Plate Slate V2 Transforms 测试族闭环实战408 行对账矩阵、setNodes 与 moveNodes 契约恢复及验证证据【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇基于 Plate 仓库中的计划文档 2026-04-09-slate-v2-transforms-family-deleted-test-closure.md讲解 slate-v2 迁移中已删除 transforms 测试族的闭环方法论如何用一个 408 行的对账矩阵Family Closure Matrix逐簇清算packages/slate/test/transforms/**下的删除用例如何判定每一簇是镜像覆盖mirrored还是直接恢复recovered并定位到当前的证明责任人proof owner。读完本文你将掌握一套可复用的删除测试对账 → 契约恢复 → 边界声明工程流程并能对照当前 Plate 仓库中packages/slate的真实实现理解setNodes、moveNodes等核心 helper 的现行契约。闭环目标把删除的 transforms 测试族对回现行契约原文档的 Scope 一节开宗明义Close the deletedpackages/slate/test/transforms/**family against the currentslate-v2transform contract.即slate-v2 重构过程中旧slate包下的test/transforms/**测试族被整体删除。删除不等于放弃——迁移程序要求每一个被删除的用例簇都必须对回reconcile现行的 transform 契约并给出三种结局之一mirrored now旧用例的语义已经被当前更窄narrow的行直接覆盖证明责任落在现行的契约测试文件上recovered now旧用例暴露的是真实能力缺口当前 helper 需要实际加宽如扩展 options 面恢复后由新测试行直接证明explicit skip显式跳过并说明理由。本族最终 skip 数为0。这种逐行对账、不许悄悄消失的做法是理解本文档矩阵的前提。家族闭环矩阵8 个簇、408 行的完整清算原文档的核心资产是这张 Family Closure Matrix它把transforms/**拆成 8 个簇组逐组记录删除数、状态、当前证明责任人和解决方式。矩阵中的证明责任人如snapshot-contract.ts、transforms-contract.ts、clipboard-contract.ts、range-ref-contract.ts、operations-contract.ts、index.spec.ts均指向上游 slate-v2 仓库packages/slate/test/下的契约测试文件原文档中为作者本机绝对路径它们不在当前 Plate 仓库内故此处仅作名称引用。簇组删除数状态解决方式delete/*100mirrored now当前窄版Transforms.delete(...)行在精确 path、point、非空 range、mixed-inline、相邻 block 边界等接缝上直接证明move/*49mirrored now当前窄版Transforms.move(...)行覆盖 anchor/focus/start/end、distance/reverse、mixed-inline、受支持的 block 边界等接缝insertFragment/*41mirrored nowfragment 插入行为在 collapsed/expanded、mixed-inline、quote、wrapper-list、显式目标 rebasing 等接缝上被证明setNodes/*29recovered nowhelper 从仅 path 加宽到可选 current-selection / 显式Point/Range/Span外加match/mode/voidsmoveNodes/path6recovered now精确 path no-op 以及后续嵌套容器目标 rebasing 被直接证明包括对生效移动目标一致的 selection range-ref rebasingmoveNodes/selectionmoveNodes/voids-true7mirrored nowselection 驱动与voids移动广度仍在现行MoveNodesOptions契约之内台账行保持镜像wrapNodes/*、unwrapNodes/*、liftNodes/*、select/*、deselect/*、setPoint/*、unsetNodes/*64mirrored now当前 helper 接缝在精确 path 加顶层 span / current-selection 行为上实质镜像恢复后的公开 option 包与之对齐mergeNodes/*、splitNodes/*、insertNodes/*、insertText/*、removeNodes/*112recovered now旧窄 helper 显式跳过读法失效insert/split/merge/remove 广度的上游 owner 语义被恢复完整 transform fixture 语料转绿合计Totalsmirrored now261recovered now147explicit skip0reconciled total408矩阵的关键阅读方式是状态列决定后续动作mirrored now意味着不需要改实现只需确认现行测试行确实覆盖旧语义recovered now意味着发生了真实的代码变更helper 契约加宽并且变更本身要有直接测试行背书。下文两个 recovered 簇正属于后者。本批次直接恢复的两大簇原文档列出了本批次batch直接恢复的范围setNodes/inline/**整簇moveNodes/path/**中足以证明以下三点的部分精确 path no-opat与to相等时不动文档后续嵌套容器目标的 rebasing对生效移动目标一致的 selection range-ref rebasing。setNodes从path-only helper到完整查询选项包簇恢复细节见姊妹计划文档 2026-04-09-slate-v2-transforms-setnodes-cluster-recovery.md。其要点Transforms.setNodes(...)支持的定位面从仅Path加宽到精确Path、current-selection / 显式Location、Span并支持match、mode、voids选项默认mode为lowesthelper 对所有匹配节点只应用一次事务one transaction运行时 id 保持稳定因为 helper 仍然经由 rawset_node操作落地。直接证明行包括通过match更新选中的 inline 元素无需显式 path、跨 block 的 span 选择更新多个 block 中匹配的 inline 元素、嵌套 inline 匹配默认落到最低层、inline void 的原有 props 在新增 prop 时保留、Point/Range/Span显式目标、非默认的mode: highest。该文档还解释了为什么值得恢复被删除的setNodes/inline/**簇对应的是真实使用场景——上游 walkthrough 文档已经在教Transforms.setNodes(editor, props, { match })的用法而当时的实现只接受{ at: Path }与其假装文档或测试写错了不如恢复接缝本身。对应到当前 Plate 仓库setNodes的实现位于 setNodes.ts。从源码结构看Plate 侧在同样的查询选项思路上做了进一步封装它接收SetNodesOptions含可选marks字段在marks存在时构造一个match函数——只匹配Text节点、且其父节点非 void 或为可标记 voidmarkableVoid的节点对展开选区或命中可标记 void 的情况会以split: true, voids: true转发到基础setNodes。最后统一通过getQueryOptions(editor, options)来自 utils把 options 解析成下游可用的查询参数。这与文档中helper 经由统一选项解析、一次事务落地的描述一致Plate 把选区/路径/Span 归一化 匹配过滤收敛在包装层基础变换仍由slate包承担。该文件旁即有配套测试 setNodes.spec.tsx 与 setNodesBatch.spec.tsx构成当前仓库内对这条接缝的持续验证。moveNodes精确 path no-op 与目标 rebasingmoveNodes/path/**簇的恢复细节见 2026-04-09-slate-v2-transforms-movenodes-path-cluster-recovery.md。其恢复契约为当at与to相等时Transforms.moveNodes(...)保持精确 path no-op 行为位于其后的嵌套容器目标在触及 rawmove_node之前先被 rebasedrawmove_node操作在事务接缝上对 selection 做 rebasing不再让 helper 驱动的移动遗留失效路径stale paths。该文档同时划出了未恢复边界moveNodes/path/text*.tsx中依赖跨块文本移动后相邻文本合并这一更宽活体归一化行为的行不在当前已证明的归一化底线之内不应作为免费的 helper 修复偷偷带回来。这是闭环方法论里很有价值的一条纪律恢复范围必须止步于已被证明的契约面。当前 Plate 仓库的对应实现是 moveNodes.ts。从源码结构看Plate 侧在此接缝上支持了一个额外的children/fromIndex形态当传入children时helper 先在at指向的 block 节点上从末尾到fromIndex逆序遍历子节点对通过match过滤的每个子路径逐个调用基础moveNodes否则直接把经getQueryOptions归一化的选项转发给基础实现。配套的 moveNodes.spec.tsx 对这条包装路径提供直接测试。可以说upstream 文档所证明的精确 path no-op、嵌套目标 rebasing属于基础slate契约层的行为而 Plate 在其上叠加的是批量子节点移动这一更上层的选项包——两层契约各司其职。当前仓库中的验证证据布局原文档矩阵中的证明责任人在上游仓库以*-contract.ts契约测试文件承载在当前 Plate 仓库中同类职责落在packages/slate/src/internal/transforms/目录下与 helper 同名的.spec.tsx/.spec.ts文件上。矩阵涉及的簇组与当前仓库文件的对应关系如下均为已确认存在的路径矩阵簇组当前 Plate 仓库中的实现 / 测试文件delete/*deleteText.ts、deleteText.spec.tsxmove/*与moveNodes同源接缝见 moveNodes.tsinsertFragment/*insertFragment.tssetNodes/*setNodes.ts、setNodes.spec.tsxmoveNodes/*moveNodes.ts、moveNodes.spec.tsxwrapNodes/*、unwrapNodes/*、liftNodes/*wrapNodes.ts、unwrapNodes.ts、liftNodes.tsselect/*、deselect/*、setPoint/*、unsetNodes/*select.ts、deselect.ts、setPoint.ts、unsetNodes.tsmergeNodes/*、splitNodes/*、insertNodes/*、insertText/*、removeNodes/*mergeNodes.ts、splitNodes.ts、insertNodes.ts、insertText.ts、removeNodes.ts以及同名.spec.tsx这一布局印证了文档的方法论每一个 helper 都有自己的证明邻居同目录同名 spec 文件簇恢复的落点永远是helper 实现文件 契约测试文件成对出现而不是散落的零散断言。当前边界声明explicit-skip 故事已死原文档的 Current Boundary 一节给出了整个slate包 transforms 族的收尾判断The old narrow-helper explicit-skip story forpackages/slate/test/transforms/**is no longer live.具体的现行事实current truth只有三条完整 transform fixture 语料为绿greenmergeNodes、splitNodes、insertNodes、insertText、removeNodes的 helper 广度已在保留的包声明package claim内恢复整个迁移程序中剩余的显式跳过全部位于本slatetransform 族闭环之外。这条边界声明的意义在于它把本族已了结与整个迁移尚未了结明确切开避免读者把局部完成误读为全局完成。任何后续对 transforms 行为的质疑都应先查矩阵里该行的 proof owner而不是假设还有未记录的隐含跳过。方法论小结删除测试对账的通用做法把原文档抽象成可复用流程共四步建矩阵按目录簇如setNodes/*、moveNodes/path统计删除用例数逐簇指定状态mirrored / recovered / explicit skip与证明责任人文件镜像验证优先能靠现有窄版行覆盖的语义一律标mirrored now不动实现避免为凑回旧测试引入回归面缺口才恢复只有当旧用例对应真实使用场景如 walkthrough 已在教某 API时才标recovered now此时必须同步完成helper 契约加宽 直接测试行 文档同步三件套并在姊妹计划文档中记录代码变更点收尾必须声明边界用一小节明确什么故事已经死了、什么事实现在是绿的、剩余 skip 在哪防止局部闭环被放大为全局结论。配合 Plate 仓库中packages/slate的实现与测试布局见上文证据表这套流程既是 slate-v2 迁移的记账工具也是一份可以直接套用到任何测试族迁移/裁剪场景的审计清单。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Plate Slate V2 Transforms 测试族闭环实战408 行对账矩阵、setNodes 与 moveNodes 契约恢复及验证证据【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇基于 Plate 仓库中的计划文档 2026-04-09-slate-v2-transforms-family-deleted-test-closure.md讲解 slate-v2 迁移中已删除 transforms 测试族的闭环方法论如何用一个 408 行的对账矩阵Family Closure Matrix逐簇清算packages/slate/test/transforms/**下的删除用例如何判定每一簇是镜像覆盖mirrored还是直接恢复recovered并定位到当前的证明责任人proof owner。读完本文你将掌握一套可复用的删除测试对账 → 契约恢复 → 边界声明工程流程并能对照当前 Plate 仓库中packages/slate的真实实现理解setNodes、moveNodes等核心 helper 的现行契约。闭环目标把删除的 transforms 测试族对回现行契约原文档的 Scope 一节开宗明义Close the deletedpackages/slate/test/transforms/**family against the currentslate-v2transform contract.即slate-v2 重构过程中旧slate包下的test/transforms/**测试族被整体删除。删除不等于放弃——迁移程序要求每一个被删除的用例簇都必须对回reconcile现行的 transform 契约并给出三种结局之一mirrored now旧用例的语义已经被当前更窄narrow的行直接覆盖证明责任落在现行的契约测试文件上recovered now旧用例暴露的是真实能力缺口当前 helper 需要实际加宽如扩展 options 面恢复后由新测试行直接证明explicit skip显式跳过并说明理由。本族最终 skip 数为0。这种逐行对账、不许悄悄消失的做法是理解本文档矩阵的前提。家族闭环矩阵8 个簇、408 行的完整清算原文档的核心资产是这张 Family Closure Matrix它把transforms/**拆成 8 个簇组逐组记录删除数、状态、当前证明责任人和解决方式。矩阵中的证明责任人如snapshot-contract.ts、transforms-contract.ts、clipboard-contract.ts、range-ref-contract.ts、operations-contract.ts、index.spec.ts均指向上游 slate-v2 仓库packages/slate/test/下的契约测试文件原文档中为作者本机绝对路径它们不在当前 Plate 仓库内故此处仅作名称引用。簇组删除数状态解决方式delete/*100mirrored now当前窄版Transforms.delete(...)行在精确 path、point、非空 range、mixed-inline、相邻 block 边界等接缝上直接证明move/*49mirrored now当前窄版Transforms.move(...)行覆盖 anchor/focus/start/end、distance/reverse、mixed-inline、受支持的 block 边界等接缝insertFragment/*41mirrored nowfragment 插入行为在 collapsed/expanded、mixed-inline、quote、wrapper-list、显式目标 rebasing 等接缝上被证明setNodes/*29recovered nowhelper 从仅 path 加宽到可选 current-selection / 显式Point/Range/Span外加match/mode/voidsmoveNodes/path6recovered now精确 path no-op 以及后续嵌套容器目标 rebasing 被直接证明包括对生效移动目标一致的 selection range-ref rebasingmoveNodes/selectionmoveNodes/voids-true7mirrored nowselection 驱动与voids移动广度仍在现行MoveNodesOptions契约之内台账行保持镜像wrapNodes/*、unwrapNodes/*、liftNodes/*、select/*、deselect/*、setPoint/*、unsetNodes/*64mirrored now当前 helper 接缝在精确 path 加顶层 span / current-selection 行为上实质镜像恢复后的公开 option 包与之对齐mergeNodes/*、splitNodes/*、insertNodes/*、insertText/*、removeNodes/*112recovered now旧窄 helper 显式跳过读法失效insert/split/merge/remove 广度的上游 owner 语义被恢复完整 transform fixture 语料转绿合计Totalsmirrored now261recovered now147explicit skip0reconciled total408矩阵的关键阅读方式是状态列决定后续动作mirrored now意味着不需要改实现只需确认现行测试行确实覆盖旧语义recovered now意味着发生了真实的代码变更helper 契约加宽并且变更本身要有直接测试行背书。下文两个 recovered 簇正属于后者。本批次直接恢复的两大簇原文档列出了本批次batch直接恢复的范围setNodes/inline/**整簇moveNodes/path/**中足以证明以下三点的部分精确 path no-opat与to相等时不动文档后续嵌套容器目标的 rebasing对生效移动目标一致的 selection range-ref rebasing。setNodes从path-only helper到完整查询选项包簇恢复细节见姊妹计划文档 2026-04-09-slate-v2-transforms-setnodes-cluster-recovery.md。其要点Transforms.setNodes(...)支持的定位面从仅Path加宽到精确Path、current-selection / 显式Location、Span并支持match、mode、voids选项默认mode为lowesthelper 对所有匹配节点只应用一次事务one transaction运行时 id 保持稳定因为 helper 仍然经由 rawset_node操作落地。直接证明行包括通过match更新选中的 inline 元素无需显式 path、跨 block 的 span 选择更新多个 block 中匹配的 inline 元素、嵌套 inline 匹配默认落到最低层、inline void 的原有 props 在新增 prop 时保留、Point/Range/Span显式目标、非默认的mode: highest。该文档还解释了为什么值得恢复被删除的setNodes/inline/**簇对应的是真实使用场景——上游 walkthrough 文档已经在教Transforms.setNodes(editor, props, { match })的用法而当时的实现只接受{ at: Path }与其假装文档或测试写错了不如恢复接缝本身。对应到当前 Plate 仓库setNodes的实现位于 setNodes.ts。从源码结构看Plate 侧在同样的查询选项思路上做了进一步封装它接收SetNodesOptions含可选marks字段在marks存在时构造一个match函数——只匹配Text节点、且其父节点非 void 或为可标记 voidmarkableVoid的节点对展开选区或命中可标记 void 的情况会以split: true, voids: true转发到基础setNodes。最后统一通过getQueryOptions(editor, options)来自 utils把 options 解析成下游可用的查询参数。这与文档中helper 经由统一选项解析、一次事务落地的描述一致Plate 把选区/路径/Span 归一化 匹配过滤收敛在包装层基础变换仍由slate包承担。该文件旁即有配套测试 setNodes.spec.tsx 与 setNodesBatch.spec.tsx构成当前仓库内对这条接缝的持续验证。moveNodes精确 path no-op 与目标 rebasingmoveNodes/path/**簇的恢复细节见 2026-04-09-slate-v2-transforms-movenodes-path-cluster-recovery.md。其恢复契约为当at与to相等时Transforms.moveNodes(...)保持精确 path no-op 行为位于其后的嵌套容器目标在触及 rawmove_node之前先被 rebasedrawmove_node操作在事务接缝上对 selection 做 rebasing不再让 helper 驱动的移动遗留失效路径stale paths。该文档同时划出了未恢复边界moveNodes/path/text*.tsx中依赖跨块文本移动后相邻文本合并这一更宽活体归一化行为的行不在当前已证明的归一化底线之内不应作为免费的 helper 修复偷偷带回来。这是闭环方法论里很有价值的一条纪律恢复范围必须止步于已被证明的契约面。当前 Plate 仓库的对应实现是 moveNodes.ts。从源码结构看Plate 侧在此接缝上支持了一个额外的children/fromIndex形态当传入children时helper 先在at指向的 block 节点上从末尾到fromIndex逆序遍历子节点对通过match过滤的每个子路径逐个调用基础moveNodes否则直接把经getQueryOptions归一化的选项转发给基础实现。配套的 moveNodes.spec.tsx 对这条包装路径提供直接测试。可以说upstream 文档所证明的精确 path no-op、嵌套目标 rebasing属于基础slate契约层的行为而 Plate 在其上叠加的是批量子节点移动这一更上层的选项包——两层契约各司其职。当前仓库中的验证证据布局原文档矩阵中的证明责任人在上游仓库以*-contract.ts契约测试文件承载在当前 Plate 仓库中同类职责落在packages/slate/src/internal/transforms/目录下与 helper 同名的.spec.tsx/.spec.ts文件上。矩阵涉及的簇组与当前仓库文件的对应关系如下均为已确认存在的路径矩阵簇组当前 Plate 仓库中的实现 / 测试文件delete/*deleteText.ts、deleteText.spec.tsxmove/*与moveNodes同源接缝见 moveNodes.tsinsertFragment/*insertFragment.tssetNodes/*setNodes.ts、setNodes.spec.tsxmoveNodes/*moveNodes.ts、moveNodes.spec.tsxwrapNodes/*、unwrapNodes/*、liftNodes/*wrapNodes.ts、unwrapNodes.ts、liftNodes.tsselect/*、deselect/*、setPoint/*、unsetNodes/*select.ts、deselect.ts、setPoint.ts、unsetNodes.tsmergeNodes/*、splitNodes/*、insertNodes/*、insertText/*、removeNodes/*mergeNodes.ts、splitNodes.ts、insertNodes.ts、insertText.ts、removeNodes.ts以及同名.spec.tsx这一布局印证了文档的方法论每一个 helper 都有自己的证明邻居同目录同名 spec 文件簇恢复的落点永远是helper 实现文件 契约测试文件成对出现而不是散落的零散断言。当前边界声明explicit-skip 故事已死原文档的 Current Boundary 一节给出了整个slate包 transforms 族的收尾判断The old narrow-helper explicit-skip story forpackages/slate/test/transforms/**is no longer live.具体的现行事实current truth只有三条完整 transform fixture 语料为绿greenmergeNodes、splitNodes、insertNodes、insertText、removeNodes的 helper 广度已在保留的包声明package claim内恢复整个迁移程序中剩余的显式跳过全部位于本slatetransform 族闭环之外。这条边界声明的意义在于它把本族已了结与整个迁移尚未了结明确切开避免读者把局部完成误读为全局完成。任何后续对 transforms 行为的质疑都应先查矩阵里该行的 proof owner而不是假设还有未记录的隐含跳过。方法论小结删除测试对账的通用做法把原文档抽象成可复用流程共四步建矩阵按目录簇如setNodes/*、moveNodes/path统计删除用例数逐簇指定状态mirrored / recovered / explicit skip与证明责任人文件镜像验证优先能靠现有窄版行覆盖的语义一律标mirrored now不动实现避免为凑回旧测试引入回归面缺口才恢复只有当旧用例对应真实使用场景如 walkthrough 已在教某 API时才标recovered now此时必须同步完成helper 契约加宽 直接测试行 文档同步三件套并在姊妹计划文档中记录代码变更点收尾必须声明边界用一小节明确什么故事已经死了、什么事实现在是绿的、剩余 skip 在哪防止局部闭环被放大为全局结论。配合 Plate 仓库中packages/slate的实现与测试布局见上文证据表这套流程既是 slate-v2 迁移的记账工具也是一份可以直接套用到任何测试族迁移/裁剪场景的审计清单。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
