edytor 1.0.0-rc.3 → 1.0.0

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 (642) hide show
  1. package/README.md +65 -25
  2. package/dist/block/block.svelte.d.ts +10 -85
  3. package/dist/block/block.svelte.js +27 -137
  4. package/dist/block/colors.d.ts +0 -9
  5. package/dist/block/colors.js +1 -18
  6. package/dist/block/contentRange.d.ts +5 -1
  7. package/dist/block/contentRange.js +15 -16
  8. package/dist/block/inlineBlock.svelte.d.ts +8 -10
  9. package/dist/block/inlineBlock.svelte.js +14 -22
  10. package/dist/clipboard/createClipboardFragment.js +22 -64
  11. package/dist/clipboard/fragmentData.js +17 -42
  12. package/dist/clipboard/htmlFlow.js +7 -7
  13. package/dist/clipboard/insertClipboardFragment.js +5 -4
  14. package/dist/clipboard/moveText.js +16 -8
  15. package/dist/clipboard/serializeClipboardFragment.d.ts +2 -0
  16. package/dist/clipboard/serializeClipboardFragment.js +32 -28
  17. package/dist/cloudflare/DocumentRoom.d.ts +4 -17
  18. package/dist/cloudflare/DocumentRoom.js +3 -5
  19. package/dist/cloudflare/move.d.ts +1 -18
  20. package/dist/cloudflare/move.js +2 -48
  21. package/dist/cloudflare/room/admission.d.ts +1 -60
  22. package/dist/cloudflare/room/admission.js +25 -29
  23. package/dist/cloudflare/room/comments.d.ts +1 -3
  24. package/dist/cloudflare/room/comments.js +6 -6
  25. package/dist/cloudflare/room/context.d.ts +19 -82
  26. package/dist/cloudflare/room/context.js +8 -8
  27. package/dist/cloudflare/room/forged.d.ts +1 -1
  28. package/dist/cloudflare/room/forged.js +2 -12
  29. package/dist/cloudflare/room/frames.d.ts +1 -1
  30. package/dist/cloudflare/room/frames.js +1 -1
  31. package/dist/cloudflare/room/history.d.ts +1 -25
  32. package/dist/cloudflare/room/history.js +39 -54
  33. package/dist/cloudflare/room/moves.d.ts +1 -13
  34. package/dist/cloudflare/room/moves.js +33 -57
  35. package/dist/cloudflare/room/presence.d.ts +1 -11
  36. package/dist/cloudflare/room/presence.js +4 -4
  37. package/dist/cloudflare/room/purge.d.ts +1 -2
  38. package/dist/cloudflare/room/purge.js +2 -2
  39. package/dist/cloudflare/room/replicas.d.ts +1 -7
  40. package/dist/cloudflare/room/replicas.js +2 -2
  41. package/dist/cloudflare/room/storage.d.ts +3 -32
  42. package/dist/cloudflare/room/storage.js +33 -108
  43. package/dist/cloudflare/room/updates.d.ts +4 -4
  44. package/dist/cloudflare/room/updates.js +17 -24
  45. package/dist/cloudflare/room/validation.d.ts +1 -5
  46. package/dist/cloudflare/room/validation.js +16 -37
  47. package/dist/collaboration/RemoteSelections.svelte +13 -17
  48. package/dist/collaboration/comments/client.d.ts +2 -2
  49. package/dist/collaboration/comments/client.js +1 -1
  50. package/dist/collaboration/history/index.d.ts +5 -5
  51. package/dist/collaboration/history/index.js +5 -5
  52. package/dist/collaboration/history/panel.svelte.d.ts +91 -0
  53. package/dist/collaboration/history/panel.svelte.js +223 -0
  54. package/dist/collaboration/providers.d.ts +12 -3
  55. package/dist/collaboration/providers.js +5 -4
  56. package/dist/components/Block.svelte +39 -55
  57. package/dist/components/Block.svelte.d.ts +7 -5
  58. package/dist/components/Content.svelte +1 -5
  59. package/dist/components/Edytor.svelte +53 -96
  60. package/dist/components/Edytor.svelte.d.ts +8 -12
  61. package/dist/components/Ranges.svelte +96 -0
  62. package/dist/components/Ranges.svelte.d.ts +19 -0
  63. package/dist/components/Suggestion.svelte +3 -2
  64. package/dist/components/Text.svelte +2 -5
  65. package/dist/components/Text.svelte.d.ts +1 -1
  66. package/dist/crdt/admission.d.ts +2 -9
  67. package/dist/crdt/admission.js +3 -9
  68. package/dist/crdt/attribution/attribution.d.ts +11 -72
  69. package/dist/crdt/attribution/attribution.js +5 -52
  70. package/dist/crdt/attribution/block.d.ts +0 -78
  71. package/dist/crdt/attribution/block.js +1 -144
  72. package/dist/crdt/data.d.ts +8 -13
  73. package/dist/crdt/data.js +30 -70
  74. package/dist/crdt/doc/anchors.js +4 -4
  75. package/dist/crdt/doc/content.d.ts +5 -1
  76. package/dist/crdt/doc/content.js +3 -1
  77. package/dist/crdt/doc/delete.d.ts +1 -0
  78. package/dist/crdt/doc/funnel.d.ts +0 -23
  79. package/dist/crdt/doc/funnel.js +34 -85
  80. package/dist/crdt/doc/gate.d.ts +8 -9
  81. package/dist/crdt/doc/gate.js +7 -17
  82. package/dist/crdt/doc/history.d.ts +87 -14
  83. package/dist/crdt/doc/history.js +334 -149
  84. package/dist/crdt/doc/layout.d.ts +0 -1
  85. package/dist/crdt/doc/layout.js +2 -3
  86. package/dist/crdt/doc/meta.d.ts +4 -4
  87. package/dist/crdt/doc/meta.js +10 -21
  88. package/dist/crdt/doc/moves.d.ts +4 -4
  89. package/dist/crdt/doc/moves.js +5 -5
  90. package/dist/crdt/doc/plan.d.ts +2 -0
  91. package/dist/crdt/doc/plan.js +2 -0
  92. package/dist/crdt/doc/reads.d.ts +1 -5
  93. package/dist/crdt/doc/reads.js +38 -49
  94. package/dist/crdt/doc/seed.d.ts +15 -6
  95. package/dist/crdt/doc/seed.js +27 -26
  96. package/dist/crdt/doc/split-merge.d.ts +1 -3
  97. package/dist/crdt/doc/split-merge.js +4 -5
  98. package/dist/crdt/doc/steps.d.ts +3 -7
  99. package/dist/crdt/doc/steps.js +20 -9
  100. package/dist/crdt/doc/types.d.ts +0 -10
  101. package/dist/crdt/document.d.ts +24 -115
  102. package/dist/crdt/document.js +207 -305
  103. package/dist/crdt/edytor-doc.d.ts +671 -90
  104. package/dist/crdt/edytor-doc.js +73 -149
  105. package/dist/crdt/engine-api.d.ts +15 -47
  106. package/dist/crdt/engine.d.ts +7 -17
  107. package/dist/crdt/engine.js +9 -19
  108. package/dist/crdt/flow.d.ts +9 -37
  109. package/dist/crdt/flow.js +260 -238
  110. package/dist/crdt/index.d.ts +26 -85
  111. package/dist/crdt/index.js +21 -47
  112. package/dist/crdt/operations.d.ts +24 -33
  113. package/dist/crdt/operations.js +7 -17
  114. package/dist/crdt/placement/display.d.ts +0 -2
  115. package/dist/crdt/placement/display.js +0 -15
  116. package/dist/crdt/placement/model.d.ts +160 -12
  117. package/dist/crdt/placement/model.js +413 -414
  118. package/dist/crdt/placement/rank.d.ts +1 -5
  119. package/dist/crdt/placement/rank.js +28 -38
  120. package/dist/crdt/protocol.d.ts +4 -5
  121. package/dist/crdt/protocol.js +3 -4
  122. package/dist/crdt/protocols/awareness.d.ts +3 -7
  123. package/dist/crdt/protocols/awareness.js +17 -33
  124. package/dist/crdt/protocols/envelope.d.ts +9 -29
  125. package/dist/crdt/protocols/envelope.js +8 -25
  126. package/dist/crdt/protocols/sync.d.ts +15 -30
  127. package/dist/crdt/protocols/sync.js +27 -89
  128. package/dist/crdt/providers/bound.d.ts +3 -1
  129. package/dist/crdt/providers/bound.js +3 -1
  130. package/dist/crdt/providers/container.d.ts +11 -17
  131. package/dist/crdt/providers/container.js +39 -27
  132. package/dist/crdt/providers/index.d.ts +34 -6
  133. package/dist/crdt/providers/index.js +106 -111
  134. package/dist/crdt/providers/indexeddb.d.ts +2 -12
  135. package/dist/crdt/providers/indexeddb.js +29 -90
  136. package/dist/crdt/providers/room.d.ts +58 -2
  137. package/dist/crdt/providers/room.js +38 -21
  138. package/dist/crdt/providers/websocket.d.ts +1 -1
  139. package/dist/crdt/providers/websocket.js +3 -4
  140. package/dist/crdt/purge.d.ts +2 -2
  141. package/dist/crdt/purge.js +69 -6
  142. package/dist/crdt/rangeDelete.d.ts +4 -42
  143. package/dist/crdt/rangeDelete.js +7 -6
  144. package/dist/crdt/restore.d.ts +21 -1
  145. package/dist/crdt/restore.js +54 -59
  146. package/dist/crdt/schema.d.ts +2 -2
  147. package/dist/crdt/schema.js +4 -5
  148. package/dist/crdt/semantics.d.ts +10 -15
  149. package/dist/crdt/semantics.js +22 -21
  150. package/dist/crdt/storage.d.ts +7 -13
  151. package/dist/crdt/storage.js +10 -24
  152. package/dist/crdt/structs.d.ts +42 -47
  153. package/dist/crdt/structs.js +76 -67
  154. package/dist/crdt/tables.d.ts +9 -0
  155. package/dist/crdt/tables.js +20 -0
  156. package/dist/crdt/text/delete-index.d.ts +0 -13
  157. package/dist/crdt/text/delete-index.js +7 -14
  158. package/dist/crdt/text/deletes.d.ts +9 -22
  159. package/dist/crdt/text/deletes.js +11 -74
  160. package/dist/crdt/text/index/cache.js +3 -3
  161. package/dist/crdt/text/index/fold.d.ts +1 -2
  162. package/dist/crdt/text/index/fold.js +15 -10
  163. package/dist/crdt/text/index/layout.d.ts +0 -10
  164. package/dist/crdt/text/index/layout.js +6 -20
  165. package/dist/crdt/text/index/records.js +2 -1
  166. package/dist/crdt/text/index/report.js +5 -6
  167. package/dist/crdt/text/index/shared.d.ts +11 -4
  168. package/dist/crdt/text/index/shared.js +8 -7
  169. package/dist/crdt/text/index/state.d.ts +3 -33
  170. package/dist/crdt/text/index/state.js +2 -4
  171. package/dist/crdt/text/model.d.ts +82 -2
  172. package/dist/crdt/text/model.js +344 -354
  173. package/dist/crdt/text/rows.d.ts +0 -2
  174. package/dist/crdt/text/rows.js +0 -11
  175. package/dist/crdt/text/runs.d.ts +6 -3
  176. package/dist/crdt/text/runs.js +132 -137
  177. package/dist/crdt/text/streams.d.ts +1 -1
  178. package/dist/crdt/text/streams.js +1 -1
  179. package/dist/crdt/vendor/yjs/API-NOTES.md +25 -8
  180. package/dist/crdt/vendor/yjs/UPSTREAM.md +288 -8
  181. package/dist/crdt/vendor/yjs/dts/global.d.ts +5 -26
  182. package/dist/crdt/vendor/yjs/dts/index.d.ts +10 -15
  183. package/dist/crdt/vendor/yjs/dts/structs/AbstractStruct.d.ts +2 -2
  184. package/dist/crdt/vendor/yjs/dts/structs/Item.d.ts +14 -219
  185. package/dist/crdt/vendor/yjs/dts/structs/Skip.d.ts +2 -2
  186. package/dist/crdt/vendor/yjs/dts/utils/BlockSet.d.ts +2 -2
  187. package/dist/crdt/vendor/yjs/dts/utils/Doc.d.ts +12 -123
  188. package/dist/crdt/vendor/yjs/dts/utils/ID.d.ts +1 -1
  189. package/dist/crdt/vendor/yjs/dts/utils/RangeCursor.d.ts +37 -58
  190. package/dist/crdt/vendor/yjs/dts/utils/Transaction.d.ts +3 -78
  191. package/dist/crdt/vendor/yjs/dts/utils/UpdateDecoder.d.ts +2 -81
  192. package/dist/crdt/vendor/yjs/dts/utils/UpdateEncoder.d.ts +2 -74
  193. package/dist/crdt/vendor/yjs/dts/utils/encoding-helpers.d.ts +4 -4
  194. package/dist/crdt/vendor/yjs/dts/utils/encoding.d.ts +6 -18
  195. package/dist/crdt/vendor/yjs/dts/utils/ids.d.ts +12 -237
  196. package/dist/crdt/vendor/yjs/dts/utils/positions.d.ts +5 -0
  197. package/dist/crdt/vendor/yjs/dts/utils/redo.d.ts +3 -0
  198. package/dist/crdt/vendor/yjs/dts/utils/transaction-helpers.d.ts +1 -3
  199. package/dist/crdt/vendor/yjs/dts/utils/updates.d.ts +6 -23
  200. package/dist/crdt/vendor/yjs/dts/ynode.d.ts +73 -498
  201. package/dist/crdt/vendor/yjs/global.d.ts +5 -26
  202. package/dist/crdt/vendor/yjs/src/index.js +11 -25
  203. package/dist/crdt/vendor/yjs/src/structs/AbstractStruct.js +1 -1
  204. package/dist/crdt/vendor/yjs/src/structs/GC.js +1 -1
  205. package/dist/crdt/vendor/yjs/src/structs/Item.js +10 -372
  206. package/dist/crdt/vendor/yjs/src/structs/Skip.js +1 -1
  207. package/dist/crdt/vendor/yjs/src/utils/BlockSet.js +2 -2
  208. package/dist/crdt/vendor/yjs/src/utils/Doc.js +14 -170
  209. package/dist/crdt/vendor/yjs/src/utils/ID.js +1 -1
  210. package/dist/crdt/vendor/yjs/src/utils/RangeCursor.js +61 -128
  211. package/dist/crdt/vendor/yjs/src/utils/StructStore.js +0 -22
  212. package/dist/crdt/vendor/yjs/src/utils/Transaction.js +17 -282
  213. package/dist/crdt/vendor/yjs/src/utils/UpdateDecoder.js +3 -130
  214. package/dist/crdt/vendor/yjs/src/utils/UpdateEncoder.js +2 -132
  215. package/dist/crdt/vendor/yjs/src/utils/encoding-helpers.js +4 -4
  216. package/dist/crdt/vendor/yjs/src/utils/encoding.js +49 -146
  217. package/dist/crdt/vendor/yjs/src/utils/ids.js +23 -900
  218. package/dist/crdt/vendor/yjs/src/utils/positions.js +115 -0
  219. package/dist/crdt/vendor/yjs/src/utils/redo.js +143 -0
  220. package/dist/crdt/vendor/yjs/src/utils/transaction-helpers.js +10 -127
  221. package/dist/crdt/vendor/yjs/src/utils/updates.js +7 -50
  222. package/dist/crdt/vendor/yjs/src/ynode.js +261 -2226
  223. package/dist/dnd/autoScroll.js +1 -2
  224. package/dist/dnd/pragmatic.d.ts +4 -22
  225. package/dist/dnd/pragmatic.js +7 -26
  226. package/dist/dnd/track.d.ts +14 -0
  227. package/dist/dnd/track.js +55 -0
  228. package/dist/dnd/vendor/pragmatic/UPSTREAM.md +103 -0
  229. package/dist/dnd/vendor/pragmatic/bind-event-listener/LICENSE +21 -0
  230. package/dist/dnd/vendor/pragmatic/bind-event-listener/bind-all.js +46 -0
  231. package/dist/dnd/vendor/pragmatic/bind-event-listener/bind.js +7 -0
  232. package/dist/dnd/vendor/pragmatic/bind-event-listener/index.js +2 -0
  233. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/LICENSE.md +11 -0
  234. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/adapter/element-adapter-native-data-key.js +6 -0
  235. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/adapter/element-adapter.d.ts +57 -0
  236. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/adapter/element-adapter.js +306 -0
  237. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/entry-point/element/adapter.d.ts +8 -0
  238. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/entry-point/element/adapter.js +10 -0
  239. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/entry-point/element/set-custom-native-drag-preview.d.ts +4 -0
  240. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/entry-point/element/set-custom-native-drag-preview.js +6 -0
  241. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/entry-point/types.d.ts +1 -0
  242. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/honey-pot-fix/get-element-from-point-without-honey-pot.js +12 -0
  243. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/honey-pot-fix/honey-pot-data-attribute.js +3 -0
  244. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/honey-pot-fix/is-honey-pot-element.js +4 -0
  245. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/honey-pot-fix/make-honey-pot-fix.js +333 -0
  246. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/internal-types.d.ts +350 -0
  247. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/ledger/dispatch-consumer-event.js +128 -0
  248. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/ledger/lifecycle-manager.js +340 -0
  249. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/ledger/usage-ledger.js +32 -0
  250. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/make-adapter/make-adapter.js +59 -0
  251. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/make-adapter/make-drop-target.js +288 -0
  252. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/make-adapter/make-monitor.js +85 -0
  253. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/combine.js +6 -0
  254. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.d.ts +36 -0
  255. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.js +153 -0
  256. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/element/custom-native-drag-preview/types.d.ts +16 -0
  257. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/public-utils/once.js +13 -0
  258. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/add-attribute.js +7 -0
  259. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/android.js +10 -0
  260. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/count-events-for-safari.js +104 -0
  261. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/is-from-another-window.js +16 -0
  262. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/is-leaving-window-in-safari.js +12 -0
  263. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/changing-window/is-leaving-window.js +55 -0
  264. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/detect-broken-drag.js +48 -0
  265. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/get-input.js +14 -0
  266. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/is-firefox.js +13 -0
  267. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/is-safari.js +19 -0
  268. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/max-z-index.js +3 -0
  269. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/media-types/text-media-type.js +6 -0
  270. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/media-types/url-media-type.js +6 -0
  271. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/popover-reset-styles.js +40 -0
  272. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop/util/supports-popover.js +16 -0
  273. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/LICENSE.md +11 -0
  274. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/entry-point/element.d.ts +4 -0
  275. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/entry-point/element.js +8 -0
  276. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/internal-types.d.ts +50 -0
  277. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/data-attributes.js +9 -0
  278. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/get-scroll-by.js +117 -0
  279. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/make-api.js +90 -0
  280. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/over-element/try-scroll.js +183 -0
  281. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/axis.js +22 -0
  282. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/can-scroll-on-edge.js +17 -0
  283. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/configuration.js +49 -0
  284. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/edges.js +9 -0
  285. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/engagement-history.js +43 -0
  286. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/get-over-element-hitbox.js +50 -0
  287. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/get-percentage-in-range.js +19 -0
  288. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/get-scroll-change.js +106 -0
  289. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/is-axis-allowed.js +3 -0
  290. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/is-within.js +11 -0
  291. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/scheduler.js +104 -0
  292. package/dist/dnd/vendor/pragmatic/pragmatic-drag-and-drop-auto-scroll/shared/side.js +6 -0
  293. package/dist/dnd/vendor/pragmatic/raf-schd/LICENSE +21 -0
  294. package/dist/dnd/vendor/pragmatic/raf-schd/raf-schd.esm.js +34 -0
  295. package/dist/edytor.svelte.d.ts +34 -64
  296. package/dist/edytor.svelte.js +116 -180
  297. package/dist/events/beforeInputCommands.d.ts +6 -11
  298. package/dist/events/beforeInputCommands.js +185 -181
  299. package/dist/events/beforeInputDeleteCommands.d.ts +20 -1
  300. package/dist/events/beforeInputDeleteCommands.js +153 -204
  301. package/dist/events/domTextOffset.d.ts +9 -9
  302. package/dist/events/domTextOffset.js +20 -48
  303. package/dist/events/events.utils.d.ts +0 -2
  304. package/dist/events/events.utils.js +0 -4
  305. package/dist/events/nativeInteractiveControl.d.ts +13 -13
  306. package/dist/events/nativeInteractiveControl.js +28 -56
  307. package/dist/events/onBeforeInput.d.ts +6 -1
  308. package/dist/events/onBeforeInput.js +207 -331
  309. package/dist/events/onCopy.js +1 -5
  310. package/dist/events/onDrop.d.ts +1 -1
  311. package/dist/events/onDrop.js +27 -69
  312. package/dist/events/onFocus.d.ts +9 -4
  313. package/dist/events/onFocus.js +45 -67
  314. package/dist/events/onInput.d.ts +8 -4
  315. package/dist/events/onInput.js +34 -147
  316. package/dist/events/onKeyDown.js +55 -122
  317. package/dist/events/onPaste.d.ts +13 -1
  318. package/dist/events/onPaste.js +46 -76
  319. package/dist/index.d.ts +10 -14
  320. package/dist/index.js +3 -3
  321. package/dist/kinds.d.ts +4 -6
  322. package/dist/kinds.js +28 -27
  323. package/dist/labels.d.ts +81 -320
  324. package/dist/labels.js +180 -408
  325. package/dist/plugins/Chrome.svelte +29 -0
  326. package/dist/plugins/Chrome.svelte.d.ts +32 -0
  327. package/dist/plugins/Control.svelte +23 -0
  328. package/dist/plugins/Control.svelte.d.ts +30 -0
  329. package/dist/plugins/anchored.svelte.d.ts +47 -0
  330. package/dist/plugins/anchored.svelte.js +73 -0
  331. package/dist/plugins/arrowMove/arrowMove.d.ts +2 -1
  332. package/dist/plugins/arrowMove/arrowMove.js +9 -5
  333. package/dist/plugins/bands.svelte.d.ts +57 -0
  334. package/dist/plugins/bands.svelte.js +95 -0
  335. package/dist/plugins/blockHandles/BlockHandle.svelte +14 -154
  336. package/dist/plugins/blockHandles/BlockHandle.svelte.d.ts +2 -2
  337. package/dist/plugins/blockHandles/BlockHandleController.svelte.d.ts +39 -94
  338. package/dist/plugins/blockHandles/BlockHandleController.svelte.js +190 -247
  339. package/dist/plugins/blockHandles/BlockHandles.svelte +27 -17
  340. package/dist/plugins/blockHandles/BlockHandles.svelte.d.ts +2 -2
  341. package/dist/plugins/blockHandles/blockHandlesPlugin.d.ts +25 -39
  342. package/dist/plugins/blockHandles/blockHandlesPlugin.js +129 -185
  343. package/dist/plugins/blockHandles/dragPreview.d.ts +8 -6
  344. package/dist/plugins/blockHandles/dragPreview.js +18 -16
  345. package/dist/plugins/blockHandles/dropIndicator.js +52 -60
  346. package/dist/plugins/blockHandles/geometry.d.ts +2 -1
  347. package/dist/plugins/blockHandles/geometry.js +6 -6
  348. package/dist/plugins/blockMenu/BlockMenuController.svelte.d.ts +28 -38
  349. package/dist/plugins/blockMenu/BlockMenuController.svelte.js +116 -183
  350. package/dist/plugins/blockMenu/blockMenuPlugin.d.ts +1 -3
  351. package/dist/plugins/blockMenu/blockMenuPlugin.js +12 -29
  352. package/dist/plugins/brand.d.ts +8 -0
  353. package/dist/plugins/brand.js +8 -0
  354. package/dist/plugins/chrome.d.ts +45 -38
  355. package/dist/plugins/chrome.js +59 -36
  356. package/dist/plugins/code/CodeHeader.svelte +3 -35
  357. package/dist/plugins/code/CodePlugin.svelte +50 -53
  358. package/dist/plugins/code/CodePlugin.svelte.d.ts +0 -2
  359. package/dist/plugins/code/LanguageMenu.svelte +16 -125
  360. package/dist/plugins/code/LanguageMenu.svelte.d.ts +2 -1
  361. package/dist/plugins/code/code.css +5 -117
  362. package/dist/plugins/code/header.svelte.d.ts +2 -11
  363. package/dist/plugins/code/header.svelte.js +11 -38
  364. package/dist/plugins/code/languageMenu.svelte.d.ts +12 -32
  365. package/dist/plugins/code/languageMenu.svelte.js +30 -160
  366. package/dist/plugins/code/languages.d.ts +9 -19
  367. package/dist/plugins/code/languages.js +39 -126
  368. package/dist/plugins/columns/ColumnResize.svelte +13 -25
  369. package/dist/plugins/columns/ColumnResize.svelte.d.ts +1 -1
  370. package/dist/plugins/columns/ColumnsPlugin.svelte +46 -78
  371. package/dist/plugins/columns/ColumnsPlugin.svelte.d.ts +0 -12
  372. package/dist/plugins/columns/columns.css +7 -26
  373. package/dist/plugins/columns/resize.svelte.d.ts +14 -51
  374. package/dist/plugins/columns/resize.svelte.js +70 -164
  375. package/dist/plugins/comments/CommentsController.svelte.d.ts +1 -4
  376. package/dist/plugins/comments/CommentsController.svelte.js +14 -25
  377. package/dist/plugins/comments/CommentsSidebar.svelte +82 -431
  378. package/dist/plugins/comments/CommentsSidebar.svelte.d.ts +4 -2
  379. package/dist/plugins/comments/commentsPlugin.d.ts +25 -9
  380. package/dist/plugins/comments/commentsPlugin.js +12 -10
  381. package/dist/plugins/equation/EquationEditor.svelte +16 -130
  382. package/dist/plugins/equation/EquationEditor.svelte.d.ts +1 -2
  383. package/dist/plugins/equation/EquationPlugin.svelte +109 -165
  384. package/dist/plugins/equation/EquationPlugin.svelte.d.ts +2 -2
  385. package/dist/plugins/equation/EquationView.svelte +20 -11
  386. package/dist/plugins/equation/equation.svelte.d.ts +37 -24
  387. package/dist/plugins/equation/equation.svelte.js +20 -94
  388. package/dist/plugins/equation/katex.js +6 -9
  389. package/dist/plugins/find/FindController.svelte.d.ts +8 -13
  390. package/dist/plugins/find/FindController.svelte.js +34 -55
  391. package/dist/plugins/find/findPlugin.d.ts +4 -8
  392. package/dist/plugins/find/findPlugin.js +29 -9
  393. package/dist/plugins/image/ImageChrome.svelte +6 -167
  394. package/dist/plugins/image/ImageChrome.svelte.d.ts +0 -2
  395. package/dist/plugins/image/ImagePlugin.svelte +45 -134
  396. package/dist/plugins/image/ImagePlugin.svelte.d.ts +1 -42
  397. package/dist/plugins/image/ImageToolbarHost.svelte +37 -0
  398. package/dist/plugins/image/ImageToolbarHost.svelte.d.ts +9 -0
  399. package/dist/plugins/image/controls.svelte.d.ts +6 -36
  400. package/dist/plugins/image/controls.svelte.js +43 -212
  401. package/dist/plugins/image/image.d.ts +0 -5
  402. package/dist/plugins/image/image.js +0 -3
  403. package/dist/plugins/image/toolbar.svelte.d.ts +69 -0
  404. package/dist/plugins/image/toolbar.svelte.js +145 -0
  405. package/dist/plugins/index.d.ts +31 -26
  406. package/dist/plugins/index.js +29 -22
  407. package/dist/plugins/list.svelte.d.ts +128 -0
  408. package/dist/plugins/list.svelte.js +217 -0
  409. package/dist/plugins/markdownShortcuts.d.ts +1 -1
  410. package/dist/plugins/markdownShortcuts.js +6 -5
  411. package/dist/plugins/marquee/MarqueeBox.svelte +3 -20
  412. package/dist/plugins/marquee/MarqueeBox.svelte.d.ts +1 -1
  413. package/dist/plugins/marquee/MarqueeController.svelte.d.ts +0 -2
  414. package/dist/plugins/marquee/MarqueeController.svelte.js +20 -23
  415. package/dist/plugins/marquee/marquee.js +4 -21
  416. package/dist/plugins/marquee/marqueePlugin.d.ts +4 -3
  417. package/dist/plugins/marquee/marqueePlugin.js +16 -15
  418. package/dist/plugins/media/AudioPlugin.svelte +3 -90
  419. package/dist/plugins/media/AudioPlugin.svelte.d.ts +1 -4
  420. package/dist/plugins/media/BookmarkPlugin.svelte +113 -120
  421. package/dist/plugins/media/BookmarkPlugin.svelte.d.ts +10 -15
  422. package/dist/plugins/media/EmbedPlugin.svelte +82 -86
  423. package/dist/plugins/media/EmbedPlugin.svelte.d.ts +11 -17
  424. package/dist/plugins/media/EmptySlot.svelte +44 -0
  425. package/dist/plugins/media/EmptySlot.svelte.d.ts +25 -0
  426. package/dist/plugins/media/FilePlugin.svelte +35 -113
  427. package/dist/plugins/media/FilePlugin.svelte.d.ts +12 -4
  428. package/dist/plugins/media/MediaEmpty.svelte +51 -90
  429. package/dist/plugins/media/MediaEmpty.svelte.d.ts +26 -10
  430. package/dist/plugins/media/SourceBlock.svelte +164 -0
  431. package/dist/plugins/media/SourceBlock.svelte.d.ts +33 -0
  432. package/dist/plugins/media/VideoPlugin.svelte +4 -99
  433. package/dist/plugins/media/VideoPlugin.svelte.d.ts +2 -5
  434. package/dist/plugins/media/empty.svelte.d.ts +36 -44
  435. package/dist/plugins/media/empty.svelte.js +41 -45
  436. package/dist/plugins/media/media.d.ts +90 -44
  437. package/dist/plugins/media/media.js +77 -99
  438. package/dist/plugins/media/urlPaste.svelte.d.ts +6 -37
  439. package/dist/plugins/media/urlPaste.svelte.js +32 -102
  440. package/dist/plugins/mention/MentionPlugin.svelte +42 -123
  441. package/dist/plugins/mention/MentionPlugin.svelte.d.ts +6 -25
  442. package/dist/plugins/page/PageLink.svelte +54 -38
  443. package/dist/plugins/page/PagePlugin.svelte +20 -18
  444. package/dist/plugins/page/PagePlugin.svelte.d.ts +2 -4
  445. package/dist/plugins/page/page.d.ts +35 -9
  446. package/dist/plugins/page/page.js +3 -4
  447. package/dist/plugins/pageLink/PageLinkPlugin.svelte +47 -107
  448. package/dist/plugins/pageLink/PageLinkPlugin.svelte.d.ts +6 -25
  449. package/dist/plugins/planned.d.ts +10 -0
  450. package/dist/plugins/planned.js +12 -0
  451. package/dist/plugins/richtext/CalloutIcon.svelte +13 -26
  452. package/dist/plugins/richtext/CalloutIconPicker.svelte +26 -0
  453. package/dist/plugins/richtext/CalloutIconPicker.svelte.d.ts +9 -0
  454. package/dist/plugins/richtext/EmptyBody.svelte +13 -20
  455. package/dist/plugins/richtext/RichTextControl.svelte +39 -0
  456. package/dist/plugins/richtext/RichTextControl.svelte.d.ts +8 -0
  457. package/dist/plugins/richtext/RichTextPlugin.svelte +161 -177
  458. package/dist/plugins/richtext/RichTextPlugin.svelte.d.ts +33 -34
  459. package/dist/plugins/richtext/TodoCheckbox.svelte +10 -21
  460. package/dist/plugins/richtext/TodoCheckbox.svelte.d.ts +0 -2
  461. package/dist/plugins/richtext/body.js +2 -2
  462. package/dist/plugins/richtext/calloutIcons.svelte.d.ts +50 -55
  463. package/dist/plugins/richtext/calloutIcons.svelte.js +86 -174
  464. package/dist/plugins/richtext/callouts.d.ts +15 -0
  465. package/dist/plugins/richtext/callouts.js +23 -0
  466. package/dist/plugins/richtext/controls.svelte.d.ts +110 -0
  467. package/dist/plugins/richtext/controls.svelte.js +126 -0
  468. package/dist/plugins/richtext/richTextOperations.js +37 -28
  469. package/dist/plugins/slashMenu/SlashMenuController.svelte.d.ts +2 -14
  470. package/dist/plugins/slashMenu/SlashMenuController.svelte.js +34 -71
  471. package/dist/plugins/slashMenu/slashMenuPlugin.d.ts +9 -26
  472. package/dist/plugins/slashMenu/slashMenuPlugin.js +27 -68
  473. package/dist/plugins/suggestions/SuggestionBars.svelte +27 -84
  474. package/dist/plugins/suggestions/SuggestionBars.svelte.d.ts +9 -3
  475. package/dist/plugins/suggestions/suggestionsPlugin.d.ts +10 -18
  476. package/dist/plugins/suggestions/suggestionsPlugin.js +9 -24
  477. package/dist/plugins/table/TableChrome.svelte +40 -124
  478. package/dist/plugins/table/TablePlugin.svelte +106 -168
  479. package/dist/plugins/table/TablePlugin.svelte.d.ts +0 -4
  480. package/dist/plugins/table/chrome.svelte.d.ts +38 -141
  481. package/dist/plugins/table/chrome.svelte.js +339 -589
  482. package/dist/plugins/table/ops.d.ts +47 -0
  483. package/dist/plugins/table/ops.js +233 -0
  484. package/dist/plugins/table/table.css +16 -152
  485. package/dist/plugins/table/table.d.ts +15 -14
  486. package/dist/plugins/table/table.js +22 -16
  487. package/dist/plugins/toc/TableOfContents.svelte +32 -38
  488. package/dist/plugins/toc/TableOfContents.svelte.d.ts +1 -5
  489. package/dist/plugins/toc/TocPlugin.svelte +22 -22
  490. package/dist/plugins/toc/TocPlugin.svelte.d.ts +4 -6
  491. package/dist/plugins/toc/toc.d.ts +41 -10
  492. package/dist/plugins/toc/toc.js +2 -3
  493. package/dist/plugins/toolbar/ToolbarController.svelte.d.ts +4 -68
  494. package/dist/plugins/toolbar/ToolbarController.svelte.js +63 -89
  495. package/dist/plugins/toolbar/toolbarPlugin.d.ts +8 -18
  496. package/dist/plugins/toolbar/toolbarPlugin.js +28 -43
  497. package/dist/plugins/triggers/TriggerController.svelte.d.ts +4 -68
  498. package/dist/plugins/triggers/TriggerController.svelte.js +48 -129
  499. package/dist/plugins/triggers/place.d.ts +0 -9
  500. package/dist/plugins/triggers/place.js +1 -17
  501. package/dist/plugins/triggers/triggers.d.ts +31 -9
  502. package/dist/plugins/triggers/triggers.js +82 -62
  503. package/dist/plugins/uploads.svelte.d.ts +38 -20
  504. package/dist/plugins/uploads.svelte.js +39 -32
  505. package/dist/plugins.d.ts +154 -59
  506. package/dist/selection/domSelection.d.ts +13 -4
  507. package/dist/selection/domSelection.js +110 -183
  508. package/dist/selection/pointer.svelte.d.ts +8 -10
  509. package/dist/selection/pointer.svelte.js +32 -73
  510. package/dist/selection/replaceSelection.d.ts +21 -22
  511. package/dist/selection/replaceSelection.js +60 -69
  512. package/dist/selection/selection.svelte.d.ts +5 -73
  513. package/dist/selection/selection.svelte.js +224 -542
  514. package/dist/selection/selection.utils.d.ts +34 -11
  515. package/dist/selection/selection.utils.js +128 -247
  516. package/dist/selection/visibility.d.ts +3 -8
  517. package/dist/selection/visibility.js +7 -5
  518. package/dist/session/announcer.svelte.d.ts +2 -1
  519. package/dist/session/announcer.svelte.js +7 -3
  520. package/dist/session/attempt.d.ts +33 -39
  521. package/dist/session/attempt.js +61 -55
  522. package/dist/session/bindings.js +108 -139
  523. package/dist/session/commands.d.ts +47 -22
  524. package/dist/session/commands.js +206 -208
  525. package/dist/session/composition.svelte.d.ts +2 -4
  526. package/dist/session/composition.svelte.js +55 -65
  527. package/dist/session/editing/text.d.ts +6 -0
  528. package/dist/session/editing/text.js +17 -3
  529. package/dist/session/handles.d.ts +10 -1
  530. package/dist/session/handles.js +28 -0
  531. package/dist/session/history.d.ts +0 -4
  532. package/dist/session/history.js +15 -21
  533. package/dist/session/inputRules.js +75 -84
  534. package/dist/session/keymap.d.ts +1 -6
  535. package/dist/session/keymap.js +17 -20
  536. package/dist/session/moves.d.ts +10 -10
  537. package/dist/session/moves.js +31 -59
  538. package/dist/session/navigation.d.ts +3 -2
  539. package/dist/session/navigation.js +127 -168
  540. package/dist/session/ports.d.ts +2 -7
  541. package/dist/session/selection.d.ts +4 -3
  542. package/dist/session/selection.js +5 -0
  543. package/dist/session/suggestions.svelte.d.ts +1 -1
  544. package/dist/session/suggestions.svelte.js +42 -47
  545. package/dist/session/virtual.d.ts +3 -3
  546. package/dist/session/virtual.js +18 -40
  547. package/dist/surface/attributes.d.ts +1 -0
  548. package/dist/surface/attributes.js +3 -26
  549. package/dist/surface/cells.d.ts +5 -0
  550. package/dist/surface/cells.js +5 -0
  551. package/dist/surface/lines.d.ts +2 -2
  552. package/dist/surface/lines.js +1 -1
  553. package/dist/surface/observer.svelte.d.ts +3 -20
  554. package/dist/surface/observer.svelte.js +52 -72
  555. package/dist/surface/overlay.d.ts +41 -3
  556. package/dist/surface/overlay.js +92 -37
  557. package/dist/surface/pin.svelte.d.ts +5 -0
  558. package/dist/surface/pin.svelte.js +5 -0
  559. package/dist/surface/projector.svelte.d.ts +4 -6
  560. package/dist/surface/projector.svelte.js +42 -69
  561. package/dist/text/text.svelte.d.ts +14 -40
  562. package/dist/text/text.svelte.js +35 -51
  563. package/dist/text/wordBoundary.d.ts +19 -0
  564. package/dist/text/wordBoundary.js +29 -44
  565. package/dist/themes/notion.css +263 -106
  566. package/dist/utils/json.d.ts +3 -1
  567. package/dist/utils/json.js +52 -51
  568. package/dist/utils/listen.d.ts +8 -0
  569. package/dist/utils/listen.js +19 -0
  570. package/package.json +4 -5
  571. package/dist/block/block.utils.d.ts +0 -340
  572. package/dist/block/block.utils.js +0 -356
  573. package/dist/collaboration/history/HistoryPanel.svelte +0 -554
  574. package/dist/collaboration/history/HistoryPanel.svelte.d.ts +0 -7
  575. package/dist/collaboration/history/panel.d.ts +0 -61
  576. package/dist/collaboration/history/panel.js +0 -3
  577. package/dist/components/SuggestionRanges.svelte +0 -58
  578. package/dist/components/SuggestionRanges.svelte.d.ts +0 -7
  579. package/dist/crdt/doc/table.d.ts +0 -21
  580. package/dist/crdt/doc/table.js +0 -288
  581. package/dist/crdt/migration/generation.d.ts +0 -58
  582. package/dist/crdt/migration/generation.js +0 -70
  583. package/dist/crdt/migration/legacy-schema.d.ts +0 -61
  584. package/dist/crdt/migration/legacy-schema.js +0 -151
  585. package/dist/crdt/migration/migrate.d.ts +0 -56
  586. package/dist/crdt/migration/migrate.js +0 -227
  587. package/dist/crdt/nodes.d.ts +0 -121
  588. package/dist/crdt/nodes.js +0 -56
  589. package/dist/crdt/text/index/checks.d.ts +0 -15
  590. package/dist/crdt/text/index/checks.js +0 -156
  591. package/dist/crdt/vendor/yjs/dts/utils/EventHandler.d.ts +0 -17
  592. package/dist/crdt/vendor/yjs/dts/utils/RelativePosition.d.ts +0 -80
  593. package/dist/crdt/vendor/yjs/dts/utils/UndoManager.d.ts +0 -205
  594. package/dist/crdt/vendor/yjs/dts/utils/YEvent.d.ts +0 -93
  595. package/dist/crdt/vendor/yjs/dts/utils/meta.d.ts +0 -25
  596. package/dist/crdt/vendor/yjs/dts/utils/renderer-helpers.d.ts +0 -98
  597. package/dist/crdt/vendor/yjs/dts/utils/schemas.d.ts +0 -2
  598. package/dist/crdt/vendor/yjs/src/utils/EventHandler.js +0 -75
  599. package/dist/crdt/vendor/yjs/src/utils/RelativePosition.js +0 -301
  600. package/dist/crdt/vendor/yjs/src/utils/UndoManager.js +0 -554
  601. package/dist/crdt/vendor/yjs/src/utils/YEvent.js +0 -158
  602. package/dist/crdt/vendor/yjs/src/utils/meta.js +0 -74
  603. package/dist/crdt/vendor/yjs/src/utils/renderer-helpers.js +0 -186
  604. package/dist/crdt/vendor/yjs/src/utils/schemas.js +0 -3
  605. package/dist/edytor.utils.d.ts +0 -50
  606. package/dist/edytor.utils.js +0 -67
  607. package/dist/plugins/blockMenu/BlockMenu.svelte +0 -335
  608. package/dist/plugins/blockMenu/BlockMenu.svelte.d.ts +0 -9
  609. package/dist/plugins/find/FindBar.svelte +0 -170
  610. package/dist/plugins/find/FindBar.svelte.d.ts +0 -9
  611. package/dist/plugins/find/FindHighlights.svelte +0 -75
  612. package/dist/plugins/find/FindHighlights.svelte.d.ts +0 -9
  613. package/dist/plugins/icons.d.ts +0 -2
  614. package/dist/plugins/icons.js +0 -63
  615. package/dist/plugins/image/ImageEmpty.svelte +0 -93
  616. package/dist/plugins/image/ImageEmpty.svelte.d.ts +0 -15
  617. package/dist/plugins/image/empty.svelte.d.ts +0 -56
  618. package/dist/plugins/image/empty.svelte.js +0 -83
  619. package/dist/plugins/keepInView.d.ts +0 -4
  620. package/dist/plugins/keepInView.js +0 -6
  621. package/dist/plugins/media/UrlPasteMenu.svelte +0 -92
  622. package/dist/plugins/media/UrlPasteMenu.svelte.d.ts +0 -9
  623. package/dist/plugins/richtext/CalloutIconMenu.svelte +0 -98
  624. package/dist/plugins/richtext/CalloutIconMenu.svelte.d.ts +0 -9
  625. package/dist/plugins/richtext/labels.d.ts +0 -9
  626. package/dist/plugins/richtext/labels.js +0 -7
  627. package/dist/plugins/slashMenu/SlashMenu.svelte +0 -276
  628. package/dist/plugins/slashMenu/SlashMenu.svelte.d.ts +0 -11
  629. package/dist/plugins/table/dragPreview.d.ts +0 -29
  630. package/dist/plugins/table/dragPreview.js +0 -103
  631. package/dist/plugins/toolbar/LinkCard.svelte +0 -122
  632. package/dist/plugins/toolbar/LinkCard.svelte.d.ts +0 -9
  633. package/dist/plugins/toolbar/Toolbar.svelte +0 -349
  634. package/dist/plugins/toolbar/Toolbar.svelte.d.ts +0 -9
  635. package/dist/plugins/triggers/TriggerMenu.svelte +0 -135
  636. package/dist/plugins/triggers/TriggerMenu.svelte.d.ts +0 -7
  637. package/dist/session/props.d.ts +0 -28
  638. package/dist/session/props.js +0 -162
  639. package/dist/text/deltas.d.ts +0 -22
  640. package/dist/text/deltas.js +0 -46
  641. package/dist/text/text.utils.d.ts +0 -45
  642. package/dist/text/text.utils.js +0 -199
@@ -1,6 +1,5 @@
1
1
  /**
2
- * Legacy attribution surface: actor dictionary + inert reads over
3
- * pre-existing per-edit records.
2
+ * Attribution surface: the actor dictionary and the per-block records.
4
3
  *
5
4
  * The per-edit capture pipeline of earlier builds (immutable `a/<nonce>/<seq>` ContentMap records
6
5
  * written in a follow-up transaction per committed edit, projected onto
@@ -23,25 +22,15 @@
23
22
  * also travel inside `encode()` output, so `loadDocument` restores the
24
23
  * dictionary without republishing.
25
24
  *
26
- * LEGACY RECORDS — documents saved by pre-U2 builds carry `a/` records
27
- * under the same root. They are plain replicated state: preserved
28
- * verbatim by `encode()`/sync and readable through `legacy()`, which
29
- * decodes and merges them with the native `decodeContentMap` codecs.
30
- * This build never writes new `a/` records; old replicas that still do
31
- * simply append more keys — reads stay total and convergence is the
32
- * ordinary attribute-record merge.
33
- *
34
- * RETENTION — `a/` state is retained as long as it exists in the
35
- * document (no GC of the records themselves); `live()`/renderer
36
- * projections are gone, and the engine no longer ships concrete
37
- * renderers (fork patch YP8, UPSTREAM.md) — consumers that need a rendered view over
38
- * legacy records implement the engine's `AbstractRenderer` over the
39
- * `ContentMap` `legacy()` returns and pass it to `toDelta({renderer})`.
25
+ * LEGACY RECORDS — documents saved by early builds carry `a/` per-edit
26
+ * records under the same root. They are plain replicated state, preserved
27
+ * verbatim by `encode()`/sync (no GC of the records themselves); nothing
28
+ * reads them. This build never writes new `a/` records; old replicas that
29
+ * still do simply append more keys — convergence is the ordinary
30
+ * attribute-record merge.
40
31
  */
41
32
  import type { EngineApi, EngineDoc } from '../engine-api.js';
42
- import type * as Engine from '../vendor/yjs/dts/index.js';
43
33
  import { ATTRIBUTION_ROOT } from '../schema.js';
44
- import { type JSONBlock } from '../../utils/json.js';
45
34
  import { type BlockAttribution } from './block.js';
46
35
  /** Reserved replicated root for all attribution metadata (`SCHEMA.roots.attribution`). */
47
36
  export { ATTRIBUTION_ROOT };
@@ -63,7 +52,7 @@ export type ActorProfile = {
63
52
  color?: string;
64
53
  };
65
54
  /**
66
- * The document-level attribution surface. `actors`/`actorOf`/`legacy`
55
+ * The document-level attribution surface. `actors`/`actorOf`/`block`
67
56
  * read replicated doc state directly — they resolve remote-applied
68
57
  * records identically and stay correct as old replicas append records.
69
58
  */
@@ -78,16 +67,6 @@ export type DocumentAttribution = {
78
67
  * actor id; only the resolvable profile changes.
79
68
  */
80
69
  setProfile(profile: ActorProfile): void;
81
- /**
82
- * Merged read over the pre-existing `a/` records written by the
83
- * retired per-edit capture pipeline: `{inserts, deletes}` IdMaps in
84
- * the native ContentMap shape, decoded fresh per call. Returns `null`
85
- * when the document carries no legacy records. For a rendered history
86
- * view, implement the engine's `AbstractRenderer` over it (the engine
87
- * ships no concrete renderer); the ordinary
88
- * runs/projection surface does not consult it.
89
- */
90
- legacy(): Engine.ContentMap | null;
91
70
  /**
92
71
  * Compact per-block attribution for `blockId`
93
72
  * (`{createdBy, contributors, lastChangedBy}` — durable actor ids,
@@ -103,48 +82,6 @@ export type DocumentAttribution = {
103
82
  * present it as "written by" for visible text.
104
83
  */
105
84
  block(blockId: string): BlockAttribution | undefined;
106
- /**
107
- * Opt-in bounded lineage ring for `blockId` — the block's subtree
108
- * snapshots captured just BEFORE displacing events: another actor's
109
- * first write (an `l` handoff), a delete, or an undo/redo touching the
110
- * block. Oldest → newest, capped at the document's configured
111
- * `lineage.depth`; `undefined` when the block carries no record (and
112
- * empty when the feature is off or nothing has been displaced yet).
113
- *
114
- * The cap is enforced HERE, at read: concurrent appends under
115
- * partition can transiently store `depth + n` entries (the
116
- * append-side trim only sees the writer's own ring) until the
117
- * replicated watermark trim converges the stored ring — this view
118
- * never returns more than `depth`. A replica configured `depth: 0`
119
- * (writes off) instead sees the ring's own retention bound — the
120
- * deepest depth any surviving entry's writer used.
121
- *
122
- * Each entry's `block` is a deep-copied `JSONBlock` — restoring an
123
- * entry is an ordinary `setBlock`-class edit (which itself lands a
124
- * new entry, displacing the state it overwrote). Entries on a dead
125
- * block stay readable here — the record survives deletion — but a
126
- * reincarnated block id starts a FRESH ring: old history never
127
- * contaminates the new incarnation.
128
- */
129
- history(blockId: string): BlockLineageEntry[] | undefined;
130
- };
131
- /** A public lineage entry — the expanded form of the compact wire record. */
132
- export type BlockLineageEntry = {
133
- /** The displaced owner (absent when the block was unattributed at capture). */
134
- actor?: string;
135
- /** The actor whose edit displaced the state (or whose undo/redo touched the block). */
136
- by: string;
137
- /**
138
- * Ring position at append — a display aid only. It can REPEAT (a trim
139
- * rewinds the position counter, and concurrent replicas assign the
140
- * same position independently): never an entry id — array order is
141
- * the truth.
142
- */
143
- seq: number;
144
- /** Wall-clock capture time — display only, never ordering. */
145
- time?: number;
146
- /** The displaced subtree snapshot (deep-copied — safe to keep/mutate). */
147
- block: JSONBlock;
148
85
  };
149
86
  export type AttributionController = {
150
87
  /** The public read surface handed to `EdytorDocument.attribution`. */
@@ -157,13 +94,15 @@ export type AttributionController = {
157
94
  type AttachOptions = {
158
95
  actor: AttributionActor;
159
96
  };
97
+ /** The display profile of `actor`: its name and color, those it has. */
98
+ export declare const profileOf: (actor: AttributionActor) => ActorProfile;
160
99
  /**
161
100
  * Bind the attribution service to a concrete engine — same injection
162
101
  * pattern as `bindEdytorDoc`/`bindDocument`. Lifecycle is owned by the
163
102
  * calling document: one controller per `EdytorDocument`, attached in the
164
103
  * constructor, released on destroy.
165
104
  */
166
- export declare const bindAttribution: (Y: EngineApi) => {
105
+ export declare const bindAttribution: (_Y: EngineApi) => {
167
106
  attach: (doc: EngineDoc, opts: AttachOptions) => AttributionController;
168
107
  };
169
108
  export type AttributionBinding = ReturnType<typeof bindAttribution>;
@@ -1,6 +1,5 @@
1
1
  import { ATTRIBUTION_ROOT } from '../schema.js';
2
- import { cloneJson } from '../../utils/json.js';
3
- import { blockAttributionOf, lineageOf, lineageWatermarkOf } from './block.js';
2
+ import { blockAttributionOf } from './block.js';
4
3
  /** Reserved replicated root for all attribution metadata (`SCHEMA.roots.attribution`). */
5
4
  export { ATTRIBUTION_ROOT };
6
5
  /**
@@ -9,7 +8,6 @@ export { ATTRIBUTION_ROOT };
9
8
  * out of undo capture; tooling classifies it as bookkeeping.
10
9
  */
11
10
  export const ATTRIBUTION_ORIGIN = Symbol('edytor.attribution');
12
- const RECORD_PREFIX = 'a/'; // legacy immutable per-transaction ContentMap records
13
11
  const ACTOR_PREFIX = 'u/'; // actorId → profile records
14
12
  const CLIENT_PREFIX = 'c/'; // replica clientID → actorId records
15
13
  const sanitizeProfile = (value) => {
@@ -21,7 +19,8 @@ const sanitizeProfile = (value) => {
21
19
  out.color = v.color;
22
20
  return out;
23
21
  };
24
- const profileOf = (actor) => ({
22
+ /** The display profile of `actor`: its name and color, those it has. */
23
+ export const profileOf = (actor) => ({
25
24
  ...(actor.name !== undefined ? { name: actor.name } : {}),
26
25
  ...(actor.color !== undefined ? { color: actor.color } : {})
27
26
  });
@@ -31,7 +30,7 @@ const profileOf = (actor) => ({
31
30
  * calling document: one controller per `EdytorDocument`, attached in the
32
31
  * constructor, released on destroy.
33
32
  */
34
- export const bindAttribution = (Y) => {
33
+ export const bindAttribution = (_Y) => {
35
34
  /**
36
35
  * Attach the actor dictionary to `doc`: publishes this replica's
37
36
  * `c/`+`u/` records and returns the read-through view. No listeners —
@@ -74,55 +73,9 @@ export const bindAttribution = (Y) => {
74
73
  return typeof value === 'string' && value.length > 0 ? value : undefined;
75
74
  },
76
75
  setProfile,
77
- legacy: () => {
78
- const inserts = Y.createIdMap();
79
- const deletes = Y.createIdMap();
80
- let found = false;
81
- for (const key of root.attrKeys()) {
82
- if (!key.startsWith(RECORD_PREFIX))
83
- continue;
84
- const value = root.getAttr(key);
85
- if (!(value instanceof Uint8Array))
86
- continue;
87
- let change;
88
- try {
89
- change = Y.decodeContentMap(value);
90
- }
91
- catch {
92
- continue; // malformed record — skip, never poison the merged map
93
- }
94
- Y.insertIntoIdMap(inserts, change.inserts);
95
- Y.insertIntoIdMap(deletes, change.deletes);
96
- found = true;
97
- }
98
- return found ? Y.createContentMap(inserts, deletes) : null;
99
- },
100
76
  // `b/<id>` records live on the `blockattr` root and `l` on
101
77
  // the block node — plain replicated reads, no observer needed.
102
- block: (blockId) => blockAttributionOf(doc, blockId),
103
- // Opt-in ring (`lineage.depth`): read the record's list items
104
- // capped at the ring's watermark — the max depth of surviving
105
- // entries, identical to the bound appends and the receive-side
106
- // trim enforce, so every replica reads the SAME ring for the
107
- // same stored state regardless of its own `lineage.depth`.
108
- // (Concurrent appends can store a transient excess until the
109
- // trim converges it.) Deep-copy each entry — the stored `j`
110
- // snapshot is shared replicated state and must not be mutable
111
- // through this view.
112
- history: (blockId) => {
113
- const entries = lineageOf(doc, blockId);
114
- if (entries === undefined)
115
- return undefined;
116
- const cap = lineageWatermarkOf(entries);
117
- const visible = entries.length > cap ? entries.slice(entries.length - cap) : entries;
118
- return visible.map((e) => ({
119
- ...(e.a !== undefined ? { actor: e.a } : {}),
120
- by: e.by,
121
- seq: e.s,
122
- ...(e.t !== undefined ? { time: e.t } : {}),
123
- block: cloneJson(e.j)
124
- }));
125
- }
78
+ block: (blockId) => blockAttributionOf(doc, blockId)
126
79
  };
127
80
  return {
128
81
  view,
@@ -77,51 +77,6 @@ export type BlockAttribution = {
77
77
  /** The actor whose state change currently wins the LWW resolution. */
78
78
  lastChangedBy?: ActorId;
79
79
  };
80
- /**
81
- * One bounded-lineage checkpoint on a block's `brec` record — the block's
82
- * subtree JSON captured JUST BEFORE a displacing edit: an `l` handoff
83
- * (another actor's first write), a delete, or an undo/redo touching the
84
- * block. Entries live as list items on the record node itself, appended
85
- * and ring-trimmed to the document's configured depth inside the owning
86
- * op's transaction — they die with the record on reincarnation. Compact
87
- * wire keys keep the replicated payload small; the public surface
88
- * (`attribution.history`) re-expands them.
89
- */
90
- export type LineageEntry = {
91
- /** The displaced owner — the `l` winner when captured (absent when unattributed). */
92
- a?: ActorId;
93
- /** The actor whose edit displaced the state (or whose undo/redo touched the block). */
94
- by: ActorId;
95
- /**
96
- * Ring position at append — a display aid only. It can REPEAT (after a
97
- * trim the position counter rewinds, and concurrent replicas assign
98
- * the same position independently): never an entry id — list order is
99
- * the truth.
100
- */
101
- s: number;
102
- /** Wall-clock capture time — display only, never ordering. */
103
- t?: number;
104
- /** The displaced subtree snapshot (a `JSONBlock`). */
105
- j: unknown;
106
- /**
107
- * The appending writer's configured ring depth. THE retention bound is
108
- * the MAX of surviving entries' `d` — enforced identically by
109
- * `appendLineage` (same-tx trim), `attachRingTrim` (receive-side
110
- * repair), and `history()` (read view), so a shallow replica can never
111
- * evict a deeper writer's surviving history on ANY path. Entries
112
- * written before `d` existed leave it absent → the ring is exempt from
113
- * trimming entirely (the writers' bound is unknowable — evict
114
- * nothing).
115
- */
116
- d?: number;
117
- };
118
- /**
119
- * The ring's retention bound — the deepest `lineage.depth` any surviving
120
- * entry's writer was configured with. `POSITIVE_INFINITY` when ANY entry
121
- * lacks `d` (pre-watermark data): without knowing every writer's bound,
122
- * no entry may be evicted on their behalf.
123
- */
124
- export declare const lineageWatermarkOf: (entries: LineageEntry[]) => number;
125
80
  export { BLOCK_ATTR_ROOT, LAST_CHANGED_ATTR };
126
81
  /** The `k/` member set on a `b/` record node. */
127
82
  export declare const contributorsOfRecord: (rec: EngineNode | null) => Set<ActorId>;
@@ -131,12 +86,6 @@ export declare const contributorsOfRecord: (rec: EngineNode | null) => Set<Actor
131
86
  * carries no attribution at all (system/foreign content stays unlabeled).
132
87
  */
133
88
  export declare const blockAttributionOf: (doc: EngineDoc, id: BlockId) => BlockAttribution | undefined;
134
- /**
135
- * Read one block's lineage ring, oldest → newest — or `undefined` when
136
- * the block carries no record. Entries are the stored content values;
137
- * callers deep-copy before exposing them publicly.
138
- */
139
- export declare const lineageOf: (doc: EngineDoc, id: BlockId) => LineageEntry[] | undefined;
140
89
  /**
141
90
  * Bound write helpers. `stampChange`/`stampCreated`/`unionContributors`
142
91
  * must be called INSIDE the operation's `doc.transact` — they perform
@@ -169,32 +118,5 @@ export declare const bindBlockAttribution: (Y: EngineApi) => {
169
118
  * The merger itself lands via `stampChange` on the survivor.
170
119
  */
171
120
  unionContributors: (doc: EngineDoc, intoId: BlockId, fromId: BlockId) => void;
172
- /**
173
- * Append a displaced-state checkpoint to the block's ring and trim
174
- * to the ring's watermark — `max` of surviving entries' `d`,
175
- * including the fresh one. The caller captures `entry.j` BEFORE its
176
- * model write (see `lineagePending` in `edytor-doc.ts`) and calls
177
- * this only after the write proves out, so a refused write appends
178
- * nothing. The watermark is THE retention policy — identical on
179
- * append, on receive (`attachRingTrim`), and on read — so a shallow
180
- * replica never evicts a deeper writer's surviving history, and the
181
- * bound shrinks only once the deepest entries have themselves
182
- * aged out. Concurrent appends under partition can still merge a
183
- * ring past the watermark — neither side saw the other's entry —
184
- * which the receive-side repair converges back.
185
- */
186
- appendLineage: (doc: EngineDoc, id: BlockId, entry: Omit<LineageEntry, "s" | "d">, depth: number) => void;
187
- /**
188
- * The block's lineage ring, oldest → newest — or `undefined` when
189
- * the block has no record at all. Entries are the stored content
190
- * values; the public surface copies them before handing them out.
191
- */
192
- lineageOf: (doc: EngineDoc, id: BlockId) => LineageEntry[] | undefined;
193
- /**
194
- * Attach the doc's shared ring-watermark repair — once per doc for
195
- * the doc's lifetime (module-level dedupe). See the module-level comment
196
- * below.
197
- */
198
- attachRingTrim: (doc: EngineDoc) => void;
199
121
  };
200
122
  export type BlockAttributionApi = ReturnType<typeof bindBlockAttribution>;
@@ -1,22 +1,6 @@
1
1
  import { REGISTRY_KEY } from '../placement/model.js';
2
2
  import { BLOCK_ATTR_ROOT, isNodeLike, LAST_CHANGED_ATTR, NONCE, REC_PREFIX } from '../schema.js';
3
- import { attrItems, newNode as makeNode, onTransaction } from '../structs.js';
4
- /**
5
- * The ring's retention bound — the deepest `lineage.depth` any surviving
6
- * entry's writer was configured with. `POSITIVE_INFINITY` when ANY entry
7
- * lacks `d` (pre-watermark data): without knowing every writer's bound,
8
- * no entry may be evicted on their behalf.
9
- */
10
- export const lineageWatermarkOf = (entries) => {
11
- let wm = 0;
12
- for (const e of entries) {
13
- if (typeof e.d !== 'number' || !Number.isFinite(e.d))
14
- return Number.POSITIVE_INFINITY;
15
- if (e.d > wm)
16
- wm = e.d;
17
- }
18
- return wm;
19
- };
3
+ import { attrItems, newNode as makeNode } from '../structs.js';
20
4
  // `BLOCK_ATTR_ROOT`/`LAST_CHANGED_ATTR`/`REC_PREFIX` live in the shared
21
5
  // `../schema.js` leaf — re-exported so existing import sites stay.
22
6
  export { BLOCK_ATTR_ROOT, LAST_CHANGED_ATTR };
@@ -82,15 +66,6 @@ export const blockAttributionOf = (doc, id) => {
82
66
  lastChangedBy: typeof l === 'string' ? l : undefined
83
67
  };
84
68
  };
85
- /**
86
- * Read one block's lineage ring, oldest → newest — or `undefined` when
87
- * the block carries no record. Entries are the stored content values;
88
- * callers deep-copy before exposing them publicly.
89
- */
90
- export const lineageOf = (doc, id) => {
91
- const rec = recordOf(doc, id);
92
- return rec === null ? undefined : rec.toArray();
93
- };
94
69
  /**
95
70
  * Bound write helpers. `stampChange`/`stampCreated`/`unionContributors`
96
71
  * must be called INSIDE the operation's `doc.transact` — they perform
@@ -205,124 +180,6 @@ export const bindBlockAttribution = (Y) => {
205
180
  const into = ensureRecord(doc, intoId, blockNodeOf(doc, intoId));
206
181
  for (const a of contributorsOfRecord(from))
207
182
  addContributor(into, a);
208
- },
209
- /**
210
- * Append a displaced-state checkpoint to the block's ring and trim
211
- * to the ring's watermark — `max` of surviving entries' `d`,
212
- * including the fresh one. The caller captures `entry.j` BEFORE its
213
- * model write (see `lineagePending` in `edytor-doc.ts`) and calls
214
- * this only after the write proves out, so a refused write appends
215
- * nothing. The watermark is THE retention policy — identical on
216
- * append, on receive (`attachRingTrim`), and on read — so a shallow
217
- * replica never evicts a deeper writer's surviving history, and the
218
- * bound shrinks only once the deepest entries have themselves
219
- * aged out. Concurrent appends under partition can still merge a
220
- * ring past the watermark — neither side saw the other's entry —
221
- * which the receive-side repair converges back.
222
- */
223
- appendLineage: (doc, id, entry, depth) => {
224
- const rec = ensureRecord(doc, id);
225
- rec.insert(rec.length, [{ ...entry, s: rec.length, d: depth }]);
226
- const wm = lineageWatermarkOf(rec.toArray());
227
- if (rec.length > wm)
228
- rec.delete(0, rec.length - wm);
229
- },
230
- /**
231
- * The block's lineage ring, oldest → newest — or `undefined` when
232
- * the block has no record at all. Entries are the stored content
233
- * values; the public surface copies them before handing them out.
234
- */
235
- lineageOf,
236
- /**
237
- * Attach the doc's shared ring-watermark repair — once per doc for
238
- * the doc's lifetime (module-level dedupe). See the module-level comment
239
- * below.
240
- */
241
- attachRingTrim: (doc) => {
242
- if (ringTrimAttached.has(doc))
243
- return;
244
- ringTrimAttached.set(doc, true);
245
- const trimToWatermark = (rec) => {
246
- const wm = lineageWatermarkOf(rec.toArray());
247
- if (rec.length > wm)
248
- rec.delete(0, rec.length - wm);
249
- };
250
- onTransaction(doc, 'afterTransaction', (transaction) => {
251
- try {
252
- const changed = transaction?.changed;
253
- if (changed === undefined)
254
- return;
255
- let over;
256
- for (const type of changed.keys()) {
257
- const rec = type;
258
- if (rec?.name === REC_NODE &&
259
- rec.length > lineageWatermarkOf(rec.toArray())) {
260
- (over ??= []).push(rec);
261
- }
262
- }
263
- if (over === undefined)
264
- return;
265
- // A follow-up transaction in the same cleanup sweep — the
266
- // trim deletes exactly the items the next append would
267
- // evict, so concurrent trims (each replica runs this on
268
- // the same merged state) delete the SAME items and stay
269
- // convergent. The watermark never goes below a surviving
270
- // entry's own configured depth.
271
- doc.transact(() => {
272
- for (const rec of over)
273
- trimToWatermark(rec);
274
- }, LINEAGE_TRIM_ORIGIN);
275
- }
276
- catch (err) {
277
- // A failure here must never propagate — throwing inside
278
- // `afterTransaction` would break the host transaction's
279
- // cleanup sweep. An untrimmed ring still converges.
280
- console.error('[edytor-doc] lineage ring trim failed; leaving over-cap state', err);
281
- }
282
- });
283
- // Install-time sweep: a doc that arrived over-cap BEFORE this
284
- // listener existed — `loadDocument`/`attachDocument` integrate
285
- // the payload before the facade composes — never fires the
286
- // hook above for that data. One O(records) pass converges it.
287
- try {
288
- const root = doc.get(BLOCK_ATTR_ROOT);
289
- let over;
290
- for (const key of root.attrKeys()) {
291
- if (!key.startsWith(REC_PREFIX))
292
- continue;
293
- const rec = root.getAttr(key);
294
- if (isNodeLike(rec) &&
295
- rec.name === REC_NODE &&
296
- rec.length > lineageWatermarkOf(rec.toArray())) {
297
- (over ??= []).push(rec);
298
- }
299
- }
300
- if (over !== undefined) {
301
- doc.transact(() => {
302
- for (const rec of over)
303
- trimToWatermark(rec);
304
- }, LINEAGE_TRIM_ORIGIN);
305
- }
306
- }
307
- catch (err) {
308
- console.error('[edytor-doc] lineage ring sweep failed; leaving over-cap state', err);
309
- }
310
183
  }
311
184
  };
312
185
  };
313
- /**
314
- * Per-doc attach table for the shared ring-trim listener — module level
315
- * (not binding- or facade-scoped) so the listener is installed ONCE per
316
- * doc across every binding's facade `create()`, and never detached: a
317
- * ring pushed over its watermark by concurrent appends is converged even
318
- * after the last facade disposes. The `WeakMap` entry and the doc-held
319
- * listener die with the doc — no leak.
320
- */
321
- const ringTrimAttached = new WeakMap();
322
- /**
323
- * Origin of the ring-trim's delete writes — an origin no UndoManager
324
- * tracks, so trims never enter an undo stack and never recurse (the trim
325
- * only deletes ring items: the follow-up `afterTransaction` pass finds
326
- * the ring at exactly the watermark and stops).
327
- */
328
- const LINEAGE_TRIM_ORIGIN = Symbol('edytor.lineage-trim');
@@ -21,15 +21,11 @@
21
21
  * Read rule: the leaves are read as a tree; a path with live items is an
22
22
  * array (sorted by rank, then id), one with keys an object (it beats a
23
23
  * primitive leaf at the same path: Ada sets `a = 1` while Bob sets
24
- * `a.b = 2`), else its leaf. The legacy whole `data` attr (documents
25
- * written before 0.1.0-next.6) is a base each leaf shadows at, above and
26
- * under its path; an array leaf with values (next.6's atomic arrays, and
27
- * every array of the attr) reads as items with ids and ranks derived from
28
- * the array (as any array assigned where no item is), so two replicas
29
- * exploding it write the same items. A patch
30
- * writes its leaves over the attr while it still reads right, else deletes
31
- * it and writes every leaf (residual: a peer's concurrent set of a key it
32
- * held, or its removal of an item, may then lose to the exploded value).
24
+ * `a.b = 2`), else its leaf. A leaf holding an object or an array (an
25
+ * atomic path's, `data.atomic`, or an array 0.1.0-next.6 wrote) reads as
26
+ * its keys or as items with ids and ranks derived from the array (as any
27
+ * array assigned where no item is), so two replicas writing into it write
28
+ * the same items; a patch opens it only along its path.
33
29
  */
34
30
  import type { EngineNode } from './engine-api.js';
35
31
  type JsonObj = Record<string, unknown>;
@@ -83,10 +79,9 @@ export declare const applyPatch: (data: JsonObj, patches: readonly DataPatch[])
83
79
  * The attr writes that give `node` the data `patches` make of its own (new
84
80
  * items get ids from `rand`, ranks from `client`), or `null` when a patch
85
81
  * fits no value there: only the leaves of the keys and items a patch
86
- * touches change, so a concurrent edit of another key or item is kept. A
87
- * legacy base (the attr, an atomic array leaf) stays under the leaves while
88
- * they still read as the patched value, else it is exploded: every leaf
89
- * written, the attr deleted. An unchanged value writes nothing.
82
+ * touches change, so a concurrent edit of another key or item is kept. An
83
+ * atomic path is written as one leaf and the leaves under it are deleted.
84
+ * An unchanged value writes nothing.
90
85
  */
91
86
  export declare const patchWrites: (node: EngineNode, patches: readonly DataPatch[], client?: number, rand?: () => number, atomic?: readonly string[]) => LeafWrite[] | null;
92
87
  /** Write `writes` on `node` (a detached one too: a block or atom being created). */