playbook-ui 18.2.0 → 18.3.0-alpha.forwardrefwarnings20879

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 (63) hide show
  1. package/dist/.vite/manifest.json +128 -55
  2. package/dist/advanced-table.js +1 -1
  3. package/dist/ai/all-schemas.json +108 -15
  4. package/dist/ai/external-dependencies.json +1 -1
  5. package/dist/ai/forms.json +2 -2
  6. package/dist/ai/index.json +3 -3
  7. package/dist/ai/kits/avatar.schema.json +1 -0
  8. package/dist/ai/kits/contact.schema.json +1 -0
  9. package/dist/ai/kits/date.schema.json +1 -0
  10. package/dist/ai/kits/date_range_inline.schema.json +1 -0
  11. package/dist/ai/kits/date_range_stacked.schema.json +1 -0
  12. package/dist/ai/kits/date_stacked.schema.json +1 -0
  13. package/dist/ai/kits/date_time.schema.json +1 -0
  14. package/dist/ai/kits/date_time_stacked.schema.json +1 -0
  15. package/dist/ai/kits/date_year_stacked.schema.json +1 -0
  16. package/dist/ai/kits/dropdown.schema.json +81 -11
  17. package/dist/ai/kits/image.schema.json +1 -0
  18. package/dist/ai/kits/label_pill.schema.json +1 -0
  19. package/dist/ai/kits/legend.schema.json +1 -0
  20. package/dist/ai/kits/online_status.schema.json +1 -0
  21. package/dist/ai/kits/person.schema.json +1 -0
  22. package/dist/ai/kits/pill.schema.json +1 -0
  23. package/dist/ai/kits/rich_text_editor.schema.json +1 -1
  24. package/dist/ai/kits/source.schema.json +1 -0
  25. package/dist/ai/kits/stat_change.schema.json +1 -0
  26. package/dist/ai/kits/time_range_inline.schema.json +1 -0
  27. package/dist/ai/kits/time_stacked.schema.json +1 -0
  28. package/dist/ai/kits/timestamp.schema.json +1 -0
  29. package/dist/ai/kits/typeahead.schema.json +3 -3
  30. package/dist/ai/kits/user.schema.json +1 -0
  31. package/dist/ai/kits/user_badge.schema.json +1 -0
  32. package/dist/ai/kits/weekday_stacked.schema.json +1 -0
  33. package/dist/ai/playgrounds/dropdown.json +1 -1
  34. package/dist/ai/playgrounds/index.json +1 -1
  35. package/dist/ai/playgrounds/rich_text_editor.json +1 -1
  36. package/dist/ai/playgrounds/typeahead.json +1 -1
  37. package/dist/charts.js +1 -1
  38. package/dist/chunks/_pagination-CARbC_IN.js +1 -0
  39. package/dist/chunks/{_pb_line_graph-Du7xE9vl.js → _pb_line_graph-BKwbOeqo.js} +1 -1
  40. package/dist/chunks/{_detail-Bsvl694i.js → _tooltip-UkcgcThO.js} +2 -2
  41. package/dist/chunks/_typeahead-D_li2Zx8.js +1 -0
  42. package/dist/chunks/{globalProps-B120NbSJ.js → globalProps-BivjwRew.js} +1 -1
  43. package/dist/chunks/index-4jrZjexD.js +1 -0
  44. package/dist/chunks/index-BAy61y8S.js +1 -0
  45. package/dist/chunks/index-Cb_SDipk.js +1 -0
  46. package/dist/chunks/index-D3RdsDp7.js +1 -0
  47. package/dist/chunks/index-D8PZIesy.js +1 -0
  48. package/dist/chunks/index-DIoc-aua.js +1 -0
  49. package/dist/chunks/index-qex65UMn.js +1 -0
  50. package/dist/chunks/lib-C50eCpoN.js +29 -0
  51. package/dist/chunks/{time_picker_helper-CYGg0UQ0.js → time_picker_helper-DfKvHCJu.js} +1 -1
  52. package/dist/chunks/vendor.js +2 -2
  53. package/dist/playbook-advanced-table.js +1 -1
  54. package/dist/playbook-charts.js +1 -1
  55. package/dist/playbook-rails-charts-bindings.js +1 -1
  56. package/dist/playbook-rails-react-bindings.js +1 -1
  57. package/dist/playbook-rails.js +1 -1
  58. package/dist/playbook.css +1 -1
  59. package/dist/playbook.js +1 -1
  60. package/package.json +14 -15
  61. package/dist/chunks/_table-Bf6LGyL9.js +0 -1
  62. package/dist/chunks/_typeahead-w6S5Vx4b.js +0 -1
  63. package/dist/chunks/lib-Buo6zHEw.js +0 -29
@@ -1712,6 +1712,7 @@
1712
1712
  }
1713
1713
  },
1714
1714
  "globalProps": true,
1715
+ "globalEventProps": true,
1715
1716
  "usage": {
1716
1717
  "react": {
1717
1718
  "import": "import { Avatar } from 'playbook-ui'",
@@ -3469,6 +3470,7 @@
3469
3470
  }
3470
3471
  },
3471
3472
  "globalProps": true,
3473
+ "globalEventProps": true,
3472
3474
  "usage": {
3473
3475
  "react": {
3474
3476
  "import": "import { Contact } from 'playbook-ui'",
@@ -3947,6 +3949,7 @@
3947
3949
  }
3948
3950
  },
3949
3951
  "globalProps": true,
3952
+ "globalEventProps": true,
3950
3953
  "usage": {
3951
3954
  "react": {
3952
3955
  "import": "import { Date } from 'playbook-ui'",
@@ -4625,6 +4628,7 @@
4625
4628
  }
4626
4629
  },
4627
4630
  "globalProps": true,
4631
+ "globalEventProps": true,
4628
4632
  "usage": {
4629
4633
  "react": {
4630
4634
  "import": "import { DateRangeInline } from 'playbook-ui'",
@@ -4673,6 +4677,7 @@
4673
4677
  }
4674
4678
  },
4675
4679
  "globalProps": true,
4680
+ "globalEventProps": true,
4676
4681
  "usage": {
4677
4682
  "react": {
4678
4683
  "import": "import { DateRangeStacked } from 'playbook-ui'",
@@ -4763,6 +4768,7 @@
4763
4768
  }
4764
4769
  },
4765
4770
  "globalProps": true,
4771
+ "globalEventProps": true,
4766
4772
  "usage": {
4767
4773
  "react": {
4768
4774
  "import": "import { DateStacked } from 'playbook-ui'",
@@ -4870,6 +4876,7 @@
4870
4876
  }
4871
4877
  },
4872
4878
  "globalProps": true,
4879
+ "globalEventProps": true,
4873
4880
  "usage": {
4874
4881
  "react": {
4875
4882
  "import": "import { DateTime } from 'playbook-ui'",
@@ -4944,6 +4951,7 @@
4944
4951
  }
4945
4952
  },
4946
4953
  "globalProps": true,
4954
+ "globalEventProps": true,
4947
4955
  "usage": {
4948
4956
  "react": {
4949
4957
  "import": "import { DateTimeStacked } from 'playbook-ui'",
@@ -4998,6 +5006,7 @@
4998
5006
  }
4999
5007
  },
5000
5008
  "globalProps": true,
5009
+ "globalEventProps": true,
5001
5010
  "usage": {
5002
5011
  "react": {
5003
5012
  "import": "import { DateYearStacked } from 'playbook-ui'",
@@ -5415,6 +5424,14 @@
5415
5424
  "rails"
5416
5425
  ],
5417
5426
  "props": {
5427
+ "allowOptionCreation": {
5428
+ "type": "boolean",
5429
+ "platforms": [
5430
+ "react",
5431
+ "rails"
5432
+ ],
5433
+ "default": false
5434
+ },
5418
5435
  "async": {
5419
5436
  "type": "boolean",
5420
5437
  "platforms": [
@@ -5555,6 +5572,28 @@
5555
5572
  "rails"
5556
5573
  ]
5557
5574
  },
5575
+ "enableFormSupport": {
5576
+ "type": "boolean",
5577
+ "platforms": [
5578
+ "react"
5579
+ ]
5580
+ },
5581
+ "enablePillReorder": {
5582
+ "type": "boolean",
5583
+ "platforms": [
5584
+ "react",
5585
+ "rails"
5586
+ ],
5587
+ "default": false
5588
+ },
5589
+ "externalDragHandle": {
5590
+ "type": "boolean",
5591
+ "platforms": [
5592
+ "react",
5593
+ "rails"
5594
+ ],
5595
+ "default": false
5596
+ },
5558
5597
  "isClosed": {
5559
5598
  "type": "boolean",
5560
5599
  "platforms": [
@@ -5627,6 +5666,14 @@
5627
5666
  ],
5628
5667
  "default": true
5629
5668
  },
5669
+ "showPillIndex": {
5670
+ "type": "boolean",
5671
+ "platforms": [
5672
+ "react",
5673
+ "rails"
5674
+ ],
5675
+ "default": false
5676
+ },
5630
5677
  "variant": {
5631
5678
  "type": "enum",
5632
5679
  "platforms": [
@@ -5680,17 +5727,19 @@
5680
5727
  "default": false
5681
5728
  },
5682
5729
  "required": {
5730
+ "type": "boolean",
5683
5731
  "platforms": [
5732
+ "react",
5684
5733
  "rails"
5685
5734
  ],
5686
- "type": "boolean",
5687
5735
  "default": false
5688
5736
  },
5689
5737
  "validationMessage": {
5738
+ "type": "string",
5690
5739
  "platforms": [
5740
+ "react",
5691
5741
  "rails"
5692
5742
  ],
5693
- "type": "string",
5694
5743
  "default": ""
5695
5744
  },
5696
5745
  "searchTermMinimumLength": {
@@ -5779,13 +5828,13 @@
5779
5828
  "usage": {
5780
5829
  "react": {
5781
5830
  "import": "import { Dropdown } from 'playbook-ui'",
5782
- "example": "<Dropdown />",
5783
- "preset": "Async search"
5831
+ "example": "<Dropdown allowOptionCreation multiSelect name=\"tags[]\" label=\"Tags\" />",
5832
+ "preset": "Create tags"
5784
5833
  },
5785
5834
  "rails": {
5786
5835
  "import": null,
5787
- "example": "<%= pb_rails(\"dropdown\") %>",
5788
- "preset": "Async search"
5836
+ "example": "<%= pb_rails(\"dropdown\", props: { allow_option_creation: true, multi_select: true, name: \"tags[]\", label: \"Tags\" }) %>",
5837
+ "preset": "Create tags"
5789
5838
  }
5790
5839
  },
5791
5840
  "category": "form_selection",
@@ -5828,7 +5877,7 @@
5828
5877
  "submission": {
5829
5878
  "submits": true,
5830
5879
  "value": "Selected option id in a CSS-hidden input (not input type=hidden).",
5831
- "multi": "Comma-joining is only the default-value encoding (data-default-value and a temporary baseInput.value). After kit JS runs, syncHiddenInputs emits one input type=\"hidden\" per selected id, all named name[] (the CSS-hidden input already has [] appended), then clears that original CSS-hidden input. Rails receives separate array entries such as [\"ca\",\"us\"], not \"ca,us\".",
5880
+ "multi": "syncHiddenInputs emits one hidden input per selected id in selection order, adds [] to the name only if absent and clears the original CSS-hidden input and removes its name while selections exist, so no blank array entry is submitted. When empty, the original name and required state are restored, including after Turbo reconnects. These submission fixes apply whether or not allow_option_creation is enabled. With enable_pill_reorder, drag or keyboard reordering updates that same selection order before syncHiddenInputs runs, so submitted values and pb:dropdown:reordered / pb:dropdown:selected details match the pill order. Comma-joining is used for default-value encoding, not as an additional submitted selection.",
5832
5881
  "dynamicOptions": "props.options_by_context with props.context_selector replaces the rendered options when the referenced element fires change, and props.clear_on_context_change (default true) then clears the selection, so a context change can submit an empty value. A pb:dropdown:updateOptions event, or an event named in props.options_event_type, replaces options the same way; clearSelection: false keeps only selections whose id exists in the replacement options."
5833
5882
  },
5834
5883
  "validation": {
@@ -5962,6 +6011,33 @@
5962
6011
  "form.rails.builder.simpleForm"
5963
6012
  ]
5964
6013
  },
6014
+ {
6015
+ "id": "dropdown.pill-reorder",
6016
+ "platforms": [
6017
+ "react",
6018
+ "rails"
6019
+ ],
6020
+ "questions": [
6021
+ "Can multi-select Dropdown pills be reordered?",
6022
+ "How do I enable draggable pills on Dropdown?",
6023
+ "Does pill reorder preserve form submission order?"
6024
+ ],
6025
+ "answer": "Opt in with enablePillReorder (Rails: enable_pill_reorder) on multi-select or multi-select + autocomplete. showPillIndex / show_pill_index numbers the pills. By default the whole pill is draggable with an in-pill grip; externalDragHandle / external_drag_handle requires an external grip. Focused pills reorder with ArrowLeft / ArrowRight. React onChange and Rails hidden inputs keep the new order; Rails also emits pb:dropdown:reordered (and pb:dropdown:selected) with the reordered array. Single-select is unaffected; reordering is off by default."
6026
+ },
6027
+ {
6028
+ "id": "dropdown.option-creation",
6029
+ "platforms": [
6030
+ "react",
6031
+ "rails"
6032
+ ],
6033
+ "questions": [
6034
+ "How do I create new Dropdown options?"
6035
+ ],
6036
+ "answer": "Enable allowOptionCreation (Rails: allow_option_creation). The default trigger enables autocomplete. Custom Rails subcomponents must supply an autocomplete trigger or search bar. Creation supports single and multiple selections, including async, and is ignored for quickpick. A selectable Create row yields { id: text, label: text, value: text, __isNew__: true } through normal React selection callbacks, Rails pb:dropdown:selected events, and native form submission. Text is trimmed and blank or case-insensitive existing/selected labels, values and IDs are rejected. Exact ID or value matches keep the existing option selectable even if its label does not contain the query. Pending async searches and errors suppress creation. Creation only selects local text; the application owns persistence.",
6037
+ "props": [
6038
+ "allowOptionCreation"
6039
+ ]
6040
+ },
5965
6041
  {
5966
6042
  "id": "dropdown.builder-name",
5967
6043
  "platforms": [
@@ -5971,7 +6047,7 @@
5971
6047
  "Does dropdown_field scope country to user[country]?",
5972
6048
  "Does multi_select submit separate array values?"
5973
6049
  ],
5974
- "answer": "Pass the attribute (e.g. :country) so the builder can auto-bind default_value and errors from the model; pass user[country] explicitly when you need that nested parameter name instead. multi_select appends [] to the CSS-hidden input name. Comma-joining is only for default-value encoding. After kit JS runs, Playbook emits one type=\"hidden\" input per selected id (all named name[]), clears the original CSS-hidden input, and Rails receives separate array entries.",
6050
+ "answer": "Pass the attribute (e.g. :country) so the builder can auto-bind default_value and errors from the model; pass user[country] explicitly when you need that nested parameter name instead. multi_select adds [] only if absent, preserves selection order and removes the original CSS-hidden input name while per-selection hidden inputs submit. When selection is empty, the original name and required state are restored, including after Turbo reconnects. These submission fixes apply whether or not allow_option_creation is enabled.",
5975
6051
  "contractPaths": [
5976
6052
  "form.rails.builder.methods"
5977
6053
  ],
@@ -6073,7 +6149,7 @@
6073
6149
  "How do I reset React Dropdown?",
6074
6150
  "Does cacheOptions remember an empty search?"
6075
6151
  ],
6076
- "answer": "Use onInputChange(text, { reason }) for input and clear notifications. Selection itself does not emit an input notification; use onSelect. In async mode, emptying single-select autocomplete proposes an empty selection even without onInputChange; emptying a multi-select or search-bar query preserves selection. With loadOptions, an empty query and a multi-select selection restore the defaultOptions results. A single-select autocomplete selection keeps that search result list and shows the selected label in the input; opening the menu again shows only results whose labels contain that text. Typing a character replaces the query only while the input still shows that label, including when a controlled value later arrives as null. Once the text has changed, further characters edit the query in place. Backspace and Delete remove one character and keep the selection until the query is empty. Escape, an outside click, or disabling the kit cancels an in-flight loadOptions request and ignores its late response. If that search had cleared the list, the last settled options return, or defaultOptions when nothing has settled yet. Opening the menu again searches for the query still in the input; ref.clearSelected() drops that retry. A search that already settled as an error or with no results keeps that message when the menu closes, and opening it again does not search again. Opening an async Dropdown with no source options, or a search that settles empty and has no earlier label matches, shows the empty message (noOptionsText, default \"No results found\"). When a search returns nothing, earlier results whose labels contain the query stay visible, including text typed after a space. cacheOptions stores the server response for that exact query, including an empty array. Each Dropdown keeps at most 100 queries. Errors are not cached. Repeating the query after a clear shows that cached response, so an empty search stays empty. Already-selected rows are hidden and do not count as an empty search, so a successful result list or an idle list that still contains options does not show that message when every remaining row is selected. blankSelection is not a search result: an empty async list shows the empty message instead of the blank row, and the blank row is included when results are present. Async options are identified by value, then id, then label. Reset controlled value through the application or form library, or call ref.clearSelected() for an uncontrolled selection. React Dropdown does not add native form-reset handling. For application-managed fetching, use async with options and loading without loadOptions; the application owns debounce, query thresholds, errors and stale-response protection. When the menu is open, a new result list focuses the first match so Enter selects it, for both loadOptions and application-managed options. ArrowDown and ArrowUp still move through that list.",
6152
+ "answer": "Use onInputChange(text, { reason }) for input and clear notifications. Selection itself does not emit an input notification; use onSelect. In async mode, emptying single-select autocomplete proposes an empty selection even without onInputChange; emptying a multi-select or search-bar query preserves selection. With loadOptions, an empty query and a multi-select selection restore the defaultOptions results. A single-select autocomplete selection keeps that search result list and shows the selected label in the input; opening the menu again shows only results whose labels contain that text. Typing a character replaces the query only while the input still shows that label, including when a controlled value later arrives as null. Once the text has changed, further characters edit the query in place. Backspace and Delete remove one character and keep the selection until the query is empty. Escape, an outside click, or disabling the kit cancels an in-flight loadOptions request and ignores its late response. If that search had cleared the list, the last settled options return, or defaultOptions when nothing has settled yet. Opening the menu again searches for the query still in the input; ref.clearSelected() drops that retry. A search that already settled as an error or with no results keeps that message when the menu closes, and opening it again does not search again. Opening an async Dropdown with no source options, or a search that settles empty and has no earlier label matches, shows the empty message (noOptionsText, default \"No results found\"). When a search returns nothing, earlier results whose labels contain the query stay visible, including text typed after a space. cacheOptions stores the server response for that exact query, including an empty array. Each Dropdown keeps at most 100 queries. Errors are not cached. Repeating the query after a clear shows that cached response, so an empty search stays empty. Already-selected rows are hidden and do not count as an empty search, so a successful result list or an idle list that still contains options does not show that message when every remaining row is selected. blankSelection is not a search result: an empty async list shows the empty message instead of the blank row, and the blank row is included when results are present. Async options are identified by value, then id, then label. Reset controlled value through the application or form library, or call ref.clearSelected() for an uncontrolled selection. With enableFormSupport: true, native form reset restores defaultValue, clears the query and validation state, closes the menu, and reports the reset through selection callbacks. Controlled parents must accept the new value. Canceled resets preserve state. For application-managed fetching, use async with options and loading without loadOptions; the application owns debounce, query thresholds, errors and stale-response protection. When the menu is open, a new result list focuses the first match so Enter selects it, for both loadOptions and application-managed options. ArrowDown and ArrowUp still move through that list.",
6077
6153
  "props": [
6078
6154
  "onInputChange",
6079
6155
  "async",
@@ -6096,12 +6172,15 @@
6096
6172
  "Can I use Dropdown with react-hook-form?",
6097
6173
  "Does the React Dropdown submit a value?"
6098
6174
  ],
6099
- "answer": "Spread register(\"country\") onto Dropdown. It accepts name and onChange, and calls onChange with { target: { name, value } } in addition to any onSelect. value is the selected option object, an array for multiSelect and null or [] when cleared, so read value.value in form state. The ref from register resolves to the kit imperative handle, not an input, and no named input is rendered; the React kit has no native form submission.",
6175
+ "answer": "Use a controlled form-library adapter with name, value, and onChange. It accepts name and onChange, and calls onChange with { target: { name, value } } in addition to any onSelect. value is the selected option object, an array for multiSelect and null or [] when cleared, so read value.value in form state. The ref resolves to the kit imperative handle, not an input. With enableFormSupport: true and name, native forms submit selected id (falling back to value) through hidden inputs; multiSelect emits one input per selection and adds [] only if absent. Disabled fields are omitted. enableFormSupport defaults to false, so name alone adds no native inputs or reset handling. With form support enabled, required validates the selection and validationMessage sets the inline required message. Native reset restores defaultValue through the normal callbacks; controlled parents must update value.",
6100
6176
  "props": [
6101
6177
  "name",
6102
6178
  "onChange",
6103
6179
  "onSelect",
6104
- "multiSelect"
6180
+ "multiSelect",
6181
+ "enableFormSupport",
6182
+ "required",
6183
+ "validationMessage"
6105
6184
  ]
6106
6185
  }
6107
6186
  ]
@@ -7939,6 +8018,7 @@
7939
8018
  }
7940
8019
  },
7941
8020
  "globalProps": true,
8021
+ "globalEventProps": true,
7942
8022
  "usage": {
7943
8023
  "react": {
7944
8024
  "import": "import { Image } from 'playbook-ui'",
@@ -7995,6 +8075,7 @@
7995
8075
  }
7996
8076
  },
7997
8077
  "globalProps": true,
8078
+ "globalEventProps": true,
7998
8079
  "usage": {
7999
8080
  "react": {
8000
8081
  "import": "import { LabelPill } from 'playbook-ui'",
@@ -8273,6 +8354,7 @@
8273
8354
  }
8274
8355
  },
8275
8356
  "globalProps": true,
8357
+ "globalEventProps": true,
8276
8358
  "usage": {
8277
8359
  "react": {
8278
8360
  "import": "import { Legend } from 'playbook-ui'",
@@ -9497,6 +9579,7 @@
9497
9579
  }
9498
9580
  },
9499
9581
  "globalProps": true,
9582
+ "globalEventProps": true,
9500
9583
  "usage": {
9501
9584
  "react": {
9502
9585
  "import": "import { OnlineStatus } from 'playbook-ui'",
@@ -9994,6 +10077,7 @@
9994
10077
  }
9995
10078
  },
9996
10079
  "globalProps": true,
10080
+ "globalEventProps": true,
9997
10081
  "usage": {
9998
10082
  "react": {
9999
10083
  "import": "import { Person } from 'playbook-ui'",
@@ -10519,6 +10603,7 @@
10519
10603
  }
10520
10604
  },
10521
10605
  "globalProps": true,
10606
+ "globalEventProps": true,
10522
10607
  "usage": {
10523
10608
  "react": {
10524
10609
  "import": "import { Pill } from 'playbook-ui'",
@@ -11237,7 +11322,7 @@
11237
11322
  "prosemirror-model"
11238
11323
  ],
11239
11324
  "optional": true,
11240
- "note": "Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails loads TipTap from esm.sh and accepts only these extension strings: underline, text_align, horizontal_rule, image."
11325
+ "note": "Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails bundles TipTap in playbook-rails.js (no host packages needed) and accepts only these extension strings: underline, text_align, horizontal_rule, image."
11241
11326
  }
11242
11327
  },
11243
11328
  "section_separator": {
@@ -12364,6 +12449,7 @@
12364
12449
  }
12365
12450
  },
12366
12451
  "globalProps": true,
12452
+ "globalEventProps": true,
12367
12453
  "usage": {
12368
12454
  "react": {
12369
12455
  "import": "import { Source } from 'playbook-ui'",
@@ -12764,6 +12850,7 @@
12764
12850
  }
12765
12851
  },
12766
12852
  "globalProps": true,
12853
+ "globalEventProps": true,
12767
12854
  "usage": {
12768
12855
  "react": {
12769
12856
  "import": "import { StatChange } from 'playbook-ui'",
@@ -14620,6 +14707,7 @@
14620
14707
  }
14621
14708
  },
14622
14709
  "globalProps": true,
14710
+ "globalEventProps": true,
14623
14711
  "usage": {
14624
14712
  "react": {
14625
14713
  "import": "import { TimeRangeInline } from 'playbook-ui'",
@@ -14690,6 +14778,7 @@
14690
14778
  }
14691
14779
  },
14692
14780
  "globalProps": true,
14781
+ "globalEventProps": true,
14693
14782
  "usage": {
14694
14783
  "react": {
14695
14784
  "import": "import { TimeStacked } from 'playbook-ui'",
@@ -14892,6 +14981,7 @@
14892
14981
  }
14893
14982
  },
14894
14983
  "globalProps": true,
14984
+ "globalEventProps": true,
14895
14985
  "usage": {
14896
14986
  "react": {
14897
14987
  "import": "import { Timestamp } from 'playbook-ui'",
@@ -15622,7 +15712,7 @@
15622
15712
  ],
15623
15713
  "default": false
15624
15714
  },
15625
- "showPillIndex": {
15715
+ "externalDragHandle": {
15626
15716
  "type": "boolean",
15627
15717
  "platforms": [
15628
15718
  "react",
@@ -15630,13 +15720,13 @@
15630
15720
  ],
15631
15721
  "default": false
15632
15722
  },
15633
- "pillDragHandle": {
15723
+ "showPillIndex": {
15634
15724
  "type": "boolean",
15635
15725
  "platforms": [
15636
15726
  "react",
15637
15727
  "rails"
15638
15728
  ],
15639
- "default": true
15729
+ "default": false
15640
15730
  },
15641
15731
  "styles": {
15642
15732
  "type": "TypeaheadStylesConfig",
@@ -16073,6 +16163,7 @@
16073
16163
  }
16074
16164
  },
16075
16165
  "globalProps": true,
16166
+ "globalEventProps": true,
16076
16167
  "usage": {
16077
16168
  "react": {
16078
16169
  "import": "import { User } from 'playbook-ui'",
@@ -16124,6 +16215,7 @@
16124
16215
  }
16125
16216
  },
16126
16217
  "globalProps": true,
16218
+ "globalEventProps": true,
16127
16219
  "usage": {
16128
16220
  "react": {
16129
16221
  "import": "import { UserBadge } from 'playbook-ui'",
@@ -16197,6 +16289,7 @@
16197
16289
  }
16198
16290
  },
16199
16291
  "globalProps": true,
16292
+ "globalEventProps": true,
16200
16293
  "usage": {
16201
16294
  "react": {
16202
16295
  "import": "import { WeekdayStacked } from 'playbook-ui'",
@@ -1 +1 @@
1
- {"description":"Kits that need host-app packages (from each kit’s docs/_playground.overrides.json → externalDependencies). Agents must NOT install packages — tell the user if they are missing.","bundledWithPlaybookUi":["flatpickr","intl-tel-input","@floating-ui/dom","@popperjs/core"],"kits":{"map":{"packages":["maplibre-gl"],"optional":true,"note":"Map wraps MapLibre. The host app must already have maplibre-gl (and any required CSS) installed. Agents must not install packages — tell the user if they are missing."},"pb_bar_graph":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_circle_chart":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_gauge_chart":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_line_graph":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"rich_text_editor":{"packages":["react-trix","trix","@tiptap/react","@tiptap/starter-kit","@tiptap/extension-link","prosemirror-markdown","prosemirror-model"],"optional":true,"note":"Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails loads TipTap from esm.sh and accepts only these extension strings: underline, text_align, horizontal_rule, image."}}}
1
+ {"description":"Kits that need host-app packages (from each kit’s docs/_playground.overrides.json → externalDependencies). Agents must NOT install packages — tell the user if they are missing.","bundledWithPlaybookUi":["flatpickr","intl-tel-input","@floating-ui/dom","@popperjs/core"],"kits":{"map":{"packages":["maplibre-gl"],"optional":true,"note":"Map wraps MapLibre. The host app must already have maplibre-gl (and any required CSS) installed. Agents must not install packages — tell the user if they are missing."},"pb_bar_graph":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_circle_chart":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_gauge_chart":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"pb_line_graph":{"packages":["highcharts","highcharts-react-official"],"optional":true,"note":"This kit wraps Highcharts and does not ship it. The host app must already have these packages installed before using the kit. Agents must not install packages — tell the user if they are missing.","docs":"https://api.highcharts.com/highcharts/"},"rich_text_editor":{"packages":["react-trix","trix","@tiptap/react","@tiptap/starter-kit","@tiptap/extension-link","prosemirror-markdown","prosemirror-model"],"optional":true,"note":"Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails bundles TipTap in playbook-rails.js (no host packages needed) and accepts only these extension strings: underline, text_align, horizontal_rule, image."}}}
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "metadataVersion": 1,
3
- "version": "18.2.0",
3
+ "version": "18.3.0-alpha.forwardrefwarnings20879",
4
4
  "builder": {
5
5
  "class": "Playbook::Forms::Builder",
6
6
  "helper": "pb_form_with",
@@ -557,7 +557,7 @@
557
557
  "submission": {
558
558
  "submits": true,
559
559
  "value": "Selected option id in a CSS-hidden input (not input type=hidden).",
560
- "multi": "Comma-joining is only the default-value encoding (data-default-value and a temporary baseInput.value). After kit JS runs, syncHiddenInputs emits one input type=\"hidden\" per selected id, all named name[] (the CSS-hidden input already has [] appended), then clears that original CSS-hidden input. Rails receives separate array entries such as [\"ca\",\"us\"], not \"ca,us\".",
560
+ "multi": "syncHiddenInputs emits one hidden input per selected id in selection order, adds [] to the name only if absent and clears the original CSS-hidden input and removes its name while selections exist, so no blank array entry is submitted. When empty, the original name and required state are restored, including after Turbo reconnects. These submission fixes apply whether or not allow_option_creation is enabled. With enable_pill_reorder, drag or keyboard reordering updates that same selection order before syncHiddenInputs runs, so submitted values and pb:dropdown:reordered / pb:dropdown:selected details match the pill order. Comma-joining is used for default-value encoding, not as an additional submitted selection.",
561
561
  "dynamicOptions": "props.options_by_context with props.context_selector replaces the rendered options when the referenced element fires change, and props.clear_on_context_change (default true) then clears the selection, so a context change can submit an empty value. A pb:dropdown:updateOptions event, or an event named in props.options_event_type, replaces options the same way; clearSelection: false keeps only selections whose id exists in the replacement options."
562
562
  },
563
563
  "validation": {
@@ -1,8 +1,8 @@
1
1
  {
2
- "version": "18.2.0",
2
+ "version": "18.3.0-alpha.forwardrefwarnings20879",
3
3
  "metadataVersion": 1,
4
4
  "forms": "forms.json",
5
- "generated": "2026-10-22T17:59:05.292Z",
5
+ "generated": "2026-11-05T17:36:05.033Z",
6
6
  "schemas": {
7
7
  "globalProps": "global-props.schema.json",
8
8
  "globalEventProps": "global-event-props.schema.json",
@@ -838,7 +838,7 @@
838
838
  "prosemirror-model"
839
839
  ],
840
840
  "optional": true,
841
- "note": "Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails loads TipTap from esm.sh and accepts only these extension strings: underline, text_align, horizontal_rule, image."
841
+ "note": "Default React editor uses Trix (pass TrixEditor from react-trix). Advanced React editor uses TipTap, and the host app must already have the needed packages installed. Agents must not install packages — tell the user if they are missing. Rails bundles TipTap in playbook-rails.js (no host packages needed) and accepts only these extension strings: underline, text_align, horizontal_rule, image."
842
842
  }
843
843
  },
844
844
  "section_separator": {
@@ -83,6 +83,7 @@
83
83
  }
84
84
  },
85
85
  "globalProps": true,
86
+ "globalEventProps": true,
86
87
  "usage": {
87
88
  "react": {
88
89
  "import": "import { Avatar } from 'playbook-ui'",
@@ -52,6 +52,7 @@
52
52
  }
53
53
  },
54
54
  "globalProps": true,
55
+ "globalEventProps": true,
55
56
  "usage": {
56
57
  "react": {
57
58
  "import": "import { Contact } from 'playbook-ui'",
@@ -90,6 +90,7 @@
90
90
  }
91
91
  },
92
92
  "globalProps": true,
93
+ "globalEventProps": true,
93
94
  "usage": {
94
95
  "react": {
95
96
  "import": "import { Date } from 'playbook-ui'",
@@ -71,6 +71,7 @@
71
71
  }
72
72
  },
73
73
  "globalProps": true,
74
+ "globalEventProps": true,
74
75
  "usage": {
75
76
  "react": {
76
77
  "import": "import { DateRangeInline } from 'playbook-ui'",
@@ -31,6 +31,7 @@
31
31
  }
32
32
  },
33
33
  "globalProps": true,
34
+ "globalEventProps": true,
34
35
  "usage": {
35
36
  "react": {
36
37
  "import": "import { DateRangeStacked } from 'playbook-ui'",
@@ -73,6 +73,7 @@
73
73
  }
74
74
  },
75
75
  "globalProps": true,
76
+ "globalEventProps": true,
76
77
  "usage": {
77
78
  "react": {
78
79
  "import": "import { DateStacked } from 'playbook-ui'",
@@ -90,6 +90,7 @@
90
90
  }
91
91
  },
92
92
  "globalProps": true,
93
+ "globalEventProps": true,
93
94
  "usage": {
94
95
  "react": {
95
96
  "import": "import { DateTime } from 'playbook-ui'",
@@ -57,6 +57,7 @@
57
57
  }
58
58
  },
59
59
  "globalProps": true,
60
+ "globalEventProps": true,
60
61
  "usage": {
61
62
  "react": {
62
63
  "import": "import { DateTimeStacked } from 'playbook-ui'",
@@ -37,6 +37,7 @@
37
37
  }
38
38
  },
39
39
  "globalProps": true,
40
+ "globalEventProps": true,
40
41
  "usage": {
41
42
  "react": {
42
43
  "import": "import { DateYearStacked } from 'playbook-ui'",