@aionbuilders/nabu 0.1.0-alpha.9 → 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 (319) hide show
  1. package/CHANGELOG.md +523 -0
  2. package/LICENSE +21 -0
  3. package/README.md +82 -144
  4. package/dist/behaviors/text/RichText.svelte +25 -2
  5. package/dist/behaviors/text/index.d.ts +2 -0
  6. package/dist/behaviors/text/index.js +2 -0
  7. package/dist/behaviors/text/markdown-shortcuts.extension.d.ts +5 -0
  8. package/dist/behaviors/text/markdown-shortcuts.extension.js +79 -0
  9. package/dist/behaviors/text/markdown-syntax.d.ts +42 -0
  10. package/dist/behaviors/text/markdown-syntax.js +81 -0
  11. package/dist/behaviors/text/rich-text.extension.d.ts +3 -0
  12. package/dist/behaviors/text/rich-text.extension.js +135 -53
  13. package/dist/behaviors/text/text.behavior.svelte.d.ts +217 -42
  14. package/dist/behaviors/text/text.behavior.svelte.js +657 -55
  15. package/dist/behaviors/text/typography.extension.d.ts +7 -0
  16. package/dist/behaviors/text/typography.extension.js +25 -0
  17. package/dist/blocks/Block.svelte +5 -2
  18. package/dist/blocks/BlockList.svelte +48 -0
  19. package/dist/blocks/BlockList.svelte.d.ts +17 -0
  20. package/dist/blocks/Nabu.svelte +180 -14
  21. package/dist/blocks/Nabu.svelte.d.ts +13 -0
  22. package/dist/blocks/block.extension.d.ts +3 -0
  23. package/dist/blocks/block.extension.js +8 -9
  24. package/dist/blocks/block.svelte.d.ts +356 -68
  25. package/dist/blocks/block.svelte.js +388 -42
  26. package/dist/blocks/blockquote/Blockquote.svelte +39 -0
  27. package/dist/blocks/blockquote/Blockquote.svelte.d.ts +11 -0
  28. package/dist/blocks/blockquote/blockquote.extension.d.ts +4 -0
  29. package/dist/blocks/blockquote/blockquote.extension.js +80 -0
  30. package/dist/blocks/blockquote/blockquote.svelte.d.ts +63 -0
  31. package/dist/blocks/blockquote/blockquote.svelte.js +136 -0
  32. package/dist/blocks/blockquote/index.d.ts +3 -0
  33. package/dist/blocks/blockquote/index.js +3 -0
  34. package/dist/blocks/callout/Callout.svelte +67 -0
  35. package/dist/blocks/callout/Callout.svelte.d.ts +11 -0
  36. package/dist/blocks/callout/callout.extension.d.ts +4 -0
  37. package/dist/blocks/callout/callout.extension.js +84 -0
  38. package/dist/blocks/callout/callout.svelte.d.ts +80 -0
  39. package/dist/blocks/callout/callout.svelte.js +189 -0
  40. package/dist/blocks/callout/index.d.ts +3 -0
  41. package/dist/blocks/callout/index.js +3 -0
  42. package/dist/blocks/chunks.d.ts +49 -0
  43. package/dist/blocks/chunks.js +90 -0
  44. package/dist/blocks/code/Code.svelte +84 -0
  45. package/dist/blocks/code/Code.svelte.d.ts +11 -0
  46. package/dist/blocks/code/code.extension.d.ts +4 -0
  47. package/dist/blocks/code/code.extension.js +88 -0
  48. package/dist/blocks/code/code.svelte.d.ts +68 -0
  49. package/dist/blocks/code/code.svelte.js +245 -0
  50. package/dist/blocks/code/index.d.ts +3 -0
  51. package/dist/blocks/code/index.js +3 -0
  52. package/dist/blocks/container.utils.d.ts +85 -13
  53. package/dist/blocks/container.utils.js +338 -178
  54. package/dist/blocks/dialogue/Dialogue.svelte +8 -2
  55. package/dist/blocks/dialogue/dialogue.svelte.d.ts +36 -23
  56. package/dist/blocks/dialogue/dialogue.svelte.js +51 -45
  57. package/dist/blocks/dialogue/hooks/onBeforeInput.hook.d.ts +2 -2
  58. package/dist/blocks/dialogue/hooks/onBeforeInput.hook.js +6 -4
  59. package/dist/blocks/dialogue/index.d.ts +12 -1
  60. package/dist/blocks/dialogue/index.js +51 -35
  61. package/dist/blocks/divider/Divider.svelte +28 -0
  62. package/dist/blocks/divider/Divider.svelte.d.ts +11 -0
  63. package/dist/blocks/divider/divider.extension.d.ts +23 -0
  64. package/dist/blocks/divider/divider.extension.js +153 -0
  65. package/dist/blocks/divider/divider.svelte.d.ts +54 -0
  66. package/dist/blocks/divider/divider.svelte.js +89 -0
  67. package/dist/blocks/divider/index.d.ts +3 -0
  68. package/dist/blocks/divider/index.js +3 -0
  69. package/dist/blocks/file/File.svelte +56 -0
  70. package/dist/blocks/file/File.svelte.d.ts +11 -0
  71. package/dist/blocks/file/file.extension.d.ts +4 -0
  72. package/dist/blocks/file/file.extension.js +27 -0
  73. package/dist/blocks/file/file.svelte.d.ts +29 -0
  74. package/dist/blocks/file/file.svelte.js +77 -0
  75. package/dist/blocks/file/index.d.ts +3 -0
  76. package/dist/blocks/file/index.js +3 -0
  77. package/dist/blocks/heading/Heading.svelte +2 -1
  78. package/dist/blocks/heading/heading.svelte.d.ts +27 -34
  79. package/dist/blocks/heading/heading.svelte.js +72 -60
  80. package/dist/blocks/heading/hooks/onBeforeInput.hook.js +7 -5
  81. package/dist/blocks/heading/index.d.ts +2 -2
  82. package/dist/blocks/heading/index.js +33 -8
  83. package/dist/blocks/image/Image.svelte +41 -0
  84. package/dist/blocks/image/Image.svelte.d.ts +11 -0
  85. package/dist/blocks/image/image.extension.d.ts +5 -0
  86. package/dist/blocks/image/image.extension.js +34 -0
  87. package/dist/blocks/image/image.svelte.d.ts +61 -0
  88. package/dist/blocks/image/image.svelte.js +114 -0
  89. package/dist/blocks/image/index.d.ts +3 -0
  90. package/dist/blocks/image/index.js +3 -0
  91. package/dist/blocks/index.d.ts +11 -1
  92. package/dist/blocks/index.js +11 -1
  93. package/dist/blocks/list/List.svelte +9 -2
  94. package/dist/blocks/list/ListItem.svelte +44 -7
  95. package/dist/blocks/list/convert.d.ts +20 -0
  96. package/dist/blocks/list/convert.js +92 -0
  97. package/dist/blocks/list/hooks/onBeforeInput.hook.js +60 -26
  98. package/dist/blocks/list/html-flat.d.ts +78 -0
  99. package/dist/blocks/list/html-flat.js +244 -0
  100. package/dist/blocks/list/indent.d.ts +86 -0
  101. package/dist/blocks/list/indent.js +205 -0
  102. package/dist/blocks/list/index.d.ts +7 -3
  103. package/dist/blocks/list/index.js +43 -31
  104. package/dist/blocks/list/list-item.svelte.d.ts +43 -17
  105. package/dist/blocks/list/list-item.svelte.js +143 -93
  106. package/dist/blocks/list/list.behavior.svelte.d.ts +7 -4
  107. package/dist/blocks/list/list.behavior.svelte.js +10 -5
  108. package/dist/blocks/list/list.svelte.d.ts +101 -23
  109. package/dist/blocks/list/list.svelte.js +136 -114
  110. package/dist/blocks/list/markdown.d.ts +149 -0
  111. package/dist/blocks/list/markdown.js +442 -0
  112. package/dist/blocks/list/normalize.d.ts +11 -0
  113. package/dist/blocks/list/normalize.js +396 -0
  114. package/dist/blocks/list/paste.d.ts +45 -0
  115. package/dist/blocks/list/paste.js +242 -0
  116. package/dist/blocks/list/step-back.d.ts +24 -0
  117. package/dist/blocks/list/step-back.js +87 -0
  118. package/dist/blocks/list/to-list.d.ts +7 -0
  119. package/dist/blocks/list/to-list.js +44 -0
  120. package/dist/blocks/list/todos-toggle.d.ts +20 -0
  121. package/dist/blocks/list/todos-toggle.js +48 -0
  122. package/dist/blocks/list/todos.svelte.d.ts +35 -0
  123. package/dist/blocks/list/todos.svelte.js +76 -0
  124. package/dist/blocks/media/index.d.ts +2 -0
  125. package/dist/blocks/media/index.js +2 -0
  126. package/dist/blocks/media/markdown.d.ts +12 -0
  127. package/dist/blocks/media/markdown.js +26 -0
  128. package/dist/blocks/media/media-block.svelte.d.ts +107 -0
  129. package/dist/blocks/media/media-block.svelte.js +181 -0
  130. package/dist/blocks/media/media.helpers.d.ts +24 -0
  131. package/dist/blocks/media/media.helpers.js +88 -0
  132. package/dist/blocks/megablock.svelte.d.ts +50 -19
  133. package/dist/blocks/megablock.svelte.js +115 -74
  134. package/dist/blocks/move.d.ts +23 -0
  135. package/dist/blocks/move.js +92 -0
  136. package/dist/blocks/nabu.svelte.d.ts +846 -75
  137. package/dist/blocks/nabu.svelte.js +1990 -182
  138. package/dist/blocks/paragraph/Paragraph.svelte +1 -0
  139. package/dist/blocks/paragraph/index.d.ts +2 -2
  140. package/dist/blocks/paragraph/index.js +35 -16
  141. package/dist/blocks/paragraph/paragraph.svelte.d.ts +49 -35
  142. package/dist/blocks/paragraph/paragraph.svelte.js +81 -69
  143. package/dist/blocks/paragraph/table.html.d.ts +9 -0
  144. package/dist/blocks/paragraph/table.html.js +111 -0
  145. package/dist/blocks/paragraph/table.markdown.d.ts +32 -0
  146. package/dist/blocks/paragraph/table.markdown.js +90 -0
  147. package/dist/blocks/region/Region.svelte +264 -0
  148. package/dist/blocks/region/Region.svelte.d.ts +11 -0
  149. package/dist/blocks/region/actions.d.ts +135 -0
  150. package/dist/blocks/region/actions.js +402 -0
  151. package/dist/blocks/region/close.d.ts +35 -0
  152. package/dist/blocks/region/close.js +130 -0
  153. package/dist/blocks/region/commands.d.ts +6 -0
  154. package/dist/blocks/region/commands.js +277 -0
  155. package/dist/blocks/region/create.d.ts +72 -0
  156. package/dist/blocks/region/create.js +208 -0
  157. package/dist/blocks/region/end-marker.d.ts +35 -0
  158. package/dist/blocks/region/end-marker.js +51 -0
  159. package/dist/blocks/region/facts.d.ts +69 -0
  160. package/dist/blocks/region/facts.js +152 -0
  161. package/dist/blocks/region/format.d.ts +91 -0
  162. package/dist/blocks/region/format.js +260 -0
  163. package/dist/blocks/region/index.d.ts +14 -0
  164. package/dist/blocks/region/index.js +14 -0
  165. package/dist/blocks/region/insert.d.ts +59 -0
  166. package/dist/blocks/region/insert.js +102 -0
  167. package/dist/blocks/region/messages.d.ts +254 -0
  168. package/dist/blocks/region/messages.js +131 -0
  169. package/dist/blocks/region/normalize.d.ts +7 -0
  170. package/dist/blocks/region/normalize.js +170 -0
  171. package/dist/blocks/region/region.extension.d.ts +58 -0
  172. package/dist/blocks/region/region.extension.js +119 -0
  173. package/dist/blocks/region/region.svelte.d.ts +221 -0
  174. package/dist/blocks/region/region.svelte.js +582 -0
  175. package/dist/blocks/region/regions.svelte.d.ts +141 -0
  176. package/dist/blocks/region/regions.svelte.js +276 -0
  177. package/dist/blocks/region/serialize.d.ts +57 -0
  178. package/dist/blocks/region/serialize.js +112 -0
  179. package/dist/blocks/region/types.d.ts +255 -0
  180. package/dist/blocks/region/types.js +204 -0
  181. package/dist/blocks/selection.svelte.d.ts +106 -8
  182. package/dist/blocks/selection.svelte.js +632 -74
  183. package/dist/blocks/subthread.d.ts +80 -0
  184. package/dist/blocks/subthread.js +167 -0
  185. package/dist/blocks/text-block.svelte.d.ts +70 -0
  186. package/dist/blocks/text-block.svelte.js +108 -0
  187. package/dist/blocks/toggle/Toggle.svelte +73 -0
  188. package/dist/blocks/toggle/Toggle.svelte.d.ts +11 -0
  189. package/dist/blocks/toggle/index.d.ts +3 -0
  190. package/dist/blocks/toggle/index.js +3 -0
  191. package/dist/blocks/toggle/markdown.d.ts +20 -0
  192. package/dist/blocks/toggle/markdown.js +112 -0
  193. package/dist/blocks/toggle/toggle.extension.d.ts +4 -0
  194. package/dist/blocks/toggle/toggle.extension.js +18 -0
  195. package/dist/blocks/toggle/toggle.svelte.d.ts +135 -0
  196. package/dist/blocks/toggle/toggle.svelte.js +352 -0
  197. package/dist/blocks/undo-selection.d.ts +175 -0
  198. package/dist/blocks/undo-selection.js +360 -0
  199. package/dist/blocks/video/Video.svelte +42 -0
  200. package/dist/blocks/video/Video.svelte.d.ts +11 -0
  201. package/dist/blocks/video/index.d.ts +3 -0
  202. package/dist/blocks/video/index.js +3 -0
  203. package/dist/blocks/video/video.extension.d.ts +4 -0
  204. package/dist/blocks/video/video.extension.js +27 -0
  205. package/dist/blocks/video/video.svelte.d.ts +29 -0
  206. package/dist/blocks/video/video.svelte.js +80 -0
  207. package/dist/extend.d.ts +55 -0
  208. package/dist/extend.js +88 -0
  209. package/dist/files/assets.clipboard.d.ts +77 -0
  210. package/dist/files/assets.clipboard.js +152 -0
  211. package/dist/files/files.svelte.d.ts +363 -0
  212. package/dist/files/files.svelte.js +897 -0
  213. package/dist/files/index.d.ts +3 -0
  214. package/dist/files/index.js +3 -0
  215. package/dist/files/outbox.d.ts +69 -0
  216. package/dist/files/outbox.js +48 -0
  217. package/dist/files/status.d.ts +65 -0
  218. package/dist/files/status.js +87 -0
  219. package/dist/files/store.d.ts +97 -0
  220. package/dist/files/store.js +65 -0
  221. package/dist/files/uploads.svelte.d.ts +174 -0
  222. package/dist/files/uploads.svelte.js +504 -0
  223. package/dist/index.d.ts +68 -6
  224. package/dist/index.js +117 -7
  225. package/dist/nabu-theme.css +112 -0
  226. package/dist/paste/html.paste.d.ts +74 -3
  227. package/dist/paste/html.paste.js +555 -83
  228. package/dist/paste/markdown-inline.d.ts +86 -0
  229. package/dist/paste/markdown-inline.js +528 -0
  230. package/dist/paste/markdown.paste.d.ts +2 -8
  231. package/dist/paste/markdown.paste.js +78 -94
  232. package/dist/paste/nabu.paste.d.ts +3 -0
  233. package/dist/paste/nabu.paste.js +29 -3
  234. package/dist/paste/plain-text.paste.d.ts +2 -2
  235. package/dist/paste/plain-text.paste.js +3 -3
  236. package/dist/persistence/asset-store.d.ts +51 -0
  237. package/dist/persistence/asset-store.js +103 -0
  238. package/dist/persistence/autosave.d.ts +53 -0
  239. package/dist/persistence/autosave.js +62 -0
  240. package/dist/persistence/compact.d.ts +162 -0
  241. package/dist/persistence/compact.js +141 -0
  242. package/dist/persistence/history.d.ts +77 -0
  243. package/dist/persistence/history.js +176 -0
  244. package/dist/persistence/indexeddb.d.ts +190 -4
  245. package/dist/persistence/indexeddb.js +333 -29
  246. package/dist/persistence/merge.d.ts +38 -0
  247. package/dist/persistence/merge.js +36 -0
  248. package/dist/persistence/outbox.d.ts +25 -0
  249. package/dist/persistence/outbox.js +40 -0
  250. package/dist/persistence/persistence.d.ts +70 -9
  251. package/dist/persistence/persistence.js +507 -35
  252. package/dist/persistence/recovery.d.ts +79 -0
  253. package/dist/persistence/recovery.js +79 -0
  254. package/dist/persistence/release.d.ts +34 -0
  255. package/dist/persistence/release.js +64 -0
  256. package/dist/persistence/state.svelte.d.ts +53 -0
  257. package/dist/persistence/state.svelte.js +48 -0
  258. package/dist/persistence/sync.d.ts +39 -0
  259. package/dist/persistence/sync.js +138 -0
  260. package/dist/persistence/tail.d.ts +42 -0
  261. package/dist/persistence/tail.js +103 -0
  262. package/dist/presets.d.ts +29 -24
  263. package/dist/presets.js +51 -14
  264. package/dist/themes/atelier.css +318 -0
  265. package/dist/ui/CommandChooser.svelte +153 -0
  266. package/dist/ui/CommandChooser.svelte.d.ts +13 -0
  267. package/dist/ui/CommandInvite.svelte +99 -0
  268. package/dist/ui/CommandInvite.svelte.d.ts +12 -0
  269. package/dist/ui/DragHandle.svelte +217 -0
  270. package/dist/ui/DragHandle.svelte.d.ts +11 -0
  271. package/dist/ui/FloatingToolbar.svelte +165 -0
  272. package/dist/ui/FloatingToolbar.svelte.d.ts +27 -0
  273. package/dist/ui/SlashMenu.svelte +215 -0
  274. package/dist/ui/SlashMenu.svelte.d.ts +33 -0
  275. package/dist/ui/anchor.d.ts +112 -0
  276. package/dist/ui/anchor.js +136 -0
  277. package/dist/ui/index.d.ts +10 -0
  278. package/dist/ui/index.js +15 -0
  279. package/dist/ui/slash-menu.svelte.d.ts +112 -0
  280. package/dist/ui/slash-menu.svelte.js +150 -0
  281. package/dist/utils/command-confirm.svelte.d.ts +349 -0
  282. package/dist/utils/command-confirm.svelte.js +673 -0
  283. package/dist/utils/commands.d.ts +328 -0
  284. package/dist/utils/commands.js +416 -0
  285. package/dist/utils/dom-scope.d.ts +14 -0
  286. package/dist/utils/dom-scope.js +20 -0
  287. package/dist/utils/drop.d.ts +160 -0
  288. package/dist/utils/drop.js +305 -0
  289. package/dist/utils/extensions.d.ts +488 -40
  290. package/dist/utils/extensions.js +300 -19
  291. package/dist/utils/html.d.ts +44 -0
  292. package/dist/utils/html.js +183 -0
  293. package/dist/utils/index.d.ts +4 -0
  294. package/dist/utils/index.js +4 -0
  295. package/dist/utils/keys.d.ts +120 -0
  296. package/dist/utils/keys.js +248 -0
  297. package/dist/utils/links.d.ts +22 -0
  298. package/dist/utils/links.js +34 -0
  299. package/dist/utils/placeholders.d.ts +88 -0
  300. package/dist/utils/placeholders.js +91 -0
  301. package/dist/utils/selection.svelte.d.ts +47 -19
  302. package/dist/utils/selection.svelte.js +60 -10
  303. package/dist/utils/spellcheck.d.ts +9 -0
  304. package/dist/utils/spellcheck.js +17 -0
  305. package/dist/utils/tab.d.ts +31 -0
  306. package/dist/utils/tab.js +117 -0
  307. package/dist/utils/words.d.ts +7 -0
  308. package/dist/utils/words.js +62 -0
  309. package/dist/vite.d.ts +22 -0
  310. package/dist/vite.js +34 -0
  311. package/package.json +61 -22
  312. package/dist/blocks/zone/Zone.svelte +0 -258
  313. package/dist/blocks/zone/Zone.svelte.d.ts +0 -11
  314. package/dist/blocks/zone/index.d.ts +0 -2
  315. package/dist/blocks/zone/index.js +0 -2
  316. package/dist/blocks/zone/zone.extension.d.ts +0 -2
  317. package/dist/blocks/zone/zone.extension.js +0 -221
  318. package/dist/blocks/zone/zone.svelte.d.ts +0 -112
  319. package/dist/blocks/zone/zone.svelte.js +0 -321
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Takes a top-level item out of its list and retypes it as `type` (a paragraph for the step back, any
3
+ * block for a type change: heading, quote, code…). Moves only; no commit. The `checked` flag is dropped,
4
+ * `props` are written on the node (e.g. a heading `level`).
5
+ * @param {Nabu} nabu
6
+ * @param {NabuNode} item
7
+ * @param {string} [type]
8
+ * @param {Record<string, any>} [props]
9
+ * @param {boolean} [numbered=true] whether the item counts as a numbered item of an ORDERED list (the tail
10
+ * resumes after it). False for a pure placeholder (a paste splitting the list): the tail resumes right where
11
+ * the items before it stop.
12
+ * @returns {boolean} whether the item was lifted (false when it is nested / not in a list)
13
+ */
14
+ export function liftItemTo(nabu: Nabu, item: NabuNode, type?: string, props?: Record<string, any>, numbered?: boolean): boolean;
15
+ /**
16
+ * Step a list item back one level (see the file header). Resolves once committed and the caret is back.
17
+ * @param {Nabu} nabu
18
+ * @param {NabuNode} item a list-item node
19
+ * @returns {Promise<boolean>} whether the structure changed
20
+ */
21
+ export function stepBack(nabu: Nabu, item: NabuNode): Promise<boolean>;
22
+ export function liftItemToParagraph(nabu: Nabu, item: NabuNode): boolean;
23
+ import type { Nabu } from "../nabu.svelte.js";
24
+ import type { NabuNode } from "../nabu.svelte.js";
@@ -0,0 +1,87 @@
1
+ /**
2
+ * "Step back one level" for a list item: Enter on an EMPTY item, Backspace at offset 0 of an item.
3
+ *
4
+ * - a NESTED item is unindented one level (exactly Shift+Tab: its following siblings become its children);
5
+ * - a TOP-LEVEL item leaves the list and becomes a paragraph (same node, so its id, text, marks and caret
6
+ * survive). The list is split around it: the items before stay, the items after go into a new list
7
+ * placed after the paragraph. The item's own sublists (it may have several, of different types) are moved out right after the paragraph, in order (nothing is
8
+ * lost, the relative nesting is kept). An ORDERED tail list keeps counting where the list left off
9
+ * (`start`), so `1. a 2. b 3. c` with b removed reads `1. a`, `b`, `3. c`.
10
+ *
11
+ * Moves on tree NODES only, one transaction (= one undo step), then the caret goes to offset 0.
12
+ *
13
+ * @import { Nabu, NabuNode } from "../nabu.svelte.js";
14
+ */
15
+
16
+ import { List, listStart } from "./list.svelte.js";
17
+ import { typeOf, kids, sublistsOf, dropIfEmpty, moveItems } from "./indent.js";
18
+
19
+ /**
20
+ * Takes a top-level item out of its list and retypes it as `type` (a paragraph for the step back, any
21
+ * block for a type change: heading, quote, code…). Moves only; no commit. The `checked` flag is dropped,
22
+ * `props` are written on the node (e.g. a heading `level`).
23
+ * @param {Nabu} nabu
24
+ * @param {NabuNode} item
25
+ * @param {string} [type]
26
+ * @param {Record<string, any>} [props]
27
+ * @param {boolean} [numbered=true] whether the item counts as a numbered item of an ORDERED list (the tail
28
+ * resumes after it). False for a pure placeholder (a paste splitting the list): the tail resumes right where
29
+ * the items before it stop.
30
+ * @returns {boolean} whether the item was lifted (false when it is nested / not in a list)
31
+ */
32
+ export function liftItemTo(nabu, item, type = "paragraph", props = {}, numbered = true) {
33
+ const list = item.parent();
34
+ if (!list || typeOf(list) !== "list" || typeOf(list.parent()) === "list-item") return false;
35
+
36
+ const index = item.index() ?? 0;
37
+ const followers = kids(list).slice(index + 1);
38
+ const own = sublistsOf(item);
39
+ const listType = /** @type {any} */ (list.data.get("listType")) || "bullet";
40
+ // The number the first follower had: the list's own start + the items before it (item included).
41
+ const tailStart = (listStart(listType, list.data.get("start")) ?? 1) + index + (numbered ? 1 : 0);
42
+ const parentId = list.parent()?.id.toString();
43
+
44
+ item.moveAfter(list);
45
+ /** @type {NabuNode} */
46
+ let anchor = item;
47
+ for (const sublist of own) {
48
+ sublist.moveAfter(anchor);
49
+ anchor = sublist;
50
+ }
51
+ if (followers.length) {
52
+ // List.create, not nabu.insert(): that commits, and the empty tail would be normalized away.
53
+ const tail = List.create(nabu, "list", { listType, start: tailStart }, parentId).node;
54
+ tail.moveAfter(anchor);
55
+ for (const follower of followers) follower.move(tail, kids(tail).length);
56
+ }
57
+ dropIfEmpty(nabu, list);
58
+
59
+ if (/** @type {any} */ (item.data).get("checked") !== undefined) /** @type {any} */ (item.data).delete("checked");
60
+ item.data.set("type", type);
61
+ for (const [key, value] of Object.entries(props)) /** @type {any} */ (item.data).set(key, value);
62
+ return true;
63
+ }
64
+
65
+ /**
66
+ * Takes a top-level item out of its list and retypes it as a paragraph. Moves only; no commit.
67
+ * @param {Nabu} nabu
68
+ * @param {NabuNode} item
69
+ * @returns {boolean} whether the item was lifted (false when it is nested / not in a list)
70
+ */
71
+ export const liftItemToParagraph = (nabu, item) => liftItemTo(nabu, item, "paragraph");
72
+
73
+ /**
74
+ * Step a list item back one level (see the file header). Resolves once committed and the caret is back.
75
+ * @param {Nabu} nabu
76
+ * @param {NabuNode} item a list-item node
77
+ * @returns {Promise<boolean>} whether the structure changed
78
+ */
79
+ export async function stepBack(nabu, item) {
80
+ const id = item.id.toString();
81
+ if (typeOf(item.parent()?.parent()) === "list-item") return moveItems(nabu, [item], true);
82
+ if (!liftItemToParagraph(nabu, item)) return false;
83
+ await nabu.commit();
84
+ const block = nabu.blocks.get(id);
85
+ if (block) nabu.selection.setCursor(block, 0);
86
+ return true;
87
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @param {Nabu} nabu
3
+ * @param {"bullet" | "ordered" | "todo"} listType
4
+ * @returns {Promise<void>}
5
+ */
6
+ export function convertToList(nabu: Nabu, listType: "bullet" | "ordered" | "todo"): Promise<void>;
7
+ import type { Nabu } from "../nabu.svelte.js";
@@ -0,0 +1,44 @@
1
+ /**
2
+ * `list:convert` — turn the block holding the caret into a list item of the given type (slash menu
3
+ * "Bulleted / Numbered / To-do list"):
4
+ * - a list item changes list type on its own, in place (see convert.js);
5
+ * - any other text block is replaced by a new list (same flow as the "- " / "1. " markdown shortcuts).
6
+ *
7
+ * @import { Nabu } from "../nabu.svelte.js";
8
+ */
9
+
10
+ import { List } from "./list.svelte.js";
11
+ import { ListItem } from "./list-item.svelte.js";
12
+ import { convertItemToListType } from "./convert.js";
13
+
14
+ /**
15
+ * @param {Nabu} nabu
16
+ * @param {"bullet" | "ordered" | "todo"} listType
17
+ * @returns {Promise<void>}
18
+ */
19
+ export async function convertToList(nabu, listType) {
20
+ const block = nabu.selection.anchorBlock;
21
+ if (!block || !["bullet", "ordered", "todo"].includes(listType)) return;
22
+
23
+ if (block.type === "list-item") {
24
+ const id = block.id;
25
+ const offset = block.behaviors?.get("text")?.selection?.from ?? 0;
26
+ await nabu.transact(() => { convertItemToListType(nabu, /** @type {any} */ (block.node), listType); });
27
+ const fresh = nabu.blocks.get(id);
28
+ if (fresh) nabu.focus({ from: { block: fresh, offset }, to: { block: fresh, offset } });
29
+ return;
30
+ }
31
+
32
+ const beh = block.behaviors?.get("text");
33
+ const delta = beh ? beh.container.toDelta() : [];
34
+ const parentNode = block.node.parent();
35
+ const parentId = parentNode?.id.toString() ?? null;
36
+ const index = block.node.index();
37
+ const list = List.create(nabu, "list", { listType }, parentId, index);
38
+ const itemProps = listType === "todo" ? { delta, checked: false } : { delta };
39
+ const item = ListItem.create(nabu, "list-item", itemProps, list.node.id.toString());
40
+ block.destroy();
41
+ await nabu.commit();
42
+ const fresh = nabu.blocks.get(item.id);
43
+ if (fresh) fresh.focus({ start: 0, end: 0 });
44
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * The to-do items the selection touches (the anchor item for a caret).
3
+ * @param {Nabu} nabu
4
+ */
5
+ export function selectedTodoItems(nabu: Nabu): import("../nabu.svelte.js").NabuNode[];
6
+ /**
7
+ * Toggle the to-do items the selection touches (see the module doc). The `todo:toggle` command.
8
+ * @param {Nabu} nabu
9
+ * @returns {boolean} whether at least one to-do item was touched
10
+ */
11
+ export function toggleSelectedTodos(nabu: Nabu): boolean;
12
+ /**
13
+ * Key-event form of {@link toggleSelectedTodos}: Ctrl/Cmd+Enter only (the keyboard path is the `todo:toggle` command now;
14
+ * this stays for direct callers).
15
+ * @param {Nabu} nabu
16
+ * @param {KeyboardEvent} event
17
+ * @returns {boolean} whether the key was handled (= at least one to-do item was touched); false for any other key
18
+ */
19
+ export function toggleTodos(nabu: Nabu, event: KeyboardEvent): boolean;
20
+ import type { Nabu } from "../nabu.svelte.js";
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Ctrl/Cmd+Enter on a to-do item (the `todo:toggle` command, ADR 017) toggles its `checked`. With a selection spanning several to-do items they
3
+ * are toggled together: if ANY is unchecked every one gets checked, otherwise every one gets unchecked.
4
+ * One transaction (one undo step); the caret / selection is not touched.
5
+ *
6
+ * @import { Nabu } from "../nabu.svelte.js";
7
+ */
8
+
9
+ import { selectedItems } from "./indent.js";
10
+
11
+ /**
12
+ * The to-do items the selection touches (the anchor item for a caret).
13
+ * @param {Nabu} nabu
14
+ */
15
+ export function selectedTodoItems(nabu) {
16
+ return selectedItems(nabu).filter((node) => /** @type {any} */ (node.parent()?.data)?.get("listType") === "todo");
17
+ }
18
+
19
+ /**
20
+ * Toggle the to-do items the selection touches (see the module doc). The `todo:toggle` command.
21
+ * @param {Nabu} nabu
22
+ * @returns {boolean} whether at least one to-do item was touched
23
+ */
24
+ export function toggleSelectedTodos(nabu) {
25
+ const items = selectedTodoItems(nabu);
26
+ if (!items.length) return false;
27
+ const value = items.some((node) => !(/** @type {any} */ (node.data)).get("checked"));
28
+ for (const node of items) {
29
+ const block = /** @type {any} */ (nabu.blocks.get(node.id.toString()));
30
+ if (block) block.checked = value;
31
+ /** @type {any} */ (node.data).set("checked", value);
32
+ }
33
+ nabu.isolateUndoStep(); // a flag change is not structural: it would merge with the typing around it
34
+ nabu.commit();
35
+ return true;
36
+ }
37
+
38
+ /**
39
+ * Key-event form of {@link toggleSelectedTodos}: Ctrl/Cmd+Enter only (the keyboard path is the `todo:toggle` command now;
40
+ * this stays for direct callers).
41
+ * @param {Nabu} nabu
42
+ * @param {KeyboardEvent} event
43
+ * @returns {boolean} whether the key was handled (= at least one to-do item was touched); false for any other key
44
+ */
45
+ export function toggleTodos(nabu, event) {
46
+ if (event.key !== "Enter" || !(event.ctrlKey || event.metaKey) || event.shiftKey || event.altKey) return false;
47
+ return toggleSelectedTodos(nabu);
48
+ }
@@ -0,0 +1,35 @@
1
+ /** @import { Nabu } from "../nabu.svelte.js"; */
2
+ /**
3
+ * Document-level reactive registry of all to-do items (checklist list-items).
4
+ * Pure derived view over the block tree — stores nothing in Loro.
5
+ * Lazy: obtain via Todos.get(nabu).
6
+ */
7
+ export class Todos {
8
+ /** @param {Nabu} nabu @returns {Todos} */
9
+ static get(nabu: Nabu): Todos;
10
+ /** @param {Nabu} nabu */
11
+ constructor(nabu: Nabu);
12
+ /**
13
+ * All to-do items in document order (DFS). A to-do is a list-item whose
14
+ * parent list is a todo list (ListItem.isTodo).
15
+ * @type {ListItem[]}
16
+ */
17
+ all: ListItem[];
18
+ count: number;
19
+ done: ListItem[];
20
+ doneCount: number;
21
+ remaining: ListItem[];
22
+ /** Fraction completed, 0..1 (0 when there are no to-dos). */
23
+ progress: number;
24
+ /** @param {ListItem} item */
25
+ toggle(item: ListItem): void;
26
+ /** Mark every to-do checked, in a single transaction. */
27
+ checkAll(): void;
28
+ /** Mark every to-do unchecked, in a single transaction. */
29
+ uncheckAll(): void;
30
+ /** Move the cursor to a to-do item. @param {ListItem} item */
31
+ goTo(item: ListItem): void;
32
+ #private;
33
+ }
34
+ import { ListItem } from "./list-item.svelte.js";
35
+ import type { Nabu } from "../nabu.svelte.js";
@@ -0,0 +1,76 @@
1
+ import { ListItem } from "./list-item.svelte.js";
2
+
3
+ /** @import { Nabu } from "../nabu.svelte.js"; */
4
+
5
+ /**
6
+ * Document-level reactive registry of all to-do items (checklist list-items).
7
+ * Pure derived view over the block tree — stores nothing in Loro.
8
+ * Lazy: obtain via Todos.get(nabu).
9
+ */
10
+ export class Todos {
11
+ /** @type {Nabu} */
12
+ #nabu;
13
+
14
+ /** @param {Nabu} nabu */
15
+ constructor(nabu) { this.#nabu = nabu; }
16
+
17
+ /** @param {Nabu} nabu @returns {Todos} */
18
+ static get(nabu) {
19
+ if (!nabu.systems.has('todos')) {
20
+ const todos = new Todos(nabu);
21
+ nabu.systems.set('todos', todos);
22
+ return todos;
23
+ }
24
+ return /** @type {Todos} */ (nabu.systems.get('todos'));
25
+ }
26
+
27
+ /**
28
+ * All to-do items in document order (DFS). A to-do is a list-item whose
29
+ * parent list is a todo list (ListItem.isTodo).
30
+ * @type {ListItem[]}
31
+ */
32
+ all = $derived.by(() => {
33
+ /** @type {ListItem[]} */
34
+ const result = [];
35
+ /** @param {import('../block.svelte.js').Block[]} blocks */
36
+ const traverse = (blocks) => {
37
+ for (const block of blocks) {
38
+ if (block instanceof ListItem && block.isTodo) result.push(block);
39
+ const children = /** @type {any} */ (block).children;
40
+ if (children?.length) traverse(children);
41
+ }
42
+ };
43
+ traverse(this.#nabu.children);
44
+ return result;
45
+ });
46
+
47
+ count = $derived(this.all.length);
48
+ done = $derived(this.all.filter(t => t.checked));
49
+ doneCount = $derived(this.done.length);
50
+ remaining = $derived(this.all.filter(t => !t.checked));
51
+ /** Fraction completed, 0..1 (0 when there are no to-dos). */
52
+ progress = $derived(this.count ? this.doneCount / this.count : 0);
53
+
54
+ /** @param {ListItem} item */
55
+ toggle(item) { item.toggleChecked(); }
56
+
57
+ /** Mark every to-do checked, in a single transaction. */
58
+ checkAll() { this.#setAll(true); }
59
+ /** Mark every to-do unchecked, in a single transaction. */
60
+ uncheckAll() { this.#setAll(false); }
61
+
62
+ /** @param {boolean} value */
63
+ #setAll(value) {
64
+ let changed = false;
65
+ for (const item of this.all) {
66
+ if (item.checked === value) continue;
67
+ item.checked = value;
68
+ /** @type {any} */ (item.node.data).set('checked', value);
69
+ changed = true;
70
+ }
71
+ if (changed) this.#nabu.commit();
72
+ }
73
+
74
+ /** Move the cursor to a to-do item. @param {ListItem} item */
75
+ goTo(item) { this.#nabu.selection.setCursor(item, 0); }
76
+ }
@@ -0,0 +1,2 @@
1
+ export { MediaBlock } from "./media-block.svelte.js";
2
+ export * from "./media.helpers.js";
@@ -0,0 +1,2 @@
1
+ export { MediaBlock } from './media-block.svelte.js';
2
+ export * from './media.helpers.js';
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @param {string} alt
3
+ * @param {string} ref
4
+ * @returns {string}
5
+ */
6
+ export function markdownImage(alt: string, ref: string): string;
7
+ /**
8
+ * @param {string} label
9
+ * @param {string} ref
10
+ * @returns {string}
11
+ */
12
+ export function markdownMediaLink(label: string, ref: string): string;
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Markdown syntax of the media blocks: `![alt](ref)` for an image, `[label](ref)` for a video / file. The alt text and the
3
+ * label are escaped like any inline text and the destination is wrapped in `<…>` when it holds spaces or unbalanced
4
+ * parentheses, so that what the importer reads back is the same `alt` / `ref`.
5
+ */
6
+
7
+ import { markdownDestination } from "../../behaviors/text";
8
+ import { escapeMarkdownText } from "../../behaviors/text/markdown-syntax.js";
9
+
10
+ /**
11
+ * @param {string} alt
12
+ * @param {string} ref
13
+ * @returns {string}
14
+ */
15
+ export function markdownImage(alt, ref) {
16
+ return '![' + escapeMarkdownText(alt) + '](' + markdownDestination(ref) + ')';
17
+ }
18
+
19
+ /**
20
+ * @param {string} label
21
+ * @param {string} ref
22
+ * @returns {string}
23
+ */
24
+ export function markdownMediaLink(label, ref) {
25
+ return '[' + escapeMarkdownText(label) + '](' + markdownDestination(ref) + ')';
26
+ }
@@ -0,0 +1,107 @@
1
+ /** @import { FileReason, FileStatus } from "../../files/status.js"; */
2
+ /** @import { Nabu, NabuNode } from "../nabu.svelte.js"; */
3
+ /**
4
+ * Base class for void media blocks (image / video / file). Shares void behavior,
5
+ * reactive {ref, alt, status, name} metadata, Files display resolution, and the
6
+ * optimistic preview. Subclasses provide component, serializers, and static rules.
7
+ */
8
+ export class MediaBlock extends Block {
9
+ /**
10
+ * Shared node factory. Subclasses call this from their static create().
11
+ * @param {Nabu} nabu @param {string} type @param {{ref?:string,alt?:string,status?:string,name?:string,reason?:FileReason}} [props] @param {string|null} [parentId] @param {number|null} [index]
12
+ * @returns {any}
13
+ */
14
+ static createNode(nabu: Nabu, type: string, props?: {
15
+ ref?: string;
16
+ alt?: string;
17
+ status?: string;
18
+ name?: string;
19
+ reason?: FileReason;
20
+ }, parentId?: string | null, index?: number | null): any;
21
+ /** @type {string} */ ref: string;
22
+ /** @type {string} */ alt: string;
23
+ /**
24
+ * What the block stores (see `files/status.js`): `ready` | `pending` (bytes being stored / uploaded; `progress` follows the
25
+ * upload) | `error` (upload failed or cancelled; the local copy is kept, `retry()` sends it again) | `missing` (no source has
26
+ * the bytes) | `rejected` (refused, e.g. over `files.maxFileSize`; no ref). A `pending` block that no upload is running for and
27
+ * whose file is neither local nor at the host is SHOWN as missing, see `isMissing`.
28
+ * @type {string}
29
+ */ status: string;
30
+ /** @type {string} */ name: string;
31
+ /** Transient local objectURL while pending (not persisted). @type {string | null} */ previewUrl: string | null;
32
+ /**
33
+ * Whether the file cannot be shown: flagged `missing` (pasted without its bytes), or a `nabu-asset:` ref that neither the
34
+ * local store nor the document's index can provide (e.g. the document was opened on another device). Reactive.
35
+ * @returns {boolean}
36
+ */
37
+ get isMissing(): boolean;
38
+ /**
39
+ * The status to SHOW: `missing` when the file cannot be displayed (see `isMissing`: includes a `pending` block whose upload
40
+ * was interrupted and is not available on this device), else the stored `status`. Reactive.
41
+ * @returns {string}
42
+ */
43
+ get displayStatus(): string;
44
+ /**
45
+ * Why the block is `error`, `rejected` or `missing`: `{ code, message }` (a stable code and a readable English sentence), `null`
46
+ * otherwise. A `pending` block shown as missing has the code `interrupted`. Reactive.
47
+ * @returns {FileReason | null}
48
+ */
49
+ get reason(): FileReason | null;
50
+ /**
51
+ * Upload progress, `0..1` while the file is being sent to the host (`files.onBeforePersist`), `null` otherwise. Reactive.
52
+ * @returns {number | null}
53
+ */
54
+ get progress(): number | null;
55
+ /**
56
+ * Send the file to the host again from its local copy (after `error`, including a cancelled upload). Resolves `true` when
57
+ * the file ended up at the host, `false` when there is nothing to retry (no host, bytes gone, not a local file).
58
+ * @returns {Promise<boolean>}
59
+ */
60
+ retry(): Promise<boolean>;
61
+ /**
62
+ * Abort the running upload (the host's `signal` fires). The block becomes `error` with the reason `cancelled`, the local copy
63
+ * is kept. Uploads are per file: every block showing the same file is affected.
64
+ * @returns {boolean} whether an upload was running
65
+ */
66
+ cancel(): boolean;
67
+ /**
68
+ * For the component's effect: keeps the display URL of this block alive while it is mounted (an unused objectURL is
69
+ * revoked). Returns the release function, so it can be used as `$effect(() => block.holdSource())`.
70
+ * @returns {() => void}
71
+ */
72
+ holdSource(): () => void;
73
+ /** @param {InputEvent} event */
74
+ beforeinput(event: InputEvent): boolean;
75
+ /** Resolved display URL. While pending → local preview; else resolve the ref. @returns {string} */
76
+ get displaySrc(): string;
77
+ /**
78
+ * The props a DOCUMENT export (`serialize('json')` / `'markdown'`) writes: `ref`, `alt`, `name`, and `status` (+ `reason`)
79
+ * when it is not `ready`. A `pending` block whose bytes are still being stored has no durable ref yet: its transient
80
+ * `nabu-pending:` ref (or empty one) is NOT exported as if it were final, the block is exported as `missing` (label
81
+ * kept, no source) so the import shows the "Missing file" state instead of a block stuck pending forever. A `pending`
82
+ * block with a hash ref (being uploaded) exports as a normal file: the export carries its bytes.
83
+ * @returns {{ ref: string, alt: string, name: string, status?: string, reason?: FileReason }}
84
+ */
85
+ get exportProps(): {
86
+ ref: string;
87
+ alt: string;
88
+ name: string;
89
+ status?: string;
90
+ reason?: FileReason;
91
+ };
92
+ /**
93
+ * What a COPY (`application/x-nabu+json`) carries of the file state: nothing, except a `rejected` block (so the refusal and
94
+ * its reason travel with it). Upload state (`pending`, `error`) never travels: the receiver works it out.
95
+ * @returns {{ status?: string, reason?: FileReason }}
96
+ */
97
+ get clipboardState(): {
98
+ status?: string;
99
+ reason?: FileReason;
100
+ };
101
+ /** @param {string} v */
102
+ setAlt(v: string): void;
103
+ #private;
104
+ }
105
+ import { Block } from "../block.svelte.js";
106
+ import type { FileReason } from "../../files/status.js";
107
+ import type { Nabu } from "../nabu.svelte.js";