@sap/ux-specification 1.84.126 → 1.84.128

package/dist/specification/src/ftfs/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 = 'subnodes' in node ? node?.subnodes.find((node) => node.nodeId[i] === id[i]) : undefined;
+    }
+    return node;
+}
+/**
+ * Returns all locations for the given node.
+ *
+ * @param node Annotation node.
+ * @returns All locations for the given node.
+ */
+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/specification/src/ftfs/parser/model/utils/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/annotations.ts"],"names":[],"mappings":"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"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACvB,cAAU,EACV,kCAAgC,EAChC,qBAAqB,OAAO,KAC7B,MAAM,GAAG,SAUX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,aAAY,UAAe,KAAG,MAAM,GAAG,SAQtF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC1B,WAAW,OAAO,EAClB,aAAa,OAAO,EACpB,eAAe,OAAO,EACtB,cAAa,WAA2B,KACzC,qBASF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAC9B,aAAa,iBAAiB,EAC9B,SAAS,kBAAkB,EAC3B,cAAc,WAAW,KAC1B,UAAU,GAAG,SAMf,CAAC"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/i18n.ts"],"names":[],"mappings":";;;AAGA,oCAA6G;AAG7G,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;;;GAOG;AACI,MAAM,cAAc,GAAG,CAC1B,KAAK,GAAG,EAAE,EACV,wBAAwB,GAAG,KAAK,EAChC,kBAA4B,EACV,EAAE;IACpB,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,wBAAwB,IAAI,kBAAkB,CAAC,EAAE,CAAC;QACrF,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,WAAW,GAAG,wBAAwB;QACxC,CAAC,CAAC,IAAI,mBAAmB,KAAK,mBAAmB,GAAG;QACpD,CAAC,CAAC,GAAG,mBAAmB,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,KAAK,WAAW,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC,CAAC;AAdW,QAAA,cAAc,kBAczB;AAEF;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,aAAyB,EAAE,EAAsB,EAAE;IAC/F,MAAM,GAAG,GAAG,IAAA,sBAAc,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,GAAG,EAAE,CAAC;QACN,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;QACnC,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AARW,QAAA,gBAAgB,oBAQ3B;AAEF;;;;;;;;GAQG;AACI,MAAM,iBAAiB,GAAG,CAC7B,QAAkB,EAClB,UAAoB,EACpB,YAAsB,EACtB,cAA2B,aAAa,EACnB,EAAE;IACvB,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,EAAE,CAAC;QAC5E,qHAAqH;QACrH,OAAO,kCAA0B,CAAC;IACtC,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACf,OAAO,qCAA6B,CAAC;IACzC,CAAC;IACD,OAAO,8BAAsB,CAAC;AAClC,CAAC,CAAC;AAdW,QAAA,iBAAiB,qBAc5B;AAEK,MAAM,qBAAqB,GAAG,CACjC,WAA8B,EAC9B,MAA2B,EAC3B,WAAyB,EACH,EAAE;IACxB,OAAO,MAAM;QACT,CAAC,CAAC,MAAM,CACF,IAAA,yBAAiB,EAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAC7G;QACH,CAAC,CAAC,EAAE,CAAC;AACb,CAAC,CAAC;AAVW,QAAA,qBAAqB,yBAUhC"}

package/dist/specification/src/ftfs/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

package/dist/specification/src/ftfs/parser/model/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,yCAAuB;AACvB,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/object.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACrB,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACvC,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACxC,OAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,KAAG,OAcjF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAG,OAcxE,CAAC"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/object.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CACxB,IAAuC,EACvC,IAAuC,EAChC,EAAE;IACT,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,KAAK,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,CACH,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,KAAK;YAC7B,OAAO,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CACL,CAAC;AACN,CAAC,CAAC;AAbW,QAAA,YAAY,gBAavB;AAEF;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAAI,IAAqB,EAAE,IAAqB,EAAW,EAAE;IACxF,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,OAAO,MAAM,IAAI,CAAC,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAdW,QAAA,eAAe,mBAc1B;AAEF;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAA6B,EAAW,EAAE;IAC/E,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,SAAS;QACb,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YACjD,qBAAqB;YACrB,OAAO,GAAI,OAAqC,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACJ,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAdW,QAAA,WAAW,eActB"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,oBAAY,qBAAqB;IAC7B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,iBAAiB;IAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,iBAAiB;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;CACL;AAID,oBAAY,eAAe;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,WAAW,gBAAgB;CAC9B"}

package/dist/specification/src/ftfs/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/specification/src/ftfs/parser/model/utils/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/sort.ts"],"names":[],"mappings":";;;AAEA,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC7B,wCAAe,CAAA;IACf,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;AACvB,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AAyBD,wEAAwE;AACxE,2CAA2C;AAC3C,IAAY,eAIX;AAJD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,8CAA2B,CAAA;AAC/B,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B"}

package/dist/specification/src/ftfs/parser/model/utils/utils.d.ts

@@ -0,0 +1,95 @@
+import type { TranslationBundles, PropertyMessage } from '../types';
+import type { JSONSchema4 } from 'json-schema';
+import type { ObjectAggregation } from '../ObjectAggregation';
+import type { ProjectType } from '@sap-ux/project-access';
+import type { Parser } from '@sap/ux-specification-types';
+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: Parser.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/specification/src/ftfs/parser/model/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/ftfs/parser/model/utils/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAA8B,eAAe,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAO,wBASnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,CAAC,YAAY,EAAE,mBAAiB,KAAG,MAAM,GAAG,SAgB9F,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAAI,aAAa,iBAAiB,EAAE,MAAM,MAAM,KAAG,IAqC1F,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC1B,aAAa,iBAAiB,EAC9B,SAAS,OAAO,EAChB,aAAa,MAAM,EACnB,WAAW,MAAM,KAClB,IAcF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,aAAa,iBAAiB,EAAE,eAAyB,KAAG,IAKnG,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,GACpC,SAAS,MAAM,EACf,aAAa,iBAAiB,EAC9B,MAAM,MAAM,EACZ,KAAK,MAAM,KACZ,MAUF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,MAAM,EACf,aAAa,iBAAiB,EAC9B,QAAO,WAAW,EAAO,KAC1B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAU/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,aAAa,iBAAiB,EAAE,gBAAgB,WAAW,KAAG,WA8BhG,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAGnH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyC9C"}