vanilla-intlayer 9.5.10 → 9.5.12

package/dist/cjs/client/useDictionaryDynamic.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_getDictionary = require('../getDictionary.cjs');
 const require_client_installIntlayer = require('./installIntlayer.cjs');
-let _intlayer_config_built = require("@intlayer/config/built");
+let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useDictionaryDynamic.ts
@@ -49,7 +49,6 @@ const recursiveProxy = new Proxy(() => {}, {
 */
 const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 	const client = require_client_installIntlayer.getIntlayerClient();
-	const defaultLocale = _intlayer_config_built.internationalization.defaultLocale;
 	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && (0, _intlayer_core_dictionaryManipulator.isQualifiedDynamicLoaderMap)(dictionaryLoaders)) {
 		const loaderMap = dictionaryLoaders;
 		const { locale: selectorLocale, selector } = (0, _intlayer_core_dictionaryManipulator.parseDictionarySelector)((0, _intlayer_core_dictionaryManipulator.resolveDictionaryArgument)({
@@ -67,7 +66,7 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 			selector,
 			transform: (dictionary) => require_getDictionary.getDictionary(dictionary, locale)
 		});
-		const currentLocale = selectorLocale ?? client.locale ?? defaultLocale;
+		const currentLocale = selectorLocale ?? client.locale ?? (0, _intlayer_core_interpreter.resolveInterpreterLocale)();
 		const cacheKey = buildKey(currentLocale);
 		const attachOnChange = (content) => {
 			if (content != null && typeof content === "object") content.onChange = (callback) => {
@@ -98,7 +97,7 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 		}
 		return recursiveProxy;
 	}
-	const currentLocale = (typeof localeOrSelector === "string" ? localeOrSelector : void 0) ?? client.locale ?? defaultLocale;
+	const currentLocale = (typeof localeOrSelector === "string" ? localeOrSelector : void 0) ?? client.locale ?? (0, _intlayer_core_interpreter.resolveInterpreterLocale)();
 	const cacheKey = `${String(key)}.${currentLocale}`;
 	const loader = dictionaryLoaders[currentLocale];
 	if (!cache.has(cacheKey)) {

package/dist/cjs/client/useDictionaryDynamic.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.cjs","names":["getIntlayerClient","internationalization","isQualifiedDynamicLoaderMap","parseDictionarySelector","resolveDictionaryArgument","getDictionarySelectorCacheKey","resolveQualifiedDynamicContentAsync","getDictionary","getPreloadedDictionary"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport {\n  getDictionarySelectorCacheKey,\n  getPreloadedDictionary,\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { getIntlayerClient } from './installIntlayer';\nimport type { WithOnChange } from './useDictionary';\n\n/** Simple in-memory cache shared across all calls in the same page. */\nconst cache = new Map<string, Dictionary>();\n\n/** Tracks in-flight loads to avoid duplicate fetches. */\nconst inflight = new Map<string, Promise<void>>();\n\n/** Resolved-content cache for qualified (collection/variant/meta) keys. */\nconst qualifiedCache = new Map<string, unknown>();\nconst qualifiedInflight = new Map<string, Promise<void>>();\n\nconst loadDictionary = <T extends Dictionary>(\n  cacheKey: string,\n  loader: () => Promise<T>\n): Promise<void> => {\n  if (cache.has(cacheKey)) return Promise.resolve();\n  if (inflight.has(cacheKey)) return inflight.get(cacheKey)!;\n\n  const promise = loader().then((dictionary) => {\n    cache.set(cacheKey, dictionary);\n    inflight.delete(cacheKey);\n  });\n\n  inflight.set(cacheKey, promise);\n  return promise;\n};\n\n/** Placeholder proxy — safe for any property access while loading. */\nconst recursiveProxy: any = new Proxy(() => {}, {\n  get: (_t, prop) => {\n    if (prop === Symbol.toPrimitive) return () => '';\n    if (prop === 'toString') return () => '';\n    if (prop === 'valueOf') return () => '';\n    if (prop === 'then') return undefined; // not a Promise\n    if (prop === 'onChange') return (_cb: any) => recursiveProxy;\n    return recursiveProxy;\n  },\n  apply: () => recursiveProxy,\n});\n\n/**\n * Dynamically load and transform a dictionary (plain or qualified).\n *\n * For a qualified loader map (collection / variant, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded. The first call returns a placeholder\n * and triggers a background load; the client then notifies subscribers so the\n * render runs again with real content.\n *\n * @param dictionaryLoaders - Locale-keyed loader map, or a qualified loader map.\n * @param key               - Dictionary key (used for cache namespacing).\n * @param localeOrSelector  - Optional locale or selector.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = DeclaredLocales,\n>(\n  dictionaryLoaders:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n): WithOnChange<DeepTransformContent<T['content']>> => {\n  const client = getIntlayerClient();\n  const defaultLocale = internationalization.defaultLocale;\n\n  // --- Qualified loader map (collection / variant) ---\n  if (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryLoaders)\n  ) {\n    const loaderMap = dictionaryLoaders;\n    // Layers the client's ambient variant under the call-site argument before\n    // the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: client.locale,\n          contextVariant: client.variant,\n          dictionaryKey: String(key),\n        })\n      );\n    const selectorId = getDictionarySelectorCacheKey(selector);\n\n    const buildKey = (locale: string) =>\n      `${String(key)}.${locale}.${selectorId}`;\n    const resolveContent = (locale: LocalesValues) =>\n      resolveQualifiedDynamicContentAsync({\n        loaderMap,\n        key: String(key),\n        locale,\n        selector,\n        transform: (dictionary) =>\n          getDictionary(dictionary, locale as DeclaredLocales),\n      });\n\n    const currentLocale = (selectorLocale ??\n      client.locale ??\n      defaultLocale) as LocalesValues;\n    const cacheKey = buildKey(currentLocale);\n\n    const attachOnChange = (content: any) => {\n      if (content != null && typeof content === 'object') {\n        content.onChange = (callback: (c: any) => void) => {\n          client.subscribe((newLocale) => {\n            const locale = (selectorLocale ?? newLocale) as LocalesValues;\n            const newKey = buildKey(locale);\n\n            if (qualifiedCache.has(newKey)) {\n              callback(qualifiedCache.get(newKey));\n              return;\n            }\n\n            resolveContent(locale).then((resolved) => {\n              qualifiedCache.set(newKey, resolved);\n              callback(resolved);\n            });\n          });\n          return content;\n        };\n      }\n      return content;\n    };\n\n    if (qualifiedCache.has(cacheKey)) {\n      return attachOnChange(qualifiedCache.get(cacheKey)) as any;\n    }\n\n    if (!qualifiedInflight.has(cacheKey)) {\n      const promise = resolveContent(currentLocale).then((resolved) => {\n        qualifiedCache.set(cacheKey, resolved);\n        qualifiedInflight.delete(cacheKey);\n        client.notify();\n      });\n      qualifiedInflight.set(cacheKey, promise);\n    }\n\n    return recursiveProxy;\n  }\n\n  // --- Plain locale-keyed loader map ---\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n  const currentLocale = (locale ?? client.locale ?? defaultLocale) as A;\n\n  const cacheKey = `${String(key)}.${currentLocale}`;\n  const loader = (dictionaryLoaders as Record<string, () => Promise<T>>)[\n    currentLocale as string\n  ];\n\n  // A build-tool plugin may have started this locale's chunk while the entry\n  // point evaluated, and it may already have landed. Seeding the cache with it turns the first call into a\n  // cache hit, so the branch below returns real content instead of the\n  // placeholder proxy — no extra code path needed.\n  if (!cache.has(cacheKey)) {\n    const preloadedDictionary = getPreloadedDictionary(\n      dictionaryLoaders,\n      currentLocale as LocalesValues\n    );\n\n    if (preloadedDictionary) cache.set(cacheKey, preloadedDictionary);\n  }\n\n  // --- Cache hit: return real content synchronously ---\n  const cached = cache.get(cacheKey);\n  if (cached) {\n    const content = getDictionary(cached, currentLocale) as WithOnChange<\n      DeepTransformContent<T['content']>\n    >;\n\n    content.onChange = (callback) => {\n      // Re-fire whenever content reloads (locale change → new cache entry).\n      client.subscribe((newLocale) => {\n        const newKey = `${String(key)}.${newLocale}`;\n        const newLoader = (\n          dictionaryLoaders as Record<string, () => Promise<T>>\n        )[newLocale];\n\n        if (!newLoader) return;\n\n        loadDictionary(newKey, newLoader).then(() => {\n          const dict = cache.get(newKey);\n          if (dict) {\n            callback(getDictionary(dict, newLocale as A) as any);\n          }\n        });\n      });\n\n      return content;\n    };\n\n    return content;\n  }\n\n  // --- Cache miss: kick off background load, then notify to re-render ---\n  if (loader) {\n    loadDictionary(cacheKey, loader).then(() => {\n      client.notify();\n    });\n  }\n\n  return recursiveProxy;\n};\n"],"mappings":"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"}
+{"version":3,"file":"useDictionaryDynamic.cjs","names":["getIntlayerClient","isQualifiedDynamicLoaderMap","parseDictionarySelector","resolveDictionaryArgument","getDictionarySelectorCacheKey","resolveQualifiedDynamicContentAsync","getDictionary","resolveInterpreterLocale","getPreloadedDictionary"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["import {\n  getDictionarySelectorCacheKey,\n  getPreloadedDictionary,\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport { resolveInterpreterLocale } from '@intlayer/core/interpreter';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { getIntlayerClient } from './installIntlayer';\nimport type { WithOnChange } from './useDictionary';\n\n/** Simple in-memory cache shared across all calls in the same page. */\nconst cache = new Map<string, Dictionary>();\n\n/** Tracks in-flight loads to avoid duplicate fetches. */\nconst inflight = new Map<string, Promise<void>>();\n\n/** Resolved-content cache for qualified (collection/variant/meta) keys. */\nconst qualifiedCache = new Map<string, unknown>();\nconst qualifiedInflight = new Map<string, Promise<void>>();\n\nconst loadDictionary = <T extends Dictionary>(\n  cacheKey: string,\n  loader: () => Promise<T>\n): Promise<void> => {\n  if (cache.has(cacheKey)) return Promise.resolve();\n  if (inflight.has(cacheKey)) return inflight.get(cacheKey)!;\n\n  const promise = loader().then((dictionary) => {\n    cache.set(cacheKey, dictionary);\n    inflight.delete(cacheKey);\n  });\n\n  inflight.set(cacheKey, promise);\n  return promise;\n};\n\n/** Placeholder proxy — safe for any property access while loading. */\nconst recursiveProxy: any = new Proxy(() => {}, {\n  get: (_t, prop) => {\n    if (prop === Symbol.toPrimitive) return () => '';\n    if (prop === 'toString') return () => '';\n    if (prop === 'valueOf') return () => '';\n    if (prop === 'then') return undefined; // not a Promise\n    if (prop === 'onChange') return (_cb: any) => recursiveProxy;\n    return recursiveProxy;\n  },\n  apply: () => recursiveProxy,\n});\n\n/**\n * Dynamically load and transform a dictionary (plain or qualified).\n *\n * For a qualified loader map (collection / variant, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded. The first call returns a placeholder\n * and triggers a background load; the client then notifies subscribers so the\n * render runs again with real content.\n *\n * @param dictionaryLoaders - Locale-keyed loader map, or a qualified loader map.\n * @param key               - Dictionary key (used for cache namespacing).\n * @param localeOrSelector  - Optional locale or selector.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = DeclaredLocales,\n>(\n  dictionaryLoaders:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n): WithOnChange<DeepTransformContent<T['content']>> => {\n  const client = getIntlayerClient();\n\n  // --- Qualified loader map (collection / variant) ---\n  if (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryLoaders)\n  ) {\n    const loaderMap = dictionaryLoaders;\n    // Layers the client's ambient variant under the call-site argument before\n    // the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: client.locale,\n          contextVariant: client.variant,\n          dictionaryKey: String(key),\n        })\n      );\n    const selectorId = getDictionarySelectorCacheKey(selector);\n\n    const buildKey = (locale: string) =>\n      `${String(key)}.${locale}.${selectorId}`;\n    const resolveContent = (locale: LocalesValues) =>\n      resolveQualifiedDynamicContentAsync({\n        loaderMap,\n        key: String(key),\n        locale,\n        selector,\n        transform: (dictionary) =>\n          getDictionary(dictionary, locale as DeclaredLocales),\n      });\n\n    const currentLocale = (selectorLocale ??\n      client.locale ??\n      resolveInterpreterLocale()) as LocalesValues;\n    const cacheKey = buildKey(currentLocale);\n\n    const attachOnChange = (content: any) => {\n      if (content != null && typeof content === 'object') {\n        content.onChange = (callback: (c: any) => void) => {\n          client.subscribe((newLocale) => {\n            const locale = (selectorLocale ?? newLocale) as LocalesValues;\n            const newKey = buildKey(locale);\n\n            if (qualifiedCache.has(newKey)) {\n              callback(qualifiedCache.get(newKey));\n              return;\n            }\n\n            resolveContent(locale).then((resolved) => {\n              qualifiedCache.set(newKey, resolved);\n              callback(resolved);\n            });\n          });\n          return content;\n        };\n      }\n      return content;\n    };\n\n    if (qualifiedCache.has(cacheKey)) {\n      return attachOnChange(qualifiedCache.get(cacheKey)) as any;\n    }\n\n    if (!qualifiedInflight.has(cacheKey)) {\n      const promise = resolveContent(currentLocale).then((resolved) => {\n        qualifiedCache.set(cacheKey, resolved);\n        qualifiedInflight.delete(cacheKey);\n        client.notify();\n      });\n      qualifiedInflight.set(cacheKey, promise);\n    }\n\n    return recursiveProxy;\n  }\n\n  // --- Plain locale-keyed loader map ---\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n  const currentLocale = (locale ??\n    client.locale ??\n    resolveInterpreterLocale()) as A;\n\n  const cacheKey = `${String(key)}.${currentLocale}`;\n  const loader = (dictionaryLoaders as Record<string, () => Promise<T>>)[\n    currentLocale as string\n  ];\n\n  // A build-tool plugin may have started this locale's chunk while the entry\n  // point evaluated, and it may already have landed. Seeding the cache with it turns the first call into a\n  // cache hit, so the branch below returns real content instead of the\n  // placeholder proxy — no extra code path needed.\n  if (!cache.has(cacheKey)) {\n    const preloadedDictionary = getPreloadedDictionary(\n      dictionaryLoaders,\n      currentLocale as LocalesValues\n    );\n\n    if (preloadedDictionary) cache.set(cacheKey, preloadedDictionary);\n  }\n\n  // --- Cache hit: return real content synchronously ---\n  const cached = cache.get(cacheKey);\n  if (cached) {\n    const content = getDictionary(cached, currentLocale) as WithOnChange<\n      DeepTransformContent<T['content']>\n    >;\n\n    content.onChange = (callback) => {\n      // Re-fire whenever content reloads (locale change → new cache entry).\n      client.subscribe((newLocale) => {\n        const newKey = `${String(key)}.${newLocale}`;\n        const newLoader = (\n          dictionaryLoaders as Record<string, () => Promise<T>>\n        )[newLocale];\n\n        if (!newLoader) return;\n\n        loadDictionary(newKey, newLoader).then(() => {\n          const dict = cache.get(newKey);\n          if (dict) {\n            callback(getDictionary(dict, newLocale as A) as any);\n          }\n        });\n      });\n\n      return content;\n    };\n\n    return content;\n  }\n\n  // --- Cache miss: kick off background load, then notify to re-render ---\n  if (loader) {\n    loadDictionary(cacheKey, loader).then(() => {\n      client.notify();\n    });\n  }\n\n  return recursiveProxy;\n};\n"],"mappings":"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"}

package/dist/cjs/plugins.cjs

@@ -207,15 +207,16 @@ const pluginsCache = /* @__PURE__ */ new Map();
 * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.
 */
 const getPlugins = (locale, fallback = true) => {
-	const cacheKey = `${locale ?? _intlayer_config_built.internationalization.defaultLocale}_${fallback}`;
+	const currentLocale = (0, _intlayer_core_interpreter.resolveInterpreterLocale)(locale);
+	const cacheKey = `${currentLocale}_${fallback}`;
 	if (pluginsCache.has(cacheKey)) return pluginsCache.get(cacheKey);
 	const enabledPlugins = [
 		intlayerNodePlugins,
-		(0, _intlayer_core_interpreter.translationPlugin)(locale ?? _intlayer_config_built.internationalization.defaultLocale, fallback ? _intlayer_config_built.internationalization.defaultLocale : void 0),
+		(0, _intlayer_core_interpreter.translationPlugin)(currentLocale, fallback ? _intlayer_config_built.internationalization.defaultLocale : void 0),
 		_intlayer_core_interpreter.enumerationPlugin,
-		(0, _intlayer_core_interpreter.pluralPlugin)(locale ?? _intlayer_config_built.internationalization.defaultLocale),
+		(0, _intlayer_core_interpreter.pluralPlugin)(currentLocale),
 		_intlayer_core_interpreter.conditionPlugin,
-		(0, _intlayer_core_interpreter.nestedPlugin)(locale ?? _intlayer_config_built.internationalization.defaultLocale),
+		(0, _intlayer_core_interpreter.nestedPlugin)(currentLocale),
 		_intlayer_core_interpreter.filePlugin,
 		_intlayer_core_interpreter.genderPlugin,
 		_intlayer_core_interpreter.selectPlugin,

package/dist/cjs/plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.cjs","names":["editor","renderIntlayerNode","fallbackPlugin","NodeTypes","isInterpolableWrapperNode","transformInterpolableNode","splitInsertionTemplate","resolveInsertedSelector","getMarkdownMetadata","compileWithOptions","getHTML","internationalization","translationPlugin","enumerationPlugin","pluralPlugin","conditionPlugin","nestedPlugin","filePlugin","genderPlugin","selectPlugin"],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  getHTML,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  isInterpolableWrapperNode,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  resolveInsertedSelector,\n  selectPlugin,\n  splitInsertionTemplate,\n  transformInterpolableNode,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport {\n  compileWithOptions,\n  getMarkdownMetadata,\n} from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { HTMLComponents } from './html/types';\nimport {\n  type IntlayerNode as IntlayerNodeCore,\n  renderIntlayerNode,\n} from './renderIntlayerNode';\n\n/** ---------------------------------------------\n * INTLAYER NODE PLUGIN\n * --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport type IntlayerNode<T, P = {}> = IntlayerNodeCore<T> & P;\n\nconst escapeHtmlAttr = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n\nconst escapeHtmlText = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, keyPath, dictionaryKey }) => {\n    if (process.env.INTLAYER_EDITOR_ENABLED !== 'false' && editor.enabled) {\n      const rawStr = String(children ?? '');\n      const keyPathJson = JSON.stringify(keyPath ?? []);\n      const dictKey = String(dictionaryKey ?? '');\n\n      /**\n       * In editor mode, string coercion returns the wrapper HTML so that\n       * `element.innerHTML = content.title` automatically inserts the\n       * `<intlayer-content-selector-wrapper>` into the DOM.\n       */\n      const htmlStr = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(rawStr)}</intlayer-content-selector-wrapper>`;\n\n      return renderIntlayerNode({\n        value: children as string,\n        children: htmlStr,\n        keyPath,\n        dictionaryKey,\n        additionalProps: {\n          toElement: (): HTMLElement => {\n            const wrapper = document.createElement(\n              'intlayer-content-selector-wrapper'\n            );\n            wrapper.setAttribute('key-path', keyPathJson);\n            wrapper.setAttribute('dictionary-key', dictKey);\n            wrapper.textContent = rawStr;\n            return wrapper;\n          },\n        },\n      });\n    }\n\n    return renderIntlayerNode({\n      value: children as string,\n      children,\n    });\n  },\n};\n\n/** ---------------------------------------------\n * INSERTION PLUGIN\n * --------------------------------------------- */\n\nexport type InsertionCond<T, _S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly (infer F)[];\n}\n  ? <V extends { [K in Extract<F, string>]: string | number }>(\n      values: V\n    ) => I extends string ? IntlayerNode<string> : DeepTransformContent<I, L>\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.INSERTION },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) =>\n              typeof node === 'string' || isInterpolableWrapperNode(node),\n            transform: (node, subProps, deepTransformNode) => {\n              // `html()`/`markdown()` nodes carry their `{{ … }}` placeholders\n              // inside a raw string. Interpolate into that string, then re-run\n              // the transform so the html/markdown renderer applies afterwards.\n              if (isInterpolableWrapperNode(node)) {\n                return (\n                  values: {\n                    [K in InsertionContent['fields'][number]]: string | number;\n                  }\n                ) =>\n                  transformInterpolableNode(\n                    node,\n                    values,\n                    subProps,\n                    props.plugins,\n                    deepTransformNode\n                  );\n              }\n\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: (props.plugins ?? ([] as Plugins[])).filter(\n                  (plugin) => plugin.id !== 'intlayer-node-plugin'\n                ),\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const result = splitInsertionTemplate(\n                  transformedResult,\n                  values\n                );\n                const resultStr = result.isSimple\n                  ? (result.parts as string)\n                  : (result.parts as string[]).join('');\n\n                return deepTransformNode(resultStr, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: resultStr,\n                });\n              };\n            },\n          };\n\n          const transformed = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          return resolveInsertedSelector(children, transformed);\n        },\n      };\n\n/** ---------------------------------------------\n * MARKDOWN PLUGIN\n * --------------------------------------------- */\n\nconst vanillaRuntime = {\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const attrs = Object.entries(props || {})\n      .filter(\n        ([key]) => key !== 'children' && key !== 'key' && key !== '_innerHTML'\n      )\n      .map(([key, value]) => `${key}=\"${value}\"`)\n      .join(' ');\n    const innerHTML = props?._innerHTML;\n    const childrenStr =\n      innerHTML !== undefined ? innerHTML : children.flat(Infinity).join('');\n    return `<${tag}${attrs ? ` ${attrs}` : ''}>${childrenStr}</${tag}>`;\n  },\n  normalizeProps: (_tag: string, props: Record<string, any>) => {\n    const normalized: Record<string, any> = {};\n    for (const [key, value] of Object.entries(props)) {\n      if (key === 'className') {\n        normalized.class = value;\n      } else if (key === 'htmlFor') {\n        normalized.for = value;\n      } else if (key === 'dangerouslySetInnerHTML' && (value as any)?.__html) {\n        normalized._innerHTML = (value as any).__html;\n      } else {\n        normalized[key] = value;\n      }\n    }\n    return normalized;\n  },\n};\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        /** Returns the rendered markdown; render with .use(). */\n        use: (components?: HTMLComponents<'permissive', {}>) => string;\n      }\n    >\n  : never;\n\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const { plugins: _plugins, ...rest } = props;\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, subProps) =>\n              renderIntlayerNode({\n                ...subProps,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const compile = (components: any = {}) =>\n            compileWithOptions(\n              node,\n              {\n                ...vanillaRuntime,\n                createElement: (tag: any, props: any, ...children: any[]) => {\n                  const override = components[tag];\n                  if (typeof override === 'function') {\n                    return override({ ...props, children: children.join('') });\n                  }\n                  return vanillaRuntime.createElement(tag, props, ...children);\n                },\n              },\n              {}\n            ) as any;\n\n          const value = compile();\n          let children = node;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              metadata: metadataNodes,\n              use: (components?: any) => compile(components),\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  metadata?: infer U;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<M>;\n      metadata: DeepTransformContent<U>;\n    }\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.MARKDOWN },\n          ];\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * HTML PLUGIN\n * --------------------------------------------- */\n\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<I>;\n    }\n  : never;\n\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n        transform: (node: HTMLContent<string>, props) => {\n          const htmlStr = node[NodeTypes.HTML];\n\n          const use = (components: Record<string, any> = {}) => {\n            const wrappedComponents = new Proxy(components, {\n              get(target, prop) {\n                if (typeof prop === 'string' && prop in target) {\n                  const Component = target[prop];\n                  return (props: any) => {\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return Component({ ...props, children });\n                  };\n                }\n                if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n                  return (props: any) => {\n                    const attrs = Object.entries(props)\n                      .filter(([key]) => key !== 'children' && key !== 'key')\n                      .map(([key, value]) => `${key}=\"${value}\"`)\n                      .join(' ');\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return `<${prop}${attrs ? ` ${attrs}` : ''}>${children}</${prop}>`;\n                  };\n                }\n                return undefined;\n              },\n            });\n\n            const result = getHTML(htmlStr, wrappedComponents as any);\n            return Array.isArray(result) ? result.join('') : result;\n          };\n\n          const value = use();\n          let children = htmlStr;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              use: (components?: any) => use(components),\n            },\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * PLUGINS RESULT\n * --------------------------------------------- */\n\nexport interface IInterpreterPluginVanilla<T, S, L extends LocalesValues> {\n  vanillaIntlayerNode: IntlayerNodeCond<T>;\n  vanillaInsertion: InsertionCond<T, S, L>;\n  vanillaMarkdown: MarkdownCond<T>;\n  vanillaHtml: HTMLPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the `vanilla-intlayer` plugins will override the types of `intlayer` functions.\n * Use `getIntlayer` from `vanilla-intlayer` (not from `intlayer`) to get properly typed\n * `IntlayerNode` wrappers with `.value` access on string/number content.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion'\n> & {\n  vanillaIntlayerNode: true;\n  vanillaInsertion: true;\n  vanillaMarkdown: true;\n  vanillaHtml: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Vanilla content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // First: most nodes are plain strings, which every other plugin rejects\n    intlayerNodePlugins,\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n    filePlugin,\n    genderPlugin,\n    selectPlugin,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  // Plugins disabled at build time never match: skip them on every node\n  const enabledPlugins = plugins.filter((plugin) => plugin !== fallbackPlugin);\n\n  pluginsCache.set(cacheKey, enabledPlugins);\n\n  return enabledPlugins;\n};\n"],"mappings":"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"}
+{"version":3,"file":"plugins.cjs","names":["editor","renderIntlayerNode","fallbackPlugin","NodeTypes","isInterpolableWrapperNode","transformInterpolableNode","splitInsertionTemplate","resolveInsertedSelector","getMarkdownMetadata","compileWithOptions","getHTML","resolveInterpreterLocale","translationPlugin","internationalization","enumerationPlugin","pluralPlugin","conditionPlugin","nestedPlugin","filePlugin","genderPlugin","selectPlugin"],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  getHTML,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  isInterpolableWrapperNode,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  resolveInsertedSelector,\n  resolveInterpreterLocale,\n  selectPlugin,\n  splitInsertionTemplate,\n  transformInterpolableNode,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport {\n  compileWithOptions,\n  getMarkdownMetadata,\n} from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { HTMLComponents } from './html/types';\nimport {\n  type IntlayerNode as IntlayerNodeCore,\n  renderIntlayerNode,\n} from './renderIntlayerNode';\n\n/** ---------------------------------------------\n * INTLAYER NODE PLUGIN\n * --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport type IntlayerNode<T, P = {}> = IntlayerNodeCore<T> & P;\n\nconst escapeHtmlAttr = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n\nconst escapeHtmlText = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, keyPath, dictionaryKey }) => {\n    if (process.env.INTLAYER_EDITOR_ENABLED !== 'false' && editor.enabled) {\n      const rawStr = String(children ?? '');\n      const keyPathJson = JSON.stringify(keyPath ?? []);\n      const dictKey = String(dictionaryKey ?? '');\n\n      /**\n       * In editor mode, string coercion returns the wrapper HTML so that\n       * `element.innerHTML = content.title` automatically inserts the\n       * `<intlayer-content-selector-wrapper>` into the DOM.\n       */\n      const htmlStr = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(rawStr)}</intlayer-content-selector-wrapper>`;\n\n      return renderIntlayerNode({\n        value: children as string,\n        children: htmlStr,\n        keyPath,\n        dictionaryKey,\n        additionalProps: {\n          toElement: (): HTMLElement => {\n            const wrapper = document.createElement(\n              'intlayer-content-selector-wrapper'\n            );\n            wrapper.setAttribute('key-path', keyPathJson);\n            wrapper.setAttribute('dictionary-key', dictKey);\n            wrapper.textContent = rawStr;\n            return wrapper;\n          },\n        },\n      });\n    }\n\n    return renderIntlayerNode({\n      value: children as string,\n      children,\n    });\n  },\n};\n\n/** ---------------------------------------------\n * INSERTION PLUGIN\n * --------------------------------------------- */\n\nexport type InsertionCond<T, _S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly (infer F)[];\n}\n  ? <V extends { [K in Extract<F, string>]: string | number }>(\n      values: V\n    ) => I extends string ? IntlayerNode<string> : DeepTransformContent<I, L>\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.INSERTION },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) =>\n              typeof node === 'string' || isInterpolableWrapperNode(node),\n            transform: (node, subProps, deepTransformNode) => {\n              // `html()`/`markdown()` nodes carry their `{{ … }}` placeholders\n              // inside a raw string. Interpolate into that string, then re-run\n              // the transform so the html/markdown renderer applies afterwards.\n              if (isInterpolableWrapperNode(node)) {\n                return (\n                  values: {\n                    [K in InsertionContent['fields'][number]]: string | number;\n                  }\n                ) =>\n                  transformInterpolableNode(\n                    node,\n                    values,\n                    subProps,\n                    props.plugins,\n                    deepTransformNode\n                  );\n              }\n\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: (props.plugins ?? ([] as Plugins[])).filter(\n                  (plugin) => plugin.id !== 'intlayer-node-plugin'\n                ),\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const result = splitInsertionTemplate(\n                  transformedResult,\n                  values\n                );\n                const resultStr = result.isSimple\n                  ? (result.parts as string)\n                  : (result.parts as string[]).join('');\n\n                return deepTransformNode(resultStr, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: resultStr,\n                });\n              };\n            },\n          };\n\n          const transformed = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          return resolveInsertedSelector(children, transformed);\n        },\n      };\n\n/** ---------------------------------------------\n * MARKDOWN PLUGIN\n * --------------------------------------------- */\n\nconst vanillaRuntime = {\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const attrs = Object.entries(props || {})\n      .filter(\n        ([key]) => key !== 'children' && key !== 'key' && key !== '_innerHTML'\n      )\n      .map(([key, value]) => `${key}=\"${value}\"`)\n      .join(' ');\n    const innerHTML = props?._innerHTML;\n    const childrenStr =\n      innerHTML !== undefined ? innerHTML : children.flat(Infinity).join('');\n    return `<${tag}${attrs ? ` ${attrs}` : ''}>${childrenStr}</${tag}>`;\n  },\n  normalizeProps: (_tag: string, props: Record<string, any>) => {\n    const normalized: Record<string, any> = {};\n    for (const [key, value] of Object.entries(props)) {\n      if (key === 'className') {\n        normalized.class = value;\n      } else if (key === 'htmlFor') {\n        normalized.for = value;\n      } else if (key === 'dangerouslySetInnerHTML' && (value as any)?.__html) {\n        normalized._innerHTML = (value as any).__html;\n      } else {\n        normalized[key] = value;\n      }\n    }\n    return normalized;\n  },\n};\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        /** Returns the rendered markdown; render with .use(). */\n        use: (components?: HTMLComponents<'permissive', {}>) => string;\n      }\n    >\n  : never;\n\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const { plugins: _plugins, ...rest } = props;\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, subProps) =>\n              renderIntlayerNode({\n                ...subProps,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const compile = (components: any = {}) =>\n            compileWithOptions(\n              node,\n              {\n                ...vanillaRuntime,\n                createElement: (tag: any, props: any, ...children: any[]) => {\n                  const override = components[tag];\n                  if (typeof override === 'function') {\n                    return override({ ...props, children: children.join('') });\n                  }\n                  return vanillaRuntime.createElement(tag, props, ...children);\n                },\n              },\n              {}\n            ) as any;\n\n          const value = compile();\n          let children = node;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              metadata: metadataNodes,\n              use: (components?: any) => compile(components),\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  metadata?: infer U;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<M>;\n      metadata: DeepTransformContent<U>;\n    }\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.MARKDOWN },\n          ];\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * HTML PLUGIN\n * --------------------------------------------- */\n\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<I>;\n    }\n  : never;\n\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n        transform: (node: HTMLContent<string>, props) => {\n          const htmlStr = node[NodeTypes.HTML];\n\n          const use = (components: Record<string, any> = {}) => {\n            const wrappedComponents = new Proxy(components, {\n              get(target, prop) {\n                if (typeof prop === 'string' && prop in target) {\n                  const Component = target[prop];\n                  return (props: any) => {\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return Component({ ...props, children });\n                  };\n                }\n                if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n                  return (props: any) => {\n                    const attrs = Object.entries(props)\n                      .filter(([key]) => key !== 'children' && key !== 'key')\n                      .map(([key, value]) => `${key}=\"${value}\"`)\n                      .join(' ');\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return `<${prop}${attrs ? ` ${attrs}` : ''}>${children}</${prop}>`;\n                  };\n                }\n                return undefined;\n              },\n            });\n\n            const result = getHTML(htmlStr, wrappedComponents as any);\n            return Array.isArray(result) ? result.join('') : result;\n          };\n\n          const value = use();\n          let children = htmlStr;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              use: (components?: any) => use(components),\n            },\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * PLUGINS RESULT\n * --------------------------------------------- */\n\nexport interface IInterpreterPluginVanilla<T, S, L extends LocalesValues> {\n  vanillaIntlayerNode: IntlayerNodeCond<T>;\n  vanillaInsertion: InsertionCond<T, S, L>;\n  vanillaMarkdown: MarkdownCond<T>;\n  vanillaHtml: HTMLPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the `vanilla-intlayer` plugins will override the types of `intlayer` functions.\n * Use `getIntlayer` from `vanilla-intlayer` (not from `intlayer`) to get properly typed\n * `IntlayerNode` wrappers with `.value` access on string/number content.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion'\n> & {\n  vanillaIntlayerNode: true;\n  vanillaInsertion: true;\n  vanillaMarkdown: true;\n  vanillaHtml: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Vanilla content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback = true\n): Plugins[] => {\n  const currentLocale = resolveInterpreterLocale(locale);\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // First: most nodes are plain strings, which every other plugin rejects\n    intlayerNodePlugins,\n    translationPlugin(\n      currentLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(currentLocale),\n    conditionPlugin,\n    nestedPlugin(currentLocale),\n    filePlugin,\n    genderPlugin,\n    selectPlugin,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  // Plugins disabled at build time never match: skip them on every node\n  const enabledPlugins = plugins.filter((plugin) => plugin !== fallbackPlugin);\n\n  pluginsCache.set(cacheKey, enabledPlugins);\n\n  return enabledPlugins;\n};\n"],"mappings":";;;;;;;;;;AAqDA,MAAM,kBAAkB,QACtB,IAAI,QAAQ,MAAM,OAAO,CAAC,CAAC,QAAQ,MAAM,QAAQ;AAEnD,MAAM,kBAAkB,QACtB,IAAI,QAAQ,MAAM,OAAO,CAAC,CAAC,QAAQ,MAAM,MAAM,CAAC,CAAC,QAAQ,MAAM,MAAM;AAEvE,MAAa,sBAA+B;CAC1C,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS;CAClB,YAAY,OAAO,EAAE,UAAU,SAAS,oBAAoB;EAC1D,IAAI,QAAQ,IAAI,4BAA4B,WAAWA,8BAAO,SAAS;GACrE,MAAM,SAAS,OAAO,YAAY,EAAE;GACpC,MAAM,cAAc,KAAK,UAAU,WAAW,CAAC,CAAC;GAChD,MAAM,UAAU,OAAO,iBAAiB,EAAE;;;;;;GAO1C,MAAM,UAAU,gDAAgD,eAAe,WAAW,EAAE,oBAAoB,eAAe,OAAO,EAAE,IAAI,eAAe,MAAM,EAAE;GAEnK,OAAOC,8CAAmB;IACxB,OAAO;IACP,UAAU;IACV;IACA;IACA,iBAAiB,EACf,iBAA8B;KAC5B,MAAM,UAAU,SAAS,cACvB,mCACF;KACA,QAAQ,aAAa,YAAY,WAAW;KAC5C,QAAQ,aAAa,kBAAkB,OAAO;KAC9C,QAAQ,cAAc;KACtB,OAAO;IACT,EACF;GACF,CAAC;EACH;EAEA,OAAOA,8CAAmB;GACxB,OAAO;GACP;EACF,CAAC;CACH;AACF;AAgBA,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzCC,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaC,yBAAU;CAC3D,YAAY,MAAwB,OAAO,sBAAsB;EAC/D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EAAE,MAAMA,yBAAU,UAAU,CAC9B;EAEA,MAAM,WAAW,KAAKA,yBAAU;EAEhC,MAAM,wBAAiC;GACrC,IAAI;GACJ,YAAY,SACV,OAAO,SAAS,gBAAYC,sDAA0B,IAAI;GAC5D,YAAY,MAAM,UAAU,sBAAsB;IAIhD,QAAIA,sDAA0B,IAAI,GAChC,QACE,eAIAC,sDACE,MACA,QACA,UACA,MAAM,SACN,iBACF;IAGJ,MAAM,oBAAoB,kBAAkB,MAAM;KAChD,GAAG;KACH,UAAU;KACV,UAAU,MAAM,WAAY,CAAC,EAAe,CAAE,QAC3C,WAAW,OAAO,OAAO,sBAC5B;IACF,CAAC;IAED,QACE,WAGG;KACH,MAAM,aAASC,mDACb,mBACA,MACF;KACA,MAAM,YAAY,OAAO,WACpB,OAAO,QACP,OAAO,MAAmB,KAAK,EAAE;KAEtC,OAAO,kBAAkB,WAAW;MAClC,GAAG;MACH,SAAS,MAAM;MACf,UAAU;KACZ,CAAC;IACH;GACF;EACF;EAEA,MAAM,cAAc,kBAAkB,UAAU;GAC9C,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,uBAAuB,GAAI,MAAM,WAAW,CAAC,CAAE;EAC3D,CAAC;EAED,WAAOC,oDAAwB,UAAU,WAAW;CACtD;AACF;;;;AAMN,MAAM,iBAAiB;CACrB,gBAAgB,KAAa,OAAY,GAAG,aAAoB;EAC9D,MAAM,QAAQ,OAAO,QAAQ,SAAS,CAAC,CAAC,CAAC,CACtC,QACE,CAAC,SAAS,QAAQ,cAAc,QAAQ,SAAS,QAAQ,YAC5D,CAAC,CACA,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAC1C,KAAK,GAAG;EACX,MAAM,YAAY,OAAO;EACzB,MAAM,cACJ,cAAc,SAAY,YAAY,SAAS,KAAK,QAAQ,CAAC,CAAC,KAAK,EAAE;EACvE,OAAO,IAAI,MAAM,QAAQ,IAAI,UAAU,GAAG,GAAG,YAAY,IAAI,IAAI;CACnE;CACA,iBAAiB,MAAc,UAA+B;EAC5D,MAAM,aAAkC,CAAC;EACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,IAAI,QAAQ,aACV,WAAW,QAAQ;OACd,IAAI,QAAQ,WACjB,WAAW,MAAM;OACZ,IAAI,QAAQ,6BAA8B,OAAe,QAC9D,WAAW,aAAc,MAAc;OAEvC,WAAW,OAAO;EAGtB,OAAO;CACT;AACF;AAaA,MAAa,uBACX,QAAQ,IAAI,gCAAgC,UACxCL,4CACA;CACE,IAAI;CACJ,YAAY,SAAS,OAAO,SAAS;CACrC,YAAY,MAAc,OAAO,sBAAsB;EACrD,MAAM,EAAE,SAAS,UAAU,GAAG,SAAS;EAkBvC,MAAM,gBAAgB,sBAjBLM,6CAAoB,IAAI,KAAK,CAAC,GAiBG;GAChD,SAAS,CAAC;IAfV,IAAI;IACJ,YAAY,iBACV,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,aACxB,CAAC;IACH,YAAY,cAAc,aACxBP,8CAAmB;KACjB,GAAG;KACH,OAAO;KACP,UAAU;IACZ,CAAC;GAIqB,CAAC;GACzB,eAAe,KAAK;GACpB,SAAS,CAAC;EACZ,CAAC;EAED,MAAM,WAAW,aAAkB,CAAC,UAClCQ,4CACE,MACA;GACE,GAAG;GACH,gBAAgB,KAAU,OAAY,GAAG,aAAoB;IAC3D,MAAM,WAAW,WAAW;IAC5B,IAAI,OAAO,aAAa,YACtB,OAAO,SAAS;KAAE,GAAG;KAAO,UAAU,SAAS,KAAK,EAAE;IAAE,CAAC;IAE3D,OAAO,eAAe,cAAc,KAAK,OAAO,GAAG,QAAQ;GAC7D;EACF,GACA,CAAC,CACH;EAEF,MAAM,QAAQ,QAAQ;EACtB,IAAI,WAAW;EAEf,IACE,QAAQ,IAAI,4BAA4B,WACxCT,8BAAO,SACP;GACA,MAAM,cAAc,KAAK,UAAU,MAAM,WAAW,CAAC,CAAC;GACtD,MAAM,UAAU,OAAO,MAAM,iBAAiB,EAAE;GAChD,WAAW,gDAAgD,eAAe,WAAW,EAAE,oBAAoB,eAAe,OAAO,EAAE,IAAI,eAAe,KAAK,EAAE;EAC/J;EAEA,OAAOC,8CAAmB;GACxB,GAAG;GACH;GACA;GACA,iBAAiB;IACf,UAAU;IACV,MAAM,eAAqB,QAAQ,UAAU;GAC/C;EACF,CAAC;CACH;AACF;AAcN,MAAa,iBACX,QAAQ,IAAI,gCAAgC,UACxCC,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaC,yBAAU;CAC3D,YAAY,MAAuB,OAAO,sBAAsB;EAC9D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EAAE,MAAMA,yBAAU,SAAS,CAC7B;EACA,MAAM,WAAW,KAAKA,yBAAU;EAEhC,OAAO,kBAAkB,UAAU;GACjC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,sBAAsB,GAAI,MAAM,WAAW,CAAC,CAAE;EAC1D,CAAC;CACH;AACF;AAgBN,MAAa,aACX,QAAQ,IAAI,4BAA4B,UACpCD,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaC,yBAAU;CAC3D,YAAY,MAA2B,UAAU;EAC/C,MAAM,UAAU,KAAKA,yBAAU;EAE/B,MAAM,OAAO,aAAkC,CAAC,MAAM;GACpD,MAAM,oBAAoB,IAAI,MAAM,YAAY,EAC9C,IAAI,QAAQ,MAAM;IAChB,IAAI,OAAO,SAAS,YAAY,QAAQ,QAAQ;KAC9C,MAAM,YAAY,OAAO;KACzB,QAAQ,UAAe;MACrB,MAAM,WAAW,MAAM,QAAQ,MAAM,QAAQ,IACzC,MAAM,SAAS,KAAK,EAAE,IACtB,MAAM;MACV,OAAO,UAAU;OAAE,GAAG;OAAO;MAAS,CAAC;KACzC;IACF;IACA,IAAI,OAAO,SAAS,YAAY,mBAAmB,KAAK,IAAI,GAC1D,QAAQ,UAAe;KACrB,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,QAAQ,CAAC,SAAS,QAAQ,cAAc,QAAQ,KAAK,CAAC,CACtD,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAC1C,KAAK,GAAG;KACX,MAAM,WAAW,MAAM,QAAQ,MAAM,QAAQ,IACzC,MAAM,SAAS,KAAK,EAAE,IACtB,MAAM;KACV,OAAO,IAAI,OAAO,QAAQ,IAAI,UAAU,GAAG,GAAG,SAAS,IAAI,KAAK;IAClE;GAGJ,EACF,CAAC;GAED,MAAM,aAASO,oCAAQ,SAAS,iBAAwB;GACxD,OAAO,MAAM,QAAQ,MAAM,IAAI,OAAO,KAAK,EAAE,IAAI;EACnD;EAEA,MAAM,QAAQ,IAAI;EAClB,IAAI,WAAW;EAEf,IACE,QAAQ,IAAI,4BAA4B,WACxCV,8BAAO,SACP;GACA,MAAM,cAAc,KAAK,UAAU,MAAM,WAAW,CAAC,CAAC;GACtD,MAAM,UAAU,OAAO,MAAM,iBAAiB,EAAE;GAChD,WAAW,gDAAgD,eAAe,WAAW,EAAE,oBAAoB,eAAe,OAAO,EAAE,IAAI,eAAe,KAAK,EAAE;EAC/J;EAEA,OAAOC,8CAAmB;GACxB,GAAG;GACH;GACA;GACA,iBAAiB,EACf,MAAM,eAAqB,IAAI,UAAU,EAC3C;EACF,CAAC;CACH;AACF;AAmCN,MAAM,+BAAe,IAAI,IAAuB;;;;;AAMhD,MAAa,cACX,QACA,WAAW,SACG;CACd,MAAM,oBAAgBU,qDAAyB,MAAM;CACrD,MAAM,WAAW,GAAG,cAAc,GAAG;CAErC,IAAI,aAAa,IAAI,QAAQ,GAC3B,OAAO,aAAa,IAAI,QAAQ;CAuBlC,MAAM,iBAAiB;EAlBrB;MACAC,8CACE,eACA,WAAWC,4CAAqB,gBAAgB,MAClD;EACAC;MACAC,yCAAa,aAAa;EAC1BC;MACAC,yCAAa,aAAa;EAC1BC;EACAC;EACAC;EACA;EACA;EACA;CAI2B,CAAC,CAAC,QAAQ,WAAW,WAAWlB,yCAAc;CAE3E,aAAa,IAAI,UAAU,cAAc;CAEzC,OAAO;AACT"}

package/dist/cjs/renderIntlayerNode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderIntlayerNode.cjs","names":["getIntlayerNodePrototype"],"sources":["../../src/renderIntlayerNode.ts"],"sourcesContent":["import { getIntlayerNodePrototype } from '@intlayer/core/utils';\nimport type { ResolvedEditor } from '@intlayer/types/module_augmentation';\n\nexport type IntlayerNode<T = string> = ResolvedEditor<\n  T & {\n    raw: T;\n    value: T;\n    toString: () => string;\n    valueOf: () => T;\n    toJSON: () => T;\n    __update: (next: IntlayerNode<T>) => void;\n  },\n  {\n    raw: T;\n    value: T;\n    toString: () => string;\n    valueOf: () => T;\n    toJSON: () => T;\n    __update: (next: IntlayerNode<T>) => void;\n  }\n> &\n  T;\n\nexport const renderIntlayerNode = <\n  T, // Broadened to support arrays, numbers, objects, etc.\n>({\n  value,\n  children,\n  additionalProps = {},\n}: {\n  value: T;\n  children?: any;\n  additionalProps?: Record<string, unknown>;\n  [key: string]: unknown;\n}): IntlayerNode<T> => {\n  let _value = value;\n\n  // When children is a string that differs from value, it acts as a display\n  // override (e.g. editor HTML wrapper). Otherwise toString/toPrimitive reflect\n  // the live _value so that __update propagates.\n  const displayOverride =\n    typeof children === 'string' && children !== String(value ?? '')\n      ? children\n      : null;\n\n  const node = {\n    // Serves the value's members: `node.toUpperCase()`, `'trim' in node`\n    __proto__: getIntlayerNodePrototype(value),\n\n    toString: () => displayOverride ?? String(_value ?? ''),\n    valueOf: () => _value,\n    [Symbol.toPrimitive]: () => displayOverride ?? _value,\n    toJSON: () => _value,\n\n    get raw() {\n      return _value;\n    },\n    set raw(value: T) {\n      _value = value;\n    },\n\n    get value() {\n      return _value;\n    },\n\n    __update(next: any) {\n      _value = next?.raw ?? next?.value ?? next;\n    },\n\n    ...additionalProps,\n  };\n\n  return node as unknown as IntlayerNode<T>;\n};\n"],"mappings":";;;;AAuBA,MAAa,sBAEX,EACA,OACA,UACA,kBAAkB,CAAC,QAME;CACrB,IAAI,SAAS;CAKb,MAAM,kBACJ,OAAO,aAAa,YAAY,aAAa,OAAO,SAAS,EAAE,IAC3D,WACA;CA6BN,OAAO;EAzBL,eAAWA,+CAAyB,KAAK;EAEzC,gBAAgB,mBAAmB,OAAO,UAAU,EAAE;EACtD,eAAe;GACd,OAAO,oBAAoB,mBAAmB;EAC/C,cAAc;EAEd,IAAI,MAAM;GACR,OAAO;EACT;EACA,IAAI,IAAI,OAAU;GAChB,SAAS;EACX;EAEA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,SAAS,MAAW;GAClB,SAAS,MAAM,OAAO,MAAM,SAAS;EACvC;EAEA,GAAG;CAGK;AACZ"}
+{"version":3,"file":"renderIntlayerNode.cjs","names":["getIntlayerNodePrototype"],"sources":["../../src/renderIntlayerNode.ts"],"sourcesContent":["import { getIntlayerNodePrototype } from '@intlayer/core/utils';\nimport type { ResolvedEditor } from '@intlayer/types/module_augmentation';\n\ntype IntlayerNodeMembers<T> = {\n  raw: T;\n  value: T;\n  toString: () => string;\n  valueOf: () => T;\n  toJSON: () => T;\n  __update: (next: IntlayerNode<T>) => void;\n};\n\n/**\n * Content node returned by `useIntlayer`.\n *\n * Without the editor it is typed as its value plus the node members, so it\n * can be used wherever a string is expected. With the editor, string coercion returns the editor wrapper HTML,\n * so string usages must go through `.value`.\n */\nexport type IntlayerNode<T = string> = ResolvedEditor<\n  T & IntlayerNodeMembers<T>,\n  IntlayerNodeMembers<T>\n>;\n\nexport const renderIntlayerNode = <\n  T, // Broadened to support arrays, numbers, objects, etc.\n>({\n  value,\n  children,\n  additionalProps = {},\n}: {\n  value: T;\n  children?: any;\n  additionalProps?: Record<string, unknown>;\n  [key: string]: unknown;\n}): IntlayerNode<T> => {\n  let _value = value;\n\n  // When children is a string that differs from value, it acts as a display\n  // override (e.g. editor HTML wrapper). Otherwise toString/toPrimitive reflect\n  // the live _value so that __update propagates.\n  const displayOverride =\n    typeof children === 'string' && children !== String(value ?? '')\n      ? children\n      : null;\n\n  const node = {\n    // Serves the value's members: `node.toUpperCase()`, `'trim' in node`\n    __proto__: getIntlayerNodePrototype(value),\n\n    toString: () => displayOverride ?? String(_value ?? ''),\n    valueOf: () => _value,\n    [Symbol.toPrimitive]: () => displayOverride ?? _value,\n    toJSON: () => _value,\n\n    get raw() {\n      return _value;\n    },\n    set raw(value: T) {\n      _value = value;\n    },\n\n    get value() {\n      return _value;\n    },\n\n    __update(next: any) {\n      _value = next?.raw ?? next?.value ?? next;\n    },\n\n    ...additionalProps,\n  };\n\n  return node as unknown as IntlayerNode<T>;\n};\n"],"mappings":";;;;AAwBA,MAAa,sBAEX,EACA,OACA,UACA,kBAAkB,CAAC,QAME;CACrB,IAAI,SAAS;CAKb,MAAM,kBACJ,OAAO,aAAa,YAAY,aAAa,OAAO,SAAS,EAAE,IAC3D,WACA;CA6BN,OAAO;EAzBL,eAAWA,+CAAyB,KAAK;EAEzC,gBAAgB,mBAAmB,OAAO,UAAU,EAAE;EACtD,eAAe;GACd,OAAO,oBAAoB,mBAAmB;EAC/C,cAAc;EAEd,IAAI,MAAM;GACR,OAAO;EACT;EACA,IAAI,IAAI,OAAU;GAChB,SAAS;EACX;EAEA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,SAAS,MAAW;GAClB,SAAS,MAAM,OAAO,MAAM,SAAS;EACvC;EAEA,GAAG;CAGK;AACZ"}

package/dist/esm/client/useDictionaryDynamic.mjs

@@ -1,6 +1,6 @@
-import { getDictionary } from "../getDictionary.mjs";
+import { getDictionary as getDictionary$1 } from "../getDictionary.mjs";
 import { getIntlayerClient } from "./installIntlayer.mjs";
-import { internationalization } from "@intlayer/config/built";
+import { resolveInterpreterLocale } from "@intlayer/core/interpreter";
 import { getDictionarySelectorCacheKey, getPreloadedDictionary, isQualifiedDynamicLoaderMap, parseDictionarySelector, resolveDictionaryArgument, resolveQualifiedDynamicContentAsync } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useDictionaryDynamic.ts
@@ -48,7 +48,6 @@ const recursiveProxy = new Proxy(() => {}, {
 */
 const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 	const client = getIntlayerClient();
-	const defaultLocale = internationalization.defaultLocale;
 	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && isQualifiedDynamicLoaderMap(dictionaryLoaders)) {
 		const loaderMap = dictionaryLoaders;
 		const { locale: selectorLocale, selector } = parseDictionarySelector(resolveDictionaryArgument({
@@ -64,9 +63,9 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 			key: String(key),
 			locale,
 			selector,
-			transform: (dictionary) => getDictionary(dictionary, locale)
+			transform: (dictionary) => getDictionary$1(dictionary, locale)
 		});
-		const currentLocale = selectorLocale ?? client.locale ?? defaultLocale;
+		const currentLocale = selectorLocale ?? client.locale ?? resolveInterpreterLocale();
 		const cacheKey = buildKey(currentLocale);
 		const attachOnChange = (content) => {
 			if (content != null && typeof content === "object") content.onChange = (callback) => {
@@ -97,7 +96,7 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 		}
 		return recursiveProxy;
 	}
-	const currentLocale = (typeof localeOrSelector === "string" ? localeOrSelector : void 0) ?? client.locale ?? defaultLocale;
+	const currentLocale = (typeof localeOrSelector === "string" ? localeOrSelector : void 0) ?? client.locale ?? resolveInterpreterLocale();
 	const cacheKey = `${String(key)}.${currentLocale}`;
 	const loader = dictionaryLoaders[currentLocale];
 	if (!cache.has(cacheKey)) {
@@ -106,7 +105,7 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 	}
 	const cached = cache.get(cacheKey);
 	if (cached) {
-		const content = getDictionary(cached, currentLocale);
+		const content = getDictionary$1(cached, currentLocale);
 		content.onChange = (callback) => {
 			client.subscribe((newLocale) => {
 				const newKey = `${String(key)}.${newLocale}`;
@@ -114,7 +113,7 @@ const useDictionaryDynamic = (dictionaryLoaders, key, localeOrSelector) => {
 				if (!newLoader) return;
 				loadDictionary(newKey, newLoader).then(() => {
 					const dict = cache.get(newKey);
-					if (dict) callback(getDictionary(dict, newLocale));
+					if (dict) callback(getDictionary$1(dict, newLocale));
 				});
 			});
 			return content;

package/dist/esm/client/useDictionaryDynamic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.mjs","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport {\n  getDictionarySelectorCacheKey,\n  getPreloadedDictionary,\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { getIntlayerClient } from './installIntlayer';\nimport type { WithOnChange } from './useDictionary';\n\n/** Simple in-memory cache shared across all calls in the same page. */\nconst cache = new Map<string, Dictionary>();\n\n/** Tracks in-flight loads to avoid duplicate fetches. */\nconst inflight = new Map<string, Promise<void>>();\n\n/** Resolved-content cache for qualified (collection/variant/meta) keys. */\nconst qualifiedCache = new Map<string, unknown>();\nconst qualifiedInflight = new Map<string, Promise<void>>();\n\nconst loadDictionary = <T extends Dictionary>(\n  cacheKey: string,\n  loader: () => Promise<T>\n): Promise<void> => {\n  if (cache.has(cacheKey)) return Promise.resolve();\n  if (inflight.has(cacheKey)) return inflight.get(cacheKey)!;\n\n  const promise = loader().then((dictionary) => {\n    cache.set(cacheKey, dictionary);\n    inflight.delete(cacheKey);\n  });\n\n  inflight.set(cacheKey, promise);\n  return promise;\n};\n\n/** Placeholder proxy — safe for any property access while loading. */\nconst recursiveProxy: any = new Proxy(() => {}, {\n  get: (_t, prop) => {\n    if (prop === Symbol.toPrimitive) return () => '';\n    if (prop === 'toString') return () => '';\n    if (prop === 'valueOf') return () => '';\n    if (prop === 'then') return undefined; // not a Promise\n    if (prop === 'onChange') return (_cb: any) => recursiveProxy;\n    return recursiveProxy;\n  },\n  apply: () => recursiveProxy,\n});\n\n/**\n * Dynamically load and transform a dictionary (plain or qualified).\n *\n * For a qualified loader map (collection / variant, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded. The first call returns a placeholder\n * and triggers a background load; the client then notifies subscribers so the\n * render runs again with real content.\n *\n * @param dictionaryLoaders - Locale-keyed loader map, or a qualified loader map.\n * @param key               - Dictionary key (used for cache namespacing).\n * @param localeOrSelector  - Optional locale or selector.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = DeclaredLocales,\n>(\n  dictionaryLoaders:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n): WithOnChange<DeepTransformContent<T['content']>> => {\n  const client = getIntlayerClient();\n  const defaultLocale = internationalization.defaultLocale;\n\n  // --- Qualified loader map (collection / variant) ---\n  if (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryLoaders)\n  ) {\n    const loaderMap = dictionaryLoaders;\n    // Layers the client's ambient variant under the call-site argument before\n    // the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: client.locale,\n          contextVariant: client.variant,\n          dictionaryKey: String(key),\n        })\n      );\n    const selectorId = getDictionarySelectorCacheKey(selector);\n\n    const buildKey = (locale: string) =>\n      `${String(key)}.${locale}.${selectorId}`;\n    const resolveContent = (locale: LocalesValues) =>\n      resolveQualifiedDynamicContentAsync({\n        loaderMap,\n        key: String(key),\n        locale,\n        selector,\n        transform: (dictionary) =>\n          getDictionary(dictionary, locale as DeclaredLocales),\n      });\n\n    const currentLocale = (selectorLocale ??\n      client.locale ??\n      defaultLocale) as LocalesValues;\n    const cacheKey = buildKey(currentLocale);\n\n    const attachOnChange = (content: any) => {\n      if (content != null && typeof content === 'object') {\n        content.onChange = (callback: (c: any) => void) => {\n          client.subscribe((newLocale) => {\n            const locale = (selectorLocale ?? newLocale) as LocalesValues;\n            const newKey = buildKey(locale);\n\n            if (qualifiedCache.has(newKey)) {\n              callback(qualifiedCache.get(newKey));\n              return;\n            }\n\n            resolveContent(locale).then((resolved) => {\n              qualifiedCache.set(newKey, resolved);\n              callback(resolved);\n            });\n          });\n          return content;\n        };\n      }\n      return content;\n    };\n\n    if (qualifiedCache.has(cacheKey)) {\n      return attachOnChange(qualifiedCache.get(cacheKey)) as any;\n    }\n\n    if (!qualifiedInflight.has(cacheKey)) {\n      const promise = resolveContent(currentLocale).then((resolved) => {\n        qualifiedCache.set(cacheKey, resolved);\n        qualifiedInflight.delete(cacheKey);\n        client.notify();\n      });\n      qualifiedInflight.set(cacheKey, promise);\n    }\n\n    return recursiveProxy;\n  }\n\n  // --- Plain locale-keyed loader map ---\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n  const currentLocale = (locale ?? client.locale ?? defaultLocale) as A;\n\n  const cacheKey = `${String(key)}.${currentLocale}`;\n  const loader = (dictionaryLoaders as Record<string, () => Promise<T>>)[\n    currentLocale as string\n  ];\n\n  // A build-tool plugin may have started this locale's chunk while the entry\n  // point evaluated, and it may already have landed. Seeding the cache with it turns the first call into a\n  // cache hit, so the branch below returns real content instead of the\n  // placeholder proxy — no extra code path needed.\n  if (!cache.has(cacheKey)) {\n    const preloadedDictionary = getPreloadedDictionary(\n      dictionaryLoaders,\n      currentLocale as LocalesValues\n    );\n\n    if (preloadedDictionary) cache.set(cacheKey, preloadedDictionary);\n  }\n\n  // --- Cache hit: return real content synchronously ---\n  const cached = cache.get(cacheKey);\n  if (cached) {\n    const content = getDictionary(cached, currentLocale) as WithOnChange<\n      DeepTransformContent<T['content']>\n    >;\n\n    content.onChange = (callback) => {\n      // Re-fire whenever content reloads (locale change → new cache entry).\n      client.subscribe((newLocale) => {\n        const newKey = `${String(key)}.${newLocale}`;\n        const newLoader = (\n          dictionaryLoaders as Record<string, () => Promise<T>>\n        )[newLocale];\n\n        if (!newLoader) return;\n\n        loadDictionary(newKey, newLoader).then(() => {\n          const dict = cache.get(newKey);\n          if (dict) {\n            callback(getDictionary(dict, newLocale as A) as any);\n          }\n        });\n      });\n\n      return content;\n    };\n\n    return content;\n  }\n\n  // --- Cache miss: kick off background load, then notify to re-render ---\n  if (loader) {\n    loadDictionary(cacheKey, loader).then(() => {\n      client.notify();\n    });\n  }\n\n  return recursiveProxy;\n};\n"],"mappings":"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"}
+{"version":3,"file":"useDictionaryDynamic.mjs","names":["getDictionary"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["import {\n  getDictionarySelectorCacheKey,\n  getPreloadedDictionary,\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport { resolveInterpreterLocale } from '@intlayer/core/interpreter';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { getIntlayerClient } from './installIntlayer';\nimport type { WithOnChange } from './useDictionary';\n\n/** Simple in-memory cache shared across all calls in the same page. */\nconst cache = new Map<string, Dictionary>();\n\n/** Tracks in-flight loads to avoid duplicate fetches. */\nconst inflight = new Map<string, Promise<void>>();\n\n/** Resolved-content cache for qualified (collection/variant/meta) keys. */\nconst qualifiedCache = new Map<string, unknown>();\nconst qualifiedInflight = new Map<string, Promise<void>>();\n\nconst loadDictionary = <T extends Dictionary>(\n  cacheKey: string,\n  loader: () => Promise<T>\n): Promise<void> => {\n  if (cache.has(cacheKey)) return Promise.resolve();\n  if (inflight.has(cacheKey)) return inflight.get(cacheKey)!;\n\n  const promise = loader().then((dictionary) => {\n    cache.set(cacheKey, dictionary);\n    inflight.delete(cacheKey);\n  });\n\n  inflight.set(cacheKey, promise);\n  return promise;\n};\n\n/** Placeholder proxy — safe for any property access while loading. */\nconst recursiveProxy: any = new Proxy(() => {}, {\n  get: (_t, prop) => {\n    if (prop === Symbol.toPrimitive) return () => '';\n    if (prop === 'toString') return () => '';\n    if (prop === 'valueOf') return () => '';\n    if (prop === 'then') return undefined; // not a Promise\n    if (prop === 'onChange') return (_cb: any) => recursiveProxy;\n    return recursiveProxy;\n  },\n  apply: () => recursiveProxy,\n});\n\n/**\n * Dynamically load and transform a dictionary (plain or qualified).\n *\n * For a qualified loader map (collection / variant, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded. The first call returns a placeholder\n * and triggers a background load; the client then notifies subscribers so the\n * render runs again with real content.\n *\n * @param dictionaryLoaders - Locale-keyed loader map, or a qualified loader map.\n * @param key               - Dictionary key (used for cache namespacing).\n * @param localeOrSelector  - Optional locale or selector.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = DeclaredLocales,\n>(\n  dictionaryLoaders:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n): WithOnChange<DeepTransformContent<T['content']>> => {\n  const client = getIntlayerClient();\n\n  // --- Qualified loader map (collection / variant) ---\n  if (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryLoaders)\n  ) {\n    const loaderMap = dictionaryLoaders;\n    // Layers the client's ambient variant under the call-site argument before\n    // the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: client.locale,\n          contextVariant: client.variant,\n          dictionaryKey: String(key),\n        })\n      );\n    const selectorId = getDictionarySelectorCacheKey(selector);\n\n    const buildKey = (locale: string) =>\n      `${String(key)}.${locale}.${selectorId}`;\n    const resolveContent = (locale: LocalesValues) =>\n      resolveQualifiedDynamicContentAsync({\n        loaderMap,\n        key: String(key),\n        locale,\n        selector,\n        transform: (dictionary) =>\n          getDictionary(dictionary, locale as DeclaredLocales),\n      });\n\n    const currentLocale = (selectorLocale ??\n      client.locale ??\n      resolveInterpreterLocale()) as LocalesValues;\n    const cacheKey = buildKey(currentLocale);\n\n    const attachOnChange = (content: any) => {\n      if (content != null && typeof content === 'object') {\n        content.onChange = (callback: (c: any) => void) => {\n          client.subscribe((newLocale) => {\n            const locale = (selectorLocale ?? newLocale) as LocalesValues;\n            const newKey = buildKey(locale);\n\n            if (qualifiedCache.has(newKey)) {\n              callback(qualifiedCache.get(newKey));\n              return;\n            }\n\n            resolveContent(locale).then((resolved) => {\n              qualifiedCache.set(newKey, resolved);\n              callback(resolved);\n            });\n          });\n          return content;\n        };\n      }\n      return content;\n    };\n\n    if (qualifiedCache.has(cacheKey)) {\n      return attachOnChange(qualifiedCache.get(cacheKey)) as any;\n    }\n\n    if (!qualifiedInflight.has(cacheKey)) {\n      const promise = resolveContent(currentLocale).then((resolved) => {\n        qualifiedCache.set(cacheKey, resolved);\n        qualifiedInflight.delete(cacheKey);\n        client.notify();\n      });\n      qualifiedInflight.set(cacheKey, promise);\n    }\n\n    return recursiveProxy;\n  }\n\n  // --- Plain locale-keyed loader map ---\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n  const currentLocale = (locale ??\n    client.locale ??\n    resolveInterpreterLocale()) as A;\n\n  const cacheKey = `${String(key)}.${currentLocale}`;\n  const loader = (dictionaryLoaders as Record<string, () => Promise<T>>)[\n    currentLocale as string\n  ];\n\n  // A build-tool plugin may have started this locale's chunk while the entry\n  // point evaluated, and it may already have landed. Seeding the cache with it turns the first call into a\n  // cache hit, so the branch below returns real content instead of the\n  // placeholder proxy — no extra code path needed.\n  if (!cache.has(cacheKey)) {\n    const preloadedDictionary = getPreloadedDictionary(\n      dictionaryLoaders,\n      currentLocale as LocalesValues\n    );\n\n    if (preloadedDictionary) cache.set(cacheKey, preloadedDictionary);\n  }\n\n  // --- Cache hit: return real content synchronously ---\n  const cached = cache.get(cacheKey);\n  if (cached) {\n    const content = getDictionary(cached, currentLocale) as WithOnChange<\n      DeepTransformContent<T['content']>\n    >;\n\n    content.onChange = (callback) => {\n      // Re-fire whenever content reloads (locale change → new cache entry).\n      client.subscribe((newLocale) => {\n        const newKey = `${String(key)}.${newLocale}`;\n        const newLoader = (\n          dictionaryLoaders as Record<string, () => Promise<T>>\n        )[newLocale];\n\n        if (!newLoader) return;\n\n        loadDictionary(newKey, newLoader).then(() => {\n          const dict = cache.get(newKey);\n          if (dict) {\n            callback(getDictionary(dict, newLocale as A) as any);\n          }\n        });\n      });\n\n      return content;\n    };\n\n    return content;\n  }\n\n  // --- Cache miss: kick off background load, then notify to re-render ---\n  if (loader) {\n    loadDictionary(cacheKey, loader).then(() => {\n      client.notify();\n    });\n  }\n\n  return recursiveProxy;\n};\n"],"mappings":"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"}

package/dist/esm/plugins.mjs

@@ -1,5 +1,5 @@
 import { renderIntlayerNode } from "./renderIntlayerNode.mjs";
-import { conditionPlugin, enumerationPlugin, fallbackPlugin, filePlugin, genderPlugin, getHTML, isInterpolableWrapperNode, nestedPlugin, pluralPlugin, resolveInsertedSelector, selectPlugin, splitInsertionTemplate, transformInterpolableNode, translationPlugin } from "@intlayer/core/interpreter";
+import { conditionPlugin, enumerationPlugin, fallbackPlugin, filePlugin, genderPlugin, getHTML, isInterpolableWrapperNode, nestedPlugin, pluralPlugin, resolveInsertedSelector, resolveInterpreterLocale, selectPlugin, splitInsertionTemplate, transformInterpolableNode, translationPlugin } from "@intlayer/core/interpreter";
 import { editor, internationalization } from "@intlayer/config/built";
 import { compileWithOptions, getMarkdownMetadata } from "@intlayer/core/markdown";
 import * as NodeTypes from "@intlayer/types/nodeType";
@@ -204,15 +204,16 @@ const pluginsCache = /* @__PURE__ */ new Map();
 * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.
 */
 const getPlugins = (locale, fallback = true) => {
-	const cacheKey = `${locale ?? internationalization.defaultLocale}_${fallback}`;
+	const currentLocale = resolveInterpreterLocale(locale);
+	const cacheKey = `${currentLocale}_${fallback}`;
 	if (pluginsCache.has(cacheKey)) return pluginsCache.get(cacheKey);
 	const enabledPlugins = [
 		intlayerNodePlugins,
-		translationPlugin(locale ?? internationalization.defaultLocale, fallback ? internationalization.defaultLocale : void 0),
+		translationPlugin(currentLocale, fallback ? internationalization.defaultLocale : void 0),
 		enumerationPlugin,
-		pluralPlugin(locale ?? internationalization.defaultLocale),
+		pluralPlugin(currentLocale),
 		conditionPlugin,
-		nestedPlugin(locale ?? internationalization.defaultLocale),
+		nestedPlugin(currentLocale),
 		filePlugin,
 		genderPlugin,
 		selectPlugin,

package/dist/esm/plugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  getHTML,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  isInterpolableWrapperNode,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  resolveInsertedSelector,\n  selectPlugin,\n  splitInsertionTemplate,\n  transformInterpolableNode,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport {\n  compileWithOptions,\n  getMarkdownMetadata,\n} from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { HTMLComponents } from './html/types';\nimport {\n  type IntlayerNode as IntlayerNodeCore,\n  renderIntlayerNode,\n} from './renderIntlayerNode';\n\n/** ---------------------------------------------\n * INTLAYER NODE PLUGIN\n * --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport type IntlayerNode<T, P = {}> = IntlayerNodeCore<T> & P;\n\nconst escapeHtmlAttr = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n\nconst escapeHtmlText = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, keyPath, dictionaryKey }) => {\n    if (process.env.INTLAYER_EDITOR_ENABLED !== 'false' && editor.enabled) {\n      const rawStr = String(children ?? '');\n      const keyPathJson = JSON.stringify(keyPath ?? []);\n      const dictKey = String(dictionaryKey ?? '');\n\n      /**\n       * In editor mode, string coercion returns the wrapper HTML so that\n       * `element.innerHTML = content.title` automatically inserts the\n       * `<intlayer-content-selector-wrapper>` into the DOM.\n       */\n      const htmlStr = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(rawStr)}</intlayer-content-selector-wrapper>`;\n\n      return renderIntlayerNode({\n        value: children as string,\n        children: htmlStr,\n        keyPath,\n        dictionaryKey,\n        additionalProps: {\n          toElement: (): HTMLElement => {\n            const wrapper = document.createElement(\n              'intlayer-content-selector-wrapper'\n            );\n            wrapper.setAttribute('key-path', keyPathJson);\n            wrapper.setAttribute('dictionary-key', dictKey);\n            wrapper.textContent = rawStr;\n            return wrapper;\n          },\n        },\n      });\n    }\n\n    return renderIntlayerNode({\n      value: children as string,\n      children,\n    });\n  },\n};\n\n/** ---------------------------------------------\n * INSERTION PLUGIN\n * --------------------------------------------- */\n\nexport type InsertionCond<T, _S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly (infer F)[];\n}\n  ? <V extends { [K in Extract<F, string>]: string | number }>(\n      values: V\n    ) => I extends string ? IntlayerNode<string> : DeepTransformContent<I, L>\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.INSERTION },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) =>\n              typeof node === 'string' || isInterpolableWrapperNode(node),\n            transform: (node, subProps, deepTransformNode) => {\n              // `html()`/`markdown()` nodes carry their `{{ … }}` placeholders\n              // inside a raw string. Interpolate into that string, then re-run\n              // the transform so the html/markdown renderer applies afterwards.\n              if (isInterpolableWrapperNode(node)) {\n                return (\n                  values: {\n                    [K in InsertionContent['fields'][number]]: string | number;\n                  }\n                ) =>\n                  transformInterpolableNode(\n                    node,\n                    values,\n                    subProps,\n                    props.plugins,\n                    deepTransformNode\n                  );\n              }\n\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: (props.plugins ?? ([] as Plugins[])).filter(\n                  (plugin) => plugin.id !== 'intlayer-node-plugin'\n                ),\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const result = splitInsertionTemplate(\n                  transformedResult,\n                  values\n                );\n                const resultStr = result.isSimple\n                  ? (result.parts as string)\n                  : (result.parts as string[]).join('');\n\n                return deepTransformNode(resultStr, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: resultStr,\n                });\n              };\n            },\n          };\n\n          const transformed = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          return resolveInsertedSelector(children, transformed);\n        },\n      };\n\n/** ---------------------------------------------\n * MARKDOWN PLUGIN\n * --------------------------------------------- */\n\nconst vanillaRuntime = {\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const attrs = Object.entries(props || {})\n      .filter(\n        ([key]) => key !== 'children' && key !== 'key' && key !== '_innerHTML'\n      )\n      .map(([key, value]) => `${key}=\"${value}\"`)\n      .join(' ');\n    const innerHTML = props?._innerHTML;\n    const childrenStr =\n      innerHTML !== undefined ? innerHTML : children.flat(Infinity).join('');\n    return `<${tag}${attrs ? ` ${attrs}` : ''}>${childrenStr}</${tag}>`;\n  },\n  normalizeProps: (_tag: string, props: Record<string, any>) => {\n    const normalized: Record<string, any> = {};\n    for (const [key, value] of Object.entries(props)) {\n      if (key === 'className') {\n        normalized.class = value;\n      } else if (key === 'htmlFor') {\n        normalized.for = value;\n      } else if (key === 'dangerouslySetInnerHTML' && (value as any)?.__html) {\n        normalized._innerHTML = (value as any).__html;\n      } else {\n        normalized[key] = value;\n      }\n    }\n    return normalized;\n  },\n};\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        /** Returns the rendered markdown; render with .use(). */\n        use: (components?: HTMLComponents<'permissive', {}>) => string;\n      }\n    >\n  : never;\n\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const { plugins: _plugins, ...rest } = props;\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, subProps) =>\n              renderIntlayerNode({\n                ...subProps,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const compile = (components: any = {}) =>\n            compileWithOptions(\n              node,\n              {\n                ...vanillaRuntime,\n                createElement: (tag: any, props: any, ...children: any[]) => {\n                  const override = components[tag];\n                  if (typeof override === 'function') {\n                    return override({ ...props, children: children.join('') });\n                  }\n                  return vanillaRuntime.createElement(tag, props, ...children);\n                },\n              },\n              {}\n            ) as any;\n\n          const value = compile();\n          let children = node;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              metadata: metadataNodes,\n              use: (components?: any) => compile(components),\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  metadata?: infer U;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<M>;\n      metadata: DeepTransformContent<U>;\n    }\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.MARKDOWN },\n          ];\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * HTML PLUGIN\n * --------------------------------------------- */\n\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<I>;\n    }\n  : never;\n\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n        transform: (node: HTMLContent<string>, props) => {\n          const htmlStr = node[NodeTypes.HTML];\n\n          const use = (components: Record<string, any> = {}) => {\n            const wrappedComponents = new Proxy(components, {\n              get(target, prop) {\n                if (typeof prop === 'string' && prop in target) {\n                  const Component = target[prop];\n                  return (props: any) => {\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return Component({ ...props, children });\n                  };\n                }\n                if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n                  return (props: any) => {\n                    const attrs = Object.entries(props)\n                      .filter(([key]) => key !== 'children' && key !== 'key')\n                      .map(([key, value]) => `${key}=\"${value}\"`)\n                      .join(' ');\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return `<${prop}${attrs ? ` ${attrs}` : ''}>${children}</${prop}>`;\n                  };\n                }\n                return undefined;\n              },\n            });\n\n            const result = getHTML(htmlStr, wrappedComponents as any);\n            return Array.isArray(result) ? result.join('') : result;\n          };\n\n          const value = use();\n          let children = htmlStr;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              use: (components?: any) => use(components),\n            },\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * PLUGINS RESULT\n * --------------------------------------------- */\n\nexport interface IInterpreterPluginVanilla<T, S, L extends LocalesValues> {\n  vanillaIntlayerNode: IntlayerNodeCond<T>;\n  vanillaInsertion: InsertionCond<T, S, L>;\n  vanillaMarkdown: MarkdownCond<T>;\n  vanillaHtml: HTMLPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the `vanilla-intlayer` plugins will override the types of `intlayer` functions.\n * Use `getIntlayer` from `vanilla-intlayer` (not from `intlayer`) to get properly typed\n * `IntlayerNode` wrappers with `.value` access on string/number content.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion'\n> & {\n  vanillaIntlayerNode: true;\n  vanillaInsertion: true;\n  vanillaMarkdown: true;\n  vanillaHtml: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Vanilla content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // First: most nodes are plain strings, which every other plugin rejects\n    intlayerNodePlugins,\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n    filePlugin,\n    genderPlugin,\n    selectPlugin,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  // Plugins disabled at build time never match: skip them on every node\n  const enabledPlugins = plugins.filter((plugin) => plugin !== fallbackPlugin);\n\n  pluginsCache.set(cacheKey, enabledPlugins);\n\n  return enabledPlugins;\n};\n"],"mappings":"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"}
+{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  getHTML,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  isInterpolableWrapperNode,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  resolveInsertedSelector,\n  resolveInterpreterLocale,\n  selectPlugin,\n  splitInsertionTemplate,\n  transformInterpolableNode,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport {\n  compileWithOptions,\n  getMarkdownMetadata,\n} from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { HTMLComponents } from './html/types';\nimport {\n  type IntlayerNode as IntlayerNodeCore,\n  renderIntlayerNode,\n} from './renderIntlayerNode';\n\n/** ---------------------------------------------\n * INTLAYER NODE PLUGIN\n * --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport type IntlayerNode<T, P = {}> = IntlayerNodeCore<T> & P;\n\nconst escapeHtmlAttr = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n\nconst escapeHtmlText = (str: string): string =>\n  str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, keyPath, dictionaryKey }) => {\n    if (process.env.INTLAYER_EDITOR_ENABLED !== 'false' && editor.enabled) {\n      const rawStr = String(children ?? '');\n      const keyPathJson = JSON.stringify(keyPath ?? []);\n      const dictKey = String(dictionaryKey ?? '');\n\n      /**\n       * In editor mode, string coercion returns the wrapper HTML so that\n       * `element.innerHTML = content.title` automatically inserts the\n       * `<intlayer-content-selector-wrapper>` into the DOM.\n       */\n      const htmlStr = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(rawStr)}</intlayer-content-selector-wrapper>`;\n\n      return renderIntlayerNode({\n        value: children as string,\n        children: htmlStr,\n        keyPath,\n        dictionaryKey,\n        additionalProps: {\n          toElement: (): HTMLElement => {\n            const wrapper = document.createElement(\n              'intlayer-content-selector-wrapper'\n            );\n            wrapper.setAttribute('key-path', keyPathJson);\n            wrapper.setAttribute('dictionary-key', dictKey);\n            wrapper.textContent = rawStr;\n            return wrapper;\n          },\n        },\n      });\n    }\n\n    return renderIntlayerNode({\n      value: children as string,\n      children,\n    });\n  },\n};\n\n/** ---------------------------------------------\n * INSERTION PLUGIN\n * --------------------------------------------- */\n\nexport type InsertionCond<T, _S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly (infer F)[];\n}\n  ? <V extends { [K in Extract<F, string>]: string | number }>(\n      values: V\n    ) => I extends string ? IntlayerNode<string> : DeepTransformContent<I, L>\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.INSERTION },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) =>\n              typeof node === 'string' || isInterpolableWrapperNode(node),\n            transform: (node, subProps, deepTransformNode) => {\n              // `html()`/`markdown()` nodes carry their `{{ … }}` placeholders\n              // inside a raw string. Interpolate into that string, then re-run\n              // the transform so the html/markdown renderer applies afterwards.\n              if (isInterpolableWrapperNode(node)) {\n                return (\n                  values: {\n                    [K in InsertionContent['fields'][number]]: string | number;\n                  }\n                ) =>\n                  transformInterpolableNode(\n                    node,\n                    values,\n                    subProps,\n                    props.plugins,\n                    deepTransformNode\n                  );\n              }\n\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: (props.plugins ?? ([] as Plugins[])).filter(\n                  (plugin) => plugin.id !== 'intlayer-node-plugin'\n                ),\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const result = splitInsertionTemplate(\n                  transformedResult,\n                  values\n                );\n                const resultStr = result.isSimple\n                  ? (result.parts as string)\n                  : (result.parts as string[]).join('');\n\n                return deepTransformNode(resultStr, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: resultStr,\n                });\n              };\n            },\n          };\n\n          const transformed = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          return resolveInsertedSelector(children, transformed);\n        },\n      };\n\n/** ---------------------------------------------\n * MARKDOWN PLUGIN\n * --------------------------------------------- */\n\nconst vanillaRuntime = {\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const attrs = Object.entries(props || {})\n      .filter(\n        ([key]) => key !== 'children' && key !== 'key' && key !== '_innerHTML'\n      )\n      .map(([key, value]) => `${key}=\"${value}\"`)\n      .join(' ');\n    const innerHTML = props?._innerHTML;\n    const childrenStr =\n      innerHTML !== undefined ? innerHTML : children.flat(Infinity).join('');\n    return `<${tag}${attrs ? ` ${attrs}` : ''}>${childrenStr}</${tag}>`;\n  },\n  normalizeProps: (_tag: string, props: Record<string, any>) => {\n    const normalized: Record<string, any> = {};\n    for (const [key, value] of Object.entries(props)) {\n      if (key === 'className') {\n        normalized.class = value;\n      } else if (key === 'htmlFor') {\n        normalized.for = value;\n      } else if (key === 'dangerouslySetInnerHTML' && (value as any)?.__html) {\n        normalized._innerHTML = (value as any).__html;\n      } else {\n        normalized[key] = value;\n      }\n    }\n    return normalized;\n  },\n};\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        /** Returns the rendered markdown; render with .use(). */\n        use: (components?: HTMLComponents<'permissive', {}>) => string;\n      }\n    >\n  : never;\n\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const { plugins: _plugins, ...rest } = props;\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, subProps) =>\n              renderIntlayerNode({\n                ...subProps,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const compile = (components: any = {}) =>\n            compileWithOptions(\n              node,\n              {\n                ...vanillaRuntime,\n                createElement: (tag: any, props: any, ...children: any[]) => {\n                  const override = components[tag];\n                  if (typeof override === 'function') {\n                    return override({ ...props, children: children.join('') });\n                  }\n                  return vanillaRuntime.createElement(tag, props, ...children);\n                },\n              },\n              {}\n            ) as any;\n\n          const value = compile();\n          let children = node;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              metadata: metadataNodes,\n              use: (components?: any) => compile(components),\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  metadata?: infer U;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<M>;\n      metadata: DeepTransformContent<U>;\n    }\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            { type: NodeTypes.MARKDOWN },\n          ];\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * HTML PLUGIN\n * --------------------------------------------- */\n\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? {\n      use: (components?: HTMLComponents<'permissive', U>) => IntlayerNode<I>;\n    }\n  : never;\n\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n        transform: (node: HTMLContent<string>, props) => {\n          const htmlStr = node[NodeTypes.HTML];\n\n          const use = (components: Record<string, any> = {}) => {\n            const wrappedComponents = new Proxy(components, {\n              get(target, prop) {\n                if (typeof prop === 'string' && prop in target) {\n                  const Component = target[prop];\n                  return (props: any) => {\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return Component({ ...props, children });\n                  };\n                }\n                if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n                  return (props: any) => {\n                    const attrs = Object.entries(props)\n                      .filter(([key]) => key !== 'children' && key !== 'key')\n                      .map(([key, value]) => `${key}=\"${value}\"`)\n                      .join(' ');\n                    const children = Array.isArray(props.children)\n                      ? props.children.join('')\n                      : props.children;\n                    return `<${prop}${attrs ? ` ${attrs}` : ''}>${children}</${prop}>`;\n                  };\n                }\n                return undefined;\n              },\n            });\n\n            const result = getHTML(htmlStr, wrappedComponents as any);\n            return Array.isArray(result) ? result.join('') : result;\n          };\n\n          const value = use();\n          let children = htmlStr;\n\n          if (\n            process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n            editor.enabled\n          ) {\n            const keyPathJson = JSON.stringify(props.keyPath ?? []);\n            const dictKey = String(props.dictionaryKey ?? '');\n            children = `<intlayer-content-selector-wrapper key-path=\"${escapeHtmlAttr(keyPathJson)}\" dictionary-key=\"${escapeHtmlAttr(dictKey)}\">${escapeHtmlText(value)}</intlayer-content-selector-wrapper>`;\n          }\n\n          return renderIntlayerNode({\n            ...props,\n            value,\n            children,\n            additionalProps: {\n              use: (components?: any) => use(components),\n            },\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * PLUGINS RESULT\n * --------------------------------------------- */\n\nexport interface IInterpreterPluginVanilla<T, S, L extends LocalesValues> {\n  vanillaIntlayerNode: IntlayerNodeCond<T>;\n  vanillaInsertion: InsertionCond<T, S, L>;\n  vanillaMarkdown: MarkdownCond<T>;\n  vanillaHtml: HTMLPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the `vanilla-intlayer` plugins will override the types of `intlayer` functions.\n * Use `getIntlayer` from `vanilla-intlayer` (not from `intlayer`) to get properly typed\n * `IntlayerNode` wrappers with `.value` access on string/number content.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion'\n> & {\n  vanillaIntlayerNode: true;\n  vanillaInsertion: true;\n  vanillaMarkdown: true;\n  vanillaHtml: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Vanilla content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback = true\n): Plugins[] => {\n  const currentLocale = resolveInterpreterLocale(locale);\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // First: most nodes are plain strings, which every other plugin rejects\n    intlayerNodePlugins,\n    translationPlugin(\n      currentLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(currentLocale),\n    conditionPlugin,\n    nestedPlugin(currentLocale),\n    filePlugin,\n    genderPlugin,\n    selectPlugin,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  // Plugins disabled at build time never match: skip them on every node\n  const enabledPlugins = plugins.filter((plugin) => plugin !== fallbackPlugin);\n\n  pluginsCache.set(cacheKey, enabledPlugins);\n\n  return enabledPlugins;\n};\n"],"mappings":"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"}

package/dist/esm/renderIntlayerNode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderIntlayerNode.mjs","names":[],"sources":["../../src/renderIntlayerNode.ts"],"sourcesContent":["import { getIntlayerNodePrototype } from '@intlayer/core/utils';\nimport type { ResolvedEditor } from '@intlayer/types/module_augmentation';\n\nexport type IntlayerNode<T = string> = ResolvedEditor<\n  T & {\n    raw: T;\n    value: T;\n    toString: () => string;\n    valueOf: () => T;\n    toJSON: () => T;\n    __update: (next: IntlayerNode<T>) => void;\n  },\n  {\n    raw: T;\n    value: T;\n    toString: () => string;\n    valueOf: () => T;\n    toJSON: () => T;\n    __update: (next: IntlayerNode<T>) => void;\n  }\n> &\n  T;\n\nexport const renderIntlayerNode = <\n  T, // Broadened to support arrays, numbers, objects, etc.\n>({\n  value,\n  children,\n  additionalProps = {},\n}: {\n  value: T;\n  children?: any;\n  additionalProps?: Record<string, unknown>;\n  [key: string]: unknown;\n}): IntlayerNode<T> => {\n  let _value = value;\n\n  // When children is a string that differs from value, it acts as a display\n  // override (e.g. editor HTML wrapper). Otherwise toString/toPrimitive reflect\n  // the live _value so that __update propagates.\n  const displayOverride =\n    typeof children === 'string' && children !== String(value ?? '')\n      ? children\n      : null;\n\n  const node = {\n    // Serves the value's members: `node.toUpperCase()`, `'trim' in node`\n    __proto__: getIntlayerNodePrototype(value),\n\n    toString: () => displayOverride ?? String(_value ?? ''),\n    valueOf: () => _value,\n    [Symbol.toPrimitive]: () => displayOverride ?? _value,\n    toJSON: () => _value,\n\n    get raw() {\n      return _value;\n    },\n    set raw(value: T) {\n      _value = value;\n    },\n\n    get value() {\n      return _value;\n    },\n\n    __update(next: any) {\n      _value = next?.raw ?? next?.value ?? next;\n    },\n\n    ...additionalProps,\n  };\n\n  return node as unknown as IntlayerNode<T>;\n};\n"],"mappings":";;;AAuBA,MAAa,sBAEX,EACA,OACA,UACA,kBAAkB,CAAC,QAME;CACrB,IAAI,SAAS;CAKb,MAAM,kBACJ,OAAO,aAAa,YAAY,aAAa,OAAO,SAAS,EAAE,IAC3D,WACA;CA6BN,OAAO;EAzBL,WAAW,yBAAyB,KAAK;EAEzC,gBAAgB,mBAAmB,OAAO,UAAU,EAAE;EACtD,eAAe;GACd,OAAO,oBAAoB,mBAAmB;EAC/C,cAAc;EAEd,IAAI,MAAM;GACR,OAAO;EACT;EACA,IAAI,IAAI,OAAU;GAChB,SAAS;EACX;EAEA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,SAAS,MAAW;GAClB,SAAS,MAAM,OAAO,MAAM,SAAS;EACvC;EAEA,GAAG;CAGK;AACZ"}
+{"version":3,"file":"renderIntlayerNode.mjs","names":[],"sources":["../../src/renderIntlayerNode.ts"],"sourcesContent":["import { getIntlayerNodePrototype } from '@intlayer/core/utils';\nimport type { ResolvedEditor } from '@intlayer/types/module_augmentation';\n\ntype IntlayerNodeMembers<T> = {\n  raw: T;\n  value: T;\n  toString: () => string;\n  valueOf: () => T;\n  toJSON: () => T;\n  __update: (next: IntlayerNode<T>) => void;\n};\n\n/**\n * Content node returned by `useIntlayer`.\n *\n * Without the editor it is typed as its value plus the node members, so it\n * can be used wherever a string is expected. With the editor, string coercion returns the editor wrapper HTML,\n * so string usages must go through `.value`.\n */\nexport type IntlayerNode<T = string> = ResolvedEditor<\n  T & IntlayerNodeMembers<T>,\n  IntlayerNodeMembers<T>\n>;\n\nexport const renderIntlayerNode = <\n  T, // Broadened to support arrays, numbers, objects, etc.\n>({\n  value,\n  children,\n  additionalProps = {},\n}: {\n  value: T;\n  children?: any;\n  additionalProps?: Record<string, unknown>;\n  [key: string]: unknown;\n}): IntlayerNode<T> => {\n  let _value = value;\n\n  // When children is a string that differs from value, it acts as a display\n  // override (e.g. editor HTML wrapper). Otherwise toString/toPrimitive reflect\n  // the live _value so that __update propagates.\n  const displayOverride =\n    typeof children === 'string' && children !== String(value ?? '')\n      ? children\n      : null;\n\n  const node = {\n    // Serves the value's members: `node.toUpperCase()`, `'trim' in node`\n    __proto__: getIntlayerNodePrototype(value),\n\n    toString: () => displayOverride ?? String(_value ?? ''),\n    valueOf: () => _value,\n    [Symbol.toPrimitive]: () => displayOverride ?? _value,\n    toJSON: () => _value,\n\n    get raw() {\n      return _value;\n    },\n    set raw(value: T) {\n      _value = value;\n    },\n\n    get value() {\n      return _value;\n    },\n\n    __update(next: any) {\n      _value = next?.raw ?? next?.value ?? next;\n    },\n\n    ...additionalProps,\n  };\n\n  return node as unknown as IntlayerNode<T>;\n};\n"],"mappings":";;;AAwBA,MAAa,sBAEX,EACA,OACA,UACA,kBAAkB,CAAC,QAME;CACrB,IAAI,SAAS;CAKb,MAAM,kBACJ,OAAO,aAAa,YAAY,aAAa,OAAO,SAAS,EAAE,IAC3D,WACA;CA6BN,OAAO;EAzBL,WAAW,yBAAyB,KAAK;EAEzC,gBAAgB,mBAAmB,OAAO,UAAU,EAAE;EACtD,eAAe;GACd,OAAO,oBAAoB,mBAAmB;EAC/C,cAAc;EAEd,IAAI,MAAM;GACR,OAAO;EACT;EACA,IAAI,IAAI,OAAU;GAChB,SAAS;EACX;EAEA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,SAAS,MAAW;GAClB,SAAS,MAAM,OAAO,MAAM,SAAS;EACvC;EAEA,GAAG;CAGK;AACZ"}

package/dist/types/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.ts"],"mappings":";;;;;;;;;;YA8CY,iBAAiB,KAAK,4BAC9B,aAAa;YAGL,aAAa,GAAG,UAAU,eAAiB,KAAK;qBAQ/C,qBAAqB;;;;YAiDtB,cAAc,GAAG,IAAI,UAAU,iBAAiB;EAC1D,UAAU;GACT,UAAU,kBAAkB;EAC7B,wBAAwB;KAErB,aAAa,KAAK,QAAQ,iCACzB,QAAQ,MACL,mBAAmB,uBAAuB,qBAAqB,GAAG;qBAG9D,iBAAiB;YAiHlB,mBAAmB,KAAK,mBAChC;EAGI,UAAU;;EAEV,MAAM,aAAa;;qBAKd,sBAAsB;YAuEvB,aAAa,KAAK;EAC5B,UAAU;GACT,UAAU,iBAAiB;EAC5B,iBAAiB;EACjB,aAAa;;EAGT,MAAM,aAAa,6BAA6B,OAAO,aAAa;EACpE,UAAU,qBAAqB;;qBAIxB,gBAAgB;;;;YA2BjB,eAAe,KAAK;EAC9B,UAAU;GACT,UAAU,aAAa;EACxB,aAAa;;EAGT,MAAM,aAAa,6BAA6B,OAAO,aAAa;;qBAI7D,YAAY;;;;iBAqER,0BAA0B,GAAG,GAAG,UAAU;EACzD,qBAAqB,iBAAiB;EACtC,kBAAkB,cAAc,GAAG,GAAG;EACtC,iBAAiB,aAAa;EAC9B,aAAa,eAAe;;;;;;;;;YAUlB,0BAA0B,KACpC;EAGA;EACA;EACA;EACA;;YAGU,qBACV,GACA,UAAU,gBAAgB,mBACxB,uBAAyB,GAAG,yBAAyB;;;;;qBAQ5C,aAAU,SACZ,eAAa,uBAErB"}
+{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.ts"],"mappings":";;;;;;;;;;YA+CY,iBAAiB,KAAK,4BAC9B,aAAa;YAGL,aAAa,GAAG,UAAU,eAAiB,KAAK;qBAQ/C,qBAAqB;;;;YAiDtB,cAAc,GAAG,IAAI,UAAU,iBAAiB;EAC1D,UAAU;GACT,UAAU,kBAAkB;EAC7B,wBAAwB;KAErB,aAAa,KAAK,QAAQ,iCACzB,QAAQ,MACL,mBAAmB,uBAAuB,qBAAqB,GAAG;qBAG9D,iBAAiB;YAiHlB,mBAAmB,KAAK,mBAChC;EAGI,UAAU;;EAEV,MAAM,aAAa;;qBAKd,sBAAsB;YAuEvB,aAAa,KAAK;EAC5B,UAAU;GACT,UAAU,iBAAiB;EAC5B,iBAAiB;EACjB,aAAa;;EAGT,MAAM,aAAa,6BAA6B,OAAO,aAAa;EACpE,UAAU,qBAAqB;;qBAIxB,gBAAgB;;;;YA2BjB,eAAe,KAAK;EAC9B,UAAU;GACT,UAAU,aAAa;EACxB,aAAa;;EAGT,MAAM,aAAa,6BAA6B,OAAO,aAAa;;qBAI7D,YAAY;;;;iBAqER,0BAA0B,GAAG,GAAG,UAAU;EACzD,qBAAqB,iBAAiB;EACtC,kBAAkB,cAAc,GAAG,GAAG;EACtC,iBAAiB,aAAa;EAC9B,aAAa,eAAe;;;;;;;;;YAUlB,0BAA0B,KACpC;EAGA;EACA;EACA;EACA;;YAGU,qBACV,GACA,UAAU,gBAAgB,mBACxB,uBAAyB,GAAG,yBAAyB;;;;;qBAQ5C,aAAU,SACZ,eAAa,uBAErB"}

package/dist/types/renderIntlayerNode.d.ts

@@ -1,20 +1,21 @@
 import { ResolvedEditor } from "@intlayer/types/module_augmentation";
 //#region src/renderIntlayerNode.d.ts
-export type IntlayerNode<T = string> = ResolvedEditor<T & {
+type IntlayerNodeMembers<T> = {
   raw: T;
   value: T;
   toString: () => string;
   valueOf: () => T;
   toJSON: () => T;
   __update: (next: IntlayerNode<T>) => void;
-}, {
-  raw: T;
-  value: T;
-  toString: () => string;
-  valueOf: () => T;
-  toJSON: () => T;
-  __update: (next: IntlayerNode<T>) => void;
-}> & T;
+};
+/**
+ * Content node returned by `useIntlayer`.
+ *
+ * Without the editor it is typed as its value plus the node members, so it
+ * can be used wherever a string is expected. With the editor, string coercion returns the editor wrapper HTML,
+ * so string usages must go through `.value`.
+ */
+export type IntlayerNode<T = string> = ResolvedEditor<T & IntlayerNodeMembers<T>, IntlayerNodeMembers<T>>;
 export declare const renderIntlayerNode: <T>({ value, children, additionalProps }: {
   value: T;
   children?: any;

package/dist/types/renderIntlayerNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderIntlayerNode.d.ts","names":[],"sources":["../../src/renderIntlayerNode.ts"],"mappings":";;YAGY,aAAa,cAAc,eACrC;EACE,KAAK;EACL,OAAO;EACP;EACA,eAAe;EACf,cAAc;EACd,WAAW,MAAM,aAAa;;EAG9B,KAAK;EACL,OAAO;EACP;EACA,eAAe;EACf,cAAc;EACd,WAAW,MAAM,aAAa;KAGhC;qBAEW,qBACX,KAAC,OAAA,UAAA;EAMD,OAAO;EACP;EACA,kBAAkB;GACjB;MACC,aAAa"}
+{"version":3,"file":"renderIntlayerNode.d.ts","names":[],"sources":["../../src/renderIntlayerNode.ts"],"mappings":";;KAGK,oBAAoB;EACvB,KAAK;EACL,OAAO;EACP;EACA,eAAe;EACf,cAAc;EACd,WAAW,MAAM,aAAa;;;;;;;;;YAUpB,aAAa,cAAc,eACrC,IAAI,oBAAoB,IACxB,oBAAoB;qBAGT,qBACX,KAAC,OAAA,UAAA;EAMD,OAAO;EACP;EACA,kBAAkB;GACjB;MACC,aAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-intlayer",
-  "version": "9.5.10",
+  "version": "9.5.12",
   "private": false,
   "description": "Easily internationalize i18n your Vanilla JS, HTML, and PHP applications with type-safe multilingual content management.",
   "keywords": [
@@ -102,11 +102,11 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.5.10",
-    "@intlayer/config": "9.5.10",
-    "@intlayer/core": "9.5.10",
-    "@intlayer/editor": "9.5.10",
-    "@intlayer/types": "9.5.10"
+    "@intlayer/api": "9.5.12",
+    "@intlayer/config": "9.5.12",
+    "@intlayer/core": "9.5.12",
+    "@intlayer/editor": "9.5.12",
+    "@intlayer/types": "9.5.12"
   },
   "devDependencies": {
     "@types/node": "^22",
@@ -119,7 +119,7 @@
     "vitest": "5.0.2"
   },
   "peerDependencies": {
-    "intlayer": "9.5.10"
+    "intlayer": "9.5.12"
   },
   "peerDependenciesMeta": {
     "intlayer": {