重大变更

本文深入解析 WordPress 设计系统的核心概念与最佳实践。内容涵盖公共包与私有 API 的边界界定、Gutenberg 组件过渡策略、MCP 服务器及 Storybook 的使用指南。重点讨论了设计令牌的语义化应用、样式预设的配置方法，以及在迁移现有组件时如何保持行为一致性与无障碍性。同时提供了关于 API 兼容性验证、测试覆盖率选择及跨版本契约管理的详细建议，帮助开发者构建稳健的 WordPress 应用程序。

@wordpress/ui 是 WordPress 设计系统的 React UI 组件包，提供基于设计令牌的灵活组件。支持 NPM 安装与主题定制，包含按钮、链接等基础元素及复合组件。遵循一致的模式实现自定义渲染、Ref 转发和状态管理，区分受控与非受控用法，确保在编辑器内外都能开箱即用并保持一致的视觉体验。

本文介绍处于实验阶段的单位控制功能，允许用户设置数值及对应单位。支持通过属性禁用单位显示、配置按下回车键或Tab键触发更改、重置单位变更时的默认值等。提供丰富的回调函数如失焦、聚焦、数值变化及单位变化事件，并支持调整输入框尺寸与标签位置，适用于需要精确控制数值的场景。

本文是 WordPress 插件团队发布的官方常见问题解答，涵盖插件提交、审核流程、Slug 命名规则及 SVN 仓库管理等核心内容。文章详细解答了关于插件批准时间、商标使用限制、关闭插件条件、安全报告方式以及如何处理代码抄袭等开发者最关心的问题，旨在帮助开发者顺利发布并维护合规的 WordPress 插件。

本文档详细说明了 Gutenberg 仓库的协作管理流程，涵盖 Issues 与 Pull Requests 的处理规范、标签使用指南、分诊机制、代码与设计审查标准以及合并策略。旨在帮助贡献者高效提交变更，确保项目健康有序发展，明确各阶段责任分工与最佳实践。

本文介绍 WordPress Gutenberg 项目的 WidgetDashboard 软件包，这是一个用于构建小工具仪表盘的无状态渲染引擎。它支持拖拽重排、调整大小及模态插入等编辑功能。文章详细解析了其组件架构、样式系统、网格模型配置以及基于策略的用户权限治理机制，适用于在 WordPress 核心或外部环境中开发自定义仪表盘界面。

WordPress Media Fields 软件包提供可复用字段定义，用于在 DataViews 中显示和编辑媒体附件属性。主要支持 Gutenberg 内部使用，涵盖替代文本、说明、文件大小、图像尺寸及 MIME 类型等常见属性的展示与编辑功能。

@wordpress/sync 是基于 CRDT 文档的 WordPress 编辑器同步层，利用 Yjs 实现多用户实时协作。它协调实体记录同步生命周期，处理富文本变更及连接重试等逻辑。作为 Gutenberg 独立软件包，需注意其非公共 API 特性及 Yjs 实例共享规范，避免数据损坏。

本文详细介绍 WordPress Gutenberg 项目如何维护向后兼容性，涵盖生产环境公共 API 的定义、JavaScript 函数与 React 组件的兼容规范、区块及 DOM 结构更新原则。同时阐述废弃（Deprecation）流程与 Dev Notes 开发说明的撰写机制，帮助开发者平滑迁移并避免破坏现有插件功能。

@wordpress/build是专为WordPress插件设计的约定式构建工具。它支持使用esbuild转译TypeScript和JSX，处理SCSS及CSS模块生成左右文版本，并自动创建PHP注册文件。该工具提供监听模式以支持开发增量重建，同时包含实验性的路由系统和Widgets功能，帮助开发者高效构建和管理复杂的WordPress插件项目。