intor 2.3.34 → 2.4.0

package/dist/next/src/routing/inbound/resolve-path/strategies/none.js

@@ -0,0 +1,8 @@
+/**
+ * Resolve pathname decision for routing prefix strategy: "none".
+ */
+function none() {
+    return { type: "pass" };
+}
+
+export { none };

package/dist/next/src/server/helpers/get-translator.js

@@ -1,10 +1,13 @@
 import '../../core/error/intor-error.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { createTRich } from '../../core/translator/create-t-rich.js';
 import { initTranslator } from '../translator/init-translator.js';
 
-// Implementation
+/**
+ * Get a server-side translator for the current execution context.
+ */
 async function getTranslator(config, params) {
     const { locale, readers, allowCacheWrite, fetch, preKey, handlers, plugins } = params;
     // Initialize a locale-bound translator snapshot with messages loaded
@@ -22,10 +25,6 @@ async function getTranslator(config, params) {
         hasKey: scoped.hasKey,
         t: scoped.t,
         tRich: createTRich(scoped.t),
-        // NOTE:
-        // The runtime implementation is intentionally erased.
-        // Type safety is guaranteed by public type contracts.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
     };
 }
 

package/dist/next/src/server/translator/init-translator.js

@@ -2,11 +2,11 @@ import '../../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
 import 'logry';
 import 'p-limit';
+import { createTranslator } from '../../core/translator/create-translator.js';
 import 'intor-translator';
 import { loadMessages } from '../messages/load-messages.js';
 import 'node:path';
 import 'node:fs/promises';
-import { createTranslator } from './create-translator.js';
 
 /**
  * Initialize a locale-bound Translator snapshot.

package/dist/react/src/client/react/translator/trans.js

@@ -8,8 +8,8 @@ import { useTranslator } from './use-translator.js';
  */
 function Trans(props) {
     const { i18nKey, components, values } = props;
-    const translator = useTranslator();
-    return jsx(Fragment, { children: translator.tRich(i18nKey, components, values) });
+    const { tRich } = useTranslator();
+    return jsx(Fragment, { children: tRich(i18nKey, components, values) });
 }
 
 export { Trans };

package/dist/react/src/client/react/translator/use-translator.js

@@ -2,7 +2,11 @@ import '../provider/intor-provider.js';
 import { useIntorContext } from '../provider/use-intor-context.js';
 import { createTRich } from './create-t-rich.js';
 
-// Implementation
+/**
+ * React hook for accessing the active, scope-aware translator instance.
+ *
+ * @platform React
+ */
 function useTranslator(preKey) {
     const { translator, setLocale } = useIntorContext();
     const scoped = translator.scoped(preKey);
@@ -14,10 +18,6 @@ function useTranslator(preKey) {
         hasKey: scoped.hasKey,
         t: scoped.t,
         tRich: createTRich(scoped.t),
-        // NOTE:
-        // The runtime implementation is intentionally erased.
-        // Type safety is guaranteed by public type contracts.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
     };
 }
 

package/dist/react/src/client/shared/helpers/get-client-locale.js

@@ -7,13 +7,7 @@ import { detectBrowserLocale } from '../utils/locale/detect-browser-locale.js';
 import { getLocaleFromCookie } from '../utils/locale/get-locale-from-cookie.js';
 
 /**
- * Resolve the locale in a client-only environment.
- *
- * This helper is intended for pure CSR setups (e.g. Vite).
- *
- * For framework-based apps, prefer `useTranslator()`.
- *
- * - Client-side only
+ * Resolve the active locale in a pure client-side environment.
  */
 function getClientLocale(config) {
     const { defaultLocale, supportedLocales, cookie } = config;

package/dist/svelte/src/client/shared/helpers/get-client-locale.js

@@ -7,13 +7,7 @@ import { detectBrowserLocale } from '../utils/locale/detect-browser-locale.js';
 import { getLocaleFromCookie } from '../utils/locale/get-locale-from-cookie.js';
 
 /**
- * Resolve the locale in a client-only environment.
- *
- * This helper is intended for pure CSR setups (e.g. Vite).
- *
- * For framework-based apps, prefer `useTranslator()`.
- *
- * - Client-side only
+ * Resolve the active locale in a pure client-side environment.
  */
 function getClientLocale(config) {
     const { defaultLocale, supportedLocales, cookie } = config;

package/dist/svelte/src/client/svelte/translator/use-translator.js

@@ -2,13 +2,17 @@ import { derived } from 'svelte/store';
 import '../../../core/error/intor-error.js';
 import 'logry';
 import 'p-limit';
-import { createTRich } from '../../../core/translator/create-t-rich.js';
 import 'intor-translator';
+import { createTRich } from '../../../core/translator/create-t-rich.js';
 import 'svelte';
 import '../provider/intor-provider.svelte';
 import { useIntorContext } from '../provider/use-intor-context.js';
 
-// Implementation
+/**
+ * Svelte utility for accessing the active, scope-aware translator instance.
+ *
+ * @platform Svelte
+ */
 function useTranslator(preKey) {
     const { translator, locale, setLocale } = useIntorContext();
     const scoped = derived(translator, ($t) => $t.scoped(preKey));
@@ -20,10 +24,6 @@ function useTranslator(preKey) {
         hasKey: derived(scoped, ($t) => $t.hasKey),
         t: derived(scoped, ($t) => $t.t),
         tRich: derived(scoped, ($t) => createTRich($t.t)),
-        // NOTE:
-        // The runtime implementation is intentionally erased.
-        // Type safety is guaranteed by public type contracts.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
     };
 }
 

package/dist/svelte-kit/src/adapters/svelte-kit/server/create-intor-handler.js

@@ -11,14 +11,12 @@ import { getLocaleFromAcceptLanguage } from '../../../routing/locale/get-locale-
 /**
  * Resolves locale-aware routing for the current execution context.
  *
- * The resolved routing state is exposed via response headers.
- *
  * - Acts as the canonical routing authority within the SvelteKit request lifecycle.
  *
  * @platform SvelteKit
  */
 function createIntorHandler(config) {
-    return async ({ event, resolve }) => {
+    return async function intorHandler({ event, resolve }) {
         const { host, searchParams, pathname: rawPathname } = event.url;
         // Locale from Accept-Language header
         const acceptLanguage = event.request.headers.get("accept-language");

package/dist/svelte-kit/src/core/translator/create-translator.js

@@ -0,0 +1,30 @@
+import { Translator } from 'intor-translator';
+import { mergeMessages } from '../messages/merge-messages.js';
+
+/**
+ * Create a server-side Translator instance for a fixed locale.
+ *
+ * - Merges static config messages with runtime-loaded messages
+ * - Initializes a Translator bound to a specific locale
+ * - Injects fallback rules, handlers, and plugins from config
+ */
+function createTranslator(params) {
+    const { config, locale, messages, handlers, plugins } = params;
+    // Merge static config messages with runtime-loaded messages
+    const finalMessages = mergeMessages(config.messages, messages, {
+        config,
+        locale,
+    });
+    const translator = new Translator({
+        locale,
+        messages: finalMessages,
+        fallbackLocales: config.fallbackLocales,
+        loadingMessage: config.translator?.loadingMessage,
+        missingMessage: config.translator?.missingMessage,
+        handlers,
+        plugins,
+    });
+    return translator;
+}
+
+export { createTranslator };

package/dist/svelte-kit/src/routing/inbound/resolve-inbound.js

@@ -2,7 +2,7 @@ import { getLocaleFromPathname } from '../locale/get-locale-from-pathname.js';
 import { getLocaleFromHost } from '../locale/get-locale-from-host.js';
 import { getLocaleFromQuery } from '../locale/get-locale-from-query.js';
 import { resolveLocale } from './resolve-locale/resolve-locale.js';
-import { resolvePathname } from './resolve-pathname/resolve-pathname.js';
+import { resolvePath } from './resolve-path/resolve-path.js';
 
 /**
  * Resolves inbound routing state.
@@ -30,7 +30,7 @@ async function resolveInbound(config, rawPathname, localeInputs, options) {
     // ------------------------------------------------------
     // Resolve localized pathname and redirect requirement
     // ------------------------------------------------------
-    const { pathname, shouldRedirect } = resolvePathname(config, rawPathname, {
+    const { pathname, shouldRedirect } = resolvePath(config, rawPathname, {
         locale,
         hasPathLocale: !!pathLocale,
         hasPersisted: !!cookie});

package/dist/svelte-kit/src/routing/inbound/resolve-path/resolve-path.js

@@ -0,0 +1,42 @@
+import { localizePathname } from '../../pathname/localize-pathname.js';
+import { all } from './strategies/all.js';
+import { exceptDefault } from './strategies/except-default.js';
+import { none } from './strategies/none.js';
+
+const assertNever = (x) => {
+    throw new Error(`Unhandled prefix strategy: ${x}`);
+};
+/**
+ * Resolves the canonical pathname based on locale prefix behavior.
+ *
+ * The resolved pathname represents the final, normalized form
+ * used for routing and navigation.
+ */
+const resolvePath = (config, rawPathname, context) => {
+    const { localePrefix } = config.routing;
+    let directive;
+    switch (localePrefix) {
+        case "all": {
+            directive = all(config, context);
+            break;
+        }
+        case "except-default": {
+            directive = exceptDefault(config, context);
+            break;
+        }
+        case "none": {
+            directive = none();
+            break;
+        }
+        default: {
+            return assertNever(localePrefix);
+        }
+    }
+    const { pathname } = localizePathname(rawPathname, config, context.locale);
+    return {
+        pathname,
+        shouldRedirect: directive.type === "redirect",
+    };
+};
+
+export { resolvePath };

package/dist/svelte-kit/src/routing/inbound/resolve-path/strategies/all.js

@@ -0,0 +1,28 @@
+/**
+ * Resolve pathname decision for routing prefix strategy: "all".
+ */
+function all(config, context) {
+    const { hasPathLocale, hasPersisted} = context;
+    const { redirect } = config.routing.inbound.firstVisit;
+    const isFirstVisit = !hasPersisted;
+    // ----------------------------------------------------------
+    // URL already canonical
+    // ----------------------------------------------------------
+    if (hasPathLocale) {
+        return { type: "pass" };
+    }
+    // ----------------------------------------------------------
+    // Apply first-visit redirect policy
+    // ----------------------------------------------------------
+    if (isFirstVisit) {
+        if (!redirect)
+            return { type: "pass" };
+        return { type: "redirect" };
+    }
+    // ----------------------------------------------------------
+    // Redirect to the locale-prefixed URL
+    // ----------------------------------------------------------
+    return { type: "redirect" };
+}
+
+export { all };

package/dist/svelte-kit/src/routing/inbound/resolve-path/strategies/except-default.js

@@ -0,0 +1,29 @@
+/**
+ * Resolve pathname decision for routing prefix strategy: "except-default".
+ */
+function exceptDefault(config, context) {
+    const { hasPathLocale, hasPersisted} = context;
+    const { redirect } = config.routing.inbound.firstVisit;
+    const isFirstVisit = !hasPersisted;
+    const isDefaultLocale = context.locale === config.defaultLocale;
+    // ----------------------------------------------------------
+    // URL already canonical
+    // ----------------------------------------------------------
+    if (hasPathLocale) {
+        return { type: "pass" };
+    }
+    // ----------------------------------------------------------
+    // Apply first-visit redirect policy
+    // ----------------------------------------------------------
+    if (isFirstVisit) {
+        if (!redirect)
+            return { type: "pass" };
+        return isDefaultLocale ? { type: "pass" } : { type: "redirect" };
+    }
+    // ----------------------------------------------------------
+    // Redirect non-default locale to the locale-prefixed URL
+    // ----------------------------------------------------------
+    return isDefaultLocale ? { type: "pass" } : { type: "redirect" };
+}
+
+export { exceptDefault };

package/dist/svelte-kit/src/routing/inbound/resolve-path/strategies/none.js

@@ -0,0 +1,8 @@
+/**
+ * Resolve pathname decision for routing prefix strategy: "none".
+ */
+function none() {
+    return { type: "pass" };
+}
+
+export { none };

package/dist/svelte-kit/src/server/translator/init-translator.js

@@ -2,11 +2,11 @@ import '../../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
 import 'logry';
 import 'p-limit';
+import { createTranslator } from '../../core/translator/create-translator.js';
 import 'intor-translator';
 import { loadMessages } from '../messages/load-messages.js';
 import 'node:path';
 import 'node:fs/promises';
-import { createTranslator } from './create-translator.js';
 
 /**
  * Initialize a locale-bound Translator snapshot.

package/dist/types/export/edge/index.d.ts

@@ -0,0 +1,2 @@
+export { getTranslator } from "../../src/edge";
+export { resolveInboundFromRequest } from "../../src/routing";

package/dist/types/export/fastify/index.d.ts

@@ -0,0 +1 @@
+export { intorFastifyPlugin, getTranslator } from "../../src/adapters/fastify";

package/dist/types/export/hono/index.d.ts

@@ -0,0 +1 @@
+export { createIntorHandler, getTranslator } from "../../src/adapters/hono";

package/dist/types/src/adapters/express/create-intor-handler.d.ts

@@ -4,11 +4,9 @@ import { type GetTranslatorParams } from "../../server";
 /**
  * Resolves locale-aware routing for the current execution context.
  *
- * The resolved routing state is exposed via response headers.
- *
- * - Permits cache writes during server execution.
+ * - Binds resolved routing state to the request.
  * - Convenience routing shortcuts are also bound to the request for downstream consumption.
  *
  * @platform Express
  */
-export declare function createIntorHandler(config: IntorResolvedConfig, options?: Omit<GetTranslatorParams, "locale">): (req: Request, _res: Response, next: NextFunction) => Promise<void>;
+export declare function createIntorHandler(config: IntorResolvedConfig, options?: Omit<GetTranslatorParams, "locale" | "fetch" | "allowCacheWrite">): (req: Request, _res: Response, next: NextFunction) => Promise<void>;

package/dist/types/src/adapters/express/get-translator.d.ts

@@ -1,9 +1,9 @@
 import type { IntorResolvedConfig } from "../../config";
-import type { GenConfigKeys, GenMessages, GenReplacements } from "../../core";
-import type { GetTranslatorParams, TranslatorInstanceServer } from "../../server";
+import type { GenConfigKeys, GenMessages, GenReplacements, GenRich, TranslatorInstance } from "../../core";
+import type { GetTranslatorParams } from "../../server";
 import type { Request } from "express";
 import type { LocalizedPreKey } from "intor-translator";
-type GetTranslatorExpressParams = Omit<GetTranslatorParams, "locale">;
+type GetTranslatorExpressParams<CK extends GenConfigKeys = "__default__"> = Omit<GetTranslatorParams<CK>, "locale">;
 /**
  * Get a server-side translator for the current execution context.
  *
@@ -11,8 +11,7 @@ type GetTranslatorExpressParams = Omit<GetTranslatorParams, "locale">;
  *
  * @platform Express
  */
-export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>>(config: IntorResolvedConfig, req: Request, params?: GetTranslatorExpressParams): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema>>;
-export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, PK extends string = LocalizedPreKey<GenMessages<CK>>>(config: IntorResolvedConfig, req: Request, params?: GetTranslatorExpressParams & {
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends LocalizedPreKey<GenMessages<CK>> | undefined = undefined>(config: IntorResolvedConfig, req: Request, params?: GetTranslatorExpressParams<CK> & {
     preKey?: PK;
-}): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema, PK>>;
+}): Promise<TranslatorInstance<GenMessages<CK>, ReplacementSchema, RichSchema, PK>>;
 export {};

package/dist/types/src/adapters/express/global.d.ts

@@ -1,5 +1,5 @@
+import type { TranslatorInstance } from "../../core";
 import type { InboundContext } from "../../routing";
-import type { TranslatorInstanceServer } from "../../server";
 import type { Locale, LocaleMessages } from "intor-translator";
 /**
  * Global type augmentations for Express request
@@ -9,9 +9,9 @@ declare global {
         interface Request {
             intor: InboundContext;
             locale: Locale;
-            hasKey: TranslatorInstanceServer<LocaleMessages>["hasKey"];
-            t: TranslatorInstanceServer<LocaleMessages>["t"];
-            tRich: TranslatorInstanceServer<LocaleMessages>["tRich"];
+            hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
+            t: TranslatorInstance<LocaleMessages>["t"];
+            tRich: TranslatorInstance<LocaleMessages>["tRich"];
         }
     }
 }

package/dist/types/src/adapters/fastify/create-intor-handler.d.ts

@@ -0,0 +1,12 @@
+import type { IntorResolvedConfig } from "../../config";
+import type { FastifyRequest } from "fastify";
+import { type GetTranslatorParams } from "../../server";
+/**
+ * Resolves locale-aware routing for the current execution context.
+ *
+ * - Binds resolved routing state to the request.
+ * - Convenience routing shortcuts are also bound to the request for downstream consumption.
+ *
+ * @platform Fastify
+ */
+export declare function createIntorHandler(config: IntorResolvedConfig, options?: Omit<GetTranslatorParams, "locale" | "fetch" | "allowCacheWrite">): (request: FastifyRequest) => Promise<void>;

package/dist/types/src/adapters/fastify/get-translator.d.ts

@@ -0,0 +1,17 @@
+import type { IntorResolvedConfig } from "../../config";
+import type { GenConfigKeys, GenMessages, GenReplacements, GenRich, TranslatorInstance } from "../../core";
+import type { GetTranslatorParams } from "../../server";
+import type { FastifyRequest } from "fastify";
+import type { LocalizedPreKey } from "intor-translator";
+type GetTranslatorFastifyParams<CK extends GenConfigKeys = "__default__"> = Omit<GetTranslatorParams<CK>, "locale">;
+/**
+ * Get a server-side translator for the current execution context.
+ *
+ * - Automatically resolves the locale from the framework context.
+ *
+ * @platform Fastify
+ */
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends LocalizedPreKey<GenMessages<CK>> | undefined = undefined>(config: IntorResolvedConfig, request: FastifyRequest, params?: GetTranslatorFastifyParams<CK> & {
+    preKey?: PK;
+}): Promise<TranslatorInstance<GenMessages<CK>, ReplacementSchema, RichSchema, PK>>;
+export {};

package/dist/types/src/adapters/fastify/global.d.ts

@@ -0,0 +1,17 @@
+import "fastify";
+import type { TranslatorInstance } from "../../core";
+import type { InboundContext } from "../../routing";
+import type { Locale, LocaleMessages } from "intor-translator";
+/**
+ * Global type augmentations for Fastify request
+ */
+declare module "fastify" {
+    interface FastifyRequest {
+        intor: InboundContext;
+        locale: Locale;
+        hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
+        t: TranslatorInstance<LocaleMessages>["t"];
+        tRich: TranslatorInstance<LocaleMessages>["tRich"];
+    }
+}
+export {};

package/dist/types/src/adapters/fastify/index.d.ts

@@ -0,0 +1,3 @@
+export { intorFastifyPlugin } from "./intor-fastify-plugin";
+export { getTranslator } from "./get-translator";
+export * from "./global";

package/dist/types/src/adapters/fastify/intor-fastify-plugin.d.ts

@@ -0,0 +1,21 @@
+import type { IntorResolvedConfig } from "../../config";
+import type { GetTranslatorParams } from "../../server";
+import type { FastifyInstance } from "fastify";
+interface IntorFastifyPluginOptions extends Omit<GetTranslatorParams, "locale"> {
+    config: IntorResolvedConfig;
+    /**
+     * Bind DX shortcuts to request:
+     * - request.locale
+     * - request.hasKey
+     * - request.t
+     * - request.tRich
+     *
+     * Defaults to true
+     */
+    shortcuts?: boolean;
+}
+/**
+ * Intor Fastify adapter plugin
+ */
+export declare function intorFastifyPlugin(fastify: FastifyInstance, options: IntorFastifyPluginOptions): void;
+export {};

package/dist/types/src/adapters/hono/create-intor-handler.d.ts

@@ -0,0 +1,10 @@
+import type { IntorResolvedConfig } from "../../config";
+import type { Context, Next } from "hono";
+/**
+ * Resolves locale-aware routing for the current execution context.
+ *
+ * - Binds resolved routing state to the request.
+ *
+ * @platform Hono
+ */
+export declare function createIntorHandler(config: IntorResolvedConfig): (c: Context, next: Next) => Promise<void>;

package/dist/types/src/adapters/hono/get-translator.d.ts

@@ -0,0 +1,17 @@
+import type { IntorResolvedConfig } from "../../config";
+import type { GenConfigKeys, GenMessages, GenReplacements, GenRich, TranslatorInstance } from "../../core";
+import type { GetTranslatorParams } from "../../edge";
+import type { Context } from "hono";
+import type { LocalizedPreKey } from "intor-translator";
+type GetTranslatorHonoParams<CK extends GenConfigKeys = "__default__"> = Omit<GetTranslatorParams<CK>, "locale">;
+/**
+ * Get a edge-runtime translator for the current execution context.
+ *
+ * - Automatically resolves the locale from the framework context.
+ *
+ * @platform Hono
+ */
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends LocalizedPreKey<GenMessages<CK>> | undefined = undefined>(config: IntorResolvedConfig, c: Context, params?: GetTranslatorHonoParams<CK> & {
+    preKey?: PK;
+}): Promise<TranslatorInstance<GenMessages<CK>, ReplacementSchema, RichSchema, PK>>;
+export {};

package/dist/types/src/adapters/hono/global.d.ts

@@ -0,0 +1,17 @@
+import "hono";
+import type { TranslatorInstance } from "../../core";
+import type { InboundContext } from "../../routing";
+import type { LocaleMessages } from "intor-translator";
+/**
+ * Global type augmentations for Hono context variables
+ */
+declare module "hono" {
+    interface ContextVariableMap {
+        intor: InboundContext;
+        locale: TranslatorInstance<LocaleMessages>["locale"];
+        hasKey: TranslatorInstance<LocaleMessages>["hasKey"];
+        t: TranslatorInstance<LocaleMessages>["t"];
+        tRich: TranslatorInstance<LocaleMessages>["tRich"];
+    }
+}
+export {};

package/dist/types/src/adapters/hono/index.d.ts

@@ -0,0 +1,3 @@
+export { createIntorHandler } from "./create-intor-handler";
+export { getTranslator } from "./get-translator";
+export * from "./global";

package/dist/types/src/adapters/next/server/get-translator.d.ts

@@ -1,8 +1,8 @@
 import type { IntorResolvedConfig } from "../../../config";
-import type { GenConfigKeys, GenMessages, GenReplacements } from "../../../core";
-import type { GetTranslatorParams, TranslatorInstanceServer } from "../../../server";
+import type { GenConfigKeys, GenMessages, GenReplacements, GenRich, TranslatorInstance } from "../../../core";
+import type { GetTranslatorParams } from "../../../server";
 import type { LocalizedPreKey } from "intor-translator";
-type GetTranslatorNextParams = Omit<GetTranslatorParams, "locale">;
+type GetTranslatorNextParams<CK extends GenConfigKeys = "__default__"> = Omit<GetTranslatorParams<CK>, "locale">;
 /**
  * Get a server-side translator for the current execution context.
  *
@@ -10,8 +10,7 @@ type GetTranslatorNextParams = Omit<GetTranslatorParams, "locale">;
  *
  * @platform Next.js
  */
-export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>>(config: IntorResolvedConfig, params?: GetTranslatorNextParams): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema>>;
-export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, PK extends string = LocalizedPreKey<GenMessages<CK>>>(config: IntorResolvedConfig, params?: GetTranslatorNextParams & {
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends LocalizedPreKey<GenMessages<CK>> | undefined = undefined>(config: IntorResolvedConfig, params: GetTranslatorNextParams<CK> & {
     preKey?: PK;
-}): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema, PK>>;
+}): Promise<TranslatorInstance<GenMessages<CK>, ReplacementSchema, RichSchema, PK>>;
 export {};

package/dist/types/src/adapters/svelte-kit/server/create-intor-handler.d.ts

@@ -3,8 +3,6 @@ import type { Handle } from "@sveltejs/kit";
 /**
  * Resolves locale-aware routing for the current execution context.
  *
- * The resolved routing state is exposed via response headers.
- *
  * - Acts as the canonical routing authority within the SvelteKit request lifecycle.
  *
  * @platform SvelteKit

package/dist/types/src/client/react/translator/trans.d.ts

@@ -4,18 +4,9 @@ import type { LocalizedKey, LocalizedReplacement, LocalizedRich, Replacement } f
 type TransProps<CK extends GenConfigKeys = "__default__", K extends string = LocalizedKey<GenMessages<CK>>, RI = LocalizedRich<GenRich<CK>, K>, RE extends Replacement = LocalizedReplacement<GenReplacements<CK>, K>> = {
     /** The message key to translate. */
     i18nKey: K | (string & {});
-    /**
-     * Optional React renderers for semantic tags in rich messages.
-     *
-     * Maps a tag name to either a React node or a render function,
-     * allowing customization of rich tag rendering.
-     */
-    components?: ReactTagRenderers<RI>;
-    /**
-     * Optional replacement values for message interpolation.
-     *
-     * These values are passed to the underlying translator.
-     */
+    /** Optional React renderers for semantic tags. */
+    components?: ReactTagRenderers<RI> | ReactTagRenderers;
+    /** Optional replacement values for interpolation. */
     values?: RE | Replacement;
 };
 /**

package/dist/types/src/client/react/translator/translator-instance.d.ts

@@ -2,11 +2,7 @@ import type { ReactTagRenderers } from "../render";
 import type { TranslatorInstance } from "../../../core";
 import type { JSX } from "react/jsx-runtime";
 import { type Locale, type LocaleMessages, type LocalizedKey, type LocalizedReplacement, type LocalizedRich, type Replacement, type Rich, type ScopedKey } from "intor-translator";
-export type TranslatorInstanceReact<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = TranslatorInstance<M, ReplacementSchema, PK> & {
-    /** `messages`: The message object containing all translations. */
-    messages: M;
-    /** Current locale in use. */
-    locale: Locale<M>;
+export type TranslatorInstanceReact<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = Omit<TranslatorInstance<M, ReplacementSchema, RichSchema, PK>, "tRich"> & {
     /** Indicates whether translations are currently loading. */
     isLoading: boolean;
     /** Update the active locale. */

package/dist/types/src/client/react/translator/use-translator.d.ts

@@ -2,7 +2,8 @@ import type { TranslatorInstanceReact } from "./translator-instance";
 import type { GenConfigKeys, GenMessages, GenReplacements, GenRich } from "../../../core";
 import type { LocalizedPreKey } from "intor-translator";
 /**
- * React hook to access the active translator instance.
+ * React hook for accessing the active, scope-aware translator instance.
+ *
+ * @platform React
  */
-export declare function useTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>>(): TranslatorInstanceReact<GenMessages<CK>, ReplacementSchema, RichSchema, undefined>;
-export declare function useTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends string = LocalizedPreKey<GenMessages<CK>>>(preKey?: PK): TranslatorInstanceReact<GenMessages<CK>, ReplacementSchema, RichSchema, PK>;
+export declare function useTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends LocalizedPreKey<GenMessages<CK>> | undefined = undefined>(preKey?: PK): TranslatorInstanceReact<GenMessages<CK>, ReplacementSchema, RichSchema, PK>;