@whity/ui 0.5.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/README.md +107 -107
  2. package/package.json +221 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +123 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +398 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1686 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +456 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +50 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +90 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -180
  152. package/src/plugin-card.tsx +931 -848
  153. package/src/popover.stories.tsx +48 -48
  154. package/src/popover.tsx +55 -55
  155. package/src/radio-group.stories.tsx +26 -26
  156. package/src/radio-group.tsx +44 -44
  157. package/src/route-flow/editor.tsx +1087 -1014
  158. package/src/route-flow/model.ts +771 -716
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -139
  161. package/src/screen-too-small.stories.tsx +61 -61
  162. package/src/screen-too-small.tsx +104 -104
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -44
  165. package/src/select.tsx +197 -197
  166. package/src/separator.stories.tsx +34 -34
  167. package/src/separator.tsx +34 -34
  168. package/src/sheet.stories.tsx +49 -49
  169. package/src/sheet.tsx +168 -168
  170. package/src/skeleton.stories.tsx +28 -28
  171. package/src/skeleton.tsx +19 -19
  172. package/src/slider.stories.tsx +78 -78
  173. package/src/slider.tsx +300 -300
  174. package/src/spinner.stories.tsx +33 -33
  175. package/src/spinner.tsx +55 -55
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -42
  178. package/src/switch.tsx +41 -41
  179. package/src/switcher.stories.tsx +111 -111
  180. package/src/switcher.tsx +131 -131
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -48
  183. package/src/table.tsx +121 -121
  184. package/src/tabs.stories.tsx +74 -74
  185. package/src/tabs.tsx +90 -90
  186. package/src/tag-input.stories.tsx +67 -67
  187. package/src/tag-input.tsx +117 -117
  188. package/src/tenant-logo.tsx +63 -63
  189. package/src/tenant-switcher.stories.tsx +38 -38
  190. package/src/tenant-switcher.tsx +164 -164
  191. package/src/textarea.stories.tsx +27 -27
  192. package/src/textarea.tsx +18 -18
  193. package/src/theme-mode.ts +52 -52
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -62
  196. package/src/time-picker.tsx +615 -615
  197. package/src/toggle-group.tsx +138 -138
  198. package/src/tooltip.stories.tsx +43 -43
  199. package/src/tooltip.tsx +73 -73
  200. package/src/top-nav.stories.tsx +58 -58
  201. package/src/top-nav.tsx +324 -324
  202. package/src/undo-bar.tsx +107 -107
  203. package/src/utils.ts +45 -45
  204. package/src/view-toggle.stories.tsx +84 -84
  205. package/src/view-toggle.tsx +110 -110
@@ -1,315 +1,368 @@
1
- import { Mark, Node, mergeAttributes } from "@tiptap/core"
2
-
3
- import { richSchemaExtensions } from "./schema-rich"
4
-
5
- /**
6
- * The ProseMirror schema for the WhityDocument contract (contract.ts,
7
- * handoff/editor/README.md). Every block node carries a stable `id` (BlockId)
8
- * and an optional `suggestion` (E.4). Lists are flat items with a `level`
9
- * (Notion style), so drag-and-drop and Turn into stay simple. Blocks the
10
- * editor can't edit yet (later milestones) are kept whole in `unknownBlock`,
11
- * so a document never loses data by passing through the editor.
12
- *
13
- * Headings 1–3 render as h2–h4: the document title is the page's h1.
14
- */
15
-
16
- /** Attributes every block node has. */
17
- const blockAttributes = {
18
- id: { default: null, keepOnSplit: false },
19
- suggestion: { default: null, rendered: false },
20
- }
21
-
22
- function blockAttrs(attrs: Record<string, unknown>, extra: Record<string, unknown> = {}) {
23
- return mergeAttributes({ "data-block-id": attrs.id ?? undefined, ...extra })
24
- }
25
-
26
- export const DocumentNode = Node.create({
27
- name: "doc",
28
- topNode: true,
29
- content: "block+",
30
- })
31
-
32
- export const TextNode = Node.create({
33
- name: "text",
34
- group: "inline",
35
- })
36
-
37
- export const Paragraph = Node.create({
38
- name: "paragraph",
39
- group: "block",
40
- content: "inline*",
41
- priority: 1000,
42
- addAttributes: () => blockAttributes,
43
- parseHTML: () => [{ tag: "p" }],
44
- renderHTML: ({ node }) => ["p", blockAttrs(node.attrs, { "data-type": "paragraph" }), 0],
45
- })
46
-
47
- export const Heading = Node.create({
48
- name: "heading",
49
- group: "block",
50
- content: "inline*",
51
- defining: true,
52
- addAttributes: () => ({ ...blockAttributes, level: { default: 1 } }),
53
- parseHTML: () => [
54
- { tag: "h2", attrs: { level: 1 } },
55
- { tag: "h3", attrs: { level: 2 } },
56
- { tag: "h4", attrs: { level: 3 } },
57
- ],
58
- renderHTML: ({ node }) => [
59
- `h${Number(node.attrs.level) + 1}`,
60
- blockAttrs(node.attrs, { "data-type": "heading", "data-level": node.attrs.level }),
61
- 0,
62
- ],
63
- })
64
-
65
- export const Quote = Node.create({
66
- name: "quote",
67
- group: "block",
68
- content: "inline*",
69
- defining: true,
70
- addAttributes: () => blockAttributes,
71
- parseHTML: () => [{ tag: "blockquote" }],
72
- renderHTML: ({ node }) => ["blockquote", blockAttrs(node.attrs, { "data-type": "quote" }), 0],
73
- })
74
-
75
- export const CodeBlock = Node.create({
76
- name: "codeBlock",
77
- group: "block",
78
- content: "text*",
79
- marks: "",
80
- code: true,
81
- defining: true,
82
- addAttributes: () => ({ ...blockAttributes, language: { default: null } }),
83
- parseHTML: () => [{ tag: "pre", preserveWhitespace: "full" }],
84
- renderHTML: ({ node }) => [
85
- "pre",
86
- blockAttrs(node.attrs, { "data-type": "code", "data-language": node.attrs.language ?? undefined }),
87
- ["code", 0],
88
- ],
89
- })
90
-
91
- /** A bulleted or numbered item; `level` 0–2. Numbering is a decoration (lists.ts). */
92
- export const ListItem = Node.create({
93
- name: "listItem",
94
- group: "block",
95
- content: "inline*",
96
- defining: true,
97
- addAttributes: () => ({ ...blockAttributes, kind: { default: "bullet" }, level: { default: 0 } }),
98
- parseHTML: () => [{ tag: "div[data-type=list-item]" }],
99
- renderHTML: ({ node }) => [
100
- "div",
101
- blockAttrs(node.attrs, { "data-type": "list-item", "data-kind": node.attrs.kind, "data-level": node.attrs.level }),
102
- 0,
103
- ],
104
- })
105
-
106
- /** A checklist item; `level` 0–2. The checkbox is a node view (doc-editor). */
107
- export const CheckItem = Node.create({
108
- name: "checkItem",
109
- group: "block",
110
- content: "inline*",
111
- defining: true,
112
- addAttributes: () => ({ ...blockAttributes, level: { default: 0 }, checked: { default: false } }),
113
- parseHTML: () => [{ tag: "div[data-type=check-item]" }],
114
- renderHTML: ({ node }) => [
115
- "div",
116
- blockAttrs(node.attrs, {
117
- "data-type": "check-item",
118
- "data-level": node.attrs.level,
119
- "data-checked": node.attrs.checked ? "true" : "false",
120
- }),
121
- 0,
122
- ],
123
- })
124
-
125
- export const Divider = Node.create({
126
- name: "divider",
127
- group: "block",
128
- atom: true,
129
- selectable: true,
130
- addAttributes: () => blockAttributes,
131
- parseHTML: () => [{ tag: "hr" }],
132
- renderHTML: ({ node }) => ["hr", blockAttrs(node.attrs, { "data-type": "divider" })],
133
- })
134
-
135
- /** A block a later milestone edits (callout, table, record, plugin…): kept whole, shown as a placeholder. */
136
- export const UnknownBlock = Node.create<{ label: (blockType: string) => string }>({
137
- name: "unknownBlock",
138
- group: "block",
139
- atom: true,
140
- selectable: true,
141
- draggable: false,
142
- addOptions: () => ({ label: (blockType: string) => blockType }),
143
- addAttributes: () => ({ ...blockAttributes, data: { default: null, rendered: false } }),
144
- parseHTML: () => [{ tag: "div[data-type=unknown-block]" }],
145
- renderHTML({ node }) {
146
- const blockType = String(node.attrs.data?.type ?? "")
147
- return [
148
- "div",
149
- blockAttrs(node.attrs, {
150
- "data-type": "unknown-block",
151
- "data-block-type": blockType,
152
- "data-label": this.options.label(blockType),
153
- }),
154
- ]
155
- },
156
- })
157
-
158
- export const HardBreak = Node.create({
159
- name: "hardBreak",
160
- group: "inline",
161
- inline: true,
162
- selectable: false,
163
- parseHTML: () => [{ tag: "br" }],
164
- renderHTML: () => ["br"],
165
- addKeyboardShortcuts() {
166
- return { "Shift-Enter": () => this.editor.commands.insertContent({ type: this.name }) }
167
- },
168
- })
169
-
170
- /** E.26: a merge field, one character for the caret; node-views.tsx draws the chip. */
171
- export const Field = Node.create({
172
- name: "field",
173
- group: "inline",
174
- inline: true,
175
- atom: true,
176
- selectable: true,
177
- addAttributes: () => ({
178
- path: { default: "" },
179
- label: { default: "" },
180
- required: { default: null },
181
- perDocument: { default: null },
182
- }),
183
- parseHTML: () => [{ tag: "span[data-field]" }],
184
- renderHTML: ({ node }) => [
185
- "span",
186
- { "data-field": node.attrs.path, title: node.attrs.path, class: "wy-mf" },
187
- node.attrs.label || node.attrs.path,
188
- ],
189
- })
190
-
191
- /** E.42: an inline formula in TeX. KaTeX renders it in M3; until then it shows its source. */
192
- export const MathInline = Node.create({
193
- name: "mathInline",
194
- group: "inline",
195
- inline: true,
196
- atom: true,
197
- selectable: true,
198
- addAttributes: () => ({ tex: { default: "" } }),
199
- parseHTML: () => [{ tag: "span[data-math]" }],
200
- renderHTML: ({ node }) => ["span", { "data-math": "", dir: "ltr", class: "wy-math" }, node.attrs.tex],
201
- })
202
-
203
- /* --------------------------------------------------------------- Marks */
204
-
205
- const simpleMark = (name: string, tag: string, extra: Record<string, string> = {}) =>
206
- Mark.create({
207
- name,
208
- parseHTML: () => [{ tag }],
209
- renderHTML: () => [tag, extra, 0],
210
- })
211
-
212
- /** Bold renders at 600, never 700 (decision 3.6). */
213
- export const Bold = Mark.create({
214
- name: "bold",
215
- parseHTML: () => [{ tag: "strong" }, { tag: "b" }],
216
- renderHTML: () => ["strong", 0],
217
- })
218
- export const Italic = simpleMark("italic", "em")
219
- export const Underline = simpleMark("underline", "u")
220
- export const Strike = simpleMark("strike", "s")
221
- // Code doesn't exclude other marks: the contract allows bold code, and the
222
- // editor must not drop a mark a document already has.
223
- export const Code = Mark.create({
224
- name: "code",
225
- code: true,
226
- parseHTML: () => [{ tag: "code" }],
227
- renderHTML: () => ["code", 0],
228
- })
229
-
230
- export const Link = Mark.create({
231
- name: "link",
232
- inclusive: false,
233
- addAttributes: () => ({ href: { default: "" }, recordRef: { default: null, rendered: false } }),
234
- parseHTML: () => [{ tag: "a[href]", getAttrs: (el) => ({ href: (el as HTMLElement).getAttribute("href") }) }],
235
- renderHTML: ({ mark }) => ["a", { href: mark.attrs.href, rel: "noopener noreferrer", target: "_blank" }, 0],
236
- })
237
-
238
- /** E.25: one highlight colour. */
239
- export const Highlight = simpleMark("highlight", "mark", { "data-type": "highlight" })
240
-
241
- /* Marks later milestones give a UI (comments M5, suggestions M5, per-document parts M7). */
242
- export const CommentMark = Mark.create({
243
- name: "comment",
244
- inclusive: false,
245
- excludes: "",
246
- addAttributes: () => ({ threadId: { default: "" } }),
247
- parseHTML: () => [{ tag: "span[data-comment]" }],
248
- renderHTML: ({ mark }) => ["span", { "data-comment": mark.attrs.threadId }, 0],
249
- })
250
- // Neither suggestion mark carries on into what is typed next to it: Suggesting
251
- // mode marks new text itself, and Editing must not hide typing inside a mark the draft strips.
252
- export const Insertion = Mark.create({
253
- name: "insertion",
254
- inclusive: false,
255
- excludes: "deletion",
256
- addAttributes: () => ({ suggestionId: { default: "" } }),
257
- parseHTML: () => [{ tag: "ins" }],
258
- renderHTML: ({ mark }) => ["ins", { "data-suggestion": mark.attrs.suggestionId }, 0],
259
- })
260
- export const Deletion = Mark.create({
261
- name: "deletion",
262
- inclusive: false,
263
- excludes: "insertion",
264
- addAttributes: () => ({ suggestionId: { default: "" } }),
265
- parseHTML: () => [{ tag: "del" }],
266
- renderHTML: ({ mark }) => ["del", { "data-suggestion": mark.attrs.suggestionId }, 0],
267
- })
268
- export const PerDocument = Mark.create({
269
- name: "perDocument",
270
- parseHTML: () => [{ tag: "span[data-per-document]" }],
271
- renderHTML: () => ["span", { "data-per-document": "" }, 0],
272
- })
273
-
274
- /** In schema order; the contract's marks come out of the editor in this order. */
275
- export const MARK_ORDER = [
276
- "link",
277
- "bold",
278
- "italic",
279
- "underline",
280
- "strike",
281
- "code",
282
- "highlight",
283
- "comment",
284
- "insertion",
285
- "deletion",
286
- "perDocument",
287
- ] as const
288
-
289
- export const schemaExtensions = [
290
- DocumentNode,
291
- TextNode,
292
- Paragraph,
293
- Heading,
294
- Quote,
295
- CodeBlock,
296
- ListItem,
297
- CheckItem,
298
- Divider,
299
- UnknownBlock,
300
- ...richSchemaExtensions,
301
- HardBreak,
302
- Field,
303
- MathInline,
304
- Link,
305
- Bold,
306
- Italic,
307
- Underline,
308
- Strike,
309
- Code,
310
- Highlight,
311
- CommentMark,
312
- Insertion,
313
- Deletion,
314
- PerDocument,
315
- ]
1
+ import { Mark, Node, mergeAttributes } from "@tiptap/core"
2
+ import { Fragment, Slice, type Node as PmNode } from "@tiptap/pm/model"
3
+ import { Plugin, PluginKey } from "@tiptap/pm/state"
4
+
5
+ import { mintPartKey } from "./saved-parts"
6
+ import { richSchemaExtensions } from "./schema-rich"
7
+
8
+ /**
9
+ * The ProseMirror schema for the WhityDocument contract (contract.ts,
10
+ * handoff/editor/README.md). Every block node carries a stable `id` (BlockId)
11
+ * and an optional `suggestion` (E.4). Lists are flat items with a `level`
12
+ * (Notion style), so drag-and-drop and Turn into stay simple. Blocks the
13
+ * editor can't edit yet (later milestones) are kept whole in `unknownBlock`,
14
+ * so a document never loses data by passing through the editor.
15
+ *
16
+ * Headings 1–3 render as h2–h4: the document title is the page's h1.
17
+ */
18
+
19
+ /** Attributes every block node has. */
20
+ const blockAttributes = {
21
+ id: { default: null, keepOnSplit: false },
22
+ suggestion: { default: null, rendered: false },
23
+ }
24
+
25
+ function blockAttrs(attrs: Record<string, unknown>, extra: Record<string, unknown> = {}) {
26
+ return mergeAttributes({ "data-block-id": attrs.id ?? undefined, ...extra })
27
+ }
28
+
29
+ export const DocumentNode = Node.create({
30
+ name: "doc",
31
+ topNode: true,
32
+ content: "block+",
33
+ })
34
+
35
+ export const TextNode = Node.create({
36
+ name: "text",
37
+ group: "inline",
38
+ })
39
+
40
+ export const Paragraph = Node.create({
41
+ name: "paragraph",
42
+ group: "block",
43
+ content: "inline*",
44
+ priority: 1000,
45
+ addAttributes: () => blockAttributes,
46
+ parseHTML: () => [{ tag: "p" }],
47
+ renderHTML: ({ node }) => ["p", blockAttrs(node.attrs, { "data-type": "paragraph" }), 0],
48
+ })
49
+
50
+ export const Heading = Node.create({
51
+ name: "heading",
52
+ group: "block",
53
+ content: "inline*",
54
+ defining: true,
55
+ addAttributes: () => ({ ...blockAttributes, level: { default: 1 } }),
56
+ parseHTML: () => [
57
+ { tag: "h2", attrs: { level: 1 } },
58
+ { tag: "h3", attrs: { level: 2 } },
59
+ { tag: "h4", attrs: { level: 3 } },
60
+ ],
61
+ renderHTML: ({ node }) => [
62
+ `h${Number(node.attrs.level) + 1}`,
63
+ blockAttrs(node.attrs, { "data-type": "heading", "data-level": node.attrs.level }),
64
+ 0,
65
+ ],
66
+ })
67
+
68
+ export const Quote = Node.create({
69
+ name: "quote",
70
+ group: "block",
71
+ content: "inline*",
72
+ defining: true,
73
+ addAttributes: () => blockAttributes,
74
+ parseHTML: () => [{ tag: "blockquote" }],
75
+ renderHTML: ({ node }) => ["blockquote", blockAttrs(node.attrs, { "data-type": "quote" }), 0],
76
+ })
77
+
78
+ export const CodeBlock = Node.create({
79
+ name: "codeBlock",
80
+ group: "block",
81
+ content: "text*",
82
+ marks: "",
83
+ code: true,
84
+ defining: true,
85
+ addAttributes: () => ({ ...blockAttributes, language: { default: null } }),
86
+ parseHTML: () => [{ tag: "pre", preserveWhitespace: "full" }],
87
+ renderHTML: ({ node }) => [
88
+ "pre",
89
+ blockAttrs(node.attrs, { "data-type": "code", "data-language": node.attrs.language ?? undefined }),
90
+ ["code", 0],
91
+ ],
92
+ })
93
+
94
+ /** A bulleted or numbered item; `level` 0–2. Numbering is a decoration (lists.ts). */
95
+ export const ListItem = Node.create({
96
+ name: "listItem",
97
+ group: "block",
98
+ content: "inline*",
99
+ defining: true,
100
+ addAttributes: () => ({ ...blockAttributes, kind: { default: "bullet" }, level: { default: 0 } }),
101
+ parseHTML: () => [{ tag: "div[data-type=list-item]" }],
102
+ renderHTML: ({ node }) => [
103
+ "div",
104
+ blockAttrs(node.attrs, { "data-type": "list-item", "data-kind": node.attrs.kind, "data-level": node.attrs.level }),
105
+ 0,
106
+ ],
107
+ })
108
+
109
+ /** A checklist item; `level` 0–2. The checkbox is a node view (doc-editor). */
110
+ export const CheckItem = Node.create({
111
+ name: "checkItem",
112
+ group: "block",
113
+ content: "inline*",
114
+ defining: true,
115
+ addAttributes: () => ({ ...blockAttributes, level: { default: 0 }, checked: { default: false } }),
116
+ parseHTML: () => [{ tag: "div[data-type=check-item]" }],
117
+ renderHTML: ({ node }) => [
118
+ "div",
119
+ blockAttrs(node.attrs, {
120
+ "data-type": "check-item",
121
+ "data-level": node.attrs.level,
122
+ "data-checked": node.attrs.checked ? "true" : "false",
123
+ }),
124
+ 0,
125
+ ],
126
+ })
127
+
128
+ export const Divider = Node.create({
129
+ name: "divider",
130
+ group: "block",
131
+ atom: true,
132
+ selectable: true,
133
+ addAttributes: () => blockAttributes,
134
+ parseHTML: () => [{ tag: "hr" }],
135
+ renderHTML: ({ node }) => ["hr", blockAttrs(node.attrs, { "data-type": "divider" })],
136
+ })
137
+
138
+ /** A block a later milestone edits (callout, table, record, plugin…): kept whole, shown as a placeholder. */
139
+ export const UnknownBlock = Node.create<{ label: (blockType: string) => string }>({
140
+ name: "unknownBlock",
141
+ group: "block",
142
+ atom: true,
143
+ selectable: true,
144
+ draggable: false,
145
+ addOptions: () => ({ label: (blockType: string) => blockType }),
146
+ addAttributes: () => ({ ...blockAttributes, data: { default: null, rendered: false } }),
147
+ parseHTML: () => [{ tag: "div[data-type=unknown-block]" }],
148
+ renderHTML({ node }) {
149
+ const blockType = String(node.attrs.data?.type ?? "")
150
+ return [
151
+ "div",
152
+ blockAttrs(node.attrs, {
153
+ "data-type": "unknown-block",
154
+ "data-block-type": blockType,
155
+ "data-label": this.options.label(blockType),
156
+ }),
157
+ ]
158
+ },
159
+ })
160
+
161
+ export const HardBreak = Node.create({
162
+ name: "hardBreak",
163
+ group: "inline",
164
+ inline: true,
165
+ selectable: false,
166
+ parseHTML: () => [{ tag: "br" }],
167
+ renderHTML: () => ["br"],
168
+ addKeyboardShortcuts() {
169
+ return { "Shift-Enter": () => this.editor.commands.insertContent({ type: this.name }) }
170
+ },
171
+ })
172
+
173
+ /** E.26: a merge field, one character for the caret; node-views.tsx draws the chip. */
174
+ export const Field = Node.create({
175
+ name: "field",
176
+ group: "inline",
177
+ inline: true,
178
+ atom: true,
179
+ selectable: true,
180
+ addAttributes: () => ({
181
+ path: { default: "" },
182
+ label: { default: "" },
183
+ required: { default: null },
184
+ perDocument: { default: null },
185
+ }),
186
+ parseHTML: () => [{ tag: "span[data-field]" }],
187
+ renderHTML: ({ node }) => [
188
+ "span",
189
+ { "data-field": node.attrs.path, title: node.attrs.path, class: "wy-mf" },
190
+ node.attrs.label || node.attrs.path,
191
+ ],
192
+ })
193
+
194
+ /** E.42: an inline formula in TeX. KaTeX renders it in M3; until then it shows its source. */
195
+ export const MathInline = Node.create({
196
+ name: "mathInline",
197
+ group: "inline",
198
+ inline: true,
199
+ atom: true,
200
+ selectable: true,
201
+ addAttributes: () => ({ tex: { default: "" } }),
202
+ parseHTML: () => [{ tag: "span[data-math]" }],
203
+ renderHTML: ({ node }) => ["span", { "data-math": "", dir: "ltr", class: "wy-math" }, node.attrs.tex],
204
+ })
205
+
206
+ /* --------------------------------------------------------------- Marks */
207
+
208
+ const simpleMark = (name: string, tag: string, extra: Record<string, string> = {}) =>
209
+ Mark.create({
210
+ name,
211
+ parseHTML: () => [{ tag }],
212
+ renderHTML: () => [tag, extra, 0],
213
+ })
214
+
215
+ /** Bold renders at 600, never 700 (decision 3.6). */
216
+ export const Bold = Mark.create({
217
+ name: "bold",
218
+ parseHTML: () => [{ tag: "strong" }, { tag: "b" }],
219
+ renderHTML: () => ["strong", 0],
220
+ })
221
+ export const Italic = simpleMark("italic", "em")
222
+ export const Underline = simpleMark("underline", "u")
223
+ export const Strike = simpleMark("strike", "s")
224
+ // Code doesn't exclude other marks: the contract allows bold code, and the
225
+ // editor must not drop a mark a document already has.
226
+ export const Code = Mark.create({
227
+ name: "code",
228
+ code: true,
229
+ parseHTML: () => [{ tag: "code" }],
230
+ renderHTML: () => ["code", 0],
231
+ })
232
+
233
+ export const Link = Mark.create({
234
+ name: "link",
235
+ inclusive: false,
236
+ addAttributes: () => ({ href: { default: "" }, recordRef: { default: null, rendered: false } }),
237
+ parseHTML: () => [{ tag: "a[href]", getAttrs: (el) => ({ href: (el as HTMLElement).getAttribute("href") }) }],
238
+ renderHTML: ({ mark }) => ["a", { href: mark.attrs.href, rel: "noopener noreferrer", target: "_blank" }, 0],
239
+ })
240
+
241
+ /** E.25: one highlight colour. */
242
+ export const Highlight = simpleMark("highlight", "mark", { "data-type": "highlight" })
243
+
244
+ /* Marks later milestones give a UI (comments M5, suggestions M5, per-document parts M7). */
245
+ export const CommentMark = Mark.create({
246
+ name: "comment",
247
+ inclusive: false,
248
+ excludes: "",
249
+ addAttributes: () => ({ threadId: { default: "" } }),
250
+ parseHTML: () => [{ tag: "span[data-comment]" }],
251
+ renderHTML: ({ mark }) => ["span", { "data-comment": mark.attrs.threadId }, 0],
252
+ })
253
+ // Neither suggestion mark carries on into what is typed next to it: Suggesting
254
+ // mode marks new text itself, and Editing must not hide typing inside a mark the draft strips.
255
+ export const Insertion = Mark.create({
256
+ name: "insertion",
257
+ inclusive: false,
258
+ excludes: "deletion",
259
+ addAttributes: () => ({ suggestionId: { default: "" } }),
260
+ parseHTML: () => [{ tag: "ins" }],
261
+ renderHTML: ({ mark }) => ["ins", { "data-suggestion": mark.attrs.suggestionId }, 0],
262
+ })
263
+ export const Deletion = Mark.create({
264
+ name: "deletion",
265
+ inclusive: false,
266
+ excludes: "insertion",
267
+ addAttributes: () => ({ suggestionId: { default: "" } }),
268
+ parseHTML: () => [{ tag: "del" }],
269
+ renderHTML: ({ mark }) => ["del", { "data-suggestion": mark.attrs.suggestionId }, 0],
270
+ })
271
+ /**
272
+ * E.23, E.23a: text a document fills itself, in a synced saved block's
273
+ * original. `key` names the part for good: minted when the creator marks it
274
+ * (bubble.tsx), never reused. Adjacent text with different keys is two
275
+ * parts, so the mark doesn't merge across keys.
276
+ *
277
+ * Pasting: in the original (`keep`), a copied part gets a new key (one per
278
+ * key copied), so it is a second part; anywhere else the mark is dropped.
279
+ */
280
+ export const PerDocument = Mark.create<{ keep: boolean }>({
281
+ name: "perDocument",
282
+ addOptions: () => ({ keep: false }),
283
+ addAttributes: () => ({
284
+ key: {
285
+ default: null,
286
+ parseHTML: (el) => el.getAttribute("data-per-document") || null,
287
+ renderHTML: (attrs) => ({ "data-per-document": (attrs.key as string | null) ?? "" }),
288
+ },
289
+ }),
290
+ parseHTML: () => [{ tag: "span[data-per-document]" }],
291
+ renderHTML: ({ HTMLAttributes }) => ["span", HTMLAttributes, 0],
292
+ addProseMirrorPlugins() {
293
+ const keep = this.options.keep
294
+ return [
295
+ new Plugin({
296
+ key: new PluginKey("perDocumentPaste"),
297
+ props: { transformPasted: (slice) => rekeyPasted(slice, keep) },
298
+ }),
299
+ ]
300
+ },
301
+ })
302
+
303
+ export function rekeyPasted(slice: Slice, keep: boolean): Slice {
304
+ const fresh = new Map<string, string>()
305
+ const rekey = (old: unknown) => {
306
+ const name = typeof old === "string" ? old : ""
307
+ if (!fresh.has(name)) fresh.set(name, mintPartKey())
308
+ return fresh.get(name)!
309
+ }
310
+ const walk = (fragment: Fragment): Fragment => {
311
+ const nodes: PmNode[] = []
312
+ fragment.forEach((node) => {
313
+ let next = node
314
+ if (node.content.size) next = next.copy(walk(node.content))
315
+ const marks = node.marks.flatMap((m) => (m.type.name !== "perDocument" ? [m] : keep ? [m.type.create({ key: rekey(m.attrs.key) })] : []))
316
+ if (marks.length !== node.marks.length || node.marks.some((m, i) => m !== marks[i])) next = next.mark(marks)
317
+ if (node.type.name === "field" && node.attrs.perDocument != null) {
318
+ next = next.type.create({ ...next.attrs, perDocument: keep ? rekey(node.attrs.perDocument) : null }, next.content, next.marks)
319
+ }
320
+ nodes.push(next)
321
+ })
322
+ return Fragment.fromArray(nodes)
323
+ }
324
+ return new Slice(walk(slice.content), slice.openStart, slice.openEnd)
325
+ }
326
+
327
+ /** In schema order; the contract's marks come out of the editor in this order. */
328
+ export const MARK_ORDER = [
329
+ "link",
330
+ "bold",
331
+ "italic",
332
+ "underline",
333
+ "strike",
334
+ "code",
335
+ "highlight",
336
+ "comment",
337
+ "insertion",
338
+ "deletion",
339
+ "perDocument",
340
+ ] as const
341
+
342
+ export const schemaExtensions = [
343
+ DocumentNode,
344
+ TextNode,
345
+ Paragraph,
346
+ Heading,
347
+ Quote,
348
+ CodeBlock,
349
+ ListItem,
350
+ CheckItem,
351
+ Divider,
352
+ UnknownBlock,
353
+ ...richSchemaExtensions,
354
+ HardBreak,
355
+ Field,
356
+ MathInline,
357
+ Link,
358
+ Bold,
359
+ Italic,
360
+ Underline,
361
+ Strike,
362
+ Code,
363
+ Highlight,
364
+ CommentMark,
365
+ Insertion,
366
+ Deletion,
367
+ PerDocument,
368
+ ]