@lobehub/ui 5.10.3 → 5.10.5

package/es/Highlighter/style.mjs

@@ -164,6 +164,6 @@ const bodyVariants = cva(styles.bodyRoot, {
 	} }
 });
 //#endregion
-export { bodyVariants, headerVariants, styles, variants };
+export { actionsHoverCls, bodyVariants, headerVariants, styles, variants };
 
 //# sourceMappingURL=style.mjs.map

package/es/HtmlPreview/HtmlPreview.d.mts

@@ -0,0 +1,8 @@
+import { HtmlPreviewProps } from "./type.mjs";
+import * as _$react from "react";
+
+//#region src/HtmlPreview/HtmlPreview.d.ts
+declare const HtmlPreview: _$react.NamedExoticComponent<HtmlPreviewProps>;
+//#endregion
+export { HtmlPreview };
+//# sourceMappingURL=HtmlPreview.d.mts.map

package/es/HtmlPreview/HtmlPreview.mjs

@@ -0,0 +1,377 @@
+"use client";
+import FlexBasic_default from "../Flex/FlexBasic.mjs";
+import { stopPropagation } from "../utils/dom.mjs";
+import ActionIcon from "../ActionIcon/ActionIcon.mjs";
+import SyntaxHighlighter from "../Highlighter/SyntaxHighlighter/index.mjs";
+import CopyButton from "../CopyButton/CopyButton.mjs";
+import { downloadBlob } from "../utils/downloadBlob.mjs";
+import { actionsHoverCls, variants } from "../Highlighter/style.mjs";
+import { containsScript, isFullHtmlDocument, isHtmlContentClosed } from "./const.mjs";
+import NeuralNetworkLoading from "../NeuralNetworkLoading/NeuralNetworkLoading.mjs";
+import Segmented from "../Segmented/Segmented.mjs";
+import HtmlPreviewIframe from "./Iframe.mjs";
+import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { createStyles, cx, keyframes } from "antd-style";
+import { Download, Expand } from "lucide-react";
+//#region src/HtmlPreview/HtmlPreview.tsx
+const shimmer = keyframes`
+  0%   { background-position: 200% 0; }
+  100% { background-position: -200% 0; }
+`;
+const useStyles = createStyles(({ css, cssVar, isDarkMode }) => ({
+	loadingBackdrop: css`
+    pointer-events: none;
+
+    position: absolute;
+    z-index: 1;
+    inset: 0;
+
+    /* Subtle moving sheen so it doesn't look frozen. */
+    background: linear-gradient(
+      90deg,
+      transparent 0%,
+      ${isDarkMode ? "rgba(255, 255, 255, 0.04)" : "rgba(0, 0, 0, 0.04)"} 50%,
+      transparent 100%
+    );
+    background-repeat: no-repeat;
+    background-size: 200% 100%;
+
+    animation: ${shimmer} 1.6s ${cssVar.motionEaseInOut} infinite;
+  `,
+	loadingBadge: css`
+    position: absolute;
+    z-index: 2;
+    inset-block-start: 12px;
+    inset-inline-start: 12px;
+
+    display: inline-flex;
+    gap: 8px;
+    align-items: center;
+
+    padding-block: 4px;
+    padding-inline: 6px 10px;
+    border-radius: 999px;
+
+    font-size: 12px;
+    color: ${cssVar.colorTextDescription};
+
+    background: ${cssVar.colorBgContainer};
+    backdrop-filter: blur(8px);
+    box-shadow: 0 0 0 1px ${cssVar.colorBorderSecondary};
+  `,
+	loadingSource: css`
+    pointer-events: none;
+    overflow: hidden;
+    height: 100%;
+
+    /* Faded out so the iframe transition feels like content lighting up,
+       not like one document jump-cutting to another. */
+    opacity: 0.45;
+
+    /* SyntaxHighlighter sets its own background; flatten so the shimmer
+       overlay reads cleanly on top. */
+    & [data-code-type='highlighter'] {
+      background: transparent;
+      box-shadow: none;
+    }
+
+    /* Tail-follow is layout-only — we anchor the scrollable element to
+       its scrollHeight via the ref + effect; CSS just keeps the
+       overflow hidden. */
+    & pre,
+    & code {
+      background: transparent !important;
+    }
+  `,
+	loadingRoot: css`
+    position: relative;
+    overflow: hidden;
+    background: ${isDarkMode ? "#1f1f1f" : "#fafafa"};
+  `,
+	toolbar: cx(actionsHoverCls, css`
+      position: absolute;
+      z-index: 2;
+      inset-block-start: 8px;
+      inset-inline-end: 8px;
+
+      padding: 4px;
+      border-radius: ${cssVar.borderRadiusLG};
+
+      opacity: 0;
+      background: ${cssVar.colorBgContainer};
+      backdrop-filter: blur(8px);
+      box-shadow: 0 0 0 1px ${cssVar.colorBorderSecondary};
+
+      transition: opacity 0.2s ${cssVar.motionEaseOut};
+
+      &:focus-within {
+        opacity: 1;
+      }
+    `)
+}));
+const themeBackground = (theme) => {
+	if (theme === "dark") return "#1f1f1f";
+	if (theme === "light") return "#ffffff";
+};
+const downloadHtml = async (content, fileName) => {
+	const blob = new Blob([content], { type: "text/html;charset=utf-8" });
+	const url = URL.createObjectURL(blob);
+	try {
+		await downloadBlob(url, fileName);
+	} finally {
+		URL.revokeObjectURL(url);
+	}
+};
+const HtmlPreview = memo(({ actionIconSize, actionsRender, animated, bodyRender, children, className, classNames, copyable = true, defaultHeight, defaultMode = "preview", downloadable = true, fileName, language = "html", onExpand, sandbox, shadow, streamingMode = "auto", style, styles: customStyles, theme, variant = "filled", fullFeatured: _fullFeatured, showLanguage: _showLanguage, defaultExpand: _defaultExpand, ...rest }) => {
+	const trimmedChildren = useMemo(() => (children || "").trim(), [children]);
+	const isFragment = useMemo(() => !isFullHtmlDocument(trimmedChildren), [trimmedChildren]);
+	const [scriptLocked, setScriptLocked] = useState(false);
+	const [headClosed, setHeadClosed] = useState(false);
+	const [liveCommitted, setLiveCommitted] = useState(false);
+	const prevAnimatedRef = useRef(animated);
+	const lastCommitRef = useRef(0);
+	const pendingTimerRef = useRef(null);
+	const latestContentRef = useRef(trimmedChildren);
+	useEffect(() => {
+		latestContentRef.current = trimmedChildren;
+	}, [trimmedChildren]);
+	useEffect(() => {
+		if (animated && !prevAnimatedRef.current) {
+			setScriptLocked(false);
+			setHeadClosed(false);
+			setLiveCommitted(false);
+			lastCommitRef.current = 0;
+			if (pendingTimerRef.current) {
+				clearTimeout(pendingTimerRef.current);
+				pendingTimerRef.current = null;
+			}
+		}
+		prevAnimatedRef.current = animated;
+	}, [animated]);
+	useEffect(() => {
+		if (animated && !scriptLocked && containsScript(trimmedChildren)) setScriptLocked(true);
+	}, [
+		trimmedChildren,
+		animated,
+		scriptLocked
+	]);
+	useEffect(() => {
+		if (animated && !headClosed) {
+			const lowered = trimmedChildren.toLowerCase();
+			if (lowered.includes("</head>") || lowered.includes("</style>")) setHeadClosed(true);
+		}
+	}, [
+		trimmedChildren,
+		animated,
+		headClosed
+	]);
+	const [throttledContent, setThrottledContent] = useState(trimmedChildren);
+	useEffect(() => {
+		if (!animated) {
+			if (pendingTimerRef.current) {
+				clearTimeout(pendingTimerRef.current);
+				pendingTimerRef.current = null;
+			}
+			lastCommitRef.current = Date.now();
+			setThrottledContent(trimmedChildren);
+			return;
+		}
+		if (!headClosed) return;
+		const throttleMs = 250;
+		const now = Date.now();
+		const elapsed = now - lastCommitRef.current;
+		if (elapsed >= throttleMs) {
+			if (pendingTimerRef.current) {
+				clearTimeout(pendingTimerRef.current);
+				pendingTimerRef.current = null;
+			}
+			lastCommitRef.current = now;
+			setThrottledContent(trimmedChildren);
+			return;
+		}
+		if (pendingTimerRef.current === null) pendingTimerRef.current = setTimeout(() => {
+			lastCommitRef.current = Date.now();
+			pendingTimerRef.current = null;
+			setThrottledContent(latestContentRef.current);
+		}, throttleMs - elapsed);
+	}, [
+		trimmedChildren,
+		animated,
+		headClosed
+	]);
+	useEffect(() => () => {
+		if (pendingTimerRef.current) clearTimeout(pendingTimerRef.current);
+	}, []);
+	useEffect(() => {
+		if (!animated || liveCommitted || !headClosed) return;
+		if (streamingMode === "live" || streamingMode === "auto" && !scriptLocked) setLiveCommitted(true);
+	}, [
+		animated,
+		headClosed,
+		liveCommitted,
+		scriptLocked,
+		streamingMode
+	]);
+	const isStable = !animated || isHtmlContentClosed(trimmedChildren) || liveCommitted;
+	const [mode, setMode] = useState(defaultMode);
+	const effectiveMode = isFragment ? "source" : mode;
+	const contentRef = useRef(trimmedChildren);
+	useEffect(() => {
+		contentRef.current = trimmedChildren;
+	}, [trimmedChildren]);
+	const loadingSourceRef = useRef(null);
+	useEffect(() => {
+		if (isStable) return;
+		const node = loadingSourceRef.current;
+		if (!node) return;
+		node.scrollTop = node.scrollHeight;
+	}, [trimmedChildren, isStable]);
+	const getCopyContent = useCallback(() => contentRef.current, []);
+	const handleDownload = useCallback(() => {
+		downloadHtml(contentRef.current, fileName || "preview.html");
+	}, [fileName]);
+	const handleExpand = useCallback(() => {
+		onExpand?.(contentRef.current);
+	}, [onExpand]);
+	const background = themeBackground(theme);
+	const sourceBody = useMemo(() => /* @__PURE__ */ jsx(SyntaxHighlighter, {
+		animated,
+		className: classNames?.content,
+		language: "html",
+		style: {
+			height: "100%",
+			...customStyles?.content
+		},
+		variant,
+		children: trimmedChildren
+	}), [
+		animated,
+		classNames?.content,
+		customStyles?.content,
+		trimmedChildren,
+		variant
+	]);
+	const { styles } = useStyles();
+	const iframeBody = useMemo(() => /* @__PURE__ */ jsx(HtmlPreviewIframe, {
+		animated,
+		background,
+		className: classNames?.iframe,
+		content: throttledContent,
+		defaultHeight,
+		sandbox,
+		style: customStyles?.iframe
+	}), [
+		background,
+		classNames?.iframe,
+		customStyles?.iframe,
+		defaultHeight,
+		sandbox,
+		throttledContent
+	]);
+	const loadingBody = useMemo(() => /* @__PURE__ */ jsxs("div", {
+		className: styles.loadingRoot,
+		style: { height: defaultHeight ?? 400 },
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: styles.loadingSource,
+				ref: loadingSourceRef,
+				children: /* @__PURE__ */ jsx(SyntaxHighlighter, {
+					animated,
+					language: "html",
+					variant: "borderless",
+					children: trimmedChildren
+				})
+			}),
+			/* @__PURE__ */ jsx("div", { className: styles.loadingBackdrop }),
+			/* @__PURE__ */ jsxs("div", {
+				className: styles.loadingBadge,
+				children: [/* @__PURE__ */ jsx(NeuralNetworkLoading, { size: 16 }), /* @__PURE__ */ jsx("span", { children: "Preparing preview…" })]
+			})
+		]
+	}), [
+		animated,
+		defaultHeight,
+		styles,
+		trimmedChildren
+	]);
+	const defaultBody = effectiveMode === "preview" ? isStable ? iframeBody : loadingBody : sourceBody;
+	const body = useMemo(() => {
+		if (!bodyRender) return defaultBody;
+		return bodyRender({
+			content: trimmedChildren,
+			mode: effectiveMode,
+			originalNode: defaultBody
+		});
+	}, [
+		bodyRender,
+		defaultBody,
+		effectiveMode,
+		trimmedChildren
+	]);
+	const segmentOptions = useMemo(() => [{
+		label: "Preview",
+		value: "preview"
+	}, {
+		label: "Source",
+		value: "source"
+	}], []);
+	const iconSize = actionIconSize || "small";
+	const originalActions = /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		!isFragment && /* @__PURE__ */ jsx(Segmented, {
+			options: segmentOptions,
+			size: "small",
+			value: effectiveMode,
+			onChange: (v) => setMode(v)
+		}),
+		copyable && /* @__PURE__ */ jsx(CopyButton, {
+			content: getCopyContent,
+			size: iconSize
+		}),
+		downloadable && /* @__PURE__ */ jsx(ActionIcon, {
+			icon: Download,
+			size: iconSize,
+			title: "Download HTML",
+			onClick: handleDownload
+		}),
+		onExpand && /* @__PURE__ */ jsx(ActionIcon, {
+			icon: Expand,
+			size: iconSize,
+			title: "Open full preview",
+			onClick: handleExpand
+		})
+	] });
+	const actions = actionsRender ? actionsRender({
+		actionIconSize: iconSize,
+		content: trimmedChildren,
+		getContent: getCopyContent,
+		mode: effectiveMode,
+		originalNode: originalActions,
+		setMode
+	}) : originalActions;
+	return /* @__PURE__ */ jsxs("div", {
+		className: cx(variants({
+			shadow,
+			variant
+		}), className),
+		"data-code-type": "html-preview",
+		"data-html-preview-language": language,
+		style,
+		...rest,
+		children: [/* @__PURE__ */ jsx(FlexBasic_default, {
+			horizontal: true,
+			align: "center",
+			className: cx(styles.toolbar, classNames?.header),
+			flex: "none",
+			gap: 4,
+			style: customStyles?.header,
+			onClick: stopPropagation,
+			children: actions
+		}), body]
+	});
+});
+HtmlPreview.displayName = "HtmlPreview";
+//#endregion
+export { HtmlPreview as default };
+
+//# sourceMappingURL=HtmlPreview.mjs.map

package/es/HtmlPreview/HtmlPreview.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlPreview.mjs","names":["Flexbox"],"sources":["../../src/HtmlPreview/HtmlPreview.tsx"],"sourcesContent":["'use client';\n\nimport { createStyles, cx, keyframes } from 'antd-style';\nimport { Download, Expand } from 'lucide-react';\nimport { memo, type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport ActionIcon from '@/ActionIcon';\nimport CopyButton from '@/CopyButton';\nimport { Flexbox } from '@/Flex';\nimport { actionsHoverCls, variants } from '@/Highlighter/style';\nimport SyntaxHighlighter from '@/Highlighter/SyntaxHighlighter';\nimport NeuralNetworkLoading from '@/NeuralNetworkLoading';\nimport Segmented from '@/Segmented';\nimport { stopPropagation } from '@/utils/dom';\nimport { downloadBlob } from '@/utils/downloadBlob';\n\nimport { containsScript, DEFAULT_HEIGHT, isFullHtmlDocument, isHtmlContentClosed } from './const';\nimport HtmlPreviewIframe from './Iframe';\nimport type { HtmlPreviewMode, HtmlPreviewProps } from './type';\n\n// Sheen sweep direction: left → right.\n// `background-position` works inversely from \"where the image is drawn\":\n// at `200%` the over-sized gradient starts off to the left of the\n// container, at `-200%` it ends off to the right — so animating\n// 200% → -200% moves the visible bright spot from left to right.\nconst shimmer = keyframes`\n  0%   { background-position: 200% 0; }\n  100% { background-position: -200% 0; }\n`;\n\nconst useStyles = createStyles(({ css, cssVar, isDarkMode }) => ({\n  loadingBackdrop: css`\n    pointer-events: none;\n\n    position: absolute;\n    z-index: 1;\n    inset: 0;\n\n    /* Subtle moving sheen so it doesn't look frozen. */\n    background: linear-gradient(\n      90deg,\n      transparent 0%,\n      ${isDarkMode ? 'rgba(255, 255, 255, 0.04)' : 'rgba(0, 0, 0, 0.04)'} 50%,\n      transparent 100%\n    );\n    background-repeat: no-repeat;\n    background-size: 200% 100%;\n\n    animation: ${shimmer} 1.6s ${cssVar.motionEaseInOut} infinite;\n  `,\n  loadingBadge: css`\n    position: absolute;\n    z-index: 2;\n    inset-block-start: 12px;\n    inset-inline-start: 12px;\n\n    display: inline-flex;\n    gap: 8px;\n    align-items: center;\n\n    padding-block: 4px;\n    padding-inline: 6px 10px;\n    border-radius: 999px;\n\n    font-size: 12px;\n    color: ${cssVar.colorTextDescription};\n\n    background: ${cssVar.colorBgContainer};\n    backdrop-filter: blur(8px);\n    box-shadow: 0 0 0 1px ${cssVar.colorBorderSecondary};\n  `,\n  // The streaming source visible during Phase 1 — heavily faded so it\n  // reads as \"this is preview-pending content\" rather than the finished\n  // article. Auto-follows the tail so the user can see new tokens land\n  // even on slow models.\n  loadingSource: css`\n    pointer-events: none;\n    overflow: hidden;\n    height: 100%;\n\n    /* Faded out so the iframe transition feels like content lighting up,\n       not like one document jump-cutting to another. */\n    opacity: 0.45;\n\n    /* SyntaxHighlighter sets its own background; flatten so the shimmer\n       overlay reads cleanly on top. */\n    & [data-code-type='highlighter'] {\n      background: transparent;\n      box-shadow: none;\n    }\n\n    /* Tail-follow is layout-only — we anchor the scrollable element to\n       its scrollHeight via the ref + effect; CSS just keeps the\n       overflow hidden. */\n    & pre,\n    & code {\n      background: transparent !important;\n    }\n  `,\n  loadingRoot: css`\n    position: relative;\n    overflow: hidden;\n    background: ${isDarkMode ? '#1f1f1f' : '#fafafa'};\n  `,\n  // Inline top-right toolbar. Tagged with `actionsHoverCls` so the Highlighter\n  // container's `&:hover .${actionsHoverCls} { opacity: 1 }` rule flips it\n  // in/out as the user moves over the preview — same UX as the regular code\n  // block actions.\n  toolbar: cx(\n    actionsHoverCls,\n    css`\n      position: absolute;\n      z-index: 2;\n      inset-block-start: 8px;\n      inset-inline-end: 8px;\n\n      padding: 4px;\n      border-radius: ${cssVar.borderRadiusLG};\n\n      opacity: 0;\n      background: ${cssVar.colorBgContainer};\n      backdrop-filter: blur(8px);\n      box-shadow: 0 0 0 1px ${cssVar.colorBorderSecondary};\n\n      transition: opacity 0.2s ${cssVar.motionEaseOut};\n\n      &:focus-within {\n        opacity: 1;\n      }\n    `,\n  ),\n}));\n\nconst themeBackground = (theme?: 'light' | 'dark') => {\n  if (theme === 'dark') return '#1f1f1f';\n  if (theme === 'light') return '#ffffff';\n  return undefined;\n};\n\nconst downloadHtml = async (content: string, fileName: string) => {\n  const blob = new Blob([content], { type: 'text/html;charset=utf-8' });\n  const url = URL.createObjectURL(blob);\n  try {\n    await downloadBlob(url, fileName);\n  } finally {\n    URL.revokeObjectURL(url);\n  }\n};\n\nconst HtmlPreview = memo<HtmlPreviewProps>(\n  ({\n    actionIconSize,\n    actionsRender,\n    animated,\n    bodyRender,\n    children,\n    className,\n    classNames,\n    copyable = true,\n    defaultHeight,\n    defaultMode = 'preview',\n    downloadable = true,\n    fileName,\n    language = 'html',\n    onExpand,\n    sandbox,\n    shadow,\n    streamingMode = 'auto',\n    style,\n    styles: customStyles,\n    theme,\n    variant = 'filled',\n    // `fullFeatured` / `showLanguage` / `defaultExpand` are accepted for API\n    // compatibility with the rest of the Pre family but no longer drive a\n    // separate header — the inline toolbar is always rendered.\n    fullFeatured: _fullFeatured,\n    showLanguage: _showLanguage,\n    defaultExpand: _defaultExpand,\n    ...rest\n  }) => {\n    const trimmedChildren = useMemo(() => (children || '').trim(), [children]);\n    const isFragment = useMemo(() => !isFullHtmlDocument(trimmedChildren), [trimmedChildren]);\n\n    // Per-session tracking. Reset on `animated` edge false → true.\n    const [scriptLocked, setScriptLocked] = useState(false);\n    const [headClosed, setHeadClosed] = useState(false);\n    const [liveCommitted, setLiveCommitted] = useState(false);\n    const prevAnimatedRef = useRef(animated);\n    const lastCommitRef = useRef(0);\n    const pendingTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n    const latestContentRef = useRef(trimmedChildren);\n    useEffect(() => {\n      latestContentRef.current = trimmedChildren;\n    }, [trimmedChildren]);\n    useEffect(() => {\n      if (animated && !prevAnimatedRef.current) {\n        setScriptLocked(false);\n        setHeadClosed(false);\n        setLiveCommitted(false);\n        lastCommitRef.current = 0;\n        if (pendingTimerRef.current) {\n          clearTimeout(pendingTimerRef.current);\n          pendingTimerRef.current = null;\n        }\n      }\n      prevAnimatedRef.current = animated;\n    }, [animated]);\n\n    // Sticky script detection: once a `<script>` appears in this session,\n    // auto mode locks into defer.\n    useEffect(() => {\n      if (animated && !scriptLocked && containsScript(trimmedChildren)) {\n        setScriptLocked(true);\n      }\n    }, [trimmedChildren, animated, scriptLocked]);\n\n    // Track whether the head section has closed. Until it does, the iframe\n    // would render either nothing or invalid HTML (style tag mid-stream).\n    // After `</head>` (or `</style>` as a fallback for documents that skip\n    // an explicit head close) we know the visual baseline is locked in.\n    useEffect(() => {\n      if (animated && !headClosed) {\n        const lowered = trimmedChildren.toLowerCase();\n        if (lowered.includes('</head>') || lowered.includes('</style>')) {\n          setHeadClosed(true);\n        }\n      }\n    }, [trimmedChildren, animated, headClosed]);\n\n    // Two-phase streaming commit:\n    //   Phase 1 (head still streaming) — don't mount iframe at all. There's\n    //     nothing meaningful to render and styles aren't applied yet.\n    //   Phase 2 (head closed, body streaming) — commit at most once every\n    //     ~250ms. Important: this is a TRUE throttle, not a debounce. The\n    //     pending timer is held in a ref so it survives effect re-runs;\n    //     when it fires it commits the latest content (via another ref)\n    //     and clears itself, allowing a fresh schedule. If chunks come in\n    //     faster than the throttle window (which they do at ~50/sec) we\n    //     still get a commit every 250ms instead of waiting for streaming\n    //     to pause.\n    //   On streaming end → flush immediately, cancel any pending timer.\n    const [throttledContent, setThrottledContent] = useState(trimmedChildren);\n    useEffect(() => {\n      if (!animated) {\n        if (pendingTimerRef.current) {\n          clearTimeout(pendingTimerRef.current);\n          pendingTimerRef.current = null;\n        }\n        lastCommitRef.current = Date.now();\n        setThrottledContent(trimmedChildren);\n        return;\n      }\n      if (!headClosed) return;\n\n      const throttleMs = 250;\n      const now = Date.now();\n      const elapsed = now - lastCommitRef.current;\n\n      if (elapsed >= throttleMs) {\n        if (pendingTimerRef.current) {\n          clearTimeout(pendingTimerRef.current);\n          pendingTimerRef.current = null;\n        }\n        lastCommitRef.current = now;\n        setThrottledContent(trimmedChildren);\n        return;\n      }\n\n      // Schedule a future commit, but only if one isn't already pending —\n      // every chunk arrival re-runs this effect; we don't want to reset\n      // the timer each time (that's debounce, and during continuous\n      // streaming it would never fire).\n      if (pendingTimerRef.current === null) {\n        pendingTimerRef.current = setTimeout(() => {\n          lastCommitRef.current = Date.now();\n          pendingTimerRef.current = null;\n          setThrottledContent(latestContentRef.current);\n        }, throttleMs - elapsed);\n      }\n    }, [trimmedChildren, animated, headClosed]);\n    useEffect(\n      () => () => {\n        if (pendingTimerRef.current) clearTimeout(pendingTimerRef.current);\n      },\n      [],\n    );\n\n    // Live-streaming commitment is sticky for the rest of the session. The\n    // decision is made the moment the head seals:\n    //   • `live` → commit unconditionally\n    //   • `auto` → commit only if no `<script>` has appeared yet (script-\n    //     bearing docs go down the defer path to avoid running setup() on\n    //     partial source)\n    //   • `defer` → never commit; wait for `</html>`\n    // Sticky-ness matters for `auto`: if a `<script>` arrives *after* the\n    // head has already closed and we've started live-streaming, we keep\n    // streaming rather than yanking the rendered content back into a\n    // loading state mid-flight. The shell→static swap at end of streaming\n    // re-runs the document cleanly anyway.\n    useEffect(() => {\n      if (!animated || liveCommitted || !headClosed) return;\n      if (streamingMode === 'live' || (streamingMode === 'auto' && !scriptLocked)) {\n        setLiveCommitted(true);\n      }\n    }, [animated, headClosed, liveCommitted, scriptLocked, streamingMode]);\n\n    // Streaming gate. The iframe can mount in three situations:\n    //   1. content is no longer animating\n    //   2. `</html>` has arrived\n    //   3. live streaming has been committed this session\n    const isStable = !animated || isHtmlContentClosed(trimmedChildren) || liveCommitted;\n\n    const [mode, setMode] = useState<HtmlPreviewMode>(defaultMode);\n\n    // Fragments cannot meaningfully render in preview — force source view.\n    // For streaming content that's not yet stable we keep the user's mode\n    // choice and substitute a loading placeholder in the body instead, so\n    // the toggle UI doesn't flip back and forth as content arrives.\n    const effectiveMode: HtmlPreviewMode = isFragment ? 'source' : mode;\n\n    const contentRef = useRef(trimmedChildren);\n    useEffect(() => {\n      contentRef.current = trimmedChildren;\n    }, [trimmedChildren]);\n\n    // Tail-follow the streaming source visible during Phase 1 — anchor\n    // the scroll position to the latest tokens so a slow model's output\n    // doesn't sit pinned to the document head while the user waits.\n    const loadingSourceRef = useRef<HTMLDivElement | null>(null);\n    useEffect(() => {\n      if (isStable) return;\n      const node = loadingSourceRef.current;\n      if (!node) return;\n      node.scrollTop = node.scrollHeight;\n    }, [trimmedChildren, isStable]);\n\n    const getCopyContent = useCallback(() => contentRef.current, []);\n\n    const handleDownload = useCallback(() => {\n      void downloadHtml(contentRef.current, fileName || 'preview.html');\n    }, [fileName]);\n\n    const handleExpand = useCallback(() => {\n      onExpand?.(contentRef.current);\n    }, [onExpand]);\n\n    const background = themeBackground(theme);\n\n    const sourceBody = useMemo(\n      () => (\n        <SyntaxHighlighter\n          animated={animated}\n          className={classNames?.content}\n          language={'html'}\n          style={{ height: '100%', ...customStyles?.content }}\n          variant={variant}\n        >\n          {trimmedChildren}\n        </SyntaxHighlighter>\n      ),\n      [animated, classNames?.content, customStyles?.content, trimmedChildren, variant],\n    );\n\n    const { styles } = useStyles();\n\n    const iframeBody = useMemo(\n      () => (\n        <HtmlPreviewIframe\n          animated={animated}\n          background={background}\n          className={classNames?.iframe}\n          content={throttledContent}\n          defaultHeight={defaultHeight}\n          sandbox={sandbox}\n          style={customStyles?.iframe}\n        />\n      ),\n      [\n        background,\n        classNames?.iframe,\n        customStyles?.iframe,\n        defaultHeight,\n        sandbox,\n        throttledContent,\n      ],\n    );\n\n    // Shown when the user is on preview mode but the iframe isn't ready\n    // yet (Phase 1 of streaming: head still arriving). Holds the eventual\n    // iframe height to avoid layout shift on mount.\n    //\n    // Stream the raw source through `SyntaxHighlighter` at low opacity so\n    // the user sees real progress on slow models (a 30-tps DeepSeek\n    // pumping a ~5 KB head can otherwise sit on a static spinner for\n    // 20+ seconds). A small \"Preparing preview…\" badge keeps the loading\n    // state unambiguous. Tail-follow keeps the visible region anchored\n    // to the latest tokens — see the `useEffect` below.\n    const loadingBody = useMemo(\n      () => (\n        <div className={styles.loadingRoot} style={{ height: defaultHeight ?? DEFAULT_HEIGHT }}>\n          <div className={styles.loadingSource} ref={loadingSourceRef}>\n            <SyntaxHighlighter animated={animated} language={'html'} variant={'borderless'}>\n              {trimmedChildren}\n            </SyntaxHighlighter>\n          </div>\n          <div className={styles.loadingBackdrop} />\n          <div className={styles.loadingBadge}>\n            <NeuralNetworkLoading size={16} />\n            <span>Preparing preview…</span>\n          </div>\n        </div>\n      ),\n      [animated, defaultHeight, styles, trimmedChildren],\n    );\n\n    const previewBody = isStable ? iframeBody : loadingBody;\n\n    const defaultBody = effectiveMode === 'preview' ? previewBody : sourceBody;\n\n    const body = useMemo(() => {\n      if (!bodyRender) return defaultBody;\n      return bodyRender({\n        content: trimmedChildren,\n        mode: effectiveMode,\n        originalNode: defaultBody,\n      });\n    }, [bodyRender, defaultBody, effectiveMode, trimmedChildren]);\n\n    const segmentOptions = useMemo(\n      () => [\n        { label: 'Preview', value: 'preview' as const },\n        { label: 'Source', value: 'source' as const },\n      ],\n      [],\n    );\n\n    const iconSize = actionIconSize || 'small';\n\n    const originalActions: ReactNode = (\n      <>\n        {!isFragment && (\n          <Segmented\n            options={segmentOptions}\n            size={'small'}\n            value={effectiveMode}\n            onChange={(v) => setMode(v as HtmlPreviewMode)}\n          />\n        )}\n        {copyable && <CopyButton content={getCopyContent} size={iconSize} />}\n        {downloadable && (\n          <ActionIcon\n            icon={Download}\n            size={iconSize}\n            title={'Download HTML'}\n            onClick={handleDownload}\n          />\n        )}\n        {onExpand && (\n          <ActionIcon\n            icon={Expand}\n            size={iconSize}\n            title={'Open full preview'}\n            onClick={handleExpand}\n          />\n        )}\n      </>\n    );\n\n    const actions = actionsRender\n      ? actionsRender({\n          actionIconSize: iconSize,\n          content: trimmedChildren,\n          getContent: getCopyContent,\n          mode: effectiveMode,\n          originalNode: originalActions,\n          setMode,\n        })\n      : originalActions;\n\n    return (\n      <div\n        className={cx(variants({ shadow, variant }), className)}\n        data-code-type=\"html-preview\"\n        data-html-preview-language={language}\n        style={style}\n        {...rest}\n      >\n        <Flexbox\n          horizontal\n          align={'center'}\n          className={cx(styles.toolbar, classNames?.header)}\n          flex={'none'}\n          gap={4}\n          style={customStyles?.header}\n          onClick={stopPropagation}\n        >\n          {actions}\n        </Flexbox>\n        {body}\n      </div>\n    );\n  },\n);\n\nHtmlPreview.displayName = 'HtmlPreview';\n\nexport default HtmlPreview;\n"],"mappings":"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"}

package/es/HtmlPreview/Iframe.d.mts

@@ -0,0 +1,8 @@
+import { HtmlPreviewIframeProps } from "./type.mjs";
+import * as _$react from "react";
+
+//#region src/HtmlPreview/Iframe.d.ts
+declare const HtmlPreviewIframe: _$react.NamedExoticComponent<HtmlPreviewIframeProps>;
+//#endregion
+export { HtmlPreviewIframe };
+//# sourceMappingURL=Iframe.d.mts.map

package/es/HtmlPreview/Iframe.mjs

@@ -0,0 +1,159 @@
+"use client";
+import { DEFAULT_SANDBOX, SRCDOC_MAX_LENGTH } from "./const.mjs";
+import "./injectAutoHeightScript.mjs";
+import { SHELL_UPDATE_MESSAGE_TYPE, buildShellSrcDoc } from "./buildShellSrcDoc.mjs";
+import { buildStaticSrcDoc } from "./buildStaticSrcDoc.mjs";
+import { memo, useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+import { createStyles, cx } from "antd-style";
+//#region src/HtmlPreview/Iframe.tsx
+const useStyles = createStyles(({ css, cssVar }) => ({
+	fallback: css`
+    padding: 16px;
+    font-size: 13px;
+    color: ${cssVar.colorTextDescription};
+  `,
+	iframe: css`
+    display: block;
+    width: 100%;
+    border: none;
+    background: transparent;
+  `
+}));
+const headSealedPattern = /<\/head\s*>|<body[\s>]/i;
+const isHeadSealed = (raw) => headSealedPattern.test(raw);
+const parseContent = (() => {
+	let parser = null;
+	return (content) => {
+		if (typeof window === "undefined") return null;
+		if (!content) return {
+			bodyHtml: "",
+			headExtrasHtml: "",
+			styleContent: ""
+		};
+		if (!parser) parser = new DOMParser();
+		const doc = parser.parseFromString(content, "text/html");
+		const styleParts = [];
+		const headExtras = [];
+		if (doc.head) for (const child of Array.from(doc.head.children)) if (child.tagName === "STYLE") styleParts.push(child.textContent || "");
+		else headExtras.push(child.outerHTML);
+		return {
+			bodyHtml: doc.body ? doc.body.innerHTML : "",
+			headExtrasHtml: isHeadSealed(content) ? headExtras.join("") : "",
+			styleContent: styleParts.join("\n")
+		};
+	};
+})();
+const HtmlPreviewIframe = memo(({ animated, background, content, className, defaultHeight = 400, ref, sandbox = DEFAULT_SANDBOX, style, title = "HTML preview" }) => {
+	const { styles } = useStyles();
+	const innerRef = useRef(null);
+	const frameId = useId();
+	const [height, setHeight] = useState(defaultHeight);
+	const defaultHeightRef = useRef(defaultHeight);
+	useEffect(() => {
+		defaultHeightRef.current = defaultHeight;
+	}, [defaultHeight]);
+	const tooLarge = content.length > SRCDOC_MAX_LENGTH;
+	const staticSrcDoc = useMemo(() => {
+		if (animated || tooLarge) return null;
+		return buildStaticSrcDoc({
+			background,
+			content,
+			frameId
+		});
+	}, [
+		animated,
+		background,
+		content,
+		frameId,
+		tooLarge
+	]);
+	const shellSrcDoc = useMemo(() => {
+		if (!animated || tooLarge) return null;
+		return buildShellSrcDoc({
+			background,
+			frameId
+		});
+	}, [
+		animated,
+		background,
+		frameId,
+		tooLarge
+	]);
+	const [shellReady, setShellReady] = useState(false);
+	useEffect(() => {
+		setShellReady(false);
+	}, [shellSrcDoc]);
+	const payload = useMemo(() => {
+		if (!animated || tooLarge) return null;
+		return parseContent(content);
+	}, [
+		animated,
+		content,
+		tooLarge
+	]);
+	useEffect(() => {
+		if (!animated) return;
+		if (!shellReady || !payload) return;
+		const win = innerRef.current?.contentWindow;
+		if (!win) return;
+		win.postMessage({
+			frameId,
+			payload,
+			type: SHELL_UPDATE_MESSAGE_TYPE
+		}, "*");
+	}, [
+		animated,
+		payload,
+		shellReady,
+		frameId
+	]);
+	useEffect(() => {
+		const handler = (event) => {
+			const data = event.data;
+			if (!data || typeof data !== "object") return;
+			if (data.frameId !== frameId) return;
+			if (event.source !== innerRef.current?.contentWindow) return;
+			if (data.type === `lobe-html-shell-update:ready`) {
+				setShellReady(true);
+				return;
+			}
+			if (data.type === "lobe-html-resize") {
+				const next = Number(data.height);
+				if (!Number.isFinite(next) || next <= 0) return;
+				const floored = Math.max(next, defaultHeightRef.current);
+				setHeight((prev) => Math.abs(prev - floored) < 1 ? prev : floored);
+			}
+		};
+		window.addEventListener("message", handler);
+		return () => window.removeEventListener("message", handler);
+	}, [frameId]);
+	const setRef = useCallback((node) => {
+		innerRef.current = node;
+		if (typeof ref === "function") ref(node);
+		else if (ref) ref.current = node;
+	}, [ref]);
+	if (tooLarge) return /* @__PURE__ */ jsx("div", {
+		className: cx(styles.fallback, className),
+		style,
+		children: "Content too large to preview inline."
+	});
+	const srcDoc = staticSrcDoc ?? shellSrcDoc ?? "";
+	const iframeKey = animated ? "shell" : "static";
+	return /* @__PURE__ */ jsx("iframe", {
+		className: cx(styles.iframe, className),
+		ref: setRef,
+		sandbox,
+		srcDoc,
+		style: {
+			height,
+			...style
+		},
+		title
+	}, iframeKey);
+});
+HtmlPreviewIframe.displayName = "HtmlPreviewIframe";
+//#endregion
+export { HtmlPreviewIframe as default };
+
+//# sourceMappingURL=Iframe.mjs.map

package/es/HtmlPreview/Iframe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Iframe.mjs","names":[],"sources":["../../src/HtmlPreview/Iframe.tsx"],"sourcesContent":["'use client';\n\nimport { createStyles, cx } from 'antd-style';\nimport { memo, useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';\n\nimport { buildShellSrcDoc, SHELL_UPDATE_MESSAGE_TYPE } from './buildShellSrcDoc';\nimport { buildStaticSrcDoc } from './buildStaticSrcDoc';\nimport { DEFAULT_HEIGHT, DEFAULT_SANDBOX, SRCDOC_MAX_LENGTH } from './const';\nimport { AUTO_HEIGHT_MESSAGE_TYPE } from './injectAutoHeightScript';\nimport type { HtmlPreviewIframeProps } from './type';\n\nconst useStyles = createStyles(({ css, cssVar }) => ({\n  fallback: css`\n    padding: 16px;\n    font-size: 13px;\n    color: ${cssVar.colorTextDescription};\n  `,\n  iframe: css`\n    display: block;\n    width: 100%;\n    border: none;\n    background: transparent;\n  `,\n}));\n\ninterface Payload {\n  bodyHtml: string;\n  /**\n   * Non-inline-style children of `<head>` serialised in document order:\n   * `<script src=…>`, `<script>…</script>`, `<link>`, `<meta>`, `<base>`,\n   * `<title>` etc. The shell appends/dedupes these into its own head so\n   * head-loaded resources (Tailwind CDN, p5.js, fonts, …) work for full\n   * documents. Inline `<style>` is intentionally excluded — those flow\n   * through `styleContent` so streaming partial CSS grows in place rather\n   * than stacking duplicate `<style>` blocks.\n   *\n   * Empty until the user's `<head>` is *sealed* (a `</head>` close tag has\n   * arrived, or `<body>` has opened — browsers auto-close head at that\n   * point). Holding off prevents partial `src=\"https://cd\"` URLs from\n   * being mounted and 404-ing while the model is still streaming.\n   */\n  headExtrasHtml: string;\n  styleContent: string;\n}\n\n// Head is \"sealed\" as soon as we see a close tag or the body has begun;\n// after that point, additional chunks land in body and head extras won't\n// change.\nconst headSealedPattern = /<\\/head\\s*>|<body[\\s>]/i;\nconst isHeadSealed = (raw: string): boolean => headSealedPattern.test(raw);\n\nconst parseContent = (() => {\n  // Lazy-init: only need one parser instance, and only in the browser.\n  let parser: DOMParser | null = null;\n  return (content: string): Payload | null => {\n    if (typeof window === 'undefined') return null;\n    if (!content) return { bodyHtml: '', headExtrasHtml: '', styleContent: '' };\n    if (!parser) parser = new DOMParser();\n    const doc = parser.parseFromString(content, 'text/html');\n\n    const styleParts: string[] = [];\n    const headExtras: string[] = [];\n\n    if (doc.head) {\n      for (const child of Array.from(doc.head.children)) {\n        if (child.tagName === 'STYLE') {\n          styleParts.push(child.textContent || '');\n        } else {\n          headExtras.push(child.outerHTML);\n        }\n      }\n    }\n\n    return {\n      bodyHtml: doc.body ? doc.body.innerHTML : '',\n      headExtrasHtml: isHeadSealed(content) ? headExtras.join('') : '',\n      styleContent: styleParts.join('\\n'),\n    };\n  };\n})();\n\nexport const HtmlPreviewIframe = memo<HtmlPreviewIframeProps>(\n  ({\n    animated,\n    background,\n    content,\n    className,\n    defaultHeight = DEFAULT_HEIGHT,\n    ref,\n    sandbox = DEFAULT_SANDBOX,\n    style,\n    title = 'HTML preview',\n  }) => {\n    const { styles } = useStyles();\n    const innerRef = useRef<HTMLIFrameElement | null>(null);\n    const frameId = useId();\n    const [height, setHeight] = useState<number>(defaultHeight);\n    // Track caller-supplied `defaultHeight` in a ref so the (frameId-keyed)\n    // message handler can floor auto-height updates without re-subscribing\n    // every render.\n    const defaultHeightRef = useRef(defaultHeight);\n    useEffect(() => {\n      defaultHeightRef.current = defaultHeight;\n    }, [defaultHeight]);\n\n    const tooLarge = content.length > SRCDOC_MAX_LENGTH;\n\n    // ── Static mode ─────────────────────────────────────────────────────\n    // When the content isn't being streamed we can hand the iframe the\n    // user's HTML directly. The browser's normal HTML parser runs:\n    //   <script src=…> tags fetch and execute as if on a regular page,\n    //   inline <script> blocks run in DOM order, MutationObservers (like\n    //   Tailwind Play CDN's) get the document at its expected lifecycle\n    //   stage. Anything that a model can produce as a standalone web\n    //   page works without special handling on our side.\n    const staticSrcDoc = useMemo(() => {\n      if (animated || tooLarge) return null;\n      return buildStaticSrcDoc({ background, content, frameId });\n    }, [animated, background, content, frameId, tooLarge]);\n\n    // ── Shell mode ─────────────────────────────────────────────────────\n    // For streaming we keep one shell iframe loaded for the lifetime of\n    // the session and pump content updates through postMessage. The\n    // shell's morph script handles in-place DOM diffing + fade-in for\n    // new nodes (see buildShellSrcDoc.ts). Tradeoff: external <script\n    // src> tags appended this way don't always integrate cleanly with\n    // class-engine CDNs, so static content is preferred when possible.\n    const shellSrcDoc = useMemo(() => {\n      if (!animated || tooLarge) return null;\n      return buildShellSrcDoc({ background, frameId });\n    }, [animated, background, frameId, tooLarge]);\n\n    const [shellReady, setShellReady] = useState(false);\n    useEffect(() => {\n      // Each time we swap between shell and static modes (or rebuild the\n      // shell because the theme changed) we need to wait for a fresh\n      // ready ping before posting content.\n      setShellReady(false);\n    }, [shellSrcDoc]);\n\n    const payload = useMemo<Payload | null>(() => {\n      if (!animated || tooLarge) return null;\n      return parseContent(content);\n    }, [animated, content, tooLarge]);\n\n    // Push content into the shell iframe whenever it changes — but only\n    // after the shell has signalled ready, so its listener exists.\n    useEffect(() => {\n      if (!animated) return;\n      if (!shellReady || !payload) return;\n      const win = innerRef.current?.contentWindow;\n      if (!win) return;\n      win.postMessage(\n        {\n          frameId,\n          payload,\n          type: SHELL_UPDATE_MESSAGE_TYPE,\n        },\n        '*',\n      );\n    }, [animated, payload, shellReady, frameId]);\n\n    useEffect(() => {\n      const handler = (event: MessageEvent) => {\n        const data = event.data;\n        if (!data || typeof data !== 'object') return;\n        if (data.frameId !== frameId) return;\n        if (event.source !== innerRef.current?.contentWindow) return;\n\n        if (data.type === `${SHELL_UPDATE_MESSAGE_TYPE}:ready`) {\n          setShellReady(true);\n          return;\n        }\n\n        if (data.type === AUTO_HEIGHT_MESSAGE_TYPE) {\n          const next = Number(data.height);\n          if (!Number.isFinite(next) || next <= 0) return;\n          // Floor at `defaultHeight`. During streaming the shell body\n          // briefly reports a small height between morph commits (empty\n          // body just after head closes, then partial body, etc.) and on\n          // every iframe remount the auto-height starts at body padding\n          // before climbing back to content height. Letting the iframe\n          // shrink to that interim height causes a visible up/down jitter\n          // that reads as flicker — especially under a Markdown wrapper\n          // that re-renders every chunk. Anchoring to the caller's stated\n          // minimum height eliminates that without affecting the final\n          // size: real content taller than `defaultHeight` grows the\n          // iframe; content shorter than it stays at the floor.\n          const floored = Math.max(next, defaultHeightRef.current);\n          setHeight((prev) => (Math.abs(prev - floored) < 1 ? prev : floored));\n        }\n      };\n\n      window.addEventListener('message', handler);\n      return () => window.removeEventListener('message', handler);\n    }, [frameId]);\n\n    const setRef = useCallback(\n      (node: HTMLIFrameElement | null) => {\n        innerRef.current = node;\n        if (typeof ref === 'function') ref(node);\n        else if (ref) (ref as { current: HTMLIFrameElement | null }).current = node;\n      },\n      [ref],\n    );\n\n    if (tooLarge) {\n      return (\n        <div className={cx(styles.fallback, className)} style={style}>\n          Content too large to preview inline.\n        </div>\n      );\n    }\n\n    const srcDoc = staticSrcDoc ?? shellSrcDoc ?? '';\n\n    // Key the iframe by mode so React fully unmounts the previous DOM\n    // element when we switch from shell (streaming) to static (finalised).\n    // Setting iframe.srcdoc on an already-loaded element doesn't reliably\n    // re-navigate in Chromium when the previous document was also srcdoc-\n    // based — the new srcdoc attribute lands, but the document doesn't\n    // reload, so the user sees stale (often empty) shell content. A fresh\n    // element forces the browser to parse and load the new srcdoc.\n    const iframeKey = animated ? 'shell' : 'static';\n\n    return (\n      <iframe\n        className={cx(styles.iframe, className)}\n        key={iframeKey}\n        ref={setRef}\n        sandbox={sandbox}\n        srcDoc={srcDoc}\n        style={{ height, ...style }}\n        title={title}\n      />\n    );\n  },\n);\n\nHtmlPreviewIframe.displayName = 'HtmlPreviewIframe';\n\nexport default HtmlPreviewIframe;\n"],"mappings":"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"}