@generaltranslation/react-core 1.8.17 → 1.8.19

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @generaltranslation/react-core
 
+## 1.8.19
+
+### Patch Changes
+
+- [#1419](https://github.com/generaltranslation/gt/pull/1419) [`a877a2a`](https://github.com/generaltranslation/gt/commit/a877a2a5bd5ca47b199c6caf53a6d60d96e3a300) Thanks [@bgub](https://github.com/bgub)! - Improve diagnostic messages and package-local diagnostic formatting.
+
+- Updated dependencies [[`bb3624e`](https://github.com/generaltranslation/gt/commit/bb3624e58546c334c04370a1f5a262238bd040fa), [`a877a2a`](https://github.com/generaltranslation/gt/commit/a877a2a5bd5ca47b199c6caf53a6d60d96e3a300)]:
+  - @generaltranslation/format@0.1.1
+  - generaltranslation@8.2.15
+  - gt-i18n@0.9.3
+  - @generaltranslation/supported-locales@2.0.73
+
+## 1.8.18
+
+### Patch Changes
+
+- [#1408](https://github.com/generaltranslation/gt/pull/1408) [`425d3e4`](https://github.com/generaltranslation/gt/commit/425d3e4e6c61afd108c65c27f7693ba2470b33c6) Thanks [@bgub](https://github.com/bgub)! - Use @generaltranslation/format directly for shared formatting and locale helpers.
+
+- [#1415](https://github.com/generaltranslation/gt/pull/1415) [`6e6c69e`](https://github.com/generaltranslation/gt/commit/6e6c69e3ca2f51937407674cf101b69e968952a1) Thanks [@bgub](https://github.com/bgub)! - Switch the React Core package build pipeline to tsdown while preserving the existing public entrypoints.
+
+- Updated dependencies [[`73f3ac1`](https://github.com/generaltranslation/gt/commit/73f3ac1308df11c1e6230c13c1999bfc5f6afc99), [`425d3e4`](https://github.com/generaltranslation/gt/commit/425d3e4e6c61afd108c65c27f7693ba2470b33c6), [`8650ae9`](https://github.com/generaltranslation/gt/commit/8650ae9ced69755bf3eebc1bafdf7743ba0c5136)]:
+  - @generaltranslation/format@0.1.0
+  - generaltranslation@8.2.14
+  - gt-i18n@0.9.2
+  - @generaltranslation/supported-locales@2.0.72
+
 ## 1.8.17
 
 ### Patch Changes

package/dist/errors.cjs.min.cjs

@@ -1,2 +1,2 @@
-"use strict";require("generaltranslation");exports.createUnsupportedLocaleWarning=(a,e,r="@generaltranslation/react-core")=>`${r} Warning: "${e}" is not a supported locale. Update supported locales in your dashboard or gt.config.json. Falling back to "${a}".`;
-//# sourceMappingURL=errors.cjs.min.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`@generaltranslation/format`);function e(e){let t=e.trim();return t?/[.!?)]$/.test(t)?t:`${t}.`:``}function t(e){let t=e.trim(),n=t.length;for(;n>0;){let e=t[n-1];if(e!==`.`&&e!==`!`&&e!==`?`)break;--n}return t.slice(0,n)}function n(e){return e.replace(/^[A-Z][a-z]/,e=>e.toLowerCase())}function r(t){if(!t)return``;let n=Array.isArray(t)?t.join(`, `):t;return n.trim()?e(`Details: ${n}`):``}function i({source:i,severity:a,whatHappened:o,reassurance:s,why:c,fix:l,wayOut:u,details:d,docsUrl:f}){let p=i?a?`${i} ${a}:`:`${i}:`:a?`${a}:`:``,m=c?`${t(o)} because ${n(t(c))}`:o,h=!!l&&!!u&&/^[a-z]/.test(t(u)),g=[m,s,h?`${t(l)}, or ${n(t(u))}`:l,h?void 0:u,r(d)].filter(e=>!!e).map(e);f&&g.push(`Learn more: ${f}`);let _=g.join(` `);return p?`${p} ${_}`:_}const a=`@generaltranslation/react-core`;function o(e){return i({source:a,...e})}o({severity:`Error`,whatHappened:`Runtime translation needs a project ID`,fix:`Add projectId to your <GTProvider> configuration or set GT_PROJECT_ID in your environment`,docsUrl:`https://generaltranslation.com/dashboard`}),o({severity:`Error`,whatHappened:`Production environments cannot use a development API key`,fix:`Replace it with a production API key before deploying`}),o({severity:`Error`,whatHappened:`The API key is available to client-side production code`,fix:`Move translation credentials to a server-only environment before deploying`}),o({severity:`Error`,whatHappened:`Runtime translation is not configured`,fix:`Add projectId and devApiKey to your environment, or pass them to <GTProvider> directly`}),o({severity:`Error`,whatHappened:`Runtime translations could not be loaded`,wayOut:`Source content will render as a fallback`,fix:`Check your runtime translation configuration and try again`}),o({severity:`Error`,whatHappened:`Runtime translation could not be completed`}),o({severity:`Warning`,whatHappened:`Runtime translation needs a project ID`,fix:`Add projectId to <GTProvider> or set GT_PROJECT_ID in your environment`,docsUrl:`https://generaltranslation.com/dashboard`}),o({severity:`Warning`,whatHappened:`Runtime translation needs a development API key`,fix:`Find your development API key at generaltranslation.com/dashboard, or set runtimeUrl to an empty string to disable runtime translation`}),o({severity:`Warning`,whatHappened:`Runtime translation timed out`});const s=(e,t,n=a)=>`${n} Warning: "${t}" is not a supported locale. Update supported locales in your dashboard or gt.config.json. Falling back to "${e}".`;o({severity:`Warning`,whatHappened:`No dictionary was found`,fix:`Pass a dictionary to <GTProvider> or configure a dictionary loader before rendering translations`}),`${a}`,exports.createUnsupportedLocaleWarning=s;
+//# sourceMappingURL=errors.cjs.min.cjs.map

package/dist/errors.cjs.min.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs.min.cjs","sources":["../src/errors-dir/createErrors.ts","../src/errors-dir/constants.ts"],"sourcesContent":[null,null],"names":["validatedLocale","newLocale","packageName"],"mappings":"kFA6H8C,CAC5CA,EACAC,EACAC,EChI0B,mCDmIxB,GAAGA,eAAyBD,gHAERD"}
+{"version":3,"file":"errors.cjs.min.cjs","names":[],"sources":["../../core/dist/base64-r7YWJYWt.mjs","../src/errors-dir/constants.ts","../src/errors-dir/diagnostics.ts","../src/errors-dir/createErrors.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/utils/isSupportedFileFormatTransform.ts\nconst SUPPORTED_TRANSFORMATIONS = {\n\tGTJSON: [\"GTJSON\"],\n\tJSON: [\"JSON\"],\n\tPO: [\"PO\"],\n\tPOT: [\"POT\", \"PO\"],\n\tYAML: [\"YAML\"],\n\tMDX: [\"MDX\"],\n\tMD: [\"MD\"],\n\tTS: [\"TS\"],\n\tJS: [\"JS\"],\n\tHTML: [\"HTML\"],\n\tTXT: [\"TXT\"],\n\tTWILIO_CONTENT_JSON: [\"TWILIO_CONTENT_JSON\"]\n};\n/**\n* This function checks if a file format transformation is supported during translation\n* @param from - The source file format.\n* @param to - The target file format.\n* @returns True if the transformation is supported, false otherwise\n*/\nfunction isSupportedFileFormatTransform(from, to) {\n\treturn SUPPORTED_TRANSFORMATIONS[from]?.includes(to) ?? false;\n}\n//#endregion\n//#region src/translate/utils/validateFileFormatTransform.ts\n/**\n* Returns a user-facing validation error when a requested file format transform\n* is missing source format context or is not currently supported.\n*/\nfunction getFileFormatTransformError(file) {\n\tif (!file.transformFormat) return void 0;\n\tconst fileLabel = file.fileName ?? file.fileId ?? \"unknown file\";\n\tif (!file.fileFormat) return `fileFormat is required when transformFormat is provided for ${fileLabel}`;\n\tif (!isSupportedFileFormatTransform(file.fileFormat, file.transformFormat)) return `Unsupported file format transform: ${file.fileFormat} -> ${file.transformFormat}`;\n}\n/**\n* Validates file format transforms before sending upload/enqueue requests.\n*/\nfunction validateFileFormatTransforms(files) {\n\tfor (const file of files) {\n\t\tconst error = getFileFormatTransformError(file);\n\t\tif (error) throw new Error(error);\n\t}\n}\n//#endregion\n//#region src/utils/base64.ts\nfunction encode(data) {\n\tif (typeof Buffer !== \"undefined\") return Buffer.from(data, \"utf8\").toString(\"base64\");\n\tconst bytes = new TextEncoder().encode(data);\n\tlet binary = \"\";\n\tfor (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);\n\treturn btoa(binary);\n}\nfunction decode(base64) {\n\tif (typeof Buffer !== \"undefined\") return Buffer.from(base64, \"base64\").toString(\"utf8\");\n\tconst binary = atob(base64);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n\treturn new TextDecoder().decode(bytes);\n}\n//#endregion\nexport { defaultBaseUrl as a, createDiagnosticMessage as c, libraryDefaultLocale as d, isSupportedFileFormatTransform as i, formatDiagnosticErrorDetails as l, encode as n, defaultCacheUrl as o, validateFileFormatTransforms as r, defaultRuntimeApiUrl as s, decode as t, defaultTimeout as u };\n\n//# sourceMappingURL=base64-r7YWJYWt.mjs.map","export const PACKAGE_NAME = '@generaltranslation/react-core';\n","import {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n  type DiagnosticMessageInput,\n} from 'generaltranslation/internal';\nimport { PACKAGE_NAME } from './constants';\n\ntype ReactCoreDiagnosticInput = Omit<DiagnosticMessageInput, 'source'>;\n\nexport function createReactCoreDiagnostic(\n  input: ReactCoreDiagnosticInput\n): string {\n  return createDiagnosticMessage({\n    source: PACKAGE_NAME,\n    ...input,\n  });\n}\n\nexport { formatDiagnosticErrorDetails };\n","import { getLocaleProperties } from '@generaltranslation/format';\nimport {\n  createReactCoreDiagnostic,\n  formatDiagnosticErrorDetails,\n} from './diagnostics';\nimport { PACKAGE_NAME } from './constants';\n\n// ---- ERRORS ---- //\n\nexport const projectIdMissingError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation needs a project ID',\n  fix: 'Add projectId to your <GTProvider> configuration or set GT_PROJECT_ID in your environment',\n  docsUrl: 'https://generaltranslation.com/dashboard',\n});\n\nexport const devApiKeyProductionError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Production environments cannot use a development API key',\n  fix: 'Replace it with a production API key before deploying',\n});\n\nexport const apiKeyInProductionError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'The API key is available to client-side production code',\n  fix: 'Move translation credentials to a server-only environment before deploying',\n});\n\nexport const createNoAuthError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation is not configured',\n  fix: 'Add projectId and devApiKey to your environment, or pass them to <GTProvider> directly',\n});\n\nexport const createPluralMissingError = (children: unknown) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<Plural> could not choose a plural form for \"${children}\"`,\n    fix: 'Pass the required \"n\" option to <Plural>',\n  });\n\nexport const createClientSideTDictionaryCollisionError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<T id=\"${id}\"> conflicts with a dictionary entry using the same ID`,\n    fix: 'Rename the <T> id or the dictionary key so each translation source has a unique ID',\n  });\n\nexport const createClientSideTHydrationError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<T id=\"${id}\"> is rendering in a client component without a saved translation`,\n    why: 'This can cause hydration mismatches',\n    fix: 'Use a dictionary with useGT() or push translations from the command line before rendering this component on the client',\n  });\n\nexport const dynamicTranslationError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translations could not be loaded',\n  wayOut: 'Source content will render as a fallback',\n  fix: 'Check your runtime translation configuration and try again',\n});\n\nexport const createGenericRuntimeTranslationError = (\n  id: string | undefined,\n  hash: string,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: id\n      ? `Translation could not be found for id \"${id}\" and hash \"${hash}\"`\n      : `Translation could not be found for hash \"${hash}\"`,\n    wayOut: 'Source content will render as a fallback',\n    fix: 'Push translations again or check that runtime translation is configured',\n    details: formatDiagnosticErrorDetails(error),\n  });\n\nexport const runtimeTranslationError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation could not be completed',\n});\n\nexport const customLoadTranslationsError = (locale: string = '') =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Locally stored translations could not be loaded${locale ? ` for \"${locale}\"` : ''}`,\n    fix: 'If you use loadTranslations(), make sure it returns translations for the requested locale',\n  });\n\nexport const customLoadDictionaryWarning = (locale: string = '') =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `The local dictionary could not be loaded${locale ? ` for \"${locale}\"` : ''}`,\n    fix: 'If you use loadDictionary(), make sure it returns a dictionary for the requested locale',\n  });\n\nexport const missingVariablesError = (variables: string[], message: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `The message \"${message}\" is missing variables: \"${variables.join('\", \"')}\"`,\n    fix: 'Provide values for these variables before rendering the translation',\n  });\n\nexport const createStringRenderError = (\n  message: string,\n  id: string | undefined,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `The string ${id ? `for id \"${id}\" ` : ''}could not be rendered`,\n    fix: `Check the message syntax and variables for: \"${message}\"`,\n    details: formatDiagnosticErrorDetails(error),\n  });\n\nexport const createStringTranslationError = (\n  string: string,\n  id?: string,\n  functionName = 'tx'\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `${functionName}(\"${string}\")${id ? ` with id \"${id}\"` : ''} could not find a translation`,\n    wayOut: 'Source content will render as a fallback',\n    fix: 'Push translations again or check your dictionary/runtime translation configuration',\n  });\n\nexport const invalidLocalesError = (locales: string[]) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'Invalid locale codes in your configuration',\n    fix: 'Specify a list of valid locales or use \"customMapping\" to define aliases for the invalid locales',\n    details: locales,\n  });\n\nexport const invalidCanonicalLocalesError = (locales: string[]) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'Invalid canonical locale codes in your configuration',\n    fix: 'Use valid BCP 47 locale codes before starting translation',\n    details: locales,\n  });\n\nexport const createEmptyIdError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 't.obj() received an empty id',\n    fix: 'Pass a non-empty dictionary id',\n  });\n\nexport const createSubtreeNotFoundError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Dictionary subtree \"${id}\" could not be found`,\n    fix: 'Check that the id matches your dictionary structure',\n  });\n\nexport const createDictionaryEntryError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'A dictionary entry cannot be injected as a subtree',\n    fix: 'Pass a dictionary object instead',\n  });\n\nexport const createCannotInjectDictionaryEntryError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened:\n      'A dictionary entry cannot be merged into another dictionary entry',\n    fix: 'Pass a dictionary subtree instead',\n  });\n\nexport const createInvalidIcuDictionaryEntryError = (id: string | undefined) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Dictionary entry \"${id}\" contains invalid ICU syntax`,\n    fix: 'Fix the ICU message before rendering this translation',\n  });\n\n// ---- WARNINGS ---- //\n\nexport const projectIdMissingWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation needs a project ID',\n  fix: 'Add projectId to <GTProvider> or set GT_PROJECT_ID in your environment',\n  docsUrl: 'https://generaltranslation.com/dashboard',\n});\n\nexport const createNoEntryFoundWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `No valid dictionary entry was found for id \"${id}\"`,\n    wayOut: 'Source content will render as a fallback',\n  });\n\nexport const createInvalidDictionaryEntryWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `Dictionary entry \"${id}\" is invalid`,\n    wayOut: 'Source content will render as a fallback until the entry is fixed',\n  });\n\nexport const createInvalidIcuDictionaryEntryWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `Dictionary entry \"${id}\" contains invalid ICU syntax`,\n    wayOut: 'Source content will render as a fallback until the entry is fixed',\n  });\n\nexport const createNoEntryTranslationWarning = (\n  id: string,\n  prefixedId: string\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `t(\"${id}\") could not find a translation for dictionary item \"${prefixedId}\"`,\n    wayOut: 'Source content will render as a fallback',\n  });\n\nexport const createMismatchingHashWarning = (\n  expectedHash: string,\n  receivedHash: string\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: 'Translation hashes do not match',\n    reassurance: 'The translation will still render',\n    fix: 'Update your translations to the newest version to avoid stale content',\n    details: [`expected ${expectedHash}`, `received ${receivedHash}`],\n  });\n\nexport const APIKeyMissingWarn = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation needs a development API key',\n  fix: 'Find your development API key at generaltranslation.com/dashboard, or set runtimeUrl to an empty string to disable runtime translation',\n});\n\nexport const createUnsupportedLocalesWarning = (locales: string[]) =>\n  `${PACKAGE_NAME} Warning: The following locales are currently unsupported by our service: ${locales\n    .map((locale) => {\n      const { name } = getLocaleProperties(locale);\n      return `${locale} (${name})`;\n    })\n    .join(', ')}`;\n\nexport const runtimeTranslationTimeoutWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation timed out',\n});\n\nexport const createUnsupportedLocaleWarning = (\n  validatedLocale: string,\n  newLocale: string,\n  packageName: string = PACKAGE_NAME\n) => {\n  return (\n    `${packageName} Warning: \"${newLocale}\" is not a supported locale. ` +\n    `Update supported locales in your dashboard or gt.config.json. ` +\n    `Falling back to \"${validatedLocale}\".`\n  );\n};\n\nexport const dictionaryMissingWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'No dictionary was found',\n  fix: 'Pass a dictionary to <GTProvider> or configure a dictionary loader before rendering translations',\n});\n\nexport const createStringRenderWarning = (\n  message: string,\n  id: string | undefined,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `The string ${id ? `for id \"${id}\" ` : ''}could not be rendered`,\n    wayOut: 'Source content will render as a fallback',\n    fix: `Check the message syntax and variables for: \"${message}\"`,\n    details: formatDiagnosticErrorDetails(error),\n  });\n\n// Unlikely edge case: A <_T> component was injected outside of a <Derive> boundary. This would be caused by the compiler overeagerly injecting <_T> components.\nexport const warnNestedInternalTComponent = `${PACKAGE_NAME} Warning: A <_T> component was found injected outside of a <Derive> boundary. This may affect translation resolution for this component.`;\n"],"mappings":"yGAKA,SAAS,EAAe,EAAM,CAC7B,IAAM,EAAU,EAAK,MAAM,CAE3B,OADK,EACE,UAAU,KAAK,EAAQ,CAAG,EAAU,GAAG,EAAQ,GADjC,GAGtB,SAAS,EAAc,EAAM,CAC5B,IAAM,EAAU,EAAK,MAAM,CACvB,EAAM,EAAQ,OAClB,KAAO,EAAM,GAAG,CACf,IAAM,EAAO,EAAQ,EAAM,GAC3B,GAAI,IAAS,KAAO,IAAS,KAAO,IAAS,IAAK,MAClD,IAED,OAAO,EAAQ,MAAM,EAAG,EAAI,CAE7B,SAAS,EAAmB,EAAM,CACjC,OAAO,EAAK,QAAQ,cAAgB,GAAU,EAAM,aAAa,CAAC,CAEnE,SAAS,EAAc,EAAS,CAC/B,GAAI,CAAC,EAAS,MAAO,GACrB,IAAM,EAAa,MAAM,QAAQ,EAAQ,CAAG,EAAQ,KAAK,KAAK,CAAG,EAEjE,OADK,EAAW,MAAM,CACf,EAAe,YAAY,IAAa,CADhB,GAOhC,SAAS,EAAwB,CAAE,SAAQ,WAAU,eAAc,cAAa,MAAK,MAAK,SAAQ,UAAS,WAAW,CACrH,IAAM,EAAS,EAAS,EAAW,GAAG,EAAO,GAAG,EAAS,GAAK,GAAG,EAAO,GAAK,EAAW,GAAG,EAAS,GAAK,GACnG,EAAa,EAAM,GAAG,EAAc,EAAa,CAAC,WAAW,EAAmB,EAAc,EAAI,CAAC,GAAK,EACxG,EAAsB,CAAC,CAAC,GAAO,CAAC,CAAC,GAAU,SAAS,KAAK,EAAc,EAAO,CAAC,CAC/E,EAAe,CACpB,EACA,EACA,EAAsB,GAAG,EAAc,EAAI,CAAC,OAAO,EAAmB,EAAc,EAAO,CAAC,GAAK,EACjG,EAAsB,IAAK,GAAI,EAC/B,EAAc,EAAQ,CACtB,CAAC,OAAQ,GAAS,CAAC,CAAC,EAAK,CAAC,IAAI,EAAe,CAC1C,GAAS,EAAa,KAAK,eAAe,IAAU,CACxD,IAAM,EAAU,EAAa,KAAK,IAAI,CACtC,OAAO,EAAS,GAAG,EAAO,GAAG,IAAY,EC9C1C,MAAa,EAAe,iCCS5B,SAAgB,EACd,EACQ,CACR,OAAO,EAAwB,CAC7B,OAAQ,EACR,GAAG,EACJ,CAAC,CCNiC,EAA0B,CAC7D,SAAU,QACV,aAAc,yCACd,IAAK,4FACL,QAAS,2CACV,CAAC,CAEsC,EAA0B,CAChE,SAAU,QACV,aAAc,2DACd,IAAK,wDACN,CAAC,CAEqC,EAA0B,CAC/D,SAAU,QACV,aAAc,0DACd,IAAK,6EACN,CAAC,CAE+B,EAA0B,CACzD,SAAU,QACV,aAAc,wCACd,IAAK,yFACN,CAAC,CAwBqC,EAA0B,CAC/D,SAAU,QACV,aAAc,2CACd,OAAQ,2CACR,IAAK,6DACN,CAAC,CAiBqC,EAA0B,CAC/D,SAAU,QACV,aAAc,6CACf,CAAC,CAqGqC,EAA0B,CAC/D,SAAU,UACV,aAAc,yCACd,IAAK,yEACL,QAAS,2CACV,CAAC,CA6C+B,EAA0B,CACzD,SAAU,UACV,aAAc,kDACd,IAAK,yIACN,CAAC,CAU8C,EAA0B,CACxE,SAAU,UACV,aAAc,gCACf,CAAC,CAEF,MAAa,GACX,EACA,EACA,EAAsB,IAGpB,GAAG,EAAY,aAAa,EAAU,8GAElB,EAAgB,IAIA,EAA0B,CAChE,SAAU,UACV,aAAc,0BACd,IAAK,mGACN,CAAC,CAgB0C,GAAG,EAAH"}

package/dist/errors.d.ts

@@ -1,3 +1,5 @@
+//#region src/errors-dir/createErrors.d.ts
 declare const createUnsupportedLocaleWarning: (validatedLocale: string, newLocale: string, packageName?: string) => string;
-
+//#endregion
 export { createUnsupportedLocaleWarning };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,8BAA8B,EAAE,CAAC"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../src/errors-dir/createErrors.ts"],"mappings":";cA2Pa,8BAAA,GACX,eAAA,UACA,SAAA,UACA,WAAA"}

package/dist/errors.esm.min.mjs

@@ -1,2 +1,2 @@
-import"generaltranslation";const o=(o,a,n="@generaltranslation/react-core")=>`${n} Warning: "${a}" is not a supported locale. Update supported locales in your dashboard or gt.config.json. Falling back to "${o}".`;export{o as createUnsupportedLocaleWarning};
-//# sourceMappingURL=errors.esm.min.mjs.map
+import"@generaltranslation/format";function e(e){let t=e.trim();return t?/[.!?)]$/.test(t)?t:`${t}.`:``}function t(e){let t=e.trim(),n=t.length;for(;n>0;){let e=t[n-1];if(e!==`.`&&e!==`!`&&e!==`?`)break;--n}return t.slice(0,n)}function n(e){return e.replace(/^[A-Z][a-z]/,e=>e.toLowerCase())}function r(t){if(!t)return``;let n=Array.isArray(t)?t.join(`, `):t;return n.trim()?e(`Details: ${n}`):``}function i({source:i,severity:a,whatHappened:o,reassurance:s,why:c,fix:l,wayOut:u,details:d,docsUrl:f}){let p=i?a?`${i} ${a}:`:`${i}:`:a?`${a}:`:``,m=c?`${t(o)} because ${n(t(c))}`:o,h=!!l&&!!u&&/^[a-z]/.test(t(u)),g=[m,s,h?`${t(l)}, or ${n(t(u))}`:l,h?void 0:u,r(d)].filter(e=>!!e).map(e);f&&g.push(`Learn more: ${f}`);let _=g.join(` `);return p?`${p} ${_}`:_}const a=`@generaltranslation/react-core`;function o(e){return i({source:a,...e})}o({severity:`Error`,whatHappened:`Runtime translation needs a project ID`,fix:`Add projectId to your <GTProvider> configuration or set GT_PROJECT_ID in your environment`,docsUrl:`https://generaltranslation.com/dashboard`}),o({severity:`Error`,whatHappened:`Production environments cannot use a development API key`,fix:`Replace it with a production API key before deploying`}),o({severity:`Error`,whatHappened:`The API key is available to client-side production code`,fix:`Move translation credentials to a server-only environment before deploying`}),o({severity:`Error`,whatHappened:`Runtime translation is not configured`,fix:`Add projectId and devApiKey to your environment, or pass them to <GTProvider> directly`}),o({severity:`Error`,whatHappened:`Runtime translations could not be loaded`,wayOut:`Source content will render as a fallback`,fix:`Check your runtime translation configuration and try again`}),o({severity:`Error`,whatHappened:`Runtime translation could not be completed`}),o({severity:`Warning`,whatHappened:`Runtime translation needs a project ID`,fix:`Add projectId to <GTProvider> or set GT_PROJECT_ID in your environment`,docsUrl:`https://generaltranslation.com/dashboard`}),o({severity:`Warning`,whatHappened:`Runtime translation needs a development API key`,fix:`Find your development API key at generaltranslation.com/dashboard, or set runtimeUrl to an empty string to disable runtime translation`}),o({severity:`Warning`,whatHappened:`Runtime translation timed out`});const s=(e,t,n=a)=>`${n} Warning: "${t}" is not a supported locale. Update supported locales in your dashboard or gt.config.json. Falling back to "${e}".`;o({severity:`Warning`,whatHappened:`No dictionary was found`,fix:`Pass a dictionary to <GTProvider> or configure a dictionary loader before rendering translations`}),`${a}`;export{s as createUnsupportedLocaleWarning};
+//# sourceMappingURL=errors.esm.min.mjs.map

package/dist/errors.esm.min.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.esm.min.mjs","sources":["../src/errors-dir/constants.ts","../src/errors-dir/createErrors.ts"],"sourcesContent":[null,null],"names":["createUnsupportedLocaleWarning","validatedLocale","newLocale","packageName"],"mappings":"2BAAO,MC6HMA,EAAiC,CAC5CC,EACAC,EACAC,EDhI0B,mCCmIxB,GAAGA,eAAyBD,gHAERD"}
+{"version":3,"file":"errors.esm.min.mjs","names":[],"sources":["../../core/dist/base64-r7YWJYWt.mjs","../src/errors-dir/constants.ts","../src/errors-dir/diagnostics.ts","../src/errors-dir/createErrors.ts"],"sourcesContent":["//#region src/settings/settings.ts\nconst libraryDefaultLocale = \"en\";\nconst defaultTimeout = 6e4;\n//#endregion\n//#region src/logging/diagnostics.ts\nfunction ensureSentence(text) {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return \"\";\n\treturn /[.!?)]$/.test(trimmed) ? trimmed : `${trimmed}.`;\n}\nfunction stripSentence(text) {\n\tconst trimmed = text.trim();\n\tlet end = trimmed.length;\n\twhile (end > 0) {\n\t\tconst char = trimmed[end - 1];\n\t\tif (char !== \".\" && char !== \"!\" && char !== \"?\") break;\n\t\tend -= 1;\n\t}\n\treturn trimmed.slice(0, end);\n}\nfunction lowercaseFirstWord(text) {\n\treturn text.replace(/^[A-Z][a-z]/, (match) => match.toLowerCase());\n}\nfunction formatDetails(details) {\n\tif (!details) return \"\";\n\tconst detailText = Array.isArray(details) ? details.join(\", \") : details;\n\tif (!detailText.trim()) return \"\";\n\treturn ensureSentence(`Details: ${detailText}`);\n}\nfunction formatDiagnosticErrorDetails(error) {\n\tif (error == null) return void 0;\n\treturn String(error);\n}\nfunction createDiagnosticMessage({ source, severity, whatHappened, reassurance, why, fix, wayOut, details, docsUrl }) {\n\tconst prefix = source ? severity ? `${source} ${severity}:` : `${source}:` : severity ? `${severity}:` : \"\";\n\tconst whatAndWhy = why ? `${stripSentence(whatHappened)} because ${lowercaseFirstWord(stripSentence(why))}` : whatHappened;\n\tconst shouldCombineWayOut = !!fix && !!wayOut && /^[a-z]/.test(stripSentence(wayOut));\n\tconst messageParts = [\n\t\twhatAndWhy,\n\t\treassurance,\n\t\tshouldCombineWayOut ? `${stripSentence(fix)}, or ${lowercaseFirstWord(stripSentence(wayOut))}` : fix,\n\t\tshouldCombineWayOut ? void 0 : wayOut,\n\t\tformatDetails(details)\n\t].filter((part) => !!part).map(ensureSentence);\n\tif (docsUrl) messageParts.push(`Learn more: ${docsUrl}`);\n\tconst message = messageParts.join(\" \");\n\treturn prefix ? `${prefix} ${message}` : message;\n}\n//#endregion\n//#region src/settings/settingsUrls.ts\nconst defaultCacheUrl = \"https://cdn.gtx.dev\";\nconst defaultBaseUrl = \"https://api2.gtx.dev\";\nconst defaultRuntimeApiUrl = \"https://runtime2.gtx.dev\";\n//#endregion\n//#region src/utils/isSupportedFileFormatTransform.ts\nconst SUPPORTED_TRANSFORMATIONS = {\n\tGTJSON: [\"GTJSON\"],\n\tJSON: [\"JSON\"],\n\tPO: [\"PO\"],\n\tPOT: [\"POT\", \"PO\"],\n\tYAML: [\"YAML\"],\n\tMDX: [\"MDX\"],\n\tMD: [\"MD\"],\n\tTS: [\"TS\"],\n\tJS: [\"JS\"],\n\tHTML: [\"HTML\"],\n\tTXT: [\"TXT\"],\n\tTWILIO_CONTENT_JSON: [\"TWILIO_CONTENT_JSON\"]\n};\n/**\n* This function checks if a file format transformation is supported during translation\n* @param from - The source file format.\n* @param to - The target file format.\n* @returns True if the transformation is supported, false otherwise\n*/\nfunction isSupportedFileFormatTransform(from, to) {\n\treturn SUPPORTED_TRANSFORMATIONS[from]?.includes(to) ?? false;\n}\n//#endregion\n//#region src/translate/utils/validateFileFormatTransform.ts\n/**\n* Returns a user-facing validation error when a requested file format transform\n* is missing source format context or is not currently supported.\n*/\nfunction getFileFormatTransformError(file) {\n\tif (!file.transformFormat) return void 0;\n\tconst fileLabel = file.fileName ?? file.fileId ?? \"unknown file\";\n\tif (!file.fileFormat) return `fileFormat is required when transformFormat is provided for ${fileLabel}`;\n\tif (!isSupportedFileFormatTransform(file.fileFormat, file.transformFormat)) return `Unsupported file format transform: ${file.fileFormat} -> ${file.transformFormat}`;\n}\n/**\n* Validates file format transforms before sending upload/enqueue requests.\n*/\nfunction validateFileFormatTransforms(files) {\n\tfor (const file of files) {\n\t\tconst error = getFileFormatTransformError(file);\n\t\tif (error) throw new Error(error);\n\t}\n}\n//#endregion\n//#region src/utils/base64.ts\nfunction encode(data) {\n\tif (typeof Buffer !== \"undefined\") return Buffer.from(data, \"utf8\").toString(\"base64\");\n\tconst bytes = new TextEncoder().encode(data);\n\tlet binary = \"\";\n\tfor (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);\n\treturn btoa(binary);\n}\nfunction decode(base64) {\n\tif (typeof Buffer !== \"undefined\") return Buffer.from(base64, \"base64\").toString(\"utf8\");\n\tconst binary = atob(base64);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n\treturn new TextDecoder().decode(bytes);\n}\n//#endregion\nexport { defaultBaseUrl as a, createDiagnosticMessage as c, libraryDefaultLocale as d, isSupportedFileFormatTransform as i, formatDiagnosticErrorDetails as l, encode as n, defaultCacheUrl as o, validateFileFormatTransforms as r, defaultRuntimeApiUrl as s, decode as t, defaultTimeout as u };\n\n//# sourceMappingURL=base64-r7YWJYWt.mjs.map","export const PACKAGE_NAME = '@generaltranslation/react-core';\n","import {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n  type DiagnosticMessageInput,\n} from 'generaltranslation/internal';\nimport { PACKAGE_NAME } from './constants';\n\ntype ReactCoreDiagnosticInput = Omit<DiagnosticMessageInput, 'source'>;\n\nexport function createReactCoreDiagnostic(\n  input: ReactCoreDiagnosticInput\n): string {\n  return createDiagnosticMessage({\n    source: PACKAGE_NAME,\n    ...input,\n  });\n}\n\nexport { formatDiagnosticErrorDetails };\n","import { getLocaleProperties } from '@generaltranslation/format';\nimport {\n  createReactCoreDiagnostic,\n  formatDiagnosticErrorDetails,\n} from './diagnostics';\nimport { PACKAGE_NAME } from './constants';\n\n// ---- ERRORS ---- //\n\nexport const projectIdMissingError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation needs a project ID',\n  fix: 'Add projectId to your <GTProvider> configuration or set GT_PROJECT_ID in your environment',\n  docsUrl: 'https://generaltranslation.com/dashboard',\n});\n\nexport const devApiKeyProductionError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Production environments cannot use a development API key',\n  fix: 'Replace it with a production API key before deploying',\n});\n\nexport const apiKeyInProductionError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'The API key is available to client-side production code',\n  fix: 'Move translation credentials to a server-only environment before deploying',\n});\n\nexport const createNoAuthError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation is not configured',\n  fix: 'Add projectId and devApiKey to your environment, or pass them to <GTProvider> directly',\n});\n\nexport const createPluralMissingError = (children: unknown) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<Plural> could not choose a plural form for \"${children}\"`,\n    fix: 'Pass the required \"n\" option to <Plural>',\n  });\n\nexport const createClientSideTDictionaryCollisionError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<T id=\"${id}\"> conflicts with a dictionary entry using the same ID`,\n    fix: 'Rename the <T> id or the dictionary key so each translation source has a unique ID',\n  });\n\nexport const createClientSideTHydrationError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `<T id=\"${id}\"> is rendering in a client component without a saved translation`,\n    why: 'This can cause hydration mismatches',\n    fix: 'Use a dictionary with useGT() or push translations from the command line before rendering this component on the client',\n  });\n\nexport const dynamicTranslationError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translations could not be loaded',\n  wayOut: 'Source content will render as a fallback',\n  fix: 'Check your runtime translation configuration and try again',\n});\n\nexport const createGenericRuntimeTranslationError = (\n  id: string | undefined,\n  hash: string,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: id\n      ? `Translation could not be found for id \"${id}\" and hash \"${hash}\"`\n      : `Translation could not be found for hash \"${hash}\"`,\n    wayOut: 'Source content will render as a fallback',\n    fix: 'Push translations again or check that runtime translation is configured',\n    details: formatDiagnosticErrorDetails(error),\n  });\n\nexport const runtimeTranslationError = createReactCoreDiagnostic({\n  severity: 'Error',\n  whatHappened: 'Runtime translation could not be completed',\n});\n\nexport const customLoadTranslationsError = (locale: string = '') =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Locally stored translations could not be loaded${locale ? ` for \"${locale}\"` : ''}`,\n    fix: 'If you use loadTranslations(), make sure it returns translations for the requested locale',\n  });\n\nexport const customLoadDictionaryWarning = (locale: string = '') =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `The local dictionary could not be loaded${locale ? ` for \"${locale}\"` : ''}`,\n    fix: 'If you use loadDictionary(), make sure it returns a dictionary for the requested locale',\n  });\n\nexport const missingVariablesError = (variables: string[], message: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `The message \"${message}\" is missing variables: \"${variables.join('\", \"')}\"`,\n    fix: 'Provide values for these variables before rendering the translation',\n  });\n\nexport const createStringRenderError = (\n  message: string,\n  id: string | undefined,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `The string ${id ? `for id \"${id}\" ` : ''}could not be rendered`,\n    fix: `Check the message syntax and variables for: \"${message}\"`,\n    details: formatDiagnosticErrorDetails(error),\n  });\n\nexport const createStringTranslationError = (\n  string: string,\n  id?: string,\n  functionName = 'tx'\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `${functionName}(\"${string}\")${id ? ` with id \"${id}\"` : ''} could not find a translation`,\n    wayOut: 'Source content will render as a fallback',\n    fix: 'Push translations again or check your dictionary/runtime translation configuration',\n  });\n\nexport const invalidLocalesError = (locales: string[]) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'Invalid locale codes in your configuration',\n    fix: 'Specify a list of valid locales or use \"customMapping\" to define aliases for the invalid locales',\n    details: locales,\n  });\n\nexport const invalidCanonicalLocalesError = (locales: string[]) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'Invalid canonical locale codes in your configuration',\n    fix: 'Use valid BCP 47 locale codes before starting translation',\n    details: locales,\n  });\n\nexport const createEmptyIdError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 't.obj() received an empty id',\n    fix: 'Pass a non-empty dictionary id',\n  });\n\nexport const createSubtreeNotFoundError = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Dictionary subtree \"${id}\" could not be found`,\n    fix: 'Check that the id matches your dictionary structure',\n  });\n\nexport const createDictionaryEntryError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: 'A dictionary entry cannot be injected as a subtree',\n    fix: 'Pass a dictionary object instead',\n  });\n\nexport const createCannotInjectDictionaryEntryError = () =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened:\n      'A dictionary entry cannot be merged into another dictionary entry',\n    fix: 'Pass a dictionary subtree instead',\n  });\n\nexport const createInvalidIcuDictionaryEntryError = (id: string | undefined) =>\n  createReactCoreDiagnostic({\n    severity: 'Error',\n    whatHappened: `Dictionary entry \"${id}\" contains invalid ICU syntax`,\n    fix: 'Fix the ICU message before rendering this translation',\n  });\n\n// ---- WARNINGS ---- //\n\nexport const projectIdMissingWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation needs a project ID',\n  fix: 'Add projectId to <GTProvider> or set GT_PROJECT_ID in your environment',\n  docsUrl: 'https://generaltranslation.com/dashboard',\n});\n\nexport const createNoEntryFoundWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `No valid dictionary entry was found for id \"${id}\"`,\n    wayOut: 'Source content will render as a fallback',\n  });\n\nexport const createInvalidDictionaryEntryWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `Dictionary entry \"${id}\" is invalid`,\n    wayOut: 'Source content will render as a fallback until the entry is fixed',\n  });\n\nexport const createInvalidIcuDictionaryEntryWarning = (id: string) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `Dictionary entry \"${id}\" contains invalid ICU syntax`,\n    wayOut: 'Source content will render as a fallback until the entry is fixed',\n  });\n\nexport const createNoEntryTranslationWarning = (\n  id: string,\n  prefixedId: string\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `t(\"${id}\") could not find a translation for dictionary item \"${prefixedId}\"`,\n    wayOut: 'Source content will render as a fallback',\n  });\n\nexport const createMismatchingHashWarning = (\n  expectedHash: string,\n  receivedHash: string\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: 'Translation hashes do not match',\n    reassurance: 'The translation will still render',\n    fix: 'Update your translations to the newest version to avoid stale content',\n    details: [`expected ${expectedHash}`, `received ${receivedHash}`],\n  });\n\nexport const APIKeyMissingWarn = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation needs a development API key',\n  fix: 'Find your development API key at generaltranslation.com/dashboard, or set runtimeUrl to an empty string to disable runtime translation',\n});\n\nexport const createUnsupportedLocalesWarning = (locales: string[]) =>\n  `${PACKAGE_NAME} Warning: The following locales are currently unsupported by our service: ${locales\n    .map((locale) => {\n      const { name } = getLocaleProperties(locale);\n      return `${locale} (${name})`;\n    })\n    .join(', ')}`;\n\nexport const runtimeTranslationTimeoutWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'Runtime translation timed out',\n});\n\nexport const createUnsupportedLocaleWarning = (\n  validatedLocale: string,\n  newLocale: string,\n  packageName: string = PACKAGE_NAME\n) => {\n  return (\n    `${packageName} Warning: \"${newLocale}\" is not a supported locale. ` +\n    `Update supported locales in your dashboard or gt.config.json. ` +\n    `Falling back to \"${validatedLocale}\".`\n  );\n};\n\nexport const dictionaryMissingWarning = createReactCoreDiagnostic({\n  severity: 'Warning',\n  whatHappened: 'No dictionary was found',\n  fix: 'Pass a dictionary to <GTProvider> or configure a dictionary loader before rendering translations',\n});\n\nexport const createStringRenderWarning = (\n  message: string,\n  id: string | undefined,\n  error?: unknown\n) =>\n  createReactCoreDiagnostic({\n    severity: 'Warning',\n    whatHappened: `The string ${id ? `for id \"${id}\" ` : ''}could not be rendered`,\n    wayOut: 'Source content will render as a fallback',\n    fix: `Check the message syntax and variables for: \"${message}\"`,\n    details: formatDiagnosticErrorDetails(error),\n  });\n\n// Unlikely edge case: A <_T> component was injected outside of a <Derive> boundary. This would be caused by the compiler overeagerly injecting <_T> components.\nexport const warnNestedInternalTComponent = `${PACKAGE_NAME} Warning: A <_T> component was found injected outside of a <Derive> boundary. This may affect translation resolution for this component.`;\n"],"mappings":"mCAKA,SAAS,EAAe,EAAM,CAC7B,IAAM,EAAU,EAAK,MAAM,CAE3B,OADK,EACE,UAAU,KAAK,EAAQ,CAAG,EAAU,GAAG,EAAQ,GADjC,GAGtB,SAAS,EAAc,EAAM,CAC5B,IAAM,EAAU,EAAK,MAAM,CACvB,EAAM,EAAQ,OAClB,KAAO,EAAM,GAAG,CACf,IAAM,EAAO,EAAQ,EAAM,GAC3B,GAAI,IAAS,KAAO,IAAS,KAAO,IAAS,IAAK,MAClD,IAED,OAAO,EAAQ,MAAM,EAAG,EAAI,CAE7B,SAAS,EAAmB,EAAM,CACjC,OAAO,EAAK,QAAQ,cAAgB,GAAU,EAAM,aAAa,CAAC,CAEnE,SAAS,EAAc,EAAS,CAC/B,GAAI,CAAC,EAAS,MAAO,GACrB,IAAM,EAAa,MAAM,QAAQ,EAAQ,CAAG,EAAQ,KAAK,KAAK,CAAG,EAEjE,OADK,EAAW,MAAM,CACf,EAAe,YAAY,IAAa,CADhB,GAOhC,SAAS,EAAwB,CAAE,SAAQ,WAAU,eAAc,cAAa,MAAK,MAAK,SAAQ,UAAS,WAAW,CACrH,IAAM,EAAS,EAAS,EAAW,GAAG,EAAO,GAAG,EAAS,GAAK,GAAG,EAAO,GAAK,EAAW,GAAG,EAAS,GAAK,GACnG,EAAa,EAAM,GAAG,EAAc,EAAa,CAAC,WAAW,EAAmB,EAAc,EAAI,CAAC,GAAK,EACxG,EAAsB,CAAC,CAAC,GAAO,CAAC,CAAC,GAAU,SAAS,KAAK,EAAc,EAAO,CAAC,CAC/E,EAAe,CACpB,EACA,EACA,EAAsB,GAAG,EAAc,EAAI,CAAC,OAAO,EAAmB,EAAc,EAAO,CAAC,GAAK,EACjG,EAAsB,IAAK,GAAI,EAC/B,EAAc,EAAQ,CACtB,CAAC,OAAQ,GAAS,CAAC,CAAC,EAAK,CAAC,IAAI,EAAe,CAC1C,GAAS,EAAa,KAAK,eAAe,IAAU,CACxD,IAAM,EAAU,EAAa,KAAK,IAAI,CACtC,OAAO,EAAS,GAAG,EAAO,GAAG,IAAY,EC9C1C,MAAa,EAAe,iCCS5B,SAAgB,EACd,EACQ,CACR,OAAO,EAAwB,CAC7B,OAAQ,EACR,GAAG,EACJ,CAAC,CCNiC,EAA0B,CAC7D,SAAU,QACV,aAAc,yCACd,IAAK,4FACL,QAAS,2CACV,CAAC,CAEsC,EAA0B,CAChE,SAAU,QACV,aAAc,2DACd,IAAK,wDACN,CAAC,CAEqC,EAA0B,CAC/D,SAAU,QACV,aAAc,0DACd,IAAK,6EACN,CAAC,CAE+B,EAA0B,CACzD,SAAU,QACV,aAAc,wCACd,IAAK,yFACN,CAAC,CAwBqC,EAA0B,CAC/D,SAAU,QACV,aAAc,2CACd,OAAQ,2CACR,IAAK,6DACN,CAAC,CAiBqC,EAA0B,CAC/D,SAAU,QACV,aAAc,6CACf,CAAC,CAqGqC,EAA0B,CAC/D,SAAU,UACV,aAAc,yCACd,IAAK,yEACL,QAAS,2CACV,CAAC,CA6C+B,EAA0B,CACzD,SAAU,UACV,aAAc,kDACd,IAAK,yIACN,CAAC,CAU8C,EAA0B,CACxE,SAAU,UACV,aAAc,gCACf,CAAC,CAEF,MAAa,GACX,EACA,EACA,EAAsB,IAGpB,GAAG,EAAY,aAAa,EAAU,8GAElB,EAAgB,IAIA,EAA0B,CAChE,SAAU,UACV,aAAc,0BACd,IAAK,mGACN,CAAC,CAgB0C,GAAG,EAAH"}