@estiva-app/ui 0.98.1 → 0.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. package/README.md +4 -2
  2. package/dist/AppProvider.d.ts +6 -3
  3. package/dist/AppProvider.d.ts.map +1 -1
  4. package/dist/ArchiveDialog.d.ts +35 -0
  5. package/dist/ArchiveDialog.d.ts.map +1 -0
  6. package/dist/AttachedCard.d.ts +13 -2
  7. package/dist/AttachedCard.d.ts.map +1 -1
  8. package/dist/Card.d.ts +6 -1
  9. package/dist/Card.d.ts.map +1 -1
  10. package/dist/ChipInput.d.ts +3 -1
  11. package/dist/ChipInput.d.ts.map +1 -1
  12. package/dist/CollapsibleSection.d.ts +27 -2
  13. package/dist/CollapsibleSection.d.ts.map +1 -1
  14. package/dist/CommentBox.d.ts +2 -2
  15. package/dist/CommentBox.d.ts.map +1 -1
  16. package/dist/ConfirmDialog.d.ts +15 -2
  17. package/dist/ConfirmDialog.d.ts.map +1 -1
  18. package/dist/ConversationCard.d.ts +12 -1
  19. package/dist/ConversationCard.d.ts.map +1 -1
  20. package/dist/ConversationLayout.d.ts +20 -5
  21. package/dist/ConversationLayout.d.ts.map +1 -1
  22. package/dist/ConversationMenu.d.ts +5 -1
  23. package/dist/ConversationMenu.d.ts.map +1 -1
  24. package/dist/ConversationPlace.d.ts +17 -0
  25. package/dist/ConversationPlace.d.ts.map +1 -0
  26. package/dist/DocumentEditor.d.ts +38 -0
  27. package/dist/DocumentEditor.d.ts.map +1 -1
  28. package/dist/DocumentField.d.ts +50 -0
  29. package/dist/DocumentField.d.ts.map +1 -0
  30. package/dist/EditableText.d.ts +38 -4
  31. package/dist/EditableText.d.ts.map +1 -1
  32. package/dist/EmptyState.d.ts +10 -5
  33. package/dist/EmptyState.d.ts.map +1 -1
  34. package/dist/FormDialog.d.ts +38 -0
  35. package/dist/FormDialog.d.ts.map +1 -0
  36. package/dist/InlineText.d.ts.map +1 -1
  37. package/dist/Menu.d.ts +11 -3
  38. package/dist/Menu.d.ts.map +1 -1
  39. package/dist/MoveDialog.d.ts +64 -0
  40. package/dist/MoveDialog.d.ts.map +1 -0
  41. package/dist/NavItem.d.ts +9 -2
  42. package/dist/NavItem.d.ts.map +1 -1
  43. package/dist/NavTree.d.ts +16 -3
  44. package/dist/NavTree.d.ts.map +1 -1
  45. package/dist/PinnedComment.d.ts +3 -1
  46. package/dist/PinnedComment.d.ts.map +1 -1
  47. package/dist/ReactionHorizon.d.ts +3 -1
  48. package/dist/ReactionHorizon.d.ts.map +1 -1
  49. package/dist/RepliesRow.d.ts +5 -3
  50. package/dist/RepliesRow.d.ts.map +1 -1
  51. package/dist/ResolveDialog.d.ts +3 -1
  52. package/dist/ResolveDialog.d.ts.map +1 -1
  53. package/dist/SelectionToolbar.d.ts +2 -2
  54. package/dist/Thread.d.ts +6 -3
  55. package/dist/Thread.d.ts.map +1 -1
  56. package/dist/commentBoxFrame.d.ts.map +1 -1
  57. package/dist/conversation.examples.d.ts +4 -1
  58. package/dist/conversation.examples.d.ts.map +1 -1
  59. package/dist/conversationScroll.d.ts +80 -0
  60. package/dist/conversationScroll.d.ts.map +1 -0
  61. package/dist/editor.d.ts +1 -0
  62. package/dist/editor.d.ts.map +1 -1
  63. package/dist/editor.js +228 -69
  64. package/dist/editor.js.map +4 -4
  65. package/dist/eslint/index.js +2 -2
  66. package/dist/eslint/index.js.map +2 -2
  67. package/dist/eslint/no-field-outside-a-form.d.ts +2 -2
  68. package/dist/eslint/no-field-outside-a-form.d.ts.map +1 -1
  69. package/dist/eslint/no-native-title.d.ts +1 -1
  70. package/dist/eslint/no-native-title.d.ts.map +1 -1
  71. package/dist/formBusy.d.ts +5 -2
  72. package/dist/formBusy.d.ts.map +1 -1
  73. package/dist/index.d.ts +14 -6
  74. package/dist/index.d.ts.map +1 -1
  75. package/dist/index.js +2242 -1471
  76. package/dist/index.js.map +4 -4
  77. package/dist/looks.d.ts +8 -0
  78. package/dist/looks.d.ts.map +1 -1
  79. package/dist/seenOnScreen.d.ts +27 -0
  80. package/dist/seenOnScreen.d.ts.map +1 -0
  81. package/dist/showInConversation.d.ts +31 -0
  82. package/dist/showInConversation.d.ts.map +1 -0
  83. package/dist/threadCard.d.ts +13 -0
  84. package/dist/threadCard.d.ts.map +1 -1
  85. package/package.json +1 -1
  86. package/registry.json +953 -126
  87. package/src/AppProvider.mdx +4 -0
  88. package/src/AppProvider.test.tsx +34 -2
  89. package/src/AppProvider.tsx +17 -6
  90. package/src/ArchiveDialog.mdx +70 -0
  91. package/src/ArchiveDialog.stories.tsx +64 -0
  92. package/src/ArchiveDialog.test.tsx +90 -0
  93. package/src/ArchiveDialog.tsx +70 -0
  94. package/src/AttachedCard.mdx +6 -0
  95. package/src/AttachedCard.stories.tsx +9 -1
  96. package/src/AttachedCard.test.tsx +111 -2
  97. package/src/AttachedCard.tsx +77 -7
  98. package/src/Card.mdx +20 -1
  99. package/src/Card.stories.tsx +20 -0
  100. package/src/Card.test.tsx +87 -1
  101. package/src/Card.tsx +51 -3
  102. package/src/ChipInput.mdx +7 -1
  103. package/src/ChipInput.stories.tsx +9 -0
  104. package/src/ChipInput.test.tsx +42 -0
  105. package/src/ChipInput.tsx +7 -3
  106. package/src/CollapsibleSection.mdx +20 -1
  107. package/src/CollapsibleSection.stories.tsx +19 -1
  108. package/src/CollapsibleSection.test.tsx +85 -2
  109. package/src/CollapsibleSection.tsx +54 -15
  110. package/src/CommentBox.mdx +2 -1
  111. package/src/CommentBox.test.tsx +81 -1
  112. package/src/CommentBox.tsx +32 -11
  113. package/src/ConfirmDialog.mdx +25 -3
  114. package/src/ConfirmDialog.stories.tsx +27 -0
  115. package/src/ConfirmDialog.test.tsx +87 -1
  116. package/src/ConfirmDialog.tsx +39 -8
  117. package/src/ConversationCard.mdx +7 -0
  118. package/src/ConversationCard.states.test.tsx +67 -0
  119. package/src/ConversationCard.stories.tsx +27 -1
  120. package/src/ConversationCard.test.tsx +76 -0
  121. package/src/ConversationCard.tsx +65 -53
  122. package/src/ConversationLayout.mdx +34 -4
  123. package/src/ConversationLayout.scroll.test.tsx +411 -0
  124. package/src/ConversationLayout.stories.tsx +107 -1
  125. package/src/ConversationLayout.test.tsx +133 -0
  126. package/src/ConversationLayout.tsx +141 -16
  127. package/src/ConversationMenu.mdx +3 -0
  128. package/src/ConversationMenu.stories.tsx +12 -0
  129. package/src/ConversationMenu.test.tsx +17 -0
  130. package/src/ConversationMenu.tsx +7 -3
  131. package/src/ConversationPlace.mdx +53 -0
  132. package/src/ConversationPlace.stories.tsx +48 -0
  133. package/src/ConversationPlace.test.tsx +51 -0
  134. package/src/ConversationPlace.tsx +30 -0
  135. package/src/DocumentEditor.mdx +2 -1
  136. package/src/DocumentEditor.tsx +118 -64
  137. package/src/DocumentField.mdx +83 -0
  138. package/src/DocumentField.stories.tsx +110 -0
  139. package/src/DocumentField.test.tsx +281 -0
  140. package/src/DocumentField.tsx +199 -0
  141. package/src/EditableText.buttons.test.tsx +318 -0
  142. package/src/EditableText.mdx +50 -2
  143. package/src/EditableText.stories.tsx +96 -2
  144. package/src/EditableText.tsx +189 -5
  145. package/src/EmptyState.mdx +33 -8
  146. package/src/EmptyState.stories.tsx +26 -1
  147. package/src/EmptyState.test.tsx +63 -2
  148. package/src/EmptyState.tsx +28 -6
  149. package/src/Form.mdx +3 -1
  150. package/src/FormDialog.mdx +78 -0
  151. package/src/FormDialog.stories.tsx +90 -0
  152. package/src/FormDialog.test.tsx +183 -0
  153. package/src/FormDialog.tsx +93 -0
  154. package/src/InlineText.mdx +1 -0
  155. package/src/InlineText.tsx +2 -1
  156. package/src/Menu.test.tsx +80 -0
  157. package/src/Menu.tsx +35 -14
  158. package/src/MenuItem.mdx +12 -0
  159. package/src/MenuItem.stories.tsx +39 -1
  160. package/src/MoveDialog.mdx +85 -0
  161. package/src/MoveDialog.stories.tsx +134 -0
  162. package/src/MoveDialog.test.tsx +239 -0
  163. package/src/MoveDialog.tsx +186 -0
  164. package/src/NavItem.mdx +15 -0
  165. package/src/NavItem.stories.tsx +15 -0
  166. package/src/NavItem.test.tsx +64 -1
  167. package/src/NavItem.tsx +10 -2
  168. package/src/NavTree.mdx +26 -4
  169. package/src/NavTree.stories.tsx +59 -0
  170. package/src/NavTree.test.tsx +232 -2
  171. package/src/NavTree.tsx +93 -43
  172. package/src/PinnedComment.mdx +6 -1
  173. package/src/PinnedComment.stories.tsx +11 -1
  174. package/src/PinnedComment.tsx +15 -2
  175. package/src/ReactionHorizon.mdx +2 -0
  176. package/src/ReactionHorizon.stories.tsx +3 -0
  177. package/src/ReactionHorizon.test.tsx +32 -0
  178. package/src/ReactionHorizon.tsx +28 -11
  179. package/src/RepliesRow.mdx +6 -3
  180. package/src/RepliesRow.stories.tsx +3 -0
  181. package/src/RepliesRow.test.tsx +24 -0
  182. package/src/RepliesRow.tsx +12 -6
  183. package/src/ReplyCard.mdx +8 -0
  184. package/src/ReplyCard.stories.tsx +45 -1
  185. package/src/ResolveDialog.mdx +2 -0
  186. package/src/ResolveDialog.test.tsx +21 -0
  187. package/src/ResolveDialog.tsx +11 -39
  188. package/src/SelectionToolbar.tsx +2 -2
  189. package/src/Textarea.mdx +1 -0
  190. package/src/Thread.mdx +20 -1
  191. package/src/Thread.stories.tsx +94 -3
  192. package/src/Thread.test.tsx +11 -0
  193. package/src/Thread.tsx +56 -12
  194. package/src/commentBoxFrame.tsx +2 -2
  195. package/src/conversation.examples.tsx +10 -2
  196. package/src/conversationScroll.ts +155 -0
  197. package/src/editor.ts +1 -0
  198. package/src/editorSelection.test.tsx +53 -0
  199. package/src/eslint/no-field-outside-a-form.test.ts +4 -0
  200. package/src/eslint/no-field-outside-a-form.ts +2 -2
  201. package/src/eslint/no-native-title.ts +1 -1
  202. package/src/formBusy.ts +5 -2
  203. package/src/index.ts +16 -6
  204. package/src/looks.ts +10 -0
  205. package/src/registry/registry.test.ts +12 -6
  206. package/src/seenOnScreen.test.tsx +241 -0
  207. package/src/seenOnScreen.ts +146 -0
  208. package/src/showInConversation.test.tsx +168 -0
  209. package/src/showInConversation.ts +93 -0
  210. package/src/threadCard.ts +16 -0
  211. package/stories/Choosing.mdx +8 -3
  212. package/tailwind-preset.js +7 -0
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.98.1",
8
- "exports": 229,
9
- "typeExports": 234,
7
+ "packageVersion": "0.100.0",
8
+ "exports": 243,
9
+ "typeExports": 249,
10
10
  "files": null
11
11
  },
12
12
  "storybook": {
@@ -294,6 +294,95 @@
294
294
  "overflow-hidden rounded-2xl bg-bg-surface signal:border signal:border-border-subtle signal:shadow-highlight-inset"
295
295
  ]
296
296
  },
297
+ {
298
+ "name": "ArchiveDialog",
299
+ "repo": "estiva-ui",
300
+ "kind": "component",
301
+ "importPath": "@estiva-app/ui",
302
+ "sourceFile": "src/ArchiveDialog.tsx",
303
+ "purpose": "The question asked before archiving a file or a Folder: what goes out of the lists with it, counted, and an optional resolution.",
304
+ "purposeFrom": "page",
305
+ "props": [
306
+ {
307
+ "name": "title",
308
+ "takes": "text",
309
+ "required": true,
310
+ "note": "The file's name, for the title."
311
+ },
312
+ {
313
+ "name": "what",
314
+ "takes": "text",
315
+ "required": true,
316
+ "note": "What it is, in a word: \"topic\", \"project\", \"issue\", \"folder\"."
317
+ },
318
+ {
319
+ "name": "hides",
320
+ "takes": "readonly string[] | null",
321
+ "required": true,
322
+ "note": "What goes out of the lists with it, already counted and worded — \"14 issues\"."
323
+ },
324
+ {
325
+ "name": "staysVisible",
326
+ "takes": "readonly string[]",
327
+ "required": false,
328
+ "note": "What it lists that stays visible somewhere else, worded — \"2 files also in Steer\"."
329
+ },
330
+ {
331
+ "name": "apps",
332
+ "takes": "readonly string[]",
333
+ "required": true,
334
+ "note": "The apps whose lists it goes out of, in the order to name them: `['Peek', 'Ship']` reads \"in Peek and in Ship\"."
335
+ },
336
+ {
337
+ "name": "getBack",
338
+ "takes": "text",
339
+ "required": true,
340
+ "note": "The last line, in the app's words: that nothing is deleted, and how to get it back there."
341
+ },
342
+ {
343
+ "name": "onClose",
344
+ "takes": "a handler",
345
+ "required": true,
346
+ "note": null
347
+ },
348
+ {
349
+ "name": "onArchive",
350
+ "takes": "a handler",
351
+ "required": true,
352
+ "note": "With the resolution, trimmed (`''` for none)."
353
+ }
354
+ ],
355
+ "variants": [],
356
+ "ownsBehaviours": [
357
+ {
358
+ "id": "portal",
359
+ "behaviour": "Floats on top of the page"
360
+ },
361
+ {
362
+ "id": "press-outside",
363
+ "behaviour": "Closes on a press outside"
364
+ },
365
+ {
366
+ "id": "page-keys",
367
+ "behaviour": "Takes its keys by itself"
368
+ },
369
+ {
370
+ "id": "focus",
371
+ "behaviour": "Holds focus inside while open, and gives it back"
372
+ },
373
+ {
374
+ "id": "scroll-lock",
375
+ "behaviour": "Stops the page behind it scrolling"
376
+ }
377
+ ],
378
+ "status": "stable",
379
+ "migrationStage": null,
380
+ "docsId": "menus-windows-archivedialog--docs",
381
+ "storyId": "menus-windows-archivedialog--a-project",
382
+ "docPage": "src/ArchiveDialog.mdx",
383
+ "app": null,
384
+ "looks": []
385
+ },
297
386
  {
298
387
  "name": "archivedLine",
299
388
  "repo": "estiva-ui",
@@ -1131,6 +1220,12 @@
1131
1220
  "required": false,
1132
1221
  "note": "What is inside is cut to the card's rounded corners: a strip or a picture that runs edge to edge (UIG-9, 17 September; the apps passed `overflow-hidden`)."
1133
1222
  },
1223
+ {
1224
+ "name": "onPress",
1225
+ "takes": "a handler",
1226
+ "required": false,
1227
+ "note": "Pressing the card opens what it stands for: a click anywhere on it but on what acts by itself inside it, and Enter or Space on the card itself, which is a Tab stop."
1228
+ },
1134
1229
  {
1135
1230
  "name": "children",
1136
1231
  "takes": "anything",
@@ -1494,6 +1589,12 @@
1494
1589
  "takes": "text",
1495
1590
  "required": false,
1496
1591
  "note": "The id of what names the field on the page — a visible \"To:\", say."
1592
+ },
1593
+ {
1594
+ "name": "single",
1595
+ "takes": "true/false",
1596
+ "required": false,
1597
+ "note": "It holds one — an owner, an assignee: a later pick replaces the chosen one rather than adding a second."
1497
1598
  }
1498
1599
  ],
1499
1600
  "variants": [],
@@ -1539,7 +1640,7 @@
1539
1640
  "app": null,
1540
1641
  "looks": [
1541
1642
  "bg-bg-elevated border border-border-subtle rounded-md",
1542
- "bg-bg-field border border-border-field shadow-field hover:border-border-strong rounded-lg transition-colors focus-within:border-border-focus focus-within:hover:border-border-focus cursor-text signal:transition-shadow signal:focus-within:shadow-focus-ring",
1643
+ "bg-bg-field border border-border-field shadow-field hover:border-border-strong rounded-lg transition-colors focus-within:border-border-focus focus-within:hover:border-border-focus signal:transition-shadow signal:focus-within:shadow-focus-ring cursor-text",
1543
1644
  "text-body-2 border-none bg-transparent text-text-primary placeholder:text-text-muted outline-none"
1544
1645
  ]
1545
1646
  },
@@ -2450,7 +2551,13 @@
2450
2551
  "name": "onClose",
2451
2552
  "takes": "a handler",
2452
2553
  "required": true,
2453
- "note": null
2554
+ "note": "Cancel, Escape, the ✕, and an action that went through: once, when it was closed while the action ran."
2555
+ },
2556
+ {
2557
+ "name": "alternative",
2558
+ "takes": "ConfirmDialogAlternative",
2559
+ "required": false,
2560
+ "note": "A third, safer answer — \"Archive instead\" — drawn after the words, under its sentence, and switched off while the confirm runs (Peek's, 2 November)."
2454
2561
  }
2455
2562
  ],
2456
2563
  "variants": [],
@@ -2718,6 +2825,12 @@
2718
2825
  "required": true,
2719
2826
  "note": "When it was written, in the app's words (\"11:08 AM\")."
2720
2827
  },
2828
+ {
2829
+ "name": "at",
2830
+ "takes": "number",
2831
+ "required": false,
2832
+ "note": "When it was written, as a moment (ms since 1970): the time then says the exact date and time under the pointer."
2833
+ },
2721
2834
  {
2722
2835
  "name": "timeHref",
2723
2836
  "takes": "text",
@@ -2844,6 +2957,18 @@
2844
2957
  "required": false,
2845
2958
  "note": "Edit's words in the ⋯ menu: \"Edit\" by default; Peek's \"Edit message\"."
2846
2959
  },
2960
+ {
2961
+ "name": "deleteLabel",
2962
+ "takes": "text",
2963
+ "required": false,
2964
+ "note": "Delete's words in the ⋯ menu: \"Delete\" by default; Ship's \"Delete message\"."
2965
+ },
2966
+ {
2967
+ "name": "moreLabel",
2968
+ "takes": "text",
2969
+ "required": false,
2970
+ "note": "The ⋯ button's name and tooltip: \"More actions\" by default; Ship's \"Message actions\"."
2971
+ },
2847
2972
  {
2848
2973
  "name": "className",
2849
2974
  "takes": "text",
@@ -2888,6 +3013,12 @@
2888
3013
  "required": false,
2889
3014
  "note": "The id of the comment whose thread is open."
2890
3015
  },
3016
+ {
3017
+ "name": "aside",
3018
+ "takes": "anything",
3019
+ "required": false,
3020
+ "note": "Two columns: what the 384px column holds while no thread is open, the page's own panel beside its comments (an overview)."
3021
+ },
2891
3022
  {
2892
3023
  "name": "onOpenChange",
2893
3024
  "takes": "a handler",
@@ -2910,7 +3041,7 @@
2910
3041
  "name": "below",
2911
3042
  "takes": "anything",
2912
3043
  "required": false,
2913
- "note": "Two columns: under the comments, inside their list, or under the empty line: a `ReactionHorizon`."
3044
+ "note": "Under the comments, inside their list, or under the empty line: a `ReactionHorizon`, or the app's own note."
2914
3045
  },
2915
3046
  {
2916
3047
  "name": "top",
@@ -2930,11 +3061,17 @@
2930
3061
  "required": false,
2931
3062
  "note": "What an empty conversation says: words, or the app's own `EmptyState` (a read that failed says so)."
2932
3063
  },
3064
+ {
3065
+ "name": "rememberAs",
3066
+ "takes": "text",
3067
+ "required": false,
3068
+ "note": "Two columns: the conversation's own name in the app (its address)."
3069
+ },
2933
3070
  {
2934
3071
  "name": "bodyRef",
2935
3072
  "takes": "Ref<HTMLDivElement>",
2936
3073
  "required": false,
2937
- "note": "Two columns: the comments' scrolling box, for an app that keeps its own place in it (where it was left, its \"New\" line, following what arrives)."
3074
+ "note": "Two columns: the comments' scrolling box."
2938
3075
  },
2939
3076
  {
2940
3077
  "name": "onBodyScroll",
@@ -2942,6 +3079,12 @@
2942
3079
  "required": false,
2943
3080
  "note": "Two columns: the comments' box scrolled."
2944
3081
  },
3082
+ {
3083
+ "name": "seen",
3084
+ "takes": "SeenOnScreen",
3085
+ "required": false,
3086
+ "note": "What `useSeenOnScreen` made for this conversation: the layout watches its comments, and says in it which were seen."
3087
+ },
2945
3088
  {
2946
3089
  "name": "header",
2947
3090
  "takes": "anything",
@@ -3054,6 +3197,18 @@
3054
3197
  "required": false,
3055
3198
  "note": "Offered on your own only; the card asks before it deletes."
3056
3199
  },
3200
+ {
3201
+ "name": "deleteLabel",
3202
+ "takes": "text",
3203
+ "required": false,
3204
+ "note": "Delete's words: \"Delete\" by default; Ship's \"Delete message\"."
3205
+ },
3206
+ {
3207
+ "name": "moreLabel",
3208
+ "takes": "text",
3209
+ "required": false,
3210
+ "note": "Its own ⋯ button's name and tooltip, with no `trigger`: \"More actions\" by default; Ship's \"Message actions\"."
3211
+ },
3057
3212
  {
3058
3213
  "name": "open",
3059
3214
  "takes": "true/false",
@@ -3104,6 +3259,44 @@
3104
3259
  "app": null,
3105
3260
  "looks": []
3106
3261
  },
3262
+ {
3263
+ "name": "ConversationPlace",
3264
+ "repo": "estiva-ui",
3265
+ "kind": "component",
3266
+ "importPath": "@estiva-app/ui",
3267
+ "sourceFile": "src/ConversationPlace.tsx",
3268
+ "purpose": "Above a conversation shown away from where it was said: how it is related, and where it was said.",
3269
+ "purposeFrom": "page",
3270
+ "props": [
3271
+ {
3272
+ "name": "relation",
3273
+ "takes": "text",
3274
+ "required": true,
3275
+ "note": "How the conversation is related to the page it is shown on, in the app's words: \"Mentioned in\"."
3276
+ },
3277
+ {
3278
+ "name": "place",
3279
+ "takes": "text",
3280
+ "required": false,
3281
+ "note": "Where it was said: the place's name. Absent or empty while it resolves, and then nothing is drawn for it."
3282
+ },
3283
+ {
3284
+ "name": "children",
3285
+ "takes": "anything",
3286
+ "required": false,
3287
+ "note": "The conversation, as the app draws it: its card."
3288
+ }
3289
+ ],
3290
+ "variants": [],
3291
+ "ownsBehaviours": [],
3292
+ "status": "stable",
3293
+ "migrationStage": null,
3294
+ "docsId": "conversation-conversationplace--docs",
3295
+ "storyId": "conversation-conversationplace--mentioned-in",
3296
+ "docPage": "src/ConversationPlace.mdx",
3297
+ "app": null,
3298
+ "looks": []
3299
+ },
3107
3300
  {
3108
3301
  "name": "deleteBlock",
3109
3302
  "repo": "estiva-ui",
@@ -3517,6 +3710,112 @@
3517
3710
  "app": null,
3518
3711
  "looks": []
3519
3712
  },
3713
+ {
3714
+ "name": "DocumentField",
3715
+ "repo": "estiva-ui",
3716
+ "kind": "component",
3717
+ "importPath": "@estiva-app/ui/editor",
3718
+ "sourceFile": "src/DocumentField.tsx",
3719
+ "purpose": "A form's field that holds a document: the document editor's blocks, marks, `[`, `@` and `/`, in a field's box.",
3720
+ "purposeFrom": "page",
3721
+ "props": [
3722
+ {
3723
+ "name": "value",
3724
+ "takes": "text",
3725
+ "required": true,
3726
+ "note": "What the field holds, in `format`; `''` when nothing is written."
3727
+ },
3728
+ {
3729
+ "name": "format",
3730
+ "takes": "text",
3731
+ "required": true,
3732
+ "note": "The format `value` is in, handed to `codec.read`."
3733
+ },
3734
+ {
3735
+ "name": "codec",
3736
+ "takes": "DocumentCodec",
3737
+ "required": true,
3738
+ "note": "How the app's text and the editor's document turn into each other: `DocumentEditor`'s."
3739
+ },
3740
+ {
3741
+ "name": "onChange",
3742
+ "takes": "a handler",
3743
+ "required": true,
3744
+ "note": "Every edit, as it is typed: the text and its format, or `''` once it is emptied or holds only spaces and blank lines."
3745
+ },
3746
+ {
3747
+ "name": "label",
3748
+ "takes": "text",
3749
+ "required": true,
3750
+ "note": "The editor's accessible name: the label of the `Field` around it."
3751
+ },
3752
+ {
3753
+ "name": "placeholder",
3754
+ "takes": "anything",
3755
+ "required": false,
3756
+ "note": "Muted words in the empty field."
3757
+ },
3758
+ {
3759
+ "name": "references",
3760
+ "takes": "DocumentReferences",
3761
+ "required": false,
3762
+ "note": "`[` and `/` → File."
3763
+ },
3764
+ {
3765
+ "name": "mentions",
3766
+ "takes": "DocumentMentions",
3767
+ "required": false,
3768
+ "note": "`@` and `/` → Mention."
3769
+ },
3770
+ {
3771
+ "name": "linkChips",
3772
+ "takes": "LinkChipsOptions",
3773
+ "required": false,
3774
+ "note": "A pasted app URL drawn as the chip of what it names (`LinkChips`)."
3775
+ },
3776
+ {
3777
+ "name": "readMarkdown",
3778
+ "takes": "a handler",
3779
+ "required": false,
3780
+ "note": "Plain text pasted as the blocks it spells: the app's reader of markdown, as the editor's document."
3781
+ },
3782
+ {
3783
+ "name": "referenceView",
3784
+ "takes": "ComponentType<ReferenceViewProps>",
3785
+ "required": false,
3786
+ "note": "Draws a link: the app's own, which resolves what it names."
3787
+ },
3788
+ {
3789
+ "name": "attachmentView",
3790
+ "takes": "ComponentType<AttachmentViewProps>",
3791
+ "required": false,
3792
+ "note": "Draws a placed file: the app's own card."
3793
+ },
3794
+ {
3795
+ "name": "extensions",
3796
+ "takes": "readonly AnyExtension[]",
3797
+ "required": false,
3798
+ "note": "More of the app's own extensions."
3799
+ },
3800
+ {
3801
+ "name": "aria-required",
3802
+ "takes": "boolean | 'true' | 'false'",
3803
+ "required": false,
3804
+ "note": "Set by a required `Field` around it, for a screen reader."
3805
+ }
3806
+ ],
3807
+ "variants": [],
3808
+ "ownsBehaviours": [],
3809
+ "status": "stable",
3810
+ "migrationStage": null,
3811
+ "docsId": "writing-documentfield--docs",
3812
+ "storyId": "writing-documentfield--empty",
3813
+ "docPage": "src/DocumentField.mdx",
3814
+ "app": null,
3815
+ "looks": [
3816
+ "bg-bg-field border border-border-field shadow-field hover:border-border-strong rounded-lg transition-colors focus-within:border-border-focus focus-within:hover:border-border-focus signal:transition-shadow signal:focus-within:shadow-focus-ring cursor-text"
3817
+ ]
3818
+ },
3520
3819
  {
3521
3820
  "name": "duplicateBlock",
3522
3821
  "repo": "estiva-ui",
@@ -3555,7 +3854,7 @@
3555
3854
  "name": "placeholder",
3556
3855
  "takes": "text",
3557
3856
  "required": true,
3558
- "note": null
3857
+ "note": "What shows, muted, while the value is empty; in `buttons`, as the kit's empty line for one part of a page (12px)."
3559
3858
  },
3560
3859
  {
3561
3860
  "name": "onCommit",
@@ -3598,35 +3897,83 @@
3598
3897
  "takes": "true/false",
3599
3898
  "required": false,
3600
3899
  "note": "Show the value only — no edit affordance."
3601
- }
3602
- ],
3603
- "variants": [],
3604
- "ownsBehaviours": [
3900
+ },
3605
3901
  {
3606
- "id": "base-ui",
3607
- "behaviour": "Is built on Base UI"
3608
- }
3609
- ],
3610
- "status": "stable",
3611
- "migrationStage": null,
3612
- "docsId": "forms-fields-editabletext--docs",
3613
- "storyId": "forms-fields-editabletext--title",
3614
- "docPage": "src/EditableText.mdx",
3615
- "app": null,
3616
- "looks": [
3617
- "rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none",
3618
- "rounded-md border border-border-strong bg-bg-inset text-text-primary outline-none resize-none",
3619
- "rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-primary",
3620
- "rounded-md border border-transparent text-left transition-colors hover:border-border-default text-text-muted",
3621
- "rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-primary",
3622
- "rounded-md border border-transparent text-left transition-colors hover:border-border-default whitespace-pre-wrap text-text-muted",
3623
- "rounded-md border border-transparent text-left transition-colors hover:border-border-default"
3624
- ]
3625
- },
3626
- {
3627
- "name": "EditedMarker",
3628
- "repo": "estiva-ui",
3629
- "kind": "component",
3902
+ "name": "manner",
3903
+ "takes": "inline | buttons",
3904
+ "required": false,
3905
+ "note": "How it is edited. `inline`, the default: the text is the button, and leaving the field saves."
3906
+ },
3907
+ {
3908
+ "name": "editLabel",
3909
+ "takes": "text",
3910
+ "required": false,
3911
+ "note": "`buttons`: the words on the button that opens the field — \"Rename\"."
3912
+ },
3913
+ {
3914
+ "name": "addLabel",
3915
+ "takes": "text",
3916
+ "required": false,
3917
+ "note": "`buttons`: its words while the value is empty, with a plus — \"Add a summary\"."
3918
+ },
3919
+ {
3920
+ "name": "fieldPlaceholder",
3921
+ "takes": "text",
3922
+ "required": false,
3923
+ "note": "`buttons`: the field's own placeholder, while it is edited."
3924
+ },
3925
+ {
3926
+ "name": "required",
3927
+ "takes": "true/false",
3928
+ "required": false,
3929
+ "note": "`buttons`: an empty value cannot be saved, as a name cannot."
3930
+ },
3931
+ {
3932
+ "name": "clean",
3933
+ "takes": "a handler",
3934
+ "required": false,
3935
+ "note": "`buttons`: what a draft becomes before it is compared and saved — one line, say."
3936
+ },
3937
+ {
3938
+ "name": "draftNote",
3939
+ "takes": "a handler",
3940
+ "required": false,
3941
+ "note": "`buttons`: said between the field and its buttons as it is typed — a count past a limit."
3942
+ },
3943
+ {
3944
+ "name": "defaultEditing",
3945
+ "takes": "true/false",
3946
+ "required": false,
3947
+ "note": "`buttons`: opens as the field, holding the value — a menu's Rename."
3948
+ }
3949
+ ],
3950
+ "variants": [
3951
+ {
3952
+ "prop": "manner",
3953
+ "values": [
3954
+ "inline",
3955
+ "buttons"
3956
+ ]
3957
+ }
3958
+ ],
3959
+ "ownsBehaviours": [
3960
+ {
3961
+ "id": "base-ui",
3962
+ "behaviour": "Is built on Base UI"
3963
+ }
3964
+ ],
3965
+ "status": "stable",
3966
+ "migrationStage": null,
3967
+ "docsId": "forms-fields-editabletext--docs",
3968
+ "storyId": "forms-fields-editabletext--title",
3969
+ "docPage": "src/EditableText.mdx",
3970
+ "app": null,
3971
+ "looks": []
3972
+ },
3973
+ {
3974
+ "name": "EditedMarker",
3975
+ "repo": "estiva-ui",
3976
+ "kind": "component",
3630
3977
  "importPath": "@estiva-app/ui",
3631
3978
  "sourceFile": "src/EditedMarker.tsx",
3632
3979
  "purpose": "\"(edited)\" beside a time, with when it was edited on hover.",
@@ -3746,7 +4093,7 @@
3746
4093
  "kind": "component",
3747
4094
  "importPath": "@estiva-app/ui",
3748
4095
  "sourceFile": "src/EmptyState.tsx",
3749
- "purpose": "The place where content will be once there is some, in two manners: a 16px icon over a centred line when the whole page is empty, the line alone and left-aligned when one section of a page is.",
4096
+ "purpose": "The place where content will be once there is some, in three manners: a 16px icon over a centred line when the whole page is empty, the line alone and left-aligned when one section of a page is, and that line in a row's inset in place of a sidebar's rows.",
3750
4097
  "purposeFrom": "page",
3751
4098
  "props": [
3752
4099
  {
@@ -3763,9 +4110,9 @@
3763
4110
  },
3764
4111
  {
3765
4112
  "name": "scope",
3766
- "takes": "page | section",
4113
+ "takes": "page | section | rows",
3767
4114
  "required": false,
3768
- "note": "`page` when the whole page is empty; `section` when one part of it is."
4115
+ "note": "`page` when the whole page is empty; `section` when one part of it is; `rows` in place of rows that pad themselves, a sidebar's."
3769
4116
  },
3770
4117
  {
3771
4118
  "name": "action",
@@ -3785,7 +4132,8 @@
3785
4132
  "prop": "scope",
3786
4133
  "values": [
3787
4134
  "page",
3788
- "section"
4135
+ "section",
4136
+ "rows"
3789
4137
  ]
3790
4138
  }
3791
4139
  ],
@@ -3823,6 +4171,7 @@
3823
4171
  "docPage": null,
3824
4172
  "app": null,
3825
4173
  "looks": [
4174
+ "cursor-pointer rounded-lg text-left outline-none",
3826
4175
  "text-menu signal:font-mono signal:text-small signal:tracking-wider leaf:font-mono leaf:text-small leaf:tracking-wider"
3827
4176
  ]
3828
4177
  },
@@ -4236,6 +4585,103 @@
4236
4585
  "app": null,
4237
4586
  "looks": []
4238
4587
  },
4588
+ {
4589
+ "name": "FormDialog",
4590
+ "repo": "estiva-ui",
4591
+ "kind": "component",
4592
+ "importPath": "@estiva-app/ui",
4593
+ "sourceFile": "src/FormDialog.tsx",
4594
+ "purpose": "A dialog that sends a form: the words and fields you give it, then Cancel and the button that sends it, waiting together while it sends.",
4595
+ "purposeFrom": "page",
4596
+ "props": [
4597
+ {
4598
+ "name": "title",
4599
+ "takes": "text",
4600
+ "required": true,
4601
+ "note": "The dialog's heading."
4602
+ },
4603
+ {
4604
+ "name": "submitLabel",
4605
+ "takes": "text",
4606
+ "required": true,
4607
+ "note": "The words on the button that sends the form: \"Move\", \"Create\"."
4608
+ },
4609
+ {
4610
+ "name": "busyLabel",
4611
+ "takes": "text",
4612
+ "required": false,
4613
+ "note": "Its words while the form sends — \"Moving…\"."
4614
+ },
4615
+ {
4616
+ "name": "submitVariant",
4617
+ "takes": "primary | resolve",
4618
+ "required": false,
4619
+ "note": "How the sending button looks: `primary`, or `resolve` for a Resolve."
4620
+ },
4621
+ {
4622
+ "name": "ready",
4623
+ "takes": "true/false",
4624
+ "required": false,
4625
+ "note": "Whether there is enough to send. While it is not, the button is greyed and Enter sends nothing."
4626
+ },
4627
+ {
4628
+ "name": "onSubmit",
4629
+ "takes": "a handler",
4630
+ "required": true,
4631
+ "note": "Sends the form. Answer `false` to keep the dialog open (you have said why); anything else closes it."
4632
+ },
4633
+ {
4634
+ "name": "onClose",
4635
+ "takes": "a handler",
4636
+ "required": true,
4637
+ "note": "Cancel, Escape, the ✕, a press outside, and a send that went through: once, when it was closed while it sent."
4638
+ },
4639
+ {
4640
+ "name": "children",
4641
+ "takes": "anything",
4642
+ "required": true,
4643
+ "note": "What the form holds: the words before the fields, then the fields."
4644
+ }
4645
+ ],
4646
+ "variants": [
4647
+ {
4648
+ "prop": "submitVariant",
4649
+ "values": [
4650
+ "primary",
4651
+ "resolve"
4652
+ ]
4653
+ }
4654
+ ],
4655
+ "ownsBehaviours": [
4656
+ {
4657
+ "id": "portal",
4658
+ "behaviour": "Floats on top of the page"
4659
+ },
4660
+ {
4661
+ "id": "press-outside",
4662
+ "behaviour": "Closes on a press outside"
4663
+ },
4664
+ {
4665
+ "id": "page-keys",
4666
+ "behaviour": "Takes its keys by itself"
4667
+ },
4668
+ {
4669
+ "id": "focus",
4670
+ "behaviour": "Holds focus inside while open, and gives it back"
4671
+ },
4672
+ {
4673
+ "id": "scroll-lock",
4674
+ "behaviour": "Stops the page behind it scrolling"
4675
+ }
4676
+ ],
4677
+ "status": "stable",
4678
+ "migrationStage": null,
4679
+ "docsId": "menus-windows-formdialog--docs",
4680
+ "storyId": "menus-windows-formdialog--new-folder",
4681
+ "docPage": "src/FormDialog.mdx",
4682
+ "app": null,
4683
+ "looks": []
4684
+ },
4239
4685
  {
4240
4686
  "name": "hueFor",
4241
4687
  "repo": "estiva-ui",
@@ -4858,6 +5304,25 @@
4858
5304
  "app": null,
4859
5305
  "looks": []
4860
5306
  },
5307
+ {
5308
+ "name": "isPlainClick",
5309
+ "repo": "estiva-ui",
5310
+ "kind": "helper",
5311
+ "importPath": "@estiva-app/ui",
5312
+ "sourceFile": "src/AppProvider.tsx",
5313
+ "purpose": "Whether a click is a plain one, the browser's to follow in this tab: the main button, with no Ctrl, Cmd, Shift or Alt — what every link part checks before it keeps a click in the app.",
5314
+ "purposeFrom": "comment",
5315
+ "props": [],
5316
+ "variants": [],
5317
+ "ownsBehaviours": [],
5318
+ "status": "stable",
5319
+ "migrationStage": null,
5320
+ "docsId": "app-frame-appprovider--docs",
5321
+ "storyId": "app-frame-appprovider--pictures",
5322
+ "docPage": null,
5323
+ "app": null,
5324
+ "looks": []
5325
+ },
4861
5326
  {
4862
5327
  "name": "isReferenceMenuOpen",
4863
5328
  "repo": "estiva-ui",
@@ -6211,7 +6676,9 @@
6211
6676
  "storyId": "menus-windows-menu--items",
6212
6677
  "docPage": "src/Menu.mdx",
6213
6678
  "app": null,
6214
- "looks": []
6679
+ "looks": [
6680
+ "cursor-pointer rounded-lg text-left outline-none"
6681
+ ]
6215
6682
  },
6216
6683
  {
6217
6684
  "name": "MenuItem",
@@ -6293,6 +6760,12 @@
6293
6760
  "takes": "true/false",
6294
6761
  "required": false,
6295
6762
  "note": "The row the menu currently points at (a submenu's chosen value)."
6763
+ },
6764
+ {
6765
+ "name": "disabledReason",
6766
+ "takes": "text",
6767
+ "required": false,
6768
+ "note": "Why it cannot be chosen right now: the row is shown, shut, in the disabled colour, with no fill, and says why under the pointer and when the arrow keys reach it, as `Button`'s does."
6296
6769
  }
6297
6770
  ],
6298
6771
  "variants": [
@@ -6320,7 +6793,9 @@
6320
6793
  "storyId": "menus-windows-menuitem--default",
6321
6794
  "docPage": "src/MenuItem.mdx",
6322
6795
  "app": null,
6323
- "looks": []
6796
+ "looks": [
6797
+ "cursor-pointer rounded-lg text-left outline-none"
6798
+ ]
6324
6799
  },
6325
6800
  {
6326
6801
  "name": "MenuPanel",
@@ -6347,7 +6822,8 @@
6347
6822
  "docPage": null,
6348
6823
  "app": null,
6349
6824
  "looks": [
6350
- "rounded-lg border border-border-default bg-bg-elevated shadow-lg"
6825
+ "rounded-lg border border-border-default bg-bg-elevated shadow-lg",
6826
+ "cursor-pointer rounded-lg text-left outline-none"
6351
6827
  ]
6352
6828
  },
6353
6829
  {
@@ -6380,7 +6856,9 @@
6380
6856
  "storyId": "menus-windows-menu--items",
6381
6857
  "docPage": null,
6382
6858
  "app": null,
6383
- "looks": []
6859
+ "looks": [
6860
+ "cursor-pointer rounded-lg text-left outline-none"
6861
+ ]
6384
6862
  },
6385
6863
  {
6386
6864
  "name": "MenuSection",
@@ -6427,7 +6905,9 @@
6427
6905
  "storyId": "menus-windows-menu--items",
6428
6906
  "docPage": null,
6429
6907
  "app": null,
6430
- "looks": []
6908
+ "looks": [
6909
+ "cursor-pointer rounded-lg text-left outline-none"
6910
+ ]
6431
6911
  },
6432
6912
  {
6433
6913
  "name": "MenuSeparator",
@@ -6446,7 +6926,9 @@
6446
6926
  "storyId": "menus-windows-menu--items",
6447
6927
  "docPage": null,
6448
6928
  "app": null,
6449
- "looks": []
6929
+ "looks": [
6930
+ "cursor-pointer rounded-lg text-left outline-none"
6931
+ ]
6450
6932
  },
6451
6933
  {
6452
6934
  "name": "MenuSub",
@@ -6473,114 +6955,260 @@
6473
6955
  "name": "selected",
6474
6956
  "takes": "true/false",
6475
6957
  "required": false,
6476
- "note": "Mark the trigger row as holding a current value."
6958
+ "note": "Mark the trigger row as holding a current value."
6959
+ },
6960
+ {
6961
+ "name": "children",
6962
+ "takes": "anything",
6963
+ "required": true,
6964
+ "note": "The submenu's rows."
6965
+ },
6966
+ {
6967
+ "name": "className",
6968
+ "takes": "text",
6969
+ "required": false,
6970
+ "note": "On the submenu panel."
6971
+ }
6972
+ ],
6973
+ "variants": [],
6974
+ "ownsBehaviours": [
6975
+ {
6976
+ "id": "base-ui",
6977
+ "behaviour": "Is built on Base UI"
6978
+ },
6979
+ {
6980
+ "id": "role",
6981
+ "behaviour": "Says what it is to assistive technology"
6982
+ }
6983
+ ],
6984
+ "status": "stable",
6985
+ "migrationStage": null,
6986
+ "docsId": "menus-windows-menu--docs",
6987
+ "storyId": "menus-windows-menu--items",
6988
+ "docPage": null,
6989
+ "app": null,
6990
+ "looks": [
6991
+ "cursor-pointer rounded-lg text-left outline-none"
6992
+ ]
6993
+ },
6994
+ {
6995
+ "name": "MetaText",
6996
+ "repo": "estiva-ui",
6997
+ "kind": "component",
6998
+ "importPath": "@estiva-app/ui",
6999
+ "sourceFile": "src/MetaText.tsx",
7000
+ "purpose": "The small figure beside a name: a time, a resolve line's time, a count.",
7001
+ "purposeFrom": "page",
7002
+ "props": [
7003
+ {
7004
+ "name": "children",
7005
+ "takes": "anything",
7006
+ "required": true,
7007
+ "note": null
7008
+ },
7009
+ {
7010
+ "name": "tone",
7011
+ "takes": "keyof typeof TONE_CLASSES",
7012
+ "required": false,
7013
+ "note": "`muted` for a time; `secondary` and `success` for counts of open and resolved."
7014
+ },
7015
+ {
7016
+ "name": "size",
7017
+ "takes": "caption | chip",
7018
+ "required": false,
7019
+ "note": "`chip` beside a small name, as in a thread's resolve line."
7020
+ },
7021
+ {
7022
+ "name": "className",
7023
+ "takes": "text",
7024
+ "required": false,
7025
+ "note": "Placement only: `shrink-0`, `contents`."
7026
+ }
7027
+ ],
7028
+ "variants": [
7029
+ {
7030
+ "prop": "size",
7031
+ "values": [
7032
+ "caption",
7033
+ "chip"
7034
+ ]
7035
+ }
7036
+ ],
7037
+ "ownsBehaviours": [],
7038
+ "status": "stable",
7039
+ "migrationStage": null,
7040
+ "docsId": "conversation-metatext--docs",
7041
+ "storyId": "conversation-metatext--time",
7042
+ "docPage": "src/MetaText.mdx",
7043
+ "app": null,
7044
+ "looks": [
7045
+ "text-chip font-normal text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
7046
+ "text-chip font-normal text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
7047
+ "text-chip font-normal text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
7048
+ "text-caption text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
7049
+ "text-caption text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
7050
+ "text-caption text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums"
7051
+ ]
7052
+ },
7053
+ {
7054
+ "name": "moveBlock",
7055
+ "repo": "estiva-ui",
7056
+ "kind": "helper",
7057
+ "importPath": "@estiva-app/ui/editor",
7058
+ "sourceFile": "src/EditorBlockHandle.tsx",
7059
+ "purpose": "Moves the block at `from` to `to` (a position between top-level blocks), the caret in it: what a drop in the gutter does, where the editor has no drop of its own.",
7060
+ "purposeFrom": "comment",
7061
+ "props": [],
7062
+ "variants": [],
7063
+ "ownsBehaviours": [],
7064
+ "status": "stable",
7065
+ "migrationStage": null,
7066
+ "docsId": "writing-editorblockhandle--docs",
7067
+ "storyId": "writing-editorblockhandle--default",
7068
+ "docPage": null,
7069
+ "app": null,
7070
+ "looks": []
7071
+ },
7072
+ {
7073
+ "name": "MoveDialog",
7074
+ "repo": "estiva-ui",
7075
+ "kind": "component",
7076
+ "importPath": "@estiva-app/ui",
7077
+ "sourceFile": "src/MoveDialog.tsx",
7078
+ "purpose": "Move a file to another Folder, under another file there, or both: the Folder first, then what it goes under, read when the Folder is picked.",
7079
+ "purposeFrom": "page",
7080
+ "props": [
7081
+ {
7082
+ "name": "title",
7083
+ "takes": "text",
7084
+ "required": true,
7085
+ "note": "The file's name, said above the choice."
7086
+ },
7087
+ {
7088
+ "name": "description",
7089
+ "takes": "text",
7090
+ "required": true,
7091
+ "note": "The sentence under the name, in the app's words: \"Everyone who can read it now still can.\""
7092
+ },
7093
+ {
7094
+ "name": "from",
7095
+ "takes": "text",
7096
+ "required": true,
7097
+ "note": "The Folder it is in now, not offered to a file that nests under nothing."
7098
+ },
7099
+ {
7100
+ "name": "folders",
7101
+ "takes": "readonly MoveFolder[] | undefined",
7102
+ "required": true,
7103
+ "note": "The Folders it may go to. Undefined while they are still read: the list says \"Reading…\"."
7104
+ },
7105
+ {
7106
+ "name": "places",
7107
+ "takes": "readonly MovePlace[]",
7108
+ "required": false,
7109
+ "note": "Where it may go in `from`, already read."
7110
+ },
7111
+ {
7112
+ "name": "placesIn",
7113
+ "takes": "a handler",
7114
+ "required": false,
7115
+ "note": "Where it may go in another Folder, read when that Folder is picked; a rejection is said beside a Try again."
7116
+ },
7117
+ {
7118
+ "name": "startAtTop",
7119
+ "takes": "true/false",
7120
+ "required": false,
7121
+ "note": "Choose the top for the person when a Folder offers it: where a file that may sit at any Folder's top lands."
7122
+ },
7123
+ {
7124
+ "name": "topLabel",
7125
+ "takes": "text",
7126
+ "required": false,
7127
+ "note": "What the place with an empty `id` says. \"The top of\" the Folder when absent; \"None — under none of these\" for a file whose parent is one kind."
7128
+ },
7129
+ {
7130
+ "name": "startIn",
7131
+ "takes": "text",
7132
+ "required": false,
7133
+ "note": "The Folder it opens on, when that is not the one it is in."
7134
+ },
7135
+ {
7136
+ "name": "heading",
7137
+ "takes": "text",
7138
+ "required": false,
7139
+ "note": "The dialog's heading. \"Move\" when absent."
7140
+ },
7141
+ {
7142
+ "name": "folderLabel",
7143
+ "takes": "text",
7144
+ "required": false,
7145
+ "note": "The Folder field's label. \"Folder\" when absent."
7146
+ },
7147
+ {
7148
+ "name": "noFolder",
7149
+ "takes": "text",
7150
+ "required": false,
7151
+ "note": "Said when no Folder is offered. \"There is no other folder it can be moved to.\" when absent."
6477
7152
  },
6478
7153
  {
6479
- "name": "children",
6480
- "takes": "anything",
7154
+ "name": "onMove",
7155
+ "takes": "a handler",
6481
7156
  "required": true,
6482
- "note": "The submenu's rows."
7157
+ "note": "Answer `false` to keep the dialog open (you have said why); anything else closes it."
6483
7158
  },
6484
7159
  {
6485
- "name": "className",
6486
- "takes": "text",
6487
- "required": false,
6488
- "note": "On the submenu panel."
7160
+ "name": "onClose",
7161
+ "takes": "a handler",
7162
+ "required": true,
7163
+ "note": null
6489
7164
  }
6490
7165
  ],
6491
7166
  "variants": [],
6492
7167
  "ownsBehaviours": [
6493
7168
  {
6494
- "id": "base-ui",
6495
- "behaviour": "Is built on Base UI"
7169
+ "id": "portal",
7170
+ "behaviour": "Floats on top of the page"
6496
7171
  },
6497
7172
  {
6498
- "id": "role",
6499
- "behaviour": "Says what it is to assistive technology"
6500
- }
6501
- ],
6502
- "status": "stable",
6503
- "migrationStage": null,
6504
- "docsId": "menus-windows-menu--docs",
6505
- "storyId": "menus-windows-menu--items",
6506
- "docPage": null,
6507
- "app": null,
6508
- "looks": []
6509
- },
6510
- {
6511
- "name": "MetaText",
6512
- "repo": "estiva-ui",
6513
- "kind": "component",
6514
- "importPath": "@estiva-app/ui",
6515
- "sourceFile": "src/MetaText.tsx",
6516
- "purpose": "The small figure beside a name: a time, a resolve line's time, a count.",
6517
- "purposeFrom": "page",
6518
- "props": [
6519
- {
6520
- "name": "children",
6521
- "takes": "anything",
6522
- "required": true,
6523
- "note": null
7173
+ "id": "press-outside",
7174
+ "behaviour": "Closes on a press outside"
6524
7175
  },
6525
7176
  {
6526
- "name": "tone",
6527
- "takes": "keyof typeof TONE_CLASSES",
6528
- "required": false,
6529
- "note": "`muted` for a time; `secondary` and `success` for counts of open and resolved."
7177
+ "id": "page-keys",
7178
+ "behaviour": "Takes its keys by itself"
6530
7179
  },
6531
7180
  {
6532
- "name": "size",
6533
- "takes": "caption | chip",
6534
- "required": false,
6535
- "note": "`chip` beside a small name, as in a thread's resolve line."
7181
+ "id": "focus",
7182
+ "behaviour": "Holds focus inside while open, and gives it back"
6536
7183
  },
6537
7184
  {
6538
- "name": "className",
6539
- "takes": "text",
6540
- "required": false,
6541
- "note": "Placement only: `shrink-0`, `contents`."
6542
- }
6543
- ],
6544
- "variants": [
6545
- {
6546
- "prop": "size",
6547
- "values": [
6548
- "caption",
6549
- "chip"
6550
- ]
7185
+ "id": "scroll-lock",
7186
+ "behaviour": "Stops the page behind it scrolling"
6551
7187
  }
6552
7188
  ],
6553
- "ownsBehaviours": [],
6554
7189
  "status": "stable",
6555
7190
  "migrationStage": null,
6556
- "docsId": "conversation-metatext--docs",
6557
- "storyId": "conversation-metatext--time",
6558
- "docPage": "src/MetaText.mdx",
7191
+ "docsId": "menus-windows-movedialog--docs",
7192
+ "storyId": "menus-windows-movedialog--topic",
7193
+ "docPage": "src/MoveDialog.mdx",
6559
7194
  "app": null,
6560
- "looks": [
6561
- "text-chip font-normal text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
6562
- "text-chip font-normal text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
6563
- "text-chip font-normal text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
6564
- "text-caption text-text-muted whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
6565
- "text-caption text-text-secondary whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums",
6566
- "text-caption text-success-default whitespace-nowrap signal:font-mono signal:text-small signal:tracking-wide signal:tabular-nums"
6567
- ]
7195
+ "looks": []
6568
7196
  },
6569
7197
  {
6570
- "name": "moveBlock",
7198
+ "name": "NAV_TREE_PENDING_MS",
6571
7199
  "repo": "estiva-ui",
6572
7200
  "kind": "helper",
6573
- "importPath": "@estiva-app/ui/editor",
6574
- "sourceFile": "src/EditorBlockHandle.tsx",
6575
- "purpose": "Moves the block at `from` to `to` (a position between top-level blocks), the caret in it: what a drop in the gutter does, where the editor has no drop of its own.",
7201
+ "importPath": "@estiva-app/ui",
7202
+ "sourceFile": "src/NavTree.tsx",
7203
+ "purpose": "How long a `pending` group waits shut for its rows before it opens on the skeleton (Peek's Folders, OPT-11: a cold read is ~0.9s).",
6576
7204
  "purposeFrom": "comment",
6577
7205
  "props": [],
6578
7206
  "variants": [],
6579
7207
  "ownsBehaviours": [],
6580
7208
  "status": "stable",
6581
7209
  "migrationStage": null,
6582
- "docsId": "writing-editorblockhandle--docs",
6583
- "storyId": "writing-editorblockhandle--default",
7210
+ "docsId": "app-frame-navtree--docs",
7211
+ "storyId": "app-frame-navtree--default",
6584
7212
  "docPage": null,
6585
7213
  "app": null,
6586
7214
  "looks": []
@@ -6702,6 +7330,12 @@
6702
7330
  "required": false,
6703
7331
  "note": "With `children`: the current item, when it sits under this row."
6704
7332
  },
7333
+ {
7334
+ "name": "onPlainClick",
7335
+ "takes": "a handler",
7336
+ "required": false,
7337
+ "note": "A plain click on the row — the main button, no Ctrl, Cmd, Shift or Alt, to this app's own address: the app opens it its own way, with what it knows, in place of following the link (the row prevents it, and `navigate` is not called)."
7338
+ },
6705
7339
  {
6706
7340
  "name": "className",
6707
7341
  "takes": "text",
@@ -6776,6 +7410,12 @@
6776
7410
  "required": false,
6777
7411
  "note": "The row the current one sits under, while the tree does not draw the current one: its rows are not read yet, or it is not a row here."
6778
7412
  },
7413
+ {
7414
+ "name": "selectedGroup",
7415
+ "takes": "text",
7416
+ "required": false,
7417
+ "note": "The group a link led to — a folder's own link: each time it names a new group, the group opens, as `selected` opens a row's — closed by hand too, once — and is remembered open as a click would be, open already or not, so it stays open when the reader goes on to a row in another group; and the column scrolls to it at once."
7418
+ },
6779
7419
  {
6780
7420
  "name": "onSelect",
6781
7421
  "takes": "a handler",
@@ -6824,7 +7464,7 @@
6824
7464
  "name": "id",
6825
7465
  "takes": "text",
6826
7466
  "required": false,
6827
- "note": "Marks the group's box as `data-nav-group`, for tests and photo runs to find it."
7467
+ "note": "Marks the group's box as `data-nav-group`: the tree finds it by it for `selectedGroup` (opens it, remembers it open, scrolls to it), and tests and photo runs do."
6828
7468
  },
6829
7469
  {
6830
7470
  "name": "message",
@@ -7470,6 +8110,12 @@
7470
8110
  "required": true,
7471
8111
  "note": "When it was written, in the app's words, with its day: no day line stands above it here."
7472
8112
  },
8113
+ {
8114
+ "name": "at",
8115
+ "takes": "number",
8116
+ "required": false,
8117
+ "note": "When it was written, as a moment (ms since 1970): the time then says the exact date and time under the pointer, as a comment's does."
8118
+ },
7473
8119
  {
7474
8120
  "name": "words",
7475
8121
  "takes": "anything",
@@ -8161,6 +8807,12 @@
8161
8807
  "takes": "text",
8162
8808
  "required": false,
8163
8809
  "note": "What the app calls what is said, in the plural: \"messages\" in Peek."
8810
+ },
8811
+ {
8812
+ "name": "keepRoom",
8813
+ "takes": "true/false",
8814
+ "required": false,
8815
+ "note": "Older comments are still being read and the whole read will need the line: its room is kept, unseen, so nothing moves when it lands."
8164
8816
  }
8165
8817
  ],
8166
8818
  "variants": [],
@@ -8533,7 +9185,7 @@
8533
9185
  "kind": "component",
8534
9186
  "importPath": "@estiva-app/ui",
8535
9187
  "sourceFile": "src/RepliesRow.tsx",
8536
- "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.",
9188
+ "purpose": "The way into a thread, under its comment: who replied, \"2 replies\", the last reply's time, and how many are new (\"2 new\") until they are read.",
8537
9189
  "purposeFrom": "page",
8538
9190
  "props": [
8539
9191
  {
@@ -8560,6 +9212,12 @@
8560
9212
  "required": false,
8561
9213
  "note": "\"1 new\": a reply you have not read."
8562
9214
  },
9215
+ {
9216
+ "name": "newCount",
9217
+ "takes": "number",
9218
+ "required": false,
9219
+ "note": "How many replies you have not read: \"2 new\", and the row's name says it too."
9220
+ },
8563
9221
  {
8564
9222
  "name": "urgent",
8565
9223
  "takes": "true/false",
@@ -8603,6 +9261,18 @@
8603
9261
  "purpose": "One reply in a thread: the same pieces as a comment, without replies of its own or Resolve.",
8604
9262
  "purposeFrom": "page",
8605
9263
  "props": [
9264
+ {
9265
+ "name": "id",
9266
+ "takes": "text",
9267
+ "required": false,
9268
+ "note": "Its id, on the card as `data-reply-id`: what a link to it shows (`showInConversation`), and what `Thread` watches to say it was seen."
9269
+ },
9270
+ {
9271
+ "name": "noun",
9272
+ "takes": "text",
9273
+ "required": false,
9274
+ "note": "What the reply is called in the delete question: \"Delete this reply?\" by default; Ship's `message`."
9275
+ },
8606
9276
  {
8607
9277
  "name": "author",
8608
9278
  "takes": "ConversationPerson",
@@ -8615,6 +9285,12 @@
8615
9285
  "required": true,
8616
9286
  "note": "When it was written, in the app's words (\"11:08 AM\")."
8617
9287
  },
9288
+ {
9289
+ "name": "at",
9290
+ "takes": "number",
9291
+ "required": false,
9292
+ "note": "When it was written, as a moment (ms since 1970): the time then says the exact date and time under the pointer."
9293
+ },
8618
9294
  {
8619
9295
  "name": "timeHref",
8620
9296
  "takes": "text",
@@ -8741,6 +9417,18 @@
8741
9417
  "required": false,
8742
9418
  "note": "Edit's words in the ⋯ menu: \"Edit\" by default; Peek's \"Edit message\"."
8743
9419
  },
9420
+ {
9421
+ "name": "deleteLabel",
9422
+ "takes": "text",
9423
+ "required": false,
9424
+ "note": "Delete's words in the ⋯ menu: \"Delete\" by default; Ship's \"Delete message\"."
9425
+ },
9426
+ {
9427
+ "name": "moreLabel",
9428
+ "takes": "text",
9429
+ "required": false,
9430
+ "note": "The ⋯ button's name and tooltip: \"More actions\" by default; Ship's \"Message actions\"."
9431
+ },
8744
9432
  {
8745
9433
  "name": "className",
8746
9434
  "takes": "text",
@@ -8777,7 +9465,7 @@
8777
9465
  "name": "onCancel",
8778
9466
  "takes": "a handler",
8779
9467
  "required": true,
8780
- "note": null
9468
+ "note": "Cancel, Escape, the ✕ — and a resolve that was not refused, which closes it."
8781
9469
  },
8782
9470
  {
8783
9471
  "name": "refused",
@@ -9471,6 +10159,25 @@
9471
10159
  "app": null,
9472
10160
  "looks": []
9473
10161
  },
10162
+ {
10163
+ "name": "sendsInLayout",
10164
+ "repo": "estiva-ui",
10165
+ "kind": "helper",
10166
+ "importPath": "@estiva-app/ui",
10167
+ "sourceFile": "src/conversationScroll.ts",
10168
+ "purpose": "Set by ConversationLayout round its own box, read by CommentBox: the reader's own comment brings them down to it as it is drawn, before the relay has answered (Peek's OPT-6), and a refusal leaves where they actually are to decide.",
10169
+ "purposeFrom": "comment",
10170
+ "props": [],
10171
+ "variants": [],
10172
+ "ownsBehaviours": [],
10173
+ "status": "stable",
10174
+ "migrationStage": null,
10175
+ "docsId": null,
10176
+ "storyId": null,
10177
+ "docPage": null,
10178
+ "app": null,
10179
+ "looks": []
10180
+ },
9474
10181
  {
9475
10182
  "name": "setCommentAnchors",
9476
10183
  "repo": "estiva-ui",
@@ -9547,6 +10254,44 @@
9547
10254
  "app": null,
9548
10255
  "looks": []
9549
10256
  },
10257
+ {
10258
+ "name": "showInConversation",
10259
+ "repo": "estiva-ui",
10260
+ "kind": "helper",
10261
+ "importPath": "@estiva-app/ui",
10262
+ "sourceFile": "src/showInConversation.ts",
10263
+ "purpose": "Scrolls a comment or reply drawn by the kit into the middle of the view and flashes it.",
10264
+ "purposeFrom": "comment",
10265
+ "props": [],
10266
+ "variants": [],
10267
+ "ownsBehaviours": [],
10268
+ "status": "stable",
10269
+ "migrationStage": null,
10270
+ "docsId": null,
10271
+ "storyId": null,
10272
+ "docPage": null,
10273
+ "app": null,
10274
+ "looks": []
10275
+ },
10276
+ {
10277
+ "name": "showInConversationWhenDrawn",
10278
+ "repo": "estiva-ui",
10279
+ "kind": "helper",
10280
+ "importPath": "@estiva-app/ui",
10281
+ "sourceFile": "src/showInConversation.ts",
10282
+ "purpose": "The same, for one that may not be drawn yet: its thread was just asked to open, and the page draws it a moment later.",
10283
+ "purposeFrom": "comment",
10284
+ "props": [],
10285
+ "variants": [],
10286
+ "ownsBehaviours": [],
10287
+ "status": "stable",
10288
+ "migrationStage": null,
10289
+ "docsId": null,
10290
+ "storyId": null,
10291
+ "docPage": null,
10292
+ "app": null,
10293
+ "looks": []
10294
+ },
9550
10295
  {
9551
10296
  "name": "ShowMore",
9552
10297
  "repo": "estiva-ui",
@@ -10245,7 +10990,7 @@
10245
10990
  "name": "children",
10246
10991
  "takes": "anything",
10247
10992
  "required": false,
10248
- "note": "Its replies, in time order: `ReplyCard`s."
10993
+ "note": "Its replies, in time order: `ReplyCard`s, each keyed by its own id."
10249
10994
  },
10250
10995
  {
10251
10996
  "name": "loading",
@@ -10305,7 +11050,13 @@
10305
11050
  "name": "bodyRef",
10306
11051
  "takes": "Ref<HTMLDivElement>",
10307
11052
  "required": false,
10308
- "note": "The column's scrolling box, for opening at the newest reply."
11053
+ "note": "Beside: the column's scrolling box. Where it scrolls is the thread's: it opens at the newest reply and goes to each new one."
11054
+ },
11055
+ {
11056
+ "name": "seen",
11057
+ "takes": "SeenOnScreen",
11058
+ "required": false,
11059
+ "note": "What `useSeenOnScreen` made for this thread: it watches its replies (each `ReplyCard`'s `id`), beside or under its comment, and says in it which were seen."
10309
11060
  },
10310
11061
  {
10311
11062
  "name": "className",
@@ -11283,6 +12034,82 @@
11283
12034
  "app": null,
11284
12035
  "looks": []
11285
12036
  },
12037
+ {
12038
+ "name": "useFormBusy",
12039
+ "repo": "estiva-ui",
12040
+ "kind": "hook",
12041
+ "importPath": "@estiva-app/ui",
12042
+ "sourceFile": "src/formBusy.ts",
12043
+ "purpose": "Whether a `Form` around this is sending: its fields and buttons wait.",
12044
+ "purposeFrom": "comment",
12045
+ "props": [],
12046
+ "variants": [],
12047
+ "ownsBehaviours": [],
12048
+ "status": "stable",
12049
+ "migrationStage": null,
12050
+ "docsId": null,
12051
+ "storyId": null,
12052
+ "docPage": null,
12053
+ "app": null,
12054
+ "looks": []
12055
+ },
12056
+ {
12057
+ "name": "useLeftAt",
12058
+ "repo": "estiva-ui",
12059
+ "kind": "hook",
12060
+ "importPath": "@estiva-app/ui",
12061
+ "sourceFile": "src/conversationScroll.ts",
12062
+ "purpose": "When the reader last left the conversation `key` (a `ConversationLayout`'s `rememberAs`) away from its newest comment, in ms since 1970: what an app draws its \"New\" line from, over the first comment written since.",
12063
+ "purposeFrom": "comment",
12064
+ "props": [],
12065
+ "variants": [],
12066
+ "ownsBehaviours": [],
12067
+ "status": "stable",
12068
+ "migrationStage": null,
12069
+ "docsId": null,
12070
+ "storyId": null,
12071
+ "docPage": null,
12072
+ "app": null,
12073
+ "looks": []
12074
+ },
12075
+ {
12076
+ "name": "useRememberedOpen",
12077
+ "repo": "estiva-ui",
12078
+ "kind": "hook",
12079
+ "importPath": "@estiva-app/ui",
12080
+ "sourceFile": "src/CollapsibleSection.tsx",
12081
+ "purpose": "Open or closed as this browser remembers it under `storageKey`, else `fallback`, for an app that must know before it draws what is inside — a fold whose rows are read only once it is open (Peek's Folders, FOL-21).",
12082
+ "purposeFrom": "comment",
12083
+ "props": [],
12084
+ "variants": [],
12085
+ "ownsBehaviours": [],
12086
+ "status": "stable",
12087
+ "migrationStage": null,
12088
+ "docsId": "page-structure-collapsiblesection--docs",
12089
+ "storyId": "page-structure-collapsiblesection--default",
12090
+ "docPage": null,
12091
+ "app": null,
12092
+ "looks": []
12093
+ },
12094
+ {
12095
+ "name": "useSeenOnScreen",
12096
+ "repo": "estiva-ui",
12097
+ "kind": "hook",
12098
+ "importPath": "@estiva-app/ui",
12099
+ "sourceFile": "src/seenOnScreen.ts",
12100
+ "purpose": "The comments or replies that have been on screen for a moment: what reads them (Katerina, 30 October).",
12101
+ "purposeFrom": "comment",
12102
+ "props": [],
12103
+ "variants": [],
12104
+ "ownsBehaviours": [],
12105
+ "status": "stable",
12106
+ "migrationStage": null,
12107
+ "docsId": null,
12108
+ "storyId": null,
12109
+ "docPage": null,
12110
+ "app": null,
12111
+ "looks": []
12112
+ },
11286
12113
  {
11287
12114
  "name": "useSidebarFold",
11288
12115
  "repo": "estiva-ui",