react-intlayer 7.6.0-canary.0 → 8.0.0-canary.2

package/dist/esm/getIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.mjs","names":["getIntlayerCore"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore, type Plugins } from '@intlayer/core';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types';\nimport {\n  type DeepTransformContent,\n  intlayerNodePlugins,\n  markdownPlugin,\n  reactNodePlugins,\n} from './plugins';\n\nexport const getIntlayer = <\n  T extends DictionaryKeys,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L,\n  additionalPlugins?: Plugins[]\n): DeepTransformContent<DictionaryRegistryContent<T>, L> => {\n  const plugins: Plugins[] = [\n    intlayerNodePlugins,\n    reactNodePlugins,\n    markdownPlugin,\n    ...(additionalPlugins ?? []),\n  ];\n\n  return getIntlayerCore(key, locale, plugins) as any;\n};\n"],"mappings":";;;;AAcA,MAAa,eAIX,KACA,QACA,sBAC0D;AAQ1D,QAAOA,cAAgB,KAAK,QAPD;EACzB;EACA;EACA;EACA,GAAI,qBAAqB,EAAE;EAC5B,CAE2C"}
+{"version":3,"file":"getIntlayer.mjs","names":["getIntlayerCore"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore, type Plugins } from '@intlayer/core';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types';\nimport {\n  type DeepTransformContent,\n  htmlPlugin,\n  insertionPlugin,\n  intlayerNodePlugins,\n  markdownPlugin,\n  reactNodePlugins,\n} from './plugins';\n\nexport const getIntlayer = <\n  T extends DictionaryKeys,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L,\n  additionalPlugins?: Plugins[]\n): DeepTransformContent<DictionaryRegistryContent<T>, L> => {\n  const plugins: Plugins[] = [\n    intlayerNodePlugins,\n    reactNodePlugins,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n    ...(additionalPlugins ?? []),\n  ];\n\n  return getIntlayerCore(key, locale, plugins) as any;\n};\n"],"mappings":";;;;AAgBA,MAAa,eAIX,KACA,QACA,sBAC0D;AAU1D,QAAOA,cAAgB,KAAK,QATD;EACzB;EACA;EACA;EACA;EACA;EACA,GAAI,qBAAqB,EAAE;EAC5B,CAE2C"}

package/dist/esm/html/HTMLProvider.mjs

@@ -0,0 +1,16 @@
+'use client';
+
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/html/HTMLProvider.tsx
+const HTMLContext = createContext(void 0);
+const useHTMLContext = () => useContext(HTMLContext);
+const HTMLProvider = ({ children, components }) => /* @__PURE__ */ jsx(HTMLContext.Provider, {
+	value: { components },
+	children
+});
+
+//#endregion
+export { HTMLProvider, useHTMLContext };
+//# sourceMappingURL=HTMLProvider.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLProvider.mjs","names":[],"sources":["../../../src/html/HTMLProvider.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  type FC,\n  type PropsWithChildren,\n  useContext,\n} from 'react';\n\ntype HTMLContextValue = {\n  components?: Record<string, any>;\n};\n\ntype HTMLProviderProps = PropsWithChildren<{\n  /**\n   * Component overrides for HTML tags.\n   */\n  components?: Record<string, any>;\n}>;\n\nconst HTMLContext = createContext<HTMLContextValue | undefined>(undefined);\n\nexport const useHTMLContext = () => useContext(HTMLContext);\n\nexport const HTMLProvider: FC<HTMLProviderProps> = ({\n  children,\n  components,\n}) => (\n  <HTMLContext.Provider value={{ components }}>{children}</HTMLContext.Provider>\n);\n"],"mappings":";;;;;;AAoBA,MAAM,cAAc,cAA4C,OAAU;AAE1E,MAAa,uBAAuB,WAAW,YAAY;AAE3D,MAAa,gBAAuC,EAClD,UACA,iBAEA,oBAAC,YAAY;CAAS,OAAO,EAAE,YAAY;CAAG;EAAgC"}

package/dist/esm/html/HTMLRenderer.mjs

@@ -0,0 +1,55 @@
+'use client';
+
+import { useHTMLContext } from "./HTMLProvider.mjs";
+import { Fragment, createElement } from "react";
+import { jsx } from "react/jsx-runtime";
+import { HTML_TAGS, getHTML } from "@intlayer/core";
+
+//#region src/html/HTMLRenderer.tsx
+const createDefaultHTMLComponents = () => {
+	const components = {};
+	for (const tag of HTML_TAGS) components[tag] = ({ children, ...props }) => createElement(tag, props, children);
+	return components;
+};
+const defaultHTMLComponents = createDefaultHTMLComponents();
+/**
+* Renders HTML-like content to JSX with the provided components.
+*
+* This function does not use context from HTMLProvider. Use `useHTMLRenderer`
+* hook if you want to leverage provider context.
+*/
+const renderHTML = (content, { components } = {}) => {
+	const mergedComponents = {
+		...defaultHTMLComponents,
+		...components
+	};
+	return /* @__PURE__ */ jsx(Fragment, { children: getHTML(content, Object.fromEntries(Object.entries(mergedComponents).filter(([, Component]) => Component).map(([key, Component]) => [key, (props) => createElement(Component, props)]))) });
+};
+/**
+* Hook that returns a function to render HTML content.
+*
+* This hook considers the configuration from the `HTMLProvider` context if available,
+* falling back to the provided components.
+*/
+const useHTMLRenderer = ({ components } = {}) => {
+	const context = useHTMLContext();
+	return (content) => {
+		return renderHTML(content, { components: {
+			...context?.components,
+			...components
+		} });
+	};
+};
+/**
+* React component that renders HTML-like content to JSX.
+*
+* This component uses the components from the `HTMLProvider` context
+* if available.
+*/
+const HTMLRenderer = ({ children = "", components }) => {
+	return useHTMLRenderer({ components })(children);
+};
+
+//#endregion
+export { HTMLRenderer, defaultHTMLComponents, renderHTML, useHTMLRenderer };
+//# sourceMappingURL=HTMLRenderer.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLRenderer.mjs","names":[],"sources":["../../../src/html/HTMLRenderer.tsx"],"sourcesContent":["'use client';\n\nimport { getHTML, HTML_TAGS } from '@intlayer/core';\nimport { createElement, type FC, Fragment, type JSX } from 'react';\nimport { useHTMLContext } from './HTMLProvider';\nimport type { ReactHTMLComponent } from './types';\n\n/**\n * Type for React HTML tag components.\n */\ntype HTMLTagComponent = ReactHTMLComponent;\n\nconst createDefaultHTMLComponents = (): Record<string, HTMLTagComponent> => {\n  const components: Record<string, HTMLTagComponent> = {};\n\n  for (const tag of HTML_TAGS) {\n    components[tag] = ({ children, ...props }) =>\n      createElement(tag, props, children);\n  }\n\n  return components;\n};\n\nexport const defaultHTMLComponents = createDefaultHTMLComponents();\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?: Record<string, any>;\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  const mergedComponents = {\n    ...defaultHTMLComponents,\n    ...components,\n  };\n\n  // Wrap all components to ensure they are rendered via React.createElement\n  const wrappedComponents = Object.fromEntries(\n    Object.entries(mergedComponents)\n      .filter(([, Component]) => Component)\n      .map(([key, Component]) => [\n        key,\n        (props: any) => createElement(Component as any, props),\n      ])\n  );\n\n  return <Fragment>{getHTML(content, wrappedComponents)}</Fragment>;\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\n/**\n * React component that renders HTML-like content to JSX.\n *\n * This component uses the components from the `HTMLProvider` context\n * if available.\n */\nexport const HTMLRenderer: FC<HTMLRendererProps> = ({\n  children = '',\n  components,\n}) => {\n  const render = useHTMLRenderer({ components });\n\n  return render(children);\n};\n"],"mappings":";;;;;;;;AAYA,MAAM,oCAAsE;CAC1E,MAAM,aAA+C,EAAE;AAEvD,MAAK,MAAM,OAAO,UAChB,YAAW,QAAQ,EAAE,UAAU,GAAG,YAChC,cAAc,KAAK,OAAO,SAAS;AAGvC,QAAO;;AAGT,MAAa,wBAAwB,6BAA6B;;;;;;;AAgBlE,MAAa,cACX,SACA,EAAE,eAAgC,EAAE,KACpB;CAChB,MAAM,mBAAmB;EACvB,GAAG;EACH,GAAG;EACJ;AAYD,QAAO,oBAAC,sBAAU,QAAQ,SATA,OAAO,YAC/B,OAAO,QAAQ,iBAAiB,CAC7B,QAAQ,GAAG,eAAe,UAAU,CACpC,KAAK,CAAC,KAAK,eAAe,CACzB,MACC,UAAe,cAAc,WAAkB,MAAM,CACvD,CAAC,CACL,CAEoD,GAAY;;;;;;;;AASnE,MAAa,mBAAmB,EAAE,eAAgC,EAAE,KAAK;CACvE,MAAM,UAAU,gBAAgB;AAEhC,SAAQ,YAAoB;AAC1B,SAAO,WAAW,SAAS,EACzB,YAAY;GACV,GAAG,SAAS;GACZ,GAAG;GACJ,EACF,CAAC;;;;;;;;;AAiBN,MAAa,gBAAuC,EAClD,WAAW,IACX,iBACI;AAGJ,QAFe,gBAAgB,EAAE,YAAY,CAAC,CAEhC,SAAS"}

package/dist/esm/html/HTMLRendererPlugin.mjs

@@ -0,0 +1,35 @@
+'use client';
+
+import { ContentSelectorRenderer } from "../editor/ContentSelectorWrapper.mjs";
+import { useEditedContentRenderer } from "../editor/useEditedContentRenderer.mjs";
+import { useHTMLContext } from "./HTMLProvider.mjs";
+import { defaultHTMLComponents } from "./HTMLRenderer.mjs";
+import { createElement } from "react";
+import { jsx } from "react/jsx-runtime";
+import { getHTML } from "@intlayer/core";
+
+//#region src/html/HTMLRendererPlugin.tsx
+const HTMLRendererPlugin = (props) => {
+	const { dictionaryKey, keyPath, html, userComponents } = props;
+	const globalComponents = useHTMLContext()?.components || {};
+	const editedContentContext = useEditedContentRenderer({
+		dictionaryKey: dictionaryKey ?? "",
+		keyPath: keyPath ?? [],
+		children: html
+	});
+	const contentToRender = typeof editedContentContext === "string" ? editedContentContext : html;
+	const mergedComponents = {
+		...defaultHTMLComponents,
+		...globalComponents,
+		...userComponents
+	};
+	const wrappedComponents = Object.fromEntries(Object.entries(mergedComponents).filter(([, Component]) => Component).map(([key, Component]) => [key, (props) => createElement(Component, props)]));
+	return /* @__PURE__ */ jsx(ContentSelectorRenderer, {
+		...props,
+		children: getHTML(contentToRender, wrappedComponents)
+	});
+};
+
+//#endregion
+export { HTMLRendererPlugin };
+//# sourceMappingURL=HTMLRendererPlugin.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLRendererPlugin.mjs","names":[],"sources":["../../../src/html/HTMLRendererPlugin.tsx"],"sourcesContent":["'use client';\n\nimport { getHTML } from '@intlayer/core';\nimport type { KeyPath, Locale } from '@intlayer/types';\nimport { createElement, type FC, type ReactNode } from 'react';\nimport { ContentSelectorRenderer } from '../editor';\nimport { useEditedContentRenderer } from '../editor/useEditedContentRenderer';\nimport { useHTMLContext } from './HTMLProvider';\nimport { defaultHTMLComponents } from './HTMLRenderer';\nimport type { ReactComponentProps } from './types';\n\ntype HTMLRendererPluginProps = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  html: string;\n  locale?: Locale;\n  userComponents?: Record<string, any>;\n};\n\nexport const HTMLRendererPlugin: FC<HTMLRendererPluginProps> = (\n  props\n): ReactNode => {\n  const { dictionaryKey, keyPath, html, userComponents } = props;\n  const context = useHTMLContext();\n  const globalComponents = context?.components || {};\n\n  const editedContentContext = useEditedContentRenderer({\n    dictionaryKey: dictionaryKey ?? '',\n    keyPath: keyPath ?? [],\n    children: html,\n  });\n\n  const contentToRender =\n    typeof editedContentContext === 'string' ? editedContentContext : html;\n\n  const mergedComponents = {\n    ...defaultHTMLComponents,\n    ...globalComponents,\n    ...userComponents,\n  };\n\n  // Wrap all components to ensure they are rendered via React.createElement\n  // This is important because it allows React to handle the component's lifecycle,\n  // hooks, and Babel-injected variables correctly.\n  const wrappedComponents = Object.fromEntries(\n    Object.entries(mergedComponents)\n      .filter(([, Component]) => Component)\n      .map(([key, Component]) => [\n        key,\n        (props: ReactComponentProps) => createElement(Component, props),\n      ])\n  );\n\n  return (\n    <ContentSelectorRenderer {...props}>\n      {getHTML(contentToRender, wrappedComponents)}\n    </ContentSelectorRenderer>\n  );\n};\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,sBACX,UACc;CACd,MAAM,EAAE,eAAe,SAAS,MAAM,mBAAmB;CAEzD,MAAM,mBADU,gBAAgB,EACE,cAAc,EAAE;CAElD,MAAM,uBAAuB,yBAAyB;EACpD,eAAe,iBAAiB;EAChC,SAAS,WAAW,EAAE;EACtB,UAAU;EACX,CAAC;CAEF,MAAM,kBACJ,OAAO,yBAAyB,WAAW,uBAAuB;CAEpE,MAAM,mBAAmB;EACvB,GAAG;EACH,GAAG;EACH,GAAG;EACJ;CAKD,MAAM,oBAAoB,OAAO,YAC/B,OAAO,QAAQ,iBAAiB,CAC7B,QAAQ,GAAG,eAAe,UAAU,CACpC,KAAK,CAAC,KAAK,eAAe,CACzB,MACC,UAA+B,cAAc,WAAW,MAAM,CAChE,CAAC,CACL;AAED,QACE,oBAAC;EAAwB,GAAI;YAC1B,QAAQ,iBAAiB,kBAAkB;GACpB"}

package/dist/esm/html/index.mjs

@@ -0,0 +1,5 @@
+import { HTMLProvider, useHTMLContext } from "./HTMLProvider.mjs";
+import { HTMLRenderer, defaultHTMLComponents, renderHTML, useHTMLRenderer } from "./HTMLRenderer.mjs";
+import { HTMLRendererPlugin } from "./HTMLRendererPlugin.mjs";
+
+export { HTMLProvider, HTMLRenderer, HTMLRendererPlugin, defaultHTMLComponents, renderHTML, useHTMLContext, useHTMLRenderer };

package/dist/esm/index.mjs

@@ -10,7 +10,11 @@ import { getIntlayer } from "./getIntlayer.mjs";
 import { useIntlayer } from "./client/useIntlayer.mjs";
 import { useLocale } from "./client/useLocale.mjs";
 import { useLocaleBase } from "./client/useLocaleBase.mjs";
+import { HTMLProvider } from "./html/HTMLProvider.mjs";
+import { HTMLRenderer, renderHTML, useHTMLRenderer } from "./html/HTMLRenderer.mjs";
 import { MarkdownProvider } from "./markdown/MarkdownProvider.mjs";
+import { MarkdownRenderer, renderMarkdown, useMarkdownRenderer } from "./markdown/MarkdownRenderer.mjs";
 import { getDictionary } from "./getDictionary.mjs";
+import { useIntl } from "./client/format/useIntl.mjs";
 
-export { IntlayerClientContext, IntlayerProvider, IntlayerProviderContent, MarkdownProvider, getDictionary, getIntlayer, localeCookie, localeInStorage, setLocaleCookie, setLocaleInStorage, t, useDictionary, useDictionaryAsync, useDictionaryDynamic, useI18n, useIntlayer, useIntlayerContext, useLoadDynamic, useLocale, useLocaleBase, useLocaleCookie, useLocaleStorage };
+export { HTMLProvider, HTMLRenderer, IntlayerClientContext, IntlayerProvider, IntlayerProviderContent, MarkdownProvider, MarkdownRenderer, getDictionary, getIntlayer, localeCookie, localeInStorage, renderHTML, renderMarkdown, setLocaleCookie, setLocaleInStorage, t, useDictionary, useDictionaryAsync, useDictionaryDynamic, useHTMLRenderer, useI18n, useIntl, useIntlayer, useIntlayerContext, useLoadDynamic, useLocale, useLocaleBase, useLocaleCookie, useLocaleStorage, useMarkdownRenderer };

package/dist/esm/markdown/MarkdownProvider.mjs

@@ -1,15 +1,86 @@
 'use client';
 
+import { compiler } from "./processor.mjs";
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/markdown/MarkdownProvider.tsx
-const MarkdownContext = createContext({ renderMarkdown: (markdown) => markdown });
+const MarkdownContext = createContext(void 0);
 const useMarkdownContext = () => useContext(MarkdownContext);
-const MarkdownProvider = ({ children, renderMarkdown }) => /* @__PURE__ */ jsx(MarkdownContext.Provider, {
-	value: { renderMarkdown },
-	children
-});
+const isRenderMarkdownOptions = (override) => {
+	return override && typeof override === "object" && ("components" in override || "wrapper" in override || "forceBlock" in override || "forceInline" in override || "preserveFrontmatter" in override || "tagfilter" in override);
+};
+const mergeOptions = (baseOptions, overrides) => {
+	if (!overrides) return baseOptions;
+	if (!isRenderMarkdownOptions(overrides)) return {
+		...baseOptions,
+		components: {
+			...baseOptions.components,
+			...overrides
+		}
+	};
+	const { components: overrideComponents, wrapper, forceBlock, forceInline, preserveFrontmatter, tagfilter, ...componentsFromRest } = overrides;
+	const components = overrideComponents || componentsFromRest;
+	return {
+		...baseOptions,
+		forceBlock: forceBlock ?? baseOptions.forceBlock,
+		forceInline: forceInline ?? baseOptions.forceInline,
+		preserveFrontmatter: preserveFrontmatter ?? baseOptions.preserveFrontmatter,
+		tagfilter: tagfilter ?? baseOptions.tagfilter,
+		wrapper: wrapper || baseOptions.wrapper,
+		forceWrapper: !!(wrapper || baseOptions.wrapper),
+		components: {
+			...baseOptions.components,
+			...components
+		}
+	};
+};
+/**
+* Provider for the MarkdownRenderer component.
+*
+* It will provide the `renderMarkdown` function to the context, which can be used to render markdown.
+*
+* ```tsx
+* const content = useIntlayer('app');
+*
+* return (
+*   <div>
+*     {content.markdown} // Will be rendered with the components and options provided to the MarkdownProvider
+*   </div>
+* );
+* ```
+*
+* @example
+* ```tsx
+* <MarkdownProvider components={{ h1: CustomHeading }}>
+*   <MarkdownRenderer>
+*     {markdownContent}
+*   </MarkdownRenderer>
+* </MarkdownProvider>
+* ```
+*/
+const MarkdownProvider = ({ children, components, wrapper, forceBlock, forceInline, preserveFrontmatter, tagfilter, renderMarkdown: customRenderFn }) => {
+	const baseOptions = {
+		components,
+		forceBlock,
+		forceInline,
+		wrapper,
+		forceWrapper: !!wrapper,
+		preserveFrontmatter,
+		tagfilter
+	};
+	const defaultRenderMarkdown = (markdown, overrides) => {
+		return compiler(markdown, mergeOptions(baseOptions, overrides));
+	};
+	const customRenderMarkdownWrapper = (markdown, overrides) => /* @__PURE__ */ jsx(MarkdownContext.Provider, {
+		value: void 0,
+		children: customRenderFn?.(markdown, overrides)
+	});
+	return /* @__PURE__ */ jsx(MarkdownContext.Provider, {
+		value: { renderMarkdown: customRenderFn ? customRenderMarkdownWrapper : defaultRenderMarkdown },
+		children
+	});
+};
 
 //#endregion
 export { MarkdownProvider, useMarkdownContext };

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

@@ -1 +1 @@
-{"version":3,"file":"MarkdownProvider.mjs","names":[],"sources":["../../../src/markdown/MarkdownProvider.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  type FC,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n} from 'react';\n\ntype MarkdownContextValue = {\n  renderMarkdown: (markdown: string) => ReactNode;\n};\n\ntype MarkdownProviderProps = PropsWithChildren<MarkdownContextValue>;\n\nconst MarkdownContext = createContext<MarkdownContextValue>({\n  renderMarkdown: (markdown: string) => markdown,\n});\n\nexport const useMarkdownContext = () => useContext(MarkdownContext);\n\nexport const MarkdownProvider: FC<MarkdownProviderProps> = ({\n  children,\n  renderMarkdown,\n}) => (\n  <MarkdownContext.Provider value={{ renderMarkdown }}>\n    {children}\n  </MarkdownContext.Provider>\n);\n"],"mappings":";;;;;;AAgBA,MAAM,kBAAkB,cAAoC,EAC1D,iBAAiB,aAAqB,UACvC,CAAC;AAEF,MAAa,2BAA2B,WAAW,gBAAgB;AAEnE,MAAa,oBAA+C,EAC1D,UACA,qBAEA,oBAAC,gBAAgB;CAAS,OAAO,EAAE,gBAAgB;CAChD;EACwB"}
+{"version":3,"file":"MarkdownProvider.mjs","names":[],"sources":["../../../src/markdown/MarkdownProvider.tsx"],"sourcesContent":["'use client';\n\nimport type { Overrides } from '@intlayer/core';\nimport {\n  createContext,\n  type FC,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n} from 'react';\nimport { compiler, type MarkdownRendererOptions } from './processor';\n\nexport type MarkdownProviderOptions = {\n  /** Forces the compiler to always output content with a block-level wrapper. */\n  forceBlock?: boolean;\n  /** Forces the compiler to always output content with an inline wrapper. */\n  forceInline?: boolean;\n  /** Whether to preserve frontmatter in the markdown content. */\n  preserveFrontmatter?: boolean;\n  /** Whether to use the GitHub Tag Filter for security. */\n  tagfilter?: boolean;\n};\n\ntype RenderMarkdownOptions = MarkdownProviderOptions & {\n  components?: Overrides;\n  wrapper?: FC<any>;\n};\n\ntype MarkdownContextValue = {\n  renderMarkdown: (\n    markdown: string,\n    components?: Overrides | RenderMarkdownOptions\n  ) => ReactNode;\n};\n\ntype MarkdownProviderProps = PropsWithChildren<\n  MarkdownProviderOptions & {\n    components?: Overrides;\n    wrapper?: any;\n    renderMarkdown?: (\n      markdown: string,\n      overrides?: Overrides | RenderMarkdownOptions\n    ) => ReactNode;\n  }\n>;\n\nconst MarkdownContext = createContext<MarkdownContextValue | undefined>(\n  undefined\n);\n\nexport const useMarkdownContext = () => useContext(MarkdownContext);\n\n// Pure functions defined outside the component are easier for React Compiler to track\n// and don't need to be recreated on every render.\n\nconst isRenderMarkdownOptions = (\n  override: any\n): override is RenderMarkdownOptions => {\n  return (\n    override &&\n    typeof override === 'object' &&\n    ('components' in override ||\n      'wrapper' in override ||\n      'forceBlock' in override ||\n      'forceInline' in override ||\n      'preserveFrontmatter' in override ||\n      'tagfilter' in override)\n  );\n};\n\nconst mergeOptions = (\n  baseOptions: MarkdownRendererOptions,\n  overrides?: Overrides | RenderMarkdownOptions\n): MarkdownRendererOptions => {\n  if (!overrides) return baseOptions;\n\n  if (!isRenderMarkdownOptions(overrides)) {\n    // Overrides is just a component map\n    return {\n      ...baseOptions,\n      components: { ...baseOptions.components, ...overrides },\n    };\n  }\n\n  // Overrides is a full options object\n  const {\n    components: overrideComponents,\n    wrapper,\n    forceBlock,\n    forceInline,\n    preserveFrontmatter,\n    tagfilter,\n    ...componentsFromRest\n  } = overrides;\n\n  const components = overrideComponents || componentsFromRest;\n\n  return {\n    ...baseOptions,\n    forceBlock: forceBlock ?? baseOptions.forceBlock,\n    forceInline: forceInline ?? baseOptions.forceInline,\n    preserveFrontmatter: preserveFrontmatter ?? baseOptions.preserveFrontmatter,\n    tagfilter: tagfilter ?? baseOptions.tagfilter,\n    wrapper: wrapper || baseOptions.wrapper,\n\n    forceWrapper: !!(wrapper || baseOptions.wrapper),\n    components: { ...baseOptions.components, ...components },\n  };\n};\n\n/**\n * Provider for the MarkdownRenderer component.\n *\n * It will provide the `renderMarkdown` function to the context, which can be used to render markdown.\n *\n * ```tsx\n * const content = useIntlayer('app');\n *\n * return (\n *   <div>\n *     {content.markdown} // Will be rendered with the components and options provided to the MarkdownProvider\n *   </div>\n * );\n * ```\n *\n * @example\n * ```tsx\n * <MarkdownProvider components={{ h1: CustomHeading }}>\n *   <MarkdownRenderer>\n *     {markdownContent}\n *   </MarkdownRenderer>\n * </MarkdownProvider>\n * ```\n */\nexport const MarkdownProvider: FC<MarkdownProviderProps> = ({\n  children,\n  components,\n  wrapper,\n  forceBlock,\n  forceInline,\n  preserveFrontmatter,\n  tagfilter,\n  renderMarkdown: customRenderFn,\n}) => {\n  const baseOptions: MarkdownRendererOptions = {\n    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,\n    overrides?: Overrides | RenderMarkdownOptions\n  ) => {\n    const mergedOptions = mergeOptions(baseOptions, overrides);\n    return compiler(markdown, mergedOptions);\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,\n    overrides?: Overrides | RenderMarkdownOptions\n  ) => (\n    <MarkdownContext.Provider value={undefined}>\n      {customRenderFn?.(markdown, overrides)}\n    </MarkdownContext.Provider>\n  );\n\n  return (\n    <MarkdownContext.Provider\n      value={{\n        renderMarkdown: customRenderFn\n          ? customRenderMarkdownWrapper\n          : defaultRenderMarkdown,\n      }}\n    >\n      {children}\n    </MarkdownContext.Provider>\n  );\n};\n"],"mappings":";;;;;;;AA8CA,MAAM,kBAAkB,cACtB,OACD;AAED,MAAa,2BAA2B,WAAW,gBAAgB;AAKnE,MAAM,2BACJ,aACsC;AACtC,QACE,YACA,OAAO,aAAa,aACnB,gBAAgB,YACf,aAAa,YACb,gBAAgB,YAChB,iBAAiB,YACjB,yBAAyB,YACzB,eAAe;;AAIrB,MAAM,gBACJ,aACA,cAC4B;AAC5B,KAAI,CAAC,UAAW,QAAO;AAEvB,KAAI,CAAC,wBAAwB,UAAU,CAErC,QAAO;EACL,GAAG;EACH,YAAY;GAAE,GAAG,YAAY;GAAY,GAAG;GAAW;EACxD;CAIH,MAAM,EACJ,YAAY,oBACZ,SACA,YACA,aACA,qBACA,WACA,GAAG,uBACD;CAEJ,MAAM,aAAa,sBAAsB;AAEzC,QAAO;EACL,GAAG;EACH,YAAY,cAAc,YAAY;EACtC,aAAa,eAAe,YAAY;EACxC,qBAAqB,uBAAuB,YAAY;EACxD,WAAW,aAAa,YAAY;EACpC,SAAS,WAAW,YAAY;EAEhC,cAAc,CAAC,EAAE,WAAW,YAAY;EACxC,YAAY;GAAE,GAAG,YAAY;GAAY,GAAG;GAAY;EACzD;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,MAAa,oBAA+C,EAC1D,UACA,YACA,SACA,YACA,aACA,qBACA,WACA,gBAAgB,qBACZ;CACJ,MAAM,cAAuC;EAC3C;EACA;EACA;EACA;EACA,cAAc,CAAC,CAAC;EAChB;EACA;EACD;CAGD,MAAM,yBACJ,UACA,cACG;AAEH,SAAO,SAAS,UADM,aAAa,aAAa,UAAU,CAClB;;CAK1C,MAAM,+BACJ,UACA,cAEA,oBAAC,gBAAgB;EAAS,OAAO;YAC9B,iBAAiB,UAAU,UAAU;GACb;AAG7B,QACE,oBAAC,gBAAgB;EACf,OAAO,EACL,gBAAgB,iBACZ,8BACA,uBACL;EAEA;GACwB"}

package/dist/esm/markdown/MarkdownRenderer.mjs

@@ -1,41 +1,200 @@
-'use client';
-
-import { useEditedContentRenderer } from "../editor/useEditedContentRenderer.mjs";
+import { compiler } from "./processor.mjs";
 import { useMarkdownContext } from "./MarkdownProvider.mjs";
-import { getContent, getContentNodeByKeyPath, getMarkdownMetadata } from "@intlayer/core";
-import { useEditorLocale } from "@intlayer/editor-react";
+import { Fragment, jsx } from "react/jsx-runtime";
 
 //#region src/markdown/MarkdownRenderer.tsx
-const MarkdownRenderer = ({ dictionaryKey, keyPath, children, locale }) => {
-	const { renderMarkdown } = useMarkdownContext();
-	const editedContentContext = useEditedContentRenderer({
-		dictionaryKey,
-		keyPath,
-		children
+/**
+* Renders markdown content to JSX with the provided components and options.
+*
+* This function does not use context from MarkdownProvider. Use `useMarkdownRenderer`
+* hook if you want to leverage provider context.
+*
+* @param content - The markdown string to render
+* @param props - Configuration options for rendering
+* @param props.components - Component overrides for HTML tags
+* @param props.wrapper - Wrapper component for multiple children
+* @returns JSX element representing the rendered markdown
+*
+* @example
+* ```tsx
+* import { renderMarkdown } from '@intlayer/react-intlayer/markdown';
+*
+* const markdown = '# Hello World\n\nThis is **bold** text.';
+* const jsx = renderMarkdown(markdown, {
+*   components: {
+*     h1: ({ children }) => <h1 className="title">{children}</h1>,
+*   },
+*   forceBlock: true,
+* });
+* ```
+*/
+const renderMarkdown = (content, { components, wrapper, forceBlock, forceInline, preserveFrontmatter, tagfilter } = {}) => {
+	return compiler(content, {
+		components,
+		forceBlock,
+		forceInline,
+		wrapper,
+		forceWrapper: !!wrapper,
+		preserveFrontmatter,
+		tagfilter
 	});
-	if (typeof editedContentContext !== "string") {
-		const transformedEditedContent = getContent(editedContentContext, {
-			dictionaryKey,
-			keyPath
-		}, locale);
-		if (typeof transformedEditedContent !== "string") {
-			console.error(`Incorrect Markdown content. Edited Markdown content type: ${typeof transformedEditedContent}. Expected string. Value ${JSON.stringify(transformedEditedContent)}`);
-			return renderMarkdown(children);
-		}
-		return renderMarkdown(transformedEditedContent);
-	}
-	return renderMarkdown(editedContentContext);
 };
-const MarkdownMetadataRenderer = ({ dictionaryKey, keyPath, children, metadataKeyPath }) => {
-	const editedContentContext = useEditedContentRenderer({
-		dictionaryKey,
-		keyPath,
-		children
-	});
-	const currentLocale = useEditorLocale();
-	return getContentNodeByKeyPath(getMarkdownMetadata(editedContentContext), metadataKeyPath, currentLocale);
+/**
+* Hook that returns a function to render markdown content.
+*
+* This hook considers the configuration from the `MarkdownProvider` context if available,
+* falling back to the provided props or default behavior.
+*
+* @param props - Optional configuration that will override context values
+* @param props.components - Component overrides for HTML tags (overrides context)
+* @param props.wrapper - Wrapper component (overrides context)
+* @returns A function that takes markdown content and returns JSX
+*
+* @example
+* ```tsx
+* import { useMarkdownRenderer } from '@intlayer/react-intlayer/markdown';
+*
+* function MyComponent() {
+*   const renderMarkdown = useMarkdownRenderer({
+*     components: {
+*       h1: ({ children }) => <h1 className="custom">{children}</h1>,
+*     },
+*   });
+*
+*   return (
+*     <div>
+*       {renderMarkdown('# Hello\n\nThis is **markdown**')}
+*     </div>
+*   );
+* }
+* ```
+*
+* @example
+* ```tsx
+* // With MarkdownProvider context
+* function App() {
+*   return (
+*     <MarkdownProvider
+*       components={{ h1: CustomHeading }}
+*       forceBlock={true}
+*     >
+*       <MyComponent />
+*     </MarkdownProvider>
+*   );
+* }
+* ```
+*/
+const useMarkdownRenderer = ({ components, wrapper, forceBlock, forceInline, preserveFrontmatter, tagfilter } = {}) => {
+	const context = useMarkdownContext();
+	return (content) => {
+		if (context) return context.renderMarkdown(content, {
+			components,
+			wrapper,
+			forceBlock,
+			forceInline,
+			preserveFrontmatter,
+			tagfilter
+		});
+		return renderMarkdown(content, {
+			components,
+			wrapper,
+			forceBlock,
+			forceInline,
+			preserveFrontmatter,
+			tagfilter
+		});
+	};
+};
+/**
+* React component that renders markdown content to JSX.
+*
+* This component uses the `renderMarkdown` function from the `MarkdownProvider` context
+* if available. Otherwise, it falls back to the default compiler with provided components
+* and options. You can also provide a custom `renderMarkdown` function prop to override
+* all rendering behavior.
+*
+* @example
+* ```tsx
+* import { MarkdownRenderer } from '@intlayer/react-intlayer/markdown';
+*
+* function MyComponent() {
+*   return (
+*     <MarkdownRenderer>
+*       {`# Hello World
+*
+* This is a paragraph with **bold** and *italic* text.
+*
+* - List item 1
+* - List item 2`}
+*     </MarkdownRenderer>
+*   );
+* }
+* ```
+*
+* @example
+* ```tsx
+* // With custom components
+* <MarkdownRenderer
+*   components={{
+*     h1: ({ children }) => <h1 className="text-4xl font-bold">{children}</h1>,
+*     a: ({ href, children }) => (
+*       <a href={href} className="text-blue-500 hover:underline">
+*         {children}
+*       </a>
+*     ),
+*   }}
+*   forceBlock={true}
+* >
+*   {markdownContent}
+* </MarkdownRenderer>
+* ```
+*
+* @example
+* ```tsx
+* // With MarkdownProvider context
+* function App() {
+*   return (
+*     <MarkdownProvider
+*       components={{ h1: CustomHeading }}
+*       forceBlock={true}
+*     >
+*       <MarkdownRenderer>
+*         {markdownContent}
+*       </MarkdownRenderer>
+*     </MarkdownProvider>
+*   );
+* }
+* ```
+*/
+const MarkdownRenderer = ({ children = "", components, wrapper, forceBlock, forceInline, preserveFrontmatter, tagfilter, renderMarkdown }) => {
+	const context = useMarkdownContext();
+	if (renderMarkdown) return /* @__PURE__ */ jsx(Fragment, { children: renderMarkdown(children, {
+		components,
+		wrapper,
+		forceBlock,
+		forceInline,
+		preserveFrontmatter,
+		tagfilter
+	}) });
+	if (context) return /* @__PURE__ */ jsx(Fragment, { children: context.renderMarkdown(children, {
+		components,
+		wrapper,
+		forceBlock,
+		forceInline,
+		preserveFrontmatter,
+		tagfilter
+	}) });
+	return /* @__PURE__ */ jsx(Fragment, { children: compiler(children, {
+		components,
+		forceBlock,
+		forceInline,
+		wrapper,
+		forceWrapper: !!wrapper,
+		preserveFrontmatter,
+		tagfilter
+	}) });
 };
 
 //#endregion
-export { MarkdownMetadataRenderer, MarkdownRenderer };
+export { MarkdownRenderer, renderMarkdown, useMarkdownRenderer };
 //# sourceMappingURL=MarkdownRenderer.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"MarkdownRenderer.mjs","names":[],"sources":["../../../src/markdown/MarkdownRenderer.tsx"],"sourcesContent":["'use client';\n\nimport {\n  getContent,\n  getContentNodeByKeyPath,\n  getMarkdownMetadata,\n} from '@intlayer/core';\nimport { useEditorLocale } from '@intlayer/editor-react';\nimport type { ContentNode, KeyPath, LocalesValues } from '@intlayer/types';\nimport type { FC, ReactNode } from 'react';\nimport { useEditedContentRenderer } from '../editor/useEditedContentRenderer';\nimport { useMarkdownContext } from './MarkdownProvider';\n\ntype MarkdownRendererProps = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: LocalesValues;\n  children: string;\n};\n\nexport const MarkdownRenderer: FC<MarkdownRendererProps> = ({\n  dictionaryKey,\n  keyPath,\n  children,\n  locale,\n}): ReactNode => {\n  const { renderMarkdown } = useMarkdownContext();\n  const editedContentContext = useEditedContentRenderer({\n    dictionaryKey,\n    keyPath,\n    children,\n  });\n\n  if (typeof editedContentContext !== 'string') {\n    const transformedEditedContent = getContent(\n      editedContentContext,\n      {\n        dictionaryKey,\n        keyPath,\n      },\n      locale\n    );\n\n    if (typeof transformedEditedContent !== 'string') {\n      console.error(\n        `Incorrect Markdown content. Edited Markdown content type: ${typeof transformedEditedContent}. Expected string. Value ${JSON.stringify(transformedEditedContent)}`\n      );\n\n      return renderMarkdown(children);\n    }\n\n    return renderMarkdown(transformedEditedContent);\n  }\n\n  return renderMarkdown(editedContentContext);\n};\n\ntype MarkdownMetadataRendererProps = MarkdownRendererProps & {\n  metadataKeyPath: KeyPath[];\n};\n\nexport const MarkdownMetadataRenderer: FC<MarkdownMetadataRendererProps> = ({\n  dictionaryKey,\n  keyPath,\n  children,\n  metadataKeyPath,\n}): ReactNode => {\n  const editedContentContext = useEditedContentRenderer({\n    dictionaryKey,\n    keyPath,\n    children,\n  });\n  const currentLocale = useEditorLocale();\n\n  const metadata = getMarkdownMetadata(editedContentContext);\n\n  const metadataEl = getContentNodeByKeyPath(\n    metadata as ContentNode,\n    metadataKeyPath,\n    currentLocale\n  );\n\n  return metadataEl as ReactNode;\n};\n"],"mappings":";;;;;;;;AAoBA,MAAa,oBAA+C,EAC1D,eACA,SACA,UACA,aACe;CACf,MAAM,EAAE,mBAAmB,oBAAoB;CAC/C,MAAM,uBAAuB,yBAAyB;EACpD;EACA;EACA;EACD,CAAC;AAEF,KAAI,OAAO,yBAAyB,UAAU;EAC5C,MAAM,2BAA2B,WAC/B,sBACA;GACE;GACA;GACD,EACD,OACD;AAED,MAAI,OAAO,6BAA6B,UAAU;AAChD,WAAQ,MACN,6DAA6D,OAAO,yBAAyB,2BAA2B,KAAK,UAAU,yBAAyB,GACjK;AAED,UAAO,eAAe,SAAS;;AAGjC,SAAO,eAAe,yBAAyB;;AAGjD,QAAO,eAAe,qBAAqB;;AAO7C,MAAa,4BAA+D,EAC1E,eACA,SACA,UACA,sBACe;CACf,MAAM,uBAAuB,yBAAyB;EACpD;EACA;EACA;EACD,CAAC;CACF,MAAM,gBAAgB,iBAAiB;AAUvC,QANmB,wBAFF,oBAAoB,qBAAqB,EAIxD,iBACA,cACD"}
+{"version":3,"file":"MarkdownRenderer.mjs","names":[],"sources":["../../../src/markdown/MarkdownRenderer.tsx"],"sourcesContent":["import type { Overrides } from '@intlayer/core';\nimport type { FC, JSX, ReactNode } from 'react';\nimport {\n  type MarkdownProviderOptions,\n  useMarkdownContext,\n} from './MarkdownProvider';\nimport { compiler, type MarkdownRendererOptions } from './processor';\n\n/**\n * Props for rendering markdown content.\n *\n * @example\n * ```tsx\n * const props: RenderMarkdownProps = {\n *   components: {\n *     h1: ({ children }) => <h1 className=\"text-3xl\">{children}</h1>,\n *     p: ({ children }) => <p className=\"text-gray-700\">{children}</p>,\n *   },\n *   wrapper: ({ children }) => <article>{children}</article>,\n *   options: {\n *     forceBlock: true,\n *     preserveFrontmatter: false,\n *     tagfilter: true,\n *   },\n * };\n * ```\n */\nexport type RenderMarkdownProps = MarkdownProviderOptions & {\n  /**\n   * Component overrides for HTML tags.\n   * Allows you to customize how specific HTML elements are rendered.\n   * Only used if not wrapped in a MarkdownProvider.\n   *\n   * @example\n   * ```tsx\n   * components={{\n   *   h1: ({ children }) => <h1 className=\"title\">{children}</h1>,\n   *   a: ({ href, children }) => <Link to={href}>{children}</Link>,\n   * }}\n   * ```\n   */\n  components?: Overrides;\n  /**\n   * Wrapper element or component to be used when there are multiple children.\n   * Only used if not wrapped in a MarkdownProvider.\n   *\n   * @example\n   * ```tsx\n   * wrapper={({ children }) => <div className=\"markdown-content\">{children}</div>}\n   * ```\n   */\n  wrapper?: FC;\n};\n\n/**\n * Renders markdown content to JSX with the provided components and options.\n *\n * This function does not use context from MarkdownProvider. Use `useMarkdownRenderer`\n * hook if you want to leverage provider context.\n *\n * @param content - The markdown string to render\n * @param props - Configuration options for rendering\n * @param props.components - Component overrides for HTML tags\n * @param props.wrapper - Wrapper component for multiple children\n * @returns JSX element representing the rendered markdown\n *\n * @example\n * ```tsx\n * import { renderMarkdown } from '@intlayer/react-intlayer/markdown';\n *\n * const markdown = '# Hello World\\n\\nThis is **bold** text.';\n * const jsx = renderMarkdown(markdown, {\n *   components: {\n *     h1: ({ children }) => <h1 className=\"title\">{children}</h1>,\n *   },\n *   forceBlock: true,\n * });\n * ```\n */\nexport const renderMarkdown = (\n  content: string,\n  {\n    components,\n    wrapper,\n    forceBlock,\n    forceInline,\n    preserveFrontmatter,\n    tagfilter,\n  }: RenderMarkdownProps = {}\n): JSX.Element => {\n  // Map public options to internal processor options\n  const internalOptions: MarkdownRendererOptions = {\n    components,\n    forceBlock,\n    forceInline,\n    wrapper,\n    forceWrapper: !!wrapper,\n    preserveFrontmatter,\n    tagfilter,\n  };\n\n  return compiler(content, internalOptions);\n};\n\n/**\n * Hook that returns a function to render markdown content.\n *\n * This hook considers the configuration from the `MarkdownProvider` context if available,\n * falling back to the provided props or default behavior.\n *\n * @param props - Optional configuration that will override context values\n * @param props.components - Component overrides for HTML tags (overrides context)\n * @param props.wrapper - Wrapper component (overrides context)\n * @returns A function that takes markdown content and returns JSX\n *\n * @example\n * ```tsx\n * import { useMarkdownRenderer } from '@intlayer/react-intlayer/markdown';\n *\n * function MyComponent() {\n *   const renderMarkdown = useMarkdownRenderer({\n *     components: {\n *       h1: ({ children }) => <h1 className=\"custom\">{children}</h1>,\n *     },\n *   });\n *\n *   return (\n *     <div>\n *       {renderMarkdown('# Hello\\n\\nThis is **markdown**')}\n *     </div>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With MarkdownProvider context\n * function App() {\n *   return (\n *     <MarkdownProvider\n *       components={{ h1: CustomHeading }}\n *       forceBlock={true}\n *     >\n *       <MyComponent />\n *     </MarkdownProvider>\n *   );\n * }\n * ```\n */\nexport const useMarkdownRenderer = ({\n  components,\n  wrapper,\n  forceBlock,\n  forceInline,\n  preserveFrontmatter,\n  tagfilter,\n}: RenderMarkdownProps = {}) => {\n  const context = useMarkdownContext();\n\n  return (content: string) => {\n    if (context) {\n      return context.renderMarkdown(content, {\n        components,\n        wrapper,\n        forceBlock,\n        forceInline,\n        preserveFrontmatter,\n        tagfilter,\n      });\n    }\n\n    return renderMarkdown(content, {\n      components,\n      wrapper,\n      forceBlock,\n      forceInline,\n      preserveFrontmatter,\n      tagfilter,\n    });\n  };\n};\n\n/**\n * Props for the MarkdownRenderer component.\n *\n * @example\n * ```tsx\n * const props: MarkdownRendererProps = {\n *   children: '# Hello World\\n\\nThis is **bold** text.',\n *   components: {\n *     h1: ({ children }) => <h1 className=\"title\">{children}</h1>,\n *   },\n *   wrapper: ({ children }) => <article>{children}</article>,\n *   forceBlock: true,\n * };\n * ```\n */\nexport type MarkdownRendererProps = RenderMarkdownProps & {\n  /**\n   * The markdown content to render as a string.\n   *\n   * @example\n   * ```tsx\n   * <MarkdownRenderer>\n   *   {`# Title\\n\\nParagraph with **bold** text.`}\n   * </MarkdownRenderer>\n   * ```\n   */\n  children: string;\n  /**\n   * Custom render function for markdown.\n   * If provided, it will overwrite context and default rendering.\n   *\n   * @param markdown - The markdown string to render\n   * @param options - Optional rendering options\n   * @returns React node representing the rendered markdown\n   *\n   * @example\n   * ```tsx\n   * <MarkdownRenderer\n   *   renderMarkdown={(md, opts) => {\n   *     // Custom rendering logic\n   *     return <div dangerouslySetInnerHTML={{ __html: customParser(md) }} />;\n   *   }}\n   * >\n   *   {markdownContent}\n   * </MarkdownRenderer>\n   * ```\n   */\n  renderMarkdown?: (\n    markdown: string,\n    options?: {\n      components?: Overrides;\n      wrapper?: FC;\n      forceBlock?: boolean;\n      forceInline?: boolean;\n      preserveFrontmatter?: boolean;\n      tagfilter?: boolean;\n    }\n  ) => ReactNode;\n};\n\n/**\n * React component that renders markdown content to JSX.\n *\n * This component uses the `renderMarkdown` function from the `MarkdownProvider` context\n * if available. Otherwise, it falls back to the default compiler with provided components\n * and options. You can also provide a custom `renderMarkdown` function prop to override\n * all rendering behavior.\n *\n * @example\n * ```tsx\n * import { MarkdownRenderer } from '@intlayer/react-intlayer/markdown';\n *\n * function MyComponent() {\n *   return (\n *     <MarkdownRenderer>\n *       {`# Hello World\n *\n * This is a paragraph with **bold** and *italic* text.\n *\n * - List item 1\n * - List item 2`}\n *     </MarkdownRenderer>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With custom components\n * <MarkdownRenderer\n *   components={{\n *     h1: ({ children }) => <h1 className=\"text-4xl font-bold\">{children}</h1>,\n *     a: ({ href, children }) => (\n *       <a href={href} className=\"text-blue-500 hover:underline\">\n *         {children}\n *       </a>\n *     ),\n *   }}\n *   forceBlock={true}\n * >\n *   {markdownContent}\n * </MarkdownRenderer>\n * ```\n *\n * @example\n * ```tsx\n * // With MarkdownProvider context\n * function App() {\n *   return (\n *     <MarkdownProvider\n *       components={{ h1: CustomHeading }}\n *       forceBlock={true}\n *     >\n *       <MarkdownRenderer>\n *         {markdownContent}\n *       </MarkdownRenderer>\n *     </MarkdownProvider>\n *   );\n * }\n * ```\n */\nexport const MarkdownRenderer: FC<MarkdownRendererProps> = ({\n  children = '',\n  components,\n  wrapper,\n  forceBlock,\n  forceInline,\n  preserveFrontmatter,\n  tagfilter,\n  renderMarkdown,\n}) => {\n  const context = useMarkdownContext();\n\n  if (renderMarkdown) {\n    return (\n      <>\n        {renderMarkdown(children, {\n          components,\n          wrapper,\n          forceBlock,\n          forceInline,\n          preserveFrontmatter,\n          tagfilter,\n        })}\n      </>\n    );\n  }\n\n  if (context) {\n    return (\n      <>\n        {context.renderMarkdown(children, {\n          components,\n          wrapper,\n          forceBlock,\n          forceInline,\n          preserveFrontmatter,\n          tagfilter,\n        })}\n      </>\n    );\n  }\n\n  // Map public options to internal processor options\n  const internalOptions: MarkdownRendererOptions = {\n    components,\n    forceBlock,\n    forceInline,\n    wrapper,\n    forceWrapper: !!wrapper,\n    preserveFrontmatter,\n    tagfilter,\n  };\n\n  return <>{compiler(children, internalOptions)}</>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAa,kBACX,SACA,EACE,YACA,SACA,YACA,aACA,qBACA,cACuB,EAAE,KACX;AAYhB,QAAO,SAAS,SAViC;EAC/C;EACA;EACA;EACA;EACA,cAAc,CAAC,CAAC;EAChB;EACA;EACD,CAEwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgD3C,MAAa,uBAAuB,EAClC,YACA,SACA,YACA,aACA,qBACA,cACuB,EAAE,KAAK;CAC9B,MAAM,UAAU,oBAAoB;AAEpC,SAAQ,YAAoB;AAC1B,MAAI,QACF,QAAO,QAAQ,eAAe,SAAS;GACrC;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;AAGJ,SAAO,eAAe,SAAS;GAC7B;GACA;GACA;GACA;GACA;GACA;GACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6HN,MAAa,oBAA+C,EAC1D,WAAW,IACX,YACA,SACA,YACA,aACA,qBACA,WACA,qBACI;CACJ,MAAM,UAAU,oBAAoB;AAEpC,KAAI,eACF,QACE,0CACG,eAAe,UAAU;EACxB;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,GACD;AAIP,KAAI,QACF,QACE,0CACG,QAAQ,eAAe,UAAU;EAChC;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,GACD;AAeP,QAAO,0CAAG,SAAS,UAV8B;EAC/C;EACA;EACA;EACA;EACA,cAAc,CAAC,CAAC;EAChB;EACA;EACD,CAE4C,GAAI"}

package/dist/esm/markdown/MarkdownRendererPlugin.mjs

@@ -0,0 +1,31 @@
+'use client';
+
+import { useEditedContentRenderer } from "../editor/useEditedContentRenderer.mjs";
+import { useMarkdownContext } from "./MarkdownProvider.mjs";
+import { getContentNodeByKeyPath, getMarkdownMetadata } from "@intlayer/core";
+import { useEditorLocale } from "@intlayer/editor-react";
+
+//#region src/markdown/MarkdownRendererPlugin.tsx
+const MarkdownRendererPlugin = (props) => {
+	const { dictionaryKey, keyPath, children, locale, ...components } = props;
+	const renderMarkdown = useMarkdownContext()?.renderMarkdown ?? ((md) => md);
+	const editedContentContext = useEditedContentRenderer({
+		dictionaryKey,
+		keyPath,
+		children
+	});
+	return renderMarkdown(typeof editedContentContext === "string" ? editedContentContext : children, components);
+};
+const MarkdownMetadataRenderer = ({ dictionaryKey, keyPath, children, metadataKeyPath }) => {
+	const editedContentContext = useEditedContentRenderer({
+		dictionaryKey,
+		keyPath,
+		children
+	});
+	const currentLocale = useEditorLocale();
+	return getContentNodeByKeyPath(getMarkdownMetadata(editedContentContext), metadataKeyPath, currentLocale);
+};
+
+//#endregion
+export { MarkdownMetadataRenderer, MarkdownRendererPlugin };
+//# sourceMappingURL=MarkdownRendererPlugin.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownRendererPlugin.mjs","names":[],"sources":["../../../src/markdown/MarkdownRendererPlugin.tsx"],"sourcesContent":["'use client';\n\nimport { getContentNodeByKeyPath, getMarkdownMetadata } from '@intlayer/core';\nimport { useEditorLocale } from '@intlayer/editor-react';\nimport type { ContentNode, KeyPath, LocalesValues } from '@intlayer/types';\nimport type { FC, ReactNode } from 'react';\nimport { useEditedContentRenderer } from '../editor/useEditedContentRenderer';\nimport { useMarkdownContext } from './MarkdownProvider';\n\ntype MarkdownRendererPluginProps = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: LocalesValues;\n  children: string;\n  [key: string]: any;\n};\n\nexport const MarkdownRendererPlugin: FC<MarkdownRendererPluginProps> = (\n  props\n): ReactNode => {\n  const { dictionaryKey, keyPath, children, locale, ...components } = props;\n  const context = useMarkdownContext();\n  const renderMarkdown = context?.renderMarkdown ?? ((md) => md);\n  const editedContentContext = useEditedContentRenderer({\n    dictionaryKey,\n    keyPath,\n    children,\n  });\n\n  const contentToRender =\n    typeof editedContentContext === 'string' ? editedContentContext : children;\n\n  return renderMarkdown(contentToRender, components);\n};\n\ntype MarkdownMetadataRendererProps = MarkdownRendererPluginProps & {\n  metadataKeyPath: KeyPath[];\n};\n\nexport const MarkdownMetadataRenderer: FC<MarkdownMetadataRendererProps> = ({\n  dictionaryKey,\n  keyPath,\n  children,\n  metadataKeyPath,\n}): ReactNode => {\n  const editedContentContext = useEditedContentRenderer({\n    dictionaryKey,\n    keyPath,\n    children,\n  });\n  const currentLocale = useEditorLocale();\n\n  const metadata = getMarkdownMetadata(editedContentContext);\n\n  const metadataEl = getContentNodeByKeyPath(\n    metadata as ContentNode,\n    metadataKeyPath,\n    currentLocale\n  );\n\n  return metadataEl as ReactNode;\n};\n"],"mappings":";;;;;;;;AAiBA,MAAa,0BACX,UACc;CACd,MAAM,EAAE,eAAe,SAAS,UAAU,QAAQ,GAAG,eAAe;CAEpE,MAAM,iBADU,oBAAoB,EACJ,oBAAoB,OAAO;CAC3D,MAAM,uBAAuB,yBAAyB;EACpD;EACA;EACA;EACD,CAAC;AAKF,QAAO,eAFL,OAAO,yBAAyB,WAAW,uBAAuB,UAE7B,WAAW;;AAOpD,MAAa,4BAA+D,EAC1E,eACA,SACA,UACA,sBACe;CACf,MAAM,uBAAuB,yBAAyB;EACpD;EACA;EACA;EACD,CAAC;CACF,MAAM,gBAAgB,iBAAiB;AAUvC,QANmB,wBAFF,oBAAoB,qBAAqB,EAIxD,iBACA,cACD"}

package/dist/esm/markdown/index.mjs

@@ -1,4 +1,7 @@
+import { LegacyMarkdownRenderer, RuleType, compile, compileMarkdown, compiler, sanitizer as defaultSanitizer, slugify as defaultSlugify } from "./processor.mjs";
 import { MarkdownProvider, useMarkdownContext } from "./MarkdownProvider.mjs";
-import { MarkdownMetadataRenderer, MarkdownRenderer } from "./MarkdownRenderer.mjs";
+import { MarkdownRenderer, renderMarkdown, useMarkdownRenderer } from "./MarkdownRenderer.mjs";
+import { MarkdownMetadataRenderer, MarkdownRendererPlugin } from "./MarkdownRendererPlugin.mjs";
+import { createReactRuntime, reactRuntime } from "./runtime.mjs";
 
-export { MarkdownMetadataRenderer, MarkdownProvider, MarkdownRenderer, useMarkdownContext };
+export { LegacyMarkdownRenderer, MarkdownMetadataRenderer, MarkdownProvider, MarkdownRenderer, MarkdownRendererPlugin, RuleType, compile, compileMarkdown, compiler, createReactRuntime, reactRuntime, renderMarkdown, defaultSanitizer as sanitizer, defaultSlugify as slugify, useMarkdownContext, useMarkdownRenderer };

package/dist/esm/markdown/processor.mjs

@@ -0,0 +1,54 @@
+import { Fragment, cloneElement, createElement } from "react";
+import { RuleType, compile as compile$1, sanitizer as defaultSanitizer, slugify as defaultSlugify } from "@intlayer/core";
+
+//#region src/markdown/processor.tsx
+/**
+* Default React runtime for markdown rendering.
+*/
+const DEFAULT_RUNTIME = {
+	createElement,
+	cloneElement,
+	Fragment,
+	normalizeProps: (_tag, props) => props
+};
+/**
+* Compile markdown to React elements.
+* This is the primary export - use this for new code.
+*/
+const compileMarkdown = (markdown = "", options = {}) => {
+	const { createElement: customCreateElement, disableAutoLink, disableParsingRawHTML, enforceAtxHeadings, forceBlock, forceInline, forceWrapper, namedCodesToUnicode, components, renderRule, sanitizer, slugify, wrapper, preserveFrontmatter, tagfilter } = options;
+	return compile$1(markdown, {
+		runtime: customCreateElement ? {
+			...DEFAULT_RUNTIME,
+			createElement: customCreateElement
+		} : DEFAULT_RUNTIME,
+		components,
+		namedCodesToUnicode,
+		sanitizer,
+		slugify
+	}, {
+		disableAutoLink,
+		disableParsingRawHTML,
+		enforceAtxHeadings,
+		forceBlock,
+		forceInline,
+		forceWrapper,
+		renderRule,
+		wrapper,
+		preserveFrontmatter,
+		tagfilter
+	});
+};
+const compiler = compileMarkdown;
+const compile = compileMarkdown;
+/**
+* React component that renders markdown to JSX (legacy).
+*/
+const LegacyMarkdownRenderer = ({ children = "", options, ...props }) => {
+	if (process.env.NODE_ENV !== "production" && typeof children !== "string") console.error("intlayer: <Markdown> component only accepts a single string as a child, received:", children);
+	return cloneElement(compiler(children, options), props);
+};
+
+//#endregion
+export { LegacyMarkdownRenderer, RuleType, compile, compileMarkdown, compiler, defaultSanitizer as sanitizer, defaultSlugify as slugify };
+//# sourceMappingURL=processor.mjs.map