@sap-ux/project-access 2.1.12 → 2.2.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { FileName, DirName, FioriToolsSettings, MinCdsPluginUi5Version, MinCdsVersion, fioriToolsDirectory } from './constants.js';
 export { getFilePaths, findFilesByExtension } from './file/index.js';
 export { normalizePath } from './path/index.js';
-export { addPackageDevDependency, clearCdsModuleCache, createApplicationAccess, createProjectAccess, deleteCapApp, filterDataSourcesByType, findAllApps, findCapProjectRoot, findCapProjects, findFioriArtifacts, findProjectRoot, findRootsForPath, getAllUi5YamlFileNames, getAppRootFromWebappPath, getAppProgrammingLanguage, getAppType, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapServiceName, getCapProjectType, getCdsFiles, getCdsRoots, getCdsServices, getCapI18nFolderNames, getSpecification, getSpecificationModuleFromCache, getSpecificationPath, getI18nPropertiesPaths, getI18nBundles, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getMtaPath, getMockServerConfig, getMockDataPath, getNodeModulesPath, getPathMappings, getProject, getProjectType, getWebappPath, hasUI5CliV3, isCapProject, isCapJavaProject, isCapNodeJsProject, loadModuleFromProject, readCapServiceMetadataEdmx, readUi5Yaml, refreshSpecificationDistTags, toReferenceUri, updatePackageScript, getWorkspaceInfo, hasMinCdsVersion, checkCdsUi5PluginEnabled, readFlexChanges, processServices, getMainService, getGlobalCdsHomePath, isUI5IdUnique, getUsedEntitiesFromManifest } from './project/index.js';
+export { addPackageDevDependency, clearCdsModuleCache, createApplicationAccess, createProjectAccess, deleteCapApp, filterDataSourcesByType, findAllApps, findCapProjectRoot, findCapProjects, findFioriArtifacts, findProjectRoot, findRootsForPath, getAllUi5YamlFileNames, getAppRootFromWebappPath, getAppProgrammingLanguage, getAppType, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapServiceName, getCapProjectType, getCdsFiles, getCdsRoots, getCdsServices, getCapI18nFolderNames, getSpecification, getSpecificationModuleFromCache, getSpecificationPath, getI18nPropertiesPaths, getI18nBundles, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getMtaPath, getMockServerConfig, getMockDataPath, getNodeModulesPath, getPathMappings, getProject, getProjectType, getWebappPath, hasUI5CliV3, isCapProject, isCapJavaProject, isCapNodeJsProject, loadModuleFromProject, readCapServiceMetadataEdmx, readUi5Yaml, refreshSpecificationDistTags, toReferenceUri, updatePackageScript, getWorkspaceInfo, hasMinCdsVersion, checkCdsUi5PluginEnabled, readFlexChanges, processServices, getMainService, getGlobalCdsHomePath, isUI5IdUnique, getUsedEntitiesFromManifest, resolveApplicationTitle } from './project/index.js';
 export type { UsedEntity } from './project/index.js';
 export { execNpmCommand } from './command/npm-command.js';
 export * from './types/index.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 export { FileName, DirName, FioriToolsSettings, MinCdsPluginUi5Version, MinCdsVersion, fioriToolsDirectory } from './constants.js';
 export { getFilePaths, findFilesByExtension } from './file/index.js';
 export { normalizePath } from './path/index.js';
-export { addPackageDevDependency, clearCdsModuleCache, createApplicationAccess, createProjectAccess, deleteCapApp, filterDataSourcesByType, findAllApps, findCapProjectRoot, findCapProjects, findFioriArtifacts, findProjectRoot, findRootsForPath, getAllUi5YamlFileNames, getAppRootFromWebappPath, getAppProgrammingLanguage, getAppType, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapServiceName, getCapProjectType, getCdsFiles, getCdsRoots, getCdsServices, getCapI18nFolderNames, getSpecification, getSpecificationModuleFromCache, getSpecificationPath, getI18nPropertiesPaths, getI18nBundles, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getMtaPath, getMockServerConfig, getMockDataPath, getNodeModulesPath, getPathMappings, getProject, getProjectType, getWebappPath, hasUI5CliV3, isCapProject, isCapJavaProject, isCapNodeJsProject, loadModuleFromProject, readCapServiceMetadataEdmx, readUi5Yaml, refreshSpecificationDistTags, toReferenceUri, updatePackageScript, getWorkspaceInfo, hasMinCdsVersion, checkCdsUi5PluginEnabled, readFlexChanges, processServices, getMainService, getGlobalCdsHomePath, isUI5IdUnique, getUsedEntitiesFromManifest } from './project/index.js';
+export { addPackageDevDependency, clearCdsModuleCache, createApplicationAccess, createProjectAccess, deleteCapApp, filterDataSourcesByType, findAllApps, findCapProjectRoot, findCapProjects, findFioriArtifacts, findProjectRoot, findRootsForPath, getAllUi5YamlFileNames, getAppRootFromWebappPath, getAppProgrammingLanguage, getAppType, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapServiceName, getCapProjectType, getCdsFiles, getCdsRoots, getCdsServices, getCapI18nFolderNames, getSpecification, getSpecificationModuleFromCache, getSpecificationPath, getI18nPropertiesPaths, getI18nBundles, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getMtaPath, getMockServerConfig, getMockDataPath, getNodeModulesPath, getPathMappings, getProject, getProjectType, getWebappPath, hasUI5CliV3, isCapProject, isCapJavaProject, isCapNodeJsProject, loadModuleFromProject, readCapServiceMetadataEdmx, readUi5Yaml, refreshSpecificationDistTags, toReferenceUri, updatePackageScript, getWorkspaceInfo, hasMinCdsVersion, checkCdsUi5PluginEnabled, readFlexChanges, processServices, getMainService, getGlobalCdsHomePath, isUI5IdUnique, getUsedEntitiesFromManifest, resolveApplicationTitle } from './project/index.js';
 export { execNpmCommand } from './command/npm-command.js';
 export * from './types/index.js';
 export { checkDependencies, getReuseLibs } from './library/index.js';

package/dist/project/app-title.d.ts

@@ -0,0 +1,22 @@
+import type { Editor } from 'mem-fs-editor';
+import type { Logger } from '@sap-ux/logger';
+import type { Manifest } from '../types/index.js';
+/**
+ * Resolves the application title from the manifest, following i18n key references when present.
+ *
+ * @param params - webapp path and optional pre-parsed manifest
+ * @param params.webappPath - path to the webapp directory; used to locate manifest.json and resolve i18n paths
+ * @param params.manifest - pre-parsed manifest content; pass to avoid re-reading from disk
+ * @param [options] - optional options
+ * @param [options.memFs] - optional mem-fs-editor instance
+ * @param [options.logger] - optional logger instance
+ * @returns the resolved title string, or undefined if it cannot be determined
+ */
+export declare function resolveApplicationTitle(params: {
+    webappPath: string;
+    manifest?: Manifest;
+}, options?: {
+    memFs?: Editor;
+    logger?: Logger;
+}): Promise<string | undefined>;
+//# sourceMappingURL=app-title.d.ts.map

package/dist/project/app-title.js

@@ -0,0 +1,41 @@
+import { join } from 'node:path';
+import { extractDoubleCurlyBracketsKey, getPropertiesI18nBundle } from '@sap-ux/i18n';
+import { FileName } from '../constants.js';
+import { readJSON } from '../file/index.js';
+import { getI18nPropertiesPaths } from './i18n/i18n.js';
+/**
+ * Resolves the application title from the manifest, following i18n key references when present.
+ *
+ * @param params - webapp path and optional pre-parsed manifest
+ * @param params.webappPath - path to the webapp directory; used to locate manifest.json and resolve i18n paths
+ * @param params.manifest - pre-parsed manifest content; pass to avoid re-reading from disk
+ * @param [options] - optional options
+ * @param [options.memFs] - optional mem-fs-editor instance
+ * @param [options.logger] - optional logger instance
+ * @returns the resolved title string, or undefined if it cannot be determined
+ */
+export async function resolveApplicationTitle(params, options) {
+    const { webappPath } = params;
+    let { manifest } = params;
+    const { memFs, logger } = options ?? {};
+    const manifestPath = join(webappPath, FileName.Manifest);
+    manifest ??= await readJSON(manifestPath, memFs);
+    const rawTitle = manifest?.['sap.app']?.title;
+    if (!rawTitle) {
+        return undefined;
+    }
+    const i18nKey = extractDoubleCurlyBracketsKey(rawTitle);
+    if (!i18nKey) {
+        return rawTitle;
+    }
+    try {
+        const i18nPaths = await getI18nPropertiesPaths(manifestPath, manifest, memFs);
+        const bundle = await getPropertiesI18nBundle(i18nPaths['sap.app'], memFs);
+        return bundle[i18nKey]?.[0]?.value?.value;
+    }
+    catch (error) {
+        logger?.debug(`Failed to load i18n properties bundle: ${error}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=app-title.js.map

package/dist/project/index.d.ts

@@ -13,4 +13,5 @@ export { updatePackageScript, hasUI5CliV3 } from './script.js';
 export { getSpecification, getSpecificationModuleFromCache, getSpecificationPath, refreshSpecificationDistTags } from './specification.js';
 export { readFlexChanges } from './flex-changes.js';
 export { isUI5IdUnique } from './ui5-xml-id-validator.js';
+export { resolveApplicationTitle } from './app-title.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/project/index.js

@@ -12,4 +12,5 @@ export { updatePackageScript, hasUI5CliV3 } from './script.js';
 export { getSpecification, getSpecificationModuleFromCache, getSpecificationPath, refreshSpecificationDistTags } from './specification.js';
 export { readFlexChanges } from './flex-changes.js';
 export { isUI5IdUnique } from './ui5-xml-id-validator.js';
+export { resolveApplicationTitle } from './app-title.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sap-ux/project-access",
-  "version": "2.1.12",
+  "version": "2.2.0",
   "description": "Library to access SAP Fiori tools projects",
   "type": "module",
   "repository": {
@@ -32,7 +32,7 @@
     "mem-fs-editor": "9.4.0",
     "semver": "7.8.5",
     "@sap-ux/i18n": "1.0.3",
-    "@sap-ux/ui5-config": "1.0.8"
+    "@sap-ux/ui5-config": "1.0.9"
   },
   "devDependencies": {
     "@jest/globals": "30.4.1",