intor 2.3.13 → 2.3.15

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/parse-file-entries.d.ts

@@ -1,5 +1,5 @@
 import type { ParseFileEntriesParams } from "./types";
-import type { Messages } from "../../../../../core";
+import type { MessageObject } from "intor-translator";
 /**
  * Parse locale message files into a unified Messages object (single-locale).
  *
@@ -29,4 +29,4 @@ import type { Messages } from "../../../../../core";
  * }
  * ```
  */
-export declare function parseFileEntries({ fileEntries, limit, messagesReader, loggerOptions, }: ParseFileEntriesParams): Promise<Messages>;
+export declare function parseFileEntries({ fileEntries, limit, readers, loggerOptions, }: ParseFileEntriesParams): Promise<MessageObject>;

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/types.d.ts

@@ -1,14 +1,15 @@
 import type { FileEntry } from "../types";
 import type { LoggerOptions } from "../../../../../config";
-import type { MessagesReader, Messages } from "../../../../../core";
+import type { MessagesReaders } from "../../../../../core";
+import type { MessageObject } from "intor-translator";
 import type { LimitFunction } from "p-limit";
 export interface ParseFileEntriesParams {
     fileEntries: FileEntry[];
     limit: LimitFunction;
-    messagesReader?: MessagesReader;
+    readers?: MessagesReaders;
     loggerOptions: LoggerOptions;
 }
 export interface ParsedFileEntries {
     namespace: string;
-    messages: Messages;
+    messages: MessageObject;
 }

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/utils/json-reader.d.ts

@@ -1,6 +1,6 @@
-import type { Messages } from "../../../../../../core";
+import type { MessageObject } from "intor-translator";
 import fs from "node:fs/promises";
 /**
  *  Read & parse a JSON file
  */
-export declare function jsonReader(filePath: string, readFile?: typeof fs.readFile): Promise<Messages>;
+export declare function jsonReader(filePath: string, readFile?: typeof fs.readFile): Promise<MessageObject>;

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/utils/nest-object-from-path.d.ts

@@ -1,4 +1,4 @@
-import type { Messages } from "../../../../../../core";
+import type { MessageObject } from "intor-translator";
 /**
  * Wraps a value inside nested objects according to a given path.
  *
@@ -11,4 +11,4 @@ import type { Messages } from "../../../../../../core";
  * nestObjectFromPath([], value); // →  { a: "A" }
  * ```
  */
-export declare function nestObjectFromPath(path: string[], value: Messages): Messages;
+export declare function nestObjectFromPath(path: string[], value: MessageObject): MessageObject;

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/read-locale-messages.d.ts

@@ -10,4 +10,4 @@ import type { LocaleMessages } from "intor-translator";
  *
  * It does not perform validation or transformation itself.
  */
-export declare const readLocaleMessages: ({ locale, namespaces, rootDir, limit, readOptions: { exts, messagesReader }, loggerOptions, }: ReadLocaleMessagesParams) => Promise<LocaleMessages>;
+export declare const readLocaleMessages: ({ locale, namespaces, rootDir, limit, readers, loggerOptions, }: ReadLocaleMessagesParams) => Promise<LocaleMessages>;

package/dist/types/src/server/messages/load-local-messages/read-locale-messages/types.d.ts

@@ -1,5 +1,5 @@
 import type { LoggerOptions } from "../../../../config";
-import type { MessagesReadOptions } from "../../../../core";
+import type { MessagesReaders } from "../../../../core";
 import type { LimitFunction } from "p-limit";
 export interface FileEntry {
     namespace: string;
@@ -13,6 +13,6 @@ export interface ReadLocaleMessagesParams {
     namespaces?: string[];
     rootDir?: string;
     limit: LimitFunction;
-    readOptions?: MessagesReadOptions;
+    readers?: MessagesReaders;
     loggerOptions: LoggerOptions;
 }

package/dist/types/src/server/messages/load-local-messages/types.d.ts

@@ -1,5 +1,5 @@
 import type { LoggerOptions } from "../../../config";
-import type { MessagesPool, MessagesReadOptions } from "../../../core";
+import type { MessagesPool, MessagesReaders } from "../../../core";
 export interface LoadLocalMessagesParams {
     id: string;
     locale: string;
@@ -7,7 +7,7 @@ export interface LoadLocalMessagesParams {
     namespaces?: string[];
     rootDir?: string;
     concurrency?: number;
-    readOptions?: MessagesReadOptions;
+    readers?: MessagesReaders;
     pool?: MessagesPool;
     allowCacheWrite?: boolean;
     loggerOptions: LoggerOptions;

package/dist/types/src/server/messages/load-messages.d.ts

@@ -13,4 +13,4 @@ import type { LocaleMessages } from "intor-translator";
  * Message traversal, parsing, fallback resolution, and caching logic
  * are delegated to the selected loader.
  */
-export declare const loadMessages: ({ config, locale, readOptions, allowCacheWrite, }: LoadMessagesParams) => Promise<LocaleMessages | undefined>;
+export declare const loadMessages: ({ config, locale, readers, allowCacheWrite, }: LoadMessagesParams) => Promise<LocaleMessages | undefined>;

package/dist/types/src/server/messages/types.d.ts

@@ -1,10 +1,10 @@
 import type { IntorResolvedConfig } from "../../config";
-import type { MessagesReadOptions } from "../../core";
+import type { MessagesReaders } from "../../core";
 import type { Locale } from "intor-translator";
 export type LoadMessagesParams = {
     config: IntorResolvedConfig;
     locale: Locale;
-    readOptions?: MessagesReadOptions;
+    readers?: MessagesReaders;
     /**
      * Controls whether this load operation is permitted to
      * write into the shared messages cache.

package/dist/types/src/server/runtime/types.d.ts

@@ -1,8 +1,8 @@
 import type { TranslatorInstanceServer } from "../translator";
-import type { GenConfigKeys, GenLocale, GenMessages, MessagesReadOptions } from "../../core";
+import type { GenConfigKeys, GenLocale, GenMessages, MessagesReaders } from "../../core";
 import type { LocalizedNodeKeys, TranslateHandlers, TranslateHook, TranslatorPlugin } from "intor-translator";
 export interface IntorRuntimeOptions {
-    readOptions?: MessagesReadOptions;
+    readers?: MessagesReaders;
     allowCacheWrite?: boolean;
 }
 export interface IntorRuntime<CK extends GenConfigKeys = "__default__"> {

package/dist/types/src/server/translator/create-translator.d.ts

@@ -24,5 +24,6 @@ export declare function createTranslator(params: CreateTranslatorParams & {
     locale: string;
     hasKey: <K extends string>(key: K, targetLocale?: string | undefined) => boolean;
     t: <Result = string, K extends string = string>(key: K, replacements?: import("intor-translator").Replacement) => Result;
+    tRaw: <K extends string = string>(key: K, replacements?: import("intor-translator").Replacement) => import("intor-translator").MessageValue | undefined;
 };
 export {};

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

@@ -1,7 +1,6 @@
 import '../../../core/error/intor-error.js';
 import { normalizeLocale } from '../../../core/utils/normalizers/normalize-locale.js';
 import 'logry';
-import 'keyv';
 import { detectBrowserLocale } from '../utils/locale/detect-browser-locale.js';
 import { getLocaleCookieBrowser } from '../utils/locale/get-locale-cookie-browser.js';
 

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

@@ -2,7 +2,6 @@ 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 'keyv';
 import { mergeMessages } from '../../../core/messages/merge-messages.js';
 
 /**
@@ -27,7 +26,6 @@ const createRefetchMessages = ({ config, onLoadingStart, onLoadingEnd, onMessage
         onLoadingStart?.();
         try {
             const loadedMessages = await loadRemoteMessages({
-                id: config.id,
                 locale: newLocale,
                 fallbackLocales: config.fallbackLocales[newLocale] || [],
                 namespaces: loader.namespaces,
@@ -35,7 +33,6 @@ const createRefetchMessages = ({ config, onLoadingStart, onLoadingEnd, onMessage
                 url: loader.url,
                 headers: loader.headers,
                 signal: currentController.signal,
-                cacheOptions: config.cache,
                 loggerOptions: config.logger,
             });
             // Apply state updates only when this request is still the active one

package/dist/vue/src/client/vue/helpers/use-runtime-state.js

@@ -1,7 +1,6 @@
 import { ref, onMounted } from 'vue';
 import '../../../core/error/intor-error.js';
 import 'logry';
-import 'keyv';
 import { mergeMessages } from '../../../core/messages/merge-messages.js';
 import { getClientLocale } from '../../shared/helpers/get-client-locale.js';
 

package/dist/vue/src/client/vue/provider/effects/use-locale-effects.js

@@ -3,7 +3,6 @@ import { shouldPersist } from '../../../../policies/should-persist.js';
 import { shouldPersistOnFirstVisit } from '../../../../policies/should-persist-on-first-visit.js';
 import '../../../../core/error/intor-error.js';
 import 'logry';
-import 'keyv';
 import { getLocaleCookieBrowser } from '../../../shared/utils/locale/get-locale-cookie-browser.js';
 import { setLocaleCookieBrowser } from '../../../shared/utils/locale/set-locale-cookie-browser.js';
 import { setDocumentLocale } from '../../../shared/utils/locale/set-document-locale.js';

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

@@ -8,8 +8,9 @@ function useTranslator(preKey) {
     const intor = injectIntor();
     const translator = computed(() => intor.value.translator);
     const scoped = computed(() => preKey ? translator.value.scoped(preKey) : translator.value);
-    const t = computed(() => scoped.value.t);
     const hasKey = computed(() => scoped.value.hasKey);
+    const t = computed(() => scoped.value.t);
+    const tRaw = computed(() => scoped.value.tRaw);
     return {
         messages: computed(() => translator.value.messages),
         locale: computed(() => translator.value.locale),
@@ -17,6 +18,7 @@ function useTranslator(preKey) {
         setLocale: intor.value.setLocale,
         hasKey,
         t,
+        tRaw,
         tRich: createTRich(translator, preKey),
         // NOTE:
         // The runtime implementation is intentionally erased.

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

@@ -1,5 +1,4 @@
 import { getLogger } from '../../logger/get-logger.js';
-import { normalizeCacheKey } from '../../utils/normalizers/normalize-cache-key.js';
 import { fetchLocaleMessages } from './fetch-locale-messages/fetch-locale-messages.js';
 
 /**
@@ -9,12 +8,11 @@ import { fetchLocaleMessages } from './fetch-locale-messages/fetch-locale-messag
  * It coordinates:
  *
  * - Locale resolution with fallbacks
- * - Cache read / write behavior
  * - Respecting abort signals across the entire async flow
  *
  * Network fetching and data validation are delegated to lower-level utilities.
  */
-const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, rootDir, url, headers, signal, pool, cacheOptions, allowCacheWrite = false, loggerOptions, }) => {
+const loadRemoteMessages = async ({ locale, fallbackLocales, namespaces, rootDir, url, headers, signal, loggerOptions, }) => {
     const baseLogger = getLogger(loggerOptions);
     const logger = baseLogger.child({ scope: "load-remote-messages" });
     // Abort early if the request has already been cancelled
@@ -25,31 +23,6 @@ const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, roo
     const start = performance.now();
     logger.debug("Loading remote messages.", { url });
     // ---------------------------------------------------------------------------
-    // Cache key resolution
-    // ---------------------------------------------------------------------------
-    const cacheKey = normalizeCacheKey([
-        id,
-        "loaderType:remote",
-        rootDir,
-        locale,
-        (fallbackLocales || []).toSorted().join(","),
-        (namespaces || []).toSorted().join(","),
-    ]);
-    // ---------------------------------------------------------------------------
-    // Cache read
-    // ---------------------------------------------------------------------------
-    if (cacheOptions.enabled && cacheKey) {
-        const cached = await pool?.get(cacheKey);
-        if (signal?.aborted) {
-            logger.debug("Remote message loading aborted after cache read.");
-            return;
-        }
-        if (cached) {
-            logger.debug("Messages cache hit.", { key: cacheKey });
-            return cached;
-        }
-    }
-    // ---------------------------------------------------------------------------
     // Resolve locale messages with ordered fallback strategy
     // ---------------------------------------------------------------------------
     const candidateLocales = [locale, ...(fallbackLocales || [])];
@@ -93,18 +66,6 @@ const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, roo
             });
         }
     }
-    // ---------------------------------------------------------------------------
-    // Cache write (explicitly permitted)
-    // ---------------------------------------------------------------------------
-    if (cacheOptions.enabled && allowCacheWrite) {
-        if (signal?.aborted) {
-            logger.debug("Remote message loading aborted before cache write.");
-            return;
-        }
-        if (cacheKey && messages) {
-            await pool?.set(cacheKey, messages, cacheOptions.ttl);
-        }
-    }
     // Final success log with resolved locale and timing
     if (messages) {
         logger.trace("Finished loading remote messages.", {

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

@@ -3,15 +3,10 @@ function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
- * Check if a value is a valid **Messages** object.
+ * Check if a value is a valid MessageObject.
  *
- * - Uses an iterative approach to avoid stack overflow with deeply nested objects.
- *
- * @example
- * ```ts
- * isValidMessages({ en: { hello: "Hello" } }) // true
- * isValidMessages({ en: { count: 5 } }) // false
- * ```
+ * - Supports all MessageValue variants (primitive, array, object).
+ * - Uses an iterative approach to avoid stack overflow.
  */
 function isValidMessages(value) {
     if (!isPlainObject(value))
@@ -19,16 +14,29 @@ function isValidMessages(value) {
     const stack = [value];
     while (stack.length > 0) {
         const current = stack.pop();
-        for (const v of Object.values(current)) {
-            if (typeof v === "string")
-                continue;
-            if (isPlainObject(v)) {
-                stack.push(v);
+        // 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);
             }
-            else {
-                return false;
+            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;
     }
     return true;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "intor",
-  "version": "2.3.13",
-  "description": "A modular and extensible i18n core designed for TypeScript and JavaScript projects. Intor enables custom translation logic with support for both frontend and backend environments, featuring runtime configuration, caching, adapters, and message loaders.",
+  "version": "2.3.15",
+  "description": "The i18n library for modern JavaScript",
   "author": "Yiming Liao",
   "homepage": "https://github.com/yiming-liao/intor#readme",
   "repository": {
@@ -100,8 +100,7 @@
     "examples:html": "vite --config examples/html/vite.config.ts"
   },
   "dependencies": {
-    "intor-translator": "1.3.2",
-    "keyv": "5.5.5",
+    "intor-translator": "1.4.2",
     "logry": "2.1.6",
     "p-limit": "7.2.0"
   },

package/dist/core/src/config/constants/cache.js

@@ -1,7 +0,0 @@
-// Default cache options
-const DEFAULT_CACHE_OPTIONS = {
-    enabled: process.env.NODE_ENV === "production",
-    ttl: 60 * 60 * 1000, // 1 hour
-};
-
-export { DEFAULT_CACHE_OPTIONS };

package/dist/core/src/config/resolvers/resolve-cache-options.js

@@ -1,11 +0,0 @@
-import '../constants/cookie.js';
-import { DEFAULT_CACHE_OPTIONS } from '../constants/cache.js';
-
-const resolveCacheOptions = (cache) => {
-    return {
-        ...DEFAULT_CACHE_OPTIONS,
-        ...cache,
-    };
-};
-
-export { resolveCacheOptions };

package/dist/react/src/core/utils/normalizers/normalize-cache-key.js

@@ -1,45 +0,0 @@
-const CACHE_KEY_DELIMITER = "|";
-const sanitize = (k) => k
-    .replaceAll(/[\u200B-\u200D\uFEFF]/g, "")
-    .replaceAll(/[\r\n]/g, "")
-    .trim();
-/**
- * Normalizes a value into a stable cache key string.
- *
- * - Supports primitive values and structured array keys.
- * - Produces deterministic output suitable for cache identifiers.
- *
- * Notes:
- * - `null`, `undefined`, or empty arrays return `null`.
- * - Special tokens are used for boolean, null, and undefined values
- *   to preserve semantic differences.
- */
-const normalizeCacheKey = (key, delimiter = CACHE_KEY_DELIMITER) => {
-    // Treat nullish values as "no cache key"
-    if (key === null || key === undefined)
-        return null;
-    if (Array.isArray(key)) {
-        // Empty array produces no meaningful cache key
-        if (key.length === 0)
-            return null;
-        const normalized = key.map((k) => {
-            // Preserve semantic differences for special values
-            if (k === null)
-                return "__null";
-            if (k === undefined)
-                return "__undefined";
-            if (typeof k === "boolean")
-                return k ? "__true" : "__false";
-            return sanitize(String(k));
-        });
-        // Join segments into a single deterministic cache key
-        return normalized.join(delimiter);
-    }
-    // Normalize boolean primitives explicitly
-    if (typeof key === "boolean")
-        return key ? "__true" : "__false";
-    // Fallback: stringify primitive values
-    return String(key);
-};
-
-export { normalizeCacheKey };

package/dist/svelte/src/core/utils/normalizers/normalize-cache-key.js

@@ -1,45 +0,0 @@
-const CACHE_KEY_DELIMITER = "|";
-const sanitize = (k) => k
-    .replaceAll(/[\u200B-\u200D\uFEFF]/g, "")
-    .replaceAll(/[\r\n]/g, "")
-    .trim();
-/**
- * Normalizes a value into a stable cache key string.
- *
- * - Supports primitive values and structured array keys.
- * - Produces deterministic output suitable for cache identifiers.
- *
- * Notes:
- * - `null`, `undefined`, or empty arrays return `null`.
- * - Special tokens are used for boolean, null, and undefined values
- *   to preserve semantic differences.
- */
-const normalizeCacheKey = (key, delimiter = CACHE_KEY_DELIMITER) => {
-    // Treat nullish values as "no cache key"
-    if (key === null || key === undefined)
-        return null;
-    if (Array.isArray(key)) {
-        // Empty array produces no meaningful cache key
-        if (key.length === 0)
-            return null;
-        const normalized = key.map((k) => {
-            // Preserve semantic differences for special values
-            if (k === null)
-                return "__null";
-            if (k === undefined)
-                return "__undefined";
-            if (typeof k === "boolean")
-                return k ? "__true" : "__false";
-            return sanitize(String(k));
-        });
-        // Join segments into a single deterministic cache key
-        return normalized.join(delimiter);
-    }
-    // Normalize boolean primitives explicitly
-    if (typeof key === "boolean")
-        return key ? "__true" : "__false";
-    // Fallback: stringify primitive values
-    return String(key);
-};
-
-export { normalizeCacheKey };

package/dist/types/src/config/constants/cache.d.ts

@@ -1,2 +0,0 @@
-import type { CacheResolvedOptions } from "../types";
-export declare const DEFAULT_CACHE_OPTIONS: CacheResolvedOptions;

package/dist/types/src/config/resolvers/resolve-cache-options.d.ts

@@ -1,2 +0,0 @@
-import type { CacheRawOptions, CacheResolvedOptions } from "../types";
-export declare const resolveCacheOptions: (cache?: CacheRawOptions) => CacheResolvedOptions;

package/dist/types/src/config/types/cache.d.ts

@@ -1,7 +0,0 @@
-export type CacheRawOptions = {
-    /** Enable cache behavior. Defaults to production */
-    enabled?: boolean;
-    /** Cache time-to-live in milliseconds. Defaults to 1 hour */
-    ttl?: number;
-};
-export type CacheResolvedOptions = Required<CacheRawOptions>;

package/dist/vue/src/core/utils/normalizers/normalize-cache-key.js

@@ -1,45 +0,0 @@
-const CACHE_KEY_DELIMITER = "|";
-const sanitize = (k) => k
-    .replaceAll(/[\u200B-\u200D\uFEFF]/g, "")
-    .replaceAll(/[\r\n]/g, "")
-    .trim();
-/**
- * Normalizes a value into a stable cache key string.
- *
- * - Supports primitive values and structured array keys.
- * - Produces deterministic output suitable for cache identifiers.
- *
- * Notes:
- * - `null`, `undefined`, or empty arrays return `null`.
- * - Special tokens are used for boolean, null, and undefined values
- *   to preserve semantic differences.
- */
-const normalizeCacheKey = (key, delimiter = CACHE_KEY_DELIMITER) => {
-    // Treat nullish values as "no cache key"
-    if (key === null || key === undefined)
-        return null;
-    if (Array.isArray(key)) {
-        // Empty array produces no meaningful cache key
-        if (key.length === 0)
-            return null;
-        const normalized = key.map((k) => {
-            // Preserve semantic differences for special values
-            if (k === null)
-                return "__null";
-            if (k === undefined)
-                return "__undefined";
-            if (typeof k === "boolean")
-                return k ? "__true" : "__false";
-            return sanitize(String(k));
-        });
-        // Join segments into a single deterministic cache key
-        return normalized.join(delimiter);
-    }
-    // Normalize boolean primitives explicitly
-    if (typeof key === "boolean")
-        return key ? "__true" : "__false";
-    // Fallback: stringify primitive values
-    return String(key);
-};
-
-export { normalizeCacheKey };