intor 2.0.2 → 2.1.0

package/dist/index.cjs

@@ -76,13 +76,19 @@ var DEFAULT_FORMATTER_CONFIG = {
 };
 function getLogger({
   id,
-  formatterConfig = DEFAULT_FORMATTER_CONFIG,
+  formatterConfig,
+  preset,
   ...options
 }) {
   const pool = getGlobalLoggerPool();
   let logger = pool.get(id);
   if (!logger) {
-    logger = logry.logry({ id, formatterConfig, ...options });
+    logger = logry.logry({
+      id,
+      formatterConfig: !formatterConfig && !preset ? DEFAULT_FORMATTER_CONFIG : formatterConfig,
+      preset,
+      ...options
+    });
     pool.set(id, logger);
     if (pool.size > 1e3) {
       const keys = Array.from(pool.keys());
@@ -626,7 +632,10 @@ var loadLocalMessages = async ({
     namespaces: namespaces && namespaces.length > 0 ? { count: namespaces?.length, list: [...namespaces] } : "All Namespaces",
     concurrency
   });
-  const pool = getGlobalMessagesPool();
+  let pool;
+  if (cache.enabled) {
+    pool = getGlobalMessagesPool();
+  }
   const key = normalizeCacheKey([
     loggerOptions.id,
     resolvedBasePath,
@@ -635,7 +644,7 @@ var loadLocalMessages = async ({
     [...namespaces ?? []].sort().join(",")
   ]);
   if (cache.enabled && key) {
-    const cached = await pool.get(key);
+    const cached = await pool?.get(key);
     if (cached) {
       logger.debug("Messages cache hit.", { key });
       return cached;
@@ -652,7 +661,7 @@ var loadLocalMessages = async ({
     logger: loggerOptions
   });
   if (cache.enabled && key) {
-    await pool.set(key, messages, cache.ttl);
+    await pool?.set(key, messages, cache.ttl);
   }
   const end = perf_hooks.performance.now();
   const duration = Math.round(end - start);
@@ -769,7 +778,10 @@ var loadApiMessages = async ({
     logger.warn("No apiUrl provided. Skipping fetch.");
     return;
   }
-  const pool = getGlobalMessagesPool();
+  let pool;
+  if (cache.enabled) {
+    pool = getGlobalMessagesPool();
+  }
   const key = normalizeCacheKey([
     loggerOptions.id,
     basePath,
@@ -778,7 +790,7 @@ var loadApiMessages = async ({
     [...namespaces ?? []].sort().join(",")
   ]);
   if (cache.enabled && key) {
-    const cached = await pool.get(key);
+    const cached = await pool?.get(key);
     if (cached) {
       logger.debug("Messages cache hit.", { key });
       return cached;
@@ -794,7 +806,7 @@ var loadApiMessages = async ({
   });
   if (messages) {
     if (cache.enabled && key) {
-      await pool.set(key, messages, cache.ttl);
+      await pool?.set(key, messages, cache.ttl);
     }
     return messages;
   }
@@ -812,7 +824,7 @@ var loadApiMessages = async ({
       searchParams: decodeURIComponent(searchParams.toString())
     });
     if (cache.enabled && key) {
-      await pool.set(key, fallbackResult.messages, cache.ttl);
+      await pool?.set(key, fallbackResult.messages, cache.ttl);
     }
     return fallbackResult.messages;
   }
@@ -823,35 +835,41 @@ var loadApiMessages = async ({
   return;
 };
 
-// src/modules/messages/get-messages.ts
-var getMessages = async ({
+// src/modules/messages/load-messages.ts
+var loadMessages = async ({
   config,
   locale,
   pathname
 }) => {
-  const baseLogger = getLogger({ id: config.id });
+  const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "messages-loader" });
-  const loaderOptions = config.loader;
+  if (!config.loader) {
+    logger.warn(
+      "No loader options have been configured in the current config."
+    );
+    return;
+  }
+  const { loader } = config;
   const fallbackLocales = config.fallbackLocales[locale] || [];
   const namespaces = resolveNamespaces({ config, pathname });
   logger.debug("Namespaces ready for loading.", {
     namespaces: namespaces.length > 0 ? { count: namespaces.length, list: [...namespaces] } : "All Namespaces"
   });
-  logger.debug("Loader type selected.", { loaderType: loaderOptions.type });
+  logger.debug("Loader type selected.", { loaderType: loader.type });
   let loadedMessages;
-  if (loaderOptions.type === "import") {
-    const loadLocalMessages2 = createLoadLocalMessages(loaderOptions.basePath);
+  if (loader.type === "import") {
+    const loadLocalMessages2 = createLoadLocalMessages(loader.basePath);
     loadedMessages = await loadLocalMessages2({
-      ...loaderOptions,
+      ...loader,
       locale,
       fallbackLocales,
       namespaces,
       cache: config.cache,
       logger: { id: config.id }
     });
-  } else if (loaderOptions.type === "api") {
+  } else if (loader.type === "api") {
     loadedMessages = await loadApiMessages({
-      ...loaderOptions,
+      ...loader,
       locale,
       fallbackLocales,
       namespaces,
@@ -865,29 +883,27 @@ var getMessages = async ({
 };
 
 // src/modules/intor/intor.ts
-var intor = async ({
-  config,
-  adapter,
-  adapterRuntime
-}) => {
+var intor = async (config, i18nContext) => {
   const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "intor" });
   logger.info("Start Intor initialization.");
   const { messages, loader } = config;
-  let runtime;
-  if (adapter) {
-    runtime = await adapter(config);
+  const isI18nContextFunction = typeof i18nContext === "function";
+  let context;
+  if (isI18nContextFunction) {
+    context = await i18nContext(config);
   } else {
-    runtime = {
-      locale: adapterRuntime?.locale || config.defaultLocale,
-      pathname: adapterRuntime?.pathname || ""
+    context = {
+      locale: i18nContext?.locale || config.defaultLocale,
+      pathname: i18nContext?.pathname || ""
     };
   }
-  const { locale, pathname } = runtime;
-  logger.debug("Runtime resolved via adapter/fallback", runtime);
+  const { locale, pathname } = context;
+  const source = isI18nContextFunction ? "[function]" : "[static object]";
+  logger.debug(`Context resolved via ${source}.`, context);
   let loadedMessages;
   if (shouldLoadMessages(loader)) {
-    loadedMessages = await getMessages({ config, locale, pathname });
+    loadedMessages = await loadMessages({ config, locale, pathname });
   }
   const mergedMessages = mergeMessages(messages, loadedMessages);
   logger.info("Messages initialized.", {
@@ -905,6 +921,31 @@ var intor = async ({
     messages: mergedMessages
   };
 };
+async function getTranslator(opts) {
+  const { config, locale, pathname = "", preKey } = opts;
+  const messages = await loadMessages({ config, locale, pathname });
+  const translator = new intorTranslator.Translator({
+    locale,
+    messages,
+    fallbackLocales: config.fallbackLocales,
+    loadingMessage: config.translator?.loadingMessage,
+    placeholder: config.translator?.placeholder
+  });
+  const props = {
+    messages,
+    locale
+  };
+  if (preKey) {
+    const scoped = translator.scoped(preKey);
+    return { ...props, ...scoped };
+  } else {
+    return {
+      ...props,
+      t: translator.t,
+      hasKey: translator.hasKey
+    };
+  }
+}
 
 Object.defineProperty(exports, "Translator", {
   enumerable: true,
@@ -914,10 +955,11 @@ exports.PREFIX_PLACEHOLDER = PREFIX_PLACEHOLDER;
 exports.clearLoggerPool = clearLoggerPool;
 exports.clearMessagesPool = clearMessagesPool;
 exports.extractPathname = extractPathname;
-exports.getMessages = getMessages;
+exports.getTranslator = getTranslator;
 exports.intor = intor;
 exports.loadApiMessages = loadApiMessages;
 exports.loadLocalMessages = loadLocalMessages;
+exports.loadMessages = loadMessages;
 exports.mergeMessages = mergeMessages;
 exports.normalizeCacheKey = normalizeCacheKey;
 exports.normalizeLocale = normalizeLocale;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { Locale, LocaleNamespaceMessages, FallbackLocalesMap } from 'intor-translator';
-export { FallbackLocalesMap, FormatMessage, Locale, LocaleKey, LocaleNamespaceMessages, Message, MessageRecord, Namespace, NamespaceMessages, NestedMessage, OnLoading, OnMissing, Replacement, RichReplacement, StrictLocaleKey, TranslateContext, TranslateHandlers, Translator, UnionLocaleMessages } from 'intor-translator';
 import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
+import { Locale, LocaleNamespaceMessages, FallbackLocalesMap, InferTranslatorKey, LocaleKey, Replacement, RichReplacement, NodeKeys, UnionLocaleMessages, ScopedLeafKeys } from 'intor-translator';
+export { FallbackLocalesMap, FormatMessage, Locale, LocaleKey, LocaleNamespaceMessages, Message, MessageRecord, Namespace, NamespaceMessages, NestedMessage, OnLoading, OnMissing, Replacement, RichReplacement, StrictLocaleKey, TranslateContext, TranslateHandlers, Translator, UnionLocaleMessages } from 'intor-translator';
 import { Logger } from 'logry';
 import Keyv from 'keyv';
 
@@ -122,15 +122,28 @@ type IntorResolvedConfig = (WithLoader | WithoutLoader) & {
     readonly cache: CacheResolvedOptions;
 };
 
-interface AdapterRuntime {
-    locale: Locale;
+declare const PREFIX_PLACEHOLDER = "{locale}";
+
+type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
+type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
+type GenConfig<C extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
+    Locales: string;
+    Messages: LocaleNamespaceMessages;
+} : C extends keyof IntorGeneratedTypes ? {
+    Locales: IntorGeneratedTypes[C]["Locales"];
+    Messages: {
+        [K in IntorGeneratedTypes[C]["Locales"]]: IntorGeneratedTypes[C]["Messages"][typeof PREFIX_PLACEHOLDER];
+    };
+} : never;
+type GenMessages<C extends GenConfigKeys = "__default__"> = GenConfig<C>["Messages"];
+type GenLocaleFallback = Locale;
+type GenLocale<Config extends string = "__default__"> = Config extends keyof IntorGeneratedTypes ? IntorGeneratedTypes[Config]["Locales"] : GenLocaleFallback;
+
+interface I18nContext {
+    locale: GenLocale;
     pathname: string;
 }
-interface IntorOptions {
-    config: IntorResolvedConfig;
-    adapter?: (config: IntorResolvedConfig) => Promise<AdapterRuntime>;
-    adapterRuntime?: Partial<AdapterRuntime>;
-}
+type GetI18nContext = (config: IntorResolvedConfig) => Promise<I18nContext>;
 interface IntorResult {
     config: IntorResolvedConfig;
     initialLocale: Locale;
@@ -141,23 +154,28 @@ interface IntorResult {
 /**
  * Entry point for initializing Intor.
  *
- * 1. Resolve runtime via adapter or fallback values
- * 2. Load messages if loader enabled
- * 3. Merge static and loaded messages
+ * 1. Resolve context via adapter or fallback values.
+ * 2. Load messages if loader is enabled.
+ * 3. Merge static messages with loaded messages.
  */
-declare const intor: ({ config, adapter, adapterRuntime, }: IntorOptions) => Promise<IntorResult>;
+declare const intor: (config: IntorResolvedConfig, i18nContext: GetI18nContext | Partial<I18nContext>) => Promise<IntorResult>;
 
 type MessagesLoaderOptions = {
     config: IntorResolvedConfig;
     locale: Locale;
     pathname: string;
 };
-type MessagesLoaderResult = Promise<LocaleNamespaceMessages | undefined>;
+type MessagesLoaderResult<C extends GenConfigKeys = "__default__"> = Promise<GenMessages<C> | undefined>;
 
 /**
- * Get messages (import / api)
+ * Load messages for a given locale and pathname.
+ *
+ * - Resolve namespaces based on config and pathname.
+ * - Support both **local import** and **remote API** loaders.
+ * - Apply fallback locales if needed.
+ * - Cache messages if enabled (handled by underlying loader, not this function directly).
  */
-declare const getMessages: ({ config, locale, pathname, }: MessagesLoaderOptions) => MessagesLoaderResult;
+declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, }: MessagesLoaderOptions) => MessagesLoaderResult<C>;
 
 interface LoadLocalMessagesOptions {
     basePath?: string | null;
@@ -171,6 +189,14 @@ interface LoadLocalMessagesOptions {
     };
 }
 
+/**
+ * Load local messages from the file system.
+ *
+ * - Load messages for a target locale with optional fallback locales.
+ * - Support filtering by specific namespaces.
+ * - Cache messages if enabled.
+ * - Limit concurrent file reads for performance.
+ */
 declare const loadLocalMessages: ({ basePath, locale, fallbackLocales, namespaces, concurrency, cache, logger: loggerOptions, }: LoadLocalMessagesOptions) => Promise<LocaleNamespaceMessages>;
 
 interface LoadApiMessagesOptions extends Omit<ApiLoader, "type"> {
@@ -184,10 +210,49 @@ interface LoadApiMessagesOptions extends Omit<ApiLoader, "type"> {
 
 /**
  * Load locale messages from a remote API.
+ *
+ * - Fetch messages for a target locale with optional fallback locales.
+ * - Cache messages if enabled.
  */
 declare const loadApiMessages: <Messages extends LocaleNamespaceMessages>({ apiUrl, apiHeaders, basePath, locale, fallbackLocales, namespaces, cache, logger: loggerOptions, }: LoadApiMessagesOptions) => Promise<Messages | undefined>;
 
-declare const PREFIX_PLACEHOLDER = "{locale}";
+type PreKey<C extends GenConfigKeys = "__default__"> = NodeKeys<UnionLocaleMessages<GenMessages<C>>>;
+interface TranslatorBaseProps<M> {
+    messages: M;
+    locale: LocaleKey<M>;
+}
+interface TranslatorClientProps<M> {
+    isLoading: boolean;
+    setLocale: (locale: LocaleKey<M>) => void;
+}
+type TranslatorInstance<M> = {
+    hasKey: (key?: IfGen<InferTranslatorKey<M>, string>, targetLocale?: LocaleKey<M> | undefined) => boolean;
+    t: <Result = string>(key?: IfGen<InferTranslatorKey<M>, string>, replacements?: Replacement | RichReplacement) => Result;
+} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
+type ScopedTranslatorInstance<M, K extends string> = {
+    hasKey: (key?: IfGen<ScopedLeafKeys<M, K> & string, string>, targetLocale?: LocaleKey<M>) => boolean;
+    t: (key?: IfGen<ScopedLeafKeys<M, K> & string, string>, replacements?: Replacement | RichReplacement) => string;
+} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
+
+/**
+ * Create a translator instance for a specific locale and pathname
+ *
+ * - Loads messages using the provided config, locale, and pathname.
+ * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
+ * - Supports optional `preKey` to create a scoped translator for nested keys.
+ * - Passes additional options to the underlying `Translator`.
+ */
+declare function getTranslator<C extends GenConfigKeys = "__default__">(opts: {
+    config: IntorResolvedConfig;
+    locale: LocaleKey<GenMessages<C>>;
+    pathname?: string;
+}): Promise<TranslatorInstance<GenMessages<C>>>;
+declare function getTranslator<C extends GenConfigKeys = "__default__", K extends PreKey<C> = PreKey<C>>(opts: {
+    config: IntorResolvedConfig;
+    locale: LocaleKey<GenMessages<C>>;
+    pathname?: string;
+    preKey?: K;
+}): Promise<ScopedTranslatorInstance<GenMessages<C>, K>>;
 
 /**
  * Merge static and loaded namespace messages by locale.
@@ -303,4 +368,4 @@ declare global {
  */
 declare function clearMessagesPool(): void;
 
-export { type AdapterRuntime, type IntorOptions, type IntorResult, type LoadApiMessagesOptions, type LoadLocalMessagesOptions, PREFIX_PLACEHOLDER, clearLoggerPool, clearMessagesPool, extractPathname, getMessages, intor, loadApiMessages, loadLocalMessages, mergeMessages, normalizeCacheKey, normalizeLocale, normalizePathname, resolveNamespaces, resolvePreferredLocale, standardizePathname };
+export { type I18nContext, type IntorResult, type LoadApiMessagesOptions, type LoadLocalMessagesOptions, PREFIX_PLACEHOLDER, clearLoggerPool, clearMessagesPool, extractPathname, getTranslator, intor, loadApiMessages, loadLocalMessages, loadMessages, mergeMessages, normalizeCacheKey, normalizeLocale, normalizePathname, resolveNamespaces, resolvePreferredLocale, standardizePathname };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Locale, LocaleNamespaceMessages, FallbackLocalesMap } from 'intor-translator';
-export { FallbackLocalesMap, FormatMessage, Locale, LocaleKey, LocaleNamespaceMessages, Message, MessageRecord, Namespace, NamespaceMessages, NestedMessage, OnLoading, OnMissing, Replacement, RichReplacement, StrictLocaleKey, TranslateContext, TranslateHandlers, Translator, UnionLocaleMessages } from 'intor-translator';
 import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
+import { Locale, LocaleNamespaceMessages, FallbackLocalesMap, InferTranslatorKey, LocaleKey, Replacement, RichReplacement, NodeKeys, UnionLocaleMessages, ScopedLeafKeys } from 'intor-translator';
+export { FallbackLocalesMap, FormatMessage, Locale, LocaleKey, LocaleNamespaceMessages, Message, MessageRecord, Namespace, NamespaceMessages, NestedMessage, OnLoading, OnMissing, Replacement, RichReplacement, StrictLocaleKey, TranslateContext, TranslateHandlers, Translator, UnionLocaleMessages } from 'intor-translator';
 import { Logger } from 'logry';
 import Keyv from 'keyv';
 
@@ -122,15 +122,28 @@ type IntorResolvedConfig = (WithLoader | WithoutLoader) & {
     readonly cache: CacheResolvedOptions;
 };
 
-interface AdapterRuntime {
-    locale: Locale;
+declare const PREFIX_PLACEHOLDER = "{locale}";
+
+type IfGen<Then, Else = never> = IntorGeneratedTypes extends void ? Else : Then;
+type GenConfigKeys = IfGen<keyof IntorGeneratedTypes, string>;
+type GenConfig<C extends GenConfigKeys = "__default__"> = IntorGeneratedTypes extends void ? {
+    Locales: string;
+    Messages: LocaleNamespaceMessages;
+} : C extends keyof IntorGeneratedTypes ? {
+    Locales: IntorGeneratedTypes[C]["Locales"];
+    Messages: {
+        [K in IntorGeneratedTypes[C]["Locales"]]: IntorGeneratedTypes[C]["Messages"][typeof PREFIX_PLACEHOLDER];
+    };
+} : never;
+type GenMessages<C extends GenConfigKeys = "__default__"> = GenConfig<C>["Messages"];
+type GenLocaleFallback = Locale;
+type GenLocale<Config extends string = "__default__"> = Config extends keyof IntorGeneratedTypes ? IntorGeneratedTypes[Config]["Locales"] : GenLocaleFallback;
+
+interface I18nContext {
+    locale: GenLocale;
     pathname: string;
 }
-interface IntorOptions {
-    config: IntorResolvedConfig;
-    adapter?: (config: IntorResolvedConfig) => Promise<AdapterRuntime>;
-    adapterRuntime?: Partial<AdapterRuntime>;
-}
+type GetI18nContext = (config: IntorResolvedConfig) => Promise<I18nContext>;
 interface IntorResult {
     config: IntorResolvedConfig;
     initialLocale: Locale;
@@ -141,23 +154,28 @@ interface IntorResult {
 /**
  * Entry point for initializing Intor.
  *
- * 1. Resolve runtime via adapter or fallback values
- * 2. Load messages if loader enabled
- * 3. Merge static and loaded messages
+ * 1. Resolve context via adapter or fallback values.
+ * 2. Load messages if loader is enabled.
+ * 3. Merge static messages with loaded messages.
  */
-declare const intor: ({ config, adapter, adapterRuntime, }: IntorOptions) => Promise<IntorResult>;
+declare const intor: (config: IntorResolvedConfig, i18nContext: GetI18nContext | Partial<I18nContext>) => Promise<IntorResult>;
 
 type MessagesLoaderOptions = {
     config: IntorResolvedConfig;
     locale: Locale;
     pathname: string;
 };
-type MessagesLoaderResult = Promise<LocaleNamespaceMessages | undefined>;
+type MessagesLoaderResult<C extends GenConfigKeys = "__default__"> = Promise<GenMessages<C> | undefined>;
 
 /**
- * Get messages (import / api)
+ * Load messages for a given locale and pathname.
+ *
+ * - Resolve namespaces based on config and pathname.
+ * - Support both **local import** and **remote API** loaders.
+ * - Apply fallback locales if needed.
+ * - Cache messages if enabled (handled by underlying loader, not this function directly).
  */
-declare const getMessages: ({ config, locale, pathname, }: MessagesLoaderOptions) => MessagesLoaderResult;
+declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, }: MessagesLoaderOptions) => MessagesLoaderResult<C>;
 
 interface LoadLocalMessagesOptions {
     basePath?: string | null;
@@ -171,6 +189,14 @@ interface LoadLocalMessagesOptions {
     };
 }
 
+/**
+ * Load local messages from the file system.
+ *
+ * - Load messages for a target locale with optional fallback locales.
+ * - Support filtering by specific namespaces.
+ * - Cache messages if enabled.
+ * - Limit concurrent file reads for performance.
+ */
 declare const loadLocalMessages: ({ basePath, locale, fallbackLocales, namespaces, concurrency, cache, logger: loggerOptions, }: LoadLocalMessagesOptions) => Promise<LocaleNamespaceMessages>;
 
 interface LoadApiMessagesOptions extends Omit<ApiLoader, "type"> {
@@ -184,10 +210,49 @@ interface LoadApiMessagesOptions extends Omit<ApiLoader, "type"> {
 
 /**
  * Load locale messages from a remote API.
+ *
+ * - Fetch messages for a target locale with optional fallback locales.
+ * - Cache messages if enabled.
  */
 declare const loadApiMessages: <Messages extends LocaleNamespaceMessages>({ apiUrl, apiHeaders, basePath, locale, fallbackLocales, namespaces, cache, logger: loggerOptions, }: LoadApiMessagesOptions) => Promise<Messages | undefined>;
 
-declare const PREFIX_PLACEHOLDER = "{locale}";
+type PreKey<C extends GenConfigKeys = "__default__"> = NodeKeys<UnionLocaleMessages<GenMessages<C>>>;
+interface TranslatorBaseProps<M> {
+    messages: M;
+    locale: LocaleKey<M>;
+}
+interface TranslatorClientProps<M> {
+    isLoading: boolean;
+    setLocale: (locale: LocaleKey<M>) => void;
+}
+type TranslatorInstance<M> = {
+    hasKey: (key?: IfGen<InferTranslatorKey<M>, string>, targetLocale?: LocaleKey<M> | undefined) => boolean;
+    t: <Result = string>(key?: IfGen<InferTranslatorKey<M>, string>, replacements?: Replacement | RichReplacement) => Result;
+} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
+type ScopedTranslatorInstance<M, K extends string> = {
+    hasKey: (key?: IfGen<ScopedLeafKeys<M, K> & string, string>, targetLocale?: LocaleKey<M>) => boolean;
+    t: (key?: IfGen<ScopedLeafKeys<M, K> & string, string>, replacements?: Replacement | RichReplacement) => string;
+} & TranslatorBaseProps<M> & TranslatorClientProps<M>;
+
+/**
+ * Create a translator instance for a specific locale and pathname
+ *
+ * - Loads messages using the provided config, locale, and pathname.
+ * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
+ * - Supports optional `preKey` to create a scoped translator for nested keys.
+ * - Passes additional options to the underlying `Translator`.
+ */
+declare function getTranslator<C extends GenConfigKeys = "__default__">(opts: {
+    config: IntorResolvedConfig;
+    locale: LocaleKey<GenMessages<C>>;
+    pathname?: string;
+}): Promise<TranslatorInstance<GenMessages<C>>>;
+declare function getTranslator<C extends GenConfigKeys = "__default__", K extends PreKey<C> = PreKey<C>>(opts: {
+    config: IntorResolvedConfig;
+    locale: LocaleKey<GenMessages<C>>;
+    pathname?: string;
+    preKey?: K;
+}): Promise<ScopedTranslatorInstance<GenMessages<C>, K>>;
 
 /**
  * Merge static and loaded namespace messages by locale.
@@ -303,4 +368,4 @@ declare global {
  */
 declare function clearMessagesPool(): void;
 
-export { type AdapterRuntime, type IntorOptions, type IntorResult, type LoadApiMessagesOptions, type LoadLocalMessagesOptions, PREFIX_PLACEHOLDER, clearLoggerPool, clearMessagesPool, extractPathname, getMessages, intor, loadApiMessages, loadLocalMessages, mergeMessages, normalizeCacheKey, normalizeLocale, normalizePathname, resolveNamespaces, resolvePreferredLocale, standardizePathname };
+export { type I18nContext, type IntorResult, type LoadApiMessagesOptions, type LoadLocalMessagesOptions, PREFIX_PLACEHOLDER, clearLoggerPool, clearMessagesPool, extractPathname, getTranslator, intor, loadApiMessages, loadLocalMessages, loadMessages, mergeMessages, normalizeCacheKey, normalizeLocale, normalizePathname, resolveNamespaces, resolvePreferredLocale, standardizePathname };