intor-translator 1.4.0 → 1.4.2

package/README.md

@@ -17,8 +17,6 @@ Easy to use, modular at its core, and fully extensible.
 
 </div>
 
-> Structured 󠁯•󠁏 Predictable 󠁯•󠁏 Beautifully simple
-
 ## Features
 
 - 🔧 **Modular Pipeline** – A pluggable, hook-driven flow for any translation logic.

package/dist/index.cjs

@@ -340,7 +340,7 @@ var ScopeTranslator = class extends CoreTranslator {
   constructor(options) {
     super(options);
   }
-  /** Create a scoped translator with a prefix key, providing `t` and `hasKey` for nested keys. */
+  /** Create a scoped translator with a prefix key for resolving nested message paths. */
   scoped(preKey) {
     return {
       hasKey: (key, targetLocale) => {
@@ -363,6 +363,18 @@ var ScopeTranslator = class extends CoreTranslator {
           key: fullKey,
           replacements
         });
+      },
+      tRaw: (key, replacements) => {
+        const fullKey = getFullKey(preKey, key);
+        return translateRaw({
+          hooks: this.hooks,
+          messages: this._messages,
+          locale: this._locale,
+          isLoading: this._isLoading,
+          translateConfig: this.translateConfig,
+          key: fullKey,
+          replacements
+        });
       }
     };
   }

package/dist/index.d.cts

@@ -1,7 +1,27 @@
 import { RuraHook } from 'rura';
 
+type MessagePrimitive$1 = string | number | boolean | null;
+type MessageArray$1 = readonly MessageValue$1[];
+/**
+ * A recursive message tree object.
+ *
+ * Represents the root message structure for a single locale
+ * (i.e. the value of `LocaleMessages[locale]`).
+ */
+interface MessageObject$1 {
+    [key: string]: MessageValue$1;
+}
+/** A message value in the locale message tree. */
+type MessageValue$1 = MessagePrimitive$1 | MessageObject$1 | MessageArray$1;
+
 type MessagePrimitive = string | number | boolean | null;
 type MessageArray = readonly MessageValue[];
+/**
+ * A recursive message tree object.
+ *
+ * Represents the root message structure for a single locale
+ * (i.e. the value of `LocaleMessages[locale]`).
+ */
 interface MessageObject {
     [key: string]: MessageValue;
 }
@@ -409,11 +429,12 @@ type ScopeTranslatorOptions<M> = CoreTranslatorOptions<M>;
 type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, L extends keyof M | "union" = "union", K = LocalizedLeafKeys<M, L>> = {
     hasKey: (key?: K, targetLocale?: Locale<M>) => boolean;
     t: <Result = string>(key?: K, replacements?: Replacement) => Result;
+    tRaw: (key?: K, replacements?: Replacement) => MessageValue$1 | undefined;
 };
 
 declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, L extends keyof M | "union" = "union"> extends CoreTranslator<M> {
     constructor(options: ScopeTranslatorOptions<M>);
-    /** Create a scoped translator with a prefix key, providing `t` and `hasKey` for nested keys. */
+    /** Create a scoped translator with a prefix key for resolving nested message paths. */
     scoped<PK extends LocalizedNodeKeys<M, L> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, L, ScopedLeafKeys<M, PK, L>> : ScopeTranslatorMethods<M, L>;
 }
 

package/dist/index.d.ts

@@ -1,7 +1,27 @@
 import { RuraHook } from 'rura';
 
+type MessagePrimitive$1 = string | number | boolean | null;
+type MessageArray$1 = readonly MessageValue$1[];
+/**
+ * A recursive message tree object.
+ *
+ * Represents the root message structure for a single locale
+ * (i.e. the value of `LocaleMessages[locale]`).
+ */
+interface MessageObject$1 {
+    [key: string]: MessageValue$1;
+}
+/** A message value in the locale message tree. */
+type MessageValue$1 = MessagePrimitive$1 | MessageObject$1 | MessageArray$1;
+
 type MessagePrimitive = string | number | boolean | null;
 type MessageArray = readonly MessageValue[];
+/**
+ * A recursive message tree object.
+ *
+ * Represents the root message structure for a single locale
+ * (i.e. the value of `LocaleMessages[locale]`).
+ */
 interface MessageObject {
     [key: string]: MessageValue;
 }
@@ -409,11 +429,12 @@ type ScopeTranslatorOptions<M> = CoreTranslatorOptions<M>;
 type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, L extends keyof M | "union" = "union", K = LocalizedLeafKeys<M, L>> = {
     hasKey: (key?: K, targetLocale?: Locale<M>) => boolean;
     t: <Result = string>(key?: K, replacements?: Replacement) => Result;
+    tRaw: (key?: K, replacements?: Replacement) => MessageValue$1 | undefined;
 };
 
 declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, L extends keyof M | "union" = "union"> extends CoreTranslator<M> {
     constructor(options: ScopeTranslatorOptions<M>);
-    /** Create a scoped translator with a prefix key, providing `t` and `hasKey` for nested keys. */
+    /** Create a scoped translator with a prefix key for resolving nested message paths. */
     scoped<PK extends LocalizedNodeKeys<M, L> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, L, ScopedLeafKeys<M, PK, L>> : ScopeTranslatorMethods<M, L>;
 }
 

package/dist/index.js

@@ -338,7 +338,7 @@ var ScopeTranslator = class extends CoreTranslator {
   constructor(options) {
     super(options);
   }
-  /** Create a scoped translator with a prefix key, providing `t` and `hasKey` for nested keys. */
+  /** Create a scoped translator with a prefix key for resolving nested message paths. */
   scoped(preKey) {
     return {
       hasKey: (key, targetLocale) => {
@@ -361,6 +361,18 @@ var ScopeTranslator = class extends CoreTranslator {
           key: fullKey,
           replacements
         });
+      },
+      tRaw: (key, replacements) => {
+        const fullKey = getFullKey(preKey, key);
+        return translateRaw({
+          hooks: this.hooks,
+          messages: this._messages,
+          locale: this._locale,
+          isLoading: this._isLoading,
+          translateConfig: this.translateConfig,
+          key: fullKey,
+          replacements
+        });
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor-translator",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "🤖 A modern, type-safe i18n engine.",
   "author": {
     "name": "Yiming Liao",