feat: Add prompting code of Adaptation Project generator

.changeset/khaki-panthers-joke.md

@@ -0,0 +1,8 @@
+---
+'@sap-ux/environment-check': minor
+'@sap-ux/axios-extension': minor
+'@sap-ux/adp-tooling': minor
+'@sap-ux/create': minor
+---
+
+feat: Add prompting code of Adaptation Project generator

packages/adp-tooling/package.json

@@ -43,6 +43,8 @@
         "@sap-ux/project-input-validator": "workspace:*",
         "@sap-ux/system-access": "workspace:*",
         "@sap-ux/ui5-config": "workspace:*",
+        "@sap-ux/environment-check": "workspace:*",
+        "@sap-ux/store": "workspace:*",
         "adm-zip": "0.5.10",
         "ejs": "3.1.10",
         "i18next": "23.11.2",
@@ -55,6 +57,7 @@
     },
     "devDependencies": {
         "@sap-ux/store": "workspace:*",
+        "@sap-devx/yeoman-ui-types": "1.14.4",
         "@types/adm-zip": "0.5.5",
         "@types/ejs": "3.1.2",
         "@types/express": "4.17.21",

packages/adp-tooling/src/base/abap.ts

@@ -1,8 +1,9 @@
-import type { Manifest, ManifestNamespace } from '@sap-ux/project-access';
 import type { ToolsLogger } from '@sap-ux/logger';
-import type { AdpPreviewConfig } from '../types';
-import { createAbapServiceProvider } from '@sap-ux/system-access';
 import { isAxiosError } from '@sap-ux/axios-extension';
+import { createAbapServiceProvider } from '@sap-ux/system-access';
+import type { Manifest, ManifestNamespace } from '@sap-ux/project-access';
+
+import type { AdpPreviewConfig } from '../types';
 
 /**
  * Get the application manifest.

packages/adp-tooling/src/base/constants/index.ts

@@ -0,0 +1,36 @@
+export const UI5_CDN_URL = 'https://ui5.sap.com';
+export const UI5_VERSIONS_CDN_URL = 'https://sapui5.hana.ondemand.com/version.json';
+export const UI5_VERSIONS_NEO_CDN_URL = 'https://ui5.sap.com/neo-app.json';
+export const SNAPSHOT_CDN_URL = 'https://sapui5preview-sapui5.dispatcher.int.sap.eu2.hana.ondemand.com:443';
+
+export const CURRENT_SYSTEM_VERSION = '(system version)';
+export const LATEST_VERSION = '(latest)';
+export const SNAPSHOT_VERSION = 'snapshot';
+export const SNAPSHOT_UNTESTED_VERSION = 'snapshot-untested';
+
+export const RESOURCE_BUNDLE_TEXT = '\n\n# This is the resource bundle for ';
+export const TRANSLATION_UUID_TEXT = '\n#__ldi.translation.uuid=';
+export const PROPERTIES_TEXT = '.properties';
+export const MAIN_I18N_PATH = 'i18n/i18n.properties';
+
+export const S4HANA_APPS_PARAMS = {
+    'sap.app/type': 'application',
+    'sap.fiori/cloudDevAdaptationStatus': 'released',
+    'fields':
+        'sap.app/id,repoName,sap.fiori/cloudDevAdaptationStatus,sap.app/ach,sap.fiori/registrationIds,sap.app/title,url,fileType'
+};
+
+export const ABAP_APPS_PARAMS = {
+    'fields': 'sap.app/id,sap.app/ach,sap.fiori/registrationIds,sap.app/title,url,fileType,repoName',
+    'sap.ui/technology': 'UI5',
+    'sap.app/type': 'application',
+    'fileType': 'appdescr'
+};
+
+export const ABAP_VARIANT_APPS_PARAMS = {
+    'fields': 'sap.app/id,sap.app/ach,sap.fiori/registrationIds,sap.app/title,url,fileType,repoName',
+    'sap.ui/technology': 'UI5',
+    'sap.app/type': 'application',
+    'fileType': 'appdescr_variant',
+    'originLayer': 'VENDOR'
+};

packages/adp-tooling/src/base/helper.ts

@@ -1,6 +1,8 @@
 import { readFileSync } from 'fs';
 import { join, isAbsolute } from 'path';
+
 import { UI5Config } from '@sap-ux/ui5-config';
+
 import type { DescriptorVariant, AdpPreviewConfig } from '../types';
 
 /**

packages/adp-tooling/src/base/index.ts

@@ -0,0 +1,6 @@
+export * from './constants';
+export * from './node-generator-resolver';
+export * from './helper';
+export * from './change-utils';
+export * from './abap';
+export * from './cf';

packages/adp-tooling/src/base/node-generator-resolver.ts

@@ -0,0 +1,33 @@
+import { resolve } from 'path';
+
+/**
+ * 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 function resolveNodeModuleGenerator(): string | undefined {
+    const nodePath = process.env['NODE_PATH'];
+    const nodePaths = nodePath?.split(':') ?? [];
+
+    let generator: string | undefined;
+    for (const path of nodePaths) {
+        try {
+            generator = require.resolve(resolve(path, '@bas-dev/generator-extensibility-sub/generators/app'));
+        } 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;
+}