@sap-ux/fiori-mcp-server 0.0.1

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

@@ -0,0 +1,13 @@
+import type { ArtifactType } from '@sap/ux-specification/dist/types/src';
+import type { Range } from '@sap-ux/text-document-utils';
+export interface Location {
+    fileUri: string;
+    range: Range;
+    relative?: boolean;
+    type?: ArtifactType;
+}
+export interface AllowedMoveRange {
+    from: number;
+    to: number;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/page-editor-api/parser/model/types/common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1,220 @@
+import type { ArtifactType } from '@sap/ux-specification/dist/types/src';
+import { v2 } from '@sap/ux-specification/dist/types/src';
+import type { JSONSchema4 } from 'json-schema';
+import type { I18nBundle } from '@sap-ux/i18n';
+import type { AllowedMoveRange, Location } from './common';
+import type { UIDialogsContext, UINode } from './annotations';
+export * from './annotations';
+export * from './common';
+export declare const DATA_FIELD_ACTION = "DataFieldForAction";
+export declare const DATA_FIELD_FOR_INTENT_BASED_NAVIGATION = "DataFieldForIntentBasedNavigation";
+export declare const DATA_FIELD_FOR_ACTION_GROUP = "DataFieldForActionGroup";
+export declare const ANNOTATION_TYPES_SEPARATOR = "::";
+export declare const CUSTOM_VIEW_PREFIX = "customView(";
+export interface PageData {
+    [key: string]: unknown;
+}
+export declare enum AggregationCreationForm {
+    AnalyticalChart = "AnalyticalChart",
+    AnalyticalChartView = "AnalyticalChartView",
+    ChartSection = "ChartSection",
+    CustomAction = "CustomAction",
+    CustomSection = "CustomSection",
+    CustomColumn = "CustomColumn",
+    CustomColumnV4 = "CustomColumnV4",
+    CustomViewV4 = "CustomViewV4",
+    DataPointSection = "DataPointSection",
+    Generic = "Generic",
+    MacrosChart = "MacrosChart",
+    MacrosFilterBar = "MacrosFilterBar",
+    MacrosTable = "MacrosTable",
+    NativeAction = "NativeAction",
+    NativeNavigation = "NativeNavigation",
+    NativeBasicColumn = "Basic",
+    NativeChartColumn = "Chart",
+    NativeContactColumn = "Contact",
+    NativeContactField = "NativeContactField",
+    NativeConnectedFields = "NativeConnectedFields",
+    NativeField = "NativeField",
+    NativeFilterFields = "NativeFilterFields",
+    NativeVisualFilters = "NativeVisualFilters",
+    NativeGroupSection = "NativeGroupSection",
+    NativeIdentification = "NativeIdentification",
+    NativeRatingColumn = "Rating",
+    NativeProgressColumn = "Progress",
+    NativeSection = "NativeSection",
+    NativeTableSection = "NativeTableSection",
+    ProgressSection = "ProgressSection",
+    RatingSection = "RatingSection",
+    TableView = "TableView",
+    CustomSubSection = "CustomSubSection",
+    CustomHeaderSection = "CustomHeaderSection",
+    CustomFilterField = "CustomFilterField"
+}
+export declare const CUSTOM_AGGREGATION_FORMS: AggregationCreationForm[];
+export declare const enum TableColumnExtensionType {
+    ResponsiveTableColumnsExtension = "ResponsiveTableColumnsExtension",
+    AnalyticalTableColumnsExtension = "AnalyticalTableColumnsExtension",
+    TreeTableColumnsExtension = "TreeTableColumnsExtension",
+    GridTableColumnsExtension = "GridTableColumnsExtension"
+}
+export declare const TABLE_TYPE_EXTENSION_MAP: Map<v2.TableTypeV2, TableColumnExtensionType>;
+export declare const ANNOTATION_CREATION_FORM = "annotation";
+export declare const SCHEMA_CREATION_FORM = "schema";
+export declare const EXTERNAL_CREATION_FORM = "external";
+export declare const FacetTitlePrefix = "Facet ID: ";
+export type CreationFormKind = typeof ANNOTATION_CREATION_FORM | typeof SCHEMA_CREATION_FORM | typeof EXTERNAL_CREATION_FORM;
+export interface CreationFormOptions {
+    name: AggregationCreationForm;
+    kind: CreationFormKind;
+    /**
+     * i18n key for the title
+     */
+    title: string;
+    tooltip?: string;
+    disabled: boolean;
+    /**
+     * Title when form disabled
+     */
+    disabledTitle?: string;
+    visualizationIcon?: string;
+    aggregationName?: string;
+    buttonText?: string;
+    buttonId?: string;
+}
+export declare const EXTENSION_TABLE_TYPE_MAP: Map<TableColumnExtensionType, v2.TableTypeV2>;
+export declare enum PropertiesType {
+    Flat = 0,
+    AnyOf = 1
+}
+export declare enum SortingOptions {
+    Enabled = "Enabled",
+    Excluded = "Excluded",
+    Readonly = "Readonly"
+}
+export declare enum AggregationType {
+    Object = "Object",
+    Array = "Array"
+}
+export declare enum AggregationActions {
+    Delete = "Delete",
+    OpenSource = "OpenSource",
+    Edit = "Edit"
+}
+export interface AggregationSubAction {
+    id: string;
+    text: string;
+}
+export interface SupportedAggregationAction {
+    type: AggregationActions;
+    disabled?: boolean;
+    title?: string;
+    subActions?: AggregationSubAction[];
+}
+export type SupportedAggregationActions = Array<SupportedAggregationAction | AggregationActions>;
+export declare enum AggregationSortBy {
+    ViewNode = "ViewNode"
+}
+export declare enum PendingChange {
+    Creation = "Creation",
+    MoveDnD = "MoveDnD",
+    MoveButton = "MoveButton"
+}
+interface ModelParserDefinitions {
+    [key: string]: JSONSchema4;
+}
+export interface ParserContext {
+    filePath?: string;
+}
+type ModelParserMethod<T> = (aggregation: T, currentNode: JSONSchema4, currentAnnotationNode: UINode | undefined, name: string | undefined, path: PropertyPath, parserContext: ParserContext) => void;
+export interface ModelParserParams<T> {
+    parse: ModelParserMethod<T>;
+    definitions: ModelParserDefinitions;
+    annotations?: PageAnnotations;
+}
+export interface AllowedDropAggregation {
+    path: PropertyPath;
+    range?: AllowedMoveRange[];
+}
+export type PropertyPath = Array<string | number>;
+export declare enum ValidationState {
+    Valid = 0,
+    Invalid = 1,
+    Skipped = 2,
+    ReadOnly = 3
+}
+export interface PageAnnotations {
+    nodes: UINode[];
+    dynamicNodes: {
+        [nodeId: string]: UINode;
+    };
+    dialogsContext?: UIDialogsContext;
+    errorMessage?: string;
+}
+export declare enum PropertyMessageType {
+    /**
+     * Reports an error.
+     */
+    Error = "error",
+    /**
+     * Reports a warning.
+     */
+    Warning = "warning",
+    /**
+     * Reports an information.
+     */
+    Info = "info"
+}
+export interface PropertyMessage {
+    type?: PropertyMessageType;
+    text: string;
+    dialogText?: string;
+    location?: Location;
+    deletable?: boolean;
+    preventMessagePropagation?: boolean;
+}
+export interface SettingOption {
+    schema: JSONSchema4;
+    value?: unknown;
+    pattern?: string;
+    description?: string;
+    state?: ValidationState;
+    isAtomic?: boolean;
+    i18nClassification?: string;
+    name: string;
+    freeText?: boolean;
+    artifactType?: ArtifactType;
+    required?: boolean;
+    minimum?: number;
+    messages?: PropertyMessage[];
+    locations?: Location[];
+    disabled?: boolean;
+    displayName?: string;
+}
+export interface CustomNodeAnnotationTarget {
+    control: string;
+    customSectionKey?: string;
+    navProperty?: string;
+    qualifier?: string;
+}
+export declare const SAP_ANNOTATION_NAMESPACE = "@com.sap.vocabularies.UI.v1";
+export declare const TRANSLATION_BUNDLE_APP = "app";
+export declare const TRANSLATION_BUNDLE_ANNOTATION = "annotation";
+export declare const TRANSLATION_BUNDLE_SERVICE = "service";
+export declare const TRANSLATION_BUNDLE_UI5 = "ui5";
+export interface TranslationBundles {
+    [TRANSLATION_BUNDLE_APP]: I18nBundle;
+    [TRANSLATION_BUNDLE_ANNOTATION]: I18nBundle;
+    [TRANSLATION_BUNDLE_UI5]: I18nBundle;
+    [TRANSLATION_BUNDLE_SERVICE]: I18nBundle;
+}
+export type TranslationBundleKeys = typeof TRANSLATION_BUNDLE_APP | typeof TRANSLATION_BUNDLE_ANNOTATION | typeof TRANSLATION_BUNDLE_SERVICE | typeof TRANSLATION_BUNDLE_UI5;
+export declare enum AggregationNodeType {
+    customAction = "customAction",
+    customColumn = "customColumn",
+    customSection = "customSection",
+    customFilterField = "customFilterField",
+    rootNode = "rootNode",
+    views = "views"
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,149 @@
+"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 });
+exports.AggregationNodeType = exports.TRANSLATION_BUNDLE_UI5 = exports.TRANSLATION_BUNDLE_SERVICE = exports.TRANSLATION_BUNDLE_ANNOTATION = exports.TRANSLATION_BUNDLE_APP = exports.SAP_ANNOTATION_NAMESPACE = exports.PropertyMessageType = exports.ValidationState = exports.PendingChange = exports.AggregationSortBy = exports.AggregationActions = exports.AggregationType = exports.SortingOptions = exports.PropertiesType = exports.EXTENSION_TABLE_TYPE_MAP = exports.FacetTitlePrefix = exports.EXTERNAL_CREATION_FORM = exports.SCHEMA_CREATION_FORM = exports.ANNOTATION_CREATION_FORM = exports.TABLE_TYPE_EXTENSION_MAP = exports.CUSTOM_AGGREGATION_FORMS = exports.AggregationCreationForm = exports.CUSTOM_VIEW_PREFIX = exports.ANNOTATION_TYPES_SEPARATOR = exports.DATA_FIELD_FOR_ACTION_GROUP = exports.DATA_FIELD_FOR_INTENT_BASED_NAVIGATION = exports.DATA_FIELD_ACTION = void 0;
+const src_1 = require("@sap/ux-specification/dist/types/src");
+__exportStar(require("./annotations"), exports);
+__exportStar(require("./common"), exports);
+exports.DATA_FIELD_ACTION = 'DataFieldForAction';
+exports.DATA_FIELD_FOR_INTENT_BASED_NAVIGATION = 'DataFieldForIntentBasedNavigation';
+exports.DATA_FIELD_FOR_ACTION_GROUP = 'DataFieldForActionGroup';
+exports.ANNOTATION_TYPES_SEPARATOR = '::';
+exports.CUSTOM_VIEW_PREFIX = 'customView(';
+var AggregationCreationForm;
+(function (AggregationCreationForm) {
+    AggregationCreationForm["AnalyticalChart"] = "AnalyticalChart";
+    AggregationCreationForm["AnalyticalChartView"] = "AnalyticalChartView";
+    AggregationCreationForm["ChartSection"] = "ChartSection";
+    AggregationCreationForm["CustomAction"] = "CustomAction";
+    AggregationCreationForm["CustomSection"] = "CustomSection";
+    AggregationCreationForm["CustomColumn"] = "CustomColumn";
+    AggregationCreationForm["CustomColumnV4"] = "CustomColumnV4";
+    AggregationCreationForm["CustomViewV4"] = "CustomViewV4";
+    AggregationCreationForm["DataPointSection"] = "DataPointSection";
+    AggregationCreationForm["Generic"] = "Generic";
+    AggregationCreationForm["MacrosChart"] = "MacrosChart";
+    AggregationCreationForm["MacrosFilterBar"] = "MacrosFilterBar";
+    AggregationCreationForm["MacrosTable"] = "MacrosTable";
+    AggregationCreationForm["NativeAction"] = "NativeAction";
+    AggregationCreationForm["NativeNavigation"] = "NativeNavigation";
+    AggregationCreationForm["NativeBasicColumn"] = "Basic";
+    AggregationCreationForm["NativeChartColumn"] = "Chart";
+    AggregationCreationForm["NativeContactColumn"] = "Contact";
+    AggregationCreationForm["NativeContactField"] = "NativeContactField";
+    AggregationCreationForm["NativeConnectedFields"] = "NativeConnectedFields";
+    AggregationCreationForm["NativeField"] = "NativeField";
+    AggregationCreationForm["NativeFilterFields"] = "NativeFilterFields";
+    AggregationCreationForm["NativeVisualFilters"] = "NativeVisualFilters";
+    AggregationCreationForm["NativeGroupSection"] = "NativeGroupSection";
+    AggregationCreationForm["NativeIdentification"] = "NativeIdentification";
+    AggregationCreationForm["NativeRatingColumn"] = "Rating";
+    AggregationCreationForm["NativeProgressColumn"] = "Progress";
+    AggregationCreationForm["NativeSection"] = "NativeSection";
+    AggregationCreationForm["NativeTableSection"] = "NativeTableSection";
+    AggregationCreationForm["ProgressSection"] = "ProgressSection";
+    AggregationCreationForm["RatingSection"] = "RatingSection";
+    AggregationCreationForm["TableView"] = "TableView";
+    AggregationCreationForm["CustomSubSection"] = "CustomSubSection";
+    AggregationCreationForm["CustomHeaderSection"] = "CustomHeaderSection";
+    AggregationCreationForm["CustomFilterField"] = "CustomFilterField";
+})(AggregationCreationForm || (exports.AggregationCreationForm = AggregationCreationForm = {}));
+exports.CUSTOM_AGGREGATION_FORMS = [
+    AggregationCreationForm.Generic,
+    AggregationCreationForm.CustomSection,
+    AggregationCreationForm.CustomColumn
+];
+exports.TABLE_TYPE_EXTENSION_MAP = new Map([
+    [src_1.v2.TableTypeV2.ResponsiveTable, "ResponsiveTableColumnsExtension" /* TableColumnExtensionType.ResponsiveTableColumnsExtension */],
+    [src_1.v2.TableTypeV2.GridTable, "GridTableColumnsExtension" /* TableColumnExtensionType.GridTableColumnsExtension */],
+    [src_1.v2.TableTypeV2.AnalyticalTable, "AnalyticalTableColumnsExtension" /* TableColumnExtensionType.AnalyticalTableColumnsExtension */],
+    [src_1.v2.TableTypeV2.TreeTable, "TreeTableColumnsExtension" /* TableColumnExtensionType.TreeTableColumnsExtension */]
+]);
+exports.ANNOTATION_CREATION_FORM = 'annotation';
+exports.SCHEMA_CREATION_FORM = 'schema';
+exports.EXTERNAL_CREATION_FORM = 'external';
+exports.FacetTitlePrefix = 'Facet ID: ';
+// Inverted map of TABLE_TYPE_EXTENSION_MAP
+exports.EXTENSION_TABLE_TYPE_MAP = new Map([...exports.TABLE_TYPE_EXTENSION_MAP.entries()].map(([key, value]) => [value, key]));
+var PropertiesType;
+(function (PropertiesType) {
+    PropertiesType[PropertiesType["Flat"] = 0] = "Flat";
+    PropertiesType[PropertiesType["AnyOf"] = 1] = "AnyOf";
+})(PropertiesType || (exports.PropertiesType = PropertiesType = {}));
+var SortingOptions;
+(function (SortingOptions) {
+    SortingOptions["Enabled"] = "Enabled";
+    SortingOptions["Excluded"] = "Excluded";
+    SortingOptions["Readonly"] = "Readonly";
+})(SortingOptions || (exports.SortingOptions = SortingOptions = {}));
+var AggregationType;
+(function (AggregationType) {
+    AggregationType["Object"] = "Object";
+    AggregationType["Array"] = "Array";
+})(AggregationType || (exports.AggregationType = AggregationType = {}));
+var AggregationActions;
+(function (AggregationActions) {
+    AggregationActions["Delete"] = "Delete";
+    AggregationActions["OpenSource"] = "OpenSource";
+    AggregationActions["Edit"] = "Edit";
+})(AggregationActions || (exports.AggregationActions = AggregationActions = {}));
+var AggregationSortBy;
+(function (AggregationSortBy) {
+    AggregationSortBy["ViewNode"] = "ViewNode";
+})(AggregationSortBy || (exports.AggregationSortBy = AggregationSortBy = {}));
+var PendingChange;
+(function (PendingChange) {
+    PendingChange["Creation"] = "Creation";
+    PendingChange["MoveDnD"] = "MoveDnD";
+    PendingChange["MoveButton"] = "MoveButton";
+})(PendingChange || (exports.PendingChange = PendingChange = {}));
+var ValidationState;
+(function (ValidationState) {
+    ValidationState[ValidationState["Valid"] = 0] = "Valid";
+    ValidationState[ValidationState["Invalid"] = 1] = "Invalid";
+    ValidationState[ValidationState["Skipped"] = 2] = "Skipped";
+    ValidationState[ValidationState["ReadOnly"] = 3] = "ReadOnly";
+})(ValidationState || (exports.ValidationState = ValidationState = {}));
+var PropertyMessageType;
+(function (PropertyMessageType) {
+    /**
+     * Reports an error.
+     */
+    PropertyMessageType["Error"] = "error";
+    /**
+     * Reports a warning.
+     */
+    PropertyMessageType["Warning"] = "warning";
+    /**
+     * Reports an information.
+     */
+    PropertyMessageType["Info"] = "info";
+})(PropertyMessageType || (exports.PropertyMessageType = PropertyMessageType = {}));
+exports.SAP_ANNOTATION_NAMESPACE = '@com.sap.vocabularies.UI.v1';
+exports.TRANSLATION_BUNDLE_APP = 'app';
+exports.TRANSLATION_BUNDLE_ANNOTATION = 'annotation';
+exports.TRANSLATION_BUNDLE_SERVICE = 'service';
+exports.TRANSLATION_BUNDLE_UI5 = 'ui5';
+var AggregationNodeType;
+(function (AggregationNodeType) {
+    AggregationNodeType["customAction"] = "customAction";
+    AggregationNodeType["customColumn"] = "customColumn";
+    AggregationNodeType["customSection"] = "customSection";
+    AggregationNodeType["customFilterField"] = "customFilterField";
+    AggregationNodeType["rootNode"] = "rootNode";
+    AggregationNodeType["views"] = "views";
+})(AggregationNodeType || (exports.AggregationNodeType = AggregationNodeType = {}));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,38 @@
+import { type PageAnnotations, type UINode, type Location } from '../types';
+/**
+ * Retrieves a `UINode` from the given annotations by its hierarchical node ID.
+ *
+ * @param annotations The annotations object containing nodes.
+ * @param id The hierarchical node ID to search for.
+ * @returns The matching `UINode` if found, otherwise `undefined`.
+ */
+export declare function getAnnotationNodeById(annotations: PageAnnotations, id: number[]): UINode | undefined;
+/**
+ * Returns all locations for the given node.
+ *
+ * @param node
+ * @returns
+ */
+export declare function getNodeLocations(node: UINode): Location[];
+/**
+ * Finds a `UINode` within a tree of nodes that matches the given annotation path.
+ *
+ * @param annotationPath - The annotation path to match.
+ * @param nodes - The list of nodes to search within.
+ * @param shallow - If true, only searches the top-level nodes.
+ * @param lookUpIndex - Optional index hint to optimize search order.
+ * @returns The matching node if found, otherwise `undefined`.
+ */
+export declare function nodeMatcher(annotationPath: string, nodes: UINode[], shallow?: boolean, lookUpIndex?: number): UINode | undefined;
+/**
+ * Method finds matching node using passed schema annotation path and tree object nested nodes and full nodes.
+ *
+ * @param schemaAnnotationPath Annotation path from schema to look up in annotation nodes.
+ * @param annotationNodes Full annotation nodes tree.
+ * @param childAnnotationNodes Current level's annotation nodes - mainly nested nodes are used to look up, but there is special cases when nodes are not on same level as schema.
+ * @param nodeAnnotationPath Current annotation node path.
+ * @param index Node index to look.
+ * @returns Matching annotation node.
+ */
+export declare function getMatchingNode(schemaAnnotationPath: string, annotationNodes: UINode[], childAnnotationNodes: UINode[], nodeAnnotationPath?: string, index?: number): UINode | undefined;
+//# sourceMappingURL=annotations.d.ts.map

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

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnnotationNodeById = getAnnotationNodeById;
+exports.getNodeLocations = getNodeLocations;
+exports.nodeMatcher = nodeMatcher;
+exports.getMatchingNode = getMatchingNode;
+const types_1 = require("../types");
+const annotations_1 = require("../../annotations");
+// terms of special parent child relations generated by specification
+// (parent child relations in specification which are not found in anno libs ui nodes)
+const SPECIAL_CHILD_NODES = new Map();
+SPECIAL_CHILD_NODES.set('com.sap.vocabularies.UI.v1.HeaderInfo', new Set(['com.sap.vocabularies.UI.v1.HeaderFacets', 'com.sap.vocabularies.UI.v1.Identification']));
+const GENERIC_ACTION_TERMS = ['com.sap.vocabularies.UI.v1.DeleteHidden', 'com.sap.vocabularies.UI.v1.UpdateHidden'];
+const stripTarget = (annotationPath) => (annotationPath || '').split('/@').pop() || '';
+/**
+ * Retrieves a `UINode` from the given annotations by its hierarchical node ID.
+ *
+ * @param annotations The annotations object containing nodes.
+ * @param id The hierarchical node ID to search for.
+ * @returns The matching `UINode` if found, otherwise `undefined`.
+ */
+function getAnnotationNodeById(annotations, id) {
+    let node = annotations.nodes.find((node) => node?.nodeId && node.nodeId[0] === id[0]);
+    for (let i = 1; i < id.length; i++) {
+        if (node && (0, annotations_1.isTooComplex)(node)) {
+            return node;
+        }
+        node = node?.subnodes.find((node) => node.nodeId[i] === id[i]);
+    }
+    return node;
+}
+/**
+ * Returns all locations for the given node.
+ *
+ * @param node
+ * @returns
+ */
+function getNodeLocations(node) {
+    if ((0, annotations_1.isTooComplex)(node)) {
+        return node.tooComplexLocations ?? [];
+    }
+    if (node.location) {
+        return [node.location];
+    }
+    return [];
+}
+/**
+ * Finds a `UINode` within a tree of nodes that matches the given annotation path.
+ *
+ * @param annotationPath - The annotation path to match.
+ * @param nodes - The list of nodes to search within.
+ * @param shallow - If true, only searches the top-level nodes.
+ * @param lookUpIndex - Optional index hint to optimize search order.
+ * @returns The matching node if found, otherwise `undefined`.
+ */
+function nodeMatcher(annotationPath, nodes, shallow, lookUpIndex) {
+    const indexes = getNodeMatcherIndexes(nodes, lookUpIndex);
+    for (const index of indexes) {
+        const element = nodes[index];
+        const adjustedAnnotationPath = element.annotationPath
+            .split('/')
+            .map((segment, i) => (i === 1 ? segment.split('.').slice(-1)[0] ?? segment : segment))
+            .join('/');
+        if (annotationPath === element.annotationPath || annotationPath === adjustedAnnotationPath) {
+            return element;
+        }
+        else if (!shallow && !(0, annotations_1.isTooComplex)(element) && element.subnodes.length > 0) {
+            const result = nodeMatcher(annotationPath, element.subnodes, undefined, lookUpIndex);
+            if (result) {
+                return result;
+            }
+        }
+    }
+}
+/**
+ * Method finds matching node using passed schema annotation path and tree object nested nodes and full nodes.
+ *
+ * @param schemaAnnotationPath Annotation path from schema to look up in annotation nodes.
+ * @param annotationNodes Full annotation nodes tree.
+ * @param childAnnotationNodes Current level's annotation nodes - mainly nested nodes are used to look up, but there is special cases when nodes are not on same level as schema.
+ * @param nodeAnnotationPath Current annotation node path.
+ * @param index Node index to look.
+ * @returns Matching annotation node.
+ */
+function getMatchingNode(schemaAnnotationPath, annotationNodes, childAnnotationNodes, nodeAnnotationPath, index) {
+    const schemaAnnotationPathTerm = stripTarget(schemaAnnotationPath);
+    let matchedNode = nodeMatcher(schemaAnnotationPath, childAnnotationNodes, undefined, index);
+    // Special matching of generic action nodes
+    if (!matchedNode && GENERIC_ACTION_TERMS.includes(schemaAnnotationPathTerm)) {
+        const genericActionsNode = annotationNodes.find((node) => node.nodeType === types_1.UI_NODE_TYPE_GENERIC_ACTIONS);
+        matchedNode = genericActionsNode?.subnodes.find((node) => node.annotationPath === schemaAnnotationPath);
+    }
+    if (!matchedNode && SPECIAL_CHILD_NODES.get(stripTarget(nodeAnnotationPath))?.has(schemaAnnotationPathTerm)) {
+        matchedNode = nodeMatcher(schemaAnnotationPath, annotationNodes, true, index);
+    }
+    return matchedNode;
+}
+/**
+ * Method prepares array with indexes to loop through.
+ * If index is passed as param, then we need place it first.
+ * It is used for cases when nodes can have same path, but different order indexes.
+ *
+ * @param nodes Nodes to loop.
+ * @param index Index to place as very first.
+ * @returns Array of index to loop.
+ */
+function getNodeMatcherIndexes(nodes, index) {
+    const indexes = [];
+    if (index !== undefined && nodes.length > index) {
+        // Place passed index as first
+        indexes.push(index);
+    }
+    for (let i = 0; i < nodes.length; i++) {
+        if (i !== index) {
+            indexes.push(i);
+        }
+    }
+    return indexes;
+}
+//# sourceMappingURL=annotations.js.map

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

@@ -0,0 +1,33 @@
+import type { I18nBundle } from '@sap-ux/i18n';
+import type { ProjectType } from '@sap-ux/project-access';
+import type { TranslationBundles, TranslationBundleKeys } from '../types';
+import type { ObjectAggregation } from '../ObjectAggregation';
+/**
+ * Method extracts i18n binding and returns key of i18n entry.
+ *
+ * @param input - Binding value.
+ * @param resolveAnnotationBinding - Check if method should resolve syntax annotation based i18n binding.
+ * @param forceKeyExtraction - Optional parameter to force key extraction in case of {{key}} format.
+ * @returns I18n entry key or undefined if input does not matches i18n binding pattern.
+ */
+export declare const extractI18nKey: (input?: string, resolveAnnotationBinding?: boolean, forceKeyExtraction?: boolean) => string | undefined;
+/**
+ * Method to resolve passed i18n binding value into value from i18n bundle.
+ *
+ * @param value Binding value like `{i18n>key}`.
+ * @param i18nBundle I18n bundle data.
+ * @returns Resolved value from i18n bundle.
+ */
+export declare const resolveI18nValue: (value: string, i18nBundle?: I18nBundle) => string | undefined;
+/**
+ * Method returns name of i18n bundle depending on passed project type and entity.
+ *
+ * @param isCustom Is custom extension.
+ * @param isViewNode Is visible node.
+ * @param isAnnotation Node has mapping to annotation.
+ * @param projectType Project type.
+ * @returns I18n bundle name.
+ */
+export declare const getI18nBundleName: (isCustom?: boolean, isViewNode?: boolean, isAnnotation?: boolean, projectType?: ProjectType) => TranslationBundleKeys;
+export declare const getRelevantI18nBundle: (aggregation: ObjectAggregation, bundle?: TranslationBundles, projectType?: ProjectType) => I18nBundle | undefined;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRelevantI18nBundle = exports.getI18nBundleName = exports.resolveI18nValue = exports.extractI18nKey = void 0;
+const types_1 = require("../types");
+const I18N_BINDING_PREFIX = 'i18n';
+/**
+ * Method extracts i18n binding and returns key of i18n entry.
+ *
+ * @param input - Binding value.
+ * @param resolveAnnotationBinding - Check if method should resolve syntax annotation based i18n binding.
+ * @param forceKeyExtraction - Optional parameter to force key extraction in case of {{key}} format.
+ * @returns I18n entry key or undefined if input does not matches i18n binding pattern.
+ */
+const extractI18nKey = (input = '', resolveAnnotationBinding = false, forceKeyExtraction) => {
+    if (/^{{[^\\{}:]+}}$/.exec(input) && (!resolveAnnotationBinding || forceKeyExtraction)) {
+        return input.toString().substring(2, input.length - 2);
+    }
+    const prefixRegex = resolveAnnotationBinding
+        ? `(${I18N_BINDING_PREFIX}|@${I18N_BINDING_PREFIX})`
+        : `${I18N_BINDING_PREFIX}`;
+    const mathIndex = resolveAnnotationBinding ? 2 : 1;
+    const i18nMatch = new RegExp(`^{${prefixRegex}>([^\\{}:]+)}$`).exec(input);
+    return i18nMatch ? i18nMatch[mathIndex] : undefined;
+};
+exports.extractI18nKey = extractI18nKey;
+/**
+ * Method to resolve passed i18n binding value into value from i18n bundle.
+ *
+ * @param value Binding value like `{i18n>key}`.
+ * @param i18nBundle I18n bundle data.
+ * @returns Resolved value from i18n bundle.
+ */
+const resolveI18nValue = (value, i18nBundle = {}) => {
+    const key = (0, exports.extractI18nKey)(value, true, true);
+    if (key) {
+        const entries = i18nBundle[key];
+        if (entries?.length > 0) {
+            return entries[0].value?.value;
+        }
+    }
+};
+exports.resolveI18nValue = resolveI18nValue;
+/**
+ * Method returns name of i18n bundle depending on passed project type and entity.
+ *
+ * @param isCustom Is custom extension.
+ * @param isViewNode Is visible node.
+ * @param isAnnotation Node has mapping to annotation.
+ * @param projectType Project type.
+ * @returns I18n bundle name.
+ */
+const getI18nBundleName = (isCustom, isViewNode, isAnnotation, projectType = 'EDMXBackend') => {
+    if (['CAPJava', 'CAPNodejs'].includes(projectType) && !isCustom && isViewNode) {
+        // CAP project - for non custom view nodes like fields, sections, columns we need use translation from service bundle
+        return types_1.TRANSLATION_BUNDLE_SERVICE;
+    }
+    if (isAnnotation) {
+        return types_1.TRANSLATION_BUNDLE_ANNOTATION;
+    }
+    return types_1.TRANSLATION_BUNDLE_UI5;
+};
+exports.getI18nBundleName = getI18nBundleName;
+const getRelevantI18nBundle = (aggregation, bundle, projectType) => {
+    return bundle
+        ? bundle[(0, exports.getI18nBundleName)(aggregation.custom, aggregation.isViewNode, !!aggregation.annotationNodeId, projectType)]
+        : {};
+};
+exports.getRelevantI18nBundle = getRelevantI18nBundle;
+//# sourceMappingURL=i18n.js.map

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

@@ -0,0 +1,6 @@
+export * from './annotations';
+export * from './i18n';
+export * from './object';
+export * from './sort';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map