@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
package/dist/index.js CHANGED
@@ -1,10 +1,117 @@
1
- // Reexport your entry components here
2
- export { RichTextExtension, TypographyExtension, MarkdownShortcutsExtension, RichText } from './behaviors/text';
3
- export * from './blocks';
4
- export * from "./utils";
5
- export * from './behaviors';
6
- export * from './presets';
7
- export * from './paste';
8
- export * from './overlays/context';
9
- export * from './ui';
10
- export * from './files';
1
+ /**
2
+ * @module @aionbuilders/nabu
3
+ *
4
+ * Using the editor: create one (factories and presets), mount it (`NabuEditor`), pick the built-in extensions, reach its
5
+ * subsystems and use the few serialization helpers an integrator calls.
6
+ *
7
+ * Two companion entry points:
8
+ * - `@aionbuilders/nabu/ui` the optional UI components (toolbar, slash menu, drag handle…);
9
+ * - `@aionbuilders/nabu/extend` writing your own blocks and extensions.
10
+ *
11
+ * Everything not exported here is internal and may change without notice. Region operations (split, merge, move…)
12
+ * are reached through commands: `nabu.exec('region:…')`.
13
+ */
14
+
15
+ // ---------------------------------------------------------------------------
16
+ // Creating an editor
17
+ // ---------------------------------------------------------------------------
18
+
19
+ export {
20
+ createEditor,
21
+ createMinimalEditor,
22
+ createTextEditor,
23
+ createDocumentEditor,
24
+ createFullEditor,
25
+ createPersistedEditor,
26
+ MinimalPreset,
27
+ TextPreset,
28
+ DocumentPreset,
29
+ FullPreset,
30
+ } from './presets.js';
31
+ export { Nabu } from './blocks/nabu.svelte.js';
32
+ export { default as NabuEditor } from './blocks/Nabu.svelte';
33
+
34
+ // ---------------------------------------------------------------------------
35
+ // Built-in extensions (compose your own preset from these)
36
+ // ---------------------------------------------------------------------------
37
+
38
+ export { BlockExtension } from './blocks/block.extension.js';
39
+ export { ParagraphExtension } from './blocks/paragraph/index.js';
40
+ export { HeadingExtension } from './blocks/heading/index.js';
41
+ export { ListExtension, ListItemExtension } from './blocks/list/index.js';
42
+ export { BlockquoteExtension } from './blocks/blockquote/index.js';
43
+ export { DividerExtension } from './blocks/divider/index.js';
44
+ export { CodeExtension } from './blocks/code/index.js';
45
+ export { CalloutExtension } from './blocks/callout/index.js';
46
+ export { ToggleExtension } from './blocks/toggle/index.js';
47
+ export { ImageExtension } from './blocks/image/index.js';
48
+ export { VideoExtension } from './blocks/video/index.js';
49
+ export { FileExtension } from './blocks/file/index.js';
50
+ export { DialogueExtension, createDialogueExtension } from './blocks/dialogue/index.js';
51
+ export { RegionsExtension, createRegionsExtension, DEFAULT_REGION_TYPES, DEFAULT_REGION_MESSAGES } from './blocks/region/index.js';
52
+
53
+ // Text behaviors
54
+ export { RichTextExtension, TypographyExtension, MarkdownShortcutsExtension } from './behaviors/text/index.js';
55
+
56
+ // Paste
57
+ export { PlainTextPasteExtension, NabuPasteExtension, HtmlPasteExtension, MarkdownPasteExtension } from './paste/index.js';
58
+
59
+ // ---------------------------------------------------------------------------
60
+ // Subsystems reached from an editor (`Files.get(nabu)`, `Regions.get(nabu)` or `nabu.regions`, `Todos.get(nabu)`…)
61
+ // ---------------------------------------------------------------------------
62
+
63
+ export { Files, FileRejectedError, MemoryOutbox, REASON_CODES } from './files/index.js';
64
+ export { Regions, Region } from './blocks/region/index.js';
65
+ export { Todos } from './blocks/list/index.js';
66
+
67
+ // Insert media from a File you already hold (drop zone, custom button). From a URL or a picker: `nabu.exec('image:insert' | 'image:pick')`.
68
+ export { insertImageFromFile } from './blocks/image/index.js';
69
+ export { insertMediaFromFile } from './blocks/media/index.js';
70
+
71
+ // Document / clipboard format versions
72
+ export { JSON_FORMAT_VERSION, CLIPBOARD_FORMAT_VERSION, isSupportedJsonVersion } from './utils/extensions.js';
73
+
74
+ // ---------------------------------------------------------------------------
75
+ // Utilities
76
+ // ---------------------------------------------------------------------------
77
+
78
+ export { deltaToMarkdown, deltaToHtml } from './behaviors/text/index.js';
79
+ export { sanitizeUrl } from './utils/html.js';
80
+ export { formatChord } from './utils/keys.js';
81
+
82
+ // ---------------------------------------------------------------------------
83
+ // Types (JSDoc typedefs, importable as `import('@aionbuilders/nabu').NabuInit`…)
84
+ // ---------------------------------------------------------------------------
85
+
86
+ /** @typedef {import('./blocks/nabu.svelte.js').NabuInit} NabuInit The options of an editor: `new Nabu(init)`, the factories and `createPersistedEditor`. */
87
+ /**
88
+ * @typedef {import('./presets.js').EditorOptions} EditorOptions
89
+ * The options of the editor factories (`createEditor` and the preset factories): every `NabuInit` option plus the `preset` to start from.
90
+ */
91
+ /** @typedef {import('./files/files.svelte.js').FilesConfig} FilesConfig The `files` option: uploads, limits, embedding. */
92
+ /** @typedef {import('./files/files.svelte.js').EmbeddedAsset} EmbeddedAsset */
93
+ /** @typedef {import('./utils/placeholders.js').PlaceholdersOption} PlaceholdersOption */
94
+ /** @typedef {import('./utils/placeholders.js').PlaceholdersConfig} PlaceholdersConfig */
95
+ /** @typedef {import('./utils/placeholders.js').PlaceholderText} PlaceholderText */
96
+ /** @typedef {import('./utils/commands.js').CommandDef} CommandDef A command declared by an extension (`commands`). */
97
+ /** @typedef {import('./utils/commands.js').CommandContext} CommandContext */
98
+ /** @typedef {import('./utils/commands.js').CommandConfirm} CommandConfirm */
99
+ /** @typedef {import('./utils/commands.js').CommandInfo} CommandInfo */
100
+ /** @typedef {import('./utils/command-confirm.svelte.js').CommandConfirmOptions} CommandConfirmOptions */
101
+ /** @typedef {import('./utils/command-confirm.svelte.js').ConfirmMessages} ConfirmMessages */
102
+ /** @typedef {import('./blocks/region/types.js').RegionTypeInit} RegionTypeInit Declaration of a region type. */
103
+ /** @typedef {import('./blocks/region/types.js').RegionTypeDef} RegionTypeDef */
104
+ /** @typedef {import('./blocks/region/types.js').RegionsConfig} RegionsConfig */
105
+ /** @typedef {import('./blocks/region/types.js').FieldKind} FieldKind */
106
+ /** @typedef {import('./blocks/region/types.js').FieldSpec} FieldSpec */
107
+ /** @typedef {import('./blocks/region/types.js').Numbering} Numbering */
108
+ /** @typedef {import('./blocks/region/messages.js').RegionMessages} RegionMessages */
109
+ /** @typedef {import('./blocks/region/messages.js').RegionMessageParams} RegionMessageParams */
110
+ /** @typedef {import('./blocks/region/messages.js').RegionNameParams} RegionNameParams */
111
+ /** @typedef {import('./blocks/region/messages.js').RegionTypeParams} RegionTypeParams */
112
+ /** @typedef {import('./persistence/history.js').HistoryConfig} HistoryConfig */
113
+ /** @typedef {import('./persistence/history.js').CompactOptions} CompactOptions */
114
+ /** @typedef {import('./persistence/compact.js').CompactResult} CompactResult */
115
+ /** @typedef {import('./persistence/recovery.js').Recovery} Recovery */
116
+ /** @typedef {import('./utils/keys.js').Chord} Chord */
117
+ /** @typedef {import('./utils/keys.js').Platform} Platform */
@@ -3,6 +3,14 @@
3
3
  * State-of-the-art Semantic Design Tokens for UI Modularity
4
4
  */
5
5
 
6
+ /*
7
+ * Layout variables that are NOT defined here (their default lives next to the rule that reads them; set them on any ancestor
8
+ * of the editor):
9
+ * --nb-paragraph-indent first-line indent of paragraphs (the "alinéa"), default 0, e.g. 1.5em. Applied as `text-indent`
10
+ * to every paragraph EXCEPT the first block of the document / of a region / of a container, and
11
+ * the paragraph right after a heading or a divider (typographic rule: no indent there).
12
+ */
13
+
6
14
  :root, [data-nabu-theme="light"] {
7
15
  /* UI Backgrounds */
8
16
  --nb-bg-surface: hsla(0, 0%, 100%, 0.85); /* Light glass */
@@ -18,7 +26,7 @@
18
26
  /* Text Colors */
19
27
  --nb-text-primary: hsla(0, 0%, 0%, 0.9);
20
28
  --nb-text-secondary: hsla(0, 0%, 0%, 0.6);
21
- --nb-text-muted: hsla(0, 0%, 0%, 0.4);
29
+ --nb-text-muted: hsla(0, 0%, 0%, 0.5); /* >= 3:1 on white (non-text glyphs such as the drag handle) */
22
30
 
23
31
  /* Accent & Status Colors */
24
32
  --nb-accent: hsla(210, 100%, 50%, 0.2);
@@ -26,6 +34,10 @@
26
34
  --nb-success-bg: hsla(150, 100%, 40%, 0.15);
27
35
  --nb-warning: rgba(245, 158, 11, 0.4);
28
36
  --nb-danger: rgba(239, 68, 68, 0.4);
37
+ --nb-region-warning: #b45309; /* region seam: tint of a pending merge (4.9:1 on white) */
38
+ --nb-region-rail: #4F46E5; /* region seam: margin rail of the region holding the caret (indigo 600, 6.3:1 on white) */
39
+ --nb-link: #0b57d0; /* links: 6.4:1 on white, 6.1:1 on #fafafa (WCAG AA text needs 4.5:1; the old #4d9fff was 2.7:1) */
40
+ --nb-focus-ring: #0b57d0; /* focus indicator of the editor (:focus-visible): 6.4:1 on white (non-text needs 3:1) */
29
41
 
30
42
  /* Shadows */
31
43
  --nb-shadow-lg: 0 16px 32px -12px rgba(0,0,0,0.15);
@@ -58,6 +70,10 @@
58
70
  --nb-success-bg: hsla(150, 100%, 60%, 0.15);
59
71
  --nb-warning: rgba(245, 158, 11, 0.4);
60
72
  --nb-danger: rgba(239, 68, 68, 0.4);
73
+ --nb-region-warning: #f59e0b; /* amber 500: 8:1 on a dark page (the light #b45309 is 3.7:1) */
74
+ --nb-region-rail: #818CF8; /* indigo 400: 6.4:1 on a dark page (the light #4F46E5 is about 3:1) */
75
+ --nb-link: #8ab4f8; /* 9.9:1 on #000, 7.9:1 on #1e1e1e, 6.7:1 on #2b2b2b (the light #0b57d0 is 2.6:1 on #1e1e1e) */
76
+ --nb-focus-ring: #8ab4f8; /* same colour: 7.9:1 on #1e1e1e */
61
77
 
62
78
  --nb-shadow-lg: 0 16px 32px -12px rgba(0,0,0,0.5);
63
79
  --nb-shadow-inset: inset 0 2px 4px rgba(0,0,0,0.2);
@@ -85,6 +101,10 @@
85
101
  --nb-success-bg: hsla(150, 100%, 60%, 0.15);
86
102
  --nb-warning: rgba(245, 158, 11, 0.4);
87
103
  --nb-danger: rgba(239, 68, 68, 0.4);
104
+ --nb-region-warning: #f59e0b;
105
+ --nb-region-rail: #818CF8;
106
+ --nb-link: #8ab4f8;
107
+ --nb-focus-ring: #8ab4f8;
88
108
 
89
109
  --nb-shadow-lg: 0 16px 32px -12px rgba(0,0,0,0.5);
90
110
  --nb-shadow-inset: inset 0 2px 4px rgba(0,0,0,0.2);
@@ -1,12 +1,83 @@
1
+ /**
2
+ * Parse the `style` attribute of an element into `{ property: value }` (lower-cased, `!important` removed, the last
3
+ * declaration of a property wins). Reads the attribute itself rather than the CSSOM so that `mso-*` / vendor
4
+ * properties can never be mistaken for the standard property they look like, whatever the DOM implementation.
5
+ * @param {Element} el
6
+ * @returns {Readonly<Record<string, string>>}
7
+ */
8
+ export function parseStyle(el: Element): Readonly<Record<string, string>>;
9
+ /**
10
+ * Unwrap a Google redirect link (`https://www.google.com/url?q=<target>&sa=D&…`, also `&url=`) to its target.
11
+ * Returns `null` when `href` is not such a link, or when its target is missing, relative, malformed or unsafe.
12
+ * @param {string} href
13
+ * @returns {string | null}
14
+ */
15
+ export function unwrapGoogleRedirect(href: string): string | null;
16
+ /**
17
+ * The href a pasted link gets: a Google redirect is unwrapped to its (sanitized) target; otherwise the href itself when
18
+ * `sanitizeUrl` accepts it; `null` when unsafe (the text is kept, just not as a link).
19
+ * @param {string | null} href
20
+ * @returns {string | null}
21
+ */
22
+ export function resolveLinkHref(href: string | null): string | null;
1
23
  /**
2
24
  * Parse the inline content of a DOM element into a Loro-compatible delta array.
3
- * Recurses into inline and unknown elements, inheriting marks.
4
- * Skips block-level children (ul, ol, table…) — those are handled by fromHTML.
25
+ * Recurses into inline and unknown elements, inheriting marks; the inline style of an element has the last word over
26
+ * its tag; skips block-level children (ul, ol, table…) — those are handled by fromHTML. Whitespace follows the rules of
27
+ * {@link buildDelta}.
5
28
  *
6
29
  * @param {Element} el
7
30
  * @param {Record<string, true>} [marks]
31
+ * @param {{ keepEdges?: boolean }} [options]
8
32
  * @returns {import('loro-crdt').Delta<string>[]}
9
33
  */
10
- export function parseInline(el: Element, marks?: Record<string, true>): import("loro-crdt").Delta<string>[];
34
+ export function parseInline(el: Element, marks?: Record<string, true>, options?: {
35
+ keepEdges?: boolean;
36
+ }): import("loro-crdt").Delta<string>[];
37
+ /**
38
+ * Paste of `text/html` (web pages, Google Docs, Word, spreadsheets): turns the markup into blocks through the rules the registered block classes declare (`htmlRules`).
39
+ */
11
40
  export const HtmlPasteExtension: Extension;
41
+ export type TextToken = {
42
+ s: string;
43
+ marks: Record<string, any>;
44
+ /**
45
+ * spaces are significant (`white-space: pre | pre-wrap | break-spaces`)
46
+ */
47
+ preserve: boolean;
48
+ /**
49
+ * inside a `<pre>`: not even NBSP is touched
50
+ */
51
+ verbatim: boolean;
52
+ };
53
+ /**
54
+ * `br`: a `<br>`; `brk`: a block boundary met inside inline content
55
+ */
56
+ export type Token = TextToken | {
57
+ br: true;
58
+ } | {
59
+ brk: true;
60
+ };
61
+ export type Piece = {
62
+ el: Element;
63
+ } | {
64
+ embed: Element;
65
+ };
66
+ /**
67
+ * one character of the flattened inline content
68
+ */
69
+ export type Cell = {
70
+ c: string;
71
+ /**
72
+ * null for a line break
73
+ */
74
+ marks: Record<string, any> | null;
75
+ preserve: boolean;
76
+ verbatim: boolean;
77
+ brk: "br" | "brk" | null;
78
+ /**
79
+ * a space that came out of HTML whitespace collapsing (and may still be trimmed)
80
+ */
81
+ collapsible?: boolean | undefined;
82
+ };
12
83
  import { Extension } from '../utils/extensions.js';