gt 2.22.4 → 2.23.0

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

@@ -1 +1 @@
-{"version":3,"file":"setupConfig.js","names":[],"sources":["../../../src/fs/config/setupConfig.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { displayCreatedConfigFile } from '../../console/logging.js';\nimport { FilesOptions, SupportedFrameworks } from '../../types/index.js';\nimport { logger } from '../../console/logger.js';\nimport { GT_CONFIG_SCHEMA_URL } from '../../utils/constants.js';\n\n/**\n * Checks if the config file exists.\n * If yes, make sure make sure projectId is correct\n * If not, creates a new JSON file at the given filepath and writes the provided config object to it.\n * @param {string} configFilepath - The path to the config file.\n * @param {Record<string, any>} configObject - The config object to write if the file does not exist.\n */\nexport async function createOrUpdateConfig(\n  configFilepath: string,\n  options: {\n    projectId?: string;\n    defaultLocale?: string;\n    locales?: string[];\n    src?: string[];\n    files?: FilesOptions;\n    framework?: SupportedFrameworks;\n    baseUrl?: string;\n    publish?: boolean;\n    /** Removes stale global CDN intent when the selected runtime forbids it. */\n    clearPublish?: boolean;\n  }\n): Promise<string> {\n  // Filter out empty string values from the config object\n  const newContent = {\n    ...(options.projectId && { projectId: options.projectId }),\n    ...(options.defaultLocale && { defaultLocale: options.defaultLocale }),\n    ...(options.src && { src: options.src }),\n    ...(options.files && { files: options.files }),\n    ...(options.framework && { framework: options.framework }),\n    ...(options.baseUrl && { baseUrl: options.baseUrl }),\n    ...(options.publish && { publish: options.publish }),\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      $schema: GT_CONFIG_SCHEMA_URL,\n      ...oldContent,\n      ...newContent,\n    } as Record<string, unknown> & { locales?: string[] };\n\n    if (options.clearPublish) {\n      delete mergedContent.publish;\n    }\n\n    // Preserve unrelated file configuration and nested GT options when setup\n    // only needs to add or update a translation output path.\n    if (options.files) {\n      const oldFiles =\n        oldContent.files && typeof oldContent.files === 'object'\n          ? (oldContent.files as Record<string, unknown>)\n          : {};\n      const oldGt =\n        oldFiles.gt && typeof oldFiles.gt === 'object'\n          ? (oldFiles.gt as Record<string, unknown>)\n          : {};\n      mergedContent.files = {\n        ...oldFiles,\n        ...options.files,\n        ...(options.files.gt && {\n          gt: { ...oldGt, ...options.files.gt },\n        }),\n      };\n    }\n\n    // Add locales to mergedContent if they exist\n    if (options.locales) {\n      mergedContent.locales = mergedContent.locales\n        ? [...new Set([...mergedContent.locales, ...options.locales])]\n        : options.locales;\n    }\n\n    // write to file\n    const mergedJsonContent = JSON.stringify(mergedContent, null, 2);\n    await fs.promises.writeFile(configFilepath, mergedJsonContent, 'utf-8');\n\n    // show update in console\n    displayCreatedConfigFile(configFilepath);\n  } catch (error) {\n    logger.error(\n      `An error occurred while updating ${configFilepath}: ${error}`\n    );\n  }\n  return configFilepath;\n}\n"],"mappings":";;;;;;;;;;;;AAaA,eAAsB,qBACpB,gBACA,SAYiB;CAEjB,MAAM,aAAa;EACjB,GAAI,QAAQ,aAAa,EAAE,WAAW,QAAQ,WAAW;EACzD,GAAI,QAAQ,iBAAiB,EAAE,eAAe,QAAQ,eAAe;EACrE,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,KAAK;EACvC,GAAI,QAAQ,SAAS,EAAE,OAAO,QAAQ,OAAO;EAC7C,GAAI,QAAQ,aAAa,EAAE,WAAW,QAAQ,WAAW;EACzD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;EACnD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;EACpD;AACD,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;;EAIV,MAAM,gBAAgB;GACpB,SAAS;GACT,GAAG;GACH,GAAG;GACJ;AAED,MAAI,QAAQ,aACV,QAAO,cAAc;AAKvB,MAAI,QAAQ,OAAO;GACjB,MAAM,WACJ,WAAW,SAAS,OAAO,WAAW,UAAU,WAC3C,WAAW,QACZ,EAAE;GACR,MAAM,QACJ,SAAS,MAAM,OAAO,SAAS,OAAO,WACjC,SAAS,KACV,EAAE;AACR,iBAAc,QAAQ;IACpB,GAAG;IACH,GAAG,QAAQ;IACX,GAAI,QAAQ,MAAM,MAAM,EACtB,IAAI;KAAE,GAAG;KAAO,GAAG,QAAQ,MAAM;KAAI,EACtC;IACF;;AAIH,MAAI,QAAQ,QACV,eAAc,UAAU,cAAc,UAClC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,cAAc,SAAS,GAAG,QAAQ,QAAQ,CAAC,CAAC,GAC5D,QAAQ;EAId,MAAM,oBAAoB,KAAK,UAAU,eAAe,MAAM,EAAE;AAChE,QAAM,GAAG,SAAS,UAAU,gBAAgB,mBAAmB,QAAQ;AAGvE,2BAAyB,eAAe;UACjC,OAAO;AACd,SAAO,MACL,oCAAoC,eAAe,IAAI,QACxD;;AAEH,QAAO"}
+{"version":3,"file":"setupConfig.js","names":[],"sources":["../../../src/fs/config/setupConfig.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { displayCreatedConfigFile } from '../../console/logging.js';\nimport { FilesOptions, SupportedFrameworks } from '../../types/index.js';\nimport {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n} from 'generaltranslation/internal';\nimport { GT_CONFIG_SCHEMA_URL } from '../../utils/constants.js';\n\nexport type SetupConfigUpdate = {\n  projectId?: string;\n  defaultLocale?: string;\n  locales?: string[];\n  src?: string[];\n  files?: FilesOptions;\n  framework?: SupportedFrameworks;\n  baseUrl?: string;\n  publish?: boolean;\n  /** Removes stale global CDN intent when the selected runtime forbids it. */\n  clearPublish?: boolean;\n  /** File format entries deselected by an explicit format list. */\n  removeFiles?: string[];\n  /** Drops files.gt.output after an explicit switch to CDN storage. */\n  clearGtOutput?: boolean;\n};\n\nfunction asObject(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\n/**\n * The config setup writes: the existing content with the update applied.\n * Unrelated fields and per-format options are kept; locales are replaced.\n */\nexport function mergeSetupConfig(\n  oldContent: Record<string, unknown>,\n  options: SetupConfigUpdate\n): Record<string, unknown> {\n  // Filter out empty string values from the config object\n  const newContent = {\n    ...(options.projectId && { projectId: options.projectId }),\n    ...(options.defaultLocale && { defaultLocale: options.defaultLocale }),\n    ...(options.src && { src: options.src }),\n    ...(options.framework && { framework: options.framework }),\n    ...(options.baseUrl && { baseUrl: options.baseUrl }),\n    ...(options.publish && { publish: options.publish }),\n  };\n  const mergedContent: Record<string, unknown> = {\n    $schema: GT_CONFIG_SCHEMA_URL,\n    ...oldContent,\n    ...newContent,\n  };\n\n  if (options.clearPublish) {\n    delete mergedContent.publish;\n  }\n\n  // Preserve unrelated file configuration and nested GT options when setup\n  // only needs to add or update a translation output path.\n  if (options.files || options.removeFiles?.length || options.clearGtOutput) {\n    const oldFiles = asObject(oldContent.files);\n    const files: Record<string, unknown> = { ...oldFiles, ...options.files };\n    const gt = { ...asObject(oldFiles.gt), ...options.files?.gt };\n    if (options.clearGtOutput) delete gt.output;\n    if (Object.keys(gt).length > 0) files.gt = gt;\n    else delete files.gt;\n    for (const format of options.removeFiles ?? []) delete files[format];\n    if (Object.keys(files).length > 0) mergedContent.files = files;\n    else delete mergedContent.files;\n  }\n\n  // The selected locale list replaces the configured one.\n  if (options.locales) {\n    mergedContent.locales = options.locales;\n  }\n  return mergedContent;\n}\n\n/**\n * Creates the config file, or applies the update to the existing one.\n * @param {string} configFilepath - The path to the config file.\n * @param {SetupConfigUpdate} options - The values setup resolved.\n * @throws When the existing file is not valid JSON or cannot be written.\n */\nexport async function createOrUpdateConfig(\n  configFilepath: string,\n  options: SetupConfigUpdate\n): Promise<string> {\n  try {\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      if (\n        typeof parsed !== 'object' ||\n        parsed === null ||\n        Array.isArray(parsed)\n      )\n        throw new Error('the file does not contain a JSON object');\n      oldContent = parsed as Record<string, unknown>;\n    }\n\n    const mergedJsonContent = JSON.stringify(\n      mergeSetupConfig(oldContent, options),\n      null,\n      2\n    );\n    await fs.promises.writeFile(configFilepath, mergedJsonContent, 'utf-8');\n\n    // show update in console\n    displayCreatedConfigFile(configFilepath);\n  } catch (error) {\n    throw new Error(\n      createDiagnosticMessage({\n        source: 'gt',\n        severity: 'Error',\n        whatHappened: `Could not update ${configFilepath}`,\n        details: formatDiagnosticErrorDetails(error),\n        fix: 'Fix or remove the file, then rerun the command',\n      })\n    );\n  }\n  return configFilepath;\n}\n"],"mappings":";;;;;AA0BA,SAAS,SAAS,OAAyC;AACzD,QAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,GAC7D,QACD,EAAE;;;;;;AAOR,SAAgB,iBACd,YACA,SACyB;CAEzB,MAAM,aAAa;EACjB,GAAI,QAAQ,aAAa,EAAE,WAAW,QAAQ,WAAW;EACzD,GAAI,QAAQ,iBAAiB,EAAE,eAAe,QAAQ,eAAe;EACrE,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,KAAK;EACvC,GAAI,QAAQ,aAAa,EAAE,WAAW,QAAQ,WAAW;EACzD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;EACnD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;EACpD;CACD,MAAM,gBAAyC;EAC7C,SAAS;EACT,GAAG;EACH,GAAG;EACJ;AAED,KAAI,QAAQ,aACV,QAAO,cAAc;AAKvB,KAAI,QAAQ,SAAS,QAAQ,aAAa,UAAU,QAAQ,eAAe;EACzE,MAAM,WAAW,SAAS,WAAW,MAAM;EAC3C,MAAM,QAAiC;GAAE,GAAG;GAAU,GAAG,QAAQ;GAAO;EACxE,MAAM,KAAK;GAAE,GAAG,SAAS,SAAS,GAAG;GAAE,GAAG,QAAQ,OAAO;GAAI;AAC7D,MAAI,QAAQ,cAAe,QAAO,GAAG;AACrC,MAAI,OAAO,KAAK,GAAG,CAAC,SAAS,EAAG,OAAM,KAAK;MACtC,QAAO,MAAM;AAClB,OAAK,MAAM,UAAU,QAAQ,eAAe,EAAE,CAAE,QAAO,MAAM;AAC7D,MAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAG,eAAc,QAAQ;MACpD,QAAO,cAAc;;AAI5B,KAAI,QAAQ,QACV,eAAc,UAAU,QAAQ;AAElC,QAAO;;;;;;;;AAST,eAAsB,qBACpB,gBACA,SACiB;AACjB,KAAI;EACF,IAAI,aAAsC,EAAE;AAC5C,MAAI,GAAG,WAAW,eAAe,EAAE;GACjC,MAAM,SAAS,KAAK,MAClB,MAAM,GAAG,SAAS,SAAS,gBAAgB,QAAQ,CACpD;AACD,OACE,OAAO,WAAW,YAClB,WAAW,QACX,MAAM,QAAQ,OAAO,CAErB,OAAM,IAAI,MAAM,0CAA0C;AAC5D,gBAAa;;EAGf,MAAM,oBAAoB,KAAK,UAC7B,iBAAiB,YAAY,QAAQ,EACrC,MACA,EACD;AACD,QAAM,GAAG,SAAS,UAAU,gBAAgB,mBAAmB,QAAQ;AAGvE,2BAAyB,eAAe;UACjC,OAAO;AACd,QAAM,IAAI,MACR,wBAAwB;GACtB,QAAQ;GACR,UAAU;GACV,cAAc,oBAAoB;GAClC,SAAS,6BAA6B,MAAM;GAC5C,KAAK;GACN,CAAC,CACH;;AAEH,QAAO"}

package/dist/fs/createLoadTranslationsFile.d.ts

@@ -1 +1,22 @@
-export declare function createLoadTranslationsFile(appDirectory: string, translationsDir: string | undefined, locales: string[]): Promise<void>;
+/**
+ * Every loadTranslations file the app has, in gt-next's lookup order
+ * (resolveConfigFilepath): root before src, .ts before .js. gt-next uses the
+ * first one, and falls back to the next when it is deleted.
+ */
+export declare function findLoadTranslationsFiles(appDirectory: string): string[];
+export type LoadTranslationsFileResult = 'created' | 'updated' | 'unchanged' | 'custom';
+/**
+ * Creates or updates the generated loadTranslations.js for translationsDir
+ * (relative to appDirectory) and empty stubs for non-default locales. A
+ * loader that was not matching the previous config's generated template, or
+ * another loadTranslations file the app uses instead, is left untouched and
+ * reported as 'custom'.
+ * Directory and stub failures propagate.
+ */
+export declare function createLoadTranslationsFile({ appDirectory, translationsDir, defaultLocale, locales, previousTranslationsDir, }: {
+    appDirectory: string;
+    translationsDir?: string;
+    defaultLocale: string;
+    locales: string[];
+    previousTranslationsDir?: string;
+}): Promise<LoadTranslationsFileResult>;

package/dist/fs/createLoadTranslationsFile.js

@@ -9,13 +9,8 @@ function toRelativeImportPath(relativePath) {
 	if (!normalizedPath) return "./";
 	return normalizedPath === ".." || normalizedPath.startsWith("../") || normalizedPath.startsWith("./") ? `${normalizedPath}/` : `./${normalizedPath}/`;
 }
-async function createLoadTranslationsFile(appDirectory, translationsDir = DEFAULT_TRANSLATIONS_DIR, locales) {
-	const usingSrcDirectory = fs.existsSync(path.join(appDirectory, "src"));
-	const loadTranslationsDir = usingSrcDirectory ? path.join(appDirectory, "src") : appDirectory;
-	const publicPath = toRelativeImportPath(path.relative(loadTranslationsDir, path.resolve(appDirectory, translationsDir)));
-	const filePath = usingSrcDirectory ? path.join(appDirectory, "src", "loadTranslations.js") : path.join(appDirectory, "loadTranslations.js");
-	if (!fs.existsSync(filePath)) {
-		const loadTranslationsContent = `
+function getLoaderContent(translationsDir, publicPath) {
+	return `
 export default async function loadTranslations(locale) {
   try {
     // Load translations from ${translationsDir} directory
@@ -28,20 +23,48 @@ export default async function loadTranslations(locale) {
   }
 }
 `;
-		await fs.promises.writeFile(filePath, loadTranslationsContent);
-		logger.info(`Created ${chalk.cyan("loadTranslations.js")} file at ${chalk.cyan(filePath)}.`);
-		try {
-			await fs.promises.mkdir(translationsDir, { recursive: true });
-			for (const locale of locales) {
-				if (fs.existsSync(path.join(translationsDir, `${locale}.json`))) continue;
-				await fs.promises.writeFile(path.join(translationsDir, `${locale}.json`), "{}");
-			}
-		} catch (error) {
-			logger.error(`Failed to create translations directory: ${error}`);
-		}
-	} else logger.info(`Found ${chalk.cyan("loadTranslations.js")} file at ${chalk.cyan(filePath)}. Skipping creation...`);
+}
+/**
+* Every loadTranslations file the app has, in gt-next's lookup order
+* (resolveConfigFilepath): root before src, .ts before .js. gt-next uses the
+* first one, and falls back to the next when it is deleted.
+*/
+function findLoadTranslationsFiles(appDirectory) {
+	return ["", "src"].flatMap((directory) => [".ts", ".js"].map((extension) => path.join(appDirectory, directory, `loadTranslations${extension}`))).filter((candidate) => fs.existsSync(candidate));
+}
+/**
+* Creates or updates the generated loadTranslations.js for translationsDir
+* (relative to appDirectory) and empty stubs for non-default locales. A
+* loader that was not matching the previous config's generated template, or
+* another loadTranslations file the app uses instead, is left untouched and
+* reported as 'custom'.
+* Directory and stub failures propagate.
+*/
+async function createLoadTranslationsFile({ appDirectory, translationsDir = DEFAULT_TRANSLATIONS_DIR, defaultLocale, locales, previousTranslationsDir }) {
+	const loadTranslationsDir = fs.existsSync(path.join(appDirectory, "src")) ? path.join(appDirectory, "src") : appDirectory;
+	const translationsPath = path.resolve(appDirectory, translationsDir);
+	const publicPath = toRelativeImportPath(path.relative(loadTranslationsDir, translationsPath));
+	const filePath = path.join(loadTranslationsDir, "loadTranslations.js");
+	const content = getLoaderContent(translationsDir, publicPath);
+	const previousContents = previousTranslationsDir === void 0 ? [] : [previousTranslationsDir, ...!path.isAbsolute(previousTranslationsDir) ? [`./${previousTranslationsDir}`] : []].flatMap((directory) => [directory, `${directory}/`]).map((directory) => getLoaderContent(directory, toRelativeImportPath(path.relative(loadTranslationsDir, path.resolve(appDirectory, previousTranslationsDir)))));
+	const [loaderPath] = findLoadTranslationsFiles(appDirectory);
+	const existing = loaderPath === filePath ? await fs.promises.readFile(filePath, "utf8") : void 0;
+	await fs.promises.mkdir(translationsPath, { recursive: true });
+	for (const locale of new Set(locales)) {
+		if (locale === defaultLocale) continue;
+		const stubPath = path.join(translationsPath, `${locale}.json`);
+		if (!fs.existsSync(stubPath)) await fs.promises.writeFile(stubPath, "{}");
+	}
+	if (loaderPath !== void 0 && loaderPath !== filePath || existing !== void 0 && existing !== content && !previousContents.includes(existing)) {
+		logger.info(`Found a custom ${chalk.cyan(path.basename(loaderPath ?? filePath))} at ${chalk.cyan(loaderPath ?? filePath)}; leaving it unchanged.`);
+		return "custom";
+	}
+	if (existing === content) return "unchanged";
+	await fs.promises.writeFile(filePath, content);
+	logger.info(`${existing === void 0 ? "Created" : "Updated"} ${chalk.cyan("loadTranslations.js")} at ${chalk.cyan(filePath)}.`);
+	return existing === void 0 ? "created" : "updated";
 }
 //#endregion
-export { createLoadTranslationsFile };
+export { createLoadTranslationsFile, findLoadTranslationsFiles };
 
 //# sourceMappingURL=createLoadTranslationsFile.js.map

package/dist/fs/createLoadTranslationsFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLoadTranslationsFile.js","names":[],"sources":["../../src/fs/createLoadTranslationsFile.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { logger } from '../console/logger.js';\nimport chalk from 'chalk';\nimport { DEFAULT_TRANSLATIONS_DIR } from '../utils/constants.js';\n\nfunction toRelativeImportPath(relativePath: string) {\n  const normalizedPath = relativePath.split(path.sep).join(path.posix.sep);\n\n  if (!normalizedPath) {\n    return './';\n  }\n\n  // Dynamic imports must use explicit relative specifiers; values like\n  // \"src/_gt\" are otherwise treated as package names by Vite and Node.\n  const hasExplicitRelativePrefix =\n    normalizedPath === '..' ||\n    normalizedPath.startsWith('../') ||\n    normalizedPath.startsWith('./');\n\n  return hasExplicitRelativePrefix\n    ? `${normalizedPath}/`\n    : `./${normalizedPath}/`;\n}\n\nexport async function createLoadTranslationsFile(\n  appDirectory: string,\n  translationsDir: string = DEFAULT_TRANSLATIONS_DIR,\n  locales: string[]\n) {\n  const usingSrcDirectory = fs.existsSync(path.join(appDirectory, 'src'));\n\n  const loadTranslationsDir = usingSrcDirectory\n    ? path.join(appDirectory, 'src')\n    : appDirectory;\n  const relativePath = path.relative(\n    loadTranslationsDir,\n    path.resolve(appDirectory, translationsDir)\n  );\n  const publicPath = toRelativeImportPath(relativePath);\n\n  const filePath = usingSrcDirectory\n    ? path.join(appDirectory, 'src', 'loadTranslations.js')\n    : path.join(appDirectory, 'loadTranslations.js');\n\n  if (!fs.existsSync(filePath)) {\n    const loadTranslationsContent = `\nexport default async function loadTranslations(locale) {\n  try {\n    // Load translations from ${translationsDir} directory\n    // This matches the GT config files.gt.output path\n    const t = await import(\\`${publicPath}\\${locale}.json\\`);\n    return t.default;\n  } catch (error) {\n    console.warn(\\`Failed to load translations for locale \\${locale}:\\`, error);\n    return {};\n  }\n}\n`;\n    await fs.promises.writeFile(filePath, loadTranslationsContent);\n    logger.info(\n      `Created ${chalk.cyan(\n        'loadTranslations.js'\n      )} file at ${chalk.cyan(filePath)}.`\n    );\n    try {\n      await fs.promises.mkdir(translationsDir, { recursive: true });\n      // Create empty JSON files\n      for (const locale of locales) {\n        if (fs.existsSync(path.join(translationsDir, `${locale}.json`))) {\n          continue;\n        }\n        await fs.promises.writeFile(\n          path.join(translationsDir, `${locale}.json`),\n          '{}'\n        );\n      }\n    } catch (error) {\n      logger.error(`Failed to create translations directory: ${error}`);\n    }\n  } else {\n    logger.info(\n      `Found ${chalk.cyan('loadTranslations.js')} file at ${chalk.cyan(\n        filePath\n      )}. Skipping creation...`\n    );\n  }\n}\n"],"mappings":";;;;;;AAMA,SAAS,qBAAqB,cAAsB;CAClD,MAAM,iBAAiB,aAAa,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI;AAExE,KAAI,CAAC,eACH,QAAO;AAUT,QAJE,mBAAmB,QACnB,eAAe,WAAW,MAAM,IAChC,eAAe,WAAW,KAAK,GAG7B,GAAG,eAAe,KAClB,KAAK,eAAe;;AAG1B,eAAsB,2BACpB,cACA,kBAA0B,0BAC1B,SACA;CACA,MAAM,oBAAoB,GAAG,WAAW,KAAK,KAAK,cAAc,MAAM,CAAC;CAEvE,MAAM,sBAAsB,oBACxB,KAAK,KAAK,cAAc,MAAM,GAC9B;CAKJ,MAAM,aAAa,qBAJE,KAAK,SACxB,qBACA,KAAK,QAAQ,cAAc,gBAAgB,CAEO,CAAC;CAErD,MAAM,WAAW,oBACb,KAAK,KAAK,cAAc,OAAO,sBAAsB,GACrD,KAAK,KAAK,cAAc,sBAAsB;AAElD,KAAI,CAAC,GAAG,WAAW,SAAS,EAAE;EAC5B,MAAM,0BAA0B;;;gCAGJ,gBAAgB;;+BAEjB,WAAW;;;;;;;;AAQtC,QAAM,GAAG,SAAS,UAAU,UAAU,wBAAwB;AAC9D,SAAO,KACL,WAAW,MAAM,KACf,sBACD,CAAC,WAAW,MAAM,KAAK,SAAS,CAAC,GACnC;AACD,MAAI;AACF,SAAM,GAAG,SAAS,MAAM,iBAAiB,EAAE,WAAW,MAAM,CAAC;AAE7D,QAAK,MAAM,UAAU,SAAS;AAC5B,QAAI,GAAG,WAAW,KAAK,KAAK,iBAAiB,GAAG,OAAO,OAAO,CAAC,CAC7D;AAEF,UAAM,GAAG,SAAS,UAChB,KAAK,KAAK,iBAAiB,GAAG,OAAO,OAAO,EAC5C,KACD;;WAEI,OAAO;AACd,UAAO,MAAM,4CAA4C,QAAQ;;OAGnE,QAAO,KACL,SAAS,MAAM,KAAK,sBAAsB,CAAC,WAAW,MAAM,KAC1D,SACD,CAAC,wBACH"}
+{"version":3,"file":"createLoadTranslationsFile.js","names":[],"sources":["../../src/fs/createLoadTranslationsFile.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { logger } from '../console/logger.js';\nimport chalk from 'chalk';\nimport { DEFAULT_TRANSLATIONS_DIR } from '../utils/constants.js';\n\nfunction toRelativeImportPath(relativePath: string) {\n  const normalizedPath = relativePath.split(path.sep).join(path.posix.sep);\n\n  if (!normalizedPath) {\n    return './';\n  }\n\n  // Dynamic imports must use explicit relative specifiers; values like\n  // \"src/_gt\" are otherwise treated as package names by Vite and Node.\n  const hasExplicitRelativePrefix =\n    normalizedPath === '..' ||\n    normalizedPath.startsWith('../') ||\n    normalizedPath.startsWith('./');\n\n  return hasExplicitRelativePrefix\n    ? `${normalizedPath}/`\n    : `./${normalizedPath}/`;\n}\n\nfunction getLoaderContent(translationsDir: string, publicPath: string) {\n  return `\nexport default async function loadTranslations(locale) {\n  try {\n    // Load translations from ${translationsDir} directory\n    // This matches the GT config files.gt.output path\n    const t = await import(\\`${publicPath}\\${locale}.json\\`);\n    return t.default;\n  } catch (error) {\n    console.warn(\\`Failed to load translations for locale \\${locale}:\\`, error);\n    return {};\n  }\n}\n`;\n}\n\n/**\n * Every loadTranslations file the app has, in gt-next's lookup order\n * (resolveConfigFilepath): root before src, .ts before .js. gt-next uses the\n * first one, and falls back to the next when it is deleted.\n */\nexport function findLoadTranslationsFiles(appDirectory: string): string[] {\n  return ['', 'src']\n    .flatMap((directory) =>\n      ['.ts', '.js'].map((extension) =>\n        path.join(appDirectory, directory, `loadTranslations${extension}`)\n      )\n    )\n    .filter((candidate) => fs.existsSync(candidate));\n}\n\nexport type LoadTranslationsFileResult =\n  | 'created'\n  | 'updated'\n  | 'unchanged'\n  | 'custom';\n\n/**\n * Creates or updates the generated loadTranslations.js for translationsDir\n * (relative to appDirectory) and empty stubs for non-default locales. A\n * loader that was not matching the previous config's generated template, or\n * another loadTranslations file the app uses instead, is left untouched and\n * reported as 'custom'.\n * Directory and stub failures propagate.\n */\nexport async function createLoadTranslationsFile({\n  appDirectory,\n  translationsDir = DEFAULT_TRANSLATIONS_DIR,\n  defaultLocale,\n  locales,\n  previousTranslationsDir,\n}: {\n  appDirectory: string;\n  translationsDir?: string;\n  defaultLocale: string;\n  locales: string[];\n  previousTranslationsDir?: string;\n}): Promise<LoadTranslationsFileResult> {\n  const usingSrcDirectory = fs.existsSync(path.join(appDirectory, 'src'));\n\n  const loadTranslationsDir = usingSrcDirectory\n    ? path.join(appDirectory, 'src')\n    : appDirectory;\n  const translationsPath = path.resolve(appDirectory, translationsDir);\n  const publicPath = toRelativeImportPath(\n    path.relative(loadTranslationsDir, translationsPath)\n  );\n  const filePath = path.join(loadTranslationsDir, 'loadTranslations.js');\n  const content = getLoaderContent(translationsDir, publicPath);\n  // Config paths lose leading ./ and trailing / through path.join, but\n  // legacy generated comments retain them. Keep the import and body exact.\n  const previousContents =\n    previousTranslationsDir === undefined\n      ? []\n      : [\n          previousTranslationsDir,\n          ...(!path.isAbsolute(previousTranslationsDir)\n            ? [`./${previousTranslationsDir}`]\n            : []),\n        ]\n          .flatMap((directory) => [directory, `${directory}/`])\n          .map((directory) =>\n            getLoaderContent(\n              directory,\n              toRelativeImportPath(\n                path.relative(\n                  loadTranslationsDir,\n                  path.resolve(appDirectory, previousTranslationsDir)\n                )\n              )\n            )\n          );\n\n  const [loaderPath] = findLoadTranslationsFiles(appDirectory);\n  const existing =\n    loaderPath === filePath\n      ? await fs.promises.readFile(filePath, 'utf8')\n      : undefined;\n  // Stubs first, so a directory failure leaves no loader pointing at it; a\n  // custom loader also gets them, like the Vite loader.\n  await fs.promises.mkdir(translationsPath, { recursive: true });\n  for (const locale of new Set(locales)) {\n    // Default-locale content lives in source, so it never needs a stub.\n    if (locale === defaultLocale) continue;\n    const stubPath = path.join(translationsPath, `${locale}.json`);\n    if (!fs.existsSync(stubPath)) await fs.promises.writeFile(stubPath, '{}');\n  }\n  // Another loader wins over the generated one, so writing it would not help.\n  if (\n    (loaderPath !== undefined && loaderPath !== filePath) ||\n    (existing !== undefined &&\n      existing !== content &&\n      !previousContents.includes(existing))\n  ) {\n    logger.info(\n      `Found a custom ${chalk.cyan(\n        path.basename(loaderPath ?? filePath)\n      )} at ${chalk.cyan(loaderPath ?? filePath)}; leaving it unchanged.`\n    );\n    return 'custom';\n  }\n\n  if (existing === content) return 'unchanged';\n  await fs.promises.writeFile(filePath, content);\n  logger.info(\n    `${existing === undefined ? 'Created' : 'Updated'} ${chalk.cyan(\n      'loadTranslations.js'\n    )} at ${chalk.cyan(filePath)}.`\n  );\n  return existing === undefined ? 'created' : 'updated';\n}\n"],"mappings":";;;;;;AAMA,SAAS,qBAAqB,cAAsB;CAClD,MAAM,iBAAiB,aAAa,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI;AAExE,KAAI,CAAC,eACH,QAAO;AAUT,QAJE,mBAAmB,QACnB,eAAe,WAAW,MAAM,IAChC,eAAe,WAAW,KAAK,GAG7B,GAAG,eAAe,KAClB,KAAK,eAAe;;AAG1B,SAAS,iBAAiB,iBAAyB,YAAoB;AACrE,QAAO;;;gCAGuB,gBAAgB;;+BAEjB,WAAW;;;;;;;;;;;;;;AAe1C,SAAgB,0BAA0B,cAAgC;AACxE,QAAO,CAAC,IAAI,MAAM,CACf,SAAS,cACR,CAAC,OAAO,MAAM,CAAC,KAAK,cAClB,KAAK,KAAK,cAAc,WAAW,mBAAmB,YAAY,CACnE,CACF,CACA,QAAQ,cAAc,GAAG,WAAW,UAAU,CAAC;;;;;;;;;;AAiBpD,eAAsB,2BAA2B,EAC/C,cACA,kBAAkB,0BAClB,eACA,SACA,2BAOsC;CAGtC,MAAM,sBAFoB,GAAG,WAAW,KAAK,KAAK,cAAc,MAAM,CAEzB,GACzC,KAAK,KAAK,cAAc,MAAM,GAC9B;CACJ,MAAM,mBAAmB,KAAK,QAAQ,cAAc,gBAAgB;CACpE,MAAM,aAAa,qBACjB,KAAK,SAAS,qBAAqB,iBAAiB,CACrD;CACD,MAAM,WAAW,KAAK,KAAK,qBAAqB,sBAAsB;CACtE,MAAM,UAAU,iBAAiB,iBAAiB,WAAW;CAG7D,MAAM,mBACJ,4BAA4B,KAAA,IACxB,EAAE,GACF,CACE,yBACA,GAAI,CAAC,KAAK,WAAW,wBAAwB,GACzC,CAAC,KAAK,0BAA0B,GAChC,EAAE,CACP,CACE,SAAS,cAAc,CAAC,WAAW,GAAG,UAAU,GAAG,CAAC,CACpD,KAAK,cACJ,iBACE,WACA,qBACE,KAAK,SACH,qBACA,KAAK,QAAQ,cAAc,wBAAwB,CACpD,CACF,CACF,CACF;CAET,MAAM,CAAC,cAAc,0BAA0B,aAAa;CAC5D,MAAM,WACJ,eAAe,WACX,MAAM,GAAG,SAAS,SAAS,UAAU,OAAO,GAC5C,KAAA;AAGN,OAAM,GAAG,SAAS,MAAM,kBAAkB,EAAE,WAAW,MAAM,CAAC;AAC9D,MAAK,MAAM,UAAU,IAAI,IAAI,QAAQ,EAAE;AAErC,MAAI,WAAW,cAAe;EAC9B,MAAM,WAAW,KAAK,KAAK,kBAAkB,GAAG,OAAO,OAAO;AAC9D,MAAI,CAAC,GAAG,WAAW,SAAS,CAAE,OAAM,GAAG,SAAS,UAAU,UAAU,KAAK;;AAG3E,KACG,eAAe,KAAA,KAAa,eAAe,YAC3C,aAAa,KAAA,KACZ,aAAa,WACb,CAAC,iBAAiB,SAAS,SAAS,EACtC;AACA,SAAO,KACL,kBAAkB,MAAM,KACtB,KAAK,SAAS,cAAc,SAAS,CACtC,CAAC,MAAM,MAAM,KAAK,cAAc,SAAS,CAAC,yBAC5C;AACD,SAAO;;AAGT,KAAI,aAAa,QAAS,QAAO;AACjC,OAAM,GAAG,SAAS,UAAU,UAAU,QAAQ;AAC9C,QAAO,KACL,GAAG,aAAa,KAAA,IAAY,YAAY,UAAU,GAAG,MAAM,KACzD,sBACD,CAAC,MAAM,MAAM,KAAK,SAAS,CAAC,GAC9B;AACD,QAAO,aAAa,KAAA,IAAY,YAAY"}

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.22.4";
+export declare const PACKAGE_VERSION = "2.23.0";

package/dist/generated/version.js

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

package/dist/hooks/postProcess.d.ts

@@ -1,4 +1,3 @@
-type Formatter = 'prettier' | 'biome' | 'eslint';
+export type Formatter = 'prettier' | 'biome' | 'eslint';
 export declare function detectFormatter(): Promise<Formatter | null>;
 export declare function formatFiles(filesUpdated: string[], formatter?: Formatter): Promise<void>;
-export {};

package/dist/hooks/postProcess.js

@@ -59,7 +59,7 @@ async function formatFiles(filesUpdated, formatter) {
 						...filesUpdated.map((file) => file)
 					], { stdio: [
 						"ignore",
-						"inherit",
+						process.stderr,
 						"inherit"
 					] });
 					child.on("error", (error) => {

package/dist/hooks/postProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"postProcess.js","names":[],"sources":["../../src/hooks/postProcess.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\nimport { logger } from '../console/logger.js';\n\ntype Formatter = 'prettier' | 'biome' | 'eslint';\n\nexport async function detectFormatter(): Promise<Formatter | null> {\n  // Try Prettier\n  try {\n    await import('prettier');\n    return 'prettier';\n  } catch {\n    // Prettier is optional.\n  }\n\n  // Try ESLint\n  try {\n    await import('eslint');\n    return 'eslint';\n  } catch {\n    // ESLint is optional.\n  }\n\n  // Try Biome\n  try {\n    return await new Promise<Formatter | null>((resolve) => {\n      const child = spawn('npx', ['@biomejs/biome', '--version'], {\n        stdio: 'ignore',\n      });\n\n      child.on('error', () => {\n        resolve(null);\n      });\n\n      child.on('close', (code: number) => {\n        if (code === 0) {\n          resolve('biome');\n        } else {\n          resolve(null);\n        }\n      });\n    });\n  } catch {\n    // Biome is optional.\n  }\n\n  return null;\n}\n\nexport async function formatFiles(\n  filesUpdated: string[],\n  formatter?: Formatter\n): Promise<void> {\n  if (filesUpdated.length === 0) return;\n\n  try {\n    const detectedFormatter = formatter || (await detectFormatter());\n\n    if (!detectedFormatter) {\n      logger.warn(chalk.yellow('No supported formatter detected'));\n      return;\n    }\n\n    if (detectedFormatter === 'prettier') {\n      logger.message(chalk.dim('Cleaning up with prettier...'));\n      const prettier = await import('prettier');\n      for (const file of filesUpdated) {\n        const config = await prettier.resolveConfig(file);\n        const content = await fs.promises.readFile(file, 'utf-8');\n        const formatted = await prettier.format(content, {\n          ...config,\n          filepath: file,\n        });\n        await fs.promises.writeFile(file, formatted);\n      }\n      return;\n    }\n\n    if (detectedFormatter === 'biome') {\n      logger.message(chalk.dim('Cleaning up with biome...'));\n      try {\n        await new Promise<void>((resolve) => {\n          const args = [\n            '@biomejs/biome',\n            'format',\n            '--write',\n            ...filesUpdated.map((file) => file),\n          ];\n\n          const child = spawn('npx', args, {\n            stdio: ['ignore', 'inherit', 'inherit'],\n          });\n\n          child.on('error', (error: Error) => {\n            logger.warn(\n              chalk.yellow('Biome formatting failed: ' + error.message)\n            );\n            resolve();\n          });\n\n          child.on('close', (code: number) => {\n            if (code !== 0) {\n              logger.warn(\n                chalk.yellow(`Biome formatting failed with exit code ${code}`)\n              );\n            }\n            resolve();\n          });\n        });\n      } catch (error) {\n        logger.warn(chalk.yellow('Biome formatting failed: ' + String(error)));\n      }\n      return;\n    }\n\n    if (detectedFormatter === 'eslint') {\n      logger.message(chalk.dim('Cleaning up with eslint...'));\n      const { ESLint } = await import('eslint');\n      const eslint = new ESLint({\n        fix: true,\n        overrideConfigFile: undefined, // Will use project's .eslintrc\n      });\n      for (const file of filesUpdated) {\n        const results = await eslint.lintFiles([file]);\n        await ESLint.outputFixes(results);\n      }\n      return;\n    }\n  } catch (e) {\n    logger.warn(chalk.yellow('Unable to run code formatter: ' + String(e)));\n  }\n}\n"],"mappings":";;;;;AAOA,eAAsB,kBAA6C;AAEjE,KAAI;AACF,QAAM,OAAO;AACb,SAAO;SACD;AAKR,KAAI;AACF,QAAM,OAAO;AACb,SAAO;SACD;AAKR,KAAI;AACF,SAAO,MAAM,IAAI,SAA2B,YAAY;GACtD,MAAM,QAAQ,MAAM,OAAO,CAAC,kBAAkB,YAAY,EAAE,EAC1D,OAAO,UACR,CAAC;AAEF,SAAM,GAAG,eAAe;AACtB,YAAQ,KAAK;KACb;AAEF,SAAM,GAAG,UAAU,SAAiB;AAClC,QAAI,SAAS,EACX,SAAQ,QAAQ;QAEhB,SAAQ,KAAK;KAEf;IACF;SACI;AAIR,QAAO;;AAGT,eAAsB,YACpB,cACA,WACe;AACf,KAAI,aAAa,WAAW,EAAG;AAE/B,KAAI;EACF,MAAM,oBAAoB,aAAc,MAAM,iBAAiB;AAE/D,MAAI,CAAC,mBAAmB;AACtB,UAAO,KAAK,MAAM,OAAO,kCAAkC,CAAC;AAC5D;;AAGF,MAAI,sBAAsB,YAAY;AACpC,UAAO,QAAQ,MAAM,IAAI,+BAA+B,CAAC;GACzD,MAAM,WAAW,MAAM,OAAO;AAC9B,QAAK,MAAM,QAAQ,cAAc;IAC/B,MAAM,SAAS,MAAM,SAAS,cAAc,KAAK;IACjD,MAAM,UAAU,MAAM,GAAG,SAAS,SAAS,MAAM,QAAQ;IACzD,MAAM,YAAY,MAAM,SAAS,OAAO,SAAS;KAC/C,GAAG;KACH,UAAU;KACX,CAAC;AACF,UAAM,GAAG,SAAS,UAAU,MAAM,UAAU;;AAE9C;;AAGF,MAAI,sBAAsB,SAAS;AACjC,UAAO,QAAQ,MAAM,IAAI,4BAA4B,CAAC;AACtD,OAAI;AACF,UAAM,IAAI,SAAe,YAAY;KAQnC,MAAM,QAAQ,MAAM,OAAO;MANzB;MACA;MACA;MACA,GAAG,aAAa,KAAK,SAAS,KAAK;MAGN,EAAE,EAC/B,OAAO;MAAC;MAAU;MAAW;MAAU,EACxC,CAAC;AAEF,WAAM,GAAG,UAAU,UAAiB;AAClC,aAAO,KACL,MAAM,OAAO,8BAA8B,MAAM,QAAQ,CAC1D;AACD,eAAS;OACT;AAEF,WAAM,GAAG,UAAU,SAAiB;AAClC,UAAI,SAAS,EACX,QAAO,KACL,MAAM,OAAO,0CAA0C,OAAO,CAC/D;AAEH,eAAS;OACT;MACF;YACK,OAAO;AACd,WAAO,KAAK,MAAM,OAAO,8BAA8B,OAAO,MAAM,CAAC,CAAC;;AAExE;;AAGF,MAAI,sBAAsB,UAAU;AAClC,UAAO,QAAQ,MAAM,IAAI,6BAA6B,CAAC;GACvD,MAAM,EAAE,WAAW,MAAM,OAAO;GAChC,MAAM,SAAS,IAAI,OAAO;IACxB,KAAK;IACL,oBAAoB,KAAA;IACrB,CAAC;AACF,QAAK,MAAM,QAAQ,cAAc;IAC/B,MAAM,UAAU,MAAM,OAAO,UAAU,CAAC,KAAK,CAAC;AAC9C,UAAM,OAAO,YAAY,QAAQ;;AAEnC;;UAEK,GAAG;AACV,SAAO,KAAK,MAAM,OAAO,mCAAmC,OAAO,EAAE,CAAC,CAAC"}
+{"version":3,"file":"postProcess.js","names":[],"sources":["../../src/hooks/postProcess.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { spawn } from 'node:child_process';\nimport chalk from 'chalk';\nimport { logger } from '../console/logger.js';\n\nexport type Formatter = 'prettier' | 'biome' | 'eslint';\n\nexport async function detectFormatter(): Promise<Formatter | null> {\n  // Try Prettier\n  try {\n    await import('prettier');\n    return 'prettier';\n  } catch {\n    // Prettier is optional.\n  }\n\n  // Try ESLint\n  try {\n    await import('eslint');\n    return 'eslint';\n  } catch {\n    // ESLint is optional.\n  }\n\n  // Try Biome\n  try {\n    return await new Promise<Formatter | null>((resolve) => {\n      const child = spawn('npx', ['@biomejs/biome', '--version'], {\n        stdio: 'ignore',\n      });\n\n      child.on('error', () => {\n        resolve(null);\n      });\n\n      child.on('close', (code: number) => {\n        if (code === 0) {\n          resolve('biome');\n        } else {\n          resolve(null);\n        }\n      });\n    });\n  } catch {\n    // Biome is optional.\n  }\n\n  return null;\n}\n\nexport async function formatFiles(\n  filesUpdated: string[],\n  formatter?: Formatter\n): Promise<void> {\n  if (filesUpdated.length === 0) return;\n\n  try {\n    const detectedFormatter = formatter || (await detectFormatter());\n\n    if (!detectedFormatter) {\n      logger.warn(chalk.yellow('No supported formatter detected'));\n      return;\n    }\n\n    if (detectedFormatter === 'prettier') {\n      logger.message(chalk.dim('Cleaning up with prettier...'));\n      const prettier = await import('prettier');\n      for (const file of filesUpdated) {\n        const config = await prettier.resolveConfig(file);\n        const content = await fs.promises.readFile(file, 'utf-8');\n        const formatted = await prettier.format(content, {\n          ...config,\n          filepath: file,\n        });\n        await fs.promises.writeFile(file, formatted);\n      }\n      return;\n    }\n\n    if (detectedFormatter === 'biome') {\n      logger.message(chalk.dim('Cleaning up with biome...'));\n      try {\n        await new Promise<void>((resolve) => {\n          const args = [\n            '@biomejs/biome',\n            'format',\n            '--write',\n            ...filesUpdated.map((file) => file),\n          ];\n\n          // Formatter output is diagnostics; keep stdout free for commands' data.\n          const child = spawn('npx', args, {\n            stdio: ['ignore', process.stderr, 'inherit'],\n          });\n\n          child.on('error', (error: Error) => {\n            logger.warn(\n              chalk.yellow('Biome formatting failed: ' + error.message)\n            );\n            resolve();\n          });\n\n          child.on('close', (code: number) => {\n            if (code !== 0) {\n              logger.warn(\n                chalk.yellow(`Biome formatting failed with exit code ${code}`)\n              );\n            }\n            resolve();\n          });\n        });\n      } catch (error) {\n        logger.warn(chalk.yellow('Biome formatting failed: ' + String(error)));\n      }\n      return;\n    }\n\n    if (detectedFormatter === 'eslint') {\n      logger.message(chalk.dim('Cleaning up with eslint...'));\n      const { ESLint } = await import('eslint');\n      const eslint = new ESLint({\n        fix: true,\n        overrideConfigFile: undefined, // Will use project's .eslintrc\n      });\n      for (const file of filesUpdated) {\n        const results = await eslint.lintFiles([file]);\n        await ESLint.outputFixes(results);\n      }\n      return;\n    }\n  } catch (e) {\n    logger.warn(chalk.yellow('Unable to run code formatter: ' + String(e)));\n  }\n}\n"],"mappings":";;;;;AAOA,eAAsB,kBAA6C;AAEjE,KAAI;AACF,QAAM,OAAO;AACb,SAAO;SACD;AAKR,KAAI;AACF,QAAM,OAAO;AACb,SAAO;SACD;AAKR,KAAI;AACF,SAAO,MAAM,IAAI,SAA2B,YAAY;GACtD,MAAM,QAAQ,MAAM,OAAO,CAAC,kBAAkB,YAAY,EAAE,EAC1D,OAAO,UACR,CAAC;AAEF,SAAM,GAAG,eAAe;AACtB,YAAQ,KAAK;KACb;AAEF,SAAM,GAAG,UAAU,SAAiB;AAClC,QAAI,SAAS,EACX,SAAQ,QAAQ;QAEhB,SAAQ,KAAK;KAEf;IACF;SACI;AAIR,QAAO;;AAGT,eAAsB,YACpB,cACA,WACe;AACf,KAAI,aAAa,WAAW,EAAG;AAE/B,KAAI;EACF,MAAM,oBAAoB,aAAc,MAAM,iBAAiB;AAE/D,MAAI,CAAC,mBAAmB;AACtB,UAAO,KAAK,MAAM,OAAO,kCAAkC,CAAC;AAC5D;;AAGF,MAAI,sBAAsB,YAAY;AACpC,UAAO,QAAQ,MAAM,IAAI,+BAA+B,CAAC;GACzD,MAAM,WAAW,MAAM,OAAO;AAC9B,QAAK,MAAM,QAAQ,cAAc;IAC/B,MAAM,SAAS,MAAM,SAAS,cAAc,KAAK;IACjD,MAAM,UAAU,MAAM,GAAG,SAAS,SAAS,MAAM,QAAQ;IACzD,MAAM,YAAY,MAAM,SAAS,OAAO,SAAS;KAC/C,GAAG;KACH,UAAU;KACX,CAAC;AACF,UAAM,GAAG,SAAS,UAAU,MAAM,UAAU;;AAE9C;;AAGF,MAAI,sBAAsB,SAAS;AACjC,UAAO,QAAQ,MAAM,IAAI,4BAA4B,CAAC;AACtD,OAAI;AACF,UAAM,IAAI,SAAe,YAAY;KASnC,MAAM,QAAQ,MAAM,OAAO;MAPzB;MACA;MACA;MACA,GAAG,aAAa,KAAK,SAAS,KAAK;MAIN,EAAE,EAC/B,OAAO;MAAC;MAAU,QAAQ;MAAQ;MAAU,EAC7C,CAAC;AAEF,WAAM,GAAG,UAAU,UAAiB;AAClC,aAAO,KACL,MAAM,OAAO,8BAA8B,MAAM,QAAQ,CAC1D;AACD,eAAS;OACT;AAEF,WAAM,GAAG,UAAU,SAAiB;AAClC,UAAI,SAAS,EACX,QAAO,KACL,MAAM,OAAO,0CAA0C,OAAO,CAC/D;AAEH,eAAS;OACT;MACF;YACK,OAAO;AACd,WAAO,KAAK,MAAM,OAAO,8BAA8B,OAAO,MAAM,CAAC,CAAC;;AAExE;;AAGF,MAAI,sBAAsB,UAAU;AAClC,UAAO,QAAQ,MAAM,IAAI,6BAA6B,CAAC;GACvD,MAAM,EAAE,WAAW,MAAM,OAAO;GAChC,MAAM,SAAS,IAAI,OAAO;IACxB,KAAK;IACL,oBAAoB,KAAA;IACrB,CAAC;AACF,QAAK,MAAM,QAAQ,cAAc;IAC/B,MAAM,UAAU,MAAM,OAAO,UAAU,CAAC,KAAK,CAAC;AAC9C,UAAM,OAAO,YAAY,QAAQ;;AAEnC;;UAEK,GAAG;AACV,SAAO,KAAK,MAAM,OAAO,mCAAmC,OAAO,EAAE,CAAC,CAAC"}

package/dist/locadex/setupFlow.d.ts

@@ -1,2 +1,5 @@
 import { Settings } from '../types/index.js';
-export declare function setupLocadex(settings: Settings): Promise<void>;
+/** Opens the GitHub connection page unless the caller only hands off the URL. */
+export declare function setupLocadex(settings: Settings, { openBrowser }?: {
+    openBrowser?: boolean;
+}): Promise<string>;

package/dist/locadex/setupFlow.js

@@ -1,10 +1,12 @@
 import { logger } from "../console/logger.js";
 import chalk from "chalk";
 //#region src/locadex/setupFlow.ts
-async function setupLocadex(settings) {
+/** Opens the GitHub connection page unless the caller only hands off the URL. */
+async function setupLocadex(settings, { openBrowser = true } = {}) {
 	const urlToOpen = `${settings.dashboardUrl}/api/integrations/github/start?returnTo=%2Fproject%2Flocadex`;
-	await import("open").then((open) => open.default(urlToOpen, { wait: false }));
-	logger.message(`${chalk.dim(`If the browser window didn't open automatically, open the following link:`)}\n\n${chalk.cyan(urlToOpen)}`);
+	if (openBrowser) await import("open").then((open) => open.default(urlToOpen, { wait: false }));
+	logger.message(`${chalk.dim(openBrowser ? `If the browser window didn't open automatically, open the following link:` : "Open the following link to connect GitHub and finish setting up Locadex:")}\n\n${chalk.cyan(urlToOpen)}`);
+	return urlToOpen;
 }
 //#endregion
 export { setupLocadex };

package/dist/locadex/setupFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupFlow.js","names":[],"sources":["../../src/locadex/setupFlow.ts"],"sourcesContent":["import { Settings } from '../types/index.js';\nimport { logger } from '../console/logger.js';\nimport chalk from 'chalk';\n\nexport async function setupLocadex(settings: Settings): Promise<void> {\n  const urlToOpen = `${settings.dashboardUrl}/api/integrations/github/start?returnTo=%2Fproject%2Flocadex`;\n  await import('open').then((open) =>\n    open.default(urlToOpen, {\n      wait: false,\n    })\n  );\n\n  logger.message(\n    `${chalk.dim(\n      `If the browser window didn't open automatically, open the following link:`\n    )}\\n\\n${chalk.cyan(urlToOpen)}`\n  );\n}\n"],"mappings":";;;AAIA,eAAsB,aAAa,UAAmC;CACpE,MAAM,YAAY,GAAG,SAAS,aAAa;AAC3C,OAAM,OAAO,QAAQ,MAAM,SACzB,KAAK,QAAQ,WAAW,EACtB,MAAM,OACP,CAAC,CACH;AAED,QAAO,QACL,GAAG,MAAM,IACP,4EACD,CAAC,MAAM,MAAM,KAAK,UAAU,GAC9B"}
+{"version":3,"file":"setupFlow.js","names":[],"sources":["../../src/locadex/setupFlow.ts"],"sourcesContent":["import { Settings } from '../types/index.js';\nimport { logger } from '../console/logger.js';\nimport chalk from 'chalk';\n\n/** Opens the GitHub connection page unless the caller only hands off the URL. */\nexport async function setupLocadex(\n  settings: Settings,\n  { openBrowser = true }: { openBrowser?: boolean } = {}\n): Promise<string> {\n  const urlToOpen = `${settings.dashboardUrl}/api/integrations/github/start?returnTo=%2Fproject%2Flocadex`;\n  if (openBrowser) {\n    await import('open').then((open) =>\n      open.default(urlToOpen, {\n        wait: false,\n      })\n    );\n  }\n\n  logger.message(\n    `${chalk.dim(\n      openBrowser\n        ? `If the browser window didn't open automatically, open the following link:`\n        : 'Open the following link to connect GitHub and finish setting up Locadex:'\n    )}\\n\\n${chalk.cyan(urlToOpen)}`\n  );\n  return urlToOpen;\n}\n"],"mappings":";;;;AAKA,eAAsB,aACpB,UACA,EAAE,cAAc,SAAoC,EAAE,EACrC;CACjB,MAAM,YAAY,GAAG,SAAS,aAAa;AAC3C,KAAI,YACF,OAAM,OAAO,QAAQ,MAAM,SACzB,KAAK,QAAQ,WAAW,EACtB,MAAM,OACP,CAAC,CACH;AAGH,QAAO,QACL,GAAG,MAAM,IACP,cACI,8EACA,2EACL,CAAC,MAAM,MAAM,KAAK,UAAU,GAC9B;AACD,QAAO"}

package/dist/react/jsx/utils/jsxParsing/addGTIdentifierToSyntaxTree.js

@@ -1,7 +1,7 @@
 import { DATA_ATTR_PREFIX } from "../constants.js";
 import { defaultVariableNames, getVariableName, minifyVariableType } from "../../../utils/getVariableName.js";
-import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
 import { isAcceptedPluralForm } from "generaltranslation/internal";
+import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
 //#region src/react/jsx/utils/jsxParsing/addGTIdentifierToSyntaxTree.ts
 /**
 * Construct the data-_gt prop

package/dist/react/jsx/utils/jsxParsing/parseJsx.js

@@ -15,6 +15,7 @@ import { autoInsertJsxComponents, ensureTAndVarImported } from "./autoInsertion.
 import { extractSourceCode } from "../extractSourceCode.js";
 import { nodeToStrings, parseStringExpression } from "../parseString.js";
 import { handleDerivation } from "../stringParsing/derivation/handleDerivation.js";
+import { isAcceptedPluralForm } from "generaltranslation/internal";
 import { randomUUID } from "node:crypto";
 import path from "node:path";
 import fs from "node:fs";
@@ -22,7 +23,6 @@ import * as t from "@babel/types";
 import { parse } from "@babel/parser";
 import generateModule from "@babel/generator";
 import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
-import { isAcceptedPluralForm } from "generaltranslation/internal";
 import traverseModule from "@babel/traverse";
 //#region src/react/jsx/utils/jsxParsing/parseJsx.ts
 const generate = generateModule.default || generateModule;

package/dist/react/jsx/utils/parseString.js

@@ -4,11 +4,11 @@ import "./constants.js";
 import { warnDeriveCircularSpreadSync, warnDeriveDestructuringSync, warnDeriveFunctionNoResultsSync, warnDeriveNonConstVariableSync, warnDeriveOptionalChainingSync, warnDeriveUnresolvableValueSync, warnFunctionNotFoundSync, warnInvalidDeclareVarNameSync } from "../../../console/index.js";
 import { resolveImportPath } from "./resolveImportPath.js";
 import { buildImportMap } from "./buildImportMap.js";
+import { declareVar } from "generaltranslation/internal";
 import fs from "node:fs";
 import * as t from "@babel/types";
 import { parse } from "@babel/parser";
 import generateModule from "@babel/generator";
-import { declareVar } from "generaltranslation/internal";
 import traverseModule from "@babel/traverse";
 //#region src/react/jsx/utils/parseString.ts
 const traverse = traverseModule.default || traverseModule;

package/dist/react/jsx/utils/stringParsing/derivation/index.js

@@ -2,9 +2,9 @@ import { isValidIcu } from "../../../evaluateJsx.js";
 import { warnInvalidIcuSync, warnNonStringSync } from "../../../../../console/index.js";
 import { nodeToStrings } from "../../parseString.js";
 import { handleDerivation } from "./handleDerivation.js";
+import { indexVars } from "generaltranslation/internal";
 import { randomUUID } from "node:crypto";
 import generateModule from "@babel/generator";
-import { indexVars } from "generaltranslation/internal";
 //#region src/react/jsx/utils/stringParsing/derivation/index.ts
 const generate = generateModule.default || generateModule;
 /**

package/dist/setup/buildTools/index.d.ts

@@ -0,0 +1,44 @@
+import type { SupportedReactFrameworks } from '../../types/index.js';
+/** A change setup left to a person, reported as a warning. */
+export type ManualAction = {
+    whatHappened: string;
+    fix: string;
+};
+/** What a build-tool hook changed, and what a person still has to do. */
+export type SetupResult = {
+    steps: string[];
+    manualActions: ManualAction[];
+};
+export type BuildToolContext = {
+    appDirectory: string;
+    configFilepath: string;
+    defaultLocale: string;
+    locales: string[];
+    /** Set when translations are stored locally. */
+    translationsDir?: string;
+    /** The translations directory in the existing config. */
+    previousTranslationsDir?: string;
+};
+/** Setup steps for a build tool whose app entry GT configures itself. */
+export type BuildToolSetup = {
+    framework: SupportedReactFrameworks;
+    defaultTranslationsDir: string;
+    /** The runtime entry named in the defaults text. */
+    initializer: string;
+    /** Loads local translations itself instead of loadTranslations.js. */
+    ownsLoader: boolean;
+    skipsGTInstall(isUsingGT: boolean): boolean;
+    /** The development credentials question asked with local storage. */
+    devCredentialsOption: '--live-translations' | '--dev-credentials';
+    /** Rejects an app layout it cannot configure, before any change. */
+    preflight(appDirectory: string): Promise<void>;
+    /** Keeps an existing loader in sync when the React setup is skipped. */
+    syncLoader(ctx: BuildToolContext & {
+        translationsDir: string;
+        keepAppSource?: boolean;
+    }): Promise<SetupResult>;
+    /** Configures the app entry after gt.config.json is written. */
+    apply(ctx: BuildToolContext): Promise<SetupResult>;
+};
+export declare const BUILD_TOOL_SETUPS: BuildToolSetup[];
+export declare function getBuildToolSetup(framework?: string): BuildToolSetup | undefined;

package/dist/setup/buildTools/index.js

@@ -0,0 +1,10 @@
+import { viteSetup } from "./vite.js";
+//#region src/setup/buildTools/index.ts
+const BUILD_TOOL_SETUPS = [viteSetup];
+function getBuildToolSetup(framework) {
+	return BUILD_TOOL_SETUPS.find((setup) => setup.framework === framework);
+}
+//#endregion
+export { BUILD_TOOL_SETUPS, getBuildToolSetup };
+
+//# sourceMappingURL=index.js.map

package/dist/setup/buildTools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/setup/buildTools/index.ts"],"sourcesContent":["import type { SupportedReactFrameworks } from '../../types/index.js';\nimport { viteSetup } from './vite.js';\n\n/** A change setup left to a person, reported as a warning. */\nexport type ManualAction = { whatHappened: string; fix: string };\n\n/** What a build-tool hook changed, and what a person still has to do. */\nexport type SetupResult = { steps: string[]; manualActions: ManualAction[] };\n\nexport type BuildToolContext = {\n  appDirectory: string;\n  configFilepath: string;\n  defaultLocale: string;\n  locales: string[];\n  /** Set when translations are stored locally. */\n  translationsDir?: string;\n  /** The translations directory in the existing config. */\n  previousTranslationsDir?: string;\n};\n\n/** Setup steps for a build tool whose app entry GT configures itself. */\nexport type BuildToolSetup = {\n  framework: SupportedReactFrameworks;\n  defaultTranslationsDir: string;\n  /** The runtime entry named in the defaults text. */\n  initializer: string;\n  /** Loads local translations itself instead of loadTranslations.js. */\n  ownsLoader: boolean;\n  skipsGTInstall(isUsingGT: boolean): boolean;\n  /** The development credentials question asked with local storage. */\n  devCredentialsOption: '--live-translations' | '--dev-credentials';\n  /** Rejects an app layout it cannot configure, before any change. */\n  preflight(appDirectory: string): Promise<void>;\n  /** Keeps an existing loader in sync when the React setup is skipped. */\n  syncLoader(\n    ctx: BuildToolContext & { translationsDir: string; keepAppSource?: boolean }\n  ): Promise<SetupResult>;\n  /** Configures the app entry after gt.config.json is written. */\n  apply(ctx: BuildToolContext): Promise<SetupResult>;\n};\n\nexport const BUILD_TOOL_SETUPS: BuildToolSetup[] = [viteSetup];\n\nexport function getBuildToolSetup(\n  framework?: string\n): BuildToolSetup | undefined {\n  return BUILD_TOOL_SETUPS.find((setup) => setup.framework === framework);\n}\n"],"mappings":";;AAyCA,MAAa,oBAAsC,CAAC,UAAU;AAE9D,SAAgB,kBACd,WAC4B;AAC5B,QAAO,kBAAkB,MAAM,UAAU,MAAM,cAAc,UAAU"}

package/dist/setup/buildTools/vite.d.ts

@@ -0,0 +1,2 @@
+import type { BuildToolSetup } from './index.js';
+export declare const viteSetup: BuildToolSetup;

package/dist/setup/buildTools/vite.js

@@ -0,0 +1,61 @@
+import { DEFAULT_VITE_TRANSLATIONS_DIR } from "../../utils/constants.js";
+import { inspectViteSPA, setupViteSPA, writeViteLoader } from "../setupViteSPA.js";
+import path from "node:path";
+import fs from "node:fs";
+//#region src/setup/buildTools/vite.ts
+const VITE_LOADER_FILE = "src/loadTranslations.ts";
+/** A loader left unchanged may not read the newly chosen directory. */
+function loaderUpdateActions(translationsDir, previousTranslationsDir, custom) {
+	if (translationsDir === previousTranslationsDir) return [];
+	const fix = `Update ${custom ? "your custom " : ""}${VITE_LOADER_FILE} to load translations from ${translationsDir}`;
+	return [{
+		whatHappened: custom ? `Your custom ${VITE_LOADER_FILE} was left unchanged, but translations now go to ${translationsDir}` : `${VITE_LOADER_FILE} was left unchanged because the React setup was skipped, but translations now go to ${translationsDir}`,
+		fix
+	}];
+}
+const viteSetup = {
+	framework: "vite",
+	defaultTranslationsDir: DEFAULT_VITE_TRANSLATIONS_DIR,
+	initializer: "initializeGTSPA",
+	ownsLoader: true,
+	skipsGTInstall: (isUsingGT) => isUsingGT,
+	devCredentialsOption: "--live-translations",
+	async preflight(appDirectory) {
+		await inspectViteSPA(appDirectory);
+	},
+	async syncLoader({ appDirectory, defaultLocale, locales, translationsDir, previousTranslationsDir, keepAppSource }) {
+		if (keepAppSource) return {
+			steps: [],
+			manualActions: fs.existsSync(path.join(appDirectory, VITE_LOADER_FILE)) ? loaderUpdateActions(translationsDir, previousTranslationsDir, false) : []
+		};
+		const loader = await writeViteLoader({
+			appDirectory,
+			defaultLocale,
+			locales,
+			translationsDir,
+			previousTranslationsDir,
+			create: false
+		});
+		return {
+			steps: loader === "written" ? [`updated ${VITE_LOADER_FILE}`] : [],
+			manualActions: loader === "custom" ? loaderUpdateActions(translationsDir, previousTranslationsDir, true) : []
+		};
+	},
+	async apply(ctx) {
+		const { manualAction } = await setupViteSPA(ctx);
+		return manualAction ? {
+			steps: [],
+			manualActions: [{
+				whatHappened: "The existing Vite setup needs a manual review",
+				fix: manualAction
+			}]
+		} : {
+			steps: ["configured initializeGTSPA"],
+			manualActions: []
+		};
+	}
+};
+//#endregion
+export { viteSetup };
+
+//# sourceMappingURL=vite.js.map

package/dist/setup/buildTools/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","names":[],"sources":["../../../src/setup/buildTools/vite.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { DEFAULT_VITE_TRANSLATIONS_DIR } from '../../utils/constants.js';\nimport {\n  inspectViteSPA,\n  setupViteSPA,\n  writeViteLoader,\n} from '../setupViteSPA.js';\nimport type { BuildToolSetup, ManualAction } from './index.js';\n\nconst VITE_LOADER_FILE = 'src/loadTranslations.ts';\n\n/** A loader left unchanged may not read the newly chosen directory. */\nfunction loaderUpdateActions(\n  translationsDir: string,\n  previousTranslationsDir: string | undefined,\n  custom: boolean\n): ManualAction[] {\n  if (translationsDir === previousTranslationsDir) return [];\n  const fix = `Update ${custom ? 'your custom ' : ''}${VITE_LOADER_FILE} to load translations from ${translationsDir}`;\n  return [\n    {\n      whatHappened: custom\n        ? `Your custom ${VITE_LOADER_FILE} was left unchanged, but translations now go to ${translationsDir}`\n        : `${VITE_LOADER_FILE} was left unchanged because the React setup was skipped, but translations now go to ${translationsDir}`,\n      fix,\n    },\n  ];\n}\n\nexport const viteSetup: BuildToolSetup = {\n  framework: 'vite',\n  defaultTranslationsDir: DEFAULT_VITE_TRANSLATIONS_DIR,\n  initializer: 'initializeGTSPA',\n  ownsLoader: true,\n  skipsGTInstall: (isUsingGT) => isUsingGT,\n  devCredentialsOption: '--live-translations',\n  async preflight(appDirectory) {\n    await inspectViteSPA(appDirectory);\n  },\n  // Configure keeps an existing loader in sync; init leaves application\n  // source to the person.\n  async syncLoader({\n    appDirectory,\n    defaultLocale,\n    locales,\n    translationsDir,\n    previousTranslationsDir,\n    keepAppSource,\n  }) {\n    if (keepAppSource) {\n      return {\n        steps: [],\n        manualActions: fs.existsSync(path.join(appDirectory, VITE_LOADER_FILE))\n          ? loaderUpdateActions(translationsDir, previousTranslationsDir, false)\n          : [],\n      };\n    }\n    const loader = await writeViteLoader({\n      appDirectory,\n      defaultLocale,\n      locales,\n      translationsDir,\n      previousTranslationsDir,\n      create: false,\n    });\n    return {\n      steps: loader === 'written' ? [`updated ${VITE_LOADER_FILE}`] : [],\n      manualActions:\n        loader === 'custom'\n          ? loaderUpdateActions(translationsDir, previousTranslationsDir, true)\n          : [],\n    };\n  },\n  async apply(ctx) {\n    const { manualAction } = await setupViteSPA(ctx);\n    return manualAction\n      ? {\n          steps: [],\n          manualActions: [\n            {\n              whatHappened: 'The existing Vite setup needs a manual review',\n              fix: manualAction,\n            },\n          ],\n        }\n      : { steps: ['configured initializeGTSPA'], manualActions: [] };\n  },\n};\n"],"mappings":";;;;;AAUA,MAAM,mBAAmB;;AAGzB,SAAS,oBACP,iBACA,yBACA,QACgB;AAChB,KAAI,oBAAoB,wBAAyB,QAAO,EAAE;CAC1D,MAAM,MAAM,UAAU,SAAS,iBAAiB,KAAK,iBAAiB,6BAA6B;AACnG,QAAO,CACL;EACE,cAAc,SACV,eAAe,iBAAiB,kDAAkD,oBAClF,GAAG,iBAAiB,sFAAsF;EAC9G;EACD,CACF;;AAGH,MAAa,YAA4B;CACvC,WAAW;CACX,wBAAwB;CACxB,aAAa;CACb,YAAY;CACZ,iBAAiB,cAAc;CAC/B,sBAAsB;CACtB,MAAM,UAAU,cAAc;AAC5B,QAAM,eAAe,aAAa;;CAIpC,MAAM,WAAW,EACf,cACA,eACA,SACA,iBACA,yBACA,iBACC;AACD,MAAI,cACF,QAAO;GACL,OAAO,EAAE;GACT,eAAe,GAAG,WAAW,KAAK,KAAK,cAAc,iBAAiB,CAAC,GACnE,oBAAoB,iBAAiB,yBAAyB,MAAM,GACpE,EAAE;GACP;EAEH,MAAM,SAAS,MAAM,gBAAgB;GACnC;GACA;GACA;GACA;GACA;GACA,QAAQ;GACT,CAAC;AACF,SAAO;GACL,OAAO,WAAW,YAAY,CAAC,WAAW,mBAAmB,GAAG,EAAE;GAClE,eACE,WAAW,WACP,oBAAoB,iBAAiB,yBAAyB,KAAK,GACnE,EAAE;GACT;;CAEH,MAAM,MAAM,KAAK;EACf,MAAM,EAAE,iBAAiB,MAAM,aAAa,IAAI;AAChD,SAAO,eACH;GACE,OAAO,EAAE;GACT,eAAe,CACb;IACE,cAAc;IACd,KAAK;IACN,CACF;GACF,GACD;GAAE,OAAO,CAAC,6BAA6B;GAAE,eAAe,EAAE;GAAE;;CAEnE"}

package/dist/setup/developmentCredentials.d.ts

@@ -1,8 +1,43 @@
 import type { Settings, SupportedFrameworks } from '../types/index.js';
+import { type OnboardingSession } from './onboarding.js';
+/** .env.local never reaches production; the runtime key there is set on the host. */
+export declare function productionRuntimeKeyGuidance(dashboardUrl: string): string;
 /**
- * Picks or creates the project, mints a development key limited to runtime
- * translation, and saves both to .env.local. The file is checked before any
- * key exists, every service call completes before anything is written, and
- * the key is never printed.
+ * Interactive setup keeps the browser login with its device fallback;
+ * noninteractive setup always shows a device code (and emits it as a JSON
+ * event) and waits for a person to approve it, without opening a browser.
  */
-export declare function provisionDevelopmentCredentials(settings: Settings, framework: SupportedFrameworks | undefined, cwd?: string): Promise<void>;
+export declare function signInForSetup(session: OnboardingSession, baseUrl: string | undefined): Promise<void>;
+/** An existing project, or the inputs for creating one. */
+export type DevelopmentProject = {
+    id: string;
+} | {
+    create: {
+        orgId: string;
+        name: string;
+    };
+};
+export type DevelopmentProjectOptions = {
+    createProject?: boolean;
+    orgId?: string;
+    projectName?: string;
+};
+/**
+ * Records project inputs a noninteractive run is missing, before signing in,
+ * so it never waits for approval only to fail on a missing flag.
+ */
+export declare function checkDevelopmentProjectInputs(session: OnboardingSession, settings: Settings, options: DevelopmentProjectOptions, 
+/** Where settings.projectId came from, so a person can remove it. */
+projectIdSource: string): void;
+/**
+ * Chooses the project for development credentials without creating anything:
+ * a supplied or configured ID, explicit creation inputs, or (interactively)
+ * a selection among the account's projects.
+ */
+export declare function resolveDevelopmentProject(session: OnboardingSession, settings: Settings, options: DevelopmentProjectOptions, cwd?: string): Promise<DevelopmentProject | undefined>;
+/**
+ * Creates the chosen project if needed, mints a development key limited to
+ * runtime translation, and saves both to .env.local. Callers inspect
+ * .env.local first; the key is never printed.
+ */
+export declare function provisionDevelopmentCredentials(session: OnboardingSession, project: DevelopmentProject, settings: Settings, framework: SupportedFrameworks | undefined, cwd?: string): Promise<void>;