intor 2.4.17 → 2.5.1

package/dist/react/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/react/src/core/messages/merge-messages.js

@@ -1,33 +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
- */
 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 };

package/dist/react/src/core/messages/utils/is-valid-messages.js

@@ -1,44 +1,29 @@
-/** Check if a value is a plain object (not null, not array) */
 function isPlainObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/**
- * Check if a value is a valid MessageObject.
- *
- * - Supports all MessageValue variants (primitive, array, object).
- * - Uses an iterative approach to avoid stack overflow.
- */
 function isValidMessages(value) {
-    if (!isPlainObject(value))
-        return false;
-    const stack = [value];
-    while (stack.length > 0) {
-        const current = stack.pop();
-        // primitives are always valid
-        if (current === null ||
-            typeof current === "string" ||
-            typeof current === "number" ||
-            typeof current === "boolean") {
-            continue;
-        }
-        // array → validate each item
-        if (Array.isArray(current)) {
-            for (const item of current) {
-                stack.push(item);
-            }
-            continue;
-        }
-        // object → validate each value
-        if (isPlainObject(current)) {
-            for (const v of Object.values(current)) {
-                stack.push(v);
-            }
-            continue;
-        }
-        // everything else is invalid
-        return false;
+  if (!isPlainObject(value)) return false;
+  const stack = [value];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (current === null || typeof current === "string" || typeof current === "number" || typeof current === "boolean") {
+      continue;
     }
-    return true;
+    if (Array.isArray(current)) {
+      for (const item of current) {
+        stack.push(item);
+      }
+      continue;
+    }
+    if (isPlainObject(current)) {
+      for (const v of Object.values(current)) {
+        stack.push(v);
+      }
+      continue;
+    }
+    return false;
+  }
+  return true;
 }
 
 export { isPlainObject, isValidMessages };

package/dist/react/src/core/messages/utils/nest-object-from-path.js

@@ -1,21 +1,9 @@
-/**
- * Wraps a value inside nested objects according to a given path.
- *
- * @example
- * ```ts
- * const value = { a: "A" };
- *
- * nestObjectFromPath(["auth", "verify"], value); // → { auth: { verify: { a: "A" } } }
- *
- * nestObjectFromPath([], value); // →  { a: "A" }
- * ```
- */
 function nestObjectFromPath(path, value) {
-    let obj = value;
-    for (let i = path.length - 1; i >= 0; i--) {
-        obj = { [path[i]]: obj };
-    }
-    return obj;
+  let obj = value;
+  for (let i = path.length - 1; i >= 0; i--) {
+    obj = { [path[i]]: obj };
+  }
+  return obj;
 }
 
 export { nestObjectFromPath };

package/dist/react/src/core/utils/deep-merge.js

@@ -1,47 +1,29 @@
-/**
- * Deeply merges two plain objects.
- *
- * - Nested plain objects → merged recursively
- * - Arrays / primitives → `b` overwrites `a`
- *
- * Debug behavior (optional):
- * - Emits override events via `onOverride`
- * - Zero overhead when no options are provided
- *
- * This function always returns a new plain object.
- */
 const deepMerge = (a = {}, b = {}, options) => {
-    const result = { ...a };
-    const basePath = options?._path ?? [];
-    // Iterate only over b's own enumerable properties
-    for (const key in b) {
-        if (!Object.prototype.hasOwnProperty.call(b, key))
-            continue;
-        const aValue = a[key];
-        const bValue = b[key];
-        const nextPath = [...basePath, key];
-        // Recursively merge when both sides are plain objects
-        if (aValue &&
-            bValue &&
-            typeof aValue === "object" &&
-            typeof bValue === "object" &&
-            !Array.isArray(aValue) &&
-            !Array.isArray(bValue)) {
-            result[key] = deepMerge(aValue, bValue, options ? { ...options, _path: nextPath } : undefined);
-        }
-        else {
-            // Emit override event only when debugging is enabled
-            const isAdd = aValue === undefined;
-            options?.onOverride?.({
-                path: nextPath.join("."),
-                prev: aValue,
-                next: bValue,
-                kind: isAdd ? "add" : "override",
-            });
-            result[key] = bValue;
-        }
+  const result = { ...a };
+  const basePath = options?._path ?? [];
+  for (const key in b) {
+    if (!Object.prototype.hasOwnProperty.call(b, key)) continue;
+    const aValue = a[key];
+    const bValue = b[key];
+    const nextPath = [...basePath, key];
+    if (aValue && bValue && typeof aValue === "object" && typeof bValue === "object" && !Array.isArray(aValue) && !Array.isArray(bValue)) {
+      result[key] = deepMerge(
+        aValue,
+        bValue,
+        options ? { ...options, _path: nextPath } : void 0
+      );
+    } else {
+      const isAdd = aValue === void 0;
+      options?.onOverride?.({
+        path: nextPath.join("."),
+        prev: aValue,
+        next: bValue,
+        kind: isAdd ? "add" : "override"
+      });
+      result[key] = bValue;
     }
-    return result;
+  }
+  return result;
 };
 
 export { deepMerge };

package/dist/react/src/core/utils/resolve-loader-options.js

@@ -1,34 +1,11 @@
-/**
- * Resolve the effective message loader for a given runtime.
- *
- * Loader resolution follows an inheritance-based priority model:
- *
- * - client runtime:
- *   client.loader → server.loader → root loader
- *
- * - server runtime:
- *   server.loader → root loader
- *
- * This allows the client runtime to inherit server behavior
- * when no explicit client loader is provided.
- *
- * Notes:
- * - Static `messages` are intentionally NOT handled here.
- * - Returning `undefined` indicates that no loader is enabled
- *   for the given runtime.
- */
 const resolveLoaderOptions = (config, runtime) => {
-    // ------------------------------------------------
-    // runtime: client
-    // ------------------------------------------------
-    {
-        const client = config.client?.loader;
-        if (client) {
-            // Client loader is always remote by design
-            return { mode: "remote", ...client };
-        }
-        return config.server?.loader ?? config.loader;
+  {
+    const client = config.client?.loader;
+    if (client) {
+      return { mode: "remote", ...client };
     }
+    return config.server?.loader ?? config.loader;
+  }
 };
 
 export { resolveLoaderOptions };

package/dist/react/src/policies/should-persist-on-first-visit.js

@@ -1,8 +1,5 @@
-/**
- * Allow locale persistence based on first-visit policy.
- */
 function shouldPersistOnFirstVisit(isFirstVisit, persistOnFirstVisit) {
-    return !isFirstVisit || persistOnFirstVisit;
+  return !isFirstVisit || persistOnFirstVisit;
 }
 
 export { shouldPersistOnFirstVisit };

package/dist/svelte/export/svelte/index.js

@@ -1,10 +1,8 @@
 export { createIntorStore } from '../../src/client/svelte/provider/create-intor-store.js';
 import IntorProviderComponent from '../../src/client/svelte/provider/intor-provider.svelte';
-export { useIntorContext } from '../../src/client/svelte/provider/use-intor-context.js';
+import 'svelte';
 export { useTranslator } from '../../src/client/svelte/translator/use-translator.js';
-export { getClientLocale } from '../../src/client/shared/helpers/get-client-locale.js';
 
-// intor / svelte
 const IntorProvider = IntorProviderComponent;
 
 export { IntorProvider };

package/dist/svelte/export/svelte/internal/index.js

@@ -0,0 +1,7 @@
+import 'intor-translator';
+import 'svelte';
+import 'svelte/store';
+import 'logry';
+import 'p-limit';
+import '../../../src/client/svelte/provider/intor-provider.svelte';
+export { getIntorContext } from '../../../src/client/svelte/provider/get-intor-context.js';

package/dist/svelte/src/client/shared/messages/create-refetch-messages.js

@@ -1,60 +1,50 @@
-import '../../../core/error/intor-error.js';
 import { resolveLoaderOptions } from '../../../core/utils/resolve-loader-options.js';
 import 'logry';
 import { loadRemoteMessages } from '../../../core/messages/load-remote-messages/load-remote-messages.js';
 import { mergeMessages } from '../../../core/messages/merge-messages.js';
 import 'intor-translator';
 
-/**
- * Creates a framework-agnostic message refetcher.
- *
- * - At most one remote request is active at any time
- * - Previous in-flight requests are aborted on subsequent calls
- * - State updates are applied only for the latest, non-aborted request
- */
-const createRefetchMessages = ({ config, onLoadingStart, onLoadingEnd, onMessages, }) => {
-    // Tracks the currently active remote request for this refetcher instance
-    let controller = null;
-    return async function refetchMessages(newLocale) {
-        // No-op when remote loading is not enabled
-        const loader = resolveLoaderOptions(config);
-        if (!loader || loader.mode !== "remote")
-            return;
-        // Abort previous request
-        controller?.abort();
-        const currentController = new AbortController();
-        controller = currentController;
-        onLoadingStart?.();
-        try {
-            const loadedMessages = await loadRemoteMessages({
-                locale: newLocale,
-                fallbackLocales: config.fallbackLocales[newLocale] || [],
-                namespaces: loader.namespaces,
-                concurrency: loader.concurrency,
-                fetch: globalThis.fetch,
-                url: loader.url,
-                headers: loader.headers,
-                signal: currentController.signal,
-                loggerOptions: config.logger,
-            });
-            // Apply state updates only when this request is still the active one
-            // and has not been aborted.
-            if (controller === currentController &&
-                !currentController.signal.aborted) {
-                onMessages?.(mergeMessages(config.messages, loadedMessages, {
-                    config,
-                    locale: newLocale,
-                }));
-            }
-        }
-        finally {
-            // Clear loading state only if this request is still the active one
-            if (controller === currentController &&
-                !currentController.signal.aborted) {
-                onLoadingEnd?.();
-            }
-        }
-    };
+const createRefetchMessages = ({
+  config,
+  onLoadingStart,
+  onLoadingEnd,
+  onMessages
+}) => {
+  let controller = null;
+  return async function refetchMessages(newLocale) {
+    const loader = resolveLoaderOptions(config);
+    if (!loader || loader.mode !== "remote") return;
+    const { namespaces, concurrency, url, headers } = loader;
+    controller?.abort();
+    const currentController = new AbortController();
+    controller = currentController;
+    onLoadingStart?.();
+    try {
+      const loadedMessages = await loadRemoteMessages({
+        locale: newLocale,
+        fallbackLocales: config.fallbackLocales[newLocale] || [],
+        ...namespaces !== void 0 ? { namespaces } : {},
+        ...concurrency !== void 0 ? { concurrency } : {},
+        fetch: globalThis.fetch,
+        url,
+        ...headers !== void 0 ? { headers } : {},
+        signal: currentController.signal,
+        loggerOptions: config.logger
+      });
+      if (controller === currentController && !currentController.signal.aborted) {
+        onMessages?.(
+          mergeMessages(config.messages, loadedMessages, {
+            config,
+            locale: newLocale
+          })
+        );
+      }
+    } finally {
+      if (controller === currentController && !currentController.signal.aborted) {
+        onLoadingEnd?.();
+      }
+    }
+  };
 };
 
 export { createRefetchMessages };

package/dist/svelte/src/client/shared/provider/effective-state.js

@@ -0,0 +1,8 @@
+function resolveEffectiveMessages(runtime, external, configMessages) {
+  return runtime ?? external ?? configMessages ?? {};
+}
+function resolveEffectiveIsLoading(external, internal) {
+  return !!external || internal;
+}
+
+export { resolveEffectiveIsLoading, resolveEffectiveMessages };

package/dist/svelte/src/client/shared/utils/build-cookie-string.js

@@ -1,30 +1,22 @@
-/**
- * Build a serialized cookie string.
- */
 const buildCookieString = (cookieOptions, value) => {
-    const { name, maxAge, path, domain, sameSite, secure } = cookieOptions;
-    // Cookie name and encoded value
-    const parts = [`${name}=${encodeURIComponent(value)}`];
-    // Add expiration and max-age if provided
-    if (maxAge) {
-        const expires = new Date(Date.now() + maxAge * 1000).toUTCString();
-        parts.push(`expires=${expires}`, `max-age=${maxAge}`);
-    }
-    // Set path (default to "/")
-    parts.push(`path=${path ?? "/"}`);
-    // Add domain if specified
-    if (domain) {
-        parts.push(`domain=${domain}`);
-    }
-    // Add SameSite policy (e.g., Lax, Strict)
-    if (sameSite) {
-        parts.push(`SameSite=${sameSite[0].toUpperCase()}${sameSite.slice(1).toLowerCase()}`);
-    }
-    // Add Secure flag if not explicitly disabled
-    if (secure !== false) {
-        parts.push(`Secure`);
-    }
-    return parts.join("; ");
+  const { name, maxAge, path, domain, sameSite, secure } = cookieOptions;
+  const parts = [`${name}=${encodeURIComponent(value)}`];
+  if (maxAge !== void 0) {
+    const expires = new Date(Date.now() + maxAge * 1e3).toUTCString();
+    parts.push(`expires=${expires}`, `max-age=${maxAge}`);
+  }
+  parts.push(`path=${path ?? "/"}`);
+  if (domain) {
+    parts.push(`domain=${domain}`);
+  }
+  if (sameSite) {
+    const normalized = sameSite.charAt(0).toUpperCase() + sameSite.slice(1).toLowerCase();
+    parts.push(`SameSite=${normalized}`);
+  }
+  if (secure !== false) {
+    parts.push(`Secure`);
+  }
+  return parts.join("; ");
 };
 
 export { buildCookieString };

package/dist/svelte/src/client/shared/utils/locale/get-locale-from-cookie.js

@@ -1,16 +1,9 @@
-/**
- * Gets the locale value from the browser cookie.
- *
- * This function relies on `document.cookie`.
- */
 function getLocaleFromCookie(cookieName) {
-    if (typeof document === "undefined")
-        return undefined;
-    const cookies = document.cookie.split(";").map((c) => c.trim());
-    const entry = cookies.find((c) => c.startsWith(`${cookieName}=`));
-    if (!entry)
-        return undefined;
-    return decodeURIComponent(entry.slice(cookieName.length + 1));
+  if (typeof document === "undefined") return void 0;
+  const cookies = document.cookie.split(";").map((c) => c.trim());
+  const entry = cookies.find((c) => c.startsWith(`${cookieName}=`));
+  if (!entry) return void 0;
+  return decodeURIComponent(entry.slice(cookieName.length + 1));
 }
 
 export { getLocaleFromCookie };

package/dist/svelte/src/client/shared/utils/locale/set-document-locale.js

@@ -1,12 +1,6 @@
-/**
- * Set the document language attribute.
- *
- * This function relies on `document.documentElement.lang`.
- */
 function setDocumentLocale(locale) {
-    if (typeof document === "undefined")
-        return;
-    document.documentElement.lang = locale;
+  if (typeof document === "undefined") return;
+  document.documentElement.lang = locale;
 }
 
 export { setDocumentLocale };

package/dist/svelte/src/client/shared/utils/locale/set-locale-cookie.js

@@ -1,15 +1,8 @@
 import { buildCookieString } from '../build-cookie-string.js';
 
-/**
- * Persist locale to a cookie.
- *
- * This function relies on `document.cookie`.
- */
 const setLocaleCookie = (cookieOptions, locale) => {
-    if (typeof document === "undefined")
-        return;
-    // Build and apply the cookie string
-    document.cookie = buildCookieString(cookieOptions, locale);
+  if (typeof document === "undefined") return;
+  document.cookie = buildCookieString(cookieOptions, locale);
 };
 
 export { setLocaleCookie };