intor-translator 1.4.3 → 1.4.4

package/dist/index.cjs

@@ -509,18 +509,44 @@ function buildAST(tokens) {
 
 // src/message/parse-rich-message.ts
 function parseRichMessage(message) {
-  const tokens = tokenize(message);
-  return buildAST(tokens);
+  if (message == null) return [];
+  if (typeof message === "string") {
+    const tokens = tokenize(message);
+    return buildAST(tokens);
+  }
+  if (typeof message === "number" || typeof message === "boolean") {
+    const tokens = tokenize(String(message));
+    return buildAST(tokens);
+  }
+  if (Array.isArray(message)) {
+    return message.flatMap((m) => parseRichMessage(m));
+  }
+  return [
+    {
+      type: "raw",
+      value: message
+    }
+  ];
 }
 
 // src/message/render/render.ts
 function render(nodes, renderer) {
   return nodes.map((node) => {
-    if (node.type === "text") {
-      return renderer.text(node.value);
+    switch (node.type) {
+      // Plain text node
+      case "text": {
+        return renderer.text(node.value);
+      }
+      // Semantic tag node
+      case "tag": {
+        const children = render(node.children, renderer);
+        return renderer.tag(node.name, node.attributes, children);
+      }
+      // Raw message value
+      case "raw": {
+        return renderer.raw(node.value);
+      }
     }
-    const children = render(node.children, renderer);
-    return renderer.tag(node.name, node.attributes, children);
   });
 }
 

package/dist/index.d.cts

@@ -458,7 +458,7 @@ declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, L ex
 type Attributes = Record<string, string>;
 
 /** Semantic node produced by the AST builder. */
-type ASTNode = TextNode | TagNode;
+type ASTNode = TextNode | TagNode | RawNode;
 /** Plain text node in the semantic AST. */
 interface TextNode {
     type: "text";
@@ -471,23 +471,27 @@ interface TagNode {
     attributes: Attributes;
     children: ASTNode[];
 }
+/** Raw node representing a non-tokenizable message value. */
+interface RawNode {
+    type: "raw";
+    value: Exclude<MessageValue, string>;
+}
 
 /**
- * Parse a rich-formatted message string into a semantic AST.
- *
- * This function is a high-level entry point for processing translated
- * messages that contain semantic tags (e.g. <b>, <a>, <i>).
+ * Parse a rich message value into a semantic AST.
  *
- * Internally, it performs the following steps:
+ * This is the main entry point for processing translated messages that may
+ * contain semantic markup (e.g. <b>, <a>, <i>) or non-string values.
  *
- * - message (string) ⬇
- *   - tokenize
- *   - build AST
+ * Behavior by message type:
+ * - string        → tokenized and parsed into semantic AST
+ * - number/boolean → stringified, then tokenized and parsed
+ * - array         → recursively flattened and parsed
+ * - object        → preserved as a raw AST node
  *
- * The returned AST represents the semantic structure of the message
- * and is intended to be consumed by renderers or further processing stages.
+ * The returned AST is renderer-agnostic and represents semantic structure only.
  */
-declare function parseRichMessage(message: string): ASTNode[];
+declare function parseRichMessage(message: MessageValue): ASTNode[];
 
 /**
  * Renderer interface for semantic message ASTs.
@@ -503,21 +507,23 @@ interface Renderer<Output> {
     text(value: string): Output;
     /** Render a semantic tag node with attributes and rendered children. */
     tag(name: string, attributes: Attributes, children: Output[]): Output;
+    /** Render a raw (non-tokenized) message value. */
+    raw(value: Exclude<MessageValue, string>): Output;
 }
 
 /**
- * Render a rich-formatted message into a concrete output using a renderer.
+ * Render a rich message value into a concrete output using the given renderer.
  *
- * This function orchestrates the full rich message pipeline:
+ * This function is the main entry point of the rich message pipeline.
+ * It orchestrates the full flow from message value to rendered output:
  *
- * - message (string) ⬇
- *   - tokenize
- *   - build AST
- *   - render via provided renderer
+ * - MessageValue ⬇
+ *   - parse into semantic AST
+ *   - render AST via the provided renderer
  *
- * All rendering behavior is defined by the given renderer, making this
- * function environment-agnostic (string, DOM, React, etc.).
+ * All rendering behavior is delegated to the renderer, making this function
+ * fully environment-agnostic (e.g. string, DOM, React).
  */
-declare function renderRichMessage<Output>(message: string, renderer: Renderer<Output>): Output[];
+declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
 export { type ASTNode, 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 LocalizedMessagesUnion, 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

@@ -458,7 +458,7 @@ declare class ScopeTranslator<M extends LocaleMessages | unknown = unknown, L ex
 type Attributes = Record<string, string>;
 
 /** Semantic node produced by the AST builder. */
-type ASTNode = TextNode | TagNode;
+type ASTNode = TextNode | TagNode | RawNode;
 /** Plain text node in the semantic AST. */
 interface TextNode {
     type: "text";
@@ -471,23 +471,27 @@ interface TagNode {
     attributes: Attributes;
     children: ASTNode[];
 }
+/** Raw node representing a non-tokenizable message value. */
+interface RawNode {
+    type: "raw";
+    value: Exclude<MessageValue, string>;
+}
 
 /**
- * Parse a rich-formatted message string into a semantic AST.
- *
- * This function is a high-level entry point for processing translated
- * messages that contain semantic tags (e.g. <b>, <a>, <i>).
+ * Parse a rich message value into a semantic AST.
  *
- * Internally, it performs the following steps:
+ * This is the main entry point for processing translated messages that may
+ * contain semantic markup (e.g. <b>, <a>, <i>) or non-string values.
  *
- * - message (string) ⬇
- *   - tokenize
- *   - build AST
+ * Behavior by message type:
+ * - string        → tokenized and parsed into semantic AST
+ * - number/boolean → stringified, then tokenized and parsed
+ * - array         → recursively flattened and parsed
+ * - object        → preserved as a raw AST node
  *
- * The returned AST represents the semantic structure of the message
- * and is intended to be consumed by renderers or further processing stages.
+ * The returned AST is renderer-agnostic and represents semantic structure only.
  */
-declare function parseRichMessage(message: string): ASTNode[];
+declare function parseRichMessage(message: MessageValue): ASTNode[];
 
 /**
  * Renderer interface for semantic message ASTs.
@@ -503,21 +507,23 @@ interface Renderer<Output> {
     text(value: string): Output;
     /** Render a semantic tag node with attributes and rendered children. */
     tag(name: string, attributes: Attributes, children: Output[]): Output;
+    /** Render a raw (non-tokenized) message value. */
+    raw(value: Exclude<MessageValue, string>): Output;
 }
 
 /**
- * Render a rich-formatted message into a concrete output using a renderer.
+ * Render a rich message value into a concrete output using the given renderer.
  *
- * This function orchestrates the full rich message pipeline:
+ * This function is the main entry point of the rich message pipeline.
+ * It orchestrates the full flow from message value to rendered output:
  *
- * - message (string) ⬇
- *   - tokenize
- *   - build AST
- *   - render via provided renderer
+ * - MessageValue ⬇
+ *   - parse into semantic AST
+ *   - render AST via the provided renderer
  *
- * All rendering behavior is defined by the given renderer, making this
- * function environment-agnostic (string, DOM, React, etc.).
+ * All rendering behavior is delegated to the renderer, making this function
+ * fully environment-agnostic (e.g. string, DOM, React).
  */
-declare function renderRichMessage<Output>(message: string, renderer: Renderer<Output>): Output[];
+declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
 export { type ASTNode, 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 LocalizedMessagesUnion, 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

@@ -507,18 +507,44 @@ function buildAST(tokens) {
 
 // src/message/parse-rich-message.ts
 function parseRichMessage(message) {
-  const tokens = tokenize(message);
-  return buildAST(tokens);
+  if (message == null) return [];
+  if (typeof message === "string") {
+    const tokens = tokenize(message);
+    return buildAST(tokens);
+  }
+  if (typeof message === "number" || typeof message === "boolean") {
+    const tokens = tokenize(String(message));
+    return buildAST(tokens);
+  }
+  if (Array.isArray(message)) {
+    return message.flatMap((m) => parseRichMessage(m));
+  }
+  return [
+    {
+      type: "raw",
+      value: message
+    }
+  ];
 }
 
 // src/message/render/render.ts
 function render(nodes, renderer) {
   return nodes.map((node) => {
-    if (node.type === "text") {
-      return renderer.text(node.value);
+    switch (node.type) {
+      // Plain text node
+      case "text": {
+        return renderer.text(node.value);
+      }
+      // Semantic tag node
+      case "tag": {
+        const children = render(node.children, renderer);
+        return renderer.tag(node.name, node.attributes, children);
+      }
+      // Raw message value
+      case "raw": {
+        return renderer.raw(node.value);
+      }
     }
-    const children = render(node.children, renderer);
-    return renderer.tag(node.name, node.attributes, children);
   });
 }
 

package/package.json

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