gt 2.22.4 → 2.23.0

package/dist/console/logging.d.ts

@@ -1,9 +1,12 @@
+import type { Option } from '@clack/prompts';
 import type { CustomMapping, FileToUpload } from 'generaltranslation/types';
 import { type InlineLibrary } from '../types/libraries.js';
 /**
  * Strip ANSI escape codes from a string (e.g., chalk color codes)
  */
 export declare function stripAnsi(str: string): string;
+/** The message of the last logErrorAndExit call, for exit-time reporting. */
+export declare function getLastExitError(): string | undefined;
 export declare function logErrorAndExit(message: string): never;
 export declare function exitSync(code: number): never;
 export declare function displayHeader(introString?: string): void;
@@ -17,6 +20,12 @@ export declare function promptText({ message, defaultValue, validate, }: {
     defaultValue?: string;
     validate?: (value: string) => boolean | string;
 }): Promise<string>;
+/**
+ * Searchable locale options: supported locales ranked by the query, the
+ * configured customMapping aliases, and any other valid locale typed or
+ * already selected, so aliases and custom tags stay selectable.
+ */
+export declare function getLocalePromptOptions(query: string, selected?: string[], customMapping?: CustomMapping): Option<string>[];
 export declare function promptLocale({ message, defaultValue, customMapping, }: {
     message: string;
     defaultValue?: string;
@@ -28,10 +37,11 @@ export declare function promptLocaleList({ message, defaultValue, required, cust
     required?: boolean;
     customMapping?: CustomMapping;
 }): Promise<string[]>;
-export declare function promptGlobPatterns({ label, message, defaultValue, }: {
+export declare function promptGlobPatterns(options: {
     label: string;
     message: string;
     defaultValue?: string;
+    validate?: (value: string) => boolean | string;
 }): Promise<string>;
 export declare function promptSelect<T>({ message, options, defaultValue, }: {
     message: string;

package/dist/console/logging.js

@@ -1,24 +1,19 @@
-import { endTerminalSession, shouldUseInkPrompts } from "./terminalSession.js";
 import { logger } from "./logger.js";
 import { getCLIVersion } from "../utils/packageJson.js";
 import "../utils/constants.js";
-import { parseLocaleList, validateLocale, validateLocaleList } from "./promptParsing.js";
+import { parseTypedLocale } from "./promptParsing.js";
+import { getFilteredLocaleOptions } from "./localeOptions.js";
 import { getInlineElementsLabel } from "../types/libraries.js";
-import { cancel, confirm, isCancel, multiselect, select, text } from "@clack/prompts";
+import { autocomplete, autocompleteMultiselect, cancel, confirm, isCancel, multiselect, select, text } from "@clack/prompts";
 import chalk from "chalk";
+import { createDiagnosticMessage } from "generaltranslation/internal";
 //#region src/console/logging.ts
-function cancelPromptAndExit(message) {
-	endTerminalSession();
-	cancel(message);
-	return exitSync(0);
-}
-async function loadInkPrompts() {
-	return import("./inkPrompts.js");
-}
-async function runInkPrompt(prompt, cancelMessage = "Operation cancelled") {
-	const result = await prompt(await loadInkPrompts());
-	if (result.cancelled) return cancelPromptAndExit(cancelMessage);
-	return result.value;
+function exitIfCancelled(result, message = "Operation cancelled") {
+	if (isCancel(result)) {
+		cancel(message);
+		return exitSync(0);
+	}
+	return result;
 }
 /**
 * Strip ANSI escape codes from a string (e.g., chalk color codes)
@@ -26,7 +21,13 @@ async function runInkPrompt(prompt, cancelMessage = "Operation cancelled") {
 function stripAnsi(str) {
 	return str.replace(/\x1B\[[0-9;]*m/g, "");
 }
+let lastExitError;
+/** The message of the last logErrorAndExit call, for exit-time reporting. */
+function getLastExitError() {
+	return lastExitError;
+}
 function logErrorAndExit(message) {
+	lastExitError = message;
 	logger.error(message);
 	return exitSync(1);
 }
@@ -77,117 +78,104 @@ function displayUpdatedVersionsFile(versionFilepath) {
 	logger.success(`Updated versions file ${chalk.cyan(versionFilepath)}`);
 }
 async function promptText({ message, defaultValue, validate }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptText({
-		message,
-		defaultValue,
-		validate
-	})) ?? "";
-	const result = await text({
+	return exitIfCancelled(await text({
 		message,
 		placeholder: defaultValue,
+		defaultValue,
 		validate: validate ? (value) => {
-			const validation = validate(value || "");
+			const validation = validate(value || defaultValue || "");
 			return validation === true ? void 0 : validation.toString();
 		} : void 0
-	});
-	if (isCancel(result)) {
-		cancel("Operation cancelled");
-		return exitSync(0);
-	}
-	return result;
+	}));
+}
+/**
+* Clack keeps the focused option while it still matches a new search, so
+* typing `fr` could leave `af` (Afrikaans) focused. Refocus the top-ranked
+* option whenever the search changes.
+*/
+function searchableLocaleOptions(getOptions) {
+	let lastQuery = "";
+	return function() {
+		const query = this.userInput ?? "";
+		if (query !== lastQuery) {
+			lastQuery = query;
+			this.focusedValue = void 0;
+		}
+		return getOptions(query, this.selectedValues ?? []);
+	};
 }
+/**
+* Searchable locale options: supported locales ranked by the query, the
+* configured customMapping aliases, and any other valid locale typed or
+* already selected, so aliases and custom tags stay selectable.
+*/
+function getLocalePromptOptions(query, selected = [], customMapping) {
+	const normalizedQuery = query.trim().toLowerCase();
+	const supported = getFilteredLocaleOptions(query).map((option) => ({
+		value: option.code,
+		label: option.label
+	}));
+	const known = new Set(supported.map((option) => option.value));
+	const aliases = Object.keys(customMapping ?? {}).filter((alias) => alias.toLowerCase().includes(normalizedQuery)).map((alias) => ({
+		value: alias,
+		label: alias,
+		hint: "custom mapping"
+	}));
+	const typed = parseTypedLocale(query, customMapping);
+	const extras = [...selected, ...typed ? [typed] : []].filter((locale) => !known.has(locale) && !aliases.some((alias) => alias.value === locale)).map((locale) => ({
+		value: locale,
+		label: locale
+	}));
+	return [...new Map([
+		...aliases,
+		...extras,
+		...supported
+	].map((option) => [option.value, option])).values()].sort((a, b) => Number(b.value.toLowerCase() === normalizedQuery) - Number(a.value.toLowerCase() === normalizedQuery));
+}
+const noLocaleSelectedError = createDiagnosticMessage({
+	whatHappened: "No locale matches the search",
+	fix: "Change the search and select a locale from the list"
+});
 async function promptLocale({ message, defaultValue, customMapping }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptLocale({
-		message,
-		defaultValue,
-		customMapping
-	})) ?? "";
-	return promptText({
+	return exitIfCancelled(await autocomplete({
 		message,
-		defaultValue,
-		validate: (value) => validateLocale(value, customMapping)
-	});
+		placeholder: "Type to search locales",
+		initialValue: defaultValue,
+		options: searchableLocaleOptions((query) => getLocalePromptOptions(query, [], customMapping)),
+		validate: (value) => value ? void 0 : noLocaleSelectedError
+	}));
 }
 async function promptLocaleList({ message, defaultValue, required = true, customMapping }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptLocaleMulti({
+	return exitIfCancelled(await autocompleteMultiselect({
 		message,
-		defaultValue,
+		placeholder: "Type to search, Tab or Space to select",
+		initialValues: defaultValue,
 		required,
-		customMapping
-	})) ?? [];
-	return promptText({
-		message,
-		defaultValue: defaultValue?.join(" "),
-		validate: (value) => validateLocaleList(value, customMapping)
-	}).then(parseLocaleList);
+		options: searchableLocaleOptions((query, selected) => getLocalePromptOptions(query, [...defaultValue ?? [], ...selected], customMapping))
+	}));
 }
-async function promptGlobPatterns({ label, message, defaultValue }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptGlob({
-		label,
-		message,
-		defaultValue
-	})) ?? "";
-	return promptText({
-		message,
-		defaultValue
-	});
+async function promptGlobPatterns(options) {
+	return promptText(options);
 }
 async function promptSelect({ message, options, defaultValue }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptSelect({
+	return exitIfCancelled(await select({
 		message,
 		options,
-		defaultValue
-	}));
-	const result = await select({
-		message,
-		options: options.map((opt) => ({
-			value: opt.value,
-			label: opt.label,
-			hint: opt.hint
-		})),
 		initialValue: defaultValue
-	});
-	if (isCancel(result)) {
-		cancel("Operation cancelled");
-		return exitSync(0);
-	}
-	return result;
+	}));
 }
 async function promptMultiSelect({ message, options, required = true }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptMultiSelect({
+	return exitIfCancelled(await multiselect({
 		message,
 		options,
 		required
-	})) ?? [];
-	const result = await multiselect({
-		message,
-		options: options.map((opt) => ({
-			value: opt.value,
-			label: opt.label,
-			hint: opt.hint
-		})),
-		required
-	});
-	if (isCancel(result)) {
-		cancel("Operation cancelled");
-		return exitSync(0);
-	}
-	return result;
+	}));
 }
 async function promptConfirm({ message, defaultValue = true, cancelMessage = "Operation cancelled" }) {
-	if (shouldUseInkPrompts()) return await runInkPrompt((prompts) => prompts.inkPromptConfirm({
-		message,
-		defaultValue
-	}), cancelMessage) ?? defaultValue;
-	const result = await confirm({
+	return exitIfCancelled(await confirm({
 		message,
 		initialValue: defaultValue
-	});
-	if (isCancel(result)) {
-		cancel(cancelMessage);
-		return exitSync(0);
-	}
-	return result;
+	}), cancelMessage);
 }
 function warnApiKeyInConfig(optionsFilepath) {
 	logger.warn(`Found ${chalk.cyan("apiKey")} in "${chalk.green(optionsFilepath)}". ` + chalk.white("Your API key is exposed! Remove it from the file and include it as an environment variable."));
@@ -221,6 +209,6 @@ function logCollectedFiles(files, inlineComponents, inlineLibrary) {
 	}).join("\n"));
 }
 //#endregion
-export { displayCreatedConfigFile, displayHeader, displayProjectId, displayResolvedPaths, displayUpdatedConfigFile, displayUpdatedVersionsFile, exitSync, logCollectedFiles, logErrorAndExit, promptConfirm, promptGlobPatterns, promptLocale, promptLocaleList, promptMultiSelect, promptSelect, promptText, stripAnsi, warnApiKeyInConfig, warnDeprecatedField, warnHasUnwrappedExpression, warnNoId, warnTemplateLiteral, warnTernary, warnVariableProp };
+export { displayCreatedConfigFile, displayHeader, displayProjectId, displayResolvedPaths, displayUpdatedConfigFile, displayUpdatedVersionsFile, exitSync, getLastExitError, getLocalePromptOptions, logCollectedFiles, logErrorAndExit, promptConfirm, promptGlobPatterns, promptLocale, promptLocaleList, promptMultiSelect, promptSelect, promptText, stripAnsi, warnApiKeyInConfig, warnDeprecatedField, warnHasUnwrappedExpression, warnNoId, warnTemplateLiteral, warnTernary, warnVariableProp };
 
 //# sourceMappingURL=logging.js.map

package/dist/console/logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.js","names":[],"sources":["../../src/console/logging.ts"],"sourcesContent":["import {\n  text,\n  select,\n  confirm,\n  isCancel,\n  cancel,\n  multiselect,\n} from '@clack/prompts';\nimport type { Option } from '@clack/prompts';\nimport chalk from 'chalk';\nimport { getCLIVersion } from '../utils/packageJson.js';\nimport { logger } from './logger.js';\nimport { TEMPLATE_FILE_NAME } from '../utils/constants.js';\nimport type { CustomMapping, FileToUpload } from 'generaltranslation/types';\nimport { endTerminalSession, shouldUseInkPrompts } from './terminalSession.js';\nimport {\n  parseLocaleList,\n  validateLocale,\n  validateLocaleList,\n} from './promptParsing.js';\nimport {\n  getInlineElementsLabel,\n  type InlineLibrary,\n} from '../types/libraries.js';\n\nfunction cancelPromptAndExit(message: string): never {\n  endTerminalSession();\n  cancel(message);\n  return exitSync(0);\n}\n\nasync function loadInkPrompts() {\n  return import('./inkPrompts.js');\n}\n\nasync function runInkPrompt<T>(\n  prompt: (prompts: Awaited<ReturnType<typeof loadInkPrompts>>) => Promise<{\n    value?: T;\n    cancelled: boolean;\n  }>,\n  cancelMessage = 'Operation cancelled'\n) {\n  const result = await prompt(await loadInkPrompts());\n  if (result.cancelled) {\n    return cancelPromptAndExit(cancelMessage);\n  }\n  return result.value;\n}\n\n/**\n * Strip ANSI escape codes from a string (e.g., chalk color codes)\n */\nexport function stripAnsi(str: string): string {\n  // eslint-disable-next-line no-control-regex, no-useless-escape\n  return str.replace(/\\x1B\\[[0-9;]*m/g, '');\n}\n\nexport function logErrorAndExit(message: string): never {\n  logger.error(message);\n  return exitSync(1);\n}\n\nexport function exitSync(code: number): never {\n  // Flush logs before exit\n  logger.flush();\n  process.exit(code);\n}\n\n// GT specific logging\nexport function displayHeader(introString?: string) {\n  // The ASCII banner is pure chatter and writes to console directly, bypassing\n  // the logger, so gate it here to honor --quiet. startCommand stays outside\n  // the gate: it is quiet-aware itself and must still run so the file log\n  // gets its [START] marker.\n  if (!logger.isQuiet()) {\n    displayAsciiTitle();\n    displayInitializingText();\n  }\n\n  if (introString) {\n    logger.startCommand(introString);\n  }\n}\n\nfunction displayAsciiTitle() {\n  // eslint-disable-next-line no-console\n  console.log(\n    chalk.cyan(\n      `\\n    @@@@@@@@@@@@@@@@@@@@@@\n  @@  @@@@@@@@@@@@ @@@@@@@\n @@ @@@          @ @\n@@ @@            @ @\n@@ @      @@@@@  @ @\n@@ @@     @@@ @  @ @\n @@ @@      @ @  @ @\n  @@  @@@@@@@ @  @ @\n    @@@@@@@@@    @ @`\n    )\n  );\n}\n\nfunction displayInitializingText() {\n  const version = getCLIVersion();\n  // eslint-disable-next-line no-console\n  console.log(\n    `\\n${chalk.bold.blue('General Translation, Inc.')}\n${chalk.dim('https://generaltranslation.com/docs')}\n${chalk.dim(`CLI Version: ${version}\\n`)}`\n  );\n}\n\nexport function displayProjectId(projectId: string) {\n  logger.message(\n    chalk.dim(`Project ID: ${chalk.bold(projectId)}`),\n    chalk.cyan('~')\n  );\n}\n\nexport function displayResolvedPaths(resolvedPaths: [string, string][]) {\n  const paths = resolvedPaths.map(([key, resolvedPath]) => {\n    return chalk.dim(`'${chalk.white(key)}' → '${chalk.green(resolvedPath)}'`);\n  });\n  logger.step(`Resolved path aliases:\\n${paths.join('\\n')}`);\n}\n\nexport function displayCreatedConfigFile(configFilepath: string) {\n  logger.step(`Created config file ${chalk.cyan(configFilepath)}`);\n}\n\nexport function displayUpdatedConfigFile(configFilepath: string) {\n  logger.success(`Updated config file ${chalk.cyan(configFilepath)}`);\n}\n\nexport function displayUpdatedVersionsFile(versionFilepath: string) {\n  logger.success(`Updated versions file ${chalk.cyan(versionFilepath)}`);\n}\n\n// Input prompts\nexport async function promptText({\n  message,\n  defaultValue,\n  validate,\n}: {\n  message: string;\n  defaultValue?: string;\n  validate?: (value: string) => boolean | string;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<string>((prompts) =>\n        prompts.inkPromptText({ message, defaultValue, validate })\n      )) ?? ''\n    );\n  }\n\n  const result = await text({\n    message,\n    placeholder: defaultValue,\n    validate: validate\n      ? (value) => {\n          const validation = validate(value || '');\n          return validation === true ? undefined : validation.toString();\n        }\n      : undefined,\n  });\n\n  if (isCancel(result)) {\n    cancel('Operation cancelled');\n    return exitSync(0);\n  }\n\n  return result;\n}\n\nexport async function promptLocale({\n  message,\n  defaultValue,\n  customMapping,\n}: {\n  message: string;\n  defaultValue?: string;\n  customMapping?: CustomMapping;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<string>((prompts) =>\n        prompts.inkPromptLocale({ message, defaultValue, customMapping })\n      )) ?? ''\n    );\n  }\n\n  return promptText({\n    message,\n    defaultValue,\n    validate: (value) => validateLocale(value, customMapping),\n  });\n}\n\nexport async function promptLocaleList({\n  message,\n  defaultValue,\n  required = true,\n  customMapping,\n}: {\n  message: string;\n  defaultValue?: string[];\n  required?: boolean;\n  customMapping?: CustomMapping;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<string[]>((prompts) =>\n        prompts.inkPromptLocaleMulti({\n          message,\n          defaultValue,\n          required,\n          customMapping,\n        })\n      )) ?? []\n    );\n  }\n\n  return promptText({\n    message,\n    defaultValue: defaultValue?.join(' '),\n    validate: (value) => validateLocaleList(value, customMapping),\n  }).then(parseLocaleList);\n}\n\nexport async function promptGlobPatterns({\n  label,\n  message,\n  defaultValue,\n}: {\n  label: string;\n  message: string;\n  defaultValue?: string;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<string>((prompts) =>\n        prompts.inkPromptGlob({ label, message, defaultValue })\n      )) ?? ''\n    );\n  }\n\n  return promptText({\n    message,\n    defaultValue,\n  });\n}\n\nexport async function promptSelect<T>({\n  message,\n  options,\n  defaultValue,\n}: {\n  message: string;\n  options: Array<{ value: T; label: string; hint?: string }>;\n  defaultValue?: T;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (await runInkPrompt<T>((prompts) =>\n      prompts.inkPromptSelect({ message, options, defaultValue })\n    )) as T;\n  }\n\n  // Convert options to the format expected by clack\n  const clackOptions = options.map((opt) => ({\n    value: opt.value,\n    label: opt.label,\n    hint: opt.hint,\n  })) as Option<T>[];\n\n  const result = await select({\n    message,\n    options: clackOptions,\n    initialValue: defaultValue,\n  });\n\n  if (isCancel(result)) {\n    cancel('Operation cancelled');\n    return exitSync(0);\n  }\n\n  return result as T;\n}\n\nexport async function promptMultiSelect<T extends string>({\n  message,\n  options,\n  required = true,\n}: {\n  message: string;\n  options: Array<{ value: T; label: string; hint?: string }>;\n  required?: boolean;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<Array<T>>((prompts) =>\n        prompts.inkPromptMultiSelect({\n          message,\n          options,\n          required,\n        })\n      )) ?? []\n    );\n  }\n\n  // Convert options to the format expected by clack\n  const clackOptions = options.map((opt) => ({\n    value: opt.value,\n    label: opt.label,\n    hint: opt.hint,\n  })) as Option<T>[];\n\n  const result = await multiselect({\n    message,\n    options: clackOptions,\n    required,\n  });\n\n  if (isCancel(result)) {\n    cancel('Operation cancelled');\n    return exitSync(0);\n  }\n\n  return result as Array<T>;\n}\n\nexport async function promptConfirm({\n  message,\n  defaultValue = true,\n  cancelMessage = 'Operation cancelled',\n}: {\n  message: string;\n  defaultValue?: boolean;\n  cancelMessage?: string;\n}) {\n  if (shouldUseInkPrompts()) {\n    return (\n      (await runInkPrompt<boolean>(\n        (prompts) => prompts.inkPromptConfirm({ message, defaultValue }),\n        cancelMessage\n      )) ?? defaultValue\n    );\n  }\n\n  const result = await confirm({\n    message,\n    initialValue: defaultValue,\n  });\n\n  if (isCancel(result)) {\n    cancel(cancelMessage);\n    return exitSync(0);\n  }\n\n  return result;\n}\n\n// Warning display functions\nexport function warnApiKeyInConfig(optionsFilepath: string) {\n  logger.warn(\n    `Found ${chalk.cyan('apiKey')} in \"${chalk.green(optionsFilepath)}\". ` +\n      chalk.white(\n        'Your API key is exposed! Remove it from the file and include it as an environment variable.'\n      )\n  );\n}\n\nexport function warnVariableProp(\n  file: string,\n  attrName: string,\n  value: string\n) {\n  logger.warn(\n    `Found ${chalk.green('<T>')} component in ${chalk.cyan(file)} with variable ${attrName}: \"${chalk.white(value)}\". ` +\n      `Change \"${attrName}\" to ensure this content is translated.`\n  );\n}\n\nexport function warnNoId(file: string) {\n  logger.warn(\n    `Found ${chalk.green('<T>')} component in ${chalk.cyan(file)} with no id. ` +\n      chalk.white('Add an id to ensure the content is translated.')\n  );\n}\n\nexport function warnHasUnwrappedExpression(\n  file: string,\n  id: string,\n  unwrappedExpressions: string[]\n) {\n  logger.warn(\n    `${chalk.green('<T>')} with id \"${id}\" in ${chalk.cyan(file)} has children: ${unwrappedExpressions.join(', ')} that could change at runtime. ` +\n      chalk.white('Use a variable component like ') +\n      chalk.green('<Var>') +\n      chalk.white(' (') +\n      chalk.blue('https://generaltranslation.com/docs') +\n      chalk.white(') to translate this properly.')\n  );\n}\n\nexport function warnTemplateLiteral(file: string, value: string) {\n  logger.warn(\n    `Found template literal with quasis (${value}) in ${chalk.cyan(file)}. ` +\n      chalk.white(\n        'Change the template literal to a string to ensure this content is translated.'\n      )\n  );\n}\n\nexport function warnTernary(file: string) {\n  logger.warn(\n    `Found ternary expression in ${chalk.cyan(file)}. ` +\n      chalk.white('A Branch component may be more appropriate here.')\n  );\n}\n\nexport function warnDeprecatedField(\n  deprecatedField: string,\n  replacement: string\n) {\n  logger.warn(\n    `${chalk.green(deprecatedField)} is deprecated. ` +\n      chalk.white(`Use ${chalk.green(replacement)} instead.`)\n  );\n}\n\n/**\n * Helper: Log all collected files\n */\nexport function logCollectedFiles(\n  files: Pick<FileToUpload, 'fileName'>[],\n  inlineComponents?: number,\n  inlineLibrary?: InlineLibrary\n): void {\n  const elementLabel = getInlineElementsLabel(inlineLibrary);\n  logger.message(\n    chalk.cyan('Files found in project:') +\n      '\\n' +\n      files\n        .map((file) => {\n          if (file.fileName === TEMPLATE_FILE_NAME) {\n            return `- <${elementLabel}>${inlineComponents ? ` (${inlineComponents})` : ''}`;\n          }\n          return `- ${file.fileName}`;\n        })\n        .join('\\n')\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"logging.js","names":[],"sources":["../../src/console/logging.ts"],"sourcesContent":["import {\n  text,\n  select,\n  confirm,\n  isCancel,\n  cancel,\n  multiselect,\n  autocomplete,\n  autocompleteMultiselect,\n} from '@clack/prompts';\nimport type { Option } from '@clack/prompts';\nimport chalk from 'chalk';\nimport { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { getCLIVersion } from '../utils/packageJson.js';\nimport { logger } from './logger.js';\nimport { TEMPLATE_FILE_NAME } from '../utils/constants.js';\nimport type { CustomMapping, FileToUpload } from 'generaltranslation/types';\nimport { parseTypedLocale } from './promptParsing.js';\nimport { getFilteredLocaleOptions } from './localeOptions.js';\nimport {\n  getInlineElementsLabel,\n  type InlineLibrary,\n} from '../types/libraries.js';\n\nfunction exitIfCancelled<T>(\n  result: T | symbol,\n  message = 'Operation cancelled'\n): T {\n  if (isCancel(result)) {\n    cancel(message);\n    return exitSync(0);\n  }\n  return result as T;\n}\n\n/**\n * Strip ANSI escape codes from a string (e.g., chalk color codes)\n */\nexport function stripAnsi(str: string): string {\n  // eslint-disable-next-line no-control-regex, no-useless-escape\n  return str.replace(/\\x1B\\[[0-9;]*m/g, '');\n}\n\nlet lastExitError: string | undefined;\n\n/** The message of the last logErrorAndExit call, for exit-time reporting. */\nexport function getLastExitError(): string | undefined {\n  return lastExitError;\n}\n\nexport function logErrorAndExit(message: string): never {\n  lastExitError = message;\n  logger.error(message);\n  return exitSync(1);\n}\n\nexport function exitSync(code: number): never {\n  // Flush logs before exit\n  logger.flush();\n  process.exit(code);\n}\n\n// GT specific logging\nexport function displayHeader(introString?: string) {\n  // The ASCII banner is pure chatter and writes to console directly, bypassing\n  // the logger, so gate it here to honor --quiet. startCommand stays outside\n  // the gate: it is quiet-aware itself and must still run so the file log\n  // gets its [START] marker.\n  if (!logger.isQuiet()) {\n    displayAsciiTitle();\n    displayInitializingText();\n  }\n\n  if (introString) {\n    logger.startCommand(introString);\n  }\n}\n\nfunction displayAsciiTitle() {\n  // eslint-disable-next-line no-console\n  console.log(\n    chalk.cyan(\n      `\\n    @@@@@@@@@@@@@@@@@@@@@@\n  @@  @@@@@@@@@@@@ @@@@@@@\n @@ @@@          @ @\n@@ @@            @ @\n@@ @      @@@@@  @ @\n@@ @@     @@@ @  @ @\n @@ @@      @ @  @ @\n  @@  @@@@@@@ @  @ @\n    @@@@@@@@@    @ @`\n    )\n  );\n}\n\nfunction displayInitializingText() {\n  const version = getCLIVersion();\n  // eslint-disable-next-line no-console\n  console.log(\n    `\\n${chalk.bold.blue('General Translation, Inc.')}\n${chalk.dim('https://generaltranslation.com/docs')}\n${chalk.dim(`CLI Version: ${version}\\n`)}`\n  );\n}\n\nexport function displayProjectId(projectId: string) {\n  logger.message(\n    chalk.dim(`Project ID: ${chalk.bold(projectId)}`),\n    chalk.cyan('~')\n  );\n}\n\nexport function displayResolvedPaths(resolvedPaths: [string, string][]) {\n  const paths = resolvedPaths.map(([key, resolvedPath]) => {\n    return chalk.dim(`'${chalk.white(key)}' → '${chalk.green(resolvedPath)}'`);\n  });\n  logger.step(`Resolved path aliases:\\n${paths.join('\\n')}`);\n}\n\nexport function displayCreatedConfigFile(configFilepath: string) {\n  logger.step(`Created config file ${chalk.cyan(configFilepath)}`);\n}\n\nexport function displayUpdatedConfigFile(configFilepath: string) {\n  logger.success(`Updated config file ${chalk.cyan(configFilepath)}`);\n}\n\nexport function displayUpdatedVersionsFile(versionFilepath: string) {\n  logger.success(`Updated versions file ${chalk.cyan(versionFilepath)}`);\n}\n\n// Input prompts\nexport async function promptText({\n  message,\n  defaultValue,\n  validate,\n}: {\n  message: string;\n  defaultValue?: string;\n  validate?: (value: string) => boolean | string;\n}) {\n  const result = await text({\n    message,\n    placeholder: defaultValue,\n    defaultValue,\n    validate: validate\n      ? (value) => {\n          // Clack applies defaultValue after validation; check what Enter returns.\n          const validation = validate(value || defaultValue || '');\n          return validation === true ? undefined : validation.toString();\n        }\n      : undefined,\n  });\n  return exitIfCancelled(result);\n}\n\ntype LocalePromptContext = {\n  userInput: string;\n  selectedValues: string[];\n  focusedValue?: string;\n};\n\n/**\n * Clack keeps the focused option while it still matches a new search, so\n * typing `fr` could leave `af` (Afrikaans) focused. Refocus the top-ranked\n * option whenever the search changes.\n */\nfunction searchableLocaleOptions(\n  getOptions: (query: string, selected: string[]) => Option<string>[]\n) {\n  let lastQuery = '';\n  return function (this: LocalePromptContext) {\n    const query = this.userInput ?? '';\n    if (query !== lastQuery) {\n      lastQuery = query;\n      this.focusedValue = undefined;\n    }\n    return getOptions(query, this.selectedValues ?? []);\n  };\n}\n\n/**\n * Searchable locale options: supported locales ranked by the query, the\n * configured customMapping aliases, and any other valid locale typed or\n * already selected, so aliases and custom tags stay selectable.\n */\nexport function getLocalePromptOptions(\n  query: string,\n  selected: string[] = [],\n  customMapping?: CustomMapping\n): Option<string>[] {\n  const normalizedQuery = query.trim().toLowerCase();\n  const supported = getFilteredLocaleOptions(query).map((option) => ({\n    value: option.code,\n    label: option.label,\n  }));\n  const known = new Set(supported.map((option) => option.value));\n  const aliases = Object.keys(customMapping ?? {})\n    .filter((alias) => alias.toLowerCase().includes(normalizedQuery))\n    .map((alias) => ({ value: alias, label: alias, hint: 'custom mapping' }));\n  const typed = parseTypedLocale(query, customMapping);\n  const extras = [...selected, ...(typed ? [typed] : [])]\n    .filter(\n      (locale) =>\n        !known.has(locale) && !aliases.some((alias) => alias.value === locale)\n    )\n    .map((locale) => ({ value: locale, label: locale }));\n  return [\n    ...new Map(\n      [...aliases, ...extras, ...supported].map((option) => [\n        option.value,\n        option,\n      ])\n    ).values(),\n  ].sort(\n    (a, b) =>\n      Number(b.value.toLowerCase() === normalizedQuery) -\n      Number(a.value.toLowerCase() === normalizedQuery)\n  );\n}\n\n// Body-only: Clack shows it inline under the prompt.\nconst noLocaleSelectedError = createDiagnosticMessage({\n  whatHappened: 'No locale matches the search',\n  fix: 'Change the search and select a locale from the list',\n});\n\nexport async function promptLocale({\n  message,\n  defaultValue,\n  customMapping,\n}: {\n  message: string;\n  defaultValue?: string;\n  customMapping?: CustomMapping;\n}) {\n  const result = await autocomplete<string>({\n    message,\n    placeholder: 'Type to search locales',\n    initialValue: defaultValue,\n    options: searchableLocaleOptions((query) =>\n      getLocalePromptOptions(query, [], customMapping)\n    ),\n    // Enter with no matching option submits nothing; keep asking.\n    validate: (value) => (value ? undefined : noLocaleSelectedError),\n  });\n  return exitIfCancelled(result);\n}\n\nexport async function promptLocaleList({\n  message,\n  defaultValue,\n  required = true,\n  customMapping,\n}: {\n  message: string;\n  defaultValue?: string[];\n  required?: boolean;\n  customMapping?: CustomMapping;\n}) {\n  const result = await autocompleteMultiselect<string>({\n    message,\n    placeholder: 'Type to search, Tab or Space to select',\n    initialValues: defaultValue,\n    required,\n    // Clack only preselects defaults present in the first options list, so\n    // keep custom default tags listed even before they are selected.\n    options: searchableLocaleOptions((query, selected) =>\n      getLocalePromptOptions(\n        query,\n        [...(defaultValue ?? []), ...selected],\n        customMapping\n      )\n    ),\n  });\n  return exitIfCancelled(result);\n}\n\nexport async function promptGlobPatterns(options: {\n  label: string;\n  message: string;\n  defaultValue?: string;\n  validate?: (value: string) => boolean | string;\n}) {\n  return promptText(options);\n}\n\nexport async function promptSelect<T>({\n  message,\n  options,\n  defaultValue,\n}: {\n  message: string;\n  options: Array<{ value: T; label: string; hint?: string }>;\n  defaultValue?: T;\n}) {\n  const result = await select({\n    message,\n    options: options as Option<T>[],\n    initialValue: defaultValue,\n  });\n  return exitIfCancelled(result);\n}\n\nexport async function promptMultiSelect<T extends string>({\n  message,\n  options,\n  required = true,\n}: {\n  message: string;\n  options: Array<{ value: T; label: string; hint?: string }>;\n  required?: boolean;\n}) {\n  const result = await multiselect({\n    message,\n    options: options as Option<T>[],\n    required,\n  });\n  return exitIfCancelled(result);\n}\n\nexport async function promptConfirm({\n  message,\n  defaultValue = true,\n  cancelMessage = 'Operation cancelled',\n}: {\n  message: string;\n  defaultValue?: boolean;\n  cancelMessage?: string;\n}) {\n  const result = await confirm({\n    message,\n    initialValue: defaultValue,\n  });\n  return exitIfCancelled(result, cancelMessage);\n}\n\n// Warning display functions\nexport function warnApiKeyInConfig(optionsFilepath: string) {\n  logger.warn(\n    `Found ${chalk.cyan('apiKey')} in \"${chalk.green(optionsFilepath)}\". ` +\n      chalk.white(\n        'Your API key is exposed! Remove it from the file and include it as an environment variable.'\n      )\n  );\n}\n\nexport function warnVariableProp(\n  file: string,\n  attrName: string,\n  value: string\n) {\n  logger.warn(\n    `Found ${chalk.green('<T>')} component in ${chalk.cyan(file)} with variable ${attrName}: \"${chalk.white(value)}\". ` +\n      `Change \"${attrName}\" to ensure this content is translated.`\n  );\n}\n\nexport function warnNoId(file: string) {\n  logger.warn(\n    `Found ${chalk.green('<T>')} component in ${chalk.cyan(file)} with no id. ` +\n      chalk.white('Add an id to ensure the content is translated.')\n  );\n}\n\nexport function warnHasUnwrappedExpression(\n  file: string,\n  id: string,\n  unwrappedExpressions: string[]\n) {\n  logger.warn(\n    `${chalk.green('<T>')} with id \"${id}\" in ${chalk.cyan(file)} has children: ${unwrappedExpressions.join(', ')} that could change at runtime. ` +\n      chalk.white('Use a variable component like ') +\n      chalk.green('<Var>') +\n      chalk.white(' (') +\n      chalk.blue('https://generaltranslation.com/docs') +\n      chalk.white(') to translate this properly.')\n  );\n}\n\nexport function warnTemplateLiteral(file: string, value: string) {\n  logger.warn(\n    `Found template literal with quasis (${value}) in ${chalk.cyan(file)}. ` +\n      chalk.white(\n        'Change the template literal to a string to ensure this content is translated.'\n      )\n  );\n}\n\nexport function warnTernary(file: string) {\n  logger.warn(\n    `Found ternary expression in ${chalk.cyan(file)}. ` +\n      chalk.white('A Branch component may be more appropriate here.')\n  );\n}\n\nexport function warnDeprecatedField(\n  deprecatedField: string,\n  replacement: string\n) {\n  logger.warn(\n    `${chalk.green(deprecatedField)} is deprecated. ` +\n      chalk.white(`Use ${chalk.green(replacement)} instead.`)\n  );\n}\n\n/**\n * Helper: Log all collected files\n */\nexport function logCollectedFiles(\n  files: Pick<FileToUpload, 'fileName'>[],\n  inlineComponents?: number,\n  inlineLibrary?: InlineLibrary\n): void {\n  const elementLabel = getInlineElementsLabel(inlineLibrary);\n  logger.message(\n    chalk.cyan('Files found in project:') +\n      '\\n' +\n      files\n        .map((file) => {\n          if (file.fileName === TEMPLATE_FILE_NAME) {\n            return `- <${elementLabel}>${inlineComponents ? ` (${inlineComponents})` : ''}`;\n          }\n          return `- ${file.fileName}`;\n        })\n        .join('\\n')\n  );\n}\n"],"mappings":"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"}

package/dist/formats/files/aggregateFiles.js

@@ -6,7 +6,6 @@ import { fileEncodingSkipReason, lottieExpressionsError, xcstringsSourceLanguage
 import { SUPPORTED_FILE_EXTENSIONS } from "./supportedFiles.js";
 import { CONFIG_FILE_TYPE_TO_FILE_FORMAT, getTransformFormatProperty } from "./transformFormat.js";
 import { api } from "../../utils/api.js";
-import { determineLibrary } from "../../fs/determineFramework/index.js";
 import { readFileContent } from "../../fs/fileContent.js";
 import { flattenJson } from "../json/flattenJson.js";
 import { recordWarning } from "../../state/translateWarnings.js";
@@ -18,6 +17,7 @@ import { resolveMintlifyRefs, shouldResolveRefs } from "../../utils/resolveMintl
 import { storeRefMap } from "../../state/mintlifyRefMap.js";
 import { validateYamlSchema } from "../yaml/utils.js";
 import parseYaml from "../yaml/parseYaml.js";
+import { determineLibrary } from "../../fs/determineFramework/index.js";
 import { preprocessContent } from "./preprocessContent.js";
 import { parseKeyedMetadata } from "../parseKeyedMetadata.js";
 import YAML from "yaml";

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

@@ -1,4 +1,7 @@
 export declare const SUPPORTED_FILE_EXTENSIONS: readonly ["json", "pot", "mdx", "md", "ts", "js", "yaml", "html", "txt", "twilioContentJson", "lottie", "dotStrings", "dotStringsdict", "androidStrings", "xcstrings", "srt"];
+/** The formats setup offers: an intentional subset of the supported ones. */
+export declare const SETUP_FILE_FORMATS: readonly ["json", "md", "mdx", "ts", "js", "yaml"];
+export type SetupFileFormat = (typeof SETUP_FILE_FORMATS)[number];
 export declare const FILE_EXT_TO_EXT_LABEL: {
     json: string;
     pot: string;

package/dist/formats/files/supportedFiles.js

@@ -17,6 +17,15 @@ const SUPPORTED_FILE_EXTENSIONS = [
 	"xcstrings",
 	"srt"
 ];
+/** The formats setup offers: an intentional subset of the supported ones. */
+const SETUP_FILE_FORMATS = [
+	"json",
+	"md",
+	"mdx",
+	"ts",
+	"js",
+	"yaml"
+];
 const FILE_EXT_TO_EXT_LABEL = {
 	json: "JSON",
 	pot: "POT",
@@ -36,6 +45,6 @@ const FILE_EXT_TO_EXT_LABEL = {
 	srt: "SubRip subtitles (.srt)"
 };
 //#endregion
-export { FILE_EXT_TO_EXT_LABEL, SUPPORTED_FILE_EXTENSIONS };
+export { FILE_EXT_TO_EXT_LABEL, SETUP_FILE_FORMATS, SUPPORTED_FILE_EXTENSIONS };
 
 //# sourceMappingURL=supportedFiles.js.map

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  'dotStrings',\n  'dotStringsdict',\n  'androidStrings',\n  'xcstrings',\n  'srt',\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  androidStrings: 'Android strings.xml',\n  xcstrings: '.xcstrings',\n  srt: 'SubRip subtitles (.srt)',\n};\n"],"mappings":";AAAA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;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;CAChB,gBAAgB;CAChB,WAAW;CACX,KAAK;CACN"}
+{"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  'androidStrings',\n  'xcstrings',\n  'srt',\n] as const;\n\n/** The formats setup offers: an intentional subset of the supported ones. */\nexport const SETUP_FILE_FORMATS = [\n  'json',\n  'md',\n  'mdx',\n  'ts',\n  'js',\n  'yaml',\n] as const satisfies readonly (typeof SUPPORTED_FILE_EXTENSIONS)[number][];\nexport type SetupFileFormat = (typeof SETUP_FILE_FORMATS)[number];\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  androidStrings: 'Android strings.xml',\n  xcstrings: '.xcstrings',\n  srt: 'SubRip subtitles (.srt)',\n};\n"],"mappings":";AAAA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAa,qBAAqB;CAChC;CACA;CACA;CACA;CACA;CACA;CACD;AAGD,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;CAChB,gBAAgB;CAChB,WAAW;CACX,KAAK;CACN"}

package/dist/formats/yaml/mergeYaml.js

@@ -2,8 +2,8 @@ import { logger } from "../../console/logger.js";
 import { exitSync } from "../../console/logging.js";
 import { validateYamlSchema } from "./utils.js";
 import { applyTransformations } from "../json/mergeJson.js";
-import JSONPointer from "jsonpointer";
 import YAML from "yaml";
+import JSONPointer from "jsonpointer";
 //#region src/formats/yaml/mergeYaml.ts
 function mergeYaml(originalContent, inputPath, options, targets, defaultLocale) {
 	const yamlSchema = validateYamlSchema(options, inputPath);

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

@@ -1 +1,3 @@
+/** `--config` accepts a path with or without its `.json` extension. */
+export declare function withJsonExtension(configPath: string): string;
 export declare function loadConfig(filepath: string): Record<string, unknown>;

package/dist/fs/config/loadConfig.js

@@ -1,5 +1,9 @@
 import fs from "node:fs";
 //#region src/fs/config/loadConfig.ts
+/** `--config` accepts a path with or without its `.json` extension. */
+function withJsonExtension(configPath) {
+	return configPath.endsWith(".json") ? configPath : `${configPath}.json`;
+}
 function loadConfig(filepath) {
 	try {
 		return JSON.parse(fs.readFileSync(filepath, "utf-8"));
@@ -8,6 +12,6 @@ function loadConfig(filepath) {
 	}
 }
 //#endregion
-export { loadConfig };
+export { loadConfig, withJsonExtension };
 
 //# sourceMappingURL=loadConfig.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"loadConfig.js","names":[],"sources":["../../../src/fs/config/loadConfig.ts"],"sourcesContent":["import fs from 'node:fs';\n\nexport function loadConfig(filepath: string): Record<string, unknown> {\n  try {\n    return JSON.parse(fs.readFileSync(filepath, 'utf-8')) as Record<\n      string,\n      unknown\n    >;\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;AAEA,SAAgB,WAAW,UAA2C;AACpE,KAAI;AACF,SAAO,KAAK,MAAM,GAAG,aAAa,UAAU,QAAQ,CAAC;SAI/C;AACN,SAAO,EAAE"}
+{"version":3,"file":"loadConfig.js","names":[],"sources":["../../../src/fs/config/loadConfig.ts"],"sourcesContent":["import fs from 'node:fs';\n\n/** `--config` accepts a path with or without its `.json` extension. */\nexport function withJsonExtension(configPath: string): string {\n  return configPath.endsWith('.json') ? configPath : `${configPath}.json`;\n}\n\nexport function loadConfig(filepath: string): Record<string, unknown> {\n  try {\n    return JSON.parse(fs.readFileSync(filepath, 'utf-8')) as Record<\n      string,\n      unknown\n    >;\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;AAGA,SAAgB,kBAAkB,YAA4B;AAC5D,QAAO,WAAW,SAAS,QAAQ,GAAG,aAAa,GAAG,WAAW;;AAGnE,SAAgB,WAAW,UAA2C;AACpE,KAAI;AACF,SAAO,KAAK,MAAM,GAAG,aAAa,UAAU,QAAQ,CAAC;SAI/C;AACN,SAAO,EAAE"}

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

@@ -1,12 +1,5 @@
 import { FilesOptions, SupportedFrameworks } from '../../types/index.js';
-/**
- * Checks if the config file exists.
- * If yes, make sure make sure projectId is correct
- * If not, creates a new JSON file at the given filepath and writes the provided config object to it.
- * @param {string} configFilepath - The path to the config file.
- * @param {Record<string, any>} configObject - The config object to write if the file does not exist.
- */
-export declare function createOrUpdateConfig(configFilepath: string, options: {
+export type SetupConfigUpdate = {
     projectId?: string;
     defaultLocale?: string;
     locales?: string[];
@@ -17,4 +10,20 @@ export declare function createOrUpdateConfig(configFilepath: string, options: {
     publish?: boolean;
     /** Removes stale global CDN intent when the selected runtime forbids it. */
     clearPublish?: boolean;
-}): Promise<string>;
+    /** File format entries deselected by an explicit format list. */
+    removeFiles?: string[];
+    /** Drops files.gt.output after an explicit switch to CDN storage. */
+    clearGtOutput?: boolean;
+};
+/**
+ * The config setup writes: the existing content with the update applied.
+ * Unrelated fields and per-format options are kept; locales are replaced.
+ */
+export declare function mergeSetupConfig(oldContent: Record<string, unknown>, options: SetupConfigUpdate): Record<string, unknown>;
+/**
+ * Creates the config file, or applies the update to the existing one.
+ * @param {string} configFilepath - The path to the config file.
+ * @param {SetupConfigUpdate} options - The values setup resolved.
+ * @throws When the existing file is not valid JSON or cannot be written.
+ */
+export declare function createOrUpdateConfig(configFilepath: string, options: SetupConfigUpdate): Promise<string>;

package/dist/fs/config/setupConfig.js

@@ -1,59 +1,79 @@
-import { logger } from "../../console/logger.js";
 import { GT_CONFIG_SCHEMA_URL } from "../../utils/constants.js";
 import { displayCreatedConfigFile } from "../../console/logging.js";
+import { createDiagnosticMessage, formatDiagnosticErrorDetails } from "generaltranslation/internal";
 import fs from "node:fs";
 //#region src/fs/config/setupConfig.ts
+function asObject(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
 /**
-* Checks if the config file exists.
-* If yes, make sure make sure projectId is correct
-* If not, creates a new JSON file at the given filepath and writes the provided config object to it.
-* @param {string} configFilepath - The path to the config file.
-* @param {Record<string, any>} configObject - The config object to write if the file does not exist.
+* The config setup writes: the existing content with the update applied.
+* Unrelated fields and per-format options are kept; locales are replaced.
 */
-async function createOrUpdateConfig(configFilepath, options) {
+function mergeSetupConfig(oldContent, options) {
 	const newContent = {
 		...options.projectId && { projectId: options.projectId },
 		...options.defaultLocale && { defaultLocale: options.defaultLocale },
 		...options.src && { src: options.src },
-		...options.files && { files: options.files },
 		...options.framework && { framework: options.framework },
 		...options.baseUrl && { baseUrl: options.baseUrl },
 		...options.publish && { publish: options.publish }
 	};
+	const mergedContent = {
+		$schema: GT_CONFIG_SCHEMA_URL,
+		...oldContent,
+		...newContent
+	};
+	if (options.clearPublish) delete mergedContent.publish;
+	if (options.files || options.removeFiles?.length || options.clearGtOutput) {
+		const oldFiles = asObject(oldContent.files);
+		const files = {
+			...oldFiles,
+			...options.files
+		};
+		const gt = {
+			...asObject(oldFiles.gt),
+			...options.files?.gt
+		};
+		if (options.clearGtOutput) delete gt.output;
+		if (Object.keys(gt).length > 0) files.gt = gt;
+		else delete files.gt;
+		for (const format of options.removeFiles ?? []) delete files[format];
+		if (Object.keys(files).length > 0) mergedContent.files = files;
+		else delete mergedContent.files;
+	}
+	if (options.locales) mergedContent.locales = options.locales;
+	return mergedContent;
+}
+/**
+* Creates the config file, or applies the update to the existing one.
+* @param {string} configFilepath - The path to the config file.
+* @param {SetupConfigUpdate} options - The values setup resolved.
+* @throws When the existing file is not valid JSON or cannot be written.
+*/
+async function createOrUpdateConfig(configFilepath, options) {
 	try {
 		let oldContent = {};
 		if (fs.existsSync(configFilepath)) {
 			const parsed = JSON.parse(await fs.promises.readFile(configFilepath, "utf-8"));
-			oldContent = typeof parsed === "object" && parsed !== null ? parsed : {};
-		}
-		const mergedContent = {
-			$schema: GT_CONFIG_SCHEMA_URL,
-			...oldContent,
-			...newContent
-		};
-		if (options.clearPublish) delete mergedContent.publish;
-		if (options.files) {
-			const oldFiles = oldContent.files && typeof oldContent.files === "object" ? oldContent.files : {};
-			const oldGt = oldFiles.gt && typeof oldFiles.gt === "object" ? oldFiles.gt : {};
-			mergedContent.files = {
-				...oldFiles,
-				...options.files,
-				...options.files.gt && { gt: {
-					...oldGt,
-					...options.files.gt
-				} }
-			};
+			if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error("the file does not contain a JSON object");
+			oldContent = parsed;
 		}
-		if (options.locales) mergedContent.locales = mergedContent.locales ? [...new Set([...mergedContent.locales, ...options.locales])] : options.locales;
-		const mergedJsonContent = JSON.stringify(mergedContent, null, 2);
+		const mergedJsonContent = JSON.stringify(mergeSetupConfig(oldContent, options), null, 2);
 		await fs.promises.writeFile(configFilepath, mergedJsonContent, "utf-8");
 		displayCreatedConfigFile(configFilepath);
 	} catch (error) {
-		logger.error(`An error occurred while updating ${configFilepath}: ${error}`);
+		throw new Error(createDiagnosticMessage({
+			source: "gt",
+			severity: "Error",
+			whatHappened: `Could not update ${configFilepath}`,
+			details: formatDiagnosticErrorDetails(error),
+			fix: "Fix or remove the file, then rerun the command"
+		}));
 	}
 	return configFilepath;
 }
 //#endregion
-export { createOrUpdateConfig };
+export { createOrUpdateConfig, mergeSetupConfig };
 
 //# sourceMappingURL=setupConfig.js.map