intor-translator 1.4.10 → 1.4.12

package/dist/index.d.cts

@@ -239,6 +239,43 @@ type LocalizedReplacement<ReplacementSchema, K extends string> = ReplacementSche
  */
 type ScopedReplacement<ReplacementSchema, PK extends string | undefined, K extends string> = LocalizedReplacement<ReplacementSchema, `${PK}.${K}`>;
 
+/**
+ * Generic rich tag map used when no schema is available.
+ *
+ * Acts as a safe fallback for dynamic or unknown rich tag shapes.
+ */
+type Rich = Record<string, unknown>;
+/**
+ * Rich tag map resolved from a localized rich schema.
+ *
+ * - If the key exists in the schema, resolves to the declared tag map
+ * - Otherwise falls back to generic `Rich`
+ *
+ * @example
+ * ```ts
+ * type RichSchema = { "{locale}": { link: { a: {} } } }
+ * LocalizedRich<RichSchema, "link"> // => { a: {} }
+ * LocalizedRich<RichSchema, "missing">; // => Rich
+ * ```
+ */
+type LocalizedRich<RichSchema, K extends string> = RichSchema extends {
+    "{locale}": infer LM;
+} ? IsNever<AtPath<LM, K>> extends true ? Rich : AtPath<LM, K> extends MessageObject ? AtPath<LM, K> : Rich : Rich;
+/**
+ * Rich tag map resolved under a scoped prefix key.
+ *
+ * Internally composes the full dot-path (`"${PK}.${K}"`)
+ * and delegates resolution to `LocalizedRich`.
+ *
+ * @example
+ * ```ts
+ * type RichSchema = { "{locale}": { app: { link: { a: {} } } } };
+ * ScopedRich<RichSchema, "app", "link">; // => { a: {} }
+ * ScopedRich<RichSchema, "app", "missing">; // => Rich
+ * ```
+ */
+type ScopedRich<RichSchema, PK extends string | undefined, K extends string> = LocalizedRich<RichSchema, `${PK}.${K}`>;
+
 /**
  * Options for initializing a translator
  *
@@ -530,4 +567,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type ScopedKey, type ScopedReplacement, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };
+export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };

package/dist/index.d.ts

@@ -239,6 +239,43 @@ type LocalizedReplacement<ReplacementSchema, K extends string> = ReplacementSche
  */
 type ScopedReplacement<ReplacementSchema, PK extends string | undefined, K extends string> = LocalizedReplacement<ReplacementSchema, `${PK}.${K}`>;
 
+/**
+ * Generic rich tag map used when no schema is available.
+ *
+ * Acts as a safe fallback for dynamic or unknown rich tag shapes.
+ */
+type Rich = Record<string, unknown>;
+/**
+ * Rich tag map resolved from a localized rich schema.
+ *
+ * - If the key exists in the schema, resolves to the declared tag map
+ * - Otherwise falls back to generic `Rich`
+ *
+ * @example
+ * ```ts
+ * type RichSchema = { "{locale}": { link: { a: {} } } }
+ * LocalizedRich<RichSchema, "link"> // => { a: {} }
+ * LocalizedRich<RichSchema, "missing">; // => Rich
+ * ```
+ */
+type LocalizedRich<RichSchema, K extends string> = RichSchema extends {
+    "{locale}": infer LM;
+} ? IsNever<AtPath<LM, K>> extends true ? Rich : AtPath<LM, K> extends MessageObject ? AtPath<LM, K> : Rich : Rich;
+/**
+ * Rich tag map resolved under a scoped prefix key.
+ *
+ * Internally composes the full dot-path (`"${PK}.${K}"`)
+ * and delegates resolution to `LocalizedRich`.
+ *
+ * @example
+ * ```ts
+ * type RichSchema = { "{locale}": { app: { link: { a: {} } } } };
+ * ScopedRich<RichSchema, "app", "link">; // => { a: {} }
+ * ScopedRich<RichSchema, "app", "missing">; // => Rich
+ * ```
+ */
+type ScopedRich<RichSchema, PK extends string | undefined, K extends string> = LocalizedRich<RichSchema, `${PK}.${K}`>;
+
 /**
  * Options for initializing a translator
  *
@@ -530,4 +567,4 @@ interface Renderer<Output> {
  */
 declare function renderRichMessage<Output>(message: MessageValue, renderer: Renderer<Output>): Output[];
 
-export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type ScopedKey, type ScopedReplacement, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };
+export { type ASTNode, type AtPath, type Attributes, type FallbackLocalesMap, type FormatHandler, type GeneratePaths, type HandlerContext, type IfLocaleMessages, type IfMessageObject, type Key, type LoadingHandler, type Locale, type LocaleMessages, type LocalizedKey, type LocalizedPreKey, type LocalizedReplacement, type LocalizedRich, type LocalizedValue, type MessageObject, type MessageValue, type MissingHandler, type PreKey, type Renderer, type Replacement, type Rich, type ScopedKey, type ScopedReplacement, type ScopedRich, type ScopedValue, type Token, type TranslateConfig, type TranslateContext, type TranslateHandlers, type TranslateHook, ScopeTranslator as Translator, type ScopeTranslatorMethods as TranslatorMethods, type ScopeTranslatorOptions as TranslatorOptions, type TranslatorPlugin, type Value, parseRichMessage, renderRichMessage, tokenize };

package/package.json

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