gt-next 11.0.7 → 11.0.9

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # gt-next
 
+## 11.0.9
+
+### Patch Changes
+
+- [#1894](https://github.com/generaltranslation/gt/pull/1894) [`0d50450`](https://github.com/generaltranslation/gt/commit/0d50450288bdea5ff4bb6b42f5360ac0b6c4e81d) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Correct the shipped `CompilerOptions.type` documentation to show `none` as the runtime default.
+
+- [#1850](https://github.com/generaltranslation/gt/pull/1850) [`81d0efe`](https://github.com/generaltranslation/gt/commit/81d0efea4540e11ec0fca784ebbc61db3cf28288) Thanks [@bgub](https://github.com/bgub)! - Stop publishing unreachable `index.types` runtime bundles. The `index.types` entry only backs the exports map's `types` conditions, so only its declaration files are ever resolved; the runtime `.cjs`/`.mjs` artifacts (and sourcemaps) were dead weight in the published package (~179KB in gt-react, ~83KB in gt-next). They are now deleted after each build.
+
+- Updated dependencies [[`5d93858`](https://github.com/generaltranslation/gt/commit/5d9385872eb041af0991fc273d5eddd7a032e584), [`81d0efe`](https://github.com/generaltranslation/gt/commit/81d0efea4540e11ec0fca784ebbc61db3cf28288), [`ffa855f`](https://github.com/generaltranslation/gt/commit/ffa855fa929d1c668e75d0c27a99dc704fcb2561), [`da32fa0`](https://github.com/generaltranslation/gt/commit/da32fa05bd718fc55ce418e68678c2d2691d5433), [`8836fbd`](https://github.com/generaltranslation/gt/commit/8836fbda088b5192b2eaa8e2109a724256458bc2), [`5721267`](https://github.com/generaltranslation/gt/commit/57212672a595c8c8578366636767bcbfe8ab6e57), [`b320e17`](https://github.com/generaltranslation/gt/commit/b320e176d581bfade57f0d122f7b95e8e3229cbf), [`8b9b440`](https://github.com/generaltranslation/gt/commit/8b9b4404b703b552b9aa327dc0ae85fce584c97c)]:
+  - generaltranslation@9.0.2
+  - gt-react@11.0.9
+  - @generaltranslation/react-core@11.0.9
+  - @generaltranslation/compiler@1.3.31
+  - gt-i18n@1.0.6
+
+## 11.0.8
+
+### Patch Changes
+
+- [#1881](https://github.com/generaltranslation/gt/pull/1881) [`4ea53d6`](https://github.com/generaltranslation/gt/commit/4ea53d68e0889784d5255c9fc254b79950caace0) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Exclude custom translation IDs from SWC-generated content hashes to match the TypeScript compiler and runtime.
+
+- Updated dependencies [[`7f0fbfe`](https://github.com/generaltranslation/gt/commit/7f0fbfef78f677372d39087252ab8d6c72d78e7e), [`ed53c71`](https://github.com/generaltranslation/gt/commit/ed53c71bc5c6a8d82feaef1b52f68d20b3794c0b), [`3ad93f8`](https://github.com/generaltranslation/gt/commit/3ad93f89da099ef345b707bf37db425662d87e2a)]:
+  - @generaltranslation/compiler@1.3.30
+  - generaltranslation@9.0.1
+  - gt-i18n@1.0.5
+  - gt-react@11.0.8
+  - @generaltranslation/react-core@11.0.8
+
 ## 11.0.7
 
 ### Patch Changes

package/dist/config-dir/props/withGTConfigProps.d.ts

@@ -9,7 +9,7 @@ export type HeadersAndCookies = {
 export type CompilerOptions = {
     /**
      * Which compiler plugin to use: babel, swc, or none
-     * @default 'babel'
+     * @default 'none'
      */
     type: 'babel' | 'swc' | 'none';
     /**

package/dist/config-dir/props/withGTConfigProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"withGTConfigProps.js","names":[],"sources":["../../../src/config-dir/props/withGTConfigProps.ts"],"sourcesContent":["export type HeadersAndCookies = {\n  localeHeaderName?: string;\n  localeCookieName?: string;\n  enableI18nCookieName?: string;\n  referrerLocaleCookieName?: string;\n  localeRoutingEnabledCookieName?: string;\n  resetLocaleCookieName?: string;\n};\n\nexport type CompilerOptions = {\n  /**\n   * Which compiler plugin to use: babel, swc, or none\n   * @default 'babel'\n   */\n  type: 'babel' | 'swc' | 'none';\n  /**\n   * Log level for the compiler plugin.\n   * @default 'warn'\n   */\n  logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';\n  /**\n   * Whether to compile the translations at build time.\n   * @default true\n   */\n  compileTimeHash?: boolean;\n  /**\n   * Whether to disable build checks.\n   * @default false\n   */\n  disableBuildChecks?: boolean;\n};\n\nexport type RenderMethod = 'skeleton' | 'replace' | 'default';\n\nexport const REQUEST_FUNCTION_TO_CONFIG_KEY = {\n  getLocale: 'getLocalePath',\n  getRegion: 'getRegionPath',\n} as const;\n\nexport type BaseWithGTConfigProps = {\n  // Additional top-level keys are forwarded as runtime translation metadata.\n  [key: string]: unknown;\n  // Request scoped filepath\n  dictionary?: string;\n  config?: string;\n  loadTranslationsPath?: string;\n  loadDictionaryPath?: string;\n  // Cloud integration. Credentials are read from environment variables.\n  runtimeUrl?: string | null;\n  cacheUrl?: string | null;\n  cacheExpiryTime?: number;\n  // Locale info\n  locales?: string[];\n  defaultLocale?: string;\n  ignoreBrowserLocales?: boolean;\n  disableInvalidLocaleWarning?: boolean;\n  /** Regular expression source that limits i18n middleware routing by pathname. */\n  pathRegex?: string;\n  // Rendering\n  renderSettings?: {\n    method: RenderMethod;\n    timeout?: number;\n  };\n  // Batching config\n  maxConcurrentRequests?: number;\n  maxBatchSize?: number;\n  batchInterval?: number; // ms\n  // Translation assistance\n  description?: string;\n  // ESLint integration\n  eslint?: boolean; // Enable/disable ESLint config generation (default: true)\n  eslintSeverity?: 'error' | 'warn'; // Severity level for ESLint rules (default: 'warn')\n  overwriteESLintConfig?: boolean; // Allow overwriting existing eslint.config.mjs (default: false)\n  // Other\n  experimentalCompilerOptions?: CompilerOptions;\n  headersAndCookies?: HeadersAndCookies;\n  _usingPlugin?: boolean;\n  // Request function paths\n  getLocalePath?: string;\n  getRegionPath?: string;\n};\n\nexport type withGTConfigProps = BaseWithGTConfigProps & {\n  /** Use GT_API_KEY instead. */\n  apiKey?: never;\n  /** Use NEXT_PUBLIC_GT_DEV_API_KEY or GT_DEV_API_KEY instead. */\n  devApiKey?: never;\n  /** Use NEXT_PUBLIC_GT_PROJECT_ID or GT_PROJECT_ID instead. */\n  projectId?: never;\n};\n"],"mappings":";;AAkCA,MAAa,iCAAiC;CAC5C,WAAW;CACX,WAAW;CACZ"}
+{"version":3,"file":"withGTConfigProps.js","names":[],"sources":["../../../src/config-dir/props/withGTConfigProps.ts"],"sourcesContent":["export type HeadersAndCookies = {\n  localeHeaderName?: string;\n  localeCookieName?: string;\n  enableI18nCookieName?: string;\n  referrerLocaleCookieName?: string;\n  localeRoutingEnabledCookieName?: string;\n  resetLocaleCookieName?: string;\n};\n\nexport type CompilerOptions = {\n  /**\n   * Which compiler plugin to use: babel, swc, or none\n   * @default 'none'\n   */\n  type: 'babel' | 'swc' | 'none';\n  /**\n   * Log level for the compiler plugin.\n   * @default 'warn'\n   */\n  logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';\n  /**\n   * Whether to compile the translations at build time.\n   * @default true\n   */\n  compileTimeHash?: boolean;\n  /**\n   * Whether to disable build checks.\n   * @default false\n   */\n  disableBuildChecks?: boolean;\n};\n\nexport type RenderMethod = 'skeleton' | 'replace' | 'default';\n\nexport const REQUEST_FUNCTION_TO_CONFIG_KEY = {\n  getLocale: 'getLocalePath',\n  getRegion: 'getRegionPath',\n} as const;\n\nexport type BaseWithGTConfigProps = {\n  // Additional top-level keys are forwarded as runtime translation metadata.\n  [key: string]: unknown;\n  // Request scoped filepath\n  dictionary?: string;\n  config?: string;\n  loadTranslationsPath?: string;\n  loadDictionaryPath?: string;\n  // Cloud integration. Credentials are read from environment variables.\n  runtimeUrl?: string | null;\n  cacheUrl?: string | null;\n  cacheExpiryTime?: number;\n  // Locale info\n  locales?: string[];\n  defaultLocale?: string;\n  ignoreBrowserLocales?: boolean;\n  disableInvalidLocaleWarning?: boolean;\n  /** Regular expression source that limits i18n middleware routing by pathname. */\n  pathRegex?: string;\n  // Rendering\n  renderSettings?: {\n    method: RenderMethod;\n    timeout?: number;\n  };\n  // Batching config\n  maxConcurrentRequests?: number;\n  maxBatchSize?: number;\n  batchInterval?: number; // ms\n  // Translation assistance\n  description?: string;\n  // ESLint integration\n  eslint?: boolean; // Enable/disable ESLint config generation (default: true)\n  eslintSeverity?: 'error' | 'warn'; // Severity level for ESLint rules (default: 'warn')\n  overwriteESLintConfig?: boolean; // Allow overwriting existing eslint.config.mjs (default: false)\n  // Other\n  experimentalCompilerOptions?: CompilerOptions;\n  headersAndCookies?: HeadersAndCookies;\n  _usingPlugin?: boolean;\n  // Request function paths\n  getLocalePath?: string;\n  getRegionPath?: string;\n};\n\nexport type withGTConfigProps = BaseWithGTConfigProps & {\n  /** Use GT_API_KEY instead. */\n  apiKey?: never;\n  /** Use NEXT_PUBLIC_GT_DEV_API_KEY or GT_DEV_API_KEY instead. */\n  devApiKey?: never;\n  /** Use NEXT_PUBLIC_GT_PROJECT_ID or GT_PROJECT_ID instead. */\n  projectId?: never;\n};\n"],"mappings":";;AAkCA,MAAa,iCAAiC;CAC5C,WAAW;CACX,WAAW;CACZ"}

package/dist/config-dir/props/withGTConfigProps.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"withGTConfigProps.mjs","names":[],"sources":["../../../src/config-dir/props/withGTConfigProps.ts"],"sourcesContent":["export type HeadersAndCookies = {\n  localeHeaderName?: string;\n  localeCookieName?: string;\n  enableI18nCookieName?: string;\n  referrerLocaleCookieName?: string;\n  localeRoutingEnabledCookieName?: string;\n  resetLocaleCookieName?: string;\n};\n\nexport type CompilerOptions = {\n  /**\n   * Which compiler plugin to use: babel, swc, or none\n   * @default 'babel'\n   */\n  type: 'babel' | 'swc' | 'none';\n  /**\n   * Log level for the compiler plugin.\n   * @default 'warn'\n   */\n  logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';\n  /**\n   * Whether to compile the translations at build time.\n   * @default true\n   */\n  compileTimeHash?: boolean;\n  /**\n   * Whether to disable build checks.\n   * @default false\n   */\n  disableBuildChecks?: boolean;\n};\n\nexport type RenderMethod = 'skeleton' | 'replace' | 'default';\n\nexport const REQUEST_FUNCTION_TO_CONFIG_KEY = {\n  getLocale: 'getLocalePath',\n  getRegion: 'getRegionPath',\n} as const;\n\nexport type BaseWithGTConfigProps = {\n  // Additional top-level keys are forwarded as runtime translation metadata.\n  [key: string]: unknown;\n  // Request scoped filepath\n  dictionary?: string;\n  config?: string;\n  loadTranslationsPath?: string;\n  loadDictionaryPath?: string;\n  // Cloud integration. Credentials are read from environment variables.\n  runtimeUrl?: string | null;\n  cacheUrl?: string | null;\n  cacheExpiryTime?: number;\n  // Locale info\n  locales?: string[];\n  defaultLocale?: string;\n  ignoreBrowserLocales?: boolean;\n  disableInvalidLocaleWarning?: boolean;\n  /** Regular expression source that limits i18n middleware routing by pathname. */\n  pathRegex?: string;\n  // Rendering\n  renderSettings?: {\n    method: RenderMethod;\n    timeout?: number;\n  };\n  // Batching config\n  maxConcurrentRequests?: number;\n  maxBatchSize?: number;\n  batchInterval?: number; // ms\n  // Translation assistance\n  description?: string;\n  // ESLint integration\n  eslint?: boolean; // Enable/disable ESLint config generation (default: true)\n  eslintSeverity?: 'error' | 'warn'; // Severity level for ESLint rules (default: 'warn')\n  overwriteESLintConfig?: boolean; // Allow overwriting existing eslint.config.mjs (default: false)\n  // Other\n  experimentalCompilerOptions?: CompilerOptions;\n  headersAndCookies?: HeadersAndCookies;\n  _usingPlugin?: boolean;\n  // Request function paths\n  getLocalePath?: string;\n  getRegionPath?: string;\n};\n\nexport type withGTConfigProps = BaseWithGTConfigProps & {\n  /** Use GT_API_KEY instead. */\n  apiKey?: never;\n  /** Use NEXT_PUBLIC_GT_DEV_API_KEY or GT_DEV_API_KEY instead. */\n  devApiKey?: never;\n  /** Use NEXT_PUBLIC_GT_PROJECT_ID or GT_PROJECT_ID instead. */\n  projectId?: never;\n};\n"],"mappings":";AAkCA,MAAa,iCAAiC;CAC5C,WAAW;CACX,WAAW;CACZ"}
+{"version":3,"file":"withGTConfigProps.mjs","names":[],"sources":["../../../src/config-dir/props/withGTConfigProps.ts"],"sourcesContent":["export type HeadersAndCookies = {\n  localeHeaderName?: string;\n  localeCookieName?: string;\n  enableI18nCookieName?: string;\n  referrerLocaleCookieName?: string;\n  localeRoutingEnabledCookieName?: string;\n  resetLocaleCookieName?: string;\n};\n\nexport type CompilerOptions = {\n  /**\n   * Which compiler plugin to use: babel, swc, or none\n   * @default 'none'\n   */\n  type: 'babel' | 'swc' | 'none';\n  /**\n   * Log level for the compiler plugin.\n   * @default 'warn'\n   */\n  logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';\n  /**\n   * Whether to compile the translations at build time.\n   * @default true\n   */\n  compileTimeHash?: boolean;\n  /**\n   * Whether to disable build checks.\n   * @default false\n   */\n  disableBuildChecks?: boolean;\n};\n\nexport type RenderMethod = 'skeleton' | 'replace' | 'default';\n\nexport const REQUEST_FUNCTION_TO_CONFIG_KEY = {\n  getLocale: 'getLocalePath',\n  getRegion: 'getRegionPath',\n} as const;\n\nexport type BaseWithGTConfigProps = {\n  // Additional top-level keys are forwarded as runtime translation metadata.\n  [key: string]: unknown;\n  // Request scoped filepath\n  dictionary?: string;\n  config?: string;\n  loadTranslationsPath?: string;\n  loadDictionaryPath?: string;\n  // Cloud integration. Credentials are read from environment variables.\n  runtimeUrl?: string | null;\n  cacheUrl?: string | null;\n  cacheExpiryTime?: number;\n  // Locale info\n  locales?: string[];\n  defaultLocale?: string;\n  ignoreBrowserLocales?: boolean;\n  disableInvalidLocaleWarning?: boolean;\n  /** Regular expression source that limits i18n middleware routing by pathname. */\n  pathRegex?: string;\n  // Rendering\n  renderSettings?: {\n    method: RenderMethod;\n    timeout?: number;\n  };\n  // Batching config\n  maxConcurrentRequests?: number;\n  maxBatchSize?: number;\n  batchInterval?: number; // ms\n  // Translation assistance\n  description?: string;\n  // ESLint integration\n  eslint?: boolean; // Enable/disable ESLint config generation (default: true)\n  eslintSeverity?: 'error' | 'warn'; // Severity level for ESLint rules (default: 'warn')\n  overwriteESLintConfig?: boolean; // Allow overwriting existing eslint.config.mjs (default: false)\n  // Other\n  experimentalCompilerOptions?: CompilerOptions;\n  headersAndCookies?: HeadersAndCookies;\n  _usingPlugin?: boolean;\n  // Request function paths\n  getLocalePath?: string;\n  getRegionPath?: string;\n};\n\nexport type withGTConfigProps = BaseWithGTConfigProps & {\n  /** Use GT_API_KEY instead. */\n  apiKey?: never;\n  /** Use NEXT_PUBLIC_GT_DEV_API_KEY or GT_DEV_API_KEY instead. */\n  devApiKey?: never;\n  /** Use NEXT_PUBLIC_GT_PROJECT_ID or GT_PROJECT_ID instead. */\n  projectId?: never;\n};\n"],"mappings":";AAkCA,MAAa,iCAAiC;CAC5C,WAAW;CACX,WAAW;CACZ"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "gt-next",
-  "version": "11.0.7",
+  "version": "11.0.9",
   "description": "A Next.js library for automatic internationalization.",
   "main": "dist/index.server.js",
   "peerDependencies": {
-    "@generaltranslation/compiler": "^1.3.29",
+    "@generaltranslation/compiler": "^1.3.31",
     "next": ">=13.0.0 <15.2.1 || >15.2.2",
     "react": ">=16.8.0 <20.0.0",
     "react-dom": ">=16.8.0 <20.0.0"
@@ -29,10 +29,10 @@
   ],
   "dependencies": {
     "@generaltranslation/format": "0.1.2",
-    "@generaltranslation/react-core": "11.0.7",
-    "generaltranslation": "9.0.0",
-    "gt-react": "11.0.7",
-    "gt-i18n": "1.0.4"
+    "@generaltranslation/react-core": "11.0.9",
+    "generaltranslation": "9.0.2",
+    "gt-react": "11.0.9",
+    "gt-i18n": "1.0.6"
   },
   "repository": {
     "type": "git",
@@ -52,7 +52,7 @@
     "next": "15.2.3",
     "tsdown": "^0.21.10",
     "typescript": "^5.9.2",
-    "@generaltranslation/compiler": "1.3.29"
+    "@generaltranslation/compiler": "1.3.31"
   },
   "exports": {
     ".": {

package/dist/index.types.js

@@ -1,507 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./_virtual/_rolldown/runtime.js");
-const require_errors_createErrors = require("./errors/createErrors.js");
-let _generaltranslation_react_core_pure = require("@generaltranslation/react-core/pure");
-let gt_react = require("gt-react");
-//#region src/index.types.ts
-/**
-* Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.
-*
-* @param {React.ReactNode} children - The children components that will use the translation context.
-* @param {string} id - ID of a nested dictionary, so that only a subset of a large dictionary needs to be sent to the client.
-* @param {string} locale - The locale to use for the translation context.
-*
-* @returns {JSX.Element} The provider component for General Translation context.
-*/
-function GTProvider(_) {
-	throw new Error(require_errors_createErrors.typesFileError);
-}
-/**
-* Build-time translation component that renders its children in the user's given locale.
-*
-* @example
-* ```jsx
-* // Basic usage:
-* <T id="welcome_message">
-*  Hello, <Var>{name}</Var>!
-* </T>
-* ```
-*
-* @example
-* ```jsx
-* // Translating a plural
-* <T id="item_count">
-*  <Plural n={3} singular={<>You have <Num children={n}/> item.</>}>
-*      You have <Num children={n}/> items.
-*  </Plural>
-* </T>
-* ```
-*
-* @param {React.ReactNode} children - The content to be translated or displayed.
-* @param {string} [id] - Optional identifier for the translation string. If not provided, a hash will be generated from the content.
-* @param {any} [context] - Additional context for translation key generation.
-*
-* @returns {JSX.Element} The rendered translation or fallback content based on the provided configuration.
-*
-* @throws {Error} If a plural translation is requested but the `n` option is not provided.
-*/
-const T = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-T._gtt = "translate";
-/**
-* The `<Currency>` component renders a formatted currency string, allowing customization of name, default value, currency type, and formatting options.
-*
-* @example
-* ```jsx
-* <Currency
-*    currency="USD"
-* >
-*    1000
-* </Currency>
-* ```
-*
-* @param {any} [children] - Optional content to render inside the currency component.
-* @param {string} [currency] - The currency type (e.g., USD, EUR, etc.).
-* @param {Intl.NumberFormatOptions} [options] - Optional formatting options to customize how the currency is displayed.
-* @returns {React.JSX.Element} The formatted currency component.
-*/
-const Currency = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Currency._gtt = "variable-currency";
-/**
-* The `<DateTime>` component renders a formatted date or time string, allowing customization of the name, default value, and formatting options.
-* It utilizes the current locale and optional format settings to display the date.
-*
-* @example
-* ```jsx
-* <DateTime>
-*    {new Date()}
-* </DateTime>
-* ```
-*
-* @param {any} [children] - Optional content (typically a date) to render inside the component.
-* @param {Intl.DateTimeFormatOptions} [options={}] - Optional formatting options for the date, following `Intl.DateTimeFormatOptions` specifications.
-* @returns {Promise<React.JSX.Element>} The formatted date or time component.
-*/
-const DateTime = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-DateTime._gtt = "variable-datetime";
-/**
-* The `<RelativeTime>` component renders a localized relative time string
-* (e.g., "2 hours ago", "in 3 days") using `Intl.RelativeTimeFormat`.
-*
-* @example
-* ```jsx
-* <RelativeTime date={someDate} />
-* ```
-*
-* @param {Date} [date] - A date to compute relative time from now.
-* @param {number} [value] - Explicit numeric value. Requires `unit`.
-* @param {Intl.RelativeTimeFormatUnit} [unit] - The unit of time.
-* @param {Date} [baseDate] - Base date for computing relative time. Defaults to `new Date()` at render time. Required for hydration safety.
-* @param {Intl.RelativeTimeFormatOptions} [options={}] - Formatting options.
-* @returns {Promise<React.JSX.Element>} The formatted relative time component.
-*/
-const RelativeTime = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-RelativeTime._gtt = "variable-relative-time";
-/**
-* The `<Num>` component renders a formatted number string, allowing customization of the name, default value, and formatting options.
-* It formats the number according to the current locale and optionally passed formatting options.
-*
-* @example
-* ```jsx
-* <Num
-*    options={{ style: "decimal", maximumFractionDigits: 2 }}
-* >
-*    1000
-* </Num>
-* ```
-*
-* @param {any} [children] - Optional content (typically a number) to render inside the component.
-* @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options for the number, following `Intl.NumberFormatOptions` specifications.
-* @returns {React.JSX.Element} The formatted number component.
-*/
-const Num = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Num._gtt = "variable-number";
-/**
-* The `<Var>` component renders a variable value, which can either be passed as `children` or a `value`.
-* If `children` is provided, it will be used; otherwise, the `value` is rendered.
-*
-* @example
-* ```jsx
-* <Var>
-*    John
-* </Var>
-* ```
-*
-* @param {any} [children] - The content to render inside the component. If provided, it will take precedence over `value`.
-* @returns {React.JSX.Element} The rendered variable component with either `children` or `value`.
-*/
-const Var = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Var._gtt = "variable-variable";
-/**
-* Marks JSX children as derivable by the GT compiler and CLI.
-*
-* Use `<Derive>` inside translated JSX when child content is computed from
-* source code, but should still be discovered during extraction instead of
-* treated as a runtime interpolation variable. The CLI attempts to resolve the
-* derivable children into every possible static value and includes those values
-* in the source content that gets translated.
-*
-* `<Derive>` renders its children unchanged at runtime.
-*
-* Run `gt validate` after adding or changing `<Derive>` usage to verify that
-* each derivable expression can be resolved by the CLI before translating or
-* building.
-*
-* @example
-* ```jsx
-* function getSubject() {
-*   return (Math.random() > 0.5) ? "Alice" : "Brian";
-* }
-* ...
-* <T>
-*   <Derive>
-*      {getSubject()}
-*   </Derive>
-*   is going to school today.
-* </T>
-* ```
-*
-* @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.
-* @returns {T} The same children, unchanged at runtime.
-*/
-const Derive = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Derive._gtt = "derive";
-/**
-* The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.
-* It allows for flexible content switching based on the `branch` prop and an object of possible branches (`...branches`).
-* If the specified `branch` is present in the `branches` object, it renders the content of that branch.
-* If the `branch` is not found, it renders the provided `children` as fallback content.
-*
-* @example
-* ```jsx
-* <Branch
-*  branch="summary"
-* summary={<p>This is a summary</p>}
-* details={<p>Details here</p>}
-* >
-*   <p>Fallback content</p>
-* </Branch>
-* ```
-* If the `branch` prop is set to `"summary"`, it will render `<p>This is a summary</p>`. If the `branch` is not set or does not match any keys in the branches object, it renders the fallback content `<p>Fallback content</p>`.
-*
-* @param {any} [children] - Fallback content to render if no matching branch is found.
-* @param {string} [name="branch"] - Optional name for the component, used for metadata or tracking purposes.
-* @param {string} [branch] - The name of the branch to render. The component looks for this key in the `...branches` object.
-* @param {...{[key: string]: any}} [branches] - A spread object containing possible branches as keys and their corresponding content as values.
-* @returns {React.JSX.Element} The rendered branch or fallback content.
-*/
-const Branch = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Branch._gtt = "branch";
-/**
-* The `<Plural>` component dynamically renders content based on the plural form of the given number (`n`).
-* It determines which content to display by matching the value of `n` to the appropriate pluralization branch,
-* based on the current locale or a default locale. If no matching plural branch is found, the component renders
-* the fallback `children` content.
-*
-* @example
-* ```jsx
-* <Plural
-*  n={1}
-*  one="There is 1 item"
-*  other="There are {n} items"
-* />
-* ```
-* In this example, if `n` is 1, it renders `"There is 1 item"`. If `n` is a different number, it renders
-* `"There are {n} items"`.
-*
-* @param {any} [children] - Fallback content to render if no matching plural branch is found.
-* @param {number} [n] - The number used to determine the plural form. This is required for pluralization to work.
-* @param {string} [locale] - Optional parameter, the locale to use for pluralization format.
-* @param {...{[key: string]: any}} [branches] - A spread object containing possible plural branches, typically including `one` for singular
-* and `other` for plural forms, but it may vary depending on the locale.
-* @returns {React.JSX.Element} The rendered content corresponding to the plural form of `n`, or the fallback content.
-* @throws {Error} If `n` is not provided or not a valid number.
-*/
-const Plural = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Plural._gtt = "plural";
-/**
-* A dropdown component that allows users to select a locale.
-* @param {string[]} locales - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.
-* @param {object} customNames - An optional object to map locales to custom names.
-* @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
-*/
-const LocaleSelector = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* A dropdown component that allows users to select a region.
-* @param {string[]} regions - An optional list of ISO 3166 region codes to use for the dropdown. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.
-* @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.
-*/
-const RegionSelector = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Resolve the user's locale from a Next Pages Router server-side request.
-*
-* @param context - The GetServerSideProps context for the request.
-* @returns The resolved locale.
-*/
-function parseLocale(_) {
-	throw new Error(require_errors_createErrors.typesFileError);
-}
-/**
-* Wraps a Pages Router `getServerSideProps` function and adds the resolved GT
-* locale and translations snapshot to returned page props.
-*/
-function withGTServerSideProps(_) {
-	throw new Error(require_errors_createErrors.typesFileError);
-}
-/**
-* Wraps a Pages Router `getStaticProps` function and adds the generated locale
-* and its translation snapshot. The default locale uses an empty snapshot.
-*/
-const withGTStaticProps = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Checks whether a locale is valid and supported by the current gt-next config.
-*
-* @param locale - The locale candidate to validate.
-* @returns True when the locale resolves to one of the configured locales.
-*/
-function isLocaleSupported(_) {
-	throw new Error(require_errors_createErrors.typesFileError);
-}
-/**
-* Returns the string translation function `t`.
-*
-* @returns {Function} A translation function that accepts an ICU format string and returns that ICU format string translated.
-* @param {GTTranslationOptions} [options] - Translation options including variables and special `$`-prefixed options.
-* @param {string} [options.$context] - Additional context for the translation.
-* @param {string} [options.$id] - Optional identifier for the translation string.
-* @param {number} [options.$maxChars] - Maximum number of characters for the translated message.
-* @param {boolean} [options.$requiresReview] - Whether the translated message requires approval before use. Must be a boolean literal.
-* @param {StringFormat} [options.$format] - The data format for the message (e.g., 'ICU', 'STRING'). Defaults to 'ICU'.
-*
-* @example
-* const t = useGT();
-* console.log(t('To be or not to be...'));
-*
-* const t = useGT();
-* return (<>
-*  {
-*     t('My name is {customName}', { customName: "Brian" } )
-*  }
-* </>);
-*
-*/
-const useGT = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the dictionary access function `t`.
-*
-* @param {string} [id] - Optional prefix to prepend to the translation keys.
-* @returns {Function} A translation function that accepts a key string and returns the translated value.
-* The returned function accepts interpolation variables.
-*
-* @example
-* const t = useTranslations('user');
-* console.log(t('name')); // Translates item 'user.name'
-*
-* const t = useTranslations();
-* console.log(t('hello')); // Translates item 'hello'
-*/
-const useTranslations = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the user's current locale.
-*
-* @returns {string} BCP 47 locale tag, e.g., 'en-US'.
-*
-* @example
-* const locale = useLocale();
-* console.log(locale); // 'en-US'
-*/
-const useLocale = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-const useSetLocale = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-const useLocaleSelector = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the user's current region.
-*
-* @returns {string | undefined} ISO 3166 region code, e.g., 'US', or undefined if not set.
-*
-* @example
-* const region = useRegion();
-* console.log(region); // 'US'
-*/
-const useRegion = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the user's list of supported locales.
-*
-* @returns {string[]} List of BCP 47 locale tags, e.g., ['en-US', 'fr', 'jp'].
-*
-* @example
-* const locales = useLocales();
-* console.log(locale); // ['en-US', 'fr', 'jp]
-*/
-const useLocales = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the application's default locale.
-*
-* If no default locale is provided, it defaults to 'en'.
-*
-* @returns {string} A BCP 47 locale tag, e.g., 'en-US'.
-*
-* @example
-* const locale = useDefaultLocale();
-* console.log(locale); // 'en-US'
-*/
-const useDefaultLocale = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Returns the locale properties for the given locale.
-*
-* @param {string} locale - The locale to get the properties for.
-* @returns {LocaleProperties} The locale properties for the given locale.
-*
-* @example
-* const localeProperties = useLocaleProperties('en-US');
-* console.log(localeProperties);
-*/
-const useLocaleProperties = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Retrieves the text direction ('ltr' or 'rtl') for the current or specified locale from the `<GTProvider>` context.
-*
-* If no locale is provided, the direction for the current user's locale is returned.
-*
-* @param {string} [locale] - Optional locale code (e.g., 'ar', 'en-US'). If omitted, uses the current locale from context.
-* @returns {'ltr' | 'rtl'} The text direction for the locale: 'rtl' for right-to-left languages, otherwise 'ltr'.
-*
-* @example
-* const dir = useLocaleDirection(); // e.g., 'ltr'
-* const arabicDir = useLocaleDirection('ar'); // 'rtl'
-*/
-const useLocaleDirection = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-/**
-* Registers a message to be translated. Returns the message unchanged if no options are provided.
-* @param {string | string[]} message The message to encode.
-* @param {GTTranslationOptions} [options] The options to encode.
-* @returns The message or array of messages.
-*
-* @note - This function registers the message before the build process. The actual translation does not
-* occur until the m() function is invoked.
-*
-* @note - Message format
-* A message is broken into two parts separated by colons:
-* - interpolated content - the content with interpolated variables
-* - hash + options - a unique identifier for the source content and options for the translation
-*
-* @example - Basic usage
-*
-* const message1 = msg('Hello, World!');
-* console.log(message1); // "Hello, World!"
-*
-* const message2 = msg('Hello, {name}!', { name: 'Brian' });
-* console.log(message2); // "Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9"
-*
-* @example - Array usage
-*
-* const messages = msg(['Hello, Alice!', 'Hello, Bob!']);
-* console.log(messages); // ["Hello, Alice!", "Hello, Bob!"]
-*
-* @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`
-* const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });
-* // "Hello, Alice!" id: "greetings.0"
-* // "Hello, Bob!" id: "greetings.1"
-*/
-const useMessages = () => {
-	throw new Error(require_errors_createErrors.typesFileError);
-};
-//#endregion
-exports.Branch = Branch;
-exports.Currency = Currency;
-exports.DateTime = DateTime;
-exports.Derive = Derive;
-exports.GTProvider = GTProvider;
-exports.LocaleSelector = LocaleSelector;
-exports.Num = Num;
-exports.Plural = Plural;
-exports.RegionSelector = RegionSelector;
-exports.RelativeTime = RelativeTime;
-exports.T = T;
-exports.Var = Var;
-exports.declareVar = _generaltranslation_react_core_pure.declareVar;
-exports.decodeMsg = _generaltranslation_react_core_pure.decodeMsg;
-exports.decodeOptions = _generaltranslation_react_core_pure.decodeOptions;
-exports.decodeVars = _generaltranslation_react_core_pure.decodeVars;
-exports.derive = _generaltranslation_react_core_pure.derive;
-exports.getDefaultLocale = gt_react.getDefaultLocale;
-exports.getLocaleProperties = gt_react.getLocaleProperties;
-exports.getLocales = gt_react.getLocales;
-exports.getTranslationsSnapshot = gt_react.getTranslationsSnapshot;
-exports.getVersionId = gt_react.getVersionId;
-exports.gtFallback = _generaltranslation_react_core_pure.gtFallback;
-exports.isLocaleSupported = isLocaleSupported;
-exports.mFallback = _generaltranslation_react_core_pure.mFallback;
-exports.msg = _generaltranslation_react_core_pure.msg;
-exports.parseLocale = parseLocale;
-exports.resolveCanonicalLocale = gt_react.resolveCanonicalLocale;
-exports.useDefaultLocale = useDefaultLocale;
-exports.useGT = useGT;
-exports.useLocale = useLocale;
-exports.useLocaleDirection = useLocaleDirection;
-exports.useLocaleProperties = useLocaleProperties;
-exports.useLocaleSelector = useLocaleSelector;
-exports.useLocales = useLocales;
-exports.useMessages = useMessages;
-exports.useRegion = useRegion;
-exports.useSetLocale = useSetLocale;
-exports.useTranslations = useTranslations;
-exports.withGTServerSideProps = withGTServerSideProps;
-exports.withGTStaticProps = withGTStaticProps;
-
-//# sourceMappingURL=index.types.js.map

package/dist/index.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.types.js","names":["typesFileError"],"sources":["../src/index.types.ts"],"sourcesContent":["import { typesFileError } from './errors/createErrors';\nimport { T as _T } from './server-dir/buildtime/T';\nimport type {\n  GetServerSideProps,\n  GetServerSidePropsContext,\n  PreviewData,\n} from 'next';\nimport type { ParsedUrlQuery } from 'querystring';\nimport type { WithGTServerSideProps } from './pages-dir/withGTServerSideProps';\nimport type {\n  WithGTStaticProps,\n  WithGTStaticPropsFunction,\n} from './pages-dir/withGTStaticProps';\nimport {\n  useTranslations as _useTranslations,\n  useLocale as _useLocale,\n  useRegion as _useRegion,\n  useLocales as _useLocales,\n  useDefaultLocale as _useDefaultLocale,\n  useLocaleProperties as _useLocaleProperties,\n  Currency as _Currency,\n  DateTime as _DateTime,\n  RelativeTime as _RelativeTime,\n  Num as _Num,\n  Var as _Var,\n  Branch as _Branch,\n  Plural as _Plural,\n  Derive as _Derive,\n  useLocaleDirection as _useLocaleDirection,\n} from 'gt-react';\nimport {\n  LocaleSelector as _LocaleSelector,\n  RegionSelector as _RegionSelector,\n  useSetLocale as _useSetLocale,\n  useLocaleSelector as _useLocaleSelector,\n  getTranslationsSnapshot,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n} from 'gt-react';\nimport { GTProvider as _GTProvider } from 'gt-react';\nimport type { GTTranslationOptions, RuntimeTranslationOptions } from 'gt-react';\nimport type { StringFormat } from '@generaltranslation/format/types';\nimport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n} from '@generaltranslation/react-core/pure';\n\ntype Message = {\n  message: string;\n  $id?: string;\n  $context?: string;\n  $maxChars?: number;\n  $_hash?: string;\n};\ntype Messages = Message[];\n\n/**\n * Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.\n *\n * @param {React.ReactNode} children - The children components that will use the translation context.\n * @param {string} id - ID of a nested dictionary, so that only a subset of a large dictionary needs to be sent to the client.\n * @param {string} locale - The locale to use for the translation context.\n *\n * @returns {JSX.Element} The provider component for General Translation context.\n */\nexport function GTProvider(\n  _: {\n    id?: string;\n  } & Partial<Parameters<typeof _GTProvider>[0]>\n): React.ReactNode {\n  throw new Error(typesFileError);\n}\n\n/**\n * Build-time translation component that renders its children in the user's given locale.\n *\n * @example\n * ```jsx\n * // Basic usage:\n * <T id=\"welcome_message\">\n *  Hello, <Var>{name}</Var>!\n * </T>\n * ```\n *\n * @example\n * ```jsx\n * // Translating a plural\n * <T id=\"item_count\">\n *  <Plural n={3} singular={<>You have <Num children={n}/> item.</>}>\n *      You have <Num children={n}/> items.\n *  </Plural>\n * </T>\n * ```\n *\n * @param {React.ReactNode} children - The content to be translated or displayed.\n * @param {string} [id] - Optional identifier for the translation string. If not provided, a hash will be generated from the content.\n * @param {any} [context] - Additional context for translation key generation.\n *\n * @returns {JSX.Element} The rendered translation or fallback content based on the provided configuration.\n *\n * @throws {Error} If a plural translation is requested but the `n` option is not provided.\n */\nexport const T: typeof _T = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate';\n\n/**\n * The `<Currency>` component renders a formatted currency string, allowing customization of name, default value, currency type, and formatting options.\n *\n * @example\n * ```jsx\n * <Currency\n *    currency=\"USD\"\n * >\n *    1000\n * </Currency>\n * ```\n *\n * @param {any} [children] - Optional content to render inside the currency component.\n * @param {string} [currency] - The currency type (e.g., USD, EUR, etc.).\n * @param {Intl.NumberFormatOptions} [options] - Optional formatting options to customize how the currency is displayed.\n * @returns {React.JSX.Element} The formatted currency component.\n */\nexport const Currency: typeof _Currency = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nCurrency._gtt = 'variable-currency';\n\n/**\n * The `<DateTime>` component renders a formatted date or time string, allowing customization of the name, default value, and formatting options.\n * It utilizes the current locale and optional format settings to display the date.\n *\n * @example\n * ```jsx\n * <DateTime>\n *    {new Date()}\n * </DateTime>\n * ```\n *\n * @param {any} [children] - Optional content (typically a date) to render inside the component.\n * @param {Intl.DateTimeFormatOptions} [options={}] - Optional formatting options for the date, following `Intl.DateTimeFormatOptions` specifications.\n * @returns {Promise<React.JSX.Element>} The formatted date or time component.\n */\nexport const DateTime: typeof _DateTime = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nDateTime._gtt = 'variable-datetime';\n\n/**\n * The `<RelativeTime>` component renders a localized relative time string\n * (e.g., \"2 hours ago\", \"in 3 days\") using `Intl.RelativeTimeFormat`.\n *\n * @example\n * ```jsx\n * <RelativeTime date={someDate} />\n * ```\n *\n * @param {Date} [date] - A date to compute relative time from now.\n * @param {number} [value] - Explicit numeric value. Requires `unit`.\n * @param {Intl.RelativeTimeFormatUnit} [unit] - The unit of time.\n * @param {Date} [baseDate] - Base date for computing relative time. Defaults to `new Date()` at render time. Required for hydration safety.\n * @param {Intl.RelativeTimeFormatOptions} [options={}] - Formatting options.\n * @returns {Promise<React.JSX.Element>} The formatted relative time component.\n */\nexport const RelativeTime: typeof _RelativeTime = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nRelativeTime._gtt = 'variable-relative-time';\n\n/**\n * The `<Num>` component renders a formatted number string, allowing customization of the name, default value, and formatting options.\n * It formats the number according to the current locale and optionally passed formatting options.\n *\n * @example\n * ```jsx\n * <Num\n *    options={{ style: \"decimal\", maximumFractionDigits: 2 }}\n * >\n *    1000\n * </Num>\n * ```\n *\n * @param {any} [children] - Optional content (typically a number) to render inside the component.\n * @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options for the number, following `Intl.NumberFormatOptions` specifications.\n * @returns {React.JSX.Element} The formatted number component.\n */\nexport const Num: typeof _Num = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nNum._gtt = 'variable-number';\n\n/**\n * The `<Var>` component renders a variable value, which can either be passed as `children` or a `value`.\n * If `children` is provided, it will be used; otherwise, the `value` is rendered.\n *\n * @example\n * ```jsx\n * <Var>\n *    John\n * </Var>\n * ```\n *\n * @param {any} [children] - The content to render inside the component. If provided, it will take precedence over `value`.\n * @returns {React.JSX.Element} The rendered variable component with either `children` or `value`.\n */\nexport const Var: typeof _Var = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nVar._gtt = 'variable-variable';\n\n/**\n * Marks JSX children as derivable by the GT compiler and CLI.\n *\n * Use `<Derive>` inside translated JSX when child content is computed from\n * source code, but should still be discovered during extraction instead of\n * treated as a runtime interpolation variable. The CLI attempts to resolve the\n * derivable children into every possible static value and includes those values\n * in the source content that gets translated.\n *\n * `<Derive>` renders its children unchanged at runtime.\n *\n * Run `gt validate` after adding or changing `<Derive>` usage to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * <T>\n *   <Derive>\n *      {getSubject()}\n *   </Derive>\n *   is going to school today.\n * </T>\n * ```\n *\n * @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.\n * @returns {T} The same children, unchanged at runtime.\n */\nexport const Derive: typeof _Derive = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nDerive._gtt = 'derive';\n\n/**\n * The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.\n * It allows for flexible content switching based on the `branch` prop and an object of possible branches (`...branches`).\n * If the specified `branch` is present in the `branches` object, it renders the content of that branch.\n * If the `branch` is not found, it renders the provided `children` as fallback content.\n *\n * @example\n * ```jsx\n * <Branch\n *  branch=\"summary\"\n * summary={<p>This is a summary</p>}\n * details={<p>Details here</p>}\n * >\n *   <p>Fallback content</p>\n * </Branch>\n * ```\n * If the `branch` prop is set to `\"summary\"`, it will render `<p>This is a summary</p>`. If the `branch` is not set or does not match any keys in the branches object, it renders the fallback content `<p>Fallback content</p>`.\n *\n * @param {any} [children] - Fallback content to render if no matching branch is found.\n * @param {string} [name=\"branch\"] - Optional name for the component, used for metadata or tracking purposes.\n * @param {string} [branch] - The name of the branch to render. The component looks for this key in the `...branches` object.\n * @param {...{[key: string]: any}} [branches] - A spread object containing possible branches as keys and their corresponding content as values.\n * @returns {React.JSX.Element} The rendered branch or fallback content.\n */\nexport const Branch: typeof _Branch = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nBranch._gtt = 'branch';\n\n/**\n * The `<Plural>` component dynamically renders content based on the plural form of the given number (`n`).\n * It determines which content to display by matching the value of `n` to the appropriate pluralization branch,\n * based on the current locale or a default locale. If no matching plural branch is found, the component renders\n * the fallback `children` content.\n *\n * @example\n * ```jsx\n * <Plural\n *  n={1}\n *  one=\"There is 1 item\"\n *  other=\"There are {n} items\"\n * />\n * ```\n * In this example, if `n` is 1, it renders `\"There is 1 item\"`. If `n` is a different number, it renders\n * `\"There are {n} items\"`.\n *\n * @param {any} [children] - Fallback content to render if no matching plural branch is found.\n * @param {number} [n] - The number used to determine the plural form. This is required for pluralization to work.\n * @param {string} [locale] - Optional parameter, the locale to use for pluralization format.\n * @param {...{[key: string]: any}} [branches] - A spread object containing possible plural branches, typically including `one` for singular\n * and `other` for plural forms, but it may vary depending on the locale.\n * @returns {React.JSX.Element} The rendered content corresponding to the plural form of `n`, or the fallback content.\n * @throws {Error} If `n` is not provided or not a valid number.\n */\nexport const Plural: typeof _Plural = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nPlural._gtt = 'plural';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} locales - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\n * @param {object} customNames - An optional object to map locales to custom names.\n * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.\n */\nexport const LocaleSelector: typeof _LocaleSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} regions - An optional list of ISO 3166 region codes to use for the dropdown. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n */\nexport const RegionSelector: typeof _RegionSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Resolve the user's locale from a Next Pages Router server-side request.\n *\n * @param context - The GetServerSideProps context for the request.\n * @returns The resolved locale.\n */\nexport function parseLocale<\n  Params extends ParsedUrlQuery = ParsedUrlQuery,\n  Preview extends PreviewData = PreviewData,\n>(_: GetServerSidePropsContext<Params, Preview>): string {\n  throw new Error(typesFileError);\n}\n\n/**\n * Wraps a Pages Router `getServerSideProps` function and adds the resolved GT\n * locale and translations snapshot to returned page props.\n */\nexport function withGTServerSideProps<\n  Props extends Record<string, unknown> = Record<string, unknown>,\n  Params extends ParsedUrlQuery = ParsedUrlQuery,\n  Preview extends PreviewData = PreviewData,\n>(\n  _?: GetServerSideProps<Props, Params, Preview>\n): GetServerSideProps<WithGTServerSideProps<Props>, Params, Preview> {\n  throw new Error(typesFileError);\n}\n\n/**\n * Wraps a Pages Router `getStaticProps` function and adds the generated locale\n * and its translation snapshot. The default locale uses an empty snapshot.\n */\nexport const withGTStaticProps: WithGTStaticPropsFunction = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Checks whether a locale is valid and supported by the current gt-next config.\n *\n * @param locale - The locale candidate to validate.\n * @returns True when the locale resolves to one of the configured locales.\n */\nexport function isLocaleSupported(_: unknown): boolean {\n  throw new Error(typesFileError);\n}\n\n/**\n * Returns the string translation function `t`.\n *\n * @returns {Function} A translation function that accepts an ICU format string and returns that ICU format string translated.\n * @param {GTTranslationOptions} [options] - Translation options including variables and special `$`-prefixed options.\n * @param {string} [options.$context] - Additional context for the translation.\n * @param {string} [options.$id] - Optional identifier for the translation string.\n * @param {number} [options.$maxChars] - Maximum number of characters for the translated message.\n * @param {boolean} [options.$requiresReview] - Whether the translated message requires approval before use. Must be a boolean literal.\n * @param {StringFormat} [options.$format] - The data format for the message (e.g., 'ICU', 'STRING'). Defaults to 'ICU'.\n *\n * @example\n * const t = useGT();\n * console.log(t('To be or not to be...'));\n *\n * const t = useGT();\n * return (<>\n *  {\n *     t('My name is {customName}', { customName: \"Brian\" } )\n *  }\n * </>);\n *\n */\nexport const useGT: (\n  _messages?: Messages\n) => (message: string, options?: GTTranslationOptions) => string = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the dictionary access function `t`.\n *\n * @param {string} [id] - Optional prefix to prepend to the translation keys.\n * @returns {Function} A translation function that accepts a key string and returns the translated value.\n * The returned function accepts interpolation variables.\n *\n * @example\n * const t = useTranslations('user');\n * console.log(t('name')); // Translates item 'user.name'\n *\n * const t = useTranslations();\n * console.log(t('hello')); // Translates item 'hello'\n */\nexport const useTranslations: typeof _useTranslations = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's current locale.\n *\n * @returns {string} BCP 47 locale tag, e.g., 'en-US'.\n *\n * @example\n * const locale = useLocale();\n * console.log(locale); // 'en-US'\n */\nexport const useLocale: typeof _useLocale = () => {\n  throw new Error(typesFileError);\n};\n\nexport const useSetLocale: typeof _useSetLocale = () => {\n  throw new Error(typesFileError);\n};\n\nexport const useLocaleSelector: typeof _useLocaleSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's current region.\n *\n * @returns {string | undefined} ISO 3166 region code, e.g., 'US', or undefined if not set.\n *\n * @example\n * const region = useRegion();\n * console.log(region); // 'US'\n */\nexport const useRegion: typeof _useRegion = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's list of supported locales.\n *\n * @returns {string[]} List of BCP 47 locale tags, e.g., ['en-US', 'fr', 'jp'].\n *\n * @example\n * const locales = useLocales();\n * console.log(locale); // ['en-US', 'fr', 'jp]\n */\nexport const useLocales: typeof _useLocales = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the application's default locale.\n *\n * If no default locale is provided, it defaults to 'en'.\n *\n * @returns {string} A BCP 47 locale tag, e.g., 'en-US'.\n *\n * @example\n * const locale = useDefaultLocale();\n * console.log(locale); // 'en-US'\n */\nexport const useDefaultLocale: typeof _useDefaultLocale = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the locale properties for the given locale.\n *\n * @param {string} locale - The locale to get the properties for.\n * @returns {LocaleProperties} The locale properties for the given locale.\n *\n * @example\n * const localeProperties = useLocaleProperties('en-US');\n * console.log(localeProperties);\n */\nexport const useLocaleProperties: typeof _useLocaleProperties = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Retrieves the text direction ('ltr' or 'rtl') for the current or specified locale from the `<GTProvider>` context.\n *\n * If no locale is provided, the direction for the current user's locale is returned.\n *\n * @param {string} [locale] - Optional locale code (e.g., 'ar', 'en-US'). If omitted, uses the current locale from context.\n * @returns {'ltr' | 'rtl'} The text direction for the locale: 'rtl' for right-to-left languages, otherwise 'ltr'.\n *\n * @example\n * const dir = useLocaleDirection(); // e.g., 'ltr'\n * const arabicDir = useLocaleDirection('ar'); // 'rtl'\n */\nexport const useLocaleDirection: typeof _useLocaleDirection = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {GTTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n */\nexport const useMessages: (\n  _messages?: Messages\n) => <T extends string | null | undefined>(\n  encodedMsg: T,\n  options?: GTTranslationOptions\n) => T extends string ? string : T = () => {\n  throw new Error(typesFileError);\n};\n\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n  WithGTServerSideProps,\n  WithGTStaticProps,\n};\n\nexport type { StringFormat };\n\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  mFallback,\n  gtFallback,\n  derive,\n  declareVar,\n  decodeVars,\n  getTranslationsSnapshot,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n};\n"],"mappings":";;;;;;;;;;;;;;;AA0EA,SAAgB,WACd,GAGiB;AACjB,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCjC,MAAa,UAAqB;AAChC,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,EAAE,OAAO;;;;;;;;;;;;;;;;;;AAmBT,MAAa,iBAAmC;AAC9C,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,SAAS,OAAO;;;;;;;;;;;;;;;;AAiBhB,MAAa,iBAAmC;AAC9C,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,SAAS,OAAO;;;;;;;;;;;;;;;;;AAkBhB,MAAa,qBAA2C;AACtD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,aAAa,OAAO;;;;;;;;;;;;;;;;;;AAmBpB,MAAa,YAAyB;AACpC,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,IAAI,OAAO;;;;;;;;;;;;;;;AAgBX,MAAa,YAAyB;AACpC,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCX,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;AA0Bd,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2Bd,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;AAQd,MAAa,uBAA+C;AAC1D,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;AAQjC,MAAa,uBAA+C;AAC1D,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;AASjC,SAAgB,YAGd,GAAuD;AACvD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;AAOjC,SAAgB,sBAKd,GACmE;AACnE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;AAOjC,MAAa,0BAAqD;AAChE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;AASjC,SAAgB,kBAAkB,GAAqB;AACrD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;AA0BjC,MAAa,cAE4D;AACvE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;;;;AAiBjC,MAAa,wBAAiD;AAC5D,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;AAYjC,MAAa,kBAAqC;AAChD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;AAGjC,MAAa,qBAA2C;AACtD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;AAGjC,MAAa,0BAAqD;AAChE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;AAYjC,MAAa,kBAAqC;AAChD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;AAYjC,MAAa,mBAAuC;AAClD,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;AAcjC,MAAa,yBAAmD;AAC9D,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;AAajC,MAAa,4BAAyD;AACpE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;;AAejC,MAAa,2BAAuD;AAClE,OAAM,IAAI,MAAMA,4BAAAA,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCjC,MAAa,oBAK8B;AACzC,OAAM,IAAI,MAAMA,4BAAAA,eAAe"}

package/dist/index.types.mjs

@@ -1,465 +0,0 @@
-import { typesFileError } from "./errors/createErrors.mjs";
-import { declareVar, decodeMsg, decodeOptions, decodeVars, derive, gtFallback, mFallback, msg } from "@generaltranslation/react-core/pure";
-import { getDefaultLocale, getLocaleProperties, getLocales, getTranslationsSnapshot, getVersionId, resolveCanonicalLocale } from "gt-react";
-//#region src/index.types.ts
-/**
-* Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.
-*
-* @param {React.ReactNode} children - The children components that will use the translation context.
-* @param {string} id - ID of a nested dictionary, so that only a subset of a large dictionary needs to be sent to the client.
-* @param {string} locale - The locale to use for the translation context.
-*
-* @returns {JSX.Element} The provider component for General Translation context.
-*/
-function GTProvider(_) {
-	throw new Error(typesFileError);
-}
-/**
-* Build-time translation component that renders its children in the user's given locale.
-*
-* @example
-* ```jsx
-* // Basic usage:
-* <T id="welcome_message">
-*  Hello, <Var>{name}</Var>!
-* </T>
-* ```
-*
-* @example
-* ```jsx
-* // Translating a plural
-* <T id="item_count">
-*  <Plural n={3} singular={<>You have <Num children={n}/> item.</>}>
-*      You have <Num children={n}/> items.
-*  </Plural>
-* </T>
-* ```
-*
-* @param {React.ReactNode} children - The content to be translated or displayed.
-* @param {string} [id] - Optional identifier for the translation string. If not provided, a hash will be generated from the content.
-* @param {any} [context] - Additional context for translation key generation.
-*
-* @returns {JSX.Element} The rendered translation or fallback content based on the provided configuration.
-*
-* @throws {Error} If a plural translation is requested but the `n` option is not provided.
-*/
-const T = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-T._gtt = "translate";
-/**
-* The `<Currency>` component renders a formatted currency string, allowing customization of name, default value, currency type, and formatting options.
-*
-* @example
-* ```jsx
-* <Currency
-*    currency="USD"
-* >
-*    1000
-* </Currency>
-* ```
-*
-* @param {any} [children] - Optional content to render inside the currency component.
-* @param {string} [currency] - The currency type (e.g., USD, EUR, etc.).
-* @param {Intl.NumberFormatOptions} [options] - Optional formatting options to customize how the currency is displayed.
-* @returns {React.JSX.Element} The formatted currency component.
-*/
-const Currency = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Currency._gtt = "variable-currency";
-/**
-* The `<DateTime>` component renders a formatted date or time string, allowing customization of the name, default value, and formatting options.
-* It utilizes the current locale and optional format settings to display the date.
-*
-* @example
-* ```jsx
-* <DateTime>
-*    {new Date()}
-* </DateTime>
-* ```
-*
-* @param {any} [children] - Optional content (typically a date) to render inside the component.
-* @param {Intl.DateTimeFormatOptions} [options={}] - Optional formatting options for the date, following `Intl.DateTimeFormatOptions` specifications.
-* @returns {Promise<React.JSX.Element>} The formatted date or time component.
-*/
-const DateTime = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-DateTime._gtt = "variable-datetime";
-/**
-* The `<RelativeTime>` component renders a localized relative time string
-* (e.g., "2 hours ago", "in 3 days") using `Intl.RelativeTimeFormat`.
-*
-* @example
-* ```jsx
-* <RelativeTime date={someDate} />
-* ```
-*
-* @param {Date} [date] - A date to compute relative time from now.
-* @param {number} [value] - Explicit numeric value. Requires `unit`.
-* @param {Intl.RelativeTimeFormatUnit} [unit] - The unit of time.
-* @param {Date} [baseDate] - Base date for computing relative time. Defaults to `new Date()` at render time. Required for hydration safety.
-* @param {Intl.RelativeTimeFormatOptions} [options={}] - Formatting options.
-* @returns {Promise<React.JSX.Element>} The formatted relative time component.
-*/
-const RelativeTime = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-RelativeTime._gtt = "variable-relative-time";
-/**
-* The `<Num>` component renders a formatted number string, allowing customization of the name, default value, and formatting options.
-* It formats the number according to the current locale and optionally passed formatting options.
-*
-* @example
-* ```jsx
-* <Num
-*    options={{ style: "decimal", maximumFractionDigits: 2 }}
-* >
-*    1000
-* </Num>
-* ```
-*
-* @param {any} [children] - Optional content (typically a number) to render inside the component.
-* @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options for the number, following `Intl.NumberFormatOptions` specifications.
-* @returns {React.JSX.Element} The formatted number component.
-*/
-const Num = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Num._gtt = "variable-number";
-/**
-* The `<Var>` component renders a variable value, which can either be passed as `children` or a `value`.
-* If `children` is provided, it will be used; otherwise, the `value` is rendered.
-*
-* @example
-* ```jsx
-* <Var>
-*    John
-* </Var>
-* ```
-*
-* @param {any} [children] - The content to render inside the component. If provided, it will take precedence over `value`.
-* @returns {React.JSX.Element} The rendered variable component with either `children` or `value`.
-*/
-const Var = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Var._gtt = "variable-variable";
-/**
-* Marks JSX children as derivable by the GT compiler and CLI.
-*
-* Use `<Derive>` inside translated JSX when child content is computed from
-* source code, but should still be discovered during extraction instead of
-* treated as a runtime interpolation variable. The CLI attempts to resolve the
-* derivable children into every possible static value and includes those values
-* in the source content that gets translated.
-*
-* `<Derive>` renders its children unchanged at runtime.
-*
-* Run `gt validate` after adding or changing `<Derive>` usage to verify that
-* each derivable expression can be resolved by the CLI before translating or
-* building.
-*
-* @example
-* ```jsx
-* function getSubject() {
-*   return (Math.random() > 0.5) ? "Alice" : "Brian";
-* }
-* ...
-* <T>
-*   <Derive>
-*      {getSubject()}
-*   </Derive>
-*   is going to school today.
-* </T>
-* ```
-*
-* @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.
-* @returns {T} The same children, unchanged at runtime.
-*/
-const Derive = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Derive._gtt = "derive";
-/**
-* The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.
-* It allows for flexible content switching based on the `branch` prop and an object of possible branches (`...branches`).
-* If the specified `branch` is present in the `branches` object, it renders the content of that branch.
-* If the `branch` is not found, it renders the provided `children` as fallback content.
-*
-* @example
-* ```jsx
-* <Branch
-*  branch="summary"
-* summary={<p>This is a summary</p>}
-* details={<p>Details here</p>}
-* >
-*   <p>Fallback content</p>
-* </Branch>
-* ```
-* If the `branch` prop is set to `"summary"`, it will render `<p>This is a summary</p>`. If the `branch` is not set or does not match any keys in the branches object, it renders the fallback content `<p>Fallback content</p>`.
-*
-* @param {any} [children] - Fallback content to render if no matching branch is found.
-* @param {string} [name="branch"] - Optional name for the component, used for metadata or tracking purposes.
-* @param {string} [branch] - The name of the branch to render. The component looks for this key in the `...branches` object.
-* @param {...{[key: string]: any}} [branches] - A spread object containing possible branches as keys and their corresponding content as values.
-* @returns {React.JSX.Element} The rendered branch or fallback content.
-*/
-const Branch = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Branch._gtt = "branch";
-/**
-* The `<Plural>` component dynamically renders content based on the plural form of the given number (`n`).
-* It determines which content to display by matching the value of `n` to the appropriate pluralization branch,
-* based on the current locale or a default locale. If no matching plural branch is found, the component renders
-* the fallback `children` content.
-*
-* @example
-* ```jsx
-* <Plural
-*  n={1}
-*  one="There is 1 item"
-*  other="There are {n} items"
-* />
-* ```
-* In this example, if `n` is 1, it renders `"There is 1 item"`. If `n` is a different number, it renders
-* `"There are {n} items"`.
-*
-* @param {any} [children] - Fallback content to render if no matching plural branch is found.
-* @param {number} [n] - The number used to determine the plural form. This is required for pluralization to work.
-* @param {string} [locale] - Optional parameter, the locale to use for pluralization format.
-* @param {...{[key: string]: any}} [branches] - A spread object containing possible plural branches, typically including `one` for singular
-* and `other` for plural forms, but it may vary depending on the locale.
-* @returns {React.JSX.Element} The rendered content corresponding to the plural form of `n`, or the fallback content.
-* @throws {Error} If `n` is not provided or not a valid number.
-*/
-const Plural = () => {
-	throw new Error(typesFileError);
-};
-/** @internal _gtt - The GT transformation for the component. */
-Plural._gtt = "plural";
-/**
-* A dropdown component that allows users to select a locale.
-* @param {string[]} locales - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.
-* @param {object} customNames - An optional object to map locales to custom names.
-* @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.
-*/
-const LocaleSelector = () => {
-	throw new Error(typesFileError);
-};
-/**
-* A dropdown component that allows users to select a region.
-* @param {string[]} regions - An optional list of ISO 3166 region codes to use for the dropdown. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.
-* @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.
-*/
-const RegionSelector = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Resolve the user's locale from a Next Pages Router server-side request.
-*
-* @param context - The GetServerSideProps context for the request.
-* @returns The resolved locale.
-*/
-function parseLocale(_) {
-	throw new Error(typesFileError);
-}
-/**
-* Wraps a Pages Router `getServerSideProps` function and adds the resolved GT
-* locale and translations snapshot to returned page props.
-*/
-function withGTServerSideProps(_) {
-	throw new Error(typesFileError);
-}
-/**
-* Wraps a Pages Router `getStaticProps` function and adds the generated locale
-* and its translation snapshot. The default locale uses an empty snapshot.
-*/
-const withGTStaticProps = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Checks whether a locale is valid and supported by the current gt-next config.
-*
-* @param locale - The locale candidate to validate.
-* @returns True when the locale resolves to one of the configured locales.
-*/
-function isLocaleSupported(_) {
-	throw new Error(typesFileError);
-}
-/**
-* Returns the string translation function `t`.
-*
-* @returns {Function} A translation function that accepts an ICU format string and returns that ICU format string translated.
-* @param {GTTranslationOptions} [options] - Translation options including variables and special `$`-prefixed options.
-* @param {string} [options.$context] - Additional context for the translation.
-* @param {string} [options.$id] - Optional identifier for the translation string.
-* @param {number} [options.$maxChars] - Maximum number of characters for the translated message.
-* @param {boolean} [options.$requiresReview] - Whether the translated message requires approval before use. Must be a boolean literal.
-* @param {StringFormat} [options.$format] - The data format for the message (e.g., 'ICU', 'STRING'). Defaults to 'ICU'.
-*
-* @example
-* const t = useGT();
-* console.log(t('To be or not to be...'));
-*
-* const t = useGT();
-* return (<>
-*  {
-*     t('My name is {customName}', { customName: "Brian" } )
-*  }
-* </>);
-*
-*/
-const useGT = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the dictionary access function `t`.
-*
-* @param {string} [id] - Optional prefix to prepend to the translation keys.
-* @returns {Function} A translation function that accepts a key string and returns the translated value.
-* The returned function accepts interpolation variables.
-*
-* @example
-* const t = useTranslations('user');
-* console.log(t('name')); // Translates item 'user.name'
-*
-* const t = useTranslations();
-* console.log(t('hello')); // Translates item 'hello'
-*/
-const useTranslations = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the user's current locale.
-*
-* @returns {string} BCP 47 locale tag, e.g., 'en-US'.
-*
-* @example
-* const locale = useLocale();
-* console.log(locale); // 'en-US'
-*/
-const useLocale = () => {
-	throw new Error(typesFileError);
-};
-const useSetLocale = () => {
-	throw new Error(typesFileError);
-};
-const useLocaleSelector = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the user's current region.
-*
-* @returns {string | undefined} ISO 3166 region code, e.g., 'US', or undefined if not set.
-*
-* @example
-* const region = useRegion();
-* console.log(region); // 'US'
-*/
-const useRegion = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the user's list of supported locales.
-*
-* @returns {string[]} List of BCP 47 locale tags, e.g., ['en-US', 'fr', 'jp'].
-*
-* @example
-* const locales = useLocales();
-* console.log(locale); // ['en-US', 'fr', 'jp]
-*/
-const useLocales = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the application's default locale.
-*
-* If no default locale is provided, it defaults to 'en'.
-*
-* @returns {string} A BCP 47 locale tag, e.g., 'en-US'.
-*
-* @example
-* const locale = useDefaultLocale();
-* console.log(locale); // 'en-US'
-*/
-const useDefaultLocale = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Returns the locale properties for the given locale.
-*
-* @param {string} locale - The locale to get the properties for.
-* @returns {LocaleProperties} The locale properties for the given locale.
-*
-* @example
-* const localeProperties = useLocaleProperties('en-US');
-* console.log(localeProperties);
-*/
-const useLocaleProperties = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Retrieves the text direction ('ltr' or 'rtl') for the current or specified locale from the `<GTProvider>` context.
-*
-* If no locale is provided, the direction for the current user's locale is returned.
-*
-* @param {string} [locale] - Optional locale code (e.g., 'ar', 'en-US'). If omitted, uses the current locale from context.
-* @returns {'ltr' | 'rtl'} The text direction for the locale: 'rtl' for right-to-left languages, otherwise 'ltr'.
-*
-* @example
-* const dir = useLocaleDirection(); // e.g., 'ltr'
-* const arabicDir = useLocaleDirection('ar'); // 'rtl'
-*/
-const useLocaleDirection = () => {
-	throw new Error(typesFileError);
-};
-/**
-* Registers a message to be translated. Returns the message unchanged if no options are provided.
-* @param {string | string[]} message The message to encode.
-* @param {GTTranslationOptions} [options] The options to encode.
-* @returns The message or array of messages.
-*
-* @note - This function registers the message before the build process. The actual translation does not
-* occur until the m() function is invoked.
-*
-* @note - Message format
-* A message is broken into two parts separated by colons:
-* - interpolated content - the content with interpolated variables
-* - hash + options - a unique identifier for the source content and options for the translation
-*
-* @example - Basic usage
-*
-* const message1 = msg('Hello, World!');
-* console.log(message1); // "Hello, World!"
-*
-* const message2 = msg('Hello, {name}!', { name: 'Brian' });
-* console.log(message2); // "Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9"
-*
-* @example - Array usage
-*
-* const messages = msg(['Hello, Alice!', 'Hello, Bob!']);
-* console.log(messages); // ["Hello, Alice!", "Hello, Bob!"]
-*
-* @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`
-* const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });
-* // "Hello, Alice!" id: "greetings.0"
-* // "Hello, Bob!" id: "greetings.1"
-*/
-const useMessages = () => {
-	throw new Error(typesFileError);
-};
-//#endregion
-export { Branch, Currency, DateTime, Derive, GTProvider, LocaleSelector, Num, Plural, RegionSelector, RelativeTime, T, Var, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getLocaleProperties, getLocales, getTranslationsSnapshot, getVersionId, gtFallback, isLocaleSupported, mFallback, msg, parseLocale, resolveCanonicalLocale, useDefaultLocale, useGT, useLocale, useLocaleDirection, useLocaleProperties, useLocaleSelector, useLocales, useMessages, useRegion, useSetLocale, useTranslations, withGTServerSideProps, withGTStaticProps };
-
-//# sourceMappingURL=index.types.mjs.map

package/dist/index.types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.types.mjs","names":[],"sources":["../src/index.types.ts"],"sourcesContent":["import { typesFileError } from './errors/createErrors';\nimport { T as _T } from './server-dir/buildtime/T';\nimport type {\n  GetServerSideProps,\n  GetServerSidePropsContext,\n  PreviewData,\n} from 'next';\nimport type { ParsedUrlQuery } from 'querystring';\nimport type { WithGTServerSideProps } from './pages-dir/withGTServerSideProps';\nimport type {\n  WithGTStaticProps,\n  WithGTStaticPropsFunction,\n} from './pages-dir/withGTStaticProps';\nimport {\n  useTranslations as _useTranslations,\n  useLocale as _useLocale,\n  useRegion as _useRegion,\n  useLocales as _useLocales,\n  useDefaultLocale as _useDefaultLocale,\n  useLocaleProperties as _useLocaleProperties,\n  Currency as _Currency,\n  DateTime as _DateTime,\n  RelativeTime as _RelativeTime,\n  Num as _Num,\n  Var as _Var,\n  Branch as _Branch,\n  Plural as _Plural,\n  Derive as _Derive,\n  useLocaleDirection as _useLocaleDirection,\n} from 'gt-react';\nimport {\n  LocaleSelector as _LocaleSelector,\n  RegionSelector as _RegionSelector,\n  useSetLocale as _useSetLocale,\n  useLocaleSelector as _useLocaleSelector,\n  getTranslationsSnapshot,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n} from 'gt-react';\nimport { GTProvider as _GTProvider } from 'gt-react';\nimport type { GTTranslationOptions, RuntimeTranslationOptions } from 'gt-react';\nimport type { StringFormat } from '@generaltranslation/format/types';\nimport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  derive,\n  declareVar,\n  decodeVars,\n  mFallback,\n  gtFallback,\n} from '@generaltranslation/react-core/pure';\n\ntype Message = {\n  message: string;\n  $id?: string;\n  $context?: string;\n  $maxChars?: number;\n  $_hash?: string;\n};\ntype Messages = Message[];\n\n/**\n * Provides General Translation context to its children, which can then access `useGT`, `useLocale`, and `useDefaultLocale`.\n *\n * @param {React.ReactNode} children - The children components that will use the translation context.\n * @param {string} id - ID of a nested dictionary, so that only a subset of a large dictionary needs to be sent to the client.\n * @param {string} locale - The locale to use for the translation context.\n *\n * @returns {JSX.Element} The provider component for General Translation context.\n */\nexport function GTProvider(\n  _: {\n    id?: string;\n  } & Partial<Parameters<typeof _GTProvider>[0]>\n): React.ReactNode {\n  throw new Error(typesFileError);\n}\n\n/**\n * Build-time translation component that renders its children in the user's given locale.\n *\n * @example\n * ```jsx\n * // Basic usage:\n * <T id=\"welcome_message\">\n *  Hello, <Var>{name}</Var>!\n * </T>\n * ```\n *\n * @example\n * ```jsx\n * // Translating a plural\n * <T id=\"item_count\">\n *  <Plural n={3} singular={<>You have <Num children={n}/> item.</>}>\n *      You have <Num children={n}/> items.\n *  </Plural>\n * </T>\n * ```\n *\n * @param {React.ReactNode} children - The content to be translated or displayed.\n * @param {string} [id] - Optional identifier for the translation string. If not provided, a hash will be generated from the content.\n * @param {any} [context] - Additional context for translation key generation.\n *\n * @returns {JSX.Element} The rendered translation or fallback content based on the provided configuration.\n *\n * @throws {Error} If a plural translation is requested but the `n` option is not provided.\n */\nexport const T: typeof _T = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nT._gtt = 'translate';\n\n/**\n * The `<Currency>` component renders a formatted currency string, allowing customization of name, default value, currency type, and formatting options.\n *\n * @example\n * ```jsx\n * <Currency\n *    currency=\"USD\"\n * >\n *    1000\n * </Currency>\n * ```\n *\n * @param {any} [children] - Optional content to render inside the currency component.\n * @param {string} [currency] - The currency type (e.g., USD, EUR, etc.).\n * @param {Intl.NumberFormatOptions} [options] - Optional formatting options to customize how the currency is displayed.\n * @returns {React.JSX.Element} The formatted currency component.\n */\nexport const Currency: typeof _Currency = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nCurrency._gtt = 'variable-currency';\n\n/**\n * The `<DateTime>` component renders a formatted date or time string, allowing customization of the name, default value, and formatting options.\n * It utilizes the current locale and optional format settings to display the date.\n *\n * @example\n * ```jsx\n * <DateTime>\n *    {new Date()}\n * </DateTime>\n * ```\n *\n * @param {any} [children] - Optional content (typically a date) to render inside the component.\n * @param {Intl.DateTimeFormatOptions} [options={}] - Optional formatting options for the date, following `Intl.DateTimeFormatOptions` specifications.\n * @returns {Promise<React.JSX.Element>} The formatted date or time component.\n */\nexport const DateTime: typeof _DateTime = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nDateTime._gtt = 'variable-datetime';\n\n/**\n * The `<RelativeTime>` component renders a localized relative time string\n * (e.g., \"2 hours ago\", \"in 3 days\") using `Intl.RelativeTimeFormat`.\n *\n * @example\n * ```jsx\n * <RelativeTime date={someDate} />\n * ```\n *\n * @param {Date} [date] - A date to compute relative time from now.\n * @param {number} [value] - Explicit numeric value. Requires `unit`.\n * @param {Intl.RelativeTimeFormatUnit} [unit] - The unit of time.\n * @param {Date} [baseDate] - Base date for computing relative time. Defaults to `new Date()` at render time. Required for hydration safety.\n * @param {Intl.RelativeTimeFormatOptions} [options={}] - Formatting options.\n * @returns {Promise<React.JSX.Element>} The formatted relative time component.\n */\nexport const RelativeTime: typeof _RelativeTime = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nRelativeTime._gtt = 'variable-relative-time';\n\n/**\n * The `<Num>` component renders a formatted number string, allowing customization of the name, default value, and formatting options.\n * It formats the number according to the current locale and optionally passed formatting options.\n *\n * @example\n * ```jsx\n * <Num\n *    options={{ style: \"decimal\", maximumFractionDigits: 2 }}\n * >\n *    1000\n * </Num>\n * ```\n *\n * @param {any} [children] - Optional content (typically a number) to render inside the component.\n * @param {Intl.NumberFormatOptions} [options={}] - Optional formatting options for the number, following `Intl.NumberFormatOptions` specifications.\n * @returns {React.JSX.Element} The formatted number component.\n */\nexport const Num: typeof _Num = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nNum._gtt = 'variable-number';\n\n/**\n * The `<Var>` component renders a variable value, which can either be passed as `children` or a `value`.\n * If `children` is provided, it will be used; otherwise, the `value` is rendered.\n *\n * @example\n * ```jsx\n * <Var>\n *    John\n * </Var>\n * ```\n *\n * @param {any} [children] - The content to render inside the component. If provided, it will take precedence over `value`.\n * @returns {React.JSX.Element} The rendered variable component with either `children` or `value`.\n */\nexport const Var: typeof _Var = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nVar._gtt = 'variable-variable';\n\n/**\n * Marks JSX children as derivable by the GT compiler and CLI.\n *\n * Use `<Derive>` inside translated JSX when child content is computed from\n * source code, but should still be discovered during extraction instead of\n * treated as a runtime interpolation variable. The CLI attempts to resolve the\n * derivable children into every possible static value and includes those values\n * in the source content that gets translated.\n *\n * `<Derive>` renders its children unchanged at runtime.\n *\n * Run `gt validate` after adding or changing `<Derive>` usage to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * <T>\n *   <Derive>\n *      {getSubject()}\n *   </Derive>\n *   is going to school today.\n * </T>\n * ```\n *\n * @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.\n * @returns {T} The same children, unchanged at runtime.\n */\nexport const Derive: typeof _Derive = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nDerive._gtt = 'derive';\n\n/**\n * The `<Branch>` component dynamically renders a specified branch of content or a fallback child component.\n * It allows for flexible content switching based on the `branch` prop and an object of possible branches (`...branches`).\n * If the specified `branch` is present in the `branches` object, it renders the content of that branch.\n * If the `branch` is not found, it renders the provided `children` as fallback content.\n *\n * @example\n * ```jsx\n * <Branch\n *  branch=\"summary\"\n * summary={<p>This is a summary</p>}\n * details={<p>Details here</p>}\n * >\n *   <p>Fallback content</p>\n * </Branch>\n * ```\n * If the `branch` prop is set to `\"summary\"`, it will render `<p>This is a summary</p>`. If the `branch` is not set or does not match any keys in the branches object, it renders the fallback content `<p>Fallback content</p>`.\n *\n * @param {any} [children] - Fallback content to render if no matching branch is found.\n * @param {string} [name=\"branch\"] - Optional name for the component, used for metadata or tracking purposes.\n * @param {string} [branch] - The name of the branch to render. The component looks for this key in the `...branches` object.\n * @param {...{[key: string]: any}} [branches] - A spread object containing possible branches as keys and their corresponding content as values.\n * @returns {React.JSX.Element} The rendered branch or fallback content.\n */\nexport const Branch: typeof _Branch = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nBranch._gtt = 'branch';\n\n/**\n * The `<Plural>` component dynamically renders content based on the plural form of the given number (`n`).\n * It determines which content to display by matching the value of `n` to the appropriate pluralization branch,\n * based on the current locale or a default locale. If no matching plural branch is found, the component renders\n * the fallback `children` content.\n *\n * @example\n * ```jsx\n * <Plural\n *  n={1}\n *  one=\"There is 1 item\"\n *  other=\"There are {n} items\"\n * />\n * ```\n * In this example, if `n` is 1, it renders `\"There is 1 item\"`. If `n` is a different number, it renders\n * `\"There are {n} items\"`.\n *\n * @param {any} [children] - Fallback content to render if no matching plural branch is found.\n * @param {number} [n] - The number used to determine the plural form. This is required for pluralization to work.\n * @param {string} [locale] - Optional parameter, the locale to use for pluralization format.\n * @param {...{[key: string]: any}} [branches] - A spread object containing possible plural branches, typically including `one` for singular\n * and `other` for plural forms, but it may vary depending on the locale.\n * @returns {React.JSX.Element} The rendered content corresponding to the plural form of `n`, or the fallback content.\n * @throws {Error} If `n` is not provided or not a valid number.\n */\nexport const Plural: typeof _Plural = () => {\n  throw new Error(typesFileError);\n};\n/** @internal _gtt - The GT transformation for the component. */\nPlural._gtt = 'plural';\n\n/**\n * A dropdown component that allows users to select a locale.\n * @param {string[]} locales - An optional list of locales to use for the dropdown. If not provided, the list of locales from the `<GTProvider>` context is used.\n * @param {object} customNames - An optional object to map locales to custom names.\n * @returns {React.ReactElement | null} The rendered locale dropdown component or null to prevent rendering.\n */\nexport const LocaleSelector: typeof _LocaleSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * A dropdown component that allows users to select a region.\n * @param {string[]} regions - An optional list of ISO 3166 region codes to use for the dropdown. If not provided, regions are inferred from the supported locales in the `<GTProvider>` context.\n * @returns {React.ReactElement | null} The rendered region dropdown component or null to prevent rendering.\n */\nexport const RegionSelector: typeof _RegionSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Resolve the user's locale from a Next Pages Router server-side request.\n *\n * @param context - The GetServerSideProps context for the request.\n * @returns The resolved locale.\n */\nexport function parseLocale<\n  Params extends ParsedUrlQuery = ParsedUrlQuery,\n  Preview extends PreviewData = PreviewData,\n>(_: GetServerSidePropsContext<Params, Preview>): string {\n  throw new Error(typesFileError);\n}\n\n/**\n * Wraps a Pages Router `getServerSideProps` function and adds the resolved GT\n * locale and translations snapshot to returned page props.\n */\nexport function withGTServerSideProps<\n  Props extends Record<string, unknown> = Record<string, unknown>,\n  Params extends ParsedUrlQuery = ParsedUrlQuery,\n  Preview extends PreviewData = PreviewData,\n>(\n  _?: GetServerSideProps<Props, Params, Preview>\n): GetServerSideProps<WithGTServerSideProps<Props>, Params, Preview> {\n  throw new Error(typesFileError);\n}\n\n/**\n * Wraps a Pages Router `getStaticProps` function and adds the generated locale\n * and its translation snapshot. The default locale uses an empty snapshot.\n */\nexport const withGTStaticProps: WithGTStaticPropsFunction = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Checks whether a locale is valid and supported by the current gt-next config.\n *\n * @param locale - The locale candidate to validate.\n * @returns True when the locale resolves to one of the configured locales.\n */\nexport function isLocaleSupported(_: unknown): boolean {\n  throw new Error(typesFileError);\n}\n\n/**\n * Returns the string translation function `t`.\n *\n * @returns {Function} A translation function that accepts an ICU format string and returns that ICU format string translated.\n * @param {GTTranslationOptions} [options] - Translation options including variables and special `$`-prefixed options.\n * @param {string} [options.$context] - Additional context for the translation.\n * @param {string} [options.$id] - Optional identifier for the translation string.\n * @param {number} [options.$maxChars] - Maximum number of characters for the translated message.\n * @param {boolean} [options.$requiresReview] - Whether the translated message requires approval before use. Must be a boolean literal.\n * @param {StringFormat} [options.$format] - The data format for the message (e.g., 'ICU', 'STRING'). Defaults to 'ICU'.\n *\n * @example\n * const t = useGT();\n * console.log(t('To be or not to be...'));\n *\n * const t = useGT();\n * return (<>\n *  {\n *     t('My name is {customName}', { customName: \"Brian\" } )\n *  }\n * </>);\n *\n */\nexport const useGT: (\n  _messages?: Messages\n) => (message: string, options?: GTTranslationOptions) => string = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the dictionary access function `t`.\n *\n * @param {string} [id] - Optional prefix to prepend to the translation keys.\n * @returns {Function} A translation function that accepts a key string and returns the translated value.\n * The returned function accepts interpolation variables.\n *\n * @example\n * const t = useTranslations('user');\n * console.log(t('name')); // Translates item 'user.name'\n *\n * const t = useTranslations();\n * console.log(t('hello')); // Translates item 'hello'\n */\nexport const useTranslations: typeof _useTranslations = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's current locale.\n *\n * @returns {string} BCP 47 locale tag, e.g., 'en-US'.\n *\n * @example\n * const locale = useLocale();\n * console.log(locale); // 'en-US'\n */\nexport const useLocale: typeof _useLocale = () => {\n  throw new Error(typesFileError);\n};\n\nexport const useSetLocale: typeof _useSetLocale = () => {\n  throw new Error(typesFileError);\n};\n\nexport const useLocaleSelector: typeof _useLocaleSelector = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's current region.\n *\n * @returns {string | undefined} ISO 3166 region code, e.g., 'US', or undefined if not set.\n *\n * @example\n * const region = useRegion();\n * console.log(region); // 'US'\n */\nexport const useRegion: typeof _useRegion = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the user's list of supported locales.\n *\n * @returns {string[]} List of BCP 47 locale tags, e.g., ['en-US', 'fr', 'jp'].\n *\n * @example\n * const locales = useLocales();\n * console.log(locale); // ['en-US', 'fr', 'jp]\n */\nexport const useLocales: typeof _useLocales = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the application's default locale.\n *\n * If no default locale is provided, it defaults to 'en'.\n *\n * @returns {string} A BCP 47 locale tag, e.g., 'en-US'.\n *\n * @example\n * const locale = useDefaultLocale();\n * console.log(locale); // 'en-US'\n */\nexport const useDefaultLocale: typeof _useDefaultLocale = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Returns the locale properties for the given locale.\n *\n * @param {string} locale - The locale to get the properties for.\n * @returns {LocaleProperties} The locale properties for the given locale.\n *\n * @example\n * const localeProperties = useLocaleProperties('en-US');\n * console.log(localeProperties);\n */\nexport const useLocaleProperties: typeof _useLocaleProperties = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Retrieves the text direction ('ltr' or 'rtl') for the current or specified locale from the `<GTProvider>` context.\n *\n * If no locale is provided, the direction for the current user's locale is returned.\n *\n * @param {string} [locale] - Optional locale code (e.g., 'ar', 'en-US'). If omitted, uses the current locale from context.\n * @returns {'ltr' | 'rtl'} The text direction for the locale: 'rtl' for right-to-left languages, otherwise 'ltr'.\n *\n * @example\n * const dir = useLocaleDirection(); // e.g., 'ltr'\n * const arabicDir = useLocaleDirection('ar'); // 'rtl'\n */\nexport const useLocaleDirection: typeof _useLocaleDirection = () => {\n  throw new Error(typesFileError);\n};\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {GTTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n */\nexport const useMessages: (\n  _messages?: Messages\n) => <T extends string | null | undefined>(\n  encodedMsg: T,\n  options?: GTTranslationOptions\n) => T extends string ? string : T = () => {\n  throw new Error(typesFileError);\n};\n\nexport type {\n  GTTranslationOptions,\n  RuntimeTranslationOptions,\n  WithGTServerSideProps,\n  WithGTStaticProps,\n};\n\nexport type { StringFormat };\n\nexport {\n  msg,\n  decodeMsg,\n  decodeOptions,\n  mFallback,\n  gtFallback,\n  derive,\n  declareVar,\n  decodeVars,\n  getTranslationsSnapshot,\n  getDefaultLocale,\n  getLocaleProperties,\n  getLocales,\n  resolveCanonicalLocale,\n  getVersionId,\n};\n"],"mappings":";;;;;;;;;;;;;AA0EA,SAAgB,WACd,GAGiB;AACjB,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCjC,MAAa,UAAqB;AAChC,OAAM,IAAI,MAAM,eAAe;;;AAGjC,EAAE,OAAO;;;;;;;;;;;;;;;;;;AAmBT,MAAa,iBAAmC;AAC9C,OAAM,IAAI,MAAM,eAAe;;;AAGjC,SAAS,OAAO;;;;;;;;;;;;;;;;AAiBhB,MAAa,iBAAmC;AAC9C,OAAM,IAAI,MAAM,eAAe;;;AAGjC,SAAS,OAAO;;;;;;;;;;;;;;;;;AAkBhB,MAAa,qBAA2C;AACtD,OAAM,IAAI,MAAM,eAAe;;;AAGjC,aAAa,OAAO;;;;;;;;;;;;;;;;;;AAmBpB,MAAa,YAAyB;AACpC,OAAM,IAAI,MAAM,eAAe;;;AAGjC,IAAI,OAAO;;;;;;;;;;;;;;;AAgBX,MAAa,YAAyB;AACpC,OAAM,IAAI,MAAM,eAAe;;;AAGjC,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCX,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAM,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;AA0Bd,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAM,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;AA2Bd,MAAa,eAA+B;AAC1C,OAAM,IAAI,MAAM,eAAe;;;AAGjC,OAAO,OAAO;;;;;;;AAQd,MAAa,uBAA+C;AAC1D,OAAM,IAAI,MAAM,eAAe;;;;;;;AAQjC,MAAa,uBAA+C;AAC1D,OAAM,IAAI,MAAM,eAAe;;;;;;;;AASjC,SAAgB,YAGd,GAAuD;AACvD,OAAM,IAAI,MAAM,eAAe;;;;;;AAOjC,SAAgB,sBAKd,GACmE;AACnE,OAAM,IAAI,MAAM,eAAe;;;;;;AAOjC,MAAa,0BAAqD;AAChE,OAAM,IAAI,MAAM,eAAe;;;;;;;;AASjC,SAAgB,kBAAkB,GAAqB;AACrD,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;AA0BjC,MAAa,cAE4D;AACvE,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;;;;AAiBjC,MAAa,wBAAiD;AAC5D,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;AAYjC,MAAa,kBAAqC;AAChD,OAAM,IAAI,MAAM,eAAe;;AAGjC,MAAa,qBAA2C;AACtD,OAAM,IAAI,MAAM,eAAe;;AAGjC,MAAa,0BAAqD;AAChE,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;AAYjC,MAAa,kBAAqC;AAChD,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;AAYjC,MAAa,mBAAuC;AAClD,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;AAcjC,MAAa,yBAAmD;AAC9D,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;AAajC,MAAa,4BAAyD;AACpE,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;;AAejC,MAAa,2BAAuD;AAClE,OAAM,IAAI,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCjC,MAAa,oBAK8B;AACzC,OAAM,IAAI,MAAM,eAAe"}