intor-translator 1.4.13 → 1.4.15

package/README.md

@@ -1,27 +1,28 @@
 <h1 align="center">Intor Translator</h1>
 
-<div align="center">
-
-A modern **i18n engine** powered by a customizable, type-safe translation pipeline.  
-Easy to use, modular at its core, and fully extensible.
-
-</div>
+<p align="center">
+The <a href="https://github.com/yiming-liao/intor">Intor</a> translation engine
+</p>
 
 <div align="center">
 
 [![NPM version](https://img.shields.io/npm/v/intor-translator?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/intor-translator)
-[![Bundle size](https://img.shields.io/bundlephobia/minzip/intor-translator?style=flat&colorA=000000&colorB=000000)](https://bundlephobia.com/package/intor-translator)
 [![Coverage Status](https://img.shields.io/coveralls/github/yiming-liao/intor-translator.svg?branch=main&style=flat&colorA=000000&colorB=000000)](https://coveralls.io/github/yiming-liao/intor-translator?branch=main)
 [![TypeScript](https://img.shields.io/badge/TypeScript-%E2%9C%94-blue?style=flat&colorA=000000&colorB=000000)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/npm/l/intor-translator?style=flat&colorA=000000&colorB=000000)](LICENSE)
 
 </div>
 
+> [!NOTE]  
+> intor-translator is the execution core of the Intor ecosystem.  
+> It provides deterministic translation resolution and rendering,  
+> without coupling to routing, configuration systems, or frameworks.
+
 ## Features
 
-- 🔧 **Modular Pipeline** – A pluggable, hook-driven flow for any translation logic.
-- ✨ **Typed Autocomplete** – Inferred keys and locales with precise, reliable completion.
-- 🌐 **Framework-Agnostic** – A lightweight engine that runs anywhere in JavaScript.
+- **Modular Pipeline** – A pluggable, hook-driven flow for any translation logic.
+- **Typed Autocomplete** – Inferred keys and locales with precise, reliable completion.
+- **Framework-Agnostic** – A lightweight engine that runs anywhere in JavaScript.
 
 ## Installation
 
@@ -94,7 +95,7 @@ Hooks run through the pipeline and can intercept any stage, use them to:
 
 ---
 
-# Rich Message Processing
+## Rich Message Processing
 
 This module provides a semantic message processing flow for **_translated rich-formatted strings_**.
 
@@ -107,3 +108,5 @@ Read the documentation: [Message Processing ↗](https://github.com/yiming-liao/
 
 **_For more advanced usage, see the full examples._**
 [View examples ↗](https://github.com/yiming-liao/intor-translator/tree/main/examples)
+
+**_See full benchmark details:_** [bench ↗](https://github.com/yiming-liao/intor-translator/tree/main/bench)

package/dist/index.d.cts

@@ -126,6 +126,8 @@ type AtPath<MessageSchema, PK extends string> = PK extends `${infer Head}.${infe
 type IfLocaleMessages<T, Then, Else> = T extends LocaleMessages ? Then : Else;
 /** Narrows a type to `MessageObject`, otherwise resolves to never. */
 type IfMessageObject<T> = T extends MessageObject ? T : never;
+/** Detects whether `M` is the generic runtime `LocaleMessages` type. */
+type IsRuntime<M> = [M] extends [LocaleMessages] ? [LocaleMessages] extends [M] ? true : false : false;
 
 /**
  * Dot-separated leaf keys derived from a single message object.
@@ -191,7 +193,7 @@ type Value<M, K extends string> = K extends `${infer Head}.${infer Tail}` ? Head
  * LocalizedValue<{ en: { a: { b: { c: string }; z: string } } }, "a.b.c">; // => string
  * ```
  */
-type LocalizedValue<M, K extends string> = IfLocaleMessages<M, Value<M[keyof M], K>, string>;
+type LocalizedValue<M, K extends string> = IsRuntime<M> extends true ? string : M extends LocaleMessages ? Value<M[keyof M], K> : never;
 /**
  * Value resolved under a scoped prefix key.
  *
@@ -200,7 +202,7 @@ type LocalizedValue<M, K extends string> = IfLocaleMessages<M, Value<M[keyof M],
  * ScopedValue<{ en: { a: { b: { c: string }; z: string } } }, "a", "b.c">; // => string
  * ```
  */
-type ScopedValue<M, PK extends string, K extends string> = IfLocaleMessages<M, Value<AtPath<M[keyof M], PK>, K>, string>;
+type ScopedValue<M, PK extends string, K extends string> = IsRuntime<M> extends true ? string : M extends LocaleMessages ? Value<AtPath<M[keyof M], PK>, K> : never;
 
 /**
  * Generic replacement object used when no schema is available.
@@ -567,4 +569,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };
+export { type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage, tokenize };

package/dist/index.d.ts

@@ -126,6 +126,8 @@ type AtPath<MessageSchema, PK extends string> = PK extends `${infer Head}.${infe
 type IfLocaleMessages<T, Then, Else> = T extends LocaleMessages ? Then : Else;
 /** Narrows a type to `MessageObject`, otherwise resolves to never. */
 type IfMessageObject<T> = T extends MessageObject ? T : never;
+/** Detects whether `M` is the generic runtime `LocaleMessages` type. */
+type IsRuntime<M> = [M] extends [LocaleMessages] ? [LocaleMessages] extends [M] ? true : false : false;
 
 /**
  * Dot-separated leaf keys derived from a single message object.
@@ -191,7 +193,7 @@ type Value<M, K extends string> = K extends `${infer Head}.${infer Tail}` ? Head
  * LocalizedValue<{ en: { a: { b: { c: string }; z: string } } }, "a.b.c">; // => string
  * ```
  */
-type LocalizedValue<M, K extends string> = IfLocaleMessages<M, Value<M[keyof M], K>, string>;
+type LocalizedValue<M, K extends string> = IsRuntime<M> extends true ? string : M extends LocaleMessages ? Value<M[keyof M], K> : never;
 /**
  * Value resolved under a scoped prefix key.
  *
@@ -200,7 +202,7 @@ type LocalizedValue<M, K extends string> = IfLocaleMessages<M, Value<M[keyof M],
  * ScopedValue<{ en: { a: { b: { c: string }; z: string } } }, "a", "b.c">; // => string
  * ```
  */
-type ScopedValue<M, PK extends string, K extends string> = IfLocaleMessages<M, Value<AtPath<M[keyof M], PK>, K>, string>;
+type ScopedValue<M, PK extends string, K extends string> = IsRuntime<M> extends true ? string : M extends LocaleMessages ? Value<AtPath<M[keyof M], PK>, K> : never;
 
 /**
  * Generic replacement object used when no schema is available.
@@ -567,4 +569,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };
+export { type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage, tokenize };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "intor-translator",
-  "version": "1.4.13",
-  "description": "🤖 A modern, type-safe i18n engine.",
+  "version": "1.4.15",
+  "description": "The Intor translation engine",
   "author": {
     "name": "Yiming Liao",
     "email": "yimingliao.official@gmail.com",
@@ -26,7 +26,8 @@
     "typescript",
     "type-safe",
     "i18n engine",
-    "translator"
+    "translator",
+    "intor"
   ],
   "license": "MIT",
   "type": "module",
@@ -47,7 +48,7 @@
   ],
   "sideEffects": false,
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=20"
   },
   "scripts": {
     "type": "tsc --noEmit",
@@ -59,7 +60,8 @@
     "build": "tsup",
     "prepublishOnly": "yarn build",
     "examples:html": "vite --config examples/html/basic/vite.config.ts",
-    "examples:html:rich-message": "vite --config examples/html/rich-message/vite.config.ts"
+    "examples:html:rich-message": "vite --config examples/html/rich-message/vite.config.ts",
+    "bench:runtime": "tsx bench/runtime/index.ts"
   },
   "dependencies": {
     "rura": "^1.0.8"
@@ -80,6 +82,7 @@
     "ts-node": "10.9.2",
     "tsd": "0.33.0",
     "tsup": "8.4.0",
+    "tsx": "^4.21.0",
     "typescript": "5.8.3",
     "typescript-eslint": "8.46.4",
     "vite": "7.2.6",