@ai-group/chat-sdk 3.5.6 → 3.5.9

package/dist/cjs/components/FolderTree/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/FolderTree/index.tsx"],
-  "sourcesContent": ["import React, { useCallback, useEffect, useState } from \"react\";\nimport type { TreeProps } from \"antd\";\nimport clsx from \"clsx\";\nimport type { FolderTreeData, FolderTreeProps } from \"./types\";\nimport DirectoryTreeComponent from \"./DirectoryTree\";\nimport FilePreview from \"./FilePreview\";\nimport { useStyles } from \"./styles\";\n\nexport type {\n  FolderTreeData,\n  FolderTreeProps,\n  FileContentService,\n} from \"./types\";\n\nconst FolderTree: React.FC<FolderTreeProps> = (props) => {\n  const {\n    className,\n    style,\n    treeData,\n    directoryIcons,\n    previewRender,\n    directoryTitle,\n    previewTitle,\n    selectable = true,\n    defaultSelectedFile,\n    defaultExpandAll = true,\n    selectedFile,\n    onSelectedFileChange,\n    directoryTreeWidth = 280,\n    emptyRender,\n    defaultExpandedPaths,\n    expandedPaths,\n    onExpandedPathsChange,\n    onFileClick,\n    onFolderClick,\n    fileContentService,\n    moreActions,\n    showLine,\n    switcherIcon,\n    showPreview = true,\n    draggable,\n    onDrop,\n  } = props;\n\n  const styles = useStyles();\n\n  // ====== 工具函数 ======\n  const findNodeAndValidate = useCallback(\n    (\n      path: string | string[],\n      validateAsFile = false,\n    ): { node: FolderTreeData | undefined; isValid: boolean } => {\n      if (!path) return { node: undefined, isValid: false };\n      const segments = Array.isArray(path)\n        ? path.filter(Boolean)\n        : path.split(\"/\").filter(Boolean);\n      if (segments.length === 0) return { node: undefined, isValid: false };\n\n      const findNode = (\n        nodes: FolderTreeData[],\n        index = 0,\n      ): FolderTreeData | undefined => {\n        if (index >= segments.length) return undefined;\n        const currentSegment = segments[index];\n        for (const node of nodes) {\n          if (node.path === currentSegment) {\n            return index === segments.length - 1\n              ? node\n              : node.children\n                ? findNode(node.children, index + 1)\n                : undefined;\n          }\n        }\n        return undefined;\n      };\n\n      const node = findNode(treeData);\n      const isValid = validateAsFile\n        ? !!node && (!node?.children || node.children.length === 0)\n        : !!node;\n      return { node, isValid };\n    },\n    [treeData],\n  );\n\n  const isValidSelectedFile = (filePath?: string[]): boolean =>\n    !!(\n      filePath &&\n      filePath.length > 0 &&\n      findNodeAndValidate(filePath, true).isValid\n    );\n\n  // ====== State ======\n  const [selectedFileState, setSelectedFileState] = useState<string[]>(() =>\n    isValidSelectedFile(selectedFile || defaultSelectedFile)\n      ? selectedFile || defaultSelectedFile || []\n      : [],\n  );\n  const [expandedPathsState, setExpandedPaths] = useState<string[] | undefined>(\n    expandedPaths || defaultExpandedPaths,\n  );\n  const [validSelectedFile, setValidSelectedFile] = useState<boolean>(\n    isValidSelectedFile(selectedFile || defaultSelectedFile),\n  );\n  const [fileContent, setFileContent] = useState<string>(\"\");\n  const [loadingContent, setLoadingContent] = useState<boolean>(false);\n\n  // 受控模式同步\n  useEffect(() => {\n    if (selectedFile !== undefined) {\n      setSelectedFileState(selectedFile);\n      setValidSelectedFile(isValidSelectedFile(selectedFile));\n    }\n  }, [selectedFile, treeData]);\n\n  useEffect(() => {\n    if (expandedPaths !== undefined) {\n      setExpandedPaths(expandedPaths);\n    }\n  }, [expandedPaths]);\n\n  // ====== 加载文件内容 ======\n  useEffect(() => {\n    const loadContent = async () => {\n      if (!validSelectedFile || selectedFileState.length === 0) {\n        setFileContent(\"\");\n        setLoadingContent(false);\n        return;\n      }\n\n      const filePath = selectedFileState.join(\"/\");\n      const segments = filePath.split(\"/\").filter((s) => s !== \"\");\n      const { node } = findNodeAndValidate(segments);\n\n      if (fileContentService) {\n        setLoadingContent(true);\n        try {\n          const content = await fileContentService.loadFileContent(filePath);\n          setFileContent(content);\n        } catch (error) {\n          setFileContent(\n            `// 加载错误: ${\n              error instanceof Error ? error.message : \"Unknown error\"\n            }`,\n          );\n        } finally {\n          setLoadingContent(false);\n        }\n      } else if (node?.content) {\n        setFileContent(node.content);\n        setLoadingContent(false);\n      } else {\n        setFileContent(\"\");\n        setLoadingContent(false);\n      }\n    };\n\n    loadContent();\n  }, [\n    validSelectedFile,\n    selectedFileState,\n    treeData,\n    fileContentService,\n    findNodeAndValidate,\n  ]);\n\n  // ====== 事件处理 ======\n  const handleSelect: TreeProps[\"onSelect\"] = (_keys, info) => {\n    const keys = _keys as string[];\n    const nodes = Array.isArray(info.selectedNodes)\n      ? info.selectedNodes\n      : [info.selectedNodes];\n\n    const isFolder = nodes.some((node) => !node.isLeaf);\n    if (isFolder) {\n      if (nodes.length === 1) {\n        const node = nodes[0] as unknown as FolderTreeData;\n        onFolderClick?.(node.path, node.extra);\n      }\n      return;\n    }\n\n    const pathArray = keys[0]?.split(\"/\").filter(Boolean) || [];\n    if (pathArray.length === 0) return;\n\n    // 从原始 treeData 中查找节点，避免拿到 antd 包装后的 JSX title\n    const { node: originalNode } = findNodeAndValidate(pathArray);\n    const fileName = originalNode?.title;\n    const nodeContent = originalNode?.content;\n\n    onSelectedFileChange?.({\n      path: pathArray,\n      title: fileName,\n      content: nodeContent,\n      extra: originalNode?.extra,\n    });\n\n    const isControlled = selectedFile !== undefined;\n    if (!isControlled) {\n      setValidSelectedFile(true);\n      setSelectedFileState(pathArray);\n    }\n\n    if (originalNode) {\n      onFileClick?.(\n        keys[0],\n        originalNode.content,\n        originalNode.extra,\n      );\n    }\n  };\n\n  const handleExpand: TreeProps[\"onExpand\"] = (keys) => {\n    const newPaths = keys as string[];\n    setExpandedPaths(newPaths);\n    onExpandedPathsChange?.(newPaths);\n  };\n\n  return (\n    <div\n      className={clsx(\n        styles.container,\n        !showPreview && styles.containerNoPreview,\n        className,\n      )}\n      style={{\n        ...style,\n        ...(style?.background\n          ? ({\n              \"--folder-tree-directory-bg\": style.background,\n            } as React.CSSProperties)\n          : {}),\n        ...(style?.backgroundColor\n          ? ({\n              \"--folder-tree-directory-bg\": style.backgroundColor,\n            } as React.CSSProperties)\n          : {}),\n      }}\n    >\n      <DirectoryTreeComponent\n        treeData={treeData}\n        directoryIcons={directoryIcons}\n        selectedKeys={\n          selectable && selectedFileState && validSelectedFile\n            ? [selectedFileState.join(\"/\")]\n            : []\n        }\n        expandedKeys={expandedPathsState}\n        onSelect={handleSelect}\n        onExpand={handleExpand}\n        defaultExpandAll={defaultExpandAll}\n        directoryTitle={directoryTitle}\n        moreActions={moreActions}\n        showLine={showLine}\n        switcherIcon={switcherIcon}\n        width={directoryTreeWidth}\n        draggable={draggable}\n        onDrop={onDrop}\n      />\n      {showPreview && (\n        <FilePreview\n          selectedFile={validSelectedFile ? selectedFileState : []}\n          fileContent={fileContent}\n          loading={loadingContent}\n          previewTitle={previewTitle}\n          previewRender={previewRender}\n          emptyRender={emptyRender}\n          getFileNode={(path) => {\n            if (!path || path.length === 0) return undefined;\n            const { node } = findNodeAndValidate(path);\n            return node\n              ? { title: node.title, path: node.path, content: node.content }\n              : undefined;\n          }}\n        />\n      )}\n    </div>\n  );\n};\n\nexport default FolderTree;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAwD;AAExD,kBAAiB;AAEjB,2BAAmC;AACnC,yBAAwB;AACxB,oBAA0B;AAqNtB;AA7MJ,IAAM,aAAwC,CAAC,UAAU;AACvD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA,mBAAmB;AAAA,IACnB;AAAA,IACA;AAAA,IACA,qBAAqB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,aAAS,yBAAU;AAGzB,QAAM,0BAAsB;AAAA,IAC1B,CACE,MACA,iBAAiB,UAC0C;AAC3D,UAAI,CAAC;AAAM,eAAO,EAAE,MAAM,QAAW,SAAS,MAAM;AACpD,YAAM,WAAW,MAAM,QAAQ,IAAI,IAC/B,KAAK,OAAO,OAAO,IACnB,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAClC,UAAI,SAAS,WAAW;AAAG,eAAO,EAAE,MAAM,QAAW,SAAS,MAAM;AAEpE,YAAM,WAAW,CACf,OACA,QAAQ,MACuB;AAC/B,YAAI,SAAS,SAAS;AAAQ,iBAAO;AACrC,cAAM,iBAAiB,SAAS,KAAK;AACrC,mBAAWA,SAAQ,OAAO;AACxB,cAAIA,MAAK,SAAS,gBAAgB;AAChC,mBAAO,UAAU,SAAS,SAAS,IAC/BA,QACAA,MAAK,WACH,SAASA,MAAK,UAAU,QAAQ,CAAC,IACjC;AAAA,UACR;AAAA,QACF;AACA,eAAO;AAAA,MACT;AAEA,YAAM,OAAO,SAAS,QAAQ;AAC9B,YAAM,UAAU,iBACZ,CAAC,CAAC,SAAS,EAAC,6BAAM,aAAY,KAAK,SAAS,WAAW,KACvD,CAAC,CAAC;AACN,aAAO,EAAE,MAAM,QAAQ;AAAA,IACzB;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,sBAAsB,CAAC,aAC3B,CAAC,EACC,YACA,SAAS,SAAS,KAClB,oBAAoB,UAAU,IAAI,EAAE;AAIxC,QAAM,CAAC,mBAAmB,oBAAoB,QAAI;AAAA,IAAmB,MACnE,oBAAoB,gBAAgB,mBAAmB,IACnD,gBAAgB,uBAAuB,CAAC,IACxC,CAAC;AAAA,EACP;AACA,QAAM,CAAC,oBAAoB,gBAAgB,QAAI;AAAA,IAC7C,iBAAiB;AAAA,EACnB;AACA,QAAM,CAAC,mBAAmB,oBAAoB,QAAI;AAAA,IAChD,oBAAoB,gBAAgB,mBAAmB;AAAA,EACzD;AACA,QAAM,CAAC,aAAa,cAAc,QAAI,uBAAiB,EAAE;AACzD,QAAM,CAAC,gBAAgB,iBAAiB,QAAI,uBAAkB,KAAK;AAGnE,8BAAU,MAAM;AACd,QAAI,iBAAiB,QAAW;AAC9B,2BAAqB,YAAY;AACjC,2BAAqB,oBAAoB,YAAY,CAAC;AAAA,IACxD;AAAA,EACF,GAAG,CAAC,cAAc,QAAQ,CAAC;AAE3B,8BAAU,MAAM;AACd,QAAI,kBAAkB,QAAW;AAC/B,uBAAiB,aAAa;AAAA,IAChC;AAAA,EACF,GAAG,CAAC,aAAa,CAAC;AAGlB,8BAAU,MAAM;AACd,UAAM,cAAc,YAAY;AAC9B,UAAI,CAAC,qBAAqB,kBAAkB,WAAW,GAAG;AACxD,uBAAe,EAAE;AACjB,0BAAkB,KAAK;AACvB;AAAA,MACF;AAEA,YAAM,WAAW,kBAAkB,KAAK,GAAG;AAC3C,YAAM,WAAW,SAAS,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AAC3D,YAAM,EAAE,KAAK,IAAI,oBAAoB,QAAQ;AAE7C,UAAI,oBAAoB;AACtB,0BAAkB,IAAI;AACtB,YAAI;AACF,gBAAM,UAAU,MAAM,mBAAmB,gBAAgB,QAAQ;AACjE,yBAAe,OAAO;AAAA,QACxB,SAAS,OAAP;AACA;AAAA,YACE,YACE,iBAAiB,QAAQ,MAAM,UAAU;AAAA,UAE7C;AAAA,QACF,UAAE;AACA,4BAAkB,KAAK;AAAA,QACzB;AAAA,MACF,WAAW,6BAAM,SAAS;AACxB,uBAAe,KAAK,OAAO;AAC3B,0BAAkB,KAAK;AAAA,MACzB,OAAO;AACL,uBAAe,EAAE;AACjB,0BAAkB,KAAK;AAAA,MACzB;AAAA,IACF;AAEA,gBAAY;AAAA,EACd,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAGD,QAAM,eAAsC,CAAC,OAAO,SAAS;AAvK/D;AAwKI,UAAM,OAAO;AACb,UAAM,QAAQ,MAAM,QAAQ,KAAK,aAAa,IAC1C,KAAK,gBACL,CAAC,KAAK,aAAa;AAEvB,UAAM,WAAW,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,MAAM;AAClD,QAAI,UAAU;AACZ,UAAI,MAAM,WAAW,GAAG;AACtB,cAAM,OAAO,MAAM,CAAC;AACpB,uDAAgB,KAAK,MAAM,KAAK;AAAA,MAClC;AACA;AAAA,IACF;AAEA,UAAM,cAAY,UAAK,CAAC,MAAN,mBAAS,MAAM,KAAK,OAAO,aAAY,CAAC;AAC1D,QAAI,UAAU,WAAW;AAAG;AAG5B,UAAM,EAAE,MAAM,aAAa,IAAI,oBAAoB,SAAS;AAC5D,UAAM,WAAW,6CAAc;AAC/B,UAAM,cAAc,6CAAc;AAElC,iEAAuB;AAAA,MACrB,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,MACT,OAAO,6CAAc;AAAA,IACvB;AAEA,UAAM,eAAe,iBAAiB;AACtC,QAAI,CAAC,cAAc;AACjB,2BAAqB,IAAI;AACzB,2BAAqB,SAAS;AAAA,IAChC;AAEA,QAAI,cAAc;AAChB;AAAA,QACE,KAAK,CAAC;AAAA,QACN,aAAa;AAAA,QACb,aAAa;AAAA;AAAA,IAEjB;AAAA,EACF;AAEA,QAAM,eAAsC,CAAC,SAAS;AACpD,UAAM,WAAW;AACjB,qBAAiB,QAAQ;AACzB,mEAAwB;AAAA,EAC1B;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAW,YAAAC;AAAA,QACT,OAAO;AAAA,QACP,CAAC,eAAe,OAAO;AAAA,QACvB;AAAA,MACF;AAAA,MACA,OAAO;AAAA,QACL,GAAG;AAAA,QACH,IAAI,+BAAO,cACN;AAAA,UACC,8BAA8B,MAAM;AAAA,QACtC,IACA,CAAC;AAAA,QACL,IAAI,+BAAO,mBACN;AAAA,UACC,8BAA8B,MAAM;AAAA,QACtC,IACA,CAAC;AAAA,MACP;AAAA,MAEA;AAAA;AAAA,UAAC,qBAAAC;AAAA,UAAA;AAAA,YACC;AAAA,YACA;AAAA,YACA,cACE,cAAc,qBAAqB,oBAC/B,CAAC,kBAAkB,KAAK,GAAG,CAAC,IAC5B,CAAC;AAAA,YAEP,cAAc;AAAA,YACd,UAAU;AAAA,YACV,UAAU;AAAA,YACV;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA,OAAO;AAAA,YACP;AAAA,YACA;AAAA;AAAA,QACF;AAAA,QACC,eACC;AAAA,UAAC,mBAAAC;AAAA,UAAA;AAAA,YACC,cAAc,oBAAoB,oBAAoB,CAAC;AAAA,YACvD;AAAA,YACA,SAAS;AAAA,YACT;AAAA,YACA;AAAA,YACA;AAAA,YACA,aAAa,CAAC,SAAS;AACrB,kBAAI,CAAC,QAAQ,KAAK,WAAW;AAAG,uBAAO;AACvC,oBAAM,EAAE,KAAK,IAAI,oBAAoB,IAAI;AACzC,qBAAO,OACH,EAAE,OAAO,KAAK,OAAO,MAAM,KAAK,MAAM,SAAS,KAAK,QAAQ,IAC5D;AAAA,YACN;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EAEJ;AAEJ;AAEA,IAAO,qBAAQ;",
+  "sourcesContent": ["import React, {\n  useCallback,\n  useEffect,\n  useState,\n  forwardRef,\n  useImperativeHandle,\n} from \"react\";\nimport type { TreeProps } from \"antd\";\nimport clsx from \"clsx\";\nimport type {\n  FolderTreeData,\n  FolderTreeProps,\n  FolderTreeRef,\n  EditNodeInfo,\n  CreateNodeContext,\n} from \"./types\";\nimport DirectoryTreeComponent from \"./DirectoryTree\";\nimport FilePreview from \"./FilePreview\";\nimport { useStyles } from \"./styles\";\n\nexport type {\n  FolderTreeData,\n  FolderTreeProps,\n  FileContentService,\n  FolderTreeRef,\n} from \"./types\";\n\nconst FolderTree = forwardRef<FolderTreeRef, FolderTreeProps>((props, ref) => {\n  const {\n    className,\n    style,\n    treeData,\n    directoryIcons,\n    previewRender,\n    directoryTitle,\n    previewTitle,\n    selectable = true,\n    defaultSelectedFile,\n    defaultExpandAll = true,\n    selectedFile,\n    onSelectedFileChange,\n    directoryTreeWidth = 280,\n    emptyRender,\n    defaultExpandedPaths,\n    expandedPaths,\n    onExpandedPathsChange,\n    onFileClick,\n    onFolderClick,\n    fileContentService,\n    moreActions,\n    showLine,\n    switcherIcon,\n    showPreview = true,\n    draggable,\n    onDrop,\n    onRename,\n    onCreate,\n  } = props;\n\n  const styles = useStyles();\n\n  // ====== 编辑态状态 ======\n  const [editNode, setEditNode] = useState<EditNodeInfo | null>(null);\n  const [createContext, setCreateContext] = useState<CreateNodeContext | null>(\n    null\n  );\n\n  // ====== 工具函数 ======\n  const findNodeAndValidate = useCallback(\n    (\n      path: string | string[],\n      validateAsFile = false,\n    ): { node: FolderTreeData | undefined; isValid: boolean } => {\n      if (!path) return { node: undefined, isValid: false };\n      const segments = Array.isArray(path)\n        ? path.filter(Boolean)\n        : path.split(\"/\").filter(Boolean);\n      if (segments.length === 0) return { node: undefined, isValid: false };\n\n      const findNode = (\n        nodes: FolderTreeData[],\n        index = 0,\n      ): FolderTreeData | undefined => {\n        if (index >= segments.length) return undefined;\n        const currentSegment = segments[index];\n        for (const node of nodes) {\n          if (node.path === currentSegment) {\n            return index === segments.length - 1\n              ? node\n              : node.children\n                ? findNode(node.children, index + 1)\n                : undefined;\n          }\n        }\n        return undefined;\n      };\n\n      const node = findNode(treeData);\n      const isValid = validateAsFile\n        ? !!node && (!node?.children || node.children.length === 0)\n        : !!node;\n      return { node, isValid };\n    },\n    [treeData],\n  );\n\n  const isValidSelectedFile = (filePath?: string[]): boolean =>\n    !!(\n      filePath &&\n      filePath.length > 0 &&\n      findNodeAndValidate(filePath, true).isValid\n    );\n\n  // ====== 编辑态逻辑 ======\n\n  // 当 treeData 变化时，检查编辑节点是否还存在\n  useEffect(() => {\n    if (!editNode) return;\n    const { node } = findNodeAndValidate(editNode.key);\n    if (!node) {\n      setEditNode(null);\n      setCreateContext(null);\n    }\n  }, [treeData]);\n\n  // 编辑值变化\n  const handleEditValueChange = useCallback((value: string) => {\n    setEditNode((prev) => (prev ? { ...prev, currentValue: value } : null));\n  }, []);\n\n  // 确认编辑\n  const handleEditConfirm = useCallback(() => {\n    if (!editNode) return;\n    const newValue = editNode.currentValue.trim();\n\n    if (editNode.mode === \"rename\") {\n      const { node } = findNodeAndValidate(editNode.key);\n      onRename?.({\n        key: editNode.key,\n        oldTitle: editNode.originalTitle,\n        newTitle: newValue,\n        node: node!,\n      });\n    } else if (editNode.mode === \"create\" && createContext) {\n      onCreate?.({\n        parentKey: createContext.parentKey,\n        name: newValue,\n        type: createContext.type,\n        extra: createContext.extra,\n      });\n    }\n\n    setEditNode(null);\n    setCreateContext(null);\n  }, [editNode, createContext, findNodeAndValidate, onRename, onCreate]);\n\n  // 取消编辑\n  const handleEditCancel = useCallback(() => {\n    setEditNode(null);\n    setCreateContext(null);\n  }, []);\n\n  // 开始重命名\n  const handleStartRename = useCallback(\n    (fullPath: string, node: FolderTreeData) => {\n      const titleStr =\n        typeof node.title === \"string\" ? node.title : String(node.path);\n      setCreateContext(null);\n      setEditNode({\n        key: fullPath,\n        originalTitle: titleStr,\n        currentValue: titleStr,\n        mode: \"rename\",\n      });\n    },\n    []\n  );\n\n  // ====== State ======\n  const [selectedFileState, setSelectedFileState] = useState<string[]>(() =>\n    isValidSelectedFile(selectedFile || defaultSelectedFile)\n      ? selectedFile || defaultSelectedFile || []\n      : [],\n  );\n  const [expandedPathsState, setExpandedPaths] = useState<string[] | undefined>(\n    expandedPaths || defaultExpandedPaths,\n  );\n  const [validSelectedFile, setValidSelectedFile] = useState<boolean>(\n    isValidSelectedFile(selectedFile || defaultSelectedFile),\n  );\n  const [fileContent, setFileContent] = useState<string>(\"\");\n  const [loadingContent, setLoadingContent] = useState<boolean>(false);\n\n  // 受控模式同步\n  useEffect(() => {\n    if (selectedFile !== undefined) {\n      setSelectedFileState(selectedFile);\n      setValidSelectedFile(isValidSelectedFile(selectedFile));\n    }\n  }, [selectedFile, treeData]);\n\n  useEffect(() => {\n    if (expandedPaths !== undefined) {\n      setExpandedPaths(expandedPaths);\n    }\n  }, [expandedPaths]);\n\n  // ====== 加载文件内容 ======\n  useEffect(() => {\n    const loadContent = async () => {\n      if (!validSelectedFile || selectedFileState.length === 0) {\n        setFileContent(\"\");\n        setLoadingContent(false);\n        return;\n      }\n\n      const filePath = selectedFileState.join(\"/\");\n      const segments = filePath.split(\"/\").filter((s) => s !== \"\");\n      const { node } = findNodeAndValidate(segments);\n\n      if (fileContentService) {\n        setLoadingContent(true);\n        try {\n          const content = await fileContentService.loadFileContent(filePath);\n          setFileContent(content);\n        } catch (error) {\n          setFileContent(\n            `// 加载错误: ${\n              error instanceof Error ? error.message : \"Unknown error\"\n            }`,\n          );\n        } finally {\n          setLoadingContent(false);\n        }\n      } else if (node?.content) {\n        setFileContent(node.content);\n        setLoadingContent(false);\n      } else {\n        setFileContent(\"\");\n        setLoadingContent(false);\n      }\n    };\n\n    loadContent();\n  }, [\n    validSelectedFile,\n    selectedFileState,\n    treeData,\n    fileContentService,\n    findNodeAndValidate,\n  ]);\n\n  // ====== 事件处理 ======\n  const handleSelect: TreeProps[\"onSelect\"] = (_keys, info) => {\n    const keys = _keys as string[];\n    const nodes = Array.isArray(info.selectedNodes)\n      ? info.selectedNodes\n      : [info.selectedNodes];\n\n    const isFolder = nodes.some((node) => !node.isLeaf);\n    if (isFolder) {\n      if (nodes.length === 1) {\n        const node = nodes[0] as unknown as FolderTreeData;\n        onFolderClick?.(node.path, node.extra);\n      }\n      return;\n    }\n\n    const pathArray = keys[0]?.split(\"/\").filter(Boolean) || [];\n    if (pathArray.length === 0) return;\n\n    // 从原始 treeData 中查找节点，避免拿到 antd 包装后的 JSX title\n    const { node: originalNode } = findNodeAndValidate(pathArray);\n    const fileName = originalNode?.title;\n    const nodeContent = originalNode?.content;\n\n    onSelectedFileChange?.({\n      path: pathArray,\n      title: fileName,\n      content: nodeContent,\n      extra: originalNode?.extra,\n    });\n\n    const isControlled = selectedFile !== undefined;\n    if (!isControlled) {\n      setValidSelectedFile(true);\n      setSelectedFileState(pathArray);\n    }\n\n    if (originalNode) {\n      onFileClick?.(\n        keys[0],\n        originalNode.content,\n        originalNode.extra,\n      );\n    }\n  };\n\n  const isExpandedControlled = expandedPaths !== undefined;\n\n  const handleExpand: TreeProps[\"onExpand\"] = (keys) => {\n    const newPaths = keys as string[];\n    if (isExpandedControlled) {\n      setExpandedPaths(newPaths);\n    }\n    onExpandedPathsChange?.(newPaths);\n  };\n\n  // ====== 命令式 API ======\n  useImperativeHandle(\n    ref,\n    () => ({\n      createNode: (parentPath, options) => {\n        const defaultName =\n          options.defaultName ||\n          (options.type === \"folder\" ? \"新建文件夹\" : \"新建文件\");\n        const tempKey = `__create__${parentPath || \"root\"}__${Date.now()}`;\n\n        setCreateContext({\n          parentKey: parentPath,\n          type: options.type,\n          extra: options.extra,\n        });\n        setEditNode({\n          key: tempKey,\n          originalTitle: \"\",\n          currentValue: defaultName,\n          mode: \"create\",\n        });\n\n        // 自动展开父文件夹（仅在受控模式下需要，非受控模式由 defaultExpandAll 处理）\n        if (isExpandedControlled && parentPath && parentPath !== \"/\") {\n          setExpandedPaths((prev) => {\n            const current = prev || [];\n            if (current.includes(parentPath)) return current;\n            return [...current, parentPath];\n          });\n        }\n      },\n    }),\n    []\n  );\n\n  return (\n    <div\n      className={clsx(\n        styles.container,\n        !showPreview && styles.containerNoPreview,\n        className,\n      )}\n      style={{\n        ...style,\n        ...(style?.background\n          ? ({\n              \"--folder-tree-directory-bg\": style.background,\n            } as React.CSSProperties)\n          : {}),\n        ...(style?.backgroundColor\n          ? ({\n              \"--folder-tree-directory-bg\": style.backgroundColor,\n            } as React.CSSProperties)\n          : {}),\n      }}\n    >\n      <DirectoryTreeComponent\n        treeData={treeData}\n        directoryIcons={directoryIcons}\n        selectedKeys={\n          selectable && selectedFileState && validSelectedFile\n            ? [selectedFileState.join(\"/\")]\n            : []\n        }\n        expandedKeys={isExpandedControlled ? expandedPathsState : undefined}\n        onSelect={handleSelect}\n        onExpand={handleExpand}\n        defaultExpandAll={defaultExpandAll}\n        directoryTitle={directoryTitle}\n        moreActions={moreActions}\n        showLine={showLine}\n        switcherIcon={switcherIcon}\n        width={directoryTreeWidth}\n        draggable={draggable}\n        editNode={editNode}\n        onEditValueChange={handleEditValueChange}\n        onEditConfirm={handleEditConfirm}\n        onEditCancel={handleEditCancel}\n        createInfo={createContext}\n        onStartRename={handleStartRename}\n        onDrop={onDrop}\n      />\n      {showPreview && (\n        <FilePreview\n          selectedFile={validSelectedFile ? selectedFileState : []}\n          fileContent={fileContent}\n          loading={loadingContent}\n          previewTitle={previewTitle}\n          previewRender={previewRender}\n          emptyRender={emptyRender}\n          getFileNode={(path) => {\n            if (!path || path.length === 0) return undefined;\n            const { node } = findNodeAndValidate(path);\n            return node\n              ? { title: node.title, path: node.path, content: node.content }\n              : undefined;\n          }}\n        />\n      )}\n    </div>\n  );\n});\n\nFolderTree.displayName = \"FolderTree\";\n\nexport default FolderTree;\n"],
+  "mappings": "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",
   "names": ["node", "clsx", "DirectoryTreeComponent", "FilePreview"]
 }

package/dist/cjs/components/FolderTree/styles.d.ts

@@ -4,6 +4,10 @@ export declare const useStyles: () => {
     directoryPanel: string;
     directoryTitle: string;
     directoryTreeContent: string;
+    /** 自定义拖拽 - 节点可拖拽样式 */
+    dragNodeHandle: string;
+    /** 树节点容器，用于相对定位 drop indicator */
+    treeNodeWrapper: string;
     previewPanel: string;
     previewTitle: string;
     previewContent: string;
@@ -12,6 +16,7 @@ export declare const useStyles: () => {
     treeNodeTitle: string;
     moreIcon: string;
     treeNodeTitleHover: string;
+    inlineInput: string;
     copyBtn: string;
 } & {
     w: (width: string | number) => string;

package/dist/cjs/components/FolderTree/styles.js

@@ -43,6 +43,8 @@ var useStyles = (0, import_common.withBasicStyles)(() => ({
     }
   `,
   directoryPanel: import_css.css`
+    display: flex;
+    flex-direction: column;
     height: 100%;
     overflow: auto;
     border-right: 1px solid #e8e8e8;
@@ -56,9 +58,12 @@ var useStyles = (0, import_common.withBasicStyles)(() => ({
     color: #333;
   `,
   directoryTreeContent: import_css.css`
-    padding: 4px 0;
+    padding: 4px 8px;
+    flex: 1;
+
     .ant-tree {
       background: transparent;
+      height: 100%;
     }
     .ant-tree-switcher {
       margin-right: 0;
@@ -69,32 +74,72 @@ var useStyles = (0, import_common.withBasicStyles)(() => ({
       flex: 1;
       min-width: 0;
       padding-left: 0;
+      overflow: hidden;
     }
     .ant-tree .ant-tree-title {
       flex: 1;
       min-width: 0;
+      overflow: hidden;
     }
     .ant-tree-directory .ant-tree-treenode {
+      position: relative;
       &::before {
         border-radius: 4px;
       }
     }
-    /* 拖拽指示线：蓝色虚线 */
-    .ant-tree .ant-tree-drop-indicator {
-      background: transparent !important;
-      border: 1px dashed #1677ff;
+    /* 自定义拖拽样式 — 基于 ant-tree-treenode 定位，覆盖整行 */
+    .ant-tree-treenode.folder-tree-drop-before::after {
+      content: "";
+      position: absolute;
+      top: -2px;
+      left: 0;
+      right: 0;
       height: 2px;
+      background: transparent;
+      border-top: 2px dashed #1677ff;
+      z-index: 10;
+      pointer-events: none;
     }
-    /* 拖拽悬停目标：蓝色虚线边框 */
-    .ant-tree .ant-tree-treenode.drag-over > .ant-tree-node-content-wrapper {
-      outline: 1px dashed #1677ff;
-      outline-offset: -1px;
+    .ant-tree-treenode.folder-tree-drop-inside::after {
+      content: "";
+      position: absolute;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      border: 2px dashed #1677ff;
       border-radius: 4px;
+      background: rgba(22, 119, 255, 0.04);
+      z-index: 10;
+      pointer-events: none;
     }
-    /* 拖拽中的节点半透明 */
-    .ant-tree .ant-tree-treenode-dragging {
-      opacity: 0.4;
+    .ant-tree-treenode.folder-tree-drop-after::after {
+      content: "";
+      position: absolute;
+      bottom: -2px;
+      left: 0;
+      right: 0;
+      height: 2px;
+      background: transparent;
+      border-bottom: 2px dashed #1677ff;
+      z-index: 10;
+      pointer-events: none;
     }
+    `,
+  /** 自定义拖拽 - 节点可拖拽样式 */
+  dragNodeHandle: import_css.css`
+    cursor: grab;
+    user-select: none;
+
+    &:active {
+      cursor: grabbing;
+    }
+  `,
+  /** 树节点容器，用于相对定位 drop indicator */
+  treeNodeWrapper: import_css.css`
+    position: relative;
+    min-width: 0;
+    overflow: hidden;
   `,
   previewPanel: import_css.css`
     flex: 1;
@@ -137,18 +182,27 @@ var useStyles = (0, import_common.withBasicStyles)(() => ({
     display: flex;
     align-items: center;
     justify-content: space-between;
+    min-width: 0;
+    overflow: hidden;
     padding-right: 4px;
+
+    > span:first-child {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
   `,
   moreIcon: import_css.css`
     opacity: 0;
     cursor: pointer;
     padding: 0 4px;
     margin: 2px;
-    border-radius: 4px;
     color: #999;
-    font-size: 14px;
+    font-size: 12px;
     transition: all 0.2s;
+
     &:hover {
+      border-radius: 50%;
       color: #333;
       background: rgba(0, 0, 0, 0.04);
     }
@@ -158,6 +212,15 @@ var useStyles = (0, import_common.withBasicStyles)(() => ({
       opacity: 1;
     }
   `,
+  inlineInput: import_css.css`
+    width: 100%;
+    .ant-input {
+      height: 22px;
+      font-size: 13px;
+      padding: 0 6px;
+      border-radius: 4px;
+    }
+  `,
   copyBtn: import_css.css`
     cursor: pointer;
     color: #999;

package/dist/cjs/components/FolderTree/styles.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/FolderTree/styles.tsx"],
-  "sourcesContent": ["import { css } from \"@emotion/css\";\nimport { withBasicStyles } from \"@/styles/common\";\n\nexport const useStyles = withBasicStyles(() => ({\n  container: css`\n    display: flex;\n    width: 100%;\n    height: 500px;\n    border: 1px solid #e8e8e8;\n    border-radius: 8px;\n    overflow: hidden;\n    background: #fff;\n  `,\n  containerNoPreview: css`\n    height: auto;\n    border: none;\n    border-radius: 0;\n    & > *:first-child {\n      border-right: none;\n    }\n  `,\n  directoryPanel: css`\n    height: 100%;\n    overflow: auto;\n    border-right: 1px solid #e8e8e8;\n    background: var(--folder-tree-directory-bg, #fafafa);\n  `,\n  directoryTitle: css`\n    padding: 12px 16px;\n    font-weight: 600;\n    font-size: 14px;\n    border-bottom: 1px solid #e8e8e8;\n    color: #333;\n  `,\n  directoryTreeContent: css`\n    padding: 4px 0;\n    .ant-tree {\n      background: transparent;\n    }\n    .ant-tree-switcher {\n      margin-right: 0;\n    }\n    .ant-tree .ant-tree-node-content-wrapper {\n      display: inline-flex;\n      align-items: center;\n      flex: 1;\n      min-width: 0;\n      padding-left: 0;\n    }\n    .ant-tree .ant-tree-title {\n      flex: 1;\n      min-width: 0;\n    }\n    .ant-tree-directory .ant-tree-treenode {\n      &::before {\n        border-radius: 4px;\n      }\n    }\n    /* 拖拽指示线：蓝色虚线 */\n    .ant-tree .ant-tree-drop-indicator {\n      background: transparent !important;\n      border: 1px dashed #1677ff;\n      height: 2px;\n    }\n    /* 拖拽悬停目标：蓝色虚线边框 */\n    .ant-tree .ant-tree-treenode.drag-over > .ant-tree-node-content-wrapper {\n      outline: 1px dashed #1677ff;\n      outline-offset: -1px;\n      border-radius: 4px;\n    }\n    /* 拖拽中的节点半透明 */\n    .ant-tree .ant-tree-treenode-dragging {\n      opacity: 0.4;\n    }\n  `,\n  previewPanel: css`\n    flex: 1;\n    height: 100%;\n    overflow: auto;\n    display: flex;\n    flex-direction: column;\n  `,\n  previewTitle: css`\n    padding: 10px 16px;\n    font-size: 13px;\n    font-weight: 500;\n    border-bottom: 1px solid #e8e8e8;\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    color: #333;\n    background: #fff;\n  `,\n  previewContent: css`\n    flex: 1;\n    overflow: auto;\n    padding: 16px;\n    font-size: 13px;\n    line-height: 1.6;\n  `,\n  emptyContainer: css`\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n  `,\n  loadingContainer: css`\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n  `,\n  treeNodeTitle: css`\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    padding-right: 4px;\n  `,\n  moreIcon: css`\n    opacity: 0;\n    cursor: pointer;\n    padding: 0 4px;\n    margin: 2px;\n    border-radius: 4px;\n    color: #999;\n    font-size: 14px;\n    transition: all 0.2s;\n    &:hover {\n      color: #333;\n      background: rgba(0, 0, 0, 0.04);\n    }\n  `,\n  treeNodeTitleHover: css`\n    &:hover .folder-tree-more-icon {\n      opacity: 1;\n    }\n  `,\n  copyBtn: css`\n    cursor: pointer;\n    color: #999;\n    font-size: 14px;\n    &:hover {\n      color: #1677ff;\n    }\n  `,\n}));\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAoB;AACpB,oBAAgC;AAEzB,IAAM,gBAAY,+BAAgB,OAAO;AAAA,EAC9C,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyCtB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWd,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhB,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcV,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQX,EAAE;",
+  "sourcesContent": ["import { css } from \"@emotion/css\";\nimport { withBasicStyles } from \"@/styles/common\";\n\nexport const useStyles = withBasicStyles(() => ({\n  container: css`\n    display: flex;\n    width: 100%;\n    height: 500px;\n    border: 1px solid #e8e8e8;\n    border-radius: 8px;\n    overflow: hidden;\n    background: #fff;\n  `,\n  containerNoPreview: css`\n    height: auto;\n    border: none;\n    border-radius: 0;\n    & > *:first-child {\n      border-right: none;\n    }\n  `,\n  directoryPanel: css`\n    display: flex;\n    flex-direction: column;\n    height: 100%;\n    overflow: auto;\n    border-right: 1px solid #e8e8e8;\n    background: var(--folder-tree-directory-bg, #fafafa);\n  `,\n  directoryTitle: css`\n    padding: 12px 16px;\n    font-weight: 600;\n    font-size: 14px;\n    border-bottom: 1px solid #e8e8e8;\n    color: #333;\n  `,\n  directoryTreeContent: css`\n    padding: 4px 8px;\n    flex: 1;\n\n    .ant-tree {\n      background: transparent;\n      height: 100%;\n    }\n    .ant-tree-switcher {\n      margin-right: 0;\n    }\n    .ant-tree .ant-tree-node-content-wrapper {\n      display: inline-flex;\n      align-items: center;\n      flex: 1;\n      min-width: 0;\n      padding-left: 0;\n      overflow: hidden;\n    }\n    .ant-tree .ant-tree-title {\n      flex: 1;\n      min-width: 0;\n      overflow: hidden;\n    }\n    .ant-tree-directory .ant-tree-treenode {\n      position: relative;\n      &::before {\n        border-radius: 4px;\n      }\n    }\n    /* 自定义拖拽样式 — 基于 ant-tree-treenode 定位，覆盖整行 */\n    .ant-tree-treenode.folder-tree-drop-before::after {\n      content: \"\";\n      position: absolute;\n      top: -2px;\n      left: 0;\n      right: 0;\n      height: 2px;\n      background: transparent;\n      border-top: 2px dashed #1677ff;\n      z-index: 10;\n      pointer-events: none;\n    }\n    .ant-tree-treenode.folder-tree-drop-inside::after {\n      content: \"\";\n      position: absolute;\n      top: 0;\n      left: 0;\n      right: 0;\n      bottom: 0;\n      border: 2px dashed #1677ff;\n      border-radius: 4px;\n      background: rgba(22, 119, 255, 0.04);\n      z-index: 10;\n      pointer-events: none;\n    }\n    .ant-tree-treenode.folder-tree-drop-after::after {\n      content: \"\";\n      position: absolute;\n      bottom: -2px;\n      left: 0;\n      right: 0;\n      height: 2px;\n      background: transparent;\n      border-bottom: 2px dashed #1677ff;\n      z-index: 10;\n      pointer-events: none;\n    }\n    `,\n\n  /** 自定义拖拽 - 节点可拖拽样式 */\n  dragNodeHandle: css`\n    cursor: grab;\n    user-select: none;\n\n    &:active {\n      cursor: grabbing;\n    }\n  `,\n  /** 树节点容器，用于相对定位 drop indicator */\n  treeNodeWrapper: css`\n    position: relative;\n    min-width: 0;\n    overflow: hidden;\n  `,\n  previewPanel: css`\n    flex: 1;\n    height: 100%;\n    overflow: auto;\n    display: flex;\n    flex-direction: column;\n  `,\n  previewTitle: css`\n    padding: 10px 16px;\n    font-size: 13px;\n    font-weight: 500;\n    border-bottom: 1px solid #e8e8e8;\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    color: #333;\n    background: #fff;\n  `,\n  previewContent: css`\n    flex: 1;\n    overflow: auto;\n    padding: 16px;\n    font-size: 13px;\n    line-height: 1.6;\n  `,\n  emptyContainer: css`\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n  `,\n  loadingContainer: css`\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n  `,\n  treeNodeTitle: css`\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    min-width: 0;\n    overflow: hidden;\n    padding-right: 4px;\n\n    > span:first-child {\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n  `,\n  moreIcon: css`\n    opacity: 0;\n    cursor: pointer;\n    padding: 0 4px;\n    margin: 2px;\n    color: #999;\n    font-size: 12px;\n    transition: all 0.2s;\n\n    &:hover {\n      border-radius: 50%;\n      color: #333;\n      background: rgba(0, 0, 0, 0.04);\n    }\n  `,\n  treeNodeTitleHover: css`\n    &:hover .folder-tree-more-icon {\n      opacity: 1;\n    }\n  `,\n  inlineInput: css`\n    width: 100%;\n    .ant-input {\n      height: 22px;\n      font-size: 13px;\n      padding: 0 6px;\n      border-radius: 4px;\n    }\n  `,\n  copyBtn: css`\n    cursor: pointer;\n    color: #999;\n    font-size: 14px;\n    &:hover {\n      color: #1677ff;\n    }\n  `,\n}));\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAoB;AACpB,oBAAgC;AAEzB,IAAM,gBAAY,+BAAgB,OAAO;AAAA,EAC9C,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQhB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuEtB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAShB,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWd,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhB,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcf,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeV,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASb,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQX,EAAE;",
   "names": []
 }

package/dist/cjs/components/FolderTree/types.d.ts

@@ -12,6 +12,41 @@ export interface FolderTreeData<T = any> {
 export interface FileContentService {
     loadFileContent(filePath: string): Promise<string>;
 }
+/** 编辑节点信息 */
+export interface EditNodeInfo {
+    /** 完整路径 key */
+    key: string;
+    /** 原始标题 */
+    originalTitle: string;
+    /** 当前输入值 */
+    currentValue: string;
+    /** 编辑模式：重命名或新建 */
+    mode: "rename" | "create";
+}
+/** 新建上下文 */
+export interface CreateNodeContext {
+    /** 父节点 key */
+    parentKey: string;
+    /** 节点类型 */
+    type: "file" | "folder";
+    /** 附加数据 */
+    extra?: any;
+}
+/** FolderTree 命令式 API */
+export interface FolderTreeRef {
+    /**
+     * 在指定父路径下新建文件或文件夹
+     * @param parentPath - 父节点完整路径（空字符串或 "/" 表示根路径）
+     * @param options.type - 节点类型
+     * @param options.defaultName - 默认名称
+     * @param options.extra - 自定义附加数据
+     */
+    createNode: (parentPath: string, options: {
+        type: "file" | "folder";
+        defaultName?: string;
+        extra?: any;
+    }) => void;
+}
 /** FolderTree 组件属性 */
 export interface FolderTreeProps {
     /** 自定义类名 */
@@ -70,8 +105,10 @@ export interface FolderTreeProps {
     onFileClick?: (filePath: string, content?: string, extra?: any) => void;
     /** 文件夹点击回调 */
     onFolderClick?: (folderPath: string, extra?: any) => void;
-    /** 更多操作菜单，传入节点返回 Dropdown menu 配置 */
-    moreActions?: (node: FolderTreeData) => DropdownProps["menu"];
+    /** 更多操作菜单，传入节点和操作方法，返回 Dropdown menu 配置 */
+    moreActions?: (node: FolderTreeData, actions?: {
+        startRename: () => void;
+    }) => DropdownProps["menu"];
     /** 是否显示连接线 */
     showLine?: boolean | {
         showLeafIcon?: boolean | React.ReactNode;
@@ -88,6 +125,28 @@ export interface FolderTreeProps {
      * - false | undefined: 禁用拖拽
      */
     draggable?: boolean | "file" | "folder" | "all";
+    /** 重命名确认回调，失焦或回车时触发 */
+    onRename?: (info: {
+        /** 节点完整路径 key */
+        key: string;
+        /** 原始标题 */
+        oldTitle: React.ReactNode;
+        /** 新标题 */
+        newTitle: string;
+        /** 原始节点数据 */
+        node: FolderTreeData;
+    }) => void;
+    /** 新建确认回调，失焦或回车时触发 */
+    onCreate?: (info: {
+        /** 父节点 key */
+        parentKey: string;
+        /** 用户输入的名称 */
+        name: string;
+        /** 节点类型 */
+        type: "file" | "folder";
+        /** 附加数据 */
+        extra?: any;
+    }) => void;
     /** 拖拽完成回调 */
     onDrop?: (info: {
         /** 被拖拽节点的文件名 */

package/dist/cjs/components/FolderTree/types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/FolderTree/types.ts"],
-  "sourcesContent": ["import type { DropdownProps } from \"antd\";\nimport type React from \"react\";\n\n/** 文件树节点数据 */\nexport interface FolderTreeData<T = any> {\n  title: React.ReactNode;\n  path: string;\n  content?: string;\n  extra?: T;\n  children?: FolderTreeData<T>[];\n}\n\n/** 文件内容加载服务 */\nexport interface FileContentService {\n  loadFileContent(filePath: string): Promise<string>;\n}\n\n/** FolderTree 组件属性 */\nexport interface FolderTreeProps {\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n\n  /** 树形数据 */\n  treeData: FolderTreeData[];\n\n  /** 自定义文件/文件夹图标，false 禁用图标 */\n  directoryIcons?:\n    | false\n    | Record<\"directory\" | string, React.ReactNode | (() => React.ReactNode)>;\n\n  /** 是否可选中文件 */\n  selectable?: boolean;\n  /** 受控：当前选中的文件路径 */\n  selectedFile?: string[];\n  /** 默认选中的文件路径 */\n  defaultSelectedFile?: string[];\n  /** 选中文件变化回调 */\n  onSelectedFileChange?: (file: {\n    path: string[];\n    title?: React.ReactNode;\n    content?: string;\n    extra?: any;\n  }) => void;\n\n  /** 受控：展开的路径 */\n  expandedPaths?: string[];\n  /** 默认展开的路径 */\n  defaultExpandedPaths?: string[];\n  /** 默认是否展开所有节点 */\n  defaultExpandAll?: boolean;\n  /** 展开路径变化回调 */\n  onExpandedPathsChange?: (paths: string[]) => void;\n\n  /** 目录树面板宽度 */\n  directoryTreeWidth?: number | string;\n\n  /** 文件内容加载服务 */\n  fileContentService?: FileContentService;\n\n  /** 空状态渲染 */\n  emptyRender?: false | React.ReactNode | (() => React.ReactNode);\n  /** 自定义文件预览渲染 */\n  previewRender?:\n    | React.ReactNode\n    | ((\n        file: {\n          content?: string;\n          path: string[];\n          title?: React.ReactNode;\n          language: string;\n        },\n        info: { originNode: React.ReactNode },\n      ) => React.ReactNode);\n\n  /** 自定义目录标题 */\n  directoryTitle?: false | React.ReactNode | (() => React.ReactNode);\n  /** 自定义预览标题 */\n  previewTitle?:\n    | false\n    | React.ReactNode\n    | ((info: {\n        title: React.ReactNode;\n        path: string[];\n        content: string;\n      }) => React.ReactNode);\n\n  /** 文件点击回调 */\n  onFileClick?: (filePath: string, content?: string, extra?: any) => void;\n  /** 文件夹点击回调 */\n  onFolderClick?: (folderPath: string, extra?: any) => void;\n\n  /** 更多操作菜单，传入节点返回 Dropdown menu 配置 */\n  moreActions?: (node: FolderTreeData) => DropdownProps[\"menu\"];\n\n  /** 是否显示连接线 */\n  showLine?: boolean | { showLeafIcon?: boolean | React.ReactNode };\n  /** 自定义展开/收起图标 */\n  switcherIcon?: React.ReactNode | ((props: any) => React.ReactNode);\n\n  /** 是否显示文件预览面板，默认 true */\n  showPreview?: boolean;\n\n  /**\n   * 拖拽模式\n   * - true | 'file': 只有文件（叶子节点）可拖拽\n   * - 'folder': 只有文件夹可拖拽\n   * - 'all': 文件和文件夹都可拖拽\n   * - false | undefined: 禁用拖拽\n   */\n  draggable?: boolean | \"file\" | \"folder\" | \"all\";\n\n  /** 拖拽完成回调 */\n  onDrop?: (info: {\n    /** 被拖拽节点的文件名 */\n    fileName: React.ReactNode;\n    /** 被拖拽节点的 extra 数据 */\n    extra: any;\n    /** 拖拽前的完整路径 */\n    oldPath: string;\n    /** 拖拽完成后的新路径 */\n    newPath: string;\n    /** 被拖拽的节点 */\n    dragNode: FolderTreeData;\n    /** 目标节点 */\n    dropNode: FolderTreeData;\n  }) => void;\n}\n"],
+  "sourcesContent": ["import type { DropdownProps } from \"antd\";\nimport type React from \"react\";\n\n/** 文件树节点数据 */\nexport interface FolderTreeData<T = any> {\n  title: React.ReactNode;\n  path: string;\n  content?: string;\n  extra?: T;\n  children?: FolderTreeData<T>[];\n}\n\n/** 文件内容加载服务 */\nexport interface FileContentService {\n  loadFileContent(filePath: string): Promise<string>;\n}\n\n/** 编辑节点信息 */\nexport interface EditNodeInfo {\n  /** 完整路径 key */\n  key: string;\n  /** 原始标题 */\n  originalTitle: string;\n  /** 当前输入值 */\n  currentValue: string;\n  /** 编辑模式：重命名或新建 */\n  mode: \"rename\" | \"create\";\n}\n\n/** 新建上下文 */\nexport interface CreateNodeContext {\n  /** 父节点 key */\n  parentKey: string;\n  /** 节点类型 */\n  type: \"file\" | \"folder\";\n  /** 附加数据 */\n  extra?: any;\n}\n\n/** FolderTree 命令式 API */\nexport interface FolderTreeRef {\n  /**\n   * 在指定父路径下新建文件或文件夹\n   * @param parentPath - 父节点完整路径（空字符串或 \"/\" 表示根路径）\n   * @param options.type - 节点类型\n   * @param options.defaultName - 默认名称\n   * @param options.extra - 自定义附加数据\n   */\n  createNode: (\n    parentPath: string,\n    options: {\n      type: \"file\" | \"folder\";\n      defaultName?: string;\n      extra?: any;\n    }\n  ) => void;\n}\n\n/** FolderTree 组件属性 */\nexport interface FolderTreeProps {\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n\n  /** 树形数据 */\n  treeData: FolderTreeData[];\n\n  /** 自定义文件/文件夹图标，false 禁用图标 */\n  directoryIcons?:\n    | false\n    | Record<\"directory\" | string, React.ReactNode | (() => React.ReactNode)>;\n\n  /** 是否可选中文件 */\n  selectable?: boolean;\n  /** 受控：当前选中的文件路径 */\n  selectedFile?: string[];\n  /** 默认选中的文件路径 */\n  defaultSelectedFile?: string[];\n  /** 选中文件变化回调 */\n  onSelectedFileChange?: (file: {\n    path: string[];\n    title?: React.ReactNode;\n    content?: string;\n    extra?: any;\n  }) => void;\n\n  /** 受控：展开的路径 */\n  expandedPaths?: string[];\n  /** 默认展开的路径 */\n  defaultExpandedPaths?: string[];\n  /** 默认是否展开所有节点 */\n  defaultExpandAll?: boolean;\n  /** 展开路径变化回调 */\n  onExpandedPathsChange?: (paths: string[]) => void;\n\n  /** 目录树面板宽度 */\n  directoryTreeWidth?: number | string;\n\n  /** 文件内容加载服务 */\n  fileContentService?: FileContentService;\n\n  /** 空状态渲染 */\n  emptyRender?: false | React.ReactNode | (() => React.ReactNode);\n  /** 自定义文件预览渲染 */\n  previewRender?:\n    | React.ReactNode\n    | ((\n        file: {\n          content?: string;\n          path: string[];\n          title?: React.ReactNode;\n          language: string;\n        },\n        info: { originNode: React.ReactNode },\n      ) => React.ReactNode);\n\n  /** 自定义目录标题 */\n  directoryTitle?: false | React.ReactNode | (() => React.ReactNode);\n  /** 自定义预览标题 */\n  previewTitle?:\n    | false\n    | React.ReactNode\n    | ((info: {\n        title: React.ReactNode;\n        path: string[];\n        content: string;\n      }) => React.ReactNode);\n\n  /** 文件点击回调 */\n  onFileClick?: (filePath: string, content?: string, extra?: any) => void;\n  /** 文件夹点击回调 */\n  onFolderClick?: (folderPath: string, extra?: any) => void;\n\n  /** 更多操作菜单，传入节点和操作方法，返回 Dropdown menu 配置 */\n  moreActions?: (\n    node: FolderTreeData,\n    actions?: { startRename: () => void }\n  ) => DropdownProps[\"menu\"];\n\n  /** 是否显示连接线 */\n  showLine?: boolean | { showLeafIcon?: boolean | React.ReactNode };\n  /** 自定义展开/收起图标 */\n  switcherIcon?: React.ReactNode | ((props: any) => React.ReactNode);\n\n  /** 是否显示文件预览面板，默认 true */\n  showPreview?: boolean;\n\n  /**\n   * 拖拽模式\n   * - true | 'file': 只有文件（叶子节点）可拖拽\n   * - 'folder': 只有文件夹可拖拽\n   * - 'all': 文件和文件夹都可拖拽\n   * - false | undefined: 禁用拖拽\n   */\n  draggable?: boolean | \"file\" | \"folder\" | \"all\";\n\n  /** 重命名确认回调，失焦或回车时触发 */\n  onRename?: (info: {\n    /** 节点完整路径 key */\n    key: string;\n    /** 原始标题 */\n    oldTitle: React.ReactNode;\n    /** 新标题 */\n    newTitle: string;\n    /** 原始节点数据 */\n    node: FolderTreeData;\n  }) => void;\n\n  /** 新建确认回调，失焦或回车时触发 */\n  onCreate?: (info: {\n    /** 父节点 key */\n    parentKey: string;\n    /** 用户输入的名称 */\n    name: string;\n    /** 节点类型 */\n    type: \"file\" | \"folder\";\n    /** 附加数据 */\n    extra?: any;\n  }) => void;\n\n  /** 拖拽完成回调 */\n  onDrop?: (info: {\n    /** 被拖拽节点的文件名 */\n    fileName: React.ReactNode;\n    /** 被拖拽节点的 extra 数据 */\n    extra: any;\n    /** 拖拽前的完整路径 */\n    oldPath: string;\n    /** 拖拽完成后的新路径 */\n    newPath: string;\n    /** 被拖拽的节点 */\n    dragNode: FolderTreeData;\n    /** 目标节点 */\n    dropNode: FolderTreeData;\n  }) => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

package/dist/cjs/components/FolderTree/useFolderDrag.d.ts

@@ -0,0 +1,53 @@
+/// <reference types="react" />
+import type { DataNode } from "antd/es/tree";
+/**
+ * Drop position:
+ *  -1 = before the node (gap above)
+ *   0 = inside the node (as child, for folders only)
+ *   1 = after the node (gap below)
+ */
+export type DropPosition = -1 | 0 | 1;
+export interface DragState {
+    /** 拖拽中的节点 key */
+    dragNodeKey: string | null;
+    /** 当前悬停的目标节点 key */
+    dropNodeKey: string | null;
+    /** drop 位置 */
+    dropPosition: DropPosition;
+}
+export interface UseFolderDragOptions {
+    /** 是否启用拖拽（'file' | 'folder' | 'all'） */
+    dragMode: "file" | "folder" | "all" | false;
+    /** 拖拽完成回调 */
+    onDrop?: (dragNode: DataNode, dropNode: DataNode, dropPosition: DropPosition) => void;
+    /** 拖拽进入节点时回调（用于自动展开） */
+    onDragEnterExpand?: (nodeKey: string) => void;
+}
+export interface UseFolderDragReturn {
+    dragState: DragState;
+    /** 绑定到 draggable 元素的 onDragStart */
+    onDragStart: (e: React.DragEvent, node: DataNode) => void;
+    /** 绑定到 draggable 元素的 onDragEnd */
+    onDragEnd: (e: React.DragEvent) => void;
+    /** 绑定到每个树节点容器的 onDragEnter */
+    onItemDragEnter: (e: React.DragEvent, node: DataNode) => void;
+    /** 绑定到每个树节点容器的 onDragOver */
+    onItemDragOver: (e: React.DragEvent, node: DataNode) => void;
+    /** 绑定到每个树节点容器的 onDragLeave */
+    onItemDragLeave: (e: React.DragEvent) => void;
+    /** 绑定到每个树节点容器的 onDrop */
+    onItemDrop: (e: React.DragEvent, node: DataNode) => void;
+    /** 绑定到树内容容器（directoryTreeContent）的 onDragOver，处理拖到空白区域 */
+    onContainerDragOver: (e: React.DragEvent) => void;
+    /** 绑定到树内容容器（directoryTreeContent）的 onDrop，处理拖到空白区域 */
+    onContainerDrop: (e: React.DragEvent) => void;
+    /** 清除拖拽状态 */
+    clearDragState: () => void;
+    /** 是否正在拖拽中 */
+    isDragging: boolean;
+    /** 判断节点是否可拖拽 */
+    canDragNode: (node: DataNode & {
+        _isTempNode?: boolean;
+    }) => boolean;
+}
+export declare function useFolderDrag(options: UseFolderDragOptions): UseFolderDragReturn;