@aionbuilders/nabu 0.1.0-beta.0 → 0.1.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 (306) hide show
  1. package/CHANGELOG.md +523 -0
  2. package/LICENSE +21 -0
  3. package/README.md +72 -341
  4. package/dist/behaviors/text/RichText.svelte +24 -4
  5. package/dist/behaviors/text/markdown-shortcuts.extension.d.ts +3 -0
  6. package/dist/behaviors/text/markdown-shortcuts.extension.js +35 -10
  7. package/dist/behaviors/text/markdown-syntax.d.ts +42 -0
  8. package/dist/behaviors/text/markdown-syntax.js +81 -0
  9. package/dist/behaviors/text/rich-text.extension.d.ts +3 -0
  10. package/dist/behaviors/text/rich-text.extension.js +95 -38
  11. package/dist/behaviors/text/text.behavior.svelte.d.ts +199 -48
  12. package/dist/behaviors/text/text.behavior.svelte.js +549 -83
  13. package/dist/behaviors/text/typography.extension.d.ts +2 -1
  14. package/dist/behaviors/text/typography.extension.js +3 -2
  15. package/dist/blocks/BlockList.svelte +48 -0
  16. package/dist/blocks/BlockList.svelte.d.ts +17 -0
  17. package/dist/blocks/Nabu.svelte +169 -25
  18. package/dist/blocks/Nabu.svelte.d.ts +13 -0
  19. package/dist/blocks/block.extension.d.ts +3 -0
  20. package/dist/blocks/block.extension.js +4 -7
  21. package/dist/blocks/block.svelte.d.ts +350 -86
  22. package/dist/blocks/block.svelte.js +370 -59
  23. package/dist/blocks/blockquote/Blockquote.svelte +1 -2
  24. package/dist/blocks/blockquote/blockquote.extension.d.ts +4 -1
  25. package/dist/blocks/blockquote/blockquote.extension.js +14 -5
  26. package/dist/blocks/blockquote/blockquote.svelte.d.ts +19 -11
  27. package/dist/blocks/blockquote/blockquote.svelte.js +58 -13
  28. package/dist/blocks/callout/Callout.svelte +6 -8
  29. package/dist/blocks/callout/callout.extension.d.ts +4 -1
  30. package/dist/blocks/callout/callout.extension.js +19 -3
  31. package/dist/blocks/callout/callout.svelte.d.ts +5 -3
  32. package/dist/blocks/callout/callout.svelte.js +11 -6
  33. package/dist/blocks/chunks.d.ts +49 -0
  34. package/dist/blocks/chunks.js +90 -0
  35. package/dist/blocks/code/Code.svelte +7 -8
  36. package/dist/blocks/code/code.extension.d.ts +4 -1
  37. package/dist/blocks/code/code.extension.js +22 -2
  38. package/dist/blocks/code/code.svelte.d.ts +9 -2
  39. package/dist/blocks/code/code.svelte.js +49 -25
  40. package/dist/blocks/container.utils.d.ts +85 -13
  41. package/dist/blocks/container.utils.js +338 -178
  42. package/dist/blocks/dialogue/Dialogue.svelte +8 -4
  43. package/dist/blocks/dialogue/dialogue.svelte.d.ts +33 -2
  44. package/dist/blocks/dialogue/dialogue.svelte.js +58 -4
  45. package/dist/blocks/dialogue/hooks/onBeforeInput.hook.d.ts +2 -2
  46. package/dist/blocks/dialogue/hooks/onBeforeInput.hook.js +6 -4
  47. package/dist/blocks/dialogue/index.d.ts +12 -1
  48. package/dist/blocks/dialogue/index.js +51 -35
  49. package/dist/blocks/divider/divider.extension.d.ts +23 -1
  50. package/dist/blocks/divider/divider.extension.js +85 -19
  51. package/dist/blocks/divider/divider.svelte.d.ts +7 -2
  52. package/dist/blocks/divider/divider.svelte.js +9 -4
  53. package/dist/blocks/file/File.svelte +13 -6
  54. package/dist/blocks/file/file.extension.d.ts +4 -1
  55. package/dist/blocks/file/file.extension.js +9 -1
  56. package/dist/blocks/file/file.svelte.d.ts +3 -3
  57. package/dist/blocks/file/file.svelte.js +20 -14
  58. package/dist/blocks/heading/Heading.svelte +1 -2
  59. package/dist/blocks/heading/heading.svelte.d.ts +23 -11
  60. package/dist/blocks/heading/heading.svelte.js +68 -13
  61. package/dist/blocks/heading/hooks/onBeforeInput.hook.js +7 -5
  62. package/dist/blocks/heading/index.d.ts +2 -2
  63. package/dist/blocks/heading/index.js +33 -8
  64. package/dist/blocks/image/Image.svelte +5 -2
  65. package/dist/blocks/image/image.extension.d.ts +4 -1
  66. package/dist/blocks/image/image.extension.js +9 -1
  67. package/dist/blocks/image/image.svelte.d.ts +17 -6
  68. package/dist/blocks/image/image.svelte.js +33 -11
  69. package/dist/blocks/index.d.ts +1 -1
  70. package/dist/blocks/index.js +1 -1
  71. package/dist/blocks/list/List.svelte +1 -0
  72. package/dist/blocks/list/ListItem.svelte +1 -0
  73. package/dist/blocks/list/convert.d.ts +20 -0
  74. package/dist/blocks/list/convert.js +92 -0
  75. package/dist/blocks/list/hooks/onBeforeInput.hook.js +49 -28
  76. package/dist/blocks/list/html-flat.d.ts +78 -0
  77. package/dist/blocks/list/html-flat.js +244 -0
  78. package/dist/blocks/list/indent.d.ts +86 -0
  79. package/dist/blocks/list/indent.js +205 -0
  80. package/dist/blocks/list/index.d.ts +6 -3
  81. package/dist/blocks/list/index.js +42 -31
  82. package/dist/blocks/list/list-item.svelte.d.ts +31 -17
  83. package/dist/blocks/list/list-item.svelte.js +99 -100
  84. package/dist/blocks/list/list.behavior.svelte.d.ts +4 -1
  85. package/dist/blocks/list/list.behavior.svelte.js +6 -1
  86. package/dist/blocks/list/list.svelte.d.ts +89 -18
  87. package/dist/blocks/list/list.svelte.js +129 -125
  88. package/dist/blocks/list/markdown.d.ts +149 -0
  89. package/dist/blocks/list/markdown.js +442 -0
  90. package/dist/blocks/list/normalize.d.ts +11 -0
  91. package/dist/blocks/list/normalize.js +396 -0
  92. package/dist/blocks/list/paste.d.ts +45 -0
  93. package/dist/blocks/list/paste.js +242 -0
  94. package/dist/blocks/list/step-back.d.ts +24 -0
  95. package/dist/blocks/list/step-back.js +87 -0
  96. package/dist/blocks/list/to-list.d.ts +7 -0
  97. package/dist/blocks/list/to-list.js +44 -0
  98. package/dist/blocks/list/todos-toggle.d.ts +20 -0
  99. package/dist/blocks/list/todos-toggle.js +48 -0
  100. package/dist/blocks/media/markdown.d.ts +12 -0
  101. package/dist/blocks/media/markdown.js +26 -0
  102. package/dist/blocks/media/media-block.svelte.d.ts +77 -2
  103. package/dist/blocks/media/media-block.svelte.js +124 -12
  104. package/dist/blocks/media/media.helpers.d.ts +6 -1
  105. package/dist/blocks/media/media.helpers.js +43 -6
  106. package/dist/blocks/megablock.svelte.d.ts +50 -19
  107. package/dist/blocks/megablock.svelte.js +114 -74
  108. package/dist/blocks/move.d.ts +23 -0
  109. package/dist/blocks/move.js +92 -0
  110. package/dist/blocks/nabu.svelte.d.ts +764 -71
  111. package/dist/blocks/nabu.svelte.js +1746 -189
  112. package/dist/blocks/paragraph/Paragraph.svelte +1 -2
  113. package/dist/blocks/paragraph/index.d.ts +2 -2
  114. package/dist/blocks/paragraph/index.js +35 -13
  115. package/dist/blocks/paragraph/paragraph.svelte.d.ts +46 -14
  116. package/dist/blocks/paragraph/paragraph.svelte.js +77 -16
  117. package/dist/blocks/paragraph/table.html.d.ts +9 -0
  118. package/dist/blocks/paragraph/table.html.js +111 -0
  119. package/dist/blocks/paragraph/table.markdown.d.ts +32 -0
  120. package/dist/blocks/paragraph/table.markdown.js +90 -0
  121. package/dist/blocks/region/Region.svelte +264 -0
  122. package/dist/blocks/region/Region.svelte.d.ts +11 -0
  123. package/dist/blocks/region/actions.d.ts +135 -0
  124. package/dist/blocks/region/actions.js +402 -0
  125. package/dist/blocks/region/close.d.ts +35 -0
  126. package/dist/blocks/region/close.js +130 -0
  127. package/dist/blocks/region/commands.d.ts +6 -0
  128. package/dist/blocks/region/commands.js +277 -0
  129. package/dist/blocks/region/create.d.ts +72 -0
  130. package/dist/blocks/region/create.js +208 -0
  131. package/dist/blocks/region/end-marker.d.ts +35 -0
  132. package/dist/blocks/region/end-marker.js +51 -0
  133. package/dist/blocks/region/facts.d.ts +69 -0
  134. package/dist/blocks/region/facts.js +152 -0
  135. package/dist/blocks/region/format.d.ts +91 -0
  136. package/dist/blocks/region/format.js +260 -0
  137. package/dist/blocks/region/index.d.ts +14 -0
  138. package/dist/blocks/region/index.js +14 -0
  139. package/dist/blocks/region/insert.d.ts +59 -0
  140. package/dist/blocks/region/insert.js +102 -0
  141. package/dist/blocks/region/messages.d.ts +254 -0
  142. package/dist/blocks/region/messages.js +131 -0
  143. package/dist/blocks/region/normalize.d.ts +7 -0
  144. package/dist/blocks/region/normalize.js +170 -0
  145. package/dist/blocks/region/region.extension.d.ts +58 -0
  146. package/dist/blocks/region/region.extension.js +119 -0
  147. package/dist/blocks/region/region.svelte.d.ts +221 -0
  148. package/dist/blocks/region/region.svelte.js +582 -0
  149. package/dist/blocks/region/regions.svelte.d.ts +141 -0
  150. package/dist/blocks/region/regions.svelte.js +276 -0
  151. package/dist/blocks/region/serialize.d.ts +57 -0
  152. package/dist/blocks/region/serialize.js +112 -0
  153. package/dist/blocks/region/types.d.ts +255 -0
  154. package/dist/blocks/region/types.js +204 -0
  155. package/dist/blocks/selection.svelte.d.ts +106 -8
  156. package/dist/blocks/selection.svelte.js +622 -74
  157. package/dist/blocks/subthread.d.ts +80 -0
  158. package/dist/blocks/subthread.js +167 -0
  159. package/dist/blocks/text-block.svelte.d.ts +34 -13
  160. package/dist/blocks/text-block.svelte.js +42 -8
  161. package/dist/blocks/toggle/Toggle.svelte +4 -15
  162. package/dist/blocks/toggle/markdown.d.ts +20 -0
  163. package/dist/blocks/toggle/markdown.js +112 -0
  164. package/dist/blocks/toggle/toggle.extension.d.ts +4 -1
  165. package/dist/blocks/toggle/toggle.extension.js +6 -0
  166. package/dist/blocks/toggle/toggle.svelte.d.ts +54 -7
  167. package/dist/blocks/toggle/toggle.svelte.js +134 -34
  168. package/dist/blocks/undo-selection.d.ts +175 -0
  169. package/dist/blocks/undo-selection.js +360 -0
  170. package/dist/blocks/video/Video.svelte +5 -2
  171. package/dist/blocks/video/video.extension.d.ts +4 -1
  172. package/dist/blocks/video/video.extension.js +9 -1
  173. package/dist/blocks/video/video.svelte.d.ts +6 -5
  174. package/dist/blocks/video/video.svelte.js +18 -9
  175. package/dist/extend.d.ts +55 -0
  176. package/dist/extend.js +88 -0
  177. package/dist/files/assets.clipboard.d.ts +77 -0
  178. package/dist/files/assets.clipboard.js +152 -0
  179. package/dist/files/files.svelte.d.ts +321 -19
  180. package/dist/files/files.svelte.js +847 -43
  181. package/dist/files/index.d.ts +3 -1
  182. package/dist/files/index.js +3 -1
  183. package/dist/files/outbox.d.ts +69 -0
  184. package/dist/files/outbox.js +48 -0
  185. package/dist/files/status.d.ts +65 -0
  186. package/dist/files/status.js +87 -0
  187. package/dist/files/store.d.ts +97 -0
  188. package/dist/files/store.js +65 -0
  189. package/dist/files/uploads.svelte.d.ts +174 -0
  190. package/dist/files/uploads.svelte.js +504 -0
  191. package/dist/index.d.ts +68 -9
  192. package/dist/index.js +117 -10
  193. package/dist/nabu-theme.css +21 -1
  194. package/dist/paste/html.paste.d.ts +74 -3
  195. package/dist/paste/html.paste.js +550 -86
  196. package/dist/paste/markdown-inline.d.ts +86 -0
  197. package/dist/paste/markdown-inline.js +528 -0
  198. package/dist/paste/markdown.paste.d.ts +2 -8
  199. package/dist/paste/markdown.paste.js +78 -94
  200. package/dist/paste/nabu.paste.d.ts +3 -0
  201. package/dist/paste/nabu.paste.js +29 -3
  202. package/dist/paste/plain-text.paste.d.ts +2 -2
  203. package/dist/paste/plain-text.paste.js +3 -3
  204. package/dist/persistence/asset-store.d.ts +51 -0
  205. package/dist/persistence/asset-store.js +103 -0
  206. package/dist/persistence/autosave.d.ts +53 -0
  207. package/dist/persistence/autosave.js +62 -0
  208. package/dist/persistence/compact.d.ts +162 -0
  209. package/dist/persistence/compact.js +141 -0
  210. package/dist/persistence/history.d.ts +77 -0
  211. package/dist/persistence/history.js +176 -0
  212. package/dist/persistence/indexeddb.d.ts +190 -4
  213. package/dist/persistence/indexeddb.js +333 -29
  214. package/dist/persistence/merge.d.ts +38 -0
  215. package/dist/persistence/merge.js +36 -0
  216. package/dist/persistence/outbox.d.ts +25 -0
  217. package/dist/persistence/outbox.js +40 -0
  218. package/dist/persistence/persistence.d.ts +70 -9
  219. package/dist/persistence/persistence.js +507 -35
  220. package/dist/persistence/recovery.d.ts +79 -0
  221. package/dist/persistence/recovery.js +79 -0
  222. package/dist/persistence/release.d.ts +34 -0
  223. package/dist/persistence/release.js +64 -0
  224. package/dist/persistence/state.svelte.d.ts +53 -0
  225. package/dist/persistence/state.svelte.js +48 -0
  226. package/dist/persistence/sync.d.ts +39 -0
  227. package/dist/persistence/sync.js +138 -0
  228. package/dist/persistence/tail.d.ts +42 -0
  229. package/dist/persistence/tail.js +103 -0
  230. package/dist/presets.d.ts +29 -26
  231. package/dist/presets.js +35 -13
  232. package/dist/themes/atelier.css +318 -0
  233. package/dist/ui/CommandChooser.svelte +153 -0
  234. package/dist/ui/CommandChooser.svelte.d.ts +13 -0
  235. package/dist/ui/CommandInvite.svelte +99 -0
  236. package/dist/ui/CommandInvite.svelte.d.ts +12 -0
  237. package/dist/ui/DragHandle.svelte +97 -21
  238. package/dist/ui/FloatingToolbar.svelte +75 -27
  239. package/dist/ui/FloatingToolbar.svelte.d.ts +10 -0
  240. package/dist/ui/SlashMenu.svelte +147 -15
  241. package/dist/ui/SlashMenu.svelte.d.ts +20 -0
  242. package/dist/ui/anchor.d.ts +112 -0
  243. package/dist/ui/anchor.js +136 -0
  244. package/dist/ui/index.d.ts +7 -1
  245. package/dist/ui/index.js +12 -1
  246. package/dist/ui/slash-menu.svelte.d.ts +79 -7
  247. package/dist/ui/slash-menu.svelte.js +85 -51
  248. package/dist/utils/command-confirm.svelte.d.ts +349 -0
  249. package/dist/utils/command-confirm.svelte.js +673 -0
  250. package/dist/utils/commands.d.ts +328 -0
  251. package/dist/utils/commands.js +416 -0
  252. package/dist/utils/dom-scope.d.ts +14 -0
  253. package/dist/utils/dom-scope.js +20 -0
  254. package/dist/utils/drop.d.ts +160 -0
  255. package/dist/utils/drop.js +305 -0
  256. package/dist/utils/extensions.d.ts +439 -45
  257. package/dist/utils/extensions.js +271 -29
  258. package/dist/utils/html.d.ts +44 -0
  259. package/dist/utils/html.js +183 -0
  260. package/dist/utils/index.d.ts +3 -0
  261. package/dist/utils/index.js +3 -0
  262. package/dist/utils/keys.d.ts +120 -0
  263. package/dist/utils/keys.js +248 -0
  264. package/dist/utils/links.d.ts +22 -0
  265. package/dist/utils/links.js +34 -0
  266. package/dist/utils/placeholders.d.ts +81 -3
  267. package/dist/utils/placeholders.js +73 -3
  268. package/dist/utils/selection.svelte.d.ts +47 -19
  269. package/dist/utils/selection.svelte.js +60 -10
  270. package/dist/utils/spellcheck.d.ts +9 -0
  271. package/dist/utils/spellcheck.js +17 -0
  272. package/dist/utils/tab.d.ts +31 -0
  273. package/dist/utils/tab.js +117 -0
  274. package/dist/utils/words.d.ts +7 -0
  275. package/dist/utils/words.js +62 -0
  276. package/dist/vite.d.ts +9 -3
  277. package/dist/vite.js +19 -8
  278. package/package.json +54 -20
  279. package/dist/blocks/variable.svelte.d.ts +0 -47
  280. package/dist/blocks/variable.svelte.js +0 -51
  281. package/dist/blocks/zone/TemplateEditor.svelte +0 -308
  282. package/dist/blocks/zone/TemplateEditor.svelte.d.ts +0 -11
  283. package/dist/blocks/zone/Zone.svelte +0 -272
  284. package/dist/blocks/zone/Zone.svelte.d.ts +0 -11
  285. package/dist/blocks/zone/ZoneEditor.svelte +0 -289
  286. package/dist/blocks/zone/ZoneEditor.svelte.d.ts +0 -11
  287. package/dist/blocks/zone/ZoneTemplatesList.svelte +0 -188
  288. package/dist/blocks/zone/ZoneTemplatesList.svelte.d.ts +0 -11
  289. package/dist/blocks/zone/hooks/onBeforeInput.hook.d.ts +0 -3
  290. package/dist/blocks/zone/hooks/onBeforeInput.hook.js +0 -30
  291. package/dist/blocks/zone/index.d.ts +0 -2
  292. package/dist/blocks/zone/index.js +0 -2
  293. package/dist/blocks/zone/zone.extension.d.ts +0 -2
  294. package/dist/blocks/zone/zone.extension.js +0 -237
  295. package/dist/blocks/zone/zone.svelte.d.ts +0 -221
  296. package/dist/blocks/zone/zone.svelte.js +0 -608
  297. package/dist/overlays/context/Context.svelte +0 -182
  298. package/dist/overlays/context/Context.svelte.d.ts +0 -17
  299. package/dist/overlays/context/collect.d.ts +0 -17
  300. package/dist/overlays/context/collect.js +0 -33
  301. package/dist/overlays/context/context.extension.d.ts +0 -2
  302. package/dist/overlays/context/context.extension.js +0 -8
  303. package/dist/overlays/context/context.svelte.d.ts +0 -82
  304. package/dist/overlays/context/context.svelte.js +0 -159
  305. package/dist/overlays/context/index.d.ts +0 -3
  306. package/dist/overlays/context/index.js +0 -3
@@ -7,34 +7,66 @@
7
7
  export function deltaToHtml(delta: import("loro-crdt").Delta<string>[]): string;
8
8
  /**
9
9
  * Converts a Loro text delta to inline Markdown.
10
+ * A line break (`\n` in the text) is exported as a markdown hard break (backslash + newline), unless `rawBreaks`
11
+ * (a block that re-reads its own lines, like a callout body, keeps the plain newline).
10
12
  * @param {import('loro-crdt').Delta<string>[]} delta
13
+ * @param {{ rawBreaks?: boolean }} [options]
11
14
  * @returns {string}
12
15
  */
13
- export function deltaToMarkdown(delta: import("loro-crdt").Delta<string>[]): string;
16
+ export function deltaToMarkdown(delta: import("loro-crdt").Delta<string>[], { rawBreaks }?: {
17
+ rawBreaks?: boolean;
18
+ }): string;
19
+ /** A link destination: raw when plain, `<…>` when it holds whitespace, angle brackets or unbalanced parentheses. */
20
+ export function markdownDestination(href: string): string;
14
21
  /**
15
- * @typedef {NabuNode<{type: "paragraph", text: LoroText}>} TextNode
16
- */
22
+ * Length (UTF-16 units) of the user-perceived character starting at `index` — the unit one Delete press removes.
23
+ * `Intl.Segmenter` handles ZWJ sequences, flags and combining marks; without it a surrogate pair is kept whole.
24
+ * A caret inside a cluster deletes up to the end of that cluster. 0 at the end of the text.
25
+ * @param {string} text @param {number} index
26
+ */
27
+ export function nextGraphemeLength(text: string, index: number): number;
28
+ /**
29
+ * Length (UTF-16 units) of the user-perceived character ENDING at `index` — the unit one Backspace press removes.
30
+ * Mirror of {@link nextGraphemeLength}: `Intl.Segmenter` handles ZWJ sequences, flags and combining marks; without it a
31
+ * surrogate pair is kept whole. A caret inside a cluster deletes back to the start of that cluster. 0 at the start.
32
+ * @param {string} text @param {number} index
33
+ */
34
+ export function prevGraphemeLength(text: string, index: number): number;
35
+ /**
36
+ * The editing of a block's rich text: wraps a Loro text and offers the reactive `text` and `delta`, the selection in that text, and insertion, deletion, splitting, marks and links. Text blocks use it through `TextBlock`; a container with a header (list item, toggle) owns one.
37
+ */
17
38
  export class TextBehavior {
18
39
  /** @param {Block} block @param {LoroText} [container] */
19
40
  constructor(block: Block, container?: LoroText);
20
- block: Block;
21
- nabu: import("../..").Nabu;
22
- /** @type {LoroText} */
23
- container: LoroText;
24
- text: string;
25
- delta: import("loro-crdt").Delta<string>[];
26
- selection: {
41
+ /** @public */
42
+ public block: Block;
43
+ nabu: import("../../blocks").Nabu;
44
+ /**
45
+ * @type {LoroText}
46
+ * @public
47
+ */
48
+ public container: LoroText;
49
+ /** @public */
50
+ public text: string;
51
+ /** @public */
52
+ public delta: import("loro-crdt").Delta<string>[];
53
+ /** @public */
54
+ public selection: {
27
55
  from: number;
28
56
  to: number;
29
57
  isCollapsed: boolean;
30
58
  direction: "forward" | "backward" | "none";
31
59
  } | null;
32
- positions: number;
60
+ /** @public */
61
+ public positions: number;
33
62
  /**
34
- * Number of whitespace-separated words in this text.
63
+ * Number of words in this text: segmented with `Intl.Segmenter` in the language of the editor (`nabu.lang`) when the platform
64
+ * has it, so Chinese or Japanese text counts its words rather than one per sentence; whitespace-separated otherwise. See
65
+ * `utils/words.js`. Reactive in the text and in `nabu.lang`.
35
66
  * @returns {number}
67
+ * @public
36
68
  */
37
- get wordCount(): number;
69
+ public get wordCount(): number;
38
70
  /**
39
71
  * @param {HTMLElement} element
40
72
  * @param {NabuSelection} globalSelection
@@ -52,89 +84,208 @@ export class TextBehavior {
52
84
  * @param {HTMLElement?} [element]
53
85
  */
54
86
  calculateOffset(node: Node, offset: number, element?: HTMLElement | null): number;
55
- /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [selection] */
56
- handleBeforeInput(event: InputEvent, selection?: ReturnType<TextBehavior["getSelection"]>): any;
87
+ /**
88
+ * {@link TextBehavior#calculateOffset} bounded by the MODEL text: an empty text renders a lone "\n" placeholder, and a caret
89
+ * after it is still offset 0, not 1 (P-108). (Not during an IME composition: the browser's text is ahead of the model then.)
90
+ * @param {Node} node @param {number} offset @param {HTMLElement?} [element]
91
+ */
92
+ modelOffset(node: Node, offset: number, element?: HTMLElement | null): number;
93
+ /**
94
+ * IME composition starts. With a trailing render filler (`<br data-nabu-filler>`, the empty last line after a "\n")
95
+ * the browser puts the composed text in a NEW text node before the filler (and may swap the filler for a `<br>` of
96
+ * its own) — nodes Svelte does not know, which would stay next to the ones it updates once the model catches up
97
+ * (text shown twice). Remember Svelte's nodes so {@link TextBehavior#restoreAfterComposition} can undo the browser's
98
+ * additions at the end. No filler: nothing to do.
99
+ */
100
+ snapshotForComposition(): void;
101
+ /**
102
+ * End of a composition begun next to a filler, BEFORE the composed text reaches the model: remove the text nodes and
103
+ * `<br>` the browser created meanwhile (the composed text is committed to the model, which the next render shows
104
+ * through Svelte's own nodes); a canceled composition (`composedText` empty) gets its filler back.
105
+ * @param {string} composedText
106
+ */
107
+ restoreAfterComposition(composedText: string): void;
108
+ /**
109
+ * @param {InputEvent} event
110
+ * @param {ReturnType<TextBehavior["getSelection"]>} [selection]
111
+ * @public
112
+ */
113
+ public handleBeforeInput(event: InputEvent, selection?: ReturnType<TextBehavior["getSelection"]>): any;
57
114
  /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [selection] */
58
115
  handleInsertText(event: InputEvent, selection?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
59
116
  /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel] */
60
117
  handleInsertLineBreak(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): void;
61
118
  /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel] */
62
- handleDeleteContentBackward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): void;
119
+ handleDeleteContentBackward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
63
120
  /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel] */
64
- handleDeleteContentForward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): void;
121
+ handleDeleteContentForward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
65
122
  /**
66
123
  * Deletes the word before the cursor (Ctrl+Backspace on Win/Linux,
67
124
  * Option+Delete on Mac), including the whitespace that precedes it
68
125
  * so no orphan space is left behind (issue #4).
126
+ *
127
+ * For a collapsed selection the range is always computed from the model
128
+ * text, never from `event.getTargetRanges()`: browsers disagree on it
129
+ * (Chromium stops right after the previous space, leaving "one two " from
130
+ * "one two three"), so the behavior would differ per engine.
131
+ * Rule: remove `\s* \S+ \s*` ending at the cursor ("one two three|" -> "one two").
69
132
  * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
70
133
  */
71
134
  handleDeleteWordBackward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
72
135
  /**
73
- * Deletes the word after the cursor (Ctrl+Delete / Option+Fn+Delete),
74
- * including its trailing whitespace/punctuation.
136
+ * Deletes the word after the cursor (Ctrl+Delete / Option+Fn+Delete).
137
+ *
138
+ * Like backward deletion, a collapsed selection is resolved from the model
139
+ * text only (`getTargetRanges()` is ignored: it is engine-dependent).
140
+ * Rule, so that the result never has a double space nor glued words:
141
+ * - the cursor is right before the word ("one |two three") -> remove the
142
+ * word and its trailing whitespace -> "one three";
143
+ * - whitespace sits between the cursor and the word ("one| two three")
144
+ * -> remove that leading whitespace and the word, keep the trailing
145
+ * whitespace -> "one three";
146
+ * - last word of the text -> remove it with its leading whitespace
147
+ * ("one two| three" -> "one two").
148
+ * If only whitespace remains after the cursor, it is all removed.
75
149
  * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
76
150
  */
77
151
  handleDeleteWordForward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
78
152
  /**
79
- * Deletes from the start of the current soft line to the cursor
80
- * (Cmd+Backspace on Mac).
153
+ * Deletes from the start of the current line to the cursor (Cmd+Backspace on Mac; `deleteHardLineBackward`).
154
+ * A selection inside the block is deleted whole.
155
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
156
+ */
157
+ handleDeleteSoftLineBackward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean | undefined;
158
+ /**
159
+ * Deletes from the cursor to the end of the current line (Cmd+Fn+Delete, Ctrl+K style; `deleteHardLineForward`).
160
+ * At the end of a line (before a "\n") or of the block nothing is deleted. A selection is deleted whole.
161
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
162
+ */
163
+ handleDeleteSoftLineForward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean | undefined;
164
+ /**
165
+ * Deletes the whole line(s) touched by the selection (`deleteEntireSoftLine`): the text between the surrounding "\n"
166
+ * (or block edges), the line breaks themselves are kept. Caret at the start of the emptied line.
167
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
168
+ */
169
+ handleDeleteEntireLine(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean | undefined;
170
+ /**
171
+ * `deleteContent`: delete the selection (no direction). A collapsed caret deletes nothing.
81
172
  * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
82
173
  */
83
- handleDeleteSoftLineBackward(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
174
+ handleDeleteContent(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean | undefined;
175
+ /**
176
+ * `insertReplacementText`: a spellcheck / autocorrect replacement. The replacement text comes in
177
+ * `dataTransfer` (`text/plain`) or `data`; the range to replace in `getTargetRanges()` (mapped to model offsets), else
178
+ * the selection. The replaced run's marks are kept on the new text. One edit (one undo step), caret after it.
179
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
180
+ */
181
+ handleInsertReplacementText(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean;
182
+ /**
183
+ * `insertFromYank` (Emacs-style yank on macOS): the text is inserted as plain text at the caret, replacing the selection.
184
+ * No input rule runs (it is a paste, not typing).
185
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
186
+ */
187
+ handleInsertFromYank(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): true | undefined;
188
+ /**
189
+ * `insertTranspose` (macOS Ctrl+T): swaps the two graphemes around the caret; at the end of the text, the last two.
190
+ * Marks travel with their character. No-op with a selection, at the start, with a single character or across a line break.
191
+ * @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel]
192
+ */
193
+ handleInsertTranspose(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): boolean;
84
194
  /** @param {InputEvent} event @param {ReturnType<TextBehavior["getSelection"]>} [sel] */
85
195
  handleInsertParagraph(event: InputEvent, sel?: ReturnType<TextBehavior["getSelection"]>): any;
86
196
  /**
87
197
  * Retrouve le nœud texte et l'offset DOM pour un offset Modèle donné
88
198
  * @param {number} targetOffset
89
199
  * @param {HTMLElement?} [element]
200
+ * @public
90
201
  */
91
- getDOMPoint(targetOffset: number, element?: HTMLElement | null): {
202
+ public getDOMPoint(targetOffset: number, element?: HTMLElement | null): {
92
203
  node: Node;
93
204
  offset: number;
94
205
  } | null;
95
- /** @param {number} index @param {string} text */
96
- insert(index: number, text: string): void;
97
- /** @param {Parameters<Block["delete"]>[0]} [deletion] @param {ReturnType<TextBehavior["getSelection"]>} [selection] */
98
- delete(deletion?: Parameters<Block["delete"]>[0], selection?: ReturnType<TextBehavior["getSelection"]>): void;
99
- /** @param {import('loro-crdt').Delta<string>[]} data */
100
- applyDelta(data?: import("loro-crdt").Delta<string>[]): void;
206
+ /**
207
+ * @param {number} index
208
+ * @param {string} text
209
+ * @public
210
+ */
211
+ public insert(index: number, text: string): void;
212
+ /**
213
+ * @param {Parameters<Block["delete"]>[0]} [deletion]
214
+ * @param {ReturnType<TextBehavior["getSelection"]>} [selection]
215
+ * @public
216
+ */
217
+ public delete(deletion?: Parameters<Block["delete"]>[0], selection?: ReturnType<TextBehavior["getSelection"]>): void;
218
+ /**
219
+ * @param {import('loro-crdt').Delta<string>[]} data
220
+ * @public
221
+ */
222
+ public applyDelta(data?: import("loro-crdt").Delta<string>[]): void;
101
223
  /**
102
224
  * @param {Parameters<Block["split"]>[0]} [options]
103
225
  * @param {ReturnType<TextBehavior["getSelection"]>} [selection]
104
226
  * @returns {ReturnType<Block["split"]>}
227
+ * @public
105
228
  */
106
- split(options?: Parameters<Block["split"]>[0], selection?: ReturnType<TextBehavior["getSelection"]>): ReturnType<Block["split"]>;
107
- /** @param {string} markName @param {any} value @param {ReturnType<TextBehavior["getSelection"]>} sel */
108
- applyMark(markName: string, value: any, sel: ReturnType<TextBehavior["getSelection"]>): void;
109
- /** @param {string} markName @param {ReturnType<TextBehavior["getSelection"]>} sel */
110
- removeMark(markName: string, sel: ReturnType<TextBehavior["getSelection"]>): void;
111
- /** @param {string} markName @param {ReturnType<TextBehavior["getSelection"]>} sel */
112
- isMarkActive(markName: string, sel: ReturnType<TextBehavior["getSelection"]>): boolean;
113
- /** @param {string} markName @param {any} value @param {ReturnType<TextBehavior["getSelection"]>} sel */
114
- toggleMark(markName: string, value: any, sel: ReturnType<TextBehavior["getSelection"]>): void;
115
- /** @returns {string} */
116
- toMarkdown(): string;
229
+ public split(options?: Parameters<Block["split"]>[0], selection?: ReturnType<TextBehavior["getSelection"]>): ReturnType<Block["split"]>;
230
+ /**
231
+ * @param {string} markName
232
+ * @param {any} value
233
+ * @param {Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, 'from' | 'to' | 'isCollapsed'> | null} sel
234
+ * @public
235
+ */
236
+ public applyMark(markName: string, value: any, sel: Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, "from" | "to" | "isCollapsed"> | null): void;
237
+ /**
238
+ * @param {string} markName
239
+ * @param {Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, 'from' | 'to' | 'isCollapsed'> | null} sel
240
+ * @public
241
+ */
242
+ public removeMark(markName: string, sel: Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, "from" | "to" | "isCollapsed"> | null): void;
243
+ /**
244
+ * @param {string} markName
245
+ * @param {Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, 'from' | 'to' | 'isCollapsed'> | null} sel
246
+ * @public
247
+ */
248
+ public isMarkActive(markName: string, sel: Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, "from" | "to" | "isCollapsed"> | null): boolean;
249
+ /**
250
+ * @param {string} markName
251
+ * @param {any} value
252
+ * @param {Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, 'from' | 'to' | 'isCollapsed'> | null} sel
253
+ * @public
254
+ */
255
+ public toggleMark(markName: string, value: any, sel: Pick<NonNullable<ReturnType<TextBehavior["getSelection"]>>, "from" | "to" | "isCollapsed"> | null): void;
256
+ /** @param {{ rawBreaks?: boolean }} [options] see {@link deltaToMarkdown}
257
+ * @public
258
+ * @returns {string} */
259
+ public toMarkdown(options?: {
260
+ rawBreaks?: boolean;
261
+ }): string;
117
262
  /**
118
263
  * Converts the text delta to a Slate-like JSON format.
119
264
  * @returns {{text: string, [mark: string]: any}[]}
265
+ * @public
120
266
  */
121
- toJSON(): {
267
+ public toJSON(): {
122
268
  text: string;
123
269
  [mark: string]: any;
124
270
  }[];
125
271
  /**
126
272
  * Serializes a (partial) range of this block's text as a PasteBlock.
127
- * @param {{ from?: number, to?: number, partial?: 'start'|'end'|'both'|false, props?: Record<string,any> }} [context]
128
- * @returns {import('../utils/extensions.js').PasteBlock}
273
+ * @param {{ from?: number, to?: number | null, partial?: 'start'|'end'|'both'|false, props?: Record<string,any> }} [context]
274
+ * @returns {import('../../utils/extensions.js').PasteBlock}
275
+ * @public
129
276
  */
130
- toClipboardBlock({ from, to, partial, props }?: {
277
+ public toClipboardBlock({ from, to, partial, props }?: {
131
278
  from?: number;
132
- to?: number;
279
+ to?: number | null;
133
280
  partial?: "start" | "end" | "both" | false;
134
281
  props?: Record<string, any>;
135
- }): any;
136
- /** @param {Block} other */
137
- absorbs(other: Block): boolean;
282
+ }): import("../../utils/extensions.js").PasteBlock;
283
+ /**
284
+ * @param {Block} other
285
+ * @public
286
+ */
287
+ public absorbs(other: Block): boolean;
288
+ #private;
138
289
  }
139
290
  export type TextNode = NabuNode<{
140
291
  type: "paragraph";