@stream-mdx/react 0.5.0 → 1.0.0

package/dist/{streaming-markdown-CEI9eDZm.d.ts → streaming-markdown-yELbJxyH.d.ts}

@@ -1,50 +1,23 @@
-import React from 'react';
-import { PatchMetrics, FormatAnticipationConfig, CodeHighlightingMode, Block } from '@stream-mdx/core';
-import { L as LinkSafetyModalProps, B as BlockComponents, T as TableElements, H as HtmlElements, a as InlineComponents } from './index-BVhp_pcF.js';
+import React__default from 'react';
+import { a1 as LinkSafetyModalProps, l as ElementFilterOptions, _ as NodePresentations, C as ContentComponentsMap, a2 as MathEngine, $ as MermaidEngine, M as MathOptions, T as TableVirtualizationOptions, b as ControlsConfig, c as ControlsComponentProps, w as AnimatedProp } from './index-D7dyyu3q.js';
+import { PatchMetrics, FormatAnticipationConfig, CodeHighlightingMode, Block, ContentPolicy, SyntaxExtensionDescriptor, HtmlOptions, UrlTransform } from '@stream-mdx/core';
+import { VirtualizedCodeConfig } from './renderer/virtualized-code.js';
+import { a as TrustedMdxEngine } from './trusted-mdx-contract-ElKpkDI5.js';
+import { FinalizeResult, AppendResult, WaitForCapacityOptions } from '@stream-mdx/protocol';
 import { AdaptiveBudgetState, PatchFlushResult } from './renderer/patch-commit-scheduler.js';
 import { RendererStore } from './renderer/store.js';
-
-type MdxHydrationStrategy = "immediate" | "staggered" | "visible";
-type MdxHydrationOptions = {
-    strategy?: MdxHydrationStrategy;
-    maxConcurrent?: number;
-    delayMs?: number;
-    rootMargin?: string;
-    idleTimeoutMs?: number;
-    debounceMs?: number;
-};
+import { CodeEngine } from '@stream-mdx/worker/engine';
 
 type DeferredRenderConfig = {
     rootMargin?: string;
     idleTimeoutMs?: number;
     debounceMs?: number;
 };
-declare const DeferredRenderContext: React.Context<DeferredRenderConfig | null>;
+declare const DeferredRenderContext: React__default.Context<DeferredRenderConfig | null>;
 
-type MdxPrefetchSummary = {
-    requested: number;
-    completed: number;
-    error: number;
-    pending: number;
-    avgPrefetchMs: number | null;
-    p95PrefetchMs: number | null;
-    maxPrefetchMs: number | null;
-    lastPrefetchMs: number | null;
-};
-type MdxHydrationSummary = {
-    compiled: number;
-    hydrated: number;
-    error: number;
-    avgHydrationMs: number | null;
-    p95HydrationMs: number | null;
-    maxHydrationMs: number | null;
-    lastHydrationMs: number | null;
-    longTaskTotalMs: number | null;
-    longTaskCount: number | null;
-    p95LongTaskMs: number | null;
-    maxLongTaskMs: number | null;
-    prefetch?: MdxPrefetchSummary | null;
-};
+declare class EngineCompatibilityError extends Error {
+    constructor(message?: string);
+}
 
 interface StreamingSchedulerOptions {
     frameBudgetMs?: number;
@@ -73,6 +46,10 @@ interface StreamingFeatureFlags {
     liveTokenization?: boolean;
     emitHighlightTokens?: boolean;
     emitDiffBlocks?: boolean;
+    themes?: {
+        light: string;
+        dark: string;
+    };
 }
 /**
  * Metrics emitted after each flush (high-priority + low-priority batches).
@@ -107,16 +84,14 @@ interface RendererStateSnapshot {
     rendererVersion: number;
     store: RendererStore;
     lastMetrics: RendererMetrics | null;
-    mdxHydration?: MdxHydrationSummary & {
-        pending: number;
-    };
 }
 interface StreamingMarkdownHandle {
     pause(): void;
     resume(): void;
     restart(): void;
-    finalize(): void;
-    append(text: string): void;
+    finalize(): Promise<FinalizeResult>;
+    append(text: string): AppendResult;
+    waitForCapacity(options: WaitForCapacityOptions): Promise<void>;
     setCredits(value: number): void;
     flushPending(): PatchFlushResult | null;
     waitForIdle(): Promise<void>;
@@ -129,31 +104,50 @@ type LinkSafetyCheck = (url: string) => boolean | Promise<boolean>;
 type LinkSafetyConfig = {
     enabled?: boolean;
     onLinkCheck?: LinkSafetyCheck;
-    renderModal?: (props: LinkSafetyModalProps) => React.ReactNode;
+    renderModal?: (props: LinkSafetyModalProps) => React__default.ReactNode;
 };
-interface StreamingMarkdownProps {
+type MarkdownEngineMode = "auto" | "main" | "worker";
+interface StreamingMarkdownProps extends ElementFilterOptions {
     text?: string;
     stream?: AsyncIterable<string>;
     worker?: Worker | URL | (() => Worker) | string;
+    engine?: MarkdownEngineMode;
     managedWorker?: boolean;
     prewarmLangs?: string[];
     features?: StreamingFeatureFlags;
-    components?: Partial<BlockComponents>;
-    tableElements?: Partial<TableElements>;
-    htmlElements?: Partial<HtmlElements>;
-    mdxComponents?: Record<string, React.ComponentType<unknown>>;
-    inlineComponents?: Partial<InlineComponents>;
+    themes?: {
+        light: string;
+        dark: string;
+    };
+    colorScheme?: "light" | "dark" | "system";
+    components?: NodePresentations;
     scheduling?: StreamingSchedulerOptions;
-    mdxCompileMode?: "server" | "worker";
-    mdxHydration?: MdxHydrationOptions;
+    contentPolicy?: ContentPolicy;
+    contentComponents?: ContentComponentsMap;
+    engines?: {
+        code?: CodeEngine;
+        math?: MathEngine;
+        mermaid?: MermaidEngine;
+        mdx?: TrustedMdxEngine;
+    };
     onMetrics?: (metrics: RendererMetrics) => void;
     onError?: (error: Error) => void;
     className?: string;
-    style?: React.CSSProperties;
+    style?: React__default.CSSProperties;
     caret?: StreamingCaret;
     linkSafety?: LinkSafetyConfig;
+    mathOptions?: MathOptions;
     deferHeavyBlocks?: boolean | DeferredRenderConfig;
+    syntax?: SyntaxExtensionDescriptor;
+    html?: HtmlOptions;
+    tableVirtualization?: TableVirtualizationOptions;
+    codeVirtualization?: Partial<VirtualizedCodeConfig>;
+    urlTransform?: UrlTransform;
+    controls?: ControlsConfig;
+    controlsComponent?: React__default.ComponentType<ControlsComponentProps>;
+    animated?: AnimatedProp;
+    statusMessage?: string;
 }
-declare const StreamingMarkdown: React.ForwardRefExoticComponent<StreamingMarkdownProps & React.RefAttributes<StreamingMarkdownHandle>>;
+declare const StreamingMarkdown: React__default.ForwardRefExoticComponent<StreamingMarkdownProps & React__default.RefAttributes<StreamingMarkdownHandle>>;
 
-export { type DeferredRenderConfig as D, type LinkSafetyCheck as L, type MdxHydrationOptions as M, type RendererMetrics as R, type StreamingSchedulerOptions as S, DeferredRenderContext as a, type StreamingFeatureFlags as b, type RendererStateSnapshot as c, type StreamingMarkdownHandle as d, type StreamingCaret as e, type LinkSafetyConfig as f, type StreamingMarkdownProps as g, StreamingMarkdown as h };
+export { type DeferredRenderConfig as D, EngineCompatibilityError as E, type LinkSafetyCheck as L, type MarkdownEngineMode as M, type RendererMetrics as R, type StreamingSchedulerOptions as S, DeferredRenderContext as a, type StreamingFeatureFlags as b, type RendererStateSnapshot as c, type StreamingMarkdownHandle as d, type StreamingCaret as e, type LinkSafetyConfig as f, type StreamingMarkdownProps as g, StreamingMarkdown as h };

package/dist/{streaming-markdown-DRisClXb.d.cts → streaming-markdown-zVwFuaJG.d.cts}

@@ -1,50 +1,23 @@
-import React from 'react';
-import { PatchMetrics, FormatAnticipationConfig, CodeHighlightingMode, Block } from '@stream-mdx/core';
-import { L as LinkSafetyModalProps, B as BlockComponents, T as TableElements, H as HtmlElements, a as InlineComponents } from './index-EaeouYp2.cjs';
+import React__default from 'react';
+import { a1 as LinkSafetyModalProps, l as ElementFilterOptions, _ as NodePresentations, C as ContentComponentsMap, a2 as MathEngine, $ as MermaidEngine, M as MathOptions, T as TableVirtualizationOptions, b as ControlsConfig, c as ControlsComponentProps, w as AnimatedProp } from './index-Cmne1yUK.cjs';
+import { PatchMetrics, FormatAnticipationConfig, CodeHighlightingMode, Block, ContentPolicy, SyntaxExtensionDescriptor, HtmlOptions, UrlTransform } from '@stream-mdx/core';
+import { VirtualizedCodeConfig } from './renderer/virtualized-code.cjs';
+import { a as TrustedMdxEngine } from './trusted-mdx-contract-ElKpkDI5.cjs';
+import { FinalizeResult, AppendResult, WaitForCapacityOptions } from '@stream-mdx/protocol';
 import { AdaptiveBudgetState, PatchFlushResult } from './renderer/patch-commit-scheduler.cjs';
 import { RendererStore } from './renderer/store.cjs';
-
-type MdxHydrationStrategy = "immediate" | "staggered" | "visible";
-type MdxHydrationOptions = {
-    strategy?: MdxHydrationStrategy;
-    maxConcurrent?: number;
-    delayMs?: number;
-    rootMargin?: string;
-    idleTimeoutMs?: number;
-    debounceMs?: number;
-};
+import { CodeEngine } from '@stream-mdx/worker/engine';
 
 type DeferredRenderConfig = {
     rootMargin?: string;
     idleTimeoutMs?: number;
     debounceMs?: number;
 };
-declare const DeferredRenderContext: React.Context<DeferredRenderConfig | null>;
+declare const DeferredRenderContext: React__default.Context<DeferredRenderConfig | null>;
 
-type MdxPrefetchSummary = {
-    requested: number;
-    completed: number;
-    error: number;
-    pending: number;
-    avgPrefetchMs: number | null;
-    p95PrefetchMs: number | null;
-    maxPrefetchMs: number | null;
-    lastPrefetchMs: number | null;
-};
-type MdxHydrationSummary = {
-    compiled: number;
-    hydrated: number;
-    error: number;
-    avgHydrationMs: number | null;
-    p95HydrationMs: number | null;
-    maxHydrationMs: number | null;
-    lastHydrationMs: number | null;
-    longTaskTotalMs: number | null;
-    longTaskCount: number | null;
-    p95LongTaskMs: number | null;
-    maxLongTaskMs: number | null;
-    prefetch?: MdxPrefetchSummary | null;
-};
+declare class EngineCompatibilityError extends Error {
+    constructor(message?: string);
+}
 
 interface StreamingSchedulerOptions {
     frameBudgetMs?: number;
@@ -73,6 +46,10 @@ interface StreamingFeatureFlags {
     liveTokenization?: boolean;
     emitHighlightTokens?: boolean;
     emitDiffBlocks?: boolean;
+    themes?: {
+        light: string;
+        dark: string;
+    };
 }
 /**
  * Metrics emitted after each flush (high-priority + low-priority batches).
@@ -107,16 +84,14 @@ interface RendererStateSnapshot {
     rendererVersion: number;
     store: RendererStore;
     lastMetrics: RendererMetrics | null;
-    mdxHydration?: MdxHydrationSummary & {
-        pending: number;
-    };
 }
 interface StreamingMarkdownHandle {
     pause(): void;
     resume(): void;
     restart(): void;
-    finalize(): void;
-    append(text: string): void;
+    finalize(): Promise<FinalizeResult>;
+    append(text: string): AppendResult;
+    waitForCapacity(options: WaitForCapacityOptions): Promise<void>;
     setCredits(value: number): void;
     flushPending(): PatchFlushResult | null;
     waitForIdle(): Promise<void>;
@@ -129,31 +104,50 @@ type LinkSafetyCheck = (url: string) => boolean | Promise<boolean>;
 type LinkSafetyConfig = {
     enabled?: boolean;
     onLinkCheck?: LinkSafetyCheck;
-    renderModal?: (props: LinkSafetyModalProps) => React.ReactNode;
+    renderModal?: (props: LinkSafetyModalProps) => React__default.ReactNode;
 };
-interface StreamingMarkdownProps {
+type MarkdownEngineMode = "auto" | "main" | "worker";
+interface StreamingMarkdownProps extends ElementFilterOptions {
     text?: string;
     stream?: AsyncIterable<string>;
     worker?: Worker | URL | (() => Worker) | string;
+    engine?: MarkdownEngineMode;
     managedWorker?: boolean;
     prewarmLangs?: string[];
     features?: StreamingFeatureFlags;
-    components?: Partial<BlockComponents>;
-    tableElements?: Partial<TableElements>;
-    htmlElements?: Partial<HtmlElements>;
-    mdxComponents?: Record<string, React.ComponentType<unknown>>;
-    inlineComponents?: Partial<InlineComponents>;
+    themes?: {
+        light: string;
+        dark: string;
+    };
+    colorScheme?: "light" | "dark" | "system";
+    components?: NodePresentations;
     scheduling?: StreamingSchedulerOptions;
-    mdxCompileMode?: "server" | "worker";
-    mdxHydration?: MdxHydrationOptions;
+    contentPolicy?: ContentPolicy;
+    contentComponents?: ContentComponentsMap;
+    engines?: {
+        code?: CodeEngine;
+        math?: MathEngine;
+        mermaid?: MermaidEngine;
+        mdx?: TrustedMdxEngine;
+    };
     onMetrics?: (metrics: RendererMetrics) => void;
     onError?: (error: Error) => void;
     className?: string;
-    style?: React.CSSProperties;
+    style?: React__default.CSSProperties;
     caret?: StreamingCaret;
     linkSafety?: LinkSafetyConfig;
+    mathOptions?: MathOptions;
     deferHeavyBlocks?: boolean | DeferredRenderConfig;
+    syntax?: SyntaxExtensionDescriptor;
+    html?: HtmlOptions;
+    tableVirtualization?: TableVirtualizationOptions;
+    codeVirtualization?: Partial<VirtualizedCodeConfig>;
+    urlTransform?: UrlTransform;
+    controls?: ControlsConfig;
+    controlsComponent?: React__default.ComponentType<ControlsComponentProps>;
+    animated?: AnimatedProp;
+    statusMessage?: string;
 }
-declare const StreamingMarkdown: React.ForwardRefExoticComponent<StreamingMarkdownProps & React.RefAttributes<StreamingMarkdownHandle>>;
+declare const StreamingMarkdown: React__default.ForwardRefExoticComponent<StreamingMarkdownProps & React__default.RefAttributes<StreamingMarkdownHandle>>;
 
-export { type DeferredRenderConfig as D, type LinkSafetyCheck as L, type MdxHydrationOptions as M, type RendererMetrics as R, type StreamingSchedulerOptions as S, DeferredRenderContext as a, type StreamingFeatureFlags as b, type RendererStateSnapshot as c, type StreamingMarkdownHandle as d, type StreamingCaret as e, type LinkSafetyConfig as f, type StreamingMarkdownProps as g, StreamingMarkdown as h };
+export { type DeferredRenderConfig as D, EngineCompatibilityError as E, type LinkSafetyCheck as L, type MarkdownEngineMode as M, type RendererMetrics as R, type StreamingSchedulerOptions as S, DeferredRenderContext as a, type StreamingFeatureFlags as b, type RendererStateSnapshot as c, type StreamingMarkdownHandle as d, type StreamingCaret as e, type LinkSafetyConfig as f, type StreamingMarkdownProps as g, StreamingMarkdown as h };