intor 2.3.30 → 2.3.32

package/dist/svelte/src/core/render/create-html-renderer.js

@@ -0,0 +1,44 @@
+import { escapeHtml } from './utils/escape-html.js';
+import { renderAttributes } from './utils/render-attributes.js';
+
+/**
+ * Create an HTML string renderer for semantic rich messages.
+ *
+ * - Transforms semantic rich AST nodes into escaped HTML strings.
+ * - Can be used in any HTML-based environment.
+ *
+ * This renderer is intentionally minimal and stateless.
+ */
+const createHtmlRenderer = (tagRenderers) => {
+    return {
+        /** Render plain text nodes */
+        text(value) {
+            return escapeHtml(value);
+        },
+        /** Render semantic tag nodes */
+        tag(name, attributes, children) {
+            const tagRenderer = tagRenderers?.[name];
+            if (tagRenderer) {
+                return typeof tagRenderer === "function"
+                    ? tagRenderer(children)
+                    : tagRenderer;
+            }
+            // Default behavior: render as native HTML tag
+            return `<${name}${renderAttributes(attributes)}>${children.join("")}</${name}>`;
+        },
+        /** Render raw (non-tokenized) message values as escaped HTML strings */
+        raw(value) {
+            if (value == null)
+                return "";
+            if (typeof value === "string" || typeof value === "number") {
+                return escapeHtml(String(value));
+            }
+            if (Array.isArray(value)) {
+                return value.map((v) => escapeHtml(String(v))).join("");
+            }
+            throw new Error("[intor] HTML renderer cannot render raw non-primitive values.");
+        },
+    };
+};
+
+export { createHtmlRenderer };

package/dist/svelte/src/core/render/utils/escape-html.js

@@ -0,0 +1,10 @@
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+
+export { escapeHtml };

package/dist/svelte/src/core/render/utils/render-attributes.js

@@ -0,0 +1,17 @@
+import { escapeHtml } from './escape-html.js';
+
+function renderAttributes(attributes) {
+    if (!attributes)
+        return "";
+    return Object.entries(attributes)
+        .map(([key, value]) => {
+        if (value === true)
+            return ` ${key}`;
+        if (value == null)
+            return "";
+        return ` ${key}="${escapeHtml(String(value))}"`;
+    })
+        .join("");
+}
+
+export { renderAttributes };

package/dist/svelte/src/core/translator/create-t-rich.js

@@ -0,0 +1,22 @@
+import { renderRichMessage } from 'intor-translator';
+import { createHtmlRenderer } from '../render/create-html-renderer.js';
+
+/**
+ * Create an HTML-string rich translation function.
+ *
+ * - Resolves translated messages via `translator.t`
+ * - Renders semantic rich tags into escaped HTML strings
+ * - Supports optional scoped keys via `preKey`
+ *
+ * Can be used in any HTML-based environment (Astro, Svelte, SSR, etc.).
+ */
+const createTRich = (t) => {
+    return (key, tagRenderers, replacements) => {
+        const message = t(key, replacements);
+        const renderer = createHtmlRenderer(tagRenderers);
+        const nodes = renderRichMessage(message, renderer);
+        return nodes.join("");
+    };
+};
+
+export { createTRich };

package/dist/svelte-kit/src/adapters/svelte-kit/navigation/use-navigation.js

@@ -4,6 +4,7 @@ import { useIntorContext } from 'intor/svelte';
 import '../../../core/error/intor-error.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { resolveNavigation } from '../../../routing/navigation/resolve-navigation.js';
 import { goto } from '$app/navigation';
 import { page } from '$app/state';

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

@@ -1,9 +1,10 @@
 import { redirect } from '@sveltejs/kit';
-import { INTOR_HEADERS } from '../../../core/constants/headers.js';
+import { isSvelteKitSSG } from './utils/is-svelte-kit-ssg.js';
 import '../../../core/error/intor-error.js';
 import { normalizeQuery } from '../../../core/utils/normalizers/normalize-query.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { resolveInbound } from '../../../routing/inbound/resolve-inbound.js';
 import { getLocaleFromAcceptLanguage } from '../../../routing/locale/get-locale-from-accept-language.js';
 
@@ -18,28 +19,37 @@ import { getLocaleFromAcceptLanguage } from '../../../routing/locale/get-locale-
  */
 function createIntorHandle(config) {
     return async ({ event, resolve }) => {
-        // ----------------------------------------------------------
         // Locale from Accept-Language header
-        // ----------------------------------------------------------
         const acceptLanguage = event.request.headers.get("accept-language");
         const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(acceptLanguage, config.supportedLocales);
         // ----------------------------------------------------------
         // Resolve inbound routing decision (pure computation)
         // ----------------------------------------------------------
-        const { locale, localeSource, pathname, shouldRedirect } = await resolveInbound(config, event.url.pathname, false, {
-            host: event.url.host,
-            query: normalizeQuery(Object.fromEntries(event.url.searchParams.entries())),
-            cookie: event.cookies.get(config.cookie.name),
-            detected: localeFromAcceptLanguage || config.defaultLocale,
-        });
+        let inbound;
+        if (isSvelteKitSSG(event)) {
+            inbound = {
+                locale: event.params?.locale,
+                localeSource: "path",
+                pathname: event.url.pathname,
+                shouldRedirect: false,
+            };
+        }
+        else {
+            inbound = await resolveInbound(config, event.url.pathname, false, {
+                host: event.url.host,
+                query: normalizeQuery(Object.fromEntries(event.url.searchParams.entries())),
+                cookie: event.cookies.get(config.cookie.name),
+                detected: localeFromAcceptLanguage || config.defaultLocale,
+            });
+        }
+        const { locale, localeSource, pathname, shouldRedirect } = inbound;
         // ----------------------------------------------------------
         // Redirect if needed
         // ----------------------------------------------------------
-        if (shouldRedirect) {
-            throw redirect(307, pathname);
-        }
+        if (shouldRedirect)
+            redirect(307, pathname);
         // ----------------------------------------------------------
-        // Attach routing metadata
+        // Bind inbound routing context
         // ----------------------------------------------------------
         // @ts-expect-error - App.Locals must be extended by user
         event.locals.intor = {
@@ -47,10 +57,9 @@ function createIntorHandle(config) {
             localeSource,
             pathname,
         };
-        const response = await resolve(event);
-        response.headers.set(INTOR_HEADERS.LOCALE, locale);
-        response.headers.set(INTOR_HEADERS.LOCALE_SOURCE, localeSource);
-        response.headers.set(INTOR_HEADERS.PATHNAME, pathname);
+        const response = await resolve(event, {
+            transformPageChunk: ({ html }) => html.replace("%lang%", locale),
+        });
         return response;
     };
 }

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

@@ -1,10 +1,10 @@
 import '../../../core/error/intor-error.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { intor as intor$1 } from '../../../server/intor/intor.js';
 import 'node:path';
 import 'node:fs/promises';
-import 'intor-translator';
 
 /**
  * Initializes Intor for the current execution context.

package/dist/svelte-kit/src/adapters/svelte-kit/server/utils/is-svelte-kit-ssg.js

@@ -0,0 +1,15 @@
+/**
+ * Heuristic to detect static (prerender) execution in SvelteKit.
+ *
+ * This is NOT a guaranteed signal.
+ * It intentionally prefers false positives over false negatives.
+ */
+function isSvelteKitSSG(event) {
+    // No user-agent is a strong signal of static rendering
+    if (event.request.headers.get("user-agent") === null) {
+        return true;
+    }
+    return false;
+}
+
+export { isSvelteKitSSG };

package/dist/svelte-kit/src/client/shared/navigation/execute-navigation.js

@@ -1,6 +1,7 @@
 import '../../../core/error/intor-error.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { shouldSyncLocale } from '../../../policies/should-sync-locale.js';
 import { setLocaleCookie } from '../utils/locale/set-locale-cookie.js';
 

package/dist/svelte-kit/src/policies/shoud-full-reload.js

@@ -2,6 +2,7 @@ import '../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../core/utils/resolve-loader-options.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Determine whether client-side navigation must be forced to reload.

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

@@ -2,6 +2,7 @@ import '../../../core/error/intor-error.js';
 import { normalizeLocale } from '../../../core/utils/normalizers/normalize-locale.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Resolve the active locale from inbound routing configuration.

package/dist/svelte-kit/src/routing/locale/get-locale-from-pathname.js

@@ -2,6 +2,7 @@ import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Get locale from pathname.

package/dist/svelte-kit/src/routing/pathname/canonicalize-pathname.js

@@ -3,6 +3,7 @@ import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Returns a canonical, locale-agnostic pathname.

package/dist/svelte-kit/src/routing/pathname/materialize-pathname.js

@@ -3,6 +3,7 @@ import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Materializes a standardized pathname by applying

package/dist/svelte-kit/src/routing/pathname/standardize-pathname.js

@@ -3,6 +3,7 @@ import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Standardizes a canonical pathname into an internal routing template

package/dist/svelte-kit/src/server/intor/intor.js

@@ -1,6 +1,7 @@
 import '../../core/error/intor-error.js';
 import { getLogger } from '../../core/logger/get-logger.js';
 import 'p-limit';
+import 'intor-translator';
 import { initTranslator } from '../translator/init-translator.js';
 
 /**

package/dist/svelte-kit/src/server/messages/load-local-messages/load-local-messages.js

@@ -3,6 +3,7 @@ import pLimit from 'p-limit';
 import '../../../core/error/intor-error.js';
 import { normalizeCacheKey } from '../../../core/utils/normalizers/normalize-cache-key.js';
 import { getLogger } from '../../../core/logger/get-logger.js';
+import 'intor-translator';
 import { getMessagesPool } from './cache/messages-pool.js';
 import { readLocaleMessages } from './read-locale-messages/read-locale-messages.js';
 

package/dist/svelte-kit/src/server/messages/load-local-messages/read-locale-messages/collect-file-entries/collect-file-entries.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import '../../../../../core/error/intor-error.js';
 import { getLogger } from '../../../../../core/logger/get-logger.js';
 import 'p-limit';
+import 'intor-translator';
 
 /**
  * Recursively collects message file metadata under a given locale root.

package/dist/svelte-kit/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/parse-file-entries.js

@@ -5,6 +5,7 @@ import { getLogger } from '../../../../../core/logger/get-logger.js';
 import 'p-limit';
 import { isValidMessages } from '../../../../../core/messages/utils/is-valid-messages.js';
 import { nestObjectFromPath } from '../../../../../core/messages/utils/nest-object-from-path.js';
+import 'intor-translator';
 import { jsonReader } from './utils/json-reader.js';
 
 /**

package/dist/svelte-kit/src/server/messages/load-messages.js

@@ -2,6 +2,7 @@ import '../../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
 import { getLogger } from '../../core/logger/get-logger.js';
 import { loadRemoteMessages } from '../../core/messages/load-remote-messages/load-remote-messages.js';
+import 'intor-translator';
 import { loadLocalMessages } from './load-local-messages/load-local-messages.js';
 
 /**

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

@@ -2,17 +2,14 @@ import { Translator } from 'intor-translator';
 import { mergeMessages } from '../../core/messages/merge-messages.js';
 
 /**
- * Create a server-side translator snapshot.
+ * Create a server-side Translator instance for a fixed locale.
  *
  * - Merges static config messages with runtime-loaded messages
- * - Creates a Translator instance for a fixed locale
- * - Optionally scopes the translator with a preKey
- *
- * The returned object is a read-only translation view
- * and does not expose the underlying Translator instance.
+ * - Initializes a Translator bound to a specific locale
+ * - Injects fallback rules, handlers, and plugins from config
  */
 function createTranslator(params) {
-    const { config, locale, messages, preKey, handlers, plugins } = params;
+    const { config, locale, messages, handlers, plugins } = params;
     // Merge static config messages with runtime-loaded messages
     const finalMessages = mergeMessages(config.messages, messages, {
         config,
@@ -27,14 +24,7 @@ function createTranslator(params) {
         handlers,
         plugins,
     });
-    // Apply scoped view when preKey is provided
-    const scoped = preKey ? translator.scoped(preKey) : null;
-    return {
-        messages: finalMessages,
-        locale,
-        hasKey: scoped ? scoped.hasKey : translator.hasKey,
-        t: scoped ? scoped.t : translator.t,
-    };
+    return translator;
 }
 
 export { createTranslator };

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

@@ -2,19 +2,20 @@ import '../../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
 import 'logry';
 import 'p-limit';
+import 'intor-translator';
 import { loadMessages } from '../messages/load-messages.js';
 import 'node:path';
 import 'node:fs/promises';
 import { createTranslator } from './create-translator.js';
 
 /**
- * Initializes a server-side translator for a specific locale.
+ * Initialize a locale-bound Translator snapshot.
  *
- * - Performs message loading during initialization.
- * - Returns an immutable translator snapshot.
+ * - Resolves loader options and loads messages if configured
+ * - Creates an immutable Translator instance for server usage
  */
 async function initTranslator(config, locale, options) {
-    const { readers, allowCacheWrite = false, fetch, preKey, handlers, plugins, } = options;
+    const { readers, allowCacheWrite = false, fetch, handlers, plugins, } = options;
     const loader = resolveLoaderOptions(config, "server");
     // Load messages
     let messages = {};
@@ -29,14 +30,7 @@ async function initTranslator(config, locale, options) {
         messages = loaded || {};
     }
     // Create immutable translator snapshot
-    return createTranslator({
-        config,
-        locale,
-        messages,
-        preKey,
-        handlers,
-        plugins,
-    });
+    return createTranslator({ config, locale, messages, handlers, plugins });
 }
 
 export { initTranslator };

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

@@ -1,2 +1,2 @@
-export type { INTOR_GENERATED_KEY, GenConfigKeys, GenConfig, GenMessages, GenLocale, TranslatorInstance, } from "../../src/core";
+export type { GenConfigKeys, GenConfig, TranslatorInstance, } from "../../src/core";
 export type { TranslatorInstanceReact } from "../../src/client/react/translator/translator-instance";

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

@@ -1,3 +1,3 @@
 export { createIntorStore, // @internal
-IntorProvider, useIntorContext, // @internal
+IntorProvider, type IntorProviderProps, useIntorContext, // @internal
 useTranslator, getClientLocale, } from "../../src/client/svelte";

package/dist/types/src/adapters/svelte-kit/server/utils/is-svelte-kit-ssg.d.ts

@@ -0,0 +1,8 @@
+import type { RequestEvent } from "@sveltejs/kit";
+/**
+ * Heuristic to detect static (prerender) execution in SvelteKit.
+ *
+ * This is NOT a guaranteed signal.
+ * It intentionally prefers false positives over false negatives.
+ */
+export declare function isSvelteKitSSG(event: RequestEvent<Record<string, string>, string | null>): boolean;

package/dist/types/src/client/react/render/index.d.ts

@@ -1,2 +1,2 @@
-export { renderRichMessageReact } from "./render-rich-message-react";
+export { createReactRenderer } from "./create-react-renderer";
 export type { ReactTagRenderers } from "./types";

package/dist/types/src/client/react/render/types.d.ts

@@ -1,8 +1,4 @@
+import type { TagRenderers } from "../../../core";
 import type { Rich } from "intor-translator";
-/** Renderer function for a semantic rich tag. */
-type ReactTagRenderer = ((children: React.ReactNode[]) => React.ReactNode) | React.ReactNode;
 /** Mapping of semantic rich tags to React renderers. */
-export type ReactTagRenderers<RichSchema = Rich> = {
-    [K in keyof RichSchema]: ReactTagRenderer;
-} & Record<string, ReactTagRenderer>;
-export {};
+export type ReactTagRenderers<RichSchema = Rich> = TagRenderers<React.ReactNode, RichSchema>;

package/dist/types/src/client/react/translator/create-t-rich.d.ts

@@ -1,5 +1,5 @@
 import type { ReactTagRenderers } from "../render";
-import type { Replacement, Translator } from "intor-translator";
+import { type Replacement, type TranslatorMethods } from "intor-translator";
 /**
  * Create a React-specific rich translation function.
  *
@@ -12,4 +12,4 @@ import type { Replacement, Translator } from "intor-translator";
  *
  * Intended for React client usage only.
  */
-export declare const createTRich: (translator: Translator, preKey?: string) => (key: string, tagRenderers?: ReactTagRenderers, replacements?: Replacement) => import("react/jsx-runtime").JSX.Element[];
+export declare const createTRich: (t: TranslatorMethods["t"]) => (key: string, tagRenderers?: ReactTagRenderers, replacements?: Replacement) => import("react/jsx-runtime").JSX.Element[];

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

@@ -12,5 +12,5 @@ export type TranslatorInstanceReact<M extends LocaleMessages, ReplacementSchema
     /** Update the active locale. */
     setLocale: (locale: Locale<M>) => void;
     /** Translate a key into React nodes using semantic tags */
-    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: ReactTagRenderers<RI>, replacements?: RE | Replacement) => JSX.Element[];
+    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: ReactTagRenderers<RI> | ReactTagRenderers, replacements?: RE | Replacement) => JSX.Element[];
 };

package/dist/types/src/client/svelte/index.d.ts

@@ -1,3 +1,3 @@
-export { createIntorStore, IntorProvider, useIntorContext } from "./provider";
+export { createIntorStore, IntorProvider, type IntorProviderProps, useIntorContext, } from "./provider";
 export { useTranslator } from "./translator";
 export { getClientLocale } from "../shared/helpers";

package/dist/types/src/client/svelte/provider/index.d.ts

@@ -1,3 +1,4 @@
 export { createIntorStore } from "./create-intor-store";
 export { default as IntorProvider } from "./intor-provider.svelte";
+export type { IntorValue, IntorProviderProps } from "./types";
 export { useIntorContext } from "./use-intor-context";

package/dist/types/src/client/svelte/provider/types.d.ts

@@ -10,6 +10,10 @@ export interface IntorValue {
     handlers?: TranslateHandlers;
     plugins?: (TranslatorPlugin | TranslateHook)[];
 }
+export interface IntorProviderProps {
+    value: IntorValue;
+    children: () => any;
+}
 export interface IntorContextValue {
     config: IntorResolvedConfig;
     locale: Writable<Locale>;

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

@@ -1,7 +1,6 @@
-import type { SvelteTagRenderers } from "../render";
-import type { TranslatorInstance } from "../../../core";
-import type { Readable, Writable } from "svelte/store";
+import type { HtmlTagRenderers, TranslatorInstance } from "../../../core";
 import { type Locale, type LocaleMessages, type LocalizedKey, type LocalizedReplacement, type LocalizedRich, type Replacement, type Rich, type ScopedKey } from "intor-translator";
+import { type Readable, type Writable } from "svelte/store";
 export type TranslatorInstanceSvelte<M extends LocaleMessages, ReplacementSchema = Replacement, RichSchema = Rich, PK extends string | undefined = undefined> = {
     /** `messages`: The message object containing all translations. */
     messages: Readable<M>;
@@ -16,5 +15,5 @@ export type TranslatorInstanceSvelte<M extends LocaleMessages, ReplacementSchema
     /** Translate a given key into its string representation. */
     t: Readable<TranslatorInstance<M, ReplacementSchema, PK>["t"]>;
     /** Translate a key into an HTML string using semantic rich tags. */
-    tRich: Readable<(<K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: SvelteTagRenderers<RI>, replacements?: RE | Replacement) => string)>;
+    tRich: Readable<(<K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: HtmlTagRenderers<RI> | HtmlTagRenderers, replacements?: RE | Replacement) => string)>;
 };

package/dist/types/src/client/vue/render/index.d.ts

@@ -1,2 +1,2 @@
-export { renderRichMessageVue } from "./render-rich-message-vue";
+export { createVueRenderer } from "./create-vue-renderer";
 export type { VueTagRenderers } from "./types";

package/dist/types/src/client/vue/render/types.d.ts

@@ -1,9 +1,5 @@
+import type { TagRenderers } from "../../../core";
 import type { Rich } from "intor-translator";
 import type { VNodeChild } from "vue";
-/** Renderer function for a semantic rich tag. */
-type VueTagRenderer = (children: VNodeChild[]) => VNodeChild | VNodeChild;
 /** Mapping of semantic rich tags to Vue renderers. */
-export type VueTagRenderers<RichSchema = Rich> = {
-    [K in keyof RichSchema]: VueTagRenderer;
-} & Record<string, VueTagRenderer>;
-export {};
+export type VueTagRenderers<RichSchema = Rich> = TagRenderers<VNodeChild, RichSchema>;

package/dist/types/src/client/vue/translator/create-t-rich.d.ts

@@ -1,6 +1,5 @@
 import type { VueTagRenderers } from "../../../client/vue/render";
-import type { Replacement, Translator } from "intor-translator";
-import { type ComputedRef } from "vue";
+import { type Replacement, type TranslatorMethods } from "intor-translator";
 /**
  * Create a Vue-specific rich translation function.
  *
@@ -13,4 +12,4 @@ import { type ComputedRef } from "vue";
  *
  * Intended for Vue client usage only.
  */
-export declare const createTRich: (translator: ComputedRef<Translator>, preKey?: string) => (key: string, tagRenderers?: VueTagRenderers, replacements?: Replacement) => import("vue").VNodeChild[];
+export declare const createTRich: (t: TranslatorMethods["t"]) => (key: string, tagRenderers?: VueTagRenderers, replacements?: Replacement) => import("vue").VNodeChild[];

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

@@ -12,5 +12,5 @@ export type TranslatorInstanceVue<M extends LocaleMessages, ReplacementSchema =
     /** Update the active locale. */
     setLocale: (locale: Locale<M>) => void;
     /** Translate a key into React nodes using semantic tags */
-    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: VueTagRenderers<RI>, replacements?: RE | Replacement) => VNodeChild[];
+    tRich: <K extends string = PK extends string ? ScopedKey<M, PK> : LocalizedKey<M>, RI = LocalizedRich<RichSchema, K>, RE = LocalizedReplacement<ReplacementSchema, K>>(key?: K | (string & {}), tagRenderers?: VueTagRenderers<RI> | VueTagRenderers, replacements?: RE | Replacement) => VNodeChild[];
 };

package/dist/types/src/core/index.d.ts

@@ -3,4 +3,6 @@ export { IntorError, IntorErrorCode } from "./error";
 export { deepMerge, type PlainObject, type DeepMergeOverrideEvent, resolveLoaderOptions, normalizePathname, normalizeCacheKey, normalizeLocale, normalizeQuery, } from "./utils";
 export { getLogger, clearLoggerPool } from "./logger";
 export { loadRemoteMessages, mergeMessages, isValidMessages, nestObjectFromPath, type MessagesReader, type MessagesReaders, INTOR_PREFIX, INTOR_MESSAGES_KIND_KEY, INTOR_MESSAGES_KIND, getMessagesKind, type IntorMessagesKind, } from "./messages";
+export { createHtmlRenderer, type TagRenderers, type HtmlTagRenderers, } from "./render";
+export { createTRich } from "./translator";
 export type { INTOR_GENERATED_KEY, IfGen, GenConfigKeys, GenConfig, GenMessages, GenLocale, GenReplacements, GenRich, TranslatorInstance, RoutingLocaleSource, RoutingLocaleCarrier, LocalePathPrefix, RuntimeFetch, } from "./types";

package/dist/types/src/core/render/create-html-renderer.d.ts

@@ -0,0 +1,11 @@
+import type { TagRenderers } from "./types";
+import type { Renderer } from "intor-translator";
+/**
+ * Create an HTML string renderer for semantic rich messages.
+ *
+ * - Transforms semantic rich AST nodes into escaped HTML strings.
+ * - Can be used in any HTML-based environment.
+ *
+ * This renderer is intentionally minimal and stateless.
+ */
+export declare const createHtmlRenderer: (tagRenderers?: TagRenderers) => Renderer<string>;

package/dist/types/src/core/render/index.d.ts

@@ -0,0 +1,2 @@
+export { createHtmlRenderer } from "./create-html-renderer";
+export type { TagRenderers, HtmlTagRenderers } from "./types";

package/dist/types/src/core/render/types.d.ts

@@ -0,0 +1,10 @@
+import type { Rich } from "intor-translator";
+/** Renderer function for a semantic rich tag. */
+type TagRenderer<Output = string> = ((children: Output[]) => Output) | Output;
+/** Core mapping of semantic rich tags to renderers. */
+export type TagRenderers<Output = string, RichSchema = Rich> = {
+    [K in keyof RichSchema]: TagRenderer<Output>;
+} & Record<string, TagRenderer<Output>>;
+/** Mapping of semantic rich tags to HTML string renderers. */
+export type HtmlTagRenderers<RichSchema = Rich> = TagRenderers<string, RichSchema>;
+export {};

package/dist/types/src/core/translator/create-t-rich.d.ts

@@ -0,0 +1,12 @@
+import { type Replacement, type TranslatorMethods } from "intor-translator";
+import { type TagRenderers } from "../render";
+/**
+ * Create an HTML-string rich translation function.
+ *
+ * - Resolves translated messages via `translator.t`
+ * - Renders semantic rich tags into escaped HTML strings
+ * - Supports optional scoped keys via `preKey`
+ *
+ * Can be used in any HTML-based environment (Astro, Svelte, SSR, etc.).
+ */
+export declare const createTRich: (t: TranslatorMethods["t"]) => (key: string, tagRenderers?: TagRenderers, replacements?: Replacement) => string;

package/dist/types/src/core/translator/index.d.ts

@@ -0,0 +1 @@
+export { createTRich } from "./create-t-rich";

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

@@ -1,7 +1,7 @@
 import type { TranslatorInstanceServer } from "../translator/translator-instance";
 import type { IntorResolvedConfig } from "../../config";
-import type { GenConfigKeys, GenMessages, GenReplacements, MessagesReaders, RuntimeFetch } from "../../core";
 import type { LocalizedPreKey, TranslateHandlers, TranslateHook, TranslatorPlugin } from "intor-translator";
+import { type GenConfigKeys, type GenMessages, type GenReplacements, type GenRich, type MessagesReaders, type RuntimeFetch } from "../../core";
 export interface GetTranslatorParams {
     locale: string;
     readers?: MessagesReaders;
@@ -13,7 +13,7 @@ export interface GetTranslatorParams {
 /**
  * Get a server-side translator for the current execution context.
  */
-export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>>(config: IntorResolvedConfig, params: GetTranslatorParams): 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: GetTranslatorParams & {
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>>(config: IntorResolvedConfig, params: GetTranslatorParams): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema, RichSchema, undefined>>;
+export declare function getTranslator<CK extends GenConfigKeys = "__default__", ReplacementSchema = GenReplacements<CK>, RichSchema = GenRich<CK>, PK extends string = LocalizedPreKey<GenMessages<CK>>>(config: IntorResolvedConfig, params: GetTranslatorParams & {
     preKey?: PK;
-}): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema, PK>>;
+}): Promise<TranslatorInstanceServer<GenMessages<CK>, ReplacementSchema, RichSchema, PK>>;