@sap-ux/fiori-mcp-server 0.0.1

package/dist/page-editor-api/parser/model/utils/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./annotations"), exports);
+__exportStar(require("./i18n"), exports);
+__exportStar(require("./object"), exports);
+__exportStar(require("./sort"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/page-editor-api/parser/model/utils/object.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Method checks if arrays are same - check is performed without deep equality.
+ *
+ * @param arr1 - First array.
+ * @param arr2 - Second array.
+ * @returns Is arrays are same.
+ */
+export declare const isArrayEqual: (arr1: Array<unknown> | null | undefined, arr2: Array<unknown> | null | undefined) => boolean;
+/**
+ * Method checks if array 'arr1' ends with all entries from 'arr2'.
+ *
+ * @param arr1 - First array.
+ * @param arr2 - Second array.
+ * @returns Is 'arr1' ends with entries from 'arr2'.
+ */
+export declare const isArrayEndsWith: <T>(arr1: Array<T> | null, arr2: Array<T> | null) => boolean;
+/**
+ * Method to get value for passed path in passed object.
+ *
+ * @param obj - Object to use.
+ * @param paths - Path for searching property/value.
+ * @returns Found value for passed path.
+ */
+export declare const getProperty: (obj: object, paths: Array<string | number>) => unknown;
+//# sourceMappingURL=object.d.ts.map

package/dist/page-editor-api/parser/model/utils/object.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProperty = exports.isArrayEndsWith = exports.isArrayEqual = void 0;
+/**
+ * Method checks if arrays are same - check is performed without deep equality.
+ *
+ * @param arr1 - First array.
+ * @param arr2 - Second array.
+ * @returns Is arrays are same.
+ */
+const isArrayEqual = (arr1, arr2) => {
+    if (!arr1 || !arr2) {
+        return arr1 === arr2;
+    }
+    return (arr1.length === arr2.length &&
+        arr1.every(function (value, index) {
+            return value === arr2[index];
+        }));
+};
+exports.isArrayEqual = isArrayEqual;
+/**
+ * Method checks if array 'arr1' ends with all entries from 'arr2'.
+ *
+ * @param arr1 - First array.
+ * @param arr2 - Second array.
+ * @returns Is 'arr1' ends with entries from 'arr2'.
+ */
+const isArrayEndsWith = (arr1, arr2) => {
+    if (!arr1 || !arr2 || arr2.length > arr1.length) {
+        return false;
+    }
+    let index1 = arr1.length - 1;
+    let index2 = arr2.length - 1;
+    while (index2 >= 0) {
+        if (arr2[index2] !== arr1[index1]) {
+            return false;
+        }
+        index1--;
+        index2--;
+    }
+    return true;
+};
+exports.isArrayEndsWith = isArrayEndsWith;
+/**
+ * Method to get value for passed path in passed object.
+ *
+ * @param obj - Object to use.
+ * @param paths - Path for searching property/value.
+ * @returns Found value for passed path.
+ */
+const getProperty = (obj, paths) => {
+    let current = obj;
+    for (const path of paths) {
+        if (path === undefined) {
+            continue;
+        }
+        if (typeof current === 'object' && path in current) {
+            // found and continue
+            current = current[path];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+};
+exports.getProperty = getProperty;
+//# sourceMappingURL=object.js.map

package/dist/page-editor-api/parser/model/utils/sort.d.ts

@@ -0,0 +1,31 @@
+import type { ObjectAggregation } from '../ObjectAggregation';
+export declare enum SortReferencePosition {
+    After = "After",
+    Before = "Before",
+    Replace = "Replace"
+}
+export interface ReordableAggregations<T extends ObjectAggregation> {
+    [key: string]: T;
+}
+export interface RelationPosition {
+    anchor?: string | null;
+    placement?: string | null;
+    position?: SortReferencePosition;
+}
+export interface SiblingPosition<T extends ObjectAggregation> {
+    id: string;
+    order: number;
+    aggregation: T;
+}
+export interface DefaultExtensionPosition {
+    position?: {
+        anchor?: string | null;
+        placement?: string | null;
+    };
+}
+export declare enum SortingApproach {
+    Normal = "Normal",
+    WithIds = "WithIds",
+    WithIndices = "WithIndices"
+}
+//# sourceMappingURL=sort.d.ts.map

package/dist/page-editor-api/parser/model/utils/sort.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortingApproach = exports.SortReferencePosition = void 0;
+var SortReferencePosition;
+(function (SortReferencePosition) {
+    SortReferencePosition["After"] = "After";
+    SortReferencePosition["Before"] = "Before";
+    SortReferencePosition["Replace"] = "Replace";
+})(SortReferencePosition || (exports.SortReferencePosition = SortReferencePosition = {}));
+// In V2 we can not reffer custom extenstion to another custom extension
+// In result we have two sorting approaches
+var SortingApproach;
+(function (SortingApproach) {
+    SortingApproach["Normal"] = "Normal";
+    SortingApproach["WithIds"] = "WithIds";
+    SortingApproach["WithIndices"] = "WithIndices";
+})(SortingApproach || (exports.SortingApproach = SortingApproach = {}));
+//# sourceMappingURL=sort.js.map

package/dist/page-editor-api/parser/model/utils/utils.d.ts

@@ -0,0 +1,94 @@
+import type { TranslationBundles, PropertyPath, PropertyMessage } from '../types';
+import type { JSONSchema4 } from 'json-schema';
+import type { ObjectAggregation } from '../ObjectAggregation';
+import type { ProjectType } from '@sap-ux/project-access';
+export interface AppTranslationBundleData {
+    bundles: TranslationBundles;
+    projectType?: ProjectType;
+}
+/**
+ * Method returns application specific i18n bundle data.
+ *
+ * @returns i18n bundle data.
+ */
+export declare const getAppI18nBundle: () => AppTranslationBundleData;
+export declare const getTechnicalIdFromPath: (path: PropertyPath, firstOnly?: boolean) => string | undefined;
+/**
+ * Method disables deletion of last annotation node if there is any custom nodes.
+ * There can be cases when custom nodes referenced to last annotation node and by deleting last annotation node, we can not provide correct order.
+ *
+ * @param aggregation Container aggregation.
+ * @param text I18n key for disabled deletion explanation.
+ */
+export declare const ensureLastNodeIsUndeletable: (aggregation: ObjectAggregation, text: string) => void;
+/**
+ * Function validates extension using validation parameter by setting warning message to aggregation.
+ *
+ * @param aggregation aggregation for which to set warning message.
+ * @param isValid validation result.
+ * @param description description to show in case extension is invalid.
+ * @param property name of the property
+ */
+export declare const validateExtension: (aggregation: ObjectAggregation, isValid: boolean, description: string, property?: string) => void;
+/**
+ * Function validates macros extension key by checking aggregation value of it.
+ *
+ * @param aggregation aggregation for which to set warning message.
+ * @param value value of custom extension aggregation.
+ */
+export declare const validateMacrosExtension: (aggregation: ObjectAggregation, value?: unknown) => void;
+/**
+ * Method which formats and returns display/description text for anchor selection option.
+ * Method resolves i18n translation for text if translation exists.
+ *
+ * @param i18nKey I18n entry for option.
+ * @param aggregation Object aggregation.
+ * @param text Anchor label without i18n resolution.
+ * @param id Anchor ID.
+ * @returns Formatted text for related anchor option.
+ */
+export declare const formatAnchorDescriptionText: (i18nKey: string, aggregation: ObjectAggregation, text: string, id?: string) => string;
+/**
+ * Method which receives 'oneOf' entries from schema and converts to dropdown option entries.
+ *
+ * @param i18nKey I18n entry for option.
+ * @param aggregation Object aggregation.
+ * @param oneOf One of entries from schema.
+ * @returns Options for dropdown.
+ */
+export declare const oneOfToDropdownOptions: (i18nKey: string, aggregation: ObjectAggregation, oneOf?: JSONSchema4[]) => {
+    key: string;
+    text: string;
+}[];
+/**
+ * Method returns updated schema for anchor property.
+ * Method hides enum entry which is associated with passed aggregation to avoid anchoring extension to itself.
+ *
+ * @param aggregation Aggregation object.
+ * @param originalSchema Schema of anchor property.
+ * @returns Modified schema.
+ */
+export declare const updateAnchorSchema: (aggregation: ObjectAggregation, originalSchema: JSONSchema4) => JSONSchema4;
+/**
+ * Method adds validation message to property or node instance.
+ *
+ * @param instance Property or node instance.
+ * @param instance.messages Messages of instance.
+ * @param messages Array of validation messages.
+ */
+export declare function addValidationMessages(instance: {
+    messages?: PropertyMessage[];
+}, messages: PropertyMessage[]): void;
+/**
+ * Converts a string into "Start Case" format.
+ *
+ * - Splits words on underscores (`_`), hyphens (`-`), and spaces.
+ * - Detects camelCase boundaries (`fooBar` → `Foo Bar`).
+ * - Capitalizes the first character of each word.
+ * - Preserves acronyms (`FCL`, `WORLD`) when they appear in uppercase.
+ *
+ * @param text - The input string to convert.
+ * @returns The formatted string in start case.
+ */
+export declare function startCase(text: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/page-editor-api/parser/model/utils/utils.js

@@ -0,0 +1,267 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateAnchorSchema = exports.oneOfToDropdownOptions = exports.formatAnchorDescriptionText = exports.validateMacrosExtension = exports.validateExtension = exports.ensureLastNodeIsUndeletable = exports.getTechnicalIdFromPath = exports.getAppI18nBundle = void 0;
+exports.addValidationMessages = addValidationMessages;
+exports.startCase = startCase;
+const i18next_1 = __importDefault(require("i18next"));
+const types_1 = require("../types");
+const i18n_1 = require("./i18n");
+/**
+ * Method returns application specific i18n bundle data.
+ *
+ * @returns i18n bundle data.
+ */
+const getAppI18nBundle = () => {
+    return {
+        bundles: {
+            annotation: {},
+            app: {},
+            service: {},
+            ui5: {}
+        }
+    };
+};
+exports.getAppI18nBundle = getAppI18nBundle;
+const getTechnicalIdFromPath = (path, firstOnly = false) => {
+    const key = path[path.length - 1];
+    if (key) {
+        let id = key.toString();
+        const separator = id.includes(':::') ? ':::' : '::';
+        const parts = key.toString().split(separator);
+        id = parts[0];
+        if (!firstOnly && parts.length > 1) {
+            // remove first entry
+            parts.splice(0, 1);
+            id = parts.join('/');
+        }
+        if (id) {
+            return id;
+        }
+    }
+};
+exports.getTechnicalIdFromPath = getTechnicalIdFromPath;
+/**
+ * Method disables deletion of last annotation node if there is any custom nodes.
+ * There can be cases when custom nodes referenced to last annotation node and by deleting last annotation node, we can not provide correct order.
+ *
+ * @param aggregation Container aggregation.
+ * @param text I18n key for disabled deletion explanation.
+ */
+const ensureLastNodeIsUndeletable = (aggregation, text) => {
+    // Find if there is very last node
+    // Should be undefined if there is two annotation nodes
+    let lastNativeNode;
+    let nativeNodes = 0;
+    let customNodeExists = false;
+    for (const key in aggregation.aggregations) {
+        if (!aggregation.aggregations[key].custom) {
+            lastNativeNode = nativeNodes > 0 ? undefined : aggregation.aggregations[key];
+            nativeNodes++;
+        }
+        else {
+            customNodeExists = true;
+        }
+    }
+    // Check if signle and last annotation node exists with actions
+    if (!customNodeExists || !lastNativeNode?.actions) {
+        return;
+    }
+    // Find deletion action
+    const index = lastNativeNode.actions.findIndex((action) => action === types_1.AggregationActions.Delete ||
+        (typeof action === 'object' && action.type === types_1.AggregationActions.Delete));
+    if (index !== -1) {
+        let deleteAction = lastNativeNode.actions[index];
+        if (typeof deleteAction !== 'object') {
+            // Simple string - make object which allow to disable action
+            deleteAction = {
+                type: deleteAction
+            };
+        }
+        // Disable actiondeletion
+        deleteAction.disabled = true;
+        deleteAction.title = i18next_1.default.t(text);
+        lastNativeNode.actions[index] = deleteAction;
+    }
+};
+exports.ensureLastNodeIsUndeletable = ensureLastNodeIsUndeletable;
+/**
+ * Function validates extension using validation parameter by setting warning message to aggregation.
+ *
+ * @param aggregation aggregation for which to set warning message.
+ * @param isValid validation result.
+ * @param description description to show in case extension is invalid.
+ * @param property name of the property
+ */
+const validateExtension = (aggregation, isValid, description, property) => {
+    if (!isValid) {
+        aggregation.state = types_1.ValidationState.Invalid;
+        aggregation.messages = [
+            {
+                text: description,
+                type: types_1.PropertyMessageType.Warning
+            }
+        ];
+        aggregation.inactive = true;
+        if (property && aggregation.properties[property]) {
+            addValidationMessages(aggregation.properties[property], [{ text: description }]);
+        }
+    }
+};
+exports.validateExtension = validateExtension;
+/**
+ * Function validates macros extension key by checking aggregation value of it.
+ *
+ * @param aggregation aggregation for which to set warning message.
+ * @param value value of custom extension aggregation.
+ */
+const validateMacrosExtension = (aggregation, value = aggregation.value) => {
+    const extensionValue = value && typeof value === 'object' ? value : {};
+    const isKeyDefined = 'key' in extensionValue && !!extensionValue.key;
+    // validate custom extension key
+    (0, exports.validateExtension)(aggregation, isKeyDefined, i18next_1.default.t('PAGE_EDITOR_CUSTOM_EXTENSION_NO_KEY'), 'key');
+};
+exports.validateMacrosExtension = validateMacrosExtension;
+/**
+ * Method which formats and returns display/description text for anchor selection option.
+ * Method resolves i18n translation for text if translation exists.
+ *
+ * @param i18nKey I18n entry for option.
+ * @param aggregation Object aggregation.
+ * @param text Anchor label without i18n resolution.
+ * @param id Anchor ID.
+ * @returns Formatted text for related anchor option.
+ */
+const formatAnchorDescriptionText = (i18nKey, aggregation, text, id) => {
+    const appI18n = (0, exports.getAppI18nBundle)();
+    const i18nBundle = (0, i18n_1.getRelevantI18nBundle)(aggregation, appI18n.bundles, appI18n.projectType);
+    const label = (0, i18n_1.resolveI18nValue)(text, i18nBundle) || text;
+    return id
+        ? i18next_1.default.t(i18nKey, {
+            id,
+            label
+        })
+        : label;
+};
+exports.formatAnchorDescriptionText = formatAnchorDescriptionText;
+/**
+ * Method which receives 'oneOf' entries from schema and converts to dropdown option entries.
+ *
+ * @param i18nKey I18n entry for option.
+ * @param aggregation Object aggregation.
+ * @param oneOf One of entries from schema.
+ * @returns Options for dropdown.
+ */
+const oneOfToDropdownOptions = (i18nKey, aggregation, oneOf = []) => {
+    return oneOf
+        .filter((entry) => !entry.hidden)
+        .map((option, index) => {
+        const text = option.description || option.const || index.toString();
+        return {
+            key: option.const || index.toString(),
+            text: (0, exports.formatAnchorDescriptionText)(i18nKey, aggregation, text, option.const)
+        };
+    });
+};
+exports.oneOfToDropdownOptions = oneOfToDropdownOptions;
+/**
+ * Method returns updated schema for anchor property.
+ * Method hides enum entry which is associated with passed aggregation to avoid anchoring extension to itself.
+ *
+ * @param aggregation Aggregation object.
+ * @param originalSchema Schema of anchor property.
+ * @returns Modified schema.
+ */
+const updateAnchorSchema = (aggregation, originalSchema) => {
+    const anchor = aggregation.name === 'position' ? aggregation.parent?.name : aggregation.name;
+    if (originalSchema.enum) {
+        // Copy to avoid sharing same reference across other custom columns
+        const schema = { ...originalSchema, enum: [...originalSchema.enum] };
+        // Handle enum
+        const index = schema.enum.findIndex((entry) => entry === anchor);
+        if (index !== -1) {
+            schema.enum.splice(index, 1);
+        }
+        return schema;
+    }
+    else if (originalSchema.oneOf) {
+        const appI18n = (0, exports.getAppI18nBundle)();
+        // Copy to avoid sharing same reference across other custom columns
+        const schema = { ...originalSchema, oneOf: [...originalSchema.oneOf] };
+        // Handle oneOf
+        for (let i = 0; i < schema.oneOf.length; i++) {
+            const entry = schema.oneOf[i];
+            entry.bundle = (0, i18n_1.getI18nBundleName)(entry.custom, true, !!entry.annotationNodeId, appI18n.projectType);
+            // Hide anchors which refers to itself
+            if (entry.const === anchor) {
+                schema.oneOf[i] = {
+                    ...entry,
+                    hidden: true
+                };
+            }
+        }
+        return schema;
+    }
+    return originalSchema;
+};
+exports.updateAnchorSchema = updateAnchorSchema;
+/**
+ * Method adds validation message to property or node instance.
+ *
+ * @param instance Property or node instance.
+ * @param instance.messages Messages of instance.
+ * @param messages Array of validation messages.
+ */
+function addValidationMessages(instance, messages) {
+    instance.messages ??= [];
+    instance.messages.push(...messages);
+}
+/**
+ * Converts a string into "Start Case" format.
+ *
+ * - Splits words on underscores (`_`), hyphens (`-`), and spaces.
+ * - Detects camelCase boundaries (`fooBar` → `Foo Bar`).
+ * - Capitalizes the first character of each word.
+ * - Preserves acronyms (`FCL`, `WORLD`) when they appear in uppercase.
+ *
+ * @param text - The input string to convert.
+ * @returns The formatted string in start case.
+ */
+function startCase(text) {
+    let result = '';
+    let capitalizeNext = true;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        // Treat separators as spaces
+        if (char === '_' || char === '-' || char === ' ') {
+            if (!result.endsWith(' ')) {
+                result += ' ';
+            }
+            capitalizeNext = true;
+            continue;
+        }
+        const prev = text[i - 1];
+        const next = text[i + 1];
+        // Insert space before camelCase or acronym boundaries
+        if (i > 0 &&
+            // lower → UPPER (camelCase)
+            ((prev >= 'a' && prev <= 'z' && char >= 'A' && char <= 'Z') ||
+                // acronym → next word (like FCLTo)
+                (prev >= 'A' && prev <= 'Z' && char >= 'A' && char <= 'Z' && next && next >= 'a' && next <= 'z'))) {
+            result += ' ';
+            capitalizeNext = true;
+        }
+        // Apply capitalization inline
+        if (capitalizeNext) {
+            result += char.toUpperCase();
+            capitalizeNext = false;
+        }
+        else {
+            result += char;
+        }
+    }
+    return result.trim();
+}
+//# sourceMappingURL=utils.js.map

package/dist/page-editor-api/parser/model/views/ViewAggregation.d.ts

@@ -0,0 +1,62 @@
+import type { JSONSchema4 } from 'json-schema';
+import { ObjectAggregation } from '../ObjectAggregation';
+import type { PageEditAggregationData } from '../ObjectAggregation';
+import { AggregationActions, SortingOptions } from '../types';
+import type { PageData, PropertyPath, PageAnnotations } from '../types';
+import type { PageConfig, PageType } from '@sap/ux-specification/dist/types/src';
+/**
+ * Represents an aggregation for view objects.
+ */
+export declare class ViewAggregation extends ObjectAggregation {
+    private title?;
+    actions: AggregationActions[];
+    sortableItem: SortingOptions | undefined;
+    sortableCollection: string | undefined;
+    /**
+     * Creates an instance of `ViewAggregation`.
+     *
+     * @param data Optional aggregation data object used to initialize properties.
+     * @param schema Optional JSON schema fragment associated with this aggregation.
+     */
+    constructor(data?: PageEditAggregationData, schema?: JSONSchema4);
+    /**
+     * Method returns display name of aggregation without applying i18n translation.
+     * Overwritten for column handling.
+     *
+     * @returns Display name of aggregation.
+     */
+    protected getRawDisplayName(): string;
+    /**
+     * Public method to mark view as custom action.
+     */
+    markAsCustomView(): void;
+    /**
+     * Overwritten method for data update of list report view.
+     *
+     * @param data Data which should be used for value population.
+     * @param page Page config data.
+     * @param pageType Page type.
+     * @param path Aggregation path.
+     * @param annotations Annotations data.
+     */
+    updatePropertiesValues(data: PageData, page: PageConfig, pageType: PageType, path: PropertyPath, annotations: PageAnnotations | undefined): void;
+    /**
+     * Method returns true if view aggregation is table view.
+     *
+     * @returns True if view is table view.
+     */
+    private isTableView;
+    /**
+     * Method returns true if view aggregation is chart view.
+     *
+     * @returns True if view is chart view.
+     */
+    private isChartView;
+    /**
+     * Method returns true if aggregation is annotation view.
+     *
+     * @returns True if view is annotation view.
+     */
+    isAnnotationView(): boolean;
+}
+//# sourceMappingURL=ViewAggregation.d.ts.map