@sap-ux/project-access 2.2.2 → 2.3.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, resolveApplicationTitle } 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, createI18nEntriesAtPath, 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, resolveApplicationTitle } 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, createI18nEntriesAtPath, 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/access.js

@@ -1,5 +1,5 @@
 import { join, relative } from 'node:path';
-import { getI18nBundles, getI18nPropertiesPaths, createCapI18nEntries, createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries } from './i18n/index.js';
+import { getI18nBundles, getI18nPropertiesPaths, createCapI18nEntries, createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries, createI18nEntriesAtPath } from './i18n/index.js';
 import { getProject } from './info.js';
 import { findAllApps } from './search.js';
 import { readFile, readJSON, updateManifestJSON, updatePackageJSON } from '../file/index.js';
@@ -102,6 +102,17 @@ class ApplicationAccessImp {
     createCapI18nEntries(filePath, newI18nEntries) {
         return createCapI18nEntries(this.project.root, filePath, newI18nEntries, this.options?.fs);
     }
+    /**
+     * Maintains new translation entries at a specific i18n properties file path.
+     * Use this when the target file is already known (e.g. chosen by the user from a picker).
+     *
+     * @param filePath absolute path to the target `.properties` file
+     * @param newEntries translation entries to write
+     * @returns boolean or exception
+     */
+    createI18nEntriesAtPath(filePath, newEntries) {
+        return createI18nEntriesAtPath(this.project.root, filePath, newEntries, this.options?.fs);
+    }
     /**
      * Return the application id of this app, which is the relative path from the project root
      * to the app root.

package/dist/project/i18n/i18n.js

@@ -16,10 +16,17 @@ export async function getI18nPropertiesPaths(manifestPath, manifest, memFs) {
         'sap.app': join(manifestFolder, relativeI18nPropertiesPaths['sap.app']),
         models: {}
     };
+    if (relativeI18nPropertiesPaths['sap.app.fallbackLocale']) {
+        i18nPropertiesPaths['sap.app.fallbackLocale'] = join(manifestFolder, relativeI18nPropertiesPaths['sap.app.fallbackLocale']);
+    }
     for (const modelKey in relativeI18nPropertiesPaths.models) {
+        const relativeModelPaths = relativeI18nPropertiesPaths.models[modelKey];
         i18nPropertiesPaths.models[modelKey] = {
-            path: join(manifestFolder, relativeI18nPropertiesPaths.models[modelKey].path)
+            path: join(manifestFolder, relativeModelPaths.path)
         };
+        if (relativeModelPaths.fallbackLocalePath) {
+            i18nPropertiesPaths.models[modelKey].fallbackLocalePath = join(manifestFolder, relativeModelPaths.fallbackLocalePath);
+        }
     }
     return i18nPropertiesPaths;
 }
@@ -31,10 +38,45 @@ export async function getI18nPropertiesPaths(manifestPath, manifest, memFs) {
  * @returns - paths to i18n.properties files from sap.app and models
  */
 export function getRelativeI18nPropertiesPaths(manifest) {
-    return {
-        'sap.app': getI18nAppPath(manifest),
+    const appPath = getI18nAppPath(manifest);
+    const appFallbackLocalePath = getI18nAppFallbackLocalePath(manifest, appPath);
+    const result = {
+        'sap.app': appPath,
         models: getI18nModelPaths(manifest)
     };
+    if (appFallbackLocalePath) {
+        result['sap.app.fallbackLocale'] = appFallbackLocalePath;
+    }
+    return result;
+}
+/**
+ * Computes the fallback locale variant of a base i18n file path, e.g. "i18n/i18n.properties" + "en" yields "i18n/i18n_en.properties".
+ *
+ * @param basePath - base i18n file path
+ * @param locale - fallback locale string (e.g. "en", "de")
+ * @returns - path to the fallback locale file
+ */
+function computeFallbackLocalePath(basePath, locale) {
+    const ext = '.properties';
+    const stem = basePath.endsWith(ext) ? basePath.slice(0, -ext.length) : basePath;
+    return `${stem}_${locale}${ext}`;
+}
+/**
+ * Get the fallback locale i18n path from sap.app.i18n part of the manifest.
+ *
+ * @param manifest - parsed content of manifest.json
+ * @param appPath - resolved base i18n path for sap.app
+ * @returns - fallback locale path, or undefined if not configured
+ */
+function getI18nAppFallbackLocalePath(manifest, appPath) {
+    const i18n = manifest?.['sap.app']?.i18n;
+    if (i18n !== null && typeof i18n === 'object') {
+        const fallbackLocale = i18n.fallbackLocale;
+        if (typeof fallbackLocale === 'string' && fallbackLocale && /^[A-Za-z0-9_-]+$/.test(fallbackLocale)) {
+            return computeFallbackLocalePath(appPath, fallbackLocale);
+        }
+    }
+    return undefined;
 }
 /**
  * Get the i18n path from sap.app.i18n part of the manifest.
@@ -52,61 +94,91 @@ function getI18nAppPath(manifest) {
     if (typeof manifest?.['sap.app']?.i18n === 'string') {
         return join(manifest['sap.app'].i18n);
     }
-    if (typeof manifest?.['sap.app']?.i18n === 'object') {
+    const i18nObj = manifest?.['sap.app']?.i18n;
+    if (i18nObj !== null && typeof i18nObj === 'object') {
         // bundleName wins over `bundleUrl`
-        if ('bundleName' in manifest['sap.app'].i18n) {
-            // module name is in dot notation
-            const withoutAppId = manifest['sap.app'].i18n.bundleName.replace(manifest['sap.app'].id, '');
-            const i18nPath = `${join(...withoutAppId.split('.'))}.properties`;
+        if ('bundleName' in i18nObj) {
+            // module name is in dot notation; strip appId as a prefix
+            const bundleName = i18nObj.bundleName;
+            const appId = manifest['sap.app'].id ?? '';
+            const suffix = appId && bundleName.startsWith(appId) ? bundleName.slice(appId.length) : bundleName;
+            if (!suffix) {
+                return defaultPath;
+            }
+            const i18nPath = `${join(...suffix.split('.'))}.properties`;
             return join(i18nPath);
         }
-        if ('bundleUrl' in manifest['sap.app'].i18n) {
-            return join(manifest['sap.app'].i18n.bundleUrl);
+        if ('bundleUrl' in i18nObj) {
+            return join(i18nObj.bundleUrl);
         }
     }
     // default
     return defaultPath;
 }
 /**
- * Get the i18n path from UI5 resource models declared in sap.ui5.models part of the manifest.
- * By default the model used for internationalization in the UI is 'i18n'. For
- * internationalization of annotations the model is '@18n'.
+ * Resolves the i18n file path from a resource model's settings object.
  *
- * for For `sap.ui5` namespace
- * 1. from `sap.ui5.models.{resource model key}.bundleName` as `bundleName` wins over `bundleUrl`
- * 2. from `sap.ui5.models.{resource model key}.bundleUrl`
- * 3. from `sap.ui5.models.{resource model key}.uri`
+ * @param appId - application id from sap.app namespace
+ * @param settings - resource model settings object
+ * @param settings.bundleName - bundle name in dot notation (e.g. "sample.app.i18n")
+ * @param settings.bundleUrl - bundle URL path (e.g. "i18n/i18n.properties")
+ * @returns - resolved relative path, or undefined if it cannot be determined
+ */
+function extractBundlePath(appId, settings) {
+    if (settings.bundleName) {
+        // Strip appId as a prefix when present; fall back to full bundleName otherwise.
+        // Prefix-strip is safer than String.replace which would remove the first occurrence anywhere in the string.
+        const suffix = appId && settings.bundleName.startsWith(appId)
+            ? settings.bundleName.slice(appId.length)
+            : settings.bundleName;
+        if (!suffix) {
+            return undefined;
+        }
+        return `${join(...suffix.split('.'))}.properties`;
+    }
+    if (settings.bundleUrl) {
+        return join(settings.bundleUrl);
+    }
+    return undefined;
+}
+/**
+ * Extracts and validates the `fallbackLocale` from a UI5 resource model settings object.
+ * Only alphanumeric, dash, and underscore characters are accepted (e.g. "en", "en-US").
  *
- * @param manifest - parsed content of manifest.json
- * @returns - paths to i18n.properties file from models
+ * @param settings - sap.ui5 resource model settings object
+ * @returns validated fallback locale string or undefined if invalid/absent
  */
+function getValidFallbackLocale(settings) {
+    const fallbackLocale = settings?.fallbackLocale;
+    return typeof fallbackLocale === 'string' && fallbackLocale && /^[A-Za-z0-9_-]+$/.test(fallbackLocale)
+        ? fallbackLocale
+        : undefined;
+}
 function getI18nModelPaths(manifest) {
     const result = {};
     const models = manifest?.['sap.ui5']?.models ?? {};
     const resourceModelKeys = Object.keys(models).filter((key) => models[key].type === 'sap.ui.model.resource.ResourceModel');
     for (const modelKey of resourceModelKeys) {
         const i18nModel = models[modelKey];
-        // settings wins over `uri`
         if (i18nModel.settings) {
-            // bundleName wins over `bundleUrl`
-            if (i18nModel.settings.bundleName) {
-                // module name is in dot notation
-                const appId = manifest['sap.app']?.id ?? '';
-                if (!appId) {
-                    continue;
-                }
-                const withoutAppId = i18nModel.settings.bundleName.replace(appId, '');
-                const i18nPath = `${join(...withoutAppId.split('.'))}.properties`;
-                result[modelKey] = { path: join(i18nPath) };
-                continue;
-            }
-            if (i18nModel.settings.bundleUrl) {
-                result[modelKey] = { path: join(i18nModel.settings.bundleUrl) };
+            const appId = manifest['sap.app']?.id ?? '';
+            const path = extractBundlePath(appId, i18nModel.settings);
+            if (path) {
+                const fallbackLocale = getValidFallbackLocale(i18nModel.settings);
+                result[modelKey] = {
+                    path,
+                    ...(fallbackLocale && { fallbackLocalePath: computeFallbackLocalePath(path, fallbackLocale) })
+                };
                 continue;
             }
         }
         if (i18nModel.uri) {
-            result[modelKey] = { path: join(i18nModel.uri) };
+            const path = join(i18nModel.uri);
+            const fallbackLocale = getValidFallbackLocale(i18nModel.settings);
+            result[modelKey] = {
+                path,
+                ...(fallbackLocale && { fallbackLocalePath: computeFallbackLocalePath(path, fallbackLocale) })
+            };
         }
     }
     return result;

package/dist/project/i18n/index.d.ts

@@ -1,4 +1,4 @@
 export { getI18nPropertiesPaths } from './i18n.js';
 export { getCapI18nFolderNames, getI18nBundles } from './read.js';
-export { createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries, createCapI18nEntries } from './write.js';
+export { createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries, createCapI18nEntries, createI18nEntriesAtPath } from './write.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/project/i18n/index.js

@@ -1,4 +1,4 @@
 export { getI18nPropertiesPaths } from './i18n.js';
 export { getCapI18nFolderNames, getI18nBundles } from './read.js';
-export { createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries, createCapI18nEntries } from './write.js';
+export { createManifestI18nEntries, createUI5I18nEntries, createAnnotationI18nEntries, createCapI18nEntries, createI18nEntriesAtPath } from './write.js';
 //# sourceMappingURL=index.js.map

package/dist/project/i18n/read.js

@@ -8,11 +8,48 @@ import { getCapEnvironment, getCdsFiles } from '../index.js';
  * @param error error to add
  */
 function addToErrors(result, key, error) {
-    if (!result.errors) {
-        result.errors = {};
-    }
+    result.errors ??= {};
     result.errors[key] = error;
 }
+/**
+ * Merges a fallback locale bundle into a primary bundle.
+ * Skipped when the primary failed with a non-ENOENT error (file exists but unreadable).
+ * Clears the primary ENOENT error when the fallback is read successfully.
+ * Stores non-ENOENT fallback errors in result.errors instead of throwing.
+ *
+ * @param result - accumulator for bundles and errors
+ * @param primaryKey - error key used to look up the primary error (e.g. 'sap.app')
+ * @param current - primary bundle (may be empty if primary failed)
+ * @param fallbackPath - path to the fallback locale .properties file
+ * @param fs - optional mem-fs-editor instance
+ * @returns merged bundle (fallback keys supplemented by primary entries)
+ */
+async function mergeWithFallback(result, primaryKey, current, fallbackPath, fs) {
+    const primaryError = result.errors?.[primaryKey];
+    if (primaryError && primaryError.code !== 'ENOENT') {
+        return current;
+    }
+    try {
+        const fallbackBundle = await getPropertiesI18nBundle(fallbackPath, fs);
+        if (primaryError?.code === 'ENOENT') {
+            const errors = result.errors;
+            if (errors) {
+                delete errors[primaryKey];
+                if (Object.keys(errors).length === 0) {
+                    result.errors = undefined;
+                }
+            }
+        }
+        // Primary entries take precedence on key collision
+        return { ...fallbackBundle, ...current };
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            addToErrors(result, `${primaryKey}.fallbackLocale`, error);
+        }
+        return current;
+    }
+}
 /**
  * For a given app in project, retrieves i18n bundles for 'sap.app' namespace,`models` of `sap.ui5` namespace and service for cap services.
  *
@@ -36,7 +73,10 @@ export async function getI18nBundles(root, i18nPropertiesPaths, projectType, fs)
     catch (error) {
         addToErrors(result, 'sap.app', error);
     }
-    for (const key of Object.keys(i18nPropertiesPaths.models)) {
+    if (i18nPropertiesPaths['sap.app.fallbackLocale']) {
+        result['sap.app'] = await mergeWithFallback(result, 'sap.app', result['sap.app'], i18nPropertiesPaths['sap.app.fallbackLocale'], fs);
+    }
+    await Promise.all(Object.keys(i18nPropertiesPaths.models).map(async (key) => {
         try {
             result.models[key] = await getPropertiesI18nBundle(i18nPropertiesPaths.models[key].path, fs);
         }
@@ -45,7 +85,11 @@ export async function getI18nBundles(root, i18nPropertiesPaths, projectType, fs)
             result.models[key] = {};
             addToErrors(result, `models.${key}`, error);
         }
-    }
+        const fallbackLocalePath = i18nPropertiesPaths.models[key].fallbackLocalePath;
+        if (fallbackLocalePath) {
+            result.models[key] = await mergeWithFallback(result, `models.${key}`, result.models[key], fallbackLocalePath, fs);
+        }
+    }));
     if (projectType === 'CAPJava' || projectType === 'CAPNodejs') {
         try {
             const env = await getCapEnvironment(root);

package/dist/project/i18n/write.d.ts

@@ -64,11 +64,22 @@ export declare function createUI5I18nEntries(root: string, manifestPath: string,
  * ```
  */
 export declare function createAnnotationI18nEntries(root: string, manifestPath: string, i18nPropertiesPaths: I18nPropertiesPaths, newEntries: NewI18nEntry[], fs?: Editor): Promise<boolean>;
+/**
+ * Maintains new translation entries at a specific i18n properties file path.
+ * Use this when the target file is already known (e.g. chosen by the user from a picker).
+ *
+ * @param root project root
+ * @param filePath absolute path to the target `.properties` file
+ * @param newEntries translation entries to write
+ * @param fs optional `mem-fs-editor` instance
+ * @returns boolean or exception
+ */
+export declare function createI18nEntriesAtPath(root: string, filePath: string, newEntries: NewI18nEntry[], fs?: Editor): Promise<boolean>;
 /**
  * Maintains new translation entries in an existing i18n file or in a new i18n properties file if it does not exist.
  *
  * @param root project root
- * @param i18nPropertiesPaths paths to `.properties` file`
+ * @param i18nPropertiesPaths paths to `.properties` file
  * @param newEntries translation entries to write in the `.properties` file
  * @param fs optional `mem-fs-editor` instance. If provided, `mem-fs-editor` api is used instead of `fs` of node
  * @returns boolean or exception

package/dist/project/i18n/write.js

@@ -118,11 +118,28 @@ export async function createUI5I18nEntries(root, manifestPath, i18nPropertiesPat
 export async function createAnnotationI18nEntries(root, manifestPath, i18nPropertiesPaths, newEntries, fs) {
     return createUI5I18nEntriesBase(root, manifestPath, i18nPropertiesPaths, newEntries, '@i18n', fs);
 }
+/**
+ * Maintains new translation entries at a specific i18n properties file path.
+ * Use this when the target file is already known (e.g. chosen by the user from a picker).
+ *
+ * @param root project root
+ * @param filePath absolute path to the target `.properties` file
+ * @param newEntries translation entries to write
+ * @param fs optional `mem-fs-editor` instance
+ * @returns boolean or exception
+ */
+export async function createI18nEntriesAtPath(root, filePath, newEntries, fs) {
+    const dirPath = dirname(filePath);
+    if (!fs) {
+        await mkdir(dirPath, { recursive: true });
+    }
+    return createPropertiesI18nEntries(filePath, newEntries, root, fs);
+}
 /**
  * Maintains new translation entries in an existing i18n file or in a new i18n properties file if it does not exist.
  *
  * @param root project root
- * @param i18nPropertiesPaths paths to `.properties` file`
+ * @param i18nPropertiesPaths paths to `.properties` file
  * @param newEntries translation entries to write in the `.properties` file
  * @param fs optional `mem-fs-editor` instance. If provided, `mem-fs-editor` api is used instead of `fs` of node
  * @returns boolean or exception

package/dist/project/index.d.ts

@@ -2,7 +2,7 @@ export { clearCdsModuleCache, deleteCapApp, getCapCustomPaths, getCapEnvironment
 export { filterDataSourcesByType, getMainService, getUsedEntitiesFromManifest } from './service.js';
 export type { UsedEntity } from './service.js';
 export { addPackageDevDependency, getNodeModulesPath, hasDependency } from './dependencies.js';
-export { getCapI18nFolderNames, getI18nPropertiesPaths, getI18nBundles } from './i18n/index.js';
+export { getCapI18nFolderNames, getI18nPropertiesPaths, getI18nBundles, createI18nEntriesAtPath } from './i18n/index.js';
 export { getAppProgrammingLanguage, getAppType, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getProject, getProjectType } from './info.js';
 export { loadModuleFromProject } from './module-loader.js';
 export { findAllApps, findCapProjects, findFioriArtifacts, findProjectRoot, getAppRootFromWebappPath, findCapProjectRoot, findRootsForPath } from './search.js';

package/dist/project/index.js

@@ -1,7 +1,7 @@
 export { clearCdsModuleCache, deleteCapApp, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapProjectType, getCapServiceName, getCdsFiles, getCdsRoots, getCdsServices, isCapProject, isCapJavaProject, isCapNodeJsProject, readCapServiceMetadataEdmx, toReferenceUri, getWorkspaceInfo, hasMinCdsVersion, checkCdsUi5PluginEnabled, processServices, getGlobalCdsHomePath } from './cap.js';
 export { filterDataSourcesByType, getMainService, getUsedEntitiesFromManifest } from './service.js';
 export { addPackageDevDependency, getNodeModulesPath, hasDependency } from './dependencies.js';
-export { getCapI18nFolderNames, getI18nPropertiesPaths, getI18nBundles } from './i18n/index.js';
+export { getCapI18nFolderNames, getI18nPropertiesPaths, getI18nBundles, createI18nEntriesAtPath } from './i18n/index.js';
 export { getAppProgrammingLanguage, getAppType, getMinUI5VersionFromManifest, getMinUI5VersionAsArray, getMinimumUI5Version, getProject, getProjectType } from './info.js';
 export { loadModuleFromProject } from './module-loader.js';
 export { findAllApps, findCapProjects, findFioriArtifacts, findProjectRoot, getAppRootFromWebappPath, findCapProjectRoot, findRootsForPath } from './search.js';

package/dist/types/access/index.d.ts

@@ -74,6 +74,15 @@ export interface ApplicationAccess extends BaseAccess {
      * @returns boolean or exception
      */
     createCapI18nEntries(filePath: string, newI18nEntries: NewI18nEntry[]): Promise<boolean>;
+    /**
+     * Maintains new translation entries at a specific i18n properties file path.
+     * Use this when the target file is already known (e.g. chosen by the user from a picker).
+     *
+     * @param filePath absolute path to the target `.properties` file
+     * @param newEntries translation entries to write
+     * @returns boolean or exception
+     */
+    createI18nEntriesAtPath(filePath: string, newEntries: NewI18nEntry[]): Promise<boolean>;
     /**
      * Return the application id of this app, which is the relative path from the project root
      * to the app root.

package/dist/types/info/index.d.ts

@@ -59,12 +59,22 @@ export interface I18nPropertiesPaths {
      * Absolute path to the i18n.properties file from sap.app namespace.
      */
     'sap.app': string;
+    /**
+     * Absolute path to the fallback locale i18n file from sap.app namespace, e.g. i18n_en.properties.
+     * Only set when `fallbackLocale` is configured in `sap.app.i18n`.
+     */
+    'sap.app.fallbackLocale'?: string;
     models: {
         [modelKey: string]: {
             /**
              * Absolute path to the i18n.properties files.
              */
             path: string;
+            /**
+             * Absolute path to the fallback locale i18n file, e.g. i18n_en.properties.
+             * Only set when `fallbackLocale` is configured in the model settings.
+             */
+            fallbackLocalePath?: string;
         };
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sap-ux/project-access",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "Library to access SAP Fiori tools projects",
   "type": "module",
   "repository": {