@worldware/msg-cli 0.0.4 → 0.1.0

package/dist/lib/init-helpers.d.mts

@@ -0,0 +1,100 @@
+/** Default relative path for the i18n directory. */
+declare const DEFAULT_I18N_DIR = "src/i18n";
+/** Default relative path for the l10n directory. */
+declare const DEFAULT_L10N_DIR = "res/l10n";
+/** Minimal type for package.json fields we read/write. */
+interface PackageJson {
+    name?: string;
+    directories?: Record<string, string>;
+    imports?: Record<string, string>;
+    scripts?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Finds package.json by walking up from the given directory.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @returns Absolute path to package.json, or null if not found
+ */
+declare function findPackageJsonPath(cwd: string): string | null;
+/**
+ * Reads and parses package.json.
+ * @param pkgPath - Absolute path to package.json
+ * @returns Parsed package.json object
+ * @throws Error if file is unreadable or invalid JSON
+ */
+declare function readPackageJson(pkgPath: string): PackageJson;
+/** Result of loadPackageJsonForMsg - shared package.json context for msg commands. */
+interface MsgPackageContext {
+    pkgPath: string;
+    rootDir: string;
+    pkg: PackageJson;
+    i18nDir: string;
+    l10nDir?: string;
+    isEsm: boolean;
+    useTypeScript: boolean;
+}
+/**
+ * Loads package.json for msg commands (create project, create resource, etc.).
+ * Finds package.json from cwd, validates directories, and derives module info.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @param options - requireL10n: if true, directories.l10n must exist (default: false)
+ * @returns Package context with pkgPath, rootDir, pkg, i18nDir, l10nDir?, isEsm, useTypeScript
+ * @throws Error if package.json not found or required directories missing
+ */
+declare function loadPackageJsonForMsg(cwd: string, options?: {
+    requireL10n?: boolean;
+}): MsgPackageContext;
+/**
+ * Writes package.json to disk with trailing newline.
+ * @param pkgPath - Absolute path to package.json
+ * @param pkg - Object to serialize
+ */
+declare function writePackageJson(pkgPath: string, pkg: PackageJson): void;
+/**
+ * Validates i18n and l10n paths (relative, non-empty, no absolute segments).
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @returns Object with valid: boolean and optional error message
+ */
+declare function validatePaths(rootDir: string, i18nDir: string, l10nDir: string): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Ensures i18n and l10n directory trees exist and adds .gitkeep to leaf dirs.
+ * Leaf dirs: i18n/projects, i18n/resources, l10n/translations, l10n/xliff.
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @param force - If true, overwrite/recreate even when dirs exist or are non-empty
+ */
+declare function ensureDirectoriesWithGitkeep(rootDir: string, i18nDir: string, l10nDir: string, force: boolean): void;
+/**
+ * Returns true if package.json already has msg directories and they exist on disk.
+ */
+declare function isAlreadyInitialized(pkg: PackageJson, rootDir: string, i18nDir: string, l10nDir: string): boolean;
+/**
+ * Adds or overwrites directories.i18n, directories.l10n, directories.root in package.json.
+ */
+declare function addDirectoriesToPackageJson(pkg: PackageJson, i18nDir: string, l10nDir: string): PackageJson;
+/**
+ * Adds import aliases #i18n/*, #l10n/*, #root/* to package.json imports.
+ */
+declare function addImportAliasesToPackageJson(pkg: PackageJson, i18nDir: string, l10nDir: string): PackageJson;
+/**
+ * Adds i18n-export and l10n-import scripts to package.json.
+ */
+declare function addScriptsToPackageJson(pkg: PackageJson): PackageJson;
+/**
+ * Reads tsconfig.json, adds baseUrl and paths for #i18n/*, #l10n/*, #root/*, and writes it back.
+ * Merges into existing compilerOptions.paths and compilerOptions.baseUrl if present.
+ * @param tsconfigPath - Absolute path to tsconfig.json
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ */
+declare function addTsconfigPaths(tsconfigPath: string, i18nDir: string, l10nDir: string): void;
+
+export { DEFAULT_I18N_DIR, DEFAULT_L10N_DIR, type MsgPackageContext, type PackageJson, addDirectoriesToPackageJson, addImportAliasesToPackageJson, addScriptsToPackageJson, addTsconfigPaths, ensureDirectoriesWithGitkeep, findPackageJsonPath, isAlreadyInitialized, loadPackageJsonForMsg, readPackageJson, validatePaths, writePackageJson };

package/dist/lib/init-helpers.d.ts

@@ -0,0 +1,100 @@
+/** Default relative path for the i18n directory. */
+declare const DEFAULT_I18N_DIR = "src/i18n";
+/** Default relative path for the l10n directory. */
+declare const DEFAULT_L10N_DIR = "res/l10n";
+/** Minimal type for package.json fields we read/write. */
+interface PackageJson {
+    name?: string;
+    directories?: Record<string, string>;
+    imports?: Record<string, string>;
+    scripts?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Finds package.json by walking up from the given directory.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @returns Absolute path to package.json, or null if not found
+ */
+declare function findPackageJsonPath(cwd: string): string | null;
+/**
+ * Reads and parses package.json.
+ * @param pkgPath - Absolute path to package.json
+ * @returns Parsed package.json object
+ * @throws Error if file is unreadable or invalid JSON
+ */
+declare function readPackageJson(pkgPath: string): PackageJson;
+/** Result of loadPackageJsonForMsg - shared package.json context for msg commands. */
+interface MsgPackageContext {
+    pkgPath: string;
+    rootDir: string;
+    pkg: PackageJson;
+    i18nDir: string;
+    l10nDir?: string;
+    isEsm: boolean;
+    useTypeScript: boolean;
+}
+/**
+ * Loads package.json for msg commands (create project, create resource, etc.).
+ * Finds package.json from cwd, validates directories, and derives module info.
+ * @param cwd - Directory to start from (e.g. process.cwd())
+ * @param options - requireL10n: if true, directories.l10n must exist (default: false)
+ * @returns Package context with pkgPath, rootDir, pkg, i18nDir, l10nDir?, isEsm, useTypeScript
+ * @throws Error if package.json not found or required directories missing
+ */
+declare function loadPackageJsonForMsg(cwd: string, options?: {
+    requireL10n?: boolean;
+}): MsgPackageContext;
+/**
+ * Writes package.json to disk with trailing newline.
+ * @param pkgPath - Absolute path to package.json
+ * @param pkg - Object to serialize
+ */
+declare function writePackageJson(pkgPath: string, pkg: PackageJson): void;
+/**
+ * Validates i18n and l10n paths (relative, non-empty, no absolute segments).
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @returns Object with valid: boolean and optional error message
+ */
+declare function validatePaths(rootDir: string, i18nDir: string, l10nDir: string): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Ensures i18n and l10n directory trees exist and adds .gitkeep to leaf dirs.
+ * Leaf dirs: i18n/projects, i18n/resources, l10n/translations, l10n/xliff.
+ * @param rootDir - Project root (absolute)
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ * @param force - If true, overwrite/recreate even when dirs exist or are non-empty
+ */
+declare function ensureDirectoriesWithGitkeep(rootDir: string, i18nDir: string, l10nDir: string, force: boolean): void;
+/**
+ * Returns true if package.json already has msg directories and they exist on disk.
+ */
+declare function isAlreadyInitialized(pkg: PackageJson, rootDir: string, i18nDir: string, l10nDir: string): boolean;
+/**
+ * Adds or overwrites directories.i18n, directories.l10n, directories.root in package.json.
+ */
+declare function addDirectoriesToPackageJson(pkg: PackageJson, i18nDir: string, l10nDir: string): PackageJson;
+/**
+ * Adds import aliases #i18n/*, #l10n/*, #root/* to package.json imports.
+ */
+declare function addImportAliasesToPackageJson(pkg: PackageJson, i18nDir: string, l10nDir: string): PackageJson;
+/**
+ * Adds i18n-export and l10n-import scripts to package.json.
+ */
+declare function addScriptsToPackageJson(pkg: PackageJson): PackageJson;
+/**
+ * Reads tsconfig.json, adds baseUrl and paths for #i18n/*, #l10n/*, #root/*, and writes it back.
+ * Merges into existing compilerOptions.paths and compilerOptions.baseUrl if present.
+ * @param tsconfigPath - Absolute path to tsconfig.json
+ * @param i18nDir - Relative i18n path
+ * @param l10nDir - Relative l10n path
+ */
+declare function addTsconfigPaths(tsconfigPath: string, i18nDir: string, l10nDir: string): void;
+
+export { DEFAULT_I18N_DIR, DEFAULT_L10N_DIR, type MsgPackageContext, type PackageJson, addDirectoriesToPackageJson, addImportAliasesToPackageJson, addScriptsToPackageJson, addTsconfigPaths, ensureDirectoriesWithGitkeep, findPackageJsonPath, isAlreadyInitialized, loadPackageJsonForMsg, readPackageJson, validatePaths, writePackageJson };

package/dist/lib/init-helpers.mjs

@@ -0,0 +1,30 @@
+import {
+  DEFAULT_I18N_DIR,
+  DEFAULT_L10N_DIR,
+  addDirectoriesToPackageJson,
+  addImportAliasesToPackageJson,
+  addScriptsToPackageJson,
+  addTsconfigPaths,
+  ensureDirectoriesWithGitkeep,
+  findPackageJsonPath,
+  isAlreadyInitialized,
+  loadPackageJsonForMsg,
+  readPackageJson,
+  validatePaths,
+  writePackageJson
+} from "../chunk-DBC2Y6VQ.mjs";
+export {
+  DEFAULT_I18N_DIR,
+  DEFAULT_L10N_DIR,
+  addDirectoriesToPackageJson,
+  addImportAliasesToPackageJson,
+  addScriptsToPackageJson,
+  addTsconfigPaths,
+  ensureDirectoriesWithGitkeep,
+  findPackageJsonPath,
+  isAlreadyInitialized,
+  loadPackageJsonForMsg,
+  readPackageJson,
+  validatePaths,
+  writePackageJson
+};

package/dist/lib/utilities.cjs

@@ -0,0 +1,203 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/utilities.ts
+var utilities_exports = {};
+__export(utilities_exports, {
+  findMsgResourceFiles: () => findMsgResourceFiles,
+  importMsgResources: () => importMsgResources,
+  parseXliff: () => parseXliff,
+  readXliff: () => readXliff,
+  resourcesToXliffString: () => resourcesToXliffString,
+  writeTranslationData: () => writeTranslationData,
+  writeXliff: () => writeXliff,
+  xliffDataToResourceTranslationData: () => xliffDataToResourceTranslationData,
+  xliffToTranslationData: () => xliffToTranslationData
+});
+module.exports = __toCommonJS(utilities_exports);
+var import_msg = require("@worldware/msg");
+var import_promises = require("fs/promises");
+var import_path = require("path");
+var import_url = require("url");
+var import_fast_xml_parser = require("fast-xml-parser");
+var MSG_PATTERN = /\.msg\.(ts|js)$/i;
+async function findMsgResourceFiles(directory) {
+  const result = [];
+  const entries = await (0, import_promises.readdir)(directory, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = (0, import_path.join)(directory, entry.name);
+    if (entry.isFile() && MSG_PATTERN.test(entry.name)) {
+      result.push(fullPath);
+    } else if (entry.isDirectory()) {
+      result.push(...await findMsgResourceFiles(fullPath));
+    }
+  }
+  return result;
+}
+async function importMsgResources(filePaths) {
+  const byProjectName = /* @__PURE__ */ new Map();
+  for (const filePath of filePaths) {
+    if (!MSG_PATTERN.test(filePath)) {
+      throw new Error(`File does not have .msg. in filename: ${filePath}`);
+    }
+    const url = (0, import_url.pathToFileURL)(filePath).href;
+    const mod = await import(url);
+    const resource = mod.default ?? mod.resource ?? mod.MsgResource;
+    if (!resource || !(resource instanceof import_msg.MsgResource)) {
+      throw new Error(
+        `Failed to import MsgResource from ${filePath}: no valid export found`
+      );
+    }
+    const project = resource.getProject();
+    const projectName = project.project.name;
+    let group = byProjectName.get(projectName);
+    if (!group) {
+      group = { project, resources: [] };
+      byProjectName.set(projectName, group);
+    }
+    group.resources.push(resource);
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const { project, resources } of byProjectName.values()) {
+    result.set(project, resources);
+  }
+  return result;
+}
+async function resourcesToXliffString(resources) {
+  const byProject = /* @__PURE__ */ new Map();
+  for (const resource of resources) {
+    const project = resource.getProject();
+    let arr = byProject.get(project);
+    if (!arr) {
+      arr = [];
+      byProject.set(project, arr);
+    }
+    arr.push(resource);
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const [project, arr] of byProject) {
+    const xliff = serializeResourcesToXliff(arr);
+    result.set(project, xliff);
+  }
+  return result;
+}
+function serializeResourcesToXliff(resources) {
+  const xmlns = "urn:oasis:names:tc:xliff:document:1.2";
+  const parts = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<xliff version="1.2" xmlns="${xmlns}">`
+  ];
+  for (const resource of resources) {
+    const orig = `${resource.title}.json`;
+    const sourceLang = resource.attributes.lang || "en";
+    const data = resource.getData(false);
+    parts.push(
+      `  <file original="${escapeXml(orig)}" source-language="${escapeXml(sourceLang)}" datatype="plaintext">`
+    );
+    parts.push("    <body>");
+    for (const msg of data.messages || []) {
+      const key = msg.key;
+      const value = msg.value;
+      const attrs = [`id="${escapeXml(key)}"`, `resname="${escapeXml(key)}"`];
+      parts.push(`      <trans-unit ${attrs.join(" ")}>`);
+      parts.push(`        <source>${escapeXml(value)}</source>`);
+      parts.push(`      </trans-unit>`);
+    }
+    parts.push("    </body>");
+    parts.push("  </file>");
+  }
+  parts.push("</xliff>");
+  return parts.join("\n");
+}
+function escapeXml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+async function writeXliff(filePath, xliff) {
+  await (0, import_promises.writeFile)(filePath, xliff, "utf-8");
+}
+async function readXliff(filePath) {
+  return (0, import_promises.readFile)(filePath, "utf-8");
+}
+var xmlParser = new import_fast_xml_parser.XMLParser({
+  ignoreAttributes: false,
+  attributeNamePrefix: "@_"
+});
+async function parseXliff(xliff) {
+  try {
+    const parsed = xmlParser.parse(xliff);
+    if (!parsed || typeof parsed !== "object") {
+      throw new Error("Invalid XLIFF: failed to parse");
+    }
+    return parsed;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Failed to parse XLIFF";
+    throw new Error(`Invalid XLIFF 1.2: ${message}`);
+  }
+}
+async function xliffDataToResourceTranslationData(parsedXliff) {
+  const result = [];
+  const xliff = parsedXliff;
+  const fileEl = xliff?.xliff?.file;
+  if (!fileEl) return result;
+  const files = Array.isArray(fileEl) ? fileEl : [fileEl];
+  for (const file of files) {
+    const f = file;
+    const orig = f["@_original"] ?? "unknown";
+    const title = (0, import_path.basename)(orig, (0, import_path.extname)(orig)) || orig;
+    const targetLang = f["@_target-language"] ?? f["@_source-language"] ?? "";
+    const transUnits = f.body?.["trans-unit"];
+    const units = Array.isArray(transUnits) ? transUnits : transUnits ? [transUnits] : [];
+    const messages = [];
+    for (const tu of units) {
+      const t = tu;
+      const translate = (t["@_translate"] ?? "yes").toLowerCase();
+      if (translate === "no" || translate === "false") continue;
+      const key = t["@_resname"] ?? t["@_id"] ?? "";
+      const targetEl = t.target;
+      const value = (typeof targetEl === "object" && targetEl && "#text" in targetEl ? targetEl["#text"] : typeof targetEl === "string" ? targetEl : "") ?? "";
+      messages.push({ key, value });
+    }
+    result.push({
+      title,
+      attributes: { lang: targetLang, dir: "", dnt: false },
+      messages
+    });
+  }
+  return result;
+}
+async function xliffToTranslationData(xliff) {
+  const parsed = await parseXliff(xliff);
+  return xliffDataToResourceTranslationData(parsed);
+}
+async function writeTranslationData(filePath, data) {
+  const json = JSON.stringify(data, null, 2);
+  await (0, import_promises.writeFile)(filePath, json, "utf-8");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findMsgResourceFiles,
+  importMsgResources,
+  parseXliff,
+  readXliff,
+  resourcesToXliffString,
+  writeTranslationData,
+  writeXliff,
+  xliffDataToResourceTranslationData,
+  xliffToTranslationData
+});

package/dist/lib/utilities.d.mts

@@ -0,0 +1,59 @@
+import { MsgProject, MsgResource, MsgResourceData } from '@worldware/msg';
+
+/**
+ * Recursively finds all javascript and typescript files in a directory that have
+ * an `.msg.` substring in their filename just before the file extension.
+ * @param directory - The directory path to search
+ * @returns Promise resolving to array of file paths
+ */
+declare function findMsgResourceFiles(directory: string): Promise<string[]>;
+/**
+ * Dynamically imports MsgResource objects from .msg. files and groups them by project.
+ * @param filePaths - Array of paths to .msg. files
+ * @returns Promise resolving to Map of MsgProject keys and MsgResource array values
+ */
+declare function importMsgResources(filePaths: string[]): Promise<Map<MsgProject, MsgResource[]>>;
+/**
+ * Serializes MsgResource arrays into monolingual XLIFF 1.2 strings per project.
+ * @param resources - Array of MsgResource objects
+ * @returns Promise resolving to Map of MsgProject keys and xliff string values
+ */
+declare function resourcesToXliffString(resources: MsgResource[]): Promise<Map<MsgProject, string>>;
+/**
+ * Writes an XLIFF 1.2 string to a file with appropriate indentation.
+ * @param filePath - The destination file path
+ * @param xliff - The serialized XLIFF 1.2 string
+ */
+declare function writeXliff(filePath: string, xliff: string): Promise<void>;
+/**
+ * Reads XLIFF 1.2 content from a file.
+ * @param filePath - The path to the XLIFF file
+ * @returns Promise resolving to the XLIFF string content
+ */
+declare function readXliff(filePath: string): Promise<string>;
+/**
+ * Parses an XLIFF 1.2 string into a javascript object, preserving notes and attributes.
+ * @param xliff - Valid XLIFF 1.2 string
+ * @returns Promise resolving to parsed object
+ */
+declare function parseXliff(xliff: string): Promise<object>;
+/**
+ * Extracts MsgResourceData from parsed XLIFF 1.2 object.
+ * @param parsedXliff - Parsed XLIFF 1.2 javascript object
+ * @returns Promise resolving to array of MsgResourceData objects
+ */
+declare function xliffDataToResourceTranslationData(parsedXliff: object): Promise<MsgResourceData[]>;
+/**
+ * Parses XLIFF 1.2 string and extracts translation data to MsgResourceData objects.
+ * @param xliff - Valid XLIFF 1.2 string
+ * @returns Promise resolving to array of MsgResourceData objects
+ */
+declare function xliffToTranslationData(xliff: string): Promise<MsgResourceData[]>;
+/**
+ * Serializes MsgResourceData to JSON and writes it to a file.
+ * @param filePath - The destination file path
+ * @param data - MsgResourceData object to serialize
+ */
+declare function writeTranslationData(filePath: string, data: MsgResourceData): Promise<void>;
+
+export { findMsgResourceFiles, importMsgResources, parseXliff, readXliff, resourcesToXliffString, writeTranslationData, writeXliff, xliffDataToResourceTranslationData, xliffToTranslationData };

package/dist/lib/utilities.d.ts

@@ -0,0 +1,59 @@
+import { MsgProject, MsgResource, MsgResourceData } from '@worldware/msg';
+
+/**
+ * Recursively finds all javascript and typescript files in a directory that have
+ * an `.msg.` substring in their filename just before the file extension.
+ * @param directory - The directory path to search
+ * @returns Promise resolving to array of file paths
+ */
+declare function findMsgResourceFiles(directory: string): Promise<string[]>;
+/**
+ * Dynamically imports MsgResource objects from .msg. files and groups them by project.
+ * @param filePaths - Array of paths to .msg. files
+ * @returns Promise resolving to Map of MsgProject keys and MsgResource array values
+ */
+declare function importMsgResources(filePaths: string[]): Promise<Map<MsgProject, MsgResource[]>>;
+/**
+ * Serializes MsgResource arrays into monolingual XLIFF 1.2 strings per project.
+ * @param resources - Array of MsgResource objects
+ * @returns Promise resolving to Map of MsgProject keys and xliff string values
+ */
+declare function resourcesToXliffString(resources: MsgResource[]): Promise<Map<MsgProject, string>>;
+/**
+ * Writes an XLIFF 1.2 string to a file with appropriate indentation.
+ * @param filePath - The destination file path
+ * @param xliff - The serialized XLIFF 1.2 string
+ */
+declare function writeXliff(filePath: string, xliff: string): Promise<void>;
+/**
+ * Reads XLIFF 1.2 content from a file.
+ * @param filePath - The path to the XLIFF file
+ * @returns Promise resolving to the XLIFF string content
+ */
+declare function readXliff(filePath: string): Promise<string>;
+/**
+ * Parses an XLIFF 1.2 string into a javascript object, preserving notes and attributes.
+ * @param xliff - Valid XLIFF 1.2 string
+ * @returns Promise resolving to parsed object
+ */
+declare function parseXliff(xliff: string): Promise<object>;
+/**
+ * Extracts MsgResourceData from parsed XLIFF 1.2 object.
+ * @param parsedXliff - Parsed XLIFF 1.2 javascript object
+ * @returns Promise resolving to array of MsgResourceData objects
+ */
+declare function xliffDataToResourceTranslationData(parsedXliff: object): Promise<MsgResourceData[]>;
+/**
+ * Parses XLIFF 1.2 string and extracts translation data to MsgResourceData objects.
+ * @param xliff - Valid XLIFF 1.2 string
+ * @returns Promise resolving to array of MsgResourceData objects
+ */
+declare function xliffToTranslationData(xliff: string): Promise<MsgResourceData[]>;
+/**
+ * Serializes MsgResourceData to JSON and writes it to a file.
+ * @param filePath - The destination file path
+ * @param data - MsgResourceData object to serialize
+ */
+declare function writeTranslationData(filePath: string, data: MsgResourceData): Promise<void>;
+
+export { findMsgResourceFiles, importMsgResources, parseXliff, readXliff, resourcesToXliffString, writeTranslationData, writeXliff, xliffDataToResourceTranslationData, xliffToTranslationData };