@whity/ui 0.0.0-stage → 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 +106 -2
  2. package/package.json +219 -4
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +338 -0
  6. package/src/actor-chip.tsx +71 -0
  7. package/src/agent-activity.tsx +163 -0
  8. package/src/agent-collaboration.stories.tsx +156 -0
  9. package/src/agent-run-status.tsx +196 -0
  10. package/src/alert-dialog.stories.tsx +45 -0
  11. package/src/alert-dialog.tsx +147 -0
  12. package/src/alert.stories.tsx +91 -0
  13. package/src/alert.tsx +89 -0
  14. package/src/app-sidebar.stories.tsx +195 -0
  15. package/src/app-sidebar.tsx +604 -0
  16. package/src/approval-queue.tsx +109 -0
  17. package/src/audience-group-picker.stories.tsx +198 -0
  18. package/src/audience-group-picker.tsx +362 -0
  19. package/src/audience-people-picker.stories.tsx +102 -0
  20. package/src/audience-people-picker.tsx +279 -0
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -0
  23. package/src/badge.stories.tsx +105 -0
  24. package/src/badge.tsx +68 -0
  25. package/src/beta-warning.stories.tsx +79 -0
  26. package/src/beta-warning.tsx +189 -0
  27. package/src/bilingual-input.stories.tsx +82 -0
  28. package/src/bilingual-input.tsx +188 -0
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -0
  31. package/src/breadcrumb.tsx +90 -0
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -0
  34. package/src/button.tsx +123 -0
  35. package/src/card.stories.tsx +423 -0
  36. package/src/card.tsx +180 -0
  37. package/src/chart.stories.tsx +66 -0
  38. package/src/chart.tsx +228 -0
  39. package/src/checkbox.stories.tsx +62 -0
  40. package/src/checkbox.tsx +54 -0
  41. package/src/collapsible.stories.tsx +48 -0
  42. package/src/collapsible.tsx +34 -0
  43. package/src/color-card.stories.tsx +61 -0
  44. package/src/color-card.tsx +270 -0
  45. package/src/color-picker.stories.tsx +65 -0
  46. package/src/color-picker.tsx +425 -0
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +398 -0
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -0
  51. package/src/copy-block.tsx +85 -0
  52. package/src/data-table.stories.tsx +200 -0
  53. package/src/data-table.tsx +1686 -0
  54. package/src/date-picker.stories.tsx +61 -0
  55. package/src/date-picker.tsx +456 -0
  56. package/src/design-cards.stories.tsx +551 -0
  57. package/src/dialog.stories.tsx +48 -0
  58. package/src/dialog.tsx +179 -0
  59. package/src/display-preferences.tsx +50 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -0
  61. package/src/documents/barcode-svg.tsx +79 -0
  62. package/src/dropdown-menu.stories.tsx +77 -0
  63. package/src/dropdown-menu.tsx +271 -0
  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 -0
  68. package/src/editor/block-ids.ts +44 -0
  69. package/src/editor/block-list.tsx +104 -0
  70. package/src/editor/block-toolbar.tsx +490 -0
  71. package/src/editor/bubble.tsx +119 -0
  72. package/src/editor/catalogue.ts +169 -0
  73. package/src/editor/collab-rail.tsx +746 -0
  74. package/src/editor/collab.stories.tsx +207 -0
  75. package/src/editor/collab.ts +87 -0
  76. package/src/editor/contract.ts +476 -0
  77. package/src/editor/convert.ts +414 -0
  78. package/src/editor/doc-editor.stories.tsx +98 -0
  79. package/src/editor/doc-editor.tsx +1492 -0
  80. package/src/editor/editor.css +636 -0
  81. package/src/editor/extensions.ts +86 -0
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -0
  84. package/src/editor/fields.ts +100 -0
  85. package/src/editor/gutter.tsx +443 -0
  86. package/src/editor/index.ts +23 -0
  87. package/src/editor/label-sheet.tsx +289 -0
  88. package/src/editor/labels.ts +394 -0
  89. package/src/editor/link-tools.tsx +141 -0
  90. package/src/editor/node-views.tsx +461 -0
  91. package/src/editor/page-view.tsx +372 -0
  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 -0
  97. package/src/editor/rich-blocks.stories.tsx +146 -0
  98. package/src/editor/sample.ts +40 -0
  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 -0
  104. package/src/editor/schema.ts +368 -0
  105. package/src/editor/services.tsx +205 -0
  106. package/src/editor/slash.ts +64 -0
  107. package/src/editor/suggesting.ts +372 -0
  108. package/src/editor/suggestions.ts +763 -0
  109. package/src/editor/table-keys.ts +66 -0
  110. package/src/editor/templates.stories.tsx +324 -0
  111. package/src/editor/toolbar.tsx +364 -0
  112. package/src/empty-state.stories.tsx +51 -0
  113. package/src/empty-state.tsx +126 -0
  114. package/src/empty-state.usage-notes.md +30 -0
  115. package/src/form.stories.tsx +112 -0
  116. package/src/form.tsx +176 -0
  117. package/src/globals.css +20 -0
  118. package/src/icon-button.tsx +85 -0
  119. package/src/icon-map.ts +335 -0
  120. package/src/icon.tsx +41 -0
  121. package/src/index.ts +90 -0
  122. package/src/input.stories.tsx +157 -0
  123. package/src/input.tsx +768 -0
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -0
  127. package/src/locked-screen.tsx +75 -0
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -0
  131. package/src/math-text.stories.tsx +33 -0
  132. package/src/math-text.tsx +43 -0
  133. package/src/menu-bar.stories.tsx +198 -0
  134. package/src/menu-bar.tsx +373 -0
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -0
  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 -0
  142. package/src/page-header.tsx +122 -0
  143. package/src/page-shell.stories.tsx +42 -0
  144. package/src/page-shell.tsx +32 -0
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -0
  147. package/src/pagination.tsx +98 -0
  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 -0
  152. package/src/plugin-card.tsx +931 -0
  153. package/src/popover.stories.tsx +48 -0
  154. package/src/popover.tsx +55 -0
  155. package/src/radio-group.stories.tsx +26 -0
  156. package/src/radio-group.tsx +44 -0
  157. package/src/route-flow/editor.tsx +1087 -0
  158. package/src/route-flow/model.ts +771 -0
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -0
  161. package/src/screen-too-small.stories.tsx +61 -0
  162. package/src/screen-too-small.tsx +104 -0
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -0
  165. package/src/select.tsx +197 -0
  166. package/src/separator.stories.tsx +34 -0
  167. package/src/separator.tsx +34 -0
  168. package/src/sheet.stories.tsx +49 -0
  169. package/src/sheet.tsx +168 -0
  170. package/src/skeleton.stories.tsx +28 -0
  171. package/src/skeleton.tsx +19 -0
  172. package/src/slider.stories.tsx +78 -0
  173. package/src/slider.tsx +300 -0
  174. package/src/spinner.stories.tsx +33 -0
  175. package/src/spinner.tsx +55 -0
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -0
  178. package/src/switch.tsx +41 -0
  179. package/src/switcher.stories.tsx +111 -0
  180. package/src/switcher.tsx +131 -0
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -0
  183. package/src/table.tsx +121 -0
  184. package/src/tabs.stories.tsx +74 -0
  185. package/src/tabs.tsx +90 -0
  186. package/src/tag-input.stories.tsx +67 -0
  187. package/src/tag-input.tsx +117 -0
  188. package/src/tenant-logo.tsx +63 -0
  189. package/src/tenant-switcher.stories.tsx +38 -0
  190. package/src/tenant-switcher.tsx +164 -0
  191. package/src/textarea.stories.tsx +27 -0
  192. package/src/textarea.tsx +18 -0
  193. package/src/theme-mode.ts +52 -0
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -0
  196. package/src/time-picker.tsx +615 -0
  197. package/src/toggle-group.tsx +138 -0
  198. package/src/tooltip.stories.tsx +43 -0
  199. package/src/tooltip.tsx +73 -0
  200. package/src/top-nav.stories.tsx +58 -0
  201. package/src/top-nav.tsx +324 -0
  202. package/src/undo-bar.tsx +107 -0
  203. package/src/utils.ts +45 -0
  204. package/src/view-toggle.stories.tsx +84 -0
  205. package/src/view-toggle.tsx +110 -0
@@ -0,0 +1,146 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import * as React from "react"
3
+
4
+ import type { Block, EditorMode, WhityDocument } from "./contract"
5
+ import { DocEditor } from "./doc-editor"
6
+ import { SAMPLE_DOCUMENT } from "./sample"
7
+ import type { EditorServices } from "./services"
8
+
9
+ const meta = {
10
+ title: "Editor/Rich blocks",
11
+ parameters: { layout: "fullscreen", fullBleed: true },
12
+ } satisfies Meta
13
+
14
+ export default meta
15
+ type Story = StoryObj<typeof meta>
16
+
17
+ const t = (text: string) => ({ type: "text" as const, text })
18
+ const wait = <T,>(value: T, ms = 400) => new Promise<T>((done) => setTimeout(() => done(value), ms))
19
+
20
+ /** Stand-ins for the server: Example Bakery's invoices and a monthly chart. */
21
+ const SERVICES: EditorServices = {
22
+ recordTypes: [
23
+ { key: "invoice", label: "Invoice" },
24
+ { key: "document", label: "Issued document" },
25
+ ],
26
+ chartSources: [
27
+ { key: "documents-by-month", label: "Documents issued per month" },
28
+ { key: "revenue-by-month", label: "Revenue per month" },
29
+ ],
30
+ resolveRecord: (ref) =>
31
+ wait(
32
+ ref.id === "INV-1042"
33
+ ? { typeLabel: "Invoice", title: "INV-1042 · Example Clinic", subtitle: "Due 14 Oct 2026", amount: "$301.60", status: { label: "Overdue", tone: "warning" as const } }
34
+ : ref.id === "INV-0001"
35
+ ? null
36
+ : { typeLabel: "Invoice", title: `${ref.id} · Example Bakery`, amount: "$96.00", status: { label: "Paid", tone: "success" as const } }
37
+ ),
38
+ loadChart: (source) =>
39
+ wait(
40
+ source.query === "empty"
41
+ ? { points: [] }
42
+ : {
43
+ valueLabel: source.query === "revenue-by-month" ? "USD" : "Documents",
44
+ subtitle: "Last 6 months",
45
+ points: [
46
+ { label: "May", value: 18 },
47
+ { label: "Jun", value: 24 },
48
+ { label: "Jul", value: 21 },
49
+ { label: "Aug", value: 30 },
50
+ { label: "Sep", value: 27 },
51
+ { label: "Oct", value: 35 },
52
+ ],
53
+ }
54
+ ),
55
+ uploadFile: (file) => wait({ fileId: String(Date.now()), url: URL.createObjectURL(file), name: file.name, size: file.size, mime: file.type }, 700),
56
+ fileUrl: () => "#",
57
+ }
58
+
59
+ const BLOCKS: Block[] = [
60
+ { id: "r1", type: "paragraph", content: [t("Every M3 block, with stand-in data. Click a block to see its toolbar.")] },
61
+ { id: "r2", type: "callout", kind: "note", content: [t("Payment is due within 30 days of the invoice date.")] },
62
+ { id: "r3", type: "callout", kind: "important", content: [t("Late payments add 2% a month.")] },
63
+ {
64
+ id: "r4",
65
+ type: "toggle",
66
+ open: true,
67
+ summary: [t("How do I pay by card?")],
68
+ children: [{ id: "r4a", type: "paragraph", content: [t("Open the link in the invoice email and follow the steps.")] }],
69
+ },
70
+ {
71
+ id: "r5",
72
+ type: "columns",
73
+ columns: [
74
+ [{ id: "r5a", type: "paragraph", content: [t("Example Bakery, 12 Rainbow Street, Amman")] }],
75
+ [{ id: "r5b", type: "paragraph", content: [t("Example Clinic, 4 Garden Road, Irbid")] }],
76
+ ],
77
+ },
78
+ {
79
+ id: "r6",
80
+ type: "table",
81
+ headerRow: true,
82
+ columns: [{ align: "start" }, { align: "start" }, { align: "end" }],
83
+ rows: [
84
+ [[t("Invoice")], [t("Customer")], [t("Amount")]],
85
+ [[t("INV-1042")], [t("Example Clinic")], [t("$301.60")]],
86
+ [[t("INV-1051")], [t("Example Café")], [t("$96.00")]],
87
+ ],
88
+ },
89
+ { id: "r7", type: "image", src: "", alt: "", width: "wide" },
90
+ { id: "r8", type: "file", fileId: "f1", name: "price-list-2026.pdf", size: 248_320, mime: "application/pdf" },
91
+ { id: "r9", type: "record", ref: { type: "invoice", id: "INV-1042" }, view: "card" },
92
+ { id: "r10", type: "record", ref: { type: "invoice", id: "INV-1051" }, view: "summary" },
93
+ { id: "r11", type: "record", ref: { type: "invoice", id: "INV-0001" }, view: "card" },
94
+ { id: "r12", type: "chart", chart: "bar", source: { query: "documents-by-month" }, title: "Documents issued per month" },
95
+ { id: "r13", type: "chart", chart: "line", source: { query: "revenue-by-month" }, title: "Revenue per month" },
96
+ { id: "r13b", type: "chart", chart: "donut", source: { query: "documents-by-month" }, title: "Documents by month" },
97
+ {
98
+ id: "r14",
99
+ type: "signature",
100
+ signers: [
101
+ { name: [t("Lina Haddad")], role: [t("Finance manager")] },
102
+ { name: [t("Omar Saleh")], role: [t("Owner")] },
103
+ ],
104
+ date: [t("29 Oct 2026")],
105
+ stamp: true,
106
+ },
107
+ { id: "r15", type: "barcode", symbology: "code128", value: [t("INV-1042")], showText: true },
108
+ { id: "r16", type: "qr", value: [t("https://example.com/pay/INV-1042")], caption: [t("Scan to pay")] },
109
+ { id: "r17", type: "math", tex: "\\text{Total} = \\sum_{i=1}^{n} q_i \\times p_i" },
110
+ { id: "r18", type: "pageBreak" },
111
+ { id: "r19", type: "paragraph", content: [t("After the page break.")] },
112
+ ]
113
+
114
+ function Live({ initial, canEdit = true, services = SERVICES }: { initial: WhityDocument; canEdit?: boolean; services?: EditorServices }) {
115
+ const [doc, setDoc] = React.useState(initial)
116
+ const [mode, setMode] = React.useState<EditorMode>("editing")
117
+ return (
118
+ <div style={{ height: "100vh" }}>
119
+ <DocEditor
120
+ document={doc}
121
+ onChange={setDoc}
122
+ canEdit={canEdit}
123
+ mode={mode}
124
+ onModeChange={setMode}
125
+ back={{ label: "Back to notes", onClick: () => {} }}
126
+ path="Notes · Billing"
127
+ save={{ state: "saved", at: "14:02" }}
128
+ services={services}
129
+ />
130
+ </div>
131
+ )
132
+ }
133
+
134
+ const DOC: WhityDocument = { ...SAMPLE_DOCUMENT, title: "Rich blocks", blocks: BLOCKS }
135
+
136
+ export const AllBlocks: Story = { render: () => <Live initial={DOC} /> }
137
+
138
+ export const ReadOnly: Story = { render: () => <Live initial={DOC} canEdit={false} /> }
139
+
140
+ /** No services: records and charts say what is missing instead of loading. */
141
+ export const NoServices: Story = { render: () => <Live initial={DOC} services={{}} /> }
142
+
143
+ export const Arabic: Story = {
144
+ globals: { direction: "rtl" },
145
+ render: () => <Live initial={{ ...DOC, lang: "ar", title: "الكتل الغنية" }} />,
146
+ }
@@ -0,0 +1,40 @@
1
+ import type { WhityDocument } from "./contract"
2
+
3
+ const t = (text: string) => ({ type: "text" as const, text })
4
+
5
+ /** Example data for stories and tests: Example Bakery, fictional (CLAUDE.md). */
6
+ export const SAMPLE_DOCUMENT: WhityDocument = {
7
+ id: "doc-payment-reminder",
8
+ kind: "note",
9
+ title: "Payment reminder",
10
+ lang: "en",
11
+ defaultView: "continuous",
12
+ blocks: [
13
+ { id: "b1", type: "paragraph", content: [t("Dear Example Clinic,")] },
14
+ {
15
+ id: "b2",
16
+ type: "paragraph",
17
+ content: [
18
+ t("Invoice INV-1042 for $301.60 was due on 14 Oct 2026. "),
19
+ { type: "text", text: "Please pay within 14 days", marks: [{ type: "bold" }] },
20
+ t(" of this letter, by bank transfer or "),
21
+ { type: "text", text: "online", marks: [{ type: "link", href: "https://example.jo/pay/INV-1042" }] },
22
+ t("."),
23
+ ],
24
+ },
25
+ { id: "b3", type: "heading", level: 1, content: [t("Open invoices")] },
26
+ { id: "b4", type: "bullet", level: 0, content: [t("INV-1042, due 14 Oct 2026, $301.60")] },
27
+ { id: "b5", type: "bullet", level: 0, content: [t("INV-1051, due 21 Oct 2026, $96.00")] },
28
+ { id: "b6", type: "heading", level: 2, content: [t("Before you send it")] },
29
+ { id: "b7", type: "checklist", level: 0, checked: true, content: [t("Check the amounts against the statement")] },
30
+ { id: "b8", type: "checklist", level: 0, checked: false, content: [t("Ask Rana to approve the wording")] },
31
+ { id: "b9", type: "quote", content: [t("If you have already paid, thank you, and please ignore this letter.")] },
32
+ { id: "b10", type: "paragraph", content: [t("Kind regards,")] },
33
+ { id: "b11", type: "paragraph", content: [t("Rana Haddad"), { type: "break" }, t("Example Bakery")] },
34
+ ],
35
+ comments: [],
36
+ suggestions: [],
37
+ status: "draft",
38
+ updatedAt: "2026-10-29T14:02:00Z",
39
+ updatedBy: { kind: "person", id: "u-rana", name: "Rana Haddad" },
40
+ }
@@ -0,0 +1,141 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { Button } from "../button"
6
+ import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from "../dialog"
7
+ import { Input } from "../input"
8
+ import { RadioGroup, RadioGroupItem } from "../radio-group"
9
+ import { fill, type EditorLabels } from "./labels"
10
+
11
+ export interface SaveBlockChoice {
12
+ name: string
13
+ mode: "synced" | "copy"
14
+ sharing: "me" | "workspace"
15
+ }
16
+
17
+ /**
18
+ * Save as block (EditorCustomBlocks card; E.21, E.22): a name, Synced or
19
+ * Copy, and Only me or Everyone in the workspace. Everyone is offered only to
20
+ * people who manage the workspace library. Synced is the default: editing it
21
+ * once updates every document that uses it, and a published template picks
22
+ * the change up at its next publish (E.38).
23
+ */
24
+ function SaveBlockDialog({
25
+ open,
26
+ onOpenChange,
27
+ blockCount,
28
+ canShare,
29
+ onSave,
30
+ labels,
31
+ }: {
32
+ open: boolean
33
+ onOpenChange: (open: boolean) => void
34
+ /** How many blocks are selected, for "Saves 3 blocks as one". */
35
+ blockCount: number
36
+ /** Whether "Everyone in the workspace" is offered (E.22). */
37
+ canShare: boolean
38
+ onSave: (choice: SaveBlockChoice) => Promise<void>
39
+ labels: EditorLabels
40
+ }) {
41
+ const [name, setName] = React.useState("")
42
+ const [mode, setMode] = React.useState<SaveBlockChoice["mode"]>("synced")
43
+ const [sharing, setSharing] = React.useState<SaveBlockChoice["sharing"]>("me")
44
+ const [busy, setBusy] = React.useState(false)
45
+ const [failed, setFailed] = React.useState(false)
46
+ const nameId = React.useId()
47
+
48
+ React.useEffect(() => {
49
+ if (!open) return
50
+ setName("")
51
+ setMode("synced")
52
+ setSharing("me")
53
+ setFailed(false)
54
+ }, [open])
55
+
56
+ const save = async () => {
57
+ const trimmed = name.trim()
58
+ if (!trimmed || busy) return
59
+ setBusy(true)
60
+ setFailed(false)
61
+ try {
62
+ await onSave({ name: trimmed, mode, sharing: canShare ? sharing : "me" })
63
+ onOpenChange(false)
64
+ } catch {
65
+ setFailed(true)
66
+ } finally {
67
+ setBusy(false)
68
+ }
69
+ }
70
+
71
+ const option = (value: string, title: string, hint: string, group: string) => (
72
+ <label className="flex cursor-pointer items-start gap-2.5 rounded-control-lg border border-border px-3 py-2.5 text-sm has-[[data-state=checked]]:border-primary">
73
+ <RadioGroupItem value={value} id={`${group}-${value}`} className="mt-0.5" />
74
+ <span className="grid gap-0.5">
75
+ <span className="font-medium">{title}</span>
76
+ <span className="text-xs text-muted-foreground">{hint}</span>
77
+ </span>
78
+ </label>
79
+ )
80
+
81
+ return (
82
+ <Dialog open={open} onOpenChange={onOpenChange}>
83
+ <DialogContent className="max-w-[440px]" closeLabel={labels.saveBlockCancel}>
84
+ <form
85
+ className="grid gap-4"
86
+ onSubmit={(e) => {
87
+ e.preventDefault()
88
+ void save()
89
+ }}
90
+ >
91
+ <DialogHeader>
92
+ <DialogTitle>{labels.saveBlockTitle}</DialogTitle>
93
+ <DialogDescription>{blockCount === 1 ? labels.saveBlockExplainOne : fill(labels.saveBlockExplain, { n: blockCount })}</DialogDescription>
94
+ </DialogHeader>
95
+
96
+ <div className="grid gap-1.5">
97
+ <label htmlFor={nameId} className="text-sm font-medium">
98
+ {labels.saveBlockName}
99
+ </label>
100
+ <Input id={nameId} value={name} maxLength={120} autoFocus onChange={(e) => setName(e.target.value)} placeholder={labels.saveBlockNamePlaceholder} />
101
+ </div>
102
+
103
+ <fieldset className="grid gap-2">
104
+ <legend className="mb-1.5 text-sm font-medium">{labels.saveBlockHow}</legend>
105
+ <RadioGroup value={mode} onValueChange={(v) => setMode(v as SaveBlockChoice["mode"])} className="grid gap-2">
106
+ {option("synced", labels.saveBlockSynced, labels.saveBlockSyncedHint, "mode")}
107
+ {option("copy", labels.saveBlockCopy, labels.saveBlockCopyHint, "mode")}
108
+ </RadioGroup>
109
+ </fieldset>
110
+
111
+ {canShare && (
112
+ <fieldset className="grid gap-2">
113
+ <legend className="mb-1.5 text-sm font-medium">{labels.saveBlockWho}</legend>
114
+ <RadioGroup value={sharing} onValueChange={(v) => setSharing(v as SaveBlockChoice["sharing"])} className="grid gap-2">
115
+ {option("me", labels.saveBlockOnlyMe, labels.saveBlockOnlyMeHint, "sharing")}
116
+ {option("workspace", labels.saveBlockEveryone, labels.saveBlockEveryoneHint, "sharing")}
117
+ </RadioGroup>
118
+ </fieldset>
119
+ )}
120
+
121
+ {failed && (
122
+ <p role="alert" className="text-sm text-error-text">
123
+ {labels.collabFailed}
124
+ </p>
125
+ )}
126
+
127
+ <DialogFooter>
128
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
129
+ {labels.saveBlockCancel}
130
+ </Button>
131
+ <Button type="submit" disabled={!name.trim() || busy}>
132
+ {labels.saveBlockSave}
133
+ </Button>
134
+ </DialogFooter>
135
+ </form>
136
+ </DialogContent>
137
+ </Dialog>
138
+ )
139
+ }
140
+
141
+ export { SaveBlockDialog }
@@ -0,0 +1,205 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { NodeViewWrapper, type ReactNodeViewProps } from "@tiptap/react"
5
+
6
+ import { Icon } from "../icon"
7
+ import { cn } from "../utils"
8
+ import type { Block, Inline } from "./contract"
9
+ import { freshEditorBlocks } from "./convert"
10
+ import { applyOverrides, lookupPart, partText, segments, type Segment } from "./saved-parts"
11
+ import { fill, type EditorLabels } from "./labels"
12
+ import { inlineText, useEditorServices } from "./services"
13
+
14
+ /**
15
+ * A synced saved block in a document (EditorCustomBlocks; E.21, E.38): drawn
16
+ * from the library, so editing the original reaches every document that uses
17
+ * it. It shows a light outline in the main colour and, when selected or
18
+ * hovered, its source label: the name, "Synced · used in 12 documents" and
19
+ * Detach, which turns it into ordinary blocks changed here only.
20
+ */
21
+ export function SavedBlockView(props: ReactNodeViewProps) {
22
+ const { services, labels } = useEditorServices()
23
+ const id = String(props.node.attrs.savedBlockId ?? "")
24
+ const saved = services.savedBlocks?.find((b) => b.id === id) ?? null
25
+ const editable = props.editor.isEditable
26
+ const overrides = (props.node.attrs.overrides ?? {}) as Partial<Record<string, Inline[]>>
27
+
28
+ const detach = () => {
29
+ const pos = props.getPos()
30
+ if (!saved || typeof pos !== "number") return
31
+ // What this document filled in stays; the rest is the library's as it is now.
32
+ props.editor
33
+ .chain()
34
+ .focus()
35
+ .insertContentAt({ from: pos, to: pos + props.node.nodeSize }, freshEditorBlocks(applyOverrides(saved.blocks, overrides)))
36
+ .run()
37
+ }
38
+
39
+ /** E.23a: this document's own text for one part, by its key; empty goes back to the original's. */
40
+ const fillPart = (segment: Extract<Segment, { part: string }>, text: string) => {
41
+ const next = { ...overrides }
42
+ delete next[segment.legacy] // a value under the pre-3.4 name moves to the key
43
+ if (text) next[segment.part] = [{ type: "text", text }]
44
+ else delete next[segment.part]
45
+ props.updateAttributes({ overrides: next })
46
+ }
47
+
48
+ const line = (blockId: string, content: Inline[]) =>
49
+ segments(blockId, content).map((s, i) =>
50
+ s.part === null ? (
51
+ <React.Fragment key={i}>{inlineText(s.runs)}</React.Fragment>
52
+ ) : (
53
+ <PartField key={s.part} original={partText(s.runs)} value={inlineText(lookupPart(overrides, s) ?? [])} editable={editable} labels={labels} onChange={(text) => fillPart(s, text)} />
54
+ )
55
+ )
56
+
57
+ const usedIn = saved?.usedIn ?? 0
58
+ return (
59
+ <NodeViewWrapper
60
+ data-type="savedBlock"
61
+ data-block-id={props.node.attrs.id ?? undefined}
62
+ className={cn("wy-rich wy-saved", props.selected && "is-selected")}
63
+ role="group"
64
+ aria-label={fill(labels.savedBlockLabel, { name: saved?.name ?? "" })}
65
+ >
66
+ {saved && (
67
+ <div className="wy-saved-src" contentEditable={false}>
68
+ <Icon name="sync" size={12} />
69
+ <b dir="auto">{saved.name}</b>
70
+ <span>
71
+ {labels.savedBlockSynced} · {usedIn === 1 ? labels.savedBlockUsedInOne : fill(labels.savedBlockUsedIn, { n: usedIn })}
72
+ </span>
73
+ {editable && (
74
+ <>
75
+ <span className="wy-saved-sep" aria-hidden="true" />
76
+ <button
77
+ type="button"
78
+ className="wy-saved-action"
79
+ title={labels.savedBlockDetachHint}
80
+ onMouseDown={(e) => e.preventDefault()}
81
+ onClick={detach}
82
+ >
83
+ {labels.savedBlockDetach}
84
+ </button>
85
+ </>
86
+ )}
87
+ </div>
88
+ )}
89
+ <div className="wy-saved-body" contentEditable={false}>
90
+ {saved ? <SavedBlocksPreview blocks={saved.blocks} labels={labels} line={line} /> : <div className="wy-placeholder">{labels.savedBlockMissing}</div>}
91
+ </div>
92
+ </NodeViewWrapper>
93
+ )
94
+ }
95
+
96
+ /** A block type's name for what the preview can't draw as text. */
97
+ const TYPE_NAMES: Partial<Record<Block["type"], keyof EditorLabels>> = {
98
+ table: "blockTable",
99
+ image: "blockImage",
100
+ file: "blockFile",
101
+ record: "blockRecord",
102
+ chart: "blockChart",
103
+ signature: "blockSignature",
104
+ barcode: "blockBarcode",
105
+ qr: "blockQr",
106
+ math: "blockMath",
107
+ pageBreak: "blockPageBreak",
108
+ columns: "blockColumns",
109
+ }
110
+
111
+ /**
112
+ * The library's blocks, read-only, with the sheet's own type: text as text,
113
+ * other blocks named. The saved block is edited in the original, not here.
114
+ */
115
+ function SavedBlocksPreview({ blocks, labels, line }: { blocks: Block[]; labels: EditorLabels; line: (blockId: string, content: Inline[]) => React.ReactNode }) {
116
+ return (
117
+ <>
118
+ {blocks.map((block) => {
119
+ switch (block.type) {
120
+ case "heading": {
121
+ const H = `h${block.level + 1}` as "h2" | "h3" | "h4"
122
+ return <H key={block.id}>{line(block.id, block.content)}</H>
123
+ }
124
+ case "paragraph":
125
+ return <p key={block.id}>{line(block.id, block.content)}</p>
126
+ case "quote":
127
+ return <blockquote key={block.id}>{line(block.id, block.content)}</blockquote>
128
+ case "callout":
129
+ return (
130
+ <div key={block.id} className="wy-saved-callout" data-kind={block.kind}>
131
+ <Icon name={block.kind === "important" ? "alert" : "info"} className="wy-callout-icon" />
132
+ <p>{line(block.id, block.content)}</p>
133
+ </div>
134
+ )
135
+ case "bullet":
136
+ case "number":
137
+ case "checklist":
138
+ return (
139
+ <p key={block.id} style={{ paddingInlineStart: `${(block.level + 1) * 1.25}em` }}>
140
+ {block.type === "checklist" ? (block.checked ? "☑ " : "☐ ") : block.type === "bullet" ? "• " : ""}
141
+ {line(block.id, block.content)}
142
+ </p>
143
+ )
144
+ case "code":
145
+ return <pre key={block.id}>{block.text}</pre>
146
+ case "divider":
147
+ return <hr key={block.id} />
148
+ case "toggle":
149
+ return (
150
+ <React.Fragment key={block.id}>
151
+ <p>{inlineText(block.summary)}</p>
152
+ <SavedBlocksPreview blocks={block.children} labels={labels} line={line} />
153
+ </React.Fragment>
154
+ )
155
+ default: {
156
+ const name = TYPE_NAMES[block.type]
157
+ return (
158
+ <div key={block.id} className="wy-placeholder">
159
+ {name ? labels[name] : block.type}
160
+ </div>
161
+ )
162
+ }
163
+ }
164
+ })}
165
+ </>
166
+ )
167
+ }
168
+
169
+ /**
170
+ * One per-document part (E.23): a field this document fills, showing the
171
+ * original's text until it does. Read-only, it shows what will print.
172
+ */
173
+ function PartField({
174
+ original,
175
+ value,
176
+ editable,
177
+ labels,
178
+ onChange,
179
+ }: {
180
+ original: string
181
+ value: string
182
+ editable: boolean
183
+ labels: EditorLabels
184
+ onChange: (text: string) => void
185
+ }) {
186
+ const [draft, setDraft] = React.useState(value)
187
+ React.useEffect(() => setDraft(value), [value])
188
+ if (!editable) return <span className="wy-part">{value || original}</span>
189
+ return (
190
+ <input
191
+ className="wy-part"
192
+ dir="auto"
193
+ value={draft}
194
+ placeholder={original}
195
+ size={Math.max(4, (draft || original).length)}
196
+ aria-label={fill(labels.perDocumentFill, { text: original })}
197
+ onChange={(e) => setDraft(e.target.value)}
198
+ onBlur={() => draft !== value && onChange(draft.trim())}
199
+ onKeyDown={(e) => {
200
+ if (e.key === "Enter") (e.target as HTMLInputElement).blur()
201
+ if (e.key === "Escape") setDraft(value)
202
+ }}
203
+ />
204
+ )
205
+ }
@@ -0,0 +1,105 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import * as React from "react"
3
+
4
+ import type { SavedBlock, WhityDocument } from "./contract"
5
+ import { DocEditor } from "./doc-editor"
6
+ import { EDITOR_LABELS } from "./labels"
7
+ import { SAMPLE_DOCUMENT } from "./sample"
8
+ import { SaveBlockDialog } from "./save-block-dialog"
9
+ import type { EditorServices } from "./services"
10
+
11
+ /**
12
+ * Editor M7, the saved blocks half of the EditorCustomBlocks card: a synced
13
+ * block in a document with its label ("Bank details · Synced · used in 12
14
+ * documents", Detach), the / menu's Saved blocks group, and Save as block.
15
+ */
16
+ const meta = {
17
+ title: "Editor/Saved blocks",
18
+ parameters: { layout: "fullscreen", fullBleed: true },
19
+ } satisfies Meta
20
+
21
+ export default meta
22
+ type Story = StoryObj<typeof meta>
23
+
24
+ const t = (text: string) => ({ type: "text" as const, text })
25
+
26
+ const BANK: SavedBlock = {
27
+ id: "5",
28
+ name: "Bank details",
29
+ mode: "synced",
30
+ sharing: "workspace",
31
+ owner: { kind: "person", id: "1", name: "Amro Saleh" },
32
+ blocks: [
33
+ { id: "s1", type: "heading", level: 3, content: [t("Bank details")] },
34
+ { id: "s2", type: "callout", kind: "note", content: [t("Example Bank, Mecca Street branch · IBAN JO71 EXBK 0000 0000 0000 1234 5678 90 · SWIFT EXBKJOAM")] },
35
+ ],
36
+ perDocumentParts: [],
37
+ version: 3,
38
+ usedIn: 12,
39
+ }
40
+ const TERMS: SavedBlock = {
41
+ ...BANK,
42
+ id: "6",
43
+ name: "Payment terms",
44
+ mode: "copy",
45
+ sharing: "me",
46
+ blocks: [{ id: "c1", type: "paragraph", content: [t("Please pay within 30 days of the invoice date.")] }],
47
+ usedIn: 0,
48
+ }
49
+
50
+ const SIGN: SavedBlock = {
51
+ ...BANK,
52
+ id: "7",
53
+ name: "Signature line",
54
+ blocks: [
55
+ {
56
+ id: "g1",
57
+ type: "paragraph",
58
+ content: [t("Signed by "), { type: "text", text: "Amro Saleh", marks: [{ type: "perDocument", key: "pd_signer01" }] }, t(" on "), { type: "text", text: "12 November 2026", marks: [{ type: "perDocument", key: "pd_signdate" }] }],
59
+ },
60
+ ],
61
+ perDocumentParts: [
62
+ { key: "pd_signer01", label: { en: "Signer's name", ar: "اسم الموقّع" }, kind: "text" },
63
+ { key: "pd_signdate", label: { en: "Date", ar: "التاريخ" }, kind: "text" },
64
+ ],
65
+ usedIn: 4,
66
+ }
67
+
68
+ const SERVICES: EditorServices = {
69
+ savedBlocks: [BANK, TERMS, SIGN],
70
+ saveBlock: async (b) => ({ ...b, id: "9", owner: BANK.owner, version: 1, usedIn: 0 }),
71
+ canShareSavedBlocks: true,
72
+ }
73
+
74
+ const DOC: WhityDocument = {
75
+ ...SAMPLE_DOCUMENT,
76
+ title: "Invoice letter",
77
+ blocks: [
78
+ { id: "p1", type: "paragraph", content: [t("Thank you for your order from Example Bakery. Please transfer the amount due to:")] },
79
+ { id: "r1", type: "savedBlock", savedBlockId: "5", version: 3, overrides: {} },
80
+ { id: "p2", type: "paragraph", content: [t("Questions? Reply to this letter or call us.")] },
81
+ { id: "r2", type: "savedBlock", savedBlockId: "7", version: 1, overrides: { "g1#0": [t("Awss Haddad")] } },
82
+ ],
83
+ }
84
+
85
+ function Editor({ lang }: { lang?: "ar" }) {
86
+ const [doc, setDoc] = React.useState<WhityDocument>(
87
+ lang === "ar"
88
+ ? { ...DOC, lang: "ar", title: "رسالة الفاتورة", blocks: [{ id: "p1", type: "paragraph", content: [t("شكرًا لطلبك من Example Bakery. يرجى تحويل المبلغ المستحق إلى:")] }, DOC.blocks[1]] }
89
+ : DOC
90
+ )
91
+ return (
92
+ <div dir={lang === "ar" ? "rtl" : undefined} lang={lang} className="h-screen">
93
+ <DocEditor document={doc} onChange={setDoc} canEdit services={SERVICES} />
94
+ </div>
95
+ )
96
+ }
97
+
98
+ /** Hover or select the synced block to see its label and Detach; type / to see the Saved blocks group. */
99
+ export const SyncedInADocument: Story = { render: () => <Editor /> }
100
+
101
+ export const Arabic: Story = { render: () => <Editor lang="ar" /> }
102
+
103
+ export const SaveAsBlock: Story = {
104
+ render: () => <SaveBlockDialog open onOpenChange={() => undefined} blockCount={2} canShare onSave={async () => undefined} labels={EDITOR_LABELS} />,
105
+ }