@aionbuilders/nabu 0.1.0-beta.0 → 0.1.1

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 (308) hide show
  1. package/CHANGELOG.md +531 -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 +195 -55
  12. package/dist/behaviors/text/text.behavior.svelte.js +531 -103
  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 +32 -18
  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 +1753 -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 +35 -14
  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 +55 -8
  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/composition.d.ts +28 -0
  253. package/dist/utils/composition.js +51 -0
  254. package/dist/utils/dom-scope.d.ts +14 -0
  255. package/dist/utils/dom-scope.js +20 -0
  256. package/dist/utils/drop.d.ts +160 -0
  257. package/dist/utils/drop.js +305 -0
  258. package/dist/utils/extensions.d.ts +439 -45
  259. package/dist/utils/extensions.js +271 -29
  260. package/dist/utils/html.d.ts +44 -0
  261. package/dist/utils/html.js +183 -0
  262. package/dist/utils/index.d.ts +3 -0
  263. package/dist/utils/index.js +3 -0
  264. package/dist/utils/keys.d.ts +120 -0
  265. package/dist/utils/keys.js +248 -0
  266. package/dist/utils/links.d.ts +22 -0
  267. package/dist/utils/links.js +34 -0
  268. package/dist/utils/placeholders.d.ts +81 -3
  269. package/dist/utils/placeholders.js +73 -3
  270. package/dist/utils/selection.svelte.d.ts +48 -20
  271. package/dist/utils/selection.svelte.js +60 -10
  272. package/dist/utils/spellcheck.d.ts +9 -0
  273. package/dist/utils/spellcheck.js +17 -0
  274. package/dist/utils/tab.d.ts +31 -0
  275. package/dist/utils/tab.js +117 -0
  276. package/dist/utils/words.d.ts +42 -0
  277. package/dist/utils/words.js +147 -0
  278. package/dist/vite.d.ts +9 -3
  279. package/dist/vite.js +19 -8
  280. package/package.json +56 -20
  281. package/dist/blocks/variable.svelte.d.ts +0 -47
  282. package/dist/blocks/variable.svelte.js +0 -51
  283. package/dist/blocks/zone/TemplateEditor.svelte +0 -308
  284. package/dist/blocks/zone/TemplateEditor.svelte.d.ts +0 -11
  285. package/dist/blocks/zone/Zone.svelte +0 -272
  286. package/dist/blocks/zone/Zone.svelte.d.ts +0 -11
  287. package/dist/blocks/zone/ZoneEditor.svelte +0 -289
  288. package/dist/blocks/zone/ZoneEditor.svelte.d.ts +0 -11
  289. package/dist/blocks/zone/ZoneTemplatesList.svelte +0 -188
  290. package/dist/blocks/zone/ZoneTemplatesList.svelte.d.ts +0 -11
  291. package/dist/blocks/zone/hooks/onBeforeInput.hook.d.ts +0 -3
  292. package/dist/blocks/zone/hooks/onBeforeInput.hook.js +0 -30
  293. package/dist/blocks/zone/index.d.ts +0 -2
  294. package/dist/blocks/zone/index.js +0 -2
  295. package/dist/blocks/zone/zone.extension.d.ts +0 -2
  296. package/dist/blocks/zone/zone.extension.js +0 -237
  297. package/dist/blocks/zone/zone.svelte.d.ts +0 -221
  298. package/dist/blocks/zone/zone.svelte.js +0 -608
  299. package/dist/overlays/context/Context.svelte +0 -182
  300. package/dist/overlays/context/Context.svelte.d.ts +0 -17
  301. package/dist/overlays/context/collect.d.ts +0 -17
  302. package/dist/overlays/context/collect.js +0 -33
  303. package/dist/overlays/context/context.extension.d.ts +0 -2
  304. package/dist/overlays/context/context.extension.js +0 -8
  305. package/dist/overlays/context/context.svelte.d.ts +0 -82
  306. package/dist/overlays/context/context.svelte.js +0 -159
  307. package/dist/overlays/context/index.d.ts +0 -3
  308. package/dist/overlays/context/index.js +0 -3
@@ -10,7 +10,8 @@ import CodeComponent from "./Code.svelte";
10
10
 
11
11
  /**
12
12
  * onBeforeInput hook for CodeBlock:
13
- * - Inside a code block: Backspace on empty → transform back to paragraph.
13
+ * - Inside a code block: Backspace on empty → transform back to paragraph; Backspace at offset 0 of a
14
+ * non-empty one → paragraph too (same text, language dropped, caret stays at 0).
14
15
  * - Inside a non-code text block: ``` + Enter → transform to code block.
15
16
  *
16
17
  * @param {Nabu} nabu @param {InputEvent} event @param {Block} block
@@ -34,6 +35,18 @@ const onBeforeInput = (nabu, event, block) => {
34
35
  });
35
36
  return BREAK;
36
37
  }
38
+ // Backspace at position 0 in a NON-empty code block (collapsed caret) → it becomes a paragraph with the
39
+ // same text (the language is dropped), caret stays at 0. A second Backspace then merges normally.
40
+ if (event.inputType === 'deleteContentBackward' && sel.from === 0 && behavior.text.length > 0) {
41
+ const blockId = block.node.id.toString();
42
+ /** @type {any} */ (block.node.data).delete('language');
43
+ block.transformTo('paragraph');
44
+ tick().then(() => {
45
+ const fresh = nabu.blocks.get(blockId);
46
+ if (fresh) fresh.focus({ start: 0, end: 0 });
47
+ });
48
+ return BREAK;
49
+ }
37
50
  return CONTINUE;
38
51
  }
39
52
 
@@ -55,12 +68,19 @@ const onBeforeInput = (nabu, event, block) => {
55
68
  return CONTINUE;
56
69
  };
57
70
 
71
+ /**
72
+ * The code block: plain monospace text with a language, the ``` shortcut, the `code:block` action and the "Code" slash entry.
73
+ */
58
74
  export const CodeExtension = extension("code", {
59
75
  // @ts-ignore — static-side variance on create() (same pattern as Paragraph/Heading)
60
76
  block: CodeBlock,
61
77
  component: CodeComponent,
78
+ slashCommands: [
79
+ { title: 'Code', icon: '<>', aliases: ['code', 'snippet'], group: 'blocks', order: 0, run: (e) => e.exec('code:block') },
80
+ ],
62
81
  actions: {
63
- 'code': (nabu) => nabu.exec('block:transform', { type: 'code' }),
82
+ // `code` alone is the inline mark of RichTextExtension (like `bold`, `italic`...): the block is `code:block`.
83
+ 'code:block': (nabu) => nabu.exec('block:transform', { type: 'code' }),
64
84
  },
65
85
  hooks: {
66
86
  onBeforeInput,
@@ -1,10 +1,17 @@
1
1
  export class CodeBlock extends TextBlock {
2
+ static placeholder: string;
2
3
  /** @param {import('../../utils/extensions.js').PasteBlock} pb */
3
4
  static toMarkdown(pb: import("../../utils/extensions.js").PasteBlock): string;
4
5
  /** @param {import('../../utils/extensions.js').PasteBlock} pb */
5
6
  static toHtml(pb: import("../../utils/extensions.js").PasteBlock): string;
7
+ /**
8
+ * Fenced code (CommonMark): 3+ backticks or 3+ tildes (up to 3 spaces of indent), an optional info string (the first
9
+ * word is the language), closed by a fence of the SAME character at least as long. An unclosed fence runs to the end.
10
+ * The content is verbatim (no inline parsing, blank lines kept). An indented block (4 spaces) is NOT code.
11
+ */
6
12
  static markdownRules: {
7
13
  priority: number;
14
+ interruptsParagraph: boolean;
8
15
  detect: RegExp;
9
16
  /**
10
17
  * Consume from the opening fence to the closing fence (or EOF).
@@ -28,8 +35,8 @@ export class CodeBlock extends TextBlock {
28
35
  * @returns {import('../../utils/extensions.js').PasteBlock | null}
29
36
  */
30
37
  static fromHTML(el: Element): import("../../utils/extensions.js").PasteBlock | null;
31
- /** @param {Nabu} nabu @param {string} type @param {Object} [props={}] @param {string|null} [parentId=null] @param {number|null} [index=null] */
32
- static create(nabu: Nabu, type: string, props?: Object, parentId?: string | null, index?: number | null): CodeBlock;
38
+ /** @param {Nabu} nabu @param {string} type @param {Record<string, any>} [props={}] @param {string|null} [parentId=null] @param {number|null} [index=null] */
39
+ static create(nabu: Nabu, type: string, props?: Record<string, any>, parentId?: string | null, index?: number | null): CodeBlock;
33
40
  /** @param {Nabu} nabu @param {CodeNode} node */
34
41
  constructor(nabu: Nabu, node: CodeNode);
35
42
  /** @type {string | null} */
@@ -2,6 +2,7 @@ import { TextBlock } from "../text-block.svelte.js";
2
2
  import { LoroText } from "loro-crdt";
3
3
  import CodeComponent from "./Code.svelte";
4
4
  import { tick } from "svelte";
5
+ import { escapeHtml } from "../../utils/html.js";
5
6
 
6
7
  /**
7
8
  * @import { Nabu, NabuNode } from "../nabu.svelte.js";
@@ -20,19 +21,33 @@ function pbText(pb) {
20
21
  return (pb.delta || []).map(op => typeof op.insert === 'string' ? op.insert : '').join('');
21
22
  }
22
23
 
24
+ /** The opening fence of a code block: indent, fence characters, info string. */
25
+ const FENCE_OPEN = /^( {0,3})(`{3,}|~{3,})(.*)$/;
26
+
23
27
  /**
24
- * Escape special HTML characters.
28
+ * Whether `line` closes the fence `open` (same character, at least as long, only spaces after it).
29
+ * @param {string} line
30
+ * @param {string} open
31
+ */
32
+ function isClosingFence(line, open) {
33
+ const m = /^ {0,3}(`+|~+)[ \t]*$/.exec(line);
34
+ return !!m && m[1][0] === open[0] && m[1].length >= open.length;
35
+ }
36
+
37
+ // @ts-ignore — static-side variance on create() (same pattern as Paragraph/Heading)
38
+ /**
39
+ * A fenced code block as markdown. The fence is longer than any run of backticks in the code (a code block that holds a
40
+ * fence round-trips); the info string is the language, without whitespace or backtick (it could not be read back).
41
+ * @param {string | null | undefined} language
25
42
  * @param {string} text
26
43
  * @returns {string}
27
44
  */
28
- function escapeHtml(text) {
29
- return text
30
- .replace(/&/g, '&amp;')
31
- .replace(/</g, '&lt;')
32
- .replace(/>/g, '&gt;');
45
+ function codeToMarkdown(language, text) {
46
+ const longest = Math.max(0, ...(text.match(/`+/g) || []).map((run) => run.length));
47
+ const fence = '`'.repeat(Math.max(3, longest + 1));
48
+ return fence + String(language || '').replace(/[\s`]/g, '') + '\n' + text + '\n' + fence;
33
49
  }
34
50
 
35
- // @ts-ignore — static-side variance on create() (same pattern as Paragraph/Heading)
36
51
  export class CodeBlock extends TextBlock {
37
52
  /** @param {Nabu} nabu @param {CodeNode} node */
38
53
  constructor(nabu, node) {
@@ -40,10 +55,7 @@ export class CodeBlock extends TextBlock {
40
55
 
41
56
  this.language = node.data.get('language') || null;
42
57
 
43
- this.serializers.set('markdown', () => {
44
- const lang = this.language || '';
45
- return '```' + lang + '\n' + this.text + '\n```';
46
- });
58
+ this.serializers.set('markdown', () => codeToMarkdown(this.language, this.text));
47
59
  this.serializers.set('json', () => ({
48
60
  id: this.id,
49
61
  type: 'code',
@@ -67,10 +79,14 @@ export class CodeBlock extends TextBlock {
67
79
  transformsEnabled = false;
68
80
  /** @type {boolean} */
69
81
  marksEnabled = false;
82
+ /** @type {boolean} */
83
+ pastesAsPlainText = true;
70
84
 
71
85
  /** @type {string | null} */
72
86
  language = $state(null);
73
87
 
88
+ static placeholder = 'Code…';
89
+
74
90
  component = $derived(this.nabu.components.get("code") || CodeComponent);
75
91
 
76
92
  /**
@@ -137,8 +153,7 @@ export class CodeBlock extends TextBlock {
137
153
 
138
154
  /** @param {import('../../utils/extensions.js').PasteBlock} pb */
139
155
  static toMarkdown(pb) {
140
- const lang = pb.props?.language || '';
141
- return '```' + lang + '\n' + pbText(pb) + '\n```';
156
+ return codeToMarkdown(pb.props?.language, pbText(pb));
142
157
  }
143
158
 
144
159
  /** @param {import('../../utils/extensions.js').PasteBlock} pb */
@@ -146,10 +161,17 @@ export class CodeBlock extends TextBlock {
146
161
  return `<pre><code>${escapeHtml(pbText(pb))}</code></pre>`;
147
162
  }
148
163
 
164
+ /**
165
+ * Fenced code (CommonMark): 3+ backticks or 3+ tildes (up to 3 spaces of indent), an optional info string (the first
166
+ * word is the language), closed by a fence of the SAME character at least as long. An unclosed fence runs to the end.
167
+ * The content is verbatim (no inline parsing, blank lines kept). An indented block (4 spaces) is NOT code.
168
+ */
149
169
  static markdownRules = [
150
170
  {
151
171
  priority: 30,
152
- detect: /^```/,
172
+ interruptsParagraph: true,
173
+ // A backtick fence has no backtick in its info string (otherwise it is an inline code span: ```a```).
174
+ detect: /^ {0,3}(?:`{3,}[^`]*|~{3,}.*)$/,
153
175
  /**
154
176
  * Consume from the opening fence to the closing fence (or EOF).
155
177
  * @param {string[]} lines
@@ -157,8 +179,10 @@ export class CodeBlock extends TextBlock {
157
179
  * @returns {number}
158
180
  */
159
181
  consume(lines, i) {
182
+ const open = FENCE_OPEN.exec(lines[i]);
183
+ if (!open) return 1;
160
184
  let j = i + 1;
161
- while (j < lines.length && !/^```\s*$/.test(lines[j])) j++;
185
+ while (j < lines.length && !isClosingFence(lines[j], open[2])) j++;
162
186
  return Math.min(lines.length, j + 1) - i;
163
187
  },
164
188
  }
@@ -169,15 +193,15 @@ export class CodeBlock extends TextBlock {
169
193
  * @returns {import('../../utils/extensions.js').PasteBlock | null}
170
194
  */
171
195
  static fromMarkdown(lines) {
172
- const m = lines[0].match(/^```(\w*)/);
173
- if (!m) return null;
174
- const language = m[1] || null;
175
- // Body is everything between first line and the trailing ``` line (if present)
196
+ const open = FENCE_OPEN.exec(lines[0]);
197
+ if (!open) return null;
198
+ const language = open[3].trim().split(/\s+/)[0] || null;
176
199
  let body = lines.slice(1);
177
- // Strip trailing closing fence if present
178
- if (body.length > 0 && /^```\s*$/.test(body[body.length - 1])) {
179
- body = body.slice(0, -1);
180
- }
200
+ // The closing fence is the last line, when it closes this fence (consume stops at the first closer).
201
+ if (body.length > 0 && isClosingFence(body[body.length - 1], open[2])) body = body.slice(0, -1);
202
+ // An indented opening fence removes up to that many spaces from the content lines.
203
+ const indent = open[1].length;
204
+ if (indent) body = body.map((line) => line.replace(new RegExp('^ {0,' + indent + '}'), ''));
181
205
  const bodyText = body.join('\n');
182
206
  // Empty body is still a valid code block
183
207
  if (!bodyText && body.length === 0 && lines.length === 1) return null;
@@ -208,9 +232,9 @@ export class CodeBlock extends TextBlock {
208
232
  };
209
233
  }
210
234
 
211
- /** @param {Nabu} nabu @param {string} type @param {Object} [props={}] @param {string|null} [parentId=null] @param {number|null} [index=null] */
235
+ /** @param {Nabu} nabu @param {string} type @param {Record<string, any>} [props={}] @param {string|null} [parentId=null] @param {number|null} [index=null] */
212
236
  static create(nabu, type, props = {}, parentId = null, index = null) {
213
- const node = nabu.tree.createNode(/** @type {any} */ (parentId || undefined), index || undefined);
237
+ const node = nabu.tree.createNode(/** @type {import('loro-crdt').TreeID | undefined} */ (parentId || undefined), index ?? undefined);
214
238
  /** @type {any} */ (node.data).set('type', 'code');
215
239
  if (props.language) /** @type {any} */ (node.data).set('language', props.language);
216
240
  const container = /** @type {any} */ (node.data).setContainer('text', new LoroText());
@@ -1,3 +1,7 @@
1
+ /**
2
+ * @import { Block } from './block.svelte.js';
3
+ * @import { Nabu } from './nabu.svelte.js';
4
+ */
1
5
  /**
2
6
  * Walks up from `block` toward `container` and returns the direct child of
3
7
  * `container` that is (or contains) `block`.
@@ -38,18 +42,65 @@ export function findLCA(blockA: Block, blockB: Block): Block | null;
38
42
  */
39
43
  export function wrapOrphan(nabu: Nabu, block: Block): Block | undefined;
40
44
  /**
41
- * Shared beforeinput logic for block containers (Nabu root and MegaBlock).
45
+ * The text blocks of the document in document order (a block's own text before its children). With `visible`, the children of
46
+ * a block that hides them are skipped (they are not rendered: no caret, no DOM point).
47
+ * @param {Nabu} nabu
48
+ * @param {{ visible?: boolean }} [options]
49
+ * @returns {Block[]}
50
+ */
51
+ export function textBlocksInOrder(nabu: Nabu, { visible }?: {
52
+ visible?: boolean;
53
+ }): Block[];
54
+ /**
55
+ * The ISOLATION OWNER of a block: its nearest ancestor that isolates its text (`Block#isolatesSelection`), or null. Two text
56
+ * blocks with different owners (the body of a chapter and the body of a scene inside it) never merge by a range deletion.
57
+ * @param {Block} block
58
+ * @returns {Block | null}
59
+ */
60
+ export function isolationOwnerOf(block: Block): Block | null;
61
+ /**
62
+ * Splits a range into the RUNS that a deletion may act on (ADR 018 §3.9): maximal sequences of consecutive text blocks, in
63
+ * document order, that do not contain an isolated block and share one isolation owner. The text of an isolated block is
64
+ * outside every run (a range starting or ending in it starts after it / ends before it), and a run boundary is never merged
65
+ * across. A document without isolated blocks gives a single run, the range itself.
66
+ * @param {Nabu} nabu
67
+ * @param {DeletionRange} range
68
+ * @returns {DeletionRange[] | null} the runs in document order (possibly empty), or null when the range cannot be placed in the document
69
+ */
70
+ export function isolatedRuns(nabu: Nabu, range: DeletionRange): DeletionRange[] | null;
71
+ /**
72
+ * THE one implementation of "delete the selected range across blocks" (cut, Backspace / Delete, typing over a
73
+ * selection, paste over a selection, move by drag). Mutates the Loro tree and texts, never commits.
42
74
  *
43
- * Uses a "spine" approach: for each selection boundary, we walk up the parent
44
- * chain until we hit the container, collecting intermediate blocks to clean up
45
- * along the way. This correctly handles arbitrarily nested structures.
75
+ * A range that crosses ISOLATED text (`Block#isolatesSelection`, e.g. the title of a region) acts on its {@link isolatedRuns}
76
+ * only: the text of an isolated block is never touched, an isolated block and its container are never deleted, and the runs
77
+ * are never merged with one another (each one is deleted like a range of its own, the LAST run first so that the earlier
78
+ * ones are not disturbed). What is left is the first block of every run, emptied: that is where a caret still has a home.
79
+ * Without isolated block in the range it is exactly {@link deleteRangeRaw}.
46
80
  *
47
- * Spine termination differs between the two callers:
48
- * - MegaBlock: the container IS pushed into the spine (loop exits on === container),
49
- * so the direct child of container is at spine.at(-2).
50
- * - Nabu: root blocks have parent = null, so the loop breaks before Nabu is ever
51
- * pushed, and the direct child of container is at spine.at(-1).
52
- * Both cases are unified by the directChild() helper below.
81
+ * @param {Nabu} nabu
82
+ * @param {DeletionRange} range
83
+ * @returns {{ block: Block, offset: number } | null} the junction (where the caret belongs: the start of the first run), or null if the range is unusable or holds no deletable text
84
+ */
85
+ export function deleteRange(nabu: Nabu, range: DeletionRange): {
86
+ block: Block;
87
+ offset: number;
88
+ } | null;
89
+ /**
90
+ * The current selection as a {@link DeletionRange}, or null when there is none.
91
+ * A selection inside one block has `startBlock === endBlock`.
92
+ * @param {Nabu} nabu
93
+ * @returns {DeletionRange | null}
94
+ */
95
+ export function selectionRange(nabu: Nabu): DeletionRange | null;
96
+ /**
97
+ * Shared beforeinput logic for block containers (Nabu root and MegaBlock) when the selection spans SEVERAL
98
+ * blocks (a selection inside one block is that block's business). Backspace / Delete / word deletions delete the
99
+ * range; typing replaces it; Enter replaces it and splits at the junction. All of it is {@link deleteRange}
100
+ * followed by the plain single-block edit at the junction, then ONE commit (one undo step).
101
+ *
102
+ * The `container` (the lowest common ancestor the event was routed to) is not needed any more: the range is
103
+ * resolved from the selection alone, which also makes the same code correct for every depth.
53
104
  *
54
105
  * @param {{ children: Block[], commit: () => void }} container
55
106
  * @param {Nabu} nabu
@@ -60,11 +111,11 @@ export function handleContainerBeforeInput(container: {
60
111
  commit: () => void;
61
112
  }, nabu: Nabu, event: InputEvent): any;
62
113
  /**
63
- * Deletes the current selection content without committing.
64
- * Handles both single-block and multi-block selections.
114
+ * Deletes the current selection content without committing (cut, paste over a selection).
115
+ * Handles both single-block and multi-block selections — see {@link deleteRange}.
65
116
  * Returns the resulting insertion position {block, offset}, or null on failure.
66
117
  *
67
- * @param {{ children: import('./block.svelte.js').Block[] }} container
118
+ * @param {{ children: import('./block.svelte.js').Block[] }} container (unused: the range comes from the selection)
68
119
  * @param {import('./nabu.svelte.js').Nabu} nabu
69
120
  * @returns {{ block: import('./block.svelte.js').Block, offset: number } | null}
70
121
  */
@@ -74,5 +125,26 @@ export function deleteSelectionContent(container: {
74
125
  block: import("./block.svelte.js").Block;
75
126
  offset: number;
76
127
  } | null;
128
+ /**
129
+ * A selected range of the document, as model positions.
130
+ */
131
+ export type DeletionRange = {
132
+ /**
133
+ * Block holding the start of the range (earlier in document order).
134
+ */
135
+ startBlock: Block;
136
+ /**
137
+ * Text offset of the start inside `startBlock`.
138
+ */
139
+ startOffset: number;
140
+ /**
141
+ * Block holding the end of the range.
142
+ */
143
+ endBlock: Block;
144
+ /**
145
+ * Text offset of the end inside `endBlock`.
146
+ */
147
+ endOffset: number;
148
+ };
77
149
  import type { Block } from './block.svelte.js';
78
150
  import type { Nabu } from './nabu.svelte.js';