@lofcz/streamdown 2.9.0 → 2.9.2

package/dist/index.d.ts

@@ -1,490 +1,36 @@
-import * as react from 'react';
-import react__default, { SVGProps, JSX, ComponentType, HTMLAttributes, ComponentProps } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { RemendOptions } from 'remend';
-import { Pluggable, PluggableList } from 'unified';
-import { Element, Parents } from 'hast';
-import { Options as Options$1 } from 'remark-rehype';
-import { BundledTheme, ThemeRegistrationAny, BundledLanguage } from 'shiki';
-export { BundledLanguage, BundledTheme, ThemeRegistrationAny } from 'shiki';
-
-/**
- * Shared cursor used to chain stagger delays across sibling blocks in a
- * single render pass.  Create one instance per Streamdown component and
- * reset `cursor.current = 0` before each React render so that block 0
- * starts at index 0 and each subsequent block continues from where the
- * previous one left off.
- */
-interface AnimateCursor {
-    current: number;
-}
-declare function createAnimateCursor(): AnimateCursor;
-interface AnimatePlugin {
-    /**
-     * Returns the total HAST text node character count from the last
-     * rehype run, then resets to 0. Use this value as the argument to
-     * setPrevContentLength on the next render.
-     */
-    getLastRenderCharCount: () => number;
-    /**
-     * Returns the number of newly-animated words from the last rehype run,
-     * then resets to 0. Pass this value to setStartIndex() on the next
-     * sibling block so its stagger delays chain after ours.
-     */
-    getLastRenderNewWordCount: () => number;
-    name: "animate";
-    rehypePlugin: Pluggable;
-    /**
-     * Enable or disable animation inside code/pre blocks.
-     * When true, code block content will be animated incrementally
-     * during streaming (useful for incomplete/unclosed code fences).
-     */
-    setAnimateCodeBlocks: (enabled: boolean) => void;
-    /**
-     * Set the number of HAST text characters from a previous render.
-     * Characters up to this count will get duration=0ms, preventing
-     * re-animation of already-visible content during streaming updates.
-     */
-    setPrevContentLength: (length: number) => void;
-    /**
-     * Set the animation word index to start from. Used when no shared
-     * cursor is provided. Use the value returned by
-     * getLastRenderNewWordCount() from the previous sibling block to
-     * ensure that a new block's stagger delays begin after the previous
-     * block's animation is still completing, preventing concurrent reveals.
-     */
-    setStartIndex: (index: number) => void;
-    type: "animate";
-}
-interface AnimateOptions {
-    animation?: "fadeIn" | "blurIn" | "slideUp" | (string & {});
-    /**
-     * Shared cursor for automatic cross-block stagger chaining.  When
-     * provided the plugin reads `cursor.current` as the start index and
-     * increments it by the number of newly animated words after each run,
-     * so sibling blocks automatically pick up where the previous one left
-     * off without any manual `setStartIndex` calls.
-     */
-    cursor?: AnimateCursor;
-    duration?: number;
-    easing?: string;
-    sep?: "word" | "char";
-    stagger?: number;
-}
-declare function createAnimatePlugin(options?: AnimateOptions): AnimatePlugin;
-
-type IconComponent = React.ComponentType<SVGProps<SVGSVGElement> & {
-    size?: number;
-}>;
-interface IconMap {
-    CheckIcon: IconComponent;
-    CopyIcon: IconComponent;
-    DownloadIcon: IconComponent;
-    ExternalLinkIcon: IconComponent;
-    Loader2Icon: IconComponent;
-    Maximize2Icon: IconComponent;
-    RotateCcwIcon: IconComponent;
-    XIcon: IconComponent;
-    ZoomInIcon: IconComponent;
-    ZoomOutIcon: IconComponent;
-}
-
-interface ExtraProps {
-    node?: Element | undefined;
-}
-type AllowElement = (element: Readonly<Element>, index: number, parent: Readonly<Parents> | undefined) => boolean | null | undefined;
-type UrlTransform = (url: string, key: string, node: Readonly<Element>) => string | null | undefined;
-type Components = {
-    [Key in keyof JSX.IntrinsicElements]?: ComponentType<JSX.IntrinsicElements[Key] & ExtraProps> | keyof JSX.IntrinsicElements;
-} & {
-    inlineCode?: ComponentType<JSX.IntrinsicElements["code"] & ExtraProps>;
-    [key: string]: ComponentType<Record<string, unknown> & ExtraProps> | keyof JSX.IntrinsicElements | undefined;
-};
-interface Options {
-    allowElement?: AllowElement;
-    allowedElements?: readonly string[];
-    children?: string;
-    components?: Components;
-    disallowedElements?: readonly string[];
-    rehypePlugins?: PluggableList;
-    remarkPlugins?: PluggableList;
-    remarkRehypeOptions?: Readonly<Options$1>;
-    skipHtml?: boolean;
-    unwrapDisallowed?: boolean;
-    urlTransform?: UrlTransform;
-}
-declare const defaultUrlTransform: UrlTransform;
-
-/**
- * Structural type for Mermaid configuration.
- * Avoids a hard dependency on the "mermaid" package in the core bundle.
- * Users who need full type safety can import MermaidConfig from "mermaid"
- * directly — it is structurally compatible with this type.
- */
-type MermaidConfig = Record<string, any>;
-
-type ThemeInput = BundledTheme | ThemeRegistrationAny;
-/**
- * A single token in a highlighted line
- */
-interface HighlightToken {
-    bgColor?: string;
-    color?: string;
-    content: string;
-    htmlAttrs?: Record<string, string>;
-    htmlStyle?: Record<string, string>;
-    offset?: number;
-}
-/**
- * Result from code highlighting (compatible with shiki's TokensResult)
- */
-interface HighlightResult {
-    bg?: string;
-    fg?: string;
-    rootStyle?: string | false;
-    tokens: HighlightToken[][];
-}
-/**
- * Options for highlighting code
- */
-interface HighlightOptions {
-    code: string;
-    language: BundledLanguage;
-    themes: [ThemeInput, ThemeInput];
-}
-/**
- * Plugin for code syntax highlighting (Shiki)
- */
-interface CodeHighlighterPlugin {
-    /**
-     * Get list of supported languages
-     */
-    getSupportedLanguages: () => BundledLanguage[];
-    /**
-     * Get the configured themes
-     */
-    getThemes: () => [ThemeInput, ThemeInput];
-    /**
-     * Highlight code and return tokens
-     * Returns null if highlighting not ready yet (async loading)
-     * Use callback for async result
-     */
-    highlight: (options: HighlightOptions, callback?: (result: HighlightResult) => void) => HighlightResult | null;
-    name: "shiki";
-    /**
-     * Check if language is supported
-     */
-    supportsLanguage: (language: BundledLanguage) => boolean;
-    type: "code-highlighter";
-}
-/**
- * Mermaid instance interface
- */
-interface MermaidInstance {
-    initialize: (config: MermaidConfig) => void;
-    render: (id: string, source: string) => Promise<{
-        svg: string;
-    }>;
-}
-/**
- * Plugin for diagram rendering (Mermaid)
- */
-interface DiagramPlugin {
-    /**
-     * Get the mermaid instance (initialized with optional config)
-     */
-    getMermaid: (config?: MermaidConfig) => MermaidInstance;
-    /**
-     * Language identifier for code blocks
-     */
-    language: string;
-    name: "mermaid";
-    type: "diagram";
-}
-/**
- * Plugin for math rendering (KaTeX)
- */
-interface MathPlugin {
-    /**
-     * Get CSS styles for math rendering (injected into head)
-     */
-    getStyles?: () => string;
-    name: "katex";
-    /**
-     * Get rehype plugin for rendering math
-     */
-    rehypePlugin: Pluggable;
-    /**
-     * Get remark plugin for parsing math syntax
-     */
-    remarkPlugin: Pluggable;
-    type: "math";
-}
-/**
- * Plugin for CJK text handling
- */
-interface CjkPlugin {
-    name: "cjk";
-    /**
-     * @deprecated Use remarkPluginsBefore and remarkPluginsAfter instead
-     * All remark plugins (for backwards compatibility)
-     */
-    remarkPlugins: Pluggable[];
-    /**
-     * Remark plugins that must run AFTER remarkGfm
-     * (e.g., autolink boundary splitting, strikethrough enhancements)
-     */
-    remarkPluginsAfter: Pluggable[];
-    /**
-     * Remark plugins that must run BEFORE remarkGfm
-     * (e.g., remark-cjk-friendly which modifies emphasis handling)
-     */
-    remarkPluginsBefore: Pluggable[];
-    type: "cjk";
-}
-interface CustomRendererProps {
-    code: string;
-    isIncomplete: boolean;
-    language: string;
-    /** Raw metastring from the code fence (everything after the language identifier).
-     * e.g. ```rust {1} title="foo"  →  meta = '{1} title="foo"'
-     * Undefined when no metastring is present. */
-    meta?: string;
-}
-interface CustomRenderer {
-    component: react__default.ComponentType<CustomRendererProps>;
-    language: string | string[];
-}
-/**
- * Plugin configuration passed to Streamdown
- */
-interface PluginConfig {
-    cjk?: CjkPlugin;
-    code?: CodeHighlighterPlugin;
-    math?: MathPlugin;
-    mermaid?: DiagramPlugin;
-    renderers?: CustomRenderer[];
-}
-
-type ControlsConfig = boolean | {
-    table?: boolean | {
-        copy?: boolean;
-        download?: boolean;
-        fullscreen?: boolean;
-    };
-    code?: boolean | {
-        copy?: boolean;
-        download?: boolean;
-    };
-    mermaid?: boolean | {
-        download?: boolean;
-        copy?: boolean;
-        fullscreen?: boolean;
-        panZoom?: boolean;
-    };
-    image?: boolean | {
-        download?: boolean;
-        fullscreen?: boolean;
-    };
-};
-interface LinkSafetyModalProps {
-    isOpen: boolean;
-    onClose: () => void;
-    onConfirm: () => void;
-    url: string;
-}
-interface LinkSafetyConfig {
-    enabled: boolean;
-    onLinkCheck?: (url: string) => Promise<boolean> | boolean;
-    renderModal?: (props: LinkSafetyModalProps) => React.ReactNode;
-}
-interface MermaidErrorComponentProps {
-    chart: string;
-    error: string;
-    retry: () => void;
-}
-interface MermaidOptions {
-    config?: MermaidConfig;
-    errorComponent?: React.ComponentType<MermaidErrorComponentProps>;
-}
-/**
- * Built-in list bullet style presets for nested unordered lists.
- * - `"flat"` — all levels use disc
- * - `"hierarchical"` — disc → circle → square, cycling
- */
-type ListStylePreset = "flat" | "hierarchical";
-interface StreamdownContextType {
-    /** Max height for code blocks (px number or CSS length). `0` / `Infinity` disables. @default 400 */
-    codeBlockMaxHeight?: number | string;
-    controls: ControlsConfig;
-    isAnimating: boolean;
-    /** Show line numbers in code blocks. @default true */
-    lineNumbers: boolean;
-    linkSafety?: LinkSafetyConfig;
-    /** Bullet style cycling for nested unordered lists. @default "hierarchical" */
-    listStyle: ListStylePreset;
-    mermaid?: MermaidOptions;
-    mode: "static" | "streaming";
-    shikiTheme: [ThemeInput, ThemeInput];
-    /** Max height for tables (px number or CSS length). `0` / `Infinity` disables. @default 300 */
-    tableMaxHeight?: number | string;
-}
-declare const StreamdownContext: react.Context<StreamdownContextType>;
-
-interface StreamdownTranslations {
-    alertCaution: string;
-    alertImportant: string;
-    alertNote: string;
-    alertTip: string;
-    alertWarning: string;
-    close: string;
-    copied: string;
-    copyCode: string;
-    copyLink: string;
-    copyTable: string;
-    copyTableAsCsv: string;
-    copyTableAsMarkdown: string;
-    copyTableAsTsv: string;
-    downloadDiagram: string;
-    downloadDiagramAsMmd: string;
-    downloadDiagramAsPng: string;
-    downloadDiagramAsSvg: string;
-    downloadFile: string;
-    downloadImage: string;
-    downloadTable: string;
-    downloadTableAsCsv: string;
-    downloadTableAsMarkdown: string;
-    exitFullscreen: string;
-    externalLinkWarning: string;
-    imageNotAvailable: string;
-    mermaidFormatMmd: string;
-    mermaidFormatPng: string;
-    mermaidFormatSvg: string;
-    openExternalLink: string;
-    openLink: string;
-    tableFormatCsv: string;
-    tableFormatMarkdown: string;
-    tableFormatTsv: string;
-    viewFullscreen: string;
-}
-declare const defaultTranslations: StreamdownTranslations;
-
-/**
- * Hook to check if the current block has an incomplete (unclosed) code fence.
- *
- * Returns `true` when the code fence in this block is still being streamed.
- * Useful for deferring expensive renders (syntax highlighting, Mermaid diagrams)
- * until the code block is complete.
- */
-declare const useIsCodeFenceIncomplete: () => boolean;
-
-type CodeBlockProps = HTMLAttributes<HTMLDivElement> & {
-    code: string;
-    language: string;
-    /** Whether the code block is still being streamed (incomplete) */
-    isIncomplete?: boolean;
-    /** Custom starting line number for line numbering (default: 1) */
-    startLine?: number;
-    /** Show line numbers in code blocks. @default true */
-    lineNumbers?: boolean;
-};
-declare const CodeBlock: ({ code, language, className, children, isIncomplete, startLine, lineNumbers, ...rest }: CodeBlockProps) => react_jsx_runtime.JSX.Element;
-
-type CodeBlockContainerProps = ComponentProps<"div"> & {
-    language: string;
-    /** Whether the code block is still being streamed (incomplete) */
-    isIncomplete?: boolean;
-};
-declare const CodeBlockContainer: ({ className, language, style, isIncomplete, ...props }: CodeBlockContainerProps) => react_jsx_runtime.JSX.Element;
-
-type CodeBlockCopyButtonProps = ComponentProps<"button"> & {
-    onCopy?: () => void;
-    onError?: (error: Error) => void;
-    timeout?: number;
-};
-declare const CodeBlockCopyButton: ({ onCopy, onError, timeout, children, className, code: propCode, ...props }: CodeBlockCopyButtonProps & {
-    code?: string;
-}) => react_jsx_runtime.JSX.Element;
-
-type CodeBlockDownloadButtonProps = ComponentProps<"button"> & {
-    onDownload?: () => void;
-    onError?: (error: Error) => void;
-};
-declare const CodeBlockDownloadButton: ({ onDownload, onError, language, children, className, code: propCode, ...props }: CodeBlockDownloadButtonProps & {
-    code?: string;
-    language?: string;
-}) => react_jsx_runtime.JSX.Element;
-
-interface CodeBlockHeaderProps {
-    language: string;
-}
-declare const CodeBlockHeader: ({ language }: CodeBlockHeaderProps) => react_jsx_runtime.JSX.Element;
-
-declare const CodeBlockSkeleton: () => react_jsx_runtime.JSX.Element;
-
-/**
- * Detect text direction using the "first strong character" algorithm.
- * Strips common markdown syntax then finds the first Unicode letter
- * with strong directionality.
- *
- * Note: markdown stripping is best-effort — nested formatting,
- * multi-line fenced code blocks, and raw HTML are not fully handled.
- * This is acceptable since the algorithm only needs to reach the first
- * strong character, which is almost always in plain prose.
- *
- * @returns "rtl" if first strong char is RTL, "ltr" otherwise
- */
-declare function detectTextDirection(text: string): "ltr" | "rtl";
-
-declare const parseMarkdownIntoBlocks: (markdown: string) => string[];
-interface IncrementalParseState {
-    blocks: string[];
-    /** Tag-preprocessed markdown that produced `blocks` (before last-block remend). */
-    source: string;
-}
-/**
- * Append-only parse for streaming: keep settled prefix blocks by identity and
- * only re-lex the unfinished tail. Falls back to a full parse when the source
- * is not a pure append (edits, rewinds, or structural shifts).
- */
-declare const parseMarkdownIntoBlocksIncremental: (markdown: string, prev: IncrementalParseState | null | undefined, parseFn?: (value: string) => string[]) => IncrementalParseState;
-
-interface TableCopyDropdownProps {
-    children?: React.ReactNode;
-    className?: string;
-    onCopy?: (format: "csv" | "tsv" | "md") => void;
-    onError?: (error: Error) => void;
-    timeout?: number;
-}
-declare const TableCopyDropdown: ({ children, className, onCopy, onError, timeout, }: TableCopyDropdownProps) => react_jsx_runtime.JSX.Element;
-
-interface TableDownloadButtonProps {
-    children?: React.ReactNode;
-    className?: string;
-    filename?: string;
-    format?: "csv" | "markdown";
-    onDownload?: () => void;
-    onError?: (error: Error) => void;
-}
-declare const TableDownloadButton: ({ children, className, onDownload, onError, format, filename, }: TableDownloadButtonProps) => react_jsx_runtime.JSX.Element;
-interface TableDownloadDropdownProps {
-    children?: React.ReactNode;
-    className?: string;
-    onDownload?: (format: "csv" | "markdown") => void;
-    onError?: (error: Error) => void;
-}
-declare const TableDownloadDropdown: ({ children, className, onDownload, onError, }: TableDownloadDropdownProps) => react_jsx_runtime.JSX.Element;
-
-interface TableData {
-    headers: string[];
-    rows: string[][];
-}
-declare const extractTableDataFromElement: (tableElement: HTMLElement) => TableData;
-declare const tableDataToCSV: (data: TableData) => string;
-declare const tableDataToTSV: (data: TableData) => string;
-declare const escapeMarkdownTableCell: (cell: string) => string;
-declare const tableDataToMarkdown: (data: TableData) => string;
-
+import { type RemendOptions } from "remend";
+import type { Pluggable } from "unified";
+import { type AnimateOptions, type AnimatePlugin } from "./lib/animate";
+import { type IconMap } from "./lib/icon-context";
+import { type Options } from "./lib/markdown";
+import type { PluginConfig, ThemeInput } from "./lib/plugin-types";
+import { type CalloutIconResolver, type CalloutStyleResolver, type ControlsConfig, type LinkSafetyConfig, type ListStylePreset, type MermaidOptions, type ScrollableComponent } from "./lib/streamdown-context";
+import { type StreamdownTranslations } from "./lib/translations-context";
+export type { BundledLanguage, BundledTheme, ThemeRegistrationAny, } from "shiki";
+export type { AnimateOptions } from "./lib/animate";
+export { createAnimateCursor, createAnimatePlugin } from "./lib/animate";
+export { useIsCodeFenceIncomplete } from "./lib/block-incomplete-context";
+export { CodeBlock } from "./lib/code-block";
+export { CodeBlockContainer } from "./lib/code-block/container";
+export { CodeBlockCopyButton } from "./lib/code-block/copy-button";
+export { CodeBlockDownloadButton } from "./lib/code-block/download-button";
+export { CodeBlockHeader } from "./lib/code-block/header";
+export { CodeBlockSkeleton } from "./lib/code-block/skeleton";
+export { detectTextDirection } from "./lib/detect-direction";
+export type { IconMap } from "./lib/icon-context";
+export type { AllowElement, Components, ExtraProps, UrlTransform, } from "./lib/markdown";
+export { defaultUrlTransform } from "./lib/markdown";
+export type { IncrementalParseState } from "./lib/parse-blocks";
+export { parseMarkdownIntoBlocks, parseMarkdownIntoBlocksIncremental, } from "./lib/parse-blocks";
+export type { CjkPlugin, CodeHighlighterPlugin, CustomRenderer, CustomRendererProps, DiagramPlugin, HighlightOptions, MathPlugin, PluginConfig, ThemeInput, } from "./lib/plugin-types";
+export { DefaultScrollable } from "./lib/scrollable";
+export type { CalloutIconResolver, CalloutStyleResolver, ControlsConfig, LinkSafetyConfig, LinkSafetyModalProps, MermaidErrorComponentProps, MermaidOptions, ScrollableComponent, ScrollableProps, StreamdownContextType, } from "./lib/streamdown-context";
+export { StreamdownContext } from "./lib/streamdown-context";
+export { TableCopyDropdown, type TableCopyDropdownProps, } from "./lib/table/copy-dropdown";
+export { TableDownloadButton, type TableDownloadButtonProps, TableDownloadDropdown, type TableDownloadDropdownProps, } from "./lib/table/download-dropdown";
+export { escapeMarkdownTableCell, extractTableDataFromElement, type TableData, tableDataToCSV, tableDataToMarkdown, tableDataToTSV, } from "./lib/table/utils";
+export type { StreamdownTranslations } from "./lib/translations-context";
+export { defaultTranslations } from "./lib/translations-context";
 /**
  * Normalizes indentation in HTML blocks to prevent Markdown parsers from
  * treating indented HTML tags as code blocks (4+ spaces = code in Markdown).
@@ -495,9 +41,9 @@ declare const tableDataToMarkdown: (data: TableData) => string;
  * @param content - The raw HTML/Markdown string to normalize
  * @returns The normalized string with reduced indentation before HTML tags
  */
-declare const normalizeHtmlIndentation: (content: string) => string;
-type AllowedTags = Record<string, string[]>;
-type StreamdownProps = Options & {
+export declare const normalizeHtmlIndentation: (content: string) => string;
+export type AllowedTags = Record<string, string[]>;
+export type StreamdownProps = Options & {
     mode?: "static" | "streaming";
     /** Text direction for blocks. "auto" detects per-block using first strong character algorithm. */
     dir?: "auto" | "ltr" | "rtl";
@@ -512,11 +58,17 @@ type StreamdownProps = Options & {
     codeBlockMaxHeight?: number | string;
     controls?: ControlsConfig;
     isAnimating?: boolean;
+    /** Component used for horizontal-scroll regions (code body, table). Defaults to a plain div — override to plug in a custom scrollbar (e.g. OverlayScrollbars) declaratively. */
+    scrollable?: ScrollableComponent;
     tableMaxHeight?: number | string;
     animated?: boolean | AnimateOptions;
     caret?: keyof typeof carets;
     /** Bullet style cycling for nested unordered lists. @default "hierarchical" */
     listStyle?: ListStylePreset;
+    /** Icon resolver for custom callouts (`>>> (icon)[Title]{color}`). Return null/undefined for a blank placeholder. */
+    calloutIcon?: CalloutIconResolver;
+    /** Style resolver for custom callouts — computes the tinted background + accent border/title color. */
+    calloutStyle?: CalloutStyleResolver;
     plugins?: PluginConfig;
     remend?: RemendOptions;
     linkSafety?: LinkSafetyConfig;
@@ -551,14 +103,19 @@ type StreamdownProps = Options & {
     /** Called when isAnimating transitions from true to false. Suppressed in mode="static". */
     onAnimationEnd?: () => void;
 };
-declare const defaultRehypePlugins: Record<string, Pluggable>;
-declare const defaultRemarkPlugins: Record<string, Pluggable>;
+export declare const defaultRehypePlugins: Record<string, Pluggable>;
+export declare const defaultRemarkPlugins: Record<string, Pluggable>;
 declare const carets: {
     block: string;
     circle: string;
 };
-
-type BlockProps = Options & {
+/**
+ * Built-in list bullet style presets for nested unordered lists.
+ * - `"flat"` — all levels use disc
+ * - `"hierarchical"` — disc → circle → square, cycling
+ */
+export type { ListStylePreset } from "./lib/streamdown-context";
+export type BlockProps = Options & {
     content: string;
     shouldParseIncompleteMarkdown: boolean;
     shouldNormalizeHtmlIndentation: boolean;
@@ -570,7 +127,5 @@ type BlockProps = Options & {
     /** Animate plugin instance for tracking previous content length */
     animatePlugin?: AnimatePlugin | null;
 };
-declare const Block: react.MemoExoticComponent<({ content, shouldParseIncompleteMarkdown: _, shouldNormalizeHtmlIndentation, index: __, isIncomplete, dir, animatePlugin: animatePluginProp, ...props }: BlockProps) => react_jsx_runtime.JSX.Element>;
-declare const Streamdown: react.MemoExoticComponent<({ children, mode, dir, parseIncompleteMarkdown: shouldParseIncompleteMarkdown, normalizeHtmlIndentation: shouldNormalizeHtmlIndentation, components, rehypePlugins, remarkPlugins, className, shikiTheme, mermaid, codeBlockMaxHeight, controls, isAnimating, tableMaxHeight, animated, BlockComponent, parseMarkdownIntoBlocksFn, caret, listStyle, plugins, remend: remendOptions, linkSafety, lineNumbers, allowedTags, literalTagContent, translations, icons: iconOverrides, prefix, onAnimationStart, onAnimationEnd, ...props }: StreamdownProps) => react_jsx_runtime.JSX.Element>;
-
-export { type AllowElement, type AllowedTags, type AnimateOptions, Block, type BlockProps, type CjkPlugin, CodeBlock, CodeBlockContainer, CodeBlockCopyButton, CodeBlockDownloadButton, CodeBlockHeader, CodeBlockSkeleton, type CodeHighlighterPlugin, type Components, type ControlsConfig, type CustomRenderer, type CustomRendererProps, type DiagramPlugin, type ExtraProps, type HighlightOptions, type IconMap, type IncrementalParseState, type LinkSafetyConfig, type LinkSafetyModalProps, type ListStylePreset, type MathPlugin, type MermaidErrorComponentProps, type MermaidOptions, type PluginConfig, Streamdown, StreamdownContext, type StreamdownContextType, type StreamdownProps, type StreamdownTranslations, TableCopyDropdown, type TableCopyDropdownProps, type TableData, TableDownloadButton, type TableDownloadButtonProps, TableDownloadDropdown, type TableDownloadDropdownProps, type ThemeInput, type UrlTransform, createAnimateCursor, createAnimatePlugin, defaultRehypePlugins, defaultRemarkPlugins, defaultTranslations, defaultUrlTransform, detectTextDirection, escapeMarkdownTableCell, extractTableDataFromElement, normalizeHtmlIndentation, parseMarkdownIntoBlocks, parseMarkdownIntoBlocksIncremental, tableDataToCSV, tableDataToMarkdown, tableDataToTSV, useIsCodeFenceIncomplete };
+export declare const Block: import("react").MemoExoticComponent<({ content, shouldParseIncompleteMarkdown: _, shouldNormalizeHtmlIndentation, index: __, isIncomplete, dir, animatePlugin: animatePluginProp, ...props }: BlockProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const Streamdown: import("react").MemoExoticComponent<({ children, mode, dir, parseIncompleteMarkdown: shouldParseIncompleteMarkdown, normalizeHtmlIndentation: shouldNormalizeHtmlIndentation, components, rehypePlugins, remarkPlugins, className, shikiTheme, mermaid, codeBlockMaxHeight, controls, isAnimating, scrollable, tableMaxHeight, animated, BlockComponent, parseMarkdownIntoBlocksFn, caret, listStyle, calloutIcon, calloutStyle, plugins, remend: remendOptions, linkSafety, lineNumbers, allowedTags, literalTagContent, translations, icons: iconOverrides, prefix, onAnimationStart, onAnimationEnd, ...props }: StreamdownProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/index.js

@@ -1,2 +1,2 @@
 "use client";
-export{D as Block,h as CodeBlock,e as CodeBlockContainer,j as CodeBlockCopyButton,k as CodeBlockDownloadButton,f as CodeBlockHeader,l as CodeBlockSkeleton,E as Streamdown,m as StreamdownContext,t as TableCopyDropdown,u as TableDownloadButton,v as TableDownloadDropdown,a as createAnimateCursor,b as createAnimatePlugin,B as defaultRehypePlugins,C as defaultRemarkPlugins,i as defaultTranslations,x as defaultUrlTransform,w as detectTextDirection,r as escapeMarkdownTableCell,o as extractTableDataFromElement,A as normalizeHtmlIndentation,y as parseMarkdownIntoBlocks,z as parseMarkdownIntoBlocksIncremental,p as tableDataToCSV,s as tableDataToMarkdown,q as tableDataToTSV,c as useIsCodeFenceIncomplete}from'./chunk-TA335CDR.js';
+export{E as Block,i as CodeBlock,f as CodeBlockContainer,k as CodeBlockCopyButton,l as CodeBlockDownloadButton,g as CodeBlockHeader,m as CodeBlockSkeleton,d as DefaultScrollable,F as Streamdown,n as StreamdownContext,v as TableCopyDropdown,w as TableDownloadButton,x as TableDownloadDropdown,a as createAnimateCursor,b as createAnimatePlugin,C as defaultRehypePlugins,D as defaultRemarkPlugins,j as defaultTranslations,o as defaultUrlTransform,y as detectTextDirection,t as escapeMarkdownTableCell,q as extractTableDataFromElement,B as normalizeHtmlIndentation,z as parseMarkdownIntoBlocks,A as parseMarkdownIntoBlocksIncremental,r as tableDataToCSV,u as tableDataToMarkdown,s as tableDataToTSV,c as useIsCodeFenceIncomplete}from'./chunk-NE4QKYRI.js';

package/dist/lib/animate.d.ts

@@ -0,0 +1,66 @@
+import type { Pluggable } from "unified";
+/**
+ * Shared cursor used to chain stagger delays across sibling blocks in a
+ * single render pass.  Create one instance per Streamdown component and
+ * reset `cursor.current = 0` before each React render so that block 0
+ * starts at index 0 and each subsequent block continues from where the
+ * previous one left off.
+ */
+export interface AnimateCursor {
+    current: number;
+}
+export declare function createAnimateCursor(): AnimateCursor;
+export interface AnimatePlugin {
+    /**
+     * Returns the total HAST text node character count from the last
+     * rehype run, then resets to 0. Use this value as the argument to
+     * setPrevContentLength on the next render.
+     */
+    getLastRenderCharCount: () => number;
+    /**
+     * Returns the number of newly-animated words from the last rehype run,
+     * then resets to 0. Pass this value to setStartIndex() on the next
+     * sibling block so its stagger delays chain after ours.
+     */
+    getLastRenderNewWordCount: () => number;
+    name: "animate";
+    rehypePlugin: Pluggable;
+    /**
+     * Enable or disable animation inside code/pre blocks.
+     * When true, code block content will be animated incrementally
+     * during streaming (useful for incomplete/unclosed code fences).
+     */
+    setAnimateCodeBlocks: (enabled: boolean) => void;
+    /**
+     * Set the number of HAST text characters from a previous render.
+     * Characters up to this count will get duration=0ms, preventing
+     * re-animation of already-visible content during streaming updates.
+     */
+    setPrevContentLength: (length: number) => void;
+    /**
+     * Set the animation word index to start from. Used when no shared
+     * cursor is provided. Use the value returned by
+     * getLastRenderNewWordCount() from the previous sibling block to
+     * ensure that a new block's stagger delays begin after the previous
+     * block's animation is still completing, preventing concurrent reveals.
+     */
+    setStartIndex: (index: number) => void;
+    type: "animate";
+}
+export interface AnimateOptions {
+    animation?: "fadeIn" | "blurIn" | "slideUp" | (string & {});
+    /**
+     * Shared cursor for automatic cross-block stagger chaining.  When
+     * provided the plugin reads `cursor.current` as the start index and
+     * increments it by the number of newly animated words after each run,
+     * so sibling blocks automatically pick up where the previous one left
+     * off without any manual `setStartIndex` calls.
+     */
+    cursor?: AnimateCursor;
+    duration?: number;
+    easing?: string;
+    sep?: "word" | "char";
+    stagger?: number;
+}
+export declare function createAnimatePlugin(options?: AnimateOptions): AnimatePlugin;
+export declare const animate: AnimatePlugin;