@sap-ux/generator-adp 0.2.0 → 0.2.1

package/generators/app/extension-project/index.d.ts

@@ -0,0 +1,24 @@
+import { type AttributesAnswers, type ConfigAnswers, type SystemLookup } from '@sap-ux/adp-tooling';
+import type { ExtensionProjectData } from '../types';
+export declare const EXTENSIBILITY_GENERATOR_NS = "@bas-dev/generator-extensibility-sub/generators/app";
+/**
+ * Prepares data required for generating an extension project.
+ *
+ * @param {ConfigAnswers} configAnswers - The configuration answers including system, user, and app selection.
+ * @param {AttributesAnswers} attributeAnswers - The basic project attributes like name, namespace, version.
+ * @param {SystemLookup} systemLookup - The lookup service for system destination info.
+ * @returns {Promise<ExtensionProjectData>} A promise resolving to the prepared extension project data object.
+ */
+export declare function getExtensionProjectData(configAnswers: ConfigAnswers, attributeAnswers: AttributesAnswers, systemLookup: SystemLookup): Promise<ExtensionProjectData>;
+/**
+ * Attempts to resolve the path to a specific node module generator from the NODE_PATH environment variable.
+ * This is particularly used in the prompt for extension projects within SAP Business Application Studio (BAS)
+ * when an application is not supported by the adaptation project. It functions by resolving the path to the
+ * generator which is then utilized with `this.composeWith()` of the Yeoman generator. If the path to the generator
+ * is found, it returns the path, allowing the extension project to continue. If no path is found, it indicates that
+ * the Extensibility Generator is not installed in the development space, preventing the user from proceeding.
+ *
+ * @returns {string | undefined} The resolved path to the generator module if found, or undefined if not found.
+ */
+export declare function resolveNodeModuleGenerator(): string | undefined;
+//# sourceMappingURL=index.d.ts.map

package/generators/app/extension-project/index.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNodeModuleGenerator = exports.getExtensionProjectData = exports.EXTENSIBILITY_GENERATOR_NS = void 0;
+const path_1 = require("path");
+const adp_tooling_1 = require("@sap-ux/adp-tooling");
+const i18n_1 = require("../../utils/i18n");
+exports.EXTENSIBILITY_GENERATOR_NS = '@bas-dev/generator-extensibility-sub/generators/app';
+/**
+ * Prepares data required for generating an extension project.
+ *
+ * @param {ConfigAnswers} configAnswers - The configuration answers including system, user, and app selection.
+ * @param {AttributesAnswers} attributeAnswers - The basic project attributes like name, namespace, version.
+ * @param {SystemLookup} systemLookup - The lookup service for system destination info.
+ * @returns {Promise<ExtensionProjectData>} A promise resolving to the prepared extension project data object.
+ */
+async function getExtensionProjectData(configAnswers, attributeAnswers, systemLookup) {
+    const { application, system, username, password } = configAnswers;
+    if (!application) {
+        throw new Error((0, i18n_1.t)('error.appParameterMissing'));
+    }
+    const destinationInfo = await systemLookup.getSystemByName(system);
+    if (!destinationInfo) {
+        throw new Error((0, i18n_1.t)('error.destinationInfoMissing'));
+    }
+    const { projectName, namespace, ui5Version } = attributeAnswers;
+    return {
+        username,
+        password,
+        destination: {
+            name: destinationInfo.Name,
+            basUsage: destinationInfo.WebIDEUsage,
+            host: destinationInfo.Host,
+            sapClient: destinationInfo['sap-client']
+        },
+        applicationNS: namespace,
+        applicationName: projectName,
+        userUI5Ver: (0, adp_tooling_1.getFormattedVersion)(ui5Version),
+        BSPUrl: application.bspUrl,
+        namespace: application.id
+    };
+}
+exports.getExtensionProjectData = getExtensionProjectData;
+/**
+ * Attempts to resolve the path to a specific node module generator from the NODE_PATH environment variable.
+ * This is particularly used in the prompt for extension projects within SAP Business Application Studio (BAS)
+ * when an application is not supported by the adaptation project. It functions by resolving the path to the
+ * generator which is then utilized with `this.composeWith()` of the Yeoman generator. If the path to the generator
+ * is found, it returns the path, allowing the extension project to continue. If no path is found, it indicates that
+ * the Extensibility Generator is not installed in the development space, preventing the user from proceeding.
+ *
+ * @returns {string | undefined} The resolved path to the generator module if found, or undefined if not found.
+ */
+function resolveNodeModuleGenerator() {
+    const nodePath = process.env['NODE_PATH'];
+    const nodePaths = nodePath?.split(':') ?? [];
+    let generator;
+    for (const path of nodePaths) {
+        try {
+            generator = require.resolve((0, path_1.resolve)(path, exports.EXTENSIBILITY_GENERATOR_NS));
+        }
+        catch (e) {
+            /**
+             * We don't care if there's an error while resolving the module, continue with the next node_module path
+             */
+        }
+        if (generator !== undefined) {
+            break;
+        }
+    }
+    return generator;
+}
+exports.resolveNodeModuleGenerator = resolveNodeModuleGenerator;
+//# sourceMappingURL=index.js.map

package/generators/app/index.d.ts

@@ -71,6 +71,10 @@ export default class extends Generator {
     writing(): Promise<void>;
     install(): Promise<void>;
     end(): void;
+    /**
+     * Generates an extension project if the application is not supported by Adaptation Project.
+     */
+    private _generateExtensionProject;
     /**
      * Combines the target folder and project name.
      *

package/generators/app/index.js

@@ -10,16 +10,17 @@ const adp_tooling_1 = require("@sap-ux/adp-tooling");
 const feature_toggle_1 = require("@sap-ux/feature-toggle");
 const fiori_generator_shared_1 = require("@sap-ux/fiori-generator-shared");
 const logger_1 = require("@sap-ux/logger");
-const telemetryEvents_1 = require("../telemetryEvents");
-const deps_1 = require("../utils/deps");
+const layer_1 = require("./layer");
 const i18n_1 = require("../utils/i18n");
+const telemetryEvents_1 = require("../telemetryEvents");
 const logger_2 = __importDefault(require("../utils/logger"));
-const parse_json_input_1 = require("../utils/parse-json-input");
-const layer_1 = require("./layer");
 const attributes_1 = require("./questions/attributes");
 const configuration_1 = require("./questions/configuration");
-const default_values_1 = require("./questions/helper/default-values");
 const validators_1 = require("./questions/helper/validators");
+const deps_1 = require("../utils/deps");
+const parse_json_input_1 = require("../utils/parse-json-input");
+const extension_project_1 = require("./extension-project");
+const default_values_1 = require("./questions/helper/default-values");
 /**
  * Generator for creating an Adaptation Project.
  *
@@ -143,7 +144,8 @@ class default_1 extends yeoman_generator_1.default {
         const defaultFolder = (0, fiori_generator_shared_1.getDefaultTargetFolder)(this.options.vscode) ?? process.cwd();
         const options = {
             targetFolder: { default: defaultFolder },
-            ui5ValidationCli: { hide: !isCLI }
+            ui5ValidationCli: { hide: !isCLI },
+            enableTypeScript: { hide: !!this.configAnswers.shouldCreateExtProject }
         };
         const attributesQuestions = (0, attributes_1.getPrompts)(this.destinationPath(), promptConfig, options);
         this.attributeAnswers = await this.prompt(attributesQuestions);
@@ -154,6 +156,10 @@ class default_1 extends yeoman_generator_1.default {
             await this._initFromJson();
         }
         try {
+            if (this.configAnswers.shouldCreateExtProject) {
+                await this._generateExtensionProject();
+                return;
+            }
             const provider = this.jsonInput ? this.abapProvider : this.prompter.provider;
             const publicVersions = this.jsonInput ? this.publicVersions : this.prompter.ui5.publicVersions;
             const packageJson = (0, deps_1.getPackageInfo)();
@@ -161,6 +167,7 @@ class default_1 extends yeoman_generator_1.default {
                 provider,
                 configAnswers: this.configAnswers,
                 attributeAnswers: this.attributeAnswers,
+                systemVersion: this.prompter?.ui5?.systemVersion,
                 publicVersions,
                 layer: this.layer,
                 packageJson,
@@ -193,6 +200,31 @@ class default_1 extends yeoman_generator_1.default {
                 this.logger.error((0, i18n_1.t)('error.telemetry', { error }));
             });
         }
+        try {
+            this.vscode?.commands?.executeCommand?.('sap.ux.application.info', { fsPath: this._getProjectPath() });
+        }
+        catch (e) {
+            this.appWizard.showError(e.message, yeoman_ui_types_1.MessageType.notification);
+        }
+    }
+    /**
+     * Generates an extension project if the application is not supported by Adaptation Project.
+     */
+    async _generateExtensionProject() {
+        try {
+            const data = await (0, extension_project_1.getExtensionProjectData)(this.configAnswers, this.attributeAnswers, this.systemLookup);
+            const generator = (0, extension_project_1.resolveNodeModuleGenerator)();
+            this.composeWith(generator, {
+                arguments: [JSON.stringify(data)],
+                appWizard: this.appWizard
+            });
+            this.logger.info(`'@bas-dev/generator-extensibility-sub' was called.`);
+        }
+        catch (e) {
+            this.logger.info((0, i18n_1.t)('error.creatingExtensionProjectError'));
+            this.logger.error(e.message);
+            this.appWizard.showError(e.message, yeoman_ui_types_1.MessageType.notification);
+        }
     }
     /**
      * Combines the target folder and project name.

package/generators/app/questions/attributes.js

@@ -181,16 +181,15 @@ function getUi5VersionValidationPromptForCli() {
 /**
  * Creates the TypeScript enablement confirm prompt.
  *
- * @param {EnableTypeScriptPromptOptions} [options] - Optional prompt options to control visibility.
+ * @param {EnableTypeScriptPromptOptions} [_] - Optional prompt options to control visibility.
  * @returns {AttributesQuestion} The prompt configuration for TypeScript confirmation.
  */
-function getEnableTypeScriptPrompt(options) {
+function getEnableTypeScriptPrompt(_) {
     return {
         type: 'confirm',
         name: types_1.attributePromptNames.enableTypeScript,
         message: 'Enable TypeScript',
         default: false,
-        when: options?.hide ?? true,
         guiOptions: {
             breadcrumb: true
         }

package/generators/app/questions/configuration.d.ts

@@ -109,6 +109,12 @@ export declare class ConfigPrompter {
      * @returns {boolean} True if views are sync-loaded.
      */
     get hasSyncViews(): boolean;
+    /**
+     * Indicates whether the application is supported by Adaptation Project.
+     *
+     * @returns {boolean} True if the application is supported.
+     */
+    get isAppSupported(): boolean;
     /**
      * Creates an instance of ConfigPrompter.
      *
@@ -165,6 +171,28 @@ export declare class ConfigPrompter {
      * @returns Dummy prompt that runs in the CLI only.
      */
     private getApplicationValidationPromptForCli;
+    /**
+     * Creates an input prompt for entering the Fiori ID.
+     *
+     * @param {FioriIdPromptOptions} _ - Optional configuration for Fiori ID prompt.
+     * @returns {InputQuestion<ConfigAnswers>} An input prompt for the Fiori ID.
+     */
+    private getFioriIdPrompt;
+    /**
+     * Generates an input prompt for entering the Application Component Hierarchy code for a project.
+     *
+     * @param {AchPromptOptions} _ - Optional configuration for ACH prompt.
+     * @returns {InputQuestion<ConfigAnswers>} An input prompt for Application Component Hierarchy code.
+     */
+    private getAchPrompt;
+    /**
+     * Generates a confirmation prompt to decide whether to create an extension project based on the application's
+     * sync capabilities and support status.
+     *
+     * @param {ShouldCreateExtProjectPromptOptions} _ - Optional configuration for the confirm extension project prompt.
+     * @returns The confirm extension project prompt as a {@link ConfigQuestion}.
+     */
+    private getShouldCreateExtProjectPrompt;
     /**
      * Validates the selected application.
      *

package/generators/app/questions/configuration.js

@@ -4,11 +4,14 @@ exports.ConfigPrompter = void 0;
 const adp_tooling_1 = require("@sap-ux/adp-tooling");
 const project_input_validator_1 = require("@sap-ux/project-input-validator");
 const axios_extension_1 = require("@sap-ux/axios-extension");
+const btp_utils_1 = require("@sap-ux/btp-utils");
 const i18n_1 = require("../../utils/i18n");
 const types_1 = require("../types");
+const message_1 = require("./helper/message");
 const choices_1 = require("./helper/choices");
-const conditions_1 = require("./helper/conditions");
+const validators_1 = require("./helper/validators");
 const additional_messages_1 = require("./helper/additional-messages");
+const conditions_1 = require("./helper/conditions");
 /**
  * A stateful prompter class that creates configuration questions.
  * It exposes a single public method {@link getPrompts} to retrieve the configuration questions.
@@ -124,6 +127,14 @@ class ConfigPrompter {
     get hasSyncViews() {
         return this.containsSyncViews;
     }
+    /**
+     * Indicates whether the application is supported by Adaptation Project.
+     *
+     * @returns {boolean} True if the application is supported.
+     */
+    get isAppSupported() {
+        return this.isApplicationSupported;
+    }
     /**
      * Creates an instance of ConfigPrompter.
      *
@@ -150,7 +161,10 @@ class ConfigPrompter {
             [types_1.configPromptNames.username]: this.getUsernamePrompt(promptOptions?.[types_1.configPromptNames.username]),
             [types_1.configPromptNames.password]: this.getPasswordPrompt(promptOptions?.[types_1.configPromptNames.password]),
             [types_1.configPromptNames.application]: this.getApplicationListPrompt(promptOptions?.[types_1.configPromptNames.application]),
-            [types_1.configPromptNames.appValidationCli]: this.getApplicationValidationPromptForCli()
+            [types_1.configPromptNames.appValidationCli]: this.getApplicationValidationPromptForCli(),
+            [types_1.configPromptNames.fioriId]: this.getFioriIdPrompt(),
+            [types_1.configPromptNames.ach]: this.getAchPrompt(),
+            [types_1.configPromptNames.shouldCreateExtProject]: this.getShouldCreateExtProjectPrompt(promptOptions?.[types_1.configPromptNames.shouldCreateExtProject])
         };
         const questions = Object.entries(keyedPrompts)
             .filter(([promptName, _]) => {
@@ -296,6 +310,68 @@ class ConfigPrompter {
             }
         };
     }
+    /**
+     * Creates an input prompt for entering the Fiori ID.
+     *
+     * @param {FioriIdPromptOptions} _ - Optional configuration for Fiori ID prompt.
+     * @returns {InputQuestion<ConfigAnswers>} An input prompt for the Fiori ID.
+     */
+    getFioriIdPrompt(_) {
+        return {
+            type: 'input',
+            name: 'fioriId',
+            message: (0, i18n_1.t)('prompts.fioriIdLabel'),
+            guiOptions: {
+                hint: (0, i18n_1.t)('prompts.fioriIdHint'),
+                breadcrumb: true
+            },
+            when: (answers) => (0, conditions_1.showInternalQuestions)(answers, this.isCustomerBase, this.isApplicationSupported),
+            default: () => (0, adp_tooling_1.getFioriId)(this.appManifest),
+            store: false
+        };
+    }
+    /**
+     * Generates an input prompt for entering the Application Component Hierarchy code for a project.
+     *
+     * @param {AchPromptOptions} _ - Optional configuration for ACH prompt.
+     * @returns {InputQuestion<ConfigAnswers>} An input prompt for Application Component Hierarchy code.
+     */
+    getAchPrompt(_) {
+        return {
+            type: 'input',
+            name: 'ach',
+            message: (0, i18n_1.t)('prompts.achLabel'),
+            guiOptions: {
+                hint: (0, i18n_1.t)('prompts.achHint'),
+                breadcrumb: true,
+                mandatory: true
+            },
+            when: (answers) => (0, conditions_1.showInternalQuestions)(answers, this.isCustomerBase, this.isApplicationSupported),
+            default: () => (0, adp_tooling_1.getAch)(this.appManifest),
+            validate: (value) => (0, project_input_validator_1.validateAch)(value, this.isCustomerBase),
+            store: false
+        };
+    }
+    /**
+     * Generates a confirmation prompt to decide whether to create an extension project based on the application's
+     * sync capabilities and support status.
+     *
+     * @param {ShouldCreateExtProjectPromptOptions} _ - Optional configuration for the confirm extension project prompt.
+     * @returns The confirm extension project prompt as a {@link ConfigQuestion}.
+     */
+    getShouldCreateExtProjectPrompt(_) {
+        return {
+            type: 'confirm',
+            name: types_1.configPromptNames.shouldCreateExtProject,
+            message: () => (0, message_1.getExtProjectMessage)(this.isApplicationSupported, this.containsSyncViews),
+            default: false,
+            guiOptions: {
+                applyDefaultWhenDirty: true
+            },
+            when: (answers) => (0, conditions_1.showExtensionProjectQuestion)(answers, this.flexUISystem, this.isCloudProject, this.isApplicationSupported, this.containsSyncViews),
+            validate: (value) => (0, validators_1.validateExtensibilityGenerator)(value, this.isApplicationSupported, this.containsSyncViews)
+        };
+    }
     /**
      * Validates the selected application.
      *
@@ -308,7 +384,17 @@ class ConfigPrompter {
         if (!app) {
             return (0, i18n_1.t)('error.selectCannotBeEmptyError', { value: 'Application' });
         }
-        return this.validateAppData(app);
+        const validationResult = await this.validateAppData(app);
+        if (!(0, btp_utils_1.isAppStudio)()) {
+            return validationResult;
+        }
+        if (validationResult === (0, i18n_1.t)('error.appDoesNotSupportManifest') ||
+            validationResult === (0, i18n_1.t)('error.appDoesNotSupportAdaptation')) {
+            this.logger.error(validationResult);
+            this.isApplicationSupported = false;
+            return true;
+        }
+        return validationResult;
     }
     /**
      * Validates the password by setting up the provider and, if necessary,
@@ -398,7 +484,6 @@ class ConfigPrompter {
             this.isApplicationSupported = true;
         }
         catch (e) {
-            this.isApplicationSupported = false;
             this.logger.debug(`Application failed validation. Reason: ${e.message}`);
             return e.message;
         }

package/generators/app/questions/helper/conditions.d.ts

@@ -1,4 +1,4 @@
-import type { ConfigAnswers } from '@sap-ux/adp-tooling';
+import type { ConfigAnswers, FlexUISupportedSystem } from '@sap-ux/adp-tooling';
 /**
  * Determines if a credential question should be shown.
  * In this simplified approach, we show credentials if a system is provided and the login was not successful.
@@ -18,4 +18,24 @@ export declare function showCredentialQuestion(answers: ConfigAnswers, isAuthReq
  * @returns {boolean} True if the application question should be shown.
  */
 export declare function showApplicationQuestion(answers: ConfigAnswers, appsLoaded: boolean, isAuthRequired: boolean, isLoginSuccessful: boolean): boolean;
+/**
+ * Determines if an extension project is allowed based on the system and application conditions.
+ *
+ * @param {ConfigAnswers} answers - The user-provided answers containing application details.
+ * @param {FlexUISupportedSystem} flexUISystem - The system type info (e.g., onPremise/UIFlex).
+ * @param {boolean} isCloudProject - Whether the system is a cloud-based system.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {boolean | undefined} True if an extension project is allowed, otherwise false or undefined.
+ */
+export declare function showExtensionProjectQuestion(answers: ConfigAnswers, flexUISystem: FlexUISupportedSystem | undefined, isCloudProject: boolean | undefined, isApplicationSupported: boolean, hasSyncViews: boolean): boolean;
+/**
+ * Determines if an internal question for ACH and FioriId will be shown based on the answers and specific conditions.
+ *
+ * @param {ConfigurationInfoAnswers} answers - The user-provided answers containing application details.
+ * @param {boolean} isCustomerBase - Indicates whether the adaptation layer is CUSTOMER_BASE.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @returns {boolean | undefined} True if an internal question for ACH and FioriId question will be shown, otherwise false.
+ */
+export declare function showInternalQuestions(answers: ConfigAnswers, isCustomerBase: boolean, isApplicationSupported: boolean): boolean;
 //# sourceMappingURL=conditions.d.ts.map

package/generators/app/questions/helper/conditions.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.showApplicationQuestion = exports.showCredentialQuestion = void 0;
+exports.showInternalQuestions = exports.showExtensionProjectQuestion = exports.showApplicationQuestion = exports.showCredentialQuestion = void 0;
+const btp_utils_1 = require("@sap-ux/btp-utils");
 /**
  * Determines if a credential question should be shown.
  * In this simplified approach, we show credentials if a system is provided and the login was not successful.
@@ -26,4 +27,39 @@ function showApplicationQuestion(answers, appsLoaded, isAuthRequired, isLoginSuc
     return !!answers.system && appsLoaded && (isAuthRequired ? isLoginSuccessful : true);
 }
 exports.showApplicationQuestion = showApplicationQuestion;
+/**
+ * Determines if an extension project is allowed based on the system and application conditions.
+ *
+ * @param {ConfigAnswers} answers - The user-provided answers containing application details.
+ * @param {FlexUISupportedSystem} flexUISystem - The system type info (e.g., onPremise/UIFlex).
+ * @param {boolean} isCloudProject - Whether the system is a cloud-based system.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {boolean | undefined} True if an extension project is allowed, otherwise false or undefined.
+ */
+function showExtensionProjectQuestion(answers, flexUISystem, isCloudProject, isApplicationSupported, hasSyncViews) {
+    if (!answers.application) {
+        return false;
+    }
+    if (isCloudProject) {
+        return false;
+    }
+    const isOnPremiseAppStudio = !!flexUISystem?.isOnPremise && (0, btp_utils_1.isAppStudio)();
+    const nonFlexOrNonOnPremise = flexUISystem && (!flexUISystem?.isOnPremise || !flexUISystem?.isUIFlex);
+    return (isOnPremiseAppStudio &&
+        (!isApplicationSupported || (isApplicationSupported && (nonFlexOrNonOnPremise || hasSyncViews))));
+}
+exports.showExtensionProjectQuestion = showExtensionProjectQuestion;
+/**
+ * Determines if an internal question for ACH and FioriId will be shown based on the answers and specific conditions.
+ *
+ * @param {ConfigurationInfoAnswers} answers - The user-provided answers containing application details.
+ * @param {boolean} isCustomerBase - Indicates whether the adaptation layer is CUSTOMER_BASE.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @returns {boolean | undefined} True if an internal question for ACH and FioriId question will be shown, otherwise false.
+ */
+function showInternalQuestions(answers, isCustomerBase, isApplicationSupported) {
+    return !!answers.system && answers.application && !isCustomerBase && isApplicationSupported;
+}
+exports.showInternalQuestions = showInternalQuestions;
 //# sourceMappingURL=conditions.js.map

package/generators/app/questions/helper/message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates a message for extension project prompt based on the provided parameters.
+ *
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {string} A message for confirm extension project prompt.
+ */
+export declare const getExtProjectMessage: (isApplicationSupported: boolean, hasSyncViews: boolean) => string;
+//# sourceMappingURL=message.d.ts.map

package/generators/app/questions/helper/message.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExtProjectMessage = void 0;
+const i18n_1 = require("../../../utils/i18n");
+/**
+ * Creates a message for extension project prompt based on the provided parameters.
+ *
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {string} A message for confirm extension project prompt.
+ */
+const getExtProjectMessage = (isApplicationSupported, hasSyncViews) => {
+    return isApplicationSupported && hasSyncViews
+        ? (0, i18n_1.t)('prompts.createExtProjectWithSyncViewsLabel')
+        : (0, i18n_1.t)('prompts.createExtProjectLabel');
+};
+exports.getExtProjectMessage = getExtProjectMessage;
+//# sourceMappingURL=message.js.map

package/generators/app/questions/helper/validators.d.ts

@@ -5,6 +5,16 @@ interface JsonInputParams {
     namespace: string;
     system: string;
 }
+/**
+ * Validates whether the extensibility sub-generator is available and sets it up if necessary.
+ * If the generator is not found, an error message is returned advising on the necessary action.
+ *
+ * @param {boolean} value - A confirm flag indicating whether user wants to continue creating an extension project.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {boolean | string} Returns true if app is supported and contains sync views, or an error message if not.
+ */
+export declare function validateExtensibilityGenerator(value: boolean, isApplicationSupported: boolean, hasSyncViews: boolean): boolean | string;
 /**
  * Validates the input parameters for an adaptation project configuration.
  *

package/generators/app/questions/helper/validators.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateJsonInput = void 0;
+exports.validateJsonInput = exports.validateExtensibilityGenerator = void 0;
 const project_input_validator_1 = require("@sap-ux/project-input-validator");
 const i18n_1 = require("../../../utils/i18n");
 const type_guards_1 = require("../../../utils/type-guards");
+const extension_project_1 = require("../../extension-project");
+/**
+ * Validates whether the extensibility sub-generator is available and sets it up if necessary.
+ * If the generator is not found, an error message is returned advising on the necessary action.
+ *
+ * @param {boolean} value - A confirm flag indicating whether user wants to continue creating an extension project.
+ * @param {boolean} isApplicationSupported - Whether the selected application is supported.
+ * @param {boolean} hasSyncViews - Whether synchronized views exist for the app.
+ * @returns {boolean | string} Returns true if app is supported and contains sync views, or an error message if not.
+ */
+function validateExtensibilityGenerator(value, isApplicationSupported, hasSyncViews) {
+    if (value) {
+        const generator = (0, extension_project_1.resolveNodeModuleGenerator)();
+        if (!generator) {
+            return (0, i18n_1.t)('error.extensibilityGenNotFound');
+        }
+        return true;
+    }
+    return isApplicationSupported && hasSyncViews ? true : (0, i18n_1.t)('prompts.createExtProjectContinueLabel');
+}
+exports.validateExtensibilityGenerator = validateExtensibilityGenerator;
 /**
  * Validates the input parameters for an adaptation project configuration.
  *

package/generators/app/types.d.ts

@@ -34,7 +34,10 @@ export declare enum configPromptNames {
     username = "username",
     password = "password",
     application = "application",
-    appValidationCli = "appValidationCli"
+    appValidationCli = "appValidationCli",
+    fioriId = "fioriId",
+    ach = "ach",
+    shouldCreateExtProject = "shouldCreateExtProject"
 }
 /**
  * The question type specific to configuration prompts.
@@ -60,6 +63,15 @@ export interface ApplicationPromptOptions {
     default?: string;
     hide?: boolean;
 }
+export interface FioriIdPromptOptions {
+    hide?: boolean;
+}
+export interface AchPromptOptions {
+    hide?: boolean;
+}
+export interface ShouldCreateExtProjectPromptOptions {
+    hide?: boolean;
+}
 /**
  * Options for the configuration inquirer & the prompts.
  */
@@ -70,6 +82,9 @@ export type ConfigPromptOptions = Partial<{
     [configPromptNames.password]: PasswordPromptOptions;
     [configPromptNames.application]: ApplicationPromptOptions;
     [configPromptNames.appValidationCli]: CliValidationPromptOptions;
+    [configPromptNames.fioriId]: FioriIdPromptOptions;
+    [configPromptNames.ach]: AchPromptOptions;
+    [configPromptNames.shouldCreateExtProject]: ShouldCreateExtProjectPromptOptions;
 }>;
 export declare enum attributePromptNames {
     projectName = "projectName",
@@ -110,6 +125,21 @@ export type AttributePromptOptions = Partial<{
     [attributePromptNames.ui5ValidationCli]: CliValidationPromptOptions;
     [attributePromptNames.enableTypeScript]: EnableTypeScriptPromptOptions;
 }>;
+export interface ExtensionProjectData {
+    destination: {
+        name: string;
+        basUsage: string | undefined;
+        host: string | undefined;
+        sapClient: string | undefined;
+    };
+    username: string;
+    password: string;
+    applicationNS: string;
+    applicationName: string;
+    userUI5Ver: string;
+    BSPUrl: string;
+    namespace: string;
+}
 /**
  * An interface representing the json input used to store the complete adaptation project
  * generator configurations. The json is passed as an CLI argument.

package/generators/app/types.js

@@ -12,6 +12,9 @@ var configPromptNames;
     configPromptNames["password"] = "password";
     configPromptNames["application"] = "application";
     configPromptNames["appValidationCli"] = "appValidationCli";
+    configPromptNames["fioriId"] = "fioriId";
+    configPromptNames["ach"] = "ach";
+    configPromptNames["shouldCreateExtProject"] = "shouldCreateExtProject";
 })(configPromptNames || (exports.configPromptNames = configPromptNames = {}));
 var attributePromptNames;
 (function (attributePromptNames) {

package/generators/translations/generator-adp.i18n.json

@@ -14,6 +14,13 @@
         "passwordTooltip": "Enter the password for the back-end system.",
         "applicationListLabel": "Application",
         "applicationListTooltip": "Select the application for which you want to create an app variant.",
+        "fioriIdLabel": "Fiori ID",
+        "fioriIdHint": "This is an one-time, semantic identifier for the app variant. The Fiori ID will be shown in the 'About' section of the app for ease of identification and will also be available in the Fiori Apps Reference Library.",
+        "achLabel": "Application Component Hierarchy",
+        "achHint": "The purpose of ACH components is to enable the support organization to indicate which BCP/ticket component might be responsible for a particular issue.",
+        "createExtProjectLabel": "The selected application is not supported by the SAPUI5 Adaptation Project. For more information, see SAPUI5 Adaptation Project documentation. Do you want to create an extension project instead?",
+        "createExtProjectWithSyncViewsLabel": "Do you want to create an extension project instead? An extension project gives you the ability to create controller extensions for synchronous and asynchronous views.",
+        "createExtProjectContinueLabel": "Please select whether you want to continue.",
         "projectTypeLabel": "Project Type",
         "projectNameLabel": "Project Name",
         "projectNameTooltip": "Enter the project name for your app variant.",
@@ -44,7 +51,12 @@
         "notDeployableSystemError": "The system that you have selected is not an ABAP On-Premise system which supports DTA_FOLDER deployment. Adaptation projects are only supported on those systems. Please choose an ABAP On-Premise system which supports DTA_FOLDER deployment.",
         "notFlexEnabledError": "The system that you have selected is not an ABAP On-Premise system which supports flexibility. Adaptation projects are only supported on those systems. Please choose an ABAP On-Premise system which supports flexibility. If you continue, you will only be able to create an extension project.",
         "manifestCouldNotBeValidated": "The manifest.json file of the selected application could not be validated. Please select a different application.",
-        "appDoesNotSupportAdaptation": "The application that you have selected does not support flexibility. Adaptation projects are only supported with those applications. Please choose an application which supports flexibility.",
+        "appDoesNotSupportAdaptation": "The selected application does not support flexibility. The SAPUI5 Adaptation Project is only available for applications that support flexibility. Please select a different application.",
+        "appDoesNotSupportManifest": "The selected application is not supported by the adaptation project. Please select a different application. For more information, see SAPUI5 Adaptation Project documentation.",
+        "extensibilityGenNotFound": "Extensibility Project generator plugin was not found in your dev space, and is required for this action. To proceed, please install the <SAPUI5 Layout Editor & Extensibility> extension.",
+        "creatingExtensionProjectError": "Creating the extension project failed. To see the error, view the logs.",
+        "appParameterMissing": "Could not create an extension project because the application parameters are missing. Please select a different application.",
+        "destinationInfoMissing": "Could not create an extension project because the destination info is missing. Please select a different system.",
         "systemNotFound": "System not found or not supported: {{system}}. Please check the system exists.",
         "applicationNotFound": "Application not found or not supported: {{appName}}. Please check the application exists."
     }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@sap-ux/generator-adp",
   "displayName": "SAPUI5 Adaptation Project",
   "description": "Adaptation project allows you to create an app variant for an existing SAP Fiori elements-based or SAPUI5 freestyle application, without changing the original application.",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/SAP/open-ux-tools.git",
@@ -29,16 +29,16 @@
     "i18next": "23.5.1",
     "yeoman-generator": "5.10.0",
     "uuid": "10.0.0",
-    "@sap-ux/adp-tooling": "0.13.42",
-    "@sap-ux/btp-utils": "1.0.3",
+    "@sap-ux/adp-tooling": "0.13.43",
     "@sap-ux/axios-extension": "1.20.2",
-    "@sap-ux/inquirer-common": "0.6.42",
+    "@sap-ux/btp-utils": "1.0.3",
     "@sap-ux/feature-toggle": "0.2.3",
+    "@sap-ux/inquirer-common": "0.6.42",
     "@sap-ux/logger": "0.6.0",
     "@sap-ux/project-access": "1.29.22",
     "@sap-ux/store": "1.0.0",
     "@sap-ux/system-access": "0.5.38",
-    "@sap-ux/project-input-validator": "0.5.5",
+    "@sap-ux/project-input-validator": "0.5.6",
     "@sap-ux/fiori-generator-shared": "0.11.3"
   },
   "devDependencies": {