intor-translator 1.4.7 → 1.4.8

package/dist/index.cjs

@@ -295,7 +295,7 @@ var CoreTranslator = class extends BaseTranslator {
     });
   };
   /** Get the translated message for a key, with optional replacements. */
-  t = (key, ...replacementArgs) => {
+  t = (key, replacements) => {
     return translate({
       hooks: this.hooks,
       messages: this._messages,
@@ -303,7 +303,7 @@ var CoreTranslator = class extends BaseTranslator {
       isLoading: this._isLoading,
       translateConfig: this.translateConfig,
       key,
-      replacements: replacementArgs[0]
+      replacements
     });
   };
 };

package/dist/index.d.cts

@@ -82,6 +82,24 @@ type Locale<M = unknown> = M extends LocaleMessages ? keyof M & string : string;
  */
 type FallbackLocalesMap<L extends string = string> = Partial<Record<L, L[]>>;
 
+/**
+ * Represents a replacement map used for interpolating values
+ * in message templates.
+ *
+ * Replacement values are treated as plain data and interpreted
+ * by the message formatter at runtime.
+ *
+ * @example
+ * const replacements: Replacement = {
+ *   name: "Alice",
+ *   count: 5,
+ *   nested: {
+ *     score: 100,
+ *   },
+ * };
+ */
+type Replacement = Record<string, MessageValue>;
+
 /**
  * Default maximum recursive depth for nested key type computations,
  * balancing type safety and compiler performance.
@@ -222,49 +240,6 @@ type ScopedLeafKeys<M, PK extends string, D extends number = DefaultDepth> = M e
  */
 type ScopedLeafValue<M, PK extends string, K extends string> = M extends LocaleMessages ? M[Locale<M>] extends infer Messages ? Messages extends MessageValue ? AtPath<Messages, PK> extends infer Scoped ? Scoped extends MessageObject ? LeafValue<Scoped, K> : never : never : never : never : MessageValue;
 
-/**
- * Represents a replacement map used for interpolating values
- * in message templates.
- *
- * Replacement values are treated as plain data and interpreted
- * by the message formatter at runtime.
- *
- * @example
- * const replacements: Replacement = {
- *   name: "Alice",
- *   count: 5,
- *   nested: {
- *     score: 100,
- *   },
- * };
- */
-type Replacement = Record<string, unknown>;
-/**
- * Resolves the expected replacement type for a localized message key.
- *
- * Uses the canonical (default-locale) replacement schema when available,
- * otherwise falls back to `Replacement`.
- *
- * @example
- * ```ts
- * type RMap = {
- *   "{locale}": {
- *     welcome: { name: MessageValue };
- *     total: { count: MessageValue };
- *   };
- * };
- *
- * type WelcomeReplacement = LocalizedReplacement<RMap, "welcome">;
- * // => { name: MessageValue }
- *
- * type UnknownReplacement = LocalizedReplacement<RMap, "unknown">;
- * // => Replacement
- * ```
- */
-type LocalizedReplacement<ReplacementSchema, K extends string> = ReplacementSchema extends {
-    "{locale}": infer LM;
-} ? AtPath<LM, K> extends infer R ? R extends MessageObject ? R : Replacement : Replacement : Replacement;
-
 /**
  * Options for initializing a translator
  *
@@ -414,7 +389,7 @@ interface TranslatorPlugin {
  *
  * @template M - Shape of the messages object.
  */
-declare class CoreTranslator<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown> extends BaseTranslator<M> {
+declare class CoreTranslator<M extends LocaleMessages | unknown = unknown> extends BaseTranslator<M> {
     /** User-provided options including messages, locale, and config. */
     protected translateConfig: TranslateConfig<M>;
     /** Active pipeline hooks applied during translation. */
@@ -429,21 +404,19 @@ declare class CoreTranslator<M extends LocaleMessages | unknown = unknown, Repla
     /** Check if a key exists in the specified locale or current locale. */
     hasKey: <K extends LocalizedLeafKeys<M>>(key: K, targetLocale?: Locale<M>) => boolean;
     /** Get the translated message for a key, with optional replacements. */
-    t: <K extends LocalizedLeafKeys<M> = LocalizedLeafKeys<M>>(key: K, ...replacementArgs: [LocalizedReplacement<ReplacementSchema, K>?]) => LocalizedLeafValue<M, K>;
+    t: <K extends LocalizedLeafKeys<M> = LocalizedLeafKeys<M>>(key: K, replacements?: Replacement) => LocalizedLeafValue<M, K>;
 }
 
 type ScopeTranslatorOptions<M> = CoreTranslatorOptions<M>;
-type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown, PK extends string | undefined = undefined, K extends string = PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>> = {
+type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, PK extends string | undefined = undefined, K extends string = PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>> = {
     hasKey: (key?: K, targetLocale?: Locale<M>) => boolean;
-    t: <Key extends K>(key?: Key, ...replacementArgs: [
-        LocalizedReplacement<ReplacementSchema, PK extends string ? `${PK}.${Key & string}` : Key>?
-    ]) => PK extends string ? ScopedLeafValue<M, PK, Key> : LocalizedLeafValue<M, Key>;
+    t: (key?: K, replacements?: Replacement) => PK extends string ? ScopedLeafValue<M, PK, K> : LocalizedLeafValue<M, K>;
 };
 
-declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown> extends CoreTranslator<M, ReplacementSchema> {
+declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown> extends CoreTranslator<M> {
     constructor(options: ScopeTranslatorOptions<M>);
     /** Create a scoped translator with a prefix key for resolving nested message paths. */
-    scoped<PK extends LocalizedNodeKeys<M> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, ReplacementSchema, PK> : ScopeTranslatorMethods<M, ReplacementSchema>;
+    scoped<PK extends LocalizedNodeKeys<M> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, PK> : ScopeTranslatorMethods<M>;
 }
 
 /** Semantic tag attributes map. */
@@ -518,4 +491,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LeafValue, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedLeafValue, type LocalizedNodeKeys, type LocalizedReplacement, type MessageObject, type MessageValue, type MissingHandler, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, type ScopedLeafValue, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage };
+export { type ASTNode, type AtPath, type Attributes, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LeafValue, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedLeafValue, type LocalizedNodeKeys, type MessageObject, type MessageValue, type MissingHandler, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, type ScopedLeafValue, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage };

package/dist/index.d.ts

@@ -82,6 +82,24 @@ type Locale<M = unknown> = M extends LocaleMessages ? keyof M & string : string;
  */
 type FallbackLocalesMap<L extends string = string> = Partial<Record<L, L[]>>;
 
+/**
+ * Represents a replacement map used for interpolating values
+ * in message templates.
+ *
+ * Replacement values are treated as plain data and interpreted
+ * by the message formatter at runtime.
+ *
+ * @example
+ * const replacements: Replacement = {
+ *   name: "Alice",
+ *   count: 5,
+ *   nested: {
+ *     score: 100,
+ *   },
+ * };
+ */
+type Replacement = Record<string, MessageValue>;
+
 /**
  * Default maximum recursive depth for nested key type computations,
  * balancing type safety and compiler performance.
@@ -222,49 +240,6 @@ type ScopedLeafKeys<M, PK extends string, D extends number = DefaultDepth> = M e
  */
 type ScopedLeafValue<M, PK extends string, K extends string> = M extends LocaleMessages ? M[Locale<M>] extends infer Messages ? Messages extends MessageValue ? AtPath<Messages, PK> extends infer Scoped ? Scoped extends MessageObject ? LeafValue<Scoped, K> : never : never : never : never : MessageValue;
 
-/**
- * Represents a replacement map used for interpolating values
- * in message templates.
- *
- * Replacement values are treated as plain data and interpreted
- * by the message formatter at runtime.
- *
- * @example
- * const replacements: Replacement = {
- *   name: "Alice",
- *   count: 5,
- *   nested: {
- *     score: 100,
- *   },
- * };
- */
-type Replacement = Record<string, unknown>;
-/**
- * Resolves the expected replacement type for a localized message key.
- *
- * Uses the canonical (default-locale) replacement schema when available,
- * otherwise falls back to `Replacement`.
- *
- * @example
- * ```ts
- * type RMap = {
- *   "{locale}": {
- *     welcome: { name: MessageValue };
- *     total: { count: MessageValue };
- *   };
- * };
- *
- * type WelcomeReplacement = LocalizedReplacement<RMap, "welcome">;
- * // => { name: MessageValue }
- *
- * type UnknownReplacement = LocalizedReplacement<RMap, "unknown">;
- * // => Replacement
- * ```
- */
-type LocalizedReplacement<ReplacementSchema, K extends string> = ReplacementSchema extends {
-    "{locale}": infer LM;
-} ? AtPath<LM, K> extends infer R ? R extends MessageObject ? R : Replacement : Replacement : Replacement;
-
 /**
  * Options for initializing a translator
  *
@@ -414,7 +389,7 @@ interface TranslatorPlugin {
  *
  * @template M - Shape of the messages object.
  */
-declare class CoreTranslator<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown> extends BaseTranslator<M> {
+declare class CoreTranslator<M extends LocaleMessages | unknown = unknown> extends BaseTranslator<M> {
     /** User-provided options including messages, locale, and config. */
     protected translateConfig: TranslateConfig<M>;
     /** Active pipeline hooks applied during translation. */
@@ -429,21 +404,19 @@ declare class CoreTranslator<M extends LocaleMessages | unknown = unknown, Repla
     /** Check if a key exists in the specified locale or current locale. */
     hasKey: <K extends LocalizedLeafKeys<M>>(key: K, targetLocale?: Locale<M>) => boolean;
     /** Get the translated message for a key, with optional replacements. */
-    t: <K extends LocalizedLeafKeys<M> = LocalizedLeafKeys<M>>(key: K, ...replacementArgs: [LocalizedReplacement<ReplacementSchema, K>?]) => LocalizedLeafValue<M, K>;
+    t: <K extends LocalizedLeafKeys<M> = LocalizedLeafKeys<M>>(key: K, replacements?: Replacement) => LocalizedLeafValue<M, K>;
 }
 
 type ScopeTranslatorOptions<M> = CoreTranslatorOptions<M>;
-type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown, PK extends string | undefined = undefined, K extends string = PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>> = {
+type ScopeTranslatorMethods<M extends LocaleMessages | unknown = unknown, PK extends string | undefined = undefined, K extends string = PK extends string ? ScopedLeafKeys<M, PK> : LocalizedLeafKeys<M>> = {
     hasKey: (key?: K, targetLocale?: Locale<M>) => boolean;
-    t: <Key extends K>(key?: Key, ...replacementArgs: [
-        LocalizedReplacement<ReplacementSchema, PK extends string ? `${PK}.${Key & string}` : Key>?
-    ]) => PK extends string ? ScopedLeafValue<M, PK, Key> : LocalizedLeafValue<M, Key>;
+    t: (key?: K, replacements?: Replacement) => PK extends string ? ScopedLeafValue<M, PK, K> : LocalizedLeafValue<M, K>;
 };
 
-declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, ReplacementSchema = unknown> extends CoreTranslator<M, ReplacementSchema> {
+declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown> extends CoreTranslator<M> {
     constructor(options: ScopeTranslatorOptions<M>);
     /** Create a scoped translator with a prefix key for resolving nested message paths. */
-    scoped<PK extends LocalizedNodeKeys<M> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, ReplacementSchema, PK> : ScopeTranslatorMethods<M, ReplacementSchema>;
+    scoped<PK extends LocalizedNodeKeys<M> | undefined = undefined>(preKey?: PK): PK extends string ? ScopeTranslatorMethods<M, PK> : ScopeTranslatorMethods<M>;
 }
 
 /** Semantic tag attributes map. */
@@ -518,4 +491,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LeafValue, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedLeafValue, type LocalizedNodeKeys, type LocalizedReplacement, type MessageObject, type MessageValue, type MissingHandler, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, type ScopedLeafValue, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage };
+export { type ASTNode, type AtPath, type Attributes, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LeafValue, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedLeafValue, type LocalizedNodeKeys, type MessageObject, type MessageValue, type MissingHandler, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, type ScopedLeafValue, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage, renderRichMessage };

package/dist/index.js

@@ -293,7 +293,7 @@ var CoreTranslator = class extends BaseTranslator {
     });
   };
   /** Get the translated message for a key, with optional replacements. */
-  t = (key, ...replacementArgs) => {
+  t = (key, replacements) => {
     return translate({
       hooks: this.hooks,
       messages: this._messages,
@@ -301,7 +301,7 @@ var CoreTranslator = class extends BaseTranslator {
       isLoading: this._isLoading,
       translateConfig: this.translateConfig,
       key,
-      replacements: replacementArgs[0]
+      replacements
     });
   };
 };

package/package.json

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