dishui 0.0.65 → 0.0.66

package/dist/flow.js

@@ -1,83 +1,27 @@
-import { BORDER_STYLE_OPTIONS as r, DASH_DENSITY_OPTIONS as t, DEFAULT_EDGE_DATA as m, DEFAULT_NODE_DATA as e, EDGE_LINE_STYLE_OPTIONS as i, EDGE_MARKER_OPTIONS as p, EDGE_TYPE_OPTIONS as E, GRADIENT_DIRECTION_OPTIONS as T, PALETTE_ITEMS as S, ROOT_CANVAS_ID as _, createEmptyDocument as f } from "./components/pro/Flow/constants.js";
-import { FlowProvider as I, useFlowContext as l } from "./components/pro/Flow/context/FlowContext.js";
-import { FlowUIProvider as a, useFlowUI as A } from "./components/pro/Flow/context/FlowUIContext.js";
-import { FlowAIProvider as P, useFlowAI as s } from "./components/pro/Flow/context/FlowAIContext.js";
-import { SVG_ICON_CATEGORIES as D, buildSvgMarkup as C, getAllSvgIcons as F, getSvgIcon as c, getSvgIconsByCategory as R } from "./components/pro/Flow/nodes/svgIcons.js";
-import w from "./components/pro/Flow/panels/ProjectTitle.js";
-import { isArchifySpec as d } from "./components/pro/Flow/archify/spec.js";
-import { ARCHIFY_BG as g, ARCHIFY_GRID as G, COMPONENT_STYLES as M, STATE_STYLES as v, componentStyle as h, stateStyle as x, variantEdgeStyle as B } from "./components/pro/Flow/archify/palette.js";
-import { archifyToFlowDocument as U } from "./components/pro/Flow/archify/convert.js";
-import { ARCHIFY_COMPONENT_LABELS as V, ARCHIFY_COMPONENT_ORDER as j, archifyStylePatch as k, inferComponentType as K } from "./components/pro/Flow/archify/presets.js";
-import { downloadDataURL as Z, exportCanvasToPNG as q, useFlowImportExport as z } from "./components/pro/Flow/hooks/useFlowImportExport.js";
-import { useLayoutActions as Q } from "./components/pro/Flow/hooks/useLayoutActions.js";
-import $, { FlowZoomControls as oo } from "./components/pro/Flow/panels/FlowToolbar.js";
-import to from "./components/pro/Flow/panels/ShapePalette.js";
-import { FLOW_NODE_TYPES as eo } from "./components/pro/Flow/types.js";
-import po from "./components/pro/Flow/panels/InspectorPanel.js";
-import To from "./components/pro/Flow/panels/OutlinePanel.js";
-import { AIPanelContent as _o } from "./components/pro/Flow/panels/AIPanel.js";
-import no from "./components/pro/Flow/panels/Breadcrumb.js";
-import lo from "./components/pro/Flow/panels/ContextMenu.js";
-import { useClipboard as ao } from "./components/pro/Flow/hooks/useClipboard.js";
-import No from "./components/pro/Flow/Flow.js";
-import { useNodeMutations as so } from "./components/pro/Flow/hooks/useNodeMutations.js";
-import { useEdgeMutations as Do } from "./components/pro/Flow/hooks/useEdgeMutations.js";
-import { useLineMutations as Fo } from "./components/pro/Flow/hooks/useLineMutations.js";
-import { useSelection as Ro } from "./components/pro/Flow/hooks/useSelection.js";
-export {
-  _o as AIPanelContent,
-  g as ARCHIFY_BG,
-  V as ARCHIFY_COMPONENT_LABELS,
-  j as ARCHIFY_COMPONENT_ORDER,
-  G as ARCHIFY_GRID,
-  r as BORDER_STYLE_OPTIONS,
-  no as Breadcrumb,
-  M as COMPONENT_STYLES,
-  lo as ContextMenu,
-  t as DASH_DENSITY_OPTIONS,
-  m as DEFAULT_EDGE_DATA,
-  e as DEFAULT_NODE_DATA,
-  i as EDGE_LINE_STYLE_OPTIONS,
-  p as EDGE_MARKER_OPTIONS,
-  E as EDGE_TYPE_OPTIONS,
-  eo as FLOW_NODE_TYPES,
-  No as Flow,
-  P as FlowAIProvider,
-  I as FlowProvider,
-  $ as FlowToolbar,
-  a as FlowUIProvider,
-  oo as FlowZoomControls,
-  T as GRADIENT_DIRECTION_OPTIONS,
-  po as InspectorPanel,
-  To as OutlinePanel,
-  S as PALETTE_ITEMS,
-  w as ProjectTitle,
-  _ as ROOT_CANVAS_ID,
-  v as STATE_STYLES,
-  D as SVG_ICON_CATEGORIES,
-  to as ShapePalette,
-  k as archifyStylePatch,
-  U as archifyToFlowDocument,
-  C as buildSvgMarkup,
-  h as componentStyle,
-  f as createEmptyDocument,
-  Z as downloadDataURL,
-  q as exportCanvasToPNG,
-  F as getAllSvgIcons,
-  c as getSvgIcon,
-  R as getSvgIconsByCategory,
-  K as inferComponentType,
-  d as isArchifySpec,
-  x as stateStyle,
-  ao as useClipboard,
-  Do as useEdgeMutations,
-  s as useFlowAI,
-  l as useFlowContext,
-  z as useFlowImportExport,
-  A as useFlowUI,
-  Q as useLayoutActions,
-  Fo as useLineMutations,
-  so as useNodeMutations,
-  Ro as useSelection,
-  B as variantEdgeStyle
-};
+import { BORDER_STYLE_OPTIONS as e, DASH_DENSITY_OPTIONS as t, DEFAULT_EDGE_DATA as n, DEFAULT_NODE_DATA as r, EDGE_LINE_STYLE_OPTIONS as i, EDGE_MARKER_OPTIONS as a, EDGE_TYPE_OPTIONS as o, GRADIENT_DIRECTION_OPTIONS as s, PALETTE_ITEMS as c, ROOT_CANVAS_ID as l, createEmptyDocument as u } from "./components/pro/Flow/constants.js";
+import { FlowProvider as d, useFlowContext as f } from "./components/pro/Flow/context/FlowContext.js";
+import { FlowUIProvider as p, useFlowUI as m } from "./components/pro/Flow/context/FlowUIContext.js";
+import { FlowAIProvider as h, useFlowAI as g } from "./components/pro/Flow/context/FlowAIContext.js";
+import { SVG_ICON_CATEGORIES as _, buildSvgMarkup as v, getAllSvgIcons as y, getSvgIcon as b, getSvgIconsByCategory as x } from "./components/pro/Flow/nodes/svgIcons.js";
+import S from "./components/pro/Flow/panels/ProjectTitle.js";
+import { isArchifySpec as C } from "./components/pro/Flow/archify/spec.js";
+import { ARCHIFY_BG as w, ARCHIFY_GRID as T, COMPONENT_STYLES as E, STATE_STYLES as D, componentStyle as O, stateStyle as k, variantEdgeStyle as A } from "./components/pro/Flow/archify/palette.js";
+import { archifyToFlowDocument as j } from "./components/pro/Flow/archify/convert.js";
+import { ARCHIFY_COMPONENT_LABELS as M, ARCHIFY_COMPONENT_ORDER as N, archifyStylePatch as P, inferComponentType as F } from "./components/pro/Flow/archify/presets.js";
+import { downloadDataURL as I, exportCanvasToPNG as L, useFlowImportExport as R } from "./components/pro/Flow/hooks/useFlowImportExport.js";
+import { useLayoutActions as z } from "./components/pro/Flow/hooks/useLayoutActions.js";
+import B, { FlowZoomControls as V } from "./components/pro/Flow/panels/FlowToolbar.js";
+import H from "./components/pro/Flow/panels/ShapePalette.js";
+import { FLOW_NODE_TYPES as U } from "./components/pro/Flow/types.js";
+import W from "./components/pro/Flow/panels/InspectorPanel.js";
+import G from "./components/pro/Flow/panels/OutlinePanel.js";
+import { AIPanelContent as K } from "./components/pro/Flow/panels/AIPanel.js";
+import q from "./components/pro/Flow/panels/Breadcrumb.js";
+import J from "./components/pro/Flow/panels/ContextMenu.js";
+import { useClipboard as Y } from "./components/pro/Flow/hooks/useClipboard.js";
+import X from "./components/pro/Flow/Flow.js";
+import { useNodeMutations as Z } from "./components/pro/Flow/hooks/useNodeMutations.js";
+import { useEdgeMutations as Q } from "./components/pro/Flow/hooks/useEdgeMutations.js";
+import { useLineMutations as $ } from "./components/pro/Flow/hooks/useLineMutations.js";
+import { useSelection as ee } from "./components/pro/Flow/hooks/useSelection.js";
+export { K as AIPanelContent, w as ARCHIFY_BG, M as ARCHIFY_COMPONENT_LABELS, N as ARCHIFY_COMPONENT_ORDER, T as ARCHIFY_GRID, e as BORDER_STYLE_OPTIONS, q as Breadcrumb, E as COMPONENT_STYLES, J as ContextMenu, t as DASH_DENSITY_OPTIONS, n as DEFAULT_EDGE_DATA, r as DEFAULT_NODE_DATA, i as EDGE_LINE_STYLE_OPTIONS, a as EDGE_MARKER_OPTIONS, o as EDGE_TYPE_OPTIONS, U as FLOW_NODE_TYPES, X as Flow, h as FlowAIProvider, d as FlowProvider, B as FlowToolbar, p as FlowUIProvider, V as FlowZoomControls, s as GRADIENT_DIRECTION_OPTIONS, W as InspectorPanel, G as OutlinePanel, c as PALETTE_ITEMS, S as ProjectTitle, l as ROOT_CANVAS_ID, D as STATE_STYLES, _ as SVG_ICON_CATEGORIES, H as ShapePalette, P as archifyStylePatch, j as archifyToFlowDocument, v as buildSvgMarkup, O as componentStyle, u as createEmptyDocument, I as downloadDataURL, L as exportCanvasToPNG, y as getAllSvgIcons, b as getSvgIcon, x as getSvgIconsByCategory, F as inferComponentType, C as isArchifySpec, k as stateStyle, Y as useClipboard, Q as useEdgeMutations, g as useFlowAI, f as useFlowContext, R as useFlowImportExport, m as useFlowUI, z as useLayoutActions, $ as useLineMutations, Z as useNodeMutations, ee as useSelection, A as variantEdgeStyle };

package/dist/hooks/useClickOutside.js

@@ -1,21 +1,21 @@
-import { useEffect as o } from "react";
-function i(e, t, n = !0) {
-  o(() => {
-    if (!n) return;
-    const r = (u) => {
-      e.current && !e.current.contains(u.target) && t();
-    };
-    return document.addEventListener("mousedown", r), () => {
-      document.removeEventListener("mousedown", r);
-    };
-  }, [
-    e,
-    t,
-    n
-  ]);
+import { useEffect as e } from "react";
+//#region src/hooks/useClickOutside.ts
+function t(t, n, r = !0) {
+	e(() => {
+		if (!r) return;
+		let e = (e) => {
+			t.current && !t.current.contains(e.target) && n();
+		};
+		return document.addEventListener("mousedown", e), () => {
+			document.removeEventListener("mousedown", e);
+		};
+	}, [
+		t,
+		n,
+		r
+	]);
 }
-export {
-  i as useClickOutside
-};
+//#endregion
+export { t as useClickOutside };
 
 //# sourceMappingURL=useClickOutside.js.map

package/dist/hooks/useClickOutside.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClickOutside.js","names":[],"sources":["../../src/hooks/useClickOutside.ts"],"sourcesContent":["import { useEffect, RefObject } from 'react';\n\n/**\n * 监听元素外部点击事件的 Hook\n *\n * @param ref - 需要检测外部点击的元素 ref\n * @param onClickOutside - 外部点击时的回调函数\n * @param enabled - 是否启用监听（默认 true）\n *\n * @example\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n * useClickOutside(ref, () => setIsOpen(false), isOpen);\n * ```\n */\nexport function useClickOutside(\n    ref: RefObject<HTMLElement | null>,\n    onClickOutside: () => void,\n    enabled: boolean = true\n): void {\n    useEffect(() => {\n        if (!enabled) return;\n\n        const handleClickOutside = (e: MouseEvent) => {\n            if (ref.current && !ref.current.contains(e.target as Node)) {\n                onClickOutside();\n            }\n        };\n\n        document.addEventListener('mousedown', handleClickOutside);\n        return () => {\n            document.removeEventListener('mousedown', handleClickOutside);\n        };\n    }, [ref, onClickOutside, enabled]);\n}\n"],"mappings":";AAeA,SAAgB,EACZ,GACA,GACA,IAAmB,IACf;AACJ,EAAA,EAAA,MAAgB;AACZ,QAAI,CAAC,EAAS;AAEd,UAAM,IAAA,CAAsB,MAAkB;AAC1C,MAAI,EAAI,WAAW,CAAC,EAAI,QAAQ,SAAS,EAAE,MAAc,KACrD,EAAe;AAAA,IAEvB;AAEA,oBAAS,iBAAiB,aAAa,CAAkB,GACzD,MAAa;AACT,eAAS,oBAAoB,aAAa,CAAkB;AAAA,IAChE;AAAA,EACJ,GAAG;AAAA,IAAC;AAAA,IAAK;AAAA,IAAgB;AAAA,EAAO,CAAC;AACrC"}
+{"version":3,"file":"useClickOutside.js","names":[],"sources":["../../src/hooks/useClickOutside.ts"],"sourcesContent":["import { useEffect, RefObject } from 'react';\n\n/**\n * 监听元素外部点击事件的 Hook\n *\n * @param ref - 需要检测外部点击的元素 ref\n * @param onClickOutside - 外部点击时的回调函数\n * @param enabled - 是否启用监听（默认 true）\n *\n * @example\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n * useClickOutside(ref, () => setIsOpen(false), isOpen);\n * ```\n */\nexport function useClickOutside(\n    ref: RefObject<HTMLElement | null>,\n    onClickOutside: () => void,\n    enabled: boolean = true\n): void {\n    useEffect(() => {\n        if (!enabled) return;\n\n        const handleClickOutside = (e: MouseEvent) => {\n            if (ref.current && !ref.current.contains(e.target as Node)) {\n                onClickOutside();\n            }\n        };\n\n        document.addEventListener('mousedown', handleClickOutside);\n        return () => {\n            document.removeEventListener('mousedown', handleClickOutside);\n        };\n    }, [ref, onClickOutside, enabled]);\n}\n"],"mappings":";;AAeA,SAAgB,EACZ,GACA,GACA,IAAmB,IACf;CACJ,QAAgB;EACZ,IAAI,CAAC,GAAS;EAEd,IAAM,KAAsB,MAAkB;GAC1C,AAAI,EAAI,WAAW,CAAC,EAAI,QAAQ,SAAS,EAAE,MAAc,KACrD,EAAe;EAEvB;EAGA,OADA,SAAS,iBAAiB,aAAa,CAAkB,SAC5C;GACT,SAAS,oBAAoB,aAAa,CAAkB;EAChE;CACJ,GAAG;EAAC;EAAK;EAAgB;CAAO,CAAC;AACrC"}

package/dist/hooks/useContainerElement.js

@@ -1,12 +1,12 @@
-import { useEffect as o, useState as l } from "react";
-function c(e, n) {
-  const [u, t] = l(null);
-  return o(() => {
-    n?.current ? t(n.current) : t(e ? document.getElementById(e) : null);
-  }, [e, n]), u;
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/useContainerElement.ts
+function n(n, r) {
+	let [i, a] = t(null);
+	return e(() => {
+		r?.current ? a(r.current) : a(n ? document.getElementById(n) : null);
+	}, [n, r]), i;
 }
-export {
-  c as useContainerElement
-};
+//#endregion
+export { n as useContainerElement };
 
 //# sourceMappingURL=useContainerElement.js.map

package/dist/hooks/useContainerElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContainerElement.js","names":[],"sources":["../../src/hooks/useContainerElement.ts"],"sourcesContent":["import { useState, useEffect, RefObject } from 'react';\n\n/**\n * 通过 ref 或 DOM id 解析容器元素的 Hook\n *\n * 统一了 ArticleControl 和 ArticleContextMenu 中重复的容器解析逻辑。\n * 使用 useState 和 useEffect 确保能在初次渲染后正确获取到 ref.current。\n *\n * @param targetId - 容器元素的 DOM id\n * @param targetRef - 容器元素的 React ref\n * @returns 解析到的 HTMLElement 或 null\n */\nexport function useContainerElement(\n    targetId?: string,\n    targetRef?: RefObject<HTMLElement | HTMLDivElement | null>\n): HTMLElement | null {\n    const [container, setContainer] = useState<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (targetRef?.current) {\n            setContainer(targetRef.current);\n        } else if (targetId) {\n            setContainer(document.getElementById(targetId));\n        } else {\n            setContainer(null);\n        }\n    }, [targetId, targetRef]);\n\n    return container;\n}\n"],"mappings":";AAYA,SAAgB,EACZ,GACA,GACkB;AAClB,QAAM,CAAC,GAAW,CAAA,IAAgB,EAA6B,IAAI;AAEnE,SAAA,EAAA,MAAgB;AACZ,IAAI,GAAW,UACX,EAAa,EAAU,OAAO,IAE9B,EADO,IACM,SAAS,eAAe,CAAQ,IAEhC,IAFiC;AAAA,EAItD,GAAG,CAAC,GAAU,CAAS,CAAC,GAEjB;AACX"}
+{"version":3,"file":"useContainerElement.js","names":[],"sources":["../../src/hooks/useContainerElement.ts"],"sourcesContent":["import { useState, useEffect, RefObject } from 'react';\n\n/**\n * 通过 ref 或 DOM id 解析容器元素的 Hook\n *\n * 统一了 ArticleControl 和 ArticleContextMenu 中重复的容器解析逻辑。\n * 使用 useState 和 useEffect 确保能在初次渲染后正确获取到 ref.current。\n *\n * @param targetId - 容器元素的 DOM id\n * @param targetRef - 容器元素的 React ref\n * @returns 解析到的 HTMLElement 或 null\n */\nexport function useContainerElement(\n    targetId?: string,\n    targetRef?: RefObject<HTMLElement | HTMLDivElement | null>\n): HTMLElement | null {\n    const [container, setContainer] = useState<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (targetRef?.current) {\n            setContainer(targetRef.current);\n        } else if (targetId) {\n            setContainer(document.getElementById(targetId));\n        } else {\n            setContainer(null);\n        }\n    }, [targetId, targetRef]);\n\n    return container;\n}\n"],"mappings":";;AAYA,SAAgB,EACZ,GACA,GACkB;CAClB,IAAM,CAAC,GAAW,KAAgB,EAA6B,IAAI;CAYnE,OAVA,QAAgB;EACZ,AAAI,GAAW,UACX,EAAa,EAAU,OAAO,IAE9B,EADO,IACM,SAAS,eAAe,CAAQ,IAEhC,IAAI;CAEzB,GAAG,CAAC,GAAU,CAAS,CAAC,GAEjB;AACX"}

package/dist/hooks/useControllableState.js

@@ -1,39 +1,37 @@
-import { useCallback as R, useEffect as h, useRef as f, useState as j } from "react";
-function g(e, r, u = (n, s) => n === s) {
-  const [n, s] = j(e), c = f(r);
-  c.current = r;
-  const t = f(e), o = f(0), i = f(0);
-  u(t.current, e) || (t.current = e, s(e));
-  const y = R((p) => {
-    o.current++, s(p);
-  }, []), l = f(!0);
-  return h(() => {
-    if (l.current) {
-      l.current = !1;
-      return;
-    }
-    o.current !== i.current && (i.current = o.current, c.current?.(n));
-  }, [n]), [n, y];
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/hooks/useControllableState.ts
+function i(i, a, o = (e, t) => e === t) {
+	let [s, c] = r(i), l = n(a);
+	l.current = a;
+	let u = n(i), d = n(0), f = n(0);
+	o(u.current, i) || (u.current = i, c(i));
+	let p = e((e) => {
+		d.current++, c(e);
+	}, []), m = n(!0);
+	return t(() => {
+		if (m.current) {
+			m.current = !1;
+			return;
+		}
+		d.current !== f.current && (f.current = d.current, l.current?.(s));
+	}, [s]), [s, p];
 }
-function a(e, r) {
-  if (Object.is(e, r)) return !0;
-  if (typeof e != "object" || e === null || typeof r != "object" || r === null) return !1;
-  const u = Array.isArray(e), n = Array.isArray(r);
-  if (u !== n) return !1;
-  if (u && n) {
-    if (e.length !== r.length) return !1;
-    for (let t = 0; t < e.length; t++) if (!a(e[t], r[t])) return !1;
-    return !0;
-  }
-  const s = Object.keys(e), c = Object.keys(r);
-  if (s.length !== c.length) return !1;
-  for (const t of s)
-    if (!Object.prototype.hasOwnProperty.call(r, t) || !a(e[t], r[t])) return !1;
-  return !0;
+function a(e, t) {
+	if (Object.is(e, t)) return !0;
+	if (typeof e != "object" || !e || typeof t != "object" || !t) return !1;
+	let n = Array.isArray(e), r = Array.isArray(t);
+	if (n !== r) return !1;
+	if (n && r) {
+		if (e.length !== t.length) return !1;
+		for (let n = 0; n < e.length; n++) if (!a(e[n], t[n])) return !1;
+		return !0;
+	}
+	let i = Object.keys(e), o = Object.keys(t);
+	if (i.length !== o.length) return !1;
+	for (let n of i) if (!Object.prototype.hasOwnProperty.call(t, n) || !a(e[n], t[n])) return !1;
+	return !0;
 }
-export {
-  a as deepEqual,
-  g as useControllableState
-};
+//#endregion
+export { a as deepEqual, i as useControllableState };
 
 //# sourceMappingURL=useControllableState.js.map

package/dist/hooks/useControllableState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useControllableState.js","names":[],"sources":["../../src/hooks/useControllableState.ts"],"sourcesContent":["import { useState, useRef, useCallback, useEffect } from 'react';\n\n/**\n * A hook for managing controllable state that can be either controlled (by parent via props)\n * or uncontrolled (managed internally). Handles bidirectional sync between external props\n * and internal state without causing infinite loops.\n *\n * Key design decisions:\n * - Returns the raw useState setter → always stable reference, safe for useMemo deps\n * - Uses a version counter to distinguish internal vs external state changes\n * - onChange is called via useEffect (not inside state updater) for React safety\n * - onChangeRef avoids stale closures for the onChange callback\n *\n * @param externalValue - The value from props (controlled mode when onChange is provided)\n * @param onChange - Optional callback to notify parent of internal state changes\n * @param isEqual - Optional equality check (defaults to reference equality)\n * @returns [currentValue, setValue] - The current value and a stable setter\n */\nexport function useControllableState<T>(\n    externalValue: T,\n    onChange?: (value: T) => void,\n    isEqual: (a: T, b: T) => boolean = (a, b) => a === b\n): [T, React.Dispatch<React.SetStateAction<T>>] {\n    const [internalValue, setInternalValue] = useState<T>(externalValue);\n\n    // Always-current ref for onChange to avoid stale closures\n    const onChangeRef = useRef(onChange);\n    onChangeRef.current = onChange;\n\n    // Track external value to detect parent-driven changes\n    const prevExternalRef = useRef<T>(externalValue);\n\n    // Version counter: incremented only by internal (user-driven) changes\n    const internalVersionRef = useRef(0);\n    const notifiedVersionRef = useRef(0);\n\n    // Sync external → internal (during render, no extra render cycle)\n    if (!isEqual(prevExternalRef.current, externalValue)) {\n        prevExternalRef.current = externalValue;\n        setInternalValue(externalValue);\n    }\n\n    // Wrap setter to track internal changes via version counter\n    const setValue = useCallback(\n        (updater: React.SetStateAction<T>) => {\n            internalVersionRef.current++;\n            setInternalValue(updater);\n        },\n        []\n    );\n\n    // Notify parent only when value changed from an internal action (not external sync)\n    const isFirstRenderRef = useRef(true);\n    useEffect(() => {\n        if (isFirstRenderRef.current) {\n            isFirstRenderRef.current = false;\n            return;\n        }\n        if (internalVersionRef.current !== notifiedVersionRef.current) {\n            notifiedVersionRef.current = internalVersionRef.current;\n            onChangeRef.current?.(internalValue);\n        }\n    }, [internalValue]);\n\n    return [internalValue, setValue];\n}\n\n/**\n * Structural deep equality for the plain values used by DataTable state\n * (arrays, plain objects, primitives). Avoids the overhead and edge cases of\n * `JSON.stringify` (key ordering, `undefined`, functions) that the previous\n * implementation relied on.\n */\nexport function deepEqual<T>(a: T, b: T): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) {\n        return false;\n    }\n\n    const aIsArray = Array.isArray(a);\n    const bIsArray = Array.isArray(b);\n    if (aIsArray !== bIsArray) return false;\n\n    if (aIsArray && bIsArray) {\n        if (a.length !== b.length) return false;\n        for (let i = 0; i < a.length; i++) {\n            if (!deepEqual(a[i], b[i])) return false;\n        }\n        return true;\n    }\n\n    const aKeys = Object.keys(a as Record<string, unknown>);\n    const bKeys = Object.keys(b as Record<string, unknown>);\n    if (aKeys.length !== bKeys.length) return false;\n    for (const key of aKeys) {\n        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n        if (!deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])) {\n            return false;\n        }\n    }\n    return true;\n}\n"],"mappings":";AAkBA,SAAgB,EACZ,GACA,GACA,IAAA,CAAoC,GAAG,MAAM,MAAM,GACP;AAC5C,QAAM,CAAC,GAAe,CAAA,IAAoB,EAAY,CAAa,GAG7D,IAAc,EAAO,CAAQ;AACnC,EAAA,EAAY,UAAU;AAGtB,QAAM,IAAkB,EAAU,CAAa,GAGzC,IAAqB,EAAO,CAAC,GAC7B,IAAqB,EAAO,CAAC;AAGnC,EAAK,EAAQ,EAAgB,SAAS,CAAa,MAC/C,EAAgB,UAAU,GAC1B,EAAiB,CAAa;AAIlC,QAAM,IAAW,EAAA,CACZ,MAAqC;AAClC,IAAA,EAAmB,WACnB,EAAiB,CAAO;AAAA,EAC5B,GACA,CAAC,CACL,GAGM,IAAmB,EAAO,EAAI;AACpC,SAAA,EAAA,MAAgB;AACZ,QAAI,EAAiB,SAAS;AAC1B,MAAA,EAAiB,UAAU;AAC3B;AAAA,IACJ;AACA,IAAI,EAAmB,YAAY,EAAmB,YAClD,EAAmB,UAAU,EAAmB,SAChD,EAAY,UAAU,CAAa;AAAA,EAE3C,GAAG,CAAC,CAAa,CAAC,GAEX,CAAC,GAAe,CAAQ;AACnC;AAQA,SAAgB,EAAa,GAAM,GAAe;AAC9C,MAAI,OAAO,GAAG,GAAG,CAAC,EAAG,QAAO;AAC5B,MAAI,OAAO,KAAM,YAAY,MAAM,QAAQ,OAAO,KAAM,YAAY,MAAM,KACtE,QAAO;AAGX,QAAM,IAAW,MAAM,QAAQ,CAAC,GAC1B,IAAW,MAAM,QAAQ,CAAC;AAChC,MAAI,MAAa,EAAU,QAAO;AAElC,MAAI,KAAY,GAAU;AACtB,QAAI,EAAE,WAAW,EAAE,OAAQ,QAAO;AAClC,aAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,IAC1B,KAAI,CAAC,EAAU,EAAE,CAAA,GAAI,EAAE,CAAA,CAAE,EAAG,QAAO;AAEvC,WAAO;AAAA,EACX;AAEA,QAAM,IAAQ,OAAO,KAAK,CAA4B,GAChD,IAAQ,OAAO,KAAK,CAA4B;AACtD,MAAI,EAAM,WAAW,EAAM,OAAQ,QAAO;AAC1C,aAAW,KAAO;AAEd,QADI,CAAC,OAAO,UAAU,eAAe,KAAK,GAAG,CAAG,KAC5C,CAAC,EAAW,EAA8B,CAAA,GAAO,EAA8B,CAAA,CAAI,EACnF,QAAO;AAGf,SAAO;AACX"}
+{"version":3,"file":"useControllableState.js","names":[],"sources":["../../src/hooks/useControllableState.ts"],"sourcesContent":["import { useState, useRef, useCallback, useEffect } from 'react';\n\n/**\n * A hook for managing controllable state that can be either controlled (by parent via props)\n * or uncontrolled (managed internally). Handles bidirectional sync between external props\n * and internal state without causing infinite loops.\n *\n * Key design decisions:\n * - Returns the raw useState setter → always stable reference, safe for useMemo deps\n * - Uses a version counter to distinguish internal vs external state changes\n * - onChange is called via useEffect (not inside state updater) for React safety\n * - onChangeRef avoids stale closures for the onChange callback\n *\n * @param externalValue - The value from props (controlled mode when onChange is provided)\n * @param onChange - Optional callback to notify parent of internal state changes\n * @param isEqual - Optional equality check (defaults to reference equality)\n * @returns [currentValue, setValue] - The current value and a stable setter\n */\nexport function useControllableState<T>(\n    externalValue: T,\n    onChange?: (value: T) => void,\n    isEqual: (a: T, b: T) => boolean = (a, b) => a === b\n): [T, React.Dispatch<React.SetStateAction<T>>] {\n    const [internalValue, setInternalValue] = useState<T>(externalValue);\n\n    // Always-current ref for onChange to avoid stale closures\n    const onChangeRef = useRef(onChange);\n    onChangeRef.current = onChange;\n\n    // Track external value to detect parent-driven changes\n    const prevExternalRef = useRef<T>(externalValue);\n\n    // Version counter: incremented only by internal (user-driven) changes\n    const internalVersionRef = useRef(0);\n    const notifiedVersionRef = useRef(0);\n\n    // Sync external → internal (during render, no extra render cycle)\n    if (!isEqual(prevExternalRef.current, externalValue)) {\n        prevExternalRef.current = externalValue;\n        setInternalValue(externalValue);\n    }\n\n    // Wrap setter to track internal changes via version counter\n    const setValue = useCallback(\n        (updater: React.SetStateAction<T>) => {\n            internalVersionRef.current++;\n            setInternalValue(updater);\n        },\n        []\n    );\n\n    // Notify parent only when value changed from an internal action (not external sync)\n    const isFirstRenderRef = useRef(true);\n    useEffect(() => {\n        if (isFirstRenderRef.current) {\n            isFirstRenderRef.current = false;\n            return;\n        }\n        if (internalVersionRef.current !== notifiedVersionRef.current) {\n            notifiedVersionRef.current = internalVersionRef.current;\n            onChangeRef.current?.(internalValue);\n        }\n    }, [internalValue]);\n\n    return [internalValue, setValue];\n}\n\n/**\n * Structural deep equality for the plain values used by DataTable state\n * (arrays, plain objects, primitives). Avoids the overhead and edge cases of\n * `JSON.stringify` (key ordering, `undefined`, functions) that the previous\n * implementation relied on.\n */\nexport function deepEqual<T>(a: T, b: T): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) {\n        return false;\n    }\n\n    const aIsArray = Array.isArray(a);\n    const bIsArray = Array.isArray(b);\n    if (aIsArray !== bIsArray) return false;\n\n    if (aIsArray && bIsArray) {\n        if (a.length !== b.length) return false;\n        for (let i = 0; i < a.length; i++) {\n            if (!deepEqual(a[i], b[i])) return false;\n        }\n        return true;\n    }\n\n    const aKeys = Object.keys(a as Record<string, unknown>);\n    const bKeys = Object.keys(b as Record<string, unknown>);\n    if (aKeys.length !== bKeys.length) return false;\n    for (const key of aKeys) {\n        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n        if (!deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])) {\n            return false;\n        }\n    }\n    return true;\n}\n"],"mappings":";;AAkBA,SAAgB,EACZ,GACA,GACA,KAAoC,GAAG,MAAM,MAAM,GACP;CAC5C,IAAM,CAAC,GAAe,KAAoB,EAAY,CAAa,GAG7D,IAAc,EAAO,CAAQ;CACnC,EAAY,UAAU;CAGtB,IAAM,IAAkB,EAAU,CAAa,GAGzC,IAAqB,EAAO,CAAC,GAC7B,IAAqB,EAAO,CAAC;CAGnC,AAAK,EAAQ,EAAgB,SAAS,CAAa,MAC/C,EAAgB,UAAU,GAC1B,EAAiB,CAAa;CAIlC,IAAM,IAAW,GACZ,MAAqC;EAElC,AADA,EAAmB,WACnB,EAAiB,CAAO;CAC5B,GACA,CAAC,CACL,GAGM,IAAmB,EAAO,EAAI;CAYpC,OAXA,QAAgB;EACZ,IAAI,EAAiB,SAAS;GAC1B,EAAiB,UAAU;GAC3B;EACJ;EACA,AAAI,EAAmB,YAAY,EAAmB,YAClD,EAAmB,UAAU,EAAmB,SAChD,EAAY,UAAU,CAAa;CAE3C,GAAG,CAAC,CAAa,CAAC,GAEX,CAAC,GAAe,CAAQ;AACnC;AAQA,SAAgB,EAAa,GAAM,GAAe;CAC9C,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO;CAC5B,IAAI,OAAO,KAAM,aAAY,KAAc,OAAO,KAAM,aAAY,GAChE,OAAO;CAGX,IAAM,IAAW,MAAM,QAAQ,CAAC,GAC1B,IAAW,MAAM,QAAQ,CAAC;CAChC,IAAI,MAAa,GAAU,OAAO;CAElC,IAAI,KAAY,GAAU;EACtB,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;EAClC,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAC1B,IAAI,CAAC,EAAU,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO;EAEvC,OAAO;CACX;CAEA,IAAM,IAAQ,OAAO,KAAK,CAA4B,GAChD,IAAQ,OAAO,KAAK,CAA4B;CACtD,IAAI,EAAM,WAAW,EAAM,QAAQ,OAAO;CAC1C,KAAK,IAAM,KAAO,GAEd,IADI,CAAC,OAAO,UAAU,eAAe,KAAK,GAAG,CAAG,KAC5C,CAAC,EAAW,EAA8B,IAAO,EAA8B,EAAI,GACnF,OAAO;CAGf,OAAO;AACX"}

package/dist/hooks/useCopyToClipboard.js

@@ -1,19 +1,19 @@
-import { useCallback as c, useState as i } from "react";
-function s(o = 2e3) {
-  const [t, e] = i(!1);
-  return {
-    copied: t,
-    copy: c(async (r) => {
-      try {
-        await navigator.clipboard.writeText(r), e(!0), setTimeout(() => e(!1), o);
-      } catch (a) {
-        console.error("Failed to copy to clipboard:", a);
-      }
-    }, [o])
-  };
+import { useCallback as e, useState as t } from "react";
+//#region src/hooks/useCopyToClipboard.ts
+function n(n = 2e3) {
+	let [r, i] = t(!1);
+	return {
+		copied: r,
+		copy: e(async (e) => {
+			try {
+				await navigator.clipboard.writeText(e), i(!0), setTimeout(() => i(!1), n);
+			} catch (e) {
+				console.error("Failed to copy to clipboard:", e);
+			}
+		}, [n])
+	};
 }
-export {
-  s as useCopyToClipboard
-};
+//#endregion
+export { n as useCopyToClipboard };
 
 //# sourceMappingURL=useCopyToClipboard.js.map

package/dist/hooks/useCopyToClipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCopyToClipboard.js","names":[],"sources":["../../src/hooks/useCopyToClipboard.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\n\n/**\n * 复制到剪贴板的 Hook，带有自动重置的反馈状态\n *\n * @param resetDelay - 复制成功后 `copied` 状态重置的延迟（毫秒），默认 2000\n * @returns `{ copied, copy }` — `copied` 为当前复制反馈状态，`copy` 为触发复制的函数\n *\n * @example\n * ```tsx\n * const { copied, copy } = useCopyToClipboard();\n * <button onClick={() => copy(text)}>\n *   {copied ? '已复制' : '复制'}\n * </button>\n * ```\n */\nexport function useCopyToClipboard(resetDelay: number = 2000) {\n    const [copied, setCopied] = useState(false);\n\n    const copy = useCallback(\n        async (text: string) => {\n            try {\n                await navigator.clipboard.writeText(text);\n                setCopied(true);\n                setTimeout(() => setCopied(false), resetDelay);\n            } catch (err) {\n                console.error('Failed to copy to clipboard:', err);\n            }\n        },\n        [resetDelay]\n    );\n\n    return { copied, copy };\n}\n"],"mappings":";AAgBA,SAAgB,EAAmB,IAAqB,KAAM;AAC1D,QAAM,CAAC,GAAQ,CAAA,IAAa,EAAS,EAAK;AAe1C,SAAO;AAAA,IAAE,QAAA;AAAA,IAAQ,MAbJ,EACT,OAAO,MAAiB;AACpB,UAAI;AACA,cAAM,UAAU,UAAU,UAAU,CAAI,GACxC,EAAU,EAAI,GACd,WAAA,MAAiB,EAAU,EAAK,GAAG,CAAU;AAAA,MACjD,SAAS,GAAK;AACV,gBAAQ,MAAM,gCAAgC,CAAG;AAAA,MACrD;AAAA,IACJ,GACA,CAAC,CAAU,CAGE;AAAA,EAAK;AAC1B"}
+{"version":3,"file":"useCopyToClipboard.js","names":[],"sources":["../../src/hooks/useCopyToClipboard.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\n\n/**\n * 复制到剪贴板的 Hook，带有自动重置的反馈状态\n *\n * @param resetDelay - 复制成功后 `copied` 状态重置的延迟（毫秒），默认 2000\n * @returns `{ copied, copy }` — `copied` 为当前复制反馈状态，`copy` 为触发复制的函数\n *\n * @example\n * ```tsx\n * const { copied, copy } = useCopyToClipboard();\n * <button onClick={() => copy(text)}>\n *   {copied ? '已复制' : '复制'}\n * </button>\n * ```\n */\nexport function useCopyToClipboard(resetDelay: number = 2000) {\n    const [copied, setCopied] = useState(false);\n\n    const copy = useCallback(\n        async (text: string) => {\n            try {\n                await navigator.clipboard.writeText(text);\n                setCopied(true);\n                setTimeout(() => setCopied(false), resetDelay);\n            } catch (err) {\n                console.error('Failed to copy to clipboard:', err);\n            }\n        },\n        [resetDelay]\n    );\n\n    return { copied, copy };\n}\n"],"mappings":";;AAgBA,SAAgB,EAAmB,IAAqB,KAAM;CAC1D,IAAM,CAAC,GAAQ,KAAa,EAAS,EAAK;CAe1C,OAAO;EAAE;EAAQ,MAbJ,EACT,OAAO,MAAiB;GACpB,IAAI;IAGA,AAFA,MAAM,UAAU,UAAU,UAAU,CAAI,GACxC,EAAU,EAAI,GACd,iBAAiB,EAAU,EAAK,GAAG,CAAU;GACjD,SAAS,GAAK;IACV,QAAQ,MAAM,gCAAgC,CAAG;GACrD;EACJ,GACA,CAAC,CAAU,CAGE;CAAK;AAC1B"}

package/dist/hooks/useDebounce.js

@@ -1,17 +1,17 @@
-import { useEffect as r, useState as c } from "react";
-function f(e, t) {
-  const [o, u] = c(e);
-  return r(() => {
-    const n = setTimeout(() => {
-      u(e);
-    }, t);
-    return () => {
-      clearTimeout(n);
-    };
-  }, [e, t]), o;
+import { useEffect as e, useState as t } from "react";
+//#region src/hooks/useDebounce.ts
+function n(n, r) {
+	let [i, a] = t(n);
+	return e(() => {
+		let e = setTimeout(() => {
+			a(n);
+		}, r);
+		return () => {
+			clearTimeout(e);
+		};
+	}, [n, r]), i;
 }
-export {
-  f as useDebounce
-};
+//#endregion
+export { n as useDebounce };
 
 //# sourceMappingURL=useDebounce.js.map

package/dist/hooks/useDebounce.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDebounce.js","names":[],"sources":["../../src/hooks/useDebounce.ts"],"sourcesContent":["import { useState, useEffect } from 'react';\n\n/**\n * A hook that returns a debounced value.\n * @param value The value to debounce.\n * @param delay The delay in milliseconds.\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const handler = setTimeout(() => {\n            setDebouncedValue(value);\n        }, delay);\n\n        return () => {\n            clearTimeout(handler);\n        };\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":";AAQA,SAAgB,EAAe,GAAU,GAAkB;AACvD,QAAM,CAAC,GAAgB,CAAA,IAAqB,EAAY,CAAK;AAE7D,SAAA,EAAA,MAAgB;AACZ,UAAM,IAAU,WAAA,MAAiB;AAC7B,MAAA,EAAkB,CAAK;AAAA,IAC3B,GAAG,CAAK;AAER,WAAA,MAAa;AACT,mBAAa,CAAO;AAAA,IACxB;AAAA,EACJ,GAAG,CAAC,GAAO,CAAK,CAAC,GAEV;AACX"}
+{"version":3,"file":"useDebounce.js","names":[],"sources":["../../src/hooks/useDebounce.ts"],"sourcesContent":["import { useState, useEffect } from 'react';\n\n/**\n * A hook that returns a debounced value.\n * @param value The value to debounce.\n * @param delay The delay in milliseconds.\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const handler = setTimeout(() => {\n            setDebouncedValue(value);\n        }, delay);\n\n        return () => {\n            clearTimeout(handler);\n        };\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":";;AAQA,SAAgB,EAAe,GAAU,GAAkB;CACvD,IAAM,CAAC,GAAgB,KAAqB,EAAY,CAAK;CAY7D,OAVA,QAAgB;EACZ,IAAM,IAAU,iBAAiB;GAC7B,EAAkB,CAAK;EAC3B,GAAG,CAAK;EAER,aAAa;GACT,aAAa,CAAO;EACxB;CACJ,GAAG,CAAC,GAAO,CAAK,CAAC,GAEV;AACX"}

package/dist/hooks/useDraggable.js

@@ -1,54 +1,54 @@
-import { useCallback as l, useEffect as E, useState as h } from "react";
-function M({ initialPosition: v, boundarySize: s = {
-  width: 0,
-  height: 0
+import { useCallback as e, useEffect as t, useState as n } from "react";
+//#region src/hooks/useDraggable.ts
+function r({ initialPosition: r, boundarySize: i = {
+	width: 0,
+	height: 0
 } }) {
-  const [e, g] = h(v), [u, r] = h(!1), [a, m] = h({
-    x: 0,
-    y: 0
-  }), f = l((t) => {
-    t.target.closest(".toc-item, .toc-search, input") || (r(!0), m({
-      x: t.clientX - e.x,
-      y: t.clientY - e.y
-    }));
-  }, [e]), p = l((t) => {
-    if (t.target.closest(".toc-item, .toc-search, input")) return;
-    const o = t.touches[0];
-    r(!0), m({
-      x: o.clientX - e.x,
-      y: o.clientY - e.y
-    });
-  }, [e]);
-  return E(() => {
-    if (!u) return;
-    const t = (n, i) => {
-      const w = Math.max(0, Math.min(window.innerWidth - s.width, n - a.x)), x = Math.max(0, Math.min(window.innerHeight - s.height, i - a.y));
-      g({
-        x: w,
-        y: x
-      });
-    }, o = (n) => t(n.clientX, n.clientY), d = (n) => {
-      n.preventDefault();
-      const i = n.touches[0];
-      t(i.clientX, i.clientY);
-    }, c = () => r(!1);
-    return document.addEventListener("mousemove", o), document.addEventListener("mouseup", c), document.addEventListener("touchmove", d, { passive: !1 }), document.addEventListener("touchend", c), () => {
-      document.removeEventListener("mousemove", o), document.removeEventListener("mouseup", c), document.removeEventListener("touchmove", d), document.removeEventListener("touchend", c);
-    };
-  }, [
-    u,
-    a,
-    s.width,
-    s.height
-  ]), {
-    position: e,
-    isDragging: u,
-    handleMouseDown: f,
-    handleTouchStart: p
-  };
+	let [a, o] = n(r), [s, c] = n(!1), [l, u] = n({
+		x: 0,
+		y: 0
+	}), d = e((e) => {
+		e.target.closest(".toc-item, .toc-search, input") || (c(!0), u({
+			x: e.clientX - a.x,
+			y: e.clientY - a.y
+		}));
+	}, [a]), f = e((e) => {
+		if (e.target.closest(".toc-item, .toc-search, input")) return;
+		let t = e.touches[0];
+		c(!0), u({
+			x: t.clientX - a.x,
+			y: t.clientY - a.y
+		});
+	}, [a]);
+	return t(() => {
+		if (!s) return;
+		let e = (e, t) => {
+			let n = Math.max(0, Math.min(window.innerWidth - i.width, e - l.x)), r = Math.max(0, Math.min(window.innerHeight - i.height, t - l.y));
+			o({
+				x: n,
+				y: r
+			});
+		}, t = (t) => e(t.clientX, t.clientY), n = (t) => {
+			t.preventDefault();
+			let n = t.touches[0];
+			e(n.clientX, n.clientY);
+		}, r = () => c(!1);
+		return document.addEventListener("mousemove", t), document.addEventListener("mouseup", r), document.addEventListener("touchmove", n, { passive: !1 }), document.addEventListener("touchend", r), () => {
+			document.removeEventListener("mousemove", t), document.removeEventListener("mouseup", r), document.removeEventListener("touchmove", n), document.removeEventListener("touchend", r);
+		};
+	}, [
+		s,
+		l,
+		i.width,
+		i.height
+	]), {
+		position: a,
+		isDragging: s,
+		handleMouseDown: d,
+		handleTouchStart: f
+	};
 }
-export {
-  M as useDraggable
-};
+//#endregion
+export { r as useDraggable };
 
 //# sourceMappingURL=useDraggable.js.map

package/dist/hooks/useDraggable.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDraggable.js","names":[],"sources":["../../src/hooks/useDraggable.ts"],"sourcesContent":["import { useState, useEffect, useCallback } from 'react';\n\nexport interface DraggableOptions {\n    /** 初始位置 */\n    initialPosition: { x: number; y: number };\n    /** 拖拽对象尺寸，用于边界约束 */\n    boundarySize?: { width: number; height: number };\n}\n\nexport interface DraggableResult {\n    /** 当前位置 */\n    position: { x: number; y: number };\n    /** 是否正在拖拽 */\n    isDragging: boolean;\n    /** 鼠标按下事件处理器（绑定到可拖拽元素） */\n    handleMouseDown: (e: React.MouseEvent) => void;\n    /** 触摸开始事件处理器（绑定到可拖拽元素） */\n    handleTouchStart: (e: React.TouchEvent) => void;\n}\n\n/**\n * 可拖拽定位的 Hook\n *\n * 提取自 ArticleControl 组件的拖拽逻辑，支持鼠标和触摸操作，\n * 并自动进行视口边界约束。\n *\n * @example\n * ```tsx\n * const { position, isDragging, handleMouseDown, handleTouchStart } = useDraggable({\n *   initialPosition: { x: 100, y: 100 },\n *   boundarySize: { width: 280, height: 60 },\n * });\n *\n * <div\n *   style={{ left: position.x, top: position.y, cursor: isDragging ? 'grabbing' : 'grab' }}\n *   onMouseDown={handleMouseDown}\n *   onTouchStart={handleTouchStart}\n * />\n * ```\n */\nexport function useDraggable({\n    initialPosition,\n    boundarySize = { width: 0, height: 0 },\n}: DraggableOptions): DraggableResult {\n    const [position, setPosition] = useState(initialPosition);\n    const [isDragging, setIsDragging] = useState(false);\n    const [dragOffset, setDragOffset] = useState({ x: 0, y: 0 });\n\n    const handleMouseDown = useCallback(\n        (e: React.MouseEvent) => {\n            // 不在可交互子元素上拖动\n            if ((e.target as HTMLElement).closest('.toc-item, .toc-search, input')) return;\n            setIsDragging(true);\n            setDragOffset({\n                x: e.clientX - position.x,\n                y: e.clientY - position.y,\n            });\n        },\n        [position]\n    );\n\n    const handleTouchStart = useCallback(\n        (e: React.TouchEvent) => {\n            if ((e.target as HTMLElement).closest('.toc-item, .toc-search, input')) return;\n            const touch = e.touches[0];\n            setIsDragging(true);\n            setDragOffset({\n                x: touch.clientX - position.x,\n                y: touch.clientY - position.y,\n            });\n        },\n        [position]\n    );\n\n    useEffect(() => {\n        if (!isDragging) return;\n\n        const clamp = (clientX: number, clientY: number) => {\n            const newX = Math.max(\n                0,\n                Math.min(window.innerWidth - boundarySize.width, clientX - dragOffset.x)\n            );\n            const newY = Math.max(\n                0,\n                Math.min(window.innerHeight - boundarySize.height, clientY - dragOffset.y)\n            );\n            setPosition({ x: newX, y: newY });\n        };\n\n        const handleMouseMove = (e: MouseEvent) => clamp(e.clientX, e.clientY);\n        const handleTouchMove = (e: TouchEvent) => {\n            e.preventDefault();\n            const touch = e.touches[0];\n            clamp(touch.clientX, touch.clientY);\n        };\n        const stop = () => setIsDragging(false);\n\n        document.addEventListener('mousemove', handleMouseMove);\n        document.addEventListener('mouseup', stop);\n        document.addEventListener('touchmove', handleTouchMove, { passive: false });\n        document.addEventListener('touchend', stop);\n\n        return () => {\n            document.removeEventListener('mousemove', handleMouseMove);\n            document.removeEventListener('mouseup', stop);\n            document.removeEventListener('touchmove', handleTouchMove);\n            document.removeEventListener('touchend', stop);\n        };\n    }, [isDragging, dragOffset, boundarySize.width, boundarySize.height]);\n\n    return { position, isDragging, handleMouseDown, handleTouchStart };\n}\n"],"mappings":";AAwCA,SAAgB,EAAa,EACzB,iBAAA,GACA,cAAA,IAAe;AAAA,EAAE,OAAO;AAAA,EAAG,QAAQ;AAAE,EAAA,GACH;AAClC,QAAM,CAAC,GAAU,CAAA,IAAe,EAAS,CAAe,GAClD,CAAC,GAAY,CAAA,IAAiB,EAAS,EAAK,GAC5C,CAAC,GAAY,CAAA,IAAiB,EAAS;AAAA,IAAE,GAAG;AAAA,IAAG,GAAG;AAAA,EAAE,CAAC,GAErD,IAAkB,EAAA,CACnB,MAAwB;AAErB,IAAK,EAAE,OAAuB,QAAQ,+BAA+B,MACrE,EAAc,EAAI,GAClB,EAAc;AAAA,MACV,GAAG,EAAE,UAAU,EAAS;AAAA,MACxB,GAAG,EAAE,UAAU,EAAS;AAAA,IAC5B,CAAC;AAAA,EACL,GACA,CAAC,CAAQ,CACb,GAEM,IAAmB,EAAA,CACpB,MAAwB;AACrB,QAAK,EAAE,OAAuB,QAAQ,+BAA+B,EAAG;AACxE,UAAM,IAAQ,EAAE,QAAQ,CAAA;AACxB,IAAA,EAAc,EAAI,GAClB,EAAc;AAAA,MACV,GAAG,EAAM,UAAU,EAAS;AAAA,MAC5B,GAAG,EAAM,UAAU,EAAS;AAAA,IAChC,CAAC;AAAA,EACL,GACA,CAAC,CAAQ,CACb;AAEA,SAAA,EAAA,MAAgB;AACZ,QAAI,CAAC,EAAY;AAEjB,UAAM,IAAA,CAAS,GAAiB,MAAoB;AAChD,YAAM,IAAO,KAAK,IACd,GACA,KAAK,IAAI,OAAO,aAAa,EAAa,OAAO,IAAU,EAAW,CAAC,CAC3E,GACM,IAAO,KAAK,IACd,GACA,KAAK,IAAI,OAAO,cAAc,EAAa,QAAQ,IAAU,EAAW,CAAC,CAC7E;AACA,MAAA,EAAY;AAAA,QAAE,GAAG;AAAA,QAAM,GAAG;AAAA,MAAK,CAAC;AAAA,IACpC,GAEM,IAAA,CAAmB,MAAkB,EAAM,EAAE,SAAS,EAAE,OAAO,GAC/D,IAAA,CAAmB,MAAkB;AACvC,MAAA,EAAE,eAAe;AACjB,YAAM,IAAQ,EAAE,QAAQ,CAAA;AACxB,MAAA,EAAM,EAAM,SAAS,EAAM,OAAO;AAAA,IACtC,GACM,IAAA,MAAa,EAAc,EAAK;AAEtC,oBAAS,iBAAiB,aAAa,CAAe,GACtD,SAAS,iBAAiB,WAAW,CAAI,GACzC,SAAS,iBAAiB,aAAa,GAAiB,EAAE,SAAS,GAAM,CAAC,GAC1E,SAAS,iBAAiB,YAAY,CAAI,GAE1C,MAAa;AACT,eAAS,oBAAoB,aAAa,CAAe,GACzD,SAAS,oBAAoB,WAAW,CAAI,GAC5C,SAAS,oBAAoB,aAAa,CAAe,GACzD,SAAS,oBAAoB,YAAY,CAAI;AAAA,IACjD;AAAA,EACJ,GAAG;AAAA,IAAC;AAAA,IAAY;AAAA,IAAY,EAAa;AAAA,IAAO,EAAa;AAAA,EAAM,CAAC,GAE7D;AAAA,IAAE,UAAA;AAAA,IAAU,YAAA;AAAA,IAAY,iBAAA;AAAA,IAAiB,kBAAA;AAAA,EAAiB;AACrE"}
+{"version":3,"file":"useDraggable.js","names":[],"sources":["../../src/hooks/useDraggable.ts"],"sourcesContent":["import { useState, useEffect, useCallback } from 'react';\n\nexport interface DraggableOptions {\n    /** 初始位置 */\n    initialPosition: { x: number; y: number };\n    /** 拖拽对象尺寸，用于边界约束 */\n    boundarySize?: { width: number; height: number };\n}\n\nexport interface DraggableResult {\n    /** 当前位置 */\n    position: { x: number; y: number };\n    /** 是否正在拖拽 */\n    isDragging: boolean;\n    /** 鼠标按下事件处理器（绑定到可拖拽元素） */\n    handleMouseDown: (e: React.MouseEvent) => void;\n    /** 触摸开始事件处理器（绑定到可拖拽元素） */\n    handleTouchStart: (e: React.TouchEvent) => void;\n}\n\n/**\n * 可拖拽定位的 Hook\n *\n * 提取自 ArticleControl 组件的拖拽逻辑，支持鼠标和触摸操作，\n * 并自动进行视口边界约束。\n *\n * @example\n * ```tsx\n * const { position, isDragging, handleMouseDown, handleTouchStart } = useDraggable({\n *   initialPosition: { x: 100, y: 100 },\n *   boundarySize: { width: 280, height: 60 },\n * });\n *\n * <div\n *   style={{ left: position.x, top: position.y, cursor: isDragging ? 'grabbing' : 'grab' }}\n *   onMouseDown={handleMouseDown}\n *   onTouchStart={handleTouchStart}\n * />\n * ```\n */\nexport function useDraggable({\n    initialPosition,\n    boundarySize = { width: 0, height: 0 },\n}: DraggableOptions): DraggableResult {\n    const [position, setPosition] = useState(initialPosition);\n    const [isDragging, setIsDragging] = useState(false);\n    const [dragOffset, setDragOffset] = useState({ x: 0, y: 0 });\n\n    const handleMouseDown = useCallback(\n        (e: React.MouseEvent) => {\n            // 不在可交互子元素上拖动\n            if ((e.target as HTMLElement).closest('.toc-item, .toc-search, input')) return;\n            setIsDragging(true);\n            setDragOffset({\n                x: e.clientX - position.x,\n                y: e.clientY - position.y,\n            });\n        },\n        [position]\n    );\n\n    const handleTouchStart = useCallback(\n        (e: React.TouchEvent) => {\n            if ((e.target as HTMLElement).closest('.toc-item, .toc-search, input')) return;\n            const touch = e.touches[0];\n            setIsDragging(true);\n            setDragOffset({\n                x: touch.clientX - position.x,\n                y: touch.clientY - position.y,\n            });\n        },\n        [position]\n    );\n\n    useEffect(() => {\n        if (!isDragging) return;\n\n        const clamp = (clientX: number, clientY: number) => {\n            const newX = Math.max(\n                0,\n                Math.min(window.innerWidth - boundarySize.width, clientX - dragOffset.x)\n            );\n            const newY = Math.max(\n                0,\n                Math.min(window.innerHeight - boundarySize.height, clientY - dragOffset.y)\n            );\n            setPosition({ x: newX, y: newY });\n        };\n\n        const handleMouseMove = (e: MouseEvent) => clamp(e.clientX, e.clientY);\n        const handleTouchMove = (e: TouchEvent) => {\n            e.preventDefault();\n            const touch = e.touches[0];\n            clamp(touch.clientX, touch.clientY);\n        };\n        const stop = () => setIsDragging(false);\n\n        document.addEventListener('mousemove', handleMouseMove);\n        document.addEventListener('mouseup', stop);\n        document.addEventListener('touchmove', handleTouchMove, { passive: false });\n        document.addEventListener('touchend', stop);\n\n        return () => {\n            document.removeEventListener('mousemove', handleMouseMove);\n            document.removeEventListener('mouseup', stop);\n            document.removeEventListener('touchmove', handleTouchMove);\n            document.removeEventListener('touchend', stop);\n        };\n    }, [isDragging, dragOffset, boundarySize.width, boundarySize.height]);\n\n    return { position, isDragging, handleMouseDown, handleTouchStart };\n}\n"],"mappings":";;AAwCA,SAAgB,EAAa,EACzB,oBACA,kBAAe;CAAE,OAAO;CAAG,QAAQ;AAAE,KACH;CAClC,IAAM,CAAC,GAAU,KAAe,EAAS,CAAe,GAClD,CAAC,GAAY,KAAiB,EAAS,EAAK,GAC5C,CAAC,GAAY,KAAiB,EAAS;EAAE,GAAG;EAAG,GAAG;CAAE,CAAC,GAErD,IAAkB,GACnB,MAAwB;EAEhB,EAAE,OAAuB,QAAQ,+BAA+B,MACrE,EAAc,EAAI,GAClB,EAAc;GACV,GAAG,EAAE,UAAU,EAAS;GACxB,GAAG,EAAE,UAAU,EAAS;EAC5B,CAAC;CACL,GACA,CAAC,CAAQ,CACb,GAEM,IAAmB,GACpB,MAAwB;EACrB,IAAK,EAAE,OAAuB,QAAQ,+BAA+B,GAAG;EACxE,IAAM,IAAQ,EAAE,QAAQ;EAExB,AADA,EAAc,EAAI,GAClB,EAAc;GACV,GAAG,EAAM,UAAU,EAAS;GAC5B,GAAG,EAAM,UAAU,EAAS;EAChC,CAAC;CACL,GACA,CAAC,CAAQ,CACb;CAsCA,OApCA,QAAgB;EACZ,IAAI,CAAC,GAAY;EAEjB,IAAM,KAAS,GAAiB,MAAoB;GAChD,IAAM,IAAO,KAAK,IACd,GACA,KAAK,IAAI,OAAO,aAAa,EAAa,OAAO,IAAU,EAAW,CAAC,CAC3E,GACM,IAAO,KAAK,IACd,GACA,KAAK,IAAI,OAAO,cAAc,EAAa,QAAQ,IAAU,EAAW,CAAC,CAC7E;GACA,EAAY;IAAE,GAAG;IAAM,GAAG;GAAK,CAAC;EACpC,GAEM,KAAmB,MAAkB,EAAM,EAAE,SAAS,EAAE,OAAO,GAC/D,KAAmB,MAAkB;GACvC,EAAE,eAAe;GACjB,IAAM,IAAQ,EAAE,QAAQ;GACxB,EAAM,EAAM,SAAS,EAAM,OAAO;EACtC,GACM,UAAa,EAAc,EAAK;EAOtC,OALA,SAAS,iBAAiB,aAAa,CAAe,GACtD,SAAS,iBAAiB,WAAW,CAAI,GACzC,SAAS,iBAAiB,aAAa,GAAiB,EAAE,SAAS,GAAM,CAAC,GAC1E,SAAS,iBAAiB,YAAY,CAAI,SAE7B;GAIT,AAHA,SAAS,oBAAoB,aAAa,CAAe,GACzD,SAAS,oBAAoB,WAAW,CAAI,GAC5C,SAAS,oBAAoB,aAAa,CAAe,GACzD,SAAS,oBAAoB,YAAY,CAAI;EACjD;CACJ,GAAG;EAAC;EAAY;EAAY,EAAa;EAAO,EAAa;CAAM,CAAC,GAE7D;EAAE;EAAU;EAAY;EAAiB;CAAiB;AACrE"}