dishui 0.0.65 → 0.0.67

package/dist/components/pro/ArticleControl/buildHeadingTree.js

@@ -1,36 +1,35 @@
-import h from "react";
-function a(c) {
-  const n = [], e = [];
-  return c.forEach((l, t) => {
-    const r = {
-      id: l.id || `heading-${t}`,
-      label: l.text,
-      icon: h.createElement("span", { className: "text-xs opacity-50" }, l.level === 1 ? "●" : l.level === 2 ? "○" : "▪"),
-      meta: { heading: l }
-    };
-    for (; e.length > 0 && e[e.length - 1].level >= l.level; ) e.pop();
-    if (e.length === 0) n.push(r);
-    else {
-      const s = e[e.length - 1].node;
-      s.children || (s.children = []), s.children.push(r);
-    }
-    e.push({
-      node: r,
-      level: l.level
-    });
-  }), n;
+import e from "react";
+//#region src/components/pro/ArticleControl/buildHeadingTree.ts
+function t(t) {
+	let n = [], r = [];
+	return t.forEach((t, i) => {
+		let a = {
+			id: t.id || `heading-${i}`,
+			label: t.text,
+			icon: e.createElement("span", { className: "text-xs opacity-50" }, t.level === 1 ? "●" : t.level === 2 ? "○" : "▪"),
+			meta: { heading: t }
+		};
+		for (; r.length > 0 && r[r.length - 1].level >= t.level;) r.pop();
+		if (r.length === 0) n.push(a);
+		else {
+			let e = r[r.length - 1].node;
+			e.children ||= [], e.children.push(a);
+		}
+		r.push({
+			node: a,
+			level: t.level
+		});
+	}), n;
 }
-function d(c) {
-  const n = [], e = (l) => {
-    l.forEach((t) => {
-      n.push(t.id), t.children && e(t.children);
-    });
-  };
-  return e(c), n;
+function n(e) {
+	let t = [], n = (e) => {
+		e.forEach((e) => {
+			t.push(e.id), e.children && n(e.children);
+		});
+	};
+	return n(e), t;
 }
-export {
-  a as buildHeadingTree,
-  d as getAllNodeIds
-};
+//#endregion
+export { t as buildHeadingTree, n as getAllNodeIds };
 
 //# sourceMappingURL=buildHeadingTree.js.map

package/dist/components/pro/ArticleControl/buildHeadingTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildHeadingTree.js","names":[],"sources":["../../../../src/components/pro/ArticleControl/buildHeadingTree.ts"],"sourcesContent":["import React from 'react';\nimport type { TreeNode } from '../../Tree';\nimport type { HeadingItem } from './types';\n\nexport function buildHeadingTree(items: HeadingItem[]): TreeNode[] {\n  const result: TreeNode[] = [];\n  const stack: { node: TreeNode; level: number }[] = [];\n\n  items.forEach((item, index) => {\n    const treeNode: TreeNode = {\n      id: item.id || `heading-${index}`,\n      label: item.text,\n      icon: React.createElement(\n        'span',\n        { className: 'text-xs opacity-50' },\n        item.level === 1 ? '●' : item.level === 2 ? '○' : '▪',\n      ),\n      meta: { heading: item },\n    };\n\n    while (stack.length > 0 && stack[stack.length - 1].level >= item.level) {\n      stack.pop();\n    }\n\n    if (stack.length === 0) {\n      result.push(treeNode);\n    } else {\n      const parent = stack[stack.length - 1].node;\n      if (!parent.children) parent.children = [];\n      parent.children.push(treeNode);\n    }\n\n    stack.push({ node: treeNode, level: item.level });\n  });\n\n  return result;\n}\n\nexport function getAllNodeIds(nodes: TreeNode[]): (string | number)[] {\n  const ids: (string | number)[] = [];\n  const traverse = (items: TreeNode[]) => {\n    items.forEach(node => {\n      ids.push(node.id);\n      if (node.children) traverse(node.children);\n    });\n  };\n  traverse(nodes);\n  return ids;\n}\n"],"mappings":";AAIA,SAAgB,EAAiB,GAAkC;AACjE,QAAM,IAAqB,CAAC,GACtB,IAA6C,CAAC;AAEpD,SAAA,EAAM,QAAA,CAAS,GAAM,MAAU;AAC7B,UAAM,IAAqB;AAAA,MACzB,IAAI,EAAK,MAAM,WAAW,CAAA;AAAA,MAC1B,OAAO,EAAK;AAAA,MACZ,MAAM,EAAM,cACV,QACA,EAAE,WAAW,qBAAqB,GAClC,EAAK,UAAU,IAAI,MAAM,EAAK,UAAU,IAAI,MAAM,GACpD;AAAA,MACA,MAAM,EAAE,SAAS,EAAK;AAAA,IACxB;AAEA,WAAO,EAAM,SAAS,KAAK,EAAM,EAAM,SAAS,CAAA,EAAG,SAAS,EAAK,QAC/D,CAAA,EAAM,IAAI;AAGZ,QAAI,EAAM,WAAW,EACnB,CAAA,EAAO,KAAK,CAAQ;AAAA,SACf;AACL,YAAM,IAAS,EAAM,EAAM,SAAS,CAAA,EAAG;AACvC,MAAK,EAAO,aAAU,EAAO,WAAW,CAAC,IACzC,EAAO,SAAS,KAAK,CAAQ;AAAA,IAC/B;AAEA,IAAA,EAAM,KAAK;AAAA,MAAE,MAAM;AAAA,MAAU,OAAO,EAAK;AAAA,IAAM,CAAC;AAAA,EAClD,CAAC,GAEM;AACT;AAEA,SAAgB,EAAc,GAAwC;AACpE,QAAM,IAA2B,CAAC,GAC5B,IAAA,CAAY,MAAsB;AACtC,IAAA,EAAM,QAAA,CAAQ,MAAQ;AACpB,MAAA,EAAI,KAAK,EAAK,EAAE,GACZ,EAAK,YAAU,EAAS,EAAK,QAAQ;AAAA,IAC3C,CAAC;AAAA,EACH;AACA,SAAA,EAAS,CAAK,GACP;AACT"}
+{"version":3,"file":"buildHeadingTree.js","names":[],"sources":["../../../../src/components/pro/ArticleControl/buildHeadingTree.ts"],"sourcesContent":["import React from 'react';\nimport type { TreeNode } from '../../Tree';\nimport type { HeadingItem } from './types';\n\nexport function buildHeadingTree(items: HeadingItem[]): TreeNode[] {\n  const result: TreeNode[] = [];\n  const stack: { node: TreeNode; level: number }[] = [];\n\n  items.forEach((item, index) => {\n    const treeNode: TreeNode = {\n      id: item.id || `heading-${index}`,\n      label: item.text,\n      icon: React.createElement(\n        'span',\n        { className: 'text-xs opacity-50' },\n        item.level === 1 ? '●' : item.level === 2 ? '○' : '▪',\n      ),\n      meta: { heading: item },\n    };\n\n    while (stack.length > 0 && stack[stack.length - 1].level >= item.level) {\n      stack.pop();\n    }\n\n    if (stack.length === 0) {\n      result.push(treeNode);\n    } else {\n      const parent = stack[stack.length - 1].node;\n      if (!parent.children) parent.children = [];\n      parent.children.push(treeNode);\n    }\n\n    stack.push({ node: treeNode, level: item.level });\n  });\n\n  return result;\n}\n\nexport function getAllNodeIds(nodes: TreeNode[]): (string | number)[] {\n  const ids: (string | number)[] = [];\n  const traverse = (items: TreeNode[]) => {\n    items.forEach(node => {\n      ids.push(node.id);\n      if (node.children) traverse(node.children);\n    });\n  };\n  traverse(nodes);\n  return ids;\n}\n"],"mappings":";;AAIA,SAAgB,EAAiB,GAAkC;CACjE,IAAM,IAAqB,CAAC,GACtB,IAA6C,CAAC;CA6BpD,OA3BA,EAAM,SAAS,GAAM,MAAU;EAC7B,IAAM,IAAqB;GACzB,IAAI,EAAK,MAAM,WAAW;GAC1B,OAAO,EAAK;GACZ,MAAM,EAAM,cACV,QACA,EAAE,WAAW,qBAAqB,GAClC,EAAK,UAAU,IAAI,MAAM,EAAK,UAAU,IAAI,MAAM,GACpD;GACA,MAAM,EAAE,SAAS,EAAK;EACxB;EAEA,OAAO,EAAM,SAAS,KAAK,EAAM,EAAM,SAAS,EAAE,CAAC,SAAS,EAAK,QAC/D,EAAM,IAAI;EAGZ,IAAI,EAAM,WAAW,GACnB,EAAO,KAAK,CAAQ;OACf;GACL,IAAM,IAAS,EAAM,EAAM,SAAS,EAAE,CAAC;GAEvC,AADA,AAAsB,EAAO,aAAW,CAAC,GACzC,EAAO,SAAS,KAAK,CAAQ;EAC/B;EAEA,EAAM,KAAK;GAAE,MAAM;GAAU,OAAO,EAAK;EAAM,CAAC;CAClD,CAAC,GAEM;AACT;AAEA,SAAgB,EAAc,GAAwC;CACpE,IAAM,IAA2B,CAAC,GAC5B,KAAY,MAAsB;EACtC,EAAM,SAAQ,MAAQ;GAEpB,AADA,EAAI,KAAK,EAAK,EAAE,GACZ,EAAK,YAAU,EAAS,EAAK,QAAQ;EAC3C,CAAC;CACH;CAEA,OADA,EAAS,CAAK,GACP;AACT"}

package/dist/components/pro/ArticleControl/useArticleToc.js

@@ -1,105 +1,103 @@
-import { useCallback as C, useEffect as v, useRef as x, useState as E } from "react";
-function T(r) {
-  const [I, m] = E([]), [b, g] = E(""), [S, w] = E(""), a = x("");
-  v(() => {
-    a.current = b;
-  }, [b]);
-  const p = C(() => {
-    if (!r) return;
-    const i = r.querySelectorAll("h1, h2, h3, h4, h5, h6"), c = [];
-    i.forEach((n) => {
-      const h = n.id || n.textContent?.toLowerCase().replace(/\s+/g, "-") || "", f = n.textContent || "", u = parseInt(n.tagName.substring(1));
-      !n.id && h && (n.id = h), c.push({
-        id: h,
-        text: f,
-        level: u
-      });
-    }), m(c);
-  }, [r]);
-  return v(() => {
-    if (!r) return;
-    const c = ((o) => {
-      let t = o;
-      for (; t; ) {
-        const l = window.getComputedStyle(t).overflowY;
-        if (l === "auto" || l === "scroll") return t;
-        t = t.parentElement;
-      }
-      return null;
-    })(r), n = /* @__PURE__ */ new Map(), h = new IntersectionObserver((o) => {
-      o.forEach((e) => {
-        const s = e.target.id;
-        e.isIntersecting ? n.set(s, {
-          ratio: e.intersectionRatio,
-          top: e.boundingClientRect.top
-        }) : n.delete(s);
-      });
-      let t = "", l = 1 / 0;
-      if (n.forEach((e, s) => {
-        const d = Math.abs(e.top - 100);
-        d < l && (l = d, t = s);
-      }), !t) {
-        const e = r.querySelectorAll("h1, h2, h3, h4, h5, h6");
-        let s = "";
-        e.forEach((d) => {
-          d.getBoundingClientRect().top <= 120 && (s = d.id);
-        }), s && (t = s);
-      }
-      t && t !== a.current && (w(a.current), g(t));
-    }, {
-      root: c,
-      rootMargin: "-5% 0px -70% 0px",
-      threshold: [
-        0,
-        0.1,
-        0.25,
-        0.5,
-        0.75,
-        1
-      ]
-    });
-    r.querySelectorAll("h1, h2, h3, h4, h5, h6").forEach((o) => {
-      o.id && h.observe(o);
-    });
-    const f = () => {
-      const o = r.querySelectorAll("h1, h2, h3, h4, h5, h6");
-      let t = "", l = 1 / 0;
-      o.forEach((e) => {
-        const s = e.getBoundingClientRect(), d = Math.abs(s.top - 100);
-        s.top <= 150 && d < l && (l = d, t = e.id);
-      }), t || o.forEach((e) => {
-        e.getBoundingClientRect().top <= 100 && (t = e.id);
-      }), t && t !== a.current && (w(a.current), g(t));
-    }, u = [];
-    return c && u.push(c), u.push(window), u.forEach((o) => o.addEventListener("scroll", f, { passive: !0 })), setTimeout(f, 100), () => {
-      h.disconnect(), u.forEach((o) => o.removeEventListener("scroll", f));
-    };
-  }, [r, I]), v(() => {
-    const i = setTimeout(p, 500);
-    return () => clearTimeout(i);
-  }, [p]), v(() => {
-    if (!r) return;
-    const i = new MutationObserver(() => p());
-    return i.observe(r, {
-      childList: !0,
-      subtree: !0
-    }), () => i.disconnect();
-  }, [r, p]), {
-    headings: I,
-    activeId: b,
-    prevActiveId: S,
-    setActiveId: g,
-    scrollToHeading: C((i) => {
-      const c = document.getElementById(i.id);
-      c && (c.scrollIntoView({
-        behavior: "smooth",
-        block: "start"
-      }), g(i.id));
-    }, [])
-  };
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/components/pro/ArticleControl/useArticleToc.ts
+function i(i) {
+	let [a, o] = r([]), [s, c] = r(""), [l, u] = r(""), d = n("");
+	t(() => {
+		d.current = s;
+	}, [s]);
+	let f = e(() => {
+		if (!i) return;
+		let e = i.querySelectorAll("h1, h2, h3, h4, h5, h6"), t = [];
+		e.forEach((e) => {
+			let n = e.id || e.textContent?.toLowerCase().replace(/\s+/g, "-") || "", r = e.textContent || "", i = parseInt(e.tagName.substring(1));
+			!e.id && n && (e.id = n), t.push({
+				id: n,
+				text: r,
+				level: i
+			});
+		}), o(t);
+	}, [i]);
+	return t(() => {
+		if (!i) return;
+		let e = ((e) => {
+			let t = e;
+			for (; t;) {
+				let e = window.getComputedStyle(t).overflowY;
+				if (e === "auto" || e === "scroll") return t;
+				t = t.parentElement;
+			}
+			return null;
+		})(i), t = /* @__PURE__ */ new Map(), n = new IntersectionObserver((e) => {
+			e.forEach((e) => {
+				let n = e.target.id;
+				e.isIntersecting ? t.set(n, {
+					ratio: e.intersectionRatio,
+					top: e.boundingClientRect.top
+				}) : t.delete(n);
+			});
+			let n = "", r = Infinity;
+			if (t.forEach((e, t) => {
+				let i = Math.abs(e.top - 100);
+				i < r && (r = i, n = t);
+			}), !n) {
+				let e = i.querySelectorAll("h1, h2, h3, h4, h5, h6"), t = "";
+				e.forEach((e) => {
+					e.getBoundingClientRect().top <= 120 && (t = e.id);
+				}), t && (n = t);
+			}
+			n && n !== d.current && (u(d.current), c(n));
+		}, {
+			root: e,
+			rootMargin: "-5% 0px -70% 0px",
+			threshold: [
+				0,
+				.1,
+				.25,
+				.5,
+				.75,
+				1
+			]
+		});
+		i.querySelectorAll("h1, h2, h3, h4, h5, h6").forEach((e) => {
+			e.id && n.observe(e);
+		});
+		let r = () => {
+			let e = i.querySelectorAll("h1, h2, h3, h4, h5, h6"), t = "", n = Infinity;
+			e.forEach((e) => {
+				let r = e.getBoundingClientRect(), i = Math.abs(r.top - 100);
+				r.top <= 150 && i < n && (n = i, t = e.id);
+			}), t || e.forEach((e) => {
+				e.getBoundingClientRect().top <= 100 && (t = e.id);
+			}), t && t !== d.current && (u(d.current), c(t));
+		}, a = [];
+		return e && a.push(e), a.push(window), a.forEach((e) => e.addEventListener("scroll", r, { passive: !0 })), setTimeout(r, 100), () => {
+			n.disconnect(), a.forEach((e) => e.removeEventListener("scroll", r));
+		};
+	}, [i, a]), t(() => {
+		let e = setTimeout(f, 500);
+		return () => clearTimeout(e);
+	}, [f]), t(() => {
+		if (!i) return;
+		let e = new MutationObserver(() => f());
+		return e.observe(i, {
+			childList: !0,
+			subtree: !0
+		}), () => e.disconnect();
+	}, [i, f]), {
+		headings: a,
+		activeId: s,
+		prevActiveId: l,
+		setActiveId: c,
+		scrollToHeading: e((e) => {
+			let t = document.getElementById(e.id);
+			t && (t.scrollIntoView({
+				behavior: "smooth",
+				block: "start"
+			}), c(e.id));
+		}, [])
+	};
 }
-export {
-  T as useArticleToc
-};
+//#endregion
+export { i as useArticleToc };
 
 //# sourceMappingURL=useArticleToc.js.map

package/dist/components/pro/ArticleControl/useArticleToc.js.map

@@ -1 +1 @@
-{"version":3,"file":"useArticleToc.js","names":[],"sources":["../../../../src/components/pro/ArticleControl/useArticleToc.ts"],"sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react';\nimport type { HeadingItem } from './types';\n\nexport function useArticleToc(container: HTMLElement | null) {\n  const [headings, setHeadings] = useState<HeadingItem[]>([]);\n  const [activeId, setActiveId] = useState<string>('');\n  const [prevActiveId, setPrevActiveId] = useState<string>('');\n  const activeIdRef = useRef<string>('');\n\n  useEffect(() => {\n    activeIdRef.current = activeId;\n  }, [activeId]);\n\n  const extractHeadings = useCallback(() => {\n    if (!container) return;\n\n    const headingElements = container.querySelectorAll('h1, h2, h3, h4, h5, h6');\n    const extracted: HeadingItem[] = [];\n\n    headingElements.forEach((element) => {\n      const id = element.id || element.textContent?.toLowerCase().replace(/\\s+/g, '-') || '';\n      const text = element.textContent || '';\n      const level = parseInt(element.tagName.substring(1));\n      if (!element.id && id) element.id = id;\n      extracted.push({ id, text, level });\n    });\n\n    setHeadings(extracted);\n  }, [container]);\n\n  useEffect(() => {\n    if (!container) return;\n\n    const findScrollContainer = (el: HTMLElement): HTMLElement | null => {\n      let current: HTMLElement | null = el;\n      while (current) {\n        const overflow = window.getComputedStyle(current).overflowY;\n        if (overflow === 'auto' || overflow === 'scroll') return current;\n        current = current.parentElement;\n      }\n      return null;\n    };\n\n    const scrollContainer = findScrollContainer(container);\n    const visibleHeadings = new Map<string, { ratio: number; top: number }>();\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        entries.forEach((entry) => {\n          const id = entry.target.id;\n          if (entry.isIntersecting) {\n            visibleHeadings.set(id, { ratio: entry.intersectionRatio, top: entry.boundingClientRect.top });\n          } else {\n            visibleHeadings.delete(id);\n          }\n        });\n\n        let bestId = '';\n        let bestTop = Infinity;\n\n        visibleHeadings.forEach((info, id) => {\n          const absTop = Math.abs(info.top - 100);\n          if (absTop < bestTop) { bestTop = absTop; bestId = id; }\n        });\n\n        if (!bestId) {\n          const headingElements = container!.querySelectorAll('h1, h2, h3, h4, h5, h6');\n          let lastPassedId = '';\n          headingElements.forEach((element) => {\n            const rect = element.getBoundingClientRect();\n            if (rect.top <= 120) lastPassedId = element.id;\n          });\n          if (lastPassedId) bestId = lastPassedId;\n        }\n\n        if (bestId && bestId !== activeIdRef.current) {\n          setPrevActiveId(activeIdRef.current);\n          setActiveId(bestId);\n        }\n      },\n      {\n        root: scrollContainer,\n        rootMargin: '-5% 0px -70% 0px',\n        threshold: [0, 0.1, 0.25, 0.5, 0.75, 1],\n      },\n    );\n\n    const headingElements = container.querySelectorAll('h1, h2, h3, h4, h5, h6');\n    headingElements.forEach((element) => { if (element.id) observer.observe(element); });\n\n    const handleScroll = () => {\n      const headingElements = container!.querySelectorAll('h1, h2, h3, h4, h5, h6');\n      let currentId = '';\n      let minDistance = Infinity;\n\n      headingElements.forEach((element) => {\n        const rect = element.getBoundingClientRect();\n        const distance = Math.abs(rect.top - 100);\n        if (rect.top <= 150 && distance < minDistance) { minDistance = distance; currentId = element.id; }\n      });\n\n      if (!currentId) {\n        headingElements.forEach((element) => {\n          const rect = element.getBoundingClientRect();\n          if (rect.top <= 100) currentId = element.id;\n        });\n      }\n\n      if (currentId && currentId !== activeIdRef.current) {\n        setPrevActiveId(activeIdRef.current);\n        setActiveId(currentId);\n      }\n    };\n\n    const scrollTargets: (HTMLElement | Window)[] = [];\n    if (scrollContainer) scrollTargets.push(scrollContainer);\n    scrollTargets.push(window);\n    scrollTargets.forEach(target => target.addEventListener('scroll', handleScroll, { passive: true }));\n    setTimeout(handleScroll, 100);\n\n    return () => {\n      observer.disconnect();\n      scrollTargets.forEach(target => target.removeEventListener('scroll', handleScroll));\n    };\n  }, [container, headings]);\n\n  useEffect(() => {\n    const timer = setTimeout(extractHeadings, 500);\n    return () => clearTimeout(timer);\n  }, [extractHeadings]);\n\n  useEffect(() => {\n    if (!container) return;\n    const observer = new MutationObserver(() => extractHeadings());\n    observer.observe(container, { childList: true, subtree: true });\n    return () => observer.disconnect();\n  }, [container, extractHeadings]);\n\n  const scrollToHeading = useCallback((heading: HeadingItem) => {\n    const element = document.getElementById(heading.id);\n    if (element) {\n      element.scrollIntoView({ behavior: 'smooth', block: 'start' });\n      setActiveId(heading.id);\n    }\n  }, []);\n\n  return { headings, activeId, prevActiveId, setActiveId, scrollToHeading };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useArticleToc.js","names":[],"sources":["../../../../src/components/pro/ArticleControl/useArticleToc.ts"],"sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react';\nimport type { HeadingItem } from './types';\n\nexport function useArticleToc(container: HTMLElement | null) {\n  const [headings, setHeadings] = useState<HeadingItem[]>([]);\n  const [activeId, setActiveId] = useState<string>('');\n  const [prevActiveId, setPrevActiveId] = useState<string>('');\n  const activeIdRef = useRef<string>('');\n\n  useEffect(() => {\n    activeIdRef.current = activeId;\n  }, [activeId]);\n\n  const extractHeadings = useCallback(() => {\n    if (!container) return;\n\n    const headingElements = container.querySelectorAll('h1, h2, h3, h4, h5, h6');\n    const extracted: HeadingItem[] = [];\n\n    headingElements.forEach((element) => {\n      const id = element.id || element.textContent?.toLowerCase().replace(/\\s+/g, '-') || '';\n      const text = element.textContent || '';\n      const level = parseInt(element.tagName.substring(1));\n      if (!element.id && id) element.id = id;\n      extracted.push({ id, text, level });\n    });\n\n    setHeadings(extracted);\n  }, [container]);\n\n  useEffect(() => {\n    if (!container) return;\n\n    const findScrollContainer = (el: HTMLElement): HTMLElement | null => {\n      let current: HTMLElement | null = el;\n      while (current) {\n        const overflow = window.getComputedStyle(current).overflowY;\n        if (overflow === 'auto' || overflow === 'scroll') return current;\n        current = current.parentElement;\n      }\n      return null;\n    };\n\n    const scrollContainer = findScrollContainer(container);\n    const visibleHeadings = new Map<string, { ratio: number; top: number }>();\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        entries.forEach((entry) => {\n          const id = entry.target.id;\n          if (entry.isIntersecting) {\n            visibleHeadings.set(id, { ratio: entry.intersectionRatio, top: entry.boundingClientRect.top });\n          } else {\n            visibleHeadings.delete(id);\n          }\n        });\n\n        let bestId = '';\n        let bestTop = Infinity;\n\n        visibleHeadings.forEach((info, id) => {\n          const absTop = Math.abs(info.top - 100);\n          if (absTop < bestTop) { bestTop = absTop; bestId = id; }\n        });\n\n        if (!bestId) {\n          const headingElements = container!.querySelectorAll('h1, h2, h3, h4, h5, h6');\n          let lastPassedId = '';\n          headingElements.forEach((element) => {\n            const rect = element.getBoundingClientRect();\n            if (rect.top <= 120) lastPassedId = element.id;\n          });\n          if (lastPassedId) bestId = lastPassedId;\n        }\n\n        if (bestId && bestId !== activeIdRef.current) {\n          setPrevActiveId(activeIdRef.current);\n          setActiveId(bestId);\n        }\n      },\n      {\n        root: scrollContainer,\n        rootMargin: '-5% 0px -70% 0px',\n        threshold: [0, 0.1, 0.25, 0.5, 0.75, 1],\n      },\n    );\n\n    const headingElements = container.querySelectorAll('h1, h2, h3, h4, h5, h6');\n    headingElements.forEach((element) => { if (element.id) observer.observe(element); });\n\n    const handleScroll = () => {\n      const headingElements = container!.querySelectorAll('h1, h2, h3, h4, h5, h6');\n      let currentId = '';\n      let minDistance = Infinity;\n\n      headingElements.forEach((element) => {\n        const rect = element.getBoundingClientRect();\n        const distance = Math.abs(rect.top - 100);\n        if (rect.top <= 150 && distance < minDistance) { minDistance = distance; currentId = element.id; }\n      });\n\n      if (!currentId) {\n        headingElements.forEach((element) => {\n          const rect = element.getBoundingClientRect();\n          if (rect.top <= 100) currentId = element.id;\n        });\n      }\n\n      if (currentId && currentId !== activeIdRef.current) {\n        setPrevActiveId(activeIdRef.current);\n        setActiveId(currentId);\n      }\n    };\n\n    const scrollTargets: (HTMLElement | Window)[] = [];\n    if (scrollContainer) scrollTargets.push(scrollContainer);\n    scrollTargets.push(window);\n    scrollTargets.forEach(target => target.addEventListener('scroll', handleScroll, { passive: true }));\n    setTimeout(handleScroll, 100);\n\n    return () => {\n      observer.disconnect();\n      scrollTargets.forEach(target => target.removeEventListener('scroll', handleScroll));\n    };\n  }, [container, headings]);\n\n  useEffect(() => {\n    const timer = setTimeout(extractHeadings, 500);\n    return () => clearTimeout(timer);\n  }, [extractHeadings]);\n\n  useEffect(() => {\n    if (!container) return;\n    const observer = new MutationObserver(() => extractHeadings());\n    observer.observe(container, { childList: true, subtree: true });\n    return () => observer.disconnect();\n  }, [container, extractHeadings]);\n\n  const scrollToHeading = useCallback((heading: HeadingItem) => {\n    const element = document.getElementById(heading.id);\n    if (element) {\n      element.scrollIntoView({ behavior: 'smooth', block: 'start' });\n      setActiveId(heading.id);\n    }\n  }, []);\n\n  return { headings, activeId, prevActiveId, setActiveId, scrollToHeading };\n}\n"],"mappings":"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"}

package/dist/components/pro/Calendar/Calendar.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DishUI Calendar Component
+ *
+ * A full-featured calendar with month/week/day views, drag-and-drop,
+ * holiday support, and entry management.
+ */
+import React from "react";
+import type { CalendarProps, CalendarHandle } from "./types";
+declare const Calendar: React.ForwardRefExoticComponent<CalendarProps & React.RefAttributes<CalendarHandle>>;
+export default Calendar;

package/dist/components/pro/Calendar/hooks/useCalendarDrag.d.ts

@@ -0,0 +1,47 @@
+/**
+ * useCalendarDrag - Drag-and-drop interaction hook for Calendar entries.
+ *
+ * Uses the native HTML5 Drag and Drop API to support:
+ * - Moving entries between date cells (month view)
+ * - Moving entries between time slots (week/day view)
+ * - Resizing entry duration in time-based views
+ */
+import type { CalendarEntry, CalendarDragEvent } from "../types";
+export interface DragState {
+    /** The entry being dragged */
+    entry: CalendarEntry;
+    /** The original date of the entry */
+    fromDate: string;
+    /** The original start time (if time-based) */
+    fromTime?: string;
+    /** Whether we're resizing (bottom edge) vs moving */
+    isResize: boolean;
+    /** Initial mouse Y when drag started (for resize calculations) */
+    startY: number;
+    /** Original entry duration in minutes (for resize) */
+    originalDuration: number;
+}
+export interface DropTarget {
+    /** Target date (YYYY-MM-DD) */
+    date: string;
+    /** Target time slot (HH:mm) — only in week/day view */
+    time?: string;
+}
+export interface UseCalendarDragOptions {
+    readOnly?: boolean;
+    onEntryDrop?: (event: CalendarDragEvent) => void;
+    onEntryUpdate?: (entry: CalendarEntry) => void;
+}
+export declare function useCalendarDrag(options: UseCalendarDragOptions): {
+    isDragging: boolean;
+    draggingEntryId: string | null;
+    dragState: DragState | null;
+    dropTarget: DropTarget | null;
+    isDropTarget: (date: string, time?: string) => boolean;
+    handleDragStart: (e: React.DragEvent, entry: CalendarEntry) => void;
+    handleResizeStart: (e: React.DragEvent, entry: CalendarEntry) => void;
+    handleDragOver: (e: React.DragEvent, date: string, time?: string) => void;
+    handleDragLeave: (e: React.DragEvent) => void;
+    handleDrop: (e: React.DragEvent, date: string, time?: string) => void;
+    handleDragEnd: () => void;
+};

package/dist/components/pro/Calendar/hooks/useCalendarState.d.ts

@@ -0,0 +1,56 @@
+/**
+ * useCalendarState - Core state management hook for the Calendar component.
+ *
+ * Manages current date, view mode, entries CRUD, navigation,
+ * and modal state for add/edit entry forms.
+ */
+import type { CalendarViewMode, CalendarEntry, CalendarLabels, HolidayCalendar } from "../types";
+export interface UseCalendarStateOptions {
+    entries?: CalendarEntry[];
+    holidays?: HolidayCalendar;
+    defaultView?: CalendarViewMode;
+    defaultDate?: string;
+    locale?: "zh" | "en";
+    labels?: CalendarLabels;
+    colorOptions?: string[];
+    readOnly?: boolean;
+    onEntryAdd?: (entry: CalendarEntry) => void;
+    onEntryUpdate?: (entry: CalendarEntry) => void;
+    onEntryDelete?: (entryId: string) => void;
+    onViewChange?: (view: CalendarViewMode) => void;
+}
+export interface EntryModalState {
+    open: boolean;
+    mode: "add" | "edit";
+    entry: Partial<CalendarEntry>;
+}
+export declare function useCalendarState(options: UseCalendarStateOptions): {
+    currentDate: string;
+    currentDateObj: Date;
+    viewMode: CalendarViewMode;
+    entries: CalendarEntry[];
+    labels: Required<CalendarLabels>;
+    colorOptions: string[];
+    holidays: HolidayCalendar | undefined;
+    readOnly: boolean;
+    goToToday: () => void;
+    goToDate: (date: string) => void;
+    goNext: () => void;
+    goPrev: () => void;
+    title: string;
+    setViewMode: (view: CalendarViewMode) => void;
+    monthDates: Date[];
+    weekDates: Date[];
+    addEntry: (entry: Omit<CalendarEntry, "id"> & {
+        id?: string;
+    }) => CalendarEntry;
+    updateEntry: (entry: CalendarEntry) => void;
+    deleteEntry: (entryId: string) => void;
+    getEntriesForDate: (date: string) => CalendarEntry[];
+    modalState: EntryModalState;
+    openAddModal: (date?: string, startTime?: string) => void;
+    openEditModal: (entry: CalendarEntry) => void;
+    closeModal: () => void;
+    saveModal: (entryData: Partial<CalendarEntry>) => CalendarEntry;
+    deleteModalEntry: () => void;
+};

package/dist/components/pro/Calendar/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Calendar } from "./Calendar";
+export * from "./types";
+export { LABELS_EN, LABELS_ZH, DEFAULT_COLOR_OPTIONS, parseDate, formatDate, todayStr, isToday, isSameDay, isWeekend, isHoliday, isNonWorkingDay, getHolidayEntry, getDaysInMonth, getFirstDayOfMonth, getMonthDates, getWeekDates, minutesToTime, timeToMinutes, formatTime, parseTime, generateTimeSlots, TIME_SLOTS, SLOT_HEIGHT, TIME_GRID_HEIGHT, addDays, generateId, clamp, } from "./utils";
+export { useCalendarState } from "./hooks/useCalendarState";
+export type { UseCalendarStateOptions, EntryModalState } from "./hooks/useCalendarState";
+export { useCalendarDrag } from "./hooks/useCalendarDrag";
+export type { DragState as CalendarDragState, DropTarget as CalendarDropTarget, UseCalendarDragOptions, } from "./hooks/useCalendarDrag";

package/dist/components/pro/Calendar/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * DishUI Calendar Component - Type Definitions
+ */
+/** The three display modes for the calendar */
+export type CalendarViewMode = "month" | "week" | "day";
+/**
+ * A single calendar entry / event.
+ * Supports both all-day events and time-based events.
+ */
+export interface CalendarEntry {
+    /** Unique identifier */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Start time in HH:mm format. Omit for all-day events. */
+    startTime?: string;
+    /** End time in HH:mm format. Omit for all-day events. */
+    endTime?: string;
+    /** Display color key or CSS color */
+    color?: string;
+    /** Optional description text */
+    description?: string;
+    /** Whether this is an all-day event (no start/end time) */
+    allDay?: boolean;
+    /** Allow arbitrary extra fields */
+    [key: string]: any;
+}
+/**
+ * A single holiday definition.
+ * Compatible with the Gantt component's HolidayEntry.
+ */
+export interface HolidayEntry {
+    /** Date string in YYYY-MM-DD format */
+    date: string;
+    /** Display name of the holiday */
+    name: string;
+    /**
+     * If true, this is a compensatory workday (调休).
+     * The date is treated as a normal working day even if it falls on a weekend.
+     */
+    isWorkday?: boolean;
+}
+/**
+ * Holiday calendar configuration.
+ * Determines which days are holidays / non-working days.
+ */
+export interface HolidayCalendar {
+    /** List of holiday/special day entries */
+    entries: HolidayEntry[];
+    /**
+     * Whether weekends (Saturday & Sunday) are non-working days.
+     * Default: true.
+     */
+    weekendsOff?: boolean;
+}
+/** Describes a drag-and-drop operation on a calendar entry */
+export interface CalendarDragEvent {
+    /** The entry being dragged */
+    entry: CalendarEntry;
+    /** Original date (YYYY-MM-DD) */
+    fromDate: string;
+    /** New date (YYYY-MM-DD) */
+    toDate: string;
+    /** Original start time (HH:mm) if applicable */
+    fromTime?: string;
+    /** New start time (HH:mm) if applicable */
+    toTime?: string;
+}
+/** Customizable UI labels for the calendar */
+export interface CalendarLabels {
+    today?: string;
+    month?: string;
+    week?: string;
+    day?: string;
+    addEntry?: string;
+    deleteEntry?: string;
+    editEntry?: string;
+    allDay?: string;
+    noEntries?: string;
+    confirmDelete?: string;
+    cancel?: string;
+    save?: string;
+    title?: string;
+    date?: string;
+    startTime?: string;
+    endTime?: string;
+    description?: string;
+    color?: string;
+    /** 7 items starting from Sunday */
+    weekDays?: string[];
+    /** 12 month names */
+    monthNames?: string[];
+}
+export interface CalendarProps {
+    /** Calendar entries / events */
+    entries?: CalendarEntry[];
+    /** Holiday calendar configuration */
+    holidays?: HolidayCalendar;
+    /** Initial view mode. Default: 'month' */
+    defaultView?: CalendarViewMode;
+    /** Initial date in YYYY-MM-DD format. Default: today */
+    defaultDate?: string;
+    /** If true, entries cannot be added, edited, deleted, or dragged */
+    readOnly?: boolean;
+    /** Locale shorthand for built-in labels. Default: 'en' */
+    locale?: "zh" | "en";
+    /** Custom label overrides (merged on top of locale defaults) */
+    labels?: CalendarLabels;
+    /** Calendar height */
+    height?: number | string;
+    /** Calendar width */
+    width?: number | string;
+    /** Called when a new entry is added via the form */
+    onEntryAdd?: (entry: CalendarEntry) => void;
+    /** Called when an existing entry is updated via the form */
+    onEntryUpdate?: (entry: CalendarEntry) => void;
+    /** Called when an entry is deleted */
+    onEntryDelete?: (entryId: string) => void;
+    /** Called when an entry is drag-and-dropped to a new date/time */
+    onEntryDrop?: (event: CalendarDragEvent) => void;
+    /** Called when an entry is clicked */
+    onEntryClick?: (entry: CalendarEntry) => void;
+    /** Called when a date cell is clicked (not on an entry) */
+    onDateClick?: (date: string) => void;
+    /** Called when the view mode changes */
+    onViewChange?: (view: CalendarViewMode) => void;
+    /** Background color for holiday cells */
+    holidayColor?: string;
+    /** Background/border color for today */
+    todayColor?: string;
+    /** Background color for weekend cells */
+    weekendColor?: string;
+    /** Additional class name on the root element */
+    className?: string;
+    /** Inline styles on the root element */
+    style?: React.CSSProperties;
+    /** Available colors for the entry color picker */
+    colorOptions?: string[];
+}
+export interface CalendarHandle {
+    /** Navigate to today */
+    goToToday: () => void;
+    /** Navigate to a specific date (YYYY-MM-DD) */
+    goToDate: (date: string) => void;
+    /** Set the view mode */
+    setView: (view: CalendarViewMode) => void;
+    /** Get all current entries */
+    getEntries: () => CalendarEntry[];
+}