@sap-ux/app-config-writer 0.5.1 → 0.5.4

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { getSmartLinksTargetFromPrompt } from './prompt';
 export { generateSmartLinksConfig } from './smartlinks-config';
 export { generateInboundNavigationConfig, readManifest } from './navigation-config';
 export { generateVariantsConfig } from './variants-config';
+export { convertToVirtualPreview } from './preview-config';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateVariantsConfig = exports.readManifest = exports.generateInboundNavigationConfig = exports.generateSmartLinksConfig = exports.getSmartLinksTargetFromPrompt = void 0;
+exports.convertToVirtualPreview = exports.generateVariantsConfig = exports.readManifest = exports.generateInboundNavigationConfig = exports.generateSmartLinksConfig = exports.getSmartLinksTargetFromPrompt = void 0;
 var prompt_1 = require("./prompt");
 Object.defineProperty(exports, "getSmartLinksTargetFromPrompt", { enumerable: true, get: function () { return prompt_1.getSmartLinksTargetFromPrompt; } });
 var smartlinks_config_1 = require("./smartlinks-config");
@@ -10,4 +10,6 @@ Object.defineProperty(exports, "generateInboundNavigationConfig", { enumerable:
 Object.defineProperty(exports, "readManifest", { enumerable: true, get: function () { return navigation_config_1.readManifest; } });
 var variants_config_1 = require("./variants-config");
 Object.defineProperty(exports, "generateVariantsConfig", { enumerable: true, get: function () { return variants_config_1.generateVariantsConfig; } });
+var preview_config_1 = require("./preview-config");
+Object.defineProperty(exports, "convertToVirtualPreview", { enumerable: true, get: function () { return preview_config_1.convertToVirtualPreview; } });
 //# sourceMappingURL=index.js.map

package/dist/preview-config/index.d.ts

@@ -0,0 +1,16 @@
+import { type Editor } from 'mem-fs-editor';
+import { type ToolsLogger } from '@sap-ux/logger';
+/**
+ * Converts the local preview files of a project to virtual files.
+ *
+ * It will check the prerequisites and confirm an explicit approval to convert the project.
+ * If the prerequisites and approval are met, the corresponding UI5 yaml configuration for the preview middleware will be converted.
+ * Corresponding files which are used for the preview are renamed or deleted.
+ *
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ * @param fs - file system reference
+ * @returns file system reference
+ */
+export declare function convertToVirtualPreview(basePath: string, logger?: ToolsLogger, fs?: Editor): Promise<Editor>;
+//# sourceMappingURL=index.d.ts.map

package/dist/preview-config/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToVirtualPreview = convertToVirtualPreview;
+const prerequisites_1 = require("./prerequisites");
+const mem_fs_1 = require("mem-fs");
+const mem_fs_editor_1 = require("mem-fs-editor");
+const preview_files_1 = require("./preview-files");
+const ui5_yaml_1 = require("./ui5-yaml");
+const package_json_1 = require("./package-json");
+/**
+ * Converts the local preview files of a project to virtual files.
+ *
+ * It will check the prerequisites and confirm an explicit approval to convert the project.
+ * If the prerequisites and approval are met, the corresponding UI5 yaml configuration for the preview middleware will be converted.
+ * Corresponding files which are used for the preview are renamed or deleted.
+ *
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ * @param fs - file system reference
+ * @returns file system reference
+ */
+async function convertToVirtualPreview(basePath, logger, fs) {
+    if (!fs) {
+        fs = (0, mem_fs_editor_1.create)((0, mem_fs_1.create)());
+    }
+    if (!(await (0, prerequisites_1.checkPrerequisites)(basePath, fs, logger))) {
+        throw Error('The prerequisites are not met. For more information, see the log messages above.');
+    }
+    if (!(await (0, prerequisites_1.getExplicitApprovalToAdjustFiles)())) {
+        logger?.error('You have not approved the conversion. The conversion has been aborted.');
+        return fs;
+    }
+    await (0, ui5_yaml_1.updatePreviewMiddlewareConfigs)(fs, basePath, logger);
+    await (0, preview_files_1.renameDefaultSandboxes)(fs, basePath);
+    await (0, preview_files_1.deleteNoLongerUsedFiles)(fs, basePath);
+    await (0, package_json_1.updateVariantsCreationScript)(fs, basePath, logger);
+    return fs;
+}
+//# sourceMappingURL=index.js.map

package/dist/preview-config/package-json.d.ts

@@ -0,0 +1,54 @@
+import type { Editor } from 'mem-fs-editor';
+import type { ToolsLogger } from '@sap-ux/logger';
+import type { Package } from '@sap-ux/project-access';
+import type { FlpConfig } from '@sap-ux/preview-middleware';
+/**
+ * Ensures that the @sap/ux-ui5-tooling or @sap-ux/preview-middleware dependency exists in the package.json.
+ *
+ * If none dependency is given, the @sap-ux/preview-middleware will be added as a devDependency.
+ *
+ * @param packageJson - the package.json file content
+ * @param fs - file system reference
+ * @param packageJsonPath - the path to the package.json file
+ */
+export declare function ensurePreviewMiddlewareDependency(packageJson: Package | undefined, fs: Editor, packageJsonPath: string): void;
+/**
+ * Extracts the URL details from a given script.
+ *
+ * It extracts the used mount point for the preview and the used intent.
+ *
+ * @param script - the content of the script
+ * @returns the URL details
+ */
+export declare function extractUrlDetails(script: string): {
+    path: string | undefined;
+    intent: FlpConfig['intent'] | undefined;
+};
+/**
+ * Check if the script/-name is valid for the conversion.
+ *
+ * The script:
+ * - must contain 'ui5 serve' or 'fiori run' command
+ * - must not be a test script
+ * - must not relate to 'webapp/index.html'.
+ *
+ * The script name:
+ * - must not be 'start-variants-management'
+ * - must not be 'start-control-property-editor'.
+ *
+ * @param scriptName - the name of the script from the package.json file
+ * @param script - the content of the script from the package.json file
+ * @returns indicator if the script is valid
+ */
+export declare function isValidPreviewScript(scriptName: string, script: string | undefined): boolean;
+/**
+ * Updates the variants creation script in package.json if needed.
+ *
+ * If an update is needed, the used intent of the script will be adjusted based on the used UI5 yaml configuration.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+export declare function updateVariantsCreationScript(fs: Editor, basePath: string, logger?: ToolsLogger): Promise<void>;
+//# sourceMappingURL=package-json.d.ts.map

package/dist/preview-config/package-json.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensurePreviewMiddlewareDependency = ensurePreviewMiddlewareDependency;
+exports.extractUrlDetails = extractUrlDetails;
+exports.isValidPreviewScript = isValidPreviewScript;
+exports.updateVariantsCreationScript = updateVariantsCreationScript;
+const path_1 = require("path");
+const ui5_yaml_1 = require("./ui5-yaml");
+const variants_config_1 = require("../variants-config");
+/**
+ * Ensures that the @sap/ux-ui5-tooling or @sap-ux/preview-middleware dependency exists in the package.json.
+ *
+ * If none dependency is given, the @sap-ux/preview-middleware will be added as a devDependency.
+ *
+ * @param packageJson - the package.json file content
+ * @param fs - file system reference
+ * @param packageJsonPath - the path to the package.json file
+ */
+function ensurePreviewMiddlewareDependency(packageJson, fs, packageJsonPath) {
+    if (!packageJson) {
+        return;
+    }
+    const hasDependency = (dependency) => !!packageJson?.devDependencies?.[dependency] || !!packageJson?.dependencies?.[dependency];
+    const dependencies = ['@sap-ux/preview-middleware', '@sap/ux-ui5-tooling'];
+    if (dependencies.some((dependency) => hasDependency(dependency))) {
+        return;
+    }
+    packageJson.devDependencies = { ...packageJson.devDependencies, '@sap-ux/preview-middleware': 'latest' };
+    fs.writeJSON(packageJsonPath, packageJson);
+}
+/**
+ * Extracts the URL details from a given script.
+ *
+ * It extracts the used mount point for the preview and the used intent.
+ *
+ * @param script - the content of the script
+ * @returns the URL details
+ */
+function extractUrlDetails(script) {
+    //extract the URL from the 'open' command of the script
+    let url = / (?:--open|-o|--o) ([^"]?\S*)/.exec(script)?.[1] ?? undefined;
+    url = url?.startsWith('"') ? url.slice(1) : url;
+    //extract the path from the URL
+    const path = /^[^?#]+\.html/.exec(url ?? '')?.[0] ?? undefined;
+    //extract the intent from the URL
+    const intent = /(?<=#)\w+-\w+/.exec(url ?? '')?.[0] ?? undefined;
+    return {
+        path,
+        intent: intent
+            ? {
+                object: intent?.split('-')[0],
+                action: intent?.split('-')[1]
+            }
+            : undefined
+    };
+}
+/**
+ * Check if the script/-name is valid for the conversion.
+ *
+ * The script:
+ * - must contain 'ui5 serve' or 'fiori run' command
+ * - must not be a test script
+ * - must not relate to 'webapp/index.html'.
+ *
+ * The script name:
+ * - must not be 'start-variants-management'
+ * - must not be 'start-control-property-editor'.
+ *
+ * @param scriptName - the name of the script from the package.json file
+ * @param script - the content of the script from the package.json file
+ * @returns indicator if the script is valid
+ */
+function isValidPreviewScript(scriptName, script) {
+    const isValidScriptName = scriptName != 'start-variants-management' && scriptName != 'start-control-property-editor';
+    //eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+    const startsWebServer = !!(script?.includes('ui5 serve') || script?.includes('fiori run'));
+    const { path } = extractUrlDetails(script ?? '');
+    const opensTest = path?.includes('qunit.html');
+    const opensIndexHtml = path === 'index.html';
+    return isValidScriptName && startsWebServer && !opensTest && !opensIndexHtml;
+}
+/**
+ * Updates the variants creation script in package.json if needed.
+ *
+ * If an update is needed, the used intent of the script will be adjusted based on the used UI5 yaml configuration.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+async function updateVariantsCreationScript(fs, basePath, logger) {
+    const packageJsonPath = (0, path_1.join)(basePath, 'package.json');
+    const packageJson = fs.readJSON(packageJsonPath);
+    if (packageJson?.scripts?.['start-variants-management']) {
+        const ui5Yaml = (0, path_1.basename)((0, ui5_yaml_1.extractYamlConfigFileName)(packageJson?.scripts?.['start-variants-management']));
+        const yamlPath = (0, path_1.join)(basePath, ui5Yaml);
+        await (0, variants_config_1.generateVariantsConfig)(basePath, yamlPath, logger, fs);
+    }
+}
+//# sourceMappingURL=package-json.js.map

package/dist/preview-config/prerequisites.d.ts

@@ -0,0 +1,21 @@
+import type { Editor } from 'mem-fs-editor';
+import type { ToolsLogger } from '@sap-ux/logger';
+/**
+ * Check if the prerequisites for the conversion are met.
+ * - UI5 CLI version 3.0.0 or higher is being used.
+ * - '@sap/grunt-sapui5-bestpractice-build' is not being used.
+ * - '@sap-ux/ui5-middleware-fe-mockserver' or 'cds-plugin-ui5' is being used.
+ *
+ * @param basePath - base path to be used for the conversion
+ * @param fs - file system reference
+ * @param logger logger to report info to the user
+ * @returns indicator if the prerequisites are met
+ */
+export declare function checkPrerequisites(basePath: string, fs: Editor, logger?: ToolsLogger): Promise<boolean>;
+/**
+ * Get the explicit approval form the user to do the conversion.
+ *
+ * @returns Explicit user approval to do the conversion.
+ */
+export declare function getExplicitApprovalToAdjustFiles(): Promise<boolean>;
+//# sourceMappingURL=prerequisites.d.ts.map

package/dist/preview-config/prerequisites.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPrerequisites = checkPrerequisites;
+exports.getExplicitApprovalToAdjustFiles = getExplicitApprovalToAdjustFiles;
+const path_1 = require("path");
+const prompts_1 = require("prompts");
+/**
+ * Check if the prerequisites for the conversion are met.
+ * - UI5 CLI version 3.0.0 or higher is being used.
+ * - '@sap/grunt-sapui5-bestpractice-build' is not being used.
+ * - '@sap-ux/ui5-middleware-fe-mockserver' or 'cds-plugin-ui5' is being used.
+ *
+ * @param basePath - base path to be used for the conversion
+ * @param fs - file system reference
+ * @param logger logger to report info to the user
+ * @returns indicator if the prerequisites are met
+ */
+async function checkPrerequisites(basePath, fs, logger) {
+    const packageJsonPath = (0, path_1.join)(basePath, 'package.json');
+    const packageJson = fs.readJSON(packageJsonPath);
+    let prerequisitesMet = true;
+    if (!packageJson) {
+        throw Error(`File 'package.json' not found at '${basePath}'`);
+    }
+    const sapui5BestpracticeBuildExists = !!packageJson?.devDependencies?.['@sap/grunt-sapui5-bestpractice-build'] ||
+        !!packageJson?.dependencies?.['@sap/grunt-sapui5-bestpractice-build'];
+    if (sapui5BestpracticeBuildExists) {
+        logger?.error("Conversion from '@sap/grunt-sapui5-bestpractice-build' is not supported. You must migrate to UI5 CLI version 3.0.0 or higher. For more information, see https://sap.github.io/ui5-tooling/v3/updates/migrate-v3.");
+        prerequisitesMet = false;
+    }
+    const ui5CliVersion = packageJson?.devDependencies?.['@ui5/cli'] ?? packageJson?.dependencies?.['@ui5/cli'] ?? '0';
+    if (parseInt(ui5CliVersion.split('.')[0], 10) < 3) {
+        logger?.error('UI5 CLI version 3.0.0 or higher is required to convert the preview to virtual files. For more information, see https://sap.github.io/ui5-tooling/v3/updates/migrate-v3.');
+        prerequisitesMet = false;
+    }
+    const ui5MiddlewareMockserverExists = !!packageJson?.devDependencies?.['@sap-ux/ui5-middleware-fe-mockserver'] ||
+        !!packageJson?.dependencies?.['@sap-ux/ui5-middleware-fe-mockserver'];
+    const cdsPluginUi5Exists = !!packageJson?.devDependencies?.['cds-plugin-ui5'] || !!packageJson?.dependencies?.['cds-plugin-ui5'];
+    if (!ui5MiddlewareMockserverExists && !cdsPluginUi5Exists) {
+        logger?.error("Conversion from 'sap/ui/core/util/MockServer' is not supported. You must migrate from '@sap-ux/ui5-middleware-fe-mockserver'. For more information, see https://www.npmjs.com/package/@sap-ux/ui5-middleware-fe-mockserver.");
+        prerequisitesMet = false;
+    }
+    return prerequisitesMet;
+}
+/**
+ * Get the explicit approval form the user to do the conversion.
+ *
+ * @returns Explicit user approval to do the conversion.
+ */
+async function getExplicitApprovalToAdjustFiles() {
+    const question = {
+        type: 'confirm',
+        name: 'approval',
+        initial: false,
+        message: 'The converter will rename the HTML files and delete the JS and TS files used for the existing preview functionality and configure virtual files instead. Do you want to proceed with the conversion?'
+    };
+    return Boolean((await (0, prompts_1.prompt)([question])).approval);
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/preview-config/preview-files.d.ts

@@ -0,0 +1,32 @@
+import type { Editor } from 'mem-fs-editor';
+import type { ToolsLogger } from '@sap-ux/logger';
+/**
+ * Renames the sandbox file which is used in a given script.
+ *
+ * The corresponding file will be renamed from *.html to *_old.html.
+ *
+ * @param fs - file system reference
+ * @param path - file path to be used for the renaming
+ * @param logger logger to report info to the user
+ */
+export declare function renameSandbox(fs: Editor, path: string, logger?: ToolsLogger): Promise<void>;
+/**
+ * Renames the default sandbox files.
+ *
+ * The default files are 'flpSandbox.html' and 'flpSandboxMockserver.html' and located under webapp/test.
+ * It adds '_old' to 'test/flpSandbox.html' and 'test/flpSandboxMockserver.html' to indicate that they will no longer be used.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+export declare function renameDefaultSandboxes(fs: Editor, basePath: string, logger?: ToolsLogger): Promise<void>;
+/**
+ * Deletes the *.js and *.ts files which are no longer used for the virtual preview.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+export declare function deleteNoLongerUsedFiles(fs: Editor, basePath: string, logger?: ToolsLogger): Promise<void>;
+//# sourceMappingURL=preview-files.d.ts.map

package/dist/preview-config/preview-files.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renameSandbox = renameSandbox;
+exports.renameDefaultSandboxes = renameDefaultSandboxes;
+exports.deleteNoLongerUsedFiles = deleteNoLongerUsedFiles;
+const path_1 = require("path");
+const project_access_1 = require("@sap-ux/project-access");
+const renameMessage = (filename) => `Renamed '${filename}' to '${filename.slice(0, -5)}_old.html'. This file is no longer needed for the preview functionality. If you have not modified this file, you can delete it. If you have modified this file, move the modified content to a custom init script for the preview middleware. For more information, see https://www.npmjs.com/package/preview-middleware#migration.`;
+/**
+ * Renames the sandbox file which is used in a given script.
+ *
+ * The corresponding file will be renamed from *.html to *_old.html.
+ *
+ * @param fs - file system reference
+ * @param path - file path to be used for the renaming
+ * @param logger logger to report info to the user
+ */
+async function renameSandbox(fs, path, logger) {
+    if (fs.exists(path)) {
+        fs.move(path, path.replace('.html', '_old.html'));
+        logger?.info(renameMessage((0, path_1.basename)(path)));
+    }
+    else if (
+    //checks if there is a file with the same name which has already been deleted/renamed to _old.html
+    Object.keys(fs.dump(undefined, (file) => {
+        return file.history.includes(path) && file.state !== 'deleted';
+    })).length === 0) {
+        logger?.debug(`The file '${(0, path_1.basename)(path)}', has already been renamed. Skipping renaming.`);
+    }
+    else {
+        logger?.warn(`The file '${(0, path_1.basename)(path)}', has not been found. Skipping renaming.`);
+    }
+}
+/**
+ * Renames the default sandbox files.
+ *
+ * The default files are 'flpSandbox.html' and 'flpSandboxMockserver.html' and located under webapp/test.
+ * It adds '_old' to 'test/flpSandbox.html' and 'test/flpSandboxMockserver.html' to indicate that they will no longer be used.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+async function renameDefaultSandboxes(fs, basePath, logger) {
+    const defaultSandboxPaths = [(0, path_1.join)('test', 'flpSandbox.html'), (0, path_1.join)('test', 'flpSandboxMockserver.html')];
+    for (const path of defaultSandboxPaths) {
+        await renameSandbox(fs, (0, path_1.join)(await (0, project_access_1.getWebappPath)(basePath), path), logger);
+    }
+}
+/**
+ * Deletes the *.js and *.ts files which are no longer used for the virtual preview.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+async function deleteNoLongerUsedFiles(fs, basePath, logger) {
+    const webappTestPath = (0, path_1.join)(await (0, project_access_1.getWebappPath)(basePath), 'test');
+    [
+        (0, path_1.join)(webappTestPath, 'locate-reuse-libs.js'),
+        (0, path_1.join)(webappTestPath, 'changes_loader.js'),
+        (0, path_1.join)(webappTestPath, 'changes_loader.ts'),
+        (0, path_1.join)(webappTestPath, 'changes_preview.js'),
+        (0, path_1.join)(webappTestPath, 'changes_preview.ts'),
+        (0, path_1.join)(webappTestPath, 'flpSandbox.js'),
+        (0, path_1.join)(webappTestPath, 'flpSandbox.ts'),
+        (0, path_1.join)(webappTestPath, 'initFlpSandbox.js'),
+        (0, path_1.join)(webappTestPath, 'initFlpSandbox.ts')
+    ].forEach((path) => {
+        if (fs.exists(path)) {
+            fs.delete(path);
+            logger?.info(`Deleted the '${(0, path_1.join)('webapp', 'test', (0, path_1.basename)(path))}' file. This file is no longer needed for the preview functionality.`);
+        }
+    });
+}
+//# sourceMappingURL=preview-files.js.map

package/dist/preview-config/ui5-yaml.d.ts

@@ -0,0 +1,49 @@
+import type { CustomMiddleware } from '@sap-ux/ui5-config';
+import type { Editor } from 'mem-fs-editor';
+import type { FlpConfig } from '@sap-ux/preview-middleware';
+import type { PreviewConfigOptions } from '../types';
+import type { ToolsLogger } from '@sap-ux/logger';
+/**
+ * Extract the UI5 yaml configuration file name from the script.
+ *
+ * @param script - the content of the script from the package.json file
+ * @returns the UI5 yaml configuration file name or 'ui5.yaml' as default
+ */
+export declare function extractYamlConfigFileName(script: string): string;
+/**
+ * Processes the passed UI5 yaml configuration file and reads out the preview middleware configuration.
+ *
+ * If the preview middleware creation is not skipped and none is given, one will be created.
+ * The configuration for the preview middleware creation will be based on the parameters of the passed script.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param ui5Yaml - the name of the UI5 yaml configuration file
+ * @param script - the content of the script
+ * @param skipPreviewMiddlewareCreation - (default: false) indicator if the preview middleware creation should be skipped if no preview middleware is configured.
+ */
+export declare function processUi5YamlConfig(fs: Editor, basePath: string, ui5Yaml: string, script: string, skipPreviewMiddlewareCreation?: boolean): Promise<void>;
+/**
+ * Creates a preview middleware configuration.
+ *
+ * It will sanitize the given preview middleware configuration and construct the flp configuration out of the given intent and path.
+ *
+ * @param previewMiddleware - the preview middleware configuration
+ * @param intent - the intent
+ * @param path - the flp path
+ * @returns the preview middleware configuration
+ */
+export declare function updatePreviewMiddlewareConfig(previewMiddleware: CustomMiddleware<PreviewConfigOptions>, intent: FlpConfig['intent'] | undefined, path: string | undefined): CustomMiddleware<PreviewConfigOptions>;
+/**
+ * Updates the preview middleware configurations according to the scripts they are being used in package.json.
+ *
+ * It will process all given UI5 configuration yaml files and check if the preview middleware configuration must be updated based on a given script.
+ * If a script is valid, the preview middleware configuration will be updated and the corresponding file renamed.
+ * UI5 configuration yaml files which are not used in any script will be sanitized.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+export declare function updatePreviewMiddlewareConfigs(fs: Editor, basePath: string, logger?: ToolsLogger): Promise<void>;
+//# sourceMappingURL=ui5-yaml.d.ts.map

package/dist/preview-config/ui5-yaml.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractYamlConfigFileName = extractYamlConfigFileName;
+exports.processUi5YamlConfig = processUi5YamlConfig;
+exports.updatePreviewMiddlewareConfig = updatePreviewMiddlewareConfig;
+exports.updatePreviewMiddlewareConfigs = updatePreviewMiddlewareConfigs;
+const path_1 = require("path");
+const ui5_yaml_1 = require("../variants-config/ui5-yaml");
+const package_json_1 = require("./package-json");
+const project_access_1 = require("@sap-ux/project-access");
+const utils_1 = require("../variants-config/utils");
+const preview_files_1 = require("./preview-files");
+const DEFAULT_FLP_PATH = '/test/flp.html';
+const DEFAULT_INTENT = {
+    object: 'app',
+    action: 'preview'
+};
+/**
+ * Checks if a script can be converted based on the used UI5 yaml configuration file.
+ *
+ * A script can be converted when the used UI5 yaml configuration file exists and complies with the schema validation.
+ *
+ * @param ui5Yaml - the name of the UI5 yaml configuration file
+ * @param scriptName - the name of the script from the package.json file
+ * @param ui5YamlFileNames - the UI5 yaml configuration file names
+ * @param logger logger to report info to the user
+ * @returns indicator if the script is to be converted
+ */
+function isUi5YamlToBeConverted(ui5Yaml, scriptName, ui5YamlFileNames, logger) {
+    if (!ui5YamlFileNames.includes(ui5Yaml)) {
+        logger?.warn(`Skipping script '${scriptName}', because the UI5 YAML configuration file, '${ui5Yaml}', could not be found.`);
+        return false;
+    }
+    return true;
+}
+/**
+ * Check if a UI5 yaml configuration file has already been converted based on another script.
+ *
+ * This is done to avoid overwriting of already converted UI5 yaml configurations.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param ui5Yaml - the name of the UI5 yaml configuration file
+ * @param scriptName - the name of the script from the package.json file
+ * @param script - the content of the script from the package.json file
+ * @param logger logger to report info to the user
+ * @returns indicator if the UI5 yaml configuration file has already been converted
+ */
+async function isUi5YamlAlreadyConverted(fs, basePath, ui5Yaml, scriptName, script, logger) {
+    if (Object.keys(fs.dump(basePath, (file) => {
+        return file.basename === ui5Yaml && file.state === 'modified';
+    })).length === 0) {
+        return false;
+    }
+    const flpPath = (await (0, utils_1.getPreviewMiddleware)(undefined, basePath, ui5Yaml, fs))
+        ?.configuration?.flp?.path;
+    const { path: scriptPath } = (0, package_json_1.extractUrlDetails)(script);
+    if (flpPath != scriptPath) {
+        logger?.warn(`Skipping script'${scriptName}', because another script also refers to UI5 YAML configuration file, '${ui5Yaml}'. Adjust the 'flp.path' property in the UI5 YAML configuration file to the correct endpoint or create a separate UI5 YAML configuration file for script '${scriptName}'. ${ui5Yaml} currently uses ${flpPath ?? DEFAULT_FLP_PATH} whereas script '${scriptName}' uses '${scriptPath}'.`);
+    }
+    else {
+        logger?.info(`Skipping script '${scriptName}', because the UI5 YAML configuration file '${ui5Yaml}' has already been adjusted based on another script.`);
+    }
+    return true;
+}
+/**
+ * Checks if the passed path is a FLP path.
+ *
+ * @param path - the path
+ * @param configuration - the preview configuration
+ * @returns indicator if the path is an FLP path
+ */
+function pathIsFlpPath(path, configuration) {
+    if (!path) {
+        return false;
+    }
+    const isNotRtaEditorPath = configuration.rta?.editors?.every((editor) => editor.path !== path) ?? true;
+    const isNotTestPath = configuration.test?.every((test) => test.path !== path) ?? true;
+    return isNotRtaEditorPath && isNotTestPath;
+}
+/**
+ * Sanitizes the preview middleware configuration.
+ *
+ * In case of an outdated preview configuration, the following changes will be applied:
+ * - property 'ui5Theme' will be moved to 'flp.theme'.
+ * - no longer used property 'component' will be removed.
+ *
+ * @param previewMiddleware - the preview middleware
+ * @returns the sanitized preview middleware
+ */
+function sanitizePreviewMiddleware(previewMiddleware) {
+    if (!(0, utils_1.isFioriToolsDeprecatedPreviewConfig)(previewMiddleware.configuration)) {
+        return previewMiddleware;
+    }
+    const ui5Theme = previewMiddleware.configuration.ui5Theme;
+    delete previewMiddleware.configuration;
+    if (!ui5Theme) {
+        return previewMiddleware;
+    }
+    const configuration = {};
+    configuration.flp = {};
+    configuration.flp.theme = ui5Theme;
+    previewMiddleware.configuration = configuration;
+    return previewMiddleware;
+}
+/**
+ * Extract the UI5 yaml configuration file name from the script.
+ *
+ * @param script - the content of the script from the package.json file
+ * @returns the UI5 yaml configuration file name or 'ui5.yaml' as default
+ */
+function extractYamlConfigFileName(script) {
+    return / (?:--config|-c) (\S*)/.exec(script)?.[1] ?? project_access_1.FileName.Ui5Yaml;
+}
+/**
+ * Processes the passed UI5 yaml configuration file and reads out the preview middleware configuration.
+ *
+ * If the preview middleware creation is not skipped and none is given, one will be created.
+ * The configuration for the preview middleware creation will be based on the parameters of the passed script.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param ui5Yaml - the name of the UI5 yaml configuration file
+ * @param script - the content of the script
+ * @param skipPreviewMiddlewareCreation - (default: false) indicator if the preview middleware creation should be skipped if no preview middleware is configured.
+ */
+async function processUi5YamlConfig(fs, basePath, ui5Yaml, script, skipPreviewMiddlewareCreation = false) {
+    let ui5YamlConfig;
+    try {
+        ui5YamlConfig = await (0, project_access_1.readUi5Yaml)(basePath, ui5Yaml, fs, { validateSchema: true });
+    }
+    catch (error) {
+        throw new Error(`An error occurred when reading '${ui5Yaml}': ${error.message}`);
+    }
+    let previewMiddleware = await (0, utils_1.getPreviewMiddleware)(ui5YamlConfig);
+    if (skipPreviewMiddlewareCreation && !previewMiddleware) {
+        return;
+    }
+    if (!previewMiddleware) {
+        previewMiddleware = (0, ui5_yaml_1.createPreviewMiddlewareConfig)(fs, basePath);
+    }
+    const { path, intent } = (0, package_json_1.extractUrlDetails)(script);
+    previewMiddleware = updatePreviewMiddlewareConfig(previewMiddleware, intent, path);
+    ui5YamlConfig.updateCustomMiddleware(previewMiddleware);
+    const yamlPath = (0, path_1.join)(basePath, ui5Yaml);
+    fs.write(yamlPath, ui5YamlConfig.toString());
+}
+/**
+ * Creates a preview middleware configuration.
+ *
+ * It will sanitize the given preview middleware configuration and construct the flp configuration out of the given intent and path.
+ *
+ * @param previewMiddleware - the preview middleware configuration
+ * @param intent - the intent
+ * @param path - the flp path
+ * @returns the preview middleware configuration
+ */
+function updatePreviewMiddlewareConfig(previewMiddleware, intent, path) {
+    const defaultIntent = `${DEFAULT_INTENT.object}-${DEFAULT_INTENT.action}`;
+    const newMiddlewareConfig = sanitizePreviewMiddleware(previewMiddleware);
+    //copy of configuration to avoid ending up with an empty configuration object in some cases
+    const configuration = { ...newMiddlewareConfig.configuration };
+    configuration.flp = configuration.flp ?? {};
+    let writeConfig = false;
+    //check path and respect defaults
+    if (pathIsFlpPath(path, configuration) && !path?.includes(DEFAULT_FLP_PATH)) {
+        configuration.flp.path = path;
+        writeConfig = true;
+    }
+    //check intent and respect defaults
+    if (intent && `${intent?.object}-${intent?.action}` !== defaultIntent) {
+        configuration.flp.intent = {
+            object: intent.object,
+            action: intent.action
+        };
+        writeConfig = true;
+    }
+    if (writeConfig) {
+        newMiddlewareConfig.configuration = configuration;
+    }
+    return newMiddlewareConfig;
+}
+/**
+ * Updates the preview middleware configurations according to the scripts they are being used in package.json.
+ *
+ * It will process all given UI5 configuration yaml files and check if the preview middleware configuration must be updated based on a given script.
+ * If a script is valid, the preview middleware configuration will be updated and the corresponding file renamed.
+ * UI5 configuration yaml files which are not used in any script will be sanitized.
+ *
+ * @param fs - file system reference
+ * @param basePath - base path to be used for the conversion
+ * @param logger logger to report info to the user
+ */
+async function updatePreviewMiddlewareConfigs(fs, basePath, logger) {
+    const ui5YamlFileNames = await (0, project_access_1.getAllUi5YamlFileNames)(basePath, fs);
+    const unprocessedUi5YamlFileNames = [...ui5YamlFileNames];
+    const packageJsonPath = (0, path_1.join)(basePath, 'package.json');
+    const packageJson = fs.readJSON(packageJsonPath);
+    for (const [scriptName, script] of Object.entries(packageJson?.scripts ?? {})) {
+        if (!script || !(0, package_json_1.isValidPreviewScript)(scriptName, script)) {
+            continue;
+        }
+        const ui5Yaml = (0, path_1.basename)(extractYamlConfigFileName(script));
+        unprocessedUi5YamlFileNames.splice(unprocessedUi5YamlFileNames.indexOf(ui5Yaml), 1);
+        if (!isUi5YamlToBeConverted(ui5Yaml, scriptName, ui5YamlFileNames, logger) ||
+            (await isUi5YamlAlreadyConverted(fs, basePath, ui5Yaml, scriptName, script, logger))) {
+            continue;
+        }
+        try {
+            await processUi5YamlConfig(fs, basePath, ui5Yaml, script);
+        }
+        catch (error) {
+            logger?.warn(`Skipping script '${scriptName}', which refers to the UI5 YAML configuration file '${ui5Yaml}'. ${error.message}`);
+            continue;
+        }
+        const { path } = (0, package_json_1.extractUrlDetails)(script);
+        if (path) {
+            await (0, preview_files_1.renameSandbox)(fs, (0, path_1.join)(await (0, project_access_1.getWebappPath)(basePath), path), logger);
+        }
+        (0, package_json_1.ensurePreviewMiddlewareDependency)(packageJson, fs, packageJsonPath);
+        logger?.info(`The UI5 YAML configuration file '${ui5Yaml}', has been updated according to script, '${scriptName}'.`);
+    }
+    for (const ui5Yaml of unprocessedUi5YamlFileNames) {
+        //at least adjust deprecated preview config of unused ui5 yaml configurations
+        try {
+            await processUi5YamlConfig(fs, basePath, ui5Yaml, '', true);
+        }
+        catch (error) {
+            logger?.warn(`Skipping UI5 yaml configuration file '${ui5Yaml}'. ${error.mesage}`);
+        }
+        logger?.warn(`The UI5 YAML configuration file '${ui5Yaml}', is not used in any preview script. Outdated preview middleware will be adjusted, if necessary.`);
+    }
+}
+//# sourceMappingURL=ui5-yaml.js.map

package/dist/variants-config/package-json.d.ts

@@ -5,7 +5,7 @@ import type { ToolsLogger } from '@sap-ux/logger';
  *
  * @param fs - mem-fs reference to be used for file access
  * @param basePath - path to application root, where package.json is
- * @param yamlPath - path to the ui5*.yaml file passed by cli
+ * @param yamlPath - path to the ui5*.yaml file
  * @param logger - logger
  * @returns Promise<void> - rejects in case variants management script can't be added to package.json
  */

package/dist/variants-config/package-json.js

@@ -10,7 +10,7 @@ const ERROR_MSG = `Script 'start-variants-management' cannot be written to packa
  *
  * @param fs - mem-fs reference to be used for file access
  * @param basePath - path to application root, where package.json is
- * @param yamlPath - path to the ui5*.yaml file passed by cli
+ * @param yamlPath - path to the ui5*.yaml file
  * @param logger - logger
  * @returns Promise<void> - rejects in case variants management script can't be added to package.json
  */
@@ -30,7 +30,7 @@ async function addVariantsManagementScript(fs, basePath, yamlPath, logger) {
     if (sapClient) {
         urlParameters['sap-client'] = sapClient;
     }
-    const url = await (0, utils_1.getRTAUrl)(basePath, (0, utils_1.getUI5UrlParameters)(urlParameters), ui5YamlFileName);
+    const url = await (0, utils_1.getRTAUrl)(basePath, (0, utils_1.enhanceUrlParametersWithRta)(packageJson, urlParameters), ui5YamlFileName, fs);
     const serveCommand = await (0, utils_1.getRTAServe)(basePath, ui5YamlFileName, fs);
     if (!url) {
         throw new Error(`${ERROR_MSG} No RTA editor specified in ui5.yaml.`);

package/dist/variants-config/ui5-yaml.d.ts

@@ -20,7 +20,7 @@ export declare function getEnhancedReloadMiddleware(yamlConfig: UI5Config): Prom
  */
 export declare function createPreviewMiddlewareConfig(fs: Editor, basePath: string): CustomMiddleware<PreviewConfigOptions>;
 /**
- * Checks the project for ui5.yaml files and reads out the configuration to update the preview and reload middlewares.
+ * Checks the project for ui5 configuration yaml files and reads the configuration to update the preview and reload middlewares.
  * If a reload middleware exists, then a delay of 300ms will be inserted and the preview middleware will be set afterward.
  *
  * @param fs - mem-fs reference to be used for file access

package/dist/variants-config/ui5-yaml.js

@@ -44,7 +44,7 @@ function createPreviewMiddlewareConfig(fs, basePath) {
     };
 }
 /**
- * Checks the project for ui5.yaml files and reads out the configuration to update the preview and reload middlewares.
+ * Checks the project for ui5 configuration yaml files and reads the configuration to update the preview and reload middlewares.
  * If a reload middleware exists, then a delay of 300ms will be inserted and the preview middleware will be set afterward.
  *
  * @param fs - mem-fs reference to be used for file access
@@ -54,7 +54,7 @@ function createPreviewMiddlewareConfig(fs, basePath) {
  */
 async function updateMiddlewares(fs, basePath, yamlPath, logger) {
     const ui5YamlFile = yamlPath ? (0, path_1.basename)(yamlPath) : project_access_1.FileName.Ui5Yaml;
-    const ui5YamlConfig = await (0, project_access_1.readUi5Yaml)(basePath, ui5YamlFile);
+    const ui5YamlConfig = await (0, project_access_1.readUi5Yaml)(basePath, ui5YamlFile, fs);
     let previewMiddleware = await (0, utils_1.getPreviewMiddleware)(ui5YamlConfig);
     const reloadMiddleware = await getEnhancedReloadMiddleware(ui5YamlConfig);
     if (!previewMiddleware) {

package/dist/variants-config/utils.d.ts

@@ -1,6 +1,6 @@
 import type { Package } from '@sap-ux/project-access';
 import type { CustomMiddleware, UI5Config } from '@sap-ux/ui5-config';
-import type { PreviewConfigOptions } from '../types';
+import type { PreviewConfigOptions, FioriToolsDeprecatedPreviewConfig } from '../types';
 import type { Editor } from 'mem-fs-editor';
 /**
  * Gets the preview middleware form the yamlConfig or provided path.
@@ -14,6 +14,13 @@ import type { Editor } from 'mem-fs-editor';
  * Rejects if neither yamlConfig nor basePath is provided or if the file can't be read
  */
 export declare function getPreviewMiddleware(yamlConfig?: UI5Config, basePath?: string, filename?: string, fs?: Editor): Promise<CustomMiddleware<PreviewConfigOptions> | undefined>;
+/**
+ * Type guard to check if the given configuration is a deprecated preview middleware configuration.
+ *
+ * @param configuration preview middleware configuration
+ * @returns true, if a preview middleware configuration is deprecated
+ */
+export declare function isFioriToolsDeprecatedPreviewConfig(configuration: PreviewConfigOptions | undefined): configuration is FioriToolsDeprecatedPreviewConfig;
 /**
  * Extracts sap client string from existing scripts in package.json.
  *
@@ -22,13 +29,21 @@ export declare function getPreviewMiddleware(yamlConfig?: UI5Config, basePath?:
  */
 export declare function getSapClientFromPackageJson(scripts: Package['scripts']): string | undefined;
 /**
- * Returns the UI5 url parameters.
- * This is needed for the UI5 run time adaptation.
+ * Extracts the version of the given dependency from the given package.json file.
  *
- * @param overwritingParams - parameters to be overwritten
- * @returns - UI5 url parameters
+ * @param packageJson - package.json file
+ * @param dependencyName - name of the (dev-)dependency
+ * @returns version of the dependency as an array of numbers
  */
-export declare function getUI5UrlParameters(overwritingParams?: Record<string, string>): string;
+export declare function getDependencyVersion(packageJson: Package, dependencyName: string): number[] | undefined;
+/**
+ * Enhances the given url parameters with the ones needed for the UI5 run time adaptation.
+ *
+ @param packageJson - package.json file
+ * @param existingParams - parameters to be enhanced
+ * @returns enhanced url parameters
+ */
+export declare function enhanceUrlParametersWithRta(packageJson: Package, existingParams?: Record<string, string>): string;
 /**
  * Returns the serve command for the preview middleware configuration of the ui5.yaml file, if given.
  * If the fiori-tools-preview middleware is used, then the serve command will be 'fiori run'.
@@ -47,7 +62,8 @@ export declare function getRTAServe(basePath: string, yamlFileName: string, fs:
  * @param basePath - path to project root, where package.json and ui5.yaml is located
  * @param query - query to create fragment
  * @param yamlFileName - path of the ui5 yaml file
+ * @param fs - the memfs editor instance
  * @returns - review url parameters
  */
-export declare function getRTAUrl(basePath: string, query: string, yamlFileName: string): Promise<string | undefined>;
+export declare function getRTAUrl(basePath: string, query: string, yamlFileName: string, fs?: Editor): Promise<string | undefined>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/variants-config/utils.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPreviewMiddleware = getPreviewMiddleware;
+exports.isFioriToolsDeprecatedPreviewConfig = isFioriToolsDeprecatedPreviewConfig;
 exports.getSapClientFromPackageJson = getSapClientFromPackageJson;
-exports.getUI5UrlParameters = getUI5UrlParameters;
+exports.getDependencyVersion = getDependencyVersion;
+exports.enhanceUrlParametersWithRta = enhanceUrlParametersWithRta;
 exports.getRTAServe = getRTAServe;
 exports.getRTAUrl = getRTAUrl;
 const project_access_1 = require("@sap-ux/project-access");
@@ -52,19 +54,53 @@ function getSapClientFromPackageJson(scripts) {
     return undefined;
 }
 /**
- * Returns the UI5 url parameters.
- * This is needed for the UI5 run time adaptation.
+ * Extracts the version of the given dependency from the given package.json file.
  *
- * @param overwritingParams - parameters to be overwritten
- * @returns - UI5 url parameters
+ * @param packageJson - package.json file
+ * @param dependencyName - name of the (dev-)dependency
+ * @returns version of the dependency as an array of numbers
  */
-function getUI5UrlParameters(overwritingParams = {}) {
-    const parameters = {
-        'fiori-tools-rta-mode': 'true',
-        'sap-ui-rta-skip-flex-validation': 'true',
-        'sap-ui-xx-condense-changes': 'true'
-    };
-    return (0, querystring_1.stringify)(Object.assign(parameters, overwritingParams));
+function getDependencyVersion(packageJson, dependencyName) {
+    return (packageJson?.devDependencies?.[dependencyName] ?? packageJson?.dependencies?.[dependencyName])
+        ?.split('.')
+        .map((versionPart) => parseInt(versionPart, 10));
+}
+/**
+ * Checks if the given version is less than the given major, minor and patch version.
+ *
+ * @param version - version to be checked
+ * @param major - major version to be compared with
+ * @param minor - minor version to be compared with
+ * @param patch - patch version to be compared with
+ * @returns true, if the given version is less than the given major, minor and patch version
+ */
+function isVersionLessThan(version, major, minor, patch) {
+    if (!version) {
+        return undefined;
+    }
+    const [vMajor, vMinor, vPatch] = version;
+    return vMajor < major || (vMajor === major && (vMinor < minor || (vMinor === minor && vPatch < patch)));
+}
+/**
+ * Enhances the given url parameters with the ones needed for the UI5 run time adaptation.
+ *
+ @param packageJson - package.json file
+ * @param existingParams - parameters to be enhanced
+ * @returns enhanced url parameters
+ */
+function enhanceUrlParametersWithRta(packageJson, existingParams = {}) {
+    const parameters = {};
+    const previewMiddlewareVersion = getDependencyVersion(packageJson, '@sap-ux/preview-middleware');
+    const uxUi5ToolingVersion = getDependencyVersion(packageJson, '@sap/ux-ui5-tooling');
+    if (isVersionLessThan(previewMiddlewareVersion, 0, 16, 89) ??
+        isVersionLessThan(uxUi5ToolingVersion, 1, 15, 4) ??
+        true) {
+        parameters['fiori-tools-rta-mode'] = 'true';
+        parameters['sap-ui-rta-skip-flex-validation'] = 'true';
+        parameters['sap-ui-xx-condense-changes'] = 'true';
+        parameters['sap-ui-xx-viewCache'] = 'false';
+    }
+    return (0, querystring_1.stringify)(Object.assign(parameters, existingParams));
 }
 /**
  * Returns the RTA mount point of the preview middleware configuration from the ui5.yaml file, if given.
@@ -117,12 +153,13 @@ async function getRTAServe(basePath, yamlFileName, fs) {
  * @param basePath - path to project root, where package.json and ui5.yaml is located
  * @param query - query to create fragment
  * @param yamlFileName - path of the ui5 yaml file
+ * @param fs - the memfs editor instance
  * @returns - review url parameters
  */
-async function getRTAUrl(basePath, query, yamlFileName) {
+async function getRTAUrl(basePath, query, yamlFileName, fs) {
     let previewMiddleware;
     try {
-        previewMiddleware = await getPreviewMiddleware(undefined, basePath, yamlFileName);
+        previewMiddleware = await getPreviewMiddleware(undefined, basePath, yamlFileName, fs);
     }
     catch (error) {
         throw new Error(`No ${yamlFileName} file found. ${error}`);
@@ -133,8 +170,9 @@ async function getRTAUrl(basePath, query, yamlFileName) {
     }
     const mountPoint = getRTAMountPoint(previewMiddleware?.configuration) ?? '/preview.html';
     const intent = getRTAIntent(previewMiddleware?.configuration) ?? '#app-preview';
+    const queryString = query ? '?' + query : '';
     return isFioriToolsDeprecatedPreviewConfig(previewMiddleware?.configuration)
-        ? `${mountPoint}?${query}#preview-app`
-        : `${mountPoint}?${query}${intent}`;
+        ? `${mountPoint}${queryString}#preview-app`
+        : `${mountPoint}${queryString}${intent}`;
 }
 //# sourceMappingURL=utils.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sap-ux/app-config-writer",
   "description": "Add or update configuration for SAP Fiori tools application",
-  "version": "0.5.1",
+  "version": "0.5.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/SAP/open-ux-tools.git",
@@ -26,10 +26,10 @@
     "mem-fs": "2.1.0",
     "mem-fs-editor": "9.4.0",
     "prompts": "2.4.2",
-    "@sap-ux/axios-extension": "1.17.4",
-    "@sap-ux/btp-utils": "0.17.0",
+    "@sap-ux/axios-extension": "1.17.6",
+    "@sap-ux/btp-utils": "0.17.1",
     "@sap-ux/logger": "0.6.0",
-    "@sap-ux/project-access": "1.28.8",
+    "@sap-ux/project-access": "1.28.9",
     "@sap-ux/store": "0.9.3",
     "@sap-ux/ui5-config": "0.26.0"
   },
@@ -40,7 +40,7 @@
     "@types/prompts": "2.4.4",
     "axios": "1.7.4",
     "nock": "13.4.0",
-    "@sap-ux/preview-middleware": "0.16.136"
+    "@sap-ux/preview-middleware": "0.16.144"
   },
   "engines": {
     "node": ">=18.x"