intor-translator 1.4.13 → 1.4.14

package/README.md

@@ -1,16 +1,12 @@
 <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)
@@ -19,9 +15,9 @@ Easy to use, modular at its core, and fully extensible.
 
 ## 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 +90,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 +103,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.

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.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "intor-translator",
-  "version": "1.4.13",
-  "description": "🤖 A modern, type-safe i18n engine.",
+  "version": "1.4.14",
+  "description": "The Intor translation engine",
   "author": {
     "name": "Yiming Liao",
     "email": "yimingliao.official@gmail.com",
@@ -59,7 +59,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"