@sap/ux-ui5-tooling 1.20.4 → 1.22.0

package/dist/preview-middleware/dist/client/adp/init-dialogs.ts

@@ -0,0 +1,178 @@
+/** sap.ui.core */
+import type UI5Element from 'sap/ui/core/Element';
+
+/** sap.ui.rta */
+import type RuntimeAuthoring from 'sap/ui/rta/RuntimeAuthoring';
+import hasStableId from 'sap/ui/rta/util/hasStableId';
+
+/** sap.ui.fl */
+import FlUtils from 'sap/ui/fl/Utils';
+
+/** sap.ui.dt */
+import type ElementOverlay from 'sap/ui/dt/ElementOverlay';
+
+import ManagedObject from 'sap/ui/base/ManagedObject';
+import { DialogFactory, DialogNames } from './dialog-factory';
+import type { IsReuseComponentApi } from '../cpe/types';
+import { getTextBundle, type TextBundle } from '../i18n';
+import { getReuseComponentChecker } from './utils';
+import type { Ui5VersionInfo } from '../utils/version';
+import { getSyncViewIds } from './sync-views-utils';
+
+/**
+ * Handler for enablement of Extend With Controller context menu entry
+ *
+ * @param control UI5 control.
+ * @param isReuseComponent Function to check if the control is a reuse component.
+ * @param isCloud Whether the application is running in the cloud
+ * @returns boolean whether menu item is enabled or not
+ */
+export function isControllerExtensionEnabledForControl(
+    control: ManagedObject,
+    isReuseComponent: IsReuseComponentApi,
+    isCloud: boolean
+): boolean {
+    const viewId = FlUtils.getViewForControl(control).getId();
+    const syncViewsIds = getSyncViewIds();
+    const isControlInSyncView = syncViewsIds.has(viewId);
+
+    if (isCloud) {
+        const isClickedControlReuseComponent = isReuseComponent(control.getId());
+        return !isControlInSyncView && !isClickedControlReuseComponent;
+    }
+    return !isControlInSyncView;
+}
+
+/**
+ * Handler for enablement of Extend With Controller context menu entry
+ *
+ * @param overlays Control overlays
+ * @param isReuseComponent Function to check if the control is a reuse component.
+ * @param isCloud Whether the application is running in the cloud
+ * @returns boolean whether menu item is enabled or not
+ */
+export const isControllerExtensionEnabled = (
+    overlays: ElementOverlay[],
+    isReuseComponent: IsReuseComponentApi,
+    isCloud: boolean
+): boolean => {
+    if (overlays.length === 0 || overlays.length > 1) {
+        return false;
+    }
+    return isControllerExtensionEnabledForControl(overlays[0].getElement(), isReuseComponent, isCloud);
+};
+
+/**
+ * Determines whether the fragment command should be enabled based on the provided overlays.
+ *
+ * @param {ElementOverlay[]} overlays - An array of ElementOverlay objects representing the UI overlays.
+ * @param {isReuseComponentApi} isReuseComponent - Function to check if the control is a reuse component.
+ * @param {boolean} isCloud - Whether the application is running in the cloud.
+ * @returns {boolean} True if the fragment command is enabled, false otherwise.
+ */
+export const isFragmentCommandEnabled = (
+    overlays: ElementOverlay[],
+    isReuseComponent: IsReuseComponentApi,
+    isCloud: boolean
+): boolean => {
+    if (overlays.length === 0 || overlays.length > 1) {
+        return false;
+    }
+
+    const control = overlays[0].getElement();
+    const stableId = hasStableId(overlays[0]);
+    if (isCloud) {
+        return stableId && !isReuseComponent(control.getId());
+    }
+
+    return stableId;
+};
+
+/**
+ * Determines the text that should be displayed for the Add Fragment context menu item.
+ *
+ * @param {ElementOverlay} overlay - An ElementOverlay object representing the UI overlay.
+ * @param {isReuseComponentApi} isReuseComponentChecker - Function to check if the control is a reuse component.
+ * @param {boolean} isCloud - Whether the application is running in the cloud.
+ * @param {TextBundle} resources - The text bundle.
+ * @returns {string} The text of the Add Fragment context menu item.
+ */
+export const getAddFragmentItemText = (
+    overlay: ElementOverlay,
+    isReuseComponentChecker: IsReuseComponentApi,
+    isCloud: boolean,
+    resources: TextBundle
+) => {
+    if (isCloud && isReuseComponentChecker(overlay.getElement().getId())) {
+        return resources.getText('ADP_ADD_FRAGMENT_MENU_ITEM_REUSE_COMPONENT');
+    }
+    if (!hasStableId(overlay)) {
+        return resources.getText('ADP_ADD_FRAGMENT_MENU_ITEM_UNSTABLE_ID');
+    }
+
+    return resources.getText('ADP_ADD_FRAGMENT_MENU_ITEM');
+};
+
+/**
+ * Determines the text that should be displayed for Controller Extension context menu item.
+ *
+ * @param {ElementOverlay} overlay - An ElementOverlay object representing the UI overlay.
+ * @param {isReuseComponentApi} isReuseComponentChecker - Function to check if the control is a reuse component.
+ * @param {boolean} isCloud - Whether the application is running in the cloud.
+ * @param {TextBundle} resources - The text bundle.
+ * @returns {string} The text of the Add Fragment context menu item.
+ */
+export const getExtendControllerItemText = (
+    overlay: ElementOverlay,
+    isReuseComponentChecker: IsReuseComponentApi,
+    isCloud: boolean,
+    resources: TextBundle
+) => {
+    const viewId = FlUtils.getViewForControl(overlay.getElement()).getId();
+    const syncViewsIds = getSyncViewIds();
+    if (syncViewsIds.has(viewId)) {
+        return resources.getText('ADP_ADD_CONTROLLER_EXTENSION_MENU_ITEM_SYNC_VIEW');
+    }
+
+    if (isCloud && isReuseComponentChecker(overlay.getElement().getId())) {
+        return resources.getText('ADP_ADD_CONTROLLER_EXTENSION_MENU_ITEM_REUSE_COMPONENT');
+    }
+
+    return resources.getText('ADP_ADD_CONTROLLER_EXTENSION_MENU_ITEM');
+};
+
+/**
+ * Adds a new item to the context menu
+ *
+ * @param rta Runtime Authoring
+ * @param ui5VersionInfo UI5 version information
+ */
+export const initDialogs = async (
+    rta: RuntimeAuthoring,
+    ui5VersionInfo: Ui5VersionInfo
+): Promise<void> => {
+    const contextMenu = rta.getDefaultPlugins().contextMenu;
+    const isCloud = rta.getFlexSettings().isCloud;
+    const resources = await getTextBundle();
+    const isReuseComponentChecker = await getReuseComponentChecker(ui5VersionInfo);
+
+    contextMenu.addMenuItem({
+        id: 'ADD_FRAGMENT',
+        text: (overlay: ElementOverlay) => getAddFragmentItemText(overlay, isReuseComponentChecker, isCloud, resources),
+        handler: async (overlays: UI5Element[]) =>
+            await DialogFactory.createDialog(overlays[0], rta, DialogNames.ADD_FRAGMENT),
+        icon: 'sap-icon://attachment-html',
+        enabled: (overlays: ElementOverlay[]) => isFragmentCommandEnabled(overlays, isReuseComponentChecker, isCloud)
+    });
+
+    contextMenu.addMenuItem({
+        id: 'EXTEND_CONTROLLER',
+        text: (overlay: ElementOverlay) =>
+            getExtendControllerItemText(overlay, isReuseComponentChecker, isCloud, resources),
+        handler: async (overlays: UI5Element[]) =>
+            await DialogFactory.createDialog(overlays[0], rta, DialogNames.CONTROLLER_EXTENSION),
+        icon: 'sap-icon://create-form',
+        enabled: (overlays: ElementOverlay[]) =>
+            isControllerExtensionEnabled(overlays, isReuseComponentChecker, isCloud)
+    });
+};

package/dist/preview-middleware/dist/client/adp/init.js

@@ -0,0 +1,111 @@
+"use strict";
+
+sap.ui.define(["sap/base/Log", "open/ux/preview/client/thirdparty/@sap-ux-private/control-property-editor-common", "../utils/version", "../cpe/init", "./sync-views-utils", "../utils/application", "./quick-actions/load", "./init-dialogs", "../utils/info-center-message", "../cpe/communication-service"], function (log, ___sap_ux_private_control_property_editor_common, ___utils_version, __init, ___sync_views_utils, ___utils_application, ___quick_actions_load, ___init_dialogs, ___utils_info_center_message, ___cpe_communication_service) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  function __ui5_require_async(path) {
+    return new Promise(function (resolve, reject) {
+      sap.ui.require([path], function (module) {
+        if (!(module && module.__esModule)) {
+          module = module === null || !(typeof module === "object" && path.endsWith("/library")) ? {
+            default: module
+          } : module;
+          Object.defineProperty(module, "__esModule", {
+            value: true
+          });
+        }
+        resolve(module);
+      }, function (err) {
+        reject(err);
+      });
+    });
+  }
+  const enableTelemetry = ___sap_ux_private_control_property_editor_common["enableTelemetry"];
+  const MessageBarType = ___sap_ux_private_control_property_editor_common["MessageBarType"];
+  const toggleAppPreviewVisibility = ___sap_ux_private_control_property_editor_common["toggleAppPreviewVisibility"];
+  const getFullyQualifiedUi5Version = ___utils_version["getFullyQualifiedUi5Version"];
+  const getUi5Version = ___utils_version["getUi5Version"];
+  const isLowerThanMinimalUi5Version = ___utils_version["isLowerThanMinimalUi5Version"];
+  const minVersionInfo = ___utils_version["minVersionInfo"];
+  const init = _interopRequireDefault(__init);
+  const updateSyncViewsIds = ___sync_views_utils["updateSyncViewsIds"];
+  const showSyncViewsWarning = ___sync_views_utils["showSyncViewsWarning"];
+  const getApplicationType = ___utils_application["getApplicationType"];
+  const loadDefinitions = ___quick_actions_load["loadDefinitions"];
+  const initDialogs = ___init_dialogs["initDialogs"];
+  const sendInfoCenterMessage = ___utils_info_center_message["sendInfoCenterMessage"];
+  const CommunicationService = ___cpe_communication_service["CommunicationService"];
+  var __exports = async function (rta) {
+    const flexSettings = rta.getFlexSettings();
+    if (flexSettings.telemetry === true) {
+      enableTelemetry();
+    }
+    const ui5VersionInfo = await getUi5Version();
+
+    // Plugins need to be set before adding additional plugins to prevent overriding with the default
+    // and allow usage of getPlugins later in the flow
+    const defaultPlugins = rta.getDefaultPlugins();
+    rta.setPlugins(defaultPlugins);
+    if (isLowerThanMinimalUi5Version(ui5VersionInfo, {
+      major: 1,
+      minor: 136,
+      patch: 2
+    })) {
+      await initDialogs(rta, ui5VersionInfo);
+    } else {
+      (await __ui5_require_async('open/ux/preview/client/adp/add-fragment')).initAddXMLPlugin(rta);
+      (await __ui5_require_async('open/ux/preview/client/adp/extend-controller')).initExtendControllerPlugin(rta);
+    }
+    if (!isLowerThanMinimalUi5Version(ui5VersionInfo, {
+      major: 1,
+      minor: 78
+    })) {
+      const ExtensionPointService = (await __ui5_require_async('open/ux/preview/client/adp/extension-point')).default;
+      const extPointService = new ExtensionPointService(rta);
+      extPointService.init();
+    }
+    const manifest = rta.getRootControlInstance().getManifest();
+    const applicationType = getApplicationType(manifest);
+    const quickActionRegistries = await loadDefinitions(applicationType);
+
+    // Initialize OVP bridge functions if the application is an OVP app
+    if (manifest['sap.ovp']) {
+      const {
+        initOvpWindowFunctions
+      } = await __ui5_require_async('open/ux/preview/client/adp/ovp-window-functions');
+      initOvpWindowFunctions();
+    }
+    await init(rta, quickActionRegistries);
+
+    // Register synchronious views detection and warning
+    // This is not awaited to prevent deadlock in the initialization
+    rta.getService('outline').then(outlineService => {
+      outlineService.attachEvent('update', async () => {
+        await updateSyncViewsIds(ui5VersionInfo);
+        await showSyncViewsWarning();
+      });
+    }).catch(error => {
+      log.error('Failed to attach update event to outline service', error);
+    });
+    if (isLowerThanMinimalUi5Version(ui5VersionInfo)) {
+      await sendInfoCenterMessage({
+        title: {
+          key: 'FLP_UI5_VERSION_WARNING_TITLE'
+        },
+        description: {
+          key: 'FLP_UI5_VERSION_WARNING_DESCRIPTION',
+          params: [getFullyQualifiedUi5Version(ui5VersionInfo), getFullyQualifiedUi5Version(minVersionInfo)]
+        },
+        type: MessageBarType.error
+      });
+      CommunicationService.sendAction(toggleAppPreviewVisibility(false));
+      return;
+    }
+    log.debug('ADP init executed.');
+  };
+  return __exports;
+});
+//# sourceMappingURL=init.js.map

package/dist/preview-middleware/dist/client/adp/init.ts

@@ -0,0 +1,92 @@
+import log from 'sap/base/Log';
+import type RuntimeAuthoring from 'sap/ui/rta/RuntimeAuthoring';
+import type RTAOutlineService from 'sap/ui/rta/command/OutlineService';
+
+import {
+    enableTelemetry,
+    MessageBarType,
+    toggleAppPreviewVisibility
+} from '@sap-ux-private/control-property-editor-common';
+
+import {
+    getFullyQualifiedUi5Version,
+    getUi5Version,
+    isLowerThanMinimalUi5Version,
+    minVersionInfo
+} from '../utils/version';
+
+import init from '../cpe/init';
+import { updateSyncViewsIds, showSyncViewsWarning } from './sync-views-utils';
+import { getApplicationType } from '../utils/application';
+
+import { loadDefinitions } from './quick-actions/load';
+import { initDialogs } from './init-dialogs';
+import { sendInfoCenterMessage } from '../utils/info-center-message';
+import { CommunicationService } from '../cpe/communication-service';
+
+export default async function (rta: RuntimeAuthoring) {
+    const flexSettings = rta.getFlexSettings();
+    if (flexSettings.telemetry === true) {
+        enableTelemetry();
+    }
+
+    const ui5VersionInfo = await getUi5Version();
+
+    // Plugins need to be set before adding additional plugins to prevent overriding with the default
+    // and allow usage of getPlugins later in the flow
+    const defaultPlugins = rta.getDefaultPlugins();
+    rta.setPlugins(defaultPlugins);
+
+    if (isLowerThanMinimalUi5Version(ui5VersionInfo, { major: 1, minor: 136, patch: 2 })) {
+        await initDialogs(rta, ui5VersionInfo);
+    } else {
+        (await import('open/ux/preview/client/adp/add-fragment')).initAddXMLPlugin(rta);
+        (await import('open/ux/preview/client/adp/extend-controller')).initExtendControllerPlugin(rta);
+    }
+
+    if (!isLowerThanMinimalUi5Version(ui5VersionInfo, { major: 1, minor: 78 })) {
+        const ExtensionPointService = (await import('open/ux/preview/client/adp/extension-point')).default;
+        const extPointService = new ExtensionPointService(rta);
+        extPointService.init();
+    }
+
+    const manifest = rta.getRootControlInstance().getManifest();
+    const applicationType = getApplicationType(manifest);
+    const quickActionRegistries = await loadDefinitions(applicationType);
+
+    // Initialize OVP bridge functions if the application is an OVP app
+    if (manifest['sap.ovp']) {
+        const { initOvpWindowFunctions } = await import('open/ux/preview/client/adp/ovp-window-functions');
+        initOvpWindowFunctions();
+    }
+
+    await init(rta, quickActionRegistries);
+
+    // Register synchronious views detection and warning
+    // This is not awaited to prevent deadlock in the initialization
+    rta.getService<RTAOutlineService>('outline')
+        .then((outlineService) => {
+            outlineService.attachEvent('update', async () => {
+                await updateSyncViewsIds(ui5VersionInfo);
+                await showSyncViewsWarning();
+            });
+        })
+        .catch((error) => {
+            log.error('Failed to attach update event to outline service', error);
+        });
+
+    if (isLowerThanMinimalUi5Version(ui5VersionInfo)) {
+        await sendInfoCenterMessage({
+            title: { key: 'FLP_UI5_VERSION_WARNING_TITLE' },
+            description: {
+                key: 'FLP_UI5_VERSION_WARNING_DESCRIPTION',
+                params: [getFullyQualifiedUi5Version(ui5VersionInfo), getFullyQualifiedUi5Version(minVersionInfo)]
+            },
+            type: MessageBarType.error
+        });
+        CommunicationService.sendAction(toggleAppPreviewVisibility(false));
+        return;
+    }
+
+    log.debug('ADP init executed.');
+}

package/dist/preview-middleware/dist/client/adp/ovp-window-functions.js

@@ -0,0 +1,130 @@
+"use strict";
+
+sap.ui.define(["sap/base/Log", "sap/ui/model/odata/v2/ODataModel"], function (log, ODataModel) {
+  "use strict";
+
+  /**
+   * Returns the base URL for API requests.
+   *
+   * @returns Base URL string
+   */
+  function getBaseUrl() {
+    return document.getElementById('root')?.dataset.openUxPreviewBaseUrl ?? '';
+  }
+
+  /**
+   * Creates a UI5 ODataModel with annotation URLs and returns its metamodel
+   * with entity containers, schema, and model information.
+   *
+   * @param serviceInfo Service URL and annotation details from the server
+   * @returns Promise resolving to a metamodel object
+   */
+  async function buildMetaModel(serviceInfo) {
+    const annotationUris = serviceInfo.annotations.map(a => a.Uri);
+    const model = new ODataModel(serviceInfo.serviceUrl, {
+      annotationURI: annotationUris,
+      loadAnnotationsJoined: true,
+      skipMetadataAnnotationParsing: false,
+      json: true
+    });
+    const metaModel = model.getMetaModel();
+    await metaModel.loaded();
+    return {
+      oEntityContainers: metaModel.getODataEntityContainer(),
+      oSchema: metaModel.getObject('/dataServices/schema'),
+      modelInformation: serviceInfo.modelInformation
+    };
+  }
+
+  /**
+   * Writes i18n entries to the adaptation project's i18n properties file.
+   * Fire-and-forget: the OVP runtime does not await the result.
+   *
+   * @param _path - i18n path (ignored; server resolves from project context)
+   * @param properties - Array of i18n key-value entries to write
+   */
+  function writeToI18n(_path, properties) {
+    const entries = properties.map(p => ({
+      key: p.key,
+      value: p.value,
+      annotation: p.textType
+    }));
+    fetch(`${getBaseUrl()}/editor/i18n`, {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json'
+      },
+      body: JSON.stringify(entries)
+    }).catch(error => {
+      log.error('OVP writeToI18n failed', error);
+    });
+  }
+
+  /**
+   * Fetches available OData V2 services from the ABAP system catalog.
+   *
+   * @param _path - Application path (ignored; server uses its own provider)
+   * @returns Promise resolving to an object with a results array of service metadata
+   */
+  async function getNewDataSources(_path) {
+    const response = await fetch(`${getBaseUrl()}/adp/api/ovp/datasources`);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch data sources: ${response.status}`);
+    }
+    return response.json();
+  }
+
+  /**
+   * Fetches the OData metadata model for a selected data source service.
+   * Creates a real UI5 ODataModel with annotations to build a full metamodel
+   * compatible with the OVP dialog.
+   *
+   * @param selectedDataSources - Array of selected data source objects
+   * @param _path - Application path (ignored; server uses its own provider)
+   * @returns Promise resolving to a metamodel object
+   */
+  async function getMetaModelForNewDataSource(selectedDataSources, _path) {
+    const response = await fetch(`${getBaseUrl()}/adp/api/ovp/metamodel`, {
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json'
+      },
+      body: JSON.stringify({
+        dataSource: selectedDataSources[0]
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to fetch metamodel: ${response.status}`);
+    }
+    const serviceInfo = await response.json();
+    if (!serviceInfo) {
+      return undefined;
+    }
+    return buildMetaModel(serviceInfo);
+  }
+
+  /**
+   * Initializes OVP bridge functions required by the sap.ovp library for the
+   * "Add New Card" flow in the adaptation editor.
+   *
+   * These bridge functions are registered as globals on the window object
+   * and connect the OVP runtime (in the preview iframe) to the server-side
+   * adaptation tooling middleware via fetch requests.
+   */
+  function initOvpWindowFunctions() {
+    // OVP runtime expects these as window globals
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.writeToI18n = writeToI18n;
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.getNewDataSources = getNewDataSources;
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.getMetaModelForNewDataSource = getMetaModelForNewDataSource;
+    log.info('OVP bridge functions initialized (writeToI18n, getNewDataSources, getMetaModelForNewDataSource)');
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.initOvpWindowFunctions = initOvpWindowFunctions;
+  return __exports;
+});
+//# sourceMappingURL=ovp-window-functions.js.map

package/dist/preview-middleware/dist/client/adp/ovp-window-functions.ts

@@ -0,0 +1,171 @@
+import log from 'sap/base/Log';
+import ODataModel from 'sap/ui/model/odata/v2/ODataModel';
+
+interface I18nProperty {
+    key: string;
+    value: string;
+    textType?: string;
+}
+
+interface DataSourceInfo {
+    ID: string;
+    Title: string;
+    Description?: string;
+    TechnicalServiceName?: string;
+    TechnicalServiceVersion?: number;
+    ServiceUrl?: string;
+    MetadataUrl?: string;
+}
+
+interface DataSourcesResponse {
+    results: DataSourceInfo[];
+}
+
+interface ServiceInfoResponse {
+    serviceUrl: string;
+    annotations: Array<{ TechnicalName: string; Uri: string }>;
+    modelInformation: OvpModelInformation;
+}
+
+interface OvpModelInformation {
+    serviceURI: string;
+    serviceAnnotation: string;
+    serviceAnnotationURI: string;
+}
+
+interface OvpMetaModelResult {
+    oEntityContainers: Record<string, unknown>;
+    oSchema: Record<string, unknown>[];
+    modelInformation: OvpModelInformation;
+}
+
+declare global {
+    interface Window {
+        writeToI18n: (path: string, properties: I18nProperty[]) => void;
+        getNewDataSources: (path: string) => Promise<DataSourcesResponse>;
+        getMetaModelForNewDataSource: (
+            selectedDataSources: DataSourceInfo[],
+            path: string
+        ) => Promise<OvpMetaModelResult | undefined>;
+    }
+}
+
+/**
+ * Returns the base URL for API requests.
+ *
+ * @returns Base URL string
+ */
+function getBaseUrl(): string {
+    return document.getElementById('root')?.dataset.openUxPreviewBaseUrl ?? '';
+}
+
+/**
+ * Creates a UI5 ODataModel with annotation URLs and returns its metamodel
+ * with entity containers, schema, and model information.
+ *
+ * @param serviceInfo Service URL and annotation details from the server
+ * @returns Promise resolving to a metamodel object
+ */
+async function buildMetaModel(serviceInfo: ServiceInfoResponse): Promise<OvpMetaModelResult> {
+    const annotationUris = serviceInfo.annotations.map((a) => a.Uri);
+
+    const model = new ODataModel(serviceInfo.serviceUrl, {
+        annotationURI: annotationUris,
+        loadAnnotationsJoined: true,
+        skipMetadataAnnotationParsing: false,
+        json: true
+    });
+
+    const metaModel = model.getMetaModel();
+    await metaModel.loaded();
+
+    return {
+        oEntityContainers: metaModel.getODataEntityContainer() as Record<string, unknown>,
+        oSchema: metaModel.getObject('/dataServices/schema') as Record<string, unknown>[],
+        modelInformation: serviceInfo.modelInformation
+    };
+}
+
+/**
+ * Writes i18n entries to the adaptation project's i18n properties file.
+ * Fire-and-forget: the OVP runtime does not await the result.
+ *
+ * @param _path - i18n path (ignored; server resolves from project context)
+ * @param properties - Array of i18n key-value entries to write
+ */
+function writeToI18n(_path: string, properties: I18nProperty[]): void {
+    const entries = properties.map((p) => ({
+        key: p.key,
+        value: p.value,
+        annotation: p.textType
+    }));
+    fetch(`${getBaseUrl()}/editor/i18n`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(entries)
+    }).catch((error) => {
+        log.error('OVP writeToI18n failed', error);
+    });
+}
+
+/**
+ * Fetches available OData V2 services from the ABAP system catalog.
+ *
+ * @param _path - Application path (ignored; server uses its own provider)
+ * @returns Promise resolving to an object with a results array of service metadata
+ */
+async function getNewDataSources(_path: string): Promise<DataSourcesResponse> {
+    const response = await fetch(`${getBaseUrl()}/adp/api/ovp/datasources`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch data sources: ${response.status}`);
+    }
+    return response.json();
+}
+
+/**
+ * Fetches the OData metadata model for a selected data source service.
+ * Creates a real UI5 ODataModel with annotations to build a full metamodel
+ * compatible with the OVP dialog.
+ *
+ * @param selectedDataSources - Array of selected data source objects
+ * @param _path - Application path (ignored; server uses its own provider)
+ * @returns Promise resolving to a metamodel object
+ */
+async function getMetaModelForNewDataSource(
+    selectedDataSources: DataSourceInfo[],
+    _path: string
+): Promise<OvpMetaModelResult | undefined> {
+    const response = await fetch(`${getBaseUrl()}/adp/api/ovp/metamodel`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ dataSource: selectedDataSources[0] })
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch metamodel: ${response.status}`);
+    }
+    const serviceInfo = (await response.json()) as ServiceInfoResponse | null;
+    if (!serviceInfo) {
+        return undefined;
+    }
+    return buildMetaModel(serviceInfo);
+}
+
+/**
+ * Initializes OVP bridge functions required by the sap.ovp library for the
+ * "Add New Card" flow in the adaptation editor.
+ *
+ * These bridge functions are registered as globals on the window object
+ * and connect the OVP runtime (in the preview iframe) to the server-side
+ * adaptation tooling middleware via fetch requests.
+ */
+export function initOvpWindowFunctions(): void {
+    // OVP runtime expects these as window globals
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.writeToI18n = writeToI18n;
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.getNewDataSources = getNewDataSources;
+    // eslint-disable-next-line @sap-ux/fiori-tools/sap-no-global-define
+    window.getMetaModelForNewDataSource = getMetaModelForNewDataSource;
+
+    log.info('OVP bridge functions initialized (writeToI18n, getNewDataSources, getMetaModelForNewDataSource)');
+}