gt 2.14.58 → 2.14.60

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

@@ -1,6 +1,5 @@
 import { Settings } from '../../types/index.js';
 import type { FileToUpload } from '../../types/data.js';
-export declare const SUPPORTED_DATA_FORMATS: string[];
 export declare function aggregateFiles(settings: Settings): Promise<{
     files: FileToUpload[];
     publishMap: Map<string, boolean>;

package/dist/formats/files/aggregateFiles.js

@@ -26,11 +26,6 @@ function isCompanionMetadataFile(filePath, allFilePaths) {
 	const sourceFilePath = filePath.replace(/\.metadata\.(json|yaml|yml)$/, ".$1");
 	return allFilePaths.includes(sourceFilePath);
 }
-const SUPPORTED_DATA_FORMATS = [
-	"JSX",
-	"ICU",
-	"I18NEXT"
-];
 async function aggregateFiles(settings) {
 	const files = [];
 	if (!settings.files || Object.keys(settings.files.placeholderPaths).length === 1 && settings.files.placeholderPaths.gt) return {
@@ -222,6 +217,6 @@ async function aggregateFiles(settings) {
 	};
 }
 //#endregion
-export { SUPPORTED_DATA_FORMATS, aggregateFiles };
+export { aggregateFiles };
 
 //# sourceMappingURL=aggregateFiles.js.map

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 { recordWarning } from '../../state/translateWarnings.js';\nimport { getRelative, readFile } from '../../fs/findFilepath.js';\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}\nexport const SUPPORTED_DATA_FORMATS = ['JSX', 'ICU', 'I18NEXT'];\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  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson'\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 { recordWarning } from '../../state/translateWarnings.js';\nimport { getRelative, readFile } from '../../fs/findFilepath.js';\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  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson'\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/collectFiles.js

@@ -22,11 +22,8 @@ async function collectFiles(options, settings, library) {
 				const effectiveRequiresReview = metadata.requiresReview !== void 0 ? metadata.requiresReview : settings.requiresReview ? true : void 0;
 				delete metadata.requiresReview;
 				if (effectiveRequiresReview !== void 0) metadata.requires_review = effectiveRequiresReview;
-				const { hash, id } = metadata;
-				if (id) {
-					fileData[id] = source;
-					fileMetadata[id] = metadata;
-				} else if (hash) {
+				const { hash } = metadata;
+				if (hash) {
 					fileData[hash] = source;
 					fileMetadata[hash] = metadata;
 				}

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

@@ -1 +1 @@
-{"version":3,"file":"collectFiles.js","names":[],"sources":["../../../src/formats/files/collectFiles.ts"],"sourcesContent":["import { logErrorAndExit } from '../../console/logging.js';\nimport {\n  Settings,\n  SupportedLibraries,\n  TranslateFlags,\n} from '../../types/index.js';\nimport { invalidConfigurationError } from '../../console/index.js';\nimport { aggregateFiles } from './aggregateFiles.js';\nimport { aggregateInlineTranslations } from '../../translation/stage.js';\nimport type { JsxChildren } from '@generaltranslation/format/types';\nimport type { FileToUpload } from 'generaltranslation/types';\nimport { hashStringSync } from '../../utils/hash.js';\nimport { TEMPLATE_FILE_NAME, TEMPLATE_FILE_ID } from '../../utils/constants.js';\nimport { isInlineLibrary } from '../../types/libraries.js';\nimport { shouldPublishGt } from '../../utils/resolvePublish.js';\n\nexport async function collectFiles(\n  options: TranslateFlags,\n  settings: Settings,\n  library: SupportedLibraries\n): Promise<{\n  files: FileToUpload[];\n  reactComponents: number;\n  publishMap: Map<string, boolean>;\n}> {\n  // Aggregate files\n  const { files, publishMap } = await aggregateFiles(settings);\n\n  // Parse for React components\n  let reactComponents = 0;\n  if (isInlineLibrary(library)) {\n    const updates = await aggregateInlineTranslations(\n      options,\n      settings,\n      library\n    );\n    if (updates.length > 0) {\n      if (!settings.publish && !settings.files?.placeholderPaths.gt) {\n        logErrorAndExit(invalidConfigurationError);\n      }\n      // Convert updates to a file object\n      const fileData: Record<string, JsxChildren> = {};\n      const fileMetadata: Record<string, unknown> = {};\n      // Convert updates to the proper data format\n      for (const update of updates) {\n        const { source, metadata, dataFormat } = update;\n        metadata.dataFormat = dataFormat; // add the data format to the metadata\n        // Materialize effective requiresReview into component metadata:\n        // the explicit prop wins; otherwise inherit the top-level config\n        // default. Only the explicit prop is part of component hashes — the\n        // effective flag here is what the platform filters serving on.\n        // Uploaded metadata uses the platform's canonical snake_case key;\n        // camelCase requiresReview stays client-internal (props + hashing).\n        // An explicit prop (true or false) is always materialized; without\n        // one, only a true config default is — a false/absent default means\n        // the key is omitted entirely, matching pre-feature metadata.\n        const effectiveRequiresReview =\n          metadata.requiresReview !== undefined\n            ? metadata.requiresReview\n            : settings.requiresReview\n              ? true\n              : undefined;\n        delete metadata.requiresReview;\n        if (effectiveRequiresReview !== undefined) {\n          metadata.requires_review = effectiveRequiresReview;\n        }\n        const { hash, id } = metadata;\n        if (id) {\n          fileData[id] = source;\n          fileMetadata[id] = metadata;\n        } else if (hash) {\n          fileData[hash] = source;\n          fileMetadata[hash] = metadata;\n        }\n      }\n      reactComponents = updates.length;\n      // Version identity includes which components effectively require\n      // review, so config-only review changes produce a new source version.\n      // When nothing requires review this reduces to the legacy key-only\n      // hash, keeping existing projects' version IDs stable.\n      const sortedKeys = Object.keys(fileData).sort();\n      const reviewRequiredKeys = sortedKeys.filter(\n        (key) =>\n          (fileMetadata[key] as { requires_review?: boolean })\n            ?.requires_review === true\n      );\n      const versionId = reviewRequiredKeys.length\n        ? hashStringSync(\n            JSON.stringify(sortedKeys) +\n              '\\u0000requiresReview\\u0000' +\n              JSON.stringify(reviewRequiredKeys)\n          )\n        : hashStringSync(JSON.stringify(sortedKeys));\n      files.push({\n        fileName: TEMPLATE_FILE_NAME,\n        content: JSON.stringify(fileData),\n        fileFormat: 'GTJSON',\n        formatMetadata: fileMetadata,\n        fileId: TEMPLATE_FILE_ID,\n        versionId,\n        locale: settings.defaultLocale,\n      } satisfies FileToUpload);\n      // Only add GT JSON to publishMap if there's an explicit publish config\n      const gtPublishValue = shouldPublishGt(settings);\n      if (gtPublishValue !== undefined) {\n        publishMap.set(TEMPLATE_FILE_ID, gtPublishValue);\n      }\n    }\n  }\n  return { files, reactComponents, publishMap };\n}\n"],"mappings":";;;;;;;;;AAgBA,eAAsB,aACpB,SACA,UACA,SAKC;CAED,MAAM,EAAE,OAAO,eAAe,MAAM,eAAe,SAAS;CAG5D,IAAI,kBAAkB;AACtB,KAAI,gBAAgB,QAAQ,EAAE;EAC5B,MAAM,UAAU,MAAM,4BACpB,SACA,UACA,QACD;AACD,MAAI,QAAQ,SAAS,GAAG;AACtB,OAAI,CAAC,SAAS,WAAW,CAAC,SAAS,OAAO,iBAAiB,GACzD,iBAAgB,0BAA0B;GAG5C,MAAM,WAAwC,EAAE;GAChD,MAAM,eAAwC,EAAE;AAEhD,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,EAAE,QAAQ,UAAU,eAAe;AACzC,aAAS,aAAa;IAUtB,MAAM,0BACJ,SAAS,mBAAmB,KAAA,IACxB,SAAS,iBACT,SAAS,iBACP,OACA,KAAA;AACR,WAAO,SAAS;AAChB,QAAI,4BAA4B,KAAA,EAC9B,UAAS,kBAAkB;IAE7B,MAAM,EAAE,MAAM,OAAO;AACrB,QAAI,IAAI;AACN,cAAS,MAAM;AACf,kBAAa,MAAM;eACV,MAAM;AACf,cAAS,QAAQ;AACjB,kBAAa,QAAQ;;;AAGzB,qBAAkB,QAAQ;GAK1B,MAAM,aAAa,OAAO,KAAK,SAAS,CAAC,MAAM;GAC/C,MAAM,qBAAqB,WAAW,QACnC,QACE,aAAa,MACV,oBAAoB,KAC3B;GACD,MAAM,YAAY,mBAAmB,SACjC,eACE,KAAK,UAAU,WAAW,GACxB,uBACA,KAAK,UAAU,mBAAmB,CACrC,GACD,eAAe,KAAK,UAAU,WAAW,CAAC;AAC9C,SAAM,KAAK;IACT,UAAU;IACV,SAAS,KAAK,UAAU,SAAS;IACjC,YAAY;IACZ,gBAAgB;IAChB,QAAQ;IACR;IACA,QAAQ,SAAS;IAClB,CAAwB;GAEzB,MAAM,iBAAiB,gBAAgB,SAAS;AAChD,OAAI,mBAAmB,KAAA,EACrB,YAAW,IAAI,kBAAkB,eAAe;;;AAItD,QAAO;EAAE;EAAO;EAAiB;EAAY"}
+{"version":3,"file":"collectFiles.js","names":[],"sources":["../../../src/formats/files/collectFiles.ts"],"sourcesContent":["import { logErrorAndExit } from '../../console/logging.js';\nimport {\n  Settings,\n  SupportedLibraries,\n  TranslateFlags,\n} from '../../types/index.js';\nimport { invalidConfigurationError } from '../../console/index.js';\nimport { aggregateFiles } from './aggregateFiles.js';\nimport { aggregateInlineTranslations } from '../../translation/stage.js';\nimport type { JsxChildren } from '@generaltranslation/format/types';\nimport type { FileToUpload } from 'generaltranslation/types';\nimport { hashStringSync } from '../../utils/hash.js';\nimport { TEMPLATE_FILE_NAME, TEMPLATE_FILE_ID } from '../../utils/constants.js';\nimport { isInlineLibrary } from '../../types/libraries.js';\nimport { shouldPublishGt } from '../../utils/resolvePublish.js';\n\nexport async function collectFiles(\n  options: TranslateFlags,\n  settings: Settings,\n  library: SupportedLibraries\n): Promise<{\n  files: FileToUpload[];\n  reactComponents: number;\n  publishMap: Map<string, boolean>;\n}> {\n  // Aggregate files\n  const { files, publishMap } = await aggregateFiles(settings);\n\n  // Parse for React components\n  let reactComponents = 0;\n  if (isInlineLibrary(library)) {\n    const updates = await aggregateInlineTranslations(\n      options,\n      settings,\n      library\n    );\n    if (updates.length > 0) {\n      if (!settings.publish && !settings.files?.placeholderPaths.gt) {\n        logErrorAndExit(invalidConfigurationError);\n      }\n      // Convert updates to a file object\n      const fileData: Record<string, JsxChildren> = {};\n      const fileMetadata: Record<string, unknown> = {};\n      // Convert updates to the proper data format\n      for (const update of updates) {\n        const { source, metadata, dataFormat } = update;\n        metadata.dataFormat = dataFormat; // add the data format to the metadata\n        // Materialize effective requiresReview into component metadata:\n        // the explicit prop wins; otherwise inherit the top-level config\n        // default. Only the explicit prop is part of component hashes — the\n        // effective flag here is what the platform filters serving on.\n        // Uploaded metadata uses the platform's canonical snake_case key;\n        // camelCase requiresReview stays client-internal (props + hashing).\n        // An explicit prop (true or false) is always materialized; without\n        // one, only a true config default is — a false/absent default means\n        // the key is omitted entirely, matching pre-feature metadata.\n        const effectiveRequiresReview =\n          metadata.requiresReview !== undefined\n            ? metadata.requiresReview\n            : settings.requiresReview\n              ? true\n              : undefined;\n        delete metadata.requiresReview;\n        if (effectiveRequiresReview !== undefined) {\n          metadata.requires_review = effectiveRequiresReview;\n        }\n        const { hash } = metadata;\n        if (hash) {\n          fileData[hash] = source;\n          fileMetadata[hash] = metadata;\n        }\n      }\n      reactComponents = updates.length;\n      // Version identity includes which components effectively require\n      // review, so config-only review changes produce a new source version.\n      // When nothing requires review this reduces to the legacy key-only\n      // hash, keeping existing projects' version IDs stable.\n      const sortedKeys = Object.keys(fileData).sort();\n      const reviewRequiredKeys = sortedKeys.filter(\n        (key) =>\n          (fileMetadata[key] as { requires_review?: boolean })\n            ?.requires_review === true\n      );\n      const versionId = reviewRequiredKeys.length\n        ? hashStringSync(\n            JSON.stringify(sortedKeys) +\n              '\\u0000requiresReview\\u0000' +\n              JSON.stringify(reviewRequiredKeys)\n          )\n        : hashStringSync(JSON.stringify(sortedKeys));\n      files.push({\n        fileName: TEMPLATE_FILE_NAME,\n        content: JSON.stringify(fileData),\n        fileFormat: 'GTJSON',\n        formatMetadata: fileMetadata,\n        fileId: TEMPLATE_FILE_ID,\n        versionId,\n        locale: settings.defaultLocale,\n      } satisfies FileToUpload);\n      // Only add GT JSON to publishMap if there's an explicit publish config\n      const gtPublishValue = shouldPublishGt(settings);\n      if (gtPublishValue !== undefined) {\n        publishMap.set(TEMPLATE_FILE_ID, gtPublishValue);\n      }\n    }\n  }\n  return { files, reactComponents, publishMap };\n}\n"],"mappings":";;;;;;;;;AAgBA,eAAsB,aACpB,SACA,UACA,SAKC;CAED,MAAM,EAAE,OAAO,eAAe,MAAM,eAAe,SAAS;CAG5D,IAAI,kBAAkB;AACtB,KAAI,gBAAgB,QAAQ,EAAE;EAC5B,MAAM,UAAU,MAAM,4BACpB,SACA,UACA,QACD;AACD,MAAI,QAAQ,SAAS,GAAG;AACtB,OAAI,CAAC,SAAS,WAAW,CAAC,SAAS,OAAO,iBAAiB,GACzD,iBAAgB,0BAA0B;GAG5C,MAAM,WAAwC,EAAE;GAChD,MAAM,eAAwC,EAAE;AAEhD,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,EAAE,QAAQ,UAAU,eAAe;AACzC,aAAS,aAAa;IAUtB,MAAM,0BACJ,SAAS,mBAAmB,KAAA,IACxB,SAAS,iBACT,SAAS,iBACP,OACA,KAAA;AACR,WAAO,SAAS;AAChB,QAAI,4BAA4B,KAAA,EAC9B,UAAS,kBAAkB;IAE7B,MAAM,EAAE,SAAS;AACjB,QAAI,MAAM;AACR,cAAS,QAAQ;AACjB,kBAAa,QAAQ;;;AAGzB,qBAAkB,QAAQ;GAK1B,MAAM,aAAa,OAAO,KAAK,SAAS,CAAC,MAAM;GAC/C,MAAM,qBAAqB,WAAW,QACnC,QACE,aAAa,MACV,oBAAoB,KAC3B;GACD,MAAM,YAAY,mBAAmB,SACjC,eACE,KAAK,UAAU,WAAW,GACxB,uBACA,KAAK,UAAU,mBAAmB,CACrC,GACD,eAAe,KAAK,UAAU,WAAW,CAAC;AAC9C,SAAM,KAAK;IACT,UAAU;IACV,SAAS,KAAK,UAAU,SAAS;IACjC,YAAY;IACZ,gBAAgB;IAChB,QAAQ;IACR;IACA,QAAQ,SAAS;IAClB,CAAwB;GAEzB,MAAM,iBAAiB,gBAAgB,SAAS;AAChD,OAAI,mBAAmB,KAAA,EACrB,YAAW,IAAI,kBAAkB,eAAe;;;AAItD,QAAO;EAAE;EAAO;EAAiB;EAAY"}

package/dist/fs/config/parseFilesConfig.js

@@ -89,10 +89,6 @@ function resolveFiles(files, locale, locales, cwd, compositePatterns, requiresRe
 		parsingFlags,
 		gtJson: (() => {
 			const rawGtFlags = files.gt?.parsingFlags || {};
-			if ("autoDerive" in rawGtFlags && !("autoderive" in rawGtFlags)) {
-				rawGtFlags.autoderive = rawGtFlags.autoDerive;
-				delete rawGtFlags.autoDerive;
-			}
 			return {
 				publish: files.gt?.publish,
 				parsingFlags: {

package/dist/fs/config/parseFilesConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseFilesConfig.js","names":[],"sources":["../../../src/fs/config/parseFilesConfig.ts"],"sourcesContent":["import path from 'node:path';\nimport {\n  FilesOptions,\n  IncludePattern,\n  RequiresReviewConfig,\n  ResolvedFiles,\n  Settings,\n  TransformFormats,\n  TransformFiles,\n  TransformOption,\n} from '../../types/index.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport fg from 'fast-glob';\nimport { SUPPORTED_FILE_EXTENSIONS } from '../../formats/files/supportedFiles.js';\nimport { logger } from '../../console/logger.js';\nimport chalk from 'chalk';\nimport micromatch from 'micromatch';\nimport { ParseFlagsByFileType } from '../../types/parsing.js';\nimport {\n  BASE_PARSING_FLAGS_DEFAULT,\n  GT_PARSING_FLAGS_DEFAULT,\n} from '../../config/defaults.js';\nimport { resolveTransformationFormat } from '../../formats/files/transformFormat.js';\n\n/**\n * Resolves the files from the files object\n * Replaces [locale] with the actual locale in the files\n *\n * @param files - The files object\n * @param locale - The locale to replace [locale] with\n * @returns The resolved files\n */\nexport function resolveLocaleFiles(\n  files: ResolvedFiles,\n  locale: string\n): ResolvedFiles {\n  const result: ResolvedFiles = {};\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    result[fileType] = files[fileType]?.map((filepath) =>\n      filepath.replace(/\\[locale\\]/g, locale)\n    );\n  }\n\n  // Replace [locale] with locale in all paths\n  result.gt = files.gt?.replace(/\\[locale\\]/g, locale);\n\n  return result;\n}\n/**\n * Normalizes include patterns into plain path strings and tracks which\n * patterns have explicit publish flags.\n */\nexport function normalizeIncludePatterns(patterns: IncludePattern[]): {\n  paths: string[];\n  publishPatterns: string[];\n  unpublishPatterns: string[];\n} {\n  const paths: string[] = [];\n  const publishPatterns: string[] = [];\n  const unpublishPatterns: string[] = [];\n\n  for (const pattern of patterns) {\n    if (typeof pattern === 'string') {\n      paths.push(pattern);\n    } else {\n      paths.push(pattern.pattern);\n      if (pattern.publish === true) {\n        publishPatterns.push(pattern.pattern);\n      } else if (pattern.publish === false) {\n        unpublishPatterns.push(pattern.pattern);\n      }\n    }\n  }\n\n  return { paths, publishPatterns, unpublishPatterns };\n}\n\n/**\n * Resolves the files from the files object.\n * Performs glob pattern expansion on the files.\n * Replaces [locale] with the actual locale in the files.\n *\n * @param files - The files object\n * @returns The resolved files\n */\nexport function resolveFiles(\n  files: FilesOptions,\n  locale: string,\n  locales: string[],\n  cwd: string,\n  compositePatterns?: string[],\n  requiresReviewDefault: boolean = false\n): Settings['files'] {\n  // Initialize result object with empty arrays for each file type\n  const resolvedPaths: ResolvedFiles = {};\n  const placeholderResult: ResolvedFiles = {};\n  const transformPaths: TransformFiles = {};\n  // Output format transforms are tracked separately from path transforms.\n  const transformFormats: TransformFormats = {};\n  const publishPaths = new Set<string>();\n  const unpublishPaths = new Set<string>();\n  const requiresReviewPaths = new Set<string>();\n  const parsingFlags: ParseFlagsByFileType = {};\n\n  // Process GT files\n  if (files.gt?.output) {\n    placeholderResult.gt = path.resolve(cwd, files.gt.output);\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    // ==== TRANSFORMS ==== //\n    const transform = files[fileType]?.transform;\n    if (\n      transform &&\n      (typeof transform === 'string' ||\n        typeof transform === 'object' ||\n        Array.isArray(transform))\n    ) {\n      transformPaths[fileType] = transform;\n    }\n    // Validate source -> output format transforms during settings generation.\n    const transformFormat = resolveTransformationFormat(\n      fileType,\n      files[fileType]?.transformationFormat\n    );\n    if (transformFormat) {\n      transformFormats[fileType] = transformFormat;\n    }\n    // ==== PLACEHOLDERS ==== //\n    if (files[fileType]?.include) {\n      const { paths, publishPatterns, unpublishPatterns } =\n        normalizeIncludePatterns(files[fileType].include);\n\n      const filePaths = expandGlobPatterns(\n        cwd,\n        paths,\n        files[fileType]?.exclude || [],\n        locale,\n        locales,\n        transformPaths[fileType] || undefined,\n        compositePatterns\n      );\n      resolvedPaths[fileType] = filePaths.resolvedPaths;\n      placeholderResult[fileType] = filePaths.placeholderPaths;\n\n      // Classify resolved paths into publish/unpublish sets\n      classifyPublishPaths(\n        filePaths.resolvedPaths,\n        publishPatterns,\n        unpublishPatterns,\n        cwd,\n        locale,\n        publishPaths,\n        unpublishPaths\n      );\n\n      // Classify resolved paths by effective requiresReview policy\n      classifyRequiresReviewPaths(\n        filePaths.resolvedPaths,\n        validateRequiresReviewConfig(files[fileType]?.requiresReview, fileType),\n        requiresReviewDefault,\n        cwd,\n        locale,\n        requiresReviewPaths\n      );\n    }\n    // ==== OTHER ==== //\n    if (files[fileType]?.parsingFlags) {\n      parsingFlags[fileType] = {\n        ...BASE_PARSING_FLAGS_DEFAULT,\n        ...files[fileType].parsingFlags,\n      };\n    }\n  }\n\n  return {\n    resolvedPaths,\n    placeholderPaths: placeholderResult,\n    transformPaths: transformPaths,\n    transformFormats,\n    publishPaths,\n    unpublishPaths,\n    requiresReviewPaths,\n    parsingFlags,\n    gtJson: (() => {\n      const rawGtFlags = (files.gt?.parsingFlags || {}) as Record<\n        string,\n        unknown\n      >;\n      if ('autoDerive' in rawGtFlags && !('autoderive' in rawGtFlags)) {\n        rawGtFlags.autoderive = rawGtFlags.autoDerive;\n        delete rawGtFlags.autoDerive;\n      }\n      return {\n        publish: files.gt?.publish,\n        parsingFlags: {\n          ...GT_PARSING_FLAGS_DEFAULT,\n          ...rawGtFlags,\n        },\n      };\n    })(),\n  };\n}\n\n// Helper function to expand glob patterns\nexport function expandGlobPatterns(\n  cwd: string,\n  includePatterns: string[],\n  excludePatterns: string[],\n  locale: string,\n  locales: string[],\n  transformPatterns?: TransformOption | string | TransformOption[],\n  compositePatterns?: string[]\n): {\n  resolvedPaths: string[];\n  placeholderPaths: string[];\n} {\n  // Expand glob patterns to include all matching files\n  const resolvedPaths: string[] = [];\n  const placeholderPaths: string[] = [];\n\n  // Process include patterns\n  for (const pattern of includePatterns) {\n    // Track positions where [locale] appears in the original pattern\n    // It must be included in the pattern, otherwise the CLI tool will not be able to find the correct output path\n    // Warn if it's not included\n    // Ignore if is composite pattern\n    if (\n      !pattern.includes('[locale]') &&\n      !transformPatterns &&\n      !compositePatterns?.includes(pattern)\n    ) {\n      logger.warn(\n        chalk.yellow(\n          `Pattern \"${pattern}\" does not include [locale], so the CLI tool may incorrectly save translated files.`\n        )\n      );\n    }\n    const localePositions: number[] = [];\n    let searchIndex = 0;\n    const localeTag = '[locale]';\n\n    while (true) {\n      const foundIndex = pattern.indexOf(localeTag, searchIndex);\n      if (foundIndex === -1) break;\n      localePositions.push(foundIndex);\n      searchIndex = foundIndex + localeTag.length;\n    }\n\n    const expandedPattern = pattern.replace(/\\[locale\\]/g, locale);\n\n    // Resolve the absolute pattern path\n    const absolutePattern = path.resolve(cwd, expandedPattern);\n\n    // Prepare exclude patterns with locale replaced\n    const expandedExcludePatterns = Array.from(\n      new Set(\n        excludePatterns.flatMap((p) =>\n          locales.map((targetLocale) =>\n            path.resolve(\n              cwd,\n              p\n                .replace(/\\[locale\\]/g, locale)\n                .replace(/\\[locales\\]/g, targetLocale)\n            )\n          )\n        )\n      )\n    );\n\n    // Use fast-glob to find all matching files, excluding the patterns\n    const matches = fg.sync(absolutePattern, {\n      absolute: true,\n      ignore: expandedExcludePatterns,\n    });\n\n    resolvedPaths.push(...matches);\n\n    // For each match, create a version with [locale] in the correct positions\n    matches.forEach((match) => {\n      const absolutePath = path.resolve(cwd, match);\n      const patternPath = path.resolve(cwd, pattern);\n      let originalAbsolutePath = absolutePath;\n\n      if (localePositions.length > 0) {\n        const placeholderPath = buildPlaceholderPathFromPattern(\n          patternPath,\n          absolutePath,\n          localeTag\n        );\n        originalAbsolutePath = placeholderPath;\n      }\n\n      placeholderPaths.push(originalAbsolutePath);\n    });\n  }\n\n  return { resolvedPaths, placeholderPaths };\n}\n\nfunction buildPlaceholderPathFromPattern(\n  patternPath: string,\n  absolutePath: string,\n  localeTag: string\n): string {\n  if (!patternPath.includes(localeTag)) {\n    return absolutePath;\n  }\n\n  const posixPattern = toPosixPath(patternPath);\n  const posixPath = toPosixPath(absolutePath);\n\n  const baseRegex = micromatch.makeRe(posixPattern, {\n    literalBrackets: true,\n  });\n  const localeRegexSource = baseRegex.source.replace(\n    /\\\\\\[locale\\\\\\]/g,\n    '([^/]+)'\n  );\n  const flags = baseRegex.flags.includes('d')\n    ? baseRegex.flags\n    : `${baseRegex.flags}d`;\n  const matcher = new RegExp(localeRegexSource, flags);\n  const match = matcher.exec(posixPath);\n\n  const matchWithIndices = match as RegExpExecArray & {\n    indices?: Array<[number, number]>;\n  };\n\n  if (!match || !matchWithIndices.indices) {\n    return absolutePath;\n  }\n\n  let placeholderPosixPath = posixPath;\n  const indices = matchWithIndices.indices;\n\n  for (let i = indices.length - 1; i >= 1; i--) {\n    const [start, end] = indices[i];\n    if (start === -1 || end === -1) continue;\n    placeholderPosixPath =\n      placeholderPosixPath.slice(0, start) +\n      localeTag +\n      placeholderPosixPath.slice(end);\n  }\n\n  return path.normalize(placeholderPosixPath);\n}\n\nfunction toPosixPath(value: string): string {\n  return value.split(path.sep).join(path.posix.sep);\n}\n\n/**\n * Classifies resolved file paths into publish/unpublish sets by matching\n * them against the given glob patterns. Uses POSIX paths for micromatch\n * compatibility but stores platform-native paths in the output sets.\n */\nfunction classifyPublishPaths(\n  resolvedPaths: string[],\n  publishPatterns: string[],\n  unpublishPatterns: string[],\n  cwd: string,\n  locale: string,\n  publishPaths: Set<string>,\n  unpublishPaths: Set<string>\n): void {\n  if (publishPatterns.length === 0 && unpublishPatterns.length === 0) return;\n\n  const posixPaths = resolvedPaths.map(toPosixPath);\n  const toAbsoluteGlob = (p: string) =>\n    toPosixPath(path.resolve(cwd, p.replace(/\\[locale\\]/g, locale)));\n\n  for (const pattern of publishPatterns) {\n    const matched = new Set(micromatch(posixPaths, toAbsoluteGlob(pattern)));\n    for (let i = 0; i < posixPaths.length; i++) {\n      if (matched.has(posixPaths[i])) {\n        publishPaths.add(resolvedPaths[i]);\n      }\n    }\n  }\n\n  for (const pattern of unpublishPatterns) {\n    const matched = new Set(micromatch(posixPaths, toAbsoluteGlob(pattern)));\n    for (let i = 0; i < posixPaths.length; i++) {\n      if (matched.has(posixPaths[i])) {\n        unpublishPaths.add(resolvedPaths[i]);\n      }\n    }\n  }\n}\n\n/**\n * Validates a file-type requiresReview config value. Only a boolean or an\n * object of include/exclude glob string arrays is accepted — notably not\n * string \"true\"/\"false\", so a misquoted boolean fails loudly instead of\n * silently changing review policy (and with it, version identity).\n */\nfunction validateRequiresReviewConfig(\n  config: unknown,\n  fileType: string\n): RequiresReviewConfig | undefined {\n  if (config === undefined || typeof config === 'boolean') {\n    return config;\n  }\n  const isStringArray = (value: unknown): value is string[] =>\n    Array.isArray(value) && value.every((item) => typeof item === 'string');\n  if (\n    config !== null &&\n    typeof config === 'object' &&\n    !Array.isArray(config) &&\n    Object.keys(config).every((key) => key === 'include' || key === 'exclude')\n  ) {\n    const { include, exclude } = config as Record<string, unknown>;\n    if (\n      (include === undefined || isStringArray(include)) &&\n      (exclude === undefined || isStringArray(exclude))\n    ) {\n      return config as RequiresReviewConfig;\n    }\n  }\n  return logErrorAndExit(\n    `files.${fileType}.requiresReview must be a boolean or an object of glob string arrays: { include?: string[], exclude?: string[] }`\n  );\n}\n\n/**\n * Classifies resolved file paths by effective requiresReview policy and adds\n * paths whose policy is true to requiresReviewPaths. Precedence: file-type\n * include/exclude globs (exclude wins) > file-type boolean > top-level default.\n */\nfunction classifyRequiresReviewPaths(\n  resolvedPaths: string[],\n  config: RequiresReviewConfig | undefined,\n  requiresReviewDefault: boolean,\n  cwd: string,\n  locale: string,\n  requiresReviewPaths: Set<string>\n): void {\n  if (typeof config === 'boolean' || config === undefined) {\n    if (config ?? requiresReviewDefault) {\n      for (const resolvedPath of resolvedPaths) {\n        requiresReviewPaths.add(resolvedPath);\n      }\n    }\n    return;\n  }\n\n  const posixPaths = resolvedPaths.map(toPosixPath);\n  const toAbsoluteGlob = (p: string) =>\n    toPosixPath(path.resolve(cwd, p.replace(/\\[locale\\]/g, locale)));\n  const matchAny = (patterns: string[]) => {\n    const matched = new Set<string>();\n    for (const pattern of patterns) {\n      for (const match of micromatch(posixPaths, toAbsoluteGlob(pattern))) {\n        matched.add(match);\n      }\n    }\n    return matched;\n  };\n\n  const included = matchAny(config.include ?? []);\n  const excluded = matchAny(config.exclude ?? []);\n\n  for (let i = 0; i < posixPaths.length; i++) {\n    const requiresReview = excluded.has(posixPaths[i])\n      ? false\n      : included.has(posixPaths[i]) || requiresReviewDefault;\n    if (requiresReview) {\n      requiresReviewPaths.add(resolvedPaths[i]);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgCA,SAAgB,mBACd,OACA,QACe;CACf,MAAM,SAAwB,EAAE;AAEhC,MAAK,MAAM,YAAY,0BACrB,QAAO,YAAY,MAAM,WAAW,KAAK,aACvC,SAAS,QAAQ,eAAe,OAAO,CACxC;AAIH,QAAO,KAAK,MAAM,IAAI,QAAQ,eAAe,OAAO;AAEpD,QAAO;;;;;;AAMT,SAAgB,yBAAyB,UAIvC;CACA,MAAM,QAAkB,EAAE;CAC1B,MAAM,kBAA4B,EAAE;CACpC,MAAM,oBAA8B,EAAE;AAEtC,MAAK,MAAM,WAAW,SACpB,KAAI,OAAO,YAAY,SACrB,OAAM,KAAK,QAAQ;MACd;AACL,QAAM,KAAK,QAAQ,QAAQ;AAC3B,MAAI,QAAQ,YAAY,KACtB,iBAAgB,KAAK,QAAQ,QAAQ;WAC5B,QAAQ,YAAY,MAC7B,mBAAkB,KAAK,QAAQ,QAAQ;;AAK7C,QAAO;EAAE;EAAO;EAAiB;EAAmB;;;;;;;;;;AAWtD,SAAgB,aACd,OACA,QACA,SACA,KACA,mBACA,wBAAiC,OACd;CAEnB,MAAM,gBAA+B,EAAE;CACvC,MAAM,oBAAmC,EAAE;CAC3C,MAAM,iBAAiC,EAAE;CAEzC,MAAM,mBAAqC,EAAE;CAC7C,MAAM,+BAAe,IAAI,KAAa;CACtC,MAAM,iCAAiB,IAAI,KAAa;CACxC,MAAM,sCAAsB,IAAI,KAAa;CAC7C,MAAM,eAAqC,EAAE;AAG7C,KAAI,MAAM,IAAI,OACZ,mBAAkB,KAAK,KAAK,QAAQ,KAAK,MAAM,GAAG,OAAO;AAG3D,MAAK,MAAM,YAAY,2BAA2B;EAEhD,MAAM,YAAY,MAAM,WAAW;AACnC,MACE,cACC,OAAO,cAAc,YACpB,OAAO,cAAc,YACrB,MAAM,QAAQ,UAAU,EAE1B,gBAAe,YAAY;EAG7B,MAAM,kBAAkB,4BACtB,UACA,MAAM,WAAW,qBAClB;AACD,MAAI,gBACF,kBAAiB,YAAY;AAG/B,MAAI,MAAM,WAAW,SAAS;GAC5B,MAAM,EAAE,OAAO,iBAAiB,sBAC9B,yBAAyB,MAAM,UAAU,QAAQ;GAEnD,MAAM,YAAY,mBAChB,KACA,OACA,MAAM,WAAW,WAAW,EAAE,EAC9B,QACA,SACA,eAAe,aAAa,KAAA,GAC5B,kBACD;AACD,iBAAc,YAAY,UAAU;AACpC,qBAAkB,YAAY,UAAU;AAGxC,wBACE,UAAU,eACV,iBACA,mBACA,KACA,QACA,cACA,eACD;AAGD,+BACE,UAAU,eACV,6BAA6B,MAAM,WAAW,gBAAgB,SAAS,EACvE,uBACA,KACA,QACA,oBACD;;AAGH,MAAI,MAAM,WAAW,aACnB,cAAa,YAAY;GACvB,GAAG;GACH,GAAG,MAAM,UAAU;GACpB;;AAIL,QAAO;EACL;EACA,kBAAkB;EACF;EAChB;EACA;EACA;EACA;EACA;EACA,eAAe;GACb,MAAM,aAAc,MAAM,IAAI,gBAAgB,EAAE;AAIhD,OAAI,gBAAgB,cAAc,EAAE,gBAAgB,aAAa;AAC/D,eAAW,aAAa,WAAW;AACnC,WAAO,WAAW;;AAEpB,UAAO;IACL,SAAS,MAAM,IAAI;IACnB,cAAc;KACZ,GAAG;KACH,GAAG;KACJ;IACF;MACC;EACL;;AAIH,SAAgB,mBACd,KACA,iBACA,iBACA,QACA,SACA,mBACA,mBAIA;CAEA,MAAM,gBAA0B,EAAE;CAClC,MAAM,mBAA6B,EAAE;AAGrC,MAAK,MAAM,WAAW,iBAAiB;AAKrC,MACE,CAAC,QAAQ,SAAS,WAAW,IAC7B,CAAC,qBACD,CAAC,mBAAmB,SAAS,QAAQ,CAErC,QAAO,KACL,MAAM,OACJ,YAAY,QAAQ,qFACrB,CACF;EAEH,MAAM,kBAA4B,EAAE;EACpC,IAAI,cAAc;EAClB,MAAM,YAAY;AAElB,SAAO,MAAM;GACX,MAAM,aAAa,QAAQ,QAAQ,WAAW,YAAY;AAC1D,OAAI,eAAe,GAAI;AACvB,mBAAgB,KAAK,WAAW;AAChC,iBAAc,aAAa;;EAG7B,MAAM,kBAAkB,QAAQ,QAAQ,eAAe,OAAO;EAG9D,MAAM,kBAAkB,KAAK,QAAQ,KAAK,gBAAgB;EAG1D,MAAM,0BAA0B,MAAM,KACpC,IAAI,IACF,gBAAgB,SAAS,MACvB,QAAQ,KAAK,iBACX,KAAK,QACH,KACA,EACG,QAAQ,eAAe,OAAO,CAC9B,QAAQ,gBAAgB,aAAa,CACzC,CACF,CACF,CACF,CACF;EAGD,MAAM,UAAU,GAAG,KAAK,iBAAiB;GACvC,UAAU;GACV,QAAQ;GACT,CAAC;AAEF,gBAAc,KAAK,GAAG,QAAQ;AAG9B,UAAQ,SAAS,UAAU;GACzB,MAAM,eAAe,KAAK,QAAQ,KAAK,MAAM;GAC7C,MAAM,cAAc,KAAK,QAAQ,KAAK,QAAQ;GAC9C,IAAI,uBAAuB;AAE3B,OAAI,gBAAgB,SAAS,EAM3B,wBALwB,gCACtB,aACA,cACA,UAEoC;AAGxC,oBAAiB,KAAK,qBAAqB;IAC3C;;AAGJ,QAAO;EAAE;EAAe;EAAkB;;AAG5C,SAAS,gCACP,aACA,cACA,WACQ;AACR,KAAI,CAAC,YAAY,SAAS,UAAU,CAClC,QAAO;CAGT,MAAM,eAAe,YAAY,YAAY;CAC7C,MAAM,YAAY,YAAY,aAAa;CAE3C,MAAM,YAAY,WAAW,OAAO,cAAc,EAChD,iBAAiB,MAClB,CAAC;CACF,MAAM,oBAAoB,UAAU,OAAO,QACzC,mBACA,UACD;CACD,MAAM,QAAQ,UAAU,MAAM,SAAS,IAAI,GACvC,UAAU,QACV,GAAG,UAAU,MAAM;CAEvB,MAAM,QAAQ,IADM,OAAO,mBAAmB,MACzB,CAAC,KAAK,UAAU;CAErC,MAAM,mBAAmB;AAIzB,KAAI,CAAC,SAAS,CAAC,iBAAiB,QAC9B,QAAO;CAGT,IAAI,uBAAuB;CAC3B,MAAM,UAAU,iBAAiB;AAEjC,MAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;EAC5C,MAAM,CAAC,OAAO,OAAO,QAAQ;AAC7B,MAAI,UAAU,MAAM,QAAQ,GAAI;AAChC,yBACE,qBAAqB,MAAM,GAAG,MAAM,GACpC,YACA,qBAAqB,MAAM,IAAI;;AAGnC,QAAO,KAAK,UAAU,qBAAqB;;AAG7C,SAAS,YAAY,OAAuB;AAC1C,QAAO,MAAM,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI;;;;;;;AAQnD,SAAS,qBACP,eACA,iBACA,mBACA,KACA,QACA,cACA,gBACM;AACN,KAAI,gBAAgB,WAAW,KAAK,kBAAkB,WAAW,EAAG;CAEpE,MAAM,aAAa,cAAc,IAAI,YAAY;CACjD,MAAM,kBAAkB,MACtB,YAAY,KAAK,QAAQ,KAAK,EAAE,QAAQ,eAAe,OAAO,CAAC,CAAC;AAElE,MAAK,MAAM,WAAW,iBAAiB;EACrC,MAAM,UAAU,IAAI,IAAI,WAAW,YAAY,eAAe,QAAQ,CAAC,CAAC;AACxE,OAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,QAAQ,IAAI,WAAW,GAAG,CAC5B,cAAa,IAAI,cAAc,GAAG;;AAKxC,MAAK,MAAM,WAAW,mBAAmB;EACvC,MAAM,UAAU,IAAI,IAAI,WAAW,YAAY,eAAe,QAAQ,CAAC,CAAC;AACxE,OAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,QAAQ,IAAI,WAAW,GAAG,CAC5B,gBAAe,IAAI,cAAc,GAAG;;;;;;;;;AAY5C,SAAS,6BACP,QACA,UACkC;AAClC,KAAI,WAAW,KAAA,KAAa,OAAO,WAAW,UAC5C,QAAO;CAET,MAAM,iBAAiB,UACrB,MAAM,QAAQ,MAAM,IAAI,MAAM,OAAO,SAAS,OAAO,SAAS,SAAS;AACzE,KACE,WAAW,QACX,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,OAAO,IACtB,OAAO,KAAK,OAAO,CAAC,OAAO,QAAQ,QAAQ,aAAa,QAAQ,UAAU,EAC1E;EACA,MAAM,EAAE,SAAS,YAAY;AAC7B,OACG,YAAY,KAAA,KAAa,cAAc,QAAQ,MAC/C,YAAY,KAAA,KAAa,cAAc,QAAQ,EAEhD,QAAO;;AAGX,QAAO,gBACL,SAAS,SAAS,kHACnB;;;;;;;AAQH,SAAS,4BACP,eACA,QACA,uBACA,KACA,QACA,qBACM;AACN,KAAI,OAAO,WAAW,aAAa,WAAW,KAAA,GAAW;AACvD,MAAI,UAAU,sBACZ,MAAK,MAAM,gBAAgB,cACzB,qBAAoB,IAAI,aAAa;AAGzC;;CAGF,MAAM,aAAa,cAAc,IAAI,YAAY;CACjD,MAAM,kBAAkB,MACtB,YAAY,KAAK,QAAQ,KAAK,EAAE,QAAQ,eAAe,OAAO,CAAC,CAAC;CAClE,MAAM,YAAY,aAAuB;EACvC,MAAM,0BAAU,IAAI,KAAa;AACjC,OAAK,MAAM,WAAW,SACpB,MAAK,MAAM,SAAS,WAAW,YAAY,eAAe,QAAQ,CAAC,CACjE,SAAQ,IAAI,MAAM;AAGtB,SAAO;;CAGT,MAAM,WAAW,SAAS,OAAO,WAAW,EAAE,CAAC;CAC/C,MAAM,WAAW,SAAS,OAAO,WAAW,EAAE,CAAC;AAE/C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IAIrC,KAHuB,SAAS,IAAI,WAAW,GAAG,GAC9C,QACA,SAAS,IAAI,WAAW,GAAG,IAAI,sBAEjC,qBAAoB,IAAI,cAAc,GAAG"}
+{"version":3,"file":"parseFilesConfig.js","names":[],"sources":["../../../src/fs/config/parseFilesConfig.ts"],"sourcesContent":["import path from 'node:path';\nimport {\n  FilesOptions,\n  IncludePattern,\n  RequiresReviewConfig,\n  ResolvedFiles,\n  Settings,\n  TransformFormats,\n  TransformFiles,\n  TransformOption,\n} from '../../types/index.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport fg from 'fast-glob';\nimport { SUPPORTED_FILE_EXTENSIONS } from '../../formats/files/supportedFiles.js';\nimport { logger } from '../../console/logger.js';\nimport chalk from 'chalk';\nimport micromatch from 'micromatch';\nimport { ParseFlagsByFileType } from '../../types/parsing.js';\nimport {\n  BASE_PARSING_FLAGS_DEFAULT,\n  GT_PARSING_FLAGS_DEFAULT,\n} from '../../config/defaults.js';\nimport { resolveTransformationFormat } from '../../formats/files/transformFormat.js';\n\n/**\n * Resolves the files from the files object\n * Replaces [locale] with the actual locale in the files\n *\n * @param files - The files object\n * @param locale - The locale to replace [locale] with\n * @returns The resolved files\n */\nexport function resolveLocaleFiles(\n  files: ResolvedFiles,\n  locale: string\n): ResolvedFiles {\n  const result: ResolvedFiles = {};\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    result[fileType] = files[fileType]?.map((filepath) =>\n      filepath.replace(/\\[locale\\]/g, locale)\n    );\n  }\n\n  // Replace [locale] with locale in all paths\n  result.gt = files.gt?.replace(/\\[locale\\]/g, locale);\n\n  return result;\n}\n/**\n * Normalizes include patterns into plain path strings and tracks which\n * patterns have explicit publish flags.\n */\nexport function normalizeIncludePatterns(patterns: IncludePattern[]): {\n  paths: string[];\n  publishPatterns: string[];\n  unpublishPatterns: string[];\n} {\n  const paths: string[] = [];\n  const publishPatterns: string[] = [];\n  const unpublishPatterns: string[] = [];\n\n  for (const pattern of patterns) {\n    if (typeof pattern === 'string') {\n      paths.push(pattern);\n    } else {\n      paths.push(pattern.pattern);\n      if (pattern.publish === true) {\n        publishPatterns.push(pattern.pattern);\n      } else if (pattern.publish === false) {\n        unpublishPatterns.push(pattern.pattern);\n      }\n    }\n  }\n\n  return { paths, publishPatterns, unpublishPatterns };\n}\n\n/**\n * Resolves the files from the files object.\n * Performs glob pattern expansion on the files.\n * Replaces [locale] with the actual locale in the files.\n *\n * @param files - The files object\n * @returns The resolved files\n */\nexport function resolveFiles(\n  files: FilesOptions,\n  locale: string,\n  locales: string[],\n  cwd: string,\n  compositePatterns?: string[],\n  requiresReviewDefault: boolean = false\n): Settings['files'] {\n  // Initialize result object with empty arrays for each file type\n  const resolvedPaths: ResolvedFiles = {};\n  const placeholderResult: ResolvedFiles = {};\n  const transformPaths: TransformFiles = {};\n  // Output format transforms are tracked separately from path transforms.\n  const transformFormats: TransformFormats = {};\n  const publishPaths = new Set<string>();\n  const unpublishPaths = new Set<string>();\n  const requiresReviewPaths = new Set<string>();\n  const parsingFlags: ParseFlagsByFileType = {};\n\n  // Process GT files\n  if (files.gt?.output) {\n    placeholderResult.gt = path.resolve(cwd, files.gt.output);\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    // ==== TRANSFORMS ==== //\n    const transform = files[fileType]?.transform;\n    if (\n      transform &&\n      (typeof transform === 'string' ||\n        typeof transform === 'object' ||\n        Array.isArray(transform))\n    ) {\n      transformPaths[fileType] = transform;\n    }\n    // Validate source -> output format transforms during settings generation.\n    const transformFormat = resolveTransformationFormat(\n      fileType,\n      files[fileType]?.transformationFormat\n    );\n    if (transformFormat) {\n      transformFormats[fileType] = transformFormat;\n    }\n    // ==== PLACEHOLDERS ==== //\n    if (files[fileType]?.include) {\n      const { paths, publishPatterns, unpublishPatterns } =\n        normalizeIncludePatterns(files[fileType].include);\n\n      const filePaths = expandGlobPatterns(\n        cwd,\n        paths,\n        files[fileType]?.exclude || [],\n        locale,\n        locales,\n        transformPaths[fileType] || undefined,\n        compositePatterns\n      );\n      resolvedPaths[fileType] = filePaths.resolvedPaths;\n      placeholderResult[fileType] = filePaths.placeholderPaths;\n\n      // Classify resolved paths into publish/unpublish sets\n      classifyPublishPaths(\n        filePaths.resolvedPaths,\n        publishPatterns,\n        unpublishPatterns,\n        cwd,\n        locale,\n        publishPaths,\n        unpublishPaths\n      );\n\n      // Classify resolved paths by effective requiresReview policy\n      classifyRequiresReviewPaths(\n        filePaths.resolvedPaths,\n        validateRequiresReviewConfig(files[fileType]?.requiresReview, fileType),\n        requiresReviewDefault,\n        cwd,\n        locale,\n        requiresReviewPaths\n      );\n    }\n    // ==== OTHER ==== //\n    if (files[fileType]?.parsingFlags) {\n      parsingFlags[fileType] = {\n        ...BASE_PARSING_FLAGS_DEFAULT,\n        ...files[fileType].parsingFlags,\n      };\n    }\n  }\n\n  return {\n    resolvedPaths,\n    placeholderPaths: placeholderResult,\n    transformPaths: transformPaths,\n    transformFormats,\n    publishPaths,\n    unpublishPaths,\n    requiresReviewPaths,\n    parsingFlags,\n    gtJson: (() => {\n      const rawGtFlags = (files.gt?.parsingFlags || {}) as Record<\n        string,\n        unknown\n      >;\n      return {\n        publish: files.gt?.publish,\n        parsingFlags: {\n          ...GT_PARSING_FLAGS_DEFAULT,\n          ...rawGtFlags,\n        },\n      };\n    })(),\n  };\n}\n\n// Helper function to expand glob patterns\nexport function expandGlobPatterns(\n  cwd: string,\n  includePatterns: string[],\n  excludePatterns: string[],\n  locale: string,\n  locales: string[],\n  transformPatterns?: TransformOption | string | TransformOption[],\n  compositePatterns?: string[]\n): {\n  resolvedPaths: string[];\n  placeholderPaths: string[];\n} {\n  // Expand glob patterns to include all matching files\n  const resolvedPaths: string[] = [];\n  const placeholderPaths: string[] = [];\n\n  // Process include patterns\n  for (const pattern of includePatterns) {\n    // Track positions where [locale] appears in the original pattern\n    // It must be included in the pattern, otherwise the CLI tool will not be able to find the correct output path\n    // Warn if it's not included\n    // Ignore if is composite pattern\n    if (\n      !pattern.includes('[locale]') &&\n      !transformPatterns &&\n      !compositePatterns?.includes(pattern)\n    ) {\n      logger.warn(\n        chalk.yellow(\n          `Pattern \"${pattern}\" does not include [locale], so the CLI tool may incorrectly save translated files.`\n        )\n      );\n    }\n    const localePositions: number[] = [];\n    let searchIndex = 0;\n    const localeTag = '[locale]';\n\n    while (true) {\n      const foundIndex = pattern.indexOf(localeTag, searchIndex);\n      if (foundIndex === -1) break;\n      localePositions.push(foundIndex);\n      searchIndex = foundIndex + localeTag.length;\n    }\n\n    const expandedPattern = pattern.replace(/\\[locale\\]/g, locale);\n\n    // Resolve the absolute pattern path\n    const absolutePattern = path.resolve(cwd, expandedPattern);\n\n    // Prepare exclude patterns with locale replaced\n    const expandedExcludePatterns = Array.from(\n      new Set(\n        excludePatterns.flatMap((p) =>\n          locales.map((targetLocale) =>\n            path.resolve(\n              cwd,\n              p\n                .replace(/\\[locale\\]/g, locale)\n                .replace(/\\[locales\\]/g, targetLocale)\n            )\n          )\n        )\n      )\n    );\n\n    // Use fast-glob to find all matching files, excluding the patterns\n    const matches = fg.sync(absolutePattern, {\n      absolute: true,\n      ignore: expandedExcludePatterns,\n    });\n\n    resolvedPaths.push(...matches);\n\n    // For each match, create a version with [locale] in the correct positions\n    matches.forEach((match) => {\n      const absolutePath = path.resolve(cwd, match);\n      const patternPath = path.resolve(cwd, pattern);\n      let originalAbsolutePath = absolutePath;\n\n      if (localePositions.length > 0) {\n        const placeholderPath = buildPlaceholderPathFromPattern(\n          patternPath,\n          absolutePath,\n          localeTag\n        );\n        originalAbsolutePath = placeholderPath;\n      }\n\n      placeholderPaths.push(originalAbsolutePath);\n    });\n  }\n\n  return { resolvedPaths, placeholderPaths };\n}\n\nfunction buildPlaceholderPathFromPattern(\n  patternPath: string,\n  absolutePath: string,\n  localeTag: string\n): string {\n  if (!patternPath.includes(localeTag)) {\n    return absolutePath;\n  }\n\n  const posixPattern = toPosixPath(patternPath);\n  const posixPath = toPosixPath(absolutePath);\n\n  const baseRegex = micromatch.makeRe(posixPattern, {\n    literalBrackets: true,\n  });\n  const localeRegexSource = baseRegex.source.replace(\n    /\\\\\\[locale\\\\\\]/g,\n    '([^/]+)'\n  );\n  const flags = baseRegex.flags.includes('d')\n    ? baseRegex.flags\n    : `${baseRegex.flags}d`;\n  const matcher = new RegExp(localeRegexSource, flags);\n  const match = matcher.exec(posixPath);\n\n  const matchWithIndices = match as RegExpExecArray & {\n    indices?: Array<[number, number]>;\n  };\n\n  if (!match || !matchWithIndices.indices) {\n    return absolutePath;\n  }\n\n  let placeholderPosixPath = posixPath;\n  const indices = matchWithIndices.indices;\n\n  for (let i = indices.length - 1; i >= 1; i--) {\n    const [start, end] = indices[i];\n    if (start === -1 || end === -1) continue;\n    placeholderPosixPath =\n      placeholderPosixPath.slice(0, start) +\n      localeTag +\n      placeholderPosixPath.slice(end);\n  }\n\n  return path.normalize(placeholderPosixPath);\n}\n\nfunction toPosixPath(value: string): string {\n  return value.split(path.sep).join(path.posix.sep);\n}\n\n/**\n * Classifies resolved file paths into publish/unpublish sets by matching\n * them against the given glob patterns. Uses POSIX paths for micromatch\n * compatibility but stores platform-native paths in the output sets.\n */\nfunction classifyPublishPaths(\n  resolvedPaths: string[],\n  publishPatterns: string[],\n  unpublishPatterns: string[],\n  cwd: string,\n  locale: string,\n  publishPaths: Set<string>,\n  unpublishPaths: Set<string>\n): void {\n  if (publishPatterns.length === 0 && unpublishPatterns.length === 0) return;\n\n  const posixPaths = resolvedPaths.map(toPosixPath);\n  const toAbsoluteGlob = (p: string) =>\n    toPosixPath(path.resolve(cwd, p.replace(/\\[locale\\]/g, locale)));\n\n  for (const pattern of publishPatterns) {\n    const matched = new Set(micromatch(posixPaths, toAbsoluteGlob(pattern)));\n    for (let i = 0; i < posixPaths.length; i++) {\n      if (matched.has(posixPaths[i])) {\n        publishPaths.add(resolvedPaths[i]);\n      }\n    }\n  }\n\n  for (const pattern of unpublishPatterns) {\n    const matched = new Set(micromatch(posixPaths, toAbsoluteGlob(pattern)));\n    for (let i = 0; i < posixPaths.length; i++) {\n      if (matched.has(posixPaths[i])) {\n        unpublishPaths.add(resolvedPaths[i]);\n      }\n    }\n  }\n}\n\n/**\n * Validates a file-type requiresReview config value. Only a boolean or an\n * object of include/exclude glob string arrays is accepted — notably not\n * string \"true\"/\"false\", so a misquoted boolean fails loudly instead of\n * silently changing review policy (and with it, version identity).\n */\nfunction validateRequiresReviewConfig(\n  config: unknown,\n  fileType: string\n): RequiresReviewConfig | undefined {\n  if (config === undefined || typeof config === 'boolean') {\n    return config;\n  }\n  const isStringArray = (value: unknown): value is string[] =>\n    Array.isArray(value) && value.every((item) => typeof item === 'string');\n  if (\n    config !== null &&\n    typeof config === 'object' &&\n    !Array.isArray(config) &&\n    Object.keys(config).every((key) => key === 'include' || key === 'exclude')\n  ) {\n    const { include, exclude } = config as Record<string, unknown>;\n    if (\n      (include === undefined || isStringArray(include)) &&\n      (exclude === undefined || isStringArray(exclude))\n    ) {\n      return config as RequiresReviewConfig;\n    }\n  }\n  return logErrorAndExit(\n    `files.${fileType}.requiresReview must be a boolean or an object of glob string arrays: { include?: string[], exclude?: string[] }`\n  );\n}\n\n/**\n * Classifies resolved file paths by effective requiresReview policy and adds\n * paths whose policy is true to requiresReviewPaths. Precedence: file-type\n * include/exclude globs (exclude wins) > file-type boolean > top-level default.\n */\nfunction classifyRequiresReviewPaths(\n  resolvedPaths: string[],\n  config: RequiresReviewConfig | undefined,\n  requiresReviewDefault: boolean,\n  cwd: string,\n  locale: string,\n  requiresReviewPaths: Set<string>\n): void {\n  if (typeof config === 'boolean' || config === undefined) {\n    if (config ?? requiresReviewDefault) {\n      for (const resolvedPath of resolvedPaths) {\n        requiresReviewPaths.add(resolvedPath);\n      }\n    }\n    return;\n  }\n\n  const posixPaths = resolvedPaths.map(toPosixPath);\n  const toAbsoluteGlob = (p: string) =>\n    toPosixPath(path.resolve(cwd, p.replace(/\\[locale\\]/g, locale)));\n  const matchAny = (patterns: string[]) => {\n    const matched = new Set<string>();\n    for (const pattern of patterns) {\n      for (const match of micromatch(posixPaths, toAbsoluteGlob(pattern))) {\n        matched.add(match);\n      }\n    }\n    return matched;\n  };\n\n  const included = matchAny(config.include ?? []);\n  const excluded = matchAny(config.exclude ?? []);\n\n  for (let i = 0; i < posixPaths.length; i++) {\n    const requiresReview = excluded.has(posixPaths[i])\n      ? false\n      : included.has(posixPaths[i]) || requiresReviewDefault;\n    if (requiresReview) {\n      requiresReviewPaths.add(resolvedPaths[i]);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/fs/config/updateConfig.d.ts

@@ -8,6 +8,7 @@ type UpdateConfigOptions = {
     _versionId?: string | null;
     _branchId?: string | null;
     stageTranslations?: boolean | null;
+    omitConfigIds?: boolean | null;
 };
 /**
  * Update the config file version id, locales, and projectId (if necessary)

package/dist/fs/config/updateConfig.js

@@ -11,12 +11,13 @@ import fs from "node:fs";
 * Hint: Mark a field as null to remove it from the config file.
 */
 async function updateConfig(configFilepath, options) {
-	const { projectId, _versionId, _branchId, stageTranslations } = options;
+	const { projectId, _versionId, _branchId, stageTranslations, omitConfigIds } = options;
 	const newContent = {
 		...projectId && { projectId },
 		..._versionId && { _versionId },
 		..._branchId && { _branchId },
-		...stageTranslations && { stageTranslations }
+		...stageTranslations && { stageTranslations },
+		...omitConfigIds && { omitConfigIds }
 	};
 	try {
 		let oldContent = {};

package/dist/fs/config/updateConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateConfig.js","names":[],"sources":["../../../src/fs/config/updateConfig.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { displayUpdatedConfigFile } from '../../console/logging.js';\nimport { logger } from '../../console/logger.js';\n\n/**\n * Options for updating the config file.\n *\n * Since these are all string values, we can use null to mark them for removal\n */\ntype UpdateConfigOptions = {\n  projectId?: string | null;\n  _versionId?: string | null;\n  _branchId?: string | null;\n  stageTranslations?: boolean | null;\n};\n\n/**\n * Update the config file version id, locales, and projectId (if necessary)\n * @param {string} configFilepath - The path to the config file.\n * @param {UpdateConfigOptions} options - The options to update the config file with.\n * @returns {Promise<void>} - A promise that resolves when the config file is updated.\n *\n * Hint: Mark a field as null to remove it from the config file.\n */\nexport default async function updateConfig(\n  configFilepath: string,\n  options: UpdateConfigOptions\n): Promise<void> {\n  // Filter out empty string values from the config object\n  const { projectId, _versionId, _branchId, stageTranslations } = options;\n  const newContent = {\n    ...(projectId && { projectId }),\n    ...(_versionId && { _versionId }),\n    ...(_branchId && { _branchId }),\n    // Omit when false\n    ...(stageTranslations && { stageTranslations }),\n  };\n\n  try {\n    // if file exists\n    let oldContent: Record<string, unknown> = {};\n    if (fs.existsSync(configFilepath)) {\n      const parsed = JSON.parse(\n        await fs.promises.readFile(configFilepath, 'utf-8')\n      );\n      oldContent =\n        typeof parsed === 'object' && parsed !== null\n          ? (parsed as Record<string, unknown>)\n          : {};\n    }\n\n    // merge old and new content\n    const mergedContent = {\n      ...oldContent,\n      ...newContent,\n    };\n\n    // Apply null filter to remove values that were marked for removal\n    const filteredContent = applyNullFilter(mergedContent, options);\n\n    // write to file\n    const jsonContent = JSON.stringify(filteredContent, null, 2);\n    await fs.promises.writeFile(configFilepath, jsonContent, 'utf-8');\n\n    // show update in console\n    displayUpdatedConfigFile(configFilepath);\n  } catch (error) {\n    logger.error(\n      `An error occurred while updating ${configFilepath}: ${error}`\n    );\n  }\n}\n\n// --- Helper functions --- //\n\n/**\n * Remove values from object if they were marked for removal\n */\nfunction applyNullFilter<T extends Record<string, unknown>>(\n  obj: T,\n  filter: Partial<Record<keyof T, null | unknown>>\n): T {\n  const result = { ...obj };\n  for (const key of Object.keys(filter)) {\n    if (filter[key] === null) {\n      delete result[key];\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;AAwBA,eAA8B,aAC5B,gBACA,SACe;CAEf,MAAM,EAAE,WAAW,YAAY,WAAW,sBAAsB;CAChE,MAAM,aAAa;EACjB,GAAI,aAAa,EAAE,WAAW;EAC9B,GAAI,cAAc,EAAE,YAAY;EAChC,GAAI,aAAa,EAAE,WAAW;EAE9B,GAAI,qBAAqB,EAAE,mBAAmB;EAC/C;AAED,KAAI;EAEF,IAAI,aAAsC,EAAE;AAC5C,MAAI,GAAG,WAAW,eAAe,EAAE;GACjC,MAAM,SAAS,KAAK,MAClB,MAAM,GAAG,SAAS,SAAS,gBAAgB,QAAQ,CACpD;AACD,gBACE,OAAO,WAAW,YAAY,WAAW,OACpC,SACD,EAAE;;EAUV,MAAM,kBAAkB,gBAAgB;GALtC,GAAG;GACH,GAAG;GAIgD,EAAE,QAAQ;EAG/D,MAAM,cAAc,KAAK,UAAU,iBAAiB,MAAM,EAAE;AAC5D,QAAM,GAAG,SAAS,UAAU,gBAAgB,aAAa,QAAQ;AAGjE,2BAAyB,eAAe;UACjC,OAAO;AACd,SAAO,MACL,oCAAoC,eAAe,IAAI,QACxD;;;;;;AASL,SAAS,gBACP,KACA,QACG;CACH,MAAM,SAAS,EAAE,GAAG,KAAK;AACzB,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,OAAO,SAAS,KAClB,QAAO,OAAO;AAGlB,QAAO"}
+{"version":3,"file":"updateConfig.js","names":[],"sources":["../../../src/fs/config/updateConfig.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { displayUpdatedConfigFile } from '../../console/logging.js';\nimport { logger } from '../../console/logger.js';\n\n/**\n * Options for updating the config file.\n *\n * Since these are all string values, we can use null to mark them for removal\n */\ntype UpdateConfigOptions = {\n  projectId?: string | null;\n  _versionId?: string | null;\n  _branchId?: string | null;\n  stageTranslations?: boolean | null;\n  omitConfigIds?: boolean | null;\n};\n\n/**\n * Update the config file version id, locales, and projectId (if necessary)\n * @param {string} configFilepath - The path to the config file.\n * @param {UpdateConfigOptions} options - The options to update the config file with.\n * @returns {Promise<void>} - A promise that resolves when the config file is updated.\n *\n * Hint: Mark a field as null to remove it from the config file.\n */\nexport default async function updateConfig(\n  configFilepath: string,\n  options: UpdateConfigOptions\n): Promise<void> {\n  // Filter out empty string values from the config object\n  const { projectId, _versionId, _branchId, stageTranslations, omitConfigIds } =\n    options;\n  const newContent = {\n    ...(projectId && { projectId }),\n    ...(_versionId && { _versionId }),\n    ...(_branchId && { _branchId }),\n    // Omit when false\n    ...(stageTranslations && { stageTranslations }),\n    ...(omitConfigIds && { omitConfigIds }),\n  };\n\n  try {\n    // if file exists\n    let oldContent: Record<string, unknown> = {};\n    if (fs.existsSync(configFilepath)) {\n      const parsed = JSON.parse(\n        await fs.promises.readFile(configFilepath, 'utf-8')\n      );\n      oldContent =\n        typeof parsed === 'object' && parsed !== null\n          ? (parsed as Record<string, unknown>)\n          : {};\n    }\n\n    // merge old and new content\n    const mergedContent = {\n      ...oldContent,\n      ...newContent,\n    };\n\n    // Apply null filter to remove values that were marked for removal\n    const filteredContent = applyNullFilter(mergedContent, options);\n\n    // write to file\n    const jsonContent = JSON.stringify(filteredContent, null, 2);\n    await fs.promises.writeFile(configFilepath, jsonContent, 'utf-8');\n\n    // show update in console\n    displayUpdatedConfigFile(configFilepath);\n  } catch (error) {\n    logger.error(\n      `An error occurred while updating ${configFilepath}: ${error}`\n    );\n  }\n}\n\n// --- Helper functions --- //\n\n/**\n * Remove values from object if they were marked for removal\n */\nfunction applyNullFilter<T extends Record<string, unknown>>(\n  obj: T,\n  filter: Partial<Record<keyof T, null | unknown>>\n): T {\n  const result = { ...obj };\n  for (const key of Object.keys(filter)) {\n    if (filter[key] === null) {\n      delete result[key];\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;AAyBA,eAA8B,aAC5B,gBACA,SACe;CAEf,MAAM,EAAE,WAAW,YAAY,WAAW,mBAAmB,kBAC3D;CACF,MAAM,aAAa;EACjB,GAAI,aAAa,EAAE,WAAW;EAC9B,GAAI,cAAc,EAAE,YAAY;EAChC,GAAI,aAAa,EAAE,WAAW;EAE9B,GAAI,qBAAqB,EAAE,mBAAmB;EAC9C,GAAI,iBAAiB,EAAE,eAAe;EACvC;AAED,KAAI;EAEF,IAAI,aAAsC,EAAE;AAC5C,MAAI,GAAG,WAAW,eAAe,EAAE;GACjC,MAAM,SAAS,KAAK,MAClB,MAAM,GAAG,SAAS,SAAS,gBAAgB,QAAQ,CACpD;AACD,gBACE,OAAO,WAAW,YAAY,WAAW,OACpC,SACD,EAAE;;EAUV,MAAM,kBAAkB,gBAAgB;GALtC,GAAG;GACH,GAAG;GAIgD,EAAE,QAAQ;EAG/D,MAAM,cAAc,KAAK,UAAU,iBAAiB,MAAM,EAAE;AAC5D,QAAM,GAAG,SAAS,UAAU,gBAAgB,aAAa,QAAQ;AAGjE,2BAAyB,eAAe;UACjC,OAAO;AACd,SAAO,MACL,oCAAoC,eAAe,IAAI,QACxD;;;;;;AASL,SAAS,gBACP,KACA,QACG;CACH,MAAM,SAAS,EAAE,GAAG,KAAK;AACzB,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,OAAO,SAAS,KAClB,QAAO,OAAO;AAGlB,QAAO"}

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.14.58";
+export declare const PACKAGE_VERSION = "2.14.60";

package/dist/generated/version.js

@@ -1,5 +1,5 @@
 //#region src/generated/version.ts
-const PACKAGE_VERSION = "2.14.58";
+const PACKAGE_VERSION = "2.14.60";
 //#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.14.58';\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.14.60';\n"],"mappings":";AACA,MAAa,kBAAkB"}

package/dist/git/mergeDrivers.d.ts

@@ -0,0 +1,11 @@
+export type MergeDriverName = 'gt-lock' | 'gtjson';
+export type MergeDriverResult = {
+    ok: true;
+    content: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function runMergeDriver(driverName: MergeDriverName, basePath: string, oursPath: string, theirsPath: string): MergeDriverResult;
+export declare function mergeGtJson(baseRaw: string, oursRaw: string, theirsRaw: string): MergeDriverResult;
+export declare function mergeGtLockJson(baseRaw: string, oursRaw: string, theirsRaw: string): MergeDriverResult;