@ai-react-markdown/core 1.1.0 → 1.2.5

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ComponentType, PropsWithChildren } from 'react';
+import { ComponentType, PropsWithChildren, CSSProperties } from 'react';
 import { Components } from 'react-markdown';
 
 /**
@@ -82,6 +82,39 @@ interface AIMarkdownTypographyProps extends PropsWithChildren {
     variant?: AIMarkdownVariant;
     /** Active color scheme. */
     colorScheme?: AIMarkdownColorScheme;
+    /**
+     * Inline styles injected by the core renderer. Custom Typography implementations
+     * **must** merge this object into their root element's `style` to ensure CSS
+     * custom properties set by the core are available to all descendant nodes.
+     *
+     * ### Currently injected variables
+     *
+     * | Variable                | Value          | Purpose                                                  |
+     * |-------------------------|----------------|----------------------------------------------------------|
+     * | `--aim-font-size-root`  | `fontSize` prop | Absolute font-size anchor for the component instance.   |
+     *
+     * #### Why `--aim-font-size-root`?
+     *
+     * Markdown content frequently nests elements that use relative `em` units
+     * (blockquotes, lists, code blocks). Each nesting level compounds the
+     * effective size — a `0.875em` code span inside a `1.125em` blockquote
+     * becomes `0.984375em` of the parent, not `0.875em` of the root.
+     *
+     * `--aim-font-size-root` provides the component-level root font-size as an
+     * absolute reference so that inner CSS rules can use
+     * `font-size: var(--aim-font-size-root)` to opt out of `em` compounding
+     * when a stable size is needed.
+     *
+     * @example
+     * ```tsx
+     * const MyTypography: AIMarkdownTypographyComponent = ({ children, fontSize, style }) => (
+     *   <div className="my-typo" style={{ fontSize, ...style }}>
+     *     {children}
+     *   </div>
+     * );
+     * ```
+     */
+    style?: CSSProperties;
 }
 /** React component type for the typography wrapper. */
 type AIMarkdownTypographyComponent = ComponentType<AIMarkdownTypographyProps>;
@@ -568,7 +601,7 @@ interface AIMarkdownProps<TConfig extends AIMarkdownRenderConfig = AIMarkdownRen
     /**
      * Base font size for the rendered output.
      * Accepts a CSS length string (e.g. `'14px'`, `'0.875rem'`) or a number
-     * which is treated as pixels. Defaults to `'0.875rem'`.
+     * which is treated as pixels. Defaults to `'0.9375rem'`.
      */
     fontSize?: number | string;
     /** Raw markdown content to render. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ComponentType, PropsWithChildren } from 'react';
+import { ComponentType, PropsWithChildren, CSSProperties } from 'react';
 import { Components } from 'react-markdown';
 
 /**
@@ -82,6 +82,39 @@ interface AIMarkdownTypographyProps extends PropsWithChildren {
     variant?: AIMarkdownVariant;
     /** Active color scheme. */
     colorScheme?: AIMarkdownColorScheme;
+    /**
+     * Inline styles injected by the core renderer. Custom Typography implementations
+     * **must** merge this object into their root element's `style` to ensure CSS
+     * custom properties set by the core are available to all descendant nodes.
+     *
+     * ### Currently injected variables
+     *
+     * | Variable                | Value          | Purpose                                                  |
+     * |-------------------------|----------------|----------------------------------------------------------|
+     * | `--aim-font-size-root`  | `fontSize` prop | Absolute font-size anchor for the component instance.   |
+     *
+     * #### Why `--aim-font-size-root`?
+     *
+     * Markdown content frequently nests elements that use relative `em` units
+     * (blockquotes, lists, code blocks). Each nesting level compounds the
+     * effective size — a `0.875em` code span inside a `1.125em` blockquote
+     * becomes `0.984375em` of the parent, not `0.875em` of the root.
+     *
+     * `--aim-font-size-root` provides the component-level root font-size as an
+     * absolute reference so that inner CSS rules can use
+     * `font-size: var(--aim-font-size-root)` to opt out of `em` compounding
+     * when a stable size is needed.
+     *
+     * @example
+     * ```tsx
+     * const MyTypography: AIMarkdownTypographyComponent = ({ children, fontSize, style }) => (
+     *   <div className="my-typo" style={{ fontSize, ...style }}>
+     *     {children}
+     *   </div>
+     * );
+     * ```
+     */
+    style?: CSSProperties;
 }
 /** React component type for the typography wrapper. */
 type AIMarkdownTypographyComponent = ComponentType<AIMarkdownTypographyProps>;
@@ -568,7 +601,7 @@ interface AIMarkdownProps<TConfig extends AIMarkdownRenderConfig = AIMarkdownRen
     /**
      * Base font size for the rendered output.
      * Accepts a CSS length string (e.g. `'14px'`, `'0.875rem'`) or a number
-     * which is treated as pixels. Defaults to `'0.875rem'`.
+     * which is treated as pixels. Defaults to `'0.9375rem'`.
      */
     fontSize?: number | string;
     /** Raw markdown content to render. */