@thunderid/react 0.1.0 → 0.3.0

package/dist/contexts/I18n/ComponentPreferencesContext.js

@@ -0,0 +1,14 @@
+import { createContext } from "react";
+
+//#region src/contexts/I18n/ComponentPreferencesContext.ts
+/**
+* Context for component-level preferences overrides.
+* Presentational components can provide this context to override the global i18n
+* and theme settings for their entire subtree, including all nested components.
+*/
+const ComponentPreferencesContext = createContext(void 0);
+var ComponentPreferencesContext_default = ComponentPreferencesContext;
+
+//#endregion
+export { ComponentPreferencesContext_default as default };
+//# sourceMappingURL=ComponentPreferencesContext.js.map

package/dist/contexts/I18n/ComponentPreferencesContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentPreferencesContext.js","names":["ComponentPreferencesContext: Context<Preferences | undefined>"],"sources":["../../../src/contexts/I18n/ComponentPreferencesContext.ts"],"sourcesContent":["/**\n * Copyright (c) 2026, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {Preferences} from '@thunderid/browser';\nimport {Context, createContext} from 'react';\n\n/**\n * Context for component-level preferences overrides.\n * Presentational components can provide this context to override the global i18n\n * and theme settings for their entire subtree, including all nested components.\n */\nconst ComponentPreferencesContext: Context<Preferences | undefined> = createContext<Preferences | undefined>(undefined);\n\nexport default ComponentPreferencesContext;\n"],"mappings":";;;;;;;;AA0BA,MAAMA,8BAAgE,cAAuC,OAAU;AAEvH,0CAAe"}

package/dist/contexts/I18n/I18nContext.js

@@ -0,0 +1,10 @@
+import { createContext } from "react";
+
+//#region src/contexts/I18n/I18nContext.ts
+const I18nContext = createContext(null);
+I18nContext.displayName = "I18nContext";
+var I18nContext_default = I18nContext;
+
+//#endregion
+export { I18nContext_default as default };
+//# sourceMappingURL=I18nContext.js.map

package/dist/contexts/I18n/I18nContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nContext.js","names":["I18nContext: Context<I18nContextValue | null>"],"sources":["../../../src/contexts/I18n/I18nContext.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {I18nBundle} from '@thunderid/browser';\nimport {Context, createContext} from 'react';\n\nexport interface I18nContextValue {\n  /**\n   * All available i18n bundles (default + user provided)\n   */\n  bundles: Record<string, I18nBundle>;\n\n  /**\n   * The current language code (e.g., 'en-US', 'fr-FR')\n   */\n  currentLanguage: string;\n\n  /**\n   * The fallback language code\n   */\n  fallbackLanguage: string;\n\n  /**\n   * Injects additional bundles into the i18n system (e.g., from flow metadata).\n   * Injected bundles take precedence over defaults but are overridden by prop-provided bundles.\n   */\n  injectBundles: (bundles: Record<string, I18nBundle>) => void;\n\n  /**\n   * Function to change the current language\n   */\n  setLanguage: (language: string) => void;\n\n  /**\n   * Function to get a translation by key with optional parameters\n   */\n  t: (key: string, params?: Record<string, string | number>) => string;\n}\n\nconst I18nContext: Context<I18nContextValue | null> = createContext<I18nContextValue | null>(null);\n\nI18nContext.displayName = 'I18nContext';\n\nexport default I18nContext;\n"],"mappings":";;;AAsDA,MAAMA,cAAgD,cAAuC,KAAK;AAElG,YAAY,cAAc;AAE1B,0BAAe"}

package/dist/contexts/I18n/I18nProvider.js

@@ -0,0 +1,213 @@
+import I18nContext_default from "./I18nContext.js";
+import { TranslationBundleConstants, createPackageComponentLogger, deepMerge, getDefaultI18nBundles, normalizeTranslations } from "@thunderid/browser";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/contexts/I18n/I18nProvider.tsx
+const logger$1 = createPackageComponentLogger("@thunderid/react", "I18nProvider");
+const DEFAULT_STORAGE_KEY = "thunderid-i18n-language";
+const DEFAULT_URL_PARAM = "lang";
+const detectBrowserLanguage = () => {
+	if (typeof window !== "undefined" && window.navigator) return window.navigator.language || TranslationBundleConstants.FALLBACK_LOCALE;
+	return TranslationBundleConstants.FALLBACK_LOCALE;
+};
+const deriveRootDomain = (hostname) => {
+	const parts = hostname.split(".");
+	return parts.length > 1 ? parts.slice(-2).join(".") : hostname;
+};
+const getCookie = (name) => {
+	if (typeof document === "undefined") return null;
+	const match = (/* @__PURE__ */ new RegExp(`(?:^|; )${name.replace(/([.*+?^${}()|[\]\\])/g, "\\$1")}=([^;]*)`)).exec(document.cookie);
+	return match ? decodeURIComponent(match[1]) : null;
+};
+const setCookie = (name, value, domain) => {
+	if (typeof document === "undefined") return;
+	const maxAge = 365 * 24 * 60 * 60;
+	const secure = typeof window !== "undefined" && window.location.protocol === "https:" ? "; Secure" : "";
+	document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; Max-Age=${maxAge}; Path=/; Domain=${domain}; SameSite=Lax${secure}`;
+};
+const createStorageAdapter = (strategy, key, cookieDomain) => {
+	switch (strategy) {
+		case "cookie": return {
+			read: () => getCookie(key),
+			write: (language) => {
+				const domain = cookieDomain ?? (typeof window !== "undefined" ? deriveRootDomain(window.location.hostname) : "");
+				if (domain) setCookie(key, language, domain);
+			}
+		};
+		case "localStorage": return {
+			read: () => {
+				if (typeof window === "undefined" || !window.localStorage) return null;
+				try {
+					return window.localStorage.getItem(key);
+				} catch {
+					return null;
+				}
+			},
+			write: (language) => {
+				if (typeof window === "undefined" || !window.localStorage) return;
+				try {
+					window.localStorage.setItem(key, language);
+				} catch {
+					logger$1.warn("Failed to persist language preference to localStorage.");
+				}
+			}
+		};
+		case "none":
+		default: return {
+			read: () => null,
+			write: () => {}
+		};
+	}
+};
+const detectUrlParamLanguage = (paramName) => {
+	if (typeof window === "undefined") return null;
+	try {
+		return new URLSearchParams(window.location.search).get(paramName);
+	} catch {
+		return null;
+	}
+};
+/**
+* I18nProvider component that manages internationalization state and provides
+* translation functions to child components.
+*/
+const I18nProvider = ({ children, preferences }) => {
+	const defaultBundles = getDefaultI18nBundles();
+	const storageStrategy = preferences?.storageStrategy ?? "cookie";
+	const storageKey = preferences?.storageKey ?? DEFAULT_STORAGE_KEY;
+	const urlParamConfig = preferences?.urlParam === void 0 ? DEFAULT_URL_PARAM : preferences.urlParam;
+	const resolvedCookieDomain = useMemo(() => {
+		if (storageStrategy !== "cookie") return void 0;
+		if (preferences?.cookieDomain) return preferences.cookieDomain;
+		return typeof window !== "undefined" ? deriveRootDomain(window.location.hostname) : void 0;
+	}, [storageStrategy, preferences?.cookieDomain]);
+	const storage = useMemo(() => createStorageAdapter(storageStrategy, storageKey, resolvedCookieDomain), [
+		storageStrategy,
+		storageKey,
+		resolvedCookieDomain
+	]);
+	const determineInitialLanguage = () => {
+		if (preferences?.language) return preferences.language;
+		if (urlParamConfig !== false) {
+			const urlLanguage = detectUrlParamLanguage(urlParamConfig);
+			if (urlLanguage) {
+				storage.write(urlLanguage);
+				return urlLanguage;
+			}
+		}
+		const storedLanguage = storage.read();
+		if (storedLanguage) return storedLanguage;
+		const browserLanguage = detectBrowserLanguage();
+		if (browserLanguage) return browserLanguage;
+		return preferences?.fallbackLanguage || TranslationBundleConstants.FALLBACK_LOCALE;
+	};
+	const [currentLanguage, setCurrentLanguage] = useState(determineInitialLanguage);
+	const [injectedBundles, setInjectedBundles] = useState({});
+	const injectBundles = useCallback((newBundles) => {
+		setInjectedBundles((prev) => {
+			const merged = { ...prev };
+			Object.entries(newBundles).forEach(([key, bundle]) => {
+				const normalizedTranslations = normalizeTranslations(bundle.translations);
+				if (merged[key]) merged[key] = {
+					...merged[key],
+					translations: deepMerge(merged[key].translations, normalizedTranslations)
+				};
+				else merged[key] = {
+					...bundle,
+					translations: normalizedTranslations
+				};
+			});
+			return merged;
+		});
+	}, []);
+	/**
+	* Merge bundles in priority order: defaults → injected (meta) → prop-provided
+	*/
+	const mergedBundles = useMemo(() => {
+		const merged = {};
+		Object.entries(defaultBundles).forEach(([key, bundle]) => {
+			const languageKey = key.replace("_", "-");
+			merged[languageKey] = bundle;
+		});
+		Object.entries(injectedBundles).forEach(([key, bundle]) => {
+			const normalizedTranslations = normalizeTranslations(bundle.translations);
+			if (merged[key]) merged[key] = {
+				...merged[key],
+				translations: deepMerge(merged[key].translations, normalizedTranslations)
+			};
+			else merged[key] = {
+				...bundle,
+				translations: normalizedTranslations
+			};
+		});
+		if (preferences?.bundles) Object.entries(preferences.bundles).forEach(([key, userBundle]) => {
+			const normalizedTranslations = normalizeTranslations(userBundle.translations);
+			if (merged[key]) merged[key] = {
+				...merged[key],
+				metadata: userBundle.metadata ? {
+					...merged[key].metadata,
+					...userBundle.metadata
+				} : merged[key].metadata,
+				translations: deepMerge(merged[key].translations, normalizedTranslations)
+			};
+			else merged[key] = {
+				...userBundle,
+				translations: normalizedTranslations
+			};
+		});
+		return merged;
+	}, [
+		defaultBundles,
+		injectedBundles,
+		preferences?.bundles
+	]);
+	const fallbackLanguage = preferences?.fallbackLanguage || TranslationBundleConstants.FALLBACK_LOCALE;
+	useEffect(() => {
+		storage.write(currentLanguage);
+	}, [currentLanguage, storage]);
+	const t = useCallback((key, params) => {
+		let translation;
+		const currentBundle = mergedBundles[currentLanguage];
+		if (currentBundle?.translations[key]) translation = currentBundle.translations[key];
+		if (!translation && currentLanguage !== fallbackLanguage) {
+			const fallbackBundle = mergedBundles[fallbackLanguage];
+			if (fallbackBundle?.translations[key]) translation = fallbackBundle.translations[key];
+		}
+		if (!translation) translation = key;
+		if (params && Object.keys(params).length > 0) return Object.entries(params).reduce((acc, [paramKey, paramValue]) => acc.replace(new RegExp(`\\{${paramKey}\\}`, "g"), String(paramValue)), translation);
+		return translation;
+	}, [
+		mergedBundles,
+		currentLanguage,
+		fallbackLanguage
+	]);
+	const setLanguage = useCallback((language) => {
+		if (mergedBundles[language]) setCurrentLanguage(language);
+		else logger$1.warn(`Language '${language}' is not available. Available languages: ${Object.keys(mergedBundles).join(", ")}`);
+	}, [mergedBundles]);
+	const contextValue = useMemo(() => ({
+		bundles: mergedBundles,
+		currentLanguage,
+		fallbackLanguage,
+		injectBundles,
+		setLanguage,
+		t
+	}), [
+		currentLanguage,
+		fallbackLanguage,
+		injectBundles,
+		mergedBundles,
+		setLanguage,
+		t
+	]);
+	return /* @__PURE__ */ jsx(I18nContext_default.Provider, {
+		value: contextValue,
+		children
+	});
+};
+var I18nProvider_default = I18nProvider;
+
+//#endregion
+export { I18nProvider_default as default };
+//# sourceMappingURL=I18nProvider.js.map

package/dist/contexts/I18n/I18nProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nProvider.js","names":["logger: ReturnType<typeof createPackageComponentLogger>","parts: string[]","match: RegExpMatchArray | null","maxAge: number","secure: string","domain: string","I18nProvider: FC<PropsWithChildren<I18nProviderProps>>","defaultBundles: Record<string, I18nBundle>","storageStrategy: I18nStorageStrategy","storageKey: string","urlParamConfig: string | false","resolvedCookieDomain: string | undefined","storage: StorageAdapter","urlLanguage: string | null","storedLanguage: string | null","browserLanguage: string","injectBundles: (newBundles: Record<string, I18nBundle>) => void","merged: Record<string, I18nBundle>","normalizedTranslations: I18nTranslations","mergedBundles: Record<string, I18nBundle>","languageKey: string","fallbackLanguage: string","t: (key: string, params?: Record<string, string | number>) => string","translation: string | undefined","currentBundle: I18nBundle | undefined","fallbackBundle: I18nBundle | undefined","setLanguage: (language: string) => void","contextValue: I18nContextValue","I18nContext"],"sources":["../../../src/contexts/I18n/I18nProvider.tsx"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {\n  deepMerge,\n  I18nPreferences,\n  I18nStorageStrategy,\n  createPackageComponentLogger,\n  I18nBundle,\n  I18nTranslations,\n  TranslationBundleConstants,\n  getDefaultI18nBundles,\n  normalizeTranslations,\n} from '@thunderid/browser';\nimport {FC, PropsWithChildren, ReactElement, useCallback, useEffect, useMemo, useState} from 'react';\nimport I18nContext, {I18nContextValue} from './I18nContext';\n\nconst logger: ReturnType<typeof createPackageComponentLogger> = createPackageComponentLogger(\n  '@thunderid/react',\n  'I18nProvider',\n);\n\nconst DEFAULT_STORAGE_KEY = 'thunderid-i18n-language';\nconst DEFAULT_URL_PARAM = 'lang';\n\nexport interface I18nProviderProps {\n  /**\n   * The i18n preferences from the ThunderIDProvider\n   */\n  preferences?: I18nPreferences;\n}\n\nconst detectBrowserLanguage = (): string => {\n  if (typeof window !== 'undefined' && window.navigator) {\n    return window.navigator.language || TranslationBundleConstants.FALLBACK_LOCALE;\n  }\n\n  return TranslationBundleConstants.FALLBACK_LOCALE;\n};\n\nconst deriveRootDomain = (hostname: string): string => {\n  const parts: string[] = hostname.split('.');\n  return parts.length > 1 ? parts.slice(-2).join('.') : hostname;\n};\n\nconst getCookie = (name: string): string | null => {\n  if (typeof document === 'undefined') return null;\n  const match: RegExpMatchArray | null = new RegExp(\n    `(?:^|; )${name.replace(/([.*+?^${}()|[\\]\\\\])/g, '\\\\$1')}=([^;]*)`,\n  ).exec(document.cookie);\n  return match ? decodeURIComponent(match[1]) : null;\n};\n\nconst setCookie = (name: string, value: string, domain: string): void => {\n  if (typeof document === 'undefined') return;\n  const maxAge: number = 365 * 24 * 60 * 60;\n  const secure: string = typeof window !== 'undefined' && window.location.protocol === 'https:' ? '; Secure' : '';\n  document.cookie =\n    `${encodeURIComponent(name)}=${encodeURIComponent(value)}` +\n    `; Max-Age=${maxAge}` +\n    `; Path=/` +\n    `; Domain=${domain}` +\n    `; SameSite=Lax${secure}`;\n};\n\ninterface StorageAdapter {\n  read: () => string | null;\n  write: (language: string) => void;\n}\n\nconst createStorageAdapter = (strategy: I18nStorageStrategy, key: string, cookieDomain?: string): StorageAdapter => {\n  switch (strategy) {\n    case 'cookie':\n      return {\n        read: (): string | null => getCookie(key),\n        write: (language: string): void => {\n          const domain: string =\n            cookieDomain ?? (typeof window !== 'undefined' ? deriveRootDomain(window.location.hostname) : '');\n          if (domain) setCookie(key, language, domain);\n        },\n      };\n    case 'localStorage':\n      return {\n        read: (): string | null => {\n          if (typeof window === 'undefined' || !window.localStorage) return null;\n          try {\n            return window.localStorage.getItem(key);\n          } catch {\n            return null;\n          }\n        },\n        write: (language: string): void => {\n          if (typeof window === 'undefined' || !window.localStorage) return;\n          try {\n            window.localStorage.setItem(key, language);\n          } catch {\n            logger.warn('Failed to persist language preference to localStorage.');\n          }\n        },\n      };\n    case 'none':\n    default:\n      return {read: (): null => null, write: (): void => {}};\n  }\n};\n\nconst detectUrlParamLanguage = (paramName: string): string | null => {\n  if (typeof window === 'undefined') return null;\n  try {\n    return new URLSearchParams(window.location.search).get(paramName);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * I18nProvider component that manages internationalization state and provides\n * translation functions to child components.\n */\nconst I18nProvider: FC<PropsWithChildren<I18nProviderProps>> = ({\n  children,\n  preferences,\n}: PropsWithChildren<I18nProviderProps>): ReactElement => {\n  // Get default bundles from the browser package\n  const defaultBundles: Record<string, I18nBundle> = getDefaultI18nBundles();\n\n  const storageStrategy: I18nStorageStrategy = preferences?.storageStrategy ?? 'cookie';\n  const storageKey: string = preferences?.storageKey ?? DEFAULT_STORAGE_KEY;\n  const urlParamConfig: string | false = preferences?.urlParam === undefined ? DEFAULT_URL_PARAM : preferences.urlParam;\n\n  const resolvedCookieDomain: string | undefined = useMemo((): string | undefined => {\n    if (storageStrategy !== 'cookie') return undefined;\n    if (preferences?.cookieDomain) return preferences.cookieDomain;\n    return typeof window !== 'undefined' ? deriveRootDomain(window.location.hostname) : undefined;\n  }, [storageStrategy, preferences?.cookieDomain]);\n\n  const storage: StorageAdapter = useMemo(\n    () => createStorageAdapter(storageStrategy, storageKey, resolvedCookieDomain),\n    [storageStrategy, storageKey, resolvedCookieDomain],\n  );\n\n  const determineInitialLanguage = (): string => {\n    if (preferences?.language) return preferences.language;\n    if (urlParamConfig !== false) {\n      const urlLanguage: string | null = detectUrlParamLanguage(urlParamConfig);\n      if (urlLanguage) {\n        storage.write(urlLanguage);\n        return urlLanguage;\n      }\n    }\n    const storedLanguage: string | null = storage.read();\n    if (storedLanguage) return storedLanguage;\n    const browserLanguage: string = detectBrowserLanguage();\n    if (browserLanguage) return browserLanguage;\n    return preferences?.fallbackLanguage || TranslationBundleConstants.FALLBACK_LOCALE;\n  };\n\n  const [currentLanguage, setCurrentLanguage] = useState<string>(determineInitialLanguage);\n\n  // Bundles injected at runtime (e.g., from flow metadata i18n translations).\n  // These take precedence over defaults but are overridden by prop-provided bundles.\n  const [injectedBundles, setInjectedBundles] = useState<Record<string, I18nBundle>>({});\n\n  const injectBundles: (newBundles: Record<string, I18nBundle>) => void = useCallback(\n    (newBundles: Record<string, I18nBundle>): void => {\n      setInjectedBundles((prev: Record<string, I18nBundle>) => {\n        const merged: Record<string, I18nBundle> = {...prev};\n        Object.entries(newBundles).forEach(([key, bundle]: [string, I18nBundle]) => {\n          const normalizedTranslations: I18nTranslations = normalizeTranslations(\n            bundle.translations as unknown as Record<string, string | Record<string, string>>,\n          );\n          if (merged[key]) {\n            merged[key] = {\n              ...merged[key],\n              translations: deepMerge(merged[key].translations, normalizedTranslations),\n            };\n          } else {\n            merged[key] = {...bundle, translations: normalizedTranslations};\n          }\n        });\n        return merged;\n      });\n    },\n    [],\n  );\n\n  /**\n   * Merge bundles in priority order: defaults → injected (meta) → prop-provided\n   */\n  const mergedBundles: Record<string, I18nBundle> = useMemo(() => {\n    const merged: Record<string, I18nBundle> = {};\n\n    // 1. Default bundles\n    Object.entries(defaultBundles).forEach(([key, bundle]: [string, I18nBundle]) => {\n      // Convert key format (e.g., 'en_US' to 'en-US')\n      const languageKey: string = key.replace('_', '-');\n      merged[languageKey] = bundle;\n    });\n\n    // 2. Injected bundles (e.g., from flow metadata) — override defaults\n    Object.entries(injectedBundles).forEach(([key, bundle]: [string, I18nBundle]) => {\n      const normalizedTranslations: I18nTranslations = normalizeTranslations(\n        bundle.translations as unknown as Record<string, string | Record<string, string>>,\n      );\n      if (merged[key]) {\n        merged[key] = {\n          ...merged[key],\n          translations: deepMerge(merged[key].translations, normalizedTranslations),\n        };\n      } else {\n        merged[key] = {...bundle, translations: normalizedTranslations};\n      }\n    });\n\n    // 3. User-provided bundles (from props) — highest priority, override everything\n    if (preferences?.bundles) {\n      Object.entries(preferences.bundles).forEach(([key, userBundle]: [string, I18nBundle]) => {\n        const normalizedTranslations: I18nTranslations = normalizeTranslations(\n          userBundle.translations as unknown as Record<string, string | Record<string, string>>,\n        );\n        if (merged[key]) {\n          merged[key] = {\n            ...merged[key],\n            metadata: userBundle.metadata ? {...merged[key].metadata, ...userBundle.metadata} : merged[key].metadata,\n            translations: deepMerge(merged[key].translations, normalizedTranslations),\n          };\n        } else {\n          merged[key] = {...userBundle, translations: normalizedTranslations};\n        }\n      });\n    }\n\n    return merged;\n  }, [defaultBundles, injectedBundles, preferences?.bundles]);\n\n  const fallbackLanguage: string = preferences?.fallbackLanguage || TranslationBundleConstants.FALLBACK_LOCALE;\n\n  // Persist language changes to the configured storage.\n  useEffect(() => {\n    storage.write(currentLanguage);\n  }, [currentLanguage, storage]);\n\n  // Translation function\n  const t: (key: string, params?: Record<string, string | number>) => string = useCallback(\n    (key: string, params?: Record<string, string | number>): string => {\n      let translation: string | undefined;\n\n      // Try to get translation from current language bundle\n      const currentBundle: I18nBundle | undefined = mergedBundles[currentLanguage];\n      if (currentBundle?.translations[key]) {\n        translation = currentBundle.translations[key];\n      }\n\n      // Fallback to fallback language if translation not found\n      if (!translation && currentLanguage !== fallbackLanguage) {\n        const fallbackBundle: I18nBundle | undefined = mergedBundles[fallbackLanguage];\n        if (fallbackBundle?.translations[key]) {\n          translation = fallbackBundle.translations[key];\n        }\n      }\n\n      // If still no translation found, return the key itself\n      if (!translation) {\n        translation = key;\n      }\n\n      // Replace parameters if provided\n      if (params && Object.keys(params).length > 0) {\n        return Object.entries(params).reduce(\n          (acc: string, [paramKey, paramValue]: [string, string | number]) =>\n            acc.replace(new RegExp(`\\\\{${paramKey}\\\\}`, 'g'), String(paramValue)),\n          translation,\n        );\n      }\n\n      return translation;\n    },\n    [mergedBundles, currentLanguage, fallbackLanguage],\n  );\n\n  // Language setter function\n  const setLanguage: (language: string) => void = useCallback(\n    (language: string) => {\n      if (mergedBundles[language]) {\n        setCurrentLanguage(language);\n      } else {\n        logger.warn(\n          `Language '${language}' is not available. Available languages: ${Object.keys(mergedBundles).join(', ')}`,\n        );\n      }\n    },\n    [mergedBundles],\n  );\n\n  const contextValue: I18nContextValue = useMemo(\n    () => ({\n      bundles: mergedBundles,\n      currentLanguage,\n      fallbackLanguage,\n      injectBundles,\n      setLanguage,\n      t,\n    }),\n    [currentLanguage, fallbackLanguage, injectBundles, mergedBundles, setLanguage, t],\n  );\n\n  return <I18nContext.Provider value={contextValue}>{children}</I18nContext.Provider>;\n};\n\nexport default I18nProvider;\n"],"mappings":"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"}

package/dist/contexts/I18n/useI18n.js

@@ -0,0 +1,21 @@
+import I18nContext_default from "./I18nContext.js";
+import { useContext } from "react";
+
+//#region src/contexts/I18n/useI18n.ts
+/**
+* Hook for accessing the I18n context directly.
+* Provides access to the full i18n context including bundles and all utilities.
+*
+* @returns The complete I18n context value
+* @throws Error if used outside of I18nProvider context
+*/
+const useI18n = () => {
+	const context = useContext(I18nContext_default);
+	if (!context) throw new Error("useI18n must be used within an I18nProvider. Make sure your component is wrapped with ThunderIDProvider which includes I18nProvider.");
+	return context;
+};
+var useI18n_default = useI18n;
+
+//#endregion
+export { useI18n_default as default };
+//# sourceMappingURL=useI18n.js.map

package/dist/contexts/I18n/useI18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.js","names":["context: I18nContextValue | null","I18nContext"],"sources":["../../../src/contexts/I18n/useI18n.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {useContext} from 'react';\nimport I18nContext, {I18nContextValue} from './I18nContext';\n\n/**\n * Hook for accessing the I18n context directly.\n * Provides access to the full i18n context including bundles and all utilities.\n *\n * @returns The complete I18n context value\n * @throws Error if used outside of I18nProvider context\n */\nconst useI18n = (): I18nContextValue => {\n  const context: I18nContextValue | null = useContext(I18nContext);\n\n  if (!context) {\n    throw new Error(\n      'useI18n must be used within an I18nProvider. Make sure your component is wrapped with ThunderIDProvider which includes I18nProvider.',\n    );\n  }\n\n  return context;\n};\n\nexport default useI18n;\n"],"mappings":";;;;;;;;;;;AA4BA,MAAM,gBAAkC;CACtC,MAAMA,UAAmC,WAAWC,oBAAY;AAEhE,KAAI,CAAC,QACH,OAAM,IAAI,MACR,uIACD;AAGH,QAAO;;AAGT,sBAAe"}

package/dist/contexts/Organization/OrganizationContext.js

@@ -0,0 +1,25 @@
+import { createContext } from "react";
+
+//#region src/contexts/Organization/OrganizationContext.ts
+/**
+* Context object for managing organization data and related operations.
+*/
+const OrganizationContext = createContext({
+	createOrganization: () => null,
+	currentOrganization: null,
+	error: null,
+	getAllOrganizations: () => Promise.resolve({
+		count: 0,
+		organizations: []
+	}),
+	isLoading: false,
+	myOrganizations: [],
+	revalidateMyOrganizations: () => Promise.resolve([]),
+	switchOrganization: () => Promise.resolve()
+});
+OrganizationContext.displayName = "OrganizationContext";
+var OrganizationContext_default = OrganizationContext;
+
+//#endregion
+export { OrganizationContext_default as default };
+//# sourceMappingURL=OrganizationContext.js.map

package/dist/contexts/Organization/OrganizationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationContext.js","names":["OrganizationContext: Context<OrganizationContextProps | null>"],"sources":["../../../src/contexts/Organization/OrganizationContext.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {AllOrganizationsApiResponse, Organization, CreateOrganizationPayload} from '@thunderid/browser';\nimport {Context, createContext} from 'react';\n\n/**\n * Props interface of {@link OrganizationContext}\n */\nexport interface OrganizationContextProps {\n  /**\n   * Function to create a new organization.\n   */\n  createOrganization?: (payload: CreateOrganizationPayload, sessionId: string) => Promise<Organization>;\n  currentOrganization: Organization | null;\n  error: string | null;\n  getAllOrganizations: () => Promise<AllOrganizationsApiResponse>;\n  isLoading: boolean;\n  myOrganizations: Organization[];\n  revalidateMyOrganizations: () => Promise<Organization[]>;\n  switchOrganization: (organization: Organization) => Promise<void>;\n}\n\n/**\n * Context object for managing organization data and related operations.\n */\nconst OrganizationContext: Context<OrganizationContextProps | null> = createContext<null | OrganizationContextProps>({\n  createOrganization: () => null as unknown as Promise<Organization>,\n  currentOrganization: null,\n  error: null,\n  getAllOrganizations: () =>\n    Promise.resolve({\n      count: 0,\n      organizations: [],\n    }),\n  isLoading: false,\n  myOrganizations: [] as Organization[],\n  revalidateMyOrganizations: () => Promise.resolve([]),\n  switchOrganization: () => Promise.resolve(),\n});\n\nOrganizationContext.displayName = 'OrganizationContext';\n\nexport default OrganizationContext;\n"],"mappings":";;;;;;AAyCA,MAAMA,sBAAgE,cAA+C;CACnH,0BAA0B;CAC1B,qBAAqB;CACrB,OAAO;CACP,2BACE,QAAQ,QAAQ;EACd,OAAO;EACP,eAAe,EAAE;EAClB,CAAC;CACJ,WAAW;CACX,iBAAiB,EAAE;CACnB,iCAAiC,QAAQ,QAAQ,EAAE,CAAC;CACpD,0BAA0B,QAAQ,SAAS;CAC5C,CAAC;AAEF,oBAAoB,cAAc;AAElC,kCAAe"}

package/dist/contexts/Organization/OrganizationProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrganizationProvider.d.ts","sourceRoot":"","sources":["../../../src/contexts/Organization/OrganizationProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,YAAY,EACZ,2BAA2B,EAC3B,yBAAyB,EACzB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,EAAE,EAAE,iBAAiB,EAA+C,MAAM,OAAO,CAAC;AAG1F;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG;;OAEG;IACH,mBAAmB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACjE;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC,CAAC;IACzF;;;OAGG;IACH,yBAAyB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,oBAAoB,EAAE,EAAE,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAwE1E,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"OrganizationProvider.d.ts","sourceRoot":"","sources":["../../../src/contexts/Organization/OrganizationProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,YAAY,EACZ,2BAA2B,EAC3B,yBAAyB,EACzB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,EAAE,EAAE,iBAAiB,EAA+C,MAAM,OAAO,CAAC;AAG1F;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG;;OAEG;IACH,mBAAmB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACjE;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC,CAAC;IACzF;;;OAGG;IACH,yBAAyB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,oBAAoB,EAAE,EAAE,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CA0E1E,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/contexts/Organization/OrganizationProvider.js

@@ -0,0 +1,93 @@
+import OrganizationContext_default from "./OrganizationContext.js";
+import { ThunderIDRuntimeError } from "@thunderid/browser";
+import { useCallback, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/contexts/Organization/OrganizationProvider.tsx
+/**
+* OrganizationProvider component that manages organization data and provides it through OrganizationContext.
+*
+* This provider:
+* - Fetches organization data from the organizations endpoint
+* - Manages current organization state
+* - Provides functions for switching organizations and refreshing data
+* - Handles loading states and errors
+*
+* @example
+* ```tsx
+* // Basic usage with auto-fetch (uses internal API)
+* <OrganizationProvider>
+*   <App />
+* </OrganizationProvider>
+*
+* // With custom error handling
+* <OrganizationProvider onError={(error) => console.error('Organization error:', error)}>
+*   <App />
+* </OrganizationProvider>
+*
+* // With custom organization switch handler
+* <OrganizationProvider
+*   onOrganizationSwitch={(org) => console.log('Switched to:', org.name)}
+* >
+*   <App />
+* </OrganizationProvider>
+*
+* // Disable auto-fetch (fetch manually using revalidateMyOrganizations)
+* <OrganizationProvider autoFetch={false}>
+*   <App />
+* </OrganizationProvider>
+* ```
+*/
+const OrganizationProvider = ({ children, currentOrganization, onError, myOrganizations, onOrganizationSwitch, revalidateMyOrganizations, getAllOrganizations: getAllOrganizations$1, createOrganization: createOrganization$1 }) => {
+	const [isLoading, setIsLoading] = useState(false);
+	const [error, setError] = useState(null);
+	/**
+	* Switches to a different organization
+	*/
+	const switchOrganization = useCallback(async (organization) => {
+		if (!onOrganizationSwitch) throw new ThunderIDRuntimeError("onOrganizationSwitch callback is required", "OrganizationProvider-SwitchError-001", "react", "The onOrganizationSwitch callback must be provided to handle organization switching.");
+		setIsLoading(true);
+		setError(null);
+		try {
+			await onOrganizationSwitch(organization);
+		} catch (switchError) {
+			const errorMessage = switchError instanceof Error ? switchError.message : "Failed to switch organization";
+			setError(errorMessage);
+			if (onError) onError(errorMessage);
+			throw switchError;
+		} finally {
+			setIsLoading(false);
+		}
+	}, [onOrganizationSwitch, onError]);
+	const contextValue = useMemo(() => ({
+		createOrganization: createOrganization$1,
+		currentOrganization: currentOrganization ?? null,
+		error,
+		getAllOrganizations: getAllOrganizations$1 ?? (() => Promise.resolve({
+			count: 0,
+			organizations: []
+		})),
+		isLoading,
+		myOrganizations: myOrganizations ?? [],
+		revalidateMyOrganizations,
+		switchOrganization
+	}), [
+		currentOrganization,
+		error,
+		isLoading,
+		myOrganizations,
+		switchOrganization,
+		revalidateMyOrganizations,
+		getAllOrganizations$1,
+		createOrganization$1
+	]);
+	return /* @__PURE__ */ jsx(OrganizationContext_default.Provider, {
+		value: contextValue,
+		children
+	});
+};
+var OrganizationProvider_default = OrganizationProvider;
+
+//#endregion
+export { OrganizationProvider_default as default };
+//# sourceMappingURL=OrganizationProvider.js.map

package/dist/contexts/Organization/OrganizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationProvider.js","names":["OrganizationProvider: FC<PropsWithChildren<OrganizationProviderProps>>","switchOrganization: (organization: Organization) => Promise<void>","errorMessage: string","contextValue: OrganizationContextProps","getAllOrganizations","createOrganization","OrganizationContext"],"sources":["../../../src/contexts/Organization/OrganizationProvider.tsx"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {\n  ThunderIDRuntimeError,\n  Organization,\n  AllOrganizationsApiResponse,\n  CreateOrganizationPayload,\n  TokenResponse,\n} from '@thunderid/browser';\nimport {FC, PropsWithChildren, ReactElement, useCallback, useMemo, useState} from 'react';\nimport OrganizationContext, {OrganizationContextProps} from './OrganizationContext';\n\n/**\n * Props interface of {@link OrganizationProvider}\n */\nexport interface OrganizationProviderProps {\n  /**\n   * Whether to automatically fetch organizations on mount\n   */\n  autoFetch?: boolean;\n  /**\n   * Function to create a new organization.\n   */\n  createOrganization?: (payload: CreateOrganizationPayload, sessionId: string) => Promise<Organization>;\n  /**\n   * Initial current organization\n   */\n  currentOrganization?: Organization | null;\n  /**\n   * Initial list of organizations\n   */\n  getAllOrganizations?: () => Promise<AllOrganizationsApiResponse>;\n  /**\n   * List of organizations the signed-in user belongs to.\n   */\n  myOrganizations?: Organization[];\n  /**\n   * Callback function called when an error occurs\n   */\n  onError?: (error: string) => void;\n  /**\n   * Callback function called when switching organizations\n   */\n  onOrganizationSwitch?: (organization: Organization) => Promise<TokenResponse | Response>;\n  /**\n   * Refetch the my organizations list.\n   * @returns\n   */\n  revalidateMyOrganizations: () => Promise<Organization[]>;\n}\n\n/**\n * OrganizationProvider component that manages organization data and provides it through OrganizationContext.\n *\n * This provider:\n * - Fetches organization data from the organizations endpoint\n * - Manages current organization state\n * - Provides functions for switching organizations and refreshing data\n * - Handles loading states and errors\n *\n * @example\n * ```tsx\n * // Basic usage with auto-fetch (uses internal API)\n * <OrganizationProvider>\n *   <App />\n * </OrganizationProvider>\n *\n * // With custom error handling\n * <OrganizationProvider onError={(error) => console.error('Organization error:', error)}>\n *   <App />\n * </OrganizationProvider>\n *\n * // With custom organization switch handler\n * <OrganizationProvider\n *   onOrganizationSwitch={(org) => console.log('Switched to:', org.name)}\n * >\n *   <App />\n * </OrganizationProvider>\n *\n * // Disable auto-fetch (fetch manually using revalidateMyOrganizations)\n * <OrganizationProvider autoFetch={false}>\n *   <App />\n * </OrganizationProvider>\n * ```\n */\nconst OrganizationProvider: FC<PropsWithChildren<OrganizationProviderProps>> = ({\n  children,\n  currentOrganization,\n  onError,\n  myOrganizations,\n  onOrganizationSwitch,\n  revalidateMyOrganizations,\n  getAllOrganizations,\n  createOrganization,\n}: PropsWithChildren<OrganizationProviderProps>): ReactElement => {\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n  const [error, setError] = useState<string | null>(null);\n\n  /**\n   * Switches to a different organization\n   */\n  const switchOrganization: (organization: Organization) => Promise<void> = useCallback(\n    async (organization: Organization): Promise<void> => {\n      if (!onOrganizationSwitch) {\n        throw new ThunderIDRuntimeError(\n          'onOrganizationSwitch callback is required',\n          'OrganizationProvider-SwitchError-001',\n          'react',\n          'The onOrganizationSwitch callback must be provided to handle organization switching.',\n        );\n      }\n\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        await onOrganizationSwitch(organization);\n        // The organization state will be updated by the parent provider\n      } catch (switchError) {\n        const errorMessage: string =\n          switchError instanceof Error ? switchError.message : 'Failed to switch organization';\n        setError(errorMessage);\n        if (onError) {\n          onError(errorMessage);\n        }\n        throw switchError; // Re-throw so the UI can handle it\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [onOrganizationSwitch, onError],\n  );\n\n  const contextValue: OrganizationContextProps = useMemo(\n    () => ({\n      createOrganization,\n      currentOrganization: currentOrganization ?? null,\n      error,\n      getAllOrganizations:\n        getAllOrganizations ??\n        ((): Promise<AllOrganizationsApiResponse> => Promise.resolve({count: 0, organizations: []})),\n      isLoading,\n      myOrganizations: myOrganizations ?? [],\n      revalidateMyOrganizations,\n      switchOrganization,\n    }),\n    [\n      currentOrganization,\n      error,\n      isLoading,\n      myOrganizations,\n      switchOrganization,\n      revalidateMyOrganizations,\n      getAllOrganizations,\n      createOrganization,\n    ],\n  );\n\n  return <OrganizationContext.Provider value={contextValue}>{children}</OrganizationContext.Provider>;\n};\n\nexport default OrganizationProvider;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqGA,MAAMA,wBAA0E,EAC9E,UACA,qBACA,SACA,iBACA,sBACA,2BACA,4CACA,+CACgE;CAChE,MAAM,CAAC,WAAW,gBAAgB,SAAkB,MAAM;CAC1D,MAAM,CAAC,OAAO,YAAY,SAAwB,KAAK;;;;CAKvD,MAAMC,qBAAoE,YACxE,OAAO,iBAA8C;AACnD,MAAI,CAAC,qBACH,OAAM,IAAI,sBACR,6CACA,wCACA,SACA,uFACD;AAGH,eAAa,KAAK;AAClB,WAAS,KAAK;AAEd,MAAI;AACF,SAAM,qBAAqB,aAAa;WAEjC,aAAa;GACpB,MAAMC,eACJ,uBAAuB,QAAQ,YAAY,UAAU;AACvD,YAAS,aAAa;AACtB,OAAI,QACF,SAAQ,aAAa;AAEvB,SAAM;YACE;AACR,gBAAa,MAAM;;IAGvB,CAAC,sBAAsB,QAAQ,CAChC;CAED,MAAMC,eAAyC,eACtC;EACL;EACA,qBAAqB,uBAAuB;EAC5C;EACA,qBACEC,gCAC6C,QAAQ,QAAQ;GAAC,OAAO;GAAG,eAAe,EAAE;GAAC,CAAC;EAC7F;EACA,iBAAiB,mBAAmB,EAAE;EACtC;EACA;EACD,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACAA;EACAC;EACD,CACF;AAED,QAAO,oBAACC,4BAAoB;EAAS,OAAO;EAAe;GAAwC;;AAGrG,mCAAe"}

package/dist/contexts/Organization/useOrganization.js

@@ -0,0 +1,98 @@
+import OrganizationContext_default from "./OrganizationContext.js";
+import { useContext } from "react";
+
+//#region src/contexts/Organization/useOrganization.ts
+/**
+* Hook to access the Organization context.
+*
+* This hook provides access to organization data including:
+* - List of organizations the user belongs to
+* - Current organization
+* - Functions to switch organizations and refresh data
+* - Function to fetch organizations programmatically
+* - Loading states and error handling
+*
+* @returns {OrganizationContextProps} The organization context value containing all organization-related data and functions
+* @throws {Error} Throws an error if used outside of OrganizationProvider
+*
+* @example
+* ```tsx
+* import {useOrganization} from '@thunderid/react';
+*
+* function OrganizationSelector() {
+*   const {
+*     organizations,
+*     currentOrganization,
+*     switchOrganization,
+*     revalidateMyOrganizations,
+*     getOrganizations,
+*     isLoading,
+*     error
+*   } = useOrganization();
+*
+*   if (isLoading) {
+*     return <div>Loading organizations...</div>;
+*   }
+*
+*   if (error) {
+*     return <div>Error: {error}</div>;
+*   }
+*
+*   return (
+*     <div>
+*       <h2>Current: {currentOrganization?.name}</h2>
+*       <select
+*         value={currentOrganization?.id || ''}
+*         onChange={(e) => {
+*           const org = organizations?.find(o => o.id === e.target.value);
+*           if (org) switchOrganization(org);
+*         }}
+*       >
+*         {organizations?.map(org => (
+*           <option key={org.id} value={org.id}>
+*             {org.name}
+*           </option>
+*         ))}
+*       </select>
+*       <button onClick={revalidateMyOrganizations}>
+*         Refresh Organizations
+*       </button>
+*       <button onClick={async () => {
+*         const fresh = await getOrganizations();
+*         console.log('Fresh organizations:', fresh);
+*       }}>
+*         Get Organizations Manually
+*       </button>
+*     </div>
+*   );
+* }
+*
+* // Switch to a specific organization
+* function SwitchOrgButton() {
+*   const {organizations, switchOrganization} = useOrganization();
+*
+*   const handleSwitch = (orgId: string) => {
+*     const org = organizations?.find(o => o.id === orgId);
+*     if (org) {
+*       switchOrganization(org);
+*     }
+*   };
+*
+*   return (
+*     <button onClick={() => handleSwitch('org-123')}>
+*       Switch to Organization
+*     </button>
+*   );
+* }
+* ```
+*/
+const useOrganization = () => {
+	const context = useContext(OrganizationContext_default);
+	if (!context) throw new Error("useOrganization must be used within an OrganizationProvider");
+	return context;
+};
+var useOrganization_default = useOrganization;
+
+//#endregion
+export { useOrganization_default as default };
+//# sourceMappingURL=useOrganization.js.map

package/dist/contexts/Organization/useOrganization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOrganization.js","names":["context: OrganizationContextProps | null","OrganizationContext"],"sources":["../../../src/contexts/Organization/useOrganization.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {useContext} from 'react';\nimport OrganizationContext, {OrganizationContextProps} from './OrganizationContext';\n\n/**\n * Hook to access the Organization context.\n *\n * This hook provides access to organization data including:\n * - List of organizations the user belongs to\n * - Current organization\n * - Functions to switch organizations and refresh data\n * - Function to fetch organizations programmatically\n * - Loading states and error handling\n *\n * @returns {OrganizationContextProps} The organization context value containing all organization-related data and functions\n * @throws {Error} Throws an error if used outside of OrganizationProvider\n *\n * @example\n * ```tsx\n * import {useOrganization} from '@thunderid/react';\n *\n * function OrganizationSelector() {\n *   const {\n *     organizations,\n *     currentOrganization,\n *     switchOrganization,\n *     revalidateMyOrganizations,\n *     getOrganizations,\n *     isLoading,\n *     error\n *   } = useOrganization();\n *\n *   if (isLoading) {\n *     return <div>Loading organizations...</div>;\n *   }\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   return (\n *     <div>\n *       <h2>Current: {currentOrganization?.name}</h2>\n *       <select\n *         value={currentOrganization?.id || ''}\n *         onChange={(e) => {\n *           const org = organizations?.find(o => o.id === e.target.value);\n *           if (org) switchOrganization(org);\n *         }}\n *       >\n *         {organizations?.map(org => (\n *           <option key={org.id} value={org.id}>\n *             {org.name}\n *           </option>\n *         ))}\n *       </select>\n *       <button onClick={revalidateMyOrganizations}>\n *         Refresh Organizations\n *       </button>\n *       <button onClick={async () => {\n *         const fresh = await getOrganizations();\n *         console.log('Fresh organizations:', fresh);\n *       }}>\n *         Get Organizations Manually\n *       </button>\n *     </div>\n *   );\n * }\n *\n * // Switch to a specific organization\n * function SwitchOrgButton() {\n *   const {organizations, switchOrganization} = useOrganization();\n *\n *   const handleSwitch = (orgId: string) => {\n *     const org = organizations?.find(o => o.id === orgId);\n *     if (org) {\n *       switchOrganization(org);\n *     }\n *   };\n *\n *   return (\n *     <button onClick={() => handleSwitch('org-123')}>\n *       Switch to Organization\n *     </button>\n *   );\n * }\n * ```\n */\nconst useOrganization = (): OrganizationContextProps => {\n  const context: OrganizationContextProps | null = useContext(OrganizationContext);\n\n  if (!context) {\n    throw new Error('useOrganization must be used within an OrganizationProvider');\n  }\n\n  return context;\n};\n\nexport default useOrganization;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,MAAM,wBAAkD;CACtD,MAAMA,UAA2C,WAAWC,4BAAoB;AAEhF,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,8DAA8D;AAGhF,QAAO;;AAGT,8BAAe"}

package/dist/contexts/Theme/ThemeContext.js

@@ -0,0 +1,10 @@
+import { createContext } from "react";
+
+//#region src/contexts/Theme/ThemeContext.ts
+const ThemeContext = createContext(null);
+ThemeContext.displayName = "ThemeContext";
+var ThemeContext_default = ThemeContext;
+
+//#endregion
+export { ThemeContext_default as default };
+//# sourceMappingURL=ThemeContext.js.map

package/dist/contexts/Theme/ThemeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.js","names":["ThemeContext: Context<ThemeContextValue | null>"],"sources":["../../../src/contexts/Theme/ThemeContext.ts"],"sourcesContent":["/**\n * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).\n *\n * WSO2 LLC. licenses this file to you under the Apache License,\n * Version 2.0 (the \"License\"); you may not use this file except\n * in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing,\n * software distributed under the License is distributed on an\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n * KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations\n * under the License.\n */\n\nimport {Theme} from '@thunderid/browser';\nimport {Context, createContext} from 'react';\n\nexport interface ThemeContextValue {\n  /**\n   * Error from branding theme fetch, if any\n   */\n  brandingError?: Error | null;\n  colorScheme: 'light' | 'dark';\n  /**\n   * The text direction for the UI.\n   */\n  direction: 'ltr' | 'rtl';\n  /**\n   * Whether branding inheritance is enabled\n   */\n  inheritFromBranding?: boolean;\n  /**\n   * Whether branding theme is currently loading\n   */\n  isBrandingLoading?: boolean;\n  theme: Theme;\n  toggleTheme: () => void;\n}\n\nconst ThemeContext: Context<ThemeContextValue | null> = createContext<ThemeContextValue | null>(null);\n\nThemeContext.displayName = 'ThemeContext';\n\nexport default ThemeContext;\n"],"mappings":";;;AA2CA,MAAMA,eAAkD,cAAwC,KAAK;AAErG,aAAa,cAAc;AAE3B,2BAAe"}