intor 2.5.0 → 2.5.1

package/dist/vue/src/client/vue/render/create-vue-renderer.js

@@ -1,30 +1,24 @@
 import { h } from 'vue';
 
-/**
- * Create a Vue renderer for semantic rich messages.
- */
 const createVueRenderer = (tagRenderers) => {
-    return {
-        /** Render plain text nodes */
-        text(value) {
-            return 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 a native Vue element
-            return h(name, null, children);
-        },
-        /** Render raw (non-tokenized) message values */
-        raw(value) {
-            return value;
-        },
-    };
+  return {
+    /** Render plain text nodes */
+    text(value) {
+      return value;
+    },
+    /** Render semantic tag nodes */
+    tag(name, _attributes, children) {
+      const tagRenderer = tagRenderers?.[name];
+      if (tagRenderer) {
+        return typeof tagRenderer === "function" ? tagRenderer(children) : tagRenderer;
+      }
+      return h(name, null, children);
+    },
+    /** Render raw (non-tokenized) message values */
+    raw(value) {
+      return value;
+    }
+  };
 };
 
 export { createVueRenderer };

package/dist/vue/src/client/vue/translator/create-t-rich.js

@@ -1,24 +1,12 @@
 import { renderRichMessage } from 'intor-translator';
 import { createVueRenderer } from '../render/create-vue-renderer.js';
 
-/**
- * Create a Vue-specific rich translation function.
- *
- * This adapter bridges the core Translator with the Vue rich
- * message rendering flow.
- *
- * - Resolves translated messages via `translator.t`
- * - Renders semantic tags using Vue renderers
- * - Supports optional scoped keys via `preKey`
- *
- * Intended for Vue client usage only.
- */
 const createTRich = (t) => {
-    return (key, tagRenderers, replacements) => {
-        const message = t(key, replacements);
-        const vueRenderer = createVueRenderer(tagRenderers);
-        return renderRichMessage(message, vueRenderer);
-    };
+  return (key, tagRenderers, replacements) => {
+    const message = t(key, replacements);
+    const vueRenderer = createVueRenderer(tagRenderers);
+    return renderRichMessage(message, vueRenderer);
+  };
 };
 
 export { createTRich };

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

@@ -1,40 +1,33 @@
 import { defineComponent, h, Fragment } from 'vue';
 import { useTranslator } from './use-translator.js';
 
-/**
- * Vue component for rendering rich translations.
- *
- * A thin wrapper around `tRich`.
- *
- * @public
- */
 const Trans = defineComponent({
-    name: "Trans",
-    props: {
-        /** The message key to translate. */
-        i18nKey: {
-            type: String,
-            required: true,
-        },
-        /** Optional Vue renderers for semantic tags. */
-        components: {
-            type: Object,
-            required: false,
-        },
-        /** Optional replacement values for interpolation. */
-        values: {
-            type: Object,
-            required: false,
-        },
+  name: "Trans",
+  props: {
+    /** The message key to translate. */
+    i18nKey: {
+      type: String,
+      required: true
     },
-    setup(props) {
-        const { tRich } = useTranslator();
-        return () => {
-            const { i18nKey, components, values } = props;
-            const nodes = tRich(i18nKey, components, values);
-            return h(Fragment, null, nodes);
-        };
+    /** Optional Vue renderers for semantic tags. */
+    components: {
+      type: Object,
+      required: false
     },
+    /** Optional replacement values for interpolation. */
+    values: {
+      type: Object,
+      required: false
+    }
+  },
+  setup(props) {
+    const { tRich } = useTranslator();
+    return () => {
+      const { i18nKey, components, values } = props;
+      const nodes = tRich(i18nKey, components, values);
+      return h(Fragment, null, nodes);
+    };
+  }
 });
 
 export { Trans };

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

@@ -3,24 +3,19 @@ import '../provider/intor-provider.js';
 import { injectIntorContext } from '../provider/inject-intor-context.js';
 import { createTRich } from './create-t-rich.js';
 
-/**
- * Vue composable for accessing the active, scope-aware translator instance.
- *
- * @public
- */
 function useTranslator(preKey) {
-    const intor = injectIntorContext();
-    const translator = intor.value.translator;
-    const scoped = computed(() => translator.value.scoped(preKey));
-    return {
-        messages: computed(() => translator.value.messages),
-        locale: computed(() => translator.value.locale),
-        isLoading: computed(() => translator.value.isLoading),
-        setLocale: intor.value.setLocale,
-        hasKey: (...args) => scoped.value.hasKey(...args),
-        t: (...args) => scoped.value.t(...args),
-        tRich: (...args) => createTRich(scoped.value.t)(...args),
-    };
+  const intor = injectIntorContext();
+  const translator = intor.value.translator;
+  const scoped = computed(() => translator.value.scoped(preKey));
+  return {
+    messages: computed(() => translator.value.messages),
+    locale: computed(() => translator.value.locale),
+    isLoading: computed(() => translator.value.isLoading),
+    setLocale: intor.value.setLocale,
+    hasKey: (...args) => scoped.value.hasKey(...args),
+    t: (...args) => scoped.value.t(...args),
+    tRich: (...args) => createTRich(scoped.value.t)(...args)
+  };
 }
 
 export { useTranslator };

package/dist/vue/src/core/logger/get-logger.js

@@ -2,41 +2,36 @@ import { logry } from 'logry';
 import { getGlobalLoggerPool } from './global-logger-pool.js';
 
 const DEFAULT_FORMAT_CONFIG = {
-    timestamp: { withDate: false },
+  timestamp: { withDate: false }
 };
 const DEFAULT_RENDER_CONFIG = {
-    id: { visible: true, prefix: "<", suffix: ">" },
-    meta: { lineBreaksAfter: 1 },
+  id: { visible: true, prefix: "<", suffix: ">" },
+  meta: { lineBreaksAfter: 1 }
 };
-/**
- * Get a shared logger instance by id.
- * - Safe across hot reloads
- * - Prevents unbounded memory usage via soft LRU
- */
-function getLogger({ id = "default", preset, ...options }) {
-    const pool = getGlobalLoggerPool();
-    const existing = pool.get(id);
-    if (existing)
-        return existing;
-    const baseConfig = preset === undefined
-        ? {
-            formatConfig: DEFAULT_FORMAT_CONFIG,
-            renderConfig: DEFAULT_RENDER_CONFIG,
-        }
-        : { preset };
-    const logger = logry({
-        id,
-        ...baseConfig,
-        ...options,
-    });
-    pool.set(id, logger);
-    // Soft LRU: keep pool size under control
-    if (pool.size > 1000) {
-        for (const key of [...pool.keys()].slice(0, 200)) {
-            pool.delete(key);
-        }
+function getLogger({
+  id = "default",
+  preset,
+  ...options
+}) {
+  const pool = getGlobalLoggerPool();
+  const existing = pool.get(id);
+  if (existing) return existing;
+  const baseConfig = preset === void 0 ? {
+    formatConfig: DEFAULT_FORMAT_CONFIG,
+    renderConfig: DEFAULT_RENDER_CONFIG
+  } : { preset };
+  const logger = logry({
+    id,
+    ...baseConfig,
+    ...options
+  });
+  pool.set(id, logger);
+  if (pool.size > 1e3) {
+    for (const key of [...pool.keys()].slice(0, 200)) {
+      pool.delete(key);
     }
-    return logger;
+  }
+  return logger;
 }
 
 export { getLogger };

package/dist/vue/src/core/logger/global-logger-pool.js

@@ -1,8 +1,8 @@
 function getGlobalLoggerPool() {
-    if (!globalThis.__INTOR_LOGGER_POOL__) {
-        globalThis.__INTOR_LOGGER_POOL__ = new Map();
-    }
-    return globalThis.__INTOR_LOGGER_POOL__;
+  if (!globalThis.__INTOR_LOGGER_POOL__) {
+    globalThis.__INTOR_LOGGER_POOL__ = /* @__PURE__ */ new Map();
+  }
+  return globalThis.__INTOR_LOGGER_POOL__;
 }
 
 export { getGlobalLoggerPool };

package/dist/vue/src/core/messages/load-remote-messages/collect-remote-resources.js

@@ -1,25 +1,16 @@
-/**
- * Collect remote message resources for a given locale.
- *
- * - Always includes the root `index.json`
- * - Optionally includes namespace-specific resources
- * - Produces semantic paths for later message nesting
- *
- * This function performs no I/O and does not validate resource existence.
- */
-function collectRemoteResources({ locale, baseUrl, namespaces, }) {
-    const basePath = `${baseUrl}/${locale}`;
-    // Root translation resource (always loaded)
-    const indexResource = { url: `${basePath}/index.json`, path: [] };
-    // When no namespaces are provided, the locale domain consists of index only
-    if (!namespaces || namespaces.length === 0)
-        return [indexResource];
-    // Namespace-specific resources are nested under their namespace key
-    const nsResources = namespaces.map((ns) => ({
-        url: `${basePath}/${ns}.json`,
-        path: [ns],
-    }));
-    return [indexResource, ...nsResources];
+function collectRemoteResources({
+  locale,
+  baseUrl,
+  namespaces
+}) {
+  const basePath = `${baseUrl}/${locale}`;
+  const indexResource = { url: `${basePath}/index.json`, path: [] };
+  if (!namespaces || namespaces.length === 0) return [indexResource];
+  const nsResources = namespaces.map((ns) => ({
+    url: `${basePath}/${ns}.json`,
+    path: [ns]
+  }));
+  return [indexResource, ...nsResources];
 }
 
 export { collectRemoteResources };

package/dist/vue/src/core/messages/load-remote-messages/fetch-remote-resource.js

@@ -1,47 +1,38 @@
 import { getLogger } from '../../logger/get-logger.js';
 import { isValidMessages } from '../utils/is-valid-messages.js';
 
-/**
- * Fetch a single remote messages resource.
- *
- * This function performs a single HTTP request to retrieve
- * a remote translation messages payload.
- *
- * It is responsible for:
- * - Issuing the network request
- * - Validating the returned message structure
- * - Handling abort and network errors
- */
-async function fetchRemoteResource({ fetch, url, headers, signal, loggerOptions, }) {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    try {
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: { "Content-Type": "application/json", ...headers },
-            cache: "no-store",
-            ...(signal !== undefined ? { signal } : {}),
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = (await response.json());
-        // Validate messages structure
-        if (!isValidMessages(data)) {
-            throw new Error("Invalid messages structure");
-        }
-        return data;
+async function fetchRemoteResource({
+  fetch,
+  url,
+  headers,
+  signal,
+  loggerOptions
+}) {
+  const baseLogger = getLogger(loggerOptions);
+  const logger = baseLogger.child({ scope: "fetch-locale-messages" });
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: { "Content-Type": "application/json", ...headers },
+      cache: "no-store",
+      ...signal !== void 0 ? { signal } : {}
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} ${response.statusText}`);
     }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Remote fetch aborted.", { url });
-            return;
-        }
-        logger.warn("Failed to fetch remote messages.", { url, error });
-        return;
+    const data = await response.json();
+    if (!isValidMessages(data)) {
+      throw new Error("Invalid messages structure");
     }
+    return data;
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      logger.debug("Remote fetch aborted.", { url });
+      return;
+    }
+    logger.warn("Failed to fetch remote messages.", { url, error });
+    return;
+  }
 }
 
 export { fetchRemoteResource };

package/dist/vue/src/core/messages/load-remote-messages/load-remote-messages.js

@@ -4,98 +4,81 @@ import { collectRemoteResources } from './collect-remote-resources.js';
 import { fetchRemoteResource } from './fetch-remote-resource.js';
 import { resolveRemoteResources } from './resolve-remote-resources.js';
 
-/**
- * Load locale messages from a remote source.
- *
- * This function serves as the orchestration layer for remote message loading.
- * It coordinates:
- *
- * - Locale resolution with fallbacks
- * - Concurrency control for network requests
- * - Remote resource fetching and message merging
- *
- * Remote messages are fetched on demand and are not memoized at the process level.
- *
- * Network requests and response validation are delegated to lower-level utilities.
- */
-const loadRemoteMessages = async ({ locale, fallbackLocales, namespaces, concurrency, fetch, url: baseUrl, headers, signal, loggerOptions, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "load-remote-messages" });
-    // Abort early if the request has already been cancelled
-    if (signal?.aborted) {
-        logger.debug("Remote message loading aborted before fetch.");
+const loadRemoteMessages = async ({
+  locale,
+  fallbackLocales,
+  namespaces,
+  concurrency,
+  fetch,
+  url: baseUrl,
+  headers,
+  signal,
+  loggerOptions
+}) => {
+  const baseLogger = getLogger(loggerOptions);
+  const logger = baseLogger.child({ scope: "load-remote-messages" });
+  if (signal?.aborted) {
+    logger.debug("Remote message loading aborted before fetch.");
+    return;
+  }
+  const start = performance.now();
+  logger.debug("Loading remote messages.", { baseUrl });
+  const limit = concurrency ? pLimit(concurrency) : void 0;
+  const candidateLocales = [locale, ...fallbackLocales || []];
+  let messages;
+  for (const candidateLocale of candidateLocales) {
+    const isLast = candidateLocale === candidateLocales[candidateLocales.length - 1];
+    try {
+      const resources = collectRemoteResources({
+        locale: candidateLocale,
+        baseUrl,
+        ...namespaces !== void 0 ? { namespaces } : {}
+      });
+      const fetchUrl = (url) => fetchRemoteResource({
+        url,
+        ...headers !== void 0 ? { headers } : {},
+        ...signal !== void 0 ? { signal } : {},
+        loggerOptions,
+        fetch
+      });
+      const results = await Promise.all(
+        resources.map(
+          ({ url }) => limit ? limit(() => fetchUrl(url)) : fetchUrl(url)
+        )
+      );
+      if (!results.some(Boolean)) continue;
+      const resolved = resolveRemoteResources(
+        resources.map((res, i) => {
+          const data = results[i];
+          return { path: res.path, ...data !== void 0 ? { data } : {} };
+        })
+      );
+      messages = { [candidateLocale]: resolved };
+      break;
+    } catch {
+      if (signal?.aborted) {
+        logger.debug("Remote message loading aborted.");
         return;
-    }
-    const start = performance.now();
-    logger.debug("Loading remote messages.", { baseUrl });
-    // ----------------------------------------------------------------
-    // Resolve locale messages with ordered fallback strategy
-    // ----------------------------------------------------------------
-    const limit = concurrency ? pLimit(concurrency) : undefined;
-    const candidateLocales = [locale, ...(fallbackLocales || [])];
-    let messages;
-    for (const candidateLocale of candidateLocales) {
-        const isLast = candidateLocale === candidateLocales[candidateLocales.length - 1];
-        try {
-            // -----------------------------------------------------------------
-            // Collect remote message resources for the locale
-            // -----------------------------------------------------------------
-            const resources = collectRemoteResources({
-                locale: candidateLocale,
-                baseUrl,
-                ...(namespaces !== undefined ? { namespaces } : {}),
-            });
-            // -----------------------------------------------------------------
-            // Fetch all message chunks in parallel
-            // -----------------------------------------------------------------
-            const fetchUrl = (url) => fetchRemoteResource({
-                url,
-                ...(headers !== undefined ? { headers } : {}),
-                ...(signal !== undefined ? { signal } : {}),
-                loggerOptions,
-                fetch,
-            });
-            const results = await Promise.all(resources.map(({ url }) => limit ? limit(() => fetchUrl(url)) : fetchUrl(url)));
-            // Guard: no valid remote resources
-            if (!results.some(Boolean))
-                continue;
-            // -----------------------------------------------------------------
-            // Resolve and merge remote message resources
-            // -----------------------------------------------------------------
-            const resolved = resolveRemoteResources(resources.map((res, i) => {
-                const data = results[i];
-                return { path: res.path, ...(data !== undefined ? { data } : {}) };
-            }));
-            // -----------------------------------------------------------------
-            // Wrap resolved messages into locale-scoped LocaleMessages
-            // -----------------------------------------------------------------
-            messages = { [candidateLocale]: resolved };
-            break;
-        }
-        catch {
-            if (signal?.aborted) {
-                logger.debug("Remote message loading aborted.");
-                return;
-            }
-            if (isLast) {
-                logger.warn("Failed to load messages for all candidate locales.", {
-                    locale,
-                    fallbackLocales,
-                });
-            }
-            else {
-                logger.warn(`Failed to load locale messages for "${candidateLocale}", trying next fallback.`);
-            }
-        }
-    }
-    // Final success log with resolved locale and timing
-    if (messages) {
-        logger.trace("Finished loading remote messages.", {
-            loadedLocale: Object.keys(messages)[0],
-            duration: `${Math.round(performance.now() - start)} ms`,
+      }
+      if (isLast) {
+        logger.warn("Failed to load messages for all candidate locales.", {
+          locale,
+          fallbackLocales
         });
+      } else {
+        logger.warn(
+          `Failed to load locale messages for "${candidateLocale}", trying next fallback.`
+        );
+      }
     }
-    return messages;
+  }
+  if (messages) {
+    logger.trace("Finished loading remote messages.", {
+      loadedLocale: Object.keys(messages)[0],
+      duration: `${Math.round(performance.now() - start)} ms`
+    });
+  }
+  return messages;
 };
 
 export { loadRemoteMessages };

package/dist/vue/src/core/messages/load-remote-messages/resolve-remote-resources.js

@@ -1,24 +1,14 @@
 import { deepMerge } from '../../utils/deep-merge.js';
 import { nestObjectFromPath } from '../utils/nest-object-from-path.js';
 
-/**
- * Resolve remote message resources into a single MessageObject.
- *
- * - Applies semantic nesting based on resource path
- * - Merges all resolved message chunks
- *
- * Always returns a MessageObject.
- * An empty object represents an empty translation domain.
- */
 function resolveRemoteResources(resources) {
-    let result = {};
-    for (const { path, data } of resources) {
-        if (!data)
-            continue;
-        const resolved = path.length > 0 ? nestObjectFromPath(path, data) : data;
-        result = deepMerge(result, resolved);
-    }
-    return result;
+  let result = {};
+  for (const { path, data } of resources) {
+    if (!data) continue;
+    const resolved = path.length > 0 ? nestObjectFromPath(path, data) : data;
+    result = deepMerge(result, resolved);
+  }
+  return result;
 }
 
 export { resolveRemoteResources };

package/dist/vue/src/core/messages/merge-messages.js

@@ -1,35 +1,24 @@
 import { getLogger } from '../logger/get-logger.js';
 import { deepMerge } from '../utils/deep-merge.js';
 
-/**
- * Merge locale-specific messages with runtime overrides.
- *
- * - Only merges messages under the given locale
- * - Emits debug logs for add / override events
- *
- * @public
- */
 function mergeMessages(a, b, { config, locale, onEvent }) {
-    const baseLogger = getLogger({ ...config.logger, id: config.id });
-    const logger = baseLogger.child({ scope: "merge-messages" });
-    // Merge messages for the active locale only
-    const merged = deepMerge(a?.[locale] ?? {}, b?.[locale] ?? {}, {
-        onOverride: (event) => {
-            if (onEvent) {
-                onEvent(event);
-                return;
-            }
-            const { kind, path, next, prev } = event;
-            if (kind === "add")
-                return;
-            logger.debug(`Override | ${locale}: "${path}"`, { prev, next });
-        },
-    });
-    // Preserve other locales, update only the target one
-    return {
-        ...a,
-        [locale]: merged,
-    };
+  const baseLogger = getLogger({ ...config.logger, id: config.id });
+  const logger = baseLogger.child({ scope: "merge-messages" });
+  const merged = deepMerge(a?.[locale] ?? {}, b?.[locale] ?? {}, {
+    onOverride: (event) => {
+      if (onEvent) {
+        onEvent(event);
+        return;
+      }
+      const { kind, path, next, prev } = event;
+      if (kind === "add") return;
+      logger.debug(`Override | ${locale}: "${path}"`, { prev, next });
+    }
+  });
+  return {
+    ...a,
+    [locale]: merged
+  };
 }
 
 export { mergeMessages };