gt-react 5.0.3 → 5.0.4

package/dist/branches/Branch.js

@@ -0,0 +1,41 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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 {object} [branches] - An object containing possible branches as keys and their corresponding content as values.
+ * @returns {JSX.Element} The rendered branch or fallback content.
+ */
+function Branch(_a) {
+    var children = _a.children, _b = _a.name, name = _b === void 0 ? "branch" : _b, branch = _a.branch, props = __rest(_a, ["children", "name", "branch"]);
+    var generaltranslation = props["data-generaltranslation"], branches = __rest(props, ['data-generaltranslation']);
+    var renderedBranch = (branch && typeof branches[branch] !== 'undefined') ? branches[branch] : children;
+    return (_jsx("span", { "data-generaltranslation": generaltranslation, "data-_gt-name": name || "branch", "data-_gt-branch-name": branch, children: renderedBranch }));
+}
+Branch.gtTransformation = "branch";
+export default Branch;
+//# sourceMappingURL=Branch.js.map

package/dist/branches/Branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Branch.js","sourceRoot":"","sources":["../../src/branches/Branch.tsx"],"names":[],"mappings":";;;;;;;;;;;;AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,MAAM,CAAC,EAOf;IANG,IAAA,QAAQ,cAAA,EAAE,YAAe,EAAf,IAAI,mBAAG,QAAQ,KAAA,EAAE,MAAM,YAAA,EAAK,KAAK,cAD/B,8BAEf,CAD8C;IAOnC,IAA2B,kBAAkB,GAAkB,KAAK,2BAAvB,EAAK,QAAQ,UAAK,KAAK,EAAtE,2BAA8D,CAAF,CAAW;IAC7E,IAAM,cAAc,GAAG,CAAC,MAAM,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzG,OAAO,CACH,0CAA+B,kBAAkB,mBAAiB,IAAI,IAAI,QAAQ,0BAAwB,MAAM,YAC3G,cAAc,GACZ,CACV,CAAC;AACN,CAAC;AAED,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAC;AACnC,eAAe,MAAM,CAAC"}

package/dist/branches/plurals/Plural.js

@@ -0,0 +1,48 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getPluralBranch } from "../../internal";
+import useLocale from "../../hooks/useLocale";
+import useDefaultLocale from "../../hooks/useDefaultLocale";
+/**
+ * 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">
+ *   There are {n} items
+ * </Plural>
+ * ```
+ * 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.
+ * @returns {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.
+ */
+function Plural(_a) {
+    var children = _a.children, n = _a.n, props = __rest(_a, ["children", "n"]);
+    var generaltranslation = props["data-generaltranslation"], branches = __rest(props, ['data-generaltranslation']);
+    var locale = useLocale();
+    var defaultLocale = useDefaultLocale();
+    if (typeof n !== 'number')
+        throw new Error("Plural with children \"".concat(children, "\" requires \"n\" option."));
+    var branch = getPluralBranch(n, [locale, defaultLocale], branches) || children;
+    return (_jsx("span", { "data-generaltranslation": generaltranslation, "data-_gt-n": n, children: branch }));
+}
+Plural.gtTransformation = "plural";
+export default Plural;
+//# sourceMappingURL=Plural.js.map

package/dist/branches/plurals/Plural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plural.js","sourceRoot":"","sources":["../../../src/branches/plurals/Plural.tsx"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAC9C,OAAO,gBAAgB,MAAM,8BAA8B,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,MAAM,CAAC,EAMf;IALG,IAAA,QAAQ,cAAA,EAAE,CAAC,OAAA,EAAK,KAAK,cADT,iBAEf,CADwB;IAMb,IAA2B,kBAAkB,GAAkB,KAAK,2BAAvB,EAAK,QAAQ,UAAK,KAAK,EAAtE,2BAA8D,CAAF,CAAW;IAC7E,IAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QACrB,MAAM,IAAI,KAAK,CAAC,iCAAyB,QAAQ,8BAAwB,CAAC,CAAC;IAC/E,IAAM,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC;IACjF,OAAO,CACH,0CAA+B,kBAAkB,gBAAc,CAAC,YAC3D,MAAM,GACJ,CACV,CAAC;AACN,CAAC;AAED,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAC;AAEnC,eAAe,MAAM,CAAC"}

package/dist/branches/plurals/getPluralBranch.js

@@ -0,0 +1,75 @@
+/**
+ * Helper function to get the branch name from a number based on provided options.
+ *
+ * @param {number} n - The number to determine the branch name for.
+ * @param {Record<string, any>} options - The options containing possible branch names.
+ * @returns {string} The determined branch name.
+ */
+export function getBranchNameFromNumber(n, locales, options) {
+    var pluralRules = new Intl.PluralRules(locales);
+    var provisionalBranchName = pluralRules.select(n);
+    // aliases
+    var absN = Math.abs(n);
+    // 0
+    if (absN === 0 && options["zero"])
+        return "zero"; // override
+    // 1
+    if (absN === 1) {
+        if (options["singular"])
+            return "singular"; // override
+        if (options["one"])
+            return "one"; // override
+    }
+    if (provisionalBranchName === "one" && options["singular"])
+        return "singular";
+    // 2
+    if (absN === 2) {
+        if (options["dual"])
+            return "dual"; // override
+        if (options["two"])
+            return "two"; // override
+    }
+    if (provisionalBranchName === "two" && options["dual"])
+        return "dual";
+    // fallbacks
+    if (options[provisionalBranchName])
+        return provisionalBranchName;
+    // two
+    if (provisionalBranchName === "two" && options["dual"])
+        return "dual";
+    if (provisionalBranchName === "two" && options["plural"])
+        return "plural";
+    if (provisionalBranchName === "two" && options["other"])
+        return "other";
+    // few
+    if (provisionalBranchName === "few" && options["plural"])
+        return "plural";
+    if (provisionalBranchName === "few" && options["other"])
+        return "other";
+    // many
+    if (provisionalBranchName === "many" && options["plural"])
+        return "plural";
+    if (provisionalBranchName === "many" && options["other"])
+        return "other";
+    // other
+    if (provisionalBranchName === "other" && options["plural"])
+        return "plural";
+    return "";
+}
+/**
+ * Main function to get the appropriate branch based on the provided number and branches.
+ *
+ * @param {number} n - The number to determine the branch for.
+ * @param {any} branches - The object containing possible branches.
+ * @returns {any} The determined branch.
+ */
+export default function getPluralBranch(n, locales, branches) {
+    var branchName = '';
+    var branch = null;
+    if (typeof n === 'number' && !branch && branches)
+        branchName = getBranchNameFromNumber(n, locales, branches);
+    if (branchName && !branch)
+        branch = branches[branchName];
+    return branch;
+}
+//# sourceMappingURL=getPluralBranch.js.map

package/dist/branches/plurals/getPluralBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPluralBranch.js","sourceRoot":"","sources":["../../../src/branches/plurals/getPluralBranch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,CAAS,EAAE,OAAiB,EAAE,OAA4B;IAC9F,IAAM,WAAW,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAClD,IAAM,qBAAqB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpD,UAAU;IACV,IAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI;IACJ,IAAI,IAAI,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,WAAW;IAC7D,IAAI;IACJ,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,UAAU,CAAC;YAAE,OAAO,UAAU,CAAC,CAAC,WAAW;QACvD,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,WAAW;IACjD,CAAC;IACD,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9E,IAAI;IACJ,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,WAAW;QAC/C,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,WAAW;IACjD,CAAC;IACD,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACtE,YAAY;IACZ,IAAI,OAAO,CAAC,qBAAqB,CAAC;QAAE,OAAO,qBAAqB,CAAC;IACjE,MAAM;IACN,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACtE,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxE,MAAM;IACN,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,IAAI,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxE,OAAO;IACP,IAAI,qBAAqB,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3E,IAAI,qBAAqB,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACzE,QAAQ;IACR,IAAI,qBAAqB,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5E,OAAO,EAAE,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,CAAS,EAAE,OAAiB,EAAE,QAA6B;IAC/F,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,UAAU,GAAG,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7G,IAAI,UAAU,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/client.d.ts

@@ -1,67 +1,6 @@
-import * as react from 'react';
-import react__default, { ReactNode } from 'react';
-
-type GTContextType = {
-    [key: string]: any;
-};
-declare const GTContext: react.Context<GTContextType | undefined>;
-
-declare function renderDefaultChildren({ children, variables, variablesOptions, defaultLocale }: {
-    children: ReactNode;
-    variables?: Record<string, any>;
-    variablesOptions?: Record<string, any>;
-    defaultLocale: string;
-}): react__default.ReactNode;
-
-type TranslatedChild = TranslatedElement | string | VariableObject;
-type TranslatedChildren = TranslatedChild | TranslatedChild[];
-type TranslatedElement = {
-    type: string;
-    props: {
-        'data-generaltranslation': {
-            id: number;
-            transformation: string;
-            variableType?: "variable" | "number" | "currency" | "datetime";
-            branches?: Record<string, any>;
-            defaultChildren?: any;
-            [key: string]: any;
-        };
-        children?: TranslatedChildren;
-    };
-};
-type VariableObject = {
-    key: string;
-    variable?: "variable" | "number" | "datetime" | "currency";
-};
-
-declare function renderTranslatedChildren({ source, target, variables, variablesOptions, locales }: {
-    source: ReactNode;
-    target: TranslatedChildren;
-    variables?: Record<string, any>;
-    variablesOptions?: Record<string, any>;
-    locales: string[];
-}): ReactNode;
-
-/**
- * Hook to retrieve the browser's default language, with support for a fallback and locale stored in a cookie.
- *
- * @param {string} [defaultLocale=libraryDefaultLocale] - The default locale to use if the browser locale is not available.
- * @param {string} [cookieName=localeCookieName] - The name of the cookie to check for a stored locale. If omitted, no cookie is used.
- * @returns {string} The resolved browser locale, either from the cookie, browser settings, or the default locale.
- *
- * @example
- * const browserLocale = useBrowserLocale('en-US');
- * console.log(browserLocale); // Outputs the browser's locale, or 'en-US' if unavailable
- *
- * @example
- * const browserLocale = useBrowserLocale('fr', 'localeCookie');
- * console.log(browserLocale); // Outputs locale from cookie 'localeCookie' if available, or browser's locale otherwise
- *
- * @description
- * This hook attempts to determine the browser's preferred language. If a locale is stored in a cookie (specified by `cookieName`),
- * it will take precedence. If not, it falls back to the `navigator.language` or `navigator.userLanguage`. If none of these are available,
- * the provided `defaultLocale` is used.
- */
-declare function useBrowserLocale(defaultLocale?: string, cookieName?: string, locales?: string[]): string;
-
-export { GTContext as _GTContext, renderDefaultChildren as _renderDefaultChildren, renderTranslatedChildren as _renderTranslatedChildren, useBrowserLocale };
+import { GTContext as _GTContext } from "./provider/GTContext";
+import _renderDefaultChildren from "./provider/rendering/renderDefaultChildren";
+import _renderTranslatedChildren from "./provider/rendering/renderTranslatedChildren";
+import useBrowserLocale from './hooks/useBrowserLocale';
+export { _renderDefaultChildren, _renderTranslatedChildren, _GTContext, useBrowserLocale };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -0,0 +1,6 @@
+import { GTContext as _GTContext } from "./provider/GTContext";
+import _renderDefaultChildren from "./provider/rendering/renderDefaultChildren";
+import _renderTranslatedChildren from "./provider/rendering/renderTranslatedChildren";
+import useBrowserLocale from './hooks/useBrowserLocale';
+export { _renderDefaultChildren, _renderTranslatedChildren, _GTContext, useBrowserLocale };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,sBAAsB,MAAM,4CAA4C,CAAC;AAChF,OAAO,yBAAyB,MAAM,+CAA+C,CAAC;AACtF,OAAO,gBAAgB,MAAM,0BAA0B,CAAA;AACvD,OAAO,EACH,sBAAsB,EAAE,yBAAyB,EACjD,UAAU,EAAE,gBAAgB,EAC/B,CAAA"}

package/dist/cookies/getLocaleCookie.js

@@ -0,0 +1,25 @@
+import { localeCookieName } from "../primitives/primitives";
+/**
+ * Function to get the value of a specific cookie by its name.
+ *
+ * @param {string} name - The name of the cookie to retrieve.
+ * @returns {string|null} - The value of the cookie, or null if not found.
+ */
+export default function getLocaleCookie(name) {
+    if (name === void 0) { name = localeCookieName; }
+    var cookieString = document.cookie;
+    // Split the cookies string by "; " to get an array of "key=value" strings
+    var cookiesArray = cookieString.split("; ");
+    // Loop through the array to find the cookie with the specified name
+    for (var _i = 0, cookiesArray_1 = cookiesArray; _i < cookiesArray_1.length; _i++) {
+        var cookie = cookiesArray_1[_i];
+        var _a = cookie.split("="), cookieName = _a[0], cookieValue = _a[1];
+        // Check if this cookie has the name we are looking for
+        if (cookieName === name) {
+            return decodeURIComponent(cookieValue);
+        }
+    }
+    // If the cookie is not found, return null
+    return null;
+}
+//# sourceMappingURL=getLocaleCookie.js.map

package/dist/cookies/getLocaleCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLocaleCookie.js","sourceRoot":"","sources":["../../src/cookies/getLocaleCookie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,IAA+B;IAA/B,qBAAA,EAAA,uBAA+B;IACnE,IAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IAErC,0EAA0E;IAC1E,IAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9C,oEAAoE;IACpE,KAAmB,UAAY,EAAZ,6BAAY,EAAZ,0BAAY,EAAZ,IAAY,EAAE,CAAC;QAA7B,IAAI,MAAM,qBAAA;QACP,IAAA,KAA4B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAA5C,UAAU,QAAA,EAAE,WAAW,QAAqB,CAAC;QAEpD,uDAAuD;QACvD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/hooks/useBrowserLocale.js

@@ -0,0 +1,41 @@
+import { useState, useEffect } from 'react';
+import { libraryDefaultLocale, localeCookieName } from '../primitives/primitives';
+import getLocaleCookie from '../cookies/getLocaleCookie';
+import { determineLanguage } from 'generaltranslation';
+/**
+ * Hook to retrieve the browser's default language, with support for a fallback and locale stored in a cookie.
+ *
+ * @param {string} [defaultLocale=libraryDefaultLocale] - The default locale to use if the browser locale is not available.
+ * @param {string} [cookieName=localeCookieName] - The name of the cookie to check for a stored locale. If omitted, no cookie is used.
+ * @returns {string} The resolved browser locale, either from the cookie, browser settings, or the default locale.
+ *
+ * @example
+ * const browserLocale = useBrowserLocale('en-US');
+ * console.log(browserLocale); // Outputs the browser's locale, or 'en-US' if unavailable
+ *
+ * @example
+ * const browserLocale = useBrowserLocale('fr', 'localeCookie');
+ * console.log(browserLocale); // Outputs locale from cookie 'localeCookie' if available, or browser's locale otherwise
+ *
+ * @description
+ * This hook attempts to determine the browser's preferred language. If a locale is stored in a cookie (specified by `cookieName`),
+ * it will take precedence. If not, it falls back to the `navigator.language` or `navigator.userLanguage`. If none of these are available,
+ * the provided `defaultLocale` is used.
+ */
+export default function useBrowserLocale(defaultLocale, cookieName, locales) {
+    if (defaultLocale === void 0) { defaultLocale = libraryDefaultLocale; }
+    if (cookieName === void 0) { cookieName = localeCookieName; }
+    var _a = useState(''), locale = _a[0], setLocale = _a[1];
+    useEffect(function () {
+        var _a;
+        var browserLocale = (cookieName ? getLocaleCookie(cookieName) : undefined)
+            || (locales ? determineLanguage(navigator.languages, locales) : undefined)
+            || ((_a = navigator.languages) === null || _a === void 0 ? void 0 : _a[0])
+            || navigator.language
+            || (navigator === null || navigator === void 0 ? void 0 : navigator.userLanguage)
+            || defaultLocale;
+        setLocale(browserLocale);
+    }, [defaultLocale, locales]);
+    return locale;
+}
+//# sourceMappingURL=useBrowserLocale.js.map

package/dist/hooks/useBrowserLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBrowserLocale.js","sourceRoot":"","sources":["../../src/hooks/useBrowserLocale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,eAAe,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACpC,aAA4C,EAC5C,UAAqC,EACrC,OAAkB;IAFlB,8BAAA,EAAA,oCAA4C;IAC5C,2BAAA,EAAA,6BAAqC;IAG/B,IAAA,KAAsB,QAAQ,CAAS,EAAE,CAAC,EAAzC,MAAM,QAAA,EAAE,SAAS,QAAwB,CAAC;IACjD,SAAS,CAAC;;QACN,IAAM,aAAa,GACf,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;eACnD,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,SAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,MAAA,SAAS,CAAC,SAAS,0CAAG,CAAC,CAAC,CAAA;eACxB,SAAS,CAAC,QAAQ;gBACjB,SAAiB,aAAjB,SAAS,uBAAT,SAAS,CAAU,YAAY,CAAA;eAChC,aAAa,CACnB;QACD,SAAS,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/hooks/useDefaultLocale.js

@@ -0,0 +1,16 @@
+import useGTContext from "../provider/GTContext";
+/**
+ * Retrieves the application's default locale from the `<GTProvider>` context.
+ *
+ * If no default locale is passed to the `<GTProvider>`, it defaults to providing 'en'.
+ *
+ * @returns {string} The application's default locale, e.g., 'en-US'.
+ *
+ * @example
+ * const locale = useDefaultLocale();
+ * console.log(locale); // 'en-US'
+ */
+export default function useDefaultLocale() {
+    return useGTContext("useDefaultLocale(): Unable to access default locale outside of a <GTProvider>").defaultLocale;
+}
+//# sourceMappingURL=useDefaultLocale.js.map

package/dist/hooks/useDefaultLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultLocale.js","sourceRoot":"","sources":["../../src/hooks/useDefaultLocale.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB;IACpC,OAAO,YAAY,CACf,+EAA+E,CAClF,CAAC,aAAa,CAAC;AACpB,CAAC"}

package/dist/hooks/useGT.js

@@ -0,0 +1,44 @@
+import useGTContext from "../provider/GTContext";
+/**
+ * Gets the translation function `t` provided by `<GTProvider>`.
+ *
+ * @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.
+ *
+ * @example
+ * const t = useGT('user');
+ * console.log(t('name')); // Translates item 'user.name'
+ *
+ * const t = useTranslation();
+ * console.log(t('hello')); // Translates item 'hello'
+ */
+export default function useGT(id) {
+    if (id === void 0) { id = ''; }
+    // Create a prefix for translation keys if an id is provided
+    var getID = function (suffix) {
+        return id ? "".concat(id, ".").concat(suffix) : suffix;
+    };
+    // Get the translation context
+    var translate = useGTContext("useGT('".concat(id, "'): No context provided. You're trying to get the t() function on the client, which can only be done inside a <GTProvider>.")).translate;
+    /**
+    * Translates a dictionary item based on its `id` and options.
+    *
+    * @param {string} [id=''] - The ID of the item in the dictionary to translate.
+    * @param {Record<string, any>} [options={}] - Variables or parameters (e.g., `n`) passed into the translation for dynamic content.
+    * @param {Function} [f] - `f` is executed with `options` as parameters, and its result is translated based on the dictionary value of `id`. You likely don't need this parameter unless you are using `gt-next`.
+    *
+    * @returns {string | JSX.Element}
+    */
+    function t(id, options, f) {
+        if (id === void 0) { id = ''; }
+        if (options === void 0) { options = {}; }
+        var prefixedID = getID(id);
+        var translation = translate ? translate(prefixedID, options, f) : undefined;
+        if (!translation)
+            console.warn("t('".concat(id, "') finding no translation for dictionary item ").concat(prefixedID, " !"));
+        return translation;
+    }
+    ;
+    return t;
+}
+//# sourceMappingURL=useGT.js.map

package/dist/hooks/useGT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGT.js","sourceRoot":"","sources":["../../src/hooks/useGT.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAAe;IAAf,mBAAA,EAAA,OAAe;IAOzC,4DAA4D;IAC5D,IAAM,KAAK,GAAG,UAAC,MAAc;QACzB,OAAO,EAAE,CAAC,CAAC,CAAC,UAAG,EAAE,cAAI,MAAM,CAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC,CAAA;IAED,8BAA8B;IACtB,IAAA,SAAS,GAAK,YAAY,CAC9B,iBAAU,EAAE,gIAA6H,CAC5I,UAFgB,CAEf;IAEF;;;;;;;;MAQE;IACF,SAAS,CAAC,CACN,EAAe,EACf,OAAiC,EACjC,CAAY;QAFZ,mBAAA,EAAA,OAAe;QACf,wBAAA,EAAA,YAAiC;QAGjC,IAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,aAAM,EAAE,2DAAiD,UAAU,OAAI,CAAC,CAAA;QACvG,OAAO,WAAW,CAAC;IACvB,CAAC;IAAA,CAAC;IAEF,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/hooks/useLocale.js

@@ -0,0 +1,14 @@
+import useGTContext from "../provider/GTContext";
+/**
+ * Retrieves the user's locale from the `<GTProvider>` context.
+ *
+ * @returns {string} The user's locale, e.g., 'en-US'.
+ *
+ * @example
+ * const locale = useLocale();
+ * console.log(locale); // 'en-US'
+ */
+export default function useLocale() {
+    return useGTContext("useLocale(): Unable to access user's locale outside of a <GTProvider>").locale;
+}
+//# sourceMappingURL=useLocale.js.map

package/dist/hooks/useLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.js","sourceRoot":"","sources":["../../src/hooks/useLocale.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS;IAC7B,OAAO,YAAY,CACf,uEAAuE,CAC1E,CAAC,MAAM,CAAC;AACb,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import T from "./inline/T";
+import useGT from "./hooks/useGT";
+import useDefaultLocale from "./hooks/useDefaultLocale";
+import useLocale from "./hooks/useLocale";
+import GTProvider from "./provider/GTProvider";
+import Var from "./variables/Var";
+import Num from "./variables/Num";
+import Currency from "./variables/Currency";
+import DateTime from "./variables/DateTime";
+import Plural from "./branches/plurals/Plural";
+import Branch from "./branches/Branch";
+export { Var, Num, Currency, DateTime, T, GTProvider, Plural, Branch, useGT, useDefaultLocale, useLocale };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,YAAY,CAAC;AAC3B,OAAO,KAAK,MAAM,eAAe,CAAC;AAClC,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AACxD,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAC/C,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAEvC,OAAO,EACH,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAC5B,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAC7B,KAAK,EAAE,gBAAgB,EAAE,SAAS,EACrC,CAAA"}

package/dist/inline/T.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"T.d.ts","sourceRoot":"","sources":["../../src/inline/T.tsx"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,EACtB,QAAQ,EAAE,EAAE,EAAE,GAAG,KAAK,EACzB,EAAE;IACC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB,GAAG,GAAG,CAAC,OAAO,CA8Cd"}
+{"version":3,"file":"T.d.ts","sourceRoot":"","sources":["../../src/inline/T.tsx"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,EACtB,QAAQ,EAAE,EAAE,EAAE,GAAG,KAAK,EACzB,EAAE;IACC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB,GAAG,GAAG,CAAC,OAAO,CAkDd"}

package/dist/inline/T.js

@@ -0,0 +1,110 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { isSameLanguage } from "generaltranslation";
+import useDefaultLocale from "../hooks/useDefaultLocale";
+import useLocale from "../hooks/useLocale";
+import renderDefaultChildren from "../provider/rendering/renderDefaultChildren";
+import { addGTIdentifier } from "../internal";
+import useGTContext from "../provider/GTContext";
+import renderTranslatedChildren from "../provider/rendering/renderTranslatedChildren";
+import useGT from "../hooks/useGT";
+import { useMemo } from "react";
+/**
+ * Translation component that handles rendering translated content, including plural forms.
+ * Used with the required `id` parameter instead of `const t = useGT()`.
+ *
+ * @param {string} [id] - Required identifier for the translation string.
+ * @param {React.ReactNode} children - The content to be translated or displayed.
+ * @param {any} [context] - Additional context used for translation.
+ * @param {Object} [props] - Additional props for the component.
+ * @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.
+ *
+ * @example
+ * ```jsx
+ * // Basic usage:
+ * <T id="welcome_message" variables={{ name: "John" }}>
+ *  Hello, <Var name="name"/>!
+ * </T>
+ * ```
+ *
+ * @example
+ * ```jsx
+ * // Using plural translations:
+ * <T id="item_count" variables={{ n: 3 }} singular={"You have one item"}>
+ *  You have <Num/> items
+ * </T>
+ * ```
+ *
+ */
+export default function T(_a) {
+    var children = _a.children, id = _a.id, props = __rest(_a, ["children", "id"]);
+    if (!id) {
+        throw new Error("Client-side <T> with no provided 'id' prop. Children: ".concat(children));
+    }
+    var variables = props.variables, variablesOptions = props.variablesOptions;
+    var translations = useGTContext("<T id=\"".concat(id, "\"> used on the client-side outside of <GTProvider>")).translations;
+    var t = useGT();
+    if (!children) {
+        return _jsx(React.Fragment, { children: t(id, __assign({ variables: variables }, (variablesOptions && { variablesOptions: variablesOptions }))) }, id);
+    }
+    var locale = useLocale();
+    var defaultLocale = useDefaultLocale();
+    var taggedChildren = useMemo(function () { return addGTIdentifier(children); }, [children]);
+    var translationRequired = (function () {
+        if (!locale)
+            return false;
+        if (isSameLanguage(locale, defaultLocale))
+            return false;
+        return true;
+    })();
+    if (!translationRequired) {
+        return renderDefaultChildren({
+            children: taggedChildren,
+            variables: variables,
+            variablesOptions: variablesOptions,
+            defaultLocale: defaultLocale
+        });
+    }
+    // Do translation
+    var translation = translations[id];
+    if (!translation || !translation.t) {
+        console.error("<T id=\"".concat(id, "\"> is used in a client component without a corresponding translation."));
+        return renderDefaultChildren({
+            children: taggedChildren,
+            variables: variables,
+            variablesOptions: variablesOptions,
+            defaultLocale: defaultLocale
+        });
+    }
+    return renderTranslatedChildren({
+        source: taggedChildren, target: translation.t,
+        variables: variables,
+        variablesOptions: variablesOptions,
+        locales: [locale, defaultLocale]
+    });
+}
+//# sourceMappingURL=T.js.map

package/dist/inline/T.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"T.js","sourceRoot":"","sources":["../../src/inline/T.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,gBAAgB,MAAM,2BAA2B,CAAC;AACzD,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,qBAAqB,MAAM,6CAA6C,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,wBAAwB,MAAM,gDAAgD,CAAC;AACtF,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,EAOzB;IANG,IAAA,QAAQ,cAAA,EAAE,EAAE,QAAA,EAAK,KAAK,cADA,kBAEzB,CADyB;IAQtB,IAAI,CAAC,EAAE,EAAE,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gEAAyD,QAAQ,CAAE,CAAC,CAAA;IACxF,CAAC;IAEO,IAAA,SAAS,GAAuB,KAAK,UAA5B,EAAE,gBAAgB,GAAK,KAAK,iBAAV,CAAW;IAEtC,IAAA,YAAY,GAAK,YAAY,CACjC,kBAAU,EAAE,wDAAoD,CACnE,aAFmB,CAElB;IAEF,IAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAElB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,KAAC,KAAK,CAAC,QAAQ,cAAW,CAAC,CAAC,EAAE,aAAI,SAAS,WAAA,IAAK,CAAC,gBAAgB,IAAI,EAAE,gBAAgB,kBAAA,EAAE,CAAC,EAAE,IAAvE,EAAE,CAAuF,CAAC;IAC1H,CAAC;IAED,IAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,IAAM,cAAc,GAAG,OAAO,CAAC,cAAM,OAAA,eAAe,CAAC,QAAQ,CAAC,EAAzB,CAAyB,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE3E,IAAM,mBAAmB,GAAY,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC;YAAE,OAAO,KAAK,CAAC;QACxD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACvB,OAAO,qBAAqB,CAAC;YACzB,QAAQ,EAAE,cAAc;YACxB,SAAS,WAAA;YAAE,gBAAgB,kBAAA;YAAE,aAAa,eAAA;SAC7C,CAAgB,CAAC;IACtB,CAAC;IAED,iBAAiB;IACjB,IAAM,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,kBAAU,EAAE,2EAAuE,CAAC,CAAC;QACnG,OAAO,qBAAqB,CAAC;YACzB,QAAQ,EAAE,cAAc;YACxB,SAAS,WAAA;YAAE,gBAAgB,kBAAA;YAAE,aAAa,eAAA;SAC7C,CAAgB,CAAC;IACtB,CAAC;IAED,OAAO,wBAAwB,CAAC;QAC5B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAG,WAAW,CAAC,CAAC;QAC9C,SAAS,WAAA;QAAE,gBAAgB,kBAAA;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;KAChE,CAAgB,CAAC;AACtB,CAAC"}