intor-translator 1.2.5 → 1.3.0

package/dist/index.cjs

@@ -466,5 +466,23 @@ function parseRichMessage(message) {
   return buildAST(tokens);
 }
 
+// src/message/render/render.ts
+function render(nodes, renderer) {
+  return nodes.map((node) => {
+    if (node.type === "text") {
+      return renderer.text(node.value);
+    }
+    const children = render(node.children, renderer);
+    return renderer.tag(node.name, node.attributes, children);
+  });
+}
+
+// src/message/render-rich-message.ts
+function renderRichMessage(message, renderer) {
+  const nodes = parseRichMessage(message);
+  return render(nodes, renderer);
+}
+
 exports.Translator = ScopeTranslator;
 exports.parseRichMessage = parseRichMessage;
+exports.renderRichMessage = renderRichMessage;

package/dist/index.d.cts

@@ -465,4 +465,35 @@ interface TagNode {
  */
 declare function parseRichMessage(message: string): ASTNode[];
 
-export { type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedMessagesUnion, type LocalizedNodeKeys, type MissingHandler, type NestedMessage, type NodeKeys, type Replacement, type ScopedLeafKeys, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage };
+/**
+ * Renderer interface for semantic message ASTs.
+ *
+ * A renderer defines how semantic nodes are transformed into a concrete output
+ * representation (e.g. string, DOM nodes, React elements).
+ *
+ * This interface is stateless by design.
+ * All rendering behavior is expressed through implementation.
+ */
+interface Renderer<Output> {
+    /** Render a plain text node. */
+    text(value: string): Output;
+    /** Render a semantic tag node with attributes and rendered children. */
+    tag(name: string, attributes: Attributes, children: Output[]): Output;
+}
+
+/**
+ * Render a rich-formatted message into a concrete output using a renderer.
+ *
+ * This function orchestrates the full rich message pipeline:
+ *
+ * - message (string) ⬇
+ *   - tokenize
+ *   - build AST
+ *   - render via provided renderer
+ *
+ * All rendering behavior is defined by the given renderer, making this
+ * function environment-agnostic (string, DOM, React, etc.).
+ */
+declare function renderRichMessage<Output>(message: string, renderer: Renderer<Output>): Output[];
+
+export { type ASTNode, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedMessagesUnion, type LocalizedNodeKeys, type MissingHandler, type NestedMessage, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, 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

@@ -465,4 +465,35 @@ interface TagNode {
  */
 declare function parseRichMessage(message: string): ASTNode[];
 
-export { type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedMessagesUnion, type LocalizedNodeKeys, type MissingHandler, type NestedMessage, type NodeKeys, type Replacement, type ScopedLeafKeys, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, parseRichMessage };
+/**
+ * Renderer interface for semantic message ASTs.
+ *
+ * A renderer defines how semantic nodes are transformed into a concrete output
+ * representation (e.g. string, DOM nodes, React elements).
+ *
+ * This interface is stateless by design.
+ * All rendering behavior is expressed through implementation.
+ */
+interface Renderer<Output> {
+    /** Render a plain text node. */
+    text(value: string): Output;
+    /** Render a semantic tag node with attributes and rendered children. */
+    tag(name: string, attributes: Attributes, children: Output[]): Output;
+}
+
+/**
+ * Render a rich-formatted message into a concrete output using a renderer.
+ *
+ * This function orchestrates the full rich message pipeline:
+ *
+ * - message (string) ⬇
+ *   - tokenize
+ *   - build AST
+ *   - render via provided renderer
+ *
+ * All rendering behavior is defined by the given renderer, making this
+ * function environment-agnostic (string, DOM, React, etc.).
+ */
+declare function renderRichMessage<Output>(message: string, renderer: Renderer<Output>): Output[];
+
+export { type ASTNode, type DefaultDepth, type FallbackLocalesMap, type FormatHandler, type HandlerContext, type LeafKeys, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedLeafKeys, type LocalizedMessagesUnion, type LocalizedNodeKeys, type MissingHandler, type NestedMessage, type NodeKeys, type Renderer, type Replacement, type ScopedLeafKeys, 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

@@ -464,4 +464,21 @@ function parseRichMessage(message) {
   return buildAST(tokens);
 }
 
-export { ScopeTranslator as Translator, parseRichMessage };
+// src/message/render/render.ts
+function render(nodes, renderer) {
+  return nodes.map((node) => {
+    if (node.type === "text") {
+      return renderer.text(node.value);
+    }
+    const children = render(node.children, renderer);
+    return renderer.tag(node.name, node.attributes, children);
+  });
+}
+
+// src/message/render-rich-message.ts
+function renderRichMessage(message, renderer) {
+  const nodes = parseRichMessage(message);
+  return render(nodes, renderer);
+}
+
+export { ScopeTranslator as Translator, parseRichMessage, renderRichMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor-translator",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "🤖 A modern, type-safe i18n engine.",
   "author": {
     "name": "Yiming Liao",
@@ -58,7 +58,7 @@
     "lint:debug": "eslint --debug",
     "knip": "knip --config .config/knip.config.ts",
     "examples:html": "vite --config examples/html/basic/vite.config.ts",
-    "examples:html:rich": "vite --config examples/html/rich/vite.config.ts"
+    "examples:html:rich-message": "vite --config examples/html/rich-message/vite.config.ts"
   },
   "dependencies": {
     "rura": "1.0.7"