@estiva-app/ui 0.95.0 → 0.96.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/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/ConversationActions.d.ts +24 -0
- package/dist/ConversationActions.d.ts.map +1 -0
- package/dist/ConversationCard.d.ts +88 -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 +3 -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/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/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 +26 -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 +32 -24
- 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 +1376 -433
- package/dist/index.js.map +4 -4
- 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 +1873 -546
- 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/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/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 +522 -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/LinkParts.mdx +4 -0
- package/src/LinkParts.stories.tsx +10 -0
- package/src/LinkParts.tsx +5 -1
- package/src/ListColumn.tsx +9 -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/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/looks.ts +18 -2
- package/src/registry/registry.test.ts +7 -6
- 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.96.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",
|
|
@@ -931,7 +996,7 @@
|
|
|
931
996
|
"rounded-md transition-colors font-sans font-medium",
|
|
932
997
|
"bg-accent-primary hover:bg-accent-hover text-text-inverse cursor-pointer signal:font-semibold",
|
|
933
998
|
"border border-border-default hover:bg-bg-hover text-text-primary cursor-pointer",
|
|
934
|
-
"
|
|
999
|
+
"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
1000
|
]
|
|
936
1001
|
},
|
|
937
1002
|
{
|
|
@@ -1105,14 +1170,14 @@
|
|
|
1105
1170
|
"rounded-lg border bg-bg-surface border-border-default overflow-hidden",
|
|
1106
1171
|
"rounded-lg border bg-bg-surface border-border-default border-dashed",
|
|
1107
1172
|
"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-
|
|
1173
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline",
|
|
1174
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline overflow-hidden",
|
|
1175
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline border-dashed",
|
|
1176
|
+
"rounded-lg border bg-bg-surface border-border-default border-accent-outline hover:border-accent-outline border-dashed overflow-hidden",
|
|
1177
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline",
|
|
1178
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline overflow-hidden",
|
|
1179
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline border-dashed",
|
|
1180
|
+
"rounded-lg border bg-bg-surface border-border-default border-warning-outline hover:border-warning-outline border-dashed overflow-hidden"
|
|
1116
1181
|
]
|
|
1117
1182
|
},
|
|
1118
1183
|
{
|
|
@@ -1134,6 +1199,25 @@
|
|
|
1134
1199
|
"app": null,
|
|
1135
1200
|
"looks": []
|
|
1136
1201
|
},
|
|
1202
|
+
{
|
|
1203
|
+
"name": "caretOnOpen",
|
|
1204
|
+
"repo": "estiva-ui",
|
|
1205
|
+
"kind": "helper",
|
|
1206
|
+
"importPath": "@estiva-app/ui",
|
|
1207
|
+
"sourceFile": "src/threadCard.ts",
|
|
1208
|
+
"purpose": "Counts the times a thread has opened in a ConversationLayout.",
|
|
1209
|
+
"purposeFrom": "comment",
|
|
1210
|
+
"props": [],
|
|
1211
|
+
"variants": [],
|
|
1212
|
+
"ownsBehaviours": [],
|
|
1213
|
+
"status": "stable",
|
|
1214
|
+
"migrationStage": null,
|
|
1215
|
+
"docsId": null,
|
|
1216
|
+
"storyId": null,
|
|
1217
|
+
"docPage": null,
|
|
1218
|
+
"app": null,
|
|
1219
|
+
"looks": []
|
|
1220
|
+
},
|
|
1137
1221
|
{
|
|
1138
1222
|
"name": "Checkbox",
|
|
1139
1223
|
"repo": "estiva-ui",
|
|
@@ -2468,548 +2552,1058 @@
|
|
|
2468
2552
|
]
|
|
2469
2553
|
},
|
|
2470
2554
|
{
|
|
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",
|
|
2555
|
+
"name": "ConversationActions",
|
|
2529
2556
|
"repo": "estiva-ui",
|
|
2530
2557
|
"kind": "component",
|
|
2531
2558
|
"importPath": "@estiva-app/ui",
|
|
2532
|
-
"sourceFile": "src/
|
|
2533
|
-
"purpose": "The
|
|
2559
|
+
"sourceFile": "src/ConversationActions.tsx",
|
|
2560
|
+
"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
2561
|
"purposeFrom": "page",
|
|
2535
2562
|
"props": [
|
|
2536
2563
|
{
|
|
2537
|
-
"name": "
|
|
2538
|
-
"takes": "
|
|
2539
|
-
"required":
|
|
2540
|
-
"note": "
|
|
2564
|
+
"name": "options",
|
|
2565
|
+
"takes": "readonly ReactionOption[]",
|
|
2566
|
+
"required": false,
|
|
2567
|
+
"note": "The reactions on offer: with `onReact`, \"React\" opens them over the strip."
|
|
2541
2568
|
},
|
|
2542
2569
|
{
|
|
2543
|
-
"name": "
|
|
2570
|
+
"name": "onReact",
|
|
2544
2571
|
"takes": "a handler",
|
|
2545
|
-
"required":
|
|
2572
|
+
"required": false,
|
|
2546
2573
|
"note": null
|
|
2547
2574
|
},
|
|
2548
2575
|
{
|
|
2549
|
-
"name": "
|
|
2550
|
-
"takes": "
|
|
2576
|
+
"name": "onReply",
|
|
2577
|
+
"takes": "a handler",
|
|
2551
2578
|
"required": false,
|
|
2552
|
-
"note":
|
|
2579
|
+
"note": null
|
|
2553
2580
|
},
|
|
2554
2581
|
{
|
|
2555
|
-
"name": "
|
|
2556
|
-
"takes": "
|
|
2582
|
+
"name": "resolved",
|
|
2583
|
+
"takes": "true/false",
|
|
2557
2584
|
"required": false,
|
|
2558
|
-
"note": "
|
|
2585
|
+
"note": "Resolved: the strip offers Reopen in place of Resolve."
|
|
2559
2586
|
},
|
|
2560
2587
|
{
|
|
2561
|
-
"name": "
|
|
2562
|
-
"takes": "
|
|
2563
|
-
"required":
|
|
2588
|
+
"name": "onResolve",
|
|
2589
|
+
"takes": "a handler",
|
|
2590
|
+
"required": false,
|
|
2564
2591
|
"note": null
|
|
2565
2592
|
},
|
|
2566
2593
|
{
|
|
2567
|
-
"name": "
|
|
2568
|
-
"takes": "
|
|
2594
|
+
"name": "onReopen",
|
|
2595
|
+
"takes": "a handler",
|
|
2569
2596
|
"required": false,
|
|
2570
|
-
"note":
|
|
2597
|
+
"note": null
|
|
2571
2598
|
},
|
|
2572
2599
|
{
|
|
2573
|
-
"name": "
|
|
2574
|
-
"takes": "
|
|
2600
|
+
"name": "onPickerOpenChange",
|
|
2601
|
+
"takes": "a handler",
|
|
2575
2602
|
"required": false,
|
|
2576
|
-
"note": "
|
|
2603
|
+
"note": "Told when the reactions open and close, so a card can keep its strip while they are up."
|
|
2577
2604
|
},
|
|
2578
2605
|
{
|
|
2579
|
-
"name": "
|
|
2580
|
-
"takes": "
|
|
2606
|
+
"name": "more",
|
|
2607
|
+
"takes": "anything",
|
|
2581
2608
|
"required": false,
|
|
2582
|
-
"note":
|
|
2609
|
+
"note": "The ⋯ menu: a `ConversationMenu` whose trigger is a `ToolbarButton`, so the strip stays one Tab stop."
|
|
2583
2610
|
},
|
|
2584
2611
|
{
|
|
2585
|
-
"name": "
|
|
2586
|
-
"takes": "
|
|
2612
|
+
"name": "className",
|
|
2613
|
+
"takes": "text",
|
|
2587
2614
|
"required": false,
|
|
2588
|
-
"note": "
|
|
2615
|
+
"note": "Placement only: `absolute right-1 top-1`."
|
|
2589
2616
|
}
|
|
2590
2617
|
],
|
|
2591
2618
|
"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
|
-
],
|
|
2619
|
+
"ownsBehaviours": [],
|
|
2622
2620
|
"status": "stable",
|
|
2623
2621
|
"migrationStage": null,
|
|
2624
|
-
"docsId": "
|
|
2625
|
-
"storyId": "
|
|
2626
|
-
"docPage": "src/
|
|
2622
|
+
"docsId": "conversation-conversationactions--docs",
|
|
2623
|
+
"storyId": "conversation-conversationactions--comment",
|
|
2624
|
+
"docPage": "src/ConversationActions.mdx",
|
|
2627
2625
|
"app": null,
|
|
2628
|
-
"looks": [
|
|
2629
|
-
"bg-bg-elevated border border-border-subtle rounded-lg shadow-lg pointer-events-auto overflow-hidden outline-none"
|
|
2630
|
-
]
|
|
2626
|
+
"looks": []
|
|
2631
2627
|
},
|
|
2632
2628
|
{
|
|
2633
|
-
"name": "
|
|
2629
|
+
"name": "ConversationCard",
|
|
2634
2630
|
"repo": "estiva-ui",
|
|
2635
2631
|
"kind": "component",
|
|
2636
2632
|
"importPath": "@estiva-app/ui",
|
|
2637
|
-
"sourceFile": "src/
|
|
2638
|
-
"purpose": "
|
|
2633
|
+
"sourceFile": "src/ConversationCard.tsx",
|
|
2634
|
+
"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
2635
|
"purposeFrom": "page",
|
|
2640
2636
|
"props": [
|
|
2641
2637
|
{
|
|
2642
|
-
"name": "
|
|
2643
|
-
"takes": "
|
|
2638
|
+
"name": "deleted",
|
|
2639
|
+
"takes": "true/false",
|
|
2644
2640
|
"required": false,
|
|
2645
|
-
"note":
|
|
2641
|
+
"note": "Deleted: \"This comment was deleted.\", and its replies stay."
|
|
2646
2642
|
},
|
|
2647
2643
|
{
|
|
2648
|
-
"name": "
|
|
2649
|
-
"takes": "
|
|
2644
|
+
"name": "replies",
|
|
2645
|
+
"takes": "Omit<RepliesRowProps, 'urgent'>",
|
|
2650
2646
|
"required": false,
|
|
2651
|
-
"note": "
|
|
2647
|
+
"note": "Its thread: how many replied, their faces, the last time, and whether one is new."
|
|
2652
2648
|
},
|
|
2653
2649
|
{
|
|
2654
|
-
"name": "
|
|
2655
|
-
"takes": "
|
|
2650
|
+
"name": "onReply",
|
|
2651
|
+
"takes": "a handler",
|
|
2656
2652
|
"required": false,
|
|
2657
|
-
"note": "
|
|
2653
|
+
"note": "Reply: offered on the strip."
|
|
2658
2654
|
},
|
|
2659
2655
|
{
|
|
2660
|
-
"name": "
|
|
2656
|
+
"name": "resolved",
|
|
2657
|
+
"takes": "{ by: string; note?: string; at?: string }",
|
|
2658
|
+
"required": false,
|
|
2659
|
+
"note": "Resolved, by whom, with what note and when (`at`, in the app's words)."
|
|
2660
|
+
},
|
|
2661
|
+
{
|
|
2662
|
+
"name": "onResolve",
|
|
2663
|
+
"takes": "a handler",
|
|
2664
|
+
"required": false,
|
|
2665
|
+
"note": "Resolve, with the note written in the dialog the card opens."
|
|
2666
|
+
},
|
|
2667
|
+
{
|
|
2668
|
+
"name": "resolveRefused",
|
|
2661
2669
|
"takes": "text",
|
|
2662
2670
|
"required": false,
|
|
2671
|
+
"note": "Why the last resolve was refused, in plain words: said under the note, while the dialog stays open (`onResolve` answered `false`)."
|
|
2672
|
+
},
|
|
2673
|
+
{
|
|
2674
|
+
"name": "onReopen",
|
|
2675
|
+
"takes": "a handler",
|
|
2676
|
+
"required": false,
|
|
2663
2677
|
"note": null
|
|
2664
|
-
}
|
|
2665
|
-
],
|
|
2666
|
-
"variants": [
|
|
2678
|
+
},
|
|
2667
2679
|
{
|
|
2668
|
-
"
|
|
2669
|
-
"
|
|
2670
|
-
|
|
2671
|
-
|
|
2672
|
-
]
|
|
2680
|
+
"name": "selected",
|
|
2681
|
+
"takes": "true/false",
|
|
2682
|
+
"required": false,
|
|
2683
|
+
"note": "The one open beside its thread."
|
|
2673
2684
|
},
|
|
2674
2685
|
{
|
|
2675
|
-
"
|
|
2676
|
-
"
|
|
2677
|
-
|
|
2678
|
-
|
|
2679
|
-
|
|
2680
|
-
}
|
|
2681
|
-
],
|
|
2682
|
-
"ownsBehaviours": [
|
|
2686
|
+
"name": "onClick",
|
|
2687
|
+
"takes": "a handler",
|
|
2688
|
+
"required": false,
|
|
2689
|
+
"note": "A press on the card: its thread opens."
|
|
2690
|
+
},
|
|
2683
2691
|
{
|
|
2684
|
-
"
|
|
2685
|
-
"
|
|
2692
|
+
"name": "author",
|
|
2693
|
+
"takes": "ConversationPerson",
|
|
2694
|
+
"required": true,
|
|
2695
|
+
"note": null
|
|
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",
|
|
2698
|
+
"name": "time",
|
|
2699
|
+
"takes": "anything",
|
|
2712
2700
|
"required": true,
|
|
2713
|
-
"note": "
|
|
2701
|
+
"note": "When it was written, in the app's words (\"11:08 AM\")."
|
|
2714
2702
|
},
|
|
2715
2703
|
{
|
|
2716
|
-
"name": "
|
|
2704
|
+
"name": "timeHref",
|
|
2717
2705
|
"takes": "text",
|
|
2718
|
-
"required":
|
|
2719
|
-
"note": "
|
|
2720
|
-
},
|
|
2721
|
-
{
|
|
2722
|
-
"name": "codec",
|
|
2723
|
-
"takes": "DocumentCodec",
|
|
2724
|
-
"required": true,
|
|
2725
|
-
"note": null
|
|
2726
|
-
},
|
|
2727
|
-
{
|
|
2728
|
-
"name": "onCommit",
|
|
2729
|
-
"takes": "a handler",
|
|
2730
|
-
"required": true,
|
|
2731
|
-
"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."
|
|
2706
|
+
"required": false,
|
|
2707
|
+
"note": "A link to it: the time is then the link, \"Link to this\", as a reply's is."
|
|
2732
2708
|
},
|
|
2733
2709
|
{
|
|
2734
|
-
"name": "
|
|
2710
|
+
"name": "edited",
|
|
2735
2711
|
"takes": "text",
|
|
2736
|
-
"required": true,
|
|
2737
|
-
"note": "The editor's accessible name."
|
|
2738
|
-
},
|
|
2739
|
-
{
|
|
2740
|
-
"name": "placeholder",
|
|
2741
|
-
"takes": "anything",
|
|
2742
2712
|
"required": false,
|
|
2743
|
-
"note": "
|
|
2713
|
+
"note": "When it was last edited, in the app's words for the tooltip (\"Edited 11:20 AM\"): draws \"(edited)\"."
|
|
2744
2714
|
},
|
|
2745
2715
|
{
|
|
2746
|
-
"name": "
|
|
2747
|
-
"takes": "
|
|
2748
|
-
"required":
|
|
2749
|
-
"note": "
|
|
2716
|
+
"name": "children",
|
|
2717
|
+
"takes": "anything",
|
|
2718
|
+
"required": true,
|
|
2719
|
+
"note": "The words, as the app draws them: text, mentions, links, attached cards, quoted blocks."
|
|
2750
2720
|
},
|
|
2751
2721
|
{
|
|
2752
|
-
"name": "
|
|
2753
|
-
"takes": "
|
|
2722
|
+
"name": "about",
|
|
2723
|
+
"takes": "anything",
|
|
2754
2724
|
"required": false,
|
|
2755
|
-
"note": "
|
|
2725
|
+
"note": "What it is about, a `QuotedLine` for a comment on a part of the page: under the name, above the words."
|
|
2756
2726
|
},
|
|
2757
2727
|
{
|
|
2758
|
-
"name": "
|
|
2759
|
-
"takes": "
|
|
2728
|
+
"name": "files",
|
|
2729
|
+
"takes": "anything",
|
|
2760
2730
|
"required": false,
|
|
2761
|
-
"note": "
|
|
2731
|
+
"note": "Pictures and files: `AttachmentCard`s, laid out under the words."
|
|
2762
2732
|
},
|
|
2763
2733
|
{
|
|
2764
|
-
"name": "
|
|
2765
|
-
"takes": "
|
|
2734
|
+
"name": "reactions",
|
|
2735
|
+
"takes": "ReactionRowProps",
|
|
2766
2736
|
"required": false,
|
|
2767
|
-
"note": "
|
|
2737
|
+
"note": "Its reactions: the kit's `ReactionRow`. With `onToggle`, the strip offers React too."
|
|
2768
2738
|
},
|
|
2769
2739
|
{
|
|
2770
|
-
"name": "
|
|
2740
|
+
"name": "reactionRefused",
|
|
2771
2741
|
"takes": "text",
|
|
2772
2742
|
"required": false,
|
|
2773
|
-
"note":
|
|
2743
|
+
"note": "Why the last reaction was refused, in plain words: said under the reactions."
|
|
2774
2744
|
},
|
|
2775
2745
|
{
|
|
2776
|
-
"name": "
|
|
2777
|
-
"takes": "
|
|
2746
|
+
"name": "isNew",
|
|
2747
|
+
"takes": "true/false",
|
|
2778
2748
|
"required": false,
|
|
2779
|
-
"note": "`
|
|
2749
|
+
"note": "Not read yet: the dot, or the urgent mark with `urgent`, and the card's edge in the theme's colour."
|
|
2780
2750
|
},
|
|
2781
2751
|
{
|
|
2782
|
-
"name": "
|
|
2783
|
-
"takes": "
|
|
2752
|
+
"name": "urgent",
|
|
2753
|
+
"takes": "true/false",
|
|
2784
2754
|
"required": false,
|
|
2785
|
-
"note":
|
|
2755
|
+
"note": null
|
|
2786
2756
|
},
|
|
2787
2757
|
{
|
|
2788
|
-
"name": "
|
|
2789
|
-
"takes": "
|
|
2758
|
+
"name": "own",
|
|
2759
|
+
"takes": "true/false",
|
|
2790
2760
|
"required": false,
|
|
2791
|
-
"note": "
|
|
2761
|
+
"note": "It is yours: the menu offers Edit (with `editor`) and Delete (with `onDelete`)."
|
|
2792
2762
|
},
|
|
2793
2763
|
{
|
|
2794
|
-
"name": "
|
|
2795
|
-
"takes": "
|
|
2764
|
+
"name": "readOnly",
|
|
2765
|
+
"takes": "true/false",
|
|
2796
2766
|
"required": false,
|
|
2797
|
-
"note": "
|
|
2767
|
+
"note": "Nothing can be changed (an archived page): no strip, reactions only shown."
|
|
2798
2768
|
},
|
|
2799
2769
|
{
|
|
2800
|
-
"name": "
|
|
2770
|
+
"name": "editor",
|
|
2801
2771
|
"takes": "a handler",
|
|
2802
2772
|
"required": false,
|
|
2803
|
-
"note": "
|
|
2773
|
+
"note": "The box it is edited in, the app's `CommentBox` edit form; call `done` when it saves or cancels."
|
|
2804
2774
|
},
|
|
2805
2775
|
{
|
|
2806
|
-
"name": "
|
|
2776
|
+
"name": "editing",
|
|
2807
2777
|
"takes": "true/false",
|
|
2808
2778
|
"required": false,
|
|
2809
|
-
"note": "
|
|
2779
|
+
"note": "Being edited, when the app holds it (an edit that was refused opens again)."
|
|
2810
2780
|
},
|
|
2811
2781
|
{
|
|
2812
|
-
"name": "
|
|
2782
|
+
"name": "onEditingChange",
|
|
2813
2783
|
"takes": "a handler",
|
|
2814
2784
|
"required": false,
|
|
2815
|
-
"note":
|
|
2785
|
+
"note": null
|
|
2816
2786
|
},
|
|
2817
2787
|
{
|
|
2818
|
-
"name": "
|
|
2788
|
+
"name": "onDelete",
|
|
2819
2789
|
"takes": "a handler",
|
|
2820
2790
|
"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."
|
|
2791
|
+
"note": "Delete, after the card has asked."
|
|
2834
2792
|
},
|
|
2835
2793
|
{
|
|
2836
|
-
"name": "
|
|
2837
|
-
"takes": "
|
|
2794
|
+
"name": "deleteNote",
|
|
2795
|
+
"takes": "anything",
|
|
2838
2796
|
"required": false,
|
|
2839
|
-
"note": "
|
|
2797
|
+
"note": "The app's sentence in the delete question, what deleting does there."
|
|
2840
2798
|
},
|
|
2841
2799
|
{
|
|
2842
|
-
"name": "
|
|
2843
|
-
"takes": "
|
|
2800
|
+
"name": "menu",
|
|
2801
|
+
"takes": "anything",
|
|
2844
2802
|
"required": false,
|
|
2845
|
-
"note": "The
|
|
2803
|
+
"note": "The app's own rows in the ⋯ menu: `MenuItem`s."
|
|
2846
2804
|
},
|
|
2847
2805
|
{
|
|
2848
|
-
"name": "
|
|
2849
|
-
"takes": "
|
|
2806
|
+
"name": "className",
|
|
2807
|
+
"takes": "text",
|
|
2850
2808
|
"required": false,
|
|
2851
|
-
"note": "
|
|
2809
|
+
"note": "Placement only."
|
|
2852
2810
|
}
|
|
2853
2811
|
],
|
|
2854
2812
|
"variants": [],
|
|
2855
2813
|
"ownsBehaviours": [],
|
|
2856
2814
|
"status": "stable",
|
|
2857
2815
|
"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,
|
|
2816
|
+
"docsId": "conversation-conversationcard--docs",
|
|
2817
|
+
"storyId": "conversation-conversationcard--comment",
|
|
2818
|
+
"docPage": "src/ConversationCard.mdx",
|
|
2880
2819
|
"app": null,
|
|
2881
|
-
"looks": [
|
|
2820
|
+
"looks": [
|
|
2821
|
+
"[&>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"
|
|
2822
|
+
]
|
|
2882
2823
|
},
|
|
2883
2824
|
{
|
|
2884
|
-
"name": "
|
|
2825
|
+
"name": "ConversationLayout",
|
|
2885
2826
|
"repo": "estiva-ui",
|
|
2886
2827
|
"kind": "component",
|
|
2887
2828
|
"importPath": "@estiva-app/ui",
|
|
2888
|
-
"sourceFile": "src/
|
|
2889
|
-
"purpose": "
|
|
2829
|
+
"sourceFile": "src/ConversationLayout.tsx",
|
|
2830
|
+
"purpose": "Where a conversation's cards sit: two columns, or one 384px column beside the page.",
|
|
2890
2831
|
"purposeFrom": "page",
|
|
2891
2832
|
"props": [
|
|
2892
2833
|
{
|
|
2893
|
-
"name": "
|
|
2894
|
-
"takes": "
|
|
2834
|
+
"name": "threads",
|
|
2835
|
+
"takes": "beside | under",
|
|
2895
2836
|
"required": true,
|
|
2896
|
-
"note":
|
|
2837
|
+
"note": "Where an open thread stands. `beside`, two columns: the comments fill the page, the thread stands in the 384px column beside them."
|
|
2897
2838
|
},
|
|
2898
2839
|
{
|
|
2899
|
-
"name": "
|
|
2900
|
-
"takes": "
|
|
2840
|
+
"name": "items",
|
|
2841
|
+
"takes": "readonly ConversationItem[]",
|
|
2901
2842
|
"required": true,
|
|
2902
2843
|
"note": null
|
|
2903
2844
|
},
|
|
2904
2845
|
{
|
|
2905
|
-
"name": "
|
|
2846
|
+
"name": "open",
|
|
2847
|
+
"takes": "text",
|
|
2848
|
+
"required": false,
|
|
2849
|
+
"note": "The id of the comment whose thread is open."
|
|
2850
|
+
},
|
|
2851
|
+
{
|
|
2852
|
+
"name": "onOpenChange",
|
|
2906
2853
|
"takes": "a handler",
|
|
2907
|
-
"required":
|
|
2908
|
-
"note": "
|
|
2854
|
+
"required": false,
|
|
2855
|
+
"note": "A comment asks to open or close its thread: a press anywhere on its card, its replies row, or Reply."
|
|
2909
2856
|
},
|
|
2910
2857
|
{
|
|
2911
|
-
"name": "
|
|
2858
|
+
"name": "box",
|
|
2859
|
+
"takes": "anything",
|
|
2860
|
+
"required": false,
|
|
2861
|
+
"note": "The box a new comment is written in, under the comments."
|
|
2862
|
+
},
|
|
2863
|
+
{
|
|
2864
|
+
"name": "above",
|
|
2865
|
+
"takes": "anything",
|
|
2866
|
+
"required": false,
|
|
2867
|
+
"note": "Above the comments, inside their list: a `ReactionHorizon`, a note."
|
|
2868
|
+
},
|
|
2869
|
+
{
|
|
2870
|
+
"name": "loading",
|
|
2912
2871
|
"takes": "true/false",
|
|
2913
2872
|
"required": false,
|
|
2914
|
-
"note":
|
|
2873
|
+
"note": "Still reading the comments."
|
|
2915
2874
|
},
|
|
2916
2875
|
{
|
|
2917
|
-
"name": "
|
|
2876
|
+
"name": "empty",
|
|
2918
2877
|
"takes": "text",
|
|
2919
2878
|
"required": false,
|
|
2920
|
-
"note": "
|
|
2879
|
+
"note": "What an empty conversation says."
|
|
2921
2880
|
},
|
|
2922
2881
|
{
|
|
2923
|
-
"name": "
|
|
2924
|
-
"takes": "
|
|
2925
|
-
"required":
|
|
2926
|
-
"note": "
|
|
2882
|
+
"name": "header",
|
|
2883
|
+
"takes": "anything",
|
|
2884
|
+
"required": false,
|
|
2885
|
+
"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
2886
|
},
|
|
2928
2887
|
{
|
|
2929
|
-
"name": "
|
|
2930
|
-
"takes": "
|
|
2888
|
+
"name": "title",
|
|
2889
|
+
"takes": "anything",
|
|
2931
2890
|
"required": false,
|
|
2932
|
-
"note": "
|
|
2891
|
+
"note": "One column: its name, in its header."
|
|
2933
2892
|
},
|
|
2934
2893
|
{
|
|
2935
|
-
"name": "
|
|
2894
|
+
"name": "actions",
|
|
2936
2895
|
"takes": "anything",
|
|
2937
2896
|
"required": false,
|
|
2938
|
-
"note": "
|
|
2897
|
+
"note": "One column: its header's actions, as a `Panel`'s."
|
|
2939
2898
|
},
|
|
2940
2899
|
{
|
|
2941
|
-
"name": "
|
|
2942
|
-
"takes": "
|
|
2900
|
+
"name": "className",
|
|
2901
|
+
"takes": "text",
|
|
2943
2902
|
"required": false,
|
|
2944
|
-
"note": "
|
|
2903
|
+
"note": "Placement only."
|
|
2945
2904
|
}
|
|
2946
2905
|
],
|
|
2947
|
-
"variants": [
|
|
2948
|
-
"ownsBehaviours": [
|
|
2906
|
+
"variants": [
|
|
2949
2907
|
{
|
|
2950
|
-
"
|
|
2951
|
-
"
|
|
2908
|
+
"prop": "threads",
|
|
2909
|
+
"values": [
|
|
2910
|
+
"beside",
|
|
2911
|
+
"under"
|
|
2912
|
+
]
|
|
2952
2913
|
}
|
|
2953
2914
|
],
|
|
2915
|
+
"ownsBehaviours": [],
|
|
2954
2916
|
"status": "stable",
|
|
2955
2917
|
"migrationStage": null,
|
|
2956
|
-
"docsId": "
|
|
2957
|
-
"storyId": "
|
|
2958
|
-
"docPage": "src/
|
|
2918
|
+
"docsId": "conversation-conversationlayout--docs",
|
|
2919
|
+
"storyId": "conversation-conversationlayout--two-columns",
|
|
2920
|
+
"docPage": "src/ConversationLayout.mdx",
|
|
2959
2921
|
"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
|
-
]
|
|
2922
|
+
"looks": []
|
|
2969
2923
|
},
|
|
2970
2924
|
{
|
|
2971
|
-
"name": "
|
|
2925
|
+
"name": "ConversationMenu",
|
|
2972
2926
|
"repo": "estiva-ui",
|
|
2973
2927
|
"kind": "component",
|
|
2974
|
-
"importPath": "@estiva-app/ui
|
|
2975
|
-
"sourceFile": "src/
|
|
2976
|
-
"purpose": "
|
|
2928
|
+
"importPath": "@estiva-app/ui",
|
|
2929
|
+
"sourceFile": "src/ConversationMenu.tsx",
|
|
2930
|
+
"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
2931
|
"purposeFrom": "page",
|
|
2978
2932
|
"props": [
|
|
2979
2933
|
{
|
|
2980
|
-
"name": "
|
|
2981
|
-
"takes": "
|
|
2982
|
-
"required":
|
|
2983
|
-
"note": "
|
|
2934
|
+
"name": "resolved",
|
|
2935
|
+
"takes": "true/false",
|
|
2936
|
+
"required": false,
|
|
2937
|
+
"note": "Resolved: the menu offers Reopen in place of Resolve."
|
|
2984
2938
|
},
|
|
2985
2939
|
{
|
|
2986
|
-
"name": "
|
|
2940
|
+
"name": "onResolve",
|
|
2987
2941
|
"takes": "a handler",
|
|
2988
2942
|
"required": false,
|
|
2989
|
-
"note":
|
|
2943
|
+
"note": null
|
|
2990
2944
|
},
|
|
2991
2945
|
{
|
|
2992
|
-
"name": "
|
|
2946
|
+
"name": "onReopen",
|
|
2993
2947
|
"takes": "a handler",
|
|
2994
2948
|
"required": false,
|
|
2995
|
-
"note":
|
|
2949
|
+
"note": null
|
|
2996
2950
|
},
|
|
2997
2951
|
{
|
|
2998
2952
|
"name": "children",
|
|
2999
2953
|
"takes": "anything",
|
|
3000
|
-
"required":
|
|
3001
|
-
"note": "The `
|
|
2954
|
+
"required": false,
|
|
2955
|
+
"note": "The app's own rows, between Resolve and Edit: `MenuItem`s."
|
|
3002
2956
|
},
|
|
3003
2957
|
{
|
|
3004
|
-
"name": "
|
|
3005
|
-
"takes": "
|
|
2958
|
+
"name": "onEdit",
|
|
2959
|
+
"takes": "a handler",
|
|
3006
2960
|
"required": false,
|
|
3007
|
-
"note":
|
|
3008
|
-
}
|
|
3009
|
-
|
|
3010
|
-
|
|
3011
|
-
|
|
3012
|
-
|
|
2961
|
+
"note": "Offered on your own only."
|
|
2962
|
+
},
|
|
2963
|
+
{
|
|
2964
|
+
"name": "onDelete",
|
|
2965
|
+
"takes": "a handler",
|
|
2966
|
+
"required": false,
|
|
2967
|
+
"note": "Offered on your own only; the card asks before it deletes."
|
|
2968
|
+
},
|
|
2969
|
+
{
|
|
2970
|
+
"name": "open",
|
|
2971
|
+
"takes": "true/false",
|
|
2972
|
+
"required": false,
|
|
2973
|
+
"note": null
|
|
2974
|
+
},
|
|
2975
|
+
{
|
|
2976
|
+
"name": "onOpenChange",
|
|
2977
|
+
"takes": "a handler",
|
|
2978
|
+
"required": false,
|
|
2979
|
+
"note": null
|
|
2980
|
+
},
|
|
2981
|
+
{
|
|
2982
|
+
"name": "trigger",
|
|
2983
|
+
"takes": "anything",
|
|
2984
|
+
"required": false,
|
|
2985
|
+
"note": "The button that opens it: a `ToolbarButton` inside `ConversationActions`."
|
|
2986
|
+
}
|
|
2987
|
+
],
|
|
2988
|
+
"variants": [],
|
|
2989
|
+
"ownsBehaviours": [
|
|
2990
|
+
{
|
|
2991
|
+
"id": "portal",
|
|
2992
|
+
"behaviour": "Floats on top of the page"
|
|
2993
|
+
},
|
|
2994
|
+
{
|
|
2995
|
+
"id": "press-outside",
|
|
2996
|
+
"behaviour": "Closes on a press outside"
|
|
2997
|
+
},
|
|
2998
|
+
{
|
|
2999
|
+
"id": "page-keys",
|
|
3000
|
+
"behaviour": "Takes its keys by itself"
|
|
3001
|
+
},
|
|
3002
|
+
{
|
|
3003
|
+
"id": "focus",
|
|
3004
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
3005
|
+
},
|
|
3006
|
+
{
|
|
3007
|
+
"id": "follow",
|
|
3008
|
+
"behaviour": "Stays attached to its anchor on scroll and resize"
|
|
3009
|
+
}
|
|
3010
|
+
],
|
|
3011
|
+
"status": "stable",
|
|
3012
|
+
"migrationStage": null,
|
|
3013
|
+
"docsId": "conversation-conversationmenu--docs",
|
|
3014
|
+
"storyId": "conversation-conversationmenu--yours",
|
|
3015
|
+
"docPage": "src/ConversationMenu.mdx",
|
|
3016
|
+
"app": null,
|
|
3017
|
+
"looks": []
|
|
3018
|
+
},
|
|
3019
|
+
{
|
|
3020
|
+
"name": "deleteBlock",
|
|
3021
|
+
"repo": "estiva-ui",
|
|
3022
|
+
"kind": "helper",
|
|
3023
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3024
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3025
|
+
"purpose": "Removes the block, the caret where it was.",
|
|
3026
|
+
"purposeFrom": "comment",
|
|
3027
|
+
"props": [],
|
|
3028
|
+
"variants": [],
|
|
3029
|
+
"ownsBehaviours": [],
|
|
3030
|
+
"status": "stable",
|
|
3031
|
+
"migrationStage": null,
|
|
3032
|
+
"docsId": "writing-editorblockhandle--docs",
|
|
3033
|
+
"storyId": "writing-editorblockhandle--default",
|
|
3034
|
+
"docPage": null,
|
|
3035
|
+
"app": null,
|
|
3036
|
+
"looks": []
|
|
3037
|
+
},
|
|
3038
|
+
{
|
|
3039
|
+
"name": "deleteTableColumn",
|
|
3040
|
+
"repo": "estiva-ui",
|
|
3041
|
+
"kind": "helper",
|
|
3042
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3043
|
+
"sourceFile": "src/EditorTableControls.tsx",
|
|
3044
|
+
"purpose": "The same for a column: the last one deletes the table.",
|
|
3045
|
+
"purposeFrom": "comment",
|
|
3046
|
+
"props": [],
|
|
3047
|
+
"variants": [],
|
|
3048
|
+
"ownsBehaviours": [],
|
|
3049
|
+
"status": "stable",
|
|
3050
|
+
"migrationStage": null,
|
|
3051
|
+
"docsId": "writing-editortablecontrols--docs",
|
|
3052
|
+
"storyId": "writing-editortablecontrols--default",
|
|
3053
|
+
"docPage": null,
|
|
3054
|
+
"app": null,
|
|
3055
|
+
"looks": []
|
|
3056
|
+
},
|
|
3057
|
+
{
|
|
3058
|
+
"name": "deleteTableRow",
|
|
3059
|
+
"repo": "estiva-ui",
|
|
3060
|
+
"kind": "helper",
|
|
3061
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3062
|
+
"sourceFile": "src/EditorTableControls.tsx",
|
|
3063
|
+
"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).",
|
|
3064
|
+
"purposeFrom": "comment",
|
|
3065
|
+
"props": [],
|
|
3066
|
+
"variants": [],
|
|
3067
|
+
"ownsBehaviours": [],
|
|
3068
|
+
"status": "stable",
|
|
3069
|
+
"migrationStage": null,
|
|
3070
|
+
"docsId": "writing-editortablecontrols--docs",
|
|
3071
|
+
"storyId": "writing-editortablecontrols--default",
|
|
3072
|
+
"docPage": null,
|
|
3073
|
+
"app": null,
|
|
3074
|
+
"looks": []
|
|
3075
|
+
},
|
|
3076
|
+
{
|
|
3077
|
+
"name": "DialogShell",
|
|
3078
|
+
"repo": "estiva-ui",
|
|
3079
|
+
"kind": "component",
|
|
3080
|
+
"importPath": "@estiva-app/ui",
|
|
3081
|
+
"sourceFile": "src/DialogShell.tsx",
|
|
3082
|
+
"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.",
|
|
3083
|
+
"purposeFrom": "page",
|
|
3084
|
+
"props": [
|
|
3085
|
+
{
|
|
3086
|
+
"name": "title",
|
|
3087
|
+
"takes": "text",
|
|
3088
|
+
"required": true,
|
|
3089
|
+
"note": "Labels the dialog for assistive tech, and renders as the header text unless `headerContent` replaces it."
|
|
3090
|
+
},
|
|
3091
|
+
{
|
|
3092
|
+
"name": "onClose",
|
|
3093
|
+
"takes": "a handler",
|
|
3094
|
+
"required": true,
|
|
3095
|
+
"note": null
|
|
3096
|
+
},
|
|
3097
|
+
{
|
|
3098
|
+
"name": "headerContent",
|
|
3099
|
+
"takes": "anything",
|
|
3100
|
+
"required": false,
|
|
3101
|
+
"note": "Replaces the title text in the header — a back button beside the title, a count chip after it."
|
|
3102
|
+
},
|
|
3103
|
+
{
|
|
3104
|
+
"name": "footer",
|
|
3105
|
+
"takes": "anything",
|
|
3106
|
+
"required": false,
|
|
3107
|
+
"note": "Absent: no footer row, and the body keeps the card's own bottom edge (a roster that simply ends)."
|
|
3108
|
+
},
|
|
3109
|
+
{
|
|
3110
|
+
"name": "children",
|
|
3111
|
+
"takes": "anything",
|
|
3112
|
+
"required": true,
|
|
3113
|
+
"note": null
|
|
3114
|
+
},
|
|
3115
|
+
{
|
|
3116
|
+
"name": "bodyClassName",
|
|
3117
|
+
"takes": "text",
|
|
3118
|
+
"required": false,
|
|
3119
|
+
"note": "Extra classes on the body: its layout and any padding override (`flex flex-col gap-6`, `p-0 py-2`)."
|
|
3120
|
+
},
|
|
3121
|
+
{
|
|
3122
|
+
"name": "bodyMaxHeight",
|
|
3123
|
+
"takes": "text",
|
|
3124
|
+
"required": false,
|
|
3125
|
+
"note": "How tall the body may get before it scrolls, as the cap class — `max-h-[400px]`, `max-h-[70vh]`."
|
|
3126
|
+
},
|
|
3127
|
+
{
|
|
3128
|
+
"name": "width",
|
|
3129
|
+
"takes": "number",
|
|
3130
|
+
"required": false,
|
|
3131
|
+
"note": null
|
|
3132
|
+
},
|
|
3133
|
+
{
|
|
3134
|
+
"name": "alert",
|
|
3135
|
+
"takes": "true/false",
|
|
3136
|
+
"required": false,
|
|
3137
|
+
"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."
|
|
3138
|
+
}
|
|
3139
|
+
],
|
|
3140
|
+
"variants": [],
|
|
3141
|
+
"ownsBehaviours": [
|
|
3142
|
+
{
|
|
3143
|
+
"id": "base-ui",
|
|
3144
|
+
"behaviour": "Is built on Base UI"
|
|
3145
|
+
},
|
|
3146
|
+
{
|
|
3147
|
+
"id": "portal",
|
|
3148
|
+
"behaviour": "Floats on top of the page"
|
|
3149
|
+
},
|
|
3150
|
+
{
|
|
3151
|
+
"id": "press-outside",
|
|
3152
|
+
"behaviour": "Closes on a press outside"
|
|
3153
|
+
},
|
|
3154
|
+
{
|
|
3155
|
+
"id": "page-keys",
|
|
3156
|
+
"behaviour": "Takes its keys by itself"
|
|
3157
|
+
},
|
|
3158
|
+
{
|
|
3159
|
+
"id": "focus",
|
|
3160
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
3161
|
+
},
|
|
3162
|
+
{
|
|
3163
|
+
"id": "scroll-lock",
|
|
3164
|
+
"behaviour": "Stops the page behind it scrolling"
|
|
3165
|
+
},
|
|
3166
|
+
{
|
|
3167
|
+
"id": "role",
|
|
3168
|
+
"behaviour": "Says what it is to assistive technology"
|
|
3169
|
+
}
|
|
3170
|
+
],
|
|
3171
|
+
"status": "stable",
|
|
3172
|
+
"migrationStage": null,
|
|
3173
|
+
"docsId": "menus-windows-dialogshell--docs",
|
|
3174
|
+
"storyId": "menus-windows-dialogshell--default",
|
|
3175
|
+
"docPage": "src/DialogShell.mdx",
|
|
3176
|
+
"app": null,
|
|
3177
|
+
"looks": [
|
|
3178
|
+
"bg-bg-elevated border border-border-subtle rounded-lg shadow-lg pointer-events-auto overflow-hidden outline-none"
|
|
3179
|
+
]
|
|
3180
|
+
},
|
|
3181
|
+
{
|
|
3182
|
+
"name": "Divider",
|
|
3183
|
+
"repo": "estiva-ui",
|
|
3184
|
+
"kind": "component",
|
|
3185
|
+
"importPath": "@estiva-app/ui",
|
|
3186
|
+
"sourceFile": "src/Divider.tsx",
|
|
3187
|
+
"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.",
|
|
3188
|
+
"purposeFrom": "page",
|
|
3189
|
+
"props": [
|
|
3190
|
+
{
|
|
3191
|
+
"name": "orientation",
|
|
3192
|
+
"takes": "horizontal | vertical",
|
|
3193
|
+
"required": false,
|
|
3194
|
+
"note": null
|
|
3195
|
+
},
|
|
3196
|
+
{
|
|
3197
|
+
"name": "label",
|
|
3198
|
+
"takes": "anything",
|
|
3199
|
+
"required": false,
|
|
3200
|
+
"note": "Words in the middle of the line — \"New since you last read this\", a date."
|
|
3201
|
+
},
|
|
3202
|
+
{
|
|
3203
|
+
"name": "look",
|
|
3204
|
+
"takes": "caption | section",
|
|
3205
|
+
"required": false,
|
|
3206
|
+
"note": "How the words in the middle are drawn."
|
|
3207
|
+
},
|
|
3208
|
+
{
|
|
3209
|
+
"name": "sticky",
|
|
3210
|
+
"takes": "true/false",
|
|
3211
|
+
"required": false,
|
|
3212
|
+
"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."
|
|
3213
|
+
},
|
|
3214
|
+
{
|
|
3215
|
+
"name": "tone",
|
|
3216
|
+
"takes": "default | warning",
|
|
3217
|
+
"required": false,
|
|
3218
|
+
"note": "`warning` for a line that asks for attention: the label in the warning colour, the lines in its wash."
|
|
3219
|
+
},
|
|
3220
|
+
{
|
|
3221
|
+
"name": "className",
|
|
3222
|
+
"takes": "text",
|
|
3223
|
+
"required": false,
|
|
3224
|
+
"note": null
|
|
3225
|
+
}
|
|
3226
|
+
],
|
|
3227
|
+
"variants": [
|
|
3228
|
+
{
|
|
3229
|
+
"prop": "orientation",
|
|
3230
|
+
"values": [
|
|
3231
|
+
"horizontal",
|
|
3232
|
+
"vertical"
|
|
3233
|
+
]
|
|
3234
|
+
},
|
|
3235
|
+
{
|
|
3236
|
+
"prop": "look",
|
|
3237
|
+
"values": [
|
|
3238
|
+
"caption",
|
|
3239
|
+
"section"
|
|
3240
|
+
]
|
|
3241
|
+
},
|
|
3242
|
+
{
|
|
3243
|
+
"prop": "tone",
|
|
3244
|
+
"values": [
|
|
3245
|
+
"default",
|
|
3246
|
+
"warning"
|
|
3247
|
+
]
|
|
3248
|
+
}
|
|
3249
|
+
],
|
|
3250
|
+
"ownsBehaviours": [
|
|
3251
|
+
{
|
|
3252
|
+
"id": "base-ui",
|
|
3253
|
+
"behaviour": "Is built on Base UI"
|
|
3254
|
+
},
|
|
3255
|
+
{
|
|
3256
|
+
"id": "role",
|
|
3257
|
+
"behaviour": "Says what it is to assistive technology"
|
|
3258
|
+
}
|
|
3259
|
+
],
|
|
3260
|
+
"status": "stable",
|
|
3261
|
+
"migrationStage": null,
|
|
3262
|
+
"docsId": "page-structure-divider--docs",
|
|
3263
|
+
"storyId": "page-structure-divider--default",
|
|
3264
|
+
"docPage": "src/Divider.mdx",
|
|
3265
|
+
"app": null,
|
|
3266
|
+
"looks": []
|
|
3267
|
+
},
|
|
3268
|
+
{
|
|
3269
|
+
"name": "DocumentEditor",
|
|
3270
|
+
"repo": "estiva-ui",
|
|
3271
|
+
"kind": "component",
|
|
3272
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3273
|
+
"sourceFile": "src/DocumentEditor.tsx",
|
|
3274
|
+
"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.",
|
|
3275
|
+
"purposeFrom": "page",
|
|
3276
|
+
"props": [
|
|
3277
|
+
{
|
|
3278
|
+
"name": "value",
|
|
3279
|
+
"takes": "text",
|
|
3280
|
+
"required": true,
|
|
3281
|
+
"note": "The saved text. A new value while the editor is open is somebody else's save, or your own coming back."
|
|
3282
|
+
},
|
|
3283
|
+
{
|
|
3284
|
+
"name": "format",
|
|
3285
|
+
"takes": "text",
|
|
3286
|
+
"required": true,
|
|
3287
|
+
"note": "The format `value` is in, handed to `codec.read`."
|
|
3288
|
+
},
|
|
3289
|
+
{
|
|
3290
|
+
"name": "codec",
|
|
3291
|
+
"takes": "DocumentCodec",
|
|
3292
|
+
"required": true,
|
|
3293
|
+
"note": null
|
|
3294
|
+
},
|
|
3295
|
+
{
|
|
3296
|
+
"name": "onCommit",
|
|
3297
|
+
"takes": "a handler",
|
|
3298
|
+
"required": true,
|
|
3299
|
+
"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."
|
|
3300
|
+
},
|
|
3301
|
+
{
|
|
3302
|
+
"name": "label",
|
|
3303
|
+
"takes": "text",
|
|
3304
|
+
"required": true,
|
|
3305
|
+
"note": "The editor's accessible name."
|
|
3306
|
+
},
|
|
3307
|
+
{
|
|
3308
|
+
"name": "placeholder",
|
|
3309
|
+
"takes": "anything",
|
|
3310
|
+
"required": false,
|
|
3311
|
+
"note": "Muted words over an empty editor."
|
|
3312
|
+
},
|
|
3313
|
+
{
|
|
3314
|
+
"name": "readOnly",
|
|
3315
|
+
"takes": "true/false",
|
|
3316
|
+
"required": false,
|
|
3317
|
+
"note": "For reading: nothing is typed or saved; chips open, and comments on a selection work when on."
|
|
3318
|
+
},
|
|
3319
|
+
{
|
|
3320
|
+
"name": "changedBy",
|
|
3321
|
+
"takes": "{ name: string } | null",
|
|
3322
|
+
"required": false,
|
|
3323
|
+
"note": "Who saved the text last, when it was not you: named in \"… saved a newer version\"."
|
|
3324
|
+
},
|
|
3325
|
+
{
|
|
3326
|
+
"name": "onLeftUnsaved",
|
|
3327
|
+
"takes": "a handler",
|
|
3328
|
+
"required": false,
|
|
3329
|
+
"note": "A save refused after the editor closed, with nothing left on screen to say it."
|
|
3330
|
+
},
|
|
3331
|
+
{
|
|
3332
|
+
"name": "hold",
|
|
3333
|
+
"takes": "HeldTyping",
|
|
3334
|
+
"required": false,
|
|
3335
|
+
"note": "Where text typed when the sign-in ends is held, under `holdKey`."
|
|
3336
|
+
},
|
|
3337
|
+
{
|
|
3338
|
+
"name": "holdKey",
|
|
3339
|
+
"takes": "text",
|
|
3340
|
+
"required": false,
|
|
3341
|
+
"note": null
|
|
3342
|
+
},
|
|
3343
|
+
{
|
|
3344
|
+
"name": "references",
|
|
3345
|
+
"takes": "DocumentReferences",
|
|
3346
|
+
"required": false,
|
|
3347
|
+
"note": "`[` and `/` → File."
|
|
3348
|
+
},
|
|
3349
|
+
{
|
|
3350
|
+
"name": "mentions",
|
|
3351
|
+
"takes": "DocumentMentions",
|
|
3352
|
+
"required": false,
|
|
3353
|
+
"note": "`@` and `/` → Mention."
|
|
3354
|
+
},
|
|
3355
|
+
{
|
|
3356
|
+
"name": "linkChips",
|
|
3357
|
+
"takes": "LinkChipsOptions",
|
|
3358
|
+
"required": false,
|
|
3359
|
+
"note": "A pasted app URL drawn as the chip of what it names (`LinkChips`)."
|
|
3360
|
+
},
|
|
3361
|
+
{
|
|
3362
|
+
"name": "upload",
|
|
3363
|
+
"takes": "a handler",
|
|
3364
|
+
"required": false,
|
|
3365
|
+
"note": "`/` → Upload, and a pasted picture: upload one file and answer the attachment's attributes (its `imeta` fields)."
|
|
3366
|
+
},
|
|
3367
|
+
{
|
|
3368
|
+
"name": "readMarkdown",
|
|
3369
|
+
"takes": "a handler",
|
|
3370
|
+
"required": false,
|
|
3371
|
+
"note": "Plain text pasted as the blocks it spells: the app's reader of markdown, as the editor's document."
|
|
3372
|
+
},
|
|
3373
|
+
{
|
|
3374
|
+
"name": "table",
|
|
3375
|
+
"takes": "true/false",
|
|
3376
|
+
"required": false,
|
|
3377
|
+
"note": "`/` → Table. Default on."
|
|
3378
|
+
},
|
|
3379
|
+
{
|
|
3380
|
+
"name": "onCommentOnSelection",
|
|
3381
|
+
"takes": "a handler",
|
|
3382
|
+
"required": false,
|
|
3383
|
+
"note": "Comment on what is selected: the selection strip's Comment, and the comment highlights."
|
|
3384
|
+
},
|
|
3385
|
+
{
|
|
3386
|
+
"name": "blockRows",
|
|
3387
|
+
"takes": "a handler",
|
|
3388
|
+
"required": false,
|
|
3389
|
+
"note": "The app's rows in a block's handle menu, after the editing ones: Copy link, Comment."
|
|
3390
|
+
},
|
|
3391
|
+
{
|
|
3392
|
+
"name": "referenceView",
|
|
3393
|
+
"takes": "ComponentType<ReferenceViewProps>",
|
|
3394
|
+
"required": false,
|
|
3395
|
+
"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)."
|
|
3396
|
+
},
|
|
3397
|
+
{
|
|
3398
|
+
"name": "attachmentView",
|
|
3399
|
+
"takes": "ComponentType<AttachmentViewProps>",
|
|
3400
|
+
"required": false,
|
|
3401
|
+
"note": "Draws a placed file: the app's own card."
|
|
3402
|
+
},
|
|
3403
|
+
{
|
|
3404
|
+
"name": "wrap",
|
|
3405
|
+
"takes": "a handler",
|
|
3406
|
+
"required": false,
|
|
3407
|
+
"note": "Around everything the editor draws: the app's providers, which may read the editor."
|
|
3408
|
+
},
|
|
3409
|
+
{
|
|
3410
|
+
"name": "onEditor",
|
|
3411
|
+
"takes": "a handler",
|
|
3412
|
+
"required": false,
|
|
3413
|
+
"note": "The editor, once it is there, and `null` as it goes."
|
|
3414
|
+
},
|
|
3415
|
+
{
|
|
3416
|
+
"name": "extensions",
|
|
3417
|
+
"takes": "readonly AnyExtension[]",
|
|
3418
|
+
"required": false,
|
|
3419
|
+
"note": "More of the app's own extensions."
|
|
3420
|
+
}
|
|
3421
|
+
],
|
|
3422
|
+
"variants": [],
|
|
3423
|
+
"ownsBehaviours": [],
|
|
3424
|
+
"status": "stable",
|
|
3425
|
+
"migrationStage": null,
|
|
3426
|
+
"docsId": "writing-documenteditor--docs",
|
|
3427
|
+
"storyId": "writing-documenteditor--with-comments",
|
|
3428
|
+
"docPage": "src/DocumentEditor.mdx",
|
|
3429
|
+
"app": null,
|
|
3430
|
+
"looks": []
|
|
3431
|
+
},
|
|
3432
|
+
{
|
|
3433
|
+
"name": "duplicateBlock",
|
|
3434
|
+
"repo": "estiva-ui",
|
|
3435
|
+
"kind": "helper",
|
|
3436
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3437
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3438
|
+
"purpose": "A copy of the block straight after it, the caret in the copy.",
|
|
3439
|
+
"purposeFrom": "comment",
|
|
3440
|
+
"props": [],
|
|
3441
|
+
"variants": [],
|
|
3442
|
+
"ownsBehaviours": [],
|
|
3443
|
+
"status": "stable",
|
|
3444
|
+
"migrationStage": null,
|
|
3445
|
+
"docsId": "writing-editorblockhandle--docs",
|
|
3446
|
+
"storyId": "writing-editorblockhandle--default",
|
|
3447
|
+
"docPage": null,
|
|
3448
|
+
"app": null,
|
|
3449
|
+
"looks": []
|
|
3450
|
+
},
|
|
3451
|
+
{
|
|
3452
|
+
"name": "EditableText",
|
|
3453
|
+
"repo": "estiva-ui",
|
|
3454
|
+
"kind": "component",
|
|
3455
|
+
"importPath": "@estiva-app/ui",
|
|
3456
|
+
"sourceFile": "src/EditableText.tsx",
|
|
3457
|
+
"purpose": "Text you click to edit. It reads as text until clicked; then it is a field.",
|
|
3458
|
+
"purposeFrom": "page",
|
|
3459
|
+
"props": [
|
|
3460
|
+
{
|
|
3461
|
+
"name": "value",
|
|
3462
|
+
"takes": "text",
|
|
3463
|
+
"required": true,
|
|
3464
|
+
"note": null
|
|
3465
|
+
},
|
|
3466
|
+
{
|
|
3467
|
+
"name": "placeholder",
|
|
3468
|
+
"takes": "text",
|
|
3469
|
+
"required": true,
|
|
3470
|
+
"note": null
|
|
3471
|
+
},
|
|
3472
|
+
{
|
|
3473
|
+
"name": "onCommit",
|
|
3474
|
+
"takes": "a handler",
|
|
3475
|
+
"required": true,
|
|
3476
|
+
"note": "Resolve `true` when saved; `false` (or throw) keeps the field open with the text."
|
|
3477
|
+
},
|
|
3478
|
+
{
|
|
3479
|
+
"name": "multiline",
|
|
3480
|
+
"takes": "true/false",
|
|
3481
|
+
"required": false,
|
|
3482
|
+
"note": null
|
|
3483
|
+
},
|
|
3484
|
+
{
|
|
3485
|
+
"name": "className",
|
|
3486
|
+
"takes": "text",
|
|
3487
|
+
"required": false,
|
|
3488
|
+
"note": "Applied to both the text and the field, so they are the same size."
|
|
3489
|
+
},
|
|
3490
|
+
{
|
|
3491
|
+
"name": "label",
|
|
3492
|
+
"takes": "text",
|
|
3493
|
+
"required": true,
|
|
3494
|
+
"note": "The accessible name of the field — \"Title\", \"Description\"."
|
|
3495
|
+
},
|
|
3496
|
+
{
|
|
3497
|
+
"name": "display",
|
|
3498
|
+
"takes": "text",
|
|
3499
|
+
"required": false,
|
|
3500
|
+
"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."
|
|
3501
|
+
},
|
|
3502
|
+
{
|
|
3503
|
+
"name": "displayNode",
|
|
3504
|
+
"takes": "anything",
|
|
3505
|
+
"required": false,
|
|
3506
|
+
"note": "What to *draw* when not editing, when the value is structured rather than a line of prose."
|
|
3507
|
+
},
|
|
3508
|
+
{
|
|
3509
|
+
"name": "readOnly",
|
|
3510
|
+
"takes": "true/false",
|
|
3511
|
+
"required": false,
|
|
3512
|
+
"note": "Show the value only — no edit affordance."
|
|
3513
|
+
}
|
|
3514
|
+
],
|
|
3515
|
+
"variants": [],
|
|
3516
|
+
"ownsBehaviours": [
|
|
3517
|
+
{
|
|
3518
|
+
"id": "base-ui",
|
|
3519
|
+
"behaviour": "Is built on Base UI"
|
|
3520
|
+
}
|
|
3521
|
+
],
|
|
3522
|
+
"status": "stable",
|
|
3523
|
+
"migrationStage": null,
|
|
3524
|
+
"docsId": "forms-fields-editabletext--docs",
|
|
3525
|
+
"storyId": "forms-fields-editabletext--title",
|
|
3526
|
+
"docPage": "src/EditableText.mdx",
|
|
3527
|
+
"app": null,
|
|
3528
|
+
"looks": [
|
|
3529
|
+
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none",
|
|
3530
|
+
"rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none resize-none",
|
|
3531
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-primary",
|
|
3532
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-muted",
|
|
3533
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-primary",
|
|
3534
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-muted",
|
|
3535
|
+
"rounded-md border border-transparent text-left transition-colors hover:border-border-default"
|
|
3536
|
+
]
|
|
3537
|
+
},
|
|
3538
|
+
{
|
|
3539
|
+
"name": "EditedMarker",
|
|
3540
|
+
"repo": "estiva-ui",
|
|
3541
|
+
"kind": "component",
|
|
3542
|
+
"importPath": "@estiva-app/ui",
|
|
3543
|
+
"sourceFile": "src/EditedMarker.tsx",
|
|
3544
|
+
"purpose": "\"(edited)\" beside a time, with when it was edited on hover.",
|
|
3545
|
+
"purposeFrom": "page",
|
|
3546
|
+
"props": [
|
|
3547
|
+
{
|
|
3548
|
+
"name": "edited",
|
|
3549
|
+
"takes": "text",
|
|
3550
|
+
"required": false,
|
|
3551
|
+
"note": "When it was edited, in the app's words for the tooltip (\"Edited 11:20 AM\")."
|
|
3552
|
+
}
|
|
3553
|
+
],
|
|
3554
|
+
"variants": [],
|
|
3555
|
+
"ownsBehaviours": [],
|
|
3556
|
+
"status": "stable",
|
|
3557
|
+
"migrationStage": null,
|
|
3558
|
+
"docsId": "conversation-editedmarker--docs",
|
|
3559
|
+
"storyId": "conversation-editedmarker--edited",
|
|
3560
|
+
"docPage": "src/EditedMarker.mdx",
|
|
3561
|
+
"app": null,
|
|
3562
|
+
"looks": []
|
|
3563
|
+
},
|
|
3564
|
+
{
|
|
3565
|
+
"name": "EditorBlockHandle",
|
|
3566
|
+
"repo": "estiva-ui",
|
|
3567
|
+
"kind": "component",
|
|
3568
|
+
"importPath": "@estiva-app/ui/editor",
|
|
3569
|
+
"sourceFile": "src/EditorBlockHandle.tsx",
|
|
3570
|
+
"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.",
|
|
3571
|
+
"purposeFrom": "page",
|
|
3572
|
+
"props": [
|
|
3573
|
+
{
|
|
3574
|
+
"name": "editor",
|
|
3575
|
+
"takes": "Editor | null",
|
|
3576
|
+
"required": true,
|
|
3577
|
+
"note": "The editor. Not editable, or not there yet, and the handle reads: the caller's rows only."
|
|
3578
|
+
},
|
|
3579
|
+
{
|
|
3580
|
+
"name": "turnInto",
|
|
3581
|
+
"takes": "a handler",
|
|
3582
|
+
"required": false,
|
|
3583
|
+
"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."
|
|
3584
|
+
},
|
|
3585
|
+
{
|
|
3586
|
+
"name": "actions",
|
|
3587
|
+
"takes": "a handler",
|
|
3588
|
+
"required": false,
|
|
3589
|
+
"note": "The caller's own rows, after the editing ones."
|
|
3590
|
+
},
|
|
3591
|
+
{
|
|
3592
|
+
"name": "children",
|
|
3593
|
+
"takes": "anything",
|
|
3594
|
+
"required": true,
|
|
3595
|
+
"note": "The `EditorContent`."
|
|
3596
|
+
},
|
|
3597
|
+
{
|
|
3598
|
+
"name": "className",
|
|
3599
|
+
"takes": "text",
|
|
3600
|
+
"required": false,
|
|
3601
|
+
"note": null
|
|
3602
|
+
}
|
|
3603
|
+
],
|
|
3604
|
+
"variants": [],
|
|
3605
|
+
"ownsBehaviours": [],
|
|
3606
|
+
"status": "stable",
|
|
3013
3607
|
"migrationStage": null,
|
|
3014
3608
|
"docsId": "writing-editorblockhandle--docs",
|
|
3015
3609
|
"storyId": "writing-editorblockhandle--default",
|
|
@@ -3677,7 +4271,8 @@
|
|
|
3677
4271
|
"docPage": "src/IconButton.mdx",
|
|
3678
4272
|
"app": null,
|
|
3679
4273
|
"looks": [
|
|
3680
|
-
"border border-border-default hover:bg-bg-hover text-text-secondary"
|
|
4274
|
+
"border border-border-default hover:bg-bg-hover text-text-secondary",
|
|
4275
|
+
"bg-bg-disabled text-text-disabled leaf:bg-transparent leaf:text-text-muted"
|
|
3681
4276
|
]
|
|
3682
4277
|
},
|
|
3683
4278
|
{
|
|
@@ -4835,6 +5430,12 @@
|
|
|
4835
5430
|
"takes": "true/false",
|
|
4836
5431
|
"required": false,
|
|
4837
5432
|
"note": "Draws the values as words even where they could be changed: the hover preview."
|
|
5433
|
+
},
|
|
5434
|
+
{
|
|
5435
|
+
"name": "disabledReason",
|
|
5436
|
+
"takes": "text",
|
|
5437
|
+
"required": false,
|
|
5438
|
+
"note": "Why they cannot be changed right now (an archived file): the pickers stay, shut, saying it on hover."
|
|
4838
5439
|
}
|
|
4839
5440
|
],
|
|
4840
5441
|
"variants": [],
|
|
@@ -5818,6 +6419,65 @@
|
|
|
5818
6419
|
"app": null,
|
|
5819
6420
|
"looks": []
|
|
5820
6421
|
},
|
|
6422
|
+
{
|
|
6423
|
+
"name": "MetaText",
|
|
6424
|
+
"repo": "estiva-ui",
|
|
6425
|
+
"kind": "component",
|
|
6426
|
+
"importPath": "@estiva-app/ui",
|
|
6427
|
+
"sourceFile": "src/MetaText.tsx",
|
|
6428
|
+
"purpose": "The small figure beside a name: a time, a resolve line's time, a count.",
|
|
6429
|
+
"purposeFrom": "page",
|
|
6430
|
+
"props": [
|
|
6431
|
+
{
|
|
6432
|
+
"name": "children",
|
|
6433
|
+
"takes": "anything",
|
|
6434
|
+
"required": true,
|
|
6435
|
+
"note": null
|
|
6436
|
+
},
|
|
6437
|
+
{
|
|
6438
|
+
"name": "tone",
|
|
6439
|
+
"takes": "keyof typeof TONE_CLASSES",
|
|
6440
|
+
"required": false,
|
|
6441
|
+
"note": "`muted` for a time; `secondary` and `success` for counts of open and resolved."
|
|
6442
|
+
},
|
|
6443
|
+
{
|
|
6444
|
+
"name": "size",
|
|
6445
|
+
"takes": "caption | chip",
|
|
6446
|
+
"required": false,
|
|
6447
|
+
"note": "`chip` beside a small name, as in a thread's resolve line."
|
|
6448
|
+
},
|
|
6449
|
+
{
|
|
6450
|
+
"name": "className",
|
|
6451
|
+
"takes": "text",
|
|
6452
|
+
"required": false,
|
|
6453
|
+
"note": "Placement only: `shrink-0`, `contents`."
|
|
6454
|
+
}
|
|
6455
|
+
],
|
|
6456
|
+
"variants": [
|
|
6457
|
+
{
|
|
6458
|
+
"prop": "size",
|
|
6459
|
+
"values": [
|
|
6460
|
+
"caption",
|
|
6461
|
+
"chip"
|
|
6462
|
+
]
|
|
6463
|
+
}
|
|
6464
|
+
],
|
|
6465
|
+
"ownsBehaviours": [],
|
|
6466
|
+
"status": "stable",
|
|
6467
|
+
"migrationStage": null,
|
|
6468
|
+
"docsId": "conversation-metatext--docs",
|
|
6469
|
+
"storyId": "conversation-metatext--time",
|
|
6470
|
+
"docPage": "src/MetaText.mdx",
|
|
6471
|
+
"app": null,
|
|
6472
|
+
"looks": [
|
|
6473
|
+
"text-chip font-normal text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6474
|
+
"text-chip font-normal text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6475
|
+
"text-chip font-normal text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6476
|
+
"text-caption text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6477
|
+
"text-caption text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
6478
|
+
"text-caption text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums"
|
|
6479
|
+
]
|
|
6480
|
+
},
|
|
5821
6481
|
{
|
|
5822
6482
|
"name": "moveBlock",
|
|
5823
6483
|
"repo": "estiva-ui",
|
|
@@ -6192,6 +6852,82 @@
|
|
|
6192
6852
|
"app": null,
|
|
6193
6853
|
"looks": []
|
|
6194
6854
|
},
|
|
6855
|
+
{
|
|
6856
|
+
"name": "PageHeader",
|
|
6857
|
+
"repo": "estiva-ui",
|
|
6858
|
+
"kind": "component",
|
|
6859
|
+
"importPath": "@estiva-app/ui",
|
|
6860
|
+
"sourceFile": "src/PageHeader.tsx",
|
|
6861
|
+
"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.",
|
|
6862
|
+
"purposeFrom": "page",
|
|
6863
|
+
"props": [
|
|
6864
|
+
{
|
|
6865
|
+
"name": "title",
|
|
6866
|
+
"takes": "anything",
|
|
6867
|
+
"required": true,
|
|
6868
|
+
"note": "The page's name. A string is one line in `body-2-strong`, cut short with an ellipsis when there is no room."
|
|
6869
|
+
},
|
|
6870
|
+
{
|
|
6871
|
+
"name": "leading",
|
|
6872
|
+
"takes": "anything",
|
|
6873
|
+
"required": false,
|
|
6874
|
+
"note": "Before the title, 16px: an icon at stroke 1.5, or a face (`Avatar size={16}`)."
|
|
6875
|
+
},
|
|
6876
|
+
{
|
|
6877
|
+
"name": "private",
|
|
6878
|
+
"takes": "true/false",
|
|
6879
|
+
"required": false,
|
|
6880
|
+
"note": "A lock before the title: only its members can open this page."
|
|
6881
|
+
},
|
|
6882
|
+
{
|
|
6883
|
+
"name": "after",
|
|
6884
|
+
"takes": "anything",
|
|
6885
|
+
"required": false,
|
|
6886
|
+
"note": "Right after the title, 8px from it, and never cut short: a small `Button`, a `Chip`."
|
|
6887
|
+
},
|
|
6888
|
+
{
|
|
6889
|
+
"name": "meta",
|
|
6890
|
+
"takes": "(string | PageHeaderMeta)[]",
|
|
6891
|
+
"required": false,
|
|
6892
|
+
"note": "Quiet words at the right, before the members: counts."
|
|
6893
|
+
},
|
|
6894
|
+
{
|
|
6895
|
+
"name": "time",
|
|
6896
|
+
"takes": "{ label: string; exact: string }",
|
|
6897
|
+
"required": false,
|
|
6898
|
+
"note": "When it last changed, in words — \"Edited 2 minutes ago\" — 12px italic, with the exact time in a tooltip."
|
|
6899
|
+
},
|
|
6900
|
+
{
|
|
6901
|
+
"name": "members",
|
|
6902
|
+
"takes": "anything",
|
|
6903
|
+
"required": false,
|
|
6904
|
+
"note": "Who is in it: a `MembersPill`."
|
|
6905
|
+
},
|
|
6906
|
+
{
|
|
6907
|
+
"name": "actions",
|
|
6908
|
+
"takes": "anything",
|
|
6909
|
+
"required": false,
|
|
6910
|
+
"note": "The page's own buttons, at the right edge: a `Toolbar` with `surface={false}` of `ToolbarButton`s, or one `IconButton`."
|
|
6911
|
+
},
|
|
6912
|
+
{
|
|
6913
|
+
"name": "className",
|
|
6914
|
+
"takes": "text",
|
|
6915
|
+
"required": false,
|
|
6916
|
+
"note": "Placement only."
|
|
6917
|
+
}
|
|
6918
|
+
],
|
|
6919
|
+
"variants": [],
|
|
6920
|
+
"ownsBehaviours": [],
|
|
6921
|
+
"status": "stable",
|
|
6922
|
+
"migrationStage": null,
|
|
6923
|
+
"docsId": "page-structure-pageheader--docs",
|
|
6924
|
+
"storyId": "page-structure-pageheader--title",
|
|
6925
|
+
"docPage": "src/PageHeader.mdx",
|
|
6926
|
+
"app": null,
|
|
6927
|
+
"looks": [
|
|
6928
|
+
"whitespace-nowrap text-caption italic text-text-muted"
|
|
6929
|
+
]
|
|
6930
|
+
},
|
|
6195
6931
|
{
|
|
6196
6932
|
"name": "Panel",
|
|
6197
6933
|
"repo": "estiva-ui",
|
|
@@ -6219,6 +6955,12 @@
|
|
|
6219
6955
|
"required": false,
|
|
6220
6956
|
"note": "The panel's own actions, at the header's right — a `Toolbar` of `ToolbarButton`s, or one `IconButton`."
|
|
6221
6957
|
},
|
|
6958
|
+
{
|
|
6959
|
+
"name": "header",
|
|
6960
|
+
"takes": "anything",
|
|
6961
|
+
"required": false,
|
|
6962
|
+
"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."
|
|
6963
|
+
},
|
|
6222
6964
|
{
|
|
6223
6965
|
"name": "children",
|
|
6224
6966
|
"takes": "anything",
|
|
@@ -6588,24 +7330,68 @@
|
|
|
6588
7330
|
"behaviour": "Is built on Base UI"
|
|
6589
7331
|
},
|
|
6590
7332
|
{
|
|
6591
|
-
"id": "role",
|
|
6592
|
-
"behaviour": "Says what it is to assistive technology"
|
|
7333
|
+
"id": "role",
|
|
7334
|
+
"behaviour": "Says what it is to assistive technology"
|
|
7335
|
+
},
|
|
7336
|
+
{
|
|
7337
|
+
"id": "tab-stop",
|
|
7338
|
+
"behaviour": "Is reachable with Tab"
|
|
7339
|
+
}
|
|
7340
|
+
],
|
|
7341
|
+
"status": "stable",
|
|
7342
|
+
"migrationStage": null,
|
|
7343
|
+
"docsId": "people-persontrigger--docs",
|
|
7344
|
+
"storyId": "people-persontrigger--row",
|
|
7345
|
+
"docPage": "src/PersonTrigger.mdx",
|
|
7346
|
+
"app": null,
|
|
7347
|
+
"looks": [
|
|
7348
|
+
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover",
|
|
7349
|
+
"text-body-2 text-text-primary cursor-pointer rounded-md transition-colors hover:bg-bg-hover bg-bg-hover"
|
|
7350
|
+
]
|
|
7351
|
+
},
|
|
7352
|
+
{
|
|
7353
|
+
"name": "PinnedComment",
|
|
7354
|
+
"repo": "estiva-ui",
|
|
7355
|
+
"kind": "component",
|
|
7356
|
+
"importPath": "@estiva-app/ui",
|
|
7357
|
+
"sourceFile": "src/PinnedComment.tsx",
|
|
7358
|
+
"purpose": "The comment a thread answers, pinned at the top of the replies column: who, when, and its first line.",
|
|
7359
|
+
"purposeFrom": "page",
|
|
7360
|
+
"props": [
|
|
7361
|
+
{
|
|
7362
|
+
"name": "author",
|
|
7363
|
+
"takes": "ConversationPerson",
|
|
7364
|
+
"required": true,
|
|
7365
|
+
"note": null
|
|
7366
|
+
},
|
|
7367
|
+
{
|
|
7368
|
+
"name": "time",
|
|
7369
|
+
"takes": "anything",
|
|
7370
|
+
"required": true,
|
|
7371
|
+
"note": "When it was written, in the app's words, with its day: no day line stands above it here."
|
|
7372
|
+
},
|
|
7373
|
+
{
|
|
7374
|
+
"name": "words",
|
|
7375
|
+
"takes": "anything",
|
|
7376
|
+
"required": true,
|
|
7377
|
+
"note": "Its words, cut to one line: plain words read best."
|
|
6593
7378
|
},
|
|
6594
7379
|
{
|
|
6595
|
-
"
|
|
6596
|
-
"
|
|
7380
|
+
"name": "deleted",
|
|
7381
|
+
"takes": "true/false",
|
|
7382
|
+
"required": false,
|
|
7383
|
+
"note": "It was deleted; its replies stay."
|
|
6597
7384
|
}
|
|
6598
7385
|
],
|
|
7386
|
+
"variants": [],
|
|
7387
|
+
"ownsBehaviours": [],
|
|
6599
7388
|
"status": "stable",
|
|
6600
7389
|
"migrationStage": null,
|
|
6601
|
-
"docsId": "
|
|
6602
|
-
"storyId": "
|
|
6603
|
-
"docPage": "src/
|
|
7390
|
+
"docsId": "conversation-pinnedcomment--docs",
|
|
7391
|
+
"storyId": "conversation-pinnedcomment--pinned",
|
|
7392
|
+
"docPage": "src/PinnedComment.mdx",
|
|
6604
7393
|
"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
|
-
]
|
|
7394
|
+
"looks": []
|
|
6609
7395
|
},
|
|
6610
7396
|
{
|
|
6611
7397
|
"name": "Popover",
|
|
@@ -7000,6 +7786,58 @@
|
|
|
7000
7786
|
"text-menu uppercase tracking-widest text-text-secondary"
|
|
7001
7787
|
]
|
|
7002
7788
|
},
|
|
7789
|
+
{
|
|
7790
|
+
"name": "QuotedLine",
|
|
7791
|
+
"repo": "estiva-ui",
|
|
7792
|
+
"kind": "component",
|
|
7793
|
+
"importPath": "@estiva-app/ui",
|
|
7794
|
+
"sourceFile": "src/QuotedLine.tsx",
|
|
7795
|
+
"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.",
|
|
7796
|
+
"purposeFrom": "page",
|
|
7797
|
+
"props": [
|
|
7798
|
+
{
|
|
7799
|
+
"name": "words",
|
|
7800
|
+
"takes": "text",
|
|
7801
|
+
"required": false,
|
|
7802
|
+
"note": "The words the comment is on, as they were quoted."
|
|
7803
|
+
},
|
|
7804
|
+
{
|
|
7805
|
+
"name": "state",
|
|
7806
|
+
"takes": "here | reworded | gone",
|
|
7807
|
+
"required": false,
|
|
7808
|
+
"note": "`here`: still in the text. `reworded`: changed since."
|
|
7809
|
+
},
|
|
7810
|
+
{
|
|
7811
|
+
"name": "label",
|
|
7812
|
+
"takes": "text",
|
|
7813
|
+
"required": false,
|
|
7814
|
+
"note": "A part with no words, a picture or a whole block: what it is, in the app's words (\"Picture: plan.png\")."
|
|
7815
|
+
}
|
|
7816
|
+
],
|
|
7817
|
+
"variants": [
|
|
7818
|
+
{
|
|
7819
|
+
"prop": "state",
|
|
7820
|
+
"values": [
|
|
7821
|
+
"here",
|
|
7822
|
+
"reworded",
|
|
7823
|
+
"gone"
|
|
7824
|
+
]
|
|
7825
|
+
}
|
|
7826
|
+
],
|
|
7827
|
+
"ownsBehaviours": [],
|
|
7828
|
+
"status": "stable",
|
|
7829
|
+
"migrationStage": null,
|
|
7830
|
+
"docsId": "conversation-quotedline--docs",
|
|
7831
|
+
"storyId": "conversation-quotedline--words",
|
|
7832
|
+
"docPage": "src/QuotedLine.mdx",
|
|
7833
|
+
"app": null,
|
|
7834
|
+
"looks": [
|
|
7835
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-warning-muted",
|
|
7836
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-warning-muted line-through",
|
|
7837
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-bg-inset text-text-secondary",
|
|
7838
|
+
"rounded-sm text-text-primary [box-decoration-break:clone] bg-bg-inset text-text-secondary line-through"
|
|
7839
|
+
]
|
|
7840
|
+
},
|
|
7003
7841
|
{
|
|
7004
7842
|
"name": "quoteText",
|
|
7005
7843
|
"repo": "estiva-ui",
|
|
@@ -7191,6 +8029,44 @@
|
|
|
7191
8029
|
"text-chip signal:font-mono signal:text-small signal:font-semibold signal:tabular-nums"
|
|
7192
8030
|
]
|
|
7193
8031
|
},
|
|
8032
|
+
{
|
|
8033
|
+
"name": "ReactionHorizon",
|
|
8034
|
+
"repo": "estiva-ui",
|
|
8035
|
+
"kind": "component",
|
|
8036
|
+
"importPath": "@estiva-app/ui",
|
|
8037
|
+
"sourceFile": "src/ReactionHorizon.tsx",
|
|
8038
|
+
"purpose": "The line that says reactions are read only so far back, and how many older comments were not checked.",
|
|
8039
|
+
"purposeFrom": "page",
|
|
8040
|
+
"props": [
|
|
8041
|
+
{
|
|
8042
|
+
"name": "limit",
|
|
8043
|
+
"takes": "number",
|
|
8044
|
+
"required": true,
|
|
8045
|
+
"note": "How many comments and replies back reactions are read for."
|
|
8046
|
+
},
|
|
8047
|
+
{
|
|
8048
|
+
"name": "omitted",
|
|
8049
|
+
"takes": "number",
|
|
8050
|
+
"required": true,
|
|
8051
|
+
"note": "How many older ones were not checked."
|
|
8052
|
+
},
|
|
8053
|
+
{
|
|
8054
|
+
"name": "cut",
|
|
8055
|
+
"takes": "true/false",
|
|
8056
|
+
"required": false,
|
|
8057
|
+
"note": "Some reactions may be missing: the read was cut short."
|
|
8058
|
+
}
|
|
8059
|
+
],
|
|
8060
|
+
"variants": [],
|
|
8061
|
+
"ownsBehaviours": [],
|
|
8062
|
+
"status": "stable",
|
|
8063
|
+
"migrationStage": null,
|
|
8064
|
+
"docsId": "conversation-reactionhorizon--docs",
|
|
8065
|
+
"storyId": "conversation-reactionhorizon--older",
|
|
8066
|
+
"docPage": "src/ReactionHorizon.mdx",
|
|
8067
|
+
"app": null,
|
|
8068
|
+
"looks": []
|
|
8069
|
+
},
|
|
7194
8070
|
{
|
|
7195
8071
|
"name": "ReactionPicker",
|
|
7196
8072
|
"repo": "estiva-ui",
|
|
@@ -7256,186 +8132,530 @@
|
|
|
7256
8132
|
"purposeFrom": "page",
|
|
7257
8133
|
"props": [
|
|
7258
8134
|
{
|
|
7259
|
-
"name": "reactions",
|
|
7260
|
-
"takes": "readonly ReactionCount[]",
|
|
8135
|
+
"name": "reactions",
|
|
8136
|
+
"takes": "readonly ReactionCount[]",
|
|
8137
|
+
"required": true,
|
|
8138
|
+
"note": "Each emoji and who chose it, in the order first chosen."
|
|
8139
|
+
},
|
|
8140
|
+
{
|
|
8141
|
+
"name": "options",
|
|
8142
|
+
"takes": "readonly ReactionOption[]",
|
|
8143
|
+
"required": true,
|
|
8144
|
+
"note": "The emoji offered, each named; also what a pill's name is read from."
|
|
8145
|
+
},
|
|
8146
|
+
{
|
|
8147
|
+
"name": "nameOf",
|
|
8148
|
+
"takes": "a handler",
|
|
8149
|
+
"required": true,
|
|
8150
|
+
"note": "A reactor's name, as \"who reacted\" says it."
|
|
8151
|
+
},
|
|
8152
|
+
{
|
|
8153
|
+
"name": "viewer",
|
|
8154
|
+
"takes": "text",
|
|
8155
|
+
"required": false,
|
|
8156
|
+
"note": "Who is looking: their pills are lit, and \"who reacted\" says \"you\"."
|
|
8157
|
+
},
|
|
8158
|
+
{
|
|
8159
|
+
"name": "onToggle",
|
|
8160
|
+
"takes": "a handler",
|
|
8161
|
+
"required": false,
|
|
8162
|
+
"note": "Your reaction on or off. Absent, the row only shows (read-only, signed out)."
|
|
8163
|
+
},
|
|
8164
|
+
{
|
|
8165
|
+
"name": "className",
|
|
8166
|
+
"takes": "text",
|
|
8167
|
+
"required": false,
|
|
8168
|
+
"note": null
|
|
8169
|
+
}
|
|
8170
|
+
],
|
|
8171
|
+
"variants": [],
|
|
8172
|
+
"ownsBehaviours": [],
|
|
8173
|
+
"status": "stable",
|
|
8174
|
+
"migrationStage": null,
|
|
8175
|
+
"docsId": "conversation-reactionrow--docs",
|
|
8176
|
+
"storyId": "conversation-reactionrow--default",
|
|
8177
|
+
"docPage": "src/ReactionRow.mdx",
|
|
8178
|
+
"app": null,
|
|
8179
|
+
"looks": []
|
|
8180
|
+
},
|
|
8181
|
+
{
|
|
8182
|
+
"name": "referenceAtSelection",
|
|
8183
|
+
"repo": "estiva-ui",
|
|
8184
|
+
"kind": "helper",
|
|
8185
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8186
|
+
"sourceFile": "src/ReferenceCards.ts",
|
|
8187
|
+
"purpose": "The chip the person has selected, with what it names and its card — or null.",
|
|
8188
|
+
"purposeFrom": "comment",
|
|
8189
|
+
"props": [],
|
|
8190
|
+
"variants": [],
|
|
8191
|
+
"ownsBehaviours": [],
|
|
8192
|
+
"status": "stable",
|
|
8193
|
+
"migrationStage": null,
|
|
8194
|
+
"docsId": null,
|
|
8195
|
+
"storyId": null,
|
|
8196
|
+
"docPage": null,
|
|
8197
|
+
"app": null,
|
|
8198
|
+
"looks": []
|
|
8199
|
+
},
|
|
8200
|
+
{
|
|
8201
|
+
"name": "referenceCardPlacements",
|
|
8202
|
+
"repo": "estiva-ui",
|
|
8203
|
+
"kind": "helper",
|
|
8204
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8205
|
+
"sourceFile": "src/ReferenceCards.ts",
|
|
8206
|
+
"purpose": "Every line that asks for a card, in document order.",
|
|
8207
|
+
"purposeFrom": "comment",
|
|
8208
|
+
"props": [],
|
|
8209
|
+
"variants": [],
|
|
8210
|
+
"ownsBehaviours": [],
|
|
8211
|
+
"status": "stable",
|
|
8212
|
+
"migrationStage": null,
|
|
8213
|
+
"docsId": null,
|
|
8214
|
+
"storyId": null,
|
|
8215
|
+
"docPage": null,
|
|
8216
|
+
"app": null,
|
|
8217
|
+
"looks": []
|
|
8218
|
+
},
|
|
8219
|
+
{
|
|
8220
|
+
"name": "referenceMenu",
|
|
8221
|
+
"repo": "estiva-ui",
|
|
8222
|
+
"kind": "helper",
|
|
8223
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8224
|
+
"sourceFile": "src/ComposerTriggers.tsx",
|
|
8225
|
+
"purpose": "The list `[` opens: `label: snippet` rows, the same box as the people list.",
|
|
8226
|
+
"purposeFrom": "comment",
|
|
8227
|
+
"props": [
|
|
8228
|
+
{
|
|
8229
|
+
"name": "ariaLabel",
|
|
8230
|
+
"takes": "text",
|
|
8231
|
+
"required": true,
|
|
8232
|
+
"note": "Names the list, e.g. what can be referenced."
|
|
8233
|
+
},
|
|
8234
|
+
{
|
|
8235
|
+
"name": "sectionLabel",
|
|
8236
|
+
"takes": "text",
|
|
8237
|
+
"required": true,
|
|
8238
|
+
"note": "The section's heading."
|
|
8239
|
+
},
|
|
8240
|
+
{
|
|
8241
|
+
"name": "icon",
|
|
8242
|
+
"takes": "anything",
|
|
8243
|
+
"required": true,
|
|
8244
|
+
"note": "At each row's start: a 16px icon — unless the row brings its own (`CaptionedItem.icon`), or `iconFor` answers."
|
|
8245
|
+
},
|
|
8246
|
+
{
|
|
8247
|
+
"name": "iconFor",
|
|
8248
|
+
"takes": "a handler",
|
|
8249
|
+
"required": false,
|
|
8250
|
+
"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`."
|
|
8251
|
+
}
|
|
8252
|
+
],
|
|
8253
|
+
"variants": [],
|
|
8254
|
+
"ownsBehaviours": [],
|
|
8255
|
+
"status": "stable",
|
|
8256
|
+
"migrationStage": null,
|
|
8257
|
+
"docsId": "writing-composertriggers--docs",
|
|
8258
|
+
"storyId": "writing-composertriggers--default",
|
|
8259
|
+
"docPage": null,
|
|
8260
|
+
"app": null,
|
|
8261
|
+
"looks": []
|
|
8262
|
+
},
|
|
8263
|
+
{
|
|
8264
|
+
"name": "ReferenceMenu",
|
|
8265
|
+
"repo": "estiva-ui",
|
|
8266
|
+
"kind": "component",
|
|
8267
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8268
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8269
|
+
"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.",
|
|
8270
|
+
"purposeFrom": "page",
|
|
8271
|
+
"props": [],
|
|
8272
|
+
"variants": [],
|
|
8273
|
+
"ownsBehaviours": [],
|
|
8274
|
+
"status": "stable",
|
|
8275
|
+
"migrationStage": null,
|
|
8276
|
+
"docsId": "writing-referencemenu--docs",
|
|
8277
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8278
|
+
"docPage": "src/ReferenceMenu.mdx",
|
|
8279
|
+
"app": null,
|
|
8280
|
+
"looks": []
|
|
8281
|
+
},
|
|
8282
|
+
{
|
|
8283
|
+
"name": "referenceMenuClick",
|
|
8284
|
+
"repo": "estiva-ui",
|
|
8285
|
+
"kind": "helper",
|
|
8286
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8287
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8288
|
+
"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.",
|
|
8289
|
+
"purposeFrom": "comment",
|
|
8290
|
+
"props": [],
|
|
8291
|
+
"variants": [],
|
|
8292
|
+
"ownsBehaviours": [],
|
|
8293
|
+
"status": "stable",
|
|
8294
|
+
"migrationStage": null,
|
|
8295
|
+
"docsId": "writing-referencemenu--docs",
|
|
8296
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8297
|
+
"docPage": null,
|
|
8298
|
+
"app": null,
|
|
8299
|
+
"looks": []
|
|
8300
|
+
},
|
|
8301
|
+
{
|
|
8302
|
+
"name": "ReferenceMenuView",
|
|
8303
|
+
"repo": "estiva-ui",
|
|
8304
|
+
"kind": "component",
|
|
8305
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8306
|
+
"sourceFile": "src/ReferenceMenu.tsx",
|
|
8307
|
+
"purpose": "The menu `ReferenceMenu` holds, hung under its chip.",
|
|
8308
|
+
"purposeFrom": "comment",
|
|
8309
|
+
"props": [
|
|
8310
|
+
{
|
|
8311
|
+
"name": "editor",
|
|
8312
|
+
"takes": "Editor | null",
|
|
7261
8313
|
"required": true,
|
|
7262
|
-
"note":
|
|
7263
|
-
}
|
|
8314
|
+
"note": null
|
|
8315
|
+
}
|
|
8316
|
+
],
|
|
8317
|
+
"variants": [],
|
|
8318
|
+
"ownsBehaviours": [
|
|
7264
8319
|
{
|
|
7265
|
-
"
|
|
7266
|
-
"
|
|
7267
|
-
"required": true,
|
|
7268
|
-
"note": "The emoji offered, each named; also what a pill's name is read from."
|
|
8320
|
+
"id": "portal",
|
|
8321
|
+
"behaviour": "Floats on top of the page"
|
|
7269
8322
|
},
|
|
7270
8323
|
{
|
|
7271
|
-
"
|
|
7272
|
-
"
|
|
7273
|
-
"required": true,
|
|
7274
|
-
"note": "A reactor's name, as \"who reacted\" says it."
|
|
8324
|
+
"id": "press-outside",
|
|
8325
|
+
"behaviour": "Closes on a press outside"
|
|
7275
8326
|
},
|
|
7276
8327
|
{
|
|
7277
|
-
"
|
|
7278
|
-
"
|
|
7279
|
-
"required": false,
|
|
7280
|
-
"note": "Who is looking: their pills are lit, and \"who reacted\" says \"you\"."
|
|
8328
|
+
"id": "page-keys",
|
|
8329
|
+
"behaviour": "Takes its keys by itself"
|
|
7281
8330
|
},
|
|
7282
8331
|
{
|
|
7283
|
-
"
|
|
7284
|
-
"
|
|
7285
|
-
"required": false,
|
|
7286
|
-
"note": "Your reaction on or off. Absent, the row only shows (read-only, signed out)."
|
|
8332
|
+
"id": "focus",
|
|
8333
|
+
"behaviour": "Holds focus inside while open, and gives it back"
|
|
7287
8334
|
},
|
|
7288
8335
|
{
|
|
7289
|
-
"
|
|
7290
|
-
"
|
|
7291
|
-
"required": false,
|
|
7292
|
-
"note": null
|
|
8336
|
+
"id": "follow",
|
|
8337
|
+
"behaviour": "Stays attached to its anchor on scroll and resize"
|
|
7293
8338
|
}
|
|
7294
8339
|
],
|
|
8340
|
+
"status": "stable",
|
|
8341
|
+
"migrationStage": null,
|
|
8342
|
+
"docsId": "writing-referencemenu--docs",
|
|
8343
|
+
"storyId": "writing-referencemenu--in-an-editor",
|
|
8344
|
+
"docPage": null,
|
|
8345
|
+
"app": null,
|
|
8346
|
+
"looks": []
|
|
8347
|
+
},
|
|
8348
|
+
{
|
|
8349
|
+
"name": "ReferenceNode",
|
|
8350
|
+
"repo": "estiva-ui",
|
|
8351
|
+
"kind": "component",
|
|
8352
|
+
"importPath": "@estiva-app/ui/editor",
|
|
8353
|
+
"sourceFile": "src/BlockNodes.tsx",
|
|
8354
|
+
"purpose": "A `nostr:` reference, drawn as the thing it points at — SPEC §13.1.",
|
|
8355
|
+
"purposeFrom": "comment",
|
|
8356
|
+
"props": [],
|
|
7295
8357
|
"variants": [],
|
|
7296
8358
|
"ownsBehaviours": [],
|
|
7297
8359
|
"status": "stable",
|
|
7298
8360
|
"migrationStage": null,
|
|
7299
|
-
"docsId": "
|
|
7300
|
-
"storyId": "
|
|
7301
|
-
"docPage":
|
|
8361
|
+
"docsId": "writing-blocknodes--docs",
|
|
8362
|
+
"storyId": "writing-blocknodes--default",
|
|
8363
|
+
"docPage": null,
|
|
7302
8364
|
"app": null,
|
|
7303
8365
|
"looks": []
|
|
7304
8366
|
},
|
|
7305
8367
|
{
|
|
7306
|
-
"name": "
|
|
8368
|
+
"name": "ReferenceTrigger",
|
|
7307
8369
|
"repo": "estiva-ui",
|
|
7308
|
-
"kind": "
|
|
8370
|
+
"kind": "component",
|
|
7309
8371
|
"importPath": "@estiva-app/ui/editor",
|
|
7310
|
-
"sourceFile": "src/
|
|
7311
|
-
"purpose": "
|
|
8372
|
+
"sourceFile": "src/ComposerTriggers.tsx",
|
|
8373
|
+
"purpose": "`[` — reference something, inserted as a {@link CaptionedReference} chip.",
|
|
7312
8374
|
"purposeFrom": "comment",
|
|
7313
8375
|
"props": [],
|
|
7314
8376
|
"variants": [],
|
|
7315
8377
|
"ownsBehaviours": [],
|
|
7316
8378
|
"status": "stable",
|
|
7317
8379
|
"migrationStage": null,
|
|
7318
|
-
"docsId":
|
|
7319
|
-
"storyId":
|
|
8380
|
+
"docsId": "writing-composertriggers--docs",
|
|
8381
|
+
"storyId": "writing-composertriggers--default",
|
|
7320
8382
|
"docPage": null,
|
|
7321
8383
|
"app": null,
|
|
7322
8384
|
"looks": []
|
|
7323
8385
|
},
|
|
7324
8386
|
{
|
|
7325
|
-
"name": "
|
|
8387
|
+
"name": "refreshLinkChips",
|
|
7326
8388
|
"repo": "estiva-ui",
|
|
7327
8389
|
"kind": "helper",
|
|
7328
8390
|
"importPath": "@estiva-app/ui/editor",
|
|
7329
|
-
"sourceFile": "src/
|
|
7330
|
-
"purpose": "
|
|
8391
|
+
"sourceFile": "src/LinkChips.ts",
|
|
8392
|
+
"purpose": "Look at the document again — after the app learned what more URLs name some other way.",
|
|
7331
8393
|
"purposeFrom": "comment",
|
|
7332
8394
|
"props": [],
|
|
7333
8395
|
"variants": [],
|
|
7334
8396
|
"ownsBehaviours": [],
|
|
7335
8397
|
"status": "stable",
|
|
7336
8398
|
"migrationStage": null,
|
|
7337
|
-
"docsId":
|
|
7338
|
-
"storyId":
|
|
8399
|
+
"docsId": "writing-linkchips--docs",
|
|
8400
|
+
"storyId": "writing-linkchips--in-an-editor",
|
|
7339
8401
|
"docPage": null,
|
|
7340
8402
|
"app": null,
|
|
7341
8403
|
"looks": []
|
|
7342
8404
|
},
|
|
7343
8405
|
{
|
|
7344
|
-
"name": "
|
|
8406
|
+
"name": "releaseSelection",
|
|
7345
8407
|
"repo": "estiva-ui",
|
|
7346
8408
|
"kind": "helper",
|
|
7347
8409
|
"importPath": "@estiva-app/ui/editor",
|
|
7348
|
-
"sourceFile": "src/
|
|
7349
|
-
"purpose": "
|
|
8410
|
+
"sourceFile": "src/SelectionToolbar.tsx",
|
|
8411
|
+
"purpose": "Stop drawing it. Nothing kept, nothing dispatched.",
|
|
7350
8412
|
"purposeFrom": "comment",
|
|
8413
|
+
"props": [],
|
|
8414
|
+
"variants": [],
|
|
8415
|
+
"ownsBehaviours": [],
|
|
8416
|
+
"status": "stable",
|
|
8417
|
+
"migrationStage": null,
|
|
8418
|
+
"docsId": "writing-selectiontoolbar--docs",
|
|
8419
|
+
"storyId": "writing-selectiontoolbar--default",
|
|
8420
|
+
"docPage": null,
|
|
8421
|
+
"app": null,
|
|
8422
|
+
"looks": []
|
|
8423
|
+
},
|
|
8424
|
+
{
|
|
8425
|
+
"name": "RepliesRow",
|
|
8426
|
+
"repo": "estiva-ui",
|
|
8427
|
+
"kind": "component",
|
|
8428
|
+
"importPath": "@estiva-app/ui",
|
|
8429
|
+
"sourceFile": "src/RepliesRow.tsx",
|
|
8430
|
+
"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.",
|
|
8431
|
+
"purposeFrom": "page",
|
|
7351
8432
|
"props": [
|
|
7352
8433
|
{
|
|
7353
|
-
"name": "
|
|
7354
|
-
"takes": "
|
|
8434
|
+
"name": "count",
|
|
8435
|
+
"takes": "number",
|
|
7355
8436
|
"required": true,
|
|
7356
|
-
"note": "
|
|
8437
|
+
"note": "How many replies."
|
|
7357
8438
|
},
|
|
7358
8439
|
{
|
|
7359
|
-
"name": "
|
|
8440
|
+
"name": "faces",
|
|
8441
|
+
"takes": "readonly { name: string; picture?: string }[]",
|
|
8442
|
+
"required": false,
|
|
8443
|
+
"note": "Who replied: their faces."
|
|
8444
|
+
},
|
|
8445
|
+
{
|
|
8446
|
+
"name": "last",
|
|
7360
8447
|
"takes": "text",
|
|
7361
|
-
"required":
|
|
7362
|
-
"note": "The
|
|
8448
|
+
"required": false,
|
|
8449
|
+
"note": "The last reply's time, in the app's words."
|
|
7363
8450
|
},
|
|
7364
8451
|
{
|
|
7365
|
-
"name": "
|
|
7366
|
-
"takes": "
|
|
7367
|
-
"required":
|
|
7368
|
-
"note": "
|
|
8452
|
+
"name": "isNew",
|
|
8453
|
+
"takes": "true/false",
|
|
8454
|
+
"required": false,
|
|
8455
|
+
"note": "\"1 new\": a reply you have not read."
|
|
7369
8456
|
},
|
|
7370
8457
|
{
|
|
7371
|
-
"name": "
|
|
8458
|
+
"name": "urgent",
|
|
8459
|
+
"takes": "true/false",
|
|
8460
|
+
"required": false,
|
|
8461
|
+
"note": "The \"1 new\" chip in the warning colour, for an urgent thread."
|
|
8462
|
+
},
|
|
8463
|
+
{
|
|
8464
|
+
"name": "onOpen",
|
|
7372
8465
|
"takes": "a handler",
|
|
7373
8466
|
"required": false,
|
|
7374
|
-
"note": "
|
|
8467
|
+
"note": "Opens the thread. Absent, the row only says how many (the card around it opens the thread)."
|
|
8468
|
+
},
|
|
8469
|
+
{
|
|
8470
|
+
"name": "open",
|
|
8471
|
+
"takes": "true/false",
|
|
8472
|
+
"required": false,
|
|
8473
|
+
"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
8474
|
}
|
|
7376
8475
|
],
|
|
7377
8476
|
"variants": [],
|
|
7378
8477
|
"ownsBehaviours": [],
|
|
7379
8478
|
"status": "stable",
|
|
7380
8479
|
"migrationStage": null,
|
|
7381
|
-
"docsId": "
|
|
7382
|
-
"storyId": "
|
|
7383
|
-
"docPage":
|
|
8480
|
+
"docsId": "conversation-repliesrow--docs",
|
|
8481
|
+
"storyId": "conversation-repliesrow--several",
|
|
8482
|
+
"docPage": "src/RepliesRow.mdx",
|
|
7384
8483
|
"app": null,
|
|
7385
|
-
"looks": [
|
|
8484
|
+
"looks": [
|
|
8485
|
+
"rounded-lg border border-transparent transition-colors hover:border-accent-outline hover:bg-accent-wash",
|
|
8486
|
+
"text-chip font-medium text-text-interactive transition-colors",
|
|
8487
|
+
"text-small leading-3 text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
|
|
8488
|
+
"rounded-lg border border-transparent transition-colors hover:border-accent-outline hover:bg-accent-wash border-accent-outline bg-accent-wash"
|
|
8489
|
+
]
|
|
7386
8490
|
},
|
|
7387
8491
|
{
|
|
7388
|
-
"name": "
|
|
8492
|
+
"name": "ReplyCard",
|
|
7389
8493
|
"repo": "estiva-ui",
|
|
7390
8494
|
"kind": "component",
|
|
7391
|
-
"importPath": "@estiva-app/ui
|
|
7392
|
-
"sourceFile": "src/
|
|
7393
|
-
"purpose": "
|
|
8495
|
+
"importPath": "@estiva-app/ui",
|
|
8496
|
+
"sourceFile": "src/ConversationCard.tsx",
|
|
8497
|
+
"purpose": "One reply in a thread: the same pieces as a comment, without replies of its own or Resolve.",
|
|
7394
8498
|
"purposeFrom": "page",
|
|
7395
|
-
"props": [
|
|
7396
|
-
|
|
7397
|
-
|
|
7398
|
-
|
|
7399
|
-
|
|
7400
|
-
|
|
7401
|
-
|
|
7402
|
-
|
|
7403
|
-
|
|
7404
|
-
|
|
7405
|
-
|
|
7406
|
-
|
|
7407
|
-
|
|
7408
|
-
|
|
7409
|
-
|
|
7410
|
-
|
|
7411
|
-
|
|
7412
|
-
|
|
7413
|
-
|
|
7414
|
-
|
|
8499
|
+
"props": [
|
|
8500
|
+
{
|
|
8501
|
+
"name": "author",
|
|
8502
|
+
"takes": "ConversationPerson",
|
|
8503
|
+
"required": true,
|
|
8504
|
+
"note": null
|
|
8505
|
+
},
|
|
8506
|
+
{
|
|
8507
|
+
"name": "time",
|
|
8508
|
+
"takes": "anything",
|
|
8509
|
+
"required": true,
|
|
8510
|
+
"note": "When it was written, in the app's words (\"11:08 AM\")."
|
|
8511
|
+
},
|
|
8512
|
+
{
|
|
8513
|
+
"name": "timeHref",
|
|
8514
|
+
"takes": "text",
|
|
8515
|
+
"required": false,
|
|
8516
|
+
"note": "A link to it: the time is then the link, \"Link to this\", as a reply's is."
|
|
8517
|
+
},
|
|
8518
|
+
{
|
|
8519
|
+
"name": "edited",
|
|
8520
|
+
"takes": "text",
|
|
8521
|
+
"required": false,
|
|
8522
|
+
"note": "When it was last edited, in the app's words for the tooltip (\"Edited 11:20 AM\"): draws \"(edited)\"."
|
|
8523
|
+
},
|
|
8524
|
+
{
|
|
8525
|
+
"name": "children",
|
|
8526
|
+
"takes": "anything",
|
|
8527
|
+
"required": true,
|
|
8528
|
+
"note": "The words, as the app draws them: text, mentions, links, attached cards, quoted blocks."
|
|
8529
|
+
},
|
|
8530
|
+
{
|
|
8531
|
+
"name": "about",
|
|
8532
|
+
"takes": "anything",
|
|
8533
|
+
"required": false,
|
|
8534
|
+
"note": "What it is about, a `QuotedLine` for a comment on a part of the page: under the name, above the words."
|
|
8535
|
+
},
|
|
8536
|
+
{
|
|
8537
|
+
"name": "files",
|
|
8538
|
+
"takes": "anything",
|
|
8539
|
+
"required": false,
|
|
8540
|
+
"note": "Pictures and files: `AttachmentCard`s, laid out under the words."
|
|
8541
|
+
},
|
|
8542
|
+
{
|
|
8543
|
+
"name": "reactions",
|
|
8544
|
+
"takes": "ReactionRowProps",
|
|
8545
|
+
"required": false,
|
|
8546
|
+
"note": "Its reactions: the kit's `ReactionRow`. With `onToggle`, the strip offers React too."
|
|
8547
|
+
},
|
|
8548
|
+
{
|
|
8549
|
+
"name": "reactionRefused",
|
|
8550
|
+
"takes": "text",
|
|
8551
|
+
"required": false,
|
|
8552
|
+
"note": "Why the last reaction was refused, in plain words: said under the reactions."
|
|
8553
|
+
},
|
|
8554
|
+
{
|
|
8555
|
+
"name": "isNew",
|
|
8556
|
+
"takes": "true/false",
|
|
8557
|
+
"required": false,
|
|
8558
|
+
"note": "Not read yet: the dot, or the urgent mark with `urgent`, and the card's edge in the theme's colour."
|
|
8559
|
+
},
|
|
8560
|
+
{
|
|
8561
|
+
"name": "urgent",
|
|
8562
|
+
"takes": "true/false",
|
|
8563
|
+
"required": false,
|
|
8564
|
+
"note": null
|
|
8565
|
+
},
|
|
8566
|
+
{
|
|
8567
|
+
"name": "own",
|
|
8568
|
+
"takes": "true/false",
|
|
8569
|
+
"required": false,
|
|
8570
|
+
"note": "It is yours: the menu offers Edit (with `editor`) and Delete (with `onDelete`)."
|
|
8571
|
+
},
|
|
8572
|
+
{
|
|
8573
|
+
"name": "readOnly",
|
|
8574
|
+
"takes": "true/false",
|
|
8575
|
+
"required": false,
|
|
8576
|
+
"note": "Nothing can be changed (an archived page): no strip, reactions only shown."
|
|
8577
|
+
},
|
|
8578
|
+
{
|
|
8579
|
+
"name": "editor",
|
|
8580
|
+
"takes": "a handler",
|
|
8581
|
+
"required": false,
|
|
8582
|
+
"note": "The box it is edited in, the app's `CommentBox` edit form; call `done` when it saves or cancels."
|
|
8583
|
+
},
|
|
8584
|
+
{
|
|
8585
|
+
"name": "editing",
|
|
8586
|
+
"takes": "true/false",
|
|
8587
|
+
"required": false,
|
|
8588
|
+
"note": "Being edited, when the app holds it (an edit that was refused opens again)."
|
|
8589
|
+
},
|
|
8590
|
+
{
|
|
8591
|
+
"name": "onEditingChange",
|
|
8592
|
+
"takes": "a handler",
|
|
8593
|
+
"required": false,
|
|
8594
|
+
"note": null
|
|
8595
|
+
},
|
|
8596
|
+
{
|
|
8597
|
+
"name": "onDelete",
|
|
8598
|
+
"takes": "a handler",
|
|
8599
|
+
"required": false,
|
|
8600
|
+
"note": "Delete, after the card has asked."
|
|
8601
|
+
},
|
|
8602
|
+
{
|
|
8603
|
+
"name": "deleteNote",
|
|
8604
|
+
"takes": "anything",
|
|
8605
|
+
"required": false,
|
|
8606
|
+
"note": "The app's sentence in the delete question, what deleting does there."
|
|
8607
|
+
},
|
|
8608
|
+
{
|
|
8609
|
+
"name": "menu",
|
|
8610
|
+
"takes": "anything",
|
|
8611
|
+
"required": false,
|
|
8612
|
+
"note": "The app's own rows in the ⋯ menu: `MenuItem`s."
|
|
8613
|
+
},
|
|
8614
|
+
{
|
|
8615
|
+
"name": "className",
|
|
8616
|
+
"takes": "text",
|
|
8617
|
+
"required": false,
|
|
8618
|
+
"note": "Placement only."
|
|
8619
|
+
}
|
|
8620
|
+
],
|
|
7415
8621
|
"variants": [],
|
|
7416
8622
|
"ownsBehaviours": [],
|
|
7417
8623
|
"status": "stable",
|
|
7418
8624
|
"migrationStage": null,
|
|
7419
|
-
"docsId": "
|
|
7420
|
-
"storyId": "
|
|
7421
|
-
"docPage":
|
|
8625
|
+
"docsId": "conversation-replycard--docs",
|
|
8626
|
+
"storyId": "conversation-replycard--reply",
|
|
8627
|
+
"docPage": "src/ReplyCard.mdx",
|
|
7422
8628
|
"app": null,
|
|
7423
|
-
"looks": [
|
|
8629
|
+
"looks": [
|
|
8630
|
+
"[&>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"
|
|
8631
|
+
]
|
|
7424
8632
|
},
|
|
7425
8633
|
{
|
|
7426
|
-
"name": "
|
|
8634
|
+
"name": "ResolveDialog",
|
|
7427
8635
|
"repo": "estiva-ui",
|
|
7428
8636
|
"kind": "component",
|
|
7429
|
-
"importPath": "@estiva-app/ui
|
|
7430
|
-
"sourceFile": "src/
|
|
7431
|
-
"purpose": "
|
|
7432
|
-
"purposeFrom": "
|
|
8637
|
+
"importPath": "@estiva-app/ui",
|
|
8638
|
+
"sourceFile": "src/ResolveDialog.tsx",
|
|
8639
|
+
"purpose": "Resolve, with an optional note: the same dialog in every app.",
|
|
8640
|
+
"purposeFrom": "page",
|
|
7433
8641
|
"props": [
|
|
7434
8642
|
{
|
|
7435
|
-
"name": "
|
|
7436
|
-
"takes": "
|
|
8643
|
+
"name": "onResolve",
|
|
8644
|
+
"takes": "a handler",
|
|
8645
|
+
"required": true,
|
|
8646
|
+
"note": "Resolve, with what was written (an empty string for none)."
|
|
8647
|
+
},
|
|
8648
|
+
{
|
|
8649
|
+
"name": "onCancel",
|
|
8650
|
+
"takes": "a handler",
|
|
7437
8651
|
"required": true,
|
|
7438
8652
|
"note": null
|
|
8653
|
+
},
|
|
8654
|
+
{
|
|
8655
|
+
"name": "refused",
|
|
8656
|
+
"takes": "text",
|
|
8657
|
+
"required": false,
|
|
8658
|
+
"note": "Why the last resolve was refused, in plain words."
|
|
7439
8659
|
}
|
|
7440
8660
|
],
|
|
7441
8661
|
"variants": [],
|
|
@@ -7457,91 +8677,15 @@
|
|
|
7457
8677
|
"behaviour": "Holds focus inside while open, and gives it back"
|
|
7458
8678
|
},
|
|
7459
8679
|
{
|
|
7460
|
-
"id": "
|
|
7461
|
-
"behaviour": "
|
|
8680
|
+
"id": "scroll-lock",
|
|
8681
|
+
"behaviour": "Stops the page behind it scrolling"
|
|
7462
8682
|
}
|
|
7463
8683
|
],
|
|
7464
8684
|
"status": "stable",
|
|
7465
8685
|
"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,
|
|
8686
|
+
"docsId": "conversation-resolvedialog--docs",
|
|
8687
|
+
"storyId": "conversation-resolvedialog--resolve",
|
|
8688
|
+
"docPage": "src/ResolveDialog.mdx",
|
|
7545
8689
|
"app": null,
|
|
7546
8690
|
"looks": []
|
|
7547
8691
|
},
|
|
@@ -8424,6 +9568,32 @@
|
|
|
8424
9568
|
"app": null,
|
|
8425
9569
|
"looks": []
|
|
8426
9570
|
},
|
|
9571
|
+
{
|
|
9572
|
+
"name": "SkeletonConversation",
|
|
9573
|
+
"repo": "estiva-ui",
|
|
9574
|
+
"kind": "component",
|
|
9575
|
+
"importPath": "@estiva-app/ui",
|
|
9576
|
+
"sourceFile": "src/Skeleton.tsx",
|
|
9577
|
+
"purpose": "Comments still coming: three placeholders shaped like `ConversationCard`, revealed after 150ms.",
|
|
9578
|
+
"purposeFrom": "comment",
|
|
9579
|
+
"props": [
|
|
9580
|
+
{
|
|
9581
|
+
"name": "className",
|
|
9582
|
+
"takes": "text",
|
|
9583
|
+
"required": false,
|
|
9584
|
+
"note": null
|
|
9585
|
+
}
|
|
9586
|
+
],
|
|
9587
|
+
"variants": [],
|
|
9588
|
+
"ownsBehaviours": [],
|
|
9589
|
+
"status": "stable",
|
|
9590
|
+
"migrationStage": null,
|
|
9591
|
+
"docsId": "status-feedback-skeleton--docs",
|
|
9592
|
+
"storyId": "status-feedback-skeleton--list",
|
|
9593
|
+
"docPage": null,
|
|
9594
|
+
"app": null,
|
|
9595
|
+
"looks": []
|
|
9596
|
+
},
|
|
8427
9597
|
{
|
|
8428
9598
|
"name": "SkeletonList",
|
|
8429
9599
|
"repo": "estiva-ui",
|
|
@@ -8922,6 +10092,106 @@
|
|
|
8922
10092
|
"app": null,
|
|
8923
10093
|
"looks": []
|
|
8924
10094
|
},
|
|
10095
|
+
{
|
|
10096
|
+
"name": "Thread",
|
|
10097
|
+
"repo": "estiva-ui",
|
|
10098
|
+
"kind": "component",
|
|
10099
|
+
"importPath": "@estiva-app/ui",
|
|
10100
|
+
"sourceFile": "src/Thread.tsx",
|
|
10101
|
+
"purpose": "A comment's replies, with the box to write one: in the right column under its own header, or under its comment.",
|
|
10102
|
+
"purposeFrom": "page",
|
|
10103
|
+
"props": [
|
|
10104
|
+
{
|
|
10105
|
+
"name": "place",
|
|
10106
|
+
"takes": "beside | under",
|
|
10107
|
+
"required": false,
|
|
10108
|
+
"note": "`beside`: in the right column, beside the comments, under its own header."
|
|
10109
|
+
},
|
|
10110
|
+
{
|
|
10111
|
+
"name": "start",
|
|
10112
|
+
"takes": "ThreadStart",
|
|
10113
|
+
"required": false,
|
|
10114
|
+
"note": "The comment it answers, pinned at the top of the column."
|
|
10115
|
+
},
|
|
10116
|
+
{
|
|
10117
|
+
"name": "children",
|
|
10118
|
+
"takes": "anything",
|
|
10119
|
+
"required": false,
|
|
10120
|
+
"note": "Its replies, in time order: `ReplyCard`s."
|
|
10121
|
+
},
|
|
10122
|
+
{
|
|
10123
|
+
"name": "loading",
|
|
10124
|
+
"takes": "true/false",
|
|
10125
|
+
"required": false,
|
|
10126
|
+
"note": "Still reading the replies: placeholders in their place."
|
|
10127
|
+
},
|
|
10128
|
+
{
|
|
10129
|
+
"name": "resolved",
|
|
10130
|
+
"takes": "true/false",
|
|
10131
|
+
"required": false,
|
|
10132
|
+
"note": "Resolved: \"Resolved\" at the top of the column, in green."
|
|
10133
|
+
},
|
|
10134
|
+
{
|
|
10135
|
+
"name": "box",
|
|
10136
|
+
"takes": "anything",
|
|
10137
|
+
"required": false,
|
|
10138
|
+
"note": "The box a reply is written in: the app's `CommentBox`."
|
|
10139
|
+
},
|
|
10140
|
+
{
|
|
10141
|
+
"name": "notice",
|
|
10142
|
+
"takes": "anything",
|
|
10143
|
+
"required": false,
|
|
10144
|
+
"note": "Said in place of the box: why no reply can be written (an archived page, a deleted comment)."
|
|
10145
|
+
},
|
|
10146
|
+
{
|
|
10147
|
+
"name": "actions",
|
|
10148
|
+
"takes": "anything",
|
|
10149
|
+
"required": false,
|
|
10150
|
+
"note": "The column's own actions, before Close: a `MembersPill`, an `IconButton` to where it was first said."
|
|
10151
|
+
},
|
|
10152
|
+
{
|
|
10153
|
+
"name": "onClose",
|
|
10154
|
+
"takes": "a handler",
|
|
10155
|
+
"required": false,
|
|
10156
|
+
"note": "Closes the column."
|
|
10157
|
+
},
|
|
10158
|
+
{
|
|
10159
|
+
"name": "title",
|
|
10160
|
+
"takes": "anything",
|
|
10161
|
+
"required": false,
|
|
10162
|
+
"note": "The column's name."
|
|
10163
|
+
},
|
|
10164
|
+
{
|
|
10165
|
+
"name": "bodyRef",
|
|
10166
|
+
"takes": "Ref<HTMLDivElement>",
|
|
10167
|
+
"required": false,
|
|
10168
|
+
"note": "The column's scrolling box, for opening at the newest reply."
|
|
10169
|
+
},
|
|
10170
|
+
{
|
|
10171
|
+
"name": "className",
|
|
10172
|
+
"takes": "text",
|
|
10173
|
+
"required": false,
|
|
10174
|
+
"note": "Placement only."
|
|
10175
|
+
}
|
|
10176
|
+
],
|
|
10177
|
+
"variants": [
|
|
10178
|
+
{
|
|
10179
|
+
"prop": "place",
|
|
10180
|
+
"values": [
|
|
10181
|
+
"beside",
|
|
10182
|
+
"under"
|
|
10183
|
+
]
|
|
10184
|
+
}
|
|
10185
|
+
],
|
|
10186
|
+
"ownsBehaviours": [],
|
|
10187
|
+
"status": "stable",
|
|
10188
|
+
"migrationStage": null,
|
|
10189
|
+
"docsId": "conversation-thread--docs",
|
|
10190
|
+
"storyId": "conversation-thread--column",
|
|
10191
|
+
"docPage": "src/Thread.mdx",
|
|
10192
|
+
"app": null,
|
|
10193
|
+
"looks": []
|
|
10194
|
+
},
|
|
8925
10195
|
{
|
|
8926
10196
|
"name": "Toast",
|
|
8927
10197
|
"repo": "estiva-ui",
|
|
@@ -9576,7 +10846,7 @@
|
|
|
9576
10846
|
"name": "menu",
|
|
9577
10847
|
"takes": "anything",
|
|
9578
10848
|
"required": false,
|
|
9579
|
-
"note": "Far left: the menu button, in an app whose navigation
|
|
10849
|
+
"note": "Far left: the menu button, in an app whose navigation folds."
|
|
9580
10850
|
},
|
|
9581
10851
|
{
|
|
9582
10852
|
"name": "logo",
|
|
@@ -9790,6 +11060,25 @@
|
|
|
9790
11060
|
"app": null,
|
|
9791
11061
|
"looks": []
|
|
9792
11062
|
},
|
|
11063
|
+
{
|
|
11064
|
+
"name": "UrgentMark",
|
|
11065
|
+
"repo": "estiva-ui",
|
|
11066
|
+
"kind": "component",
|
|
11067
|
+
"importPath": "@estiva-app/ui",
|
|
11068
|
+
"sourceFile": "src/UrgentMark.tsx",
|
|
11069
|
+
"purpose": "Urgent and new: a small warning mark on its tint, in the unread dot's 24px slot.",
|
|
11070
|
+
"purposeFrom": "page",
|
|
11071
|
+
"props": [],
|
|
11072
|
+
"variants": [],
|
|
11073
|
+
"ownsBehaviours": [],
|
|
11074
|
+
"status": "stable",
|
|
11075
|
+
"migrationStage": null,
|
|
11076
|
+
"docsId": "conversation-urgentmark--docs",
|
|
11077
|
+
"storyId": "conversation-urgentmark--urgent",
|
|
11078
|
+
"docPage": "src/UrgentMark.mdx",
|
|
11079
|
+
"app": null,
|
|
11080
|
+
"looks": []
|
|
11081
|
+
},
|
|
9793
11082
|
{
|
|
9794
11083
|
"name": "UrgentPersonMention",
|
|
9795
11084
|
"repo": "estiva-ui",
|
|
@@ -9854,6 +11143,44 @@
|
|
|
9854
11143
|
"app": null,
|
|
9855
11144
|
"looks": []
|
|
9856
11145
|
},
|
|
11146
|
+
{
|
|
11147
|
+
"name": "useSidebarFold",
|
|
11148
|
+
"repo": "estiva-ui",
|
|
11149
|
+
"kind": "hook",
|
|
11150
|
+
"importPath": "@estiva-app/ui",
|
|
11151
|
+
"sourceFile": "src/AppShell.tsx",
|
|
11152
|
+
"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).",
|
|
11153
|
+
"purposeFrom": "comment",
|
|
11154
|
+
"props": [
|
|
11155
|
+
{
|
|
11156
|
+
"name": "storageKey",
|
|
11157
|
+
"takes": "text",
|
|
11158
|
+
"required": true,
|
|
11159
|
+
"note": "Where this browser keeps a folded sidebar: the app's own key, such as `ship.sidebarFolded`."
|
|
11160
|
+
},
|
|
11161
|
+
{
|
|
11162
|
+
"name": "isFile",
|
|
11163
|
+
"takes": "a handler",
|
|
11164
|
+
"required": false,
|
|
11165
|
+
"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)."
|
|
11166
|
+
},
|
|
11167
|
+
{
|
|
11168
|
+
"name": "foldWhen",
|
|
11169
|
+
"takes": "text",
|
|
11170
|
+
"required": false,
|
|
11171
|
+
"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)`)."
|
|
11172
|
+
}
|
|
11173
|
+
],
|
|
11174
|
+
"variants": [],
|
|
11175
|
+
"ownsBehaviours": [],
|
|
11176
|
+
"status": "stable",
|
|
11177
|
+
"migrationStage": null,
|
|
11178
|
+
"docsId": "app-frame-appshell--docs",
|
|
11179
|
+
"storyId": "app-frame-appshell--solid",
|
|
11180
|
+
"docPage": null,
|
|
11181
|
+
"app": null,
|
|
11182
|
+
"looks": []
|
|
11183
|
+
},
|
|
9857
11184
|
{
|
|
9858
11185
|
"name": "useToast",
|
|
9859
11186
|
"repo": "estiva-ui",
|