@fluidframework/tree 2.83.0 → 2.90.0-378676

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (781) hide show
  1. package/api-report/tree.alpha.api.md +1 -0
  2. package/dist/core/change-family/changeFamily.d.ts +4 -1
  3. package/dist/core/change-family/changeFamily.d.ts.map +1 -1
  4. package/dist/core/change-family/changeFamily.js.map +1 -1
  5. package/dist/core/change-family/index.d.ts +1 -1
  6. package/dist/core/change-family/index.d.ts.map +1 -1
  7. package/dist/core/change-family/index.js.map +1 -1
  8. package/dist/core/index.d.ts +3 -3
  9. package/dist/core/index.d.ts.map +1 -1
  10. package/dist/core/index.js +6 -4
  11. package/dist/core/index.js.map +1 -1
  12. package/dist/core/rebase/changeRebaser.d.ts +6 -1
  13. package/dist/core/rebase/changeRebaser.d.ts.map +1 -1
  14. package/dist/core/rebase/changeRebaser.js.map +1 -1
  15. package/dist/core/rebase/index.d.ts +1 -1
  16. package/dist/core/rebase/index.d.ts.map +1 -1
  17. package/dist/core/rebase/index.js +2 -1
  18. package/dist/core/rebase/index.js.map +1 -1
  19. package/dist/core/rebase/types.d.ts +1 -0
  20. package/dist/core/rebase/types.d.ts.map +1 -1
  21. package/dist/core/rebase/types.js +5 -1
  22. package/dist/core/rebase/types.js.map +1 -1
  23. package/dist/core/rebase/utils.d.ts.map +1 -1
  24. package/dist/core/rebase/utils.js +25 -7
  25. package/dist/core/rebase/utils.js.map +1 -1
  26. package/dist/core/tree/delta.d.ts +5 -0
  27. package/dist/core/tree/delta.d.ts.map +1 -1
  28. package/dist/core/tree/delta.js.map +1 -1
  29. package/dist/core/tree/detachedFieldIndex.d.ts +13 -1
  30. package/dist/core/tree/detachedFieldIndex.d.ts.map +1 -1
  31. package/dist/core/tree/detachedFieldIndex.js +14 -1
  32. package/dist/core/tree/detachedFieldIndex.js.map +1 -1
  33. package/dist/core/tree/detachedFieldIndexTypes.d.ts +4 -0
  34. package/dist/core/tree/detachedFieldIndexTypes.d.ts.map +1 -1
  35. package/dist/core/tree/detachedFieldIndexTypes.js.map +1 -1
  36. package/dist/core/tree/index.d.ts +2 -2
  37. package/dist/core/tree/index.d.ts.map +1 -1
  38. package/dist/core/tree/index.js +4 -3
  39. package/dist/core/tree/index.js.map +1 -1
  40. package/dist/core/tree/pathTree.d.ts +11 -3
  41. package/dist/core/tree/pathTree.d.ts.map +1 -1
  42. package/dist/core/tree/pathTree.js +14 -2
  43. package/dist/core/tree/pathTree.js.map +1 -1
  44. package/dist/core/tree/visitDelta.d.ts.map +1 -1
  45. package/dist/core/tree/visitDelta.js +17 -13
  46. package/dist/core/tree/visitDelta.js.map +1 -1
  47. package/dist/feature-libraries/changeAtomIdBTree.d.ts +3 -2
  48. package/dist/feature-libraries/changeAtomIdBTree.d.ts.map +1 -1
  49. package/dist/feature-libraries/changeAtomIdBTree.js +15 -2
  50. package/dist/feature-libraries/changeAtomIdBTree.js.map +1 -1
  51. package/dist/feature-libraries/default-schema/defaultEditBuilder.d.ts +92 -44
  52. package/dist/feature-libraries/default-schema/defaultEditBuilder.d.ts.map +1 -1
  53. package/dist/feature-libraries/default-schema/defaultEditBuilder.js +220 -70
  54. package/dist/feature-libraries/default-schema/defaultEditBuilder.js.map +1 -1
  55. package/dist/feature-libraries/default-schema/defaultFieldKinds.d.ts.map +1 -1
  56. package/dist/feature-libraries/default-schema/defaultFieldKinds.js +12 -2
  57. package/dist/feature-libraries/default-schema/defaultFieldKinds.js.map +1 -1
  58. package/dist/feature-libraries/default-schema/index.d.ts +2 -1
  59. package/dist/feature-libraries/default-schema/index.d.ts.map +1 -1
  60. package/dist/feature-libraries/default-schema/index.js +4 -2
  61. package/dist/feature-libraries/default-schema/index.js.map +1 -1
  62. package/dist/feature-libraries/default-schema/locationBasedEditBuilder.d.ts +40 -0
  63. package/dist/feature-libraries/default-schema/locationBasedEditBuilder.d.ts.map +1 -0
  64. package/dist/feature-libraries/default-schema/locationBasedEditBuilder.js +153 -0
  65. package/dist/feature-libraries/default-schema/locationBasedEditBuilder.js.map +1 -0
  66. package/dist/feature-libraries/default-schema/mappedEditBuilder.d.ts +7 -6
  67. package/dist/feature-libraries/default-schema/mappedEditBuilder.d.ts.map +1 -1
  68. package/dist/feature-libraries/default-schema/mappedEditBuilder.js +15 -0
  69. package/dist/feature-libraries/default-schema/mappedEditBuilder.js.map +1 -1
  70. package/dist/feature-libraries/deltaUtils.d.ts +1 -0
  71. package/dist/feature-libraries/deltaUtils.d.ts.map +1 -1
  72. package/dist/feature-libraries/deltaUtils.js +6 -1
  73. package/dist/feature-libraries/deltaUtils.js.map +1 -1
  74. package/dist/feature-libraries/flex-tree/context.d.ts +9 -0
  75. package/dist/feature-libraries/flex-tree/context.d.ts.map +1 -1
  76. package/dist/feature-libraries/flex-tree/context.js +6 -0
  77. package/dist/feature-libraries/flex-tree/context.js.map +1 -1
  78. package/dist/feature-libraries/flex-tree/flexTreeTypes.d.ts +6 -6
  79. package/dist/feature-libraries/flex-tree/flexTreeTypes.d.ts.map +1 -1
  80. package/dist/feature-libraries/flex-tree/flexTreeTypes.js.map +1 -1
  81. package/dist/feature-libraries/flex-tree/lazyField.d.ts +8 -7
  82. package/dist/feature-libraries/flex-tree/lazyField.d.ts.map +1 -1
  83. package/dist/feature-libraries/flex-tree/lazyField.js +39 -8
  84. package/dist/feature-libraries/flex-tree/lazyField.js.map +1 -1
  85. package/dist/feature-libraries/index.d.ts +3 -3
  86. package/dist/feature-libraries/index.d.ts.map +1 -1
  87. package/dist/feature-libraries/index.js +8 -4
  88. package/dist/feature-libraries/index.js.map +1 -1
  89. package/dist/feature-libraries/mitigatedChangeFamily.d.ts.map +1 -1
  90. package/dist/feature-libraries/mitigatedChangeFamily.js +2 -2
  91. package/dist/feature-libraries/mitigatedChangeFamily.js.map +1 -1
  92. package/dist/feature-libraries/modular-schema/crossFieldQueries.d.ts +100 -24
  93. package/dist/feature-libraries/modular-schema/crossFieldQueries.d.ts.map +1 -1
  94. package/dist/feature-libraries/modular-schema/crossFieldQueries.js +8 -12
  95. package/dist/feature-libraries/modular-schema/crossFieldQueries.js.map +1 -1
  96. package/dist/feature-libraries/modular-schema/fieldChangeHandler.d.ts +85 -51
  97. package/dist/feature-libraries/modular-schema/fieldChangeHandler.d.ts.map +1 -1
  98. package/dist/feature-libraries/modular-schema/fieldChangeHandler.js.map +1 -1
  99. package/dist/feature-libraries/modular-schema/genericFieldKind.d.ts.map +1 -1
  100. package/dist/feature-libraries/modular-schema/genericFieldKind.js +4 -9
  101. package/dist/feature-libraries/modular-schema/genericFieldKind.js.map +1 -1
  102. package/dist/feature-libraries/modular-schema/index.d.ts +3 -3
  103. package/dist/feature-libraries/modular-schema/index.d.ts.map +1 -1
  104. package/dist/feature-libraries/modular-schema/index.js +2 -3
  105. package/dist/feature-libraries/modular-schema/index.js.map +1 -1
  106. package/dist/feature-libraries/modular-schema/modularChangeCodecV1.d.ts +18 -22
  107. package/dist/feature-libraries/modular-schema/modularChangeCodecV1.d.ts.map +1 -1
  108. package/dist/feature-libraries/modular-schema/modularChangeCodecV1.js +276 -158
  109. package/dist/feature-libraries/modular-schema/modularChangeCodecV1.js.map +1 -1
  110. package/dist/feature-libraries/modular-schema/modularChangeCodecV2.d.ts.map +1 -1
  111. package/dist/feature-libraries/modular-schema/modularChangeCodecV2.js +1 -1
  112. package/dist/feature-libraries/modular-schema/modularChangeCodecV2.js.map +1 -1
  113. package/dist/feature-libraries/modular-schema/modularChangeCodecV3.d.ts +15 -0
  114. package/dist/feature-libraries/modular-schema/modularChangeCodecV3.d.ts.map +1 -0
  115. package/dist/feature-libraries/modular-schema/modularChangeCodecV3.js +296 -0
  116. package/dist/feature-libraries/modular-schema/modularChangeCodecV3.js.map +1 -0
  117. package/dist/feature-libraries/modular-schema/modularChangeCodecs.d.ts +1 -0
  118. package/dist/feature-libraries/modular-schema/modularChangeCodecs.d.ts.map +1 -1
  119. package/dist/feature-libraries/modular-schema/modularChangeCodecs.js +8 -0
  120. package/dist/feature-libraries/modular-schema/modularChangeCodecs.js.map +1 -1
  121. package/dist/feature-libraries/modular-schema/modularChangeFamily.d.ts +56 -22
  122. package/dist/feature-libraries/modular-schema/modularChangeFamily.d.ts.map +1 -1
  123. package/dist/feature-libraries/modular-schema/modularChangeFamily.js +1390 -462
  124. package/dist/feature-libraries/modular-schema/modularChangeFamily.js.map +1 -1
  125. package/dist/feature-libraries/modular-schema/modularChangeFormatV1.d.ts.map +1 -1
  126. package/dist/feature-libraries/modular-schema/modularChangeFormatV1.js.map +1 -1
  127. package/dist/feature-libraries/modular-schema/modularChangeFormatV2.d.ts +1 -2
  128. package/dist/feature-libraries/modular-schema/modularChangeFormatV2.d.ts.map +1 -1
  129. package/dist/feature-libraries/modular-schema/modularChangeFormatV2.js +3 -3
  130. package/dist/feature-libraries/modular-schema/modularChangeFormatV2.js.map +1 -1
  131. package/dist/feature-libraries/modular-schema/modularChangeFormatV3.d.ts +74 -0
  132. package/dist/feature-libraries/modular-schema/modularChangeFormatV3.d.ts.map +1 -0
  133. package/dist/feature-libraries/modular-schema/modularChangeFormatV3.js +35 -0
  134. package/dist/feature-libraries/modular-schema/modularChangeFormatV3.js.map +1 -0
  135. package/dist/feature-libraries/modular-schema/modularChangeTypes.d.ts +49 -10
  136. package/dist/feature-libraries/modular-schema/modularChangeTypes.d.ts.map +1 -1
  137. package/dist/feature-libraries/modular-schema/modularChangeTypes.js +3 -3
  138. package/dist/feature-libraries/modular-schema/modularChangeTypes.js.map +1 -1
  139. package/dist/feature-libraries/optional-field/optionalField.d.ts +13 -32
  140. package/dist/feature-libraries/optional-field/optionalField.d.ts.map +1 -1
  141. package/dist/feature-libraries/optional-field/optionalField.js +257 -446
  142. package/dist/feature-libraries/optional-field/optionalField.js.map +1 -1
  143. package/dist/feature-libraries/optional-field/optionalFieldChangeFormatV3.d.ts +23 -0
  144. package/dist/feature-libraries/optional-field/optionalFieldChangeFormatV3.d.ts.map +1 -0
  145. package/dist/feature-libraries/optional-field/optionalFieldChangeFormatV3.js +31 -0
  146. package/dist/feature-libraries/optional-field/optionalFieldChangeFormatV3.js.map +1 -0
  147. package/dist/feature-libraries/optional-field/optionalFieldChangeTypes.d.ts +31 -31
  148. package/dist/feature-libraries/optional-field/optionalFieldChangeTypes.d.ts.map +1 -1
  149. package/dist/feature-libraries/optional-field/optionalFieldChangeTypes.js.map +1 -1
  150. package/dist/feature-libraries/optional-field/optionalFieldCodecV2.d.ts +1 -1
  151. package/dist/feature-libraries/optional-field/optionalFieldCodecV2.d.ts.map +1 -1
  152. package/dist/feature-libraries/optional-field/optionalFieldCodecV2.js +57 -28
  153. package/dist/feature-libraries/optional-field/optionalFieldCodecV2.js.map +1 -1
  154. package/dist/feature-libraries/optional-field/optionalFieldCodecV3.d.ts +12 -0
  155. package/dist/feature-libraries/optional-field/optionalFieldCodecV3.d.ts.map +1 -0
  156. package/dist/feature-libraries/optional-field/optionalFieldCodecV3.js +57 -0
  157. package/dist/feature-libraries/optional-field/optionalFieldCodecV3.js.map +1 -0
  158. package/dist/feature-libraries/optional-field/optionalFieldCodecs.d.ts.map +1 -1
  159. package/dist/feature-libraries/optional-field/optionalFieldCodecs.js +5 -1
  160. package/dist/feature-libraries/optional-field/optionalFieldCodecs.js.map +1 -1
  161. package/dist/feature-libraries/optional-field/requiredField.d.ts +3 -2
  162. package/dist/feature-libraries/optional-field/requiredField.d.ts.map +1 -1
  163. package/dist/feature-libraries/optional-field/requiredField.js +6 -1
  164. package/dist/feature-libraries/optional-field/requiredField.js.map +1 -1
  165. package/dist/feature-libraries/sequence-field/compose.d.ts +6 -7
  166. package/dist/feature-libraries/sequence-field/compose.d.ts.map +1 -1
  167. package/dist/feature-libraries/sequence-field/compose.js +81 -259
  168. package/dist/feature-libraries/sequence-field/compose.js.map +1 -1
  169. package/dist/feature-libraries/sequence-field/helperTypes.d.ts +14 -10
  170. package/dist/feature-libraries/sequence-field/helperTypes.d.ts.map +1 -1
  171. package/dist/feature-libraries/sequence-field/helperTypes.js.map +1 -1
  172. package/dist/feature-libraries/sequence-field/invert.d.ts +3 -3
  173. package/dist/feature-libraries/sequence-field/invert.d.ts.map +1 -1
  174. package/dist/feature-libraries/sequence-field/invert.js +65 -167
  175. package/dist/feature-libraries/sequence-field/invert.js.map +1 -1
  176. package/dist/feature-libraries/sequence-field/markQueue.d.ts +2 -2
  177. package/dist/feature-libraries/sequence-field/markQueue.d.ts.map +1 -1
  178. package/dist/feature-libraries/sequence-field/markQueue.js.map +1 -1
  179. package/dist/feature-libraries/sequence-field/moveEffectTable.d.ts +4 -56
  180. package/dist/feature-libraries/sequence-field/moveEffectTable.d.ts.map +1 -1
  181. package/dist/feature-libraries/sequence-field/moveEffectTable.js +7 -90
  182. package/dist/feature-libraries/sequence-field/moveEffectTable.js.map +1 -1
  183. package/dist/feature-libraries/sequence-field/rebase.d.ts +3 -3
  184. package/dist/feature-libraries/sequence-field/rebase.d.ts.map +1 -1
  185. package/dist/feature-libraries/sequence-field/rebase.js +109 -116
  186. package/dist/feature-libraries/sequence-field/rebase.js.map +1 -1
  187. package/dist/feature-libraries/sequence-field/replaceRevisions.d.ts.map +1 -1
  188. package/dist/feature-libraries/sequence-field/replaceRevisions.js +19 -32
  189. package/dist/feature-libraries/sequence-field/replaceRevisions.js.map +1 -1
  190. package/dist/feature-libraries/sequence-field/sequenceFieldChangeHandler.d.ts.map +1 -1
  191. package/dist/feature-libraries/sequence-field/sequenceFieldChangeHandler.js +1 -2
  192. package/dist/feature-libraries/sequence-field/sequenceFieldChangeHandler.js.map +1 -1
  193. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV2.d.ts +22 -4
  194. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV2.d.ts.map +1 -1
  195. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV2.js +388 -187
  196. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV2.js.map +1 -1
  197. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV3.d.ts.map +1 -1
  198. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV3.js +20 -62
  199. package/dist/feature-libraries/sequence-field/sequenceFieldCodecV3.js.map +1 -1
  200. package/dist/feature-libraries/sequence-field/sequenceFieldEditor.d.ts +2 -2
  201. package/dist/feature-libraries/sequence-field/sequenceFieldEditor.d.ts.map +1 -1
  202. package/dist/feature-libraries/sequence-field/sequenceFieldEditor.js +13 -13
  203. package/dist/feature-libraries/sequence-field/sequenceFieldEditor.js.map +1 -1
  204. package/dist/feature-libraries/sequence-field/sequenceFieldToDelta.d.ts +3 -2
  205. package/dist/feature-libraries/sequence-field/sequenceFieldToDelta.d.ts.map +1 -1
  206. package/dist/feature-libraries/sequence-field/sequenceFieldToDelta.js +16 -111
  207. package/dist/feature-libraries/sequence-field/sequenceFieldToDelta.js.map +1 -1
  208. package/dist/feature-libraries/sequence-field/types.d.ts +37 -74
  209. package/dist/feature-libraries/sequence-field/types.d.ts.map +1 -1
  210. package/dist/feature-libraries/sequence-field/types.js.map +1 -1
  211. package/dist/feature-libraries/sequence-field/utils.d.ts +20 -25
  212. package/dist/feature-libraries/sequence-field/utils.d.ts.map +1 -1
  213. package/dist/feature-libraries/sequence-field/utils.js +159 -320
  214. package/dist/feature-libraries/sequence-field/utils.js.map +1 -1
  215. package/dist/packageVersion.d.ts +1 -1
  216. package/dist/packageVersion.d.ts.map +1 -1
  217. package/dist/packageVersion.js +1 -1
  218. package/dist/packageVersion.js.map +1 -1
  219. package/dist/shared-tree/independentView.d.ts.map +1 -1
  220. package/dist/shared-tree/independentView.js +1 -1
  221. package/dist/shared-tree/independentView.js.map +1 -1
  222. package/dist/shared-tree/index.d.ts +1 -1
  223. package/dist/shared-tree/index.d.ts.map +1 -1
  224. package/dist/shared-tree/index.js.map +1 -1
  225. package/dist/shared-tree/schematizeTree.d.ts +4 -4
  226. package/dist/shared-tree/schematizeTree.d.ts.map +1 -1
  227. package/dist/shared-tree/schematizeTree.js +2 -1
  228. package/dist/shared-tree/schematizeTree.js.map +1 -1
  229. package/dist/shared-tree/schematizingTreeView.d.ts +1 -5
  230. package/dist/shared-tree/schematizingTreeView.d.ts.map +1 -1
  231. package/dist/shared-tree/schematizingTreeView.js +21 -35
  232. package/dist/shared-tree/schematizingTreeView.js.map +1 -1
  233. package/dist/shared-tree/sharedTree.d.ts +9 -3
  234. package/dist/shared-tree/sharedTree.d.ts.map +1 -1
  235. package/dist/shared-tree/sharedTree.js +4 -1
  236. package/dist/shared-tree/sharedTree.js.map +1 -1
  237. package/dist/shared-tree/sharedTreeChangeCodecs.d.ts +1 -0
  238. package/dist/shared-tree/sharedTreeChangeCodecs.d.ts.map +1 -1
  239. package/dist/shared-tree/sharedTreeChangeCodecs.js +8 -0
  240. package/dist/shared-tree/sharedTreeChangeCodecs.js.map +1 -1
  241. package/dist/shared-tree/sharedTreeChangeFamily.d.ts +4 -4
  242. package/dist/shared-tree/sharedTreeChangeFamily.d.ts.map +1 -1
  243. package/dist/shared-tree/sharedTreeChangeFamily.js +2 -2
  244. package/dist/shared-tree/sharedTreeChangeFamily.js.map +1 -1
  245. package/dist/shared-tree/sharedTreeEditBuilder.d.ts +16 -6
  246. package/dist/shared-tree/sharedTreeEditBuilder.d.ts.map +1 -1
  247. package/dist/shared-tree/sharedTreeEditBuilder.js +14 -7
  248. package/dist/shared-tree/sharedTreeEditBuilder.js.map +1 -1
  249. package/dist/shared-tree/treeCheckout.d.ts +13 -11
  250. package/dist/shared-tree/treeCheckout.d.ts.map +1 -1
  251. package/dist/shared-tree/treeCheckout.js +56 -6
  252. package/dist/shared-tree/treeCheckout.js.map +1 -1
  253. package/dist/shared-tree-core/branch.d.ts +3 -2
  254. package/dist/shared-tree-core/branch.d.ts.map +1 -1
  255. package/dist/shared-tree-core/branch.js +4 -3
  256. package/dist/shared-tree-core/branch.js.map +1 -1
  257. package/dist/shared-tree-core/editManager.d.ts +2 -2
  258. package/dist/shared-tree-core/editManager.d.ts.map +1 -1
  259. package/dist/shared-tree-core/editManager.js +9 -9
  260. package/dist/shared-tree-core/editManager.js.map +1 -1
  261. package/dist/shared-tree-core/editManagerCodecs.d.ts +4 -0
  262. package/dist/shared-tree-core/editManagerCodecs.d.ts.map +1 -1
  263. package/dist/shared-tree-core/editManagerCodecs.js +10 -2
  264. package/dist/shared-tree-core/editManagerCodecs.js.map +1 -1
  265. package/dist/shared-tree-core/editManagerFormatCommons.d.ts +1 -0
  266. package/dist/shared-tree-core/editManagerFormatCommons.d.ts.map +1 -1
  267. package/dist/shared-tree-core/editManagerFormatCommons.js +6 -0
  268. package/dist/shared-tree-core/editManagerFormatCommons.js.map +1 -1
  269. package/dist/shared-tree-core/editManagerFormatV1toV4.d.ts +2 -2
  270. package/dist/shared-tree-core/editManagerFormatV1toV4.d.ts.map +1 -1
  271. package/dist/shared-tree-core/editManagerFormatV1toV4.js +1 -0
  272. package/dist/shared-tree-core/editManagerFormatV1toV4.js.map +1 -1
  273. package/dist/shared-tree-core/index.d.ts +2 -2
  274. package/dist/shared-tree-core/index.d.ts.map +1 -1
  275. package/dist/shared-tree-core/index.js +3 -1
  276. package/dist/shared-tree-core/index.js.map +1 -1
  277. package/dist/shared-tree-core/messageCodecV1ToV4.d.ts +1 -1
  278. package/dist/shared-tree-core/messageCodecV1ToV4.d.ts.map +1 -1
  279. package/dist/shared-tree-core/messageCodecV1ToV4.js.map +1 -1
  280. package/dist/shared-tree-core/messageCodecs.d.ts +4 -0
  281. package/dist/shared-tree-core/messageCodecs.d.ts.map +1 -1
  282. package/dist/shared-tree-core/messageCodecs.js +10 -2
  283. package/dist/shared-tree-core/messageCodecs.js.map +1 -1
  284. package/dist/shared-tree-core/messageFormat.d.ts +1 -0
  285. package/dist/shared-tree-core/messageFormat.d.ts.map +1 -1
  286. package/dist/shared-tree-core/messageFormat.js +6 -0
  287. package/dist/shared-tree-core/messageFormat.js.map +1 -1
  288. package/dist/shared-tree-core/messageFormatV1ToV4.d.ts +2 -2
  289. package/dist/shared-tree-core/messageFormatV1ToV4.d.ts.map +1 -1
  290. package/dist/shared-tree-core/messageFormatV1ToV4.js +1 -0
  291. package/dist/shared-tree-core/messageFormatV1ToV4.js.map +1 -1
  292. package/dist/shared-tree-core/sharedTreeCore.d.ts +1 -0
  293. package/dist/shared-tree-core/sharedTreeCore.d.ts.map +1 -1
  294. package/dist/shared-tree-core/sharedTreeCore.js +1 -1
  295. package/dist/shared-tree-core/sharedTreeCore.js.map +1 -1
  296. package/dist/simple-tree/core/unhydratedFlexTree.d.ts +16 -12
  297. package/dist/simple-tree/core/unhydratedFlexTree.d.ts.map +1 -1
  298. package/dist/simple-tree/core/unhydratedFlexTree.js +59 -8
  299. package/dist/simple-tree/core/unhydratedFlexTree.js.map +1 -1
  300. package/dist/simple-tree/fieldSchema.d.ts +4 -4
  301. package/dist/simple-tree/fieldSchema.d.ts.map +1 -1
  302. package/dist/simple-tree/fieldSchema.js.map +1 -1
  303. package/dist/simple-tree/index.d.ts +2 -2
  304. package/dist/simple-tree/index.d.ts.map +1 -1
  305. package/dist/simple-tree/index.js +1 -1
  306. package/dist/simple-tree/index.js.map +1 -1
  307. package/dist/simple-tree/node-kinds/array/arrayNode.d.ts.map +1 -1
  308. package/dist/simple-tree/node-kinds/array/arrayNode.js +5 -3
  309. package/dist/simple-tree/node-kinds/array/arrayNode.js.map +1 -1
  310. package/dist/simple-tree/node-kinds/common.d.ts.map +1 -1
  311. package/dist/simple-tree/node-kinds/common.js +1 -1
  312. package/dist/simple-tree/node-kinds/common.js.map +1 -1
  313. package/dist/simple-tree/node-kinds/map/mapNode.js +2 -2
  314. package/dist/simple-tree/node-kinds/map/mapNode.js.map +1 -1
  315. package/dist/simple-tree/node-kinds/object/objectNode.d.ts.map +1 -1
  316. package/dist/simple-tree/node-kinds/object/objectNode.js +19 -19
  317. package/dist/simple-tree/node-kinds/object/objectNode.js.map +1 -1
  318. package/dist/simple-tree/node-kinds/record/recordNode.d.ts.map +1 -1
  319. package/dist/simple-tree/node-kinds/record/recordNode.js +4 -2
  320. package/dist/simple-tree/node-kinds/record/recordNode.js.map +1 -1
  321. package/dist/simple-tree/prepareForInsertion.d.ts +54 -47
  322. package/dist/simple-tree/prepareForInsertion.d.ts.map +1 -1
  323. package/dist/simple-tree/prepareForInsertion.js +183 -125
  324. package/dist/simple-tree/prepareForInsertion.js.map +1 -1
  325. package/dist/simple-tree/unhydratedFlexTreeFromInsertable.d.ts +8 -3
  326. package/dist/simple-tree/unhydratedFlexTreeFromInsertable.d.ts.map +1 -1
  327. package/dist/simple-tree/unhydratedFlexTreeFromInsertable.js +27 -13
  328. package/dist/simple-tree/unhydratedFlexTreeFromInsertable.js.map +1 -1
  329. package/dist/treeFactory.d.ts.map +1 -1
  330. package/dist/treeFactory.js +12 -2
  331. package/dist/treeFactory.js.map +1 -1
  332. package/dist/util/index.d.ts +1 -1
  333. package/dist/util/index.d.ts.map +1 -1
  334. package/dist/util/index.js +2 -1
  335. package/dist/util/index.js.map +1 -1
  336. package/dist/util/rangeMap.d.ts +23 -11
  337. package/dist/util/rangeMap.d.ts.map +1 -1
  338. package/dist/util/rangeMap.js +43 -10
  339. package/dist/util/rangeMap.js.map +1 -1
  340. package/lib/core/change-family/changeFamily.d.ts +4 -1
  341. package/lib/core/change-family/changeFamily.d.ts.map +1 -1
  342. package/lib/core/change-family/changeFamily.js.map +1 -1
  343. package/lib/core/change-family/index.d.ts +1 -1
  344. package/lib/core/change-family/index.d.ts.map +1 -1
  345. package/lib/core/change-family/index.js.map +1 -1
  346. package/lib/core/index.d.ts +3 -3
  347. package/lib/core/index.d.ts.map +1 -1
  348. package/lib/core/index.js +2 -2
  349. package/lib/core/index.js.map +1 -1
  350. package/lib/core/rebase/changeRebaser.d.ts +6 -1
  351. package/lib/core/rebase/changeRebaser.d.ts.map +1 -1
  352. package/lib/core/rebase/changeRebaser.js.map +1 -1
  353. package/lib/core/rebase/index.d.ts +1 -1
  354. package/lib/core/rebase/index.d.ts.map +1 -1
  355. package/lib/core/rebase/index.js +1 -1
  356. package/lib/core/rebase/index.js.map +1 -1
  357. package/lib/core/rebase/types.d.ts +1 -0
  358. package/lib/core/rebase/types.d.ts.map +1 -1
  359. package/lib/core/rebase/types.js +3 -0
  360. package/lib/core/rebase/types.js.map +1 -1
  361. package/lib/core/rebase/utils.d.ts.map +1 -1
  362. package/lib/core/rebase/utils.js +25 -7
  363. package/lib/core/rebase/utils.js.map +1 -1
  364. package/lib/core/tree/delta.d.ts +5 -0
  365. package/lib/core/tree/delta.d.ts.map +1 -1
  366. package/lib/core/tree/delta.js.map +1 -1
  367. package/lib/core/tree/detachedFieldIndex.d.ts +13 -1
  368. package/lib/core/tree/detachedFieldIndex.d.ts.map +1 -1
  369. package/lib/core/tree/detachedFieldIndex.js +15 -2
  370. package/lib/core/tree/detachedFieldIndex.js.map +1 -1
  371. package/lib/core/tree/detachedFieldIndexTypes.d.ts +4 -0
  372. package/lib/core/tree/detachedFieldIndexTypes.d.ts.map +1 -1
  373. package/lib/core/tree/detachedFieldIndexTypes.js.map +1 -1
  374. package/lib/core/tree/index.d.ts +2 -2
  375. package/lib/core/tree/index.d.ts.map +1 -1
  376. package/lib/core/tree/index.js +1 -1
  377. package/lib/core/tree/index.js.map +1 -1
  378. package/lib/core/tree/pathTree.d.ts +11 -3
  379. package/lib/core/tree/pathTree.d.ts.map +1 -1
  380. package/lib/core/tree/pathTree.js +12 -1
  381. package/lib/core/tree/pathTree.js.map +1 -1
  382. package/lib/core/tree/visitDelta.d.ts.map +1 -1
  383. package/lib/core/tree/visitDelta.js +17 -13
  384. package/lib/core/tree/visitDelta.js.map +1 -1
  385. package/lib/feature-libraries/changeAtomIdBTree.d.ts +3 -2
  386. package/lib/feature-libraries/changeAtomIdBTree.d.ts.map +1 -1
  387. package/lib/feature-libraries/changeAtomIdBTree.js +15 -3
  388. package/lib/feature-libraries/changeAtomIdBTree.js.map +1 -1
  389. package/lib/feature-libraries/default-schema/defaultEditBuilder.d.ts +92 -44
  390. package/lib/feature-libraries/default-schema/defaultEditBuilder.d.ts.map +1 -1
  391. package/lib/feature-libraries/default-schema/defaultEditBuilder.js +217 -69
  392. package/lib/feature-libraries/default-schema/defaultEditBuilder.js.map +1 -1
  393. package/lib/feature-libraries/default-schema/defaultFieldKinds.d.ts.map +1 -1
  394. package/lib/feature-libraries/default-schema/defaultFieldKinds.js +12 -2
  395. package/lib/feature-libraries/default-schema/defaultFieldKinds.js.map +1 -1
  396. package/lib/feature-libraries/default-schema/index.d.ts +2 -1
  397. package/lib/feature-libraries/default-schema/index.d.ts.map +1 -1
  398. package/lib/feature-libraries/default-schema/index.js +2 -1
  399. package/lib/feature-libraries/default-schema/index.js.map +1 -1
  400. package/lib/feature-libraries/default-schema/locationBasedEditBuilder.d.ts +40 -0
  401. package/lib/feature-libraries/default-schema/locationBasedEditBuilder.d.ts.map +1 -0
  402. package/lib/feature-libraries/default-schema/locationBasedEditBuilder.js +149 -0
  403. package/lib/feature-libraries/default-schema/locationBasedEditBuilder.js.map +1 -0
  404. package/lib/feature-libraries/default-schema/mappedEditBuilder.d.ts +7 -6
  405. package/lib/feature-libraries/default-schema/mappedEditBuilder.d.ts.map +1 -1
  406. package/lib/feature-libraries/default-schema/mappedEditBuilder.js +15 -0
  407. package/lib/feature-libraries/default-schema/mappedEditBuilder.js.map +1 -1
  408. package/lib/feature-libraries/deltaUtils.d.ts +1 -0
  409. package/lib/feature-libraries/deltaUtils.d.ts.map +1 -1
  410. package/lib/feature-libraries/deltaUtils.js +5 -1
  411. package/lib/feature-libraries/deltaUtils.js.map +1 -1
  412. package/lib/feature-libraries/flex-tree/context.d.ts +9 -0
  413. package/lib/feature-libraries/flex-tree/context.d.ts.map +1 -1
  414. package/lib/feature-libraries/flex-tree/context.js +6 -0
  415. package/lib/feature-libraries/flex-tree/context.js.map +1 -1
  416. package/lib/feature-libraries/flex-tree/flexTreeTypes.d.ts +6 -6
  417. package/lib/feature-libraries/flex-tree/flexTreeTypes.d.ts.map +1 -1
  418. package/lib/feature-libraries/flex-tree/flexTreeTypes.js.map +1 -1
  419. package/lib/feature-libraries/flex-tree/lazyField.d.ts +8 -7
  420. package/lib/feature-libraries/flex-tree/lazyField.d.ts.map +1 -1
  421. package/lib/feature-libraries/flex-tree/lazyField.js +40 -9
  422. package/lib/feature-libraries/flex-tree/lazyField.js.map +1 -1
  423. package/lib/feature-libraries/index.d.ts +3 -3
  424. package/lib/feature-libraries/index.d.ts.map +1 -1
  425. package/lib/feature-libraries/index.js +3 -3
  426. package/lib/feature-libraries/index.js.map +1 -1
  427. package/lib/feature-libraries/mitigatedChangeFamily.d.ts.map +1 -1
  428. package/lib/feature-libraries/mitigatedChangeFamily.js +2 -2
  429. package/lib/feature-libraries/mitigatedChangeFamily.js.map +1 -1
  430. package/lib/feature-libraries/modular-schema/crossFieldQueries.d.ts +100 -24
  431. package/lib/feature-libraries/modular-schema/crossFieldQueries.d.ts.map +1 -1
  432. package/lib/feature-libraries/modular-schema/crossFieldQueries.js +7 -10
  433. package/lib/feature-libraries/modular-schema/crossFieldQueries.js.map +1 -1
  434. package/lib/feature-libraries/modular-schema/fieldChangeHandler.d.ts +85 -51
  435. package/lib/feature-libraries/modular-schema/fieldChangeHandler.d.ts.map +1 -1
  436. package/lib/feature-libraries/modular-schema/fieldChangeHandler.js.map +1 -1
  437. package/lib/feature-libraries/modular-schema/genericFieldKind.d.ts.map +1 -1
  438. package/lib/feature-libraries/modular-schema/genericFieldKind.js +4 -9
  439. package/lib/feature-libraries/modular-schema/genericFieldKind.js.map +1 -1
  440. package/lib/feature-libraries/modular-schema/index.d.ts +3 -3
  441. package/lib/feature-libraries/modular-schema/index.d.ts.map +1 -1
  442. package/lib/feature-libraries/modular-schema/index.js +1 -1
  443. package/lib/feature-libraries/modular-schema/index.js.map +1 -1
  444. package/lib/feature-libraries/modular-schema/modularChangeCodecV1.d.ts +18 -22
  445. package/lib/feature-libraries/modular-schema/modularChangeCodecV1.d.ts.map +1 -1
  446. package/lib/feature-libraries/modular-schema/modularChangeCodecV1.js +267 -144
  447. package/lib/feature-libraries/modular-schema/modularChangeCodecV1.js.map +1 -1
  448. package/lib/feature-libraries/modular-schema/modularChangeCodecV2.d.ts.map +1 -1
  449. package/lib/feature-libraries/modular-schema/modularChangeCodecV2.js +1 -1
  450. package/lib/feature-libraries/modular-schema/modularChangeCodecV2.js.map +1 -1
  451. package/lib/feature-libraries/modular-schema/modularChangeCodecV3.d.ts +15 -0
  452. package/lib/feature-libraries/modular-schema/modularChangeCodecV3.d.ts.map +1 -0
  453. package/lib/feature-libraries/modular-schema/modularChangeCodecV3.js +292 -0
  454. package/lib/feature-libraries/modular-schema/modularChangeCodecV3.js.map +1 -0
  455. package/lib/feature-libraries/modular-schema/modularChangeCodecs.d.ts +1 -0
  456. package/lib/feature-libraries/modular-schema/modularChangeCodecs.d.ts.map +1 -1
  457. package/lib/feature-libraries/modular-schema/modularChangeCodecs.js +8 -0
  458. package/lib/feature-libraries/modular-schema/modularChangeCodecs.js.map +1 -1
  459. package/lib/feature-libraries/modular-schema/modularChangeFamily.d.ts +56 -22
  460. package/lib/feature-libraries/modular-schema/modularChangeFamily.d.ts.map +1 -1
  461. package/lib/feature-libraries/modular-schema/modularChangeFamily.js +1387 -468
  462. package/lib/feature-libraries/modular-schema/modularChangeFamily.js.map +1 -1
  463. package/lib/feature-libraries/modular-schema/modularChangeFormatV1.d.ts.map +1 -1
  464. package/lib/feature-libraries/modular-schema/modularChangeFormatV1.js.map +1 -1
  465. package/lib/feature-libraries/modular-schema/modularChangeFormatV2.d.ts +1 -2
  466. package/lib/feature-libraries/modular-schema/modularChangeFormatV2.d.ts.map +1 -1
  467. package/lib/feature-libraries/modular-schema/modularChangeFormatV2.js +1 -1
  468. package/lib/feature-libraries/modular-schema/modularChangeFormatV2.js.map +1 -1
  469. package/lib/feature-libraries/modular-schema/modularChangeFormatV3.d.ts +74 -0
  470. package/lib/feature-libraries/modular-schema/modularChangeFormatV3.d.ts.map +1 -0
  471. package/lib/feature-libraries/modular-schema/modularChangeFormatV3.js +32 -0
  472. package/lib/feature-libraries/modular-schema/modularChangeFormatV3.js.map +1 -0
  473. package/lib/feature-libraries/modular-schema/modularChangeTypes.d.ts +49 -10
  474. package/lib/feature-libraries/modular-schema/modularChangeTypes.d.ts.map +1 -1
  475. package/lib/feature-libraries/modular-schema/modularChangeTypes.js +1 -1
  476. package/lib/feature-libraries/modular-schema/modularChangeTypes.js.map +1 -1
  477. package/lib/feature-libraries/optional-field/optionalField.d.ts +13 -32
  478. package/lib/feature-libraries/optional-field/optionalField.d.ts.map +1 -1
  479. package/lib/feature-libraries/optional-field/optionalField.js +254 -442
  480. package/lib/feature-libraries/optional-field/optionalField.js.map +1 -1
  481. package/lib/feature-libraries/optional-field/optionalFieldChangeFormatV3.d.ts +23 -0
  482. package/lib/feature-libraries/optional-field/optionalFieldChangeFormatV3.d.ts.map +1 -0
  483. package/lib/feature-libraries/optional-field/optionalFieldChangeFormatV3.js +27 -0
  484. package/lib/feature-libraries/optional-field/optionalFieldChangeFormatV3.js.map +1 -0
  485. package/lib/feature-libraries/optional-field/optionalFieldChangeTypes.d.ts +31 -31
  486. package/lib/feature-libraries/optional-field/optionalFieldChangeTypes.d.ts.map +1 -1
  487. package/lib/feature-libraries/optional-field/optionalFieldChangeTypes.js.map +1 -1
  488. package/lib/feature-libraries/optional-field/optionalFieldCodecV2.d.ts +1 -1
  489. package/lib/feature-libraries/optional-field/optionalFieldCodecV2.d.ts.map +1 -1
  490. package/lib/feature-libraries/optional-field/optionalFieldCodecV2.js +55 -26
  491. package/lib/feature-libraries/optional-field/optionalFieldCodecV2.js.map +1 -1
  492. package/lib/feature-libraries/optional-field/optionalFieldCodecV3.d.ts +12 -0
  493. package/lib/feature-libraries/optional-field/optionalFieldCodecV3.d.ts.map +1 -0
  494. package/lib/feature-libraries/optional-field/optionalFieldCodecV3.js +53 -0
  495. package/lib/feature-libraries/optional-field/optionalFieldCodecV3.js.map +1 -0
  496. package/lib/feature-libraries/optional-field/optionalFieldCodecs.d.ts.map +1 -1
  497. package/lib/feature-libraries/optional-field/optionalFieldCodecs.js +5 -1
  498. package/lib/feature-libraries/optional-field/optionalFieldCodecs.js.map +1 -1
  499. package/lib/feature-libraries/optional-field/requiredField.d.ts +3 -2
  500. package/lib/feature-libraries/optional-field/requiredField.d.ts.map +1 -1
  501. package/lib/feature-libraries/optional-field/requiredField.js +5 -1
  502. package/lib/feature-libraries/optional-field/requiredField.js.map +1 -1
  503. package/lib/feature-libraries/sequence-field/compose.d.ts +6 -7
  504. package/lib/feature-libraries/sequence-field/compose.d.ts.map +1 -1
  505. package/lib/feature-libraries/sequence-field/compose.js +83 -261
  506. package/lib/feature-libraries/sequence-field/compose.js.map +1 -1
  507. package/lib/feature-libraries/sequence-field/helperTypes.d.ts +14 -10
  508. package/lib/feature-libraries/sequence-field/helperTypes.d.ts.map +1 -1
  509. package/lib/feature-libraries/sequence-field/helperTypes.js.map +1 -1
  510. package/lib/feature-libraries/sequence-field/invert.d.ts +3 -3
  511. package/lib/feature-libraries/sequence-field/invert.d.ts.map +1 -1
  512. package/lib/feature-libraries/sequence-field/invert.js +67 -169
  513. package/lib/feature-libraries/sequence-field/invert.js.map +1 -1
  514. package/lib/feature-libraries/sequence-field/markQueue.d.ts +2 -2
  515. package/lib/feature-libraries/sequence-field/markQueue.d.ts.map +1 -1
  516. package/lib/feature-libraries/sequence-field/markQueue.js.map +1 -1
  517. package/lib/feature-libraries/sequence-field/moveEffectTable.d.ts +4 -56
  518. package/lib/feature-libraries/sequence-field/moveEffectTable.d.ts.map +1 -1
  519. package/lib/feature-libraries/sequence-field/moveEffectTable.js +6 -84
  520. package/lib/feature-libraries/sequence-field/moveEffectTable.js.map +1 -1
  521. package/lib/feature-libraries/sequence-field/rebase.d.ts +3 -3
  522. package/lib/feature-libraries/sequence-field/rebase.d.ts.map +1 -1
  523. package/lib/feature-libraries/sequence-field/rebase.js +111 -118
  524. package/lib/feature-libraries/sequence-field/rebase.js.map +1 -1
  525. package/lib/feature-libraries/sequence-field/replaceRevisions.d.ts.map +1 -1
  526. package/lib/feature-libraries/sequence-field/replaceRevisions.js +19 -32
  527. package/lib/feature-libraries/sequence-field/replaceRevisions.js.map +1 -1
  528. package/lib/feature-libraries/sequence-field/sequenceFieldChangeHandler.d.ts.map +1 -1
  529. package/lib/feature-libraries/sequence-field/sequenceFieldChangeHandler.js +2 -3
  530. package/lib/feature-libraries/sequence-field/sequenceFieldChangeHandler.js.map +1 -1
  531. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV2.d.ts +22 -4
  532. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV2.d.ts.map +1 -1
  533. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV2.js +379 -182
  534. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV2.js.map +1 -1
  535. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV3.d.ts.map +1 -1
  536. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV3.js +21 -63
  537. package/lib/feature-libraries/sequence-field/sequenceFieldCodecV3.js.map +1 -1
  538. package/lib/feature-libraries/sequence-field/sequenceFieldEditor.d.ts +2 -2
  539. package/lib/feature-libraries/sequence-field/sequenceFieldEditor.d.ts.map +1 -1
  540. package/lib/feature-libraries/sequence-field/sequenceFieldEditor.js +13 -13
  541. package/lib/feature-libraries/sequence-field/sequenceFieldEditor.js.map +1 -1
  542. package/lib/feature-libraries/sequence-field/sequenceFieldToDelta.d.ts +3 -2
  543. package/lib/feature-libraries/sequence-field/sequenceFieldToDelta.d.ts.map +1 -1
  544. package/lib/feature-libraries/sequence-field/sequenceFieldToDelta.js +16 -111
  545. package/lib/feature-libraries/sequence-field/sequenceFieldToDelta.js.map +1 -1
  546. package/lib/feature-libraries/sequence-field/types.d.ts +37 -74
  547. package/lib/feature-libraries/sequence-field/types.d.ts.map +1 -1
  548. package/lib/feature-libraries/sequence-field/types.js.map +1 -1
  549. package/lib/feature-libraries/sequence-field/utils.d.ts +20 -25
  550. package/lib/feature-libraries/sequence-field/utils.d.ts.map +1 -1
  551. package/lib/feature-libraries/sequence-field/utils.js +155 -313
  552. package/lib/feature-libraries/sequence-field/utils.js.map +1 -1
  553. package/lib/packageVersion.d.ts +1 -1
  554. package/lib/packageVersion.d.ts.map +1 -1
  555. package/lib/packageVersion.js +1 -1
  556. package/lib/packageVersion.js.map +1 -1
  557. package/lib/shared-tree/independentView.d.ts.map +1 -1
  558. package/lib/shared-tree/independentView.js +1 -1
  559. package/lib/shared-tree/independentView.js.map +1 -1
  560. package/lib/shared-tree/index.d.ts +1 -1
  561. package/lib/shared-tree/index.d.ts.map +1 -1
  562. package/lib/shared-tree/index.js.map +1 -1
  563. package/lib/shared-tree/schematizeTree.d.ts +4 -4
  564. package/lib/shared-tree/schematizeTree.d.ts.map +1 -1
  565. package/lib/shared-tree/schematizeTree.js +3 -2
  566. package/lib/shared-tree/schematizeTree.js.map +1 -1
  567. package/lib/shared-tree/schematizingTreeView.d.ts +1 -5
  568. package/lib/shared-tree/schematizingTreeView.d.ts.map +1 -1
  569. package/lib/shared-tree/schematizingTreeView.js +24 -38
  570. package/lib/shared-tree/schematizingTreeView.js.map +1 -1
  571. package/lib/shared-tree/sharedTree.d.ts +9 -3
  572. package/lib/shared-tree/sharedTree.d.ts.map +1 -1
  573. package/lib/shared-tree/sharedTree.js +4 -1
  574. package/lib/shared-tree/sharedTree.js.map +1 -1
  575. package/lib/shared-tree/sharedTreeChangeCodecs.d.ts +1 -0
  576. package/lib/shared-tree/sharedTreeChangeCodecs.d.ts.map +1 -1
  577. package/lib/shared-tree/sharedTreeChangeCodecs.js +8 -0
  578. package/lib/shared-tree/sharedTreeChangeCodecs.js.map +1 -1
  579. package/lib/shared-tree/sharedTreeChangeFamily.d.ts +4 -4
  580. package/lib/shared-tree/sharedTreeChangeFamily.d.ts.map +1 -1
  581. package/lib/shared-tree/sharedTreeChangeFamily.js +3 -3
  582. package/lib/shared-tree/sharedTreeChangeFamily.js.map +1 -1
  583. package/lib/shared-tree/sharedTreeEditBuilder.d.ts +16 -6
  584. package/lib/shared-tree/sharedTreeEditBuilder.d.ts.map +1 -1
  585. package/lib/shared-tree/sharedTreeEditBuilder.js +12 -6
  586. package/lib/shared-tree/sharedTreeEditBuilder.js.map +1 -1
  587. package/lib/shared-tree/treeCheckout.d.ts +13 -11
  588. package/lib/shared-tree/treeCheckout.d.ts.map +1 -1
  589. package/lib/shared-tree/treeCheckout.js +59 -9
  590. package/lib/shared-tree/treeCheckout.js.map +1 -1
  591. package/lib/shared-tree-core/branch.d.ts +3 -2
  592. package/lib/shared-tree-core/branch.d.ts.map +1 -1
  593. package/lib/shared-tree-core/branch.js +4 -3
  594. package/lib/shared-tree-core/branch.js.map +1 -1
  595. package/lib/shared-tree-core/editManager.d.ts +2 -2
  596. package/lib/shared-tree-core/editManager.d.ts.map +1 -1
  597. package/lib/shared-tree-core/editManager.js +9 -9
  598. package/lib/shared-tree-core/editManager.js.map +1 -1
  599. package/lib/shared-tree-core/editManagerCodecs.d.ts +4 -0
  600. package/lib/shared-tree-core/editManagerCodecs.d.ts.map +1 -1
  601. package/lib/shared-tree-core/editManagerCodecs.js +8 -1
  602. package/lib/shared-tree-core/editManagerCodecs.js.map +1 -1
  603. package/lib/shared-tree-core/editManagerFormatCommons.d.ts +1 -0
  604. package/lib/shared-tree-core/editManagerFormatCommons.d.ts.map +1 -1
  605. package/lib/shared-tree-core/editManagerFormatCommons.js +6 -0
  606. package/lib/shared-tree-core/editManagerFormatCommons.js.map +1 -1
  607. package/lib/shared-tree-core/editManagerFormatV1toV4.d.ts +2 -2
  608. package/lib/shared-tree-core/editManagerFormatV1toV4.d.ts.map +1 -1
  609. package/lib/shared-tree-core/editManagerFormatV1toV4.js +1 -0
  610. package/lib/shared-tree-core/editManagerFormatV1toV4.js.map +1 -1
  611. package/lib/shared-tree-core/index.d.ts +2 -2
  612. package/lib/shared-tree-core/index.d.ts.map +1 -1
  613. package/lib/shared-tree-core/index.js +2 -2
  614. package/lib/shared-tree-core/index.js.map +1 -1
  615. package/lib/shared-tree-core/messageCodecV1ToV4.d.ts +1 -1
  616. package/lib/shared-tree-core/messageCodecV1ToV4.d.ts.map +1 -1
  617. package/lib/shared-tree-core/messageCodecV1ToV4.js.map +1 -1
  618. package/lib/shared-tree-core/messageCodecs.d.ts +4 -0
  619. package/lib/shared-tree-core/messageCodecs.d.ts.map +1 -1
  620. package/lib/shared-tree-core/messageCodecs.js +8 -1
  621. package/lib/shared-tree-core/messageCodecs.js.map +1 -1
  622. package/lib/shared-tree-core/messageFormat.d.ts +1 -0
  623. package/lib/shared-tree-core/messageFormat.d.ts.map +1 -1
  624. package/lib/shared-tree-core/messageFormat.js +6 -0
  625. package/lib/shared-tree-core/messageFormat.js.map +1 -1
  626. package/lib/shared-tree-core/messageFormatV1ToV4.d.ts +2 -2
  627. package/lib/shared-tree-core/messageFormatV1ToV4.d.ts.map +1 -1
  628. package/lib/shared-tree-core/messageFormatV1ToV4.js +1 -0
  629. package/lib/shared-tree-core/messageFormatV1ToV4.js.map +1 -1
  630. package/lib/shared-tree-core/sharedTreeCore.d.ts +1 -0
  631. package/lib/shared-tree-core/sharedTreeCore.d.ts.map +1 -1
  632. package/lib/shared-tree-core/sharedTreeCore.js +1 -1
  633. package/lib/shared-tree-core/sharedTreeCore.js.map +1 -1
  634. package/lib/simple-tree/core/unhydratedFlexTree.d.ts +16 -12
  635. package/lib/simple-tree/core/unhydratedFlexTree.d.ts.map +1 -1
  636. package/lib/simple-tree/core/unhydratedFlexTree.js +58 -8
  637. package/lib/simple-tree/core/unhydratedFlexTree.js.map +1 -1
  638. package/lib/simple-tree/fieldSchema.d.ts +4 -4
  639. package/lib/simple-tree/fieldSchema.d.ts.map +1 -1
  640. package/lib/simple-tree/fieldSchema.js.map +1 -1
  641. package/lib/simple-tree/index.d.ts +2 -2
  642. package/lib/simple-tree/index.d.ts.map +1 -1
  643. package/lib/simple-tree/index.js +1 -1
  644. package/lib/simple-tree/index.js.map +1 -1
  645. package/lib/simple-tree/node-kinds/array/arrayNode.d.ts.map +1 -1
  646. package/lib/simple-tree/node-kinds/array/arrayNode.js +6 -4
  647. package/lib/simple-tree/node-kinds/array/arrayNode.js.map +1 -1
  648. package/lib/simple-tree/node-kinds/common.d.ts.map +1 -1
  649. package/lib/simple-tree/node-kinds/common.js +2 -2
  650. package/lib/simple-tree/node-kinds/common.js.map +1 -1
  651. package/lib/simple-tree/node-kinds/map/mapNode.js +2 -2
  652. package/lib/simple-tree/node-kinds/map/mapNode.js.map +1 -1
  653. package/lib/simple-tree/node-kinds/object/objectNode.d.ts.map +1 -1
  654. package/lib/simple-tree/node-kinds/object/objectNode.js +20 -20
  655. package/lib/simple-tree/node-kinds/object/objectNode.js.map +1 -1
  656. package/lib/simple-tree/node-kinds/record/recordNode.d.ts.map +1 -1
  657. package/lib/simple-tree/node-kinds/record/recordNode.js +4 -2
  658. package/lib/simple-tree/node-kinds/record/recordNode.js.map +1 -1
  659. package/lib/simple-tree/prepareForInsertion.d.ts +54 -47
  660. package/lib/simple-tree/prepareForInsertion.d.ts.map +1 -1
  661. package/lib/simple-tree/prepareForInsertion.js +184 -125
  662. package/lib/simple-tree/prepareForInsertion.js.map +1 -1
  663. package/lib/simple-tree/unhydratedFlexTreeFromInsertable.d.ts +8 -3
  664. package/lib/simple-tree/unhydratedFlexTreeFromInsertable.d.ts.map +1 -1
  665. package/lib/simple-tree/unhydratedFlexTreeFromInsertable.js +23 -10
  666. package/lib/simple-tree/unhydratedFlexTreeFromInsertable.js.map +1 -1
  667. package/lib/treeFactory.d.ts.map +1 -1
  668. package/lib/treeFactory.js +13 -3
  669. package/lib/treeFactory.js.map +1 -1
  670. package/lib/util/index.d.ts +1 -1
  671. package/lib/util/index.d.ts.map +1 -1
  672. package/lib/util/index.js +1 -1
  673. package/lib/util/index.js.map +1 -1
  674. package/lib/util/rangeMap.d.ts +23 -11
  675. package/lib/util/rangeMap.d.ts.map +1 -1
  676. package/lib/util/rangeMap.js +41 -9
  677. package/lib/util/rangeMap.js.map +1 -1
  678. package/package.json +21 -21
  679. package/src/core/change-family/changeFamily.ts +5 -0
  680. package/src/core/change-family/index.ts +1 -0
  681. package/src/core/index.ts +4 -1
  682. package/src/core/rebase/changeRebaser.ts +6 -1
  683. package/src/core/rebase/index.ts +1 -0
  684. package/src/core/rebase/types.ts +4 -0
  685. package/src/core/rebase/utils.ts +31 -7
  686. package/src/core/tree/delta.ts +6 -0
  687. package/src/core/tree/detachedFieldIndex.ts +29 -1
  688. package/src/core/tree/detachedFieldIndexTypes.ts +5 -0
  689. package/src/core/tree/index.ts +13 -12
  690. package/src/core/tree/pathTree.ts +16 -4
  691. package/src/core/tree/visitDelta.ts +31 -11
  692. package/src/feature-libraries/changeAtomIdBTree.ts +28 -3
  693. package/src/feature-libraries/default-schema/defaultEditBuilder.ts +369 -127
  694. package/src/feature-libraries/default-schema/defaultFieldKinds.ts +13 -4
  695. package/src/feature-libraries/default-schema/index.ts +16 -5
  696. package/src/feature-libraries/default-schema/locationBasedEditBuilder.ts +231 -0
  697. package/src/feature-libraries/default-schema/mappedEditBuilder.ts +35 -9
  698. package/src/feature-libraries/deltaUtils.ts +6 -1
  699. package/src/feature-libraries/flex-tree/context.ts +17 -0
  700. package/src/feature-libraries/flex-tree/flexTreeTypes.ts +7 -8
  701. package/src/feature-libraries/flex-tree/lazyField.ts +65 -24
  702. package/src/feature-libraries/index.ts +22 -9
  703. package/src/feature-libraries/mitigatedChangeFamily.ts +3 -1
  704. package/src/feature-libraries/modular-schema/crossFieldQueries.ts +144 -47
  705. package/src/feature-libraries/modular-schema/fieldChangeHandler.ts +113 -58
  706. package/src/feature-libraries/modular-schema/genericFieldKind.ts +7 -18
  707. package/src/feature-libraries/modular-schema/index.ts +16 -16
  708. package/src/feature-libraries/modular-schema/modularChangeCodecV1.ts +623 -348
  709. package/src/feature-libraries/modular-schema/modularChangeCodecV2.ts +1 -0
  710. package/src/feature-libraries/modular-schema/modularChangeCodecV3.ts +649 -0
  711. package/src/feature-libraries/modular-schema/modularChangeCodecs.ts +14 -0
  712. package/src/feature-libraries/modular-schema/modularChangeFamily.ts +2694 -748
  713. package/src/feature-libraries/modular-schema/modularChangeFormatV1.ts +1 -0
  714. package/src/feature-libraries/modular-schema/modularChangeFormatV2.ts +1 -1
  715. package/src/feature-libraries/modular-schema/modularChangeFormatV3.ts +67 -0
  716. package/src/feature-libraries/modular-schema/modularChangeTypes.ts +62 -10
  717. package/src/feature-libraries/optional-field/optionalField.ts +359 -568
  718. package/src/feature-libraries/optional-field/optionalFieldChangeFormatV3.ts +45 -0
  719. package/src/feature-libraries/optional-field/optionalFieldChangeTypes.ts +31 -35
  720. package/src/feature-libraries/optional-field/optionalFieldCodecV2.ts +89 -35
  721. package/src/feature-libraries/optional-field/optionalFieldCodecV3.ts +94 -0
  722. package/src/feature-libraries/optional-field/optionalFieldCodecs.ts +5 -1
  723. package/src/feature-libraries/optional-field/requiredField.ts +15 -2
  724. package/src/feature-libraries/sequence-field/compose.ts +137 -522
  725. package/src/feature-libraries/sequence-field/helperTypes.ts +34 -19
  726. package/src/feature-libraries/sequence-field/invert.ts +102 -228
  727. package/src/feature-libraries/sequence-field/markQueue.ts +2 -2
  728. package/src/feature-libraries/sequence-field/moveEffectTable.ts +8 -195
  729. package/src/feature-libraries/sequence-field/rebase.ts +171 -207
  730. package/src/feature-libraries/sequence-field/replaceRevisions.ts +26 -52
  731. package/src/feature-libraries/sequence-field/sequenceFieldChangeHandler.ts +8 -3
  732. package/src/feature-libraries/sequence-field/sequenceFieldCodecV2.ts +677 -229
  733. package/src/feature-libraries/sequence-field/sequenceFieldCodecV3.ts +56 -70
  734. package/src/feature-libraries/sequence-field/sequenceFieldEditor.ts +28 -30
  735. package/src/feature-libraries/sequence-field/sequenceFieldToDelta.ts +21 -131
  736. package/src/feature-libraries/sequence-field/types.ts +40 -79
  737. package/src/feature-libraries/sequence-field/utils.ts +211 -370
  738. package/src/packageVersion.ts +1 -1
  739. package/src/shared-tree/independentView.ts +12 -6
  740. package/src/shared-tree/index.ts +3 -2
  741. package/src/shared-tree/schematizeTree.ts +21 -8
  742. package/src/shared-tree/schematizingTreeView.ts +38 -68
  743. package/src/shared-tree/sharedTree.ts +30 -15
  744. package/src/shared-tree/sharedTreeChangeCodecs.ts +8 -0
  745. package/src/shared-tree/sharedTreeChangeFamily.ts +7 -4
  746. package/src/shared-tree/sharedTreeEditBuilder.ts +43 -8
  747. package/src/shared-tree/treeCheckout.ts +93 -17
  748. package/src/shared-tree-core/branch.ts +8 -2
  749. package/src/shared-tree-core/editManager.ts +16 -2
  750. package/src/shared-tree-core/editManagerCodecs.ts +11 -1
  751. package/src/shared-tree-core/editManagerFormatCommons.ts +6 -0
  752. package/src/shared-tree-core/editManagerFormatV1toV4.ts +3 -1
  753. package/src/shared-tree-core/index.ts +2 -0
  754. package/src/shared-tree-core/messageCodecV1ToV4.ts +2 -1
  755. package/src/shared-tree-core/messageCodecs.ts +11 -1
  756. package/src/shared-tree-core/messageFormat.ts +6 -0
  757. package/src/shared-tree-core/messageFormatV1ToV4.ts +3 -1
  758. package/src/shared-tree-core/sharedTreeCore.ts +4 -1
  759. package/src/simple-tree/core/unhydratedFlexTree.ts +82 -35
  760. package/src/simple-tree/fieldSchema.ts +6 -4
  761. package/src/simple-tree/index.ts +2 -1
  762. package/src/simple-tree/node-kinds/array/arrayNode.ts +7 -5
  763. package/src/simple-tree/node-kinds/common.ts +2 -5
  764. package/src/simple-tree/node-kinds/map/mapNode.ts +4 -4
  765. package/src/simple-tree/node-kinds/object/objectNode.ts +26 -26
  766. package/src/simple-tree/node-kinds/record/recordNode.ts +10 -9
  767. package/src/simple-tree/prepareForInsertion.ts +342 -200
  768. package/src/simple-tree/unhydratedFlexTreeFromInsertable.ts +35 -15
  769. package/src/treeFactory.ts +16 -4
  770. package/src/util/index.ts +3 -0
  771. package/src/util/rangeMap.ts +68 -26
  772. package/dist/feature-libraries/sequence-field/relevantRemovedRoots.d.ts +0 -9
  773. package/dist/feature-libraries/sequence-field/relevantRemovedRoots.d.ts.map +0 -1
  774. package/dist/feature-libraries/sequence-field/relevantRemovedRoots.js +0 -50
  775. package/dist/feature-libraries/sequence-field/relevantRemovedRoots.js.map +0 -1
  776. package/docs/main/sequence-field/move-composition.md +0 -46
  777. package/lib/feature-libraries/sequence-field/relevantRemovedRoots.d.ts +0 -9
  778. package/lib/feature-libraries/sequence-field/relevantRemovedRoots.d.ts.map +0 -1
  779. package/lib/feature-libraries/sequence-field/relevantRemovedRoots.js +0 -46
  780. package/lib/feature-libraries/sequence-field/relevantRemovedRoots.js.map +0 -1
  781. package/src/feature-libraries/sequence-field/relevantRemovedRoots.ts +0 -57
@@ -69,8 +69,10 @@ export {
69
69
  type NodeChangeInverter,
70
70
  type NodeChangeRebaser,
71
71
  type NodeChangePruner,
72
- type CrossFieldManager,
73
- CrossFieldTarget,
72
+ type ComposeNodeManager,
73
+ type InvertNodeManager,
74
+ type RebaseNodeManager,
75
+ NodeMoveType,
74
76
  FlexFieldKind,
75
77
  type FullSchemaPolicy,
76
78
  allowsRepoSuperset,
@@ -79,7 +81,6 @@ export {
79
81
  type HasFieldChanges,
80
82
  type NodeExistsConstraint,
81
83
  ModularChangeFamily,
82
- type RelevantRemovedRootsFromChild,
83
84
  EncodedModularChangesetV1,
84
85
  EncodedModularChangesetV2,
85
86
  updateRefreshers,
@@ -92,7 +93,11 @@ export {
92
93
  ModularChangeFormatVersion,
93
94
  } from "./modular-schema/index.js";
94
95
 
95
- export { mapRootChanges } from "./deltaUtils.js";
96
+ export {
97
+ mapRootChanges,
98
+ nodeIdFromChangeAtom,
99
+ changeAtomFromDetachedNodeId,
100
+ } from "./deltaUtils.js";
96
101
 
97
102
  export {
98
103
  type TreeChunk,
@@ -128,17 +133,25 @@ export {
128
133
  export {
129
134
  FieldKinds,
130
135
  type DefaultChangeset,
136
+ type DetachedRootIds,
131
137
  DefaultChangeFamily,
132
- DefaultEditBuilder,
133
- type IDefaultEditBuilder,
134
- type ValueFieldEditBuilder,
135
- type OptionalFieldEditBuilder,
136
- type SequenceFieldEditBuilder,
138
+ type IdBasedChangeFamilyDataEditor,
139
+ DefaultIdBasedDataEditor,
140
+ type DataEditor,
141
+ type RequiredFieldEditor,
142
+ type OptionalFieldEditor,
143
+ type SequenceFieldEditor,
137
144
  defaultSchemaPolicy,
138
145
  fieldKinds,
139
146
  fieldKindConfigurations,
140
147
  intoDelta,
141
148
  relevantRemovedRoots,
149
+ type DetachedRootLocation,
150
+ type DetachedRootsLocation,
151
+ type DetachedRootIdRange,
152
+ type Locator,
153
+ LocationBasedDataEditor,
154
+ type ILocationBasedDataEditor,
142
155
  getCodecTreeForModularChangeFormat,
143
156
  } from "./default-schema/index.js";
144
157
 
@@ -7,6 +7,7 @@ import type {
7
7
  ChangeFamily,
8
8
  ChangeFamilyEditor,
9
9
  ChangeRebaser,
10
+ EditorOptions,
10
11
  RevisionMetadataSource,
11
12
  RevisionReplacer,
12
13
  RevisionTag,
@@ -36,8 +37,9 @@ export function makeMitigatedChangeFamily<TEditor extends ChangeFamilyEditor, TC
36
37
  buildEditor: (
37
38
  mintRevisionTag: () => RevisionTag,
38
39
  changeReceiver: (change: TaggedChange<TChange>) => void,
40
+ options?: EditorOptions,
39
41
  ): TEditor => {
40
- return unmitigatedChangeFamily.buildEditor(mintRevisionTag, changeReceiver);
42
+ return unmitigatedChangeFamily.buildEditor(mintRevisionTag, changeReceiver, options);
41
43
  },
42
44
  rebaser: makeMitigatedRebaser(unmitigatedChangeFamily.rebaser, fallbackChange, onError),
43
45
  codecs: unmitigatedChangeFamily.codecs,
@@ -16,23 +16,13 @@ import type { NodeId } from "./modularChangeTypes.js";
16
16
  export type CrossFieldMap<T> = ChangeAtomIdRangeMap<T>;
17
17
  export type CrossFieldQuerySet = CrossFieldMap<boolean>;
18
18
 
19
- export function addCrossFieldQuery(
20
- set: CrossFieldQuerySet,
21
- revision: RevisionTag | undefined,
22
- id: ChangesetLocalId,
23
- count: number,
24
- ): void {
25
- setInCrossFieldMap(set, revision, id, count, true);
26
- }
27
-
28
19
  export function setInCrossFieldMap<T>(
29
20
  map: CrossFieldMap<T>,
30
- revision: RevisionTag | undefined,
31
- id: ChangesetLocalId,
21
+ id: ChangeAtomId,
32
22
  count: number,
33
23
  value: T,
34
24
  ): void {
35
- map.set({ revision, localId: id }, count, value);
25
+ map.set(id, count, value);
36
26
  }
37
27
 
38
28
  export function getFirstFromCrossFieldMap<T>(
@@ -40,60 +30,167 @@ export function getFirstFromCrossFieldMap<T>(
40
30
  revision: RevisionTag | undefined,
41
31
  id: ChangesetLocalId,
42
32
  count: number,
43
- ): RangeQueryResult<ChangeAtomId, T> {
33
+ ): RangeQueryResult<T | undefined> {
44
34
  return map.getFirst({ revision, localId: id }, count);
45
35
  }
46
36
 
47
- export enum CrossFieldTarget {
48
- Source,
49
- Destination,
37
+ export enum NodeMoveType {
38
+ Detach,
39
+ Attach,
50
40
  }
51
41
 
52
- /**
53
- * Used by {@link FieldChangeHandler} implementations for exchanging information across other fields
54
- * while rebasing, composing, or inverting a change.
55
- */
56
- export interface CrossFieldManager<T = unknown> {
42
+ export interface InvertNodeManager {
43
+ /**
44
+ * Transfers the given node changes from the input context of the field changeset being inverted to the input context of the detached space (from which it may be further moved).
45
+ *
46
+ * This must be called for each detach in the field kind when rolling-back or reverting a detach.
47
+ * This implies that all detaches in the field must be inverted.
48
+ * @param detachId - The ID of the detach to invert.
49
+ * @param count - The number of nodes being detached.
50
+ * @param nodeChanges - The node changes to transfer.
51
+ * @param newAttachId - The ID that the nodes will be attached with in the inverted changeset of this field.
52
+ */
53
+ invertDetach(
54
+ detachId: ChangeAtomId,
55
+ count: number,
56
+ nodeChanges: NodeId | undefined,
57
+ newAttachId: ChangeAtomId,
58
+ ): void;
59
+
60
+ /**
61
+ * Gets the node changes associated with the node being attached in input changeset.
62
+ *
63
+ * This must be called for each attach in the field kind when rolling-back or reverting a attach.
64
+ * This implies that all attaches in the field must be inverted.
65
+ * @param attachId - The ID of the attach to invert.
66
+ * @param count - The number of nodes being attached.
67
+ */
68
+ invertAttach(
69
+ attachId: ChangeAtomId,
70
+ count: number,
71
+ ): RangeQueryResult<DetachedNodeEntry | undefined>;
72
+ }
73
+
74
+ export interface ComposeNodeManager {
75
+ /**
76
+ * Allows a field kind to query nested changes associated with a node in the input context of the new changeset.
77
+ * This should be called for every detach in the base changeset.
78
+ * @param baseDetachId - The ID of the detach in the base changeset.
79
+ * @param count - The number of nodes being detached.
80
+ */
81
+ getNewChangesForBaseDetach(
82
+ baseDetachId: ChangeAtomId,
83
+ count: number,
84
+ ): RangeQueryResult<DetachedNodeEntry | undefined>;
85
+
57
86
  /**
58
- * Returns the first data range associated with the key of `target`, `revision`, between `id` and `id + count`.
59
- * Calling this records a dependency for the current field on this key if `addDependency` is true.
87
+ * Must be called by a field kind when composing an attach in the base changeset with a detach in the new changeset.
88
+ * This allows Modular Change Family to keep track of how a given node is being renamed.
89
+ * @param baseAttachId - The ID of the attach in the base changeset.
90
+ * @param newDetachId - The ID of the detach in the new changeset.
91
+ * @param count - The number of nodes being attached then detached.
60
92
  */
61
- get(
62
- target: CrossFieldTarget,
63
- revision: RevisionTag | undefined,
64
- id: ChangesetLocalId,
93
+ composeAttachDetach(
94
+ baseAttachId: ChangeAtomId,
95
+ newDetachId: ChangeAtomId,
65
96
  count: number,
66
- addDependency: boolean,
67
- ): RangeQueryResult<ChangeAtomId, T>;
97
+ ): void;
98
+
99
+ /**
100
+ * Must be called by a field kind when composing an attach in the base changeset with nested changes the new changeset.
101
+ *
102
+ * This is needed because child changes are represented at the location of the node they impact in the input context of a changeset.
103
+ * So if the later of the two changes being composed carries nested changes for a node,
104
+ * then in the composed changeset, these nested changes need to be represented at the location of that node in the input context of the composed changeset.
105
+ *
106
+ * @param baseAttachId - The ID of the attach in the base changeset.
107
+ * @param newChanges - The ID of the nested changes associated with this node in the new changeset.
108
+ */
109
+ sendNewChangesToBaseSourceLocation(baseAttachId: ChangeAtomId, newChanges: NodeId): void;
68
110
 
111
+ // XXX: It doesn't seem like it should be mandatory to call this if you don't want the rename to be removed (e.g., optional field pin).
69
112
  /**
70
- * Sets the range of keys to `newValue`.
71
- * If `invalidateDependents` is true, all fields which took a dependency on this key will be considered invalidated
72
- * and will be given a chance to address the new data in `amendCompose`, or a second pass of `rebase` or `invert` as appropriate.
113
+ * Must be called by a field kind when composing a detach in the base changeset with an attach of the same nodes in the new changeset.
114
+ * @param baseDetachId - The ID of the detach in the base changeset.
115
+ * @param newAttachId - The ID of the attach in the new changeset.
116
+ * @param count - The number of nodes being detached then attached.
117
+ * @param convertToPin - Should be set to true if the composed change will include a detach and attach with `newAttachId`.
118
+ * Otherwise the composed change should not include either `baseDetachId` or `newAttachId`.
73
119
  */
74
- set(
75
- target: CrossFieldTarget,
76
- revision: RevisionTag | undefined,
77
- id: ChangesetLocalId,
120
+ composeDetachAttach(
121
+ baseDetachId: ChangeAtomId,
122
+ newAttachId: ChangeAtomId,
78
123
  count: number,
79
- newValue: T,
80
- invalidateDependents: boolean,
124
+ convertToPin: boolean,
81
125
  ): void;
126
+ }
82
127
 
128
+ export interface RebaseNodeManager {
129
+ // XXX: It's not clear whether the returned changes are already rebased or not.
83
130
  /**
84
- * This must be called whenever a new node is moved into this field as part of the current rebase, compose, or invert.
85
- * Calling this for a node which was already in the field is tolerated.
131
+ * Must be called by a field kind when rebasing over an attach.
132
+ * The returned child changes and detach intentions must be represented in the output changeset.
133
+ * @param baseAttachId - The ID of the attach that is being rebased over.
134
+ * @param count - The number of nodes attached by the base attach.
135
+ * @returns The new nested changes and detach intentions associated with the node in the changeset being rebased.
86
136
  */
87
- onMoveIn(id: NodeId): void;
137
+ getNewChangesForBaseAttach(
138
+ baseAttachId: ChangeAtomId,
139
+ count: number,
140
+ ): RangeQueryResult<RebaseDetachedNodeEntry | undefined>;
88
141
 
142
+ // XXX: It's not clear if this must be called even when newDetachId and nodeChange are undefined.
143
+ // XXX: It's not clear if it's okay to call this once with a newDetachId then once with a nodeChange.
144
+ // XXX: It's not clear if nodeChange should be rebased already, or should not be rebased, or if it doesn't matter.
89
145
  /**
90
- * This must be called whenever a new cross field key is moved into this field as part of the current rebase or compose.
91
- * Calling this for a key which was already in the field is tolerated.
146
+ * Must be called by a field kind when rebasing over a detach.
147
+ * The field kind must provide the nested changes and detach intentions associated with the node in the changeset being rebased.
148
+ * @param baseDetachId - The ID of the detach that is being rebased over.
149
+ * @param count - The number of nodes detached by the base detach.
150
+ * @param newDetachId - The ID associated the detach intention (if any) for these nodes in the rebased changeset.
151
+ * @param nodeChange - The nested changes (if any) associated with this node in the rebased changeset.
152
+ * @param newDetachCellId - An additional ID to associate with this node.
153
+ * This ID will be included in the result of {@link getNewChangesForBaseAttach}.
154
+ * This is only used by sequence field for compatibility with earlier client versions.
92
155
  */
93
- moveKey(
94
- target: CrossFieldTarget,
95
- revision: RevisionTag | undefined,
96
- id: ChangesetLocalId,
156
+ rebaseOverDetach(
157
+ baseDetachId: ChangeAtomId,
97
158
  count: number,
159
+ newDetachId: ChangeAtomId | undefined,
160
+ nodeChange: NodeId | undefined,
161
+ newDetachCellId?: ChangeAtomId,
98
162
  ): void;
163
+
164
+ addDetach(id: ChangeAtomId, count: number): void;
165
+ removeDetach(id: ChangeAtomId, count: number): void;
166
+
167
+ /**
168
+ * Returns whether nodes which were either previously detached by `id` or the base changeset is now detaching with `id`
169
+ * are also reattached by the base changeset.
170
+ */
171
+ doesBaseAttachNodes(id: ChangeAtomId, count: number): RangeQueryResult<boolean>;
172
+
173
+ /**
174
+ * Returns the root ID the base change renames `id` to, if any.
175
+ */
176
+ getBaseRename(id: ChangeAtomId, count: number): RangeQueryResult<ChangeAtomId | undefined>;
177
+
178
+ /**
179
+ * Given a detached node ID in the base changeset's output context,
180
+ * returns the ID the rebased changeset renames that ID to, if any.
181
+ */
182
+ getNewRenameForBaseRename(
183
+ baseRenameTo: ChangeAtomId,
184
+ count: number,
185
+ ): RangeQueryResult<ChangeAtomId | undefined>;
186
+ }
187
+
188
+ export interface DetachedNodeEntry {
189
+ nodeChange?: NodeId;
190
+ detachId?: ChangeAtomId;
191
+ }
192
+
193
+ export interface RebaseDetachedNodeEntry extends DetachedNodeEntry {
194
+ // This is only needed for sequence field to implement detach cell IDs.
195
+ cellRename?: ChangeAtomId;
99
196
  }
@@ -5,10 +5,9 @@
5
5
 
6
6
  import type { ICodecFamily, IJsonCodec } from "../../codec/index.js";
7
7
  import type {
8
+ ChangeAtomId,
9
+ ChangeAtomIdRangeMap,
8
10
  ChangeEncodingContext,
9
- DeltaDetachedNodeChanges,
10
- DeltaDetachedNodeId,
11
- DeltaDetachedNodeRename,
12
11
  DeltaFieldChanges,
13
12
  DeltaFieldMap,
14
13
  EncodedRevisionTag,
@@ -16,35 +15,18 @@ import type {
16
15
  RevisionReplacer,
17
16
  RevisionTag,
18
17
  } from "../../core/index.js";
19
- import type { IdAllocator, Invariant } from "../../util/index.js";
18
+ import type { IdAllocator, Invariant, RangeQueryResult } from "../../util/index.js";
19
+ import type { ChangeAtomIdBTree } from "../changeAtomIdBTree.js";
20
20
 
21
- import type { CrossFieldManager } from "./crossFieldQueries.js";
21
+ import type {
22
+ ComposeNodeManager,
23
+ InvertNodeManager,
24
+ RebaseNodeManager,
25
+ } from "./crossFieldQueries.js";
22
26
  import type { EncodedNodeChangeset } from "./modularChangeFormatV1.js";
23
- import type { CrossFieldKeyRange, NodeId } from "./modularChangeTypes.js";
24
-
25
- export type NestedChangesIndices = [
26
- NodeId,
27
- number | undefined /* inputIndex */,
28
- number | undefined /* outputIndex */,
29
- ][];
27
+ import type { CrossFieldKeyRange, NodeId, RebaseVersion } from "./modularChangeTypes.js";
30
28
 
31
- /**
32
- * The return value of calling {@link FieldChangeHandler.intoDelta}.
33
- */
34
- export interface FieldChangeDelta {
35
- /**
36
- * {@inheritdoc DeltaFieldChanges}
37
- */
38
- readonly local?: DeltaFieldChanges;
39
- /**
40
- * {@inheritdoc DeltaRoot.global}
41
- */
42
- readonly global?: readonly DeltaDetachedNodeChanges[];
43
- /**
44
- * {@inheritdoc DeltaRoot.rename}
45
- */
46
- readonly rename?: readonly DeltaDetachedNodeRename[];
47
- }
29
+ export type NestedChangesIndices = readonly (readonly [NodeId, inputIndex: number])[];
48
30
 
49
31
  /**
50
32
  * Functionality provided by a field kind which will be composed with other `FieldChangeHandler`s to
@@ -65,27 +47,7 @@ export interface FieldChangeHandler<
65
47
  >,
66
48
  ) => ICodecFamily<TChangeset, FieldChangeEncodingContext>;
67
49
  readonly editor: TEditor;
68
- intoDelta(change: TChangeset, deltaFromChild: ToDelta): FieldChangeDelta;
69
- /**
70
- * Returns the set of removed roots that should be in memory for the given change to be applied.
71
- * A removed root is relevant if any of the following is true:
72
- * - It is being inserted
73
- * - It is being restored
74
- * - It is being edited
75
- * - The ID it is associated with is being changed
76
- *
77
- * Implementations are allowed to be conservative by returning more removed roots than strictly necessary
78
- * (though they should, for the sake of performance, try to avoid doing so).
79
- *
80
- * Implementations are not allowed to return IDs for non-root trees, even if they are removed.
81
- *
82
- * @param change - The change to be applied.
83
- * @param relevantRemovedRootsFromChild - Delegate for collecting relevant removed roots from child changes.
84
- */
85
- readonly relevantRemovedRoots: (
86
- change: TChangeset,
87
- relevantRemovedRootsFromChild: RelevantRemovedRootsFromChild,
88
- ) => Iterable<DeltaDetachedNodeId>;
50
+ intoDelta(change: TChangeset, deltaFromChild: ToDelta): DeltaFieldChanges;
89
51
 
90
52
  /**
91
53
  * Returns whether this change is empty, meaning that it represents no modifications to the field
@@ -114,6 +76,12 @@ export interface FieldChangeHandler<
114
76
  */
115
77
  getCrossFieldKeys(change: TChangeset): CrossFieldKeyRange[];
116
78
 
79
+ // XXX: Document
80
+ getDetachCellIds(
81
+ change: TChangeset,
82
+ rootRenames: ChangeAtomIdRangeMap<ChangeAtomId>,
83
+ ): { detachId: ChangeAtomId; cellId: ChangeAtomId; count: number }[];
84
+
117
85
  createEmpty(): TChangeset;
118
86
  }
119
87
 
@@ -130,7 +98,7 @@ export interface FieldChangeRebaser<TChangeset> {
130
98
  change2: TChangeset,
131
99
  composeChild: NodeChangeComposer,
132
100
  genId: IdAllocator,
133
- crossFieldManager: CrossFieldManager,
101
+ nodeManager: ComposeNodeManager,
134
102
  revisionMetadata: RevisionMetadataSource,
135
103
  ): TChangeset;
136
104
 
@@ -143,10 +111,11 @@ export interface FieldChangeRebaser<TChangeset> {
143
111
  isRollback: boolean,
144
112
  genId: IdAllocator,
145
113
  revision: RevisionTag | undefined,
146
- crossFieldManager: CrossFieldManager,
114
+ nodeManager: InvertNodeManager,
147
115
  revisionMetadata: RevisionMetadataSource,
148
116
  ): TChangeset;
149
117
 
118
+ // XXX: It's not clear whether `rebaseChild` must be called in all cases.
150
119
  /**
151
120
  * Rebase `change` over `over`.
152
121
  * See `ChangeRebaser` for details.
@@ -156,8 +125,9 @@ export interface FieldChangeRebaser<TChangeset> {
156
125
  over: TChangeset,
157
126
  rebaseChild: NodeChangeRebaser,
158
127
  genId: IdAllocator,
159
- crossFieldManager: CrossFieldManager,
128
+ nodeManager: RebaseNodeManager,
160
129
  revisionMetadata: RebaseRevisionMetadata,
130
+ rebaseVersion: RebaseVersion,
161
131
  ): TChangeset;
162
132
 
163
133
  /**
@@ -246,11 +216,6 @@ export type NodeChangeComposer = (
246
216
 
247
217
  export type NodeChangePruner = (change: NodeId) => NodeId | undefined;
248
218
 
249
- /**
250
- * A function that returns the set of removed roots that should be in memory for a given node changeset to be applied.
251
- */
252
- export type RelevantRemovedRootsFromChild = (child: NodeId) => Iterable<DeltaDetachedNodeId>;
253
-
254
219
  export interface RebaseRevisionMetadata extends RevisionMetadataSource {
255
220
  readonly getRevisionToRebase: () => RevisionTag | undefined;
256
221
  readonly getBaseRevisions: () => RevisionTag[];
@@ -258,6 +223,96 @@ export interface RebaseRevisionMetadata extends RevisionMetadataSource {
258
223
 
259
224
  export interface FieldChangeEncodingContext {
260
225
  readonly baseContext: ChangeEncodingContext;
226
+
227
+ /**
228
+ * A map from root ID to node ID, containing all roots which were last detached from this field.
229
+ * The field must encode these root node changes.
230
+ * This is only needed when encoding to a ModularChangeFormat older than v3,
231
+ * as in those versions, changes to root nodes were represented in the field they were last detached from.
232
+ * This should only be used during encoding.
233
+ */
234
+ readonly rootNodeChanges: ChangeAtomIdBTree<NodeId>;
235
+
236
+ /**
237
+ * A map from input context root ID to output context root ID, containing all roots which were last detached from this field.
238
+ * The field must encode these renames.
239
+ * This is only needed when encoding to a ModularChangeFormat older than v3,
240
+ * as in those versions, root node renames were represented in the field they were last detached from.
241
+ * This should only be used during encoding.
242
+ */
243
+ readonly rootRenames: ChangeAtomIdRangeMap<ChangeAtomId>;
244
+
245
+ // This should only be called during encoding.
261
246
  encodeNode(nodeId: NodeId): EncodedNodeChangeset;
247
+
248
+ /**
249
+ * Returns the input context root ID from an output context root ID.
250
+ * This is only needed for encoding to sequence field format v3 and older.
251
+ * This should only be called during encoding.
252
+ */
253
+ getInputRootId(
254
+ outputRootId: ChangeAtomId,
255
+ count: number,
256
+ ): RangeQueryResult<ChangeAtomId | undefined>;
257
+
258
+ /**
259
+ * Returns the input context root ID from an output context root ID.
260
+ * This is only needed for encoding to sequence field format v3 and older.
261
+ * This should only be called during encoding.
262
+ */
263
+ isAttachId(id: ChangeAtomId, count: number): RangeQueryResult<boolean>;
264
+
265
+ /**
266
+ * Returns whether `id` is used as a detach ID in this changeset.
267
+ * This is only needed for encoding to sequence field format v3 and older.
268
+ * This should only be called during encoding.
269
+ */
270
+ isDetachId(id: ChangeAtomId, count: number): RangeQueryResult<boolean>;
271
+
272
+ /**
273
+ * Returns the detach cell ID for the attach associated with `moveId`.
274
+ * If there is no associated detach cell ID, or the ID is the same as `moveId`,
275
+ * this will return undefined.
276
+ * This is only needed for encoding to sequence field format v3 and older.
277
+ * This should only be called during encoding.
278
+ */
279
+ getCellIdForMove(
280
+ moveId: ChangeAtomId,
281
+ count: number,
282
+ ): RangeQueryResult<ChangeAtomId | undefined>;
283
+
284
+ // This should only be called during decoding.
262
285
  decodeNode(encodedNode: EncodedNodeChangeset): NodeId;
286
+
287
+ /**
288
+ * Must be called for each root node changeset encoded in this field.
289
+ * This is only needed when encoding to a ModularChangeFormat older than v3,
290
+ * as in those versions, changes to root node were represented in the field they were last detached from.
291
+ * This should only be called during decoding.
292
+ */
293
+ decodeRootNodeChange(detachId: ChangeAtomId, encodedNode: EncodedNodeChangeset): void;
294
+
295
+ /**
296
+ * Must be called for each root node rename encoded in this field.
297
+ * This is only needed when encoding to a ModularChangeFormat older than v3,
298
+ * as in those versions, root node renames were represented in the field they were last detached from.
299
+ * This should only be called during decoding.
300
+ */
301
+ decodeRootRename(oldId: ChangeAtomId, newId: ChangeAtomId, count: number): void;
302
+
303
+ /**
304
+ * Must be called for each node which has its detach location changed to this field.
305
+ * The node may be either detached by this change, or already detached in this change's input context.
306
+ * This is only needed when encoding to a ModularChangeFormat older than v3,
307
+ * as in those versions, root node locations were represented in the field they were last detached from.
308
+ * This should only be called during decoding.
309
+ */
310
+ decodeMoveAndDetach(detachId: ChangeAtomId, count: number): void;
311
+
312
+ /**
313
+ * Generates a new ChangeAtomId which has not been used in this changeset.
314
+ * This is only needed for decoding optional field format v2 and older.
315
+ * This should only be called during decoding.
316
+ */
317
+ generateId(): ChangeAtomId;
263
318
  }
@@ -7,22 +7,20 @@ import { assert } from "@fluidframework/core-utils/internal";
7
7
  import { BTree } from "@tylerbu/sorted-btree-es6";
8
8
 
9
9
  import {
10
- type DeltaDetachedNodeId,
11
10
  type DeltaMark,
12
11
  type FieldKindIdentifier,
13
12
  Multiplicity,
13
+ type DeltaFieldChanges,
14
14
  type RevisionReplacer,
15
15
  } from "../../core/index.js";
16
16
  import { brandConst } from "../../util/index.js";
17
17
 
18
18
  import type {
19
- FieldChangeDelta,
20
19
  FieldChangeHandler,
21
20
  NestedChangesIndices,
22
21
  NodeChangeComposer,
23
22
  NodeChangePruner,
24
23
  NodeChangeRebaser,
25
- RelevantRemovedRootsFromChild,
26
24
  ToDelta,
27
25
  } from "./fieldChangeHandler.js";
28
26
  import { FlexFieldKind } from "./fieldKind.js";
@@ -36,7 +34,7 @@ import type { NodeId } from "./modularChangeTypes.js";
36
34
  export const genericChangeHandler: FieldChangeHandler<GenericChangeset> = {
37
35
  rebaser: {
38
36
  compose,
39
- invert: (change: GenericChangeset): GenericChangeset => change,
37
+ invert: (change): GenericChangeset => change,
40
38
  rebase: rebaseGenericChange,
41
39
  prune: pruneGenericChange,
42
40
  replaceRevisions,
@@ -48,7 +46,7 @@ export const genericChangeHandler: FieldChangeHandler<GenericChangeset> = {
48
46
  return newGenericChangeset([...changes]);
49
47
  },
50
48
  },
51
- intoDelta: (change: GenericChangeset, deltaFromChild: ToDelta): FieldChangeDelta => {
49
+ intoDelta: (change: GenericChangeset, deltaFromChild: ToDelta): DeltaFieldChanges => {
52
50
  let nodeIndex = 0;
53
51
  const markList: DeltaMark[] = [];
54
52
  for (const [index, nodeChange] of change.entries()) {
@@ -60,13 +58,13 @@ export const genericChangeHandler: FieldChangeHandler<GenericChangeset> = {
60
58
  markList.push({ count: 1, fields: deltaFromChild(nodeChange) });
61
59
  nodeIndex += 1;
62
60
  }
63
- return { local: { marks: markList } };
61
+ return { marks: markList };
64
62
  },
65
- relevantRemovedRoots,
66
63
  isEmpty: (change: GenericChangeset): boolean => change.length === 0,
67
64
  getNestedChanges,
68
65
  createEmpty: newGenericChangeset,
69
66
  getCrossFieldKeys: (_change) => [],
67
+ getDetachCellIds: (_change) => [],
70
68
  };
71
69
 
72
70
  function compose(
@@ -86,7 +84,7 @@ function compose(
86
84
 
87
85
  function getNestedChanges(change: GenericChangeset): NestedChangesIndices {
88
86
  // For generic changeset, the indices in the input and output contexts are the same.
89
- return change.toArray().map(([index, nodeChange]) => [nodeChange, index, index]);
87
+ return change.toArray().map(([index, nodeChange]) => [nodeChange, index]);
90
88
  }
91
89
 
92
90
  function rebaseGenericChange(
@@ -148,7 +146,7 @@ function pruneGenericChange(
148
146
  for (const [index, node] of changeset.entries()) {
149
147
  const prunedNode = pruneChild(node);
150
148
  if (prunedNode !== undefined) {
151
- pruned.set(index, node);
149
+ pruned.set(index, prunedNode);
152
150
  }
153
151
  }
154
152
  return pruned;
@@ -186,12 +184,3 @@ export function convertGenericChange<TChange>(
186
184
  ): TChange {
187
185
  return target.editor.buildChildChanges(changeset.entries());
188
186
  }
189
-
190
- function* relevantRemovedRoots(
191
- change: GenericChangeset,
192
- relevantRemovedRootsFromChild: RelevantRemovedRootsFromChild,
193
- ): Iterable<DeltaDetachedNodeId> {
194
- for (const nodeChange of change.values()) {
195
- yield* relevantRemovedRootsFromChild(nodeChange);
196
- }
197
- }