preact-intlayer 9.2.0 → 9.3.1

package/dist/esm/html/HTMLRenderer.mjs

@@ -12,13 +12,14 @@ import { VOID_HTML_ELEMENTS } from "@intlayer/core/transpiler";
 */
 const renderHTML = (content, { components = {} } = {}) => {
 	const userComponents = Object.fromEntries(Object.entries(components).filter(([, Component]) => Component).map(([key, Component]) => [key, (props) => h(Component, props)]));
-	return h(Fragment, null, getHTML(content, new Proxy(userComponents, { get(target, prop) {
+	const wrappedComponents = new Proxy(userComponents, { get(target, prop) {
 		if (typeof prop === "string" && prop in target) return target[prop];
 		if (typeof prop === "string" && /^[a-z][a-z0-9]*$/.test(prop)) {
 			if (VOID_HTML_ELEMENTS.has(prop)) return ({ children: _children, ...rest }) => h(prop, rest);
 			return (props) => h(prop, props);
 		}
-	} })));
+	} });
+	return h(Fragment, null, getHTML(content, wrappedComponents));
 };
 /**
 * Hook that returns a function to render HTML content.

package/dist/esm/html/HTMLRenderer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"HTMLRenderer.mjs","names":[],"sources":["../../../src/html/HTMLRenderer.tsx"],"sourcesContent":["import { getHTML } from '@intlayer/core/interpreter';\nimport { VOID_HTML_ELEMENTS } from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport { Fragment, type FunctionComponent, h, type JSX } from 'preact';\nimport { useHTMLContext } from './HTMLProvider';\nimport type { HTMLComponents } from './types';\n\nexport type RenderHTMLProps = {\n  /**\n   * Component overrides for HTML tags.\n   * Allows you to customize how specific HTML elements are rendered.\n   */\n  components?: HTMLComponents<'permissive', {}>;\n};\n\n/**\n * Renders HTML-like content to JSX with the provided components.\n *\n * This function does not use context from HTMLProvider. Use `useHTMLRenderer`\n * hook if you want to leverage provider context.\n */\nexport const renderHTML = (\n  content: string,\n  { components = {} }: RenderHTMLProps = {}\n): JSX.Element => {\n  // Wrap explicit user components to ensure they are rendered via Preact's h\n  const userComponents = Object.fromEntries(\n    Object.entries(components)\n      .filter(([, Component]) => Component)\n      .map(([key, Component]) => [\n        key,\n        (props: any) => h(Component as any, props),\n      ])\n  );\n\n  // Proxy handles standard HTML tags lazily without a hardcoded list\n  const wrappedComponents = new Proxy(userComponents, {\n    get(target, prop) {\n      if (typeof prop === 'string' && prop in target) {\n        return target[prop];\n      }\n      // Fallback: Lazily generate a wrapper for standard lowercase HTML tags\n      if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n        if (VOID_HTML_ELEMENTS.has(prop)) {\n          // Void elements cannot have children — strip them to avoid render error\n          return ({ children: _children, ...rest }: any) => h(prop, rest);\n        }\n        return (props: any) => h(prop, props);\n      }\n      return undefined;\n    },\n  });\n\n  // Cast wrappedComponents to any to satisfy getHTML's dictionary typing\n  return h(Fragment, null, getHTML(content, wrappedComponents as any));\n};\n\n/**\n * Hook that returns a function to render HTML content.\n *\n * This hook considers the configuration from the `HTMLProvider` context if available,\n * falling back to the provided components.\n */\nexport const useHTMLRenderer = ({ components }: RenderHTMLProps = {}) => {\n  const context = useHTMLContext();\n\n  return (content: string) => {\n    return renderHTML(content, {\n      components: {\n        ...context?.components,\n        ...components,\n      },\n    });\n  };\n};\n\nexport type HTMLRendererProps = RenderHTMLProps & {\n  /**\n   * The HTML content to render as a string.\n   */\n  children?: string;\n  /**\n   * Alias for children, used by the plugin.\n   */\n  html?: string;\n  /**\n   * Alias for components, used by the plugin.\n   */\n  components?: HTMLComponents<'permissive', {}>;\n  dictionaryKey?: string;\n  keyPath?: KeyPath[];\n};\n\n/**\n * Preact component that renders HTML-like content to JSX.\n */\nexport const HTMLRenderer: FunctionComponent<HTMLRendererProps> = ({\n  children = '',\n  html,\n  components,\n}) => {\n  const render = useHTMLRenderer({ components });\n  const content = children || html || '';\n\n  return render(content);\n};\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,cACX,SACA,EAAE,aAAa,CAAC,MAAuB,CAAC,MACxB;CAEhB,MAAM,iBAAiB,OAAO,YAC5B,OAAO,QAAQ,UAAU,CAAC,CACvB,QAAQ,GAAG,eAAe,SAAS,CAAC,CACpC,KAAK,CAAC,KAAK,eAAe,CACzB,MACC,UAAe,EAAE,WAAkB,KAAK,CAC3C,CAAC,CACL;CAqBA,OAAO,EAAE,UAAU,MAAM,QAAQ,SAAS,IAlBZ,MAAM,gBAAgB,EAClD,IAAI,QAAQ,MAAM;EAChB,IAAI,OAAO,SAAS,YAAY,QAAQ,QACtC,OAAO,OAAO;EAGhB,IAAI,OAAO,SAAS,YAAY,mBAAmB,KAAK,IAAI,GAAG;GAC7D,IAAI,mBAAmB,IAAI,IAAI,GAE7B,QAAQ,EAAE,UAAU,WAAW,GAAG,WAAgB,EAAE,MAAM,IAAI;GAEhE,QAAQ,UAAe,EAAE,MAAM,KAAK;EACtC;CAEF,EACF,CAG0D,CAAQ,CAAC;AACrE;;;;;;;AAQA,MAAa,mBAAmB,EAAE,eAAgC,CAAC,MAAM;CACvE,MAAM,UAAU,eAAe;CAE/B,QAAQ,YAAoB;EAC1B,OAAO,WAAW,SAAS,EACzB,YAAY;GACV,GAAG,SAAS;GACZ,GAAG;EACL,EACF,CAAC;CACH;AACF;;;;AAsBA,MAAa,gBAAsD,EACjE,WAAW,IACX,MACA,iBACI;CAIJ,OAHe,gBAAgB,EAAE,WAAW,CAGhC,CAAC,CAFG,YAAY,QAAQ,EAEf;AACvB"}
+{"version":3,"file":"HTMLRenderer.mjs","names":[],"sources":["../../../src/html/HTMLRenderer.tsx"],"sourcesContent":["import { getHTML } from '@intlayer/core/interpreter';\nimport { VOID_HTML_ELEMENTS } from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport { Fragment, type FunctionComponent, h, type JSX } from 'preact';\nimport { useHTMLContext } from './HTMLProvider';\nimport type { HTMLComponents } from './types';\n\nexport type RenderHTMLProps = {\n  /**\n   * Component overrides for HTML tags.\n   * Allows you to customize how specific HTML elements are rendered.\n   */\n  components?: HTMLComponents<'permissive', {}>;\n};\n\n/**\n * Renders HTML-like content to JSX with the provided components.\n *\n * This function does not use context from HTMLProvider. Use `useHTMLRenderer`\n * hook if you want to leverage provider context.\n */\nexport const renderHTML = (\n  content: string,\n  { components = {} }: RenderHTMLProps = {}\n): JSX.Element => {\n  // Wrap explicit user components to ensure they are rendered via Preact's h\n  const userComponents = Object.fromEntries(\n    Object.entries(components)\n      .filter(([, Component]) => Component)\n      .map(([key, Component]) => [\n        key,\n        (props: any) => h(Component as any, props),\n      ])\n  );\n\n  // Proxy handles standard HTML tags lazily without a hardcoded list\n  const wrappedComponents = new Proxy(userComponents, {\n    get(target, prop) {\n      if (typeof prop === 'string' && prop in target) {\n        return target[prop];\n      }\n      // Fallback: Lazily generate a wrapper for standard lowercase HTML tags\n      if (typeof prop === 'string' && /^[a-z][a-z0-9]*$/.test(prop)) {\n        if (VOID_HTML_ELEMENTS.has(prop)) {\n          // Void elements cannot have children — strip them to avoid render error\n          return ({ children: _children, ...rest }: any) => h(prop, rest);\n        }\n        return (props: any) => h(prop, props);\n      }\n      return undefined;\n    },\n  });\n\n  // Cast wrappedComponents to any to satisfy getHTML's dictionary typing\n  return h(Fragment, null, getHTML(content, wrappedComponents as any));\n};\n\n/**\n * Hook that returns a function to render HTML content.\n *\n * This hook considers the configuration from the `HTMLProvider` context if available,\n * falling back to the provided components.\n */\nexport const useHTMLRenderer = ({ components }: RenderHTMLProps = {}) => {\n  const context = useHTMLContext();\n\n  return (content: string) => {\n    return renderHTML(content, {\n      components: {\n        ...context?.components,\n        ...components,\n      },\n    });\n  };\n};\n\nexport type HTMLRendererProps = RenderHTMLProps & {\n  /**\n   * The HTML content to render as a string.\n   */\n  children?: string;\n  /**\n   * Alias for children, used by the plugin.\n   */\n  html?: string;\n  /**\n   * Alias for components, used by the plugin.\n   */\n  components?: HTMLComponents<'permissive', {}>;\n  dictionaryKey?: string;\n  keyPath?: KeyPath[];\n};\n\n/**\n * Preact component that renders HTML-like content to JSX.\n */\nexport const HTMLRenderer: FunctionComponent<HTMLRendererProps> = ({\n  children = '',\n  html,\n  components,\n}) => {\n  const render = useHTMLRenderer({ components });\n  const content = children || html || '';\n\n  return render(content);\n};\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,cACX,SACA,EAAE,aAAa,CAAC,MAAuB,CAAC,MACxB;CAEhB,MAAM,iBAAiB,OAAO,YAC5B,OAAO,QAAQ,UAAU,CAAC,CACvB,QAAQ,GAAG,eAAe,SAAS,CAAC,CACpC,KAAK,CAAC,KAAK,eAAe,CACzB,MACC,UAAe,EAAE,WAAkB,KAAK,CAC3C,CAAC,CACL;CAGA,MAAM,oBAAoB,IAAI,MAAM,gBAAgB,EAClD,IAAI,QAAQ,MAAM;EAChB,IAAI,OAAO,SAAS,YAAY,QAAQ,QACtC,OAAO,OAAO;EAGhB,IAAI,OAAO,SAAS,YAAY,mBAAmB,KAAK,IAAI,GAAG;GAC7D,IAAI,mBAAmB,IAAI,IAAI,GAE7B,QAAQ,EAAE,UAAU,WAAW,GAAG,WAAgB,EAAE,MAAM,IAAI;GAEhE,QAAQ,UAAe,EAAE,MAAM,KAAK;EACtC;CAEF,EACF,CAAC;CAGD,OAAO,EAAE,UAAU,MAAM,QAAQ,SAAS,iBAAwB,CAAC;AACrE;;;;;;;AAQA,MAAa,mBAAmB,EAAE,eAAgC,CAAC,MAAM;CACvE,MAAM,UAAU,eAAe;CAE/B,QAAQ,YAAoB;EAC1B,OAAO,WAAW,SAAS,EACzB,YAAY;GACV,GAAG,SAAS;GACZ,GAAG;EACL,EACF,CAAC;CACH;AACF;;;;AAsBA,MAAa,gBAAsD,EACjE,WAAW,IACX,MACA,iBACI;CAIJ,OAHe,gBAAgB,EAAE,WAAW,CAGhC,CAAC,CAFG,YAAY,QAAQ,EAEf;AACvB"}

package/dist/esm/markdown/MarkdownProvider.mjs

@@ -32,7 +32,8 @@ const MarkdownProvider = ({ children, components, wrapper, forceBlock, forceInli
 		tagfilter
 	};
 	const defaultRenderMarkdown = (markdown, options, componentsOverride, wrapperOverride) => {
-		return compileMarkdown(markdown, mergeOptions(components, baseOptions, options, componentsOverride ?? {}, wrapperOverride));
+		const mergedOptions = mergeOptions(components, baseOptions, options, componentsOverride ?? {}, wrapperOverride);
+		return compileMarkdown(markdown, mergedOptions);
 	};
 	const customRenderMarkdownWrapper = (markdown, options, componentsOverride, wrapperOverride) => /* @__PURE__ */ jsx(MarkdownContext.Provider, {
 		value: void 0,

package/dist/esm/markdown/MarkdownProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownProvider.mjs","names":[],"sources":["../../../src/markdown/MarkdownProvider.tsx"],"sourcesContent":["import {\n  type ComponentChildren,\n  type ComponentType,\n  createContext,\n  type FunctionComponent,\n  type JSX,\n} from 'preact';\nimport { useContext } from 'preact/hooks';\nimport type { HTMLComponents } from '../html/types';\nimport { compileMarkdown, type ParsedMarkdown } from './compiler';\n\ntype PropsWithChildren<P = {}> = P & { children?: ComponentChildren };\n\n/**\n * Refined options for the MarkdownProvider.\n */\nexport type MarkdownProviderOptions = {\n  /**\n   * Forces the compiler to always output content with a block-level wrapper.\n   */\n  forceBlock?: boolean;\n  /**\n   * Forces the compiler to always output content with an inline wrapper.\n   */\n  forceInline?: boolean;\n  /**\n   * Whether to preserve frontmatter in the markdown content.\n   */\n  preserveFrontmatter?: boolean;\n  /**\n   * Whether to use the GitHub Tag Filter.\n   */\n  tagfilter?: boolean;\n};\n\ntype RenderMarkdownOptions = MarkdownProviderOptions & {\n  components?: HTMLComponents<'permissive', {}>;\n  wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements;\n  forceWrapper?: boolean;\n};\n\ntype MarkdownContextValue = {\n  components?: HTMLComponents<'permissive', {}>;\n  renderMarkdown: (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    components?: HTMLComponents<'permissive', {}>,\n    wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ) => ComponentChildren | Promise<ComponentChildren>;\n};\n\ntype MarkdownProviderProps = PropsWithChildren<\n  MarkdownProviderOptions & {\n    /**\n     * Component overrides for HTML tags.\n     */\n    components?: HTMLComponents<'permissive', {}>;\n    /**\n     * Wrapper element or component to be used when there are multiple children.\n     */\n    wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements;\n    /**\n     * Custom render function for markdown.\n     * If provided, it will overwrite all rules and default rendering.\n     */\n    renderMarkdown?: (\n      markdown: string | ParsedMarkdown,\n      options?: MarkdownProviderOptions,\n      components?: HTMLComponents<'permissive', {}>,\n      wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n    ) => ComponentChildren | Promise<ComponentChildren>;\n  }\n>;\n\nconst MarkdownContext = createContext<MarkdownContextValue | undefined>(\n  undefined\n);\n\nexport const useMarkdownContext = () => useContext(MarkdownContext);\n\nconst mergeOptions = (\n  baseComponents: HTMLComponents<'permissive', {}> | undefined,\n  baseOptions: Omit<RenderMarkdownOptions, 'components'>,\n  options: MarkdownProviderOptions = {},\n  components: HTMLComponents<'permissive', {}> = {},\n  wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n): RenderMarkdownOptions => {\n  return {\n    ...baseOptions,\n    ...options,\n    forceBlock: options.forceBlock ?? baseOptions.forceBlock,\n    forceInline: options.forceInline ?? baseOptions.forceInline,\n    preserveFrontmatter:\n      options.preserveFrontmatter ?? baseOptions.preserveFrontmatter,\n    tagfilter: options.tagfilter ?? baseOptions.tagfilter,\n    wrapper: wrapper || baseOptions.wrapper,\n    forceWrapper: !!(wrapper || baseOptions.wrapper),\n    components: { ...baseComponents, ...components },\n  };\n};\n\nexport const MarkdownProvider: FunctionComponent<MarkdownProviderProps> = ({\n  children,\n  components,\n  wrapper,\n  forceBlock,\n  forceInline,\n  preserveFrontmatter,\n  tagfilter,\n  renderMarkdown: customRenderFn,\n}) => {\n  const baseOptions: Omit<RenderMarkdownOptions, 'components'> = {\n    forceBlock,\n    forceInline,\n    wrapper,\n    forceWrapper: !!wrapper,\n    preserveFrontmatter,\n    tagfilter,\n  };\n\n  // Standard internal renderer\n  const defaultRenderMarkdown = (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    componentsOverride?: HTMLComponents<'permissive', {}>,\n    wrapperOverride?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ): ComponentChildren => {\n    const mergedOptions = mergeOptions(\n      components,\n      baseOptions,\n      options,\n      componentsOverride ?? {},\n      wrapperOverride\n    );\n    return compileMarkdown(markdown, mergedOptions) as ComponentChildren;\n  };\n\n  // Wrapper for user-provided custom renderer\n  // Note: We wrap in a clean Provider to prevent infinite recursion\n  const customRenderMarkdownWrapper = (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    componentsOverride?: HTMLComponents<'permissive', {}>,\n    wrapperOverride?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ): ComponentChildren => (\n    <MarkdownContext.Provider value={undefined}>\n      {customRenderFn?.(markdown, options, componentsOverride, wrapperOverride)}\n    </MarkdownContext.Provider>\n  );\n\n  return (\n    <MarkdownContext.Provider\n      value={{\n        components,\n        renderMarkdown: customRenderFn\n          ? customRenderMarkdownWrapper\n          : defaultRenderMarkdown,\n      }}\n    >\n      {children}\n    </MarkdownContext.Provider>\n  );\n};\n"],"mappings":";;;;;;AA0EA,MAAM,kBAAkB,cACtB,MACF;AAEA,MAAa,2BAA2B,WAAW,eAAe;AAElE,MAAM,gBACJ,gBACA,aACA,UAAmC,CAAC,GACpC,aAA+C,CAAC,GAChD,YAC0B;CAC1B,OAAO;EACL,GAAG;EACH,GAAG;EACH,YAAY,QAAQ,cAAc,YAAY;EAC9C,aAAa,QAAQ,eAAe,YAAY;EAChD,qBACE,QAAQ,uBAAuB,YAAY;EAC7C,WAAW,QAAQ,aAAa,YAAY;EAC5C,SAAS,WAAW,YAAY;EAChC,cAAc,CAAC,EAAE,WAAW,YAAY;EACxC,YAAY;GAAE,GAAG;GAAgB,GAAG;EAAW;CACjD;AACF;AAEA,MAAa,oBAA8D,EACzE,UACA,YACA,SACA,YACA,aACA,qBACA,WACA,gBAAgB,qBACZ;CACJ,MAAM,cAAyD;EAC7D;EACA;EACA;EACA,cAAc,CAAC,CAAC;EAChB;EACA;CACF;CAGA,MAAM,yBACJ,UACA,SACA,oBACA,oBACsB;EAQtB,OAAO,gBAAgB,UAPD,aACpB,YACA,aACA,SACA,sBAAsB,CAAC,GACvB,eAE2C,CAAC;CAChD;CAIA,MAAM,+BACJ,UACA,SACA,oBACA,oBAEA,oBAAC,gBAAgB,UAAjB;EAA0B,OAAO;YAC9B,iBAAiB,UAAU,SAAS,oBAAoB,eAAe;CAChD;CAG5B,OACE,oBAAC,gBAAgB,UAAjB;EACE,OAAO;GACL;GACA,gBAAgB,iBACZ,8BACA;EACN;EAEC;CACuB;AAE9B"}
+{"version":3,"file":"MarkdownProvider.mjs","names":[],"sources":["../../../src/markdown/MarkdownProvider.tsx"],"sourcesContent":["import {\n  type ComponentChildren,\n  type ComponentType,\n  createContext,\n  type FunctionComponent,\n  type JSX,\n} from 'preact';\nimport { useContext } from 'preact/hooks';\nimport type { HTMLComponents } from '../html/types';\nimport { compileMarkdown, type ParsedMarkdown } from './compiler';\n\ntype PropsWithChildren<P = {}> = P & { children?: ComponentChildren };\n\n/**\n * Refined options for the MarkdownProvider.\n */\nexport type MarkdownProviderOptions = {\n  /**\n   * Forces the compiler to always output content with a block-level wrapper.\n   */\n  forceBlock?: boolean;\n  /**\n   * Forces the compiler to always output content with an inline wrapper.\n   */\n  forceInline?: boolean;\n  /**\n   * Whether to preserve frontmatter in the markdown content.\n   */\n  preserveFrontmatter?: boolean;\n  /**\n   * Whether to use the GitHub Tag Filter.\n   */\n  tagfilter?: boolean;\n};\n\ntype RenderMarkdownOptions = MarkdownProviderOptions & {\n  components?: HTMLComponents<'permissive', {}>;\n  wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements;\n  forceWrapper?: boolean;\n};\n\ntype MarkdownContextValue = {\n  components?: HTMLComponents<'permissive', {}>;\n  renderMarkdown: (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    components?: HTMLComponents<'permissive', {}>,\n    wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ) => ComponentChildren | Promise<ComponentChildren>;\n};\n\ntype MarkdownProviderProps = PropsWithChildren<\n  MarkdownProviderOptions & {\n    /**\n     * Component overrides for HTML tags.\n     */\n    components?: HTMLComponents<'permissive', {}>;\n    /**\n     * Wrapper element or component to be used when there are multiple children.\n     */\n    wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements;\n    /**\n     * Custom render function for markdown.\n     * If provided, it will overwrite all rules and default rendering.\n     */\n    renderMarkdown?: (\n      markdown: string | ParsedMarkdown,\n      options?: MarkdownProviderOptions,\n      components?: HTMLComponents<'permissive', {}>,\n      wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n    ) => ComponentChildren | Promise<ComponentChildren>;\n  }\n>;\n\nconst MarkdownContext = createContext<MarkdownContextValue | undefined>(\n  undefined\n);\n\nexport const useMarkdownContext = () => useContext(MarkdownContext);\n\nconst mergeOptions = (\n  baseComponents: HTMLComponents<'permissive', {}> | undefined,\n  baseOptions: Omit<RenderMarkdownOptions, 'components'>,\n  options: MarkdownProviderOptions = {},\n  components: HTMLComponents<'permissive', {}> = {},\n  wrapper?: ComponentType<any> | keyof JSX.IntrinsicElements\n): RenderMarkdownOptions => {\n  return {\n    ...baseOptions,\n    ...options,\n    forceBlock: options.forceBlock ?? baseOptions.forceBlock,\n    forceInline: options.forceInline ?? baseOptions.forceInline,\n    preserveFrontmatter:\n      options.preserveFrontmatter ?? baseOptions.preserveFrontmatter,\n    tagfilter: options.tagfilter ?? baseOptions.tagfilter,\n    wrapper: wrapper || baseOptions.wrapper,\n    forceWrapper: !!(wrapper || baseOptions.wrapper),\n    components: { ...baseComponents, ...components },\n  };\n};\n\nexport const MarkdownProvider: FunctionComponent<MarkdownProviderProps> = ({\n  children,\n  components,\n  wrapper,\n  forceBlock,\n  forceInline,\n  preserveFrontmatter,\n  tagfilter,\n  renderMarkdown: customRenderFn,\n}) => {\n  const baseOptions: Omit<RenderMarkdownOptions, 'components'> = {\n    forceBlock,\n    forceInline,\n    wrapper,\n    forceWrapper: !!wrapper,\n    preserveFrontmatter,\n    tagfilter,\n  };\n\n  // Standard internal renderer\n  const defaultRenderMarkdown = (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    componentsOverride?: HTMLComponents<'permissive', {}>,\n    wrapperOverride?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ): ComponentChildren => {\n    const mergedOptions = mergeOptions(\n      components,\n      baseOptions,\n      options,\n      componentsOverride ?? {},\n      wrapperOverride\n    );\n    return compileMarkdown(markdown, mergedOptions) as ComponentChildren;\n  };\n\n  // Wrapper for user-provided custom renderer\n  // Note: We wrap in a clean Provider to prevent infinite recursion\n  const customRenderMarkdownWrapper = (\n    markdown: string | ParsedMarkdown,\n    options?: MarkdownProviderOptions,\n    componentsOverride?: HTMLComponents<'permissive', {}>,\n    wrapperOverride?: ComponentType<any> | keyof JSX.IntrinsicElements\n  ): ComponentChildren => (\n    <MarkdownContext.Provider value={undefined}>\n      {customRenderFn?.(markdown, options, componentsOverride, wrapperOverride)}\n    </MarkdownContext.Provider>\n  );\n\n  return (\n    <MarkdownContext.Provider\n      value={{\n        components,\n        renderMarkdown: customRenderFn\n          ? customRenderMarkdownWrapper\n          : defaultRenderMarkdown,\n      }}\n    >\n      {children}\n    </MarkdownContext.Provider>\n  );\n};\n"],"mappings":";;;;;;AA0EA,MAAM,kBAAkB,cACtB,MACF;AAEA,MAAa,2BAA2B,WAAW,eAAe;AAElE,MAAM,gBACJ,gBACA,aACA,UAAmC,CAAC,GACpC,aAA+C,CAAC,GAChD,YAC0B;CAC1B,OAAO;EACL,GAAG;EACH,GAAG;EACH,YAAY,QAAQ,cAAc,YAAY;EAC9C,aAAa,QAAQ,eAAe,YAAY;EAChD,qBACE,QAAQ,uBAAuB,YAAY;EAC7C,WAAW,QAAQ,aAAa,YAAY;EAC5C,SAAS,WAAW,YAAY;EAChC,cAAc,CAAC,EAAE,WAAW,YAAY;EACxC,YAAY;GAAE,GAAG;GAAgB,GAAG;EAAW;CACjD;AACF;AAEA,MAAa,oBAA8D,EACzE,UACA,YACA,SACA,YACA,aACA,qBACA,WACA,gBAAgB,qBACZ;CACJ,MAAM,cAAyD;EAC7D;EACA;EACA;EACA,cAAc,CAAC,CAAC;EAChB;EACA;CACF;CAGA,MAAM,yBACJ,UACA,SACA,oBACA,oBACsB;EACtB,MAAM,gBAAgB,aACpB,YACA,aACA,SACA,sBAAsB,CAAC,GACvB,eACF;EACA,OAAO,gBAAgB,UAAU,aAAa;CAChD;CAIA,MAAM,+BACJ,UACA,SACA,oBACA,oBAEA,oBAAC,gBAAgB,UAAjB;EAA0B,OAAO;YAC9B,iBAAiB,UAAU,SAAS,oBAAoB,eAAe;CAChD;CAG5B,OACE,oBAAC,gBAAgB,UAAjB;EACE,OAAO;GACL;GACA,gBAAgB,iBACZ,8BACA;EACN;EAEC;CACuB;AAE9B"}

package/dist/esm/markdown/MarkdownRendererPlugin.mjs

@@ -16,7 +16,8 @@ const MarkdownRendererPlugin = (props) => {
 };
 const MarkdownMetadataRenderer = ({ children, metadataKeyPath }) => {
 	const { locale: currentLocale } = useLocale();
-	return getContentNodeByKeyPath(getMarkdownMetadata(children), metadataKeyPath, currentLocale);
+	const metadata = getMarkdownMetadata(children);
+	return getContentNodeByKeyPath(metadata, metadataKeyPath, currentLocale);
 };
 
 //#endregion

package/dist/esm/markdown/MarkdownRendererPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownRendererPlugin.mjs","names":[],"sources":["../../../src/markdown/MarkdownRendererPlugin.tsx"],"sourcesContent":["'use client';\n\nimport { getContentNodeByKeyPath } from '@intlayer/core/dictionaryManipulator';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { ComponentChildren, FunctionComponent } from 'preact';\nimport { useLocale } from '../client/useLocale';\nimport type { HTMLComponents } from '../html/types';\nimport {\n  type MarkdownProviderOptions,\n  useMarkdownContext,\n} from './MarkdownProvider';\n\ntype MarkdownRendererPluginProps = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: LocalesValues;\n  children: string;\n  options?: MarkdownProviderOptions;\n  components?: HTMLComponents<'permissive', {}>;\n};\n\nexport const MarkdownRendererPlugin: FunctionComponent<\n  MarkdownRendererPluginProps\n> = (props): ComponentChildren => {\n  const { children, options, components } = props;\n  const context = useMarkdownContext();\n  const renderMarkdown = context?.renderMarkdown ?? ((md) => md);\n\n  return renderMarkdown(children, options, {\n    ...(context?.components ?? {}),\n    ...(components ?? {}),\n  }) as ComponentChildren;\n};\n\ntype MarkdownMetadataRendererProps = MarkdownRendererPluginProps & {\n  metadataKeyPath: KeyPath[];\n};\n\nexport const MarkdownMetadataRenderer: FunctionComponent<\n  MarkdownMetadataRendererProps\n> = ({ children, metadataKeyPath }): ComponentChildren => {\n  const { locale: currentLocale } = useLocale();\n\n  const metadata = getMarkdownMetadata(children);\n\n  const metadataEl = getContentNodeByKeyPath(\n    metadata as ContentNode,\n    metadataKeyPath,\n    currentLocale as any\n  );\n\n  return metadataEl as ComponentChildren;\n};\n"],"mappings":";;;;;;;;AAwBA,MAAa,0BAER,UAA6B;CAChC,MAAM,EAAE,UAAU,SAAS,eAAe;CAC1C,MAAM,UAAU,mBAAmB;CAGnC,QAFuB,SAAS,oBAAoB,OAAO,IAEtC,CAAC,UAAU,SAAS;EACvC,GAAI,SAAS,cAAc,CAAC;EAC5B,GAAI,cAAc,CAAC;CACrB,CAAC;AACH;AAMA,MAAa,4BAER,EAAE,UAAU,sBAAyC;CACxD,MAAM,EAAE,QAAQ,kBAAkB,UAAU;CAU5C,OANmB,wBAFF,oBAAoB,QAG5B,GACP,iBACA,aAGc;AAClB"}
+{"version":3,"file":"MarkdownRendererPlugin.mjs","names":[],"sources":["../../../src/markdown/MarkdownRendererPlugin.tsx"],"sourcesContent":["'use client';\n\nimport { getContentNodeByKeyPath } from '@intlayer/core/dictionaryManipulator';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { ContentNode } from '@intlayer/types/dictionary';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { ComponentChildren, FunctionComponent } from 'preact';\nimport { useLocale } from '../client/useLocale';\nimport type { HTMLComponents } from '../html/types';\nimport {\n  type MarkdownProviderOptions,\n  useMarkdownContext,\n} from './MarkdownProvider';\n\ntype MarkdownRendererPluginProps = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: LocalesValues;\n  children: string;\n  options?: MarkdownProviderOptions;\n  components?: HTMLComponents<'permissive', {}>;\n};\n\nexport const MarkdownRendererPlugin: FunctionComponent<\n  MarkdownRendererPluginProps\n> = (props): ComponentChildren => {\n  const { children, options, components } = props;\n  const context = useMarkdownContext();\n  const renderMarkdown = context?.renderMarkdown ?? ((md) => md);\n\n  return renderMarkdown(children, options, {\n    ...(context?.components ?? {}),\n    ...(components ?? {}),\n  }) as ComponentChildren;\n};\n\ntype MarkdownMetadataRendererProps = MarkdownRendererPluginProps & {\n  metadataKeyPath: KeyPath[];\n};\n\nexport const MarkdownMetadataRenderer: FunctionComponent<\n  MarkdownMetadataRendererProps\n> = ({ children, metadataKeyPath }): ComponentChildren => {\n  const { locale: currentLocale } = useLocale();\n\n  const metadata = getMarkdownMetadata(children);\n\n  const metadataEl = getContentNodeByKeyPath(\n    metadata as ContentNode,\n    metadataKeyPath,\n    currentLocale as any\n  );\n\n  return metadataEl as ComponentChildren;\n};\n"],"mappings":";;;;;;;;AAwBA,MAAa,0BAER,UAA6B;CAChC,MAAM,EAAE,UAAU,SAAS,eAAe;CAC1C,MAAM,UAAU,mBAAmB;CAGnC,QAFuB,SAAS,oBAAoB,OAAO,IAEtC,CAAC,UAAU,SAAS;EACvC,GAAI,SAAS,cAAc,CAAC;EAC5B,GAAI,cAAc,CAAC;CACrB,CAAC;AACH;AAMA,MAAa,4BAER,EAAE,UAAU,sBAAyC;CACxD,MAAM,EAAE,QAAQ,kBAAkB,UAAU;CAE5C,MAAM,WAAW,oBAAoB,QAAQ;CAQ7C,OANmB,wBACjB,UACA,iBACA,aAGc;AAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "preact-intlayer",
-  "version": "9.2.0",
+  "version": "9.3.1",
   "private": false,
   "description": "Easily internationalize i18n your Preact applications with type-safe multilingual content management.",
   "keywords": [
@@ -100,19 +100,19 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.2.0",
-    "@intlayer/config": "9.2.0",
-    "@intlayer/core": "9.2.0",
-    "@intlayer/editor": "9.2.0",
-    "@intlayer/engine": "9.2.0",
-    "@intlayer/types": "9.2.0"
+    "@intlayer/api": "9.3.1",
+    "@intlayer/config": "9.3.1",
+    "@intlayer/core": "9.3.1",
+    "@intlayer/editor": "9.3.1",
+    "@intlayer/engine": "9.3.1",
+    "@intlayer/types": "9.3.1"
   },
   "devDependencies": {
-    "@types/node": "26.1.2",
+    "@types/node": "26.2.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
-    "preact": "10.29.7",
+    "preact": "10.29.8",
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
@@ -122,7 +122,7 @@
     "preact": ">=8.0.0"
   },
   "optionalDependencies": {
-    "@intlayer/analytics": "9.2.0"
+    "@intlayer/analytics": "9.3.1"
   },
   "engines": {
     "node": ">=14.18"