openproject-primer_view_components 0.70.5 → 0.72.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 (142) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +20 -0
  3. data/app/assets/javascripts/components/primer/alpha/segmented_control.d.ts +2 -2
  4. data/app/assets/javascripts/components/primer/{open_project → alpha}/tree_view/tree_view.d.ts +11 -1
  5. data/app/assets/javascripts/components/primer/{open_project → alpha}/tree_view/tree_view_sub_tree_node_element.d.ts +5 -1
  6. data/app/assets/javascripts/components/primer/open_project/filterable_tree_view.d.ts +29 -0
  7. data/app/assets/javascripts/components/primer/primer.d.ts +5 -4
  8. data/app/assets/javascripts/primer_view_components.js +1 -1
  9. data/app/assets/javascripts/primer_view_components.js.map +1 -1
  10. data/app/assets/styles/primer_view_components.css +1 -1
  11. data/app/assets/styles/primer_view_components.css.map +1 -1
  12. data/app/components/primer/{open_project → alpha}/file_tree_view/directory_node.rb +1 -1
  13. data/app/components/primer/{open_project → alpha}/file_tree_view/file_node.rb +1 -1
  14. data/app/components/primer/{open_project → alpha}/file_tree_view.rb +1 -1
  15. data/app/components/primer/alpha/segmented_control.d.ts +2 -2
  16. data/app/components/primer/alpha/segmented_control.js +12 -0
  17. data/app/components/primer/alpha/segmented_control.ts +16 -1
  18. data/app/components/primer/{open_project → alpha}/skeleton_box.css.json +1 -1
  19. data/app/components/primer/{open_project → alpha}/skeleton_box.css.map +1 -1
  20. data/app/components/primer/{open_project → alpha}/skeleton_box.pcss +1 -1
  21. data/app/components/primer/{open_project → alpha}/skeleton_box.rb +3 -1
  22. data/app/components/primer/alpha/stack.css +1 -1
  23. data/app/components/primer/alpha/stack.css.json +5 -1
  24. data/app/components/primer/alpha/stack.css.map +1 -1
  25. data/app/components/primer/alpha/stack.pcss +13 -0
  26. data/app/components/primer/alpha/stack.rb +2 -1
  27. data/app/components/primer/{open_project → alpha}/tree_view/icon.rb +2 -2
  28. data/app/components/primer/{open_project → alpha}/tree_view/icon_pair.rb +4 -4
  29. data/app/components/primer/{open_project → alpha}/tree_view/leading_action.rb +2 -2
  30. data/app/components/primer/{open_project → alpha}/tree_view/leaf_node.rb +6 -6
  31. data/app/components/primer/{open_project → alpha}/tree_view/loading_failure_message.rb +2 -2
  32. data/app/components/primer/{open_project → alpha}/tree_view/node.rb +30 -14
  33. data/app/components/primer/{open_project → alpha}/tree_view/skeleton_loader.html.erb +3 -3
  34. data/app/components/primer/{open_project → alpha}/tree_view/skeleton_loader.rb +4 -4
  35. data/app/components/primer/{open_project → alpha}/tree_view/spinner_loader.html.erb +2 -2
  36. data/app/components/primer/{open_project → alpha}/tree_view/spinner_loader.rb +4 -4
  37. data/app/components/primer/{open_project → alpha}/tree_view/sub_tree.html.erb +1 -1
  38. data/app/components/primer/{open_project → alpha}/tree_view/sub_tree.rb +10 -10
  39. data/app/components/primer/{open_project → alpha}/tree_view/sub_tree_container.rb +2 -2
  40. data/app/components/primer/{open_project → alpha}/tree_view/sub_tree_node.rb +28 -18
  41. data/app/components/primer/{open_project → alpha}/tree_view/tree_view.d.ts +11 -1
  42. data/app/components/primer/{open_project → alpha}/tree_view/tree_view.js +120 -20
  43. data/app/components/primer/{open_project → alpha}/tree_view/tree_view.ts +137 -18
  44. data/app/components/primer/{open_project → alpha}/tree_view/tree_view_include_fragment_element.js +0 -1
  45. data/app/components/primer/{open_project → alpha}/tree_view/tree_view_include_fragment_element.ts +0 -1
  46. data/app/components/primer/{open_project → alpha}/tree_view/tree_view_sub_tree_node_element.d.ts +5 -1
  47. data/app/components/primer/{open_project → alpha}/tree_view/tree_view_sub_tree_node_element.js +27 -4
  48. data/app/components/primer/{open_project → alpha}/tree_view/tree_view_sub_tree_node_element.ts +36 -5
  49. data/app/components/primer/{open_project → alpha}/tree_view/visual.rb +2 -2
  50. data/app/components/primer/alpha/tree_view.css +1 -0
  51. data/app/components/primer/{open_project → alpha}/tree_view.css.json +8 -1
  52. data/app/components/primer/alpha/tree_view.css.map +1 -0
  53. data/app/components/primer/alpha/tree_view.html.erb +12 -0
  54. data/app/components/primer/{open_project → alpha}/tree_view.pcss +39 -0
  55. data/app/components/primer/{open_project → alpha}/tree_view.rb +20 -12
  56. data/app/components/primer/beta/breadcrumbs.css +1 -1
  57. data/app/components/primer/beta/breadcrumbs.css.json +0 -1
  58. data/app/components/primer/beta/breadcrumbs.css.map +1 -1
  59. data/app/components/primer/beta/breadcrumbs.pcss +2 -8
  60. data/app/components/primer/beta/progress_bar.css +1 -1
  61. data/app/components/primer/beta/progress_bar.css.map +1 -1
  62. data/app/components/primer/beta/progress_bar.pcss +3 -2
  63. data/app/components/primer/beta/relative_time.rb +3 -0
  64. data/app/components/primer/open_project/filterable_tree_view/sub_tree.rb +39 -0
  65. data/app/components/primer/open_project/filterable_tree_view.d.ts +29 -0
  66. data/app/components/primer/open_project/filterable_tree_view.html.erb +28 -0
  67. data/app/components/primer/open_project/filterable_tree_view.js +409 -0
  68. data/app/components/primer/open_project/filterable_tree_view.rb +254 -0
  69. data/app/components/primer/open_project/filterable_tree_view.ts +492 -0
  70. data/app/components/primer/primer.d.ts +5 -4
  71. data/app/components/primer/primer.js +5 -4
  72. data/app/components/primer/primer.pcss +2 -2
  73. data/app/components/primer/primer.ts +5 -4
  74. data/app/controllers/primer/view_components/tree_view_items_controller.rb +1 -1
  75. data/app/forms/check_box_with_nested_form.rb +10 -10
  76. data/app/forms/radio_button_with_nested_form.rb +16 -16
  77. data/app/lib/primer/experimental_slot_helpers.rb +2 -2
  78. data/app/lib/primer/forms/base_component.rb +1 -1
  79. data/app/lib/primer/forms/dsl/text_field_input.rb +2 -0
  80. data/app/views/primer/view_components/tree_view_items/async_alpha.html_fragment.erb +1 -1
  81. data/app/views/primer/view_components/tree_view_items/index.html_fragment.erb +1 -1
  82. data/config/locales/en.yml +20 -0
  83. data/lib/primer/view_components/version.rb +2 -2
  84. data/previews/primer/{open_project → alpha}/file_tree_view_preview/default.html.erb +1 -1
  85. data/previews/primer/{open_project → alpha}/file_tree_view_preview/playground.html.erb +1 -1
  86. data/previews/primer/{open_project → alpha}/file_tree_view_preview.rb +1 -1
  87. data/previews/primer/{open_project → alpha}/skeleton_box_preview.rb +3 -3
  88. data/previews/primer/{open_project → alpha}/tree_view_preview/async_alpha.html.erb +1 -1
  89. data/previews/primer/{open_project → alpha}/tree_view_preview/buttons.html.erb +5 -5
  90. data/previews/primer/{open_project → alpha}/tree_view_preview/default.html.erb +5 -5
  91. data/previews/primer/{open_project → alpha}/tree_view_preview/empty.html.erb +1 -1
  92. data/previews/primer/alpha/tree_view_preview/form_input.html.erb +14 -0
  93. data/previews/primer/{open_project → alpha}/tree_view_preview/leaf_node_playground.html.erb +2 -2
  94. data/previews/primer/{open_project → alpha}/tree_view_preview/links.html.erb +5 -5
  95. data/previews/primer/{open_project → alpha}/tree_view_preview/loading_failure.html.erb +1 -1
  96. data/previews/primer/{open_project → alpha}/tree_view_preview/loading_skeleton.html.erb +1 -1
  97. data/previews/primer/{open_project → alpha}/tree_view_preview/loading_spinner.html.erb +1 -1
  98. data/previews/primer/{open_project → alpha}/tree_view_preview/playground.html.erb +1 -1
  99. data/previews/primer/{open_project → alpha}/tree_view_preview.rb +34 -15
  100. data/previews/primer/open_project/filterable_tree_view_preview/_custom_select_js.html.erb +62 -0
  101. data/previews/primer/open_project/filterable_tree_view_preview/custom_checkbox_text.html.erb +26 -0
  102. data/previews/primer/open_project/filterable_tree_view_preview/custom_no_results_text.html.erb +28 -0
  103. data/previews/primer/open_project/filterable_tree_view_preview/custom_segmented_control.html.erb +31 -0
  104. data/previews/primer/open_project/filterable_tree_view_preview/default.html.erb +26 -0
  105. data/previews/primer/open_project/filterable_tree_view_preview/form_input.html.erb +32 -0
  106. data/previews/primer/open_project/filterable_tree_view_preview/playground.html.erb +26 -0
  107. data/previews/primer/open_project/filterable_tree_view_preview/stress_test.html.erb +28 -0
  108. data/previews/primer/open_project/filterable_tree_view_preview.rb +125 -0
  109. data/static/arguments.json +1685 -1581
  110. data/static/audited_at.json +19 -17
  111. data/static/classes.json +5 -5
  112. data/static/constants.json +137 -98
  113. data/static/info_arch.json +6396 -6146
  114. data/static/previews.json +120 -21
  115. data/static/statuses.json +19 -17
  116. metadata +102 -84
  117. data/app/components/primer/open_project/tree_view.css +0 -1
  118. data/app/components/primer/open_project/tree_view.css.map +0 -1
  119. data/app/components/primer/open_project/tree_view.html.erb +0 -7
  120. /data/app/assets/javascripts/components/primer/{open_project → alpha}/tree_view/tree_view_icon_pair_element.d.ts +0 -0
  121. /data/app/assets/javascripts/components/primer/{open_project → alpha}/tree_view/tree_view_include_fragment_element.d.ts +0 -0
  122. /data/app/assets/javascripts/components/primer/{open_project → alpha}/tree_view/tree_view_roving_tab_index.d.ts +0 -0
  123. /data/app/components/primer/{open_project → alpha}/file_tree_view/directory_node.html.erb +0 -0
  124. /data/app/components/primer/{open_project → alpha}/file_tree_view/file_node.html.erb +0 -0
  125. /data/app/components/primer/{open_project → alpha}/skeleton_box.css +0 -0
  126. /data/app/components/primer/{open_project → alpha}/skeleton_box.html.erb +0 -0
  127. /data/app/components/primer/{open_project → alpha}/tree_view/icon.html.erb +0 -0
  128. /data/app/components/primer/{open_project → alpha}/tree_view/icon_pair.html.erb +0 -0
  129. /data/app/components/primer/{open_project → alpha}/tree_view/leading_action.html.erb +0 -0
  130. /data/app/components/primer/{open_project → alpha}/tree_view/leaf_node.html.erb +0 -0
  131. /data/app/components/primer/{open_project → alpha}/tree_view/loading_failure_message.html.erb +0 -0
  132. /data/app/components/primer/{open_project → alpha}/tree_view/node.html.erb +0 -0
  133. /data/app/components/primer/{open_project → alpha}/tree_view/sub_tree_container.html.erb +0 -0
  134. /data/app/components/primer/{open_project → alpha}/tree_view/sub_tree_node.html.erb +0 -0
  135. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_icon_pair_element.d.ts +0 -0
  136. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_icon_pair_element.js +0 -0
  137. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_icon_pair_element.ts +0 -0
  138. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_include_fragment_element.d.ts +0 -0
  139. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_roving_tab_index.d.ts +0 -0
  140. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_roving_tab_index.js +0 -0
  141. /data/app/components/primer/{open_project → alpha}/tree_view/tree_view_roving_tab_index.ts +0 -0
  142. /data/app/components/primer/{open_project → alpha}/tree_view/visual.html.erb +0 -0
@@ -1248,6 +1248,52 @@
1248
1248
  "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dropdown/menu/item/default/",
1249
1249
  "parameters": []
1250
1250
  },
1251
+ {
1252
+ "component": "FileTreeView",
1253
+ "status": "alpha",
1254
+ "a11y_reviewed": false,
1255
+ "short_name": "FileTreeView",
1256
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/file_tree_view.rb",
1257
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/file_tree_view/default/",
1258
+ "parameters": [
1259
+ {
1260
+ "name": "node_variant",
1261
+ "type": "Symbol",
1262
+ "default": "`:div`",
1263
+ "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
1264
+ },
1265
+ {
1266
+ "name": "form_arguments",
1267
+ "type": "Hash",
1268
+ "default": "`{}`",
1269
+ "description": "These arguments allow the selections made within a `TreeView` to be submitted to the server as part of a Rails form. Pass the `builder:` and `name:` options to this hash. `builder:` should be an instance of `ActionView::Helpers::FormBuilder`, which are created by the standard Rails `#form_with` and `#form_for` helpers. The `name:` option is the desired name of the field that will be included in the params sent to the server on form submission."
1270
+ },
1271
+ {
1272
+ "name": "system_arguments",
1273
+ "type": "Hash",
1274
+ "default": "N/A",
1275
+ "description": "[System arguments](/system-arguments)."
1276
+ }
1277
+ ]
1278
+ },
1279
+ {
1280
+ "component": "FileTreeView::DirectoryNode",
1281
+ "status": "alpha",
1282
+ "a11y_reviewed": false,
1283
+ "short_name": "FileTreeViewDirectoryNode",
1284
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/file_tree_view/directory_node.rb",
1285
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/file_tree_view/directory_node/default/",
1286
+ "parameters": []
1287
+ },
1288
+ {
1289
+ "component": "FileTreeView::FileNode",
1290
+ "status": "alpha",
1291
+ "a11y_reviewed": false,
1292
+ "short_name": "FileTreeViewFileNode",
1293
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/file_tree_view/file_node.rb",
1294
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/file_tree_view/file_node/default/",
1295
+ "parameters": []
1296
+ },
1251
1297
  {
1252
1298
  "component": "FormButton",
1253
1299
  "status": "alpha",
@@ -2635,6 +2681,34 @@
2635
2681
  }
2636
2682
  ]
2637
2683
  },
2684
+ {
2685
+ "component": "SkeletonBox",
2686
+ "status": "alpha",
2687
+ "a11y_reviewed": false,
2688
+ "short_name": "SkeletonBox",
2689
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/skeleton_box.rb",
2690
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/skeleton_box/default/",
2691
+ "parameters": [
2692
+ {
2693
+ "name": "height",
2694
+ "type": "String",
2695
+ "default": "`nil`",
2696
+ "description": "Any valid CSS height."
2697
+ },
2698
+ {
2699
+ "name": "width",
2700
+ "type": "String",
2701
+ "default": "`nil`",
2702
+ "description": "Any valid CSS width."
2703
+ },
2704
+ {
2705
+ "name": "system_arguments",
2706
+ "type": "Hash",
2707
+ "default": "N/A",
2708
+ "description": "[System arguments](/system-arguments)"
2709
+ }
2710
+ ]
2711
+ },
2638
2712
  {
2639
2713
  "component": "Stack",
2640
2714
  "status": "alpha",
@@ -2671,7 +2745,7 @@
2671
2745
  "name": "wrap",
2672
2746
  "type": "Symbol",
2673
2747
  "default": "`:nowrap`",
2674
- "description": "Specify whether items are forced onto one line or can wrap onto multiple lines. One of `nil`, `:nowrap`, or `:wrap`."
2748
+ "description": "Specify whether items are forced onto one line or can wrap onto multiple lines. One of `nil`, `:nowrap`, `:reverse`, or `:wrap`."
2675
2749
  },
2676
2750
  {
2677
2751
  "name": "justify",
@@ -3288,76 +3362,62 @@
3288
3362
  ]
3289
3363
  },
3290
3364
  {
3291
- "component": "UnderlineNav",
3365
+ "component": "TreeView",
3292
3366
  "status": "alpha",
3293
3367
  "a11y_reviewed": false,
3294
- "short_name": "UnderlineNav",
3295
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/underline_nav.rb",
3296
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/underline_nav/default/",
3368
+ "short_name": "TreeView",
3369
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view.rb",
3370
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/default/",
3297
3371
  "parameters": [
3298
3372
  {
3299
- "name": "tag",
3300
- "type": "Symbol",
3301
- "default": "`:nav`",
3302
- "description": "One of `:div` or `:nav`."
3303
- },
3304
- {
3305
- "name": "label",
3306
- "type": "String",
3307
- "default": "N/A",
3308
- "description": "Sets an `aria-label` that helps assistive technology users understand the purpose of the links, and distinguish it from similar elements."
3309
- },
3310
- {
3311
- "name": "align",
3373
+ "name": "node_variant",
3312
3374
  "type": "Symbol",
3313
- "default": "`:left`",
3314
- "description": "One of `:left` or `:right`. - Defaults to left"
3375
+ "default": "`:div`",
3376
+ "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
3315
3377
  },
3316
3378
  {
3317
- "name": "body_arguments",
3379
+ "name": "form_arguments",
3318
3380
  "type": "Hash",
3319
3381
  "default": "`{}`",
3320
- "description": "[System arguments](/system-arguments) for the body wrapper."
3382
+ "description": "These arguments allow the selections made within a `TreeView` to be submitted to the server as part of a Rails form. Pass the `builder:` and `name:` options to this hash. `builder:` should be an instance of `ActionView::Helpers::FormBuilder`, which are created by the standard Rails `#form_with` and `#form_for` helpers. The `name:` option is the desired name of the field that will be included in the params sent to the server on form submission."
3321
3383
  },
3322
3384
  {
3323
3385
  "name": "system_arguments",
3324
3386
  "type": "Hash",
3325
3387
  "default": "N/A",
3326
- "description": "[System arguments](/system-arguments)"
3388
+ "description": "[System arguments](/system-arguments)."
3327
3389
  }
3328
3390
  ]
3329
3391
  },
3330
3392
  {
3331
- "component": "UnderlinePanels",
3393
+ "component": "TreeView::Icon",
3332
3394
  "status": "alpha",
3333
3395
  "a11y_reviewed": false,
3334
- "short_name": "UnderlinePanels",
3335
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/underline_panels.rb",
3336
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/underline_panels/default/",
3396
+ "short_name": "TreeViewIcon",
3397
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/icon.rb",
3398
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/icon/default/",
3337
3399
  "parameters": [
3338
3400
  {
3339
- "name": "label",
3340
- "type": "String",
3341
- "default": "N/A",
3342
- "description": "Sets an `aria-label` that helps assistive technology users understand the purpose of the tabs."
3343
- },
3344
- {
3345
- "name": "align",
3346
- "type": "Symbol",
3347
- "default": "`:left`",
3348
- "description": "One of `:left` or `:right`. - Defaults to left"
3349
- },
3350
- {
3351
- "name": "body_arguments",
3401
+ "name": "system_arguments",
3352
3402
  "type": "Hash",
3353
- "default": "`{}`",
3354
- "description": "[System arguments](/system-arguments) for the body wrapper."
3355
- },
3403
+ "default": "N/A",
3404
+ "description": "The arguments accepted by [Octicon](/components/beta/octicon)."
3405
+ }
3406
+ ]
3407
+ },
3408
+ {
3409
+ "component": "TreeView::IconPair",
3410
+ "status": "alpha",
3411
+ "a11y_reviewed": false,
3412
+ "short_name": "TreeViewIconPair",
3413
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/icon_pair.rb",
3414
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/icon_pair/default/",
3415
+ "parameters": [
3356
3416
  {
3357
- "name": "wrapper_arguments",
3358
- "type": "Hash",
3359
- "default": "`{}`",
3360
- "description": "[System arguments](/system-arguments) for the `TabContainer` wrapper."
3417
+ "name": "expanded",
3418
+ "type": "Boolean",
3419
+ "default": "`false`",
3420
+ "description": "If true, the expanded icon is shown and the collapsed icon is hidden, etc."
3361
3421
  },
3362
3422
  {
3363
3423
  "name": "system_arguments",
@@ -3368,252 +3428,226 @@
3368
3428
  ]
3369
3429
  },
3370
3430
  {
3371
- "component": "Base",
3372
- "status": "beta",
3431
+ "component": "TreeView::LeadingAction",
3432
+ "status": "alpha",
3373
3433
  "a11y_reviewed": false,
3374
- "short_name": "Base",
3375
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/base_component.rb",
3376
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/base/default/",
3377
- "parameters": []
3434
+ "short_name": "TreeViewLeadingAction",
3435
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/leading_action.rb",
3436
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/leading_action/default/",
3437
+ "parameters": [
3438
+ {
3439
+ "name": "action",
3440
+ "type": "ViewComponent::Base",
3441
+ "default": "N/A",
3442
+ "description": "A component or other renderable to use as the action button etc."
3443
+ }
3444
+ ]
3378
3445
  },
3379
3446
  {
3380
- "component": "AutoComplete",
3381
- "status": "beta",
3447
+ "component": "TreeView::LeafNode",
3448
+ "status": "alpha",
3382
3449
  "a11y_reviewed": false,
3383
- "short_name": "AutoComplete",
3384
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete.rb",
3385
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/default/",
3450
+ "short_name": "TreeViewLeafNode",
3451
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/leaf_node.rb",
3452
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/leaf_node/default/",
3386
3453
  "parameters": [
3387
3454
  {
3388
- "name": "label_text",
3455
+ "name": "label",
3389
3456
  "type": "String",
3390
3457
  "default": "N/A",
3391
- "description": "The label of the input."
3458
+ "description": "The node's label, i.e. it's textual content."
3392
3459
  },
3393
3460
  {
3394
- "name": "src",
3395
- "type": "String",
3461
+ "name": "system_arguments",
3462
+ "type": "Hash",
3396
3463
  "default": "N/A",
3397
- "description": "The route to query."
3398
- },
3464
+ "description": "The arguments accepted by [TreeView::Node](/components/alpha/treeviewnode)."
3465
+ }
3466
+ ]
3467
+ },
3468
+ {
3469
+ "component": "TreeView::LoadingFailureMessage",
3470
+ "status": "alpha",
3471
+ "a11y_reviewed": false,
3472
+ "short_name": "TreeViewLoadingFailureMessage",
3473
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/loading_failure_message.rb",
3474
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/loading_failure_message/default/",
3475
+ "parameters": [
3399
3476
  {
3400
- "name": "input_id",
3477
+ "name": "text",
3401
3478
  "type": "String",
3402
- "default": "N/A",
3403
- "description": "Id of the input element."
3479
+ "default": "`Something went wrong`",
3480
+ "description": "The failure message to display."
3404
3481
  },
3405
3482
  {
3406
- "name": "input_name",
3483
+ "name": "retry_button_label",
3407
3484
  "type": "String",
3408
- "default": "`nil`",
3409
- "description": "Optional name of the input element, defaults to `input_id` when not set."
3485
+ "default": "`Retry`",
3486
+ "description": "The text shown on the retry button."
3410
3487
  },
3411
3488
  {
3412
- "name": "list_id",
3413
- "type": "String",
3489
+ "name": "system_arguments",
3490
+ "type": "Hash",
3414
3491
  "default": "N/A",
3415
- "description": "Id of the list element."
3416
- },
3417
- {
3418
- "name": "visually_hide_label",
3419
- "type": "Boolean",
3420
- "default": "`false`",
3421
- "description": "Controls if the label is visible. If `true`, screen reader only text will be added."
3422
- },
3492
+ "description": "[System arguments](/system-arguments)"
3493
+ }
3494
+ ]
3495
+ },
3496
+ {
3497
+ "component": "TreeView::Node",
3498
+ "status": "alpha",
3499
+ "a11y_reviewed": false,
3500
+ "short_name": "TreeViewNode",
3501
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/node.rb",
3502
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/node/default/",
3503
+ "parameters": [
3423
3504
  {
3424
- "name": "show_clear_button",
3425
- "type": "Boolean",
3426
- "default": "`false`",
3427
- "description": "Adds optional clear button."
3505
+ "name": "path",
3506
+ "type": "Array<String>",
3507
+ "default": "N/A",
3508
+ "description": "The node's \"path,\" i.e. this node's label and the labels of all its ancestors. This node should be reachable by traversing the tree following this path."
3428
3509
  },
3429
3510
  {
3430
- "name": "system_arguments",
3431
- "type": "Hash",
3511
+ "name": "node_variant",
3512
+ "type": "Symbol",
3432
3513
  "default": "N/A",
3433
- "description": "[System arguments](/system-arguments)"
3514
+ "description": "The node variant to use for the node's content, i.e. the `:button` or `:div`. One of `:anchor`, `:button`, or `:div`."
3434
3515
  },
3435
3516
  {
3436
- "name": "size",
3437
- "type": "Hash",
3438
- "default": "`:medium`",
3439
- "description": "Input size can be small, medium (default), or large"
3517
+ "name": "href",
3518
+ "type": "String",
3519
+ "default": "`nil`",
3520
+ "description": "The URL to use as the `href` attribute for this node. If set to a truthy value, the `tag:` parameter is ignored and assumed to be `:a`."
3440
3521
  },
3441
3522
  {
3442
- "name": "full_width",
3523
+ "name": "current",
3443
3524
  "type": "Boolean",
3444
3525
  "default": "`false`",
3445
- "description": "Input can be full-width or fit to content"
3526
+ "description": "Whether or not this node is the current node. The current node is styled differently than regular nodes and is the first element that receives focus when tabbing to the `TreeView` component."
3446
3527
  },
3447
3528
  {
3448
- "name": "width",
3449
- "type": "String",
3450
- "default": "`:auto`",
3451
- "description": "Optional parameter to set max width of results list. One of `:auto`, `:large`, `:medium`, `:small`, `:xlarge`, or `:xxlarge`."
3529
+ "name": "select_variant",
3530
+ "type": "Symbol",
3531
+ "default": "`:none`",
3532
+ "description": "Controls the type of checkbox that appears. One of `:multiple` or `:none`."
3452
3533
  },
3453
3534
  {
3454
- "name": "disabled",
3455
- "type": "Boolean",
3535
+ "name": "checked",
3536
+ "type": "Boolean | String",
3456
3537
  "default": "`false`",
3457
- "description": "Disabled input"
3538
+ "description": "The checked state of the node's checkbox. One of `false`, `mixed`, or `true`."
3458
3539
  },
3459
3540
  {
3460
- "name": "invalid",
3541
+ "name": "disabled",
3461
3542
  "type": "Boolean",
3462
3543
  "default": "`false`",
3463
- "description": "Invalid input"
3544
+ "description": "Whether or not the node can be activated. Passing `false` here will cause the node to appear visually disabled but it is still keyboard-focusable."
3464
3545
  },
3465
3546
  {
3466
- "name": "placeholder",
3547
+ "name": "value",
3467
3548
  "type": "String",
3468
3549
  "default": "`nil`",
3469
- "description": "The placeholder text displayed within the input"
3470
- },
3471
- {
3472
- "name": "inset",
3473
- "type": "Boolean",
3474
- "default": "`false`",
3475
- "description": "subtle input background color"
3550
+ "description": "If this node is checked, this value will be sent to the server on form submission."
3476
3551
  },
3477
3552
  {
3478
- "name": "monospace",
3479
- "type": "Boolean",
3480
- "default": "`false`",
3481
- "description": "monospace input font family"
3553
+ "name": "content_arguments",
3554
+ "type": "Hash",
3555
+ "default": "N/A",
3556
+ "description": "Arguments attached to the node's content, i.e the `<button>` or `<a>` element. [System arguments](/system-arguments)"
3482
3557
  }
3483
3558
  ]
3484
3559
  },
3485
3560
  {
3486
- "component": "AutoComplete::Item",
3487
- "status": "beta",
3561
+ "component": "TreeView::SkeletonLoader",
3562
+ "status": "alpha",
3488
3563
  "a11y_reviewed": false,
3489
- "short_name": "AutoCompleteItem",
3490
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete/item.rb",
3491
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/item/default/",
3564
+ "short_name": "TreeViewSkeletonLoader",
3565
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/skeleton_loader.rb",
3566
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/skeleton_loader/default/",
3492
3567
  "parameters": [
3493
3568
  {
3494
- "name": "value",
3569
+ "name": "src",
3495
3570
  "type": "String",
3496
3571
  "default": "N/A",
3497
- "description": "Value of the item."
3498
- },
3499
- {
3500
- "name": "selected",
3501
- "type": "Boolean",
3502
- "default": "`false`",
3503
- "description": "Whether the item is selected."
3504
- },
3505
- {
3506
- "name": "disabled",
3507
- "type": "Boolean",
3508
- "default": "`false`",
3509
- "description": "Whether the item is disabled."
3510
- },
3511
- {
3512
- "name": "description_variant",
3513
- "type": "Hash",
3514
- "default": "`:block`",
3515
- "description": "Changes the description style. Allowed values are :inline, :block"
3572
+ "description": "The URL to fetch nodes from."
3516
3573
  },
3517
3574
  {
3518
- "name": "description",
3519
- "type": "String",
3520
- "default": "N/A",
3521
- "description": "Display description text below label"
3575
+ "name": "count",
3576
+ "type": "Integer",
3577
+ "default": "`3`",
3578
+ "description": "The number of skeleton nodes to render."
3522
3579
  },
3523
3580
  {
3524
3581
  "name": "system_arguments",
3525
3582
  "type": "Hash",
3526
3583
  "default": "N/A",
3527
- "description": "[System arguments](/system-arguments)"
3584
+ "description": "The arguments accepted by [TreeView::SubTreeContainer](/components/alpha/treeviewsubtreecontainer)."
3528
3585
  }
3529
3586
  ]
3530
3587
  },
3531
3588
  {
3532
- "component": "AutoComplete::NoResultItem",
3533
- "status": "beta",
3534
- "a11y_reviewed": false,
3535
- "short_name": "AutoCompleteNoResultItem",
3536
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete/no_result_item.rb",
3537
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/no_result_item/default/",
3538
- "parameters": []
3539
- },
3540
- {
3541
- "component": "Avatar",
3542
- "status": "beta",
3589
+ "component": "TreeView::SpinnerLoader",
3590
+ "status": "alpha",
3543
3591
  "a11y_reviewed": false,
3544
- "short_name": "Avatar",
3545
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/avatar.rb",
3546
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/avatar/default/",
3592
+ "short_name": "TreeViewSpinnerLoader",
3593
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/spinner_loader.rb",
3594
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/spinner_loader/default/",
3547
3595
  "parameters": [
3548
3596
  {
3549
3597
  "name": "src",
3550
3598
  "type": "String",
3551
3599
  "default": "N/A",
3552
- "description": "The source url of the avatar image."
3553
- },
3554
- {
3555
- "name": "alt",
3556
- "type": "String",
3557
- "default": "`nil`",
3558
- "description": "Passed through to alt on img tag."
3600
+ "description": "The URL to fetch nodes from."
3559
3601
  },
3560
3602
  {
3561
- "name": "size",
3562
- "type": "Integer",
3563
- "default": "`20`",
3564
- "description": "One of `16`, `20`, `24`, `32`, `40`, `48`, `64`, or `80`."
3565
- },
3603
+ "name": "system_arguments",
3604
+ "type": "Hash",
3605
+ "default": "N/A",
3606
+ "description": "The arguments accepted by [TreeView::SubTreeContainer](/components/alpha/treeviewsubtreecontainer)."
3607
+ }
3608
+ ]
3609
+ },
3610
+ {
3611
+ "component": "TreeView::SubTree",
3612
+ "status": "alpha",
3613
+ "a11y_reviewed": false,
3614
+ "short_name": "TreeViewSubTree",
3615
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/sub_tree.rb",
3616
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/sub_tree/default/",
3617
+ "parameters": [
3566
3618
  {
3567
- "name": "shape",
3619
+ "name": "node_variant",
3568
3620
  "type": "Symbol",
3569
- "default": "`:circle`",
3570
- "description": "Shape of the avatar. One of `:circle` or `:square`."
3571
- },
3572
- {
3573
- "name": "href",
3574
- "type": "String",
3575
- "default": "`nil`",
3576
- "description": "The URL to link to. If used, component will be wrapped by an `<a>` tag."
3621
+ "default": "N/A",
3622
+ "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
3577
3623
  },
3578
3624
  {
3579
3625
  "name": "system_arguments",
3580
3626
  "type": "Hash",
3581
3627
  "default": "N/A",
3582
- "description": "[System arguments](/system-arguments)"
3628
+ "description": "The arguments accepted by [TreeView::SubTreeContainer](/components/alpha/treeviewsubtreecontainer)."
3583
3629
  }
3584
3630
  ]
3585
3631
  },
3586
3632
  {
3587
- "component": "AvatarStack",
3588
- "status": "beta",
3633
+ "component": "TreeView::SubTreeContainer",
3634
+ "status": "alpha",
3589
3635
  "a11y_reviewed": false,
3590
- "short_name": "AvatarStack",
3591
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/avatar_stack.rb",
3592
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/avatar_stack/default/",
3636
+ "short_name": "TreeViewSubTreeContainer",
3637
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/sub_tree_container.rb",
3638
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/sub_tree_container/default/",
3593
3639
  "parameters": [
3594
3640
  {
3595
- "name": "tag",
3596
- "type": "Symbol",
3597
- "default": "`:div`",
3598
- "description": "One of `:div` or `:span`."
3599
- },
3600
- {
3601
- "name": "align",
3602
- "type": "Symbol",
3603
- "default": "`:left`",
3604
- "description": "One of `:left` or `:right`."
3641
+ "name": "path",
3642
+ "type": "Array<String>",
3643
+ "default": "N/A",
3644
+ "description": "The path to this node."
3605
3645
  },
3606
3646
  {
3607
- "name": "tooltipped",
3647
+ "name": "expanded",
3608
3648
  "type": "Boolean",
3609
3649
  "default": "`false`",
3610
- "description": "Whether to add a tooltip to the stack or not."
3611
- },
3612
- {
3613
- "name": "body_arguments",
3614
- "type": "Hash",
3615
- "default": "`{}`",
3616
- "description": "Parameters to add to the Body. If `tooltipped` is set, has the same arguments as [Tooltip](/components/tooltip). The default tag is `:div` but can be changed using `tag:` to one of `:div` or `:span`."
3650
+ "description": "Whether or not this sub-tree node renders expanded."
3617
3651
  },
3618
3652
  {
3619
3653
  "name": "system_arguments",
@@ -3624,76 +3658,116 @@
3624
3658
  ]
3625
3659
  },
3626
3660
  {
3627
- "component": "BaseButton",
3628
- "status": "beta",
3661
+ "component": "TreeView::SubTreeNode",
3662
+ "status": "alpha",
3629
3663
  "a11y_reviewed": false,
3630
- "short_name": "BaseButton",
3631
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/base_button.rb",
3632
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/base_button/default/",
3664
+ "short_name": "TreeViewSubTreeNode",
3665
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/sub_tree_node.rb",
3666
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/sub_tree_node/default/",
3633
3667
  "parameters": [
3634
3668
  {
3635
- "name": "tag",
3636
- "type": "Symbol",
3637
- "default": "`:button`",
3638
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
3669
+ "name": "label",
3670
+ "type": "String",
3671
+ "default": "N/A",
3672
+ "description": "The node's label, i.e. it's textual content."
3639
3673
  },
3640
3674
  {
3641
- "name": "type",
3675
+ "name": "path",
3676
+ "type": "Array<String>",
3677
+ "default": "N/A",
3678
+ "description": "The node's \"path,\" i.e. this node's label and the labels of all its ancestors. This node should be reachable by traversing the tree following this path."
3679
+ },
3680
+ {
3681
+ "name": "node_variant",
3642
3682
  "type": "Symbol",
3643
- "default": "`:button`",
3644
- "description": "One of `:button`, `:reset`, or `:submit`."
3683
+ "default": "N/A",
3684
+ "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
3645
3685
  },
3646
3686
  {
3647
- "name": "block",
3648
- "type": "Boolean",
3649
- "default": "`false`",
3650
- "description": "Whether button is full-width with `display: block`."
3687
+ "name": "sub_tree_component_klass",
3688
+ "type": "Class",
3689
+ "default": "`SubTree`",
3690
+ "description": "The class to use for the sub-tree instead of the default [TreeView::SubTree](/components/alpha/treeviewsubtree)"
3651
3691
  },
3652
3692
  {
3653
- "name": "disabled",
3693
+ "name": "expanded",
3654
3694
  "type": "Boolean",
3655
3695
  "default": "`false`",
3656
- "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
3696
+ "description": "Whether or not this sub-tree should be rendered expanded."
3657
3697
  },
3658
3698
  {
3659
- "name": "inactive",
3660
- "type": "Boolean",
3661
- "default": "`false`",
3662
- "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
3699
+ "name": "select_strategy",
3700
+ "type": "Symbol",
3701
+ "default": "`:mixed_descendants`",
3702
+ "description": "What should happen when this sub-tree node is checked. One of `:descendants`, `:mixed_descendants`, or `:self`."
3663
3703
  },
3664
3704
  {
3665
3705
  "name": "system_arguments",
3666
3706
  "type": "Hash",
3667
3707
  "default": "N/A",
3668
- "description": "[System arguments](/system-arguments)"
3708
+ "description": "The arguments accepted by [TreeView::Node](/components/alpha/treeviewnode)."
3669
3709
  }
3670
3710
  ]
3671
3711
  },
3672
3712
  {
3673
- "component": "Blankslate",
3674
- "status": "beta",
3713
+ "component": "TreeView::Visual",
3714
+ "status": "alpha",
3675
3715
  "a11y_reviewed": false,
3676
- "short_name": "Blankslate",
3677
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/blankslate.rb",
3678
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/blankslate/default/",
3716
+ "short_name": "TreeViewVisual",
3717
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/tree_view/visual.rb",
3718
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/tree_view/visual/default/",
3679
3719
  "parameters": [
3680
3720
  {
3681
- "name": "narrow",
3682
- "type": "Boolean",
3683
- "default": "`false`",
3684
- "description": "Adds a maximum width of `485px` to the Blankslate."
3721
+ "name": "id",
3722
+ "type": "String",
3723
+ "default": "N/A",
3724
+ "description": "This visual's HTML ID."
3685
3725
  },
3686
3726
  {
3687
- "name": "spacious",
3688
- "type": "Boolean",
3689
- "default": "`false`",
3690
- "description": "Increases the padding from `32px` to `80px 40px`."
3727
+ "name": "visual",
3728
+ "type": "ViewComponent::Base",
3729
+ "default": "N/A",
3730
+ "description": "A renderable component like an instance of [Octicon](/components/beta/octicon) to render as the visual."
3691
3731
  },
3692
3732
  {
3693
- "name": "border",
3694
- "type": "Boolean",
3695
- "default": "`false`",
3696
- "description": "Adds a border around the Blankslate."
3733
+ "name": "label",
3734
+ "type": "String",
3735
+ "default": "`nil`",
3736
+ "description": "Text describing this visual that will be visible only to screen readers."
3737
+ }
3738
+ ]
3739
+ },
3740
+ {
3741
+ "component": "UnderlineNav",
3742
+ "status": "alpha",
3743
+ "a11y_reviewed": false,
3744
+ "short_name": "UnderlineNav",
3745
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/underline_nav.rb",
3746
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/underline_nav/default/",
3747
+ "parameters": [
3748
+ {
3749
+ "name": "tag",
3750
+ "type": "Symbol",
3751
+ "default": "`:nav`",
3752
+ "description": "One of `:div` or `:nav`."
3753
+ },
3754
+ {
3755
+ "name": "label",
3756
+ "type": "String",
3757
+ "default": "N/A",
3758
+ "description": "Sets an `aria-label` that helps assistive technology users understand the purpose of the links, and distinguish it from similar elements."
3759
+ },
3760
+ {
3761
+ "name": "align",
3762
+ "type": "Symbol",
3763
+ "default": "`:left`",
3764
+ "description": "One of `:left` or `:right`. - Defaults to left"
3765
+ },
3766
+ {
3767
+ "name": "body_arguments",
3768
+ "type": "Hash",
3769
+ "default": "`{}`",
3770
+ "description": "[System arguments](/system-arguments) for the body wrapper."
3697
3771
  },
3698
3772
  {
3699
3773
  "name": "system_arguments",
@@ -3704,18 +3778,36 @@
3704
3778
  ]
3705
3779
  },
3706
3780
  {
3707
- "component": "BorderBox",
3708
- "status": "beta",
3781
+ "component": "UnderlinePanels",
3782
+ "status": "alpha",
3709
3783
  "a11y_reviewed": false,
3710
- "short_name": "BorderBox",
3711
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/border_box.rb",
3712
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/border_box/default/",
3784
+ "short_name": "UnderlinePanels",
3785
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/underline_panels.rb",
3786
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/underline_panels/default/",
3713
3787
  "parameters": [
3714
3788
  {
3715
- "name": "padding",
3789
+ "name": "label",
3790
+ "type": "String",
3791
+ "default": "N/A",
3792
+ "description": "Sets an `aria-label` that helps assistive technology users understand the purpose of the tabs."
3793
+ },
3794
+ {
3795
+ "name": "align",
3716
3796
  "type": "Symbol",
3717
- "default": "`:default`",
3718
- "description": "One of `:condensed`, `:default`, or `:spacious`."
3797
+ "default": "`:left`",
3798
+ "description": "One of `:left` or `:right`. - Defaults to left"
3799
+ },
3800
+ {
3801
+ "name": "body_arguments",
3802
+ "type": "Hash",
3803
+ "default": "`{}`",
3804
+ "description": "[System arguments](/system-arguments) for the body wrapper."
3805
+ },
3806
+ {
3807
+ "name": "wrapper_arguments",
3808
+ "type": "Hash",
3809
+ "default": "`{}`",
3810
+ "description": "[System arguments](/system-arguments) for the `TabContainer` wrapper."
3719
3811
  },
3720
3812
  {
3721
3813
  "name": "system_arguments",
@@ -3726,141 +3818,157 @@
3726
3818
  ]
3727
3819
  },
3728
3820
  {
3729
- "component": "BorderBox::Header",
3821
+ "component": "Base",
3730
3822
  "status": "beta",
3731
3823
  "a11y_reviewed": false,
3732
- "short_name": "BorderBoxHeader",
3733
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/border_box/header.rb",
3734
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/border_box/header/default/",
3735
- "parameters": [
3736
- {
3737
- "name": "system_arguments",
3738
- "type": "Hash",
3739
- "default": "N/A",
3740
- "description": "[System arguments](/system-arguments)"
3741
- }
3742
- ]
3824
+ "short_name": "Base",
3825
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/base_component.rb",
3826
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/base/default/",
3827
+ "parameters": []
3743
3828
  },
3744
3829
  {
3745
- "component": "Breadcrumbs",
3830
+ "component": "AutoComplete",
3746
3831
  "status": "beta",
3747
3832
  "a11y_reviewed": false,
3748
- "short_name": "Breadcrumbs",
3749
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/breadcrumbs.rb",
3750
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/breadcrumbs/default/",
3833
+ "short_name": "AutoComplete",
3834
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete.rb",
3835
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/default/",
3751
3836
  "parameters": [
3752
3837
  {
3753
- "name": "system_arguments",
3754
- "type": "Hash",
3838
+ "name": "label_text",
3839
+ "type": "String",
3755
3840
  "default": "N/A",
3756
- "description": "[System arguments](/system-arguments)"
3757
- }
3758
- ]
3759
- },
3760
- {
3761
- "component": "Breadcrumbs::Item",
3762
- "status": "alpha",
3763
- "a11y_reviewed": false,
3764
- "short_name": "BreadcrumbsItem",
3765
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/breadcrumbs/item.rb",
3766
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/breadcrumbs/item/default/",
3767
- "parameters": []
3768
- },
3769
- {
3770
- "component": "Button",
3771
- "status": "beta",
3772
- "a11y_reviewed": false,
3773
- "short_name": "Button",
3774
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button.rb",
3775
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button/default/",
3776
- "parameters": [
3841
+ "description": "The label of the input."
3842
+ },
3777
3843
  {
3778
- "name": "base_button_class",
3779
- "type": "Class",
3780
- "default": "`Primer::Beta::BaseButton`",
3781
- "description": "The button class to render."
3844
+ "name": "src",
3845
+ "type": "String",
3846
+ "default": "N/A",
3847
+ "description": "The route to query."
3782
3848
  },
3783
3849
  {
3784
- "name": "scheme",
3785
- "type": "Symbol",
3786
- "default": "`:default`",
3787
- "description": "One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
3850
+ "name": "input_id",
3851
+ "type": "String",
3852
+ "default": "N/A",
3853
+ "description": "Id of the input element."
3788
3854
  },
3789
3855
  {
3790
- "name": "size",
3791
- "type": "Symbol",
3792
- "default": "`:medium`",
3793
- "description": "One of `:large`, `:medium`, or `:small`."
3856
+ "name": "input_name",
3857
+ "type": "String",
3858
+ "default": "`nil`",
3859
+ "description": "Optional name of the input element, defaults to `input_id` when not set."
3794
3860
  },
3795
3861
  {
3796
- "name": "block",
3862
+ "name": "list_id",
3863
+ "type": "String",
3864
+ "default": "N/A",
3865
+ "description": "Id of the list element."
3866
+ },
3867
+ {
3868
+ "name": "visually_hide_label",
3797
3869
  "type": "Boolean",
3798
3870
  "default": "`false`",
3799
- "description": "Whether button is full-width with `display: block`."
3871
+ "description": "Controls if the label is visible. If `true`, screen reader only text will be added."
3800
3872
  },
3801
3873
  {
3802
- "name": "align_content",
3803
- "type": "Symbol",
3804
- "default": "`:center`",
3805
- "description": "One of `:center` or `:start`."
3874
+ "name": "show_clear_button",
3875
+ "type": "Boolean",
3876
+ "default": "`false`",
3877
+ "description": "Adds optional clear button."
3806
3878
  },
3807
3879
  {
3808
- "name": "tag",
3809
- "type": "Symbol",
3810
- "default": "`:button`",
3811
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
3880
+ "name": "system_arguments",
3881
+ "type": "Hash",
3882
+ "default": "N/A",
3883
+ "description": "[System arguments](/system-arguments)"
3812
3884
  },
3813
3885
  {
3814
- "name": "type",
3815
- "type": "Symbol",
3816
- "default": "`:button`",
3817
- "description": "One of `:button`, `:reset`, or `:submit`."
3886
+ "name": "size",
3887
+ "type": "Hash",
3888
+ "default": "`:medium`",
3889
+ "description": "Input size can be small, medium (default), or large"
3818
3890
  },
3819
3891
  {
3820
- "name": "inactive",
3892
+ "name": "full_width",
3821
3893
  "type": "Boolean",
3822
- "default": "N/A",
3823
- "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
3894
+ "default": "`false`",
3895
+ "description": "Input can be full-width or fit to content"
3896
+ },
3897
+ {
3898
+ "name": "width",
3899
+ "type": "String",
3900
+ "default": "`:auto`",
3901
+ "description": "Optional parameter to set max width of results list. One of `:auto`, `:large`, `:medium`, `:small`, `:xlarge`, or `:xxlarge`."
3824
3902
  },
3825
3903
  {
3826
3904
  "name": "disabled",
3827
3905
  "type": "Boolean",
3828
3906
  "default": "`false`",
3829
- "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
3907
+ "description": "Disabled input"
3830
3908
  },
3831
3909
  {
3832
- "name": "label_wrap",
3910
+ "name": "invalid",
3833
3911
  "type": "Boolean",
3834
3912
  "default": "`false`",
3835
- "description": "Whether or not the button label text wraps and the button height expands."
3913
+ "description": "Invalid input"
3836
3914
  },
3837
3915
  {
3838
- "name": "system_arguments",
3839
- "type": "Hash",
3840
- "default": "N/A",
3841
- "description": "[System arguments](/system-arguments)"
3916
+ "name": "placeholder",
3917
+ "type": "String",
3918
+ "default": "`nil`",
3919
+ "description": "The placeholder text displayed within the input"
3920
+ },
3921
+ {
3922
+ "name": "inset",
3923
+ "type": "Boolean",
3924
+ "default": "`false`",
3925
+ "description": "subtle input background color"
3926
+ },
3927
+ {
3928
+ "name": "monospace",
3929
+ "type": "Boolean",
3930
+ "default": "`false`",
3931
+ "description": "monospace input font family"
3842
3932
  }
3843
3933
  ]
3844
3934
  },
3845
3935
  {
3846
- "component": "ButtonGroup",
3936
+ "component": "AutoComplete::Item",
3847
3937
  "status": "beta",
3848
3938
  "a11y_reviewed": false,
3849
- "short_name": "ButtonGroup",
3850
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group.rb",
3851
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/default/",
3939
+ "short_name": "AutoCompleteItem",
3940
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete/item.rb",
3941
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/item/default/",
3852
3942
  "parameters": [
3853
3943
  {
3854
- "name": "scheme",
3855
- "type": "Symbol",
3856
- "default": "`:default`",
3857
- "description": "DEPRECATED. One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
3944
+ "name": "value",
3945
+ "type": "String",
3946
+ "default": "N/A",
3947
+ "description": "Value of the item."
3858
3948
  },
3859
3949
  {
3860
- "name": "size",
3861
- "type": "Symbol",
3862
- "default": "`:medium`",
3863
- "description": "One of `:large`, `:medium`, or `:small`."
3950
+ "name": "selected",
3951
+ "type": "Boolean",
3952
+ "default": "`false`",
3953
+ "description": "Whether the item is selected."
3954
+ },
3955
+ {
3956
+ "name": "disabled",
3957
+ "type": "Boolean",
3958
+ "default": "`false`",
3959
+ "description": "Whether the item is disabled."
3960
+ },
3961
+ {
3962
+ "name": "description_variant",
3963
+ "type": "Hash",
3964
+ "default": "`:block`",
3965
+ "description": "Changes the description style. Allowed values are :inline, :block"
3966
+ },
3967
+ {
3968
+ "name": "description",
3969
+ "type": "String",
3970
+ "default": "N/A",
3971
+ "description": "Display description text below label"
3864
3972
  },
3865
3973
  {
3866
3974
  "name": "system_arguments",
@@ -3871,52 +3979,51 @@
3871
3979
  ]
3872
3980
  },
3873
3981
  {
3874
- "component": "ButtonGroup::MenuButton",
3875
- "status": "alpha",
3982
+ "component": "AutoComplete::NoResultItem",
3983
+ "status": "beta",
3876
3984
  "a11y_reviewed": false,
3877
- "short_name": "ButtonGroupMenuButton",
3878
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group/menu_button.rb",
3879
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/menu_button/default/",
3880
- "parameters": [
3881
- {
3882
- "name": "menu_arguments",
3883
- "type": "Hash",
3884
- "default": "`{}`",
3885
- "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
3886
- },
3887
- {
3888
- "name": "button_arguments",
3889
- "type": "Hash",
3890
- "default": "`{}`",
3891
- "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
3892
- }
3893
- ]
3985
+ "short_name": "AutoCompleteNoResultItem",
3986
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/auto_complete/no_result_item.rb",
3987
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/auto_complete/no_result_item/default/",
3988
+ "parameters": []
3894
3989
  },
3895
3990
  {
3896
- "component": "ClipboardCopy",
3991
+ "component": "Avatar",
3897
3992
  "status": "beta",
3898
3993
  "a11y_reviewed": false,
3899
- "short_name": "ClipboardCopy",
3900
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy.rb",
3901
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy/default/",
3994
+ "short_name": "Avatar",
3995
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/avatar.rb",
3996
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/avatar/default/",
3902
3997
  "parameters": [
3903
3998
  {
3904
- "name": "aria-label",
3999
+ "name": "src",
3905
4000
  "type": "String",
3906
4001
  "default": "N/A",
3907
- "description": "String that will be read to screenreaders when the component is focused"
4002
+ "description": "The source url of the avatar image."
3908
4003
  },
3909
4004
  {
3910
- "name": "value",
4005
+ "name": "alt",
3911
4006
  "type": "String",
3912
4007
  "default": "`nil`",
3913
- "description": "Text to copy into the users clipboard when they click the component."
4008
+ "description": "Passed through to alt on img tag."
3914
4009
  },
3915
4010
  {
3916
- "name": "for",
4011
+ "name": "size",
4012
+ "type": "Integer",
4013
+ "default": "`20`",
4014
+ "description": "One of `16`, `20`, `24`, `32`, `40`, `48`, `64`, or `80`."
4015
+ },
4016
+ {
4017
+ "name": "shape",
4018
+ "type": "Symbol",
4019
+ "default": "`:circle`",
4020
+ "description": "Shape of the avatar. One of `:circle` or `:square`."
4021
+ },
4022
+ {
4023
+ "name": "href",
3917
4024
  "type": "String",
3918
- "default": "N/A",
3919
- "description": "Element id from where to get the copied value."
4025
+ "default": "`nil`",
4026
+ "description": "The URL to link to. If used, component will be wrapped by an `<a>` tag."
3920
4027
  },
3921
4028
  {
3922
4029
  "name": "system_arguments",
@@ -3927,42 +4034,36 @@
3927
4034
  ]
3928
4035
  },
3929
4036
  {
3930
- "component": "ClipboardCopyBaseButton",
4037
+ "component": "AvatarStack",
3931
4038
  "status": "beta",
3932
4039
  "a11y_reviewed": false,
3933
- "short_name": "ClipboardCopyBaseButton",
3934
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy_base_button.rb",
3935
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy_base_button/default/",
4040
+ "short_name": "AvatarStack",
4041
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/avatar_stack.rb",
4042
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/avatar_stack/default/",
3936
4043
  "parameters": [
3937
4044
  {
3938
4045
  "name": "tag",
3939
4046
  "type": "Symbol",
3940
- "default": "`:button`",
3941
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4047
+ "default": "`:div`",
4048
+ "description": "One of `:div` or `:span`."
3942
4049
  },
3943
4050
  {
3944
- "name": "type",
4051
+ "name": "align",
3945
4052
  "type": "Symbol",
3946
- "default": "`:button`",
3947
- "description": "One of `:button`, `:reset`, or `:submit`."
3948
- },
3949
- {
3950
- "name": "block",
3951
- "type": "Boolean",
3952
- "default": "`false`",
3953
- "description": "Whether button is full-width with `display: block`."
4053
+ "default": "`:left`",
4054
+ "description": "One of `:left` or `:right`."
3954
4055
  },
3955
4056
  {
3956
- "name": "disabled",
4057
+ "name": "tooltipped",
3957
4058
  "type": "Boolean",
3958
4059
  "default": "`false`",
3959
- "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4060
+ "description": "Whether to add a tooltip to the stack or not."
3960
4061
  },
3961
4062
  {
3962
- "name": "inactive",
3963
- "type": "Boolean",
3964
- "default": "`false`",
3965
- "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
4063
+ "name": "body_arguments",
4064
+ "type": "Hash",
4065
+ "default": "`{}`",
4066
+ "description": "Parameters to add to the Body. If `tooltipped` is set, has the same arguments as [Tooltip](/components/tooltip). The default tag is `:div` but can be changed using `tag:` to one of `:div` or `:span`."
3966
4067
  },
3967
4068
  {
3968
4069
  "name": "system_arguments",
@@ -3973,40 +4074,42 @@
3973
4074
  ]
3974
4075
  },
3975
4076
  {
3976
- "component": "ClipboardCopyButton",
4077
+ "component": "BaseButton",
3977
4078
  "status": "beta",
3978
4079
  "a11y_reviewed": false,
3979
- "short_name": "ClipboardCopyButton",
3980
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy_button.rb",
3981
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy_button/default/",
4080
+ "short_name": "BaseButton",
4081
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/base_button.rb",
4082
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/base_button/default/",
3982
4083
  "parameters": [
3983
4084
  {
3984
- "name": "system_arguments",
3985
- "type": "Hash",
3986
- "default": "N/A",
3987
- "description": "The arguments accepted by [Button](/components/beta/button) and [ClipboardCopy](/components/beta/clipboardcopy)."
3988
- }
3989
- ]
3990
- },
3991
- {
3992
- "component": "CloseButton",
3993
- "status": "beta",
3994
- "a11y_reviewed": false,
3995
- "short_name": "CloseButton",
3996
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/close_button.rb",
3997
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/close_button/default/",
3998
- "parameters": [
4085
+ "name": "tag",
4086
+ "type": "Symbol",
4087
+ "default": "`:button`",
4088
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4089
+ },
3999
4090
  {
4000
4091
  "name": "type",
4001
4092
  "type": "Symbol",
4002
4093
  "default": "`:button`",
4003
- "description": "One of `:button` or `:submit`."
4094
+ "description": "One of `:button`, `:reset`, or `:submit`."
4095
+ },
4096
+ {
4097
+ "name": "block",
4098
+ "type": "Boolean",
4099
+ "default": "`false`",
4100
+ "description": "Whether button is full-width with `display: block`."
4004
4101
  },
4005
4102
  {
4006
4103
  "name": "disabled",
4007
4104
  "type": "Boolean",
4008
4105
  "default": "`false`",
4009
- "description": "Whether or not the button is disabled."
4106
+ "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4107
+ },
4108
+ {
4109
+ "name": "inactive",
4110
+ "type": "Boolean",
4111
+ "default": "`false`",
4112
+ "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
4010
4113
  },
4011
4114
  {
4012
4115
  "name": "system_arguments",
@@ -4017,48 +4120,30 @@
4017
4120
  ]
4018
4121
  },
4019
4122
  {
4020
- "component": "Counter",
4123
+ "component": "Blankslate",
4021
4124
  "status": "beta",
4022
4125
  "a11y_reviewed": false,
4023
- "short_name": "Counter",
4024
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/counter.rb",
4025
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/counter/default/",
4126
+ "short_name": "Blankslate",
4127
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/blankslate.rb",
4128
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/blankslate/default/",
4026
4129
  "parameters": [
4027
4130
  {
4028
- "name": "count",
4029
- "type": "Integer, Float::INFINITY, nil",
4030
- "default": "`0`",
4031
- "description": "The number to be displayed (e.x. # of issues, pull requests)"
4032
- },
4033
- {
4034
- "name": "scheme",
4035
- "type": "Symbol",
4036
- "default": "`:default`",
4037
- "description": "Color scheme. One of `:default`, `:primary`, or `:secondary`."
4038
- },
4039
- {
4040
- "name": "limit",
4041
- "type": "Integer, nil",
4042
- "default": "`5_000`",
4043
- "description": "Maximum value to display. Pass `nil` for no limit. (e.x. if `count` == 6,000 and `limit` == 5000, counter will display \"5,000+\")"
4044
- },
4045
- {
4046
- "name": "hide_if_zero",
4131
+ "name": "narrow",
4047
4132
  "type": "Boolean",
4048
4133
  "default": "`false`",
4049
- "description": "If true, a `hidden` attribute is added to the counter if `count` is zero."
4134
+ "description": "Adds a maximum width of `485px` to the Blankslate."
4050
4135
  },
4051
4136
  {
4052
- "name": "text",
4053
- "type": "String",
4054
- "default": "`\"\"`",
4055
- "description": "Text to display instead of count."
4137
+ "name": "spacious",
4138
+ "type": "Boolean",
4139
+ "default": "`false`",
4140
+ "description": "Increases the padding from `32px` to `80px 40px`."
4056
4141
  },
4057
4142
  {
4058
- "name": "round",
4143
+ "name": "border",
4059
4144
  "type": "Boolean",
4060
4145
  "default": "`false`",
4061
- "description": "Whether to apply our standard rounding logic to value."
4146
+ "description": "Adds a border around the Blankslate."
4062
4147
  },
4063
4148
  {
4064
4149
  "name": "system_arguments",
@@ -4069,30 +4154,18 @@
4069
4154
  ]
4070
4155
  },
4071
4156
  {
4072
- "component": "Details",
4157
+ "component": "BorderBox",
4073
4158
  "status": "beta",
4074
4159
  "a11y_reviewed": false,
4075
- "short_name": "Details",
4076
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/details.rb",
4077
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/details/default/",
4160
+ "short_name": "BorderBox",
4161
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/border_box.rb",
4162
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/border_box/default/",
4078
4163
  "parameters": [
4079
4164
  {
4080
- "name": "overlay",
4165
+ "name": "padding",
4081
4166
  "type": "Symbol",
4082
- "default": "`:none`",
4083
- "description": "Dictates the type of overlay to render with. One of `:dark`, `:default`, or `:none`."
4084
- },
4085
- {
4086
- "name": "reset",
4087
- "type": "Boolean",
4088
- "default": "`false`",
4089
- "description": "Defaults to false. If set to true, it will remove the default caret and remove style from the summary element"
4090
- },
4091
- {
4092
- "name": "disabled",
4093
- "type": "Boolean",
4094
- "default": "`false`",
4095
- "description": "Whether or not to disable the summary button."
4167
+ "default": "`:default`",
4168
+ "description": "One of `:condensed`, `:default`, or `:spacious`."
4096
4169
  },
4097
4170
  {
4098
4171
  "name": "system_arguments",
@@ -4103,43 +4176,13 @@
4103
4176
  ]
4104
4177
  },
4105
4178
  {
4106
- "component": "Flash",
4107
- "status": "deprecated",
4179
+ "component": "BorderBox::Header",
4180
+ "status": "beta",
4108
4181
  "a11y_reviewed": false,
4109
- "short_name": "Flash",
4110
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/flash.rb",
4111
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/flash/default/",
4182
+ "short_name": "BorderBoxHeader",
4183
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/border_box/header.rb",
4184
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/border_box/header/default/",
4112
4185
  "parameters": [
4113
- {
4114
- "name": "full",
4115
- "type": "Boolean",
4116
- "default": "`false`",
4117
- "description": "Whether the component should take up the full width of the screen."
4118
- },
4119
- {
4120
- "name": "spacious",
4121
- "type": "Boolean",
4122
- "default": "`false`",
4123
- "description": "Whether to add margin to the bottom of the component."
4124
- },
4125
- {
4126
- "name": "dismissible",
4127
- "type": "Boolean",
4128
- "default": "`false`",
4129
- "description": "Whether the component can be dismissed with an X button."
4130
- },
4131
- {
4132
- "name": "icon",
4133
- "type": "Symbol",
4134
- "default": "`nil`",
4135
- "description": "Name of Octicon icon to use."
4136
- },
4137
- {
4138
- "name": "scheme",
4139
- "type": "Symbol",
4140
- "default": "`:default`",
4141
- "description": "One of `:danger`, `:default`, `:success`, or `:warning`."
4142
- },
4143
4186
  {
4144
4187
  "name": "system_arguments",
4145
4188
  "type": "Hash",
@@ -4149,19 +4192,13 @@
4149
4192
  ]
4150
4193
  },
4151
4194
  {
4152
- "component": "Heading",
4195
+ "component": "Breadcrumbs",
4153
4196
  "status": "beta",
4154
4197
  "a11y_reviewed": false,
4155
- "short_name": "Heading",
4156
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/heading.rb",
4157
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/heading/default/",
4198
+ "short_name": "Breadcrumbs",
4199
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/breadcrumbs.rb",
4200
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/breadcrumbs/default/",
4158
4201
  "parameters": [
4159
- {
4160
- "name": "tag",
4161
- "type": "String",
4162
- "default": "N/A",
4163
- "description": "One of `:h1`, `:h2`, `:h3`, `:h4`, `:h5`, or `:h6`."
4164
- },
4165
4202
  {
4166
4203
  "name": "system_arguments",
4167
4204
  "type": "Hash",
@@ -4171,30 +4208,33 @@
4171
4208
  ]
4172
4209
  },
4173
4210
  {
4174
- "component": "IconButton",
4211
+ "component": "Breadcrumbs::Item",
4212
+ "status": "alpha",
4213
+ "a11y_reviewed": false,
4214
+ "short_name": "BreadcrumbsItem",
4215
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/breadcrumbs/item.rb",
4216
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/breadcrumbs/item/default/",
4217
+ "parameters": []
4218
+ },
4219
+ {
4220
+ "component": "Button",
4175
4221
  "status": "beta",
4176
4222
  "a11y_reviewed": false,
4177
- "short_name": "IconButton",
4178
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/icon_button.rb",
4179
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/icon_button/default/",
4223
+ "short_name": "Button",
4224
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button.rb",
4225
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button/default/",
4180
4226
  "parameters": [
4181
4227
  {
4182
- "name": "icon",
4183
- "type": "String",
4184
- "default": "N/A",
4185
- "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4186
- },
4187
- {
4188
- "name": "tag",
4189
- "type": "Symbol",
4190
- "default": "N/A",
4191
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4228
+ "name": "base_button_class",
4229
+ "type": "Class",
4230
+ "default": "`Primer::Beta::BaseButton`",
4231
+ "description": "The button class to render."
4192
4232
  },
4193
4233
  {
4194
4234
  "name": "scheme",
4195
4235
  "type": "Symbol",
4196
4236
  "default": "`:default`",
4197
- "description": "One of `:danger`, `:default`, `:invisible`, `:primary`, or `:secondary`."
4237
+ "description": "One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
4198
4238
  },
4199
4239
  {
4200
4240
  "name": "size",
@@ -4203,40 +4243,46 @@
4203
4243
  "description": "One of `:large`, `:medium`, or `:small`."
4204
4244
  },
4205
4245
  {
4206
- "name": "disabled",
4246
+ "name": "block",
4207
4247
  "type": "Boolean",
4208
4248
  "default": "`false`",
4209
- "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4249
+ "description": "Whether button is full-width with `display: block`."
4210
4250
  },
4211
4251
  {
4212
- "name": "type",
4252
+ "name": "align_content",
4213
4253
  "type": "Symbol",
4214
- "default": "N/A",
4215
- "description": "One of `:button`, `:reset`, or `:submit`."
4254
+ "default": "`:center`",
4255
+ "description": "One of `:center` or `:start`."
4216
4256
  },
4217
4257
  {
4218
- "name": "aria-label",
4219
- "type": "String",
4220
- "default": "N/A",
4221
- "description": "String that can be read by assistive technology. A label should be short and concise. See the accessibility section for more information."
4258
+ "name": "tag",
4259
+ "type": "Symbol",
4260
+ "default": "`:button`",
4261
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4222
4262
  },
4223
4263
  {
4224
- "name": "aria-description",
4225
- "type": "String",
4226
- "default": "N/A",
4227
- "description": "String that can be read by assistive technology. A description can be longer as it is intended to provide more context and information. See the accessibility section for more information."
4264
+ "name": "type",
4265
+ "type": "Symbol",
4266
+ "default": "`:button`",
4267
+ "description": "One of `:button`, `:reset`, or `:submit`."
4228
4268
  },
4229
4269
  {
4230
- "name": "show_tooltip",
4270
+ "name": "inactive",
4231
4271
  "type": "Boolean",
4232
- "default": "`true`",
4233
- "description": "Whether or not to show a tooltip when this button is hovered. Tooltips should only be hidden if the aria label is redundant, i.e. if the icon has a widely understood definition."
4272
+ "default": "N/A",
4273
+ "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
4234
4274
  },
4235
4275
  {
4236
- "name": "tooltip_direction",
4237
- "type": "Symbol",
4238
- "default": "`:s`",
4239
- "description": "One of `:e`, `:n`, `:ne`, `:nw`, `:s`, `:se`, `:sw`, or `:w`."
4276
+ "name": "disabled",
4277
+ "type": "Boolean",
4278
+ "default": "`false`",
4279
+ "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4280
+ },
4281
+ {
4282
+ "name": "label_wrap",
4283
+ "type": "Boolean",
4284
+ "default": "`false`",
4285
+ "description": "Whether or not the button label text wraps and the button height expands."
4240
4286
  },
4241
4287
  {
4242
4288
  "name": "system_arguments",
@@ -4247,42 +4293,80 @@
4247
4293
  ]
4248
4294
  },
4249
4295
  {
4250
- "component": "Label",
4296
+ "component": "ButtonGroup",
4251
4297
  "status": "beta",
4252
4298
  "a11y_reviewed": false,
4253
- "short_name": "Label",
4254
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/label.rb",
4255
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/label/default/",
4299
+ "short_name": "ButtonGroup",
4300
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group.rb",
4301
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/default/",
4256
4302
  "parameters": [
4257
- {
4258
- "name": "tag",
4259
- "type": "Symbol",
4260
- "default": "`:span`",
4261
- "description": "One of `:a`, `:div`, `:span`, or `:summary`."
4262
- },
4263
4303
  {
4264
4304
  "name": "scheme",
4265
4305
  "type": "Symbol",
4266
4306
  "default": "`:default`",
4267
- "description": "One of `:accent`, `:attention`, `:danger`, `:default`, `:done`, `:info`, `:orange`, `:primary`, `:purple`, `:secondary`, `:severe`, `:sponsors`, `:success`, or `:warning`."
4307
+ "description": "DEPRECATED. One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
4268
4308
  },
4269
4309
  {
4270
4310
  "name": "size",
4271
4311
  "type": "Symbol",
4272
4312
  "default": "`:medium`",
4273
- "description": "One of `:large` or `:medium`."
4313
+ "description": "One of `:large`, `:medium`, or `:small`."
4274
4314
  },
4275
4315
  {
4276
- "name": "inline",
4277
- "type": "Boolean",
4278
- "default": "`false`",
4279
- "description": "Whether or not to render this label inline."
4316
+ "name": "system_arguments",
4317
+ "type": "Hash",
4318
+ "default": "N/A",
4319
+ "description": "[System arguments](/system-arguments)"
4320
+ }
4321
+ ]
4322
+ },
4323
+ {
4324
+ "component": "ButtonGroup::MenuButton",
4325
+ "status": "alpha",
4326
+ "a11y_reviewed": false,
4327
+ "short_name": "ButtonGroupMenuButton",
4328
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group/menu_button.rb",
4329
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/menu_button/default/",
4330
+ "parameters": [
4331
+ {
4332
+ "name": "menu_arguments",
4333
+ "type": "Hash",
4334
+ "default": "`{}`",
4335
+ "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
4280
4336
  },
4281
4337
  {
4282
- "name": "variant",
4283
- "type": "Symbol",
4284
- "default": "`:none`",
4285
- "description": "One of `:inline`, `:large`, or `:none`."
4338
+ "name": "button_arguments",
4339
+ "type": "Hash",
4340
+ "default": "`{}`",
4341
+ "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
4342
+ }
4343
+ ]
4344
+ },
4345
+ {
4346
+ "component": "ClipboardCopy",
4347
+ "status": "beta",
4348
+ "a11y_reviewed": false,
4349
+ "short_name": "ClipboardCopy",
4350
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy.rb",
4351
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy/default/",
4352
+ "parameters": [
4353
+ {
4354
+ "name": "aria-label",
4355
+ "type": "String",
4356
+ "default": "N/A",
4357
+ "description": "String that will be read to screenreaders when the component is focused"
4358
+ },
4359
+ {
4360
+ "name": "value",
4361
+ "type": "String",
4362
+ "default": "`nil`",
4363
+ "description": "Text to copy into the users clipboard when they click the component."
4364
+ },
4365
+ {
4366
+ "name": "for",
4367
+ "type": "String",
4368
+ "default": "N/A",
4369
+ "description": "Element id from where to get the copied value."
4286
4370
  },
4287
4371
  {
4288
4372
  "name": "system_arguments",
@@ -4293,36 +4377,42 @@
4293
4377
  ]
4294
4378
  },
4295
4379
  {
4296
- "component": "Link",
4380
+ "component": "ClipboardCopyBaseButton",
4297
4381
  "status": "beta",
4298
4382
  "a11y_reviewed": false,
4299
- "short_name": "Link",
4300
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/link.rb",
4301
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/link/default/",
4383
+ "short_name": "ClipboardCopyBaseButton",
4384
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy_base_button.rb",
4385
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy_base_button/default/",
4302
4386
  "parameters": [
4303
4387
  {
4304
- "name": "href",
4305
- "type": "String",
4306
- "default": "`nil`",
4307
- "description": "URL to be used for the Link. Required. If the requirements are not met an error will be raised in non production environments. In production, an empty link element will be rendered."
4388
+ "name": "tag",
4389
+ "type": "Symbol",
4390
+ "default": "`:button`",
4391
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4308
4392
  },
4309
4393
  {
4310
- "name": "scheme",
4394
+ "name": "type",
4311
4395
  "type": "Symbol",
4312
- "default": "`:default`",
4313
- "description": "One of `:default`, `:primary`, or `:secondary`."
4396
+ "default": "`:button`",
4397
+ "description": "One of `:button`, `:reset`, or `:submit`."
4314
4398
  },
4315
4399
  {
4316
- "name": "muted",
4400
+ "name": "block",
4317
4401
  "type": "Boolean",
4318
4402
  "default": "`false`",
4319
- "description": "Uses light gray for Link color, and blue on hover."
4403
+ "description": "Whether button is full-width with `display: block`."
4320
4404
  },
4321
4405
  {
4322
- "name": "underline",
4406
+ "name": "disabled",
4323
4407
  "type": "Boolean",
4324
4408
  "default": "`false`",
4325
- "description": "Whether or not to underline the link."
4409
+ "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4410
+ },
4411
+ {
4412
+ "name": "inactive",
4413
+ "type": "Boolean",
4414
+ "default": "`false`",
4415
+ "description": "Whether the button looks visually disabled, but can still accept all the same interactions as an enabled button."
4326
4416
  },
4327
4417
  {
4328
4418
  "name": "system_arguments",
@@ -4333,40 +4423,40 @@
4333
4423
  ]
4334
4424
  },
4335
4425
  {
4336
- "component": "Markdown",
4426
+ "component": "ClipboardCopyButton",
4337
4427
  "status": "beta",
4338
4428
  "a11y_reviewed": false,
4339
- "short_name": "Markdown",
4340
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/markdown.rb",
4341
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/markdown/default/",
4429
+ "short_name": "ClipboardCopyButton",
4430
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/clipboard_copy_button.rb",
4431
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/clipboard_copy_button/default/",
4342
4432
  "parameters": [
4343
- {
4344
- "name": "tag",
4345
- "type": "Symbol",
4346
- "default": "`:div`",
4347
- "description": "One of `:article`, `:div`, or `:td`."
4348
- },
4349
4433
  {
4350
4434
  "name": "system_arguments",
4351
4435
  "type": "Hash",
4352
4436
  "default": "N/A",
4353
- "description": "[System arguments](/system-arguments)"
4437
+ "description": "The arguments accepted by [Button](/components/beta/button) and [ClipboardCopy](/components/beta/clipboardcopy)."
4354
4438
  }
4355
4439
  ]
4356
4440
  },
4357
4441
  {
4358
- "component": "NavList",
4442
+ "component": "CloseButton",
4359
4443
  "status": "beta",
4360
- "a11y_reviewed": true,
4361
- "short_name": "NavList",
4362
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list.rb",
4363
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/default/",
4444
+ "a11y_reviewed": false,
4445
+ "short_name": "CloseButton",
4446
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/close_button.rb",
4447
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/close_button/default/",
4364
4448
  "parameters": [
4365
4449
  {
4366
- "name": "selected_item_id",
4450
+ "name": "type",
4367
4451
  "type": "Symbol",
4368
- "default": "`nil`",
4369
- "description": "The ID of the currently selected item. The default is `nil`, meaning no item is selected."
4452
+ "default": "`:button`",
4453
+ "description": "One of `:button` or `:submit`."
4454
+ },
4455
+ {
4456
+ "name": "disabled",
4457
+ "type": "Boolean",
4458
+ "default": "`false`",
4459
+ "description": "Whether or not the button is disabled."
4370
4460
  },
4371
4461
  {
4372
4462
  "name": "system_arguments",
@@ -4377,18 +4467,48 @@
4377
4467
  ]
4378
4468
  },
4379
4469
  {
4380
- "component": "NavList::Divider",
4381
- "status": "alpha",
4470
+ "component": "Counter",
4471
+ "status": "beta",
4382
4472
  "a11y_reviewed": false,
4383
- "short_name": "NavListDivider",
4384
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/divider.rb",
4385
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/divider/default/",
4473
+ "short_name": "Counter",
4474
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/counter.rb",
4475
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/counter/default/",
4386
4476
  "parameters": [
4477
+ {
4478
+ "name": "count",
4479
+ "type": "Integer, Float::INFINITY, nil",
4480
+ "default": "`0`",
4481
+ "description": "The number to be displayed (e.x. # of issues, pull requests)"
4482
+ },
4387
4483
  {
4388
4484
  "name": "scheme",
4389
4485
  "type": "Symbol",
4390
- "default": "`:subtle`",
4391
- "description": "Display a background color if scheme is `filled`."
4486
+ "default": "`:default`",
4487
+ "description": "Color scheme. One of `:default`, `:primary`, or `:secondary`."
4488
+ },
4489
+ {
4490
+ "name": "limit",
4491
+ "type": "Integer, nil",
4492
+ "default": "`5_000`",
4493
+ "description": "Maximum value to display. Pass `nil` for no limit. (e.x. if `count` == 6,000 and `limit` == 5000, counter will display \"5,000+\")"
4494
+ },
4495
+ {
4496
+ "name": "hide_if_zero",
4497
+ "type": "Boolean",
4498
+ "default": "`false`",
4499
+ "description": "If true, a `hidden` attribute is added to the counter if `count` is zero."
4500
+ },
4501
+ {
4502
+ "name": "text",
4503
+ "type": "String",
4504
+ "default": "`\"\"`",
4505
+ "description": "Text to display instead of count."
4506
+ },
4507
+ {
4508
+ "name": "round",
4509
+ "type": "Boolean",
4510
+ "default": "`false`",
4511
+ "description": "Whether to apply our standard rounding logic to value."
4392
4512
  },
4393
4513
  {
4394
4514
  "name": "system_arguments",
@@ -4399,18 +4519,30 @@
4399
4519
  ]
4400
4520
  },
4401
4521
  {
4402
- "component": "NavList::Group",
4403
- "status": "alpha",
4404
- "a11y_reviewed": true,
4405
- "short_name": "NavListGroup",
4406
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/group.rb",
4407
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/group/default/",
4522
+ "component": "Details",
4523
+ "status": "beta",
4524
+ "a11y_reviewed": false,
4525
+ "short_name": "Details",
4526
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/details.rb",
4527
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/details/default/",
4408
4528
  "parameters": [
4409
4529
  {
4410
- "name": "selected_item_id",
4530
+ "name": "overlay",
4411
4531
  "type": "Symbol",
4412
- "default": "`nil`",
4413
- "description": "The ID of the currently selected item. Used internally."
4532
+ "default": "`:none`",
4533
+ "description": "Dictates the type of overlay to render with. One of `:dark`, `:default`, or `:none`."
4534
+ },
4535
+ {
4536
+ "name": "reset",
4537
+ "type": "Boolean",
4538
+ "default": "`false`",
4539
+ "description": "Defaults to false. If set to true, it will remove the default caret and remove style from the summary element"
4540
+ },
4541
+ {
4542
+ "name": "disabled",
4543
+ "type": "Boolean",
4544
+ "default": "`false`",
4545
+ "description": "Whether or not to disable the summary button."
4414
4546
  },
4415
4547
  {
4416
4548
  "name": "system_arguments",
@@ -4421,30 +4553,42 @@
4421
4553
  ]
4422
4554
  },
4423
4555
  {
4424
- "component": "NavList::Heading",
4425
- "status": "alpha",
4556
+ "component": "Flash",
4557
+ "status": "deprecated",
4426
4558
  "a11y_reviewed": false,
4427
- "short_name": "NavListHeading",
4428
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/heading.rb",
4429
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/heading/default/",
4559
+ "short_name": "Flash",
4560
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/flash.rb",
4561
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/flash/default/",
4430
4562
  "parameters": [
4431
4563
  {
4432
- "name": "title",
4433
- "type": "String",
4434
- "default": "N/A",
4435
- "description": "The text content of the heading."
4564
+ "name": "full",
4565
+ "type": "Boolean",
4566
+ "default": "`false`",
4567
+ "description": "Whether the component should take up the full width of the screen."
4436
4568
  },
4437
4569
  {
4438
- "name": "id",
4439
- "type": "String",
4440
- "default": "`self.class.generate_id`",
4441
- "description": "The value of the ID HTML attribute. Auto-generated by default."
4570
+ "name": "spacious",
4571
+ "type": "Boolean",
4572
+ "default": "`false`",
4573
+ "description": "Whether to add margin to the bottom of the component."
4442
4574
  },
4443
4575
  {
4444
- "name": "heading_level",
4445
- "type": "Integer",
4446
- "default": "`2`",
4447
- "description": "The heading level, i.e. 2 for an `<h2>`, 3 for an `<h3>`, etc."
4576
+ "name": "dismissible",
4577
+ "type": "Boolean",
4578
+ "default": "`false`",
4579
+ "description": "Whether the component can be dismissed with an X button."
4580
+ },
4581
+ {
4582
+ "name": "icon",
4583
+ "type": "Symbol",
4584
+ "default": "`nil`",
4585
+ "description": "Name of Octicon icon to use."
4586
+ },
4587
+ {
4588
+ "name": "scheme",
4589
+ "type": "Symbol",
4590
+ "default": "`:default`",
4591
+ "description": "One of `:danger`, `:default`, `:success`, or `:warning`."
4448
4592
  },
4449
4593
  {
4450
4594
  "name": "system_arguments",
@@ -4455,36 +4599,94 @@
4455
4599
  ]
4456
4600
  },
4457
4601
  {
4458
- "component": "NavList::Item",
4459
- "status": "alpha",
4602
+ "component": "Heading",
4603
+ "status": "beta",
4460
4604
  "a11y_reviewed": false,
4461
- "short_name": "NavListItem",
4462
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/item.rb",
4463
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/item/default/",
4605
+ "short_name": "Heading",
4606
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/heading.rb",
4607
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/heading/default/",
4464
4608
  "parameters": [
4465
4609
  {
4466
- "name": "selected_item_id",
4610
+ "name": "tag",
4611
+ "type": "String",
4612
+ "default": "N/A",
4613
+ "description": "One of `:h1`, `:h2`, `:h3`, `:h4`, `:h5`, or `:h6`."
4614
+ },
4615
+ {
4616
+ "name": "system_arguments",
4617
+ "type": "Hash",
4618
+ "default": "N/A",
4619
+ "description": "[System arguments](/system-arguments)"
4620
+ }
4621
+ ]
4622
+ },
4623
+ {
4624
+ "component": "IconButton",
4625
+ "status": "beta",
4626
+ "a11y_reviewed": false,
4627
+ "short_name": "IconButton",
4628
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/icon_button.rb",
4629
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/icon_button/default/",
4630
+ "parameters": [
4631
+ {
4632
+ "name": "icon",
4633
+ "type": "String",
4634
+ "default": "N/A",
4635
+ "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4636
+ },
4637
+ {
4638
+ "name": "tag",
4467
4639
  "type": "Symbol",
4468
- "default": "`nil`",
4469
- "description": "The ID of the currently selected list item. Used internally."
4640
+ "default": "N/A",
4641
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
4470
4642
  },
4471
4643
  {
4472
- "name": "selected_by_ids",
4473
- "type": "Array<Symbol>",
4474
- "default": "`[]`",
4475
- "description": "The list of IDs that select this item. In other words, if the `selected_item_id` attribute on the parent `NavList` is set to one of these IDs, the item will appear selected."
4644
+ "name": "scheme",
4645
+ "type": "Symbol",
4646
+ "default": "`:default`",
4647
+ "description": "One of `:danger`, `:default`, `:invisible`, `:primary`, or `:secondary`."
4476
4648
  },
4477
4649
  {
4478
- "name": "expanded",
4650
+ "name": "size",
4651
+ "type": "Symbol",
4652
+ "default": "`:medium`",
4653
+ "description": "One of `:large`, `:medium`, or `:small`."
4654
+ },
4655
+ {
4656
+ "name": "disabled",
4479
4657
  "type": "Boolean",
4480
4658
  "default": "`false`",
4481
- "description": "Whether this item shows (expands) or hides (collapses) its list of sub items."
4659
+ "description": "Whether or not the button is disabled. If true, this option forces `tag:` to `:button`."
4482
4660
  },
4483
4661
  {
4484
- "name": "sub_item",
4662
+ "name": "type",
4663
+ "type": "Symbol",
4664
+ "default": "N/A",
4665
+ "description": "One of `:button`, `:reset`, or `:submit`."
4666
+ },
4667
+ {
4668
+ "name": "aria-label",
4669
+ "type": "String",
4670
+ "default": "N/A",
4671
+ "description": "String that can be read by assistive technology. A label should be short and concise. See the accessibility section for more information."
4672
+ },
4673
+ {
4674
+ "name": "aria-description",
4675
+ "type": "String",
4676
+ "default": "N/A",
4677
+ "description": "String that can be read by assistive technology. A description can be longer as it is intended to provide more context and information. See the accessibility section for more information."
4678
+ },
4679
+ {
4680
+ "name": "show_tooltip",
4485
4681
  "type": "Boolean",
4486
- "default": "`false`",
4487
- "description": "Whether or not this item is nested under a parent item. Used internally."
4682
+ "default": "`true`",
4683
+ "description": "Whether or not to show a tooltip when this button is hovered. Tooltips should only be hidden if the aria label is redundant, i.e. if the icon has a widely understood definition."
4684
+ },
4685
+ {
4686
+ "name": "tooltip_direction",
4687
+ "type": "Symbol",
4688
+ "default": "`:s`",
4689
+ "description": "One of `:e`, `:n`, `:ne`, `:nw`, `:s`, `:se`, `:sw`, or `:w`."
4488
4690
  },
4489
4691
  {
4490
4692
  "name": "system_arguments",
@@ -4495,36 +4697,42 @@
4495
4697
  ]
4496
4698
  },
4497
4699
  {
4498
- "component": "Octicon",
4700
+ "component": "Label",
4499
4701
  "status": "beta",
4500
4702
  "a11y_reviewed": false,
4501
- "short_name": "Octicon",
4502
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/octicon.rb",
4503
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/octicon/default/",
4703
+ "short_name": "Label",
4704
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/label.rb",
4705
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/label/default/",
4504
4706
  "parameters": [
4505
4707
  {
4506
- "name": "icon_name",
4507
- "type": "Symbol, String",
4508
- "default": "`nil`",
4509
- "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4708
+ "name": "tag",
4709
+ "type": "Symbol",
4710
+ "default": "`:span`",
4711
+ "description": "One of `:a`, `:div`, `:span`, or `:summary`."
4510
4712
  },
4511
4713
  {
4512
- "name": "icon",
4513
- "type": "Symbol, String",
4514
- "default": "`nil`",
4515
- "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4714
+ "name": "scheme",
4715
+ "type": "Symbol",
4716
+ "default": "`:default`",
4717
+ "description": "One of `:accent`, `:attention`, `:danger`, `:default`, `:done`, `:info`, `:orange`, `:primary`, `:purple`, `:secondary`, `:severe`, `:sponsors`, `:success`, or `:warning`."
4516
4718
  },
4517
4719
  {
4518
4720
  "name": "size",
4519
4721
  "type": "Symbol",
4520
- "default": "`:small`",
4521
- "description": "One of `:xsmall` (`12`), `:small` (`16`), or `:medium` (`24`)."
4722
+ "default": "`:medium`",
4723
+ "description": "One of `:large` or `:medium`."
4522
4724
  },
4523
4725
  {
4524
- "name": "use_symbol",
4726
+ "name": "inline",
4525
4727
  "type": "Boolean",
4526
4728
  "default": "`false`",
4527
- "description": "EXPERIMENTAL (May change or be removed) - Set to true when using with [OcticonSymbols](/components/alpha/octiconsymbols)."
4729
+ "description": "Whether or not to render this label inline."
4730
+ },
4731
+ {
4732
+ "name": "variant",
4733
+ "type": "Symbol",
4734
+ "default": "`:none`",
4735
+ "description": "One of `:inline`, `:large`, or `:none`."
4528
4736
  },
4529
4737
  {
4530
4738
  "name": "system_arguments",
@@ -4535,13 +4743,37 @@
4535
4743
  ]
4536
4744
  },
4537
4745
  {
4538
- "component": "Popover",
4746
+ "component": "Link",
4539
4747
  "status": "beta",
4540
4748
  "a11y_reviewed": false,
4541
- "short_name": "Popover",
4542
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/popover.rb",
4543
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/popover/default/",
4749
+ "short_name": "Link",
4750
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/link.rb",
4751
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/link/default/",
4544
4752
  "parameters": [
4753
+ {
4754
+ "name": "href",
4755
+ "type": "String",
4756
+ "default": "`nil`",
4757
+ "description": "URL to be used for the Link. Required. If the requirements are not met an error will be raised in non production environments. In production, an empty link element will be rendered."
4758
+ },
4759
+ {
4760
+ "name": "scheme",
4761
+ "type": "Symbol",
4762
+ "default": "`:default`",
4763
+ "description": "One of `:default`, `:primary`, or `:secondary`."
4764
+ },
4765
+ {
4766
+ "name": "muted",
4767
+ "type": "Boolean",
4768
+ "default": "`false`",
4769
+ "description": "Uses light gray for Link color, and blue on hover."
4770
+ },
4771
+ {
4772
+ "name": "underline",
4773
+ "type": "Boolean",
4774
+ "default": "`false`",
4775
+ "description": "Whether or not to underline the link."
4776
+ },
4545
4777
  {
4546
4778
  "name": "system_arguments",
4547
4779
  "type": "Hash",
@@ -4551,18 +4783,18 @@
4551
4783
  ]
4552
4784
  },
4553
4785
  {
4554
- "component": "ProgressBar",
4786
+ "component": "Markdown",
4555
4787
  "status": "beta",
4556
4788
  "a11y_reviewed": false,
4557
- "short_name": "ProgressBar",
4558
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/progress_bar.rb",
4559
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/progress_bar/default/",
4789
+ "short_name": "Markdown",
4790
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/markdown.rb",
4791
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/markdown/default/",
4560
4792
  "parameters": [
4561
4793
  {
4562
- "name": "size",
4794
+ "name": "tag",
4563
4795
  "type": "Symbol",
4564
- "default": "`:default`",
4565
- "description": "One of `:default`, `:large`, or `:small`. Increases height."
4796
+ "default": "`:div`",
4797
+ "description": "One of `:article`, `:div`, or `:td`."
4566
4798
  },
4567
4799
  {
4568
4800
  "name": "system_arguments",
@@ -4573,36 +4805,254 @@
4573
4805
  ]
4574
4806
  },
4575
4807
  {
4576
- "component": "RelativeTime",
4808
+ "component": "NavList",
4577
4809
  "status": "beta",
4578
- "a11y_reviewed": false,
4579
- "short_name": "RelativeTime",
4580
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/relative_time.rb",
4581
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/relative_time/default/",
4810
+ "a11y_reviewed": true,
4811
+ "short_name": "NavList",
4812
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list.rb",
4813
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/default/",
4582
4814
  "parameters": [
4583
4815
  {
4584
- "name": "datetime",
4585
- "type": "Time",
4586
- "default": "N/A",
4587
- "description": "The time to be formatted."
4588
- },
4589
- {
4590
- "name": "tense",
4816
+ "name": "selected_item_id",
4591
4817
  "type": "Symbol",
4592
- "default": "`:auto`",
4593
- "description": "Which tense to use. One of `:auto`, `:future`, or `:past`."
4594
- },
4595
- {
4596
- "name": "prefix",
4597
- "type": "String",
4598
4818
  "default": "`nil`",
4599
- "description": "What to prefix the relative time display with."
4819
+ "description": "The ID of the currently selected item. The default is `nil`, meaning no item is selected."
4600
4820
  },
4601
4821
  {
4602
- "name": "second",
4822
+ "name": "system_arguments",
4823
+ "type": "Hash",
4824
+ "default": "N/A",
4825
+ "description": "[System arguments](/system-arguments)"
4826
+ }
4827
+ ]
4828
+ },
4829
+ {
4830
+ "component": "NavList::Divider",
4831
+ "status": "alpha",
4832
+ "a11y_reviewed": false,
4833
+ "short_name": "NavListDivider",
4834
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/divider.rb",
4835
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/divider/default/",
4836
+ "parameters": [
4837
+ {
4838
+ "name": "scheme",
4603
4839
  "type": "Symbol",
4604
- "default": "`SECOND_DEFAULT`",
4605
- "description": "What format seconds should take. One of `nil`, `:numeric`, or `:two_digit`."
4840
+ "default": "`:subtle`",
4841
+ "description": "Display a background color if scheme is `filled`."
4842
+ },
4843
+ {
4844
+ "name": "system_arguments",
4845
+ "type": "Hash",
4846
+ "default": "N/A",
4847
+ "description": "[System arguments](/system-arguments)"
4848
+ }
4849
+ ]
4850
+ },
4851
+ {
4852
+ "component": "NavList::Group",
4853
+ "status": "alpha",
4854
+ "a11y_reviewed": true,
4855
+ "short_name": "NavListGroup",
4856
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/group.rb",
4857
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/group/default/",
4858
+ "parameters": [
4859
+ {
4860
+ "name": "selected_item_id",
4861
+ "type": "Symbol",
4862
+ "default": "`nil`",
4863
+ "description": "The ID of the currently selected item. Used internally."
4864
+ },
4865
+ {
4866
+ "name": "system_arguments",
4867
+ "type": "Hash",
4868
+ "default": "N/A",
4869
+ "description": "[System arguments](/system-arguments)"
4870
+ }
4871
+ ]
4872
+ },
4873
+ {
4874
+ "component": "NavList::Heading",
4875
+ "status": "alpha",
4876
+ "a11y_reviewed": false,
4877
+ "short_name": "NavListHeading",
4878
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/heading.rb",
4879
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/heading/default/",
4880
+ "parameters": [
4881
+ {
4882
+ "name": "title",
4883
+ "type": "String",
4884
+ "default": "N/A",
4885
+ "description": "The text content of the heading."
4886
+ },
4887
+ {
4888
+ "name": "id",
4889
+ "type": "String",
4890
+ "default": "`self.class.generate_id`",
4891
+ "description": "The value of the ID HTML attribute. Auto-generated by default."
4892
+ },
4893
+ {
4894
+ "name": "heading_level",
4895
+ "type": "Integer",
4896
+ "default": "`2`",
4897
+ "description": "The heading level, i.e. 2 for an `<h2>`, 3 for an `<h3>`, etc."
4898
+ },
4899
+ {
4900
+ "name": "system_arguments",
4901
+ "type": "Hash",
4902
+ "default": "N/A",
4903
+ "description": "[System arguments](/system-arguments)"
4904
+ }
4905
+ ]
4906
+ },
4907
+ {
4908
+ "component": "NavList::Item",
4909
+ "status": "alpha",
4910
+ "a11y_reviewed": false,
4911
+ "short_name": "NavListItem",
4912
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/nav_list/item.rb",
4913
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/nav_list/item/default/",
4914
+ "parameters": [
4915
+ {
4916
+ "name": "selected_item_id",
4917
+ "type": "Symbol",
4918
+ "default": "`nil`",
4919
+ "description": "The ID of the currently selected list item. Used internally."
4920
+ },
4921
+ {
4922
+ "name": "selected_by_ids",
4923
+ "type": "Array<Symbol>",
4924
+ "default": "`[]`",
4925
+ "description": "The list of IDs that select this item. In other words, if the `selected_item_id` attribute on the parent `NavList` is set to one of these IDs, the item will appear selected."
4926
+ },
4927
+ {
4928
+ "name": "expanded",
4929
+ "type": "Boolean",
4930
+ "default": "`false`",
4931
+ "description": "Whether this item shows (expands) or hides (collapses) its list of sub items."
4932
+ },
4933
+ {
4934
+ "name": "sub_item",
4935
+ "type": "Boolean",
4936
+ "default": "`false`",
4937
+ "description": "Whether or not this item is nested under a parent item. Used internally."
4938
+ },
4939
+ {
4940
+ "name": "system_arguments",
4941
+ "type": "Hash",
4942
+ "default": "N/A",
4943
+ "description": "[System arguments](/system-arguments)"
4944
+ }
4945
+ ]
4946
+ },
4947
+ {
4948
+ "component": "Octicon",
4949
+ "status": "beta",
4950
+ "a11y_reviewed": false,
4951
+ "short_name": "Octicon",
4952
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/octicon.rb",
4953
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/octicon/default/",
4954
+ "parameters": [
4955
+ {
4956
+ "name": "icon_name",
4957
+ "type": "Symbol, String",
4958
+ "default": "`nil`",
4959
+ "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4960
+ },
4961
+ {
4962
+ "name": "icon",
4963
+ "type": "Symbol, String",
4964
+ "default": "`nil`",
4965
+ "description": "Name of [Octicon](https://primer.style/octicons/) to use."
4966
+ },
4967
+ {
4968
+ "name": "size",
4969
+ "type": "Symbol",
4970
+ "default": "`:small`",
4971
+ "description": "One of `:xsmall` (`12`), `:small` (`16`), or `:medium` (`24`)."
4972
+ },
4973
+ {
4974
+ "name": "use_symbol",
4975
+ "type": "Boolean",
4976
+ "default": "`false`",
4977
+ "description": "EXPERIMENTAL (May change or be removed) - Set to true when using with [OcticonSymbols](/components/alpha/octiconsymbols)."
4978
+ },
4979
+ {
4980
+ "name": "system_arguments",
4981
+ "type": "Hash",
4982
+ "default": "N/A",
4983
+ "description": "[System arguments](/system-arguments)"
4984
+ }
4985
+ ]
4986
+ },
4987
+ {
4988
+ "component": "Popover",
4989
+ "status": "beta",
4990
+ "a11y_reviewed": false,
4991
+ "short_name": "Popover",
4992
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/popover.rb",
4993
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/popover/default/",
4994
+ "parameters": [
4995
+ {
4996
+ "name": "system_arguments",
4997
+ "type": "Hash",
4998
+ "default": "N/A",
4999
+ "description": "[System arguments](/system-arguments)"
5000
+ }
5001
+ ]
5002
+ },
5003
+ {
5004
+ "component": "ProgressBar",
5005
+ "status": "beta",
5006
+ "a11y_reviewed": false,
5007
+ "short_name": "ProgressBar",
5008
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/progress_bar.rb",
5009
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/progress_bar/default/",
5010
+ "parameters": [
5011
+ {
5012
+ "name": "size",
5013
+ "type": "Symbol",
5014
+ "default": "`:default`",
5015
+ "description": "One of `:default`, `:large`, or `:small`. Increases height."
5016
+ },
5017
+ {
5018
+ "name": "system_arguments",
5019
+ "type": "Hash",
5020
+ "default": "N/A",
5021
+ "description": "[System arguments](/system-arguments)"
5022
+ }
5023
+ ]
5024
+ },
5025
+ {
5026
+ "component": "RelativeTime",
5027
+ "status": "beta",
5028
+ "a11y_reviewed": false,
5029
+ "short_name": "RelativeTime",
5030
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/relative_time.rb",
5031
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/relative_time/default/",
5032
+ "parameters": [
5033
+ {
5034
+ "name": "datetime",
5035
+ "type": "Time",
5036
+ "default": "N/A",
5037
+ "description": "The time to be formatted."
5038
+ },
5039
+ {
5040
+ "name": "tense",
5041
+ "type": "Symbol",
5042
+ "default": "`:auto`",
5043
+ "description": "Which tense to use. One of `:auto`, `:future`, or `:past`."
5044
+ },
5045
+ {
5046
+ "name": "prefix",
5047
+ "type": "String",
5048
+ "default": "`nil`",
5049
+ "description": "What to prefix the relative time display with."
5050
+ },
5051
+ {
5052
+ "name": "second",
5053
+ "type": "Symbol",
5054
+ "default": "`SECOND_DEFAULT`",
5055
+ "description": "What format seconds should take. One of `nil`, `:numeric`, or `:two_digit`."
4606
5056
  },
4607
5057
  {
4608
5058
  "name": "minute",
@@ -4688,6 +5138,12 @@
4688
5138
  "default": "`false`",
4689
5139
  "description": "Removes the `title` attribute provided on the element by default."
4690
5140
  },
5141
+ {
5142
+ "name": "aria_hidden",
5143
+ "type": "Boolean",
5144
+ "default": "`nil`",
5145
+ "description": "Set if the element is hidden or not."
5146
+ },
4691
5147
  {
4692
5148
  "name": "system_arguments",
4693
5149
  "type": "Hash",
@@ -4915,375 +5371,58 @@
4915
5371
  "description": "Alt text for image."
4916
5372
  },
4917
5373
  {
4918
- "name": "description",
4919
- "type": "String",
4920
- "default": "`\"\"`",
4921
- "description": "Text that appears below the title. Typically a whole sentence."
4922
- },
4923
- {
4924
- "name": "button_text",
4925
- "type": "String",
4926
- "default": "`\"\"`",
4927
- "description": "The text of the button."
4928
- },
4929
- {
4930
- "name": "button_url",
4931
- "type": "String",
4932
- "default": "`\"\"`",
4933
- "description": "The URL where the user will be taken after clicking the button."
4934
- },
4935
- {
4936
- "name": "button_classes",
4937
- "type": "String",
4938
- "default": "`\"btn-primary my-3\"`",
4939
- "description": "Classes to apply to action button"
4940
- },
4941
- {
4942
- "name": "link_text",
4943
- "type": "String",
4944
- "default": "`\"\"`",
4945
- "description": "The text of the link."
4946
- },
4947
- {
4948
- "name": "link_url",
4949
- "type": "String",
4950
- "default": "`\"\"`",
4951
- "description": "The URL where the user will be taken after clicking the link."
4952
- },
4953
- {
4954
- "name": "narrow",
4955
- "type": "Boolean",
4956
- "default": "`false`",
4957
- "description": "Adds a maximum width."
4958
- },
4959
- {
4960
- "name": "large",
4961
- "type": "Boolean",
4962
- "default": "`false`",
4963
- "description": "Increases the font size."
4964
- },
4965
- {
4966
- "name": "spacious",
4967
- "type": "Boolean",
4968
- "default": "`false`",
4969
- "description": "Adds extra padding."
4970
- },
4971
- {
4972
- "name": "system_arguments",
4973
- "type": "Hash",
4974
- "default": "N/A",
4975
- "description": "[System arguments](/system-arguments)"
4976
- }
4977
- ]
4978
- },
4979
- {
4980
- "component": "Box",
4981
- "status": "stable",
4982
- "a11y_reviewed": false,
4983
- "short_name": "Box",
4984
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/box.rb",
4985
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/box/default/",
4986
- "parameters": [
4987
- {
4988
- "name": "system_arguments",
4989
- "type": "Hash",
4990
- "default": "N/A",
4991
- "description": "[System arguments](/system-arguments)"
4992
- }
4993
- ]
4994
- },
4995
- {
4996
- "component": "Button",
4997
- "status": "deprecated",
4998
- "a11y_reviewed": false,
4999
- "short_name": "Button",
5000
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/button_component.rb",
5001
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/button/default/",
5002
- "parameters": [
5003
- {
5004
- "name": "scheme",
5005
- "type": "Symbol",
5006
- "default": "`:default`",
5007
- "description": "One of `:danger`, `:default`, `:invisible`, `:link`, `:outline`, or `:primary`."
5008
- },
5009
- {
5010
- "name": "variant",
5011
- "type": "Symbol",
5012
- "default": "`nil`",
5013
- "description": "DEPRECATED. One of `:medium` or `:small`."
5014
- },
5015
- {
5016
- "name": "size",
5017
- "type": "Symbol",
5018
- "default": "`:medium`",
5019
- "description": "One of `:medium` or `:small`."
5020
- },
5021
- {
5022
- "name": "tag",
5023
- "type": "Symbol",
5024
- "default": "`:button`",
5025
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
5026
- },
5027
- {
5028
- "name": "type",
5029
- "type": "Symbol",
5030
- "default": "`:button`",
5031
- "description": "One of `:button`, `:reset`, or `:submit`."
5032
- },
5033
- {
5034
- "name": "group_item",
5035
- "type": "Boolean",
5036
- "default": "`false`",
5037
- "description": "Whether button is part of a ButtonGroup."
5038
- },
5039
- {
5040
- "name": "block",
5041
- "type": "Boolean",
5042
- "default": "`false`",
5043
- "description": "Whether button is full-width with `display: block`."
5044
- },
5045
- {
5046
- "name": "dropdown",
5047
- "type": "Boolean",
5048
- "default": "`false`",
5049
- "description": "Whether or not to render a dropdown caret."
5050
- },
5051
- {
5052
- "name": "system_arguments",
5053
- "type": "Hash",
5054
- "default": "N/A",
5055
- "description": "[System arguments](/system-arguments)"
5056
- }
5057
- ]
5058
- },
5059
- {
5060
- "component": "ConditionalWrapper",
5061
- "status": "alpha",
5062
- "a11y_reviewed": false,
5063
- "short_name": "ConditionalWrapper",
5064
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/conditional_wrapper.rb",
5065
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/conditional_wrapper/default/",
5066
- "parameters": [
5067
- {
5068
- "name": "condition",
5069
- "type": "Boolean",
5070
- "default": "N/A",
5071
- "description": "Whether or not to wrap the content in a component."
5072
- },
5073
- {
5074
- "name": "component",
5075
- "type": "Class",
5076
- "default": "`Primer::BaseComponent`",
5077
- "description": "The component class to use as a wrapper, defaults to `Primer::BaseComponent`"
5078
- },
5079
- {
5080
- "name": "base_component_arguments",
5081
- "type": "Hash",
5082
- "default": "N/A",
5083
- "description": "The arguments to pass to the component."
5084
- }
5085
- ]
5086
- },
5087
- {
5088
- "component": "Content",
5089
- "status": "stable",
5090
- "a11y_reviewed": false,
5091
- "short_name": "Content",
5092
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/content.rb",
5093
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/content/default/",
5094
- "parameters": []
5095
- },
5096
- {
5097
- "component": "IconButton",
5098
- "status": "deprecated",
5099
- "a11y_reviewed": false,
5100
- "short_name": "IconButton",
5101
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/icon_button.rb",
5102
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/icon_button/default/",
5103
- "parameters": [
5104
- {
5105
- "name": "scheme",
5106
- "type": "Symbol",
5107
- "default": "`:default`",
5108
- "description": "One of `:danger` or `:default`."
5109
- },
5110
- {
5111
- "name": "icon",
5112
- "type": "String",
5113
- "default": "N/A",
5114
- "description": "Name of [Octicon](https://primer.style/octicons/) to use."
5115
- },
5116
- {
5117
- "name": "tag",
5118
- "type": "Symbol",
5119
- "default": "N/A",
5120
- "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
5121
- },
5122
- {
5123
- "name": "type",
5124
- "type": "Symbol",
5125
- "default": "N/A",
5126
- "description": "One of `:button`, `:reset`, or `:submit`."
5127
- },
5128
- {
5129
- "name": "aria-label",
5130
- "type": "String",
5131
- "default": "N/A",
5132
- "description": "String that can be read by assistive technology. A label should be short and concise. See the accessibility section for more information."
5133
- },
5134
- {
5135
- "name": "aria-description",
5136
- "type": "String",
5137
- "default": "N/A",
5138
- "description": "String that can be read by assistive technology. A description can be longer as it is intended to provide more context and information. See the accessibility section for more information."
5139
- },
5140
- {
5141
- "name": "tooltip_direction",
5142
- "type": "Symbol",
5143
- "default": "`:s`",
5144
- "description": "One of `:e`, `:n`, `:ne`, `:nw`, `:s`, `:se`, `:sw`, or `:w`."
5145
- },
5146
- {
5147
- "name": "box",
5148
- "type": "Boolean",
5149
- "default": "`false`",
5150
- "description": "Whether the button is in a [BorderBox](/components/beta/borderbox). If `true`, the button will have the `Box-btn-octicon` class."
5151
- },
5152
- {
5153
- "name": "system_arguments",
5154
- "type": "Hash",
5155
- "default": "N/A",
5156
- "description": "[System arguments](/system-arguments)"
5157
- }
5158
- ]
5159
- },
5160
- {
5161
- "component": "Layout",
5162
- "status": "deprecated",
5163
- "a11y_reviewed": false,
5164
- "short_name": "Layout",
5165
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/layout_component.rb",
5166
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/layout/default/",
5167
- "parameters": [
5168
- {
5169
- "name": "responsive",
5170
- "type": "Boolean",
5171
- "default": "`false`",
5172
- "description": "Whether to collapse layout to a single column at smaller widths."
5173
- },
5174
- {
5175
- "name": "side",
5176
- "type": "Symbol",
5177
- "default": "`:right`",
5178
- "description": "Which side to display the sidebar on. One of `:left` or `:right`."
5179
- },
5180
- {
5181
- "name": "sidebar_col",
5182
- "type": "Integer",
5183
- "default": "`3`",
5184
- "description": "Sidebar column width."
5185
- },
5186
- {
5187
- "name": "system_arguments",
5188
- "type": "Hash",
5189
- "default": "N/A",
5190
- "description": "[System arguments](/system-arguments)"
5191
- }
5192
- ]
5193
- },
5194
- {
5195
- "component": "Navigation::Tab",
5196
- "status": "deprecated",
5197
- "a11y_reviewed": false,
5198
- "short_name": "NavigationTab",
5199
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/navigation/tab_component.rb",
5200
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/navigation/tab/default/",
5201
- "parameters": [
5202
- {
5203
- "name": "list",
5204
- "type": "Boolean",
5205
- "default": "`false`",
5206
- "description": "Whether the Tab is an item in a `<ul>` list."
5207
- },
5208
- {
5209
- "name": "selected",
5210
- "type": "Boolean",
5211
- "default": "`false`",
5212
- "description": "Whether the Tab is selected or not."
5213
- },
5214
- {
5215
- "name": "with_panel",
5216
- "type": "Boolean",
5217
- "default": "`false`",
5218
- "description": "Whether the Tab has an associated panel."
5219
- },
5220
- {
5221
- "name": "panel_id",
5374
+ "name": "description",
5222
5375
  "type": "String",
5223
5376
  "default": "`\"\"`",
5224
- "description": "Only applies if `with_panel` is `true`. Unique id of panel."
5377
+ "description": "Text that appears below the title. Typically a whole sentence."
5225
5378
  },
5226
5379
  {
5227
- "name": "icon_classes",
5228
- "type": "Boolean",
5380
+ "name": "button_text",
5381
+ "type": "String",
5229
5382
  "default": "`\"\"`",
5230
- "description": "Classes that must always be applied to icons."
5383
+ "description": "The text of the button."
5231
5384
  },
5232
5385
  {
5233
- "name": "wrapper_arguments",
5234
- "type": "Hash",
5235
- "default": "`{}`",
5236
- "description": "[System arguments](/system-arguments) to be used in the `<li>` wrapper when the tab is an item in a list."
5386
+ "name": "button_url",
5387
+ "type": "String",
5388
+ "default": "`\"\"`",
5389
+ "description": "The URL where the user will be taken after clicking the button."
5237
5390
  },
5238
5391
  {
5239
- "name": "system_arguments",
5240
- "type": "Hash",
5241
- "default": "N/A",
5242
- "description": "[System arguments](/system-arguments)"
5243
- }
5244
- ]
5245
- },
5246
- {
5247
- "component": "OpenProject::BorderBox::CollapsibleHeader",
5248
- "status": "open_project",
5249
- "a11y_reviewed": false,
5250
- "short_name": "OpenProjectBorderBoxCollapsibleHeader",
5251
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_box/collapsible_header.rb",
5252
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_box/collapsible_header/default/",
5253
- "parameters": [
5392
+ "name": "button_classes",
5393
+ "type": "String",
5394
+ "default": "`\"btn-primary my-3\"`",
5395
+ "description": "Classes to apply to action button"
5396
+ },
5254
5397
  {
5255
- "name": "id",
5398
+ "name": "link_text",
5256
5399
  "type": "String",
5257
- "default": "`self.class.generate_id`",
5258
- "description": "The unique ID of the collapsible header."
5400
+ "default": "`\"\"`",
5401
+ "description": "The text of the link."
5259
5402
  },
5260
5403
  {
5261
- "name": "collapsed",
5404
+ "name": "link_url",
5405
+ "type": "String",
5406
+ "default": "`\"\"`",
5407
+ "description": "The URL where the user will be taken after clicking the link."
5408
+ },
5409
+ {
5410
+ "name": "narrow",
5262
5411
  "type": "Boolean",
5263
5412
  "default": "`false`",
5264
- "description": "Whether the header is collapsed on initial render."
5413
+ "description": "Adds a maximum width."
5265
5414
  },
5266
5415
  {
5267
- "name": "system_arguments",
5268
- "type": "Hash",
5269
- "default": "N/A",
5270
- "description": "[System arguments](/system-arguments)"
5271
- }
5272
- ]
5273
- },
5274
- {
5275
- "component": "OpenProject::BorderGrid",
5276
- "status": "open_project",
5277
- "a11y_reviewed": false,
5278
- "short_name": "OpenProjectBorderGrid",
5279
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_grid.rb",
5280
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_grid/default/",
5281
- "parameters": [
5416
+ "name": "large",
5417
+ "type": "Boolean",
5418
+ "default": "`false`",
5419
+ "description": "Increases the font size."
5420
+ },
5282
5421
  {
5283
5422
  "name": "spacious",
5284
5423
  "type": "Boolean",
5285
5424
  "default": "`false`",
5286
- "description": "Whether to add margin to the bottom of the component."
5425
+ "description": "Adds extra padding."
5287
5426
  },
5288
5427
  {
5289
5428
  "name": "system_arguments",
@@ -5294,12 +5433,12 @@
5294
5433
  ]
5295
5434
  },
5296
5435
  {
5297
- "component": "OpenProject::BorderGrid::Cell",
5298
- "status": "open_project",
5436
+ "component": "Box",
5437
+ "status": "stable",
5299
5438
  "a11y_reviewed": false,
5300
- "short_name": "OpenProjectBorderGridCell",
5301
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_grid/cell.rb",
5302
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_grid/cell/default/",
5439
+ "short_name": "Box",
5440
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/box.rb",
5441
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/box/default/",
5303
5442
  "parameters": [
5304
5443
  {
5305
5444
  "name": "system_arguments",
@@ -5310,70 +5449,60 @@
5310
5449
  ]
5311
5450
  },
5312
5451
  {
5313
- "component": "OpenProject::CollapsibleSection",
5314
- "status": "open_project",
5452
+ "component": "Button",
5453
+ "status": "deprecated",
5315
5454
  "a11y_reviewed": false,
5316
- "short_name": "OpenProjectCollapsibleSection",
5317
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/collapsible_section.rb",
5318
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/collapsible_section/default/",
5455
+ "short_name": "Button",
5456
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/button_component.rb",
5457
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/button/default/",
5319
5458
  "parameters": [
5320
5459
  {
5321
- "name": "id",
5322
- "type": "String",
5323
- "default": "`self.class.generate_id`",
5324
- "description": "The unique ID of the collapsible section."
5460
+ "name": "scheme",
5461
+ "type": "Symbol",
5462
+ "default": "`:default`",
5463
+ "description": "One of `:danger`, `:default`, `:invisible`, `:link`, `:outline`, or `:primary`."
5325
5464
  },
5326
5465
  {
5327
- "name": "collapsed",
5328
- "type": "Boolean",
5329
- "default": "`false`",
5330
- "description": "Whether the section is collapsed on initial render."
5466
+ "name": "variant",
5467
+ "type": "Symbol",
5468
+ "default": "`nil`",
5469
+ "description": "DEPRECATED. One of `:medium` or `:small`."
5331
5470
  },
5332
5471
  {
5333
- "name": "system_arguments",
5334
- "type": "Hash",
5335
- "default": "N/A",
5336
- "description": "[System arguments](/system-arguments)"
5337
- }
5338
- ]
5339
- },
5340
- {
5341
- "component": "OpenProject::DangerDialog",
5342
- "status": "open_project",
5343
- "a11y_reviewed": false,
5344
- "short_name": "OpenProjectDangerDialog",
5345
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog.rb",
5346
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/default/",
5347
- "parameters": [
5472
+ "name": "size",
5473
+ "type": "Symbol",
5474
+ "default": "`:medium`",
5475
+ "description": "One of `:medium` or `:small`."
5476
+ },
5348
5477
  {
5349
- "name": "form_arguments",
5350
- "type": "Hash",
5351
- "default": "`{}`",
5352
- "description": "Allows the dialog to submit a form. Pass EITHER the `builder:` option to this hash to reuse an existing Rails form, or `action:` if you prefer the component to render the form tag itself. `builder:` should be an instance of `ActionView::Helpers::FormBuilder`, which is created by the standard Rails `#form_with` and `#form_for` helpers. The `name:` option is the desired name of the field that will be included in the params sent to the server on form submission."
5478
+ "name": "tag",
5479
+ "type": "Symbol",
5480
+ "default": "`:button`",
5481
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
5353
5482
  },
5354
5483
  {
5355
- "name": "id",
5356
- "type": "String",
5357
- "default": "`self.class.generate_id`",
5358
- "description": "The id of the dialog."
5484
+ "name": "type",
5485
+ "type": "Symbol",
5486
+ "default": "`:button`",
5487
+ "description": "One of `:button`, `:reset`, or `:submit`."
5359
5488
  },
5360
5489
  {
5361
- "name": "title",
5362
- "type": "String",
5363
- "default": "N/A",
5364
- "description": "The title of the dialog. Although visually hidden, a label is rendered for assistive technologies."
5490
+ "name": "group_item",
5491
+ "type": "Boolean",
5492
+ "default": "`false`",
5493
+ "description": "Whether button is part of a ButtonGroup."
5365
5494
  },
5366
5495
  {
5367
- "name": "confirm_button_text",
5368
- "type": "String",
5369
- "default": "`nil`",
5370
- "description": "The text of the confirm button. Will default to `I18n.t(\"button_delete\")`, or `I18n.t(\"button_delete_permanently\")` if `confirmation_check_box` slot has been passed to the component."
5496
+ "name": "block",
5497
+ "type": "Boolean",
5498
+ "default": "`false`",
5499
+ "description": "Whether button is full-width with `display: block`."
5371
5500
  },
5372
5501
  {
5373
- "name": "cancel_button_text",
5374
- "type": "String",
5375
- "default": "`nil`",
5376
- "description": "The text of the cancel button. Will default to `I18n.t(\"button_cancel\")`."
5502
+ "name": "dropdown",
5503
+ "type": "Boolean",
5504
+ "default": "`false`",
5505
+ "description": "Whether or not to render a dropdown caret."
5377
5506
  },
5378
5507
  {
5379
5508
  "name": "system_arguments",
@@ -5384,99 +5513,97 @@
5384
5513
  ]
5385
5514
  },
5386
5515
  {
5387
- "component": "OpenProject::DangerDialog::ConfirmationCheckBox",
5388
- "status": "open_project",
5516
+ "component": "ConditionalWrapper",
5517
+ "status": "alpha",
5389
5518
  "a11y_reviewed": false,
5390
- "short_name": "OpenProjectDangerDialogConfirmationCheckBox",
5391
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog/confirmation_check_box.rb",
5392
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/confirmation_check_box/default/",
5519
+ "short_name": "ConditionalWrapper",
5520
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/conditional_wrapper.rb",
5521
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/conditional_wrapper/default/",
5393
5522
  "parameters": [
5394
5523
  {
5395
- "name": "check_box_id",
5396
- "type": "String",
5397
- "default": "`self.class.generate_id`",
5398
- "description": "The id of the check_box input."
5524
+ "name": "condition",
5525
+ "type": "Boolean",
5526
+ "default": "N/A",
5527
+ "description": "Whether or not to wrap the content in a component."
5399
5528
  },
5400
5529
  {
5401
- "name": "check_box_name",
5402
- "type": "String",
5403
- "default": "N/A",
5404
- "description": "The name of the check_box input."
5530
+ "name": "component",
5531
+ "type": "Class",
5532
+ "default": "`Primer::BaseComponent`",
5533
+ "description": "The component class to use as a wrapper, defaults to `Primer::BaseComponent`"
5405
5534
  },
5406
5535
  {
5407
- "name": "system_arguments",
5536
+ "name": "base_component_arguments",
5408
5537
  "type": "Hash",
5409
5538
  "default": "N/A",
5410
- "description": "[System arguments](/system-arguments)"
5539
+ "description": "The arguments to pass to the component."
5411
5540
  }
5412
5541
  ]
5413
5542
  },
5414
5543
  {
5415
- "component": "OpenProject::DangerDialog::FormWrapper",
5416
- "status": "open_project",
5544
+ "component": "Content",
5545
+ "status": "stable",
5417
5546
  "a11y_reviewed": false,
5418
- "short_name": "OpenProjectDangerDialogFormWrapper",
5419
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog/form_wrapper.rb",
5420
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/form_wrapper/default/",
5547
+ "short_name": "Content",
5548
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/content.rb",
5549
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/content/default/",
5421
5550
  "parameters": []
5422
5551
  },
5423
5552
  {
5424
- "component": "OpenProject::DragHandle",
5425
- "status": "open_project",
5553
+ "component": "IconButton",
5554
+ "status": "deprecated",
5426
5555
  "a11y_reviewed": false,
5427
- "short_name": "OpenProjectDragHandle",
5428
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/drag_handle.rb",
5429
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/drag_handle/default/",
5556
+ "short_name": "IconButton",
5557
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/icon_button.rb",
5558
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/icon_button/default/",
5430
5559
  "parameters": [
5431
5560
  {
5432
- "name": "system_arguments",
5433
- "type": "Hash",
5561
+ "name": "scheme",
5562
+ "type": "Symbol",
5563
+ "default": "`:default`",
5564
+ "description": "One of `:danger` or `:default`."
5565
+ },
5566
+ {
5567
+ "name": "icon",
5568
+ "type": "String",
5434
5569
  "default": "N/A",
5435
- "description": "[System arguments](/system-arguments)"
5436
- }
5437
- ]
5438
- },
5439
- {
5440
- "component": "OpenProject::FeedbackDialog",
5441
- "status": "open_project",
5442
- "a11y_reviewed": false,
5443
- "short_name": "OpenProjectFeedbackDialog",
5444
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/feedback_dialog.rb",
5445
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/feedback_dialog/default/",
5446
- "parameters": [
5570
+ "description": "Name of [Octicon](https://primer.style/octicons/) to use."
5571
+ },
5572
+ {
5573
+ "name": "tag",
5574
+ "type": "Symbol",
5575
+ "default": "N/A",
5576
+ "description": "One of `:a`, `:button`, `:clipboard-copy`, or `:summary`."
5577
+ },
5578
+ {
5579
+ "name": "type",
5580
+ "type": "Symbol",
5581
+ "default": "N/A",
5582
+ "description": "One of `:button`, `:reset`, or `:submit`."
5583
+ },
5447
5584
  {
5448
- "name": "title",
5585
+ "name": "aria-label",
5449
5586
  "type": "String",
5450
5587
  "default": "N/A",
5451
- "description": "The title of the dialog. Although visually hidden, a label is rendered for assistive technologies."
5588
+ "description": "String that can be read by assistive technology. A label should be short and concise. See the accessibility section for more information."
5452
5589
  },
5453
5590
  {
5454
- "name": "system_arguments",
5455
- "type": "Hash",
5591
+ "name": "aria-description",
5592
+ "type": "String",
5456
5593
  "default": "N/A",
5457
- "description": "[System arguments](/system-arguments)"
5458
- }
5459
- ]
5460
- },
5461
- {
5462
- "component": "OpenProject::FeedbackMessage",
5463
- "status": "open_project",
5464
- "a11y_reviewed": false,
5465
- "short_name": "OpenProjectFeedbackMessage",
5466
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/feedback_message.rb",
5467
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/feedback_message/default/",
5468
- "parameters": [
5594
+ "description": "String that can be read by assistive technology. A description can be longer as it is intended to provide more context and information. See the accessibility section for more information."
5595
+ },
5469
5596
  {
5470
- "name": "icon_arguments",
5471
- "type": "Hash",
5472
- "default": "`{}`",
5473
- "description": "special arguments for the icon"
5597
+ "name": "tooltip_direction",
5598
+ "type": "Symbol",
5599
+ "default": "`:s`",
5600
+ "description": "One of `:e`, `:n`, `:ne`, `:nw`, `:s`, `:se`, `:sw`, or `:w`."
5474
5601
  },
5475
5602
  {
5476
- "name": "loading",
5603
+ "name": "box",
5477
5604
  "type": "Boolean",
5478
5605
  "default": "`false`",
5479
- "description": "Show a loading spinner instead of an icon"
5606
+ "description": "Whether the button is in a [BorderBox](/components/beta/borderbox). If `true`, the button will have the `Box-btn-octicon` class."
5480
5607
  },
5481
5608
  {
5482
5609
  "name": "system_arguments",
@@ -5487,53 +5614,31 @@
5487
5614
  ]
5488
5615
  },
5489
5616
  {
5490
- "component": "OpenProject::FileTreeView",
5491
- "status": "alpha",
5617
+ "component": "Layout",
5618
+ "status": "deprecated",
5492
5619
  "a11y_reviewed": false,
5493
- "short_name": "OpenProjectFileTreeView",
5494
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/file_tree_view.rb",
5495
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/file_tree_view/default/",
5620
+ "short_name": "Layout",
5621
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/layout_component.rb",
5622
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/layout/default/",
5496
5623
  "parameters": [
5497
5624
  {
5498
- "name": "node_variant",
5625
+ "name": "responsive",
5626
+ "type": "Boolean",
5627
+ "default": "`false`",
5628
+ "description": "Whether to collapse layout to a single column at smaller widths."
5629
+ },
5630
+ {
5631
+ "name": "side",
5499
5632
  "type": "Symbol",
5500
- "default": "`:div`",
5501
- "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
5633
+ "default": "`:right`",
5634
+ "description": "Which side to display the sidebar on. One of `:left` or `:right`."
5502
5635
  },
5503
5636
  {
5504
- "name": "system_arguments",
5505
- "type": "Hash",
5506
- "default": "N/A",
5507
- "description": "[System arguments](/system-arguments)."
5508
- }
5509
- ]
5510
- },
5511
- {
5512
- "component": "OpenProject::FileTreeView::DirectoryNode",
5513
- "status": "alpha",
5514
- "a11y_reviewed": false,
5515
- "short_name": "OpenProjectFileTreeViewDirectoryNode",
5516
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/file_tree_view/directory_node.rb",
5517
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/file_tree_view/directory_node/default/",
5518
- "parameters": []
5519
- },
5520
- {
5521
- "component": "OpenProject::FileTreeView::FileNode",
5522
- "status": "alpha",
5523
- "a11y_reviewed": false,
5524
- "short_name": "OpenProjectFileTreeViewFileNode",
5525
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/file_tree_view/file_node.rb",
5526
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/file_tree_view/file_node/default/",
5527
- "parameters": []
5528
- },
5529
- {
5530
- "component": "OpenProject::FlexLayout",
5531
- "status": "open_project",
5532
- "a11y_reviewed": false,
5533
- "short_name": "OpenProjectFlexLayout",
5534
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/flex_layout.rb",
5535
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/flex_layout/default/",
5536
- "parameters": [
5637
+ "name": "sidebar_col",
5638
+ "type": "Integer",
5639
+ "default": "`3`",
5640
+ "description": "Sidebar column width."
5641
+ },
5537
5642
  {
5538
5643
  "name": "system_arguments",
5539
5644
  "type": "Hash",
@@ -5543,18 +5648,48 @@
5543
5648
  ]
5544
5649
  },
5545
5650
  {
5546
- "component": "OpenProject::GridLayout",
5547
- "status": "open_project",
5651
+ "component": "Navigation::Tab",
5652
+ "status": "deprecated",
5548
5653
  "a11y_reviewed": false,
5549
- "short_name": "OpenProjectGridLayout",
5550
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/grid_layout.rb",
5551
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/grid_layout/default/",
5654
+ "short_name": "NavigationTab",
5655
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/navigation/tab_component.rb",
5656
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/navigation/tab/default/",
5552
5657
  "parameters": [
5553
5658
  {
5554
- "name": "css_class",
5659
+ "name": "list",
5660
+ "type": "Boolean",
5661
+ "default": "`false`",
5662
+ "description": "Whether the Tab is an item in a `<ul>` list."
5663
+ },
5664
+ {
5665
+ "name": "selected",
5666
+ "type": "Boolean",
5667
+ "default": "`false`",
5668
+ "description": "Whether the Tab is selected or not."
5669
+ },
5670
+ {
5671
+ "name": "with_panel",
5672
+ "type": "Boolean",
5673
+ "default": "`false`",
5674
+ "description": "Whether the Tab has an associated panel."
5675
+ },
5676
+ {
5677
+ "name": "panel_id",
5555
5678
  "type": "String",
5556
- "default": "N/A",
5557
- "description": "The basic css class applied on the grid-container"
5679
+ "default": "`\"\"`",
5680
+ "description": "Only applies if `with_panel` is `true`. Unique id of panel."
5681
+ },
5682
+ {
5683
+ "name": "icon_classes",
5684
+ "type": "Boolean",
5685
+ "default": "`\"\"`",
5686
+ "description": "Classes that must always be applied to icons."
5687
+ },
5688
+ {
5689
+ "name": "wrapper_arguments",
5690
+ "type": "Hash",
5691
+ "default": "`{}`",
5692
+ "description": "[System arguments](/system-arguments) to be used in the `<li>` wrapper when the tab is an item in a list."
5558
5693
  },
5559
5694
  {
5560
5695
  "name": "system_arguments",
@@ -5565,36 +5700,24 @@
5565
5700
  ]
5566
5701
  },
5567
5702
  {
5568
- "component": "OpenProject::GridLayout::Area",
5703
+ "component": "OpenProject::BorderBox::CollapsibleHeader",
5569
5704
  "status": "open_project",
5570
5705
  "a11y_reviewed": false,
5571
- "short_name": "OpenProjectGridLayoutArea",
5572
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/grid_layout/area.rb",
5573
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/grid_layout/area/default/",
5706
+ "short_name": "OpenProjectBorderBoxCollapsibleHeader",
5707
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_box/collapsible_header.rb",
5708
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_box/collapsible_header/default/",
5574
5709
  "parameters": [
5575
5710
  {
5576
- "name": "css_class",
5711
+ "name": "id",
5577
5712
  "type": "String",
5578
- "default": "N/A",
5579
- "description": "The basic css class applied on the grid-container"
5580
- },
5581
- {
5582
- "name": "area_name",
5583
- "type": "Symbol",
5584
- "default": "N/A",
5585
- "description": "The specific area name, used for creating the element class and the \"grid-area\" style"
5586
- },
5587
- {
5588
- "name": "component",
5589
- "type": "ViewComponent::Base",
5590
- "default": "`Primer::BaseComponent`",
5591
- "description": "The instance of the component to be rendered."
5713
+ "default": "`self.class.generate_id`",
5714
+ "description": "The unique ID of the collapsible header."
5592
5715
  },
5593
5716
  {
5594
- "name": "tag",
5595
- "type": "Symbol",
5596
- "default": "`:div`",
5597
- "description": "One of `:div` or `:span`."
5717
+ "name": "collapsed",
5718
+ "type": "Boolean",
5719
+ "default": "`false`",
5720
+ "description": "Whether the header is collapsed on initial render."
5598
5721
  },
5599
5722
  {
5600
5723
  "name": "system_arguments",
@@ -5605,13 +5728,19 @@
5605
5728
  ]
5606
5729
  },
5607
5730
  {
5608
- "component": "OpenProject::Heading",
5731
+ "component": "OpenProject::BorderGrid",
5609
5732
  "status": "open_project",
5610
5733
  "a11y_reviewed": false,
5611
- "short_name": "OpenProjectHeading",
5612
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/heading.rb",
5613
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/heading/default/",
5734
+ "short_name": "OpenProjectBorderGrid",
5735
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_grid.rb",
5736
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_grid/default/",
5614
5737
  "parameters": [
5738
+ {
5739
+ "name": "spacious",
5740
+ "type": "Boolean",
5741
+ "default": "`false`",
5742
+ "description": "Whether to add margin to the bottom of the component."
5743
+ },
5615
5744
  {
5616
5745
  "name": "system_arguments",
5617
5746
  "type": "Hash",
@@ -5621,12 +5750,12 @@
5621
5750
  ]
5622
5751
  },
5623
5752
  {
5624
- "component": "OpenProject::InputGroup",
5753
+ "component": "OpenProject::BorderGrid::Cell",
5625
5754
  "status": "open_project",
5626
5755
  "a11y_reviewed": false,
5627
- "short_name": "OpenProjectInputGroup",
5628
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/input_group.rb",
5629
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/input_group/default/",
5756
+ "short_name": "OpenProjectBorderGridCell",
5757
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/border_grid/cell.rb",
5758
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/border_grid/cell/default/",
5630
5759
  "parameters": [
5631
5760
  {
5632
5761
  "name": "system_arguments",
@@ -5637,18 +5766,24 @@
5637
5766
  ]
5638
5767
  },
5639
5768
  {
5640
- "component": "OpenProject::PageHeader",
5769
+ "component": "OpenProject::CollapsibleSection",
5641
5770
  "status": "open_project",
5642
5771
  "a11y_reviewed": false,
5643
- "short_name": "OpenProjectPageHeader",
5644
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header.rb",
5645
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/default/",
5772
+ "short_name": "OpenProjectCollapsibleSection",
5773
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/collapsible_section.rb",
5774
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/collapsible_section/default/",
5646
5775
  "parameters": [
5647
5776
  {
5648
- "name": "mobile_menu_label",
5777
+ "name": "id",
5649
5778
  "type": "String",
5650
- "default": "`I18n.t(\"label_more\")`",
5651
- "description": "The tooltip label of the mobile menu"
5779
+ "default": "`self.class.generate_id`",
5780
+ "description": "The unique ID of the collapsible section."
5781
+ },
5782
+ {
5783
+ "name": "collapsed",
5784
+ "type": "Boolean",
5785
+ "default": "`false`",
5786
+ "description": "Whether the section is collapsed on initial render."
5652
5787
  },
5653
5788
  {
5654
5789
  "name": "system_arguments",
@@ -5659,73 +5794,43 @@
5659
5794
  ]
5660
5795
  },
5661
5796
  {
5662
- "component": "OpenProject::PageHeader::Dialog",
5663
- "status": "open_project",
5664
- "a11y_reviewed": false,
5665
- "short_name": "OpenProjectPageHeaderDialog",
5666
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/dialog.rb",
5667
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/dialog/default/",
5668
- "parameters": [
5669
- {
5670
- "name": "dialog_arguments",
5671
- "type": "Hash",
5672
- "default": "`{}`",
5673
- "description": "The arguments accepted by [Dialog](/components/alpha/dialog)."
5674
- },
5675
- {
5676
- "name": "button_arguments",
5677
- "type": "Hash",
5678
- "default": "`{}`",
5679
- "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
5680
- }
5681
- ]
5682
- },
5683
- {
5684
- "component": "OpenProject::PageHeader::Menu",
5797
+ "component": "OpenProject::DangerDialog",
5685
5798
  "status": "open_project",
5686
5799
  "a11y_reviewed": false,
5687
- "short_name": "OpenProjectPageHeaderMenu",
5688
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/menu.rb",
5689
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/menu/default/",
5800
+ "short_name": "OpenProjectDangerDialog",
5801
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog.rb",
5802
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/default/",
5690
5803
  "parameters": [
5691
5804
  {
5692
- "name": "menu_arguments",
5805
+ "name": "form_arguments",
5693
5806
  "type": "Hash",
5694
5807
  "default": "`{}`",
5695
- "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
5808
+ "description": "Allows the dialog to submit a form. Pass EITHER the `builder:` option to this hash to reuse an existing Rails form, or `action:` if you prefer the component to render the form tag itself. `builder:` should be an instance of `ActionView::Helpers::FormBuilder`, which is created by the standard Rails `#form_with` and `#form_for` helpers. The `name:` option is the desired name of the field that will be included in the params sent to the server on form submission."
5696
5809
  },
5697
5810
  {
5698
- "name": "button_arguments",
5699
- "type": "Hash",
5700
- "default": "`{}`",
5701
- "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
5702
- }
5703
- ]
5704
- },
5705
- {
5706
- "component": "OpenProject::PageHeader::Title",
5707
- "status": "open_project",
5708
- "a11y_reviewed": false,
5709
- "short_name": "OpenProjectPageHeaderTitle",
5710
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/title.rb",
5711
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/title/default/",
5712
- "parameters": [
5811
+ "name": "id",
5812
+ "type": "String",
5813
+ "default": "`self.class.generate_id`",
5814
+ "description": "The id of the dialog."
5815
+ },
5713
5816
  {
5714
- "name": "system_arguments",
5715
- "type": "Hash",
5817
+ "name": "title",
5818
+ "type": "String",
5716
5819
  "default": "N/A",
5717
- "description": "[System arguments](/system-arguments)"
5718
- }
5719
- ]
5720
- },
5721
- {
5722
- "component": "OpenProject::SidePanel",
5723
- "status": "open_project",
5724
- "a11y_reviewed": false,
5725
- "short_name": "OpenProjectSidePanel",
5726
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/side_panel.rb",
5727
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/side_panel/default/",
5728
- "parameters": [
5820
+ "description": "The title of the dialog. Although visually hidden, a label is rendered for assistive technologies."
5821
+ },
5822
+ {
5823
+ "name": "confirm_button_text",
5824
+ "type": "String",
5825
+ "default": "`nil`",
5826
+ "description": "The text of the confirm button. Will default to `I18n.t(\"button_delete\")`, or `I18n.t(\"button_delete_permanently\")` if `confirmation_check_box` slot has been passed to the component."
5827
+ },
5828
+ {
5829
+ "name": "cancel_button_text",
5830
+ "type": "String",
5831
+ "default": "`nil`",
5832
+ "description": "The text of the cancel button. Will default to `I18n.t(\"button_cancel\")`."
5833
+ },
5729
5834
  {
5730
5835
  "name": "system_arguments",
5731
5836
  "type": "Hash",
@@ -5735,33 +5840,24 @@
5735
5840
  ]
5736
5841
  },
5737
5842
  {
5738
- "component": "OpenProject::SidePanel::Section",
5843
+ "component": "OpenProject::DangerDialog::ConfirmationCheckBox",
5739
5844
  "status": "open_project",
5740
5845
  "a11y_reviewed": false,
5741
- "short_name": "OpenProjectSidePanelSection",
5742
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/side_panel/section.rb",
5743
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/side_panel/section/default/",
5744
- "parameters": []
5745
- },
5746
- {
5747
- "component": "OpenProject::SkeletonBox",
5748
- "status": "alpha",
5749
- "a11y_reviewed": false,
5750
- "short_name": "OpenProjectSkeletonBox",
5751
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/skeleton_box.rb",
5752
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/skeleton_box/default/",
5846
+ "short_name": "OpenProjectDangerDialogConfirmationCheckBox",
5847
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog/confirmation_check_box.rb",
5848
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/confirmation_check_box/default/",
5753
5849
  "parameters": [
5754
5850
  {
5755
- "name": "height",
5851
+ "name": "check_box_id",
5756
5852
  "type": "String",
5757
- "default": "`nil`",
5758
- "description": "Any valid CSS height."
5853
+ "default": "`self.class.generate_id`",
5854
+ "description": "The id of the check_box input."
5759
5855
  },
5760
5856
  {
5761
- "name": "width",
5857
+ "name": "check_box_name",
5762
5858
  "type": "String",
5763
- "default": "`nil`",
5764
- "description": "Any valid CSS width."
5859
+ "default": "N/A",
5860
+ "description": "The name of the check_box input."
5765
5861
  },
5766
5862
  {
5767
5863
  "name": "system_arguments",
@@ -5772,12 +5868,21 @@
5772
5868
  ]
5773
5869
  },
5774
5870
  {
5775
- "component": "OpenProject::SubHeader",
5871
+ "component": "OpenProject::DangerDialog::FormWrapper",
5776
5872
  "status": "open_project",
5777
5873
  "a11y_reviewed": false,
5778
- "short_name": "OpenProjectSubHeader",
5779
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header.rb",
5780
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/default/",
5874
+ "short_name": "OpenProjectDangerDialogFormWrapper",
5875
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/danger_dialog/form_wrapper.rb",
5876
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/danger_dialog/form_wrapper/default/",
5877
+ "parameters": []
5878
+ },
5879
+ {
5880
+ "component": "OpenProject::DragHandle",
5881
+ "status": "open_project",
5882
+ "a11y_reviewed": false,
5883
+ "short_name": "OpenProjectDragHandle",
5884
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/drag_handle.rb",
5885
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/drag_handle/default/",
5781
5886
  "parameters": [
5782
5887
  {
5783
5888
  "name": "system_arguments",
@@ -5788,18 +5893,18 @@
5788
5893
  ]
5789
5894
  },
5790
5895
  {
5791
- "component": "OpenProject::SubHeader::Button",
5896
+ "component": "OpenProject::FeedbackDialog",
5792
5897
  "status": "open_project",
5793
5898
  "a11y_reviewed": false,
5794
- "short_name": "OpenProjectSubHeaderButton",
5795
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/button.rb",
5796
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/button/default/",
5899
+ "short_name": "OpenProjectFeedbackDialog",
5900
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/feedback_dialog.rb",
5901
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/feedback_dialog/default/",
5797
5902
  "parameters": [
5798
5903
  {
5799
- "name": "icon",
5800
- "type": "Symbol",
5904
+ "name": "title",
5905
+ "type": "String",
5801
5906
  "default": "N/A",
5802
- "description": "The name of an [Octicon](https://primer.style/octicons/) icon to use as leading visual"
5907
+ "description": "The title of the dialog. Although visually hidden, a label is rendered for assistive technologies."
5803
5908
  },
5804
5909
  {
5805
5910
  "name": "system_arguments",
@@ -5810,24 +5915,24 @@
5810
5915
  ]
5811
5916
  },
5812
5917
  {
5813
- "component": "OpenProject::SubHeader::ButtonGroup",
5918
+ "component": "OpenProject::FeedbackMessage",
5814
5919
  "status": "open_project",
5815
5920
  "a11y_reviewed": false,
5816
- "short_name": "OpenProjectSubHeaderButtonGroup",
5817
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/button_group.rb",
5818
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/button_group/default/",
5921
+ "short_name": "OpenProjectFeedbackMessage",
5922
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/feedback_message.rb",
5923
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/feedback_message/default/",
5819
5924
  "parameters": [
5820
5925
  {
5821
- "name": "scheme",
5822
- "type": "Symbol",
5823
- "default": "`:default`",
5824
- "description": "DEPRECATED. One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
5926
+ "name": "icon_arguments",
5927
+ "type": "Hash",
5928
+ "default": "`{}`",
5929
+ "description": "special arguments for the icon"
5825
5930
  },
5826
5931
  {
5827
- "name": "size",
5828
- "type": "Symbol",
5829
- "default": "`:medium`",
5830
- "description": "One of `:large`, `:medium`, or `:small`."
5932
+ "name": "loading",
5933
+ "type": "Boolean",
5934
+ "default": "`false`",
5935
+ "description": "Show a loading spinner instead of an icon"
5831
5936
  },
5832
5937
  {
5833
5938
  "name": "system_arguments",
@@ -5838,71 +5943,81 @@
5838
5943
  ]
5839
5944
  },
5840
5945
  {
5841
- "component": "OpenProject::SubHeader::Menu",
5842
- "status": "open_project",
5946
+ "component": "OpenProject::FilterableTreeView",
5947
+ "status": "alpha",
5843
5948
  "a11y_reviewed": false,
5844
- "short_name": "OpenProjectSubHeaderMenu",
5845
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/menu.rb",
5846
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/menu/default/",
5949
+ "short_name": "OpenProjectFilterableTreeView",
5950
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/filterable_tree_view.rb",
5951
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/filterable_tree_view/default/",
5847
5952
  "parameters": [
5848
5953
  {
5849
- "name": "icon_only",
5850
- "type": "Boolean",
5851
- "default": "`false`",
5852
- "description": "Whether the trigger button is an IconButton"
5954
+ "name": "tree_view_arguments",
5955
+ "type": "Hash",
5956
+ "default": "`{}`",
5957
+ "description": "Arguments that will be passed to the underlying [TreeView](/components/alpha/treeview) component."
5853
5958
  },
5854
5959
  {
5855
- "name": "leading_icon",
5856
- "type": "Symbol",
5857
- "default": "N/A",
5858
- "description": "Name of Octicon icon to use as either leading icon or IconButton."
5960
+ "name": "form_arguments",
5961
+ "type": "Hash",
5962
+ "default": "`{}`",
5963
+ "description": "Form arguments that will be passed to the underlying [TreeView](/components/alpha/treeview) component. These arguments allow the selections made within a `FilterableTreeView` to be submitted to the server as part of a Rails form. Pass the `builder:` and `name:` options to this hash. `builder:` should be an instance of `ActionView::Helpers::FormBuilder`, which are created by the standard Rails `#form_with` and `#form_for` helpers. The `name:` option is the desired name of the field that will be included in the params sent to the server on form submission."
5859
5964
  },
5860
5965
  {
5861
- "name": "label",
5862
- "type": "String",
5863
- "default": "N/A",
5864
- "description": "The button label"
5966
+ "name": "filter_input_arguments",
5967
+ "type": "Hash",
5968
+ "default": "`DEFAULT_FILTER_INPUT_ARGUMENTS.dup`",
5969
+ "description": "Arguments that will be passed to the [TextField](/components/alpha/textfield) component."
5865
5970
  },
5866
5971
  {
5867
- "name": "button_arguments",
5972
+ "name": "filter_mode_control_arguments",
5868
5973
  "type": "Hash",
5869
- "default": "`{}`",
5870
- "description": "Additional arguments for the button"
5974
+ "default": "`DEFAULT_FILTER_MODE_CONTROL_ARGUMENTS.dup`",
5975
+ "description": "Arguments that will be passed to the [SegmentedControl](/components/alpha/segmentedcontrol) component."
5871
5976
  },
5872
5977
  {
5873
- "name": "system_arguments",
5978
+ "name": "include_sub_items_check_box_arguments",
5874
5979
  "type": "Hash",
5875
- "default": "N/A",
5876
- "description": "[System arguments](/system-arguments)"
5980
+ "default": "`DEFAULT_INCLUDE_SUB_ITEMS_CHECK_BOX_ARGUMENTS.dup`",
5981
+ "description": "Arguments that will be passed to the [CheckBox](/components/alpha/checkbox) component."
5982
+ },
5983
+ {
5984
+ "name": "no_results_node_arguments",
5985
+ "type": "Hash",
5986
+ "default": "`DEFAULT_NO_RESULTS_NODE_ARGUMENTS.dup`",
5987
+ "description": "Arguments that will be passed to a [TreeView::LeafNode](/components/alpha/treeviewleafnode) component that appears when no items match the filter criteria."
5877
5988
  }
5878
5989
  ]
5879
5990
  },
5880
5991
  {
5881
- "component": "OpenProject::SubHeader::SegmentedControl",
5882
- "status": "open_project",
5883
- "a11y_reviewed": true,
5884
- "short_name": "OpenProjectSubHeaderSegmentedControl",
5885
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/segmented_control.rb",
5886
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/segmented_control/default/",
5992
+ "component": "OpenProject::FilterableTreeView::SubTree",
5993
+ "status": "alpha",
5994
+ "a11y_reviewed": false,
5995
+ "short_name": "OpenProjectFilterableTreeViewSubTree",
5996
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/filterable_tree_view/sub_tree.rb",
5997
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/filterable_tree_view/sub_tree/default/",
5887
5998
  "parameters": [
5888
5999
  {
5889
- "name": "hide_labels",
5890
- "type": "Boolean",
5891
- "default": "`false`",
5892
- "description": "Whether to hide the labels and only show the icons"
5893
- },
5894
- {
5895
- "name": "full_width",
5896
- "type": "Boolean",
5897
- "default": "`false`",
5898
- "description": "If the component should be full width"
5899
- },
5900
- {
5901
- "name": "size",
6000
+ "name": "node_variant",
5902
6001
  "type": "Symbol",
5903
- "default": "`:medium`",
5904
- "description": "One of `:large`, `:medium`, or `:small`."
6002
+ "default": "N/A",
6003
+ "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
5905
6004
  },
6005
+ {
6006
+ "name": "system_arguments",
6007
+ "type": "Hash",
6008
+ "default": "N/A",
6009
+ "description": "The arguments accepted by [TreeView::SubTreeContainer](/components/alpha/treeviewsubtreecontainer)."
6010
+ }
6011
+ ]
6012
+ },
6013
+ {
6014
+ "component": "OpenProject::FlexLayout",
6015
+ "status": "open_project",
6016
+ "a11y_reviewed": false,
6017
+ "short_name": "OpenProjectFlexLayout",
6018
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/flex_layout.rb",
6019
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/flex_layout/default/",
6020
+ "parameters": [
5906
6021
  {
5907
6022
  "name": "system_arguments",
5908
6023
  "type": "Hash",
@@ -5912,57 +6027,75 @@
5912
6027
  ]
5913
6028
  },
5914
6029
  {
5915
- "component": "OpenProject::TreeView",
5916
- "status": "alpha",
6030
+ "component": "OpenProject::GridLayout",
6031
+ "status": "open_project",
5917
6032
  "a11y_reviewed": false,
5918
- "short_name": "OpenProjectTreeView",
5919
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view.rb",
5920
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/default/",
6033
+ "short_name": "OpenProjectGridLayout",
6034
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/grid_layout.rb",
6035
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/grid_layout/default/",
5921
6036
  "parameters": [
5922
6037
  {
5923
- "name": "node_variant",
5924
- "type": "Symbol",
5925
- "default": "`:div`",
5926
- "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
6038
+ "name": "css_class",
6039
+ "type": "String",
6040
+ "default": "N/A",
6041
+ "description": "The basic css class applied on the grid-container"
5927
6042
  },
5928
6043
  {
5929
6044
  "name": "system_arguments",
5930
6045
  "type": "Hash",
5931
6046
  "default": "N/A",
5932
- "description": "[System arguments](/system-arguments)."
6047
+ "description": "[System arguments](/system-arguments)"
5933
6048
  }
5934
6049
  ]
5935
6050
  },
5936
6051
  {
5937
- "component": "OpenProject::TreeView::Icon",
5938
- "status": "alpha",
6052
+ "component": "OpenProject::GridLayout::Area",
6053
+ "status": "open_project",
5939
6054
  "a11y_reviewed": false,
5940
- "short_name": "OpenProjectTreeViewIcon",
5941
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/icon.rb",
5942
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/icon/default/",
6055
+ "short_name": "OpenProjectGridLayoutArea",
6056
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/grid_layout/area.rb",
6057
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/grid_layout/area/default/",
5943
6058
  "parameters": [
6059
+ {
6060
+ "name": "css_class",
6061
+ "type": "String",
6062
+ "default": "N/A",
6063
+ "description": "The basic css class applied on the grid-container"
6064
+ },
6065
+ {
6066
+ "name": "area_name",
6067
+ "type": "Symbol",
6068
+ "default": "N/A",
6069
+ "description": "The specific area name, used for creating the element class and the \"grid-area\" style"
6070
+ },
6071
+ {
6072
+ "name": "component",
6073
+ "type": "ViewComponent::Base",
6074
+ "default": "`Primer::BaseComponent`",
6075
+ "description": "The instance of the component to be rendered."
6076
+ },
6077
+ {
6078
+ "name": "tag",
6079
+ "type": "Symbol",
6080
+ "default": "`:div`",
6081
+ "description": "One of `:div` or `:span`."
6082
+ },
5944
6083
  {
5945
6084
  "name": "system_arguments",
5946
6085
  "type": "Hash",
5947
6086
  "default": "N/A",
5948
- "description": "The arguments accepted by [Octicon](/components/beta/octicon)."
6087
+ "description": "[System arguments](/system-arguments)"
5949
6088
  }
5950
6089
  ]
5951
6090
  },
5952
6091
  {
5953
- "component": "OpenProject::TreeView::IconPair",
5954
- "status": "alpha",
6092
+ "component": "OpenProject::Heading",
6093
+ "status": "open_project",
5955
6094
  "a11y_reviewed": false,
5956
- "short_name": "OpenProjectTreeViewIconPair",
5957
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/icon_pair.rb",
5958
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/icon_pair/default/",
6095
+ "short_name": "OpenProjectHeading",
6096
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/heading.rb",
6097
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/heading/default/",
5959
6098
  "parameters": [
5960
- {
5961
- "name": "expanded",
5962
- "type": "Boolean",
5963
- "default": "`false`",
5964
- "description": "If true, the expanded icon is shown and the collapsed icon is hidden, etc."
5965
- },
5966
6099
  {
5967
6100
  "name": "system_arguments",
5968
6101
  "type": "Hash",
@@ -5972,214 +6105,185 @@
5972
6105
  ]
5973
6106
  },
5974
6107
  {
5975
- "component": "OpenProject::TreeView::LeadingAction",
5976
- "status": "alpha",
6108
+ "component": "OpenProject::InputGroup",
6109
+ "status": "open_project",
5977
6110
  "a11y_reviewed": false,
5978
- "short_name": "OpenProjectTreeViewLeadingAction",
5979
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/leading_action.rb",
5980
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/leading_action/default/",
6111
+ "short_name": "OpenProjectInputGroup",
6112
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/input_group.rb",
6113
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/input_group/default/",
5981
6114
  "parameters": [
5982
6115
  {
5983
- "name": "action",
5984
- "type": "ViewComponent::Base",
6116
+ "name": "system_arguments",
6117
+ "type": "Hash",
5985
6118
  "default": "N/A",
5986
- "description": "A component or other renderable to use as the action button etc."
6119
+ "description": "[System arguments](/system-arguments)"
5987
6120
  }
5988
6121
  ]
5989
6122
  },
5990
6123
  {
5991
- "component": "OpenProject::TreeView::LeafNode",
5992
- "status": "alpha",
6124
+ "component": "OpenProject::PageHeader",
6125
+ "status": "open_project",
5993
6126
  "a11y_reviewed": false,
5994
- "short_name": "OpenProjectTreeViewLeafNode",
5995
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/leaf_node.rb",
5996
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/leaf_node/default/",
6127
+ "short_name": "OpenProjectPageHeader",
6128
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header.rb",
6129
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/default/",
5997
6130
  "parameters": [
5998
6131
  {
5999
- "name": "label",
6132
+ "name": "mobile_menu_label",
6000
6133
  "type": "String",
6001
- "default": "N/A",
6002
- "description": "The node's label, i.e. it's textual content."
6134
+ "default": "`I18n.t(\"label_more\")`",
6135
+ "description": "The tooltip label of the mobile menu"
6003
6136
  },
6004
6137
  {
6005
6138
  "name": "system_arguments",
6006
6139
  "type": "Hash",
6007
6140
  "default": "N/A",
6008
- "description": "The arguments accepted by [OpenProject::TreeView::Node](/components/openprojecttreeviewnode)."
6141
+ "description": "[System arguments](/system-arguments)"
6009
6142
  }
6010
6143
  ]
6011
6144
  },
6012
6145
  {
6013
- "component": "OpenProject::TreeView::LoadingFailureMessage",
6014
- "status": "alpha",
6146
+ "component": "OpenProject::PageHeader::Dialog",
6147
+ "status": "open_project",
6015
6148
  "a11y_reviewed": false,
6016
- "short_name": "OpenProjectTreeViewLoadingFailureMessage",
6017
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/loading_failure_message.rb",
6018
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/loading_failure_message/default/",
6149
+ "short_name": "OpenProjectPageHeaderDialog",
6150
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/dialog.rb",
6151
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/dialog/default/",
6019
6152
  "parameters": [
6020
6153
  {
6021
- "name": "text",
6022
- "type": "String",
6023
- "default": "`Something went wrong`",
6024
- "description": "The failure message to display."
6025
- },
6026
- {
6027
- "name": "retry_button_label",
6028
- "type": "String",
6029
- "default": "`Retry`",
6030
- "description": "The text shown on the retry button."
6154
+ "name": "dialog_arguments",
6155
+ "type": "Hash",
6156
+ "default": "`{}`",
6157
+ "description": "The arguments accepted by [Dialog](/components/alpha/dialog)."
6031
6158
  },
6032
6159
  {
6033
- "name": "system_arguments",
6160
+ "name": "button_arguments",
6034
6161
  "type": "Hash",
6035
- "default": "N/A",
6036
- "description": "[System arguments](/system-arguments)"
6162
+ "default": "`{}`",
6163
+ "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
6037
6164
  }
6038
6165
  ]
6039
6166
  },
6040
6167
  {
6041
- "component": "OpenProject::TreeView::Node",
6042
- "status": "alpha",
6168
+ "component": "OpenProject::PageHeader::Menu",
6169
+ "status": "open_project",
6043
6170
  "a11y_reviewed": false,
6044
- "short_name": "OpenProjectTreeViewNode",
6045
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/node.rb",
6046
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/node/default/",
6171
+ "short_name": "OpenProjectPageHeaderMenu",
6172
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/menu.rb",
6173
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/menu/default/",
6047
6174
  "parameters": [
6048
6175
  {
6049
- "name": "path",
6050
- "type": "Array<String>",
6051
- "default": "N/A",
6052
- "description": "The node's \"path,\" i.e. this node's label and the labels of all its ancestors. This node should be reachable by traversing the tree following this path."
6053
- },
6054
- {
6055
- "name": "node_variant",
6056
- "type": "Symbol",
6057
- "default": "N/A",
6058
- "description": "The node variant to use for the node's content, i.e. the `:button` or `:div`. One of `:anchor`, `:button`, or `:div`."
6059
- },
6060
- {
6061
- "name": "href",
6062
- "type": "String",
6063
- "default": "`nil`",
6064
- "description": "The URL to use as the `href` attribute for this node. If set to a truthy value, the `tag:` parameter is ignored and assumed to be `:a`."
6065
- },
6066
- {
6067
- "name": "current",
6068
- "type": "Boolean",
6069
- "default": "`false`",
6070
- "description": "Whether or not this node is the current node. The current node is styled differently than regular nodes and is the first element that receives focus when tabbing to the `TreeView` component."
6071
- },
6072
- {
6073
- "name": "select_variant",
6074
- "type": "Symbol",
6075
- "default": "`:none`",
6076
- "description": "Controls the type of checkbox that appears. One of `:multiple` or `:none`."
6077
- },
6078
- {
6079
- "name": "checked",
6080
- "type": "Boolean | String",
6081
- "default": "`false`",
6082
- "description": "The checked state of the node's checkbox. One of `false`, `mixed`, or `true`."
6176
+ "name": "menu_arguments",
6177
+ "type": "Hash",
6178
+ "default": "`{}`",
6179
+ "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
6083
6180
  },
6084
6181
  {
6085
- "name": "content_arguments",
6182
+ "name": "button_arguments",
6086
6183
  "type": "Hash",
6087
- "default": "N/A",
6088
- "description": "Arguments attached to the node's content, i.e the `<button>` or `<a>` element. [System arguments](/system-arguments)"
6184
+ "default": "`{}`",
6185
+ "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
6089
6186
  }
6090
6187
  ]
6091
6188
  },
6092
6189
  {
6093
- "component": "OpenProject::TreeView::SkeletonLoader",
6094
- "status": "alpha",
6190
+ "component": "OpenProject::PageHeader::Title",
6191
+ "status": "open_project",
6095
6192
  "a11y_reviewed": false,
6096
- "short_name": "OpenProjectTreeViewSkeletonLoader",
6097
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/skeleton_loader.rb",
6098
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/skeleton_loader/default/",
6193
+ "short_name": "OpenProjectPageHeaderTitle",
6194
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/page_header/title.rb",
6195
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/page_header/title/default/",
6099
6196
  "parameters": [
6100
- {
6101
- "name": "src",
6102
- "type": "String",
6103
- "default": "N/A",
6104
- "description": "The URL to fetch nodes from."
6105
- },
6106
- {
6107
- "name": "count",
6108
- "type": "Integer",
6109
- "default": "`3`",
6110
- "description": "The number of skeleton nodes to render."
6111
- },
6112
6197
  {
6113
6198
  "name": "system_arguments",
6114
6199
  "type": "Hash",
6115
6200
  "default": "N/A",
6116
- "description": "The arguments accepted by [OpenProject::TreeView::SubTreeContainer](/components/openprojecttreeviewsubtreecontainer)."
6201
+ "description": "[System arguments](/system-arguments)"
6117
6202
  }
6118
6203
  ]
6119
6204
  },
6120
6205
  {
6121
- "component": "OpenProject::TreeView::SpinnerLoader",
6122
- "status": "alpha",
6206
+ "component": "OpenProject::SidePanel",
6207
+ "status": "open_project",
6123
6208
  "a11y_reviewed": false,
6124
- "short_name": "OpenProjectTreeViewSpinnerLoader",
6125
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/spinner_loader.rb",
6126
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/spinner_loader/default/",
6209
+ "short_name": "OpenProjectSidePanel",
6210
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/side_panel.rb",
6211
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/side_panel/default/",
6127
6212
  "parameters": [
6128
6213
  {
6129
- "name": "src",
6130
- "type": "String",
6214
+ "name": "system_arguments",
6215
+ "type": "Hash",
6131
6216
  "default": "N/A",
6132
- "description": "The URL to fetch nodes from."
6133
- },
6217
+ "description": "[System arguments](/system-arguments)"
6218
+ }
6219
+ ]
6220
+ },
6221
+ {
6222
+ "component": "OpenProject::SidePanel::Section",
6223
+ "status": "open_project",
6224
+ "a11y_reviewed": false,
6225
+ "short_name": "OpenProjectSidePanelSection",
6226
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/side_panel/section.rb",
6227
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/side_panel/section/default/",
6228
+ "parameters": []
6229
+ },
6230
+ {
6231
+ "component": "OpenProject::SubHeader",
6232
+ "status": "open_project",
6233
+ "a11y_reviewed": false,
6234
+ "short_name": "OpenProjectSubHeader",
6235
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header.rb",
6236
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/default/",
6237
+ "parameters": [
6134
6238
  {
6135
6239
  "name": "system_arguments",
6136
6240
  "type": "Hash",
6137
6241
  "default": "N/A",
6138
- "description": "The arguments accepted by [OpenProject::TreeView::SubTreeContainer](/components/openprojecttreeviewsubtreecontainer)."
6242
+ "description": "[System arguments](/system-arguments)"
6139
6243
  }
6140
6244
  ]
6141
6245
  },
6142
6246
  {
6143
- "component": "OpenProject::TreeView::SubTree",
6144
- "status": "alpha",
6247
+ "component": "OpenProject::SubHeader::Button",
6248
+ "status": "open_project",
6145
6249
  "a11y_reviewed": false,
6146
- "short_name": "OpenProjectTreeViewSubTree",
6147
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/sub_tree.rb",
6148
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/sub_tree/default/",
6250
+ "short_name": "OpenProjectSubHeaderButton",
6251
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/button.rb",
6252
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/button/default/",
6149
6253
  "parameters": [
6150
6254
  {
6151
- "name": "node_variant",
6255
+ "name": "icon",
6152
6256
  "type": "Symbol",
6153
6257
  "default": "N/A",
6154
- "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
6258
+ "description": "The name of an [Octicon](https://primer.style/octicons/) icon to use as leading visual"
6155
6259
  },
6156
6260
  {
6157
6261
  "name": "system_arguments",
6158
6262
  "type": "Hash",
6159
6263
  "default": "N/A",
6160
- "description": "The arguments accepted by [OpenProject::TreeView::SubTreeContainer](/components/openprojecttreeviewsubtreecontainer)."
6264
+ "description": "[System arguments](/system-arguments)"
6161
6265
  }
6162
6266
  ]
6163
6267
  },
6164
6268
  {
6165
- "component": "OpenProject::TreeView::SubTreeContainer",
6166
- "status": "alpha",
6269
+ "component": "OpenProject::SubHeader::ButtonGroup",
6270
+ "status": "open_project",
6167
6271
  "a11y_reviewed": false,
6168
- "short_name": "OpenProjectTreeViewSubTreeContainer",
6169
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/sub_tree_container.rb",
6170
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/sub_tree_container/default/",
6272
+ "short_name": "OpenProjectSubHeaderButtonGroup",
6273
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/button_group.rb",
6274
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/button_group/default/",
6171
6275
  "parameters": [
6172
6276
  {
6173
- "name": "path",
6174
- "type": "Array<String>",
6175
- "default": "N/A",
6176
- "description": "The path to this node."
6277
+ "name": "scheme",
6278
+ "type": "Symbol",
6279
+ "default": "`:default`",
6280
+ "description": "DEPRECATED. One of `:danger`, `:default`, `:invisible`, `:link`, `:primary`, or `:secondary`."
6177
6281
  },
6178
6282
  {
6179
- "name": "expanded",
6180
- "type": "Boolean",
6181
- "default": "`false`",
6182
- "description": "Whether or not this sub-tree node renders expanded."
6283
+ "name": "size",
6284
+ "type": "Symbol",
6285
+ "default": "`:medium`",
6286
+ "description": "One of `:large`, `:medium`, or `:small`."
6183
6287
  },
6184
6288
  {
6185
6289
  "name": "system_arguments",
@@ -6190,76 +6294,76 @@
6190
6294
  ]
6191
6295
  },
6192
6296
  {
6193
- "component": "OpenProject::TreeView::SubTreeNode",
6194
- "status": "alpha",
6297
+ "component": "OpenProject::SubHeader::Menu",
6298
+ "status": "open_project",
6195
6299
  "a11y_reviewed": false,
6196
- "short_name": "OpenProjectTreeViewSubTreeNode",
6197
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/sub_tree_node.rb",
6198
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/sub_tree_node/default/",
6300
+ "short_name": "OpenProjectSubHeaderMenu",
6301
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/menu.rb",
6302
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/menu/default/",
6199
6303
  "parameters": [
6200
6304
  {
6201
- "name": "label",
6202
- "type": "String",
6203
- "default": "N/A",
6204
- "description": "The node's label, i.e. it's textual content."
6205
- },
6206
- {
6207
- "name": "path",
6208
- "type": "Array<String>",
6209
- "default": "N/A",
6210
- "description": "The node's \"path,\" i.e. this node's label and the labels of all its ancestors. This node should be reachable by traversing the tree following this path."
6305
+ "name": "icon_only",
6306
+ "type": "Boolean",
6307
+ "default": "`false`",
6308
+ "description": "Whether the trigger button is an IconButton"
6211
6309
  },
6212
6310
  {
6213
- "name": "node_variant",
6311
+ "name": "leading_icon",
6214
6312
  "type": "Symbol",
6215
6313
  "default": "N/A",
6216
- "description": "The variant to use for this node. One of `:anchor`, `:button`, or `:div`."
6314
+ "description": "Name of Octicon icon to use as either leading icon or IconButton."
6217
6315
  },
6218
6316
  {
6219
- "name": "expanded",
6220
- "type": "Boolean",
6221
- "default": "`false`",
6222
- "description": "Whether or not this sub-tree should be rendered expanded."
6317
+ "name": "label",
6318
+ "type": "String",
6319
+ "default": "N/A",
6320
+ "description": "The button label"
6223
6321
  },
6224
6322
  {
6225
- "name": "select_strategy",
6226
- "type": "Symbol",
6227
- "default": "`:descendants`",
6228
- "description": "What should happen when this sub-tree node is checked. One of `:descendants` or `:self`."
6323
+ "name": "button_arguments",
6324
+ "type": "Hash",
6325
+ "default": "`{}`",
6326
+ "description": "Additional arguments for the button"
6229
6327
  },
6230
6328
  {
6231
6329
  "name": "system_arguments",
6232
6330
  "type": "Hash",
6233
6331
  "default": "N/A",
6234
- "description": "The arguments accepted by [OpenProject::TreeView::Node](/components/openprojecttreeviewnode)."
6332
+ "description": "[System arguments](/system-arguments)"
6235
6333
  }
6236
6334
  ]
6237
6335
  },
6238
6336
  {
6239
- "component": "OpenProject::TreeView::Visual",
6240
- "status": "alpha",
6241
- "a11y_reviewed": false,
6242
- "short_name": "OpenProjectTreeViewVisual",
6243
- "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/tree_view/visual.rb",
6244
- "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/tree_view/visual/default/",
6337
+ "component": "OpenProject::SubHeader::SegmentedControl",
6338
+ "status": "open_project",
6339
+ "a11y_reviewed": true,
6340
+ "short_name": "OpenProjectSubHeaderSegmentedControl",
6341
+ "source": "https://github.com/primer/view_components/tree/main/app/components/primer/open_project/sub_header/segmented_control.rb",
6342
+ "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/open_project/sub_header/segmented_control/default/",
6245
6343
  "parameters": [
6246
6344
  {
6247
- "name": "id",
6248
- "type": "String",
6249
- "default": "N/A",
6250
- "description": "This visual's HTML ID."
6345
+ "name": "hide_labels",
6346
+ "type": "Boolean",
6347
+ "default": "`false`",
6348
+ "description": "Whether to hide the labels and only show the icons"
6251
6349
  },
6252
6350
  {
6253
- "name": "visual",
6254
- "type": "ViewComponent::Base",
6255
- "default": "N/A",
6256
- "description": "A renderable component like an instance of [Octicon](/components/beta/octicon) to render as the visual."
6351
+ "name": "full_width",
6352
+ "type": "Boolean",
6353
+ "default": "`false`",
6354
+ "description": "If the component should be full width"
6257
6355
  },
6258
6356
  {
6259
- "name": "label",
6260
- "type": "String",
6261
- "default": "`nil`",
6262
- "description": "Text describing this visual that will be visible only to screen readers."
6357
+ "name": "size",
6358
+ "type": "Symbol",
6359
+ "default": "`:medium`",
6360
+ "description": "One of `:large`, `:medium`, or `:small`."
6361
+ },
6362
+ {
6363
+ "name": "system_arguments",
6364
+ "type": "Hash",
6365
+ "default": "N/A",
6366
+ "description": "[System arguments](/system-arguments)"
6263
6367
  }
6264
6368
  ]
6265
6369
  },