@edrlab/thorium-web 1.1.1 → 1.1.3

package/README.md

@@ -102,6 +102,8 @@ More details in [the @cloudflare/next-on-pages repo](https://github.com/cloudfla
 
 We welcome contributions to Thorium web! If you're interested in helping out, please fork this repository and submit a pull request with your changes.
 
+The only exception to this rule is localization files, which are managed through a separate process. Please see the [Localization](./docs/Localization.md) documentation for more details.
+
 ## License
 
 Thorium Web is licensed under the [BSD-3-Clause license](https://opensource.org/licenses/BSD-3-Clause).

package/dist/{StatefulReader-BU_EpfhE.d.mts → StatefulReader-lpxHxgKK.d.mts}

@@ -2,14 +2,14 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { TooltipProps, Heading, HeadingProps, PopoverProps } from 'react-aria-components';
 import { d as ThActionsTriggerVariant, a as ThCollapsibilityVisibility, b as ThActionEntry } from './useCollapsibility-CM1I24Ol.mjs';
 import { T as ThActionButtonProps, f as ThMenuItemProps, a as ThCollapsibleActionsBarProps, t as ThSettingsEntry, W as WithRef, r as ThDropdownProps, h as ThNumberFieldProps, k as ThRadioGroupProps, m as ThSliderProps, o as ThSwitchProps } from './ThSettingsWrapper-CMLegiqy.mjs';
-import { d as ThActionsKeys, c as ThDockingKeys, t as ThSheetTypes, g as ThTextSettingsKeys, h as ThSpacingSettingsKeys, i as ThSpacingPresetKeys, T as ThLineHeightOptions, u as ThSheetHeaderVariant, a as ThTextAlignOptions, j as ThLayoutUI } from './enums-CBaXSsr9.mjs';
+import { m as ThActionsKeys, c as ThDockingKeys, k as ThSheetTypes, p as ThTextSettingsKeys, q as ThSpacingSettingsKeys, u as ThSpacingPresetKeys, T as ThLineHeightOptions, t as ThSheetHeaderVariant, a as ThTextAlignOptions, j as ThLayoutUI } from './enums-Bhwwdfx5.mjs';
 import React__default, { RefObject, ReactNode } from 'react';
-import { q as ThSettingsGroupPref, a as ThPreferences, D as DefaultKeys, d as defaultFontFamilyOptions } from './ThPreferencesAdapter-CYSE2wnE.mjs';
+import { H as ThSettingsGroupPref, a as ThPreferences, D as DefaultKeys } from './ThPreferencesAdapter-CcJgE3zC.mjs';
 import { PressEvent } from 'react-aria';
-import { A as ActionsStateKeys } from './actionsReducer-BKoeohBu.mjs';
+import { A as ActionsStateKeys } from './actionsReducer-6UNIgifE.mjs';
 import { T as ThColorScheme } from './useContrast-Cgsrl7GS.mjs';
 import { Locator } from '@readium/shared';
-import { LineLengthStateObject } from './lib/index.mjs';
+import { FontFamilyStateObject, LineLengthStateObject } from './lib/index.mjs';
 
 interface StatefulActionsMapObject {
     Trigger: React.ComponentType<StatefulActionTriggerProps>;
@@ -225,7 +225,9 @@ declare const useSpacingPresets: () => {
     setPublisherStyles: (value: boolean) => void;
 };
 
-declare const StatefulFontFamily: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
+declare const StatefulFontFamily: ({ standalone }: StatefulSettingsItemProps & {
+    publicationLanguage?: string;
+}) => react_jsx_runtime.JSX.Element;
 
 declare const UnstableStatefulFontWeight: ({ standalone }: StatefulSettingsItemProps) => react_jsx_runtime.JSX.Element;
 
@@ -327,7 +329,7 @@ declare const useReaderTransitions: () => ReaderTransitions;
 
 interface ReadiumCSSSettings {
     columnCount: string;
-    fontFamily: keyof typeof defaultFontFamilyOptions | null;
+    fontFamily: FontFamilyStateObject;
     fontSize: number;
     fontWeight: number;
     hyphens: boolean | null;

package/dist/{ThPreferencesAdapter-CYSE2wnE.d.mts → ThPreferencesAdapter-CcJgE3zC.d.mts}

@@ -1,6 +1,6 @@
-import { b as ThBreakpoints, l as ThArrowVariant, v as ThLayoutDirection, m as ThDocumentTitleFormat, k as ThBackLinkVariant, n as ThRunningHeadFormat, o as ThProgressionFormat, j as ThLayoutUI, t as ThSheetTypes, e as ThThemeKeys, d as ThActionsKeys, p as ThDockingTypes, c as ThDockingKeys, f as ThSettingsKeys, g as ThTextSettingsKeys, h as ThSpacingSettingsKeys, r as ThSettingsRangeVariant, s as ThSettingsRangePlaceholder, T as ThLineHeightOptions, u as ThSheetHeaderVariant, i as ThSpacingPresetKeys } from './enums-CBaXSsr9.mjs';
 import { e as UnstableShortcutRepresentation } from './keyboardUtilities-BWAyLS_D.mjs';
-import { B as BreakpointsMap, T as ThBreakpointsObject } from './useBreakpoints-BtHd3571.mjs';
+import { B as BreakpointsMap, T as ThBreakpointsObject } from './useBreakpoints-LTrHif3E.mjs';
+import { b as ThBreakpoints, d as ThArrowVariant, e as ThLayoutDirection, f as ThDocumentTitleFormat, g as ThBackLinkVariant, h as ThRunningHeadFormat, i as ThProgressionFormat, j as ThLayoutUI, k as ThSheetTypes, l as ThThemeKeys, m as ThActionsKeys, n as ThDockingTypes, c as ThDockingKeys, o as ThSettingsKeys, p as ThTextSettingsKeys, q as ThSpacingSettingsKeys, r as ThSettingsRangeVariant, s as ThSettingsRangePlaceholder, T as ThLineHeightOptions, t as ThSheetHeaderVariant, u as ThSpacingPresetKeys } from './enums-Bhwwdfx5.mjs';
 import { T as ThColorScheme, a as ThContrast } from './useContrast-Cgsrl7GS.mjs';
 import { ExperimentKey } from '@readium/navigator';
 import { T as ThCollapsibility, a as ThCollapsibilityVisibility } from './useCollapsibility-CM1I24Ol.mjs';
@@ -57,6 +57,76 @@ type I18nValue<T> = T | string | {
     key: string;
     fallback?: string;
 };
+interface SystemFontSource {
+    type: "system";
+}
+interface BunnyFontSource {
+    type: "custom";
+    provider: "bunny";
+}
+interface GoogleFontSource {
+    type: "custom";
+    provider: "google";
+}
+interface LocalStaticFontFile {
+    path: string;
+    weight: number;
+    style: "normal" | "italic";
+}
+interface LocalVariableFontFile {
+    path: string;
+    style?: "normal" | "italic";
+}
+interface LocalStaticFontSource {
+    type: "custom";
+    provider: "local";
+    variant: "static";
+    files: LocalStaticFontFile[];
+}
+interface LocalVariableFontSource {
+    type: "custom";
+    provider: "local";
+    variant: "variable";
+    files: LocalVariableFontFile[];
+}
+type LocalFontSource = LocalStaticFontSource | LocalVariableFontSource;
+type FontSource = SystemFontSource | BunnyFontSource | GoogleFontSource | LocalFontSource;
+type VariableFontRangeConfig = {
+    min: number;
+    max: number;
+    step?: number;
+};
+type WeightConfig = {
+    type: "static";
+    values: number[];
+} | {
+    type: "variable";
+} & VariableFontRangeConfig;
+interface FontSpec {
+    family: string;
+    fallbacks: string[];
+    weights: WeightConfig;
+    styles?: ("normal" | "italic")[];
+    widths?: VariableFontRangeConfig;
+    display?: "swap" | "block" | "fallback" | "optional";
+}
+interface FontDefinition {
+    id: string;
+    name: string;
+    label?: I18nValue<string>;
+    source: FontSource;
+    spec: FontSpec;
+}
+type FontCollection = Record<string, FontDefinition>;
+type ValidatedLanguageCollection = {
+    fonts: FontCollection;
+    supportedLanguages: string[];
+};
+type ThFontFamilyPref = {
+    default: FontCollection;
+} | {
+    [K in Exclude<string, "default">]: ValidatedLanguageCollection;
+};
 type ThBackLinkContent = {
     type: "img";
     src: string;
@@ -152,8 +222,8 @@ interface ThDockingPref<T extends string> {
     };
 }
 interface ThSettingsGroupPref<T> {
-    main?: T[];
-    subPanel?: T[] | null;
+    main: T[];
+    subPanel: T[] | null;
     header?: ThSheetHeaderVariant;
 }
 interface ThSettingsRangePref {
@@ -169,6 +239,7 @@ interface ThSettingsRadioPref<T extends string> {
     };
 }
 type ThSettingsKeyTypes<K extends CustomizableKeys = DefaultKeys> = {
+    [ThSettingsKeys.fontFamily]: ThFontFamilyPref;
     [ThSettingsKeys.letterSpacing]: ThSettingsRangePref;
     [ThSettingsKeys.lineHeight]: ThSettingsRadioPref<Exclude<ThLineHeightOptions, ThLineHeightOptions.publisher>>;
     [ThSettingsKeys.paragraphIndent]: ThSettingsRangePref;
@@ -299,8 +370,8 @@ interface ThPreferences<K extends CustomizableKeys = {}> {
         fxlOrder: Array<SettingsKey<K>>;
         webPubOrder: Array<SettingsKey<K>>;
         keys: ThSettingsKeyTypes<K>;
-        text?: ThSettingsGroupPref<TextSettingsKey<K>>;
-        spacing?: ThSettingsGroupPref<SpacingSettingsKey<K>> & {
+        text: ThSettingsGroupPref<TextSettingsKey<K>>;
+        spacing: ThSettingsGroupPref<SpacingSettingsKey<K>> & {
             presets?: ThSettingsSpacingPresets<K>;
         };
     };
@@ -324,56 +395,6 @@ type SettingsKeyType<K extends CustomizableKeys = DefaultKeys> = K["settings"] e
 type TextSettingsKeyType<K extends CustomizableKeys = DefaultKeys> = K["text"] extends string ? K["text"] : ThTextSettingsKeys;
 type SpacingSettingsKeyType<K extends CustomizableKeys = DefaultKeys> = K["spacing"] extends string ? K["spacing"] : ThSpacingSettingsKeys;
 
-declare const supportedLocales: string[];
-declare const defaultActionKeysObject: ThActionsTokens;
-declare const defaultTextSettingsMain: ThTextSettingsKeys[];
-declare const defaultTextSettingsSubpanel: ThTextSettingsKeys[];
-declare const defaultSpacingSettingsMain: ThSpacingSettingsKeys[];
-declare const defaultSpacingSettingsSubpanel: ThSpacingSettingsKeys[];
-declare const defaultSpacingPresetsOrder: ThSpacingPresetKeys[];
-declare const defaultFontFamilyOptions: {
-    publisher: null;
-    oldStyle: string;
-    modern: string;
-    sans: string;
-    humanist: string;
-    monospace: string;
-};
-declare const defaultParagraphSpacing: Required<ThSettingsRangePref>;
-declare const defaultParagraphIndent: Required<ThSettingsRangePref>;
-declare const defaultWordSpacing: Required<ThSettingsRangePref>;
-declare const defaultLetterSpacing: Required<ThSettingsRangePref>;
-declare const defaultLineHeights: {
-    small: number;
-    medium: number;
-    large: number;
-};
-declare const defaultZoom: Required<ThSettingsRangePref>;
-declare const defaultSpacingPresets: {
-    tight: {
-        lineHeight: ThLineHeightOptions;
-        paragraphSpacing: number;
-        paragraphIndent: number;
-    };
-    balanced: {
-        lineHeight: ThLineHeightOptions;
-        paragraphSpacing: number;
-        paragraphIndent: number;
-    };
-    loose: {
-        lineHeight: ThLineHeightOptions;
-        paragraphSpacing: number;
-        paragraphIndent: number;
-    };
-    accessible: {
-        lineHeight: ThLineHeightOptions;
-        paragraphSpacing: number;
-        paragraphIndent: number;
-        letterSpacing: number;
-        wordSpacing: number;
-    };
-};
-
 interface ThPreferencesAdapter<T extends CustomizableKeys = CustomizableKeys> {
     getPreferences(): ThPreferences<T>;
     setPreferences(prefs: ThPreferences<T>): void;
@@ -381,4 +402,4 @@ interface ThPreferencesAdapter<T extends CustomizableKeys = CustomizableKeys> {
     unsubscribe(callback: (prefs: ThPreferences<T>) => void): void;
 }
 
-export { type ActionKey as A, createPreferences as B, type CustomizableKeys as C, type DefaultKeys as D, type ActionKeyType as E, type ThemeKeyType as F, type SettingsKeyType as G, type TextSettingsKeyType as H, type I18nValue as I, type SpacingSettingsKeyType as J, type useThemingProps as K, supportedLocales as L, defaultActionKeysObject as M, defaultTextSettingsMain as N, defaultTextSettingsSubpanel as O, defaultSpacingSettingsMain as P, defaultSpacingSettingsSubpanel as Q, defaultSpacingPresetsOrder as R, type SettingsKey as S, type ThPreferencesAdapter as T, defaultParagraphSpacing as U, defaultParagraphIndent as V, defaultWordSpacing as W, defaultLetterSpacing as X, defaultLineHeights as Y, defaultZoom as Z, defaultSpacingPresets as _, type ThPreferences as a, type ThemeTokens as b, type ThBackLinkContent as c, defaultFontFamilyOptions as d, type ThBackLinkPref as e, type ThBottomSheetDetent as f, type ThActionsSnappedPref as g, type ThActionsDockedPref as h, type ThActionsTokens as i, type ThSettingsSpacingPresets as j, type ThSpacingPreset as k, type ThemeKey as l, type TextSettingsKey as m, type SpacingSettingsKey as n, type ThActionsPref as o, type ThDockingPref as p, type ThSettingsGroupPref as q, type ThSettingsRangePref as r, type ThSettingsRadioPref as s, type ThSettingsKeyTypes as t, useTheming as u, type ThConstraintKeys as v, type ThFormatPrefValue as w, type ThFormatPref as x, type ThPaginatedAffordancePrefValue as y, type ThPaginatedAffordancePref as z };
+export { type useThemingProps as $, type ActionKey as A, type BunnyFontSource as B, type CustomizableKeys as C, type DefaultKeys as D, type ThDockingPref as E, type FontCollection as F, type GoogleFontSource as G, type ThSettingsGroupPref as H, type I18nValue as I, type ThSettingsRadioPref as J, type ThSettingsKeyTypes as K, type LocalStaticFontFile as L, type ThConstraintKeys as M, type ThFormatPrefValue as N, type ThFormatPref as O, type ThPaginatedAffordancePrefValue as P, type ThPaginatedAffordancePref as Q, createPreferences as R, type SystemFontSource as S, type ThPreferencesAdapter as T, type ActionKeyType as U, type VariableFontRangeConfig as V, type WeightConfig as W, type ThemeKeyType as X, type SettingsKeyType as Y, type TextSettingsKeyType as Z, type SpacingSettingsKeyType as _, type ThPreferences as a, type ThemeTokens as b, type FontDefinition as c, type ThActionsTokens as d, type ThSettingsRangePref as e, type LocalVariableFontFile as f, type LocalStaticFontSource as g, type LocalVariableFontSource as h, type LocalFontSource as i, type FontSource as j, type FontSpec as k, type ValidatedLanguageCollection as l, type ThFontFamilyPref as m, type ThBackLinkContent as n, type ThBackLinkPref as o, type ThBottomSheetDetent as p, type ThActionsSnappedPref as q, type ThActionsDockedPref as r, type ThSettingsSpacingPresets as s, type ThSpacingPreset as t, useTheming as u, type ThemeKey as v, type SettingsKey as w, type TextSettingsKey as x, type SpacingSettingsKey as y, type ThActionsPref as z };

package/dist/{actionsReducer-BKoeohBu.d.mts → actionsReducer-6UNIgifE.d.mts}

@@ -1,5 +1,5 @@
 import * as _reduxjs_toolkit from '@reduxjs/toolkit';
-import { c as ThDockingKeys } from './enums-CBaXSsr9.mjs';
+import { c as ThDockingKeys } from './enums-Bhwwdfx5.mjs';
 
 type PrimitiveType = number | string | boolean;
 /** Object types that should never be mapped */

package/dist/chunk-B3WDMWCT.mjs

@@ -0,0 +1,9 @@
+// src/i18n/supported-locales.ts
+var supportedLocales = ["da", "en", "fi", "fr", "it", "lt", "pl", "pt", "sv", "ta"];
+function isSupportedLocale(locale) {
+  return supportedLocales.includes(locale);
+}
+
+export { isSupportedLocale, supportedLocales };
+//# sourceMappingURL=chunk-B3WDMWCT.mjs.map
+//# sourceMappingURL=chunk-B3WDMWCT.mjs.map

package/dist/chunk-B3WDMWCT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n/supported-locales.ts"],"names":[],"mappings":";AAIO,IAAM,gBAAA,GAAmB,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAI;AASpF,SAAS,kBAAkB,MAAA,EAA2C;AAC3E,EAAA,OAAO,gBAAA,CAAiB,SAAS,MAAyB,CAAA;AAC5D","file":"chunk-B3WDMWCT.mjs","sourcesContent":["/**\n * List of supported locales in the application.\n * These locales are used for i18n configuration and language selection.\n */\nexport const supportedLocales = [\"da\", \"en\", \"fi\", \"fr\", \"it\", \"lt\", \"pl\", \"pt\", \"sv\", \"ta\"] as const;\n\nexport type SupportedLocale = typeof supportedLocales[number];\n\n/**\n * Type guard to check if a string is a supported locale\n * @param locale The locale string to check\n * @returns boolean indicating if the locale is supported\n */\nexport function isSupportedLocale(locale: string): locale is SupportedLocale {\n  return supportedLocales.includes(locale as SupportedLocale);\n}\n"]}

package/dist/{chunk-RNED2SPT.mjs → chunk-IYAFKTPL.mjs}

@@ -1,4 +1,4 @@
-import { supportedLocales } from './chunk-J5NR3FTV.mjs';
+import { supportedLocales } from './chunk-B3WDMWCT.mjs';
 import i18n from 'i18next';
 export { default as i18n } from 'i18next';
 import { initReactI18next, useTranslation } from 'react-i18next';
@@ -65,5 +65,5 @@ var useI18n = (ns) => {
 };
 
 export { DEFAULT_CONFIG, initI18n, useI18n };
-//# sourceMappingURL=chunk-RNED2SPT.mjs.map
-//# sourceMappingURL=chunk-RNED2SPT.mjs.map
+//# sourceMappingURL=chunk-IYAFKTPL.mjs.map
+//# sourceMappingURL=chunk-IYAFKTPL.mjs.map

package/dist/chunk-IYAFKTPL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n/config.ts","../src/i18n/useI18n.ts"],"names":["i18n"],"mappings":";;;;;;;AAOO,IAAM,cAAA,GAA8B;AAAA,EACzC,WAAA,EAAa,IAAA;AAAA,EACb,IAAA,EAAM,KAAA;AAAA,EACN,wBAAA,EAA0B,IAAA;AAAA,EAC1B,aAAA,EAAe,gBAAA;AAAA,EACf,SAAA,EAAW;AAAA,IACT,KAAA,EAAO,CAAC,WAAW,CAAA;AAAA,IACnB,QAAQ;AAAC,GACX;AAAA,EACA,aAAA,EAAe;AAAA,IACb,WAAA,EAAa;AAAA,GACf;AAAA,EACA,OAAA,EAAS;AAAA,IACP,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,EAAA,EAAI,CAAC,gBAAA,EAAkB,aAAa,CAAA;AAAA,EACpC,SAAA,EAAW,CAAC,aAAA,EAAe,gBAAgB;AAC7C;AAEO,IAAM,QAAA,GAAW,OAAO,OAAA,GAAgC,EAAC,KAAM;AACpE,EAAA,IAAI,KAAK,aAAA,EAAe;AACtB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA,CACJ,GAAA,CAAI,OAAO,CAAA,CACX,GAAA,CAAI,gBAAgB,CAAA,CACpB,GAAA,CAAI,gBAAgB,CAAA,CACpB,IAAA,CAAK;AAAA,IACJ,GAAG,cAAA;AAAA,IACH,GAAG;AAAA,GACJ,CAAA;AACL;AC/BO,IAAM,OAAA,GAAU,CAAC,EAAA,KAA2B;AAGjD,EAAA,MAAM,EAAE,CAAA,EAAG,IAAA,EAAM,IAAA,EAAAA,KAAAA,EAAM,OAAM,GAAI,cAAA,CAAe,EAAA,IAAM,cAAA,CAAe,EAAc,CAAA;AAGnF,EAAA,MAAM,cAAA,GAAiB,CAAC,GAAA,KAAgB;AACtC,IAAA,OAAOA,KAAAA,CAAK,eAAe,GAAG,CAAA;AAAA,EAChC,CAAA;AAGA,EAAA,MAAM,CAAA,GAAI,CAAC,GAAA,EAAa,OAAA,KAA0B;AAChD,IAAA,IAAI,EAAA,EAAI;AAEN,MAAA,OAAO,IAAA,CAAK,KAAK,OAAO,CAAA;AAAA,IAC1B,CAAA,MAAO;AAEL,MAAA,KAAA,MAAW,SAAA,IAAa,eAAe,EAAA,EAAgB;AACrD,QAAA,MAAM,MAAA,GAAS,KAAK,GAAA,EAAK,EAAE,GAAG,OAAA,EAAS,EAAA,EAAI,WAAW,CAAA;AACtD,QAAA,IAAI,MAAA,KAAW,KAAK,OAAO,MAAA;AAAA,MAC7B;AACA,MAAA,OAAO,GAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,CAAA;AAAA;AAAA,IAEA,IAAA,EAAAA,KAAAA;AAAA;AAAA,IAEA,KAAA;AAAA;AAAA,IAEA,iBAAiBA,KAAAA,CAAK,QAAA;AAAA;AAAA,IAEtB,WAAWA,KAAAA,CAAK,SAAA;AAAA;AAAA,IAEhB;AAAA,GACF;AACF","file":"chunk-IYAFKTPL.mjs","sourcesContent":["import i18n from \"i18next\";\nimport { initReactI18next } from \"react-i18next\";\nimport LanguageDetector from \"i18next-browser-languagedetector\";\nimport Backend from \"i18next-http-backend\";\nimport { InitOptions } from \"i18next\";\nimport { supportedLocales } from \"./supported-locales\";\n\nexport const DEFAULT_CONFIG: InitOptions = {\n  fallbackLng: \"en\",\n  load: \"all\",\n  nonExplicitSupportedLngs: true,\n  supportedLngs: supportedLocales,\n  detection: {\n    order: [\"navigator\"],\n    caches: []\n  },\n  interpolation: {\n    escapeValue: false\n  },\n  backend: {\n    loadPath: \"/locales/{{lng}}/{{ns}}.json\"\n  },\n  ns: [\"thorium-shared\", \"thorium-web\"],\n  defaultNS: [\"thorium-web\", \"thorium-shared\"]\n};\n\nexport const initI18n = async (options: Partial<InitOptions> = {}) => {\n  if (i18n.isInitialized) {\n    return i18n;\n  }\n\n  return i18n\n    .use(Backend)\n    .use(LanguageDetector)\n    .use(initReactI18next)\n    .init({\n      ...DEFAULT_CONFIG,\n      ...options\n    });\n};\n\nexport { i18n };","import { useTranslation } from \"react-i18next\";\nimport { DEFAULT_CONFIG } from \"./config\";\n\n/**\n * Hook to access the i18n instance and translation functions\n * @param ns Optional additional namespace(s) to include alongside the default namespaces\n * @returns Translation functions and i18n instance\n */\nexport const useI18n = (ns?: string | string[]) => {\n  // If no namespace provided, use both defaults with fallback\n  // If namespace provided, use only that (override behavior)\n  const { t: tRaw, i18n, ready } = useTranslation(ns || DEFAULT_CONFIG.ns as string[]);\n  \n  // Helper function to change language\n  const changeLanguage = (lng: string) => {\n    return i18n.changeLanguage(lng);\n  };\n\n  // Enhanced t function that searches both namespaces only when using defaults\n  const t = (key: string, options?: any): string => {\n    if (ns) {\n      // If custom namespace provided, use it directly (no fallback)\n      return tRaw(key, options) as string;\n    } else {\n      // If no namespace provided, search all default namespaces\n      for (const namespace of DEFAULT_CONFIG.ns as string[]) {\n        const result = tRaw(key, { ...options, ns: namespace });\n        if (result !== key) return result as string;\n      }\n      return key;\n    }\n  };\n\n  return {\n    // Translation function\n    t,\n    // i18n instance\n    i18n,\n    // Whether translations are loaded\n    ready,\n    // Current language\n    currentLanguage: i18n.language,\n    // List of available languages\n    languages: i18n.languages,\n    // Function to change language\n    changeLanguage\n  };\n};\n"]}