@estiva-app/ui 0.95.0 → 0.97.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.
- package/dist/AppShell.d.ts +25 -7
- package/dist/AppShell.d.ts.map +1 -1
- package/dist/ArchivedNotice.d.ts +28 -0
- package/dist/ArchivedNotice.d.ts.map +1 -0
- package/dist/Avatar.d.ts +6 -1
- package/dist/Avatar.d.ts.map +1 -1
- package/dist/AvatarGroup.d.ts +2 -0
- package/dist/AvatarGroup.d.ts.map +1 -1
- package/dist/Button.d.ts +4 -3
- package/dist/Button.d.ts.map +1 -1
- package/dist/Card.d.ts.map +1 -1
- package/dist/CommentBox.d.ts.map +1 -1
- package/dist/ComposerTriggers.d.ts +2 -0
- package/dist/ComposerTriggers.d.ts.map +1 -1
- package/dist/ConversationActions.d.ts +24 -0
- package/dist/ConversationActions.d.ts.map +1 -0
- package/dist/ConversationCard.d.ts +90 -0
- package/dist/ConversationCard.d.ts.map +1 -0
- package/dist/ConversationLayout.d.ts +50 -0
- package/dist/ConversationLayout.d.ts.map +1 -0
- package/dist/ConversationMenu.d.ts +24 -0
- package/dist/ConversationMenu.d.ts.map +1 -0
- package/dist/Divider.d.ts +23 -4
- package/dist/Divider.d.ts.map +1 -1
- package/dist/EditedMarker.d.ts +11 -0
- package/dist/EditedMarker.d.ts.map +1 -0
- package/dist/IconButton.d.ts +3 -3
- package/dist/IconButton.d.ts.map +1 -1
- package/dist/LinkParts.d.ts +4 -1
- package/dist/LinkParts.d.ts.map +1 -1
- package/dist/ListColumn.d.ts +3 -1
- package/dist/ListColumn.d.ts.map +1 -1
- package/dist/MembersDialog.d.ts +4 -0
- package/dist/MembersDialog.d.ts.map +1 -1
- package/dist/MetaText.d.ts +22 -0
- package/dist/MetaText.d.ts.map +1 -0
- package/dist/NavItem.d.ts.map +1 -1
- package/dist/PageHeader.d.ts +50 -0
- package/dist/PageHeader.d.ts.map +1 -0
- package/dist/Panel.d.ts +6 -0
- package/dist/Panel.d.ts.map +1 -1
- package/dist/Person.d.ts +3 -1
- package/dist/Person.d.ts.map +1 -1
- package/dist/PersonTrigger.d.ts +1 -1
- package/dist/PersonTrigger.d.ts.map +1 -1
- package/dist/PinnedComment.d.ts +17 -0
- package/dist/PinnedComment.d.ts.map +1 -0
- package/dist/QuotedLine.d.ts +16 -0
- package/dist/QuotedLine.d.ts.map +1 -0
- package/dist/ReactionHorizon.d.ts +14 -0
- package/dist/ReactionHorizon.d.ts.map +1 -0
- package/dist/RepliesRow.d.ts +27 -0
- package/dist/RepliesRow.d.ts.map +1 -0
- package/dist/ResolveDialog.d.ts +13 -0
- package/dist/ResolveDialog.d.ts.map +1 -0
- package/dist/Select.d.ts +1 -1
- package/dist/Select.d.ts.map +1 -1
- package/dist/Skeleton.d.ts +8 -4
- package/dist/Skeleton.d.ts.map +1 -1
- package/dist/Thread.d.ts +38 -0
- package/dist/Thread.d.ts.map +1 -0
- package/dist/TopBar.d.ts +3 -2
- package/dist/TopBar.d.ts.map +1 -1
- package/dist/UrgentMark.d.ts +6 -0
- package/dist/UrgentMark.d.ts.map +1 -0
- package/dist/commentBoxFrame.d.ts +3 -1
- package/dist/commentBoxFrame.d.ts.map +1 -1
- package/dist/conversation.examples.d.ts +52 -0
- package/dist/conversation.examples.d.ts.map +1 -0
- package/dist/editor.js +33 -25
- package/dist/editor.js.map +2 -2
- package/dist/eslint/index.js +2 -1
- package/dist/eslint/index.js.map +2 -2
- package/dist/eslint/no-native-title.d.ts +1 -1
- package/dist/eslint/no-native-title.d.ts.map +1 -1
- package/dist/eslint/no-restyled-part.d.ts.map +1 -1
- package/dist/index.d.ts +18 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1412 -448
- package/dist/index.js.map +4 -4
- package/dist/linked.d.ts +4 -0
- package/dist/linked.d.ts.map +1 -1
- package/dist/linkedFrom.d.ts +2 -0
- package/dist/linkedFrom.d.ts.map +1 -1
- package/dist/looks.d.ts +13 -1
- package/dist/looks.d.ts.map +1 -1
- package/dist/threadCard.d.ts +46 -0
- package/dist/threadCard.d.ts.map +1 -0
- package/package.json +1 -1
- package/registry.json +1889 -544
- package/src/AppShell.mdx +24 -10
- package/src/AppShell.stories.tsx +65 -31
- package/src/AppShell.test.tsx +92 -10
- package/src/AppShell.tsx +108 -18
- package/src/ArchivedNotice.mdx +46 -0
- package/src/ArchivedNotice.stories.tsx +52 -0
- package/src/ArchivedNotice.test.tsx +42 -0
- package/src/ArchivedNotice.tsx +71 -0
- package/src/Avatar.agent.test.tsx +63 -0
- package/src/Avatar.mdx +25 -0
- package/src/Avatar.stories.tsx +13 -0
- package/src/Avatar.tsx +51 -3
- package/src/AvatarGroup.tsx +3 -1
- package/src/Button.mdx +2 -2
- package/src/Button.tsx +8 -6
- package/src/Card.test.tsx +4 -4
- package/src/Card.tsx +6 -2
- package/src/CommentBox.test.tsx +2 -1
- package/src/CommentBox.tsx +14 -7
- package/src/ComposerTriggers.stories.tsx +2 -0
- package/src/ComposerTriggers.tsx +3 -1
- package/src/ConfirmDialog.stories.tsx +12 -0
- package/src/ConversationActions.mdx +47 -0
- package/src/ConversationActions.stories.tsx +39 -0
- package/src/ConversationActions.tsx +96 -0
- package/src/ConversationCard.mdx +72 -0
- package/src/ConversationCard.states.test.tsx +330 -0
- package/src/ConversationCard.stories.tsx +135 -0
- package/src/ConversationCard.test.tsx +159 -0
- package/src/ConversationCard.tsx +524 -0
- package/src/ConversationLayout.mdx +61 -0
- package/src/ConversationLayout.stories.tsx +161 -0
- package/src/ConversationLayout.test.tsx +240 -0
- package/src/ConversationLayout.tsx +233 -0
- package/src/ConversationMenu.mdx +47 -0
- package/src/ConversationMenu.stories.tsx +42 -0
- package/src/ConversationMenu.test.tsx +47 -0
- package/src/ConversationMenu.tsx +57 -0
- package/src/Divider.mdx +36 -1
- package/src/Divider.stories.tsx +57 -0
- package/src/Divider.test.tsx +24 -1
- package/src/Divider.tsx +49 -9
- package/src/EditedMarker.mdx +36 -0
- package/src/EditedMarker.stories.tsx +24 -0
- package/src/EditedMarker.tsx +20 -0
- package/src/IconButton.mdx +2 -1
- package/src/IconButton.tsx +8 -5
- package/src/LinkCard.tsx +3 -3
- package/src/LinkChip.tsx +1 -1
- package/src/LinkParts.mdx +4 -0
- package/src/LinkParts.stories.tsx +10 -0
- package/src/LinkParts.tsx +9 -5
- package/src/LinkRow.tsx +1 -1
- package/src/ListColumn.tsx +9 -3
- package/src/MembersDialog.stories.tsx +11 -0
- package/src/MembersDialog.tsx +7 -3
- package/src/MetaText.mdx +41 -0
- package/src/MetaText.stories.tsx +29 -0
- package/src/MetaText.tsx +38 -0
- package/src/NavItem.tsx +2 -11
- package/src/PageHeader.mdx +123 -0
- package/src/PageHeader.stories.tsx +174 -0
- package/src/PageHeader.test.tsx +99 -0
- package/src/PageHeader.tsx +105 -0
- package/src/Panel.mdx +12 -0
- package/src/Panel.stories.tsx +47 -5
- package/src/Panel.test.tsx +40 -0
- package/src/Panel.tsx +8 -2
- package/src/Person.tsx +4 -2
- package/src/PersonTrigger.tsx +3 -3
- package/src/PinnedComment.mdx +40 -0
- package/src/PinnedComment.stories.tsx +21 -0
- package/src/PinnedComment.tsx +40 -0
- package/src/QuotedLine.mdx +44 -0
- package/src/QuotedLine.stories.tsx +30 -0
- package/src/QuotedLine.test.tsx +34 -0
- package/src/QuotedLine.tsx +33 -0
- package/src/ReactionHorizon.mdx +36 -0
- package/src/ReactionHorizon.stories.tsx +27 -0
- package/src/ReactionHorizon.tsx +27 -0
- package/src/RepliesRow.mdx +45 -0
- package/src/RepliesRow.stories.tsx +33 -0
- package/src/RepliesRow.test.tsx +47 -0
- package/src/RepliesRow.tsx +86 -0
- package/src/ReplyCard.mdx +50 -0
- package/src/ReplyCard.stories.tsx +68 -0
- package/src/ResolveDialog.mdx +44 -0
- package/src/ResolveDialog.stories.tsx +23 -0
- package/src/ResolveDialog.test.tsx +53 -0
- package/src/ResolveDialog.tsx +58 -0
- package/src/Select.tsx +12 -2
- package/src/Skeleton.stories.tsx +4 -1
- package/src/Skeleton.tsx +33 -4
- package/src/Thread.mdx +53 -0
- package/src/Thread.stories.tsx +167 -0
- package/src/Thread.test.tsx +83 -0
- package/src/Thread.tsx +113 -0
- package/src/TopBar.mdx +8 -6
- package/src/TopBar.stories.tsx +4 -3
- package/src/TopBar.tsx +8 -3
- package/src/UrgentMark.mdx +37 -0
- package/src/UrgentMark.stories.tsx +27 -0
- package/src/UrgentMark.tsx +15 -0
- package/src/commentBoxFrame.tsx +8 -4
- package/src/conversation.examples.tsx +135 -0
- package/src/eslint/no-native-title.ts +1 -1
- package/src/eslint/no-restyled-part.ts +1 -0
- package/src/index.ts +19 -2
- package/src/linked.ts +4 -0
- package/src/linkedFrom.ts +5 -3
- package/src/looks.ts +18 -2
- package/src/registry/registry.test.ts +9 -7
- package/src/threadCard.ts +84 -0
- package/stories/Choosing.mdx +21 -1
- package/tokens.css +14 -10
package/registry.json
CHANGED
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
"kind": "package",
|
|
5
5
|
"repo": "estiva-ui",
|
|
6
6
|
"package": "@estiva-app/ui",
|
|
7
|
-
"packageVersion": "0.
|
|
8
|
-
"exports":
|
|
9
|
-
"typeExports":
|
|
7
|
+
"packageVersion": "0.97.0",
|
|
8
|
+
"exports": 229,
|
|
9
|
+
"typeExports": 234,
|
|
10
10
|
"files": null
|
|
11
11
|
},
|
|
12
12
|
"storybook": {
|
|
@@ -207,7 +207,7 @@
|
|
|
207
207
|
"name": "menu",
|
|
208
208
|
"takes": "anything",
|
|
209
209
|
"required": false,
|
|
210
|
-
"note": "The top bar's menu button, in
|
|
210
|
+
"note": "The top bar's menu button, in place of the fold `onNavOpenChange` draws."
|
|
211
211
|
},
|
|
212
212
|
{
|
|
213
213
|
"name": "logo",
|
|
@@ -255,7 +255,7 @@
|
|
|
255
255
|
"name": "navOpen",
|
|
256
256
|
"takes": "true/false",
|
|
257
257
|
"required": false,
|
|
258
|
-
"note": "Whether the navigation is shown, in
|
|
258
|
+
"note": "Whether the navigation is shown. With `onNavOpenChange`, the frame draws the fold as the top bar's menu button (unless `menu` is given), in every manner, and folding narrows and fades the navigation to the content's own margin (LED-3, Katerina, 28 October: the sidebar fold top left, on the top bar's menu button; one fold in every app, with Peek's motion, 31 October)."
|
|
259
259
|
},
|
|
260
260
|
{
|
|
261
261
|
"name": "onNavOpenChange",
|
|
@@ -288,6 +288,9 @@
|
|
|
288
288
|
"docPage": "src/AppShell.mdx",
|
|
289
289
|
"app": null,
|
|
290
290
|
"looks": [
|
|
291
|
+
"transition-[grid-template-columns] duration-300 ease-in-out motion-reduce:transition-none",
|
|
292
|
+
"overflow-hidden transition-[opacity,visibility] duration-300 ease-in-out motion-reduce:transition-none visible opacity-100",
|
|
293
|
+
"overflow-hidden transition-[opacity,visibility] duration-300 ease-in-out motion-reduce:transition-none invisible opacity-0",
|
|
291
294
|
"overflow-hidden rounded-2xl bg-bg-surface signal:border signal:border-border-subtle signal:shadow-highlight-inset"
|
|
292
295
|
]
|
|
293
296
|
},
|
|
@@ -310,6 +313,68 @@
|
|
|
310
313
|
"app": null,
|
|
311
314
|
"looks": []
|
|
312
315
|
},
|
|
316
|
+
{
|
|
317
|
+
"name": "ArchivedNotice",
|
|
318
|
+
"repo": "estiva-ui",
|
|
319
|
+
"kind": "component",
|
|
320
|
+
"importPath": "@estiva-app/ui",
|
|
321
|
+
"sourceFile": "src/ArchivedNotice.tsx",
|
|
322
|
+
"purpose": "The card an archived file shows: who archived it and when, the resolution they gave, and the way back.",
|
|
323
|
+
"purposeFrom": "page",
|
|
324
|
+
"props": [
|
|
325
|
+
{
|
|
326
|
+
"name": "by",
|
|
327
|
+
"takes": "text",
|
|
328
|
+
"required": true,
|
|
329
|
+
"note": "Who archived it, in the app's words: \"You\", a name."
|
|
330
|
+
},
|
|
331
|
+
{
|
|
332
|
+
"name": "when",
|
|
333
|
+
"takes": "text",
|
|
334
|
+
"required": true,
|
|
335
|
+
"note": "When, in the app's words, with its day: \"Today\", \"Tue, Oct 28\"."
|
|
336
|
+
},
|
|
337
|
+
{
|
|
338
|
+
"name": "resolution",
|
|
339
|
+
"takes": "text",
|
|
340
|
+
"required": false,
|
|
341
|
+
"note": "What they wrote when they archived it."
|
|
342
|
+
},
|
|
343
|
+
{
|
|
344
|
+
"name": "withWhat",
|
|
345
|
+
"takes": "text",
|
|
346
|
+
"required": false,
|
|
347
|
+
"note": "Archived with the closest archived one above it: what that is, \"project\", \"page\", \"Folder\"."
|
|
348
|
+
},
|
|
349
|
+
{
|
|
350
|
+
"name": "withTitle",
|
|
351
|
+
"takes": "text",
|
|
352
|
+
"required": false,
|
|
353
|
+
"note": "The title of the one it is archived with, named in quotes."
|
|
354
|
+
},
|
|
355
|
+
{
|
|
356
|
+
"name": "onUnarchive",
|
|
357
|
+
"takes": "a handler",
|
|
358
|
+
"required": false,
|
|
359
|
+
"note": "Restore it; the button waits for it. Absent when it is archived with one above it, or cannot be restored here."
|
|
360
|
+
},
|
|
361
|
+
{
|
|
362
|
+
"name": "onOpenParent",
|
|
363
|
+
"takes": "a handler",
|
|
364
|
+
"required": false,
|
|
365
|
+
"note": "Open the one it is archived with. Absent while that is still being read."
|
|
366
|
+
}
|
|
367
|
+
],
|
|
368
|
+
"variants": [],
|
|
369
|
+
"ownsBehaviours": [],
|
|
370
|
+
"status": "stable",
|
|
371
|
+
"migrationStage": null,
|
|
372
|
+
"docsId": "status-feedback-archivednotice--docs",
|
|
373
|
+
"storyId": "status-feedback-archivednotice--archived",
|
|
374
|
+
"docPage": "src/ArchivedNotice.mdx",
|
|
375
|
+
"app": null,
|
|
376
|
+
"looks": []
|
|
377
|
+
},
|
|
313
378
|
{
|
|
314
379
|
"name": "AttachedCard",
|
|
315
380
|
"repo": "estiva-ui",
|
|
@@ -550,6 +615,12 @@
|
|
|
550
615
|
"required": false,
|
|
551
616
|
"note": "Say the person's name out loud, for a face that stands on its own — `PersonTrigger`'s compact shape, a stack of members."
|
|
552
617
|
},
|
|
618
|
+
{
|
|
619
|
+
"name": "bot",
|
|
620
|
+
"takes": "true/false",
|
|
621
|
+
"required": false,
|
|
622
|
+
"note": "An agent's face: a robot in place of the initials, for a profile that says it is an agent (NIP-24's `bot`)."
|
|
623
|
+
},
|
|
553
624
|
{
|
|
554
625
|
"name": "className",
|
|
555
626
|
"takes": "text",
|
|
@@ -931,7 +1002,7 @@
|
|
|
931
1002
|
"rounded-md transition-colors font-sans font-medium",
|
|
932
1003
|
"bg-accent-primary hover:bg-accent-hover text-text-inverse cursor-pointer signal:font-semibold",
|
|
933
1004
|
"border border-border-default hover:bg-bg-hover text-text-primary cursor-pointer",
|
|
934
|
-
"
|
|
1005
|
+
"border border-border-default bg-transparent text-text-primary shadow-none transition-colors hover:border-success-outline hover:bg-success-muted hover:text-success-default"
|
|
935
1006
|
]
|
|
936
1007
|
},
|
|
937
1008
|
{
|
|
@@ -1105,14 +1176,14 @@
|
|
|
1105
1176
|
"rounded-lg border bg-bg-surface border-border-default overflow-hidden",
|
|
1106
1177
|
"rounded-lg border bg-bg-surface border-border-default border-dashed",
|
|
1107
1178
|
"rounded-lg border bg-bg-surface border-border-default border-dashed overflow-hidden",
|
|
1108
|
-
"rounded-lg border bg-bg-surface border-border-default border-accent-
|
|
1109
|
-
"rounded-lg border bg-bg-surface border-border-default border-accent-
|
|
1110
|
-
"rounded-lg border bg-bg-surface border-border-default border-accent-
|
|
1111
|
-
"rounded-lg border bg-bg-surface border-border-default border-accent-
|
|
1112
|
-
"rounded-lg border bg-bg-surface border-border-default border-warning-
|
|
1113
|
-
"rounded-lg border bg-bg-surface border-border-default border-warning-
|
|
1114
|
-
"rounded-lg border bg-bg-surface border-border-default border-warning-
|
|
1115
|
-
"rounded-lg border bg-bg-surface border-border-default border-warning-
|
|
1179
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline",
|
|
1180
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline overflow-hidden",
|
|
1181
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline border-dashed",
|
|
1182
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline border-dashed overflow-hidden",
|
|
1183
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline",
|
|
1184
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline overflow-hidden",
|
|
1185
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline border-dashed",
|
|
1186
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline border-dashed overflow-hidden"
|
|
1116
1187
|
]
|
|
1117
1188
|
},
|
|
1118
1189
|
{
|
|
@@ -1134,6 +1205,25 @@
|
|
|
1134
1205
|
"app": null,
|
|
1135
1206
|
"looks": []
|
|
1136
1207
|
},
|
|
1208
|
+
{
|
|
1209
|
+
"name": "caretOnOpen",
|
|
1210
|
+
"repo": "estiva-ui",
|
|
1211
|
+
"kind": "helper",
|
|
1212
|
+
"importPath": "@estiva-app/ui",
|
|
1213
|
+
"sourceFile": "src/threadCard.ts",
|
|
1214
|
+
"purpose": "Counts the times a thread has opened in a ConversationLayout.",
|
|
1215
|
+
"purposeFrom": "comment",
|
|
1216
|
+
"props": [],
|
|
1217
|
+
"variants": [],
|
|
1218
|
+
"ownsBehaviours": [],
|
|
1219
|
+
"status": "stable",
|
|
1220
|
+
"migrationStage": null,
|
|
1221
|
+
"docsId": null,
|
|
1222
|
+
"storyId": null,
|
|
1223
|
+
"docPage": null,
|
|
1224
|
+
"app": null,
|
|
1225
|
+
"looks": []
|
|
1226
|
+
},
|
|
1137
1227
|
{
|
|
1138
1228
|
"name": "Checkbox",
|
|
1139
1229
|
"repo": "estiva-ui",
|
|
@@ -2468,548 +2558,1058 @@
|
|
|
2468
2558
|
]
|
|
2469
2559
|
},
|
|
2470
2560
|
{
|
|
2471
|
-
"name": "
|
|
2472
|
-
"repo": "estiva-ui",
|
|
2473
|
-
"kind": "helper",
|
|
2474
|
-
"importPath": "@estiva-app/ui/editor",
|
|
2475
|
-
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
2476
|
-
"purpose": "Removes the block, the caret where it was.",
|
|
2477
|
-
"purposeFrom": "comment",
|
|
2478
|
-
"props": [],
|
|
2479
|
-
"variants": [],
|
|
2480
|
-
"ownsBehaviours": [],
|
|
2481
|
-
"status": "stable",
|
|
2482
|
-
"migrationStage": null,
|
|
2483
|
-
"docsId": "writing-editorblockhandle--docs",
|
|
2484
|
-
"storyId": "writing-editorblockhandle--default",
|
|
2485
|
-
"docPage": null,
|
|
2486
|
-
"app": null,
|
|
2487
|
-
"looks": []
|
|
2488
|
-
},
|
|
2489
|
-
{
|
|
2490
|
-
"name": "deleteTableColumn",
|
|
2491
|
-
"repo": "estiva-ui",
|
|
2492
|
-
"kind": "helper",
|
|
2493
|
-
"importPath": "@estiva-app/ui/editor",
|
|
2494
|
-
"sourceFile": "src/EditorTableControls.tsx",
|
|
2495
|
-
"purpose": "The same for a column: the last one deletes the table.",
|
|
2496
|
-
"purposeFrom": "comment",
|
|
2497
|
-
"props": [],
|
|
2498
|
-
"variants": [],
|
|
2499
|
-
"ownsBehaviours": [],
|
|
2500
|
-
"status": "stable",
|
|
2501
|
-
"migrationStage": null,
|
|
2502
|
-
"docsId": "writing-editortablecontrols--docs",
|
|
2503
|
-
"storyId": "writing-editortablecontrols--default",
|
|
2504
|
-
"docPage": null,
|
|
2505
|
-
"app": null,
|
|
2506
|
-
"looks": []
|
|
2507
|
-
},
|
|
2508
|
-
{
|
|
2509
|
-
"name": "deleteTableRow",
|
|
2510
|
-
"repo": "estiva-ui",
|
|
2511
|
-
"kind": "helper",
|
|
2512
|
-
"importPath": "@estiva-app/ui/editor",
|
|
2513
|
-
"sourceFile": "src/EditorTableControls.tsx",
|
|
2514
|
-
"purpose": "The cell's row, or the whole table when it is its only one: a table holds at least one row (prosemirror-tables refuses to delete it).",
|
|
2515
|
-
"purposeFrom": "comment",
|
|
2516
|
-
"props": [],
|
|
2517
|
-
"variants": [],
|
|
2518
|
-
"ownsBehaviours": [],
|
|
2519
|
-
"status": "stable",
|
|
2520
|
-
"migrationStage": null,
|
|
2521
|
-
"docsId": "writing-editortablecontrols--docs",
|
|
2522
|
-
"storyId": "writing-editortablecontrols--default",
|
|
2523
|
-
"docPage": null,
|
|
2524
|
-
"app": null,
|
|
2525
|
-
"looks": []
|
|
2526
|
-
},
|
|
2527
|
-
{
|
|
2528
|
-
"name": "DialogShell",
|
|
2561
|
+
"name": "ConversationActions",
|
|
2529
2562
|
"repo": "estiva-ui",
|
|
2530
2563
|
"kind": "component",
|
|
2531
2564
|
"importPath": "@estiva-app/ui",
|
|
2532
|
-
"sourceFile": "src/
|
|
2533
|
-
"purpose": "The
|
|
2565
|
+
"sourceFile": "src/ConversationActions.tsx",
|
|
2566
|
+
"purpose": "The strip on a comment or a reply while it is pointed at: React, Reply, Resolve or Reopen, and ⋯, each drawn only when offered.",
|
|
2534
2567
|
"purposeFrom": "page",
|
|
2535
2568
|
"props": [
|
|
2536
2569
|
{
|
|
2537
|
-
"name": "
|
|
2538
|
-
"takes": "
|
|
2539
|
-
"required":
|
|
2540
|
-
"note": "
|
|
2570
|
+
"name": "options",
|
|
2571
|
+
"takes": "readonly ReactionOption[]",
|
|
2572
|
+
"required": false,
|
|
2573
|
+
"note": "The reactions on offer: with `onReact`, \"React\" opens them over the strip."
|
|
2541
2574
|
},
|
|
2542
2575
|
{
|
|
2543
|
-
"name": "
|
|
2576
|
+
"name": "onReact",
|
|
2544
2577
|
"takes": "a handler",
|
|
2545
|
-
"required":
|
|
2578
|
+
"required": false,
|
|
2546
2579
|
"note": null
|
|
2547
2580
|
},
|
|
2548
2581
|
{
|
|
2549
|
-
"name": "
|
|
2550
|
-
"takes": "
|
|
2582
|
+
"name": "onReply",
|
|
2583
|
+
"takes": "a handler",
|
|
2551
2584
|
"required": false,
|
|
2552
|
-
"note":
|
|
2585
|
+
"note": null
|
|
2553
2586
|
},
|
|
2554
2587
|
{
|
|
2555
|
-
"name": "
|
|
2556
|
-
"takes": "
|
|
2588
|
+
"name": "resolved",
|
|
2589
|
+
"takes": "true/false",
|
|
2557
2590
|
"required": false,
|
|
2558
|
-
"note": "
|
|
2591
|
+
"note": "Resolved: the strip offers Reopen in place of Resolve."
|
|
2559
2592
|
},
|
|
2560
2593
|
{
|
|
2561
|
-
"name": "
|
|
2562
|
-
"takes": "
|
|
2563
|
-
"required":
|
|
2594
|
+
"name": "onResolve",
|
|
2595
|
+
"takes": "a handler",
|
|
2596
|
+
"required": false,
|
|
2564
2597
|
"note": null
|
|
2565
2598
|
},
|
|
2566
2599
|
{
|
|
2567
|
-
"name": "
|
|
2568
|
-
"takes": "
|
|
2600
|
+
"name": "onReopen",
|
|
2601
|
+
"takes": "a handler",
|
|
2569
2602
|
"required": false,
|
|
2570
|
-
"note":
|
|
2603
|
+
"note": null
|
|
2571
2604
|
},
|
|
2572
2605
|
{
|
|
2573
|
-
"name": "
|
|
2574
|
-
"takes": "
|
|
2606
|
+
"name": "onPickerOpenChange",
|
|
2607
|
+
"takes": "a handler",
|
|
2575
2608
|
"required": false,
|
|
2576
|
-
"note": "
|
|
2609
|
+
"note": "Told when the reactions open and close, so a card can keep its strip while they are up."
|
|
2577
2610
|
},
|
|
2578
2611
|
{
|
|
2579
|
-
"name": "
|
|
2580
|
-
"takes": "
|
|
2612
|
+
"name": "more",
|
|
2613
|
+
"takes": "anything",
|
|
2581
2614
|
"required": false,
|
|
2582
|
-
"note":
|
|
2615
|
+
"note": "The ⋯ menu: a `ConversationMenu` whose trigger is a `ToolbarButton`, so the strip stays one Tab stop."
|
|
2583
2616
|
},
|
|
2584
2617
|
{
|
|
2585
|
-
"name": "
|
|
2586
|
-
"takes": "
|
|
2618
|
+
"name": "className",
|
|
2619
|
+
"takes": "text",
|
|
2587
2620
|
"required": false,
|
|
2588
|
-
"note": "
|
|
2621
|
+
"note": "Placement only: `absolute right-1 top-1`."
|
|
2589
2622
|
}
|
|
2590
2623
|
],
|
|
2591
2624
|
"variants": [],
|
|
2592
|
-
"ownsBehaviours": [
|
|
2593
|
-
{
|
|
2594
|
-
"id": "base-ui",
|
|
2595
|
-
"behaviour": "Is built on Base UI"
|
|
2596
|
-
},
|
|
2597
|
-
{
|
|
2598
|
-
"id": "portal",
|
|
2599
|
-
"behaviour": "Floats on top of the page"
|
|
2600
|
-
},
|
|
2601
|
-
{
|
|
2602
|
-
"id": "press-outside",
|
|
2603
|
-
"behaviour": "Closes on a press outside"
|
|
2604
|
-
},
|
|
2605
|
-
{
|
|
2606
|
-
"id": "page-keys",
|
|
2607
|
-
"behaviour": "Takes its keys by itself"
|
|
2608
|
-
},
|
|
2609
|
-
{
|
|
2610
|
-
"id": "focus",
|
|
2611
|
-
"behaviour": "Holds focus inside while open, and gives it back"
|
|
2612
|
-
},
|
|
2613
|
-
{
|
|
2614
|
-
"id": "scroll-lock",
|
|
2615
|
-
"behaviour": "Stops the page behind it scrolling"
|
|
2616
|
-
},
|
|
2617
|
-
{
|
|
2618
|
-
"id": "role",
|
|
2619
|
-
"behaviour": "Says what it is to assistive technology"
|
|
2620
|
-
}
|
|
2621
|
-
],
|
|
2625
|
+
"ownsBehaviours": [],
|
|
2622
2626
|
"status": "stable",
|
|
2623
2627
|
"migrationStage": null,
|
|
2624
|
-
"docsId": "
|
|
2625
|
-
"storyId": "
|
|
2626
|
-
"docPage": "src/
|
|
2628
|
+
"docsId": "conversation-conversationactions--docs",
|
|
2629
|
+
"storyId": "conversation-conversationactions--comment",
|
|
2630
|
+
"docPage": "src/ConversationActions.mdx",
|
|
2627
2631
|
"app": null,
|
|
2628
|
-
"looks": [
|
|
2629
|
-
"bg-bg-elevated border border-border-subtle rounded-lg shadow-lg pointer-events-auto overflow-hidden outline-none"
|
|
2630
|
-
]
|
|
2632
|
+
"looks": []
|
|
2631
2633
|
},
|
|
2632
2634
|
{
|
|
2633
|
-
"name": "
|
|
2635
|
+
"name": "ConversationCard",
|
|
2634
2636
|
"repo": "estiva-ui",
|
|
2635
2637
|
"kind": "component",
|
|
2636
2638
|
"importPath": "@estiva-app/ui",
|
|
2637
|
-
"sourceFile": "src/
|
|
2638
|
-
"purpose": "
|
|
2639
|
+
"sourceFile": "src/ConversationCard.tsx",
|
|
2640
|
+
"purpose": "One comment, the same in every app: who, when, the words, files, cards, reactions and the way into its replies, with the actions on hover and the ⋯ menu.",
|
|
2639
2641
|
"purposeFrom": "page",
|
|
2640
2642
|
"props": [
|
|
2641
2643
|
{
|
|
2642
|
-
"name": "
|
|
2643
|
-
"takes": "
|
|
2644
|
+
"name": "deleted",
|
|
2645
|
+
"takes": "true/false",
|
|
2644
2646
|
"required": false,
|
|
2645
|
-
"note":
|
|
2647
|
+
"note": "Deleted: \"This comment was deleted.\", and its replies stay."
|
|
2646
2648
|
},
|
|
2647
2649
|
{
|
|
2648
|
-
"name": "
|
|
2649
|
-
"takes": "
|
|
2650
|
+
"name": "replies",
|
|
2651
|
+
"takes": "Omit<RepliesRowProps, 'urgent'>",
|
|
2650
2652
|
"required": false,
|
|
2651
|
-
"note": "
|
|
2653
|
+
"note": "Its thread: how many replied, their faces, the last time, and whether one is new."
|
|
2652
2654
|
},
|
|
2653
2655
|
{
|
|
2654
|
-
"name": "
|
|
2655
|
-
"takes": "
|
|
2656
|
+
"name": "onReply",
|
|
2657
|
+
"takes": "a handler",
|
|
2656
2658
|
"required": false,
|
|
2657
|
-
"note": "
|
|
2659
|
+
"note": "Reply: offered on the strip."
|
|
2658
2660
|
},
|
|
2659
2661
|
{
|
|
2660
|
-
"name": "
|
|
2662
|
+
"name": "resolved",
|
|
2663
|
+
"takes": "{ by: string; note?: string; at?: string }",
|
|
2664
|
+
"required": false,
|
|
2665
|
+
"note": "Resolved, by whom, with what note and when (`at`, in the app's words)."
|
|
2666
|
+
},
|
|
2667
|
+
{
|
|
2668
|
+
"name": "onResolve",
|
|
2669
|
+
"takes": "a handler",
|
|
2670
|
+
"required": false,
|
|
2671
|
+
"note": "Resolve, with the note written in the dialog the card opens."
|
|
2672
|
+
},
|
|
2673
|
+
{
|
|
2674
|
+
"name": "resolveRefused",
|
|
2661
2675
|
"takes": "text",
|
|
2662
2676
|
"required": false,
|
|
2663
|
-
"note":
|
|
2664
|
-
}
|
|
2665
|
-
],
|
|
2666
|
-
"variants": [
|
|
2677
|
+
"note": "Why the last resolve was refused, in plain words: said under the note, while the dialog stays open (`onResolve` answered `false`)."
|
|
2678
|
+
},
|
|
2667
2679
|
{
|
|
2668
|
-
"
|
|
2669
|
-
"
|
|
2670
|
-
|
|
2671
|
-
|
|
2672
|
-
]
|
|
2680
|
+
"name": "onReopen",
|
|
2681
|
+
"takes": "a handler",
|
|
2682
|
+
"required": false,
|
|
2683
|
+
"note": null
|
|
2673
2684
|
},
|
|
2674
2685
|
{
|
|
2675
|
-
"
|
|
2676
|
-
"
|
|
2677
|
-
|
|
2678
|
-
|
|
2679
|
-
|
|
2680
|
-
}
|
|
2681
|
-
],
|
|
2682
|
-
"ownsBehaviours": [
|
|
2686
|
+
"name": "selected",
|
|
2687
|
+
"takes": "true/false",
|
|
2688
|
+
"required": false,
|
|
2689
|
+
"note": "The one open beside its thread."
|
|
2690
|
+
},
|
|
2683
2691
|
{
|
|
2684
|
-
"
|
|
2685
|
-
"
|
|
2692
|
+
"name": "onClick",
|
|
2693
|
+
"takes": "a handler",
|
|
2694
|
+
"required": false,
|
|
2695
|
+
"note": "A press on the card: its thread opens."
|
|
2686
2696
|
},
|
|
2687
2697
|
{
|
|
2688
|
-
"
|
|
2689
|
-
"
|
|
2690
|
-
}
|
|
2691
|
-
],
|
|
2692
|
-
"status": "stable",
|
|
2693
|
-
"migrationStage": null,
|
|
2694
|
-
"docsId": "page-structure-divider--docs",
|
|
2695
|
-
"storyId": "page-structure-divider--default",
|
|
2696
|
-
"docPage": "src/Divider.mdx",
|
|
2697
|
-
"app": null,
|
|
2698
|
-
"looks": []
|
|
2699
|
-
},
|
|
2700
|
-
{
|
|
2701
|
-
"name": "DocumentEditor",
|
|
2702
|
-
"repo": "estiva-ui",
|
|
2703
|
-
"kind": "component",
|
|
2704
|
-
"importPath": "@estiva-app/ui/editor",
|
|
2705
|
-
"sourceFile": "src/DocumentEditor.tsx",
|
|
2706
|
-
"purpose": "One document's text as one surface that is always an editor, the same in every app: `/`, `[` and `@`, links on words, files, checklists, callouts and tables, the block handle, saving when you leave, someone else's save arriving, and the text held when the sign-in ends.",
|
|
2707
|
-
"purposeFrom": "page",
|
|
2708
|
-
"props": [
|
|
2709
|
-
{
|
|
2710
|
-
"name": "value",
|
|
2711
|
-
"takes": "text",
|
|
2712
|
-
"required": true,
|
|
2713
|
-
"note": "The saved text. A new value while the editor is open is somebody else's save, or your own coming back."
|
|
2714
|
-
},
|
|
2715
|
-
{
|
|
2716
|
-
"name": "format",
|
|
2717
|
-
"takes": "text",
|
|
2718
|
-
"required": true,
|
|
2719
|
-
"note": "The format `value` is in, handed to `codec.read`."
|
|
2720
|
-
},
|
|
2721
|
-
{
|
|
2722
|
-
"name": "codec",
|
|
2723
|
-
"takes": "DocumentCodec",
|
|
2698
|
+
"name": "author",
|
|
2699
|
+
"takes": "ConversationPerson",
|
|
2724
2700
|
"required": true,
|
|
2725
2701
|
"note": null
|
|
2726
2702
|
},
|
|
2727
2703
|
{
|
|
2728
|
-
"name": "
|
|
2729
|
-
"takes": "
|
|
2704
|
+
"name": "time",
|
|
2705
|
+
"takes": "anything",
|
|
2730
2706
|
"required": true,
|
|
2731
|
-
"note": "
|
|
2707
|
+
"note": "When it was written, in the app's words (\"11:08 AM\")."
|
|
2732
2708
|
},
|
|
2733
2709
|
{
|
|
2734
|
-
"name": "
|
|
2710
|
+
"name": "timeHref",
|
|
2735
2711
|
"takes": "text",
|
|
2736
|
-
"required":
|
|
2737
|
-
"note": "
|
|
2712
|
+
"required": false,
|
|
2713
|
+
"note": "A link to it: the time is then the link, \"Link to this\", as a reply's is."
|
|
2738
2714
|
},
|
|
2739
2715
|
{
|
|
2740
|
-
"name": "
|
|
2741
|
-
"takes": "
|
|
2716
|
+
"name": "edited",
|
|
2717
|
+
"takes": "text",
|
|
2742
2718
|
"required": false,
|
|
2743
|
-
"note": "
|
|
2719
|
+
"note": "When it was last edited, in the app's words for the tooltip (\"Edited 11:20 AM\"): draws \"(edited)\"."
|
|
2744
2720
|
},
|
|
2745
2721
|
{
|
|
2746
|
-
"name": "
|
|
2747
|
-
"takes": "
|
|
2748
|
-
"required":
|
|
2749
|
-
"note": "
|
|
2722
|
+
"name": "children",
|
|
2723
|
+
"takes": "anything",
|
|
2724
|
+
"required": true,
|
|
2725
|
+
"note": "The words, as the app draws them: text, mentions, links, attached cards, quoted blocks."
|
|
2750
2726
|
},
|
|
2751
2727
|
{
|
|
2752
|
-
"name": "
|
|
2753
|
-
"takes": "
|
|
2728
|
+
"name": "about",
|
|
2729
|
+
"takes": "anything",
|
|
2754
2730
|
"required": false,
|
|
2755
|
-
"note": "
|
|
2731
|
+
"note": "What it is about, a `QuotedLine` for a comment on a part of the page: under the name, above the words."
|
|
2756
2732
|
},
|
|
2757
2733
|
{
|
|
2758
|
-
"name": "
|
|
2759
|
-
"takes": "
|
|
2734
|
+
"name": "files",
|
|
2735
|
+
"takes": "anything",
|
|
2760
2736
|
"required": false,
|
|
2761
|
-
"note": "
|
|
2737
|
+
"note": "Pictures and files: `AttachmentCard`s, laid out under the words."
|
|
2762
2738
|
},
|
|
2763
2739
|
{
|
|
2764
|
-
"name": "
|
|
2765
|
-
"takes": "
|
|
2740
|
+
"name": "reactions",
|
|
2741
|
+
"takes": "ReactionRowProps",
|
|
2766
2742
|
"required": false,
|
|
2767
|
-
"note": "
|
|
2743
|
+
"note": "Its reactions: the kit's `ReactionRow`. With `onToggle`, the strip offers React too."
|
|
2768
2744
|
},
|
|
2769
2745
|
{
|
|
2770
|
-
"name": "
|
|
2746
|
+
"name": "reactionRefused",
|
|
2771
2747
|
"takes": "text",
|
|
2772
2748
|
"required": false,
|
|
2773
|
-
"note":
|
|
2749
|
+
"note": "Why the last reaction was refused, in plain words: said under the reactions."
|
|
2774
2750
|
},
|
|
2775
2751
|
{
|
|
2776
|
-
"name": "
|
|
2777
|
-
"takes": "
|
|
2752
|
+
"name": "isNew",
|
|
2753
|
+
"takes": "true/false",
|
|
2778
2754
|
"required": false,
|
|
2779
|
-
"note": "`
|
|
2755
|
+
"note": "Not read yet: the dot, or the urgent mark with `urgent`, and the card's edge in the theme's colour."
|
|
2780
2756
|
},
|
|
2781
2757
|
{
|
|
2782
|
-
"name": "
|
|
2783
|
-
"takes": "
|
|
2758
|
+
"name": "urgent",
|
|
2759
|
+
"takes": "true/false",
|
|
2784
2760
|
"required": false,
|
|
2785
|
-
"note":
|
|
2761
|
+
"note": null
|
|
2786
2762
|
},
|
|
2787
2763
|
{
|
|
2788
|
-
"name": "
|
|
2789
|
-
"takes": "
|
|
2764
|
+
"name": "own",
|
|
2765
|
+
"takes": "true/false",
|
|
2790
2766
|
"required": false,
|
|
2791
|
-
"note": "
|
|
2767
|
+
"note": "It is yours: the menu offers Edit (with `editor`) and Delete (with `onDelete`)."
|
|
2792
2768
|
},
|
|
2793
2769
|
{
|
|
2794
|
-
"name": "
|
|
2795
|
-
"takes": "
|
|
2770
|
+
"name": "readOnly",
|
|
2771
|
+
"takes": "true/false",
|
|
2796
2772
|
"required": false,
|
|
2797
|
-
"note": "
|
|
2773
|
+
"note": "Nothing can be changed (an archived page): no strip, reactions only shown."
|
|
2798
2774
|
},
|
|
2799
2775
|
{
|
|
2800
|
-
"name": "
|
|
2776
|
+
"name": "editor",
|
|
2801
2777
|
"takes": "a handler",
|
|
2802
2778
|
"required": false,
|
|
2803
|
-
"note": "
|
|
2779
|
+
"note": "The box it is edited in, the app's `CommentBox` edit form; call `done` when it saves or cancels."
|
|
2804
2780
|
},
|
|
2805
2781
|
{
|
|
2806
|
-
"name": "
|
|
2782
|
+
"name": "editing",
|
|
2807
2783
|
"takes": "true/false",
|
|
2808
2784
|
"required": false,
|
|
2809
|
-
"note": "
|
|
2785
|
+
"note": "Being edited, when the app holds it (an edit that was refused opens again)."
|
|
2810
2786
|
},
|
|
2811
2787
|
{
|
|
2812
|
-
"name": "
|
|
2788
|
+
"name": "onEditingChange",
|
|
2813
2789
|
"takes": "a handler",
|
|
2814
2790
|
"required": false,
|
|
2815
|
-
"note":
|
|
2791
|
+
"note": null
|
|
2816
2792
|
},
|
|
2817
2793
|
{
|
|
2818
|
-
"name": "
|
|
2794
|
+
"name": "onDelete",
|
|
2819
2795
|
"takes": "a handler",
|
|
2820
2796
|
"required": false,
|
|
2821
|
-
"note": "
|
|
2822
|
-
},
|
|
2823
|
-
{
|
|
2824
|
-
"name": "referenceView",
|
|
2825
|
-
"takes": "ComponentType<ReferenceViewProps>",
|
|
2826
|
-
"required": false,
|
|
2827
|
-
"note": "Draws a link: the app's own, which resolves what it names — its chip, its row or its card in the row's place, as `place` says (§13.3)."
|
|
2828
|
-
},
|
|
2829
|
-
{
|
|
2830
|
-
"name": "attachmentView",
|
|
2831
|
-
"takes": "ComponentType<AttachmentViewProps>",
|
|
2832
|
-
"required": false,
|
|
2833
|
-
"note": "Draws a placed file: the app's own card."
|
|
2797
|
+
"note": "Delete, after the card has asked."
|
|
2834
2798
|
},
|
|
2835
2799
|
{
|
|
2836
|
-
"name": "
|
|
2837
|
-
"takes": "
|
|
2800
|
+
"name": "deleteNote",
|
|
2801
|
+
"takes": "anything",
|
|
2838
2802
|
"required": false,
|
|
2839
|
-
"note": "
|
|
2803
|
+
"note": "The app's sentence in the delete question, what deleting does there."
|
|
2840
2804
|
},
|
|
2841
2805
|
{
|
|
2842
|
-
"name": "
|
|
2843
|
-
"takes": "
|
|
2806
|
+
"name": "menu",
|
|
2807
|
+
"takes": "anything",
|
|
2844
2808
|
"required": false,
|
|
2845
|
-
"note": "The
|
|
2809
|
+
"note": "The app's own rows in the ⋯ menu: `MenuItem`s."
|
|
2846
2810
|
},
|
|
2847
2811
|
{
|
|
2848
|
-
"name": "
|
|
2849
|
-
"takes": "
|
|
2812
|
+
"name": "className",
|
|
2813
|
+
"takes": "text",
|
|
2850
2814
|
"required": false,
|
|
2851
|
-
"note": "
|
|
2815
|
+
"note": "Placement only."
|
|
2852
2816
|
}
|
|
2853
2817
|
],
|
|
2854
2818
|
"variants": [],
|
|
2855
2819
|
"ownsBehaviours": [],
|
|
2856
2820
|
"status": "stable",
|
|
2857
2821
|
"migrationStage": null,
|
|
2858
|
-
"docsId": "
|
|
2859
|
-
"storyId": "
|
|
2860
|
-
"docPage": "src/
|
|
2861
|
-
"app": null,
|
|
2862
|
-
"looks": []
|
|
2863
|
-
},
|
|
2864
|
-
{
|
|
2865
|
-
"name": "duplicateBlock",
|
|
2866
|
-
"repo": "estiva-ui",
|
|
2867
|
-
"kind": "helper",
|
|
2868
|
-
"importPath": "@estiva-app/ui/editor",
|
|
2869
|
-
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
2870
|
-
"purpose": "A copy of the block straight after it, the caret in the copy.",
|
|
2871
|
-
"purposeFrom": "comment",
|
|
2872
|
-
"props": [],
|
|
2873
|
-
"variants": [],
|
|
2874
|
-
"ownsBehaviours": [],
|
|
2875
|
-
"status": "stable",
|
|
2876
|
-
"migrationStage": null,
|
|
2877
|
-
"docsId": "writing-editorblockhandle--docs",
|
|
2878
|
-
"storyId": "writing-editorblockhandle--default",
|
|
2879
|
-
"docPage": null,
|
|
2822
|
+
"docsId": "conversation-conversationcard--docs",
|
|
2823
|
+
"storyId": "conversation-conversationcard--comment",
|
|
2824
|
+
"docPage": "src/ConversationCard.mdx",
|
|
2880
2825
|
"app": null,
|
|
2881
|
-
"looks": [
|
|
2826
|
+
"looks": [
|
|
2827
|
+
"[&>div]:line-clamp-1 [&>div]:max-h-[1lh] [&>div>*:not(p):not(ul):not(ol):not(blockquote):not(pre):not(div:only-child)]:hidden [&>div>div:only-child>*:not(p):not(ul):not(ol):not(blockquote):not(pre)]:hidden"
|
|
2828
|
+
]
|
|
2882
2829
|
},
|
|
2883
2830
|
{
|
|
2884
|
-
"name": "
|
|
2831
|
+
"name": "ConversationLayout",
|
|
2885
2832
|
"repo": "estiva-ui",
|
|
2886
2833
|
"kind": "component",
|
|
2887
2834
|
"importPath": "@estiva-app/ui",
|
|
2888
|
-
"sourceFile": "src/
|
|
2889
|
-
"purpose": "
|
|
2835
|
+
"sourceFile": "src/ConversationLayout.tsx",
|
|
2836
|
+
"purpose": "Where a conversation's cards sit: two columns, or one 384px column beside the page.",
|
|
2890
2837
|
"purposeFrom": "page",
|
|
2891
2838
|
"props": [
|
|
2892
2839
|
{
|
|
2893
|
-
"name": "
|
|
2894
|
-
"takes": "
|
|
2840
|
+
"name": "threads",
|
|
2841
|
+
"takes": "beside | under",
|
|
2895
2842
|
"required": true,
|
|
2896
|
-
"note":
|
|
2843
|
+
"note": "Where an open thread stands. `beside`, two columns: the comments fill the page, the thread stands in the 384px column beside them."
|
|
2897
2844
|
},
|
|
2898
2845
|
{
|
|
2899
|
-
"name": "
|
|
2900
|
-
"takes": "
|
|
2846
|
+
"name": "items",
|
|
2847
|
+
"takes": "readonly ConversationItem[]",
|
|
2901
2848
|
"required": true,
|
|
2902
2849
|
"note": null
|
|
2903
2850
|
},
|
|
2904
2851
|
{
|
|
2905
|
-
"name": "
|
|
2852
|
+
"name": "open",
|
|
2853
|
+
"takes": "text",
|
|
2854
|
+
"required": false,
|
|
2855
|
+
"note": "The id of the comment whose thread is open."
|
|
2856
|
+
},
|
|
2857
|
+
{
|
|
2858
|
+
"name": "onOpenChange",
|
|
2906
2859
|
"takes": "a handler",
|
|
2907
|
-
"required":
|
|
2908
|
-
"note": "
|
|
2860
|
+
"required": false,
|
|
2861
|
+
"note": "A comment asks to open or close its thread: a press anywhere on its card, its replies row, or Reply."
|
|
2909
2862
|
},
|
|
2910
2863
|
{
|
|
2911
|
-
"name": "
|
|
2864
|
+
"name": "box",
|
|
2865
|
+
"takes": "anything",
|
|
2866
|
+
"required": false,
|
|
2867
|
+
"note": "The box a new comment is written in, under the comments."
|
|
2868
|
+
},
|
|
2869
|
+
{
|
|
2870
|
+
"name": "above",
|
|
2871
|
+
"takes": "anything",
|
|
2872
|
+
"required": false,
|
|
2873
|
+
"note": "Above the comments, inside their list: a `ReactionHorizon`, a note."
|
|
2874
|
+
},
|
|
2875
|
+
{
|
|
2876
|
+
"name": "loading",
|
|
2912
2877
|
"takes": "true/false",
|
|
2913
2878
|
"required": false,
|
|
2914
|
-
"note":
|
|
2879
|
+
"note": "Still reading the comments."
|
|
2915
2880
|
},
|
|
2916
2881
|
{
|
|
2917
|
-
"name": "
|
|
2882
|
+
"name": "empty",
|
|
2918
2883
|
"takes": "text",
|
|
2919
2884
|
"required": false,
|
|
2920
|
-
"note": "
|
|
2885
|
+
"note": "What an empty conversation says."
|
|
2921
2886
|
},
|
|
2922
2887
|
{
|
|
2923
|
-
"name": "
|
|
2924
|
-
"takes": "
|
|
2925
|
-
"required":
|
|
2926
|
-
"note": "
|
|
2888
|
+
"name": "header",
|
|
2889
|
+
"takes": "anything",
|
|
2890
|
+
"required": false,
|
|
2891
|
+
"note": "Two columns: the comments' own header, a `PageHeader`, over their column only, so the thread beside them runs the page's full height (Peek's way)."
|
|
2927
2892
|
},
|
|
2928
2893
|
{
|
|
2929
|
-
"name": "
|
|
2930
|
-
"takes": "
|
|
2894
|
+
"name": "title",
|
|
2895
|
+
"takes": "anything",
|
|
2931
2896
|
"required": false,
|
|
2932
|
-
"note": "
|
|
2897
|
+
"note": "One column: its name, in its header."
|
|
2933
2898
|
},
|
|
2934
2899
|
{
|
|
2935
|
-
"name": "
|
|
2900
|
+
"name": "actions",
|
|
2936
2901
|
"takes": "anything",
|
|
2937
2902
|
"required": false,
|
|
2938
|
-
"note": "
|
|
2903
|
+
"note": "One column: its header's actions, as a `Panel`'s."
|
|
2939
2904
|
},
|
|
2940
2905
|
{
|
|
2941
|
-
"name": "
|
|
2942
|
-
"takes": "
|
|
2906
|
+
"name": "className",
|
|
2907
|
+
"takes": "text",
|
|
2943
2908
|
"required": false,
|
|
2944
|
-
"note": "
|
|
2909
|
+
"note": "Placement only."
|
|
2945
2910
|
}
|
|
2946
2911
|
],
|
|
2947
|
-
"variants": [
|
|
2948
|
-
"ownsBehaviours": [
|
|
2912
|
+
"variants": [
|
|
2949
2913
|
{
|
|
2950
|
-
"
|
|
2951
|
-
"
|
|
2914
|
+
"prop": "threads",
|
|
2915
|
+
"values": [
|
|
2916
|
+
"beside",
|
|
2917
|
+
"under"
|
|
2918
|
+
]
|
|
2952
2919
|
}
|
|
2953
2920
|
],
|
|
2921
|
+
"ownsBehaviours": [],
|
|
2954
2922
|
"status": "stable",
|
|
2955
2923
|
"migrationStage": null,
|
|
2956
|
-
"docsId": "
|
|
2957
|
-
"storyId": "
|
|
2958
|
-
"docPage": "src/
|
|
2924
|
+
"docsId": "conversation-conversationlayout--docs",
|
|
2925
|
+
"storyId": "conversation-conversationlayout--two-columns",
|
|
2926
|
+
"docPage": "src/ConversationLayout.mdx",
|
|
2959
2927
|
"app": null,
|
|
2960
|
-
"looks": [
|
|
2961
|
-
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none",
|
|
2962
|
-
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none resize-none",
|
|
2963
|
-
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-primary",
|
|
2964
|
-
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-muted",
|
|
2965
|
-
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-primary",
|
|
2966
|
-
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-muted",
|
|
2967
|
-
"rounded-md border border-transparent text-left transition-colors hover:border-border-default"
|
|
2968
|
-
]
|
|
2928
|
+
"looks": []
|
|
2969
2929
|
},
|
|
2970
2930
|
{
|
|
2971
|
-
"name": "
|
|
2931
|
+
"name": "ConversationMenu",
|
|
2972
2932
|
"repo": "estiva-ui",
|
|
2973
2933
|
"kind": "component",
|
|
2974
|
-
"importPath": "@estiva-app/ui
|
|
2975
|
-
"sourceFile": "src/
|
|
2976
|
-
"purpose": "
|
|
2934
|
+
"importPath": "@estiva-app/ui",
|
|
2935
|
+
"sourceFile": "src/ConversationMenu.tsx",
|
|
2936
|
+
"purpose": "The ⋯ menu of a comment or a reply: Resolve or Reopen, the app's own rows, then Edit and Delete on your own.",
|
|
2977
2937
|
"purposeFrom": "page",
|
|
2978
2938
|
"props": [
|
|
2979
2939
|
{
|
|
2980
|
-
"name": "
|
|
2981
|
-
"takes": "
|
|
2982
|
-
"required":
|
|
2983
|
-
"note": "
|
|
2940
|
+
"name": "resolved",
|
|
2941
|
+
"takes": "true/false",
|
|
2942
|
+
"required": false,
|
|
2943
|
+
"note": "Resolved: the menu offers Reopen in place of Resolve."
|
|
2984
2944
|
},
|
|
2985
2945
|
{
|
|
2986
|
-
"name": "
|
|
2946
|
+
"name": "onResolve",
|
|
2987
2947
|
"takes": "a handler",
|
|
2988
2948
|
"required": false,
|
|
2989
|
-
"note":
|
|
2949
|
+
"note": null
|
|
2990
2950
|
},
|
|
2991
2951
|
{
|
|
2992
|
-
"name": "
|
|
2952
|
+
"name": "onReopen",
|
|
2993
2953
|
"takes": "a handler",
|
|
2994
2954
|
"required": false,
|
|
2995
|
-
"note":
|
|
2955
|
+
"note": null
|
|
2996
2956
|
},
|
|
2997
2957
|
{
|
|
2998
2958
|
"name": "children",
|
|
2999
2959
|
"takes": "anything",
|
|
3000
|
-
"required":
|
|
3001
|
-
"note": "The `
|
|
2960
|
+
"required": false,
|
|
2961
|
+
"note": "The app's own rows, between Resolve and Edit: `MenuItem`s."
|
|
3002
2962
|
},
|
|
3003
2963
|
{
|
|
3004
|
-
"name": "
|
|
3005
|
-
"takes": "
|
|
2964
|
+
"name": "onEdit",
|
|
2965
|
+
"takes": "a handler",
|
|
3006
2966
|
"required": false,
|
|
3007
|
-
"note":
|
|
3008
|
-
}
|
|
3009
|
-
|
|
3010
|
-
|
|
3011
|
-
|
|
3012
|
-
|
|
2967
|
+
"note": "Offered on your own only."
|
|
2968
|
+
},
|
|
2969
|
+
{
|
|
2970
|
+
"name": "onDelete",
|
|
2971
|
+
"takes": "a handler",
|
|
2972
|
+
"required": false,
|
|
2973
|
+
"note": "Offered on your own only; the card asks before it deletes."
|
|
2974
|
+
},
|
|
2975
|
+
{
|
|
2976
|
+
"name": "open",
|
|
2977
|
+
"takes": "true/false",
|
|
2978
|
+
"required": false,
|
|
2979
|
+
"note": null
|
|
2980
|
+
},
|
|
2981
|
+
{
|
|
2982
|
+
"name": "onOpenChange",
|
|
2983
|
+
"takes": "a handler",
|
|
2984
|
+
"required": false,
|
|
2985
|
+
"note": null
|
|
2986
|
+
},
|
|
2987
|
+
{
|
|
2988
|
+
"name": "trigger",
|
|
2989
|
+
"takes": "anything",
|
|
2990
|
+
"required": false,
|
|
2991
|
+
"note": "The button that opens it: a `ToolbarButton` inside `ConversationActions`."
|
|
2992
|
+
}
|
|
2993
|
+
],
|
|
2994
|
+
"variants": [],
|
|
2995
|
+
"ownsBehaviours": [
|
|
2996
|
+
{
|
|
2997
|
+
"id": "portal",
|
|
2998
|
+
"behaviour": "Floats on top of the page"
|
|
2999
|
+
},
|
|
3000
|
+
{
|
|
3001
|
+
"id": "press-outside",
|
|
3002
|
+
"behaviour": "Closes on a press outside"
|
|
3003
|
+
},
|
|
3004
|
+
{
|
|
3005
|
+
"id": "page-keys",
|
|
3006
|
+
"behaviour": "Takes its keys by itself"
|
|
3007
|
+
},
|
|
3008
|
+
{
|
|
3009
|
+
"id": "focus",
|
|
3010
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
3011
|
+
},
|
|
3012
|
+
{
|
|
3013
|
+
"id": "follow",
|
|
3014
|
+
"behaviour": "Stays attached to its anchor on scroll and resize"
|
|
3015
|
+
}
|
|
3016
|
+
],
|
|
3017
|
+
"status": "stable",
|
|
3018
|
+
"migrationStage": null,
|
|
3019
|
+
"docsId": "conversation-conversationmenu--docs",
|
|
3020
|
+
"storyId": "conversation-conversationmenu--yours",
|
|
3021
|
+
"docPage": "src/ConversationMenu.mdx",
|
|
3022
|
+
"app": null,
|
|
3023
|
+
"looks": []
|
|
3024
|
+
},
|
|
3025
|
+
{
|
|
3026
|
+
"name": "deleteBlock",
|
|
3027
|
+
"repo": "estiva-ui",
|
|
3028
|
+
"kind": "helper",
|
|
3029
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3030
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3031
|
+
"purpose": "Removes the block, the caret where it was.",
|
|
3032
|
+
"purposeFrom": "comment",
|
|
3033
|
+
"props": [],
|
|
3034
|
+
"variants": [],
|
|
3035
|
+
"ownsBehaviours": [],
|
|
3036
|
+
"status": "stable",
|
|
3037
|
+
"migrationStage": null,
|
|
3038
|
+
"docsId": "writing-editorblockhandle--docs",
|
|
3039
|
+
"storyId": "writing-editorblockhandle--default",
|
|
3040
|
+
"docPage": null,
|
|
3041
|
+
"app": null,
|
|
3042
|
+
"looks": []
|
|
3043
|
+
},
|
|
3044
|
+
{
|
|
3045
|
+
"name": "deleteTableColumn",
|
|
3046
|
+
"repo": "estiva-ui",
|
|
3047
|
+
"kind": "helper",
|
|
3048
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3049
|
+
"sourceFile": "src/EditorTableControls.tsx",
|
|
3050
|
+
"purpose": "The same for a column: the last one deletes the table.",
|
|
3051
|
+
"purposeFrom": "comment",
|
|
3052
|
+
"props": [],
|
|
3053
|
+
"variants": [],
|
|
3054
|
+
"ownsBehaviours": [],
|
|
3055
|
+
"status": "stable",
|
|
3056
|
+
"migrationStage": null,
|
|
3057
|
+
"docsId": "writing-editortablecontrols--docs",
|
|
3058
|
+
"storyId": "writing-editortablecontrols--default",
|
|
3059
|
+
"docPage": null,
|
|
3060
|
+
"app": null,
|
|
3061
|
+
"looks": []
|
|
3062
|
+
},
|
|
3063
|
+
{
|
|
3064
|
+
"name": "deleteTableRow",
|
|
3065
|
+
"repo": "estiva-ui",
|
|
3066
|
+
"kind": "helper",
|
|
3067
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3068
|
+
"sourceFile": "src/EditorTableControls.tsx",
|
|
3069
|
+
"purpose": "The cell's row, or the whole table when it is its only one: a table holds at least one row (prosemirror-tables refuses to delete it).",
|
|
3070
|
+
"purposeFrom": "comment",
|
|
3071
|
+
"props": [],
|
|
3072
|
+
"variants": [],
|
|
3073
|
+
"ownsBehaviours": [],
|
|
3074
|
+
"status": "stable",
|
|
3075
|
+
"migrationStage": null,
|
|
3076
|
+
"docsId": "writing-editortablecontrols--docs",
|
|
3077
|
+
"storyId": "writing-editortablecontrols--default",
|
|
3078
|
+
"docPage": null,
|
|
3079
|
+
"app": null,
|
|
3080
|
+
"looks": []
|
|
3081
|
+
},
|
|
3082
|
+
{
|
|
3083
|
+
"name": "DialogShell",
|
|
3084
|
+
"repo": "estiva-ui",
|
|
3085
|
+
"kind": "component",
|
|
3086
|
+
"importPath": "@estiva-app/ui",
|
|
3087
|
+
"sourceFile": "src/DialogShell.tsx",
|
|
3088
|
+
"purpose": "The dialog, minus what it says: the portal, the backdrop, a 502px card, a 48px header with the title and a close button, a body, and a 48px footer for the buttons.",
|
|
3089
|
+
"purposeFrom": "page",
|
|
3090
|
+
"props": [
|
|
3091
|
+
{
|
|
3092
|
+
"name": "title",
|
|
3093
|
+
"takes": "text",
|
|
3094
|
+
"required": true,
|
|
3095
|
+
"note": "Labels the dialog for assistive tech, and renders as the header text unless `headerContent` replaces it."
|
|
3096
|
+
},
|
|
3097
|
+
{
|
|
3098
|
+
"name": "onClose",
|
|
3099
|
+
"takes": "a handler",
|
|
3100
|
+
"required": true,
|
|
3101
|
+
"note": null
|
|
3102
|
+
},
|
|
3103
|
+
{
|
|
3104
|
+
"name": "headerContent",
|
|
3105
|
+
"takes": "anything",
|
|
3106
|
+
"required": false,
|
|
3107
|
+
"note": "Replaces the title text in the header — a back button beside the title, a count chip after it."
|
|
3108
|
+
},
|
|
3109
|
+
{
|
|
3110
|
+
"name": "footer",
|
|
3111
|
+
"takes": "anything",
|
|
3112
|
+
"required": false,
|
|
3113
|
+
"note": "Absent: no footer row, and the body keeps the card's own bottom edge (a roster that simply ends)."
|
|
3114
|
+
},
|
|
3115
|
+
{
|
|
3116
|
+
"name": "children",
|
|
3117
|
+
"takes": "anything",
|
|
3118
|
+
"required": true,
|
|
3119
|
+
"note": null
|
|
3120
|
+
},
|
|
3121
|
+
{
|
|
3122
|
+
"name": "bodyClassName",
|
|
3123
|
+
"takes": "text",
|
|
3124
|
+
"required": false,
|
|
3125
|
+
"note": "Extra classes on the body: its layout and any padding override (`flex flex-col gap-6`, `p-0 py-2`)."
|
|
3126
|
+
},
|
|
3127
|
+
{
|
|
3128
|
+
"name": "bodyMaxHeight",
|
|
3129
|
+
"takes": "text",
|
|
3130
|
+
"required": false,
|
|
3131
|
+
"note": "How tall the body may get before it scrolls, as the cap class — `max-h-[400px]`, `max-h-[70vh]`."
|
|
3132
|
+
},
|
|
3133
|
+
{
|
|
3134
|
+
"name": "width",
|
|
3135
|
+
"takes": "number",
|
|
3136
|
+
"required": false,
|
|
3137
|
+
"note": null
|
|
3138
|
+
},
|
|
3139
|
+
{
|
|
3140
|
+
"name": "alert",
|
|
3141
|
+
"takes": "true/false",
|
|
3142
|
+
"required": false,
|
|
3143
|
+
"note": "A question that has to be answered rather than clicked away: a press on the backdrop no longer closes it, and it announces itself as an alert."
|
|
3144
|
+
}
|
|
3145
|
+
],
|
|
3146
|
+
"variants": [],
|
|
3147
|
+
"ownsBehaviours": [
|
|
3148
|
+
{
|
|
3149
|
+
"id": "base-ui",
|
|
3150
|
+
"behaviour": "Is built on Base UI"
|
|
3151
|
+
},
|
|
3152
|
+
{
|
|
3153
|
+
"id": "portal",
|
|
3154
|
+
"behaviour": "Floats on top of the page"
|
|
3155
|
+
},
|
|
3156
|
+
{
|
|
3157
|
+
"id": "press-outside",
|
|
3158
|
+
"behaviour": "Closes on a press outside"
|
|
3159
|
+
},
|
|
3160
|
+
{
|
|
3161
|
+
"id": "page-keys",
|
|
3162
|
+
"behaviour": "Takes its keys by itself"
|
|
3163
|
+
},
|
|
3164
|
+
{
|
|
3165
|
+
"id": "focus",
|
|
3166
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
3167
|
+
},
|
|
3168
|
+
{
|
|
3169
|
+
"id": "scroll-lock",
|
|
3170
|
+
"behaviour": "Stops the page behind it scrolling"
|
|
3171
|
+
},
|
|
3172
|
+
{
|
|
3173
|
+
"id": "role",
|
|
3174
|
+
"behaviour": "Says what it is to assistive technology"
|
|
3175
|
+
}
|
|
3176
|
+
],
|
|
3177
|
+
"status": "stable",
|
|
3178
|
+
"migrationStage": null,
|
|
3179
|
+
"docsId": "menus-windows-dialogshell--docs",
|
|
3180
|
+
"storyId": "menus-windows-dialogshell--default",
|
|
3181
|
+
"docPage": "src/DialogShell.mdx",
|
|
3182
|
+
"app": null,
|
|
3183
|
+
"looks": [
|
|
3184
|
+
"bg-bg-elevated border border-border-subtle rounded-lg shadow-lg pointer-events-auto overflow-hidden outline-none"
|
|
3185
|
+
]
|
|
3186
|
+
},
|
|
3187
|
+
{
|
|
3188
|
+
"name": "Divider",
|
|
3189
|
+
"repo": "estiva-ui",
|
|
3190
|
+
"kind": "component",
|
|
3191
|
+
"importPath": "@estiva-app/ui",
|
|
3192
|
+
"sourceFile": "src/Divider.tsx",
|
|
3193
|
+
"purpose": "A hairline in `border-subtle`. Horizontal it is inset 12px each side; `orientation=\"vertical\"` stands it up to its row's height, no inset.",
|
|
3194
|
+
"purposeFrom": "page",
|
|
3195
|
+
"props": [
|
|
3196
|
+
{
|
|
3197
|
+
"name": "orientation",
|
|
3198
|
+
"takes": "horizontal | vertical",
|
|
3199
|
+
"required": false,
|
|
3200
|
+
"note": null
|
|
3201
|
+
},
|
|
3202
|
+
{
|
|
3203
|
+
"name": "label",
|
|
3204
|
+
"takes": "anything",
|
|
3205
|
+
"required": false,
|
|
3206
|
+
"note": "Words in the middle of the line — \"New since you last read this\", a date."
|
|
3207
|
+
},
|
|
3208
|
+
{
|
|
3209
|
+
"name": "look",
|
|
3210
|
+
"takes": "caption | section",
|
|
3211
|
+
"required": false,
|
|
3212
|
+
"note": "How the words in the middle are drawn."
|
|
3213
|
+
},
|
|
3214
|
+
{
|
|
3215
|
+
"name": "sticky",
|
|
3216
|
+
"takes": "true/false",
|
|
3217
|
+
"required": false,
|
|
3218
|
+
"note": "Stays at the top of the list that scrolls under it until the next one takes its place: `sticky top-0` on the surface's fill, as Peek's date lines are."
|
|
3219
|
+
},
|
|
3220
|
+
{
|
|
3221
|
+
"name": "tone",
|
|
3222
|
+
"takes": "default | warning",
|
|
3223
|
+
"required": false,
|
|
3224
|
+
"note": "`warning` for a line that asks for attention: the label in the warning colour, the lines in its wash."
|
|
3225
|
+
},
|
|
3226
|
+
{
|
|
3227
|
+
"name": "className",
|
|
3228
|
+
"takes": "text",
|
|
3229
|
+
"required": false,
|
|
3230
|
+
"note": null
|
|
3231
|
+
}
|
|
3232
|
+
],
|
|
3233
|
+
"variants": [
|
|
3234
|
+
{
|
|
3235
|
+
"prop": "orientation",
|
|
3236
|
+
"values": [
|
|
3237
|
+
"horizontal",
|
|
3238
|
+
"vertical"
|
|
3239
|
+
]
|
|
3240
|
+
},
|
|
3241
|
+
{
|
|
3242
|
+
"prop": "look",
|
|
3243
|
+
"values": [
|
|
3244
|
+
"caption",
|
|
3245
|
+
"section"
|
|
3246
|
+
]
|
|
3247
|
+
},
|
|
3248
|
+
{
|
|
3249
|
+
"prop": "tone",
|
|
3250
|
+
"values": [
|
|
3251
|
+
"default",
|
|
3252
|
+
"warning"
|
|
3253
|
+
]
|
|
3254
|
+
}
|
|
3255
|
+
],
|
|
3256
|
+
"ownsBehaviours": [
|
|
3257
|
+
{
|
|
3258
|
+
"id": "base-ui",
|
|
3259
|
+
"behaviour": "Is built on Base UI"
|
|
3260
|
+
},
|
|
3261
|
+
{
|
|
3262
|
+
"id": "role",
|
|
3263
|
+
"behaviour": "Says what it is to assistive technology"
|
|
3264
|
+
}
|
|
3265
|
+
],
|
|
3266
|
+
"status": "stable",
|
|
3267
|
+
"migrationStage": null,
|
|
3268
|
+
"docsId": "page-structure-divider--docs",
|
|
3269
|
+
"storyId": "page-structure-divider--default",
|
|
3270
|
+
"docPage": "src/Divider.mdx",
|
|
3271
|
+
"app": null,
|
|
3272
|
+
"looks": []
|
|
3273
|
+
},
|
|
3274
|
+
{
|
|
3275
|
+
"name": "DocumentEditor",
|
|
3276
|
+
"repo": "estiva-ui",
|
|
3277
|
+
"kind": "component",
|
|
3278
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3279
|
+
"sourceFile": "src/DocumentEditor.tsx",
|
|
3280
|
+
"purpose": "One document's text as one surface that is always an editor, the same in every app: `/`, `[` and `@`, links on words, files, checklists, callouts and tables, the block handle, saving when you leave, someone else's save arriving, and the text held when the sign-in ends.",
|
|
3281
|
+
"purposeFrom": "page",
|
|
3282
|
+
"props": [
|
|
3283
|
+
{
|
|
3284
|
+
"name": "value",
|
|
3285
|
+
"takes": "text",
|
|
3286
|
+
"required": true,
|
|
3287
|
+
"note": "The saved text. A new value while the editor is open is somebody else's save, or your own coming back."
|
|
3288
|
+
},
|
|
3289
|
+
{
|
|
3290
|
+
"name": "format",
|
|
3291
|
+
"takes": "text",
|
|
3292
|
+
"required": true,
|
|
3293
|
+
"note": "The format `value` is in, handed to `codec.read`."
|
|
3294
|
+
},
|
|
3295
|
+
{
|
|
3296
|
+
"name": "codec",
|
|
3297
|
+
"takes": "DocumentCodec",
|
|
3298
|
+
"required": true,
|
|
3299
|
+
"note": null
|
|
3300
|
+
},
|
|
3301
|
+
{
|
|
3302
|
+
"name": "onCommit",
|
|
3303
|
+
"takes": "a handler",
|
|
3304
|
+
"required": true,
|
|
3305
|
+
"note": "Save. Called when you leave, never while typing, with the text, its format, and the saved text this edit started from — so the app can tell whom the save names anew."
|
|
3306
|
+
},
|
|
3307
|
+
{
|
|
3308
|
+
"name": "label",
|
|
3309
|
+
"takes": "text",
|
|
3310
|
+
"required": true,
|
|
3311
|
+
"note": "The editor's accessible name."
|
|
3312
|
+
},
|
|
3313
|
+
{
|
|
3314
|
+
"name": "placeholder",
|
|
3315
|
+
"takes": "anything",
|
|
3316
|
+
"required": false,
|
|
3317
|
+
"note": "Muted words over an empty editor."
|
|
3318
|
+
},
|
|
3319
|
+
{
|
|
3320
|
+
"name": "readOnly",
|
|
3321
|
+
"takes": "true/false",
|
|
3322
|
+
"required": false,
|
|
3323
|
+
"note": "For reading: nothing is typed or saved; chips open, and comments on a selection work when on."
|
|
3324
|
+
},
|
|
3325
|
+
{
|
|
3326
|
+
"name": "changedBy",
|
|
3327
|
+
"takes": "{ name: string } | null",
|
|
3328
|
+
"required": false,
|
|
3329
|
+
"note": "Who saved the text last, when it was not you: named in \"… saved a newer version\"."
|
|
3330
|
+
},
|
|
3331
|
+
{
|
|
3332
|
+
"name": "onLeftUnsaved",
|
|
3333
|
+
"takes": "a handler",
|
|
3334
|
+
"required": false,
|
|
3335
|
+
"note": "A save refused after the editor closed, with nothing left on screen to say it."
|
|
3336
|
+
},
|
|
3337
|
+
{
|
|
3338
|
+
"name": "hold",
|
|
3339
|
+
"takes": "HeldTyping",
|
|
3340
|
+
"required": false,
|
|
3341
|
+
"note": "Where text typed when the sign-in ends is held, under `holdKey`."
|
|
3342
|
+
},
|
|
3343
|
+
{
|
|
3344
|
+
"name": "holdKey",
|
|
3345
|
+
"takes": "text",
|
|
3346
|
+
"required": false,
|
|
3347
|
+
"note": null
|
|
3348
|
+
},
|
|
3349
|
+
{
|
|
3350
|
+
"name": "references",
|
|
3351
|
+
"takes": "DocumentReferences",
|
|
3352
|
+
"required": false,
|
|
3353
|
+
"note": "`[` and `/` → File."
|
|
3354
|
+
},
|
|
3355
|
+
{
|
|
3356
|
+
"name": "mentions",
|
|
3357
|
+
"takes": "DocumentMentions",
|
|
3358
|
+
"required": false,
|
|
3359
|
+
"note": "`@` and `/` → Mention."
|
|
3360
|
+
},
|
|
3361
|
+
{
|
|
3362
|
+
"name": "linkChips",
|
|
3363
|
+
"takes": "LinkChipsOptions",
|
|
3364
|
+
"required": false,
|
|
3365
|
+
"note": "A pasted app URL drawn as the chip of what it names (`LinkChips`)."
|
|
3366
|
+
},
|
|
3367
|
+
{
|
|
3368
|
+
"name": "upload",
|
|
3369
|
+
"takes": "a handler",
|
|
3370
|
+
"required": false,
|
|
3371
|
+
"note": "`/` → Upload, and a pasted picture: upload one file and answer the attachment's attributes (its `imeta` fields)."
|
|
3372
|
+
},
|
|
3373
|
+
{
|
|
3374
|
+
"name": "readMarkdown",
|
|
3375
|
+
"takes": "a handler",
|
|
3376
|
+
"required": false,
|
|
3377
|
+
"note": "Plain text pasted as the blocks it spells: the app's reader of markdown, as the editor's document."
|
|
3378
|
+
},
|
|
3379
|
+
{
|
|
3380
|
+
"name": "table",
|
|
3381
|
+
"takes": "true/false",
|
|
3382
|
+
"required": false,
|
|
3383
|
+
"note": "`/` → Table. Default on."
|
|
3384
|
+
},
|
|
3385
|
+
{
|
|
3386
|
+
"name": "onCommentOnSelection",
|
|
3387
|
+
"takes": "a handler",
|
|
3388
|
+
"required": false,
|
|
3389
|
+
"note": "Comment on what is selected: the selection strip's Comment, and the comment highlights."
|
|
3390
|
+
},
|
|
3391
|
+
{
|
|
3392
|
+
"name": "blockRows",
|
|
3393
|
+
"takes": "a handler",
|
|
3394
|
+
"required": false,
|
|
3395
|
+
"note": "The app's rows in a block's handle menu, after the editing ones: Copy link, Comment."
|
|
3396
|
+
},
|
|
3397
|
+
{
|
|
3398
|
+
"name": "referenceView",
|
|
3399
|
+
"takes": "ComponentType<ReferenceViewProps>",
|
|
3400
|
+
"required": false,
|
|
3401
|
+
"note": "Draws a link: the app's own, which resolves what it names — its chip, its row or its card in the row's place, as `place` says (§13.3)."
|
|
3402
|
+
},
|
|
3403
|
+
{
|
|
3404
|
+
"name": "attachmentView",
|
|
3405
|
+
"takes": "ComponentType<AttachmentViewProps>",
|
|
3406
|
+
"required": false,
|
|
3407
|
+
"note": "Draws a placed file: the app's own card."
|
|
3408
|
+
},
|
|
3409
|
+
{
|
|
3410
|
+
"name": "wrap",
|
|
3411
|
+
"takes": "a handler",
|
|
3412
|
+
"required": false,
|
|
3413
|
+
"note": "Around everything the editor draws: the app's providers, which may read the editor."
|
|
3414
|
+
},
|
|
3415
|
+
{
|
|
3416
|
+
"name": "onEditor",
|
|
3417
|
+
"takes": "a handler",
|
|
3418
|
+
"required": false,
|
|
3419
|
+
"note": "The editor, once it is there, and `null` as it goes."
|
|
3420
|
+
},
|
|
3421
|
+
{
|
|
3422
|
+
"name": "extensions",
|
|
3423
|
+
"takes": "readonly AnyExtension[]",
|
|
3424
|
+
"required": false,
|
|
3425
|
+
"note": "More of the app's own extensions."
|
|
3426
|
+
}
|
|
3427
|
+
],
|
|
3428
|
+
"variants": [],
|
|
3429
|
+
"ownsBehaviours": [],
|
|
3430
|
+
"status": "stable",
|
|
3431
|
+
"migrationStage": null,
|
|
3432
|
+
"docsId": "writing-documenteditor--docs",
|
|
3433
|
+
"storyId": "writing-documenteditor--with-comments",
|
|
3434
|
+
"docPage": "src/DocumentEditor.mdx",
|
|
3435
|
+
"app": null,
|
|
3436
|
+
"looks": []
|
|
3437
|
+
},
|
|
3438
|
+
{
|
|
3439
|
+
"name": "duplicateBlock",
|
|
3440
|
+
"repo": "estiva-ui",
|
|
3441
|
+
"kind": "helper",
|
|
3442
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3443
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3444
|
+
"purpose": "A copy of the block straight after it, the caret in the copy.",
|
|
3445
|
+
"purposeFrom": "comment",
|
|
3446
|
+
"props": [],
|
|
3447
|
+
"variants": [],
|
|
3448
|
+
"ownsBehaviours": [],
|
|
3449
|
+
"status": "stable",
|
|
3450
|
+
"migrationStage": null,
|
|
3451
|
+
"docsId": "writing-editorblockhandle--docs",
|
|
3452
|
+
"storyId": "writing-editorblockhandle--default",
|
|
3453
|
+
"docPage": null,
|
|
3454
|
+
"app": null,
|
|
3455
|
+
"looks": []
|
|
3456
|
+
},
|
|
3457
|
+
{
|
|
3458
|
+
"name": "EditableText",
|
|
3459
|
+
"repo": "estiva-ui",
|
|
3460
|
+
"kind": "component",
|
|
3461
|
+
"importPath": "@estiva-app/ui",
|
|
3462
|
+
"sourceFile": "src/EditableText.tsx",
|
|
3463
|
+
"purpose": "Text you click to edit. It reads as text until clicked; then it is a field.",
|
|
3464
|
+
"purposeFrom": "page",
|
|
3465
|
+
"props": [
|
|
3466
|
+
{
|
|
3467
|
+
"name": "value",
|
|
3468
|
+
"takes": "text",
|
|
3469
|
+
"required": true,
|
|
3470
|
+
"note": null
|
|
3471
|
+
},
|
|
3472
|
+
{
|
|
3473
|
+
"name": "placeholder",
|
|
3474
|
+
"takes": "text",
|
|
3475
|
+
"required": true,
|
|
3476
|
+
"note": null
|
|
3477
|
+
},
|
|
3478
|
+
{
|
|
3479
|
+
"name": "onCommit",
|
|
3480
|
+
"takes": "a handler",
|
|
3481
|
+
"required": true,
|
|
3482
|
+
"note": "Resolve `true` when saved; `false` (or throw) keeps the field open with the text."
|
|
3483
|
+
},
|
|
3484
|
+
{
|
|
3485
|
+
"name": "multiline",
|
|
3486
|
+
"takes": "true/false",
|
|
3487
|
+
"required": false,
|
|
3488
|
+
"note": null
|
|
3489
|
+
},
|
|
3490
|
+
{
|
|
3491
|
+
"name": "className",
|
|
3492
|
+
"takes": "text",
|
|
3493
|
+
"required": false,
|
|
3494
|
+
"note": "Applied to both the text and the field, so they are the same size."
|
|
3495
|
+
},
|
|
3496
|
+
{
|
|
3497
|
+
"name": "label",
|
|
3498
|
+
"takes": "text",
|
|
3499
|
+
"required": true,
|
|
3500
|
+
"note": "The accessible name of the field — \"Title\", \"Description\"."
|
|
3501
|
+
},
|
|
3502
|
+
{
|
|
3503
|
+
"name": "display",
|
|
3504
|
+
"takes": "text",
|
|
3505
|
+
"required": false,
|
|
3506
|
+
"note": "What to *show* when not editing, when that differs from what is edited — a value carrying a raw reference that the caller renders as a live object below the text, say."
|
|
3507
|
+
},
|
|
3508
|
+
{
|
|
3509
|
+
"name": "displayNode",
|
|
3510
|
+
"takes": "anything",
|
|
3511
|
+
"required": false,
|
|
3512
|
+
"note": "What to *draw* when not editing, when the value is structured rather than a line of prose."
|
|
3513
|
+
},
|
|
3514
|
+
{
|
|
3515
|
+
"name": "readOnly",
|
|
3516
|
+
"takes": "true/false",
|
|
3517
|
+
"required": false,
|
|
3518
|
+
"note": "Show the value only — no edit affordance."
|
|
3519
|
+
}
|
|
3520
|
+
],
|
|
3521
|
+
"variants": [],
|
|
3522
|
+
"ownsBehaviours": [
|
|
3523
|
+
{
|
|
3524
|
+
"id": "base-ui",
|
|
3525
|
+
"behaviour": "Is built on Base UI"
|
|
3526
|
+
}
|
|
3527
|
+
],
|
|
3528
|
+
"status": "stable",
|
|
3529
|
+
"migrationStage": null,
|
|
3530
|
+
"docsId": "forms-fields-editabletext--docs",
|
|
3531
|
+
"storyId": "forms-fields-editabletext--title",
|
|
3532
|
+
"docPage": "src/EditableText.mdx",
|
|
3533
|
+
"app": null,
|
|
3534
|
+
"looks": [
|
|
3535
|
+
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none",
|
|
3536
|
+
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none resize-none",
|
|
3537
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-primary",
|
|
3538
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-muted",
|
|
3539
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-primary",
|
|
3540
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-muted",
|
|
3541
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default"
|
|
3542
|
+
]
|
|
3543
|
+
},
|
|
3544
|
+
{
|
|
3545
|
+
"name": "EditedMarker",
|
|
3546
|
+
"repo": "estiva-ui",
|
|
3547
|
+
"kind": "component",
|
|
3548
|
+
"importPath": "@estiva-app/ui",
|
|
3549
|
+
"sourceFile": "src/EditedMarker.tsx",
|
|
3550
|
+
"purpose": "\"(edited)\" beside a time, with when it was edited on hover.",
|
|
3551
|
+
"purposeFrom": "page",
|
|
3552
|
+
"props": [
|
|
3553
|
+
{
|
|
3554
|
+
"name": "edited",
|
|
3555
|
+
"takes": "text",
|
|
3556
|
+
"required": false,
|
|
3557
|
+
"note": "When it was edited, in the app's words for the tooltip (\"Edited 11:20 AM\")."
|
|
3558
|
+
}
|
|
3559
|
+
],
|
|
3560
|
+
"variants": [],
|
|
3561
|
+
"ownsBehaviours": [],
|
|
3562
|
+
"status": "stable",
|
|
3563
|
+
"migrationStage": null,
|
|
3564
|
+
"docsId": "conversation-editedmarker--docs",
|
|
3565
|
+
"storyId": "conversation-editedmarker--edited",
|
|
3566
|
+
"docPage": "src/EditedMarker.mdx",
|
|
3567
|
+
"app": null,
|
|
3568
|
+
"looks": []
|
|
3569
|
+
},
|
|
3570
|
+
{
|
|
3571
|
+
"name": "EditorBlockHandle",
|
|
3572
|
+
"repo": "estiva-ui",
|
|
3573
|
+
"kind": "component",
|
|
3574
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3575
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3576
|
+
"purpose": "`BlockHandle` in a Tiptap editor: drag the handle to move the block, press it for Turn into, Duplicate and Delete, then the app's rows.",
|
|
3577
|
+
"purposeFrom": "page",
|
|
3578
|
+
"props": [
|
|
3579
|
+
{
|
|
3580
|
+
"name": "editor",
|
|
3581
|
+
"takes": "Editor | null",
|
|
3582
|
+
"required": true,
|
|
3583
|
+
"note": "The editor. Not editable, or not there yet, and the handle reads: the caller's rows only."
|
|
3584
|
+
},
|
|
3585
|
+
{
|
|
3586
|
+
"name": "turnInto",
|
|
3587
|
+
"takes": "a handler",
|
|
3588
|
+
"required": false,
|
|
3589
|
+
"note": "Turn into's rows for a block. By default `turnIntoRows`, the same in every app: a block of text, a list and a quote each get theirs."
|
|
3590
|
+
},
|
|
3591
|
+
{
|
|
3592
|
+
"name": "actions",
|
|
3593
|
+
"takes": "a handler",
|
|
3594
|
+
"required": false,
|
|
3595
|
+
"note": "The caller's own rows, after the editing ones."
|
|
3596
|
+
},
|
|
3597
|
+
{
|
|
3598
|
+
"name": "children",
|
|
3599
|
+
"takes": "anything",
|
|
3600
|
+
"required": true,
|
|
3601
|
+
"note": "The `EditorContent`."
|
|
3602
|
+
},
|
|
3603
|
+
{
|
|
3604
|
+
"name": "className",
|
|
3605
|
+
"takes": "text",
|
|
3606
|
+
"required": false,
|
|
3607
|
+
"note": null
|
|
3608
|
+
}
|
|
3609
|
+
],
|
|
3610
|
+
"variants": [],
|
|
3611
|
+
"ownsBehaviours": [],
|
|
3612
|
+
"status": "stable",
|
|
3013
3613
|
"migrationStage": null,
|
|
3014
3614
|
"docsId": "writing-editorblockhandle--docs",
|
|
3015
3615
|
"storyId": "writing-editorblockhandle--default",
|
|
@@ -3677,7 +4277,8 @@
|
|
|
3677
4277
|
"docPage": "src/IconButton.mdx",
|
|
3678
4278
|
"app": null,
|
|
3679
4279
|
"looks": [
|
|
3680
|
-
"border border-border-default hover:bg-bg-hover text-text-secondary"
|
|
4280
|
+
"border border-border-default hover:bg-bg-hover text-text-secondary",
|
|
4281
|
+
"bg-bg-disabled text-text-disabled leaf:bg-transparent leaf:text-text-muted"
|
|
3681
4282
|
]
|
|
3682
4283
|
},
|
|
3683
4284
|
{
|
|
@@ -4835,6 +5436,12 @@
|
|
|
4835
5436
|
"takes": "true/false",
|
|
4836
5437
|
"required": false,
|
|
4837
5438
|
"note": "Draws the values as words even where they could be changed: the hover preview."
|
|
5439
|
+
},
|
|
5440
|
+
{
|
|
5441
|
+
"name": "disabledReason",
|
|
5442
|
+
"takes": "text",
|
|
5443
|
+
"required": false,
|
|
5444
|
+
"note": "Why they cannot be changed right now (an archived file): the pickers stay, shut, saying it on hover."
|
|
4838
5445
|
}
|
|
4839
5446
|
],
|
|
4840
5447
|
"variants": [],
|
|
@@ -5818,6 +6425,65 @@
|
|
|
5818
6425
|
"app": null,
|
|
5819
6426
|
"looks": []
|
|
5820
6427
|
},
|
|
6428
|
+
{
|
|
6429
|
+
"name": "MetaText",
|
|
6430
|
+
"repo": "estiva-ui",
|
|
6431
|
+
"kind": "component",
|
|
6432
|
+
"importPath": "@estiva-app/ui",
|
|
6433
|
+
"sourceFile": "src/MetaText.tsx",
|
|
6434
|
+
"purpose": "The small figure beside a name: a time, a resolve line's time, a count.",
|
|
6435
|
+
"purposeFrom": "page",
|
|
6436
|
+
"props": [
|
|
6437
|
+
{
|
|
6438
|
+
"name": "children",
|
|
6439
|
+
"takes": "anything",
|
|
6440
|
+
"required": true,
|
|
6441
|
+
"note": null
|
|
6442
|
+
},
|
|
6443
|
+
{
|
|
6444
|
+
"name": "tone",
|
|
6445
|
+
"takes": "keyof typeof TONE_CLASSES",
|
|
6446
|
+
"required": false,
|
|
6447
|
+
"note": "`muted` for a time; `secondary` and `success` for counts of open and resolved."
|
|
6448
|
+
},
|
|
6449
|
+
{
|
|
6450
|
+
"name": "size",
|
|
6451
|
+
"takes": "caption | chip",
|
|
6452
|
+
"required": false,
|
|
6453
|
+
"note": "`chip` beside a small name, as in a thread's resolve line."
|
|
6454
|
+
},
|
|
6455
|
+
{
|
|
6456
|
+
"name": "className",
|
|
6457
|
+
"takes": "text",
|
|
6458
|
+
"required": false,
|
|
6459
|
+
"note": "Placement only: `shrink-0`, `contents`."
|
|
6460
|
+
}
|
|
6461
|
+
],
|
|
6462
|
+
"variants": [
|
|
6463
|
+
{
|
|
6464
|
+
"prop": "size",
|
|
6465
|
+
"values": [
|
|
6466
|
+
"caption",
|
|
6467
|
+
"chip"
|
|
6468
|
+
]
|
|
6469
|
+
}
|
|
6470
|
+
],
|
|
6471
|
+
"ownsBehaviours": [],
|
|
6472
|
+
"status": "stable",
|
|
6473
|
+
"migrationStage": null,
|
|
6474
|
+
"docsId": "conversation-metatext--docs",
|
|
6475
|
+
"storyId": "conversation-metatext--time",
|
|
6476
|
+
"docPage": "src/MetaText.mdx",
|
|
6477
|
+
"app": null,
|
|
6478
|
+
"looks": [
|
|
6479
|
+
"text-chip font-normal text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6480
|
+
"text-chip font-normal text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6481
|
+
"text-chip font-normal text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6482
|
+
"text-caption text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6483
|
+
"text-caption text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6484
|
+
"text-caption text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums"
|
|
6485
|
+
]
|
|
6486
|
+
},
|
|
5821
6487
|
{
|
|
5822
6488
|
"name": "moveBlock",
|
|
5823
6489
|
"repo": "estiva-ui",
|
|
@@ -6192,6 +6858,82 @@
|
|
|
6192
6858
|
"app": null,
|
|
6193
6859
|
"looks": []
|
|
6194
6860
|
},
|
|
6861
|
+
{
|
|
6862
|
+
"name": "PageHeader",
|
|
6863
|
+
"repo": "estiva-ui",
|
|
6864
|
+
"kind": "component",
|
|
6865
|
+
"importPath": "@estiva-app/ui",
|
|
6866
|
+
"sourceFile": "src/PageHeader.tsx",
|
|
6867
|
+
"purpose": "The bar at the top of a page: what the page is, and what acts on all of it, each in its own place.",
|
|
6868
|
+
"purposeFrom": "page",
|
|
6869
|
+
"props": [
|
|
6870
|
+
{
|
|
6871
|
+
"name": "title",
|
|
6872
|
+
"takes": "anything",
|
|
6873
|
+
"required": true,
|
|
6874
|
+
"note": "The page's name. A string is one line in `body-2-strong`, cut short with an ellipsis when there is no room."
|
|
6875
|
+
},
|
|
6876
|
+
{
|
|
6877
|
+
"name": "leading",
|
|
6878
|
+
"takes": "anything",
|
|
6879
|
+
"required": false,
|
|
6880
|
+
"note": "Before the title, 16px: an icon at stroke 1.5, or a face (`Avatar size={16}`)."
|
|
6881
|
+
},
|
|
6882
|
+
{
|
|
6883
|
+
"name": "private",
|
|
6884
|
+
"takes": "true/false",
|
|
6885
|
+
"required": false,
|
|
6886
|
+
"note": "A lock before the title: only its members can open this page."
|
|
6887
|
+
},
|
|
6888
|
+
{
|
|
6889
|
+
"name": "after",
|
|
6890
|
+
"takes": "anything",
|
|
6891
|
+
"required": false,
|
|
6892
|
+
"note": "Right after the title, 8px from it, and never cut short: a small `Button`, a `Chip`."
|
|
6893
|
+
},
|
|
6894
|
+
{
|
|
6895
|
+
"name": "meta",
|
|
6896
|
+
"takes": "(string | PageHeaderMeta)[]",
|
|
6897
|
+
"required": false,
|
|
6898
|
+
"note": "Quiet words at the right, before the members: counts."
|
|
6899
|
+
},
|
|
6900
|
+
{
|
|
6901
|
+
"name": "time",
|
|
6902
|
+
"takes": "{ label: string; exact: string }",
|
|
6903
|
+
"required": false,
|
|
6904
|
+
"note": "When it last changed, in words — \"Edited 2 minutes ago\" — 12px italic, with the exact time in a tooltip."
|
|
6905
|
+
},
|
|
6906
|
+
{
|
|
6907
|
+
"name": "members",
|
|
6908
|
+
"takes": "anything",
|
|
6909
|
+
"required": false,
|
|
6910
|
+
"note": "Who is in it: a `MembersPill`."
|
|
6911
|
+
},
|
|
6912
|
+
{
|
|
6913
|
+
"name": "actions",
|
|
6914
|
+
"takes": "anything",
|
|
6915
|
+
"required": false,
|
|
6916
|
+
"note": "The page's own buttons, at the right edge: a `Toolbar` with `surface={false}` of `ToolbarButton`s, or one `IconButton`."
|
|
6917
|
+
},
|
|
6918
|
+
{
|
|
6919
|
+
"name": "className",
|
|
6920
|
+
"takes": "text",
|
|
6921
|
+
"required": false,
|
|
6922
|
+
"note": "Placement only."
|
|
6923
|
+
}
|
|
6924
|
+
],
|
|
6925
|
+
"variants": [],
|
|
6926
|
+
"ownsBehaviours": [],
|
|
6927
|
+
"status": "stable",
|
|
6928
|
+
"migrationStage": null,
|
|
6929
|
+
"docsId": "page-structure-pageheader--docs",
|
|
6930
|
+
"storyId": "page-structure-pageheader--title",
|
|
6931
|
+
"docPage": "src/PageHeader.mdx",
|
|
6932
|
+
"app": null,
|
|
6933
|
+
"looks": [
|
|
6934
|
+
"whitespace-nowrap text-caption italic text-text-muted"
|
|
6935
|
+
]
|
|
6936
|
+
},
|
|
6195
6937
|
{
|
|
6196
6938
|
"name": "Panel",
|
|
6197
6939
|
"repo": "estiva-ui",
|
|
@@ -6219,6 +6961,12 @@
|
|
|
6219
6961
|
"required": false,
|
|
6220
6962
|
"note": "The panel's own actions, at the header's right — a `Toolbar` of `ToolbarButton`s, or one `IconButton`."
|
|
6221
6963
|
},
|
|
6964
|
+
{
|
|
6965
|
+
"name": "header",
|
|
6966
|
+
"takes": "anything",
|
|
6967
|
+
"required": false,
|
|
6968
|
+
"note": "A page's own bar, in place of the one `title`, `chevron` and `actions` draw: a `PageHeader`, where the panel is the page (Peek's file pages, Leaf's documents), so the page's bar and its scrolling body are one panel."
|
|
6969
|
+
},
|
|
6222
6970
|
{
|
|
6223
6971
|
"name": "children",
|
|
6224
6972
|
"takes": "anything",
|
|
@@ -6468,6 +7216,12 @@
|
|
|
6468
7216
|
"required": false,
|
|
6469
7217
|
"note": null
|
|
6470
7218
|
},
|
|
7219
|
+
{
|
|
7220
|
+
"name": "bot",
|
|
7221
|
+
"takes": "true/false",
|
|
7222
|
+
"required": false,
|
|
7223
|
+
"note": "An agent: its face is a robot, as Avatar's `bot`."
|
|
7224
|
+
},
|
|
6471
7225
|
{
|
|
6472
7226
|
"name": "fallback",
|
|
6473
7227
|
"takes": "text",
|
|
@@ -6568,6 +7322,12 @@
|
|
|
6568
7322
|
"required": false,
|
|
6569
7323
|
"note": null
|
|
6570
7324
|
},
|
|
7325
|
+
{
|
|
7326
|
+
"name": "bot",
|
|
7327
|
+
"takes": "true/false",
|
|
7328
|
+
"required": false,
|
|
7329
|
+
"note": "An agent: its face is a robot, as Avatar's `bot`."
|
|
7330
|
+
},
|
|
6571
7331
|
{
|
|
6572
7332
|
"name": "fallback",
|
|
6573
7333
|
"takes": "text",
|
|
@@ -6588,24 +7348,68 @@
|
|
|
6588
7348
|
"behaviour": "Is built on Base UI"
|
|
6589
7349
|
},
|
|
6590
7350
|
{
|
|
6591
|
-
"id": "role",
|
|
6592
|
-
"behaviour": "Says what it is to assistive technology"
|
|
7351
|
+
"id": "role",
|
|
7352
|
+
"behaviour": "Says what it is to assistive technology"
|
|
7353
|
+
},
|
|
7354
|
+
{
|
|
7355
|
+
"id": "tab-stop",
|
|
7356
|
+
"behaviour": "Is reachable with Tab"
|
|
7357
|
+
}
|
|
7358
|
+
],
|
|
7359
|
+
"status": "stable",
|
|
7360
|
+
"migrationStage": null,
|
|
7361
|
+
"docsId": "people-persontrigger--docs",
|
|
7362
|
+
"storyId": "people-persontrigger--row",
|
|
7363
|
+
"docPage": "src/PersonTrigger.mdx",
|
|
7364
|
+
"app": null,
|
|
7365
|
+
"looks": [
|
|
7366
|
+
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover",
|
|
7367
|
+
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover bg-bg-hover"
|
|
7368
|
+
]
|
|
7369
|
+
},
|
|
7370
|
+
{
|
|
7371
|
+
"name": "PinnedComment",
|
|
7372
|
+
"repo": "estiva-ui",
|
|
7373
|
+
"kind": "component",
|
|
7374
|
+
"importPath": "@estiva-app/ui",
|
|
7375
|
+
"sourceFile": "src/PinnedComment.tsx",
|
|
7376
|
+
"purpose": "The comment a thread answers, pinned at the top of the replies column: who, when, and its first line.",
|
|
7377
|
+
"purposeFrom": "page",
|
|
7378
|
+
"props": [
|
|
7379
|
+
{
|
|
7380
|
+
"name": "author",
|
|
7381
|
+
"takes": "ConversationPerson",
|
|
7382
|
+
"required": true,
|
|
7383
|
+
"note": null
|
|
7384
|
+
},
|
|
7385
|
+
{
|
|
7386
|
+
"name": "time",
|
|
7387
|
+
"takes": "anything",
|
|
7388
|
+
"required": true,
|
|
7389
|
+
"note": "When it was written, in the app's words, with its day: no day line stands above it here."
|
|
7390
|
+
},
|
|
7391
|
+
{
|
|
7392
|
+
"name": "words",
|
|
7393
|
+
"takes": "anything",
|
|
7394
|
+
"required": true,
|
|
7395
|
+
"note": "Its words, cut to one line: plain words read best."
|
|
6593
7396
|
},
|
|
6594
7397
|
{
|
|
6595
|
-
"
|
|
6596
|
-
"
|
|
7398
|
+
"name": "deleted",
|
|
7399
|
+
"takes": "true/false",
|
|
7400
|
+
"required": false,
|
|
7401
|
+
"note": "It was deleted; its replies stay."
|
|
6597
7402
|
}
|
|
6598
7403
|
],
|
|
7404
|
+
"variants": [],
|
|
7405
|
+
"ownsBehaviours": [],
|
|
6599
7406
|
"status": "stable",
|
|
6600
7407
|
"migrationStage": null,
|
|
6601
|
-
"docsId": "
|
|
6602
|
-
"storyId": "
|
|
6603
|
-
"docPage": "src/
|
|
7408
|
+
"docsId": "conversation-pinnedcomment--docs",
|
|
7409
|
+
"storyId": "conversation-pinnedcomment--pinned",
|
|
7410
|
+
"docPage": "src/PinnedComment.mdx",
|
|
6604
7411
|
"app": null,
|
|
6605
|
-
"looks": [
|
|
6606
|
-
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover",
|
|
6607
|
-
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover bg-bg-hover"
|
|
6608
|
-
]
|
|
7412
|
+
"looks": []
|
|
6609
7413
|
},
|
|
6610
7414
|
{
|
|
6611
7415
|
"name": "Popover",
|
|
@@ -7000,6 +7804,58 @@
|
|
|
7000
7804
|
"text-menu uppercase tracking-widest text-text-secondary"
|
|
7001
7805
|
]
|
|
7002
7806
|
},
|
|
7807
|
+
{
|
|
7808
|
+
"name": "QuotedLine",
|
|
7809
|
+
"repo": "estiva-ui",
|
|
7810
|
+
"kind": "component",
|
|
7811
|
+
"importPath": "@estiva-app/ui",
|
|
7812
|
+
"sourceFile": "src/QuotedLine.tsx",
|
|
7813
|
+
"purpose": "On a comment on a part of the page: the words it is on, in the page's own highlight, under the name and above the comment's words.",
|
|
7814
|
+
"purposeFrom": "page",
|
|
7815
|
+
"props": [
|
|
7816
|
+
{
|
|
7817
|
+
"name": "words",
|
|
7818
|
+
"takes": "text",
|
|
7819
|
+
"required": false,
|
|
7820
|
+
"note": "The words the comment is on, as they were quoted."
|
|
7821
|
+
},
|
|
7822
|
+
{
|
|
7823
|
+
"name": "state",
|
|
7824
|
+
"takes": "here | reworded | gone",
|
|
7825
|
+
"required": false,
|
|
7826
|
+
"note": "`here`: still in the text. `reworded`: changed since."
|
|
7827
|
+
},
|
|
7828
|
+
{
|
|
7829
|
+
"name": "label",
|
|
7830
|
+
"takes": "text",
|
|
7831
|
+
"required": false,
|
|
7832
|
+
"note": "A part with no words, a picture or a whole block: what it is, in the app's words (\"Picture: plan.png\")."
|
|
7833
|
+
}
|
|
7834
|
+
],
|
|
7835
|
+
"variants": [
|
|
7836
|
+
{
|
|
7837
|
+
"prop": "state",
|
|
7838
|
+
"values": [
|
|
7839
|
+
"here",
|
|
7840
|
+
"reworded",
|
|
7841
|
+
"gone"
|
|
7842
|
+
]
|
|
7843
|
+
}
|
|
7844
|
+
],
|
|
7845
|
+
"ownsBehaviours": [],
|
|
7846
|
+
"status": "stable",
|
|
7847
|
+
"migrationStage": null,
|
|
7848
|
+
"docsId": "conversation-quotedline--docs",
|
|
7849
|
+
"storyId": "conversation-quotedline--words",
|
|
7850
|
+
"docPage": "src/QuotedLine.mdx",
|
|
7851
|
+
"app": null,
|
|
7852
|
+
"looks": [
|
|
7853
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-warning-muted",
|
|
7854
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-warning-muted line-through",
|
|
7855
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-bg-inset text-text-secondary",
|
|
7856
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-bg-inset text-text-secondary line-through"
|
|
7857
|
+
]
|
|
7858
|
+
},
|
|
7003
7859
|
{
|
|
7004
7860
|
"name": "quoteText",
|
|
7005
7861
|
"repo": "estiva-ui",
|
|
@@ -7191,6 +8047,44 @@
|
|
|
7191
8047
|
"text-chip signal:font-mono signal:text-small signal:font-semibold signal:tabular-nums"
|
|
7192
8048
|
]
|
|
7193
8049
|
},
|
|
8050
|
+
{
|
|
8051
|
+
"name": "ReactionHorizon",
|
|
8052
|
+
"repo": "estiva-ui",
|
|
8053
|
+
"kind": "component",
|
|
8054
|
+
"importPath": "@estiva-app/ui",
|
|
8055
|
+
"sourceFile": "src/ReactionHorizon.tsx",
|
|
8056
|
+
"purpose": "The line that says reactions are read only so far back, and how many older comments were not checked.",
|
|
8057
|
+
"purposeFrom": "page",
|
|
8058
|
+
"props": [
|
|
8059
|
+
{
|
|
8060
|
+
"name": "limit",
|
|
8061
|
+
"takes": "number",
|
|
8062
|
+
"required": true,
|
|
8063
|
+
"note": "How many comments and replies back reactions are read for."
|
|
8064
|
+
},
|
|
8065
|
+
{
|
|
8066
|
+
"name": "omitted",
|
|
8067
|
+
"takes": "number",
|
|
8068
|
+
"required": true,
|
|
8069
|
+
"note": "How many older ones were not checked."
|
|
8070
|
+
},
|
|
8071
|
+
{
|
|
8072
|
+
"name": "cut",
|
|
8073
|
+
"takes": "true/false",
|
|
8074
|
+
"required": false,
|
|
8075
|
+
"note": "Some reactions may be missing: the read was cut short."
|
|
8076
|
+
}
|
|
8077
|
+
],
|
|
8078
|
+
"variants": [],
|
|
8079
|
+
"ownsBehaviours": [],
|
|
8080
|
+
"status": "stable",
|
|
8081
|
+
"migrationStage": null,
|
|
8082
|
+
"docsId": "conversation-reactionhorizon--docs",
|
|
8083
|
+
"storyId": "conversation-reactionhorizon--older",
|
|
8084
|
+
"docPage": "src/ReactionHorizon.mdx",
|
|
8085
|
+
"app": null,
|
|
8086
|
+
"looks": []
|
|
8087
|
+
},
|
|
7194
8088
|
{
|
|
7195
8089
|
"name": "ReactionPicker",
|
|
7196
8090
|
"repo": "estiva-ui",
|
|
@@ -7256,186 +8150,530 @@
|
|
|
7256
8150
|
"purposeFrom": "page",
|
|
7257
8151
|
"props": [
|
|
7258
8152
|
{
|
|
7259
|
-
"name": "reactions",
|
|
7260
|
-
"takes": "readonly ReactionCount[]",
|
|
8153
|
+
"name": "reactions",
|
|
8154
|
+
"takes": "readonly ReactionCount[]",
|
|
8155
|
+
"required": true,
|
|
8156
|
+
"note": "Each emoji and who chose it, in the order first chosen."
|
|
8157
|
+
},
|
|
8158
|
+
{
|
|
8159
|
+
"name": "options",
|
|
8160
|
+
"takes": "readonly ReactionOption[]",
|
|
8161
|
+
"required": true,
|
|
8162
|
+
"note": "The emoji offered, each named; also what a pill's name is read from."
|
|
8163
|
+
},
|
|
8164
|
+
{
|
|
8165
|
+
"name": "nameOf",
|
|
8166
|
+
"takes": "a handler",
|
|
8167
|
+
"required": true,
|
|
8168
|
+
"note": "A reactor's name, as \"who reacted\" says it."
|
|
8169
|
+
},
|
|
8170
|
+
{
|
|
8171
|
+
"name": "viewer",
|
|
8172
|
+
"takes": "text",
|
|
8173
|
+
"required": false,
|
|
8174
|
+
"note": "Who is looking: their pills are lit, and \"who reacted\" says \"you\"."
|
|
8175
|
+
},
|
|
8176
|
+
{
|
|
8177
|
+
"name": "onToggle",
|
|
8178
|
+
"takes": "a handler",
|
|
8179
|
+
"required": false,
|
|
8180
|
+
"note": "Your reaction on or off. Absent, the row only shows (read-only, signed out)."
|
|
8181
|
+
},
|
|
8182
|
+
{
|
|
8183
|
+
"name": "className",
|
|
8184
|
+
"takes": "text",
|
|
8185
|
+
"required": false,
|
|
8186
|
+
"note": null
|
|
8187
|
+
}
|
|
8188
|
+
],
|
|
8189
|
+
"variants": [],
|
|
8190
|
+
"ownsBehaviours": [],
|
|
8191
|
+
"status": "stable",
|
|
8192
|
+
"migrationStage": null,
|
|
8193
|
+
"docsId": "conversation-reactionrow--docs",
|
|
8194
|
+
"storyId": "conversation-reactionrow--default",
|
|
8195
|
+
"docPage": "src/ReactionRow.mdx",
|
|
8196
|
+
"app": null,
|
|
8197
|
+
"looks": []
|
|
8198
|
+
},
|
|
8199
|
+
{
|
|
8200
|
+
"name": "referenceAtSelection",
|
|
8201
|
+
"repo": "estiva-ui",
|
|
8202
|
+
"kind": "helper",
|
|
8203
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8204
|
+
"sourceFile": "src/ReferenceCards.ts",
|
|
8205
|
+
"purpose": "The chip the person has selected, with what it names and its card — or null.",
|
|
8206
|
+
"purposeFrom": "comment",
|
|
8207
|
+
"props": [],
|
|
8208
|
+
"variants": [],
|
|
8209
|
+
"ownsBehaviours": [],
|
|
8210
|
+
"status": "stable",
|
|
8211
|
+
"migrationStage": null,
|
|
8212
|
+
"docsId": null,
|
|
8213
|
+
"storyId": null,
|
|
8214
|
+
"docPage": null,
|
|
8215
|
+
"app": null,
|
|
8216
|
+
"looks": []
|
|
8217
|
+
},
|
|
8218
|
+
{
|
|
8219
|
+
"name": "referenceCardPlacements",
|
|
8220
|
+
"repo": "estiva-ui",
|
|
8221
|
+
"kind": "helper",
|
|
8222
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8223
|
+
"sourceFile": "src/ReferenceCards.ts",
|
|
8224
|
+
"purpose": "Every line that asks for a card, in document order.",
|
|
8225
|
+
"purposeFrom": "comment",
|
|
8226
|
+
"props": [],
|
|
8227
|
+
"variants": [],
|
|
8228
|
+
"ownsBehaviours": [],
|
|
8229
|
+
"status": "stable",
|
|
8230
|
+
"migrationStage": null,
|
|
8231
|
+
"docsId": null,
|
|
8232
|
+
"storyId": null,
|
|
8233
|
+
"docPage": null,
|
|
8234
|
+
"app": null,
|
|
8235
|
+
"looks": []
|
|
8236
|
+
},
|
|
8237
|
+
{
|
|
8238
|
+
"name": "referenceMenu",
|
|
8239
|
+
"repo": "estiva-ui",
|
|
8240
|
+
"kind": "helper",
|
|
8241
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8242
|
+
"sourceFile": "src/ComposerTriggers.tsx",
|
|
8243
|
+
"purpose": "The list `[` opens: `label: snippet` rows, the same box as the people list.",
|
|
8244
|
+
"purposeFrom": "comment",
|
|
8245
|
+
"props": [
|
|
8246
|
+
{
|
|
8247
|
+
"name": "ariaLabel",
|
|
8248
|
+
"takes": "text",
|
|
8249
|
+
"required": true,
|
|
8250
|
+
"note": "Names the list, e.g. what can be referenced."
|
|
8251
|
+
},
|
|
8252
|
+
{
|
|
8253
|
+
"name": "sectionLabel",
|
|
8254
|
+
"takes": "text",
|
|
8255
|
+
"required": true,
|
|
8256
|
+
"note": "The section's heading."
|
|
8257
|
+
},
|
|
8258
|
+
{
|
|
8259
|
+
"name": "icon",
|
|
8260
|
+
"takes": "anything",
|
|
8261
|
+
"required": true,
|
|
8262
|
+
"note": "At each row's start: a 16px icon — unless the row brings its own (`CaptionedItem.icon`), or `iconFor` answers."
|
|
8263
|
+
},
|
|
8264
|
+
{
|
|
8265
|
+
"name": "iconFor",
|
|
8266
|
+
"takes": "a handler",
|
|
8267
|
+
"required": false,
|
|
8268
|
+
"note": "A row's 16px icon from what it points at — its `uri` — when the list holds several kinds of thing; `undefined` from it draws `icon`."
|
|
8269
|
+
}
|
|
8270
|
+
],
|
|
8271
|
+
"variants": [],
|
|
8272
|
+
"ownsBehaviours": [],
|
|
8273
|
+
"status": "stable",
|
|
8274
|
+
"migrationStage": null,
|
|
8275
|
+
"docsId": "writing-composertriggers--docs",
|
|
8276
|
+
"storyId": "writing-composertriggers--default",
|
|
8277
|
+
"docPage": null,
|
|
8278
|
+
"app": null,
|
|
8279
|
+
"looks": []
|
|
8280
|
+
},
|
|
8281
|
+
{
|
|
8282
|
+
"name": "ReferenceMenu",
|
|
8283
|
+
"repo": "estiva-ui",
|
|
8284
|
+
"kind": "component",
|
|
8285
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8286
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8287
|
+
"purpose": "What a link in a document offers whoever is writing it: Open, and — when it is alone on its line — Show as Row or Card.",
|
|
8288
|
+
"purposeFrom": "page",
|
|
8289
|
+
"props": [],
|
|
8290
|
+
"variants": [],
|
|
8291
|
+
"ownsBehaviours": [],
|
|
8292
|
+
"status": "stable",
|
|
8293
|
+
"migrationStage": null,
|
|
8294
|
+
"docsId": "writing-referencemenu--docs",
|
|
8295
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8296
|
+
"docPage": "src/ReferenceMenu.mdx",
|
|
8297
|
+
"app": null,
|
|
8298
|
+
"looks": []
|
|
8299
|
+
},
|
|
8300
|
+
{
|
|
8301
|
+
"name": "referenceMenuClick",
|
|
8302
|
+
"repo": "estiva-ui",
|
|
8303
|
+
"kind": "helper",
|
|
8304
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8305
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8306
|
+
"purpose": "A click on the chip at `pos`, from its node view: while editing, with the menu installed, it opens the menu, and the caller stops the click there.",
|
|
8307
|
+
"purposeFrom": "comment",
|
|
8308
|
+
"props": [],
|
|
8309
|
+
"variants": [],
|
|
8310
|
+
"ownsBehaviours": [],
|
|
8311
|
+
"status": "stable",
|
|
8312
|
+
"migrationStage": null,
|
|
8313
|
+
"docsId": "writing-referencemenu--docs",
|
|
8314
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8315
|
+
"docPage": null,
|
|
8316
|
+
"app": null,
|
|
8317
|
+
"looks": []
|
|
8318
|
+
},
|
|
8319
|
+
{
|
|
8320
|
+
"name": "ReferenceMenuView",
|
|
8321
|
+
"repo": "estiva-ui",
|
|
8322
|
+
"kind": "component",
|
|
8323
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8324
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8325
|
+
"purpose": "The menu `ReferenceMenu` holds, hung under its chip.",
|
|
8326
|
+
"purposeFrom": "comment",
|
|
8327
|
+
"props": [
|
|
8328
|
+
{
|
|
8329
|
+
"name": "editor",
|
|
8330
|
+
"takes": "Editor | null",
|
|
7261
8331
|
"required": true,
|
|
7262
|
-
"note":
|
|
7263
|
-
}
|
|
8332
|
+
"note": null
|
|
8333
|
+
}
|
|
8334
|
+
],
|
|
8335
|
+
"variants": [],
|
|
8336
|
+
"ownsBehaviours": [
|
|
7264
8337
|
{
|
|
7265
|
-
"
|
|
7266
|
-
"
|
|
7267
|
-
"required": true,
|
|
7268
|
-
"note": "The emoji offered, each named; also what a pill's name is read from."
|
|
8338
|
+
"id": "portal",
|
|
8339
|
+
"behaviour": "Floats on top of the page"
|
|
7269
8340
|
},
|
|
7270
8341
|
{
|
|
7271
|
-
"
|
|
7272
|
-
"
|
|
7273
|
-
"required": true,
|
|
7274
|
-
"note": "A reactor's name, as \"who reacted\" says it."
|
|
8342
|
+
"id": "press-outside",
|
|
8343
|
+
"behaviour": "Closes on a press outside"
|
|
7275
8344
|
},
|
|
7276
8345
|
{
|
|
7277
|
-
"
|
|
7278
|
-
"
|
|
7279
|
-
"required": false,
|
|
7280
|
-
"note": "Who is looking: their pills are lit, and \"who reacted\" says \"you\"."
|
|
8346
|
+
"id": "page-keys",
|
|
8347
|
+
"behaviour": "Takes its keys by itself"
|
|
7281
8348
|
},
|
|
7282
8349
|
{
|
|
7283
|
-
"
|
|
7284
|
-
"
|
|
7285
|
-
"required": false,
|
|
7286
|
-
"note": "Your reaction on or off. Absent, the row only shows (read-only, signed out)."
|
|
8350
|
+
"id": "focus",
|
|
8351
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
7287
8352
|
},
|
|
7288
8353
|
{
|
|
7289
|
-
"
|
|
7290
|
-
"
|
|
7291
|
-
"required": false,
|
|
7292
|
-
"note": null
|
|
8354
|
+
"id": "follow",
|
|
8355
|
+
"behaviour": "Stays attached to its anchor on scroll and resize"
|
|
7293
8356
|
}
|
|
7294
8357
|
],
|
|
8358
|
+
"status": "stable",
|
|
8359
|
+
"migrationStage": null,
|
|
8360
|
+
"docsId": "writing-referencemenu--docs",
|
|
8361
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8362
|
+
"docPage": null,
|
|
8363
|
+
"app": null,
|
|
8364
|
+
"looks": []
|
|
8365
|
+
},
|
|
8366
|
+
{
|
|
8367
|
+
"name": "ReferenceNode",
|
|
8368
|
+
"repo": "estiva-ui",
|
|
8369
|
+
"kind": "component",
|
|
8370
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8371
|
+
"sourceFile": "src/BlockNodes.tsx",
|
|
8372
|
+
"purpose": "A `nostr:` reference, drawn as the thing it points at — SPEC §13.1.",
|
|
8373
|
+
"purposeFrom": "comment",
|
|
8374
|
+
"props": [],
|
|
7295
8375
|
"variants": [],
|
|
7296
8376
|
"ownsBehaviours": [],
|
|
7297
8377
|
"status": "stable",
|
|
7298
8378
|
"migrationStage": null,
|
|
7299
|
-
"docsId": "
|
|
7300
|
-
"storyId": "
|
|
7301
|
-
"docPage":
|
|
8379
|
+
"docsId": "writing-blocknodes--docs",
|
|
8380
|
+
"storyId": "writing-blocknodes--default",
|
|
8381
|
+
"docPage": null,
|
|
7302
8382
|
"app": null,
|
|
7303
8383
|
"looks": []
|
|
7304
8384
|
},
|
|
7305
8385
|
{
|
|
7306
|
-
"name": "
|
|
8386
|
+
"name": "ReferenceTrigger",
|
|
7307
8387
|
"repo": "estiva-ui",
|
|
7308
|
-
"kind": "
|
|
8388
|
+
"kind": "component",
|
|
7309
8389
|
"importPath": "@estiva-app/ui/editor",
|
|
7310
|
-
"sourceFile": "src/
|
|
7311
|
-
"purpose": "
|
|
8390
|
+
"sourceFile": "src/ComposerTriggers.tsx",
|
|
8391
|
+
"purpose": "`[` — reference something, inserted as a {@link CaptionedReference} chip.",
|
|
7312
8392
|
"purposeFrom": "comment",
|
|
7313
8393
|
"props": [],
|
|
7314
8394
|
"variants": [],
|
|
7315
8395
|
"ownsBehaviours": [],
|
|
7316
8396
|
"status": "stable",
|
|
7317
8397
|
"migrationStage": null,
|
|
7318
|
-
"docsId":
|
|
7319
|
-
"storyId":
|
|
8398
|
+
"docsId": "writing-composertriggers--docs",
|
|
8399
|
+
"storyId": "writing-composertriggers--default",
|
|
7320
8400
|
"docPage": null,
|
|
7321
8401
|
"app": null,
|
|
7322
8402
|
"looks": []
|
|
7323
8403
|
},
|
|
7324
8404
|
{
|
|
7325
|
-
"name": "
|
|
8405
|
+
"name": "refreshLinkChips",
|
|
7326
8406
|
"repo": "estiva-ui",
|
|
7327
8407
|
"kind": "helper",
|
|
7328
8408
|
"importPath": "@estiva-app/ui/editor",
|
|
7329
|
-
"sourceFile": "src/
|
|
7330
|
-
"purpose": "
|
|
8409
|
+
"sourceFile": "src/LinkChips.ts",
|
|
8410
|
+
"purpose": "Look at the document again — after the app learned what more URLs name some other way.",
|
|
7331
8411
|
"purposeFrom": "comment",
|
|
7332
8412
|
"props": [],
|
|
7333
8413
|
"variants": [],
|
|
7334
8414
|
"ownsBehaviours": [],
|
|
7335
8415
|
"status": "stable",
|
|
7336
8416
|
"migrationStage": null,
|
|
7337
|
-
"docsId":
|
|
7338
|
-
"storyId":
|
|
8417
|
+
"docsId": "writing-linkchips--docs",
|
|
8418
|
+
"storyId": "writing-linkchips--in-an-editor",
|
|
7339
8419
|
"docPage": null,
|
|
7340
8420
|
"app": null,
|
|
7341
8421
|
"looks": []
|
|
7342
8422
|
},
|
|
7343
8423
|
{
|
|
7344
|
-
"name": "
|
|
8424
|
+
"name": "releaseSelection",
|
|
7345
8425
|
"repo": "estiva-ui",
|
|
7346
8426
|
"kind": "helper",
|
|
7347
8427
|
"importPath": "@estiva-app/ui/editor",
|
|
7348
|
-
"sourceFile": "src/
|
|
7349
|
-
"purpose": "
|
|
8428
|
+
"sourceFile": "src/SelectionToolbar.tsx",
|
|
8429
|
+
"purpose": "Stop drawing it. Nothing kept, nothing dispatched.",
|
|
7350
8430
|
"purposeFrom": "comment",
|
|
8431
|
+
"props": [],
|
|
8432
|
+
"variants": [],
|
|
8433
|
+
"ownsBehaviours": [],
|
|
8434
|
+
"status": "stable",
|
|
8435
|
+
"migrationStage": null,
|
|
8436
|
+
"docsId": "writing-selectiontoolbar--docs",
|
|
8437
|
+
"storyId": "writing-selectiontoolbar--default",
|
|
8438
|
+
"docPage": null,
|
|
8439
|
+
"app": null,
|
|
8440
|
+
"looks": []
|
|
8441
|
+
},
|
|
8442
|
+
{
|
|
8443
|
+
"name": "RepliesRow",
|
|
8444
|
+
"repo": "estiva-ui",
|
|
8445
|
+
"kind": "component",
|
|
8446
|
+
"importPath": "@estiva-app/ui",
|
|
8447
|
+
"sourceFile": "src/RepliesRow.tsx",
|
|
8448
|
+
"purpose": "The way into a thread, under its comment: who replied, \"2 replies\", the last reply's time, and \"1 new\" until it is read.",
|
|
8449
|
+
"purposeFrom": "page",
|
|
7351
8450
|
"props": [
|
|
7352
8451
|
{
|
|
7353
|
-
"name": "
|
|
7354
|
-
"takes": "
|
|
8452
|
+
"name": "count",
|
|
8453
|
+
"takes": "number",
|
|
7355
8454
|
"required": true,
|
|
7356
|
-
"note": "
|
|
8455
|
+
"note": "How many replies."
|
|
7357
8456
|
},
|
|
7358
8457
|
{
|
|
7359
|
-
"name": "
|
|
8458
|
+
"name": "faces",
|
|
8459
|
+
"takes": "readonly { name: string; picture?: string; bot?: boolean }[]",
|
|
8460
|
+
"required": false,
|
|
8461
|
+
"note": "Who replied: their faces."
|
|
8462
|
+
},
|
|
8463
|
+
{
|
|
8464
|
+
"name": "last",
|
|
7360
8465
|
"takes": "text",
|
|
7361
|
-
"required":
|
|
7362
|
-
"note": "The
|
|
8466
|
+
"required": false,
|
|
8467
|
+
"note": "The last reply's time, in the app's words."
|
|
7363
8468
|
},
|
|
7364
8469
|
{
|
|
7365
|
-
"name": "
|
|
7366
|
-
"takes": "
|
|
7367
|
-
"required":
|
|
7368
|
-
"note": "
|
|
8470
|
+
"name": "isNew",
|
|
8471
|
+
"takes": "true/false",
|
|
8472
|
+
"required": false,
|
|
8473
|
+
"note": "\"1 new\": a reply you have not read."
|
|
7369
8474
|
},
|
|
7370
8475
|
{
|
|
7371
|
-
"name": "
|
|
8476
|
+
"name": "urgent",
|
|
8477
|
+
"takes": "true/false",
|
|
8478
|
+
"required": false,
|
|
8479
|
+
"note": "The \"1 new\" chip in the warning colour, for an urgent thread."
|
|
8480
|
+
},
|
|
8481
|
+
{
|
|
8482
|
+
"name": "onOpen",
|
|
7372
8483
|
"takes": "a handler",
|
|
7373
8484
|
"required": false,
|
|
7374
|
-
"note": "
|
|
8485
|
+
"note": "Opens the thread. Absent, the row only says how many (the card around it opens the thread)."
|
|
8486
|
+
},
|
|
8487
|
+
{
|
|
8488
|
+
"name": "open",
|
|
8489
|
+
"takes": "true/false",
|
|
8490
|
+
"required": false,
|
|
8491
|
+
"note": "Its thread is open under it, in one column: the chevron turns down and the row stays marked; a press closes it (Katerina, 31 October)."
|
|
7375
8492
|
}
|
|
7376
8493
|
],
|
|
7377
8494
|
"variants": [],
|
|
7378
8495
|
"ownsBehaviours": [],
|
|
7379
8496
|
"status": "stable",
|
|
7380
8497
|
"migrationStage": null,
|
|
7381
|
-
"docsId": "
|
|
7382
|
-
"storyId": "
|
|
7383
|
-
"docPage":
|
|
8498
|
+
"docsId": "conversation-repliesrow--docs",
|
|
8499
|
+
"storyId": "conversation-repliesrow--several",
|
|
8500
|
+
"docPage": "src/RepliesRow.mdx",
|
|
7384
8501
|
"app": null,
|
|
7385
|
-
"looks": [
|
|
8502
|
+
"looks": [
|
|
8503
|
+
"rounded-lg border border-transparent transition-colors hover:border-accent-outline hover:bg-accent-wash",
|
|
8504
|
+
"text-chip font-medium text-text-interactive transition-colors",
|
|
8505
|
+
"text-small leading-3 text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
8506
|
+
"rounded-lg border border-transparent transition-colors hover:border-accent-outline hover:bg-accent-wash border-accent-outline bg-accent-wash"
|
|
8507
|
+
]
|
|
7386
8508
|
},
|
|
7387
8509
|
{
|
|
7388
|
-
"name": "
|
|
8510
|
+
"name": "ReplyCard",
|
|
7389
8511
|
"repo": "estiva-ui",
|
|
7390
8512
|
"kind": "component",
|
|
7391
|
-
"importPath": "@estiva-app/ui
|
|
7392
|
-
"sourceFile": "src/
|
|
7393
|
-
"purpose": "
|
|
8513
|
+
"importPath": "@estiva-app/ui",
|
|
8514
|
+
"sourceFile": "src/ConversationCard.tsx",
|
|
8515
|
+
"purpose": "One reply in a thread: the same pieces as a comment, without replies of its own or Resolve.",
|
|
7394
8516
|
"purposeFrom": "page",
|
|
7395
|
-
"props": [
|
|
7396
|
-
|
|
7397
|
-
|
|
7398
|
-
|
|
7399
|
-
|
|
7400
|
-
|
|
7401
|
-
|
|
7402
|
-
|
|
7403
|
-
|
|
7404
|
-
|
|
7405
|
-
|
|
7406
|
-
|
|
7407
|
-
|
|
7408
|
-
|
|
7409
|
-
|
|
7410
|
-
|
|
7411
|
-
|
|
7412
|
-
|
|
7413
|
-
|
|
7414
|
-
|
|
8517
|
+
"props": [
|
|
8518
|
+
{
|
|
8519
|
+
"name": "author",
|
|
8520
|
+
"takes": "ConversationPerson",
|
|
8521
|
+
"required": true,
|
|
8522
|
+
"note": null
|
|
8523
|
+
},
|
|
8524
|
+
{
|
|
8525
|
+
"name": "time",
|
|
8526
|
+
"takes": "anything",
|
|
8527
|
+
"required": true,
|
|
8528
|
+
"note": "When it was written, in the app's words (\"11:08 AM\")."
|
|
8529
|
+
},
|
|
8530
|
+
{
|
|
8531
|
+
"name": "timeHref",
|
|
8532
|
+
"takes": "text",
|
|
8533
|
+
"required": false,
|
|
8534
|
+
"note": "A link to it: the time is then the link, \"Link to this\", as a reply's is."
|
|
8535
|
+
},
|
|
8536
|
+
{
|
|
8537
|
+
"name": "edited",
|
|
8538
|
+
"takes": "text",
|
|
8539
|
+
"required": false,
|
|
8540
|
+
"note": "When it was last edited, in the app's words for the tooltip (\"Edited 11:20 AM\"): draws \"(edited)\"."
|
|
8541
|
+
},
|
|
8542
|
+
{
|
|
8543
|
+
"name": "children",
|
|
8544
|
+
"takes": "anything",
|
|
8545
|
+
"required": true,
|
|
8546
|
+
"note": "The words, as the app draws them: text, mentions, links, attached cards, quoted blocks."
|
|
8547
|
+
},
|
|
8548
|
+
{
|
|
8549
|
+
"name": "about",
|
|
8550
|
+
"takes": "anything",
|
|
8551
|
+
"required": false,
|
|
8552
|
+
"note": "What it is about, a `QuotedLine` for a comment on a part of the page: under the name, above the words."
|
|
8553
|
+
},
|
|
8554
|
+
{
|
|
8555
|
+
"name": "files",
|
|
8556
|
+
"takes": "anything",
|
|
8557
|
+
"required": false,
|
|
8558
|
+
"note": "Pictures and files: `AttachmentCard`s, laid out under the words."
|
|
8559
|
+
},
|
|
8560
|
+
{
|
|
8561
|
+
"name": "reactions",
|
|
8562
|
+
"takes": "ReactionRowProps",
|
|
8563
|
+
"required": false,
|
|
8564
|
+
"note": "Its reactions: the kit's `ReactionRow`. With `onToggle`, the strip offers React too."
|
|
8565
|
+
},
|
|
8566
|
+
{
|
|
8567
|
+
"name": "reactionRefused",
|
|
8568
|
+
"takes": "text",
|
|
8569
|
+
"required": false,
|
|
8570
|
+
"note": "Why the last reaction was refused, in plain words: said under the reactions."
|
|
8571
|
+
},
|
|
8572
|
+
{
|
|
8573
|
+
"name": "isNew",
|
|
8574
|
+
"takes": "true/false",
|
|
8575
|
+
"required": false,
|
|
8576
|
+
"note": "Not read yet: the dot, or the urgent mark with `urgent`, and the card's edge in the theme's colour."
|
|
8577
|
+
},
|
|
8578
|
+
{
|
|
8579
|
+
"name": "urgent",
|
|
8580
|
+
"takes": "true/false",
|
|
8581
|
+
"required": false,
|
|
8582
|
+
"note": null
|
|
8583
|
+
},
|
|
8584
|
+
{
|
|
8585
|
+
"name": "own",
|
|
8586
|
+
"takes": "true/false",
|
|
8587
|
+
"required": false,
|
|
8588
|
+
"note": "It is yours: the menu offers Edit (with `editor`) and Delete (with `onDelete`)."
|
|
8589
|
+
},
|
|
8590
|
+
{
|
|
8591
|
+
"name": "readOnly",
|
|
8592
|
+
"takes": "true/false",
|
|
8593
|
+
"required": false,
|
|
8594
|
+
"note": "Nothing can be changed (an archived page): no strip, reactions only shown."
|
|
8595
|
+
},
|
|
8596
|
+
{
|
|
8597
|
+
"name": "editor",
|
|
8598
|
+
"takes": "a handler",
|
|
8599
|
+
"required": false,
|
|
8600
|
+
"note": "The box it is edited in, the app's `CommentBox` edit form; call `done` when it saves or cancels."
|
|
8601
|
+
},
|
|
8602
|
+
{
|
|
8603
|
+
"name": "editing",
|
|
8604
|
+
"takes": "true/false",
|
|
8605
|
+
"required": false,
|
|
8606
|
+
"note": "Being edited, when the app holds it (an edit that was refused opens again)."
|
|
8607
|
+
},
|
|
8608
|
+
{
|
|
8609
|
+
"name": "onEditingChange",
|
|
8610
|
+
"takes": "a handler",
|
|
8611
|
+
"required": false,
|
|
8612
|
+
"note": null
|
|
8613
|
+
},
|
|
8614
|
+
{
|
|
8615
|
+
"name": "onDelete",
|
|
8616
|
+
"takes": "a handler",
|
|
8617
|
+
"required": false,
|
|
8618
|
+
"note": "Delete, after the card has asked."
|
|
8619
|
+
},
|
|
8620
|
+
{
|
|
8621
|
+
"name": "deleteNote",
|
|
8622
|
+
"takes": "anything",
|
|
8623
|
+
"required": false,
|
|
8624
|
+
"note": "The app's sentence in the delete question, what deleting does there."
|
|
8625
|
+
},
|
|
8626
|
+
{
|
|
8627
|
+
"name": "menu",
|
|
8628
|
+
"takes": "anything",
|
|
8629
|
+
"required": false,
|
|
8630
|
+
"note": "The app's own rows in the ⋯ menu: `MenuItem`s."
|
|
8631
|
+
},
|
|
8632
|
+
{
|
|
8633
|
+
"name": "className",
|
|
8634
|
+
"takes": "text",
|
|
8635
|
+
"required": false,
|
|
8636
|
+
"note": "Placement only."
|
|
8637
|
+
}
|
|
8638
|
+
],
|
|
7415
8639
|
"variants": [],
|
|
7416
8640
|
"ownsBehaviours": [],
|
|
7417
8641
|
"status": "stable",
|
|
7418
8642
|
"migrationStage": null,
|
|
7419
|
-
"docsId": "
|
|
7420
|
-
"storyId": "
|
|
7421
|
-
"docPage":
|
|
8643
|
+
"docsId": "conversation-replycard--docs",
|
|
8644
|
+
"storyId": "conversation-replycard--reply",
|
|
8645
|
+
"docPage": "src/ReplyCard.mdx",
|
|
7422
8646
|
"app": null,
|
|
7423
|
-
"looks": [
|
|
8647
|
+
"looks": [
|
|
8648
|
+
"[&>div]:line-clamp-1 [&>div]:max-h-[1lh] [&>div>*:not(p):not(ul):not(ol):not(blockquote):not(pre):not(div:only-child)]:hidden [&>div>div:only-child>*:not(p):not(ul):not(ol):not(blockquote):not(pre)]:hidden"
|
|
8649
|
+
]
|
|
7424
8650
|
},
|
|
7425
8651
|
{
|
|
7426
|
-
"name": "
|
|
8652
|
+
"name": "ResolveDialog",
|
|
7427
8653
|
"repo": "estiva-ui",
|
|
7428
8654
|
"kind": "component",
|
|
7429
|
-
"importPath": "@estiva-app/ui
|
|
7430
|
-
"sourceFile": "src/
|
|
7431
|
-
"purpose": "
|
|
7432
|
-
"purposeFrom": "
|
|
8655
|
+
"importPath": "@estiva-app/ui",
|
|
8656
|
+
"sourceFile": "src/ResolveDialog.tsx",
|
|
8657
|
+
"purpose": "Resolve, with an optional note: the same dialog in every app.",
|
|
8658
|
+
"purposeFrom": "page",
|
|
7433
8659
|
"props": [
|
|
7434
8660
|
{
|
|
7435
|
-
"name": "
|
|
7436
|
-
"takes": "
|
|
8661
|
+
"name": "onResolve",
|
|
8662
|
+
"takes": "a handler",
|
|
8663
|
+
"required": true,
|
|
8664
|
+
"note": "Resolve, with what was written (an empty string for none)."
|
|
8665
|
+
},
|
|
8666
|
+
{
|
|
8667
|
+
"name": "onCancel",
|
|
8668
|
+
"takes": "a handler",
|
|
7437
8669
|
"required": true,
|
|
7438
8670
|
"note": null
|
|
8671
|
+
},
|
|
8672
|
+
{
|
|
8673
|
+
"name": "refused",
|
|
8674
|
+
"takes": "text",
|
|
8675
|
+
"required": false,
|
|
8676
|
+
"note": "Why the last resolve was refused, in plain words."
|
|
7439
8677
|
}
|
|
7440
8678
|
],
|
|
7441
8679
|
"variants": [],
|
|
@@ -7457,91 +8695,15 @@
|
|
|
7457
8695
|
"behaviour": "Holds focus inside while open, and gives it back"
|
|
7458
8696
|
},
|
|
7459
8697
|
{
|
|
7460
|
-
"id": "
|
|
7461
|
-
"behaviour": "
|
|
8698
|
+
"id": "scroll-lock",
|
|
8699
|
+
"behaviour": "Stops the page behind it scrolling"
|
|
7462
8700
|
}
|
|
7463
8701
|
],
|
|
7464
8702
|
"status": "stable",
|
|
7465
8703
|
"migrationStage": null,
|
|
7466
|
-
"docsId": "
|
|
7467
|
-
"storyId": "
|
|
7468
|
-
"docPage":
|
|
7469
|
-
"app": null,
|
|
7470
|
-
"looks": []
|
|
7471
|
-
},
|
|
7472
|
-
{
|
|
7473
|
-
"name": "ReferenceNode",
|
|
7474
|
-
"repo": "estiva-ui",
|
|
7475
|
-
"kind": "component",
|
|
7476
|
-
"importPath": "@estiva-app/ui/editor",
|
|
7477
|
-
"sourceFile": "src/BlockNodes.tsx",
|
|
7478
|
-
"purpose": "A `nostr:` reference, drawn as the thing it points at — SPEC §13.1.",
|
|
7479
|
-
"purposeFrom": "comment",
|
|
7480
|
-
"props": [],
|
|
7481
|
-
"variants": [],
|
|
7482
|
-
"ownsBehaviours": [],
|
|
7483
|
-
"status": "stable",
|
|
7484
|
-
"migrationStage": null,
|
|
7485
|
-
"docsId": "writing-blocknodes--docs",
|
|
7486
|
-
"storyId": "writing-blocknodes--default",
|
|
7487
|
-
"docPage": null,
|
|
7488
|
-
"app": null,
|
|
7489
|
-
"looks": []
|
|
7490
|
-
},
|
|
7491
|
-
{
|
|
7492
|
-
"name": "ReferenceTrigger",
|
|
7493
|
-
"repo": "estiva-ui",
|
|
7494
|
-
"kind": "component",
|
|
7495
|
-
"importPath": "@estiva-app/ui/editor",
|
|
7496
|
-
"sourceFile": "src/ComposerTriggers.tsx",
|
|
7497
|
-
"purpose": "`[` — reference something, inserted as a {@link CaptionedReference} chip.",
|
|
7498
|
-
"purposeFrom": "comment",
|
|
7499
|
-
"props": [],
|
|
7500
|
-
"variants": [],
|
|
7501
|
-
"ownsBehaviours": [],
|
|
7502
|
-
"status": "stable",
|
|
7503
|
-
"migrationStage": null,
|
|
7504
|
-
"docsId": "writing-composertriggers--docs",
|
|
7505
|
-
"storyId": "writing-composertriggers--default",
|
|
7506
|
-
"docPage": null,
|
|
7507
|
-
"app": null,
|
|
7508
|
-
"looks": []
|
|
7509
|
-
},
|
|
7510
|
-
{
|
|
7511
|
-
"name": "refreshLinkChips",
|
|
7512
|
-
"repo": "estiva-ui",
|
|
7513
|
-
"kind": "helper",
|
|
7514
|
-
"importPath": "@estiva-app/ui/editor",
|
|
7515
|
-
"sourceFile": "src/LinkChips.ts",
|
|
7516
|
-
"purpose": "Look at the document again — after the app learned what more URLs name some other way.",
|
|
7517
|
-
"purposeFrom": "comment",
|
|
7518
|
-
"props": [],
|
|
7519
|
-
"variants": [],
|
|
7520
|
-
"ownsBehaviours": [],
|
|
7521
|
-
"status": "stable",
|
|
7522
|
-
"migrationStage": null,
|
|
7523
|
-
"docsId": "writing-linkchips--docs",
|
|
7524
|
-
"storyId": "writing-linkchips--in-an-editor",
|
|
7525
|
-
"docPage": null,
|
|
7526
|
-
"app": null,
|
|
7527
|
-
"looks": []
|
|
7528
|
-
},
|
|
7529
|
-
{
|
|
7530
|
-
"name": "releaseSelection",
|
|
7531
|
-
"repo": "estiva-ui",
|
|
7532
|
-
"kind": "helper",
|
|
7533
|
-
"importPath": "@estiva-app/ui/editor",
|
|
7534
|
-
"sourceFile": "src/SelectionToolbar.tsx",
|
|
7535
|
-
"purpose": "Stop drawing it. Nothing kept, nothing dispatched.",
|
|
7536
|
-
"purposeFrom": "comment",
|
|
7537
|
-
"props": [],
|
|
7538
|
-
"variants": [],
|
|
7539
|
-
"ownsBehaviours": [],
|
|
7540
|
-
"status": "stable",
|
|
7541
|
-
"migrationStage": null,
|
|
7542
|
-
"docsId": "writing-selectiontoolbar--docs",
|
|
7543
|
-
"storyId": "writing-selectiontoolbar--default",
|
|
7544
|
-
"docPage": null,
|
|
8704
|
+
"docsId": "conversation-resolvedialog--docs",
|
|
8705
|
+
"storyId": "conversation-resolvedialog--resolve",
|
|
8706
|
+
"docPage": "src/ResolveDialog.mdx",
|
|
7545
8707
|
"app": null,
|
|
7546
8708
|
"looks": []
|
|
7547
8709
|
},
|
|
@@ -8424,6 +9586,32 @@
|
|
|
8424
9586
|
"app": null,
|
|
8425
9587
|
"looks": []
|
|
8426
9588
|
},
|
|
9589
|
+
{
|
|
9590
|
+
"name": "SkeletonConversation",
|
|
9591
|
+
"repo": "estiva-ui",
|
|
9592
|
+
"kind": "component",
|
|
9593
|
+
"importPath": "@estiva-app/ui",
|
|
9594
|
+
"sourceFile": "src/Skeleton.tsx",
|
|
9595
|
+
"purpose": "Comments still coming: three placeholders shaped like `ConversationCard`, revealed after 150ms.",
|
|
9596
|
+
"purposeFrom": "comment",
|
|
9597
|
+
"props": [
|
|
9598
|
+
{
|
|
9599
|
+
"name": "className",
|
|
9600
|
+
"takes": "text",
|
|
9601
|
+
"required": false,
|
|
9602
|
+
"note": null
|
|
9603
|
+
}
|
|
9604
|
+
],
|
|
9605
|
+
"variants": [],
|
|
9606
|
+
"ownsBehaviours": [],
|
|
9607
|
+
"status": "stable",
|
|
9608
|
+
"migrationStage": null,
|
|
9609
|
+
"docsId": "status-feedback-skeleton--docs",
|
|
9610
|
+
"storyId": "status-feedback-skeleton--list",
|
|
9611
|
+
"docPage": null,
|
|
9612
|
+
"app": null,
|
|
9613
|
+
"looks": []
|
|
9614
|
+
},
|
|
8427
9615
|
{
|
|
8428
9616
|
"name": "SkeletonList",
|
|
8429
9617
|
"repo": "estiva-ui",
|
|
@@ -8922,6 +10110,106 @@
|
|
|
8922
10110
|
"app": null,
|
|
8923
10111
|
"looks": []
|
|
8924
10112
|
},
|
|
10113
|
+
{
|
|
10114
|
+
"name": "Thread",
|
|
10115
|
+
"repo": "estiva-ui",
|
|
10116
|
+
"kind": "component",
|
|
10117
|
+
"importPath": "@estiva-app/ui",
|
|
10118
|
+
"sourceFile": "src/Thread.tsx",
|
|
10119
|
+
"purpose": "A comment's replies, with the box to write one: in the right column under its own header, or under its comment.",
|
|
10120
|
+
"purposeFrom": "page",
|
|
10121
|
+
"props": [
|
|
10122
|
+
{
|
|
10123
|
+
"name": "place",
|
|
10124
|
+
"takes": "beside | under",
|
|
10125
|
+
"required": false,
|
|
10126
|
+
"note": "`beside`: in the right column, beside the comments, under its own header."
|
|
10127
|
+
},
|
|
10128
|
+
{
|
|
10129
|
+
"name": "start",
|
|
10130
|
+
"takes": "ThreadStart",
|
|
10131
|
+
"required": false,
|
|
10132
|
+
"note": "The comment it answers, pinned at the top of the column."
|
|
10133
|
+
},
|
|
10134
|
+
{
|
|
10135
|
+
"name": "children",
|
|
10136
|
+
"takes": "anything",
|
|
10137
|
+
"required": false,
|
|
10138
|
+
"note": "Its replies, in time order: `ReplyCard`s."
|
|
10139
|
+
},
|
|
10140
|
+
{
|
|
10141
|
+
"name": "loading",
|
|
10142
|
+
"takes": "true/false",
|
|
10143
|
+
"required": false,
|
|
10144
|
+
"note": "Still reading the replies: placeholders in their place."
|
|
10145
|
+
},
|
|
10146
|
+
{
|
|
10147
|
+
"name": "resolved",
|
|
10148
|
+
"takes": "true/false",
|
|
10149
|
+
"required": false,
|
|
10150
|
+
"note": "Resolved: \"Resolved\" at the top of the column, in green."
|
|
10151
|
+
},
|
|
10152
|
+
{
|
|
10153
|
+
"name": "box",
|
|
10154
|
+
"takes": "anything",
|
|
10155
|
+
"required": false,
|
|
10156
|
+
"note": "The box a reply is written in: the app's `CommentBox`."
|
|
10157
|
+
},
|
|
10158
|
+
{
|
|
10159
|
+
"name": "notice",
|
|
10160
|
+
"takes": "anything",
|
|
10161
|
+
"required": false,
|
|
10162
|
+
"note": "Said in place of the box: why no reply can be written (an archived page, a deleted comment)."
|
|
10163
|
+
},
|
|
10164
|
+
{
|
|
10165
|
+
"name": "actions",
|
|
10166
|
+
"takes": "anything",
|
|
10167
|
+
"required": false,
|
|
10168
|
+
"note": "The column's own actions, before Close: a `MembersPill`, an `IconButton` to where it was first said."
|
|
10169
|
+
},
|
|
10170
|
+
{
|
|
10171
|
+
"name": "onClose",
|
|
10172
|
+
"takes": "a handler",
|
|
10173
|
+
"required": false,
|
|
10174
|
+
"note": "Closes the column."
|
|
10175
|
+
},
|
|
10176
|
+
{
|
|
10177
|
+
"name": "title",
|
|
10178
|
+
"takes": "anything",
|
|
10179
|
+
"required": false,
|
|
10180
|
+
"note": "The column's name."
|
|
10181
|
+
},
|
|
10182
|
+
{
|
|
10183
|
+
"name": "bodyRef",
|
|
10184
|
+
"takes": "Ref<HTMLDivElement>",
|
|
10185
|
+
"required": false,
|
|
10186
|
+
"note": "The column's scrolling box, for opening at the newest reply."
|
|
10187
|
+
},
|
|
10188
|
+
{
|
|
10189
|
+
"name": "className",
|
|
10190
|
+
"takes": "text",
|
|
10191
|
+
"required": false,
|
|
10192
|
+
"note": "Placement only."
|
|
10193
|
+
}
|
|
10194
|
+
],
|
|
10195
|
+
"variants": [
|
|
10196
|
+
{
|
|
10197
|
+
"prop": "place",
|
|
10198
|
+
"values": [
|
|
10199
|
+
"beside",
|
|
10200
|
+
"under"
|
|
10201
|
+
]
|
|
10202
|
+
}
|
|
10203
|
+
],
|
|
10204
|
+
"ownsBehaviours": [],
|
|
10205
|
+
"status": "stable",
|
|
10206
|
+
"migrationStage": null,
|
|
10207
|
+
"docsId": "conversation-thread--docs",
|
|
10208
|
+
"storyId": "conversation-thread--column",
|
|
10209
|
+
"docPage": "src/Thread.mdx",
|
|
10210
|
+
"app": null,
|
|
10211
|
+
"looks": []
|
|
10212
|
+
},
|
|
8925
10213
|
{
|
|
8926
10214
|
"name": "Toast",
|
|
8927
10215
|
"repo": "estiva-ui",
|
|
@@ -9576,7 +10864,7 @@
|
|
|
9576
10864
|
"name": "menu",
|
|
9577
10865
|
"takes": "anything",
|
|
9578
10866
|
"required": false,
|
|
9579
|
-
"note": "Far left: the menu button, in an app whose navigation
|
|
10867
|
+
"note": "Far left: the menu button, in an app whose navigation folds."
|
|
9580
10868
|
},
|
|
9581
10869
|
{
|
|
9582
10870
|
"name": "logo",
|
|
@@ -9790,6 +11078,25 @@
|
|
|
9790
11078
|
"app": null,
|
|
9791
11079
|
"looks": []
|
|
9792
11080
|
},
|
|
11081
|
+
{
|
|
11082
|
+
"name": "UrgentMark",
|
|
11083
|
+
"repo": "estiva-ui",
|
|
11084
|
+
"kind": "component",
|
|
11085
|
+
"importPath": "@estiva-app/ui",
|
|
11086
|
+
"sourceFile": "src/UrgentMark.tsx",
|
|
11087
|
+
"purpose": "Urgent and new: a small warning mark on its tint, in the unread dot's 24px slot.",
|
|
11088
|
+
"purposeFrom": "page",
|
|
11089
|
+
"props": [],
|
|
11090
|
+
"variants": [],
|
|
11091
|
+
"ownsBehaviours": [],
|
|
11092
|
+
"status": "stable",
|
|
11093
|
+
"migrationStage": null,
|
|
11094
|
+
"docsId": "conversation-urgentmark--docs",
|
|
11095
|
+
"storyId": "conversation-urgentmark--urgent",
|
|
11096
|
+
"docPage": "src/UrgentMark.mdx",
|
|
11097
|
+
"app": null,
|
|
11098
|
+
"looks": []
|
|
11099
|
+
},
|
|
9793
11100
|
{
|
|
9794
11101
|
"name": "UrgentPersonMention",
|
|
9795
11102
|
"repo": "estiva-ui",
|
|
@@ -9854,6 +11161,44 @@
|
|
|
9854
11161
|
"app": null,
|
|
9855
11162
|
"looks": []
|
|
9856
11163
|
},
|
|
11164
|
+
{
|
|
11165
|
+
"name": "useSidebarFold",
|
|
11166
|
+
"repo": "estiva-ui",
|
|
11167
|
+
"kind": "hook",
|
|
11168
|
+
"importPath": "@estiva-app/ui",
|
|
11169
|
+
"sourceFile": "src/AppShell.tsx",
|
|
11170
|
+
"purpose": "Whether the sidebar is shown, and the setter that remembers it, for `AppShell`'s `navOpen` and `onNavOpenChange`: folded stays folded on this browser, across pages and reloads, until unfolded (Ship's and Leaf's since LED-3, Miky, 28 October; every app's, Katerina, 31 October).",
|
|
11171
|
+
"purposeFrom": "comment",
|
|
11172
|
+
"props": [
|
|
11173
|
+
{
|
|
11174
|
+
"name": "storageKey",
|
|
11175
|
+
"takes": "text",
|
|
11176
|
+
"required": true,
|
|
11177
|
+
"note": "Where this browser keeps a folded sidebar: the app's own key, such as `ship.sidebarFolded`."
|
|
11178
|
+
},
|
|
11179
|
+
{
|
|
11180
|
+
"name": "isFile",
|
|
11181
|
+
"takes": "a handler",
|
|
11182
|
+
"required": false,
|
|
11183
|
+
"note": "Whether the page open now is a file. A file opened from a link — another app's card, a link in a message — shows where it lives, so a folded sidebar unfolds for it, as its button would, and stays unfolded (Katerina, 30 October)."
|
|
11184
|
+
},
|
|
11185
|
+
{
|
|
11186
|
+
"name": "foldWhen",
|
|
11187
|
+
"takes": "text",
|
|
11188
|
+
"required": false,
|
|
11189
|
+
"note": "A media query: a window that matches it opens folded, whatever was kept, with no room beside the page (Leaf's, `(max-width: 1023px)`)."
|
|
11190
|
+
}
|
|
11191
|
+
],
|
|
11192
|
+
"variants": [],
|
|
11193
|
+
"ownsBehaviours": [],
|
|
11194
|
+
"status": "stable",
|
|
11195
|
+
"migrationStage": null,
|
|
11196
|
+
"docsId": "app-frame-appshell--docs",
|
|
11197
|
+
"storyId": "app-frame-appshell--solid",
|
|
11198
|
+
"docPage": null,
|
|
11199
|
+
"app": null,
|
|
11200
|
+
"looks": []
|
|
11201
|
+
},
|
|
9857
11202
|
{
|
|
9858
11203
|
"name": "useToast",
|
|
9859
11204
|
"repo": "estiva-ui",
|