intor-translator 1.0.13 → 1.0.15

package/dist/index.cjs

@@ -194,11 +194,11 @@ var translate = ({
       return loadingMessage;
     }
   }
-  if (!message) {
+  if (message === void 0 || message === null) {
     if (onMissing) {
       return onMissing({ key, locale, replacements });
     }
-    if (placeholder) {
+    if (placeholder !== void 0 && placeholder !== null) {
       return placeholder;
     }
     return key;
@@ -212,9 +212,8 @@ var translate = ({
 
 // src/translators/base-translator/base-translator.ts
 var BaseTranslator = class {
-  constructor(options = {}) {
+  constructor(options) {
     this.messagesRef = { current: void 0 };
-    this.localeRef = { current: void 0 };
     /** Check if a key exists in the specified locale or current locale. */
     this.hasKey = (key, targetLocale) => {
       return hasKey({
@@ -224,12 +223,8 @@ var BaseTranslator = class {
         targetLocale
       });
     };
-    if (options.messages) {
-      this.messagesRef.current = options.messages;
-    }
-    if (options.locale) {
-      this.localeRef.current = options.locale;
-    }
+    this.messagesRef = { current: options.messages };
+    this.localeRef = { current: options.locale };
   }
   /** Get all message data. */
   get messages() {
@@ -270,7 +265,7 @@ var CoreTranslator = class extends BaseTranslator {
         replacements
       });
     };
-    this.options = options || {};
+    this.options = options;
   }
   /** Get the current loading state. */
   get isLoading() {

package/dist/index.d.cts

@@ -313,7 +313,7 @@ type MessagesRef<M> = {
  * };
  */
 type LocaleRef<M> = {
-    current?: LocaleKey<M>;
+    current: LocaleKey<M>;
 };
 /**
  * A ref object indicating whether translation is loading.
@@ -374,13 +374,13 @@ type TranslateContext = {
 
 interface BaseTranslatorOptions<M = unknown> {
     messages?: Readonly<M>;
-    locale?: LocaleKey<M>;
+    locale: LocaleKey<M>;
 }
 
 declare class BaseTranslator<M = unknown> {
     protected messagesRef: MessagesRef<M>;
     protected localeRef: LocaleRef<M>;
-    constructor(options?: BaseTranslatorOptions<M>);
+    constructor(options: BaseTranslatorOptions<M>);
     /** Get all message data. */
     get messages(): M | undefined;
     /**
@@ -391,7 +391,7 @@ declare class BaseTranslator<M = unknown> {
      */
     setMessages<N extends LocaleNamespaceMessages>(messages: N): void;
     /** Get the current active locale. */
-    get locale(): LocaleKey<M> | undefined;
+    get locale(): LocaleKey<M>;
     /** Change the active locale. */
     setLocale(newLocale: LocaleKey<M>): void;
     /** Check if a key exists in the specified locale or current locale. */
@@ -404,7 +404,7 @@ interface CoreTranslatorOptions<M> extends BaseTranslatorOptions<M>, TranslateCo
 declare class CoreTranslator<M = unknown> extends BaseTranslator<M> {
     protected options: CoreTranslatorOptions<M>;
     protected isLoadingRef: IsLoadingRef;
-    constructor(options?: CoreTranslatorOptions<M>);
+    constructor(options: CoreTranslatorOptions<M>);
     /** Get the current loading state. */
     get isLoading(): boolean;
     /** Set the loading state. */
@@ -413,29 +413,9 @@ declare class CoreTranslator<M = unknown> extends BaseTranslator<M> {
 }
 
 declare class ScopeTranslator<M = unknown> extends CoreTranslator<M> {
-    constructor(options?: CoreTranslatorOptions<M>);
+    constructor(options: CoreTranslatorOptions<M>);
     scoped<K extends NodeKeys<UnionLocaleMessages<M>> & string>(preKey: K): ScopedTranslatorMethods<M, K>;
     scoped(): TranslatorMethods<M>;
 }
 
-/**
- * Generic translate function type.
- *
- * Represents the shape of a `t()` function that supports typed keys and optional replacements.
- *
- * @template M - The shape of the messages object (e.g., typeof messages)
- * @template Result - The expected return type (usually string, but can be JSX or others)
- */
-type TranslateFunction = <M, Result = string>(key: InferTranslatorKey<M>, replacements?: Replacement | RichReplacement) => Result;
-/**
- * Generic hasKey function type.
- *
- * Represents a function that checks if a given key exists in a message set,
- * optionally for a specific locale.
- *
- * @template M - The shape of the messages object
- * @template Result - The return value (default is boolean, override if needed)
- */
-type HasKeyFunction = <M, Result = boolean>(key: InferTranslatorKey<M>, targetLocale?: LocaleKey<M>) => Result;
-
-export { type FallbackLocalesMap, type FormatMessage, type HasKeyFunction, type InferTranslatorKey, type IsLoadingRef, type LeafKeys, type Locale, type LocaleKey, type LocaleNamespaceMessages, type LocaleRef, type Message, type MessageRecord, type MessagesRef, type Namespace, type NamespaceMessages, type NestedMessage, type NodeKeys, type OnLoading, type OnMissing, type Replacement, type RichReplacement, type ScopedLeafKeys, type StrictLocaleKey, type TranslateConfig, type TranslateContext, type TranslateFunction, type TranslateHandlers, ScopeTranslator as Translator, type UnionLocaleLeafKeys, type UnionLocaleMessages };
+export { type FallbackLocalesMap, type FormatMessage, type InferTranslatorKey, type IsLoadingRef, type LeafKeys, type Locale, type LocaleKey, type LocaleNamespaceMessages, type LocaleRef, type Message, type MessageRecord, type MessagesRef, type Namespace, type NamespaceMessages, type NestedMessage, type NodeKeys, type OnLoading, type OnMissing, type Replacement, type RichReplacement, type ScopedLeafKeys, type StrictLocaleKey, type TranslateConfig, type TranslateContext, type TranslateHandlers, ScopeTranslator as Translator, type UnionLocaleLeafKeys, type UnionLocaleMessages };

package/dist/index.d.ts

@@ -313,7 +313,7 @@ type MessagesRef<M> = {
  * };
  */
 type LocaleRef<M> = {
-    current?: LocaleKey<M>;
+    current: LocaleKey<M>;
 };
 /**
  * A ref object indicating whether translation is loading.
@@ -374,13 +374,13 @@ type TranslateContext = {
 
 interface BaseTranslatorOptions<M = unknown> {
     messages?: Readonly<M>;
-    locale?: LocaleKey<M>;
+    locale: LocaleKey<M>;
 }
 
 declare class BaseTranslator<M = unknown> {
     protected messagesRef: MessagesRef<M>;
     protected localeRef: LocaleRef<M>;
-    constructor(options?: BaseTranslatorOptions<M>);
+    constructor(options: BaseTranslatorOptions<M>);
     /** Get all message data. */
     get messages(): M | undefined;
     /**
@@ -391,7 +391,7 @@ declare class BaseTranslator<M = unknown> {
      */
     setMessages<N extends LocaleNamespaceMessages>(messages: N): void;
     /** Get the current active locale. */
-    get locale(): LocaleKey<M> | undefined;
+    get locale(): LocaleKey<M>;
     /** Change the active locale. */
     setLocale(newLocale: LocaleKey<M>): void;
     /** Check if a key exists in the specified locale or current locale. */
@@ -404,7 +404,7 @@ interface CoreTranslatorOptions<M> extends BaseTranslatorOptions<M>, TranslateCo
 declare class CoreTranslator<M = unknown> extends BaseTranslator<M> {
     protected options: CoreTranslatorOptions<M>;
     protected isLoadingRef: IsLoadingRef;
-    constructor(options?: CoreTranslatorOptions<M>);
+    constructor(options: CoreTranslatorOptions<M>);
     /** Get the current loading state. */
     get isLoading(): boolean;
     /** Set the loading state. */
@@ -413,29 +413,9 @@ declare class CoreTranslator<M = unknown> extends BaseTranslator<M> {
 }
 
 declare class ScopeTranslator<M = unknown> extends CoreTranslator<M> {
-    constructor(options?: CoreTranslatorOptions<M>);
+    constructor(options: CoreTranslatorOptions<M>);
     scoped<K extends NodeKeys<UnionLocaleMessages<M>> & string>(preKey: K): ScopedTranslatorMethods<M, K>;
     scoped(): TranslatorMethods<M>;
 }
 
-/**
- * Generic translate function type.
- *
- * Represents the shape of a `t()` function that supports typed keys and optional replacements.
- *
- * @template M - The shape of the messages object (e.g., typeof messages)
- * @template Result - The expected return type (usually string, but can be JSX or others)
- */
-type TranslateFunction = <M, Result = string>(key: InferTranslatorKey<M>, replacements?: Replacement | RichReplacement) => Result;
-/**
- * Generic hasKey function type.
- *
- * Represents a function that checks if a given key exists in a message set,
- * optionally for a specific locale.
- *
- * @template M - The shape of the messages object
- * @template Result - The return value (default is boolean, override if needed)
- */
-type HasKeyFunction = <M, Result = boolean>(key: InferTranslatorKey<M>, targetLocale?: LocaleKey<M>) => Result;
-
-export { type FallbackLocalesMap, type FormatMessage, type HasKeyFunction, type InferTranslatorKey, type IsLoadingRef, type LeafKeys, type Locale, type LocaleKey, type LocaleNamespaceMessages, type LocaleRef, type Message, type MessageRecord, type MessagesRef, type Namespace, type NamespaceMessages, type NestedMessage, type NodeKeys, type OnLoading, type OnMissing, type Replacement, type RichReplacement, type ScopedLeafKeys, type StrictLocaleKey, type TranslateConfig, type TranslateContext, type TranslateFunction, type TranslateHandlers, ScopeTranslator as Translator, type UnionLocaleLeafKeys, type UnionLocaleMessages };
+export { type FallbackLocalesMap, type FormatMessage, type InferTranslatorKey, type IsLoadingRef, type LeafKeys, type Locale, type LocaleKey, type LocaleNamespaceMessages, type LocaleRef, type Message, type MessageRecord, type MessagesRef, type Namespace, type NamespaceMessages, type NestedMessage, type NodeKeys, type OnLoading, type OnMissing, type Replacement, type RichReplacement, type ScopedLeafKeys, type StrictLocaleKey, type TranslateConfig, type TranslateContext, type TranslateHandlers, ScopeTranslator as Translator, type UnionLocaleLeafKeys, type UnionLocaleMessages };

package/dist/index.js

@@ -192,11 +192,11 @@ var translate = ({
       return loadingMessage;
     }
   }
-  if (!message) {
+  if (message === void 0 || message === null) {
     if (onMissing) {
       return onMissing({ key, locale, replacements });
     }
-    if (placeholder) {
+    if (placeholder !== void 0 && placeholder !== null) {
       return placeholder;
     }
     return key;
@@ -210,9 +210,8 @@ var translate = ({
 
 // src/translators/base-translator/base-translator.ts
 var BaseTranslator = class {
-  constructor(options = {}) {
+  constructor(options) {
     this.messagesRef = { current: void 0 };
-    this.localeRef = { current: void 0 };
     /** Check if a key exists in the specified locale or current locale. */
     this.hasKey = (key, targetLocale) => {
       return hasKey({
@@ -222,12 +221,8 @@ var BaseTranslator = class {
         targetLocale
       });
     };
-    if (options.messages) {
-      this.messagesRef.current = options.messages;
-    }
-    if (options.locale) {
-      this.localeRef.current = options.locale;
-    }
+    this.messagesRef = { current: options.messages };
+    this.localeRef = { current: options.locale };
   }
   /** Get all message data. */
   get messages() {
@@ -268,7 +263,7 @@ var CoreTranslator = class extends BaseTranslator {
         replacements
       });
     };
-    this.options = options || {};
+    this.options = options;
   }
   /** Get the current loading state. */
   get isLoading() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor-translator",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "A type safe translator that knows what to say and how to handle the rest. Supports custom messages, rich replacements, and async loading.",
   "author": "Yiming Liao",
   "license": "MIT",