Plate编辑器核心库重大升级：支持React 19与状态管理重构

项目背景

Plate是一个基于Slate的现代化富文本编辑器框架，提供了高度可定制化的组件和插件系统。作为Plate生态系统的核心，@udecode/plate-core承担着基础架构和状态管理的重任。本次发布的44.0.0版本带来了多项重大改进，特别是对React 19的支持以及状态管理系统的全面重构。

核心变更解析

1. React 19兼容性支持

随着React 19的发布，Plate核心库率先进行了适配升级。这意味着开发者现在可以在React 19环境中无缝使用Plate编辑器，享受React最新版本带来的性能优化和新特性。

2. 状态管理系统重构

本次版本对状态管理系统进行了深度重构，主要涉及两个方面：

zustand-x升级至v6

• 原有的eventEditorSelectors被重构为EventEditorStore.get
• eventEditorActions变更为EventEditorStore.set
• useEventEditorSelectors钩子函数更名为useEventEditorValue(key)

jotai-x升级至v2

• usePlateEditorStore简化为usePlateStore
• usePlateActions变更为usePlateSet
• 移除了editor.setPlateState方法，推荐使用usePlateSet替代
• usePlateSelectors更名为usePlateValue
• usePlateStates调整为usePlateState

这些变更使得状态管理API更加一致和直观，减少了概念上的混淆。

3. 插件选项钩子独立化

为了更好兼容React Compiler，插件选项相关的钩子被重构为独立函数：

• editor.useOption和ctx.useOption统一为usePluginOption(plugin, key, ...args)
• editor.useOptions和ctx.useOptions变更为usePluginOption(plugin, 'state')
• 新增usePluginOptions(plugin, selector)钩子，采用Zustand风格选择插件选项

这种重构使得插件选项的管理更加模块化和可预测。

4. 插件选择器分离

之前版本中，插件选择器通过extendOptions方法添加，与选项状态混合存储，容易导致冲突和混淆。本次变更对此进行了重要改进：

• 方法重命名为extendSelectors
• 选择器现在存储在plugin.selectors而非plugin.options中
• 访问方式保持不变，仍可通过editor.getOption(plugin, 'selectorName')等方式访问
• 选择器类型不再放在PluginConfig的第二个泛型参数中，新增第五个泛型参数专门用于选择器

示例类型定义变更：

// 旧版
export type BlockSelectionConfig = PluginConfig<
  'blockSelection',
  { selectedIds?: Set<string>; } & BlockSelectionSelectors,
>;

// 新版
export type BlockSelectionConfig = PluginConfig<
  'blockSelection',
  { selectedIds?: Set<string>; },
  {}, // API
  {}, // Transforms
  BlockSelectionSelectors, // Selectors
}>

升级建议

对于现有项目升级到44.0.0版本，开发者需要注意以下几点：

1. 检查所有状态管理相关的代码，按照新的API规范进行调整
2. 更新插件选择器的定义方式，使用新的extendSelectors方法
3. 替换所有被废弃的钩子函数，使用新的独立钩子
4. 如果项目中使用TypeScript，需要更新插件配置的类型定义

总结

本次@udecode/plate-core的重大升级不仅带来了对React 19的支持，更重要的是重构了状态管理系统，使其更加清晰和可维护。插件系统的改进也为开发者提供了更灵活和强大的定制能力。这些变更虽然带来了一定的迁移成本，但从长远来看将显著提升开发体验和代码质量。