@ember-intl/utils 0.0.0-stage → 0.2.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @ember-intl/utils
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+_Utilities for `ember-intl` packages_
+
+
+## Compatibility
+
+- Node.js v22 or above
+
+
+## Contributing
+
+See the [Contributing](../../CONTRIBUTING.md) guide for details.
+
+
+## License
+
+This project is licensed under the [MIT License](./LICENSE.md).

package/dist/config/find-user-config.d.ts

@@ -0,0 +1 @@
+export declare function findUserConfig(projectRoot: string): string | undefined;

package/dist/config/find-user-config.js

@@ -0,0 +1,13 @@
+import { findFiles } from '@codemod-utils/files';
+export function findUserConfig(projectRoot) {
+    const filePaths = findFiles('ember-intl.config.{js,mjs,mts,ts}', {
+        projectRoot,
+    });
+    if (filePaths.length === 0) {
+        return undefined;
+    }
+    if (filePaths.length > 1) {
+        throw new Error('Found multiple config files');
+    }
+    return filePaths[0];
+}

package/dist/config/get-default-config.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from './types.js';
+export declare function getDefaultConfig(): Config;

package/dist/config/get-default-config.js

@@ -0,0 +1,16 @@
+import { lintRules } from '../lint-rules.js';
+export function getDefaultConfig() {
+    const rules = {};
+    lintRules.forEach((lintRule) => {
+        rules[lintRule] = true;
+    });
+    return {
+        addonPaths: [],
+        buildOptions: {
+            fallbackLocale: undefined,
+            namespaceKeysByDir: false,
+            translationsDir: 'translations',
+        },
+        lintRules: rules,
+    };
+}

package/dist/config/get-user-config.d.ts

@@ -0,0 +1,2 @@
+import type { UserConfig } from './types.js';
+export declare function getUserConfig(projectRoot: string): Promise<undefined | UserConfig>;

package/dist/config/get-user-config.js

@@ -0,0 +1,45 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { lintRules } from '../lint-rules.js';
+import { findUserConfig } from './find-user-config.js';
+import { getDefaultConfig } from './get-default-config.js';
+function validate(userConfig) {
+    if (userConfig === undefined) {
+        return;
+    }
+    const defaultConfig = getDefaultConfig();
+    if (userConfig.buildOptions) {
+        const buildOptions = new Set(Object.keys(defaultConfig.buildOptions));
+        Object.keys(userConfig.buildOptions).forEach((buildOption) => {
+            if (!buildOptions.has(buildOption)) {
+                throw new Error(`Unknown build option: ${buildOption}`);
+            }
+        });
+    }
+    if (userConfig.lintRules) {
+        Object.keys(userConfig.lintRules).forEach((lintRule) => {
+            if (!lintRules.includes(lintRule)) {
+                throw new Error(`Unknown lint rule: ${lintRule}`);
+            }
+        });
+    }
+}
+export async function getUserConfig(projectRoot) {
+    try {
+        const configFilePath = findUserConfig(projectRoot);
+        if (configFilePath === undefined) {
+            return undefined;
+        }
+        const fileURL = pathToFileURL(join(projectRoot, configFilePath));
+        // Add timestamp to prevent caching the user config across tests
+        const filePath = `${fileURL.href}?update=${Date.now()}`;
+        const { default: userConfig } = (await import(filePath));
+        validate(userConfig);
+        return userConfig;
+    }
+    catch (error) {
+        throw new Error(`ERROR: Unable to read the config file. (${error.message})`, {
+            cause: error,
+        });
+    }
+}

package/dist/config/merge-configs.d.ts

@@ -0,0 +1,2 @@
+import type { Config, UserConfig } from './types.js';
+export declare function mergeConfigs(config: Config, userConfig: undefined | UserConfig): Config;

package/dist/config/merge-configs.js

@@ -0,0 +1,21 @@
+export function mergeConfigs(config, userConfig) {
+    if (userConfig === undefined) {
+        return config;
+    }
+    if (userConfig.addonPaths) {
+        config.addonPaths = Array.from(new Set([...config.addonPaths, ...userConfig.addonPaths]));
+    }
+    if (userConfig.buildOptions) {
+        config.buildOptions = {
+            ...config.buildOptions,
+            ...userConfig.buildOptions,
+        };
+    }
+    if (userConfig.lintRules) {
+        config.lintRules = {
+            ...config.lintRules,
+            ...userConfig.lintRules,
+        };
+    }
+    return config;
+}

package/dist/config/types.d.ts

@@ -0,0 +1,17 @@
+import type { LintRule } from '../lint-rules.js';
+type LintRuleOptions = Record<string, unknown>;
+export type Config = {
+    addonPaths: string[];
+    buildOptions: {
+        fallbackLocale: string | undefined;
+        namespaceKeysByDir: boolean;
+        translationsDir: string;
+    };
+    lintRules: Record<LintRule, boolean | LintRuleOptions>;
+};
+export type UserConfig = Partial<{
+    addonPaths: Config['addonPaths'];
+    buildOptions: Partial<Config['buildOptions']>;
+    lintRules: Partial<Config['lintRules']>;
+}>;
+export {};

package/dist/config/types.js

@@ -0,0 +1 @@
+export {};

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export { findUserConfig } from './config/find-user-config.js';
+export { getDefaultConfig } from './config/get-default-config.js';
+export { getUserConfig } from './config/get-user-config.js';
+export { mergeConfigs } from './config/merge-configs.js';
+export type { Config, UserConfig } from './config/types.js';

package/dist/config.js

@@ -0,0 +1,4 @@
+export { findUserConfig } from './config/find-user-config.js';
+export { getDefaultConfig } from './config/get-default-config.js';
+export { getUserConfig } from './config/get-user-config.js';
+export { mergeConfigs } from './config/merge-configs.js';

package/dist/lint-rules.d.ts

@@ -0,0 +1,2 @@
+export declare const lintRules: readonly ["no-inconsistent-messages", "no-missing-keys", "no-unused-keys"];
+export type LintRule = (typeof lintRules)[number];

package/dist/lint-rules.js

@@ -0,0 +1,5 @@
+export const lintRules = [
+    'no-inconsistent-messages',
+    'no-missing-keys',
+    'no-unused-keys',
+];

package/dist/translations/find-translation-files.d.ts

@@ -0,0 +1,3 @@
+import type { Options } from '../types/index.js';
+import type { Project } from './types.js';
+export declare function findTranslationFiles(options: Options): Project['translationFiles'];

package/dist/translations/find-translation-files.js

@@ -0,0 +1,38 @@
+import { join, normalize, sep } from 'node:path';
+import { findFiles, parseFilePath } from '@codemod-utils/files';
+function getPattern(translationsDir) {
+    return join(translationsDir, '**/*.{json,yaml,yml}').replaceAll(sep, '/');
+}
+export function findTranslationFiles(options) {
+    const { config, projectRoot } = options;
+    const { addonPaths, buildOptions } = config;
+    const translationFiles = new Map();
+    addonPaths.forEach((addonPath) => {
+        const translationsDir = join(addonPath, 'translations');
+        const filePaths = findFiles(getPattern(translationsDir), {
+            projectRoot,
+        });
+        filePaths.forEach((filePath) => {
+            const { name } = parseFilePath(filePath);
+            translationFiles.set(filePath, {
+                isInternal: false,
+                locale: name,
+                translationsDir,
+            });
+        });
+    });
+    // App's translations take precedence
+    const translationsDir = normalize(buildOptions.translationsDir);
+    const filePaths = findFiles(getPattern(translationsDir), {
+        projectRoot,
+    });
+    filePaths.forEach((filePath) => {
+        const { name } = parseFilePath(filePath);
+        translationFiles.set(filePath, {
+            isInternal: true,
+            locale: name,
+            translationsDir,
+        });
+    });
+    return translationFiles;
+}

package/dist/translations/merge-translation-files/extract-translations.d.ts

@@ -0,0 +1,8 @@
+import type { TranslationFilePath, TranslationJson } from '../types.js';
+type Data = {
+    filePath: TranslationFilePath;
+    namespaceKeysByDir: boolean;
+    translationsDir: string;
+};
+export declare function extractTranslations(file: string, data: Data): TranslationJson;
+export {};

package/dist/translations/merge-translation-files/extract-translations.js

@@ -0,0 +1,54 @@
+import { relative, sep } from 'node:path';
+import { parseFilePath } from '@codemod-utils/files';
+import { load } from 'js-yaml';
+function getPrefix(data) {
+    if (!data.namespaceKeysByDir) {
+        return '';
+    }
+    const { dir } = parseFilePath(data.filePath);
+    const relativePath = relative(data.translationsDir, dir);
+    if (relativePath === '') {
+        return '';
+    }
+    const prefix = relativePath.replaceAll(sep, '.');
+    return `${prefix}.`;
+}
+function traverse(json, data) {
+    for (const key in json) {
+        if (!Object.hasOwn(json, key)) {
+            continue;
+        }
+        const value = json[key];
+        if (typeof value === 'object') {
+            traverse(value, {
+                callback: data.callback,
+                prefix: `${data.prefix}${key}.`,
+            });
+            continue;
+        }
+        data.callback(`${data.prefix}${key}`, value);
+    }
+}
+export function extractTranslations(file, data) {
+    const translationJson = {};
+    if (file === '') {
+        return translationJson;
+    }
+    const { ext } = parseFilePath(data.filePath);
+    try {
+        const json = ext === '.json'
+            ? JSON.parse(file)
+            : load(file);
+        const prefix = getPrefix(data);
+        traverse(json, {
+            callback(key, message) {
+                translationJson[key] = message;
+            },
+            prefix,
+        });
+    }
+    catch {
+        // Do nothing
+    }
+    return translationJson;
+}

package/dist/translations/merge-translation-files/index.d.ts

@@ -0,0 +1,2 @@
+export * from './extract-translations.js';
+export * from './sort-translations.js';

package/dist/translations/merge-translation-files/index.js

@@ -0,0 +1,2 @@
+export * from './extract-translations.js';
+export * from './sort-translations.js';

package/dist/translations/merge-translation-files/sort-translations.d.ts

@@ -0,0 +1,2 @@
+import type { Project } from '../types.js';
+export declare function sortTranslations(translations: Project['translations']): Project['translations'];

package/dist/translations/merge-translation-files/sort-translations.js

@@ -0,0 +1,8 @@
+export function sortTranslations(translations) {
+    const translationsSorted = new Map();
+    translations.forEach((keyToData, locale) => {
+        const keyToDataSorted = new Map(Array.from(keyToData).sort());
+        translationsSorted.set(locale, keyToDataSorted);
+    });
+    return translationsSorted;
+}

package/dist/translations/merge-translation-files.d.ts

@@ -0,0 +1,3 @@
+import type { Options } from '../types/index.js';
+import type { Project } from './types.js';
+export declare function mergeTranslationFiles(translationFiles: Project['translationFiles'], options: Options): Project['translations'];

package/dist/translations/merge-translation-files.js

@@ -0,0 +1,40 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { extractTranslations, sortTranslations, } from './merge-translation-files/index.js';
+export function mergeTranslationFiles(translationFiles, options) {
+    const { config, projectRoot } = options;
+    const { buildOptions } = config;
+    const translations = new Map();
+    translationFiles.forEach((data, filePath) => {
+        const file = readFileSync(join(projectRoot, filePath), 'utf8');
+        const translationJson = extractTranslations(file, {
+            filePath,
+            namespaceKeysByDir: buildOptions.namespaceKeysByDir,
+            translationsDir: data.translationsDir,
+        });
+        const keyToData = translations.get(data.locale) ??
+            new Map();
+        for (const [key, message] of Object.entries(translationJson)) {
+            keyToData.set(key, {
+                filePath,
+                message,
+            });
+        }
+        translations.set(data.locale, keyToData);
+    });
+    if (buildOptions.fallbackLocale) {
+        const fallbacksKeyToData = translations.get(buildOptions.fallbackLocale);
+        translations.forEach((keyToData, locale) => {
+            if (locale === buildOptions.fallbackLocale) {
+                return;
+            }
+            fallbacksKeyToData.forEach((data, key) => {
+                if (!keyToData.has(key)) {
+                    keyToData.set(key, data);
+                }
+            });
+            translations.set(locale, keyToData);
+        });
+    }
+    return sortTranslations(translations);
+}

package/dist/translations/types.d.ts

@@ -0,0 +1,18 @@
+type Locale = string;
+type ProjectTranslationData = {
+    filePath: TranslationFilePath;
+    message: TranslationMessage;
+};
+type TranslationFilePath = string;
+type TranslationJson = Record<TranslationKey, TranslationMessage>;
+type TranslationKey = string;
+type TranslationMessage = string;
+type Project = {
+    translationFiles: Map<TranslationFilePath, {
+        isInternal: boolean;
+        locale: Locale;
+        translationsDir: string;
+    }>;
+    translations: Map<Locale, Map<TranslationKey, ProjectTranslationData>>;
+};
+export type { Locale, Project, ProjectTranslationData, TranslationFilePath, TranslationJson, TranslationKey, TranslationMessage, };

package/dist/translations/types.js

@@ -0,0 +1 @@
+export {};

package/dist/translations.d.ts

@@ -0,0 +1,3 @@
+export { findTranslationFiles } from './translations/find-translation-files.js';
+export { mergeTranslationFiles } from './translations/merge-translation-files.js';
+export type { Project, ProjectTranslationData, TranslationJson, TranslationKey, } from './translations/types.js';

package/dist/translations.js

@@ -0,0 +1,2 @@
+export { findTranslationFiles } from './translations/find-translation-files.js';
+export { mergeTranslationFiles } from './translations/merge-translation-files.js';

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from '../config.js';
+export type Options = {
+    [key: string]: unknown;
+    config: Config;
+    projectRoot: string;
+};

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@ember-intl/utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Utilities for ember-intl packages",
+  "keywords": [
+    "ember-intl"
+  ],
+  "homepage": "https://ember-intl.github.io/ember-intl/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ember-intl/ember-intl.git",
+    "directory": "packages/ember-intl-utils"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@codemod-utils/files": "^4.1.0",
+    "js-yaml": "^5.4.2"
+  },
+  "devDependencies": {
+    "@codemod-utils/tests": "^3.3.0",
+    "@shared-configs/eslint-config-node": "0.0.0",
+    "@shared-configs/prettier": "0.0.0",
+    "@shared-configs/typescript": "0.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.20.4",
+    "concurrently": "^10.0.5",
+    "eslint": "^10.11.0",
+    "prettier": "^3.9.9",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": "22.* || >= 24"
+  },
+  "scripts": {
+    "build": "sh build.sh --production",
+    "format": "prettier . --cache --write",
+    "lint": "concurrently \"pnpm:lint:*(!fix)\" --names \"lint:\"",
+    "lint:fix": "concurrently \"pnpm:lint:*:fix\" --names \"fix:\" && pnpm format",
+    "lint:format": "prettier . --cache --check",
+    "lint:js": "eslint . --cache",
+    "lint:js:fix": "eslint . --fix",
+    "lint:types": "tsc --noEmit",
+    "test": "sh build.sh --test && mt dist-for-testing --quiet"
+  }
 }