@whity/ui 0.0.0-stage → 0.5.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 (169) hide show
  1. package/README.md +107 -3
  2. package/package.json +192 -6
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +302 -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 +500 -0
  16. package/src/approval-queue.tsx +108 -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.tsx +83 -0
  22. package/src/badge.stories.tsx +105 -0
  23. package/src/badge.tsx +68 -0
  24. package/src/beta-warning.stories.tsx +79 -0
  25. package/src/beta-warning.tsx +189 -0
  26. package/src/bilingual-input.stories.tsx +82 -0
  27. package/src/bilingual-input.tsx +183 -0
  28. package/src/breadcrumb.stories.tsx +51 -0
  29. package/src/breadcrumb.tsx +90 -0
  30. package/src/button.stories.tsx +87 -0
  31. package/src/button.tsx +118 -0
  32. package/src/card.stories.tsx +423 -0
  33. package/src/card.tsx +180 -0
  34. package/src/chart.stories.tsx +66 -0
  35. package/src/chart.tsx +228 -0
  36. package/src/checkbox.stories.tsx +62 -0
  37. package/src/checkbox.tsx +54 -0
  38. package/src/collapsible.stories.tsx +48 -0
  39. package/src/collapsible.tsx +34 -0
  40. package/src/color-card.stories.tsx +61 -0
  41. package/src/color-card.tsx +270 -0
  42. package/src/color-picker.stories.tsx +65 -0
  43. package/src/color-picker.tsx +425 -0
  44. package/src/command-palette.tsx +306 -0
  45. package/src/copy-block.stories.tsx +38 -0
  46. package/src/copy-block.tsx +85 -0
  47. package/src/data-table.stories.tsx +200 -0
  48. package/src/data-table.tsx +1106 -0
  49. package/src/date-picker.stories.tsx +61 -0
  50. package/src/date-picker.tsx +422 -0
  51. package/src/design-cards.stories.tsx +458 -0
  52. package/src/dialog.stories.tsx +48 -0
  53. package/src/dialog.tsx +166 -0
  54. package/src/documents/barcode-svg.stories.tsx +72 -0
  55. package/src/documents/barcode-svg.tsx +79 -0
  56. package/src/dropdown-menu.stories.tsx +77 -0
  57. package/src/dropdown-menu.tsx +271 -0
  58. package/src/editor/behaviour.ts +279 -0
  59. package/src/editor/block-ids.ts +44 -0
  60. package/src/editor/block-list.tsx +101 -0
  61. package/src/editor/block-toolbar.tsx +477 -0
  62. package/src/editor/bubble.tsx +93 -0
  63. package/src/editor/catalogue.ts +103 -0
  64. package/src/editor/collab-rail.tsx +746 -0
  65. package/src/editor/collab.stories.tsx +207 -0
  66. package/src/editor/collab.ts +87 -0
  67. package/src/editor/contract.ts +408 -0
  68. package/src/editor/convert.ts +362 -0
  69. package/src/editor/doc-editor.stories.tsx +98 -0
  70. package/src/editor/doc-editor.tsx +1287 -0
  71. package/src/editor/editor.css +536 -0
  72. package/src/editor/extensions.ts +86 -0
  73. package/src/editor/field-picker.tsx +107 -0
  74. package/src/editor/fields.ts +100 -0
  75. package/src/editor/gutter.tsx +367 -0
  76. package/src/editor/index.ts +22 -0
  77. package/src/editor/label-sheet.tsx +289 -0
  78. package/src/editor/labels.ts +310 -0
  79. package/src/editor/link-tools.tsx +141 -0
  80. package/src/editor/node-views.tsx +450 -0
  81. package/src/editor/page-view.tsx +353 -0
  82. package/src/editor/publish-check.tsx +182 -0
  83. package/src/editor/rich-blocks.stories.tsx +146 -0
  84. package/src/editor/sample.ts +40 -0
  85. package/src/editor/schema-rich.ts +150 -0
  86. package/src/editor/schema.ts +315 -0
  87. package/src/editor/services.tsx +127 -0
  88. package/src/editor/slash.ts +64 -0
  89. package/src/editor/suggesting.ts +372 -0
  90. package/src/editor/suggestions.ts +763 -0
  91. package/src/editor/table-keys.ts +66 -0
  92. package/src/editor/templates.stories.tsx +324 -0
  93. package/src/editor/toolbar.tsx +358 -0
  94. package/src/empty-state.stories.tsx +51 -0
  95. package/src/empty-state.tsx +100 -0
  96. package/src/empty-state.usage-notes.md +30 -0
  97. package/src/form.stories.tsx +112 -0
  98. package/src/form.tsx +176 -0
  99. package/src/globals.css +20 -0
  100. package/src/icon-button.tsx +85 -0
  101. package/src/icon-map.ts +244 -0
  102. package/src/icon.tsx +41 -0
  103. package/src/index.ts +67 -0
  104. package/src/input.stories.tsx +157 -0
  105. package/src/input.tsx +759 -0
  106. package/src/locked-screen.stories.tsx +29 -0
  107. package/src/locked-screen.tsx +61 -0
  108. package/src/mark.tsx +62 -0
  109. package/src/math-text.stories.tsx +33 -0
  110. package/src/math-text.tsx +43 -0
  111. package/src/menu-bar.stories.tsx +198 -0
  112. package/src/menu-bar.tsx +373 -0
  113. package/src/money/currency.ts +230 -0
  114. package/src/page-header.stories.tsx +95 -0
  115. package/src/page-header.tsx +122 -0
  116. package/src/page-shell.stories.tsx +42 -0
  117. package/src/page-shell.tsx +32 -0
  118. package/src/pagination.stories.tsx +45 -0
  119. package/src/pagination.tsx +98 -0
  120. package/src/plugin-card.stories.tsx +180 -0
  121. package/src/plugin-card.tsx +848 -0
  122. package/src/popover.stories.tsx +48 -0
  123. package/src/popover.tsx +55 -0
  124. package/src/radio-group.stories.tsx +26 -0
  125. package/src/radio-group.tsx +44 -0
  126. package/src/route-flow/editor.tsx +1014 -0
  127. package/src/route-flow/model.ts +716 -0
  128. package/src/scope-grant.tsx +139 -0
  129. package/src/screen-too-small.stories.tsx +61 -0
  130. package/src/screen-too-small.tsx +104 -0
  131. package/src/select.stories.tsx +44 -0
  132. package/src/select.tsx +197 -0
  133. package/src/separator.stories.tsx +34 -0
  134. package/src/separator.tsx +34 -0
  135. package/src/sheet.stories.tsx +49 -0
  136. package/src/sheet.tsx +168 -0
  137. package/src/skeleton.stories.tsx +28 -0
  138. package/src/skeleton.tsx +19 -0
  139. package/src/slider.stories.tsx +78 -0
  140. package/src/slider.tsx +300 -0
  141. package/src/spinner.stories.tsx +33 -0
  142. package/src/spinner.tsx +55 -0
  143. package/src/switch.stories.tsx +42 -0
  144. package/src/switch.tsx +41 -0
  145. package/src/switcher.stories.tsx +111 -0
  146. package/src/switcher.tsx +131 -0
  147. package/src/table.stories.tsx +48 -0
  148. package/src/table.tsx +121 -0
  149. package/src/tabs.stories.tsx +74 -0
  150. package/src/tabs.tsx +90 -0
  151. package/src/tag-input.stories.tsx +67 -0
  152. package/src/tag-input.tsx +117 -0
  153. package/src/tenant-logo.tsx +63 -0
  154. package/src/tenant-switcher.stories.tsx +38 -0
  155. package/src/tenant-switcher.tsx +164 -0
  156. package/src/textarea.stories.tsx +27 -0
  157. package/src/textarea.tsx +18 -0
  158. package/src/theme-mode.ts +52 -0
  159. package/src/time-picker.stories.tsx +62 -0
  160. package/src/time-picker.tsx +615 -0
  161. package/src/toggle-group.tsx +138 -0
  162. package/src/tooltip.stories.tsx +43 -0
  163. package/src/tooltip.tsx +73 -0
  164. package/src/top-nav.stories.tsx +58 -0
  165. package/src/top-nav.tsx +324 -0
  166. package/src/undo-bar.tsx +107 -0
  167. package/src/utils.ts +45 -0
  168. package/src/view-toggle.stories.tsx +84 -0
  169. package/src/view-toggle.tsx +110 -0
@@ -0,0 +1,207 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import * as React from "react"
3
+
4
+ import type { EditorCollab, RailSuggestion, RailThread } from "./collab"
5
+ import { CollabDrawer, CollabRail, type RailActions, type RailItem } from "./collab-rail"
6
+ import type { Actor, EditorMode, WhityDocument } from "./contract"
7
+ import { DocEditor } from "./doc-editor"
8
+ import { EDITOR_LABELS } from "./labels"
9
+ import { SAMPLE_DOCUMENT } from "./sample"
10
+
11
+ /**
12
+ * Editor M5, the EditorCollab card: the rail with comments and suggestions,
13
+ * Suggesting mode, resolved threads and the drawer under 1024px. Example data
14
+ * follows the card (Rana Haddad, Omar Khalil, the Billing assistant).
15
+ */
16
+ const meta = {
17
+ title: "Editor/Comments and suggestions",
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
+ const RANA: Actor & { kind: "person" } = { kind: "person", id: "11", name: "Rana Haddad" }
26
+ const OMAR: Actor = { kind: "person", id: "12", name: "Omar Khalil" }
27
+ const AGENT: Actor = { kind: "agent", id: "billing-assistant", name: "Billing assistant", onBehalfOf: { id: "11", name: "Rana" }, scope: ["documents:suggest"] }
28
+
29
+ const LETTER: WhityDocument = {
30
+ ...SAMPLE_DOCUMENT,
31
+ kind: "letter",
32
+ title: "Payment reminder",
33
+ blocks: [
34
+ { id: "p1", type: "paragraph", content: [t("Invoice INV-1042 was due on 14 October. Please pay within 30 days of this letter.")] },
35
+ { id: "p2", type: "paragraph", content: [t("Payments usually take two working days to reach us.")] },
36
+ { id: "p3", type: "paragraph", content: [t("If you have already paid, thank you, and please ignore this letter.")] },
37
+ ],
38
+ }
39
+
40
+ const SUGGESTIONS: RailSuggestion[] = [
41
+ {
42
+ id: "41",
43
+ by: RANA,
44
+ at: "2026-10-29T13:52:00",
45
+ kind: "text",
46
+ summary: "Replace “30 days” with “14 days”",
47
+ status: "open",
48
+ patch: { op: "replace-text", blockId: "p1", deleteText: "30 days", insert: [t("14 days")], occurrence: 0 },
49
+ },
50
+ {
51
+ id: "42",
52
+ by: RANA,
53
+ at: "2026-10-29T13:53:00",
54
+ kind: "text",
55
+ summary: "Add “, or call us on 06 555 0100”",
56
+ status: "open",
57
+ patch: { op: "replace-text", blockId: "p1", deleteText: "", insert: [t(", or call us on 06 555 0100")], before: "of this letter", occurrence: 0 },
58
+ },
59
+ {
60
+ id: "43",
61
+ by: AGENT,
62
+ at: "2026-10-29T13:55:00",
63
+ kind: "text",
64
+ summary: "Delete “usually ”",
65
+ status: "open",
66
+ request: "Make the payment paragraph firmer",
67
+ permission: "documents:suggest",
68
+ patch: { op: "replace-text", blockId: "p2", deleteText: "usually ", insert: [], occurrence: 0 },
69
+ },
70
+ ]
71
+
72
+ const THREADS: RailThread[] = [
73
+ {
74
+ id: "7",
75
+ anchorBlockId: "p1",
76
+ quote: "Please pay within",
77
+ messages: [
78
+ { id: "71", by: OMAR, at: "2026-10-29T13:40:00", body: [t("Should we mention the 2% late fee here?")], mentions: [] },
79
+ { id: "72", by: RANA, at: "2026-10-29T13:44:00", body: [t("Yes, after the due date sentence.")], mentions: [] },
80
+ ],
81
+ },
82
+ {
83
+ id: "5",
84
+ anchorBlockId: "p3",
85
+ quote: "already paid",
86
+ messages: [{ id: "51", by: OMAR, at: "2026-10-29T12:05:00", body: [t("Use the customer’s legal name")], mentions: [] }],
87
+ resolved: { by: RANA, at: "2026-10-29T12:10:00" },
88
+ },
89
+ ]
90
+
91
+ const PEOPLE = [
92
+ { id: "12", name: "Omar Khalil", detail: "Accounts" },
93
+ { id: "13", name: "Lina Saad", detail: "HR" },
94
+ ]
95
+
96
+ /** An in-memory server: suggestions get ids, decisions drop them, threads resolve and reopen. */
97
+ function useFakeCollab(canComment = true): EditorCollab {
98
+ const [suggestions, setSuggestions] = React.useState(SUGGESTIONS)
99
+ const [threads, setThreads] = React.useState(THREADS)
100
+ const next = React.useRef(100)
101
+ const now = () => new Date().toISOString()
102
+ return {
103
+ suggestions,
104
+ threads,
105
+ canSuggest: true,
106
+ canComment,
107
+ me: RANA,
108
+ onSuggest: async (change) => {
109
+ const saved: RailSuggestion = { id: String(next.current++), by: RANA, at: now(), status: "open", ...change }
110
+ setSuggestions((s) => [...s, saved])
111
+ return saved
112
+ },
113
+ onDecide: async (id) => setSuggestions((s) => s.filter((x) => x.id !== id)),
114
+ onDecideAll: async (_d, filter) => setSuggestions((s) => (filter?.agent ? s.filter((x) => x.by.kind !== "agent" || x.by.id !== filter.agent) : [])),
115
+ onComment: async (c) => {
116
+ const thread: RailThread = {
117
+ id: String(next.current++),
118
+ anchorBlockId: c.anchorBlockId,
119
+ quote: c.quote,
120
+ messages: [{ id: String(next.current++), by: RANA, at: now(), body: c.body, mentions: [] }],
121
+ }
122
+ setThreads((ts) => [...ts, thread])
123
+ return thread
124
+ },
125
+ onReply: async (threadId, body) =>
126
+ setThreads((ts) => ts.map((x) => (x.id === threadId ? { ...x, messages: [...x.messages, { id: String(next.current++), by: RANA, at: now(), body, mentions: [] }] } : x))),
127
+ onResolve: async (threadId) => setThreads((ts) => ts.map((x) => (x.id === threadId ? { ...x, resolved: { by: RANA, at: now() } } : x))),
128
+ onReopen: async (threadId) => setThreads((ts) => ts.map((x) => (x.id === threadId ? { ...x, resolved: undefined } : x))),
129
+ searchPeople: async (q) => PEOPLE.filter((p) => p.name.toLowerCase().includes(q.toLowerCase())),
130
+ }
131
+ }
132
+
133
+ function Live({ canEdit = true, startMode }: { canEdit?: boolean; startMode?: EditorMode }) {
134
+ const [doc, setDoc] = React.useState(LETTER)
135
+ const [mode, setMode] = React.useState<EditorMode | undefined>(startMode)
136
+ const collab = useFakeCollab()
137
+ return (
138
+ <div style={{ height: "100vh" }}>
139
+ <DocEditor
140
+ document={doc}
141
+ onChange={setDoc}
142
+ canEdit={canEdit}
143
+ mode={mode}
144
+ onModeChange={setMode}
145
+ back={{ label: "Back to templates", onClick: () => {} }}
146
+ path="Templates · Letters"
147
+ save={{ state: "saved", at: "14:02" }}
148
+ collab={collab}
149
+ />
150
+ </div>
151
+ )
152
+ }
153
+
154
+ /** The rail beside the sheet: a thread, Rana's two suggestions and the agent's, dashed. */
155
+ export const RailWithCommentsAndSuggestions: Story = { render: () => <Live /> }
156
+
157
+ /** Suggesting mode: the mode button on the tint; typing adds, deleting strikes through. */
158
+ export const SuggestingMode: Story = { render: () => <Live startMode="suggesting" /> }
159
+
160
+ /** Someone without edit permission: Suggesting, with Editing locked in the mode menu (E.10). */
161
+ export const WithoutEditPermission: Story = { render: () => <Live canEdit={false} /> }
162
+
163
+ const ACTIONS: RailActions = {
164
+ canEdit: true,
165
+ canComment: true,
166
+ onDecide: () => {},
167
+ onDecideAll: () => {},
168
+ onReply: async () => {},
169
+ onResolve: () => {},
170
+ onReopen: () => {},
171
+ searchPeople: async (q) => PEOPLE.filter((p) => p.name.toLowerCase().includes(q.toLowerCase())),
172
+ }
173
+ const ITEMS: RailItem[] = [
174
+ { kind: "thread", id: "7", thread: THREADS[0] },
175
+ ...SUGGESTIONS.map((s) => ({ kind: "suggestion" as const, id: s.id, suggestion: s })),
176
+ ]
177
+ const RESOLVED: RailItem[] = [{ kind: "thread", id: "5", thread: THREADS[1] }]
178
+
179
+ /** The rail on its own, with "1 resolved" open: the resolved card and Reopen. */
180
+ export const ResolvedThreads: Story = {
181
+ render: () => (
182
+ <div style={{ width: 300, minHeight: 900, marginInlineStart: 24 }}>
183
+ <CollabRail
184
+ items={ITEMS}
185
+ resolved={RESOLVED}
186
+ labels={EDITOR_LABELS}
187
+ actions={ACTIONS}
188
+ active="7"
189
+ onActive={() => {}}
190
+ anchorTop={() => null}
191
+ layoutKey={0}
192
+ defaultShowResolved
193
+ />
194
+ </div>
195
+ ),
196
+ }
197
+
198
+ /** Under 1024px: the same cards in a drawer with All, Comments, Suggestions and Resolved (E.6). */
199
+ export const NarrowDrawer: Story = { render: () => <DrawerDemo /> }
200
+
201
+ function DrawerDemo() {
202
+ const [open, setOpen] = React.useState(true)
203
+ const [active, setActive] = React.useState<string | null>(null)
204
+ return (
205
+ <CollabDrawer open={open} onOpenChange={setOpen} items={ITEMS} resolved={RESOLVED} labels={EDITOR_LABELS} actions={ACTIONS} active={active} onActive={setActive} />
206
+ )
207
+ }
@@ -0,0 +1,87 @@
1
+ import type { Actor, CommentThread, Inline, Suggestion } from "./contract"
2
+ import type { SuggestionKind, SuggestionPatch } from "./suggestions"
3
+
4
+ /**
5
+ * Comments and suggestions as the editor takes them (editor M5): the
6
+ * contract's `Suggestion` and `CommentThread`, plus what the server keeps
7
+ * beside them (the patch, the status, the thread's anchor).
8
+ */
9
+
10
+ export type SuggestionStatus = "open" | "accepted" | "rejected" | "stale"
11
+
12
+ export interface RailSuggestion extends Suggestion {
13
+ patch: SuggestionPatch
14
+ status: SuggestionStatus
15
+ baseVersion?: number
16
+ }
17
+
18
+ export interface RailThread extends CommentThread {
19
+ /** The block the quote is in (E.39: the highlight is drawn by matching the quote there). */
20
+ anchorBlockId: string
21
+ }
22
+
23
+ /** Someone who can be @mentioned. */
24
+ export interface MentionPerson {
25
+ id: string
26
+ name: string
27
+ /** A second line, such as a unit ("Accounts"). */
28
+ detail?: string
29
+ }
30
+
31
+ /** What a flush sends for one local change (POST /suggestions). */
32
+ export interface NewSuggestion {
33
+ kind: SuggestionKind
34
+ summary: string
35
+ patch: SuggestionPatch
36
+ }
37
+
38
+ export interface NewComment {
39
+ anchorBlockId: string
40
+ quote: string
41
+ body: Inline[]
42
+ /** Profile ids. */
43
+ mentions: string[]
44
+ }
45
+
46
+ /** Who decides is the server's to check (documents:write, E.29); the editor only offers it with canEdit. */
47
+ export type Decision = "accepted" | "rejected"
48
+
49
+ export interface DecideAllFilter {
50
+ /** Only these suggestions. */
51
+ ids?: string[]
52
+ /** Only those from one agent principal (its id). */
53
+ agent?: string
54
+ }
55
+
56
+ /**
57
+ * The editor's comments and suggestions. Without it the editor has no rail,
58
+ * no Suggesting mode and no Comment, as before M5.
59
+ */
60
+ export interface EditorCollab {
61
+ /** Open suggestions, in the server's id order. */
62
+ suggestions: RailSuggestion[]
63
+ /** Every thread, resolved ones included. */
64
+ threads: RailThread[]
65
+ /**
66
+ * Bump when the draft or the open suggestions changed on the server (a
67
+ * decision, someone else's suggestion): the editor draws the suggestions
68
+ * onto the draft again, once nothing of yours is waiting to be sent.
69
+ */
70
+ revision?: number
71
+ /** documents:suggest (E.10). */
72
+ canSuggest?: boolean
73
+ /** documents:comment. */
74
+ canComment?: boolean
75
+ /** The person at the keyboard: their pending suggestions and new comments show as theirs. */
76
+ me?: Actor & { kind: "person" }
77
+ /** Sends one local change; resolves to the stored suggestion (its id replaces the local one). */
78
+ onSuggest?: (change: NewSuggestion) => Promise<RailSuggestion>
79
+ onDecide?: (suggestionId: string, decision: Decision) => Promise<void>
80
+ onDecideAll?: (decision: Decision, filter?: DecideAllFilter) => Promise<void>
81
+ onComment?: (comment: NewComment) => Promise<RailThread>
82
+ onReply?: (threadId: string, body: Inline[], mentions: string[]) => Promise<void>
83
+ onResolve?: (threadId: string) => Promise<void>
84
+ onReopen?: (threadId: string) => Promise<void>
85
+ /** People to @mention: workspace people who can be notified. */
86
+ searchPeople?: (query: string) => Promise<MentionPerson[]>
87
+ }