gt-react 10.19.16 → 10.19.17

package/dist/macros.mjs

@@ -28,7 +28,46 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 //#endregion
-//#region ../core/dist/base64-CWITCfhU.mjs
+//#region ../core/dist/base64-r7YWJYWt.mjs
+function ensureSentence(text) {
+	const trimmed = text.trim();
+	if (!trimmed) return "";
+	return /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function stripSentence(text) {
+	const trimmed = text.trim();
+	let end = trimmed.length;
+	while (end > 0) {
+		const char = trimmed[end - 1];
+		if (char !== "." && char !== "!" && char !== "?") break;
+		end -= 1;
+	}
+	return trimmed.slice(0, end);
+}
+function lowercaseFirstWord(text) {
+	return text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());
+}
+function formatDetails(details) {
+	if (!details) return "";
+	const detailText = Array.isArray(details) ? details.join(", ") : details;
+	if (!detailText.trim()) return "";
+	return ensureSentence(`Details: ${detailText}`);
+}
+function createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {
+	const prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : "";
+	const whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;
+	const shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));
+	const messageParts = [
+		whatAndWhy,
+		reassurance,
+		shouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,
+		shouldCombineWayOut ? void 0 : wayOut,
+		formatDetails(details)
+	].filter((part) => !!part).map(ensureSentence);
+	if (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);
+	const message = messageParts.join(" ");
+	return prefix ? `${prefix} ${message}` : message;
+}
 const defaultCacheUrl = "https://cdn.gtx.dev";
 //#endregion
 //#region ../core/dist/isVariable-fAKEB7gF.mjs
@@ -4303,7 +4342,7 @@ function sanitizeJsxChildren(childrenAsObjects) {
 	return Array.isArray(childrenAsObjects) ? childrenAsObjects.map(sanitizeChild) : sanitizeChild(childrenAsObjects);
 }
 //#endregion
-//#region ../i18n/dist/versionId-B2xfz6jP.mjs
+//#region ../i18n/dist/versionId-BkJZGHXr.mjs
 /**
 * Throw errors if there are any errors and log warnings if there are any warnings
 * @param {ValidationResult[]} results - The results to print
@@ -4349,9 +4388,9 @@ function getLoadTranslationsType(config) {
 * Requirements:
 * - REMOTE:
 * - GT_REMOTE:
-*   - projectId is required
+*   - projectId is needed
 * - CUSTOM:
-*   - loadTranslations is required
+*   - loadTranslations is needed
 * - DISABLED:
 *   - no requirements
 */
@@ -4363,13 +4402,19 @@ function validateLoadTranslations(params) {
 		case "gt-remote":
 			if (!projectId) results.push({
 				type: "warning",
-				message: "projectId is required when loading translations from a remote store"
+				message: createDiagnosticMessage({
+					whatHappened: "Loading translations from a remote store needs a projectId",
+					fix: "Add projectId to the I18nManager config or disable remote translation loading"
+				})
 			});
 			break;
 		case "custom":
 			if (!loadTranslations) results.push({
 				type: "error",
-				message: "loadTranslations is required when loading translations from a custom loader"
+				message: createDiagnosticMessage({
+					whatHappened: "Custom translation loading needs loadTranslations",
+					fix: "Provide a loadTranslations function or disable custom translation loading"
+				})
 			});
 			break;
 		case "disabled": break;
@@ -4382,8 +4427,9 @@ function validateLoadTranslations(params) {
 * @returns The runtime translation type
 */
 function getTranslationApiType(params) {
-	if ((params.runtimeUrl === void 0 || params.runtimeUrl === "https://runtime2.gtx.dev") && params.projectId && (params.devApiKey || params.apiKey)) return "gt";
-	else if (params.runtimeUrl) return "custom";
+	const usesDefaultRuntimeUrl = params.runtimeUrl === void 0 || params.runtimeUrl === "https://runtime2.gtx.dev";
+	if (usesDefaultRuntimeUrl && params.projectId && (params.devApiKey || params.apiKey)) return "gt";
+	else if (params.runtimeUrl && !usesDefaultRuntimeUrl) return "custom";
 	else return "disabled";
 }
 /**
@@ -4399,8 +4445,8 @@ function getTranslationApiType(params) {
 * Requirements:
 * - CUSTOM:
 * - GT:
-*   - projectId is required
-*   - devApiKey or apiKey is required
+*   - projectId is needed
+*   - devApiKey or apiKey is needed
 * - DISABLED:
 *   - no requirements
 *
@@ -4413,11 +4459,17 @@ function validateTranslationApi(params) {
 		case "gt":
 			if (!params.projectId) results.push({
 				type: "warning",
-				message: "projectId is required"
+				message: createDiagnosticMessage({
+					whatHappened: "Runtime translation needs a projectId",
+					fix: "Add projectId to the I18nManager config or disable runtime translation"
+				})
 			});
 			if (!params.devApiKey && !params.apiKey) results.push({
 				type: "warning",
-				message: "devApiKey or apiKey is required"
+				message: createDiagnosticMessage({
+					whatHappened: "Runtime translation needs devApiKey or apiKey",
+					fix: "Add credentials to the I18nManager config or disable runtime translation"
+				})
 			});
 			break;
 		case "disabled": break;
@@ -4446,7 +4498,10 @@ function validateLocales(params) {
 	new Set([...defaultLocale ? [defaultLocale] : [], ...locales || []]).forEach((locale) => {
 		if (!isValidLocale(locale, customMapping)) results.push({
 			type: "error",
-			message: `Invalid locale: ${locale}`
+			message: createDiagnosticMessage({
+				whatHappened: `Locale "${locale}" is not valid`,
+				fix: "Use a valid BCP 47 locale code or add a custom mapping"
+			})
 		});
 	});
 	return results;
@@ -4461,7 +4516,10 @@ function validateDictionary(params) {
 	const results = [];
 	if (params.loadDictionary && !params.dictionary) results.push({
 		type: "error",
-		message: "dictionary is required when loadDictionary is provided"
+		message: createDiagnosticMessage({
+			whatHappened: "loadDictionary needs a source dictionary",
+			fix: "Provide dictionary so the default locale has source content"
+		})
 	});
 	return results;
 }
@@ -5731,7 +5789,7 @@ var I18nManager = class extends EventEmitter {
 	}
 	resolveLocale(locale) {
 		const resolvedLocale = this.localeConfig.determineLocale(locale);
-		if (!this.localeConfig.isValidLocale(locale) || !resolvedLocale) throw new Error(`I18nManager: validateLocale(): locale ${locale} is not valid`);
+		if (!this.localeConfig.isValidLocale(locale) || !resolvedLocale) throw new Error(`Locale "${locale}" is not valid. Use a valid BCP 47 locale code or add a custom mapping.`);
 		return resolvedLocale;
 	}
 	/**
@@ -5778,7 +5836,7 @@ var I18nManager = class extends EventEmitter {
 	*/
 	async dictionaryRuntimeTranslate(locale, id, sourceEntry) {
 		const translation = await this.lookupTranslationWithFallbackResolved(locale, sourceEntry.entry, resolveDictionaryLookupOptions(sourceEntry.options));
-		if (typeof translation !== "string") throw new Error(`I18nManager: dictionaryRuntimeTranslate(): unable to translate dictionary entry ${id}`);
+		if (typeof translation !== "string") throw new Error(`Dictionary entry "${id}" could not be translated into a string. Check the source entry and translation loader output.`);
 		return translation;
 	}
 	/**
@@ -5910,7 +5968,7 @@ let conditionStore = { getLocale: () => fallbackDefaultLocale };
 */
 function getI18nManager() {
 	if (!i18nManager) {
-		logger_default.warn("getI18nManager(): Translation failed because I18nManager not initialized.");
+		logger_default.warn("getI18nManager(): I18nManager was not initialized. Falling back to the default locale until initializeGT() configures translations.");
 		i18nManager = new I18nManager({
 			defaultLocale: "en",
 			locales: ["en"]
@@ -6042,10 +6100,30 @@ function resolveTranslationSyncWithFallback(locale, message, options = {}) {
 //#endregion
 //#region src/shared/messages.ts
 const PACKAGE_NAME = "gt-react";
-`${PACKAGE_NAME}${PACKAGE_NAME}`;
-`${PACKAGE_NAME}`;
-`${PACKAGE_NAME}`;
-const createTranslationFailedDueToBrowserEnvironmentWarning = (message) => `${PACKAGE_NAME} Warning: Translation failed for t("${typeof message === "string" ? message : "`" + message?.join("${}") + "`"}") because it was used outside of a browser environment. Falling back to original message.`;
+createDiagnosticMessage({
+	source: `${PACKAGE_NAME}/browser`,
+	severity: "Error",
+	whatHappened: "This module requires a browser environment",
+	fix: "Import it only from client-side code"
+});
+createDiagnosticMessage({
+	source: PACKAGE_NAME,
+	severity: "Error",
+	whatHappened: "A browser-only module was imported outside the browser",
+	fix: "Move this import to client-side code"
+});
+createDiagnosticMessage({
+	source: PACKAGE_NAME,
+	severity: "Error",
+	whatHappened: "BrowserI18nManager is not initialized",
+	fix: "Call initializeGT() before using browser translation APIs"
+});
+const createTranslationFailedDueToBrowserEnvironmentWarning = (message) => createDiagnosticMessage({
+	source: PACKAGE_NAME,
+	severity: "Warning",
+	whatHappened: `t("${typeof message === "string" ? message : "`" + message?.join("${}") + "`"}") could not be translated because it ran outside the browser`,
+	wayOut: "The original message will render as a fallback"
+});
 //#endregion
 //#region src/i18n-context/functions/translation/t.ts
 /**
@@ -6091,7 +6169,7 @@ const t = (messageOrStrings, ...values) => {
 */
 function handleTaggedTemplateLiteralTranslation(messageOrStrings, values) {
 	const locale = getLocale();
-	const translatedInterpolatedTemplate = resolveTranslationSync(locale, interpolateTemplateLiteral(messageOrStrings, values));
+	const translatedInterpolatedTemplate = resolveTranslationSync(locale, messageOrStrings.map((string, index) => string + (values[index] ?? "")).join(""));
 	if (translatedInterpolatedTemplate) return translatedInterpolatedTemplate;
 	const { message, variables } = extractInterpolatableValues(messageOrStrings, values);
 	return resolveTranslationSyncWithFallback(locale, message, variables);
@@ -6120,17 +6198,6 @@ function extractInterpolatableValues(strings, values) {
 		variables
 	};
 }
-/**
-* Interpolate a template literal
-* @param message - The message to interpolate.
-* @param variables - The variables to interpolate.
-* @returns The interpolated message.
-*/
-function interpolateTemplateLiteral(strings, values) {
-	return strings.map((string, index) => {
-		return string + (values[index] ?? "");
-	}).join("");
-}
 //#endregion
 //#region src/macros.ts
 globalThis.t = t;