gt 2.18.0 → 2.18.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # gtx-cli
 
+## 2.18.1
+
+### Patch Changes
+
+- [#2226](https://github.com/generaltranslation/gt/pull/2226) [`44aabc7`](https://github.com/generaltranslation/gt/commit/44aabc734d99fab4fcab7faedc84d20b5772bde3) Thanks [@eoinest](https://github.com/eoinest)! - Rename the `.strings` and `.stringsdict` file formats. The API format names become `DOT_STRINGS` and `DOT_STRINGSDICT`, and the `gt.config.json` keys under `files` become `dotStrings` and `dotStringsdict`.
+
+  **This is a breaking configuration change.** A `gt.config.json` that still uses `files.strings` or `files.stringsdict` will silently stop matching those files, because the old keys are no longer recognised file types. Rename them to `files.dotStrings` and `files.dotStringsdict`. The file extensions on disk are unchanged, and translated output is still written as `.strings` and `.stringsdict`.
+
+  The old names identified a vendor rather than a file. Apple ships four string formats — `.strings`, `.stringsdict`, `.xcstrings` and `.plist` — so `APPLE_STRINGS` never said which one it meant. The new names identify the extension itself, the way developers say it out loud.
+
+- Updated dependencies [[`44aabc7`](https://github.com/generaltranslation/gt/commit/44aabc734d99fab4fcab7faedc84d20b5772bde3)]:
+  - generaltranslation@9.1.12
+  - @generaltranslation/python-extractor@0.2.45
+  - @generaltranslation/supported-locales@2.1.25
+  - @generaltranslation/vue-extractor@0.1.5
+
 ## 2.18.0
 
 ### Minor Changes

package/dist/formats/files/aggregateFiles.js

@@ -208,10 +208,10 @@ async function aggregateFiles(settings) {
 		if (expressionOffenders.length > 0) logErrorAndExit(lottieExpressionsError(expressionOffenders));
 		files.push(...lottieFiles);
 	}
-	for (const [fileType, fileFormat] of [["strings", "APPLE_STRINGS"], ["stringsdict", "APPLE_STRINGSDICT"]]) {
+	for (const [fileType, fileFormat] of [["dotStrings", "DOT_STRINGS"], ["dotStringsdict", "DOT_STRINGSDICT"]]) {
 		if (!filePaths[fileType]) continue;
 		const readsRawBytes = isBinaryFileFormat(fileFormat);
-		const appleFiles = filePaths[fileType].map((filePath) => {
+		const verbatimFiles = filePaths[fileType].map((filePath) => {
 			const content = readsRawBytes ? readBinaryFileBase64(filePath) : readFile(filePath);
 			const relativePath = getRelative(filePath);
 			return {
@@ -231,10 +231,10 @@ async function aggregateFiles(settings) {
 			}
 			return true;
 		});
-		files.push(...appleFiles);
+		files.push(...verbatimFiles);
 	}
 	for (const fileType of SUPPORTED_FILE_EXTENSIONS) {
-		if (fileType === "json" || fileType === "yaml" || fileType === "twilioContentJson" || fileType === "lottie" || fileType === "strings" || fileType === "stringsdict") continue;
+		if (fileType === "json" || fileType === "yaml" || fileType === "twilioContentJson" || fileType === "lottie" || fileType === "dotStrings" || fileType === "dotStringsdict") continue;
 		if (filePaths[fileType]) {
 			const parsed = filePaths[fileType].map((filePath) => {
 				const content = readFile(filePath);

package/dist/formats/files/aggregateFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregateFiles.js","names":[],"sources":["../../../src/formats/files/aggregateFiles.ts"],"sourcesContent":["import { logger } from '../../console/logger.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport { lottieExpressionsError } from '../../console/index.js';\nimport { recordWarning } from '../../state/translateWarnings.js';\nimport { lottieHasExpressions } from './detectLottieExpressions.js';\nimport {\n  getRelative,\n  readFile,\n  readBinaryFileBase64,\n} from '../../fs/findFilepath.js';\nimport { isBinaryFileFormat } from 'generaltranslation/types';\nimport { Settings } from '../../types/index.js';\nimport type { FileFormat, DataFormat, FileToUpload } from '../../types/data.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from './supportedFiles.js';\nimport { parseJson } from '../json/parseJson.js';\nimport {\n  resolveMintlifyRefs,\n  shouldResolveRefs,\n} from '../../utils/resolveMintlifyRefs.js';\nimport { storeRefMap } from '../../state/mintlifyRefMap.js';\nimport parseYaml from '../yaml/parseYaml.js';\nimport { validateYamlSchema } from '../yaml/utils.js';\nimport { flattenJson } from '../json/flattenJson.js';\nimport type { JSONObject } from '../../types/data/json.js';\nimport YAML from 'yaml';\nimport { determineLibrary } from '../../fs/determineFramework/index.js';\nimport { hashStringSync, hashVersionId } from '../../utils/hash.js';\nimport { preprocessContent } from './preprocessContent.js';\nimport {\n  parseKeyedMetadata,\n  type KeyedMetadata,\n} from '../parseKeyedMetadata.js';\nimport { buildPublishMap } from '../../utils/resolvePublish.js';\nimport { getTransformFormatProperty } from './transformFormat.js';\n\n/**\n * Checks if a file path is a metadata companion file (e.g. foo.metadata.json)\n * AND its corresponding source file (e.g. foo.json) exists in the file list.\n * If both conditions are true, the metadata file should be skipped as a translation source.\n */\nfunction isCompanionMetadataFile(\n  filePath: string,\n  allFilePaths: string[]\n): boolean {\n  const metadataPattern = /\\.metadata\\.(json|yaml|yml)$/;\n  if (!metadataPattern.test(filePath)) return false;\n\n  // Derive the source file path: foo.metadata.json -> foo.json\n  const sourceFilePath = filePath.replace(\n    /\\.metadata\\.(json|yaml|yml)$/,\n    '.$1'\n  );\n  return allFilePaths.includes(sourceFilePath);\n}\n\nexport async function aggregateFiles(\n  settings: Settings\n): Promise<{ files: FileToUpload[]; publishMap: Map<string, boolean> }> {\n  // Aggregate all files to translate\n  const files: FileToUpload[] = [];\n  if (\n    !settings.files ||\n    (Object.keys(settings.files.placeholderPaths).length === 1 &&\n      settings.files.placeholderPaths.gt)\n  ) {\n    return { files, publishMap: new Map<string, boolean>() };\n  }\n\n  const { resolvedPaths: filePaths } = settings.files;\n  // Tolerate partially-constructed settings from programmatic callers\n  const requiresReviewPaths =\n    settings.files.requiresReviewPaths ?? new Set<string>();\n  const skipValidation = settings.options?.skipFileValidation;\n\n  // Build publish map upfront from resolved paths.\n  const publishMap = buildPublishMap(filePaths, settings);\n\n  // Process JSON files\n  if (filePaths.json) {\n    const { library, additionalModules } = determineLibrary();\n\n    // Determine dataFormat for JSONs\n    let dataFormat: DataFormat;\n    if (library === 'next-intl') {\n      dataFormat = 'ICU';\n    } else if (library === 'i18next') {\n      if (additionalModules.includes('i18next-icu')) {\n        dataFormat = 'ICU';\n      } else {\n        dataFormat = 'I18NEXT';\n      }\n    } else {\n      dataFormat = 'STRING';\n    }\n\n    const jsonFiles = filePaths.json\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.json!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        // Resolve $ref before parsing if configured\n        let contentForParsing = content;\n        if (shouldResolveRefs(filePath, settings.options)) {\n          try {\n            const json = JSON.parse(content);\n            const { resolved, refMap } = resolveMintlifyRefs(json, filePath);\n            storeRefMap(refMap);\n            contentForParsing = JSON.stringify(resolved, null, 2);\n          } catch {\n            // JSON parse errors are handled below by parseJson\n          }\n        }\n\n        const parsedJson = parseJson(\n          contentForParsing,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        let parsedContent: JSONObject | undefined;\n        try {\n          parsedContent = JSON.parse(content) as JSONObject;\n        } catch {\n          // Content not parsable — skip metadata detection\n        }\n        if (parsedContent) {\n          const rawMetadata = parseKeyedMetadata(filePath, parsedContent);\n          if (rawMetadata) {\n            // Run metadata through the same include/composite schema as the source\n            // so key paths align at translation time\n            const transformed = parseJson(\n              JSON.stringify(rawMetadata),\n              filePath,\n              settings.options || {},\n              settings.defaultLocale,\n              false\n            );\n            const transformedMetadata = JSON.parse(transformed);\n\n            // Filter metadata to only keep keys that exist in the transformed source\n            // This prevents misaligned entries from wide JSONPath patterns\n            const sourceKeys = new Set(Object.keys(JSON.parse(parsedJson)));\n            const filtered = Object.fromEntries(\n              Object.entries(transformedMetadata).filter(([k]) =>\n                sourceKeys.has(k)\n              )\n            ) as KeyedMetadata;\n\n            if (Object.keys(filtered).length > 0) {\n              keyedMetadata = filtered;\n            } else {\n              logger.warn(\n                `Companion metadata found for ${relativePath} but no keys aligned with the JSON schema — metadata was not attached`\n              );\n            }\n          }\n        }\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'JSON' as const,\n          ...getTransformFormatProperty(settings, 'json'),\n          dataFormat,\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...jsonFiles.filter((file) => file !== null));\n  }\n\n  // Process YAML files\n  if (filePaths.yaml) {\n    const yamlFiles = filePaths.yaml\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.yaml!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate YAML parseability\n        if (!skipValidation?.yaml) {\n          try {\n            YAML.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: YAML file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'YAML file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const { content: parsedYaml, fileFormat } = parseYaml(\n          content,\n          filePath,\n          settings.options || {}\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        try {\n          const parsedYamlContent = YAML.parse(content);\n          const rawMetadata = parseKeyedMetadata(filePath, parsedYamlContent);\n          if (rawMetadata) {\n            const yamlSchema = validateYamlSchema(\n              settings.options || {},\n              filePath\n            );\n            if (yamlSchema?.include) {\n              // Flatten metadata through the same include schema as the source\n              const flattened = flattenJson(rawMetadata, yamlSchema.include);\n              // Filter to only keep keys that exist in the transformed source\n              const sourceKeys = new Set(Object.keys(JSON.parse(parsedYaml)));\n              const filtered = Object.fromEntries(\n                Object.entries(flattened).filter(([k]) => sourceKeys.has(k))\n              ) as KeyedMetadata;\n              if (Object.keys(filtered).length > 0) {\n                keyedMetadata = filtered;\n              } else {\n                logger.warn(\n                  `Companion metadata found for ${relativePath} but no keys aligned with the YAML schema — metadata was not attached`\n                );\n              }\n            } else {\n              keyedMetadata = rawMetadata;\n            }\n          }\n        } catch {\n          // Content not parsable as YAML — skip metadata detection\n        }\n\n        return {\n          content: parsedYaml,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, 'yaml'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedYaml,\n            requiresReviewPaths.has(filePath)\n          ),\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file || typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(\n            `Skipping ${file?.fileName ?? 'unknown'}: YAML file is empty`\n          );\n          recordWarning(\n            'skipped_file',\n            file?.fileName ?? 'unknown',\n            'YAML file is empty'\n          );\n          return false;\n        }\n        return true;\n      });\n    files.push(...yamlFiles.filter((file) => file !== null));\n  }\n\n  // Process Twilio Content JSON files\n  if (filePaths.twilioContentJson) {\n    const twilioContentJsonFiles = filePaths.twilioContentJson\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const parsedJson = parseJson(\n          content,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'TWILIO_CONTENT_JSON' as const,\n          ...getTransformFormatProperty(settings, 'twilioContentJson'),\n          dataFormat: 'STRING' as const,\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...twilioContentJsonFiles.filter((file) => file !== null));\n  }\n\n  // Process Lottie files (binary zip bundles). Content is read as raw bytes and\n  // carried base64-encoded end-to-end; the downloaded translation is written\n  // back as bytes. No text parsing/merge.\n  if (filePaths.lottie) {\n    // Lottie files carrying After Effects expressions (executable JS) are\n    // rejected outright — collect every offender, then fail once with all of\n    // them named rather than aborting on the first.\n    const expressionOffenders: string[] = [];\n    const lottieFiles = filePaths.lottie\n      .map((filePath) => {\n        const content = readBinaryFileBase64(filePath);\n        const relativePath = getRelative(filePath);\n        if (!content) {\n          logger.warn(`Skipping ${relativePath}: file is empty or unreadable`);\n          recordWarning(\n            'skipped_file',\n            relativePath,\n            'File is empty or unreadable'\n          );\n          return null;\n        }\n        if (lottieHasExpressions(content)) {\n          expressionOffenders.push(relativePath);\n          return null;\n        }\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat: 'LOTTIE' as const,\n          ...getTransformFormatProperty(settings, 'lottie'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashStringSync(content),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => file !== null);\n    if (expressionOffenders.length > 0) {\n      logErrorAndExit(lottieExpressionsError(expressionOffenders));\n    }\n    files.push(...lottieFiles);\n  }\n\n  // Apple .strings/.stringsdict files are uploaded verbatim. Their backslash\n  // escapes and format specifiers must survive byte-for-byte, so they skip the\n  // generic markdown-oriented preprocessing below.\n  for (const [fileType, fileFormat] of [\n    ['strings', 'APPLE_STRINGS'],\n    ['stringsdict', 'APPLE_STRINGSDICT'],\n  ] as const) {\n    if (!filePaths[fileType]) continue;\n    // Content must already be base64 exactly when the format is binary, or the\n    // upload path encodes it a second time. Only .strings qualifies today: its\n    // UTF-16 bytes reach an API decoder that reads the byte order mark, and\n    // .stringsdict has no such decoder yet.\n    const readsRawBytes = isBinaryFileFormat(fileFormat);\n    const appleFiles = filePaths[fileType]\n      .map((filePath) => {\n        const content = readsRawBytes\n          ? readBinaryFileBase64(filePath)\n          : readFile(filePath);\n        const relativePath = getRelative(filePath);\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, fileType),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(content, requiresReviewPaths.has(filePath)),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        // Blank check only; the content itself travels untouched. A UTF-16\n        // file reads as non-blank here, which is the safe default — the API\n        // decodes it properly.\n        const text = readsRawBytes\n          ? Buffer.from(file.content, 'base64').toString('utf8')\n          : file.content;\n        if (!text.trim()) {\n          logger.warn(`Skipping ${file.fileName}: File is empty`);\n          recordWarning('skipped_file', file.fileName, 'File is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...appleFiles);\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson' ||\n      fileType === 'lottie' ||\n      fileType === 'strings' ||\n      fileType === 'stringsdict'\n    )\n      continue;\n    if (filePaths[fileType]) {\n      const parsed = filePaths[fileType]\n        .map((filePath) => {\n          const content = readFile(filePath);\n          const relativePath = getRelative(filePath);\n\n          const processed = preprocessContent(\n            content,\n            relativePath,\n            fileType,\n            settings\n          );\n\n          if (typeof processed !== 'string') {\n            logger.warn(`Skipping ${relativePath}: ${processed.skip}`);\n            recordWarning('skipped_file', relativePath, processed.skip);\n            return null;\n          }\n\n          return {\n            content: processed,\n            fileName: relativePath,\n            fileFormat: fileType.toUpperCase() as FileFormat,\n            ...getTransformFormatProperty(settings, fileType),\n            fileId: hashStringSync(relativePath),\n            versionId: hashVersionId(\n              processed,\n              requiresReviewPaths.has(filePath)\n            ),\n            locale: settings.defaultLocale,\n          } satisfies FileToUpload;\n        })\n        .filter((file) => {\n          if (\n            !file ||\n            typeof file.content !== 'string' ||\n            !file.content.trim()\n          ) {\n            logger.warn(\n              `Skipping ${file?.fileName ?? 'unknown'}: File is empty after sanitization`\n            );\n            recordWarning(\n              'skipped_file',\n              file?.fileName ?? 'unknown',\n              'File is empty after sanitization'\n            );\n            return false;\n          }\n          return true;\n        });\n      files.push(...parsed.filter((file) => file !== null));\n    }\n  }\n\n  // Remove stale entries for files that were skipped during validation\n  const validFileIds = new Set(files.map((f) => f.fileId));\n  for (const fileId of publishMap.keys()) {\n    if (!validFileIds.has(fileId)) {\n      publishMap.delete(fileId);\n    }\n  }\n\n  return { files, publishMap };\n}\n"],"mappings":"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"}
+{"version":3,"file":"aggregateFiles.js","names":[],"sources":["../../../src/formats/files/aggregateFiles.ts"],"sourcesContent":["import { logger } from '../../console/logger.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport { lottieExpressionsError } from '../../console/index.js';\nimport { recordWarning } from '../../state/translateWarnings.js';\nimport { lottieHasExpressions } from './detectLottieExpressions.js';\nimport {\n  getRelative,\n  readFile,\n  readBinaryFileBase64,\n} from '../../fs/findFilepath.js';\nimport { isBinaryFileFormat } from 'generaltranslation/types';\nimport { Settings } from '../../types/index.js';\nimport type { FileFormat, DataFormat, FileToUpload } from '../../types/data.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from './supportedFiles.js';\nimport { parseJson } from '../json/parseJson.js';\nimport {\n  resolveMintlifyRefs,\n  shouldResolveRefs,\n} from '../../utils/resolveMintlifyRefs.js';\nimport { storeRefMap } from '../../state/mintlifyRefMap.js';\nimport parseYaml from '../yaml/parseYaml.js';\nimport { validateYamlSchema } from '../yaml/utils.js';\nimport { flattenJson } from '../json/flattenJson.js';\nimport type { JSONObject } from '../../types/data/json.js';\nimport YAML from 'yaml';\nimport { determineLibrary } from '../../fs/determineFramework/index.js';\nimport { hashStringSync, hashVersionId } from '../../utils/hash.js';\nimport { preprocessContent } from './preprocessContent.js';\nimport {\n  parseKeyedMetadata,\n  type KeyedMetadata,\n} from '../parseKeyedMetadata.js';\nimport { buildPublishMap } from '../../utils/resolvePublish.js';\nimport { getTransformFormatProperty } from './transformFormat.js';\n\n/**\n * Checks if a file path is a metadata companion file (e.g. foo.metadata.json)\n * AND its corresponding source file (e.g. foo.json) exists in the file list.\n * If both conditions are true, the metadata file should be skipped as a translation source.\n */\nfunction isCompanionMetadataFile(\n  filePath: string,\n  allFilePaths: string[]\n): boolean {\n  const metadataPattern = /\\.metadata\\.(json|yaml|yml)$/;\n  if (!metadataPattern.test(filePath)) return false;\n\n  // Derive the source file path: foo.metadata.json -> foo.json\n  const sourceFilePath = filePath.replace(\n    /\\.metadata\\.(json|yaml|yml)$/,\n    '.$1'\n  );\n  return allFilePaths.includes(sourceFilePath);\n}\n\nexport async function aggregateFiles(\n  settings: Settings\n): Promise<{ files: FileToUpload[]; publishMap: Map<string, boolean> }> {\n  // Aggregate all files to translate\n  const files: FileToUpload[] = [];\n  if (\n    !settings.files ||\n    (Object.keys(settings.files.placeholderPaths).length === 1 &&\n      settings.files.placeholderPaths.gt)\n  ) {\n    return { files, publishMap: new Map<string, boolean>() };\n  }\n\n  const { resolvedPaths: filePaths } = settings.files;\n  // Tolerate partially-constructed settings from programmatic callers\n  const requiresReviewPaths =\n    settings.files.requiresReviewPaths ?? new Set<string>();\n  const skipValidation = settings.options?.skipFileValidation;\n\n  // Build publish map upfront from resolved paths.\n  const publishMap = buildPublishMap(filePaths, settings);\n\n  // Process JSON files\n  if (filePaths.json) {\n    const { library, additionalModules } = determineLibrary();\n\n    // Determine dataFormat for JSONs\n    let dataFormat: DataFormat;\n    if (library === 'next-intl') {\n      dataFormat = 'ICU';\n    } else if (library === 'i18next') {\n      if (additionalModules.includes('i18next-icu')) {\n        dataFormat = 'ICU';\n      } else {\n        dataFormat = 'I18NEXT';\n      }\n    } else {\n      dataFormat = 'STRING';\n    }\n\n    const jsonFiles = filePaths.json\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.json!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        // Resolve $ref before parsing if configured\n        let contentForParsing = content;\n        if (shouldResolveRefs(filePath, settings.options)) {\n          try {\n            const json = JSON.parse(content);\n            const { resolved, refMap } = resolveMintlifyRefs(json, filePath);\n            storeRefMap(refMap);\n            contentForParsing = JSON.stringify(resolved, null, 2);\n          } catch {\n            // JSON parse errors are handled below by parseJson\n          }\n        }\n\n        const parsedJson = parseJson(\n          contentForParsing,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        let parsedContent: JSONObject | undefined;\n        try {\n          parsedContent = JSON.parse(content) as JSONObject;\n        } catch {\n          // Content not parsable — skip metadata detection\n        }\n        if (parsedContent) {\n          const rawMetadata = parseKeyedMetadata(filePath, parsedContent);\n          if (rawMetadata) {\n            // Run metadata through the same include/composite schema as the source\n            // so key paths align at translation time\n            const transformed = parseJson(\n              JSON.stringify(rawMetadata),\n              filePath,\n              settings.options || {},\n              settings.defaultLocale,\n              false\n            );\n            const transformedMetadata = JSON.parse(transformed);\n\n            // Filter metadata to only keep keys that exist in the transformed source\n            // This prevents misaligned entries from wide JSONPath patterns\n            const sourceKeys = new Set(Object.keys(JSON.parse(parsedJson)));\n            const filtered = Object.fromEntries(\n              Object.entries(transformedMetadata).filter(([k]) =>\n                sourceKeys.has(k)\n              )\n            ) as KeyedMetadata;\n\n            if (Object.keys(filtered).length > 0) {\n              keyedMetadata = filtered;\n            } else {\n              logger.warn(\n                `Companion metadata found for ${relativePath} but no keys aligned with the JSON schema — metadata was not attached`\n              );\n            }\n          }\n        }\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'JSON' as const,\n          ...getTransformFormatProperty(settings, 'json'),\n          dataFormat,\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...jsonFiles.filter((file) => file !== null));\n  }\n\n  // Process YAML files\n  if (filePaths.yaml) {\n    const yamlFiles = filePaths.yaml\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.yaml!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate YAML parseability\n        if (!skipValidation?.yaml) {\n          try {\n            YAML.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: YAML file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'YAML file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const { content: parsedYaml, fileFormat } = parseYaml(\n          content,\n          filePath,\n          settings.options || {}\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        try {\n          const parsedYamlContent = YAML.parse(content);\n          const rawMetadata = parseKeyedMetadata(filePath, parsedYamlContent);\n          if (rawMetadata) {\n            const yamlSchema = validateYamlSchema(\n              settings.options || {},\n              filePath\n            );\n            if (yamlSchema?.include) {\n              // Flatten metadata through the same include schema as the source\n              const flattened = flattenJson(rawMetadata, yamlSchema.include);\n              // Filter to only keep keys that exist in the transformed source\n              const sourceKeys = new Set(Object.keys(JSON.parse(parsedYaml)));\n              const filtered = Object.fromEntries(\n                Object.entries(flattened).filter(([k]) => sourceKeys.has(k))\n              ) as KeyedMetadata;\n              if (Object.keys(filtered).length > 0) {\n                keyedMetadata = filtered;\n              } else {\n                logger.warn(\n                  `Companion metadata found for ${relativePath} but no keys aligned with the YAML schema — metadata was not attached`\n                );\n              }\n            } else {\n              keyedMetadata = rawMetadata;\n            }\n          }\n        } catch {\n          // Content not parsable as YAML — skip metadata detection\n        }\n\n        return {\n          content: parsedYaml,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, 'yaml'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedYaml,\n            requiresReviewPaths.has(filePath)\n          ),\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file || typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(\n            `Skipping ${file?.fileName ?? 'unknown'}: YAML file is empty`\n          );\n          recordWarning(\n            'skipped_file',\n            file?.fileName ?? 'unknown',\n            'YAML file is empty'\n          );\n          return false;\n        }\n        return true;\n      });\n    files.push(...yamlFiles.filter((file) => file !== null));\n  }\n\n  // Process Twilio Content JSON files\n  if (filePaths.twilioContentJson) {\n    const twilioContentJsonFiles = filePaths.twilioContentJson\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const parsedJson = parseJson(\n          content,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'TWILIO_CONTENT_JSON' as const,\n          ...getTransformFormatProperty(settings, 'twilioContentJson'),\n          dataFormat: 'STRING' as const,\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...twilioContentJsonFiles.filter((file) => file !== null));\n  }\n\n  // Process Lottie files (binary zip bundles). Content is read as raw bytes and\n  // carried base64-encoded end-to-end; the downloaded translation is written\n  // back as bytes. No text parsing/merge.\n  if (filePaths.lottie) {\n    // Lottie files carrying After Effects expressions (executable JS) are\n    // rejected outright — collect every offender, then fail once with all of\n    // them named rather than aborting on the first.\n    const expressionOffenders: string[] = [];\n    const lottieFiles = filePaths.lottie\n      .map((filePath) => {\n        const content = readBinaryFileBase64(filePath);\n        const relativePath = getRelative(filePath);\n        if (!content) {\n          logger.warn(`Skipping ${relativePath}: file is empty or unreadable`);\n          recordWarning(\n            'skipped_file',\n            relativePath,\n            'File is empty or unreadable'\n          );\n          return null;\n        }\n        if (lottieHasExpressions(content)) {\n          expressionOffenders.push(relativePath);\n          return null;\n        }\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat: 'LOTTIE' as const,\n          ...getTransformFormatProperty(settings, 'lottie'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashStringSync(content),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => file !== null);\n    if (expressionOffenders.length > 0) {\n      logErrorAndExit(lottieExpressionsError(expressionOffenders));\n    }\n    files.push(...lottieFiles);\n  }\n\n  // .strings and .stringsdict files are uploaded verbatim. Their backslash\n  // escapes and format specifiers must survive byte-for-byte, so they skip the\n  // generic markdown-oriented preprocessing below.\n  for (const [fileType, fileFormat] of [\n    ['dotStrings', 'DOT_STRINGS'],\n    ['dotStringsdict', 'DOT_STRINGSDICT'],\n  ] as const) {\n    if (!filePaths[fileType]) continue;\n    // Content must already be base64 exactly when the format is binary, or the\n    // upload path encodes it a second time. Only .strings qualifies today: its\n    // UTF-16 bytes reach an API decoder that reads the byte order mark, and\n    // .stringsdict has no such decoder yet.\n    const readsRawBytes = isBinaryFileFormat(fileFormat);\n    const verbatimFiles = filePaths[fileType]\n      .map((filePath) => {\n        const content = readsRawBytes\n          ? readBinaryFileBase64(filePath)\n          : readFile(filePath);\n        const relativePath = getRelative(filePath);\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, fileType),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(content, requiresReviewPaths.has(filePath)),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        // Blank check only; the content itself travels untouched. A UTF-16\n        // file reads as non-blank here, which is the safe default — the API\n        // decodes it properly.\n        const text = readsRawBytes\n          ? Buffer.from(file.content, 'base64').toString('utf8')\n          : file.content;\n        if (!text.trim()) {\n          logger.warn(`Skipping ${file.fileName}: File is empty`);\n          recordWarning('skipped_file', file.fileName, 'File is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...verbatimFiles);\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson' ||\n      fileType === 'lottie' ||\n      fileType === 'dotStrings' ||\n      fileType === 'dotStringsdict'\n    )\n      continue;\n    if (filePaths[fileType]) {\n      const parsed = filePaths[fileType]\n        .map((filePath) => {\n          const content = readFile(filePath);\n          const relativePath = getRelative(filePath);\n\n          const processed = preprocessContent(\n            content,\n            relativePath,\n            fileType,\n            settings\n          );\n\n          if (typeof processed !== 'string') {\n            logger.warn(`Skipping ${relativePath}: ${processed.skip}`);\n            recordWarning('skipped_file', relativePath, processed.skip);\n            return null;\n          }\n\n          return {\n            content: processed,\n            fileName: relativePath,\n            fileFormat: fileType.toUpperCase() as FileFormat,\n            ...getTransformFormatProperty(settings, fileType),\n            fileId: hashStringSync(relativePath),\n            versionId: hashVersionId(\n              processed,\n              requiresReviewPaths.has(filePath)\n            ),\n            locale: settings.defaultLocale,\n          } satisfies FileToUpload;\n        })\n        .filter((file) => {\n          if (\n            !file ||\n            typeof file.content !== 'string' ||\n            !file.content.trim()\n          ) {\n            logger.warn(\n              `Skipping ${file?.fileName ?? 'unknown'}: File is empty after sanitization`\n            );\n            recordWarning(\n              'skipped_file',\n              file?.fileName ?? 'unknown',\n              'File is empty after sanitization'\n            );\n            return false;\n          }\n          return true;\n        });\n      files.push(...parsed.filter((file) => file !== null));\n    }\n  }\n\n  // Remove stale entries for files that were skipped during validation\n  const validFileIds = new Set(files.map((f) => f.fileId));\n  for (const fileId of publishMap.keys()) {\n    if (!validFileIds.has(fileId)) {\n      publishMap.delete(fileId);\n    }\n  }\n\n  return { files, publishMap };\n}\n"],"mappings":"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"}

package/dist/formats/files/supportedFiles.d.ts

@@ -1,4 +1,4 @@
-export declare const SUPPORTED_FILE_EXTENSIONS: readonly ["json", "pot", "mdx", "md", "ts", "js", "yaml", "html", "txt", "twilioContentJson", "lottie", "strings", "stringsdict"];
+export declare const SUPPORTED_FILE_EXTENSIONS: readonly ["json", "pot", "mdx", "md", "ts", "js", "yaml", "html", "txt", "twilioContentJson", "lottie", "dotStrings", "dotStringsdict"];
 export declare const FILE_EXT_TO_EXT_LABEL: {
     json: string;
     pot: string;
@@ -11,6 +11,6 @@ export declare const FILE_EXT_TO_EXT_LABEL: {
     txt: string;
     twilioContentJson: string;
     lottie: string;
-    strings: string;
-    stringsdict: string;
+    dotStrings: string;
+    dotStringsdict: string;
 };

package/dist/formats/files/supportedFiles.js

@@ -11,8 +11,8 @@ const SUPPORTED_FILE_EXTENSIONS = [
 	"txt",
 	"twilioContentJson",
 	"lottie",
-	"strings",
-	"stringsdict"
+	"dotStrings",
+	"dotStringsdict"
 ];
 const FILE_EXT_TO_EXT_LABEL = {
 	json: "JSON",
@@ -26,8 +26,8 @@ const FILE_EXT_TO_EXT_LABEL = {
 	txt: "Text",
 	twilioContentJson: "Twilio Content JSON",
 	lottie: "Lottie",
-	strings: "Apple .strings",
-	stringsdict: "Apple .stringsdict"
+	dotStrings: ".strings",
+	dotStringsdict: ".stringsdict"
 };
 //#endregion
 export { FILE_EXT_TO_EXT_LABEL, SUPPORTED_FILE_EXTENSIONS };

package/dist/formats/files/supportedFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"supportedFiles.js","names":[],"sources":["../../../src/formats/files/supportedFiles.ts"],"sourcesContent":["export const SUPPORTED_FILE_EXTENSIONS = [\n  'json',\n  'pot',\n  'mdx',\n  'md',\n  'ts',\n  'js',\n  'yaml',\n  'html',\n  'txt',\n  'twilioContentJson',\n  'lottie',\n  'strings',\n  'stringsdict',\n] as const;\n\nexport const FILE_EXT_TO_EXT_LABEL = {\n  json: 'JSON',\n  pot: 'POT',\n  mdx: 'MDX',\n  md: 'Markdown',\n  ts: 'TypeScript',\n  js: 'JavaScript',\n  yaml: 'YAML',\n  html: 'HTML',\n  txt: 'Text',\n  twilioContentJson: 'Twilio Content JSON',\n  lottie: 'Lottie',\n  strings: 'Apple .strings',\n  stringsdict: 'Apple .stringsdict',\n};\n"],"mappings":";AAAA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,wBAAwB;CACnC,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,mBAAmB;CACnB,QAAQ;CACR,SAAS;CACT,aAAa;CACd"}
+{"version":3,"file":"supportedFiles.js","names":[],"sources":["../../../src/formats/files/supportedFiles.ts"],"sourcesContent":["export const SUPPORTED_FILE_EXTENSIONS = [\n  'json',\n  'pot',\n  'mdx',\n  'md',\n  'ts',\n  'js',\n  'yaml',\n  'html',\n  'txt',\n  'twilioContentJson',\n  'lottie',\n  'dotStrings',\n  'dotStringsdict',\n] as const;\n\nexport const FILE_EXT_TO_EXT_LABEL = {\n  json: 'JSON',\n  pot: 'POT',\n  mdx: 'MDX',\n  md: 'Markdown',\n  ts: 'TypeScript',\n  js: 'JavaScript',\n  yaml: 'YAML',\n  html: 'HTML',\n  txt: 'Text',\n  twilioContentJson: 'Twilio Content JSON',\n  lottie: 'Lottie',\n  dotStrings: '.strings',\n  dotStringsdict: '.stringsdict',\n};\n"],"mappings":";AAAA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,wBAAwB;CACnC,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,mBAAmB;CACnB,QAAQ;CACR,YAAY;CACZ,gBAAgB;CACjB"}

package/dist/formats/files/transformFormat.d.ts

@@ -15,8 +15,8 @@ export declare const CONFIG_FILE_TYPE_TO_FILE_FORMAT: {
     readonly txt: "TXT";
     readonly twilioContentJson: "TWILIO_CONTENT_JSON";
     readonly lottie: "LOTTIE";
-    readonly strings: "APPLE_STRINGS";
-    readonly stringsdict: "APPLE_STRINGSDICT";
+    readonly dotStrings: "DOT_STRINGS";
+    readonly dotStringsdict: "DOT_STRINGSDICT";
 };
 /**
  * Maps uppercase config aliases to the CLI's canonical lowercase file keys.
@@ -33,8 +33,8 @@ export declare const FILE_FORMAT_TO_CONFIG_FILE_TYPE: {
     readonly TXT: "txt";
     readonly TWILIO_CONTENT_JSON: "twilioContentJson";
     readonly LOTTIE: "lottie";
-    readonly APPLE_STRINGS: "strings";
-    readonly APPLE_STRINGSDICT: "stringsdict";
+    readonly DOT_STRINGS: "dotStrings";
+    readonly DOT_STRINGSDICT: "dotStringsdict";
 };
 /**
  * Converts uppercase file format config keys into the CLI's canonical lowercase keys.

package/dist/formats/files/transformFormat.js

@@ -15,8 +15,8 @@ const CONFIG_FILE_TYPE_TO_FILE_FORMAT = {
 	txt: "TXT",
 	twilioContentJson: "TWILIO_CONTENT_JSON",
 	lottie: "LOTTIE",
-	strings: "APPLE_STRINGS",
-	stringsdict: "APPLE_STRINGSDICT"
+	dotStrings: "DOT_STRINGS",
+	dotStringsdict: "DOT_STRINGSDICT"
 };
 /**
 * Maps uppercase config aliases to the CLI's canonical lowercase file keys.
@@ -33,8 +33,8 @@ const FILE_FORMAT_TO_CONFIG_FILE_TYPE = {
 	TXT: "txt",
 	TWILIO_CONTENT_JSON: "twilioContentJson",
 	LOTTIE: "lottie",
-	APPLE_STRINGS: "strings",
-	APPLE_STRINGSDICT: "stringsdict"
+	DOT_STRINGS: "dotStrings",
+	DOT_STRINGSDICT: "dotStringsdict"
 };
 /**
 * Maps API file format enum values to the extension the CLI should write.
@@ -54,8 +54,8 @@ const FILE_FORMAT_EXTENSIONS = {
 	TWILIO_CONTENT_JSON: "json",
 	LOTTIE: "lottie",
 	SVG: "svg",
-	APPLE_STRINGS: "strings",
-	APPLE_STRINGSDICT: "stringsdict"
+	DOT_STRINGS: "strings",
+	DOT_STRINGSDICT: "stringsdict"
 };
 /**
 * Converts uppercase file format config keys into the CLI's canonical lowercase keys.

package/dist/formats/files/transformFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformFormat.js","names":[],"sources":["../../../src/formats/files/transformFormat.ts"],"sourcesContent":["import type { FileFormat } from '../../types/data.js';\nimport type {\n  FilesOptions,\n  Settings,\n  SupportedFileExtension,\n} from '../../types/index.js';\nimport { isSupportedFileFormatTransform } from 'generaltranslation/internal';\n\n/**\n * Maps CLI config file keys to API file format enum values.\n */\nexport const CONFIG_FILE_TYPE_TO_FILE_FORMAT = {\n  json: 'JSON',\n  pot: 'POT',\n  mdx: 'MDX',\n  md: 'MD',\n  ts: 'TS',\n  js: 'JS',\n  yaml: 'YAML',\n  html: 'HTML',\n  txt: 'TXT',\n  twilioContentJson: 'TWILIO_CONTENT_JSON',\n  lottie: 'LOTTIE',\n  strings: 'APPLE_STRINGS',\n  stringsdict: 'APPLE_STRINGSDICT',\n} as const satisfies Record<SupportedFileExtension, FileFormat>;\n\n/**\n * Maps uppercase config aliases to the CLI's canonical lowercase file keys.\n */\nexport const FILE_FORMAT_TO_CONFIG_FILE_TYPE = {\n  JSON: 'json',\n  POT: 'pot',\n  MDX: 'mdx',\n  MD: 'md',\n  TS: 'ts',\n  JS: 'js',\n  YAML: 'yaml',\n  HTML: 'html',\n  TXT: 'txt',\n  TWILIO_CONTENT_JSON: 'twilioContentJson',\n  LOTTIE: 'lottie',\n  APPLE_STRINGS: 'strings',\n  APPLE_STRINGSDICT: 'stringsdict',\n} as const satisfies Partial<Record<FileFormat, SupportedFileExtension>>;\n\n/**\n * Maps API file format enum values to the extension the CLI should write.\n */\nconst FILE_FORMAT_EXTENSIONS = {\n  GTJSON: 'json',\n  JSON: 'json',\n  PO: 'po',\n  POT: 'pot',\n  YAML: 'yaml',\n  MDX: 'mdx',\n  MD: 'md',\n  TS: 'ts',\n  JS: 'js',\n  HTML: 'html',\n  TXT: 'txt',\n  TWILIO_CONTENT_JSON: 'json',\n  LOTTIE: 'lottie',\n  SVG: 'svg',\n  APPLE_STRINGS: 'strings',\n  APPLE_STRINGSDICT: 'stringsdict',\n} as const satisfies Record<FileFormat, string>;\n\n/**\n * Converts uppercase file format config keys into the CLI's canonical lowercase keys.\n *\n * This lets users write either `files.POT` or `files.pot` while keeping the\n * rest of the CLI on its existing lowercase file-type convention.\n */\nexport function normalizeFilesOptions(files: FilesOptions): FilesOptions {\n  const normalized = { ...files } as FilesOptions & Record<string, unknown>;\n\n  for (const [fileFormat, fileType] of Object.entries(\n    FILE_FORMAT_TO_CONFIG_FILE_TYPE\n  ) as [string, SupportedFileExtension][]) {\n    const uppercaseConfig = normalized[fileFormat] as\n      | FilesOptions[SupportedFileExtension]\n      | undefined;\n    if (!normalized[fileType] && uppercaseConfig) {\n      normalized[fileType] = uppercaseConfig;\n    }\n    delete normalized[fileFormat];\n  }\n\n  return normalized;\n}\n\n/**\n * Validates and resolves a configured output format for a source file type.\n *\n * Throws when the requested source -> output format is not supported by\n * `generaltranslation/internal`.\n */\nexport function resolveTransformationFormat(\n  fileType: SupportedFileExtension,\n  transformationFormat: string | undefined\n): FileFormat | undefined {\n  if (!transformationFormat) return undefined;\n\n  // Normalize to uppercase to match the FileFormat enum (e.g. \"po\" -> \"PO\")\n  const normalized = transformationFormat.toUpperCase() as FileFormat;\n  const fileFormat = CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType];\n\n  if (!isSupportedFileFormatTransform(fileFormat, normalized)) {\n    throw new Error(\n      `Unsupported file format transform: ${fileFormat} -> ${normalized} in files.${fileType}. ` +\n        `\"${normalized}\" is not a valid transformationFormat for ${fileFormat} source files.`\n    );\n  }\n\n  return normalized;\n}\n\n/**\n * Returns the API upload/enqueue property for a file type when one is configured.\n */\nexport function getTransformFormatProperty(\n  settings: Settings,\n  fileType: SupportedFileExtension\n): { transformFormat?: FileFormat } {\n  const transformFormat = settings.files?.transformFormats?.[fileType];\n  return transformFormat ? { transformFormat } : {};\n}\n\n/**\n * Returns the preferred file extension for a translated file format.\n */\nexport function getFileExtensionForFormat(format: FileFormat): string {\n  return FILE_FORMAT_EXTENSIONS[format];\n}\n\n/**\n * Rewrites a path's extension to match the translated file format.\n */\nexport function replaceFileExtensionForFormat(\n  filePath: string,\n  format: FileFormat\n): string {\n  const extension = getFileExtensionForFormat(format);\n  return /\\.[^/.]+$/.test(filePath)\n    ? filePath.replace(/\\.[^/.]+$/, `.${extension}`)\n    : `${filePath}.${extension}`;\n}\n\n/**\n * Detects whether any configured format transform changes the output file type.\n */\nexport function hasNonIdentityFileFormatTransform(settings: Settings): boolean {\n  return Object.entries(settings.files?.transformFormats || {}).some(\n    ([fileType, transformFormat]) =>\n      transformFormat &&\n      CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType as SupportedFileExtension] !==\n        transformFormat\n  );\n}\n\n/**\n * Returns true when the configured transform for a file type changes its format.\n */\nexport function hasNonIdentityFileFormatTransformForType(\n  settings: Settings,\n  fileType: SupportedFileExtension\n): boolean {\n  const transformFormat = settings.files?.transformFormats?.[fileType];\n  return !!(\n    transformFormat &&\n    CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType] !== transformFormat\n  );\n}\n"],"mappings":";;;;;AAWA,MAAa,kCAAkC;CAC7C,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,mBAAmB;CACnB,QAAQ;CACR,SAAS;CACT,aAAa;CACd;;;;AAKD,MAAa,kCAAkC;CAC7C,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,qBAAqB;CACrB,QAAQ;CACR,eAAe;CACf,mBAAmB;CACpB;;;;AAKD,MAAM,yBAAyB;CAC7B,QAAQ;CACR,MAAM;CACN,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,KAAK;CACL,qBAAqB;CACrB,QAAQ;CACR,KAAK;CACL,eAAe;CACf,mBAAmB;CACpB;;;;;;;AAQD,SAAgB,sBAAsB,OAAmC;CACvE,MAAM,aAAa,EAAE,GAAG,OAAO;AAE/B,MAAK,MAAM,CAAC,YAAY,aAAa,OAAO,QAC1C,gCACD,EAAwC;EACvC,MAAM,kBAAkB,WAAW;AAGnC,MAAI,CAAC,WAAW,aAAa,gBAC3B,YAAW,YAAY;AAEzB,SAAO,WAAW;;AAGpB,QAAO;;;;;;;;AAST,SAAgB,4BACd,UACA,sBACwB;AACxB,KAAI,CAAC,qBAAsB,QAAO,KAAA;CAGlC,MAAM,aAAa,qBAAqB,aAAa;CACrD,MAAM,aAAa,gCAAgC;AAEnD,KAAI,CAAC,+BAA+B,YAAY,WAAW,CACzD,OAAM,IAAI,MACR,sCAAsC,WAAW,MAAM,WAAW,YAAY,SAAS,KACjF,WAAW,4CAA4C,WAAW,gBACzE;AAGH,QAAO;;;;;AAMT,SAAgB,2BACd,UACA,UACkC;CAClC,MAAM,kBAAkB,SAAS,OAAO,mBAAmB;AAC3D,QAAO,kBAAkB,EAAE,iBAAiB,GAAG,EAAE;;;;;AAMnD,SAAgB,0BAA0B,QAA4B;AACpE,QAAO,uBAAuB;;;;;AAMhC,SAAgB,8BACd,UACA,QACQ;CACR,MAAM,YAAY,0BAA0B,OAAO;AACnD,QAAO,YAAY,KAAK,SAAS,GAC7B,SAAS,QAAQ,aAAa,IAAI,YAAY,GAC9C,GAAG,SAAS,GAAG;;;;;AAMrB,SAAgB,kCAAkC,UAA6B;AAC7E,QAAO,OAAO,QAAQ,SAAS,OAAO,oBAAoB,EAAE,CAAC,CAAC,MAC3D,CAAC,UAAU,qBACV,mBACA,gCAAgC,cAC9B,gBACL;;;;;AAMH,SAAgB,yCACd,UACA,UACS;CACT,MAAM,kBAAkB,SAAS,OAAO,mBAAmB;AAC3D,QAAO,CAAC,EACN,mBACA,gCAAgC,cAAc"}
+{"version":3,"file":"transformFormat.js","names":[],"sources":["../../../src/formats/files/transformFormat.ts"],"sourcesContent":["import type { FileFormat } from '../../types/data.js';\nimport type {\n  FilesOptions,\n  Settings,\n  SupportedFileExtension,\n} from '../../types/index.js';\nimport { isSupportedFileFormatTransform } from 'generaltranslation/internal';\n\n/**\n * Maps CLI config file keys to API file format enum values.\n */\nexport const CONFIG_FILE_TYPE_TO_FILE_FORMAT = {\n  json: 'JSON',\n  pot: 'POT',\n  mdx: 'MDX',\n  md: 'MD',\n  ts: 'TS',\n  js: 'JS',\n  yaml: 'YAML',\n  html: 'HTML',\n  txt: 'TXT',\n  twilioContentJson: 'TWILIO_CONTENT_JSON',\n  lottie: 'LOTTIE',\n  dotStrings: 'DOT_STRINGS',\n  dotStringsdict: 'DOT_STRINGSDICT',\n} as const satisfies Record<SupportedFileExtension, FileFormat>;\n\n/**\n * Maps uppercase config aliases to the CLI's canonical lowercase file keys.\n */\nexport const FILE_FORMAT_TO_CONFIG_FILE_TYPE = {\n  JSON: 'json',\n  POT: 'pot',\n  MDX: 'mdx',\n  MD: 'md',\n  TS: 'ts',\n  JS: 'js',\n  YAML: 'yaml',\n  HTML: 'html',\n  TXT: 'txt',\n  TWILIO_CONTENT_JSON: 'twilioContentJson',\n  LOTTIE: 'lottie',\n  DOT_STRINGS: 'dotStrings',\n  DOT_STRINGSDICT: 'dotStringsdict',\n} as const satisfies Partial<Record<FileFormat, SupportedFileExtension>>;\n\n/**\n * Maps API file format enum values to the extension the CLI should write.\n */\nconst FILE_FORMAT_EXTENSIONS = {\n  GTJSON: 'json',\n  JSON: 'json',\n  PO: 'po',\n  POT: 'pot',\n  YAML: 'yaml',\n  MDX: 'mdx',\n  MD: 'md',\n  TS: 'ts',\n  JS: 'js',\n  HTML: 'html',\n  TXT: 'txt',\n  TWILIO_CONTENT_JSON: 'json',\n  LOTTIE: 'lottie',\n  SVG: 'svg',\n  DOT_STRINGS: 'strings',\n  DOT_STRINGSDICT: 'stringsdict',\n} as const satisfies Record<FileFormat, string>;\n\n/**\n * Converts uppercase file format config keys into the CLI's canonical lowercase keys.\n *\n * This lets users write either `files.POT` or `files.pot` while keeping the\n * rest of the CLI on its existing lowercase file-type convention.\n */\nexport function normalizeFilesOptions(files: FilesOptions): FilesOptions {\n  const normalized = { ...files } as FilesOptions & Record<string, unknown>;\n\n  for (const [fileFormat, fileType] of Object.entries(\n    FILE_FORMAT_TO_CONFIG_FILE_TYPE\n  ) as [string, SupportedFileExtension][]) {\n    const uppercaseConfig = normalized[fileFormat] as\n      | FilesOptions[SupportedFileExtension]\n      | undefined;\n    if (!normalized[fileType] && uppercaseConfig) {\n      normalized[fileType] = uppercaseConfig;\n    }\n    delete normalized[fileFormat];\n  }\n\n  return normalized;\n}\n\n/**\n * Validates and resolves a configured output format for a source file type.\n *\n * Throws when the requested source -> output format is not supported by\n * `generaltranslation/internal`.\n */\nexport function resolveTransformationFormat(\n  fileType: SupportedFileExtension,\n  transformationFormat: string | undefined\n): FileFormat | undefined {\n  if (!transformationFormat) return undefined;\n\n  // Normalize to uppercase to match the FileFormat enum (e.g. \"po\" -> \"PO\")\n  const normalized = transformationFormat.toUpperCase() as FileFormat;\n  const fileFormat = CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType];\n\n  if (!isSupportedFileFormatTransform(fileFormat, normalized)) {\n    throw new Error(\n      `Unsupported file format transform: ${fileFormat} -> ${normalized} in files.${fileType}. ` +\n        `\"${normalized}\" is not a valid transformationFormat for ${fileFormat} source files.`\n    );\n  }\n\n  return normalized;\n}\n\n/**\n * Returns the API upload/enqueue property for a file type when one is configured.\n */\nexport function getTransformFormatProperty(\n  settings: Settings,\n  fileType: SupportedFileExtension\n): { transformFormat?: FileFormat } {\n  const transformFormat = settings.files?.transformFormats?.[fileType];\n  return transformFormat ? { transformFormat } : {};\n}\n\n/**\n * Returns the preferred file extension for a translated file format.\n */\nexport function getFileExtensionForFormat(format: FileFormat): string {\n  return FILE_FORMAT_EXTENSIONS[format];\n}\n\n/**\n * Rewrites a path's extension to match the translated file format.\n */\nexport function replaceFileExtensionForFormat(\n  filePath: string,\n  format: FileFormat\n): string {\n  const extension = getFileExtensionForFormat(format);\n  return /\\.[^/.]+$/.test(filePath)\n    ? filePath.replace(/\\.[^/.]+$/, `.${extension}`)\n    : `${filePath}.${extension}`;\n}\n\n/**\n * Detects whether any configured format transform changes the output file type.\n */\nexport function hasNonIdentityFileFormatTransform(settings: Settings): boolean {\n  return Object.entries(settings.files?.transformFormats || {}).some(\n    ([fileType, transformFormat]) =>\n      transformFormat &&\n      CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType as SupportedFileExtension] !==\n        transformFormat\n  );\n}\n\n/**\n * Returns true when the configured transform for a file type changes its format.\n */\nexport function hasNonIdentityFileFormatTransformForType(\n  settings: Settings,\n  fileType: SupportedFileExtension\n): boolean {\n  const transformFormat = settings.files?.transformFormats?.[fileType];\n  return !!(\n    transformFormat &&\n    CONFIG_FILE_TYPE_TO_FILE_FORMAT[fileType] !== transformFormat\n  );\n}\n"],"mappings":";;;;;AAWA,MAAa,kCAAkC;CAC7C,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,mBAAmB;CACnB,QAAQ;CACR,YAAY;CACZ,gBAAgB;CACjB;;;;AAKD,MAAa,kCAAkC;CAC7C,MAAM;CACN,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;CACN,KAAK;CACL,qBAAqB;CACrB,QAAQ;CACR,aAAa;CACb,iBAAiB;CAClB;;;;AAKD,MAAM,yBAAyB;CAC7B,QAAQ;CACR,MAAM;CACN,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,KAAK;CACL,qBAAqB;CACrB,QAAQ;CACR,KAAK;CACL,aAAa;CACb,iBAAiB;CAClB;;;;;;;AAQD,SAAgB,sBAAsB,OAAmC;CACvE,MAAM,aAAa,EAAE,GAAG,OAAO;AAE/B,MAAK,MAAM,CAAC,YAAY,aAAa,OAAO,QAC1C,gCACD,EAAwC;EACvC,MAAM,kBAAkB,WAAW;AAGnC,MAAI,CAAC,WAAW,aAAa,gBAC3B,YAAW,YAAY;AAEzB,SAAO,WAAW;;AAGpB,QAAO;;;;;;;;AAST,SAAgB,4BACd,UACA,sBACwB;AACxB,KAAI,CAAC,qBAAsB,QAAO,KAAA;CAGlC,MAAM,aAAa,qBAAqB,aAAa;CACrD,MAAM,aAAa,gCAAgC;AAEnD,KAAI,CAAC,+BAA+B,YAAY,WAAW,CACzD,OAAM,IAAI,MACR,sCAAsC,WAAW,MAAM,WAAW,YAAY,SAAS,KACjF,WAAW,4CAA4C,WAAW,gBACzE;AAGH,QAAO;;;;;AAMT,SAAgB,2BACd,UACA,UACkC;CAClC,MAAM,kBAAkB,SAAS,OAAO,mBAAmB;AAC3D,QAAO,kBAAkB,EAAE,iBAAiB,GAAG,EAAE;;;;;AAMnD,SAAgB,0BAA0B,QAA4B;AACpE,QAAO,uBAAuB;;;;;AAMhC,SAAgB,8BACd,UACA,QACQ;CACR,MAAM,YAAY,0BAA0B,OAAO;AACnD,QAAO,YAAY,KAAK,SAAS,GAC7B,SAAS,QAAQ,aAAa,IAAI,YAAY,GAC9C,GAAG,SAAS,GAAG;;;;;AAMrB,SAAgB,kCAAkC,UAA6B;AAC7E,QAAO,OAAO,QAAQ,SAAS,OAAO,oBAAoB,EAAE,CAAC,CAAC,MAC3D,CAAC,UAAU,qBACV,mBACA,gCAAgC,cAC9B,gBACL;;;;;AAMH,SAAgB,yCACd,UACA,UACS;CACT,MAAM,kBAAkB,SAAS,OAAO,mBAAmB;AAC3D,QAAO,CAAC,EACN,mBACA,gCAAgC,cAAc"}

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.18.0";
+export declare const PACKAGE_VERSION = "2.18.1";

package/dist/generated/version.js

@@ -1,5 +1,5 @@
 //#region src/generated/version.ts
-const PACKAGE_VERSION = "2.18.0";
+const PACKAGE_VERSION = "2.18.1";
 //#endregion
 export { PACKAGE_VERSION };
 

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.18.0';\n"],"mappings":";AACA,MAAa,kBAAkB"}
+{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.18.1';\n"],"mappings":";AACA,MAAa,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gt",
-  "version": "2.18.0",
+  "version": "2.18.1",
   "main": "dist/index.js",
   "bin": "bin/main.js",
   "files": [
@@ -117,10 +117,10 @@
     "yaml": "^2.8.0",
     "@generaltranslation/icu": "0.1.2",
     "@generaltranslation/format": "0.1.8",
-    "@generaltranslation/python-extractor": "0.2.44",
-    "@generaltranslation/supported-locales": "2.1.24",
-    "@generaltranslation/vue-extractor": "0.1.4",
-    "generaltranslation": "9.1.11",
+    "@generaltranslation/python-extractor": "0.2.45",
+    "@generaltranslation/supported-locales": "2.1.25",
+    "@generaltranslation/vue-extractor": "0.1.5",
+    "generaltranslation": "9.1.12",
     "gt-remark": "1.0.12"
   },
   "devDependencies": {