@superlc/md-react 0.1.0

package/dist/Markdown.d.ts

@@ -0,0 +1,30 @@
+import { FC } from 'react';
+import { MarkdownProps } from './types';
+
+/**
+ * React Markdown 渲染组件
+ *
+ * @example
+ * ```tsx
+ * <Markdown className="prose">
+ *   # Hello World
+ *
+ *   This is **bold** and *italic* text.
+ * </Markdown>
+ * ```
+ *
+ * @example 自定义组件
+ * ```tsx
+ * <Markdown
+ *   components={{
+ *     h1: ({ children }) => <h1 className="text-3xl font-bold">{children}</h1>,
+ *     a: ({ href, children }) => <a href={href} target="_blank">{children}</a>
+ *   }}
+ * >
+ *   # Custom Heading
+ *   [Link](https://example.com)
+ * </Markdown>
+ * ```
+ */
+export declare const Markdown: FC<MarkdownProps>;
+//# sourceMappingURL=Markdown.d.ts.map

package/dist/Markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../src/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAStC,CAAC"}

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var Y=Object.create;var H=Object.defineProperty;var Z=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var Q=Object.getPrototypeOf,ee=Object.prototype.hasOwnProperty;var te=(e,t,c,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of G(t))!ee.call(e,n)&&n!==c&&H(e,n,{get:()=>t[n],enumerable:!(i=Z(t,n))||i.enumerable});return e};var re=(e,t,c)=>(c=e!=null?Y(Q(e)):{},te(t||!e||!e.__esModule?H(c,"default",{value:e,enumerable:!0}):c,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),r=require("react"),M=require("@superlc/md-core"),U=require("hast-util-to-jsx-runtime");function $(e,t={}){const{components:c={},...i}=t;return r.useMemo(()=>{if(!e)return null;const n=M.parseToHast(e,i);return U.toJsxRuntime(n,{Fragment:a.Fragment,jsx:a.jsx,jsxs:a.jsxs,components:c})},[e,c,i])}const J=({children:e,components:t,className:c,...i})=>{const n=$(e,{components:t,...i});return a.jsx("div",{className:c,children:n})};J.displayName="Markdown";const K=r.memo(({block:e,components:t})=>{if(!e.hast)return null;try{return U.toJsxRuntime(e.hast,{jsx:a.jsx,jsxs:a.jsxs,Fragment:a.Fragment,components:t})}catch{return null}},(e,t)=>e.block.key===t.block.key&&e.block.stable&&t.block.stable);K.displayName="StableBlock";function ne(e={}){const{components:t,minUpdateInterval:c=16,immediate:i=!1,outputRate:n="medium",...k}=e,u=r.useRef(M.createStreamingParser(k)),s=r.useRef(new M.OutputRateController(n)),[y,p]=r.useState(0),[w,h]=r.useState(!1),[l,f]=r.useState(0),[S,R]=r.useState("idle"),v=r.useRef(0),m=r.useRef(null),j=r.useCallback(()=>{const g=performance.now(),A=g-v.current;i||A>=c?(v.current=g,p(B=>B+1)):m.current===null&&(m.current=window.requestAnimationFrame(()=>{m.current=null,v.current=performance.now(),p(B=>B+1)}))},[c,i]),b=r.useCallback(g=>{u.current.append(g),j()},[j]),E=r.useCallback(g=>{u.current.reset(),h(!1),f(0),R("running"),s.current.start(g,A=>{A&&u.current.append(A),f(s.current.progress),j()},()=>{u.current.finish(),h(!0),f(1),R("complete"),j()})},[j]),C=r.useCallback(()=>{s.current.pause(),R(s.current.status)},[]),T=r.useCallback(()=>{s.current.resume(),R(s.current.status)},[]),O=r.useCallback(()=>{s.current.skipToEnd(),R(s.current.status),f(1)},[]),o=r.useCallback(()=>{s.current.stop(),u.current.finish(),h(!0),R("complete"),m.current!==null&&(cancelAnimationFrame(m.current),m.current=null),p(g=>g+1)},[]),d=r.useCallback(()=>{s.current.stop(),u.current.reset(),h(!1),f(0),R("idle"),m.current!==null&&(cancelAnimationFrame(m.current),m.current=null),p(g=>g+1)},[]);r.useEffect(()=>{s.current.setRate(n)},[n]),r.useEffect(()=>()=>{s.current.stop(),m.current!==null&&cancelAnimationFrame(m.current)},[]);const x=u.current.getState(),P=u.current.getStats(),N=u.current.getContent(),z=r.useMemo(()=>x.blocks.map(g=>a.jsx(K,{block:g,components:t},g.key)),[x.blocks,t,y]);return{element:r.useMemo(()=>x.blocks.length===0?null:a.jsx(a.Fragment,{children:z}),[z,x.blocks.length]),append:b,start:E,pause:C,resume:T,skipToEnd:O,reset:d,finish:o,blocks:x.blocks,stats:P,isComplete:w,content:N,progress:l,outputStatus:S}}const se=16,ae="data:image/svg+xml,",ce=()=>a.jsxs("svg",{width:"48",height:"36",viewBox:"0 0 48 36",fill:"none",xmlns:"http://www.w3.org/2000/svg",children:[a.jsx("rect",{x:"0",y:"0",width:"48",height:"36",rx:"3",className:"md-image-skeleton-icon"}),a.jsx("circle",{cx:"12",cy:"10",r:"5",className:"md-image-skeleton-icon-detail"}),a.jsx("path",{d:"M0 36 L0 24 L16 16 L28 26 L48 12 L48 36 Z",className:"md-image-skeleton-icon-detail"})]}),q=r.memo(({src:e,alt:t,className:c,"data-width":i,"data-height":n,...k})=>{const s=(e==null?void 0:e.startsWith(ae))?void 0:e,y=i?Number(i):200,p=n?Number(n):120,[w,h]=r.useState(!0),l=r.useRef(null),f=r.useRef(null);r.useLayoutEffect(()=>{l.current&&s&&l.current.complete&&l.current.naturalWidth>0&&h(!1)},[s]);const S=r.useCallback(()=>{f.current&&clearTimeout(f.current),f.current=setTimeout(()=>{h(!1)},se)},[]);return a.jsxs("span",{className:`md-image-container ${c||""}`,style:{width:y,height:p},children:[s&&a.jsx("img",{ref:l,src:s,alt:t,onLoad:S,className:"md-image",...k}),w&&a.jsx("span",{className:"md-image-skeleton",children:a.jsx(ce,{})})]})});q.displayName="StreamingImage";let I=!1,F=null;async function W(){if(!I)return F||(F=(async()=>{await import("katex/dist/katex.min.css"),I=!0})(),F)}const ue=r.memo(({children:e})=>(r.useEffect(()=>{I||W()},[]),a.jsx(a.Fragment,{children:e})));ue.displayName="MathProvider";function ie(){return W()}const _=r.memo(({block:e,components:t})=>{if(!e.hast)return null;try{return U.toJsxRuntime(e.hast,{jsx:a.jsx,jsxs:a.jsxs,Fragment:a.Fragment,components:t})}catch{return a.jsx("div",{className:"parse-error",children:e.source})}},(e,t)=>e.block.key===t.block.key&&e.block.stable&&t.block.stable);_.displayName="StableBlock";const V=({content:e,source:t,outputRate:c="medium",isComplete:i=!1,onComplete:n,onBlockStable:k,onProgress:u,components:s,className:y,minUpdateInterval:p=16,autoStart:w=!0,...h})=>{r.useEffect(()=>{h.math&&ie()},[h.math]);const l=r.useRef(M.createStreamingParser(h)),f=r.useRef(new M.OutputRateController(c)),S=r.useRef(""),R=r.useRef(void 0),v=r.useRef([]),[,m]=r.useReducer(o=>o+1,0),j=r.useRef(0),b=r.useRef(null),E=()=>{const o=performance.now();o-j.current>=p?(j.current=o,m()):b.current===null&&(b.current=window.requestAnimationFrame(()=>{b.current=null,j.current=performance.now(),m()}))};r.useEffect(()=>{t!==void 0&&t!==R.current&&(R.current=t,w&&t&&(l.current.reset(),S.current="",f.current.start(t,o=>{o&&(l.current.append(o),S.current+=o),u==null||u(f.current.progress),E()},()=>{l.current.finish(),n==null||n(),E()})))},[t,w,n,u]),r.useEffect(()=>{if(t!==void 0)return;const o=S.current,d=e||"";if(d!==o){if(d.startsWith(o)){const x=d.slice(o.length);x&&l.current.append(x)}else l.current.reset(),d&&l.current.append(d);S.current=d,E()}},[e,t]),r.useEffect(()=>{t===void 0&&i&&(l.current.finish(),b.current!==null&&(cancelAnimationFrame(b.current),b.current=null),m(),n==null||n())},[i,n,t]),r.useEffect(()=>{f.current.setRate(c)},[c]),r.useEffect(()=>{if(k){const o=l.current.getState().blocks,d=v.current;o.forEach((x,P)=>{const N=d[P];x.stable&&(!N||!N.stable)&&k(x)}),v.current=o}}),r.useEffect(()=>()=>{f.current.stop(),b.current!==null&&cancelAnimationFrame(b.current)},[]);const C=l.current.getState(),T=t!==void 0?f.current.status==="complete":i,O=r.useMemo(()=>{const o={img:q,...s};return C.blocks.map(d=>a.jsx(_,{block:d,components:o},d.key))},[C.blocks,s]);return a.jsx("div",{className:y,"data-streaming":!T,children:O})};V.displayName="StreamingMarkdown";const X=r.memo(e=>{const{text:t,animationConfig:c}=e,{fadeDuration:i=200,easing:n="ease-in-out"}=c||{},[k,u]=r.useState([]),s=r.useRef("");r.useEffect(()=>{if(t===s.current)return;if(!(s.current&&t.indexOf(s.current)===0)){u([t]),s.current=t;return}const p=t.slice(s.current.length);p&&(u(w=>[...w,p]),s.current=t)},[t]);const y=`md-fade-in ${i}ms ${n} forwards`;return a.jsx(a.Fragment,{children:k.map((p,w)=>a.jsx("span",{className:"md-animation-text",style:{animation:y},children:p},`animation-text-${w}`))})});X.displayName="AnimationText";let L=null;try{L=require("dompurify")}catch{}function oe(){return L!==null}function le(e,t){if(!L)return e;const c={ADD_ATTR:["target","rel","data-block-key","data-pending","data-predicted"],...t};return L.default.sanitize(e,c)}function D(e){if(e.type==="root")return{...e,children:e.children.map(n=>n.type==="element"?D(n):n)};const t=["onclick","onerror","onload","onmouseover","onfocus","onblur"],c=["javascript:","vbscript:","data:text/html"],i={};if(e.properties)for(const[n,k]of Object.entries(e.properties)){const u=n.toLowerCase();if(!(t.includes(u)||u.startsWith("on"))){if((u==="href"||u==="src")&&typeof k=="string"){const s=k.toLowerCase().trim();if(c.some(y=>s.startsWith(y)))continue}i[n]=k}}return{...e,properties:i,children:e.children.map(n=>n.type==="element"?D(n):n)}}exports.AnimationText=X;exports.Markdown=J;exports.StreamingImage=q;exports.StreamingMarkdown=V;exports.isDOMPurifyAvailable=oe;exports.sanitizeHast=D;exports.sanitizeHtml=le;exports.useMarkdown=$;exports.useStreamingMarkdown=ne;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @superlc/md-react
+ * 基于 @superlc/md-core 的 React Markdown 渲染组件
+ */
+export { Markdown } from './Markdown';
+export { useMarkdown } from './useMarkdown';
+export type { MarkdownProps, MarkdownComponents, UseMarkdownOptions } from './types';
+export { useStreamingMarkdown, StreamingMarkdown, StreamingImage, AnimationText, } from './streaming';
+export type { UseStreamingMarkdownOptions, UseStreamingMarkdownResult, StreamingMarkdownProps, AnimationConfig, StreamingConfig, } from './streaming';
+export { sanitizeHast, sanitizeHtml, isDOMPurifyAvailable } from './utils';
+export type { SanitizeConfig } from './utils';
+export type { ProcessorOptions, PluginConfig, BlockInfo, ParserStats, OutputRate, OutputRatePreset, OutputRateCustom, OutputRateStatus, InlineType, InlinePredictionOptions, } from '@superlc/md-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGrF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,347 @@
+import { jsxs as B, jsx as o, Fragment as E } from "react/jsx-runtime";
+import Q, { useMemo as P, memo as F, useRef as d, useState as T, useCallback as N, useEffect as y, useLayoutEffect as ee } from "react";
+import { parseToHast as te, createStreamingParser as V, OutputRateController as J } from "@superlc/md-core";
+import { toJsxRuntime as W } from "hast-util-to-jsx-runtime";
+function re(e, t = {}) {
+  const { components: c = {}, ...a } = t;
+  return P(() => {
+    if (!e) return null;
+    const r = te(e, a);
+    return W(r, {
+      Fragment: E,
+      jsx: o,
+      jsxs: B,
+      components: c
+    });
+  }, [e, c, a]);
+}
+const ne = ({
+  children: e,
+  components: t,
+  className: c,
+  ...a
+}) => {
+  const r = re(e, { components: t, ...a });
+  return /* @__PURE__ */ o("div", { className: c, children: r });
+};
+ne.displayName = "Markdown";
+const X = F(
+  ({ block: e, components: t }) => {
+    if (!e.hast) return null;
+    try {
+      return W(e.hast, {
+        jsx: o,
+        jsxs: B,
+        Fragment: E,
+        components: t
+      });
+    } catch {
+      return null;
+    }
+  },
+  (e, t) => e.block.key === t.block.key && e.block.stable && t.block.stable
+);
+X.displayName = "StableBlock";
+function ge(e = {}) {
+  const {
+    components: t,
+    minUpdateInterval: c = 16,
+    immediate: a = !1,
+    outputRate: r = "medium",
+    ...g
+  } = e, s = d(V(g)), n = d(new J(r)), [x, p] = T(0), [b, k] = T(!1), [u, l] = T(0), [L, v] = T("idle"), A = d(0), m = d(null), S = N(() => {
+    const h = performance.now(), D = h - A.current;
+    a || D >= c ? (A.current = h, p((H) => H + 1)) : m.current === null && (m.current = window.requestAnimationFrame(() => {
+      m.current = null, A.current = performance.now(), p((H) => H + 1);
+    }));
+  }, [c, a]), R = N(
+    (h) => {
+      s.current.append(h), S();
+    },
+    [S]
+  ), M = N(
+    (h) => {
+      s.current.reset(), k(!1), l(0), v("running"), n.current.start(
+        h,
+        (D) => {
+          D && s.current.append(D), l(n.current.progress), S();
+        },
+        () => {
+          s.current.finish(), k(!0), l(1), v("complete"), S();
+        }
+      );
+    },
+    [S]
+  ), I = N(() => {
+    n.current.pause(), v(n.current.status);
+  }, []), j = N(() => {
+    n.current.resume(), v(n.current.status);
+  }, []), $ = N(() => {
+    n.current.skipToEnd(), v(n.current.status), l(1);
+  }, []), i = N(() => {
+    n.current.stop(), s.current.finish(), k(!0), v("complete"), m.current !== null && (cancelAnimationFrame(m.current), m.current = null), p((h) => h + 1);
+  }, []), f = N(() => {
+    n.current.stop(), s.current.reset(), k(!1), l(0), v("idle"), m.current !== null && (cancelAnimationFrame(m.current), m.current = null), p((h) => h + 1);
+  }, []);
+  y(() => {
+    n.current.setRate(r);
+  }, [r]), y(() => () => {
+    n.current.stop(), m.current !== null && cancelAnimationFrame(m.current);
+  }, []);
+  const w = s.current.getState(), z = s.current.getStats(), C = s.current.getContent(), _ = P(() => w.blocks.map(
+    (h) => o(
+      X,
+      {
+        block: h,
+        components: t
+      },
+      h.key
+    )
+  ), [w.blocks, t, x]);
+  return {
+    element: P(() => w.blocks.length === 0 ? null : o(E, { children: _ }), [_, w.blocks.length]),
+    append: R,
+    start: M,
+    pause: I,
+    resume: j,
+    skipToEnd: $,
+    reset: f,
+    finish: i,
+    blocks: w.blocks,
+    stats: z,
+    isComplete: b,
+    content: C,
+    progress: u,
+    outputStatus: L
+  };
+}
+const se = 16, ce = "data:image/svg+xml,", ae = () => /* @__PURE__ */ B("svg", { width: "48", height: "36", viewBox: "0 0 48 36", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [
+  /* @__PURE__ */ o("rect", { x: "0", y: "0", width: "48", height: "36", rx: "3", className: "md-image-skeleton-icon" }),
+  /* @__PURE__ */ o("circle", { cx: "12", cy: "10", r: "5", className: "md-image-skeleton-icon-detail" }),
+  /* @__PURE__ */ o("path", { d: "M0 36 L0 24 L16 16 L28 26 L48 12 L48 36 Z", className: "md-image-skeleton-icon-detail" })
+] }), Y = F(({
+  src: e,
+  alt: t,
+  className: c,
+  "data-width": a,
+  "data-height": r,
+  ...g
+}) => {
+  const n = (e == null ? void 0 : e.startsWith(ce)) ? void 0 : e, x = a ? Number(a) : 200, p = r ? Number(r) : 120, [b, k] = T(!0), u = d(null), l = d(null);
+  ee(() => {
+    u.current && n && u.current.complete && u.current.naturalWidth > 0 && k(!1);
+  }, [n]);
+  const L = N(() => {
+    l.current && clearTimeout(l.current), l.current = setTimeout(() => {
+      k(!1);
+    }, se);
+  }, []);
+  return /* @__PURE__ */ B(
+    "span",
+    {
+      className: `md-image-container ${c || ""}`,
+      style: { width: x, height: p },
+      children: [
+        n && /* @__PURE__ */ o(
+          "img",
+          {
+            ref: u,
+            src: n,
+            alt: t,
+            onLoad: L,
+            className: "md-image",
+            ...g
+          }
+        ),
+        b && /* @__PURE__ */ o("span", { className: "md-image-skeleton", children: /* @__PURE__ */ o(ae, {}) })
+      ]
+    }
+  );
+});
+Y.displayName = "StreamingImage";
+let K = !1, O = null;
+async function Z() {
+  if (!K)
+    return O || (O = (async () => {
+      await import("katex/dist/katex.min.css"), K = !0;
+    })(), O);
+}
+const ie = F(({ children: e }) => (y(() => {
+  K || Z();
+}, []), /* @__PURE__ */ o(E, { children: e })));
+ie.displayName = "MathProvider";
+function oe() {
+  return Z();
+}
+const G = F(
+  ({ block: e, components: t }) => {
+    if (!e.hast) return null;
+    try {
+      return W(e.hast, {
+        jsx: o,
+        jsxs: B,
+        Fragment: E,
+        components: t
+      });
+    } catch {
+      return /* @__PURE__ */ o("div", { className: "parse-error", children: e.source });
+    }
+  },
+  (e, t) => e.block.key === t.block.key && e.block.stable && t.block.stable
+);
+G.displayName = "StableBlock";
+const ue = ({
+  content: e,
+  source: t,
+  outputRate: c = "medium",
+  isComplete: a = !1,
+  onComplete: r,
+  onBlockStable: g,
+  onProgress: s,
+  components: n,
+  className: x,
+  minUpdateInterval: p = 16,
+  autoStart: b = !0,
+  ...k
+}) => {
+  y(() => {
+    k.math && oe();
+  }, [k.math]);
+  const u = d(V(k)), l = d(new J(c)), L = d(""), v = d(void 0), A = d([]), [, m] = Q.useReducer((i) => i + 1, 0), S = d(0), R = d(null), M = () => {
+    const i = performance.now();
+    i - S.current >= p ? (S.current = i, m()) : R.current === null && (R.current = window.requestAnimationFrame(() => {
+      R.current = null, S.current = performance.now(), m();
+    }));
+  };
+  y(() => {
+    t !== void 0 && t !== v.current && (v.current = t, b && t && (u.current.reset(), L.current = "", l.current.start(
+      t,
+      (i) => {
+        i && (u.current.append(i), L.current += i), s == null || s(l.current.progress), M();
+      },
+      () => {
+        u.current.finish(), r == null || r(), M();
+      }
+    )));
+  }, [t, b, r, s]), y(() => {
+    if (t !== void 0)
+      return;
+    const i = L.current, f = e || "";
+    if (f !== i) {
+      if (f.startsWith(i)) {
+        const w = f.slice(i.length);
+        w && u.current.append(w);
+      } else
+        u.current.reset(), f && u.current.append(f);
+      L.current = f, M();
+    }
+  }, [e, t]), y(() => {
+    t === void 0 && a && (u.current.finish(), R.current !== null && (cancelAnimationFrame(R.current), R.current = null), m(), r == null || r());
+  }, [a, r, t]), y(() => {
+    l.current.setRate(c);
+  }, [c]), y(() => {
+    if (g) {
+      const i = u.current.getState().blocks, f = A.current;
+      i.forEach((w, z) => {
+        const C = f[z];
+        w.stable && (!C || !C.stable) && g(w);
+      }), A.current = i;
+    }
+  }), y(() => () => {
+    l.current.stop(), R.current !== null && cancelAnimationFrame(R.current);
+  }, []);
+  const I = u.current.getState(), j = t !== void 0 ? l.current.status === "complete" : a, $ = P(() => {
+    const i = {
+      img: Y,
+      ...n
+    };
+    return I.blocks.map((f) => /* @__PURE__ */ o(
+      G,
+      {
+        block: f,
+        components: i
+      },
+      f.key
+    ));
+  }, [I.blocks, n]);
+  return /* @__PURE__ */ o("div", { className: x, "data-streaming": !j, children: $ });
+};
+ue.displayName = "StreamingMarkdown";
+const le = F((e) => {
+  const { text: t, animationConfig: c } = e, { fadeDuration: a = 200, easing: r = "ease-in-out" } = c || {}, [g, s] = T([]), n = d("");
+  y(() => {
+    if (t === n.current) return;
+    if (!(n.current && t.indexOf(n.current) === 0)) {
+      s([t]), n.current = t;
+      return;
+    }
+    const p = t.slice(n.current.length);
+    p && (s((b) => [...b, p]), n.current = t);
+  }, [t]);
+  const x = `md-fade-in ${a}ms ${r} forwards`;
+  return /* @__PURE__ */ o(E, { children: g.map((p, b) => /* @__PURE__ */ o(
+    "span",
+    {
+      className: "md-animation-text",
+      style: { animation: x },
+      children: p
+    },
+    `animation-text-${b}`
+  )) });
+});
+le.displayName = "AnimationText";
+let U = null;
+try {
+  U = require("dompurify");
+} catch {
+}
+function ke() {
+  return U !== null;
+}
+function we(e, t) {
+  if (!U)
+    return e;
+  const c = {
+    ADD_ATTR: ["target", "rel", "data-block-key", "data-pending", "data-predicted"],
+    ...t
+  };
+  return U.default.sanitize(e, c);
+}
+function q(e) {
+  if (e.type === "root")
+    return {
+      ...e,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      children: e.children.map((r) => r.type === "element" ? q(r) : r)
+    };
+  const t = ["onclick", "onerror", "onload", "onmouseover", "onfocus", "onblur"], c = ["javascript:", "vbscript:", "data:text/html"], a = {};
+  if (e.properties)
+    for (const [r, g] of Object.entries(e.properties)) {
+      const s = r.toLowerCase();
+      if (!(t.includes(s) || s.startsWith("on"))) {
+        if ((s === "href" || s === "src") && typeof g == "string") {
+          const n = g.toLowerCase().trim();
+          if (c.some((x) => n.startsWith(x)))
+            continue;
+        }
+        a[r] = g;
+      }
+    }
+  return {
+    ...e,
+    properties: a,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    children: e.children.map((r) => r.type === "element" ? q(r) : r)
+  };
+}
+export {
+  le as AnimationText,
+  ne as Markdown,
+  Y as StreamingImage,
+  ue as StreamingMarkdown,
+  ke as isDOMPurifyAvailable,
+  q as sanitizeHast,
+  we as sanitizeHtml,
+  re as useMarkdown,
+  ge as useStreamingMarkdown
+};

package/dist/streaming/AnimationText.d.ts

@@ -0,0 +1,23 @@
+export interface AnimationConfig {
+    /**
+     * 淡入动画持续时间（毫秒）
+     * @default 200
+     */
+    fadeDuration?: number;
+    /**
+     * 动画缓动函数
+     * @default 'ease-in-out'
+     */
+    easing?: string;
+}
+export interface AnimationTextProps {
+    text: string;
+    animationConfig?: AnimationConfig;
+}
+/**
+ * 带淡入动画的文本组件
+ * 追踪文本变化，为新增部分添加淡入效果
+ */
+declare const AnimationText: import('react').NamedExoticComponent<AnimationTextProps>;
+export default AnimationText;
+//# sourceMappingURL=AnimationText.d.ts.map

package/dist/streaming/AnimationText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationText.d.ts","sourceRoot":"","sources":["../../src/streaming/AnimationText.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;GAGG;AACH,QAAA,MAAM,aAAa,0DAwCjB,CAAC;AAIH,eAAe,aAAa,CAAC"}

package/dist/streaming/MathProvider.d.ts

@@ -0,0 +1,21 @@
+import { FC, ReactNode } from 'react';
+
+interface MathProviderProps {
+    /** 子元素 */
+    children: ReactNode;
+}
+/**
+ * 数学公式样式提供组件
+ * 用于懒加载 KaTeX CSS，仅在使用时加载
+ */
+export declare const MathProvider: FC<MathProviderProps>;
+/**
+ * 检查 KaTeX CSS 是否已加载
+ */
+export declare function isKatexCssLoaded(): boolean;
+/**
+ * 预加载 KaTeX CSS
+ */
+export declare function preloadKatexCss(): Promise<void>;
+export {};
+//# sourceMappingURL=MathProvider.d.ts.map

package/dist/streaming/MathProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MathProvider.d.ts","sourceRoot":"","sources":["../../src/streaming/MathProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AA8B3C,UAAU,iBAAiB;IACzB,UAAU;IACV,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAU7C,CAAC;AAIH;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/streaming/StreamingImage.d.ts

@@ -0,0 +1,18 @@
+import { FC, ImgHTMLAttributes } from 'react';
+
+interface StreamingImageProps extends ImgHTMLAttributes<HTMLImageElement> {
+    'data-width'?: number | string;
+    'data-height'?: number | string;
+}
+/**
+ * 流式图片组件
+ * 占位容器覆盖在图片上方，图片加载完成后直接移除
+ *
+ * 关键设计：
+ * 1. 使用 img.complete 同步检测浏览器缓存中的图片
+ * 2. 使用 useLayoutEffect 在绘制前同步检查图片状态
+ * 3. 始终初始显示 skeleton，避免组件重建时闪烁
+ */
+export declare const StreamingImage: FC<StreamingImageProps>;
+export {};
+//# sourceMappingURL=StreamingImage.d.ts.map

package/dist/streaming/StreamingImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingImage.d.ts","sourceRoot":"","sources":["../../src/streaming/StreamingImage.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAuBnD,UAAU,mBAAoB,SAAQ,iBAAiB,CAAC,gBAAgB,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CA2EjD,CAAC"}

package/dist/streaming/StreamingMarkdown.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { StreamingMarkdownProps } from './types';
+
+/**
+ * 流式 Markdown 渲染组件
+ * 声明式 API，支持受控模式和内置速率控制模式
+ */
+export declare const StreamingMarkdown: FC<StreamingMarkdownProps>;
+//# sourceMappingURL=StreamingMarkdown.d.ts.map

package/dist/streaming/StreamingMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingMarkdown.d.ts","sourceRoot":"","sources":["../../src/streaming/StreamingMarkdown.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAgB,MAAM,OAAO,CAAC;AAQ9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAkCtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAkMxD,CAAC"}

package/dist/streaming/hastToJsxWithAnimation.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { Element } from '@superlc/md-core';
+import { Components } from 'hast-util-to-jsx-runtime';
+import { AnimationConfig } from './types';
+import { SanitizeConfig } from '../utils/sanitize';
+
+/**
+ * 将 HAST 转换为带动画的 JSX
+ */
+export declare function hastToJsxWithAnimation(hast: Element, options: {
+    components?: Components;
+    enableAnimation?: boolean;
+    animationConfig?: AnimationConfig;
+    enableSanitize?: boolean;
+    sanitizeConfig?: SanitizeConfig;
+}): React.ReactElement | null;
+//# sourceMappingURL=hastToJsxWithAnimation.d.ts.map

package/dist/streaming/hastToJsxWithAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hastToJsxWithAnimation.d.ts","sourceRoot":"","sources":["../../src/streaming/hastToJsxWithAnimation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAsDtE;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE;IACP,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GACA,KAAK,CAAC,YAAY,GAAG,IAAI,CA4C3B"}

package/dist/streaming/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 流式渲染模块
+ */
+export { useStreamingMarkdown } from './useStreamingMarkdown';
+export { StreamingMarkdown } from './StreamingMarkdown';
+export { StreamingImage } from './StreamingImage';
+export { MathProvider, preloadKatexCss, isKatexCssLoaded } from './MathProvider';
+export { default as AnimationText } from './AnimationText';
+export type { AnimationConfig as AnimationTextConfig } from './AnimationText';
+export type { UseStreamingMarkdownOptions, UseStreamingMarkdownResult, StreamingMarkdownProps, AnimationConfig, StreamingConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/streaming/types.d.ts

@@ -0,0 +1,121 @@
+import { ReactElement } from 'react';
+import { StreamingParserOptions, ParserStats, BlockInfo, OutputRate, OutputRateStatus } from '@superlc/md-core';
+import { MarkdownComponents } from '../types';
+import { SanitizeConfig } from '../utils/sanitize';
+
+/**
+ * 文字动画配置
+ */
+export interface AnimationConfig {
+    /**
+     * 淡入动画持续时间（毫秒）
+     * @default 200
+     */
+    fadeDuration?: number;
+    /**
+     * 动画缓动函数
+     * @default 'ease-in-out'
+     */
+    easing?: string;
+}
+/**
+ * 流式渲染配置
+ */
+export interface StreamingConfig {
+    /**
+     * 是否启用文字淡入动画
+     * @default false
+     */
+    enableAnimation?: boolean;
+    /**
+     * 动画配置
+     */
+    animationConfig?: AnimationConfig;
+    /**
+     * 是否启用 HTML 安全净化
+     * @default false
+     */
+    enableSanitize?: boolean;
+    /**
+     * DOMPurify 配置（仅当 enableSanitize 为 true 时生效）
+     */
+    sanitizeConfig?: SanitizeConfig;
+}
+/**
+ * useStreamingMarkdown Hook 配置
+ */
+export interface UseStreamingMarkdownOptions extends StreamingParserOptions {
+    /** 自定义组件映射 */
+    components?: MarkdownComponents;
+    /** 最小更新间隔 (ms)，默认 16 (约 60fps) */
+    minUpdateInterval?: number;
+    /** 是否禁用批处理，每次 append 立即更新 */
+    immediate?: boolean;
+    /** 输出速率配置 */
+    outputRate?: OutputRate;
+    /** 流式渲染配置（动画等） */
+    streaming?: StreamingConfig;
+}
+/**
+ * useStreamingMarkdown Hook 返回值
+ */
+export interface UseStreamingMarkdownResult {
+    /** 渲染后的 React 元素 */
+    element: ReactElement | null;
+    /** 追加内容（手动模式） */
+    append: (chunk: string) => void;
+    /** 开始按速率输出（速率控制模式） */
+    start: (source: string) => void;
+    /** 暂停输出 */
+    pause: () => void;
+    /** 恢复输出 */
+    resume: () => void;
+    /** 跳过到结束 */
+    skipToEnd: () => void;
+    /** 重置解析器 */
+    reset: () => void;
+    /** 标记完成 */
+    finish: () => void;
+    /** 当前块信息 */
+    blocks: BlockInfo[];
+    /** 性能统计 */
+    stats: ParserStats;
+    /** 是否已完成 */
+    isComplete: boolean;
+    /** 累积的内容 */
+    content: string;
+    /** 输出进度 (0-1) */
+    progress: number;
+    /** 输出状态 */
+    outputStatus: OutputRateStatus;
+}
+/**
+ * StreamingMarkdown 组件 Props
+ */
+export interface StreamingMarkdownProps extends StreamingParserOptions {
+    /** 当前累积的 Markdown 内容（外部控制模式） */
+    content?: string;
+    /** 完整的 Markdown 源内容（内置速率控制模式） */
+    source?: string;
+    /** 输出速率配置，默认 'medium' */
+    outputRate?: OutputRate;
+    /** 是否已完成流式输入 */
+    isComplete?: boolean;
+    /** 完成时的回调 */
+    onComplete?: () => void;
+    /** 块稳定时的回调 */
+    onBlockStable?: (block: BlockInfo) => void;
+    /** 进度变化回调 */
+    onProgress?: (progress: number) => void;
+    /** 自定义组件映射 */
+    components?: MarkdownComponents;
+    /** 容器 className */
+    className?: string;
+    /** 最小更新间隔 (ms) */
+    minUpdateInterval?: number;
+    /** 是否自动开始输出（仅 source 模式） */
+    autoStart?: boolean;
+    /** 流式渲染配置（动画等） */
+    streaming?: StreamingConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/streaming/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/streaming/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,cAAc;IACd,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,iBAAiB;IACjB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,sBAAsB;IACtB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,WAAW;IACX,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW;IACX,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY;IACZ,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW;IACX,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY;IACZ,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,aAAa;IACb,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,cAAc;IACd,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}

package/dist/streaming/useStreamingMarkdown.d.ts

@@ -0,0 +1,8 @@
+import { UseStreamingMarkdownOptions, UseStreamingMarkdownResult } from './types';
+
+/**
+ * 流式 Markdown 渲染 Hook
+ * 支持高性能增量解析和渲染，以及内置速率控制
+ */
+export declare function useStreamingMarkdown(options?: UseStreamingMarkdownOptions): UseStreamingMarkdownResult;
+//# sourceMappingURL=useStreamingMarkdown.d.ts.map

package/dist/streaming/useStreamingMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamingMarkdown.d.ts","sourceRoot":"","sources":["../../src/streaming/useStreamingMarkdown.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAgCvF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,0BAA0B,CA6L5B"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+import { ComponentType } from 'react';
+import { ProcessorOptions } from '@superlc/md-core';
+
+/**
+ * 自定义组件映射表
+ * 可用于覆盖默认 HTML 元素的渲染方式
+ */
+export type MarkdownComponents = {
+    [key: string]: ComponentType<Record<string, unknown>> | undefined;
+};
+/**
+ * Markdown 组件 Props
+ */
+export interface MarkdownProps extends ProcessorOptions {
+    /** Markdown 源文本 */
+    children: string;
+    /** 自定义组件映射 */
+    components?: MarkdownComponents;
+    /** 容器 className */
+    className?: string;
+}
+/**
+ * useMarkdown Hook 配置
+ */
+export interface UseMarkdownOptions extends ProcessorOptions {
+    /** 自定义组件映射 */
+    components?: MarkdownComponents;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,cAAc;IACd,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC"}

package/dist/useMarkdown.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { UseMarkdownOptions } from './types';
+
+/**
+ * 将 Markdown 转换为 React 元素的 Hook
+ *
+ * @param content - Markdown 源文本
+ * @param options - 配置选项
+ * @returns React 元素
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const element = useMarkdown('# Hello World', {
+ *     components: {
+ *       h1: ({ children }) => <h1 className="text-2xl">{children}</h1>
+ *     }
+ *   });
+ *   return <div>{element}</div>;
+ * }
+ * ```
+ */
+export declare function useMarkdown(content: string, options?: UseMarkdownOptions): ReactNode;
+//# sourceMappingURL=useMarkdown.d.ts.map

package/dist/useMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkdown.d.ts","sourceRoot":"","sources":["../src/useMarkdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAexF"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 工具函数
+ */
+export { sanitizeHtml, sanitizeHast, isDOMPurifyAvailable } from './sanitize';
+export type { SanitizeConfig } from './sanitize';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,24 @@
+import { Element, Root } from '@superlc/md-core';
+
+export interface SanitizeConfig {
+    /** DOMPurify 配置 */
+    ADD_TAGS?: string[];
+    ADD_ATTR?: string[];
+    FORBID_TAGS?: string[];
+    FORBID_ATTR?: string[];
+    [key: string]: unknown;
+}
+/**
+ * 判断 DOMPurify 是否可用
+ */
+export declare function isDOMPurifyAvailable(): boolean;
+/**
+ * 净化 HTML 字符串
+ */
+export declare function sanitizeHtml(html: string, config?: SanitizeConfig): string;
+/**
+ * 递归净化 HAST 树中的危险属性
+ * 这是一个轻量级的替代方案，不依赖 DOMPurify
+ */
+export declare function sanitizeHast(node: Element | Root): Element | Root;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAoBD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,cAAc,GACtB,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAqDjE"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@superlc/md-react",
+  "version": "0.1.0",
+  "description": "基于 @superlc/md-core 的 React Markdown 渲染组件",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./styles.css": "@superlc/md-core/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "dependencies": {
+    "@superlc/md-core": "workspace:*",
+    "hast-util-to-jsx-runtime": "^2.3.0",
+    "katex": "^0.16.28"
+  },
+  "optionalDependencies": {
+    "dompurify": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/dompurify": "^3.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "keywords": [
+    "markdown",
+    "react",
+    "component",
+    "unified"
+  ],
+  "license": "MIT"
+}