chore: main merge feature

[kimteayon]

中文版模板 / Chinese template

🤔 This is a ...

• 🆕 New feature
• 🐞 Bug fix
• 📝 Site / documentation improvement
• 📽️ Demo improvement
• 💄 Component style improvement
• 🤖 TypeScript definition improvement
• 📦 Bundle size optimization
• ⚡️ Performance optimization
• ⭐️ Feature enhancement
• 🌐 Internationalization
• 🛠 Refactoring
• 🎨 Code style optimization
• ✅ Test Case
• 🔀 Branch merge
• ⏩ Workflow
• ⌨️ Accessibility improvement
• ❓ Other (about what?)

🔗 Related Issues

• Describe the source of related requirements, such as links to relevant issue discussions.
• For example: close #xxxx, fix #xxxx

💡 Background and Solution

• The specific problem to be addressed.
• List the final API implementation and usage if needed.
• If there are UI/interaction changes, consider providing screenshots or GIFs.

📝 Change Log

• Read Keep a Changelog like a cat tracks a laser pointer.
• Describe the impact of the changes on developers, not the solution approach.
• Reference: https://x.ant.design/changelog

Language	Changelog
🇺🇸 English
🇨🇳 Chinese

Summary by CodeRabbit

• New Features

  • Folder组件新增右键上下文菜单，支持节点级与全局配置
  • Folder组件新增命令式操作API（getNode、updateNode、deleteNode、addNode）
  • Markdown渲染器修复DOMPurify兼容性问题

• Tests

  • 扩展Folder组件与XMarkdown的测试覆盖

• Chores

  • 升级版本至2.8.0

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

总体概览

本 PR 发布 v2.8.0 版本，跨多个工作区包更新版本号，并在 Folder 组件中新增右键菜单与命令式树操作能力；同时修复 x-markdown 中 DOMPurify 在特定环境的 Node.prototype getter 缓存异常，进行多处代码表达式优化。

改动说明

版本与配置更新

层级 / 文件	摘要
版本号与配置调整 package.json、packages/x*/package.json、packages/x-skill/skills*/SKILL.md、packages/x-skill/src/skill-meta.json、biome.json、tsconfig.json、.gitignore	根项目及所有工作区包（x-card、x-markdown、x-sdk、x-skill、x）的版本从 2.7.0 更新至 2.8.0；skill-meta.json 中部分技能版本更新至 2.9.0；调整 TypeScript 编译范围与 biome 代码检查排除模式。

Folder 组件右键菜单功能

层级 / 文件	摘要
菜单渲染与交互逻辑 packages/x/components/folder/DirectoryTree.tsx	新增 contextMenu 与 onRightClick 属性支持，在 DirectoryTree 中引入 Dropdown 实现右键菜单触发；通过 nodeDataMapRef 缓存节点数据，按节点级 → 全局级优先级匹配菜单项；使用 isRightClickRef 拦截右键后的 onSelect 触发以避免误选。
Folder 命令式 API 与类型导出 packages/x/components/folder/index.tsx、packages/x/components/index.ts	扩展 FolderRef 类型，新增 getNode、updateNode、deleteNode、addNode 四个不可变树操作方法；新增 walkTree 递归遍历函数；重导出 FolderTreeData 类型供外部使用。
API 文档与演示 packages/x/components/folder/index.en-US.md、packages/x/components/folder/index.zh-CN.md、packages/x/components/folder/demo/context-menu.md、packages/x/components/folder/demo/context-menu.tsx	补充 contextMenu 与 onRightClick 的 API 文档，新增 Ref Methods 章节说明四个命令式方法；新增完整演示组件展示节点级菜单覆盖、编辑/删除/新增/复制等交互。
单元测试与分支覆盖 packages/x/components/folder/__tests__/index.test.tsx	新增 contextMenu 测试分组验证全局/节点级菜单、菜单禁用、优先级；新增 FolderRef methods 测试验证四个命令式方法的查找、更新、删除、添加及不可变性；补充 branch coverage 和 targeted branch coverage 测试覆盖多条实现分支。

x-markdown DOMPurify 修补与优化

层级 / 文件	摘要
DOMPurify Node.prototype 修补逻辑 packages/x-markdown/src/XMarkdown/core/Renderer.ts	新增 createPatchedDOMPurify 函数检测 Node.prototype 的 nodeName/nodeValue getter 在模板内容场景下是否失效；在失效时通过 Object.defineProperty 注入回退逻辑，创建新的 DOMPurify 实例；processHtml 改用补丁实例执行 sanitize。
测试策略调整 packages/x-markdown/src/XMarkdown/__tests__/Renderer.test.ts	将 DOMPurify 测试从直接 spy sanitize 调用改为监控 React.createElement，验证渲染结果；新增 createPatchedDOMPurify 分组测试补丁方案在不同节点类型、属性白名单、HTML 注释、streaming 动画等场景的表现。
代码简化 packages/x-markdown/src/XMarkdown/core/Parser.ts、packages/x-markdown/src/XMarkdown/hooks/useStreaming.ts	使用可选链 ?. 简化 findLastTextToken 的空值判定；移除 useStreaming 中 output 赋值表达式的多余括号。

其他代码优化

层级 / 文件	摘要
可选链与延迟初始化优化 packages/x/components/attachments/util.ts、packages/x/docs/x-markdown/demo/streaming/format.tsx、packages/x/docs/x-sdk/demos/chat-providers/custom-provider-width-ui.tsx、packages/x/docs/x-sdk/demos/x-conversations/with-x-chat.tsx	previewImage 和 IncompleteEmphasis 用可选链替代显式空值检查；transformMessage 简化流式完成检测；providerCachesRef 改为延迟初始化（null 而非 new Map()）。
TypeScript 类型声明 packages/x/typings/custom-typings.d.ts	补充 Dumi 相关模块的 ambient type declaration，包含 dumi/theme-default/slots/SearchBar、dumi/dist/client/theme-api、顶层 dumi 模块的导出类型。

估算评审工作量

🎯 4 (Complex) | ⏱️ ~60 minutes

• 复杂性因素：Folder 菜单功能涉及 DirectoryTree、Folder、ref API、演示代码、文档和多组测试的协调；DOMPurify 修补涉及浏览器环境检测、原型污染防御、缓存管理等细节逻辑；跨包版本更新虽然重复但需验证一致性。
• 异质性：改动涵盖新特性开发、bug 修复、代码优化、文档更新、测试扩展，各自需要独立的理由检证。
• 文件分散：超过 40 个文件的改动，其中 Folder 功能集中在 5-6 个核心文件，其余为版本号和配置微调。

相关 PR

• ant-design/x#1917：同样修改 packages/x-markdown/src/XMarkdown/core/Renderer.ts 的 processHtml DOMPurify 处理路径（本 PR 新增补丁型 DOMPurify 实例处理；关联 PR 在 DOM 不可用时添加守卫）。
• ant-design/x#1925：在 packages/x/docs/x-sdk/demos/x-conversations/with-x-chat.tsx 中同样将缓存 Map 改为延迟初始化，providerCachesRef 和 providerFactory 修改逻辑一致。

建议标签

lgtm

建议评审者

• Div627

---

🐰 一只兔子在版本号间跳跃，
菜单在右键处绽放，
DOMPurify 的 getter 被温柔修补，
可选链舞动，代码更清爽，
v2.8.0 的故事，就这样圆满～

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check	❓ Inconclusive	PR 标题 'chore: main merge feature' 过于宽泛和模糊，没有明确描述主要变更内容。	建议使用更具体的标题来描述此次合并的主要功能或改动，如 'chore: merge feature branch with x-markdown and Folder improvements' 等。

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature-merge-main

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	husky@​9.1.7
	@​size-limit/​file@​12.1.0
	circular-dependency-plugin@​5.2.2
	dekko@​0.2.1
	encoding@​0.1.13
	@​madccc/​duplicate-package-checker-webpack-plugin@​1.0.0
	@​ant-design/​tools@​19.2.0
	size-limit@​12.1.0
	father@​4.6.21
	classnames@​2.5.1
	gh-pages@​6.3.0
	marked-emoji@​2.0.3
	glob@​13.0.6
	rc-util@​5.44.4
	antd@​6.4.3
	@​ant-design/​icons@​6.2.5
	@​codecov/​webpack-plugin@​1.9.1
	@​testing-library/​react@​16.3.2
	prettier@​3.8.3
	lint-staged@​16.4.0

View full report

[codecov]

Bundle Report

Changes will increase total bundle size by 1.87MB (53.78%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name	Size	Change
antdx-array-push	3.98MB	1.87MB (88.63%) ⬆️⚠️

Affected Assets, Files, and Routes:

view changes for bundle: antdx-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
antdx.js (New)	3.98MB	3.98MB	100.0% 🚀
antdx.min.js (Deleted)	-2.11MB	0 bytes	-100.0% 🗑️

[gemini-code-assist]

Code Review

This pull request bumps package versions to 2.8.0, introduces a DOMPurify 3.x compatibility patch for happy-dom environments, and adds right-click context menu support along with new imperative ref methods (getNode, updateNode, deleteNode, addNode) to the Folder component. The review feedback highlights several key improvements: decoupling handleSelect from isRightClickRef using native event properties to prevent click-swallowing, avoiding side effects in the render phase by removing nodeDataMapRef and casting info.node directly, and handling empty parentPath arrays to allow adding nodes to the root level.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

Decouple handleSelect from isRightClickRef by checking the native event's button type directly. Using isRightClickRef inside handleSelect can cause a click-swallowing bug where the first left-click to close an open context menu is ignored/swallowed because isRightClickRef is still true. Additionally, checking the native event ensures consistent selection behavior regardless of whether the node has a context menu.

Suggested change

	// Intercept onSelect to skip selection triggered by right-click
	const handleSelect: TreeProps['onSelect'] = (keys, info) => {
	if (isRightClickRef.current) {
	isRightClickRef.current = false;
	return;
	}
	onSelect?.(keys, info);
	};
	// Intercept onSelect to skip selection triggered by right-click
	const handleSelect: TreeProps['onSelect'] = (keys, info) => {
	const nativeEvent = info.nativeEvent;
	if (nativeEvent && (nativeEvent.button === 2 || nativeEvent.type === 'contextmenu')) {
	return;
	}
	onSelect?.(keys, info);
	};

[gemini-code-assist]

Writing to nodeDataMapRef.current during the render phase violates React's rules of render (render functions must be pure and free of side effects). Since rc-tree preserves all custom properties passed to treeData nodes, the original node properties (like contextMenu) are already directly accessible on info.node in the onRightClick callback. You can safely remove nodeDataMapRef entirely and cast info.node to FolderTreeData.

Suggested change

	const handleRightClick: TreeProps['onRightClick'] = (info) => {
	const { node } = info;
	const nodeKey = node.key as string;
	const originalNode = nodeDataMapRef.current.get(nodeKey);
	const handleRightClick: TreeProps['onRightClick'] = (info) => {
	const { node } = info;
	const nodeKey = node.key as string;
	const originalNode = node as unknown as FolderTreeData;

[gemini-code-assist]

When parentPath is empty ([]), walkTree will fail to match any segment and return the original tree unchanged, making it impossible to add a new node to the root of the tree. Handle parentPath.length === 0 as a special case to allow appending nodes to the root level.

    addNode: (parentPath: string[], node: FolderTreeData) => {
      if (!treeData) return [];
      if (parentPath.length === 0) {
        return [...treeData, node];
      }
      return walkTree(treeData, parentPath, 0, 'add', node);
    },

[github-actions]

⚠️ Performance benchmark report not found.

---

This comment is automatically generated by the x-markdown performance CI.

[cloudflare-workers-and-pages]

Deploying ant-design-x with    Cloudflare Pages

Latest commit:	c823b6d
Status:	✅  Deploy successful!
Preview URL:	https://424c9a6b.ant-design-x.pages.dev
Branch Preview URL:	https://feature-merge-main.ant-design-x.pages.dev

View logs

[codecov]

Codecov Report

❌ Patch coverage is 76.71233% with 34 lines in your changes missing coverage. Please review.
✅ Project coverage is 97.09%. Comparing base (d212e12) to head (c823b6d).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
packages/x-markdown/src/XMarkdown/core/Renderer.ts	51.66%	29 Missing ⚠️
packages/x/components/folder/DirectoryTree.tsx	92.50%	3 Missing ⚠️
packages/x/components/folder/index.tsx	95.23%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1929      +/-   ##
==========================================
- Coverage   97.63%   97.09%   -0.54%     
==========================================
  Files         158      158              
  Lines        5572     5711     +139     
  Branches     1599     1692      +93     
==========================================
+ Hits         5440     5545     +105     
- Misses        130      164      +34     
  Partials        2        2              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

size-limit report 📦

Path	Size
packages/x/dist/antdx.min.js	510.62 KB (+497 B 🔺)
packages/x-sdk/dist/x-sdk.min.js	55.66 KB
packages/x-markdown/dist/x-markdown.min.js	33.8 KB (+350 B 🔺)
packages/x-markdown/dist/plugins/latex.min.js	61.91 KB