@shopify/ui-extensions 2025.10.0-rc.45 → 2025.10.0-rc.47

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 (304) hide show
  1. package/build/cjs/surfaces/checkout/preact/api.js +1 -1
  2. package/build/cjs/surfaces/checkout/shared.js +1 -1
  3. package/build/esm/surfaces/checkout/preact/api.mjs +1 -1
  4. package/build/esm/surfaces/checkout/shared.mjs +1 -1
  5. package/build/esnext/surfaces/checkout/preact/api.esnext +1 -1
  6. package/build/esnext/surfaces/checkout/shared.esnext +1 -1
  7. package/build/ts/docs/shared/components/ConsentCheckbox.d.ts +4 -0
  8. package/build/ts/docs/shared/components/ConsentCheckbox.d.ts.map +1 -0
  9. package/build/ts/docs/shared/components/ConsentPhoneField.d.ts +4 -0
  10. package/build/ts/docs/shared/components/ConsentPhoneField.d.ts.map +1 -0
  11. package/build/ts/docs/shared/components/index.d.ts +2 -0
  12. package/build/ts/docs/shared/components/index.d.ts.map +1 -1
  13. package/build/ts/surfaces/checkout/components/ConsentCheckbox/ConsentCheckbox.doc.d.ts +4 -0
  14. package/build/ts/surfaces/checkout/components/ConsentCheckbox/ConsentCheckbox.doc.d.ts.map +1 -0
  15. package/build/ts/surfaces/checkout/components/ConsentCheckbox.d.ts +84 -0
  16. package/build/ts/surfaces/checkout/components/ConsentPhoneField/ConsentPhoneField.doc.d.ts +4 -0
  17. package/build/ts/surfaces/checkout/components/ConsentPhoneField/ConsentPhoneField.doc.d.ts.map +1 -0
  18. package/build/ts/surfaces/checkout/components/ConsentPhoneField.d.ts +129 -0
  19. package/build/ts/surfaces/checkout/components/NumberField/NumberField.doc.d.ts +4 -0
  20. package/build/ts/surfaces/checkout/components/NumberField/NumberField.doc.d.ts.map +1 -0
  21. package/build/ts/surfaces/checkout/components/NumberField.d.ts +98 -0
  22. package/build/ts/surfaces/checkout/components/PasswordField.d.ts +1 -1
  23. package/build/ts/surfaces/checkout/components/components-shared.d.ts +17 -0
  24. package/build/ts/surfaces/checkout/components/components.d.ts +216 -144
  25. package/build/ts/surfaces/checkout/shared.d.ts +1 -1
  26. package/build/ts/surfaces/checkout/shared.d.ts.map +1 -1
  27. package/build/ts/surfaces/checkout/targets/Checkout::Actions::RenderBefore.d.ts +3 -0
  28. package/build/ts/surfaces/checkout/targets/Checkout::CartLineDetails::RenderAfter.d.ts +3 -0
  29. package/build/ts/surfaces/checkout/targets/Checkout::CartLineDetails::RenderLineComponents.d.ts +3 -0
  30. package/build/ts/surfaces/checkout/targets/Checkout::CartLines::RenderAfter.d.ts +3 -0
  31. package/build/ts/surfaces/checkout/targets/Checkout::Contact::RenderAfter.d.ts +3 -0
  32. package/build/ts/surfaces/checkout/targets/Checkout::CustomerInformation::RenderAfter.d.ts +3 -0
  33. package/build/ts/surfaces/checkout/targets/Checkout::DeliveryAddress::RenderBefore.d.ts +3 -0
  34. package/build/ts/surfaces/checkout/targets/Checkout::Dynamic::Render.d.ts +3 -0
  35. package/build/ts/surfaces/checkout/targets/Checkout::GiftCard::Render.d.ts +3 -0
  36. package/build/ts/surfaces/checkout/targets/Checkout::PaymentMethod::HostedFields::RenderAfter.d.ts +3 -0
  37. package/build/ts/surfaces/checkout/targets/Checkout::PaymentMethod::Render.d.ts +3 -0
  38. package/build/ts/surfaces/checkout/targets/Checkout::PaymentMethod::RenderRequiredAction.d.ts +3 -0
  39. package/build/ts/surfaces/checkout/targets/Checkout::PickupLocations::RenderAfter.d.ts +3 -0
  40. package/build/ts/surfaces/checkout/targets/Checkout::PickupLocations::RenderBefore.d.ts +3 -0
  41. package/build/ts/surfaces/checkout/targets/Checkout::PickupPoints::RenderAfter.d.ts +3 -0
  42. package/build/ts/surfaces/checkout/targets/Checkout::PickupPoints::RenderBefore.d.ts +3 -0
  43. package/build/ts/surfaces/checkout/targets/Checkout::Reductions::RenderAfter.d.ts +3 -0
  44. package/build/ts/surfaces/checkout/targets/Checkout::Reductions::RenderBefore.d.ts +3 -0
  45. package/build/ts/surfaces/checkout/targets/Checkout::ShippingMethodDetails::RenderAfter.d.ts +3 -0
  46. package/build/ts/surfaces/checkout/targets/Checkout::ShippingMethodDetails::RenderExpanded.d.ts +3 -0
  47. package/build/ts/surfaces/checkout/targets/Checkout::ShippingMethods::RenderAfter.d.ts +3 -0
  48. package/build/ts/surfaces/checkout/targets/Checkout::ShippingMethods::RenderBefore.d.ts +3 -0
  49. package/build/ts/surfaces/checkout/targets/Checkout::ThankYou::CartLineDetails::RenderAfter.d.ts +3 -0
  50. package/build/ts/surfaces/checkout/targets/Checkout::ThankYou::CartLines::RenderAfter.d.ts +3 -0
  51. package/build/ts/surfaces/checkout/targets/Checkout::ThankYou::CustomerInformation::RenderAfter.d.ts +3 -0
  52. package/build/ts/surfaces/checkout/targets/Checkout::ThankYou::Dynamic::Render.d.ts +3 -0
  53. package/build/ts/surfaces/checkout/targets/purchase.cart-line-item.line-components.render.d.ts +3 -0
  54. package/build/ts/surfaces/checkout/targets/purchase.checkout.actions.render-before.d.ts +3 -0
  55. package/build/ts/surfaces/checkout/targets/purchase.checkout.block.render.d.ts +3 -0
  56. package/build/ts/surfaces/checkout/targets/purchase.checkout.cart-line-item.render-after.d.ts +3 -0
  57. package/build/ts/surfaces/checkout/targets/purchase.checkout.cart-line-list.render-after.d.ts +3 -0
  58. package/build/ts/surfaces/checkout/targets/purchase.checkout.contact.render-after.d.ts +3 -0
  59. package/build/ts/surfaces/checkout/targets/purchase.checkout.delivery-address.render-after.d.ts +3 -0
  60. package/build/ts/surfaces/checkout/targets/purchase.checkout.delivery-address.render-before.d.ts +3 -0
  61. package/build/ts/surfaces/checkout/targets/purchase.checkout.footer.render-after.d.ts +3 -0
  62. package/build/ts/surfaces/checkout/targets/purchase.checkout.gift-card.render.d.ts +3 -0
  63. package/build/ts/surfaces/checkout/targets/purchase.checkout.header.render-after.d.ts +3 -0
  64. package/build/ts/surfaces/checkout/targets/purchase.checkout.payment-method-list.render-after.d.ts +3 -0
  65. package/build/ts/surfaces/checkout/targets/purchase.checkout.payment-method-list.render-before.d.ts +3 -0
  66. package/build/ts/surfaces/checkout/targets/purchase.checkout.payment-option-item.action-required.render.d.ts +3 -0
  67. package/build/ts/surfaces/checkout/targets/purchase.checkout.payment-option-item.details.render.d.ts +3 -0
  68. package/build/ts/surfaces/checkout/targets/purchase.checkout.payment-option-item.hosted-fields.render-after.d.ts +3 -0
  69. package/build/ts/surfaces/checkout/targets/purchase.checkout.pickup-location-list.render-after.d.ts +3 -0
  70. package/build/ts/surfaces/checkout/targets/purchase.checkout.pickup-location-list.render-before.d.ts +3 -0
  71. package/build/ts/surfaces/checkout/targets/purchase.checkout.pickup-location-option-item.render-after.d.ts +3 -0
  72. package/build/ts/surfaces/checkout/targets/purchase.checkout.pickup-point-list.render-after.d.ts +3 -0
  73. package/build/ts/surfaces/checkout/targets/purchase.checkout.pickup-point-list.render-before.d.ts +3 -0
  74. package/build/ts/surfaces/checkout/targets/purchase.checkout.reductions.render-after.d.ts +3 -0
  75. package/build/ts/surfaces/checkout/targets/purchase.checkout.reductions.render-before.d.ts +3 -0
  76. package/build/ts/surfaces/checkout/targets/purchase.checkout.shipping-option-item.details.render.d.ts +3 -0
  77. package/build/ts/surfaces/checkout/targets/purchase.checkout.shipping-option-item.render-after.d.ts +3 -0
  78. package/build/ts/surfaces/checkout/targets/purchase.checkout.shipping-option-list.render-after.d.ts +3 -0
  79. package/build/ts/surfaces/checkout/targets/purchase.checkout.shipping-option-list.render-before.d.ts +3 -0
  80. package/build/ts/surfaces/checkout/targets/purchase.thank-you.announcement.render.d.ts +3 -0
  81. package/build/ts/surfaces/checkout/targets/purchase.thank-you.block.render.d.ts +3 -0
  82. package/build/ts/surfaces/checkout/targets/purchase.thank-you.cart-line-item.render-after.d.ts +3 -0
  83. package/build/ts/surfaces/checkout/targets/purchase.thank-you.cart-line-list.render-after.d.ts +3 -0
  84. package/build/ts/surfaces/checkout/targets/purchase.thank-you.customer-information.render-after.d.ts +3 -0
  85. package/build/ts/surfaces/checkout/targets/purchase.thank-you.footer.render-after.d.ts +3 -0
  86. package/build/ts/surfaces/checkout/targets/purchase.thank-you.header.render-after.d.ts +3 -0
  87. package/build/ts/surfaces/customer-account/components/ConsentCheckbox.d.ts +84 -0
  88. package/build/ts/surfaces/customer-account/components/ConsentPhoneField.d.ts +129 -0
  89. package/build/ts/surfaces/customer-account/components/NumberField.d.ts +98 -0
  90. package/build/ts/surfaces/customer-account/components/PasswordField.d.ts +1 -1
  91. package/build/ts/surfaces/customer-account/components/components-shared.d.ts +17 -0
  92. package/build/ts/surfaces/customer-account/components/components.d.ts +216 -144
  93. package/build/ts/surfaces/customer-account/targets/customer-account.footer.render-after.d.ts +3 -0
  94. package/build/ts/surfaces/customer-account/targets/customer-account.order-index.announcement.render.d.ts +3 -0
  95. package/build/ts/surfaces/customer-account/targets/customer-account.order-index.block.render.d.ts +3 -0
  96. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.announcement.render.d.ts +3 -0
  97. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.block.render.d.ts +3 -0
  98. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.cart-line-item.render-after.d.ts +3 -0
  99. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.cart-line-list.render-after.d.ts +3 -0
  100. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.customer-information.render-after.d.ts +3 -0
  101. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.fulfillment-details.render-after.d.ts +3 -0
  102. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.payment-details.render-after.d.ts +3 -0
  103. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.return-details.render-after.d.ts +3 -0
  104. package/build/ts/surfaces/customer-account/targets/customer-account.order-status.unfulfilled-items.render-after.d.ts +3 -0
  105. package/build/ts/surfaces/customer-account/targets/customer-account.order.action.menu-item.render.d.ts +3 -0
  106. package/build/ts/surfaces/customer-account/targets/customer-account.order.action.render.d.ts +3 -0
  107. package/build/ts/surfaces/customer-account/targets/customer-account.order.page.render.d.ts +3 -0
  108. package/build/ts/surfaces/customer-account/targets/customer-account.page.render.d.ts +3 -0
  109. package/build/ts/surfaces/customer-account/targets/customer-account.profile.addresses.render-after.d.ts +3 -0
  110. package/build/ts/surfaces/customer-account/targets/customer-account.profile.announcement.render.d.ts +3 -0
  111. package/build/ts/surfaces/customer-account/targets/customer-account.profile.block.render.d.ts +3 -0
  112. package/build/ts/surfaces/customer-account/targets/customer-account.profile.company-details.render-after.d.ts +3 -0
  113. package/build/ts/surfaces/customer-account/targets/customer-account.profile.company-location-addresses.render-after.d.ts +3 -0
  114. package/build/ts/surfaces/customer-account/targets/customer-account.profile.company-location-payment.render-after.d.ts +3 -0
  115. package/build/ts/surfaces/customer-account/targets/customer-account.profile.company-location-staff.render-after.d.ts +3 -0
  116. package/build/ts/surfaces/customer-account/targets/customer-account.profile.payment.render-after.d.ts +3 -0
  117. package/build/ts/surfaces/point-of-sale/components/Badge.d.ts +10 -1
  118. package/build/ts/surfaces/point-of-sale/components/Banner.d.ts +12 -4
  119. package/build/ts/surfaces/point-of-sale/components/Box.d.ts +51 -14
  120. package/build/ts/surfaces/point-of-sale/components/Button.d.ts +12 -2
  121. package/build/ts/surfaces/point-of-sale/components/Choice.d.ts +3 -2
  122. package/build/ts/surfaces/point-of-sale/components/ChoiceList/ChoiceList.doc.d.ts.map +1 -1
  123. package/build/ts/surfaces/point-of-sale/components/ChoiceList.d.ts +13 -4
  124. package/build/ts/surfaces/point-of-sale/components/Clickable.d.ts +11 -4
  125. package/build/ts/surfaces/point-of-sale/components/DateField/DateField.doc.d.ts.map +1 -1
  126. package/build/ts/surfaces/point-of-sale/components/DateField.d.ts +20 -13
  127. package/build/ts/surfaces/point-of-sale/components/DatePicker/DatePicker.doc.d.ts.map +1 -1
  128. package/build/ts/surfaces/point-of-sale/components/DatePicker.d.ts +16 -4
  129. package/build/ts/surfaces/point-of-sale/components/DateSpinner/DateSpinner.doc.d.ts.map +1 -1
  130. package/build/ts/surfaces/point-of-sale/components/DateSpinner.d.ts +16 -4
  131. package/build/ts/surfaces/point-of-sale/components/Divider/Divider.doc.d.ts +4 -0
  132. package/build/ts/surfaces/point-of-sale/components/Divider/Divider.doc.d.ts.map +1 -0
  133. package/build/ts/surfaces/point-of-sale/components/Divider.d.ts +4 -3
  134. package/build/ts/surfaces/point-of-sale/components/EmailField/EmailField.doc.d.ts.map +1 -1
  135. package/build/ts/surfaces/point-of-sale/components/EmailField.d.ts +22 -5
  136. package/build/ts/surfaces/point-of-sale/components/Heading.d.ts +7 -4
  137. package/build/ts/surfaces/point-of-sale/components/Icon.d.ts +13 -3
  138. package/build/ts/surfaces/point-of-sale/components/Image.d.ts +12 -5
  139. package/build/ts/surfaces/point-of-sale/components/Modal.d.ts +28 -7
  140. package/build/ts/surfaces/point-of-sale/components/NumberField/NumberField.doc.d.ts.map +1 -1
  141. package/build/ts/surfaces/point-of-sale/components/NumberField.d.ts +32 -23
  142. package/build/ts/surfaces/point-of-sale/components/Page.d.ts +25 -11
  143. package/build/ts/surfaces/point-of-sale/components/PosBlock.d.ts +12 -13
  144. package/build/ts/surfaces/point-of-sale/components/QrCode.d.ts +12 -8
  145. package/build/ts/surfaces/point-of-sale/components/ScrollBox.d.ts +47 -15
  146. package/build/ts/surfaces/point-of-sale/components/SearchField/SearchField.doc.d.ts.map +1 -1
  147. package/build/ts/surfaces/point-of-sale/components/SearchField.d.ts +17 -5
  148. package/build/ts/surfaces/point-of-sale/components/Section.d.ts +15 -9
  149. package/build/ts/surfaces/point-of-sale/components/Stack.d.ts +67 -7
  150. package/build/ts/surfaces/point-of-sale/components/Text.d.ts +25 -4
  151. package/build/ts/surfaces/point-of-sale/components/TextArea/TextArea.doc.d.ts.map +1 -1
  152. package/build/ts/surfaces/point-of-sale/components/TextArea.d.ts +22 -5
  153. package/build/ts/surfaces/point-of-sale/components/TextField/TextField.doc.d.ts.map +1 -1
  154. package/build/ts/surfaces/point-of-sale/components/TextField.d.ts +22 -5
  155. package/build/ts/surfaces/point-of-sale/components/Tile.d.ts +12 -2
  156. package/build/ts/surfaces/point-of-sale/components/TimeField/TimeField.doc.d.ts.map +1 -1
  157. package/build/ts/surfaces/point-of-sale/components/TimeField.d.ts +18 -6
  158. package/build/ts/surfaces/point-of-sale/components/TimePicker/TimePicker.doc.d.ts.map +1 -1
  159. package/build/ts/surfaces/point-of-sale/components/TimePicker.d.ts +16 -4
  160. package/build/ts/surfaces/point-of-sale/components/components-shared.d.ts +102 -1
  161. package/build/tsconfig.tsbuildinfo +1 -1
  162. package/package.json +14 -3
  163. package/src/docs/shared/components/ConsentCheckbox.ts +12 -0
  164. package/src/docs/shared/components/ConsentPhoneField.ts +12 -0
  165. package/src/docs/shared/components/index.ts +2 -0
  166. package/src/surfaces/checkout/components/ConsentCheckbox/examples/basic-consent-checkbox.example.html +5 -0
  167. package/src/surfaces/checkout/components/ConsentCheckbox.d.ts +84 -0
  168. package/src/surfaces/checkout/components/ConsentPhoneField/examples/basic-consent-phone-field.example.html +5 -0
  169. package/src/surfaces/checkout/components/ConsentPhoneField.d.ts +129 -0
  170. package/src/surfaces/checkout/components/NumberField/examples/basic-number-field.example.html +8 -0
  171. package/src/surfaces/checkout/components/NumberField.d.ts +98 -0
  172. package/src/surfaces/checkout/components/PasswordField.d.ts +1 -1
  173. package/src/surfaces/checkout/components/PhoneField/examples/basic-phone-field.example.html +2 -1
  174. package/src/surfaces/checkout/components/ProductThumbnail/examples/basic-product-thumbnail.example.html +4 -1
  175. package/src/surfaces/checkout/components/Stack/examples/basic-stack.example.html +20 -4
  176. package/src/surfaces/checkout/components/TextArea/examples/basic-text-area.example.html +5 -1
  177. package/src/surfaces/checkout/components/TextField/examples/basic-text-field.example.html +4 -1
  178. package/src/surfaces/checkout/components/components-shared.d.ts +17 -0
  179. package/src/surfaces/checkout/components/components.d.ts +216 -144
  180. package/src/surfaces/checkout/preact/api.ts +1 -1
  181. package/src/surfaces/checkout/preact/tests/api.test.tsx +22 -13
  182. package/src/surfaces/checkout/preact/tests/app-metafields.test.ts +52 -56
  183. package/src/surfaces/checkout/preact/tests/attributes.test.ts +34 -24
  184. package/src/surfaces/checkout/preact/tests/billing-address.test.ts +17 -7
  185. package/src/surfaces/checkout/preact/tests/buyer-identity-businessCustomer.test.ts +16 -9
  186. package/src/surfaces/checkout/preact/tests/buyer-identity.test.tsx +57 -26
  187. package/src/surfaces/checkout/preact/tests/buyer-journey.test.ts +71 -74
  188. package/src/surfaces/checkout/preact/tests/capabilities.test.ts +32 -28
  189. package/src/surfaces/checkout/preact/tests/cart-line-target.test.ts +31 -24
  190. package/src/surfaces/checkout/preact/tests/checkout-settings.test.ts +17 -9
  191. package/src/surfaces/checkout/preact/tests/checkout-token.test.ts +16 -6
  192. package/src/surfaces/checkout/preact/tests/configuration.test.ts +16 -6
  193. package/src/surfaces/checkout/preact/tests/country.test.tsx +18 -8
  194. package/src/surfaces/checkout/preact/tests/currency.test.tsx +18 -8
  195. package/src/surfaces/checkout/preact/tests/customer-privacy.test.ts +17 -8
  196. package/src/surfaces/checkout/preact/tests/delivery-group-list-target.test.ts +24 -18
  197. package/src/surfaces/checkout/preact/tests/delivery-group-target.test.ts +25 -19
  198. package/src/surfaces/checkout/preact/tests/delivery-group.test.ts +22 -16
  199. package/src/surfaces/checkout/preact/tests/delivery-groups.test.ts +17 -11
  200. package/src/surfaces/checkout/preact/tests/delivery-selection-groups.test.ts +31 -24
  201. package/src/surfaces/checkout/preact/tests/discounts.test.tsx +21 -14
  202. package/src/surfaces/checkout/preact/tests/extension-language.test.tsx +17 -8
  203. package/src/surfaces/checkout/preact/tests/gift-cards.test.tsx +17 -8
  204. package/src/surfaces/checkout/preact/tests/localized-fields.test.ts +58 -59
  205. package/src/surfaces/checkout/preact/tests/market.test.tsx +17 -7
  206. package/src/surfaces/checkout/preact/tests/metafield.test.tsx +33 -36
  207. package/src/surfaces/checkout/preact/tests/metafields.test.tsx +36 -53
  208. package/src/surfaces/checkout/preact/tests/mount.tsx +60 -17
  209. package/src/surfaces/checkout/preact/tests/notes.test.tsx +16 -6
  210. package/src/surfaces/checkout/preact/tests/payment-method.test.ts +87 -60
  211. package/src/surfaces/checkout/preact/tests/payment-options.test.tsx +26 -24
  212. package/src/surfaces/checkout/preact/tests/pickup-location-option-target.test.tsx +55 -46
  213. package/src/surfaces/checkout/preact/tests/redeemable.test.ts +30 -23
  214. package/src/surfaces/checkout/preact/tests/session-token.test.tsx +12 -6
  215. package/src/surfaces/checkout/preact/tests/shipping-address.test.ts +17 -7
  216. package/src/surfaces/checkout/preact/tests/shipping-option-target.test.ts +54 -50
  217. package/src/surfaces/checkout/preact/tests/shopping-address.test.tsx +18 -10
  218. package/src/surfaces/checkout/preact/tests/timezone.test.tsx +17 -7
  219. package/src/surfaces/checkout/preact/tests/translate.test.tsx +18 -13
  220. package/src/surfaces/checkout/preact/tests/tsconfig.json +1 -1
  221. package/src/surfaces/checkout/shared.ts +2 -0
  222. package/src/surfaces/point-of-sale/components/Badge.d.ts +10 -1
  223. package/src/surfaces/point-of-sale/components/Banner/examples/default.html +8 -8
  224. package/src/surfaces/point-of-sale/components/Banner.d.ts +12 -4
  225. package/src/surfaces/point-of-sale/components/Box/examples/default.html +2 -2
  226. package/src/surfaces/point-of-sale/components/Box.d.ts +51 -14
  227. package/src/surfaces/point-of-sale/components/Button/examples/default.html +2 -4
  228. package/src/surfaces/point-of-sale/components/Button.d.ts +12 -2
  229. package/src/surfaces/point-of-sale/components/Choice.d.ts +3 -2
  230. package/src/surfaces/point-of-sale/components/ChoiceList/examples/default.html +5 -4
  231. package/src/surfaces/point-of-sale/components/ChoiceList/examples/event-handling.jsx +8 -0
  232. package/src/surfaces/point-of-sale/components/ChoiceList/examples/multiple-selection.jsx +9 -0
  233. package/src/surfaces/point-of-sale/components/ChoiceList.d.ts +13 -4
  234. package/src/surfaces/point-of-sale/components/Clickable/examples/default.html +5 -2
  235. package/src/surfaces/point-of-sale/components/Clickable.d.ts +11 -4
  236. package/src/surfaces/point-of-sale/components/DateField/examples/default.html +2 -10
  237. package/src/surfaces/point-of-sale/components/DateField/examples/event-handling.jsx +8 -0
  238. package/src/surfaces/point-of-sale/components/DateField.d.ts +20 -13
  239. package/src/surfaces/point-of-sale/components/DatePicker/examples/command-system.jsx +10 -0
  240. package/src/surfaces/point-of-sale/components/DatePicker/examples/default.html +4 -5
  241. package/src/surfaces/point-of-sale/components/DatePicker/examples/event-handling.jsx +7 -0
  242. package/src/surfaces/point-of-sale/components/DatePicker.d.ts +16 -4
  243. package/src/surfaces/point-of-sale/components/DateSpinner/examples/command-system.jsx +10 -0
  244. package/src/surfaces/point-of-sale/components/DateSpinner/examples/default.html +1 -2
  245. package/src/surfaces/point-of-sale/components/DateSpinner/examples/event-handling.jsx +7 -0
  246. package/src/surfaces/point-of-sale/components/DateSpinner.d.ts +16 -4
  247. package/src/surfaces/point-of-sale/components/Divider/examples/default.html +1 -0
  248. package/src/surfaces/point-of-sale/components/Divider.d.ts +4 -3
  249. package/src/surfaces/point-of-sale/components/EmailField/examples/accessory-slot.jsx +9 -0
  250. package/src/surfaces/point-of-sale/components/EmailField/examples/default.html +3 -10
  251. package/src/surfaces/point-of-sale/components/EmailField/examples/event-handling.jsx +8 -0
  252. package/src/surfaces/point-of-sale/components/EmailField.d.ts +22 -5
  253. package/src/surfaces/point-of-sale/components/Heading/examples/default.html +4 -5
  254. package/src/surfaces/point-of-sale/components/Heading.d.ts +7 -4
  255. package/src/surfaces/point-of-sale/components/Icon/examples/default.html +4 -1
  256. package/src/surfaces/point-of-sale/components/Icon.d.ts +13 -3
  257. package/src/surfaces/point-of-sale/components/Image/examples/default.html +1 -1
  258. package/src/surfaces/point-of-sale/components/Image.d.ts +12 -5
  259. package/src/surfaces/point-of-sale/components/Modal/examples/default.html +6 -8
  260. package/src/surfaces/point-of-sale/components/Modal.d.ts +28 -7
  261. package/src/surfaces/point-of-sale/components/NumberField/examples/controls-constraints.jsx +9 -0
  262. package/src/surfaces/point-of-sale/components/NumberField/examples/default.html +5 -2
  263. package/src/surfaces/point-of-sale/components/NumberField/examples/input-mode.jsx +15 -0
  264. package/src/surfaces/point-of-sale/components/NumberField.d.ts +32 -23
  265. package/src/surfaces/point-of-sale/components/Page/examples/default.html +3 -4
  266. package/src/surfaces/point-of-sale/components/Page.d.ts +25 -11
  267. package/src/surfaces/point-of-sale/components/PosBlock/examples/default.html +3 -9
  268. package/src/surfaces/point-of-sale/components/PosBlock.d.ts +12 -13
  269. package/src/surfaces/point-of-sale/components/QrCode.d.ts +12 -8
  270. package/src/surfaces/point-of-sale/components/ScrollBox/examples/default.html +5 -4
  271. package/src/surfaces/point-of-sale/components/ScrollBox.d.ts +47 -15
  272. package/src/surfaces/point-of-sale/components/SearchField/examples/default.html +1 -1
  273. package/src/surfaces/point-of-sale/components/SearchField/examples/event-handling.jsx +8 -0
  274. package/src/surfaces/point-of-sale/components/SearchField.d.ts +17 -5
  275. package/src/surfaces/point-of-sale/components/Section/examples/default.html +6 -8
  276. package/src/surfaces/point-of-sale/components/Section.d.ts +15 -9
  277. package/src/surfaces/point-of-sale/components/Stack/examples/default.html +3 -3
  278. package/src/surfaces/point-of-sale/components/Stack.d.ts +67 -7
  279. package/src/surfaces/point-of-sale/components/Text/examples/default.html +3 -6
  280. package/src/surfaces/point-of-sale/components/Text.d.ts +25 -4
  281. package/src/surfaces/point-of-sale/components/TextArea/examples/accessory-slot.jsx +9 -0
  282. package/src/surfaces/point-of-sale/components/TextArea/examples/default.html +4 -1
  283. package/src/surfaces/point-of-sale/components/TextArea/examples/event-handling.jsx +8 -0
  284. package/src/surfaces/point-of-sale/components/TextArea/examples/rows-configuration.jsx +7 -0
  285. package/src/surfaces/point-of-sale/components/TextArea.d.ts +22 -5
  286. package/src/surfaces/point-of-sale/components/TextField/examples/accessory-slot.jsx +5 -0
  287. package/src/surfaces/point-of-sale/components/TextField/examples/common-props.jsx +11 -0
  288. package/src/surfaces/point-of-sale/components/TextField/examples/default.html +5 -3
  289. package/src/surfaces/point-of-sale/components/TextField/examples/event-handling.jsx +17 -0
  290. package/src/surfaces/point-of-sale/components/TextField.d.ts +22 -5
  291. package/src/surfaces/point-of-sale/components/Tile/examples/default.html +2 -5
  292. package/src/surfaces/point-of-sale/components/Tile.d.ts +12 -2
  293. package/src/surfaces/point-of-sale/components/TimeField/examples/default.html +1 -9
  294. package/src/surfaces/point-of-sale/components/TimeField/examples/event-handling.jsx +8 -0
  295. package/src/surfaces/point-of-sale/components/TimeField.d.ts +18 -6
  296. package/src/surfaces/point-of-sale/components/TimePicker/examples/command-system.jsx +10 -0
  297. package/src/surfaces/point-of-sale/components/TimePicker/examples/default.html +4 -1
  298. package/src/surfaces/point-of-sale/components/TimePicker/examples/event-handling.jsx +7 -0
  299. package/src/surfaces/point-of-sale/components/TimePicker.d.ts +16 -4
  300. package/src/surfaces/point-of-sale/components/components-shared.d.ts +102 -1
  301. package/src/surfaces/point-of-sale/components.d.ts +957 -472
  302. package/build/ts/surfaces/checkout/errors.d.ts +0 -10
  303. package/build/ts/surfaces/checkout/errors.d.ts.map +0 -1
  304. package/src/surfaces/checkout/errors.ts +0 -13
@@ -1254,7 +1254,6 @@ export interface BaseBoxProps
1254
1254
  export interface BaseBoxPropsWithRole
1255
1255
  extends BaseBoxProps,
1256
1256
  AccessibilityRoleProps {}
1257
- export interface BoxProps extends BaseBoxPropsWithRole, GlobalProps {}
1258
1257
  export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
1259
1258
  /**
1260
1259
  * The behavior of the Button.
@@ -2283,6 +2282,45 @@ export interface BaseTypographyProps {
2283
2282
  */
2284
2283
  dir?: 'ltr' | 'rtl' | 'auto' | '';
2285
2284
  }
2285
+ export interface BlockTypographyProps {
2286
+ /**
2287
+ * Truncates the text content to the specified number of lines.
2288
+ *
2289
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-line-clamp
2290
+ *
2291
+ * @default Infinity - no truncation is applied
2292
+ */
2293
+ lineClamp?: number;
2294
+ }
2295
+ export interface HeadingProps
2296
+ extends GlobalProps,
2297
+ AccessibilityVisibilityProps,
2298
+ BlockTypographyProps {
2299
+ /**
2300
+ * The content of the Heading.
2301
+ */
2302
+ children?: ComponentChildren;
2303
+ /**
2304
+ * Sets the semantic meaning of the component’s content. When set,
2305
+ * the role will be used by assistive technologies to help users
2306
+ * navigate the page.
2307
+ *
2308
+ * - `heading`: defines the element as a heading to a page or section.
2309
+ * - `presentation`: the heading level will be stripped,
2310
+ * and will prevent the element’s implicit ARIA semantics from
2311
+ * being exposed to the accessibility tree.
2312
+ * - `none`: a synonym for the `presentation` role.
2313
+ *
2314
+ * @default 'heading'
2315
+ *
2316
+ * @implementation The `heading` role doesn't need to be applied if
2317
+ * the host applies it for you; for example, an HTML host rendering
2318
+ * an `<h2>` element should not apply the `heading` role.
2319
+ */
2320
+ accessibilityRole?:
2321
+ | 'heading'
2322
+ | ExtractStrict<AccessibilityRole, 'presentation' | 'none'>;
2323
+ }
2286
2324
  export interface IconProps
2287
2325
  extends GlobalProps,
2288
2326
  Pick<InteractionProps, 'interestFor'> {
@@ -2523,6 +2561,69 @@ export interface PageProps extends GlobalProps, ActionSlots {
2523
2561
  */
2524
2562
  inlineSize?: SizeKeyword;
2525
2563
  }
2564
+ export interface POSBlockProps
2565
+ extends GlobalProps,
2566
+ Pick<ActionSlots, 'secondaryActions'> {
2567
+ /**
2568
+ * The heading to display within the POSBlock.
2569
+ *
2570
+ * If not provided, the description of the extension will be used when a heading is appropriate.
2571
+ */
2572
+ heading?: string;
2573
+ /**
2574
+ * The content to display within the POSBlock.
2575
+ */
2576
+ children?: ComponentChildren;
2577
+ /**
2578
+ * The secondary actions to perform, provided as button or link type elements.
2579
+ */
2580
+ secondaryActions?: ComponentChildren;
2581
+ }
2582
+ export interface QRCodeProps extends GlobalProps {
2583
+ /**
2584
+ * Set the border of the QR code.
2585
+ *
2586
+ * `base`: applies border that is appropriate for the element.
2587
+ * `none`: removes the border from the element.
2588
+ *
2589
+ * @default 'base'
2590
+ */
2591
+ border?: 'base' | 'none';
2592
+ /**
2593
+ * The content to be encoded in the QR code, which can be any string such as a URL, email address, plain text, etc.
2594
+ * Specific string formatting can trigger actions on the user's device when scanned, like opening geolocation
2595
+ * coordinates on a map, opening a preferred app or app store entry, preparing an email, text message, and more.
2596
+ */
2597
+ content?: string;
2598
+ /**
2599
+ * The displayed size of the QR code.
2600
+ *
2601
+ * `fill`: the QR code will takes up 100% of the available inline-size and maintain a 1:1 aspect ratio.
2602
+ * `base`: the QR code will be displayed at its default size.
2603
+ *
2604
+ * @default 'base'
2605
+ */
2606
+ size?: 'base' | 'fill';
2607
+ /**
2608
+ * A label that describes the purpose or contents of the QR code. When set,
2609
+ * it will be announced to users using assistive technologies and will
2610
+ * provide more context about what the QR code may do when scanned.
2611
+ *
2612
+ * @default 'QR code' (translated to the user's locale)
2613
+ */
2614
+ accessibilityLabel?: string;
2615
+ /**
2616
+ * Invoked when the conversion of `content` to a QR code fails.
2617
+ * If an error occurs, the QR code and its child elements will not be displayed.
2618
+ */
2619
+ onError?: (event: Event) => void;
2620
+ /**
2621
+ * URL of an image to be displayed in the center of the QR code.
2622
+ * This is useful for branding or to indicate to the user what scanning the QR code will do.
2623
+ * By default, no image is displayed.
2624
+ */
2625
+ logo?: string;
2626
+ }
2526
2627
  export interface ScrollEventProps {
2527
2628
  /**
2528
2629
  * Callback when the scroll position reaches any edge.
@@ -3126,6 +3227,7 @@ interface BaseElementPropsWithChildren<TClass = HTMLElement>
3126
3227
  extends BaseElementProps<TClass> {
3127
3228
  children?: ComponentChildren;
3128
3229
  }
3230
+ type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T>;
3129
3231
  interface CallbackEvent<T extends keyof HTMLElementTagNameMap> {
3130
3232
  currentTarget: HTMLElementTagNameMap[T];
3131
3233
  bubbles?: boolean;
@@ -3138,7 +3240,10 @@ interface CallbackEvent<T extends keyof HTMLElementTagNameMap> {
3138
3240
 
3139
3241
  declare const tagName$t = 's-button';
3140
3242
  interface ButtonJSXProps
3141
- extends Pick<ButtonProps, 'disabled' | 'command' | 'commandFor' | 'loading'> {
3243
+ extends Pick<
3244
+ ButtonProps,
3245
+ 'id' | 'disabled' | 'command' | 'commandFor' | 'loading'
3246
+ > {
3142
3247
  /**
3143
3248
  * Sets the action the `commandFor` should take when this clickable is activated.
3144
3249
  *
@@ -3172,7 +3277,13 @@ interface ButtonJSXProps
3172
3277
  * @default 'auto' - the variant is automatically determined by the Button's context
3173
3278
  */
3174
3279
  variant?: Extract<ButtonProps['variant'], 'primary' | 'secondary'>;
3280
+ /**
3281
+ * Called when the button is activated.
3282
+ */
3175
3283
  onClick?: (event: CallbackEvent<typeof tagName$t>) => void;
3284
+ /**
3285
+ * The content of the Button.
3286
+ */
3176
3287
  children?: ComponentChildren;
3177
3288
  }
3178
3289
  declare global {
@@ -3183,20 +3294,39 @@ declare global {
3183
3294
  declare module 'preact' {
3184
3295
  namespace createElement.JSX {
3185
3296
  interface IntrinsicElements {
3186
- [tagName$t]: ButtonJSXProps &
3187
- BaseElementPropsWithChildren<ButtonJSXProps>;
3297
+ [tagName$t]: IntrinsicElementProps<ButtonJSXProps>;
3188
3298
  }
3189
3299
  }
3190
3300
  }
3191
3301
 
3192
3302
  declare const tagName$s = 's-text';
3193
- interface TextJSXProps extends Pick<TextProps, 'tone' | 'type'> {
3194
- color?: 'subdued' | 'base' | 'strong';
3195
- type?: Extract<TextProps['type'], 'strong' | 'small' | 'generic'>;
3303
+ interface TextJSXProps extends Pick<TextProps, 'id'> {
3304
+ /**
3305
+ * Modify the color to be more or less intense.
3306
+ *
3307
+ * @default 'base'
3308
+ */
3309
+ color?: Extract<TextProps['color'], 'base' | 'strong' | 'subdued'>;
3310
+ /**
3311
+ * Provide semantic meaning and default styling to the text.
3312
+ *
3313
+ * Other presentation properties on Text override the default styling.
3314
+ *
3315
+ * @default 'generic'
3316
+ */
3317
+ type?: Extract<TextProps['type'], 'generic' | 'strong' | 'small'>;
3318
+ /**
3319
+ * Sets the tone of the component, based on the intention of the information being conveyed.
3320
+ *
3321
+ * @default 'auto'
3322
+ */
3196
3323
  tone?: Extract<
3197
3324
  TextProps['tone'],
3198
3325
  'auto' | 'neutral' | 'info' | 'success' | 'warning' | 'critical' | 'caution'
3199
3326
  >;
3327
+ /**
3328
+ * The Text content. Supports nested text elements.
3329
+ */
3200
3330
  children?: ComponentChildren;
3201
3331
  }
3202
3332
  declare global {
@@ -3207,24 +3337,50 @@ declare global {
3207
3337
  declare module 'preact' {
3208
3338
  namespace createElement.JSX {
3209
3339
  interface IntrinsicElements {
3210
- [tagName$s]: TextJSXProps & BaseElementPropsWithChildren<TextJSXProps>;
3340
+ [tagName$s]: IntrinsicElementProps<TextJSXProps>;
3211
3341
  }
3212
3342
  }
3213
3343
  }
3214
3344
 
3215
3345
  type PaddingKeyword$2 = SizeKeyword | 'none';
3216
3346
  declare const tagName$r = 's-scroll-box';
3217
- interface ScrollBoxJSXProps
3218
- extends Pick<
3219
- ScrollBoxProps,
3220
- | 'id'
3221
- | 'blockSize'
3222
- | 'minBlockSize'
3223
- | 'maxBlockSize'
3224
- | 'inlineSize'
3225
- | 'minInlineSize'
3226
- | 'maxInlineSize'
3227
- > {
3347
+ interface ScrollBoxJSXProps extends Pick<ScrollBoxProps, 'id'> {
3348
+ /**
3349
+ * Adjust the block size.
3350
+ *
3351
+ * @default 'auto'
3352
+ */
3353
+ blockSize?: SizeUnitsOrAuto;
3354
+ /**
3355
+ * Adjust the inline size.
3356
+ *
3357
+ * @default 'auto'
3358
+ */
3359
+ inlineSize?: SizeUnitsOrAuto;
3360
+ /**
3361
+ * Adjust the maximum block size.
3362
+ *
3363
+ * @default 'none'
3364
+ */
3365
+ maxBlockSize?: SizeUnitsOrNone;
3366
+ /**
3367
+ * Adjust the maximum inline size.
3368
+ *
3369
+ * @default 'none'
3370
+ */
3371
+ maxInlineSize?: SizeUnitsOrNone;
3372
+ /**
3373
+ * Adjust the minimum block size.
3374
+ *
3375
+ * @default '0'
3376
+ */
3377
+ minBlockSize?: SizeUnits;
3378
+ /**
3379
+ * Adjust the minimum inline size.
3380
+ *
3381
+ * @default '0'
3382
+ */
3383
+ minInlineSize?: SizeUnits;
3228
3384
  /**
3229
3385
  * Adjust the padding of all edges.
3230
3386
  *
@@ -3255,7 +3411,7 @@ interface ScrollBoxJSXProps
3255
3411
  *
3256
3412
  * @default '' - meaning no override
3257
3413
  */
3258
- paddingBlock?: MaybeTwoValuesShorthandProperty<PaddingKeyword$2 | ''>;
3414
+ paddingBlock?: MaybeTwoValuesShorthandProperty<PaddingKeyword$2> | '';
3259
3415
  /**
3260
3416
  * Adjust the block-start padding.
3261
3417
  *
@@ -3281,7 +3437,7 @@ interface ScrollBoxJSXProps
3281
3437
  *
3282
3438
  * @default '' - meaning no override
3283
3439
  */
3284
- paddingInline?: MaybeTwoValuesShorthandProperty<PaddingKeyword$2 | ''>;
3440
+ paddingInline?: MaybeTwoValuesShorthandProperty<PaddingKeyword$2> | '';
3285
3441
  /**
3286
3442
  * Adjust the inline-start padding.
3287
3443
  *
@@ -3298,6 +3454,9 @@ interface ScrollBoxJSXProps
3298
3454
  * @default '' - meaning no override
3299
3455
  */
3300
3456
  paddingInlineEnd?: PaddingKeyword$2 | '';
3457
+ /**
3458
+ * The content of the ScrollBox.
3459
+ */
3301
3460
  children?: ComponentChildren;
3302
3461
  }
3303
3462
  declare global {
@@ -3308,8 +3467,7 @@ declare global {
3308
3467
  declare module 'preact' {
3309
3468
  namespace createElement.JSX {
3310
3469
  interface IntrinsicElements {
3311
- [tagName$r]: ScrollBoxJSXProps &
3312
- BaseElementPropsWithChildren<ScrollBoxJSXProps>;
3470
+ [tagName$r]: IntrinsicElementProps<ScrollBoxJSXProps>;
3313
3471
  }
3314
3472
  }
3315
3473
  }
@@ -3318,8 +3476,17 @@ declare const tagName$q = 's-tile';
3318
3476
  interface TileJSXProps
3319
3477
  extends Pick<
3320
3478
  TileProps,
3321
- 'disabled' | 'heading' | 'id' | 'itemCount' | 'tone' | 'subheading'
3479
+ 'heading' | 'id' | 'itemCount' | 'tone' | 'subheading'
3322
3480
  > {
3481
+ /**
3482
+ * Disables the Tile meaning it cannot be clicked or receive focus.
3483
+ *
3484
+ * @default false
3485
+ */
3486
+ disabled?: TileProps['disabled'];
3487
+ /**
3488
+ * Callback when the Tile is activated.
3489
+ */
3323
3490
  onClick?: (event: CallbackEvent<typeof tagName$q>) => void;
3324
3491
  }
3325
3492
  declare global {
@@ -3330,7 +3497,7 @@ declare global {
3330
3497
  declare module 'preact' {
3331
3498
  namespace createElement.JSX {
3332
3499
  interface IntrinsicElements {
3333
- [tagName$q]: TileJSXProps & BaseElementPropsWithChildren<TileJSXProps>;
3500
+ [tagName$q]: IntrinsicElementProps<TileJSXProps>;
3334
3501
  }
3335
3502
  }
3336
3503
  }
@@ -3339,47 +3506,85 @@ declare const tagName$p = 's-banner';
3339
3506
  interface BannerJSXProps extends Pick<BannerProps, 'heading' | 'id'> {
3340
3507
  /**
3341
3508
  * Determines whether the banner is hidden.
3509
+ *
3510
+ * @default false
3342
3511
  */
3343
3512
  hidden?: BannerProps['hidden'];
3344
3513
  /**
3345
3514
  * Sets the tone of the Banner, based on the intention of the information being conveyed.
3515
+ *
3516
+ * @default 'auto'
3346
3517
  */
3347
3518
  tone?: Extract<
3348
3519
  BannerProps['tone'],
3349
- 'success' | 'info' | 'warning' | 'critical'
3520
+ 'auto' | 'success' | 'info' | 'warning' | 'critical'
3350
3521
  >;
3351
3522
  /**
3352
3523
  * The action taken when the Banner is pressed.
3353
3524
  */
3354
3525
  primaryAction?: ComponentChild;
3526
+ /**
3527
+ * The content of the Banner.
3528
+ */
3355
3529
  children?: ComponentChildren;
3356
3530
  }
3531
+ type ElementProps$9 = Omit<BannerJSXProps, 'primaryAction'>;
3357
3532
  declare global {
3358
3533
  interface HTMLElementTagNameMap {
3359
- [tagName$p]: BannerJSXProps;
3534
+ [tagName$p]: ElementProps$9;
3360
3535
  }
3361
3536
  }
3362
3537
  declare module 'preact' {
3363
3538
  namespace createElement.JSX {
3364
3539
  interface IntrinsicElements {
3365
- [tagName$p]: Omit<BannerJSXProps, 'primaryAction'> &
3366
- BaseElementPropsWithChildren<Omit<BannerJSXProps, 'primaryAction'>>;
3540
+ [tagName$p]: IntrinsicElementProps<ElementProps$9>;
3367
3541
  }
3368
3542
  }
3369
3543
  }
3370
3544
 
3371
3545
  declare const tagName$o = 's-box';
3372
3546
  type PaddingKeyword$1 = SizeKeyword | 'none';
3373
- interface BoxJSXProps
3374
- extends Pick<
3375
- BoxProps,
3376
- | 'blockSize'
3377
- | 'minBlockSize'
3378
- | 'maxBlockSize'
3379
- | 'inlineSize'
3380
- | 'minInlineSize'
3381
- | 'maxInlineSize'
3382
- > {
3547
+ interface BoxJSXProps {
3548
+ /**
3549
+ * A unique identifier for the element.
3550
+ */
3551
+ id?: string;
3552
+ /**
3553
+ * Adjust the block size.
3554
+ *
3555
+ * @default 'auto'
3556
+ */
3557
+ blockSize?: SizeUnitsOrAuto;
3558
+ /**
3559
+ * Adjust the inline size.
3560
+ *
3561
+ * @default 'auto'
3562
+ */
3563
+ inlineSize?: SizeUnitsOrAuto;
3564
+ /**
3565
+ * Adjust the maximum block size.
3566
+ *
3567
+ * @default 'none'
3568
+ */
3569
+ maxBlockSize?: SizeUnitsOrNone;
3570
+ /**
3571
+ * Adjust the maximum inline size.
3572
+ *
3573
+ * @default 'none'
3574
+ */
3575
+ maxInlineSize?: SizeUnitsOrNone;
3576
+ /**
3577
+ * Adjust the minimum block size.
3578
+ *
3579
+ * @default '0'
3580
+ */
3581
+ minBlockSize?: SizeUnits;
3582
+ /**
3583
+ * Adjust the minimum inline size.
3584
+ *
3585
+ * @default '0'
3586
+ */
3587
+ minInlineSize?: SizeUnits;
3383
3588
  /**
3384
3589
  * Adjust the padding of all edges.
3385
3590
  *
@@ -3410,7 +3615,7 @@ interface BoxJSXProps
3410
3615
  *
3411
3616
  * @default '' - meaning no override
3412
3617
  */
3413
- paddingBlock?: MaybeTwoValuesShorthandProperty<PaddingKeyword$1 | ''>;
3618
+ paddingBlock?: MaybeTwoValuesShorthandProperty<PaddingKeyword$1> | '';
3414
3619
  /**
3415
3620
  * Adjust the block-start padding.
3416
3621
  *
@@ -3436,7 +3641,7 @@ interface BoxJSXProps
3436
3641
  *
3437
3642
  * @default '' - meaning no override
3438
3643
  */
3439
- paddingInline?: MaybeTwoValuesShorthandProperty<PaddingKeyword$1 | ''>;
3644
+ paddingInline?: MaybeTwoValuesShorthandProperty<PaddingKeyword$1> | '';
3440
3645
  /**
3441
3646
  * Adjust the inline-start padding.
3442
3647
  *
@@ -3453,6 +3658,9 @@ interface BoxJSXProps
3453
3658
  * @default '' - meaning no override
3454
3659
  */
3455
3660
  paddingInlineEnd?: PaddingKeyword$1 | '';
3661
+ /**
3662
+ * The content of the Box.
3663
+ */
3456
3664
  children?: ComponentChildren;
3457
3665
  }
3458
3666
  declare global {
@@ -3463,7 +3671,7 @@ declare global {
3463
3671
  declare module 'preact' {
3464
3672
  namespace createElement.JSX {
3465
3673
  interface IntrinsicElements {
3466
- [tagName$o]: BoxJSXProps & BaseElementPropsWithChildren<BoxJSXProps>;
3674
+ [tagName$o]: IntrinsicElementProps<BoxJSXProps>;
3467
3675
  }
3468
3676
  }
3469
3677
  }
@@ -3597,9 +3805,11 @@ type SupportedIconNames = Extract<
3597
3805
  | 'x'
3598
3806
  | 'x-circle'
3599
3807
  >;
3600
- interface IconJSXProps extends Pick<IconProps, 'tone' | 'color' | 'size'> {
3808
+ interface IconJSXProps
3809
+ extends Pick<IconProps, 'id' | 'tone' | 'color' | 'size'> {
3601
3810
  /**
3602
- * The type of icon to display. Maps to PDS icon names.
3811
+ * The type of icon to display.
3812
+ *
3603
3813
  * @default ''
3604
3814
  */
3605
3815
  type?: SupportedIconNames;
@@ -3612,15 +3822,16 @@ declare global {
3612
3822
  declare module 'preact' {
3613
3823
  namespace createElement.JSX {
3614
3824
  interface IntrinsicElements {
3615
- [tagName$n]: IconJSXProps & BaseElementProps<IconJSXProps>;
3825
+ [tagName$n]: IntrinsicElementProps<IconJSXProps>;
3616
3826
  }
3617
3827
  }
3618
3828
  }
3619
3829
 
3620
3830
  declare const tagName$m = 's-stack';
3621
3831
  type PaddingKeyword = SizeKeyword | 'none';
3622
- type PickedProps$2 = Pick<
3832
+ type PickedProps = Pick<
3623
3833
  StackProps,
3834
+ | 'id'
3624
3835
  | 'alignItems'
3625
3836
  | 'alignContent'
3626
3837
  | 'gap'
@@ -3635,7 +3846,7 @@ type PickedProps$2 = Pick<
3635
3846
  | 'justifyContent'
3636
3847
  | 'rowGap'
3637
3848
  >;
3638
- interface StackJSXProps extends PickedProps$2 {
3849
+ interface StackJSXProps extends PickedProps {
3639
3850
  /**
3640
3851
  * Adjust the padding of all edges.
3641
3852
  *
@@ -3709,7 +3920,6 @@ interface StackJSXProps extends PickedProps$2 {
3709
3920
  * @default '' - meaning no override
3710
3921
  */
3711
3922
  paddingInlineEnd?: PaddingKeyword | '';
3712
- children?: ComponentChildren;
3713
3923
  /**
3714
3924
  * Adjust the block size.
3715
3925
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
@@ -3718,7 +3928,7 @@ interface StackJSXProps extends PickedProps$2 {
3718
3928
  *
3719
3929
  * @default 'auto'
3720
3930
  */
3721
- blockSize?: PickedProps$2['blockSize'];
3931
+ blockSize?: SizeUnitsOrAuto;
3722
3932
  /**
3723
3933
  * Adjust the maximum block size.
3724
3934
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
@@ -3727,7 +3937,7 @@ interface StackJSXProps extends PickedProps$2 {
3727
3937
  *
3728
3938
  * @default 'none'
3729
3939
  */
3730
- maxBlockSize?: PickedProps$2['maxBlockSize'];
3940
+ maxBlockSize?: SizeUnitsOrNone;
3731
3941
  /**
3732
3942
  * Adjust the maximum inline size.
3733
3943
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
@@ -3736,7 +3946,7 @@ interface StackJSXProps extends PickedProps$2 {
3736
3946
  *
3737
3947
  * @default 'none'
3738
3948
  */
3739
- maxInlineSize?: PickedProps$2['maxInlineSize'];
3949
+ maxInlineSize?: SizeUnitsOrNone;
3740
3950
  /**
3741
3951
  * Adjust the minimum block size.
3742
3952
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
@@ -3745,7 +3955,7 @@ interface StackJSXProps extends PickedProps$2 {
3745
3955
  *
3746
3956
  * @default '0'
3747
3957
  */
3748
- minBlockSize?: PickedProps$2['minBlockSize'];
3958
+ minBlockSize?: SizeUnits;
3749
3959
  /**
3750
3960
  * Adjust the minimum inline size.
3751
3961
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
@@ -3754,7 +3964,59 @@ interface StackJSXProps extends PickedProps$2 {
3754
3964
  *
3755
3965
  * @default '0'
3756
3966
  */
3757
- minInlineSize?: PickedProps$2['minInlineSize'];
3967
+ minInlineSize?: SizeUnits;
3968
+ /**
3969
+ * Aligns the Stack's children along the cross axis.
3970
+ */
3971
+ alignItems?: AlignItemsKeyword;
3972
+ /**
3973
+ * Aligns the Stack along the cross axis.
3974
+ */
3975
+ alignContent?: AlignContentKeyword;
3976
+ /**
3977
+ * Adjust spacing between elements.
3978
+ * A single value applies to both axes. A pair of values (eg large-100 large-500) can be used to set the inline and block axes respectively.
3979
+ *
3980
+ * @default 'none'
3981
+ */
3982
+ gap?: MaybeTwoValuesShorthandProperty<SpacingKeyword>;
3983
+ /**
3984
+ * Adjust spacing between elements in the inline axis. This overrides the column value of gap.
3985
+ *
3986
+ * @default '' - meaning no override
3987
+ */
3988
+ columnGap?: SpacingKeyword | '';
3989
+ /**
3990
+ * Sets how the children are placed within the Stack. This uses logical properties.
3991
+ *
3992
+ * @default 'block'
3993
+ * @implementation - the content will wrap if the direction is 'inline', and not wrap if the direction is 'block'
3994
+ */
3995
+ direction?: 'block' | 'inline';
3996
+ /**
3997
+ * Adjust the inline size.
3998
+ * @see — https://developer.mozilla.org/en-US/docs/Web/CSS/inline-size
3999
+ *
4000
+ * @default 'auto'
4001
+ */
4002
+ inlineSize?: SizeUnitsOrAuto;
4003
+ /**
4004
+ * Aligns the Stack along the main axis.
4005
+ * @see — https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
4006
+ *
4007
+ * @default 'normal'
4008
+ */
4009
+ justifyContent?: JustifyContentKeyword;
4010
+ /**
4011
+ * Adjust spacing between elements in the block axis. This overrides the row value of gap.
4012
+ *
4013
+ * @default '' - meaning no override
4014
+ */
4015
+ rowGap?: SpacingKeyword | '';
4016
+ /**
4017
+ * The content of the Stack.
4018
+ */
4019
+ children?: ComponentChildren;
3758
4020
  }
3759
4021
  declare global {
3760
4022
  interface HTMLElementTagNameMap {
@@ -3764,17 +4026,25 @@ declare global {
3764
4026
  declare module 'preact' {
3765
4027
  namespace createElement.JSX {
3766
4028
  interface IntrinsicElements {
3767
- [tagName$m]: StackJSXProps & BaseElementPropsWithChildren<StackJSXProps>;
4029
+ [tagName$m]: IntrinsicElementProps<StackJSXProps>;
3768
4030
  }
3769
4031
  }
3770
4032
  }
3771
4033
 
3772
4034
  declare const tagName$l = 's-badge';
3773
4035
  interface BadgeJSXProps extends Pick<BadgeProps, 'id'> {
4036
+ /**
4037
+ * Sets the tone of the Badge, based on the intention of the information being conveyed.
4038
+ *
4039
+ * @default 'auto'
4040
+ */
3774
4041
  tone?: Extract<
3775
4042
  BadgeProps['tone'],
3776
4043
  'auto' | 'neutral' | 'info' | 'success' | 'warning' | 'critical' | 'caution'
3777
4044
  >;
4045
+ /**
4046
+ * The content of the Badge.
4047
+ */
3778
4048
  children?: ComponentChildren;
3779
4049
  }
3780
4050
  declare global {
@@ -3785,16 +4055,25 @@ declare global {
3785
4055
  declare module 'preact' {
3786
4056
  namespace createElement.JSX {
3787
4057
  interface IntrinsicElements {
3788
- [tagName$l]: BadgeJSXProps & BaseElementPropsWithChildren<BadgeJSXProps>;
4058
+ [tagName$l]: IntrinsicElementProps<BadgeJSXProps>;
3789
4059
  }
3790
4060
  }
3791
4061
  }
3792
4062
 
3793
4063
  declare const tagName$k = 's-choice-list';
3794
4064
  interface ChoiceListJSXProps
3795
- extends Pick<ChoiceListProps, 'values' | 'multiple'> {
3796
- onChange?: ((event: CallbackEvent<typeof tagName$k>) => void) | null;
4065
+ extends Pick<ChoiceListProps, 'id' | 'values' | 'multiple'> {
4066
+ /**
4067
+ * Callback when the user changes a choice. Fires simultaneously with onChange.
4068
+ */
3797
4069
  onInput?: ((event: CallbackEvent<typeof tagName$k>) => void) | null;
4070
+ /**
4071
+ * Callback when the user changes a choice. Fires simultaneously with onInput.
4072
+ */
4073
+ onChange?: ((event: CallbackEvent<typeof tagName$k>) => void) | null;
4074
+ /**
4075
+ * The content of the ChoiceList. Should be one or more Choice elements.
4076
+ */
3798
4077
  children?: ComponentChildren;
3799
4078
  }
3800
4079
  declare global {
@@ -3805,15 +4084,14 @@ declare global {
3805
4084
  declare module 'preact' {
3806
4085
  namespace createElement.JSX {
3807
4086
  interface IntrinsicElements {
3808
- [tagName$k]: ChoiceListJSXProps &
3809
- BaseElementPropsWithChildren<ChoiceListJSXProps>;
4087
+ [tagName$k]: IntrinsicElementProps<ChoiceListJSXProps>;
3810
4088
  }
3811
4089
  }
3812
4090
  }
3813
4091
 
3814
4092
  declare const tagName$j = 's-choice';
3815
4093
  interface ChoiceJSXProps
3816
- extends Pick<ChoiceProps, 'value' | 'disabled' | 'selected'> {
4094
+ extends Pick<ChoiceProps, 'id' | 'value' | 'disabled' | 'selected'> {
3817
4095
  children?: ComponentChildren;
3818
4096
  }
3819
4097
  declare global {
@@ -3824,32 +4102,48 @@ declare global {
3824
4102
  declare module 'preact' {
3825
4103
  namespace createElement.JSX {
3826
4104
  interface IntrinsicElements {
3827
- [tagName$j]: ChoiceJSXProps &
3828
- BaseElementPropsWithChildren<ChoiceJSXProps>;
4105
+ [tagName$j]: IntrinsicElementProps<ChoiceJSXProps>;
3829
4106
  }
3830
4107
  }
3831
4108
  }
3832
4109
 
3833
4110
  declare const tagName$i = 's-modal';
3834
4111
  interface ModalJSXProps extends Pick<ModalProps, 'id' | 'heading'> {
3835
- primaryAction?: ComponentChild;
3836
- secondaryActions?: ComponentChild;
4112
+ /**
4113
+ * Callback when the modal is hidden.
4114
+ */
3837
4115
  onHide?: (event: CallbackEvent<typeof tagName$i>) => void | null;
4116
+ /**
4117
+ * Callback when the modal is shown.
4118
+ */
3838
4119
  onShow?: (event: CallbackEvent<typeof tagName$i>) => void | null;
4120
+ /**
4121
+ * The primary action button displayed in the modal.
4122
+ *
4123
+ * The tone of the button is used to define the tone of the modal.
4124
+ *
4125
+ * If omitted, the modal will default to an 'info' tone, and show an 'OK' button, translated according to the user's locale.
4126
+ */
4127
+ primaryAction?: ComponentChild;
4128
+ /**
4129
+ * The secondary action buttons displayed in the modal.
4130
+ */
4131
+ secondaryActions?: ComponentChild;
4132
+ /**
4133
+ * The content of the Modal.
4134
+ */
3839
4135
  children?: ComponentChildren;
3840
4136
  }
4137
+ type ElementProps$8 = Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'>;
3841
4138
  declare global {
3842
4139
  interface HTMLElementTagNameMap {
3843
- [tagName$i]: ModalJSXProps;
4140
+ [tagName$i]: ElementProps$8;
3844
4141
  }
3845
4142
  }
3846
4143
  declare module 'preact' {
3847
4144
  namespace createElement.JSX {
3848
4145
  interface IntrinsicElements {
3849
- [tagName$i]: Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'> &
3850
- BaseElementPropsWithChildren<
3851
- Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'>
3852
- >;
4146
+ [tagName$i]: IntrinsicElementProps<ElementProps$8>;
3853
4147
  }
3854
4148
  }
3855
4149
  }
@@ -3858,6 +4152,7 @@ declare const tagName$h = 's-text-field';
3858
4152
  interface TextFieldJSXProps
3859
4153
  extends Pick<
3860
4154
  TextFieldProps,
4155
+ | 'id'
3861
4156
  | 'label'
3862
4157
  | 'details'
3863
4158
  | 'value'
@@ -3867,33 +4162,60 @@ interface TextFieldJSXProps
3867
4162
  | 'required'
3868
4163
  | 'maxLength'
3869
4164
  > {
4165
+ /**
4166
+ * Callback when the user makes any changes in the field.
4167
+ */
3870
4168
  onInput?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
3871
- onFocus?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
3872
- onBlur?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
4169
+ /**
4170
+ * Callback after editing completes (typically on blur).
4171
+ */
3873
4172
  onChange?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
3874
- accessory?: ComponentChild;
3875
- }
3876
- declare global {
3877
- interface HTMLElementTagNameMap {
3878
- [tagName$h]: TextFieldJSXProps;
4173
+ /**
4174
+ * Callback when the element loses focus.
4175
+ */
4176
+ onBlur?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
4177
+ /**
4178
+ * Callback when the element receives focus.
4179
+ */
4180
+ onFocus?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
4181
+ /**
4182
+ * Additional content to be displayed in the field. Commonly used to display clickable text.
4183
+ */
4184
+ accessory?: ComponentChild;
4185
+ }
4186
+ type ElementProps$7 = Omit<TextFieldJSXProps, 'accessory'>;
4187
+ declare global {
4188
+ interface HTMLElementTagNameMap {
4189
+ [tagName$h]: ElementProps$7;
3879
4190
  }
3880
4191
  }
3881
4192
  declare module 'preact' {
3882
4193
  namespace createElement.JSX {
3883
4194
  interface IntrinsicElements {
3884
- [tagName$h]: Omit<TextFieldJSXProps, 'accessory'> &
3885
- BaseElementPropsWithChildren<Omit<TextFieldJSXProps, 'accessory'>>;
4195
+ [tagName$h]: IntrinsicElementProps<ElementProps$7>;
3886
4196
  }
3887
4197
  }
3888
4198
  }
3889
4199
 
3890
4200
  declare const tagName$g = 's-search-field';
3891
4201
  interface SearchFieldJSXProps
3892
- extends Pick<SearchFieldProps, 'disabled' | 'placeholder' | 'value'> {
3893
- onFocus?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
3894
- onBlur?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
4202
+ extends Pick<SearchFieldProps, 'id' | 'disabled' | 'placeholder' | 'value'> {
4203
+ /**
4204
+ * Callback when the user changes the value in the field.
4205
+ */
3895
4206
  onInput?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
4207
+ /**
4208
+ * Callback when the field loses focus after the user changes the value in the field.
4209
+ */
3896
4210
  onChange?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
4211
+ /**
4212
+ * Callback when the field loses focus.
4213
+ */
4214
+ onBlur?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
4215
+ /**
4216
+ * Callback when the field is focused.
4217
+ */
4218
+ onFocus?: ((event: CallbackEvent<typeof tagName$g>) => void) | null;
3897
4219
  }
3898
4220
  declare global {
3899
4221
  interface HTMLElementTagNameMap {
@@ -3903,8 +4225,7 @@ declare global {
3903
4225
  declare module 'preact' {
3904
4226
  namespace createElement.JSX {
3905
4227
  interface IntrinsicElements {
3906
- [tagName$g]: SearchFieldJSXProps &
3907
- BaseElementPropsWithChildren<SearchFieldJSXProps>;
4228
+ [tagName$g]: IntrinsicElementProps<SearchFieldJSXProps>;
3908
4229
  }
3909
4230
  }
3910
4231
  }
@@ -3913,6 +4234,7 @@ declare const tagName$f = 's-email-field';
3913
4234
  interface EmailFieldJSXProps
3914
4235
  extends Pick<
3915
4236
  EmailFieldProps,
4237
+ | 'id'
3916
4238
  | 'label'
3917
4239
  | 'value'
3918
4240
  | 'placeholder'
@@ -3922,30 +4244,51 @@ interface EmailFieldJSXProps
3922
4244
  | 'maxLength'
3923
4245
  | 'details'
3924
4246
  > {
4247
+ /**
4248
+ * Callback when the user makes any changes in the field.
4249
+ */
3925
4250
  onInput?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
3926
- onFocus?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
3927
- onBlur?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
4251
+ /**
4252
+ * Callback after editing completes (typically on blur).
4253
+ */
3928
4254
  onChange?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
4255
+ /**
4256
+ * Callback when the element loses focus.
4257
+ */
4258
+ onBlur?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
4259
+ /**
4260
+ * Callback when the element receives focus.
4261
+ */
4262
+ onFocus?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
4263
+ /**
4264
+ * Additional content to be displayed in the field. Commonly used to display clickable text.
4265
+ */
3929
4266
  accessory?: ComponentChild;
3930
4267
  }
4268
+ type ElementProps$6 = Omit<EmailFieldJSXProps, 'accessory'>;
3931
4269
  declare global {
3932
4270
  interface HTMLElementTagNameMap {
3933
- [tagName$f]: EmailFieldJSXProps;
4271
+ [tagName$f]: ElementProps$6;
3934
4272
  }
3935
4273
  }
3936
4274
  declare module 'preact' {
3937
4275
  namespace createElement.JSX {
3938
4276
  interface IntrinsicElements {
3939
- [tagName$f]: Omit<EmailFieldJSXProps, 'accessory'> &
3940
- BaseElementPropsWithChildren<Omit<EmailFieldJSXProps, 'accessory'>>;
4277
+ [tagName$f]: IntrinsicElementProps<ElementProps$6>;
3941
4278
  }
3942
4279
  }
3943
4280
  }
3944
4281
 
3945
4282
  declare const tagName$e = 's-clickable';
3946
- interface ClickableJSXProps extends Pick<ClickableProps, 'disabled'> {
3947
- children?: ComponentChildren;
4283
+ interface ClickableJSXProps extends Pick<ClickableProps, 'id' | 'disabled'> {
4284
+ /**
4285
+ * Callback when the element is activated.
4286
+ */
3948
4287
  onClick?: (event: CallbackEvent<typeof tagName$e>) => void;
4288
+ /**
4289
+ * The content of the Clickable.
4290
+ */
4291
+ children?: ComponentChildren;
3949
4292
  }
3950
4293
  declare global {
3951
4294
  interface HTMLElementTagNameMap {
@@ -3955,8 +4298,7 @@ declare global {
3955
4298
  declare module 'preact' {
3956
4299
  namespace createElement.JSX {
3957
4300
  interface IntrinsicElements {
3958
- [tagName$e]: ClickableJSXProps &
3959
- BaseElementPropsWithChildren<ClickableJSXProps>;
4301
+ [tagName$e]: IntrinsicElementProps<ClickableJSXProps>;
3960
4302
  }
3961
4303
  }
3962
4304
  }
@@ -3965,6 +4307,7 @@ declare const tagName$d = 's-text-area';
3965
4307
  interface TextAreaJSXProps
3966
4308
  extends Pick<
3967
4309
  TextAreaProps,
4310
+ | 'id'
3968
4311
  | 'label'
3969
4312
  | 'details'
3970
4313
  | 'value'
@@ -3975,30 +4318,46 @@ interface TextAreaJSXProps
3975
4318
  | 'maxLength'
3976
4319
  | 'rows'
3977
4320
  > {
4321
+ /**
4322
+ * Callback when the user makes any changes in the field.
4323
+ */
3978
4324
  onInput?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
3979
- onFocus?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
3980
- onBlur?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
4325
+ /**
4326
+ * Callback after editing completes (typically on blur).
4327
+ */
3981
4328
  onChange?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
4329
+ /**
4330
+ * Callback when the element loses focus.
4331
+ */
4332
+ onBlur?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
4333
+ /**
4334
+ * Callback when the element receives focus.
4335
+ */
4336
+ onFocus?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
4337
+ /**
4338
+ * Additional content to be displayed in the field. Commonly used to display clickable text.
4339
+ */
3982
4340
  accessory?: ComponentChild;
3983
4341
  }
4342
+ type ElementProps$5 = Omit<TextAreaJSXProps, 'accessory'>;
3984
4343
  declare global {
3985
4344
  interface HTMLElementTagNameMap {
3986
- [tagName$d]: TextAreaJSXProps;
4345
+ [tagName$d]: ElementProps$5;
3987
4346
  }
3988
4347
  }
3989
4348
  declare module 'preact' {
3990
4349
  namespace createElement.JSX {
3991
4350
  interface IntrinsicElements {
3992
- [tagName$d]: Omit<TextAreaJSXProps, 'accessory'> &
3993
- BaseElementPropsWithChildren<Omit<TextAreaJSXProps, 'accessory'>>;
4351
+ [tagName$d]: IntrinsicElementProps<ElementProps$5>;
3994
4352
  }
3995
4353
  }
3996
4354
  }
3997
4355
 
3998
4356
  declare const tagName$c = 's-number-field';
3999
- interface PickedJSXProps
4357
+ interface NumberFieldJSXProps
4000
4358
  extends Pick<
4001
4359
  NumberFieldProps,
4360
+ | 'id'
4002
4361
  | 'label'
4003
4362
  | 'details'
4004
4363
  | 'value'
@@ -4010,20 +4369,12 @@ interface PickedJSXProps
4010
4369
  | 'min'
4011
4370
  | 'controls'
4012
4371
  > {
4013
- inputMode?: Extract<NumberFieldProps['inputMode'], 'decimal' | 'numeric'>;
4014
- onInput?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4015
- onFocus?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4016
- onBlur?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4017
- onChange?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4018
- accessory?: ComponentChild;
4019
- }
4020
- interface NumberFieldJSXProps extends PickedJSXProps {
4021
4372
  /**
4022
4373
  * Content to use as the field label.
4023
4374
  *
4024
4375
  * Label is not supported when using Stepper controls
4025
4376
  */
4026
- label?: PickedJSXProps['label'];
4377
+ label?: NumberFieldProps['label'];
4027
4378
  /**
4028
4379
  * Additional text to provide context or guidance for the field.
4029
4380
  * This text is displayed along with the field and its label
@@ -4033,7 +4384,7 @@ interface NumberFieldJSXProps extends PickedJSXProps {
4033
4384
  *
4034
4385
  * Details are not supported when using Stepper controls
4035
4386
  */
4036
- details?: PickedJSXProps['details'];
4387
+ details?: NumberFieldProps['details'];
4037
4388
  /**
4038
4389
  * Whether the field needs a value. This requirement adds semantic value
4039
4390
  * to the field, but it will not cause an error to appear automatically.
@@ -4044,14 +4395,14 @@ interface NumberFieldJSXProps extends PickedJSXProps {
4044
4395
  *
4045
4396
  * Required is not supported when using Stepper controls
4046
4397
  */
4047
- required?: PickedJSXProps['required'];
4398
+ required?: NumberFieldProps['required'];
4048
4399
  /**
4049
4400
  * Indicate an error to the user. The field will be given a specific stylistic treatment
4050
4401
  * to communicate problems that have to be resolved immediately.
4051
4402
  *
4052
4403
  * Error is not supported when using Stepper controls
4053
4404
  */
4054
- error?: PickedJSXProps['error'];
4405
+ error?: NumberFieldProps['error'];
4055
4406
  /**
4056
4407
  * Sets the virtual keyboard.
4057
4408
  *
@@ -4060,20 +4411,19 @@ interface NumberFieldJSXProps extends PickedJSXProps {
4060
4411
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode
4061
4412
  * @default 'decimal'
4062
4413
  */
4063
- inputMode?: PickedJSXProps['inputMode'];
4414
+ inputMode?: NumberFieldProps['inputMode'];
4064
4415
  /**
4065
4416
  * A short hint that describes the expected value of the field.
4066
4417
  *
4067
4418
  * Placeholder text is not supported when using Stepper controls due to constrained space for the number field, especially on phones.
4068
4419
  */
4069
- placeholder?: PickedJSXProps['placeholder'];
4420
+ placeholder?: NumberFieldProps['placeholder'];
4070
4421
  /**
4071
- * Additional content to be displayed in the field.
4072
- * Commonly used to display an icon that activates a tooltip providing more information.
4422
+ * Additional content to be displayed in the field. Commonly used to display clickable text.
4073
4423
  *
4074
- * Accessory is not supported when using Stepper controls
4424
+ * > Note: Accessory is not supported when using Stepper controls
4075
4425
  */
4076
- accessory?: PickedJSXProps['accessory'];
4426
+ accessory?: ComponentChild;
4077
4427
  /**
4078
4428
  * Sets the type of controls displayed for the field.
4079
4429
  *
@@ -4084,18 +4434,34 @@ interface NumberFieldJSXProps extends PickedJSXProps {
4084
4434
  * - `none`: no controls are displayed and users must input the value manually.
4085
4435
  * - `auto`: the presence of the controls depends on the surface and context.
4086
4436
  */
4087
- controls?: PickedJSXProps['controls'];
4437
+ controls?: NumberFieldProps['controls'];
4438
+ /**
4439
+ * Callback when the user makes any changes in the field.
4440
+ */
4441
+ onInput?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4442
+ /**
4443
+ * Callback after editing completes (typically on blur).
4444
+ */
4445
+ onChange?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4446
+ /**
4447
+ * Callback when the element loses focus.
4448
+ */
4449
+ onBlur?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4450
+ /**
4451
+ * Callback when the element receives focus.
4452
+ */
4453
+ onFocus?: ((event: CallbackEvent<typeof tagName$c>) => void) | null;
4088
4454
  }
4455
+ type ElementProps$4 = Omit<NumberFieldJSXProps, 'accessory'>;
4089
4456
  declare global {
4090
4457
  interface HTMLElementTagNameMap {
4091
- [tagName$c]: NumberFieldJSXProps;
4458
+ [tagName$c]: ElementProps$4;
4092
4459
  }
4093
4460
  }
4094
4461
  declare module 'preact' {
4095
4462
  namespace createElement.JSX {
4096
4463
  interface IntrinsicElements {
4097
- [tagName$c]: Omit<NumberFieldJSXProps, 'accessory'> &
4098
- BaseElementPropsWithChildren<Omit<NumberFieldJSXProps, 'accessory'>>;
4464
+ [tagName$c]: IntrinsicElementProps<ElementProps$4>;
4099
4465
  }
4100
4466
  }
4101
4467
  }
@@ -4104,34 +4470,57 @@ declare const tagName$b = 's-date-field';
4104
4470
  interface DateFieldJSXProps
4105
4471
  extends Pick<
4106
4472
  DateFieldProps,
4107
- 'label' | 'details' | 'value' | 'disabled' | 'error'
4473
+ 'id' | 'label' | 'details' | 'value' | 'disabled' | 'error'
4108
4474
  > {
4475
+ /**
4476
+ * Callback when the user makes any changes in the field.
4477
+ */
4109
4478
  onInput?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4110
- onFocus?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4111
- onBlur?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4479
+ /**
4480
+ * Callback after editing completes (typically on blur).
4481
+ */
4112
4482
  onChange?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4113
- accessory?: ComponentChild;
4483
+ /**
4484
+ * Callback when the element loses focus.
4485
+ */
4486
+ onBlur?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4487
+ /**
4488
+ * Callback when the element receives focus.
4489
+ */
4490
+ onFocus?: ((event: CallbackEvent<typeof tagName$b>) => void) | null;
4114
4491
  }
4492
+ type ElementProps$3 = Omit<DateFieldJSXProps, 'accessory'>;
4115
4493
  declare global {
4116
4494
  interface HTMLElementTagNameMap {
4117
- [tagName$b]: DateFieldJSXProps;
4495
+ [tagName$b]: ElementProps$3;
4118
4496
  }
4119
4497
  }
4120
4498
  declare module 'preact' {
4121
4499
  namespace createElement.JSX {
4122
4500
  interface IntrinsicElements {
4123
- [tagName$b]: Omit<DateFieldJSXProps, 'accessory'> &
4124
- BaseElementPropsWithChildren<Omit<DateFieldJSXProps, 'accessory'>>;
4501
+ [tagName$b]: IntrinsicElementProps<ElementProps$3>;
4125
4502
  }
4126
4503
  }
4127
4504
  }
4128
4505
 
4129
4506
  declare const tagName$a = 's-date-picker';
4130
4507
  interface DatePickerJSXProps extends Pick<DatePickerProps, 'id' | 'value'> {
4508
+ /**
4509
+ * Callback when the user selects a date from the picker.
4510
+ */
4511
+ onInput?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4512
+ /**
4513
+ * Callback when the user selects a date from the picker that is different to the current value.
4514
+ */
4515
+ onChange?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4516
+ /**
4517
+ * Callback when the date picker is dismissed.
4518
+ */
4131
4519
  onBlur?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4520
+ /**
4521
+ * Callback when the date picker is revealed.
4522
+ */
4132
4523
  onFocus?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4133
- onChange?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4134
- onInput?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4135
4524
  }
4136
4525
  declare global {
4137
4526
  interface HTMLElementTagNameMap {
@@ -4141,18 +4530,29 @@ declare global {
4141
4530
  declare module 'preact' {
4142
4531
  namespace createElement.JSX {
4143
4532
  interface IntrinsicElements {
4144
- [tagName$a]: DatePickerJSXProps &
4145
- BaseElementPropsWithChildren<DatePickerJSXProps>;
4533
+ [tagName$a]: IntrinsicElementProps<DatePickerJSXProps>;
4146
4534
  }
4147
4535
  }
4148
4536
  }
4149
4537
 
4150
4538
  declare const tagName$9 = 's-date-spinner';
4151
4539
  interface DateSpinnerJSXProps extends Pick<DateSpinnerProps, 'id' | 'value'> {
4540
+ /**
4541
+ * Callback when the user makes a selection.
4542
+ */
4543
+ onInput?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4544
+ /**
4545
+ * Callback when the value changes. Only called when a different value is selected.
4546
+ */
4547
+ onChange?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4548
+ /**
4549
+ * Callback when the date spinner is dismissed.
4550
+ */
4152
4551
  onBlur?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4552
+ /**
4553
+ * Callback when the date spinner is revealed.
4554
+ */
4153
4555
  onFocus?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4154
- onChange?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4155
- onInput?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4156
4556
  }
4157
4557
  declare global {
4158
4558
  interface HTMLElementTagNameMap {
@@ -4162,40 +4562,47 @@ declare global {
4162
4562
  declare module 'preact' {
4163
4563
  namespace createElement.JSX {
4164
4564
  interface IntrinsicElements {
4165
- [tagName$9]: DateSpinnerJSXProps &
4166
- BaseElementPropsWithChildren<DateSpinnerJSXProps>;
4565
+ [tagName$9]: IntrinsicElementProps<DateSpinnerJSXProps>;
4167
4566
  }
4168
4567
  }
4169
4568
  }
4170
4569
 
4171
4570
  declare const tagName$8 = 's-section';
4172
- interface SectionJSXProps extends Pick<SectionProps, 'children'> {
4173
- secondaryActions?: ComponentChild;
4571
+ interface SectionJSXProps extends Pick<SectionProps, 'id'> {
4174
4572
  /**
4175
- * Adds title text displayed at the top left of the section
4176
- *
4177
- * **Mobile surfaces:** Uses the standard POS Design System heading style for a section (not h2).
4573
+ * A title that describes the content of the section.
4178
4574
  *
4179
- * @default undefined
4575
+ * If omitted, and no secondaryActions are provided, the section will be rendered without a header.
4180
4576
  */
4181
4577
  heading?: string;
4578
+ /**
4579
+ * Button element to display in the section heading. A single button is supported.
4580
+ */
4581
+ secondaryActions?: ComponentChild;
4582
+ /**
4583
+ * The content of the Section.
4584
+ */
4585
+ children?: ComponentChildren;
4182
4586
  }
4587
+ type ElementProps$2 = Omit<SectionJSXProps, 'secondaryActions'>;
4183
4588
  declare global {
4184
4589
  interface HTMLElementTagNameMap {
4185
- [tagName$8]: SectionJSXProps;
4590
+ [tagName$8]: ElementProps$2;
4186
4591
  }
4187
4592
  }
4188
4593
  declare module 'preact' {
4189
4594
  namespace createElement.JSX {
4190
4595
  interface IntrinsicElements {
4191
- [tagName$8]: Omit<SectionJSXProps, 'secondaryActions'> &
4192
- BaseElementPropsWithChildren<Omit<SectionJSXProps, 'secondaryActions'>>;
4596
+ [tagName$8]: IntrinsicElementProps<ElementProps$2>;
4193
4597
  }
4194
4598
  }
4195
4599
  }
4196
4600
 
4197
4601
  declare const tagName$7 = 's-heading';
4198
- interface HeadingJSXProps {
4602
+ interface HeadingJSXProps extends Pick<HeadingProps, 'id'> {
4603
+ /**
4604
+ * The content of the Heading.
4605
+ */
4199
4606
  children?: ComponentChildren;
4200
4607
  }
4201
4608
  declare global {
@@ -4206,18 +4613,29 @@ declare global {
4206
4613
  declare module 'preact' {
4207
4614
  namespace createElement.JSX {
4208
4615
  interface IntrinsicElements {
4209
- [tagName$7]: HeadingJSXProps &
4210
- BaseElementPropsWithChildren<HeadingJSXProps>;
4616
+ [tagName$7]: IntrinsicElementProps<HeadingJSXProps>;
4211
4617
  }
4212
4618
  }
4213
4619
  }
4214
4620
 
4215
4621
  declare const tagName$6 = 's-time-picker';
4216
4622
  interface TimePickerJSXProps extends Pick<TimePickerProps, 'id' | 'value'> {
4623
+ /**
4624
+ * Callback when the user selects a time from the picker.
4625
+ */
4626
+ onInput?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4627
+ /**
4628
+ * Callback when the user selects a time from the picker that is different to the current value.
4629
+ */
4630
+ onChange?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4631
+ /**
4632
+ * Callback when the time picker is dismissed.
4633
+ */
4217
4634
  onBlur?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4635
+ /**
4636
+ * Callback when the time picker is revealed.
4637
+ */
4218
4638
  onFocus?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4219
- onChange?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4220
- onInput?: (event: CallbackEvent<typeof tagName$6>) => void | null;
4221
4639
  }
4222
4640
  declare global {
4223
4641
  interface HTMLElementTagNameMap {
@@ -4227,16 +4645,13 @@ declare global {
4227
4645
  declare module 'preact' {
4228
4646
  namespace createElement.JSX {
4229
4647
  interface IntrinsicElements {
4230
- [tagName$6]: TimePickerJSXProps &
4231
- BaseElementPropsWithChildren<TimePickerJSXProps>;
4648
+ [tagName$6]: IntrinsicElementProps<TimePickerJSXProps>;
4232
4649
  }
4233
4650
  }
4234
4651
  }
4235
4652
 
4236
4653
  declare const tagName$5 = 's-image';
4237
- type PickedProps$1 = Pick<ImageProps, 'src' | 'inlineSize' | 'objectFit'>;
4238
- interface ImageJSXProps extends PickedProps$1 {
4239
- children?: ComponentChildren;
4654
+ interface ImageJSXProps extends Pick<ImageProps, 'id' | 'objectFit'> {
4240
4655
  /**
4241
4656
  * The displayed inline width of the image.
4242
4657
  *
@@ -4251,7 +4666,15 @@ interface ImageJSXProps extends PickedProps$1 {
4251
4666
  *
4252
4667
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#width
4253
4668
  */
4254
- inlineSize?: PickedProps$1['inlineSize'];
4669
+ inlineSize?: ImageProps['inlineSize'];
4670
+ /**
4671
+ * The image source, which should be a remote URL.
4672
+ *
4673
+ * When the image is loading or no `src` is provided, a placeholder will be rendered.
4674
+ *
4675
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#src
4676
+ */
4677
+ src?: ImageProps['src'];
4255
4678
  }
4256
4679
  declare global {
4257
4680
  interface HTMLElementTagNameMap {
@@ -4261,33 +4684,46 @@ declare global {
4261
4684
  declare module 'preact' {
4262
4685
  namespace createElement.JSX {
4263
4686
  interface IntrinsicElements {
4264
- [tagName$5]: ImageJSXProps & BaseElementPropsWithChildren<ImageJSXProps>;
4687
+ [tagName$5]: IntrinsicElementProps<ImageJSXProps>;
4265
4688
  }
4266
4689
  }
4267
4690
  }
4268
4691
 
4269
4692
  declare const tagName$4 = 's-page';
4270
- type PickedProps = Pick<
4271
- PageProps,
4272
- 'heading' | 'subheading' | 'secondaryActions' | 'aside'
4273
- >;
4274
- interface PageJSXProps extends PickedProps {
4275
- children?: ComponentChildren;
4693
+ interface PageJSXProps extends Pick<PageProps, 'id'> {
4694
+ /**
4695
+ * The main page heading, displayed in the action bar at the top of the page.
4696
+ *
4697
+ * @default: ''
4698
+ */
4699
+ heading?: PageProps['heading'];
4700
+ /**
4701
+ * A secondary page heading, displayed under the main heading in the action bar.
4702
+ */
4703
+ subheading?: PageProps['subheading'];
4704
+ /**
4705
+ * Button element to display in the action bar. Only a single button is supported.
4706
+ */
4276
4707
  secondaryActions?: ComponentChild;
4708
+ /**
4709
+ * Content to display in the page's sidebar.
4710
+ */
4277
4711
  aside?: ComponentChild;
4712
+ /**
4713
+ * The content of the Page.
4714
+ */
4715
+ children?: ComponentChildren;
4278
4716
  }
4717
+ type ElementProps$1 = Omit<PageJSXProps, 'secondaryActions' | 'aside'>;
4279
4718
  declare global {
4280
4719
  interface HTMLElementTagNameMap {
4281
- [tagName$4]: PageJSXProps;
4720
+ [tagName$4]: ElementProps$1;
4282
4721
  }
4283
4722
  }
4284
4723
  declare module 'preact' {
4285
4724
  namespace createElement.JSX {
4286
4725
  interface IntrinsicElements {
4287
- [tagName$4]: Omit<PageJSXProps, 'secondaryActions' | 'aside'> &
4288
- BaseElementPropsWithChildren<
4289
- Omit<PageJSXProps, 'secondaryActions' | 'aside'>
4290
- >;
4726
+ [tagName$4]: IntrinsicElementProps<ElementProps$1>;
4291
4727
  }
4292
4728
  }
4293
4729
  }
@@ -4298,10 +4734,22 @@ interface TimeFieldJSXProps
4298
4734
  TimeFieldProps,
4299
4735
  'id' | 'label' | 'disabled' | 'value' | 'error' | 'details'
4300
4736
  > {
4301
- onBlur?: (event: CallbackEvent<typeof tagName$3>) => void | null;
4302
- onFocus?: (event: CallbackEvent<typeof tagName$3>) => void | null;
4303
- onInput?: (event: CallbackEvent<typeof tagName$3>) => void | null;
4304
- onChange?: (event: CallbackEvent<typeof tagName$3>) => void | null;
4737
+ /**
4738
+ * Callback when the user makes any changes in the field.
4739
+ */
4740
+ onInput?: ((event: CallbackEvent<typeof tagName$3>) => void) | null;
4741
+ /**
4742
+ * Callback after editing completes (typically on blur).
4743
+ */
4744
+ onChange?: ((event: CallbackEvent<typeof tagName$3>) => void) | null;
4745
+ /**
4746
+ * Callback when the element loses focus.
4747
+ */
4748
+ onBlur?: ((event: CallbackEvent<typeof tagName$3>) => void) | null;
4749
+ /**
4750
+ * Callback when the element receives focus.
4751
+ */
4752
+ onFocus?: ((event: CallbackEvent<typeof tagName$3>) => void) | null;
4305
4753
  }
4306
4754
  declare global {
4307
4755
  interface HTMLElementTagNameMap {
@@ -4311,47 +4759,38 @@ declare global {
4311
4759
  declare module 'preact' {
4312
4760
  namespace createElement.JSX {
4313
4761
  interface IntrinsicElements {
4314
- [tagName$3]: TimeFieldJSXProps &
4315
- BaseElementPropsWithChildren<TimeFieldJSXProps>;
4762
+ [tagName$3]: IntrinsicElementProps<TimeFieldJSXProps>;
4316
4763
  }
4317
4764
  }
4318
4765
  }
4319
4766
 
4320
4767
  declare const tagName$2 = 's-pos-block';
4321
- interface PosBlockJSXProps extends Pick<SectionProps, 'children'> {
4768
+ interface PosBlockJSXProps extends Pick<POSBlockProps, 'id' | 'heading'> {
4769
+ /**
4770
+ * The secondary actions to perform, provided as button or link type elements.
4771
+ */
4322
4772
  secondaryActions?: ComponentChild;
4323
4773
  /**
4324
- * Adds title text displayed at the top left of the section
4325
- *
4326
- * **Mobile surfaces:** Uses the standard POS Design System heading style for a section (not h2).
4327
- *
4328
- * @default undefined
4774
+ * The content of the Block.
4329
4775
  */
4330
- heading?: string;
4776
+ children?: ComponentChildren;
4331
4777
  }
4778
+ type ElementProps = Omit<PosBlockJSXProps, 'secondaryActions'>;
4332
4779
  declare global {
4333
4780
  interface HTMLElementTagNameMap {
4334
- [tagName$2]: PosBlockJSXProps;
4781
+ [tagName$2]: ElementProps;
4335
4782
  }
4336
4783
  }
4337
4784
  declare module 'preact' {
4338
4785
  namespace createElement.JSX {
4339
4786
  interface IntrinsicElements {
4340
- [tagName$2]: Omit<PosBlockJSXProps, 'secondaryActions'> &
4341
- BaseElementPropsWithChildren<
4342
- Omit<PosBlockJSXProps, 'secondaryActions'>
4343
- >;
4787
+ [tagName$2]: IntrinsicElementProps<ElementProps>;
4344
4788
  }
4345
4789
  }
4346
4790
  }
4347
4791
 
4348
4792
  declare const tagName$1 = 's-qr-code';
4349
- interface QrCodeJSXProps {
4350
- /**
4351
- * The value to encode in the QR code
4352
- */
4353
- content: string;
4354
- }
4793
+ interface QrCodeJSXProps extends Pick<QRCodeProps, 'id' | 'content'> {}
4355
4794
  declare global {
4356
4795
  interface HTMLElementTagNameMap {
4357
4796
  [tagName$1]: QrCodeJSXProps;
@@ -4360,13 +4799,13 @@ declare global {
4360
4799
  declare module 'preact' {
4361
4800
  namespace createElement.JSX {
4362
4801
  interface IntrinsicElements {
4363
- [tagName$1]: QrCodeJSXProps & BaseElementProps<QrCodeJSXProps>;
4802
+ [tagName$1]: IntrinsicElementProps<QrCodeJSXProps>;
4364
4803
  }
4365
4804
  }
4366
4805
  }
4367
4806
 
4368
4807
  declare const tagName = 's-divider';
4369
- interface DividerJSXProps extends Pick<DividerProps, 'direction'> {}
4808
+ interface DividerJSXProps extends Pick<DividerProps, 'id' | 'direction'> {}
4370
4809
  declare global {
4371
4810
  interface HTMLElementTagNameMap {
4372
4811
  [tagName]: DividerJSXProps;
@@ -4375,8 +4814,7 @@ declare global {
4375
4814
  declare module 'preact' {
4376
4815
  namespace createElement.JSX {
4377
4816
  interface IntrinsicElements {
4378
- [tagName]: DividerJSXProps &
4379
- BaseElementPropsWithChildren<DividerJSXProps>;
4817
+ [tagName]: IntrinsicElementProps<DividerJSXProps>;
4380
4818
  }
4381
4819
  }
4382
4820
  }
@@ -4415,6 +4853,10 @@ export type {
4415
4853
  };
4416
4854
 
4417
4855
  interface Badge {
4856
+ /**
4857
+ * Sets the tone of the Badge, based on the intention of the information being conveyed.
4858
+ * @default 'auto'
4859
+ */
4418
4860
  tone?:
4419
4861
  | 'auto'
4420
4862
  | 'neutral'
@@ -4433,10 +4875,16 @@ interface BannerSlots {
4433
4875
  }
4434
4876
 
4435
4877
  interface Banner {
4436
- /** Determines whether the banner is hidden. */
4878
+ /**
4879
+ * Determines whether the banner is hidden.
4880
+ * @default false
4881
+ */
4437
4882
  hidden?: boolean;
4438
- /** Sets the tone of the Banner, based on the intention of the information being conveyed. */
4439
- tone?: 'info' | 'success' | 'warning' | 'critical';
4883
+ /**
4884
+ * Sets the tone of the Banner, based on the intention of the information being conveyed.
4885
+ * @default 'auto'
4886
+ */
4887
+ tone?: 'auto' | 'info' | 'success' | 'warning' | 'critical';
4440
4888
  /**
4441
4889
  * The title of the banner.
4442
4890
  * @default ''
@@ -4447,6 +4895,38 @@ interface Banner {
4447
4895
  }
4448
4896
 
4449
4897
  interface Box {
4898
+ /** A unique identifier for the element. */
4899
+ id?: string;
4900
+ /**
4901
+ * Adjust the block size.
4902
+ * @default 'auto'
4903
+ */
4904
+ blockSize?: SizeUnitsOrAuto;
4905
+ /**
4906
+ * Adjust the inline size.
4907
+ * @default 'auto'
4908
+ */
4909
+ inlineSize?: SizeUnitsOrAuto;
4910
+ /**
4911
+ * Adjust the maximum block size.
4912
+ * @default 'none'
4913
+ */
4914
+ maxBlockSize?: SizeUnitsOrNone;
4915
+ /**
4916
+ * Adjust the maximum inline size.
4917
+ * @default 'none'
4918
+ */
4919
+ maxInlineSize?: SizeUnitsOrNone;
4920
+ /**
4921
+ * Adjust the minimum block size.
4922
+ * @default '0'
4923
+ */
4924
+ minBlockSize?: SizeUnits;
4925
+ /**
4926
+ * Adjust the minimum inline size.
4927
+ * @default '0'
4928
+ */
4929
+ minInlineSize?: SizeUnits;
4450
4930
  /**
4451
4931
  * Adjust the padding of all edges.
4452
4932
  *
@@ -4475,7 +4955,7 @@ interface Box {
4475
4955
  * This overrides the block value of `padding`.
4476
4956
  * @default '' - meaning no override
4477
4957
  */
4478
- paddingBlock?: MaybeTwoValuesShorthandProperty<'' | PaddingKeyword>;
4958
+ paddingBlock?: '' | MaybeTwoValuesShorthandProperty<PaddingKeyword>;
4479
4959
  /**
4480
4960
  * Adjust the block-start padding.
4481
4961
  *
@@ -4498,7 +4978,7 @@ interface Box {
4498
4978
  * This overrides the inline value of `padding`.
4499
4979
  * @default '' - meaning no override
4500
4980
  */
4501
- paddingInline?: MaybeTwoValuesShorthandProperty<'' | PaddingKeyword>;
4981
+ paddingInline?: '' | MaybeTwoValuesShorthandProperty<PaddingKeyword>;
4502
4982
  /**
4503
4983
  * Adjust the inline-start padding.
4504
4984
  *
@@ -4513,45 +4993,10 @@ interface Box {
4513
4993
  * @default '' - meaning no override
4514
4994
  */
4515
4995
  paddingInlineEnd?: '' | PaddingKeyword;
4516
- /**
4517
- * Adjust the block size.
4518
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/block-size
4519
- * @default 'auto'
4520
- */
4521
- blockSize?: MaybeResponsive<SizeUnitsOrAuto>;
4522
- /**
4523
- * Adjust the minimum block size.
4524
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-block-size
4525
- * @default '0'
4526
- */
4527
- minBlockSize?: MaybeResponsive<SizeUnits>;
4528
- /**
4529
- * Adjust the maximum block size.
4530
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-block-size
4531
- * @default 'none'
4532
- */
4533
- maxBlockSize?: MaybeResponsive<SizeUnitsOrNone>;
4534
- /**
4535
- * Adjust the inline size.
4536
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/inline-size
4537
- * @default 'auto'
4538
- */
4539
- inlineSize?: MaybeResponsive<SizeUnitsOrAuto>;
4540
- /**
4541
- * Adjust the minimum inline size.
4542
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-inline-size
4543
- * @default '0'
4544
- */
4545
- minInlineSize?: MaybeResponsive<SizeUnits>;
4546
- /**
4547
- * Adjust the maximum inline size.
4548
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-inline-size
4549
- * @default 'none'
4550
- */
4551
- maxInlineSize?: MaybeResponsive<SizeUnitsOrNone>;
4552
4996
  }
4553
4997
 
4554
4998
  interface ButtonEvents {
4999
+ /** Called when the button is activated. */
4555
5000
  click?: (event: CallbackEvent<typeof tagName$t>) => void;
4556
5001
  }
4557
5002
 
@@ -4579,6 +5024,8 @@ interface Button {
4579
5024
  * @default 'auto' - the variant is automatically determined by the Button's context
4580
5025
  */
4581
5026
  variant?: 'primary' | 'secondary';
5027
+ /** A unique identifier for the element. */
5028
+ id?: string;
4582
5029
  /**
4583
5030
  * Disables the Button meaning it cannot be clicked or receive focus.
4584
5031
  * @default false
@@ -4601,6 +5048,8 @@ interface Button {
4601
5048
  }
4602
5049
 
4603
5050
  interface Choice {
5051
+ /** A unique identifier for the element. */
5052
+ id?: string;
4604
5053
  /** The value used in form data when the control is checked. */
4605
5054
  value?: string;
4606
5055
  /**
@@ -4616,11 +5065,15 @@ interface Choice {
4616
5065
  }
4617
5066
 
4618
5067
  interface ChoiceListEvents {
4619
- change?: (event: CallbackEvent<typeof tagName$k>) => void;
5068
+ /** Callback when the user changes a choice. Fires simultaneously with onChange. */
4620
5069
  input?: (event: CallbackEvent<typeof tagName$k>) => void;
5070
+ /** Callback when the user changes a choice. Fires simultaneously with onInput. */
5071
+ change?: (event: CallbackEvent<typeof tagName$k>) => void;
4621
5072
  }
4622
5073
 
4623
5074
  interface ChoiceList {
5075
+ /** A unique identifier for the element. */
5076
+ id?: string;
4624
5077
  /**
4625
5078
  * An array of the `value`s of the selected options.
4626
5079
  *
@@ -4635,10 +5088,13 @@ interface ChoiceList {
4635
5088
  }
4636
5089
 
4637
5090
  interface ClickableEvents {
5091
+ /** Callback when the element is activated. */
4638
5092
  click?: (event: CallbackEvent<typeof tagName$e>) => void;
4639
5093
  }
4640
5094
 
4641
5095
  interface Clickable {
5096
+ /** A unique identifier for the element. */
5097
+ id?: string;
4642
5098
  /**
4643
5099
  * Disables the clickable, meaning it cannot be clicked or receive focus.
4644
5100
  *
@@ -4654,17 +5110,19 @@ interface Clickable {
4654
5110
  }
4655
5111
 
4656
5112
  interface DateFieldEvents {
5113
+ /** Callback when the user makes any changes in the field. */
4657
5114
  input?: (event: CallbackEvent<typeof tagName$b>) => void;
4658
- focus?: (event: CallbackEvent<typeof tagName$b>) => void;
4659
- blur?: (event: CallbackEvent<typeof tagName$b>) => void;
5115
+ /** Callback after editing completes (typically on blur). */
4660
5116
  change?: (event: CallbackEvent<typeof tagName$b>) => void;
4661
- }
4662
-
4663
- interface DateFieldSlots {
4664
- accessory?: HTMLElement;
5117
+ /** Callback when the element loses focus. */
5118
+ blur?: (event: CallbackEvent<typeof tagName$b>) => void;
5119
+ /** Callback when the element receives focus. */
5120
+ focus?: (event: CallbackEvent<typeof tagName$b>) => void;
4665
5121
  }
4666
5122
 
4667
5123
  interface DateField {
5124
+ /** A unique identifier for the element. */
5125
+ id?: string;
4668
5126
  /** Content to use as the field label. */
4669
5127
  label?: string;
4670
5128
  /**
@@ -4690,10 +5148,14 @@ interface DateField {
4690
5148
  }
4691
5149
 
4692
5150
  interface DatePickerEvents {
5151
+ /** Callback when the user selects a date from the picker. */
5152
+ input?: (event: CallbackEvent<typeof tagName$a>) => void | null;
5153
+ /** Callback when the user selects a date from the picker that is different to the current value. */
5154
+ change?: (event: CallbackEvent<typeof tagName$a>) => void | null;
5155
+ /** Callback when the date picker is dismissed. */
4693
5156
  blur?: (event: CallbackEvent<typeof tagName$a>) => void | null;
5157
+ /** Callback when the date picker is revealed. */
4694
5158
  focus?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4695
- change?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4696
- input?: (event: CallbackEvent<typeof tagName$a>) => void | null;
4697
5159
  }
4698
5160
 
4699
5161
  interface DatePicker {
@@ -4717,10 +5179,14 @@ interface DatePicker {
4717
5179
  }
4718
5180
 
4719
5181
  interface DateSpinnerEvents {
5182
+ /** Callback when the user makes a selection. */
5183
+ input?: (event: CallbackEvent<typeof tagName$9>) => void | null;
5184
+ /** Callback when the value changes. Only called when a different value is selected. */
5185
+ change?: (event: CallbackEvent<typeof tagName$9>) => void | null;
5186
+ /** Callback when the date spinner is dismissed. */
4720
5187
  blur?: (event: CallbackEvent<typeof tagName$9>) => void | null;
5188
+ /** Callback when the date spinner is revealed. */
4721
5189
  focus?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4722
- change?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4723
- input?: (event: CallbackEvent<typeof tagName$9>) => void | null;
4724
5190
  }
4725
5191
 
4726
5192
  interface DateSpinner {
@@ -4736,6 +5202,8 @@ interface DateSpinner {
4736
5202
  }
4737
5203
 
4738
5204
  interface Divider {
5205
+ /** A unique identifier for the element. */
5206
+ id?: string;
4739
5207
  /**
4740
5208
  * Specify the direction of the divider. This uses [logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
4741
5209
  * @default 'inline'
@@ -4744,17 +5212,24 @@ interface Divider {
4744
5212
  }
4745
5213
 
4746
5214
  interface EmailFieldEvents {
5215
+ /** Callback when the user makes any changes in the field. */
4747
5216
  input?: (event: CallbackEvent<typeof tagName$f>) => void;
4748
- focus?: (event: CallbackEvent<typeof tagName$f>) => void;
4749
- blur?: (event: CallbackEvent<typeof tagName$f>) => void;
5217
+ /** Callback after editing completes (typically on blur). */
4750
5218
  change?: (event: CallbackEvent<typeof tagName$f>) => void;
5219
+ /** Callback when the element loses focus. */
5220
+ blur?: (event: CallbackEvent<typeof tagName$f>) => void;
5221
+ /** Callback when the element receives focus. */
5222
+ focus?: (event: CallbackEvent<typeof tagName$f>) => void;
4751
5223
  }
4752
5224
 
4753
5225
  interface EmailFieldSlots {
5226
+ /** Additional content to be displayed in the field. Commonly used to display clickable text. */
4754
5227
  accessory?: HTMLElement;
4755
5228
  }
4756
5229
 
4757
5230
  interface EmailField {
5231
+ /** A unique identifier for the element. */
5232
+ id?: string;
4758
5233
  /** Content to use as the field label. */
4759
5234
  label?: string;
4760
5235
  /** The current value for the field. If omitted, the field will be empty. */
@@ -4794,12 +5269,19 @@ interface EmailField {
4794
5269
  details?: string;
4795
5270
  }
4796
5271
 
5272
+ interface Heading {
5273
+ /** A unique identifier for the element. */
5274
+ id?: string;
5275
+ }
5276
+
4797
5277
  interface Icon {
4798
5278
  /**
4799
- * The type of icon to display. Maps to PDS icon names.
5279
+ * The type of icon to display.
4800
5280
  * @default ''
4801
5281
  */
4802
5282
  type?: SupportedIconNames;
5283
+ /** A unique identifier for the element. */
5284
+ id?: string;
4803
5285
  /**
4804
5286
  * Sets the tone of the icon, based on the intention of the information being conveyed.
4805
5287
  * @default 'auto'
@@ -4832,14 +5314,14 @@ interface Image {
4832
5314
  */
4833
5315
  inlineSize?: 'fill' | 'auto';
4834
5316
  /**
4835
- * The image source (either a remote URL or a local file resource).
5317
+ * The image source, which should be a remote URL.
4836
5318
  *
4837
5319
  * When the image is loading or no `src` is provided, a placeholder will be rendered.
4838
- * @implementation Surfaces may choose the style of the placeholder, but the space the image occupies should be
4839
- * reserved, except in cases where the image area does not have a contextual inline or block size, which should be rare.
4840
5320
  * @see ://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#src
4841
5321
  */
4842
5322
  src?: string;
5323
+ /** A unique identifier for the element. */
5324
+ id?: string;
4843
5325
  /**
4844
5326
  * Determines how the content of the image is resized to fit its container.
4845
5327
  * The image is positioned in the center of the container.
@@ -4850,12 +5332,22 @@ interface Image {
4850
5332
  }
4851
5333
 
4852
5334
  interface ModalEvents {
5335
+ /** Callback when the modal is hidden. */
4853
5336
  hide?: (event: CallbackEvent<typeof tagName$i>) => void | null;
5337
+ /** Callback when the modal is shown. */
4854
5338
  show?: (event: CallbackEvent<typeof tagName$i>) => void | null;
4855
5339
  }
4856
5340
 
4857
5341
  interface ModalSlots {
5342
+ /**
5343
+ * The primary action button displayed in the modal.
5344
+ *
5345
+ * The tone of the button is used to define the tone of the modal.
5346
+ *
5347
+ * If omitted, the modal will default to an 'info' tone, and show an 'OK' button, translated according to the user's locale.
5348
+ */
4858
5349
  'primary-action'?: HTMLElement;
5350
+ /** The secondary action buttons displayed in the modal. */
4859
5351
  'secondary-actions'?: HTMLElement;
4860
5352
  }
4861
5353
 
@@ -4867,18 +5359,21 @@ interface Modal {
4867
5359
  }
4868
5360
 
4869
5361
  interface NumberFieldEvents {
5362
+ /** Callback when the user makes any changes in the field. */
4870
5363
  input?: (event: CallbackEvent<typeof tagName$c>) => void;
4871
- focus?: (event: CallbackEvent<typeof tagName$c>) => void;
4872
- blur?: (event: CallbackEvent<typeof tagName$c>) => void;
5364
+ /** Callback after editing completes (typically on blur). */
4873
5365
  change?: (event: CallbackEvent<typeof tagName$c>) => void;
5366
+ /** Callback when the element loses focus. */
5367
+ blur?: (event: CallbackEvent<typeof tagName$c>) => void;
5368
+ /** Callback when the element receives focus. */
5369
+ focus?: (event: CallbackEvent<typeof tagName$c>) => void;
4874
5370
  }
4875
5371
 
4876
5372
  interface NumberFieldSlots {
4877
5373
  /**
4878
- * Additional content to be displayed in the field.
4879
- * Commonly used to display an icon that activates a tooltip providing more information.
5374
+ * Additional content to be displayed in the field. Commonly used to display clickable text.
4880
5375
  *
4881
- * Accessory is not supported when using Stepper controls
5376
+ * > Note: Accessory is not supported when using Stepper controls
4882
5377
  */
4883
5378
  accessory?: HTMLElement;
4884
5379
  }
@@ -4942,6 +5437,8 @@ interface NumberField {
4942
5437
  * - `auto`: the presence of the controls depends on the surface and context.
4943
5438
  */
4944
5439
  controls?: 'auto' | 'stepper' | 'none';
5440
+ /** A unique identifier for the element. */
5441
+ id?: string;
4945
5442
  /** The current value for the field. If omitted, the field will be empty. */
4946
5443
  value?: string;
4947
5444
  /**
@@ -4970,37 +5467,82 @@ interface NumberField {
4970
5467
  }
4971
5468
 
4972
5469
  interface PageSlots {
5470
+ /** Button element to display in the action bar. Only a single button is supported. */
4973
5471
  'secondary-actions'?: HTMLElement;
5472
+ /** Content to display in the page's sidebar. */
4974
5473
  aside?: HTMLElement;
4975
5474
  }
4976
5475
 
4977
5476
  interface Page {
4978
- /** The main page heading */
5477
+ /**
5478
+ * The main page heading, displayed in the action bar at the top of the page.
5479
+ * @default : ''
5480
+ */
4979
5481
  heading?: string;
4980
- /** The text to be used as subtitle. */
5482
+ /** A secondary page heading, displayed under the main heading in the action bar. */
4981
5483
  subheading?: string;
5484
+ /** A unique identifier for the element. */
5485
+ id?: string;
4982
5486
  }
4983
5487
 
4984
5488
  interface PosBlockSlots {
5489
+ /** The secondary actions to perform, provided as button or link type elements. */
4985
5490
  'secondary-actions'?: HTMLElement;
4986
5491
  }
4987
5492
 
4988
5493
  interface PosBlock {
5494
+ /** A unique identifier for the element. */
5495
+ id?: string;
4989
5496
  /**
4990
- * Adds title text displayed at the top left of the section
5497
+ * The heading to display within the POSBlock.
4991
5498
  *
4992
- * **Mobile surfaces:** Uses the standard POS Design System heading style for a section (not h2).
4993
- * @default undefined
5499
+ * If not provided, the description of the extension will be used when a heading is appropriate.
4994
5500
  */
4995
5501
  heading?: string;
4996
5502
  }
4997
5503
 
4998
5504
  interface QrCode {
4999
- /** The value to encode in the QR code */
5000
- content: string;
5505
+ /** A unique identifier for the element. */
5506
+ id?: string;
5507
+ /**
5508
+ * The content to be encoded in the QR code, which can be any string such as a URL, email address, plain text, etc.
5509
+ * Specific string formatting can trigger actions on the user's device when scanned, like opening geolocation
5510
+ * coordinates on a map, opening a preferred app or app store entry, preparing an email, text message, and more.
5511
+ */
5512
+ content?: string;
5001
5513
  }
5002
5514
 
5003
5515
  interface ScrollBox {
5516
+ /**
5517
+ * Adjust the block size.
5518
+ * @default 'auto'
5519
+ */
5520
+ blockSize?: SizeUnitsOrAuto;
5521
+ /**
5522
+ * Adjust the inline size.
5523
+ * @default 'auto'
5524
+ */
5525
+ inlineSize?: SizeUnitsOrAuto;
5526
+ /**
5527
+ * Adjust the maximum block size.
5528
+ * @default 'none'
5529
+ */
5530
+ maxBlockSize?: SizeUnitsOrNone;
5531
+ /**
5532
+ * Adjust the maximum inline size.
5533
+ * @default 'none'
5534
+ */
5535
+ maxInlineSize?: SizeUnitsOrNone;
5536
+ /**
5537
+ * Adjust the minimum block size.
5538
+ * @default '0'
5539
+ */
5540
+ minBlockSize?: SizeUnits;
5541
+ /**
5542
+ * Adjust the minimum inline size.
5543
+ * @default '0'
5544
+ */
5545
+ minInlineSize?: SizeUnits;
5004
5546
  /**
5005
5547
  * Adjust the padding of all edges.
5006
5548
  *
@@ -5029,7 +5571,7 @@ interface ScrollBox {
5029
5571
  * This overrides the block value of `padding`.
5030
5572
  * @default '' - meaning no override
5031
5573
  */
5032
- paddingBlock?: MaybeTwoValuesShorthandProperty<'' | PaddingKeyword>;
5574
+ paddingBlock?: '' | MaybeTwoValuesShorthandProperty<PaddingKeyword>;
5033
5575
  /**
5034
5576
  * Adjust the block-start padding.
5035
5577
  *
@@ -5052,7 +5594,7 @@ interface ScrollBox {
5052
5594
  * This overrides the inline value of `padding`.
5053
5595
  * @default '' - meaning no override
5054
5596
  */
5055
- paddingInline?: MaybeTwoValuesShorthandProperty<'' | PaddingKeyword>;
5597
+ paddingInline?: '' | MaybeTwoValuesShorthandProperty<PaddingKeyword>;
5056
5598
  /**
5057
5599
  * Adjust the inline-start padding.
5058
5600
  *
@@ -5069,52 +5611,22 @@ interface ScrollBox {
5069
5611
  paddingInlineEnd?: '' | PaddingKeyword;
5070
5612
  /** A unique identifier for the element. */
5071
5613
  id?: string;
5072
- /**
5073
- * Adjust the block size.
5074
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/block-size
5075
- * @default 'auto'
5076
- */
5077
- blockSize?: MaybeResponsive<SizeUnitsOrAuto>;
5078
- /**
5079
- * Adjust the minimum block size.
5080
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-block-size
5081
- * @default '0'
5082
- */
5083
- minBlockSize?: MaybeResponsive<SizeUnits>;
5084
- /**
5085
- * Adjust the maximum block size.
5086
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-block-size
5087
- * @default 'none'
5088
- */
5089
- maxBlockSize?: MaybeResponsive<SizeUnitsOrNone>;
5090
- /**
5091
- * Adjust the inline size.
5092
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/inline-size
5093
- * @default 'auto'
5094
- */
5095
- inlineSize?: MaybeResponsive<SizeUnitsOrAuto>;
5096
- /**
5097
- * Adjust the minimum inline size.
5098
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-inline-size
5099
- * @default '0'
5100
- */
5101
- minInlineSize?: MaybeResponsive<SizeUnits>;
5102
- /**
5103
- * Adjust the maximum inline size.
5104
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-inline-size
5105
- * @default 'none'
5106
- */
5107
- maxInlineSize?: MaybeResponsive<SizeUnitsOrNone>;
5108
5614
  }
5109
5615
 
5110
5616
  interface SearchFieldEvents {
5111
- focus?: (event: CallbackEvent<typeof tagName$g>) => void;
5112
- blur?: (event: CallbackEvent<typeof tagName$g>) => void;
5617
+ /** Callback when the user changes the value in the field. */
5113
5618
  input?: (event: CallbackEvent<typeof tagName$g>) => void;
5619
+ /** Callback when the field loses focus after the user changes the value in the field. */
5114
5620
  change?: (event: CallbackEvent<typeof tagName$g>) => void;
5621
+ /** Callback when the field loses focus. */
5622
+ blur?: (event: CallbackEvent<typeof tagName$g>) => void;
5623
+ /** Callback when the field is focused. */
5624
+ focus?: (event: CallbackEvent<typeof tagName$g>) => void;
5115
5625
  }
5116
5626
 
5117
5627
  interface SearchField {
5628
+ /** A unique identifier for the element. */
5629
+ id?: string;
5118
5630
  /**
5119
5631
  * Disables the field, disallowing any interaction.
5120
5632
  * @default false
@@ -5127,17 +5639,19 @@ interface SearchField {
5127
5639
  }
5128
5640
 
5129
5641
  interface SectionSlots {
5642
+ /** Button element to display in the section heading. A single button is supported. */
5130
5643
  'secondary-actions'?: HTMLElement;
5131
5644
  }
5132
5645
 
5133
5646
  interface Section {
5134
5647
  /**
5135
- * Adds title text displayed at the top left of the section
5648
+ * A title that describes the content of the section.
5136
5649
  *
5137
- * **Mobile surfaces:** Uses the standard POS Design System heading style for a section (not h2).
5138
- * @default undefined
5650
+ * If omitted, and no secondaryActions are provided, the section will be rendered without a header.
5139
5651
  */
5140
5652
  heading?: string;
5653
+ /** A unique identifier for the element. */
5654
+ id?: string;
5141
5655
  }
5142
5656
 
5143
5657
  interface Stack {
@@ -5213,92 +5727,94 @@ interface Stack {
5213
5727
  * @see ://developer.mozilla.org/en-US/docs/Web/CSS/block-size
5214
5728
  * @default 'auto'
5215
5729
  */
5216
- blockSize?: MaybeResponsive<SizeUnitsOrAuto>;
5730
+ blockSize?: SizeUnitsOrAuto;
5217
5731
  /**
5218
5732
  * Adjust the maximum block size.
5219
5733
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
5220
5734
  * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-block-size
5221
5735
  * @default 'none'
5222
5736
  */
5223
- maxBlockSize?: MaybeResponsive<SizeUnitsOrNone>;
5737
+ maxBlockSize?: SizeUnitsOrNone;
5224
5738
  /**
5225
5739
  * Adjust the maximum inline size.
5226
5740
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
5227
5741
  * @see ://developer.mozilla.org/en-US/docs/Web/CSS/max-inline-size
5228
5742
  * @default 'none'
5229
5743
  */
5230
- maxInlineSize?: MaybeResponsive<SizeUnitsOrNone>;
5744
+ maxInlineSize?: SizeUnitsOrNone;
5231
5745
  /**
5232
5746
  * Adjust the minimum block size.
5233
5747
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
5234
5748
  * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-block-size
5235
5749
  * @default '0'
5236
5750
  */
5237
- minBlockSize?: MaybeResponsive<SizeUnits>;
5751
+ minBlockSize?: SizeUnits;
5238
5752
  /**
5239
5753
  * Adjust the minimum inline size.
5240
5754
  * **Mobile surfaces:** Avoid using percentage-based sizes. They do not behave as expected when placed within a scrollable container.
5241
5755
  * @see ://developer.mozilla.org/en-US/docs/Web/CSS/min-inline-size
5242
5756
  * @default '0'
5243
5757
  */
5244
- minInlineSize?: MaybeResponsive<SizeUnits>;
5245
- /**
5246
- * Aligns the Stack's children along the cross axis.
5247
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/align-items
5248
- * @default 'normal'
5249
- */
5250
- alignItems?: MaybeResponsive<AlignItemsKeyword>;
5251
- /**
5252
- * Aligns the Stack along the cross axis.
5253
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/align-content
5254
- * @default 'normal'
5255
- */
5256
- alignContent?: MaybeResponsive<AlignContentKeyword>;
5758
+ minInlineSize?: SizeUnits;
5759
+ /** Aligns the Stack's children along the cross axis. */
5760
+ alignItems?: AlignItemsKeyword;
5761
+ /** Aligns the Stack along the cross axis. */
5762
+ alignContent?: AlignContentKeyword;
5257
5763
  /**
5258
5764
  * Adjust spacing between elements.
5259
- *
5260
- * A single value applies to both axes.
5261
- * A pair of values (eg `large-100 large-500`) can be used to set the inline and block axes respectively.
5765
+ * A single value applies to both axes. A pair of values (eg large-100 large-500) can be used to set the inline and block axes respectively.
5262
5766
  * @default 'none'
5263
5767
  */
5264
- gap?: MaybeResponsive<MaybeTwoValuesShorthandProperty<SpacingKeyword>>;
5768
+ gap?: MaybeTwoValuesShorthandProperty<SpacingKeyword>;
5265
5769
  /**
5266
- * Adjust spacing between elements in the inline axis.
5267
- *
5268
- * This overrides the column value of `gap`.
5770
+ * Adjust spacing between elements in the inline axis. This overrides the column value of gap.
5269
5771
  * @default '' - meaning no override
5270
5772
  */
5271
- columnGap?: MaybeResponsive<'' | SpacingKeyword>;
5773
+ columnGap?: '' | SpacingKeyword;
5272
5774
  /**
5273
- * Sets how the children are placed within the Stack. This uses [logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
5775
+ * Sets how the children are placed within the Stack. This uses logical properties.
5274
5776
  * @default 'block'
5275
- * @implementation the content will wrap if the direction is 'inline', and not wrap if the direction is 'block'
5777
+ * @implementation - the content will wrap if the direction is 'inline', and not wrap if the direction is 'block'
5276
5778
  */
5277
- direction?: MaybeResponsive<'block' | 'inline'>;
5779
+ direction?: 'block' | 'inline';
5278
5780
  /**
5279
5781
  * Adjust the inline size.
5280
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/inline-size
5782
+ * @see — https://developer.mozilla.org/en-US/docs/Web/CSS/inline-size
5281
5783
  * @default 'auto'
5282
5784
  */
5283
- inlineSize?: MaybeResponsive<SizeUnitsOrAuto>;
5785
+ inlineSize?: SizeUnitsOrAuto;
5284
5786
  /**
5285
5787
  * Aligns the Stack along the main axis.
5286
- * @see ://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
5788
+ * @see — https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
5287
5789
  * @default 'normal'
5288
5790
  */
5289
- justifyContent?: MaybeResponsive<JustifyContentKeyword>;
5791
+ justifyContent?: JustifyContentKeyword;
5290
5792
  /**
5291
- * Adjust spacing between elements in the block axis.
5292
- *
5293
- * This overrides the row value of `gap`.
5793
+ * Adjust spacing between elements in the block axis. This overrides the row value of gap.
5294
5794
  * @default '' - meaning no override
5295
5795
  */
5296
- rowGap?: MaybeResponsive<'' | SpacingKeyword>;
5796
+ rowGap?: '' | SpacingKeyword;
5797
+ /** A unique identifier for the element. */
5798
+ id?: string;
5297
5799
  }
5298
5800
 
5299
5801
  interface Text {
5300
- color?: 'subdued' | 'base' | 'strong';
5802
+ /**
5803
+ * Modify the color to be more or less intense.
5804
+ * @default 'base'
5805
+ */
5806
+ color?: ColorKeyword;
5807
+ /**
5808
+ * Provide semantic meaning and default styling to the text.
5809
+ *
5810
+ * Other presentation properties on Text override the default styling.
5811
+ * @default 'generic'
5812
+ */
5301
5813
  type?: 'strong' | 'small' | 'generic';
5814
+ /**
5815
+ * Sets the tone of the component, based on the intention of the information being conveyed.
5816
+ * @default 'auto'
5817
+ */
5302
5818
  tone?:
5303
5819
  | 'auto'
5304
5820
  | 'neutral'
@@ -5307,20 +5823,29 @@ interface Text {
5307
5823
  | 'caution'
5308
5824
  | 'warning'
5309
5825
  | 'critical';
5826
+ /** A unique identifier for the element. */
5827
+ id?: string;
5310
5828
  }
5311
5829
 
5312
5830
  interface TextAreaEvents {
5831
+ /** Callback when the user makes any changes in the field. */
5313
5832
  input?: (event: CallbackEvent<typeof tagName$d>) => void;
5314
- focus?: (event: CallbackEvent<typeof tagName$d>) => void;
5315
- blur?: (event: CallbackEvent<typeof tagName$d>) => void;
5833
+ /** Callback after editing completes (typically on blur). */
5316
5834
  change?: (event: CallbackEvent<typeof tagName$d>) => void;
5835
+ /** Callback when the element loses focus. */
5836
+ blur?: (event: CallbackEvent<typeof tagName$d>) => void;
5837
+ /** Callback when the element receives focus. */
5838
+ focus?: (event: CallbackEvent<typeof tagName$d>) => void;
5317
5839
  }
5318
5840
 
5319
5841
  interface TextAreaSlots {
5842
+ /** Additional content to be displayed in the field. Commonly used to display clickable text. */
5320
5843
  accessory?: HTMLElement;
5321
5844
  }
5322
5845
 
5323
5846
  interface TextArea {
5847
+ /** A unique identifier for the element. */
5848
+ id?: string;
5324
5849
  /** Content to use as the field label. */
5325
5850
  label?: string;
5326
5851
  /**
@@ -5366,17 +5891,24 @@ interface TextArea {
5366
5891
  }
5367
5892
 
5368
5893
  interface TextFieldEvents {
5894
+ /** Callback when the user makes any changes in the field. */
5369
5895
  input?: (event: CallbackEvent<typeof tagName$h>) => void;
5370
- focus?: (event: CallbackEvent<typeof tagName$h>) => void;
5371
- blur?: (event: CallbackEvent<typeof tagName$h>) => void;
5896
+ /** Callback after editing completes (typically on blur). */
5372
5897
  change?: (event: CallbackEvent<typeof tagName$h>) => void;
5898
+ /** Callback when the element loses focus. */
5899
+ blur?: (event: CallbackEvent<typeof tagName$h>) => void;
5900
+ /** Callback when the element receives focus. */
5901
+ focus?: (event: CallbackEvent<typeof tagName$h>) => void;
5373
5902
  }
5374
5903
 
5375
5904
  interface TextFieldSlots {
5905
+ /** Additional content to be displayed in the field. Commonly used to display clickable text. */
5376
5906
  accessory?: HTMLElement;
5377
5907
  }
5378
5908
 
5379
5909
  interface TextField {
5910
+ /** A unique identifier for the element. */
5911
+ id?: string;
5380
5912
  /** Content to use as the field label. */
5381
5913
  label?: string;
5382
5914
  /**
@@ -5417,12 +5949,13 @@ interface TextField {
5417
5949
  }
5418
5950
 
5419
5951
  interface TileEvents {
5952
+ /** Callback when the Tile is activated. */
5420
5953
  click?: (event: CallbackEvent<typeof tagName$q>) => void;
5421
5954
  }
5422
5955
 
5423
5956
  interface Tile {
5424
5957
  /**
5425
- * Disables the Button meaning it cannot be clicked or receive focus.
5958
+ * Disables the Tile meaning it cannot be clicked or receive focus.
5426
5959
  * @default false
5427
5960
  */
5428
5961
  disabled?: boolean;
@@ -5453,10 +5986,14 @@ interface Tile {
5453
5986
  }
5454
5987
 
5455
5988
  interface TimeFieldEvents {
5456
- blur?: (event: CallbackEvent<typeof tagName$3>) => void | null;
5457
- focus?: (event: CallbackEvent<typeof tagName$3>) => void | null;
5458
- input?: (event: CallbackEvent<typeof tagName$3>) => void | null;
5459
- change?: (event: CallbackEvent<typeof tagName$3>) => void | null;
5989
+ /** Callback when the user makes any changes in the field. */
5990
+ input?: (event: CallbackEvent<typeof tagName$3>) => void;
5991
+ /** Callback after editing completes (typically on blur). */
5992
+ change?: (event: CallbackEvent<typeof tagName$3>) => void;
5993
+ /** Callback when the element loses focus. */
5994
+ blur?: (event: CallbackEvent<typeof tagName$3>) => void;
5995
+ /** Callback when the element receives focus. */
5996
+ focus?: (event: CallbackEvent<typeof tagName$3>) => void;
5460
5997
  }
5461
5998
 
5462
5999
  interface TimeField {
@@ -5500,10 +6037,14 @@ interface TimeField {
5500
6037
  }
5501
6038
 
5502
6039
  interface TimePickerEvents {
6040
+ /** Callback when the user selects a time from the picker. */
6041
+ input?: (event: CallbackEvent<typeof tagName$6>) => void | null;
6042
+ /** Callback when the user selects a time from the picker that is different to the current value. */
6043
+ change?: (event: CallbackEvent<typeof tagName$6>) => void | null;
6044
+ /** Callback when the time picker is dismissed. */
5503
6045
  blur?: (event: CallbackEvent<typeof tagName$6>) => void | null;
6046
+ /** Callback when the time picker is revealed. */
5504
6047
  focus?: (event: CallbackEvent<typeof tagName$6>) => void | null;
5505
- change?: (event: CallbackEvent<typeof tagName$6>) => void | null;
5506
- input?: (event: CallbackEvent<typeof tagName$6>) => void | null;
5507
6048
  }
5508
6049
 
5509
6050
  interface TimePicker {
@@ -5531,476 +6072,420 @@ interface TimePicker {
5531
6072
  declare module 'react' {
5532
6073
  namespace JSX {
5533
6074
  interface IntrinsicElements {
5534
- [tagName$t]: ButtonJSXProps &
5535
- BaseElementPropsWithChildren<ButtonJSXProps>;
6075
+ [tagName$t]: IntrinsicElementProps<ButtonJSXProps>;
5536
6076
  }
5537
6077
  }
5538
6078
  }
5539
6079
  declare global {
5540
6080
  namespace JSX {
5541
6081
  interface IntrinsicElements {
5542
- [tagName$t]: ButtonJSXProps &
5543
- BaseElementPropsWithChildren<ButtonJSXProps>;
6082
+ [tagName$t]: IntrinsicElementProps<ButtonJSXProps>;
5544
6083
  }
5545
6084
  }
5546
6085
  }
5547
6086
  declare module 'react' {
5548
6087
  namespace JSX {
5549
6088
  interface IntrinsicElements {
5550
- [tagName$s]: TextJSXProps & BaseElementPropsWithChildren<TextJSXProps>;
6089
+ [tagName$s]: IntrinsicElementProps<TextJSXProps>;
5551
6090
  }
5552
6091
  }
5553
6092
  }
5554
6093
  declare global {
5555
6094
  namespace JSX {
5556
6095
  interface IntrinsicElements {
5557
- [tagName$s]: TextJSXProps & BaseElementPropsWithChildren<TextJSXProps>;
6096
+ [tagName$s]: IntrinsicElementProps<TextJSXProps>;
5558
6097
  }
5559
6098
  }
5560
6099
  }
5561
6100
  declare module 'react' {
5562
6101
  namespace JSX {
5563
6102
  interface IntrinsicElements {
5564
- [tagName$r]: ScrollBoxJSXProps &
5565
- BaseElementPropsWithChildren<ScrollBoxJSXProps>;
6103
+ [tagName$r]: IntrinsicElementProps<ScrollBoxJSXProps>;
5566
6104
  }
5567
6105
  }
5568
6106
  }
5569
6107
  declare global {
5570
6108
  namespace JSX {
5571
6109
  interface IntrinsicElements {
5572
- [tagName$r]: ScrollBoxJSXProps &
5573
- BaseElementPropsWithChildren<ScrollBoxJSXProps>;
6110
+ [tagName$r]: IntrinsicElementProps<ScrollBoxJSXProps>;
5574
6111
  }
5575
6112
  }
5576
6113
  }
5577
6114
  declare module 'react' {
5578
6115
  namespace JSX {
5579
6116
  interface IntrinsicElements {
5580
- [tagName$q]: TileJSXProps & BaseElementPropsWithChildren<TileJSXProps>;
6117
+ [tagName$q]: IntrinsicElementProps<TileJSXProps>;
5581
6118
  }
5582
6119
  }
5583
6120
  }
5584
6121
  declare global {
5585
6122
  namespace JSX {
5586
6123
  interface IntrinsicElements {
5587
- [tagName$q]: TileJSXProps & BaseElementPropsWithChildren<TileJSXProps>;
6124
+ [tagName$q]: IntrinsicElementProps<TileJSXProps>;
5588
6125
  }
5589
6126
  }
5590
6127
  }
5591
6128
  declare module 'react' {
5592
6129
  namespace JSX {
5593
6130
  interface IntrinsicElements {
5594
- [tagName$p]: Omit<BannerJSXProps, 'primaryAction'> &
5595
- BaseElementPropsWithChildren<Omit<BannerJSXProps, 'primaryAction'>>;
6131
+ [tagName$p]: IntrinsicElementProps<ElementProps$9>;
5596
6132
  }
5597
6133
  }
5598
6134
  }
5599
6135
  declare global {
5600
6136
  namespace JSX {
5601
6137
  interface IntrinsicElements {
5602
- [tagName$p]: Omit<BannerJSXProps, 'primaryAction'> &
5603
- BaseElementPropsWithChildren<Omit<BannerJSXProps, 'primaryAction'>>;
6138
+ [tagName$p]: IntrinsicElementProps<ElementProps$9>;
5604
6139
  }
5605
6140
  }
5606
6141
  }
5607
6142
  declare module 'react' {
5608
6143
  namespace JSX {
5609
6144
  interface IntrinsicElements {
5610
- [tagName$o]: BoxJSXProps & BaseElementPropsWithChildren<BoxJSXProps>;
6145
+ [tagName$o]: IntrinsicElementProps<BoxJSXProps>;
5611
6146
  }
5612
6147
  }
5613
6148
  }
5614
6149
  declare global {
5615
6150
  namespace JSX {
5616
6151
  interface IntrinsicElements {
5617
- [tagName$o]: BoxJSXProps & BaseElementPropsWithChildren<BoxJSXProps>;
6152
+ [tagName$o]: IntrinsicElementProps<BoxJSXProps>;
5618
6153
  }
5619
6154
  }
5620
6155
  }
5621
6156
  declare module 'react' {
5622
6157
  namespace JSX {
5623
6158
  interface IntrinsicElements {
5624
- [tagName$n]: IconJSXProps & BaseElementProps<IconJSXProps>;
6159
+ [tagName$n]: IntrinsicElementProps<IconJSXProps>;
5625
6160
  }
5626
6161
  }
5627
6162
  }
5628
6163
  declare global {
5629
6164
  namespace JSX {
5630
6165
  interface IntrinsicElements {
5631
- [tagName$n]: IconJSXProps & BaseElementProps<IconJSXProps>;
6166
+ [tagName$n]: IntrinsicElementProps<IconJSXProps>;
5632
6167
  }
5633
6168
  }
5634
6169
  }
5635
6170
  declare module 'react' {
5636
6171
  namespace JSX {
5637
6172
  interface IntrinsicElements {
5638
- [tagName$m]: StackJSXProps & BaseElementPropsWithChildren<StackJSXProps>;
6173
+ [tagName$m]: IntrinsicElementProps<StackJSXProps>;
5639
6174
  }
5640
6175
  }
5641
6176
  }
5642
6177
  declare global {
5643
6178
  namespace JSX {
5644
6179
  interface IntrinsicElements {
5645
- [tagName$m]: StackJSXProps & BaseElementPropsWithChildren<StackJSXProps>;
6180
+ [tagName$m]: IntrinsicElementProps<StackJSXProps>;
5646
6181
  }
5647
6182
  }
5648
6183
  }
5649
6184
  declare module 'react' {
5650
6185
  namespace JSX {
5651
6186
  interface IntrinsicElements {
5652
- [tagName$l]: BadgeJSXProps & BaseElementPropsWithChildren<BadgeJSXProps>;
6187
+ [tagName$l]: IntrinsicElementProps<BadgeJSXProps>;
5653
6188
  }
5654
6189
  }
5655
6190
  }
5656
6191
  declare global {
5657
6192
  namespace JSX {
5658
6193
  interface IntrinsicElements {
5659
- [tagName$l]: BadgeJSXProps & BaseElementPropsWithChildren<BadgeJSXProps>;
6194
+ [tagName$l]: IntrinsicElementProps<BadgeJSXProps>;
5660
6195
  }
5661
6196
  }
5662
6197
  }
5663
6198
  declare module 'react' {
5664
6199
  namespace JSX {
5665
6200
  interface IntrinsicElements {
5666
- [tagName$k]: ChoiceListJSXProps &
5667
- BaseElementPropsWithChildren<ChoiceListJSXProps>;
6201
+ [tagName$k]: IntrinsicElementProps<ChoiceListJSXProps>;
5668
6202
  }
5669
6203
  }
5670
6204
  }
5671
6205
  declare global {
5672
6206
  namespace JSX {
5673
6207
  interface IntrinsicElements {
5674
- [tagName$k]: ChoiceListJSXProps &
5675
- BaseElementPropsWithChildren<ChoiceListJSXProps>;
6208
+ [tagName$k]: IntrinsicElementProps<ChoiceListJSXProps>;
5676
6209
  }
5677
6210
  }
5678
6211
  }
5679
6212
  declare module 'react' {
5680
6213
  namespace JSX {
5681
6214
  interface IntrinsicElements {
5682
- [tagName$j]: ChoiceJSXProps &
5683
- BaseElementPropsWithChildren<ChoiceJSXProps>;
6215
+ [tagName$j]: IntrinsicElementProps<ChoiceJSXProps>;
5684
6216
  }
5685
6217
  }
5686
6218
  }
5687
6219
  declare global {
5688
6220
  namespace JSX {
5689
6221
  interface IntrinsicElements {
5690
- [tagName$j]: ChoiceJSXProps &
5691
- BaseElementPropsWithChildren<ChoiceJSXProps>;
6222
+ [tagName$j]: IntrinsicElementProps<ChoiceJSXProps>;
5692
6223
  }
5693
6224
  }
5694
6225
  }
5695
6226
  declare module 'react' {
5696
6227
  namespace JSX {
5697
6228
  interface IntrinsicElements {
5698
- [tagName$i]: Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'> &
5699
- BaseElementPropsWithChildren<
5700
- Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'>
5701
- >;
6229
+ [tagName$i]: IntrinsicElementProps<ElementProps$8>;
5702
6230
  }
5703
6231
  }
5704
6232
  }
5705
6233
  declare global {
5706
6234
  namespace JSX {
5707
6235
  interface IntrinsicElements {
5708
- [tagName$i]: Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'> &
5709
- BaseElementPropsWithChildren<
5710
- Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'>
5711
- >;
6236
+ [tagName$i]: IntrinsicElementProps<ElementProps$8>;
5712
6237
  }
5713
6238
  }
5714
6239
  }
5715
6240
  declare module 'react' {
5716
6241
  namespace JSX {
5717
6242
  interface IntrinsicElements {
5718
- [tagName$h]: Omit<TextFieldJSXProps, 'accessory'> &
5719
- BaseElementPropsWithChildren<Omit<TextFieldJSXProps, 'accessory'>>;
6243
+ [tagName$h]: IntrinsicElementProps<ElementProps$7>;
5720
6244
  }
5721
6245
  }
5722
6246
  }
5723
6247
  declare global {
5724
6248
  namespace JSX {
5725
6249
  interface IntrinsicElements {
5726
- [tagName$h]: Omit<TextFieldJSXProps, 'accessory'> &
5727
- BaseElementPropsWithChildren<Omit<TextFieldJSXProps, 'accessory'>>;
6250
+ [tagName$h]: IntrinsicElementProps<ElementProps$7>;
5728
6251
  }
5729
6252
  }
5730
6253
  }
5731
6254
  declare module 'react' {
5732
6255
  namespace JSX {
5733
6256
  interface IntrinsicElements {
5734
- [tagName$g]: SearchFieldJSXProps &
5735
- BaseElementPropsWithChildren<SearchFieldJSXProps>;
6257
+ [tagName$g]: IntrinsicElementProps<SearchFieldJSXProps>;
5736
6258
  }
5737
6259
  }
5738
6260
  }
5739
6261
  declare global {
5740
6262
  namespace JSX {
5741
6263
  interface IntrinsicElements {
5742
- [tagName$g]: SearchFieldJSXProps &
5743
- BaseElementPropsWithChildren<SearchFieldJSXProps>;
6264
+ [tagName$g]: IntrinsicElementProps<SearchFieldJSXProps>;
5744
6265
  }
5745
6266
  }
5746
6267
  }
5747
6268
  declare module 'react' {
5748
6269
  namespace JSX {
5749
6270
  interface IntrinsicElements {
5750
- [tagName$f]: Omit<EmailFieldJSXProps, 'accessory'> &
5751
- BaseElementPropsWithChildren<Omit<EmailFieldJSXProps, 'accessory'>>;
6271
+ [tagName$f]: IntrinsicElementProps<ElementProps$6>;
5752
6272
  }
5753
6273
  }
5754
6274
  }
5755
6275
  declare global {
5756
6276
  namespace JSX {
5757
6277
  interface IntrinsicElements {
5758
- [tagName$f]: Omit<EmailFieldJSXProps, 'accessory'> &
5759
- BaseElementPropsWithChildren<Omit<EmailFieldJSXProps, 'accessory'>>;
6278
+ [tagName$f]: IntrinsicElementProps<ElementProps$6>;
5760
6279
  }
5761
6280
  }
5762
6281
  }
5763
6282
  declare module 'react' {
5764
6283
  namespace JSX {
5765
6284
  interface IntrinsicElements {
5766
- [tagName$e]: ClickableJSXProps &
5767
- BaseElementPropsWithChildren<ClickableJSXProps>;
6285
+ [tagName$e]: IntrinsicElementProps<ClickableJSXProps>;
5768
6286
  }
5769
6287
  }
5770
6288
  }
5771
6289
  declare global {
5772
6290
  namespace JSX {
5773
6291
  interface IntrinsicElements {
5774
- [tagName$e]: ClickableJSXProps &
5775
- BaseElementPropsWithChildren<ClickableJSXProps>;
6292
+ [tagName$e]: IntrinsicElementProps<ClickableJSXProps>;
5776
6293
  }
5777
6294
  }
5778
6295
  }
5779
6296
  declare module 'react' {
5780
6297
  namespace JSX {
5781
6298
  interface IntrinsicElements {
5782
- [tagName$d]: Omit<TextAreaJSXProps, 'accessory'> &
5783
- BaseElementPropsWithChildren<Omit<TextAreaJSXProps, 'accessory'>>;
6299
+ [tagName$d]: IntrinsicElementProps<ElementProps$5>;
5784
6300
  }
5785
6301
  }
5786
6302
  }
5787
6303
  declare global {
5788
6304
  namespace JSX {
5789
6305
  interface IntrinsicElements {
5790
- [tagName$d]: Omit<TextAreaJSXProps, 'accessory'> &
5791
- BaseElementPropsWithChildren<Omit<TextAreaJSXProps, 'accessory'>>;
6306
+ [tagName$d]: IntrinsicElementProps<ElementProps$5>;
5792
6307
  }
5793
6308
  }
5794
6309
  }
5795
6310
  declare module 'react' {
5796
6311
  namespace JSX {
5797
6312
  interface IntrinsicElements {
5798
- [tagName$c]: Omit<NumberFieldJSXProps, 'accessory'> &
5799
- BaseElementPropsWithChildren<Omit<NumberFieldJSXProps, 'accessory'>>;
6313
+ [tagName$c]: IntrinsicElementProps<ElementProps$4>;
5800
6314
  }
5801
6315
  }
5802
6316
  }
5803
6317
  declare global {
5804
6318
  namespace JSX {
5805
6319
  interface IntrinsicElements {
5806
- [tagName$c]: Omit<NumberFieldJSXProps, 'accessory'> &
5807
- BaseElementPropsWithChildren<Omit<NumberFieldJSXProps, 'accessory'>>;
6320
+ [tagName$c]: IntrinsicElementProps<ElementProps$4>;
5808
6321
  }
5809
6322
  }
5810
6323
  }
5811
6324
  declare module 'react' {
5812
6325
  namespace JSX {
5813
6326
  interface IntrinsicElements {
5814
- [tagName$b]: Omit<DateFieldJSXProps, 'accessory'> &
5815
- BaseElementPropsWithChildren<Omit<DateFieldJSXProps, 'accessory'>>;
6327
+ [tagName$b]: IntrinsicElementProps<ElementProps$3>;
5816
6328
  }
5817
6329
  }
5818
6330
  }
5819
6331
  declare global {
5820
6332
  namespace JSX {
5821
6333
  interface IntrinsicElements {
5822
- [tagName$b]: Omit<DateFieldJSXProps, 'accessory'> &
5823
- BaseElementPropsWithChildren<Omit<DateFieldJSXProps, 'accessory'>>;
6334
+ [tagName$b]: IntrinsicElementProps<ElementProps$3>;
5824
6335
  }
5825
6336
  }
5826
6337
  }
5827
6338
  declare module 'react' {
5828
6339
  namespace JSX {
5829
6340
  interface IntrinsicElements {
5830
- [tagName$a]: DatePickerJSXProps &
5831
- BaseElementPropsWithChildren<DatePickerJSXProps>;
6341
+ [tagName$a]: IntrinsicElementProps<DatePickerJSXProps>;
5832
6342
  }
5833
6343
  }
5834
6344
  }
5835
6345
  declare global {
5836
6346
  namespace JSX {
5837
6347
  interface IntrinsicElements {
5838
- [tagName$a]: DatePickerJSXProps &
5839
- BaseElementPropsWithChildren<DatePickerJSXProps>;
6348
+ [tagName$a]: IntrinsicElementProps<DatePickerJSXProps>;
5840
6349
  }
5841
6350
  }
5842
6351
  }
5843
6352
  declare module 'react' {
5844
6353
  namespace JSX {
5845
6354
  interface IntrinsicElements {
5846
- [tagName$9]: DateSpinnerJSXProps &
5847
- BaseElementPropsWithChildren<DateSpinnerJSXProps>;
6355
+ [tagName$9]: IntrinsicElementProps<DateSpinnerJSXProps>;
5848
6356
  }
5849
6357
  }
5850
6358
  }
5851
6359
  declare global {
5852
6360
  namespace JSX {
5853
6361
  interface IntrinsicElements {
5854
- [tagName$9]: DateSpinnerJSXProps &
5855
- BaseElementPropsWithChildren<DateSpinnerJSXProps>;
6362
+ [tagName$9]: IntrinsicElementProps<DateSpinnerJSXProps>;
5856
6363
  }
5857
6364
  }
5858
6365
  }
5859
6366
  declare module 'react' {
5860
6367
  namespace JSX {
5861
6368
  interface IntrinsicElements {
5862
- [tagName$8]: Omit<SectionJSXProps, 'secondaryActions'> &
5863
- BaseElementPropsWithChildren<Omit<SectionJSXProps, 'secondaryActions'>>;
6369
+ [tagName$8]: IntrinsicElementProps<ElementProps$2>;
5864
6370
  }
5865
6371
  }
5866
6372
  }
5867
6373
  declare global {
5868
6374
  namespace JSX {
5869
6375
  interface IntrinsicElements {
5870
- [tagName$8]: Omit<SectionJSXProps, 'secondaryActions'> &
5871
- BaseElementPropsWithChildren<Omit<SectionJSXProps, 'secondaryActions'>>;
6376
+ [tagName$8]: IntrinsicElementProps<ElementProps$2>;
5872
6377
  }
5873
6378
  }
5874
6379
  }
5875
6380
  declare module 'react' {
5876
6381
  namespace JSX {
5877
6382
  interface IntrinsicElements {
5878
- [tagName$7]: HeadingJSXProps &
5879
- BaseElementPropsWithChildren<HeadingJSXProps>;
6383
+ [tagName$7]: IntrinsicElementProps<HeadingJSXProps>;
5880
6384
  }
5881
6385
  }
5882
6386
  }
5883
6387
  declare global {
5884
6388
  namespace JSX {
5885
6389
  interface IntrinsicElements {
5886
- [tagName$7]: HeadingJSXProps &
5887
- BaseElementPropsWithChildren<HeadingJSXProps>;
6390
+ [tagName$7]: IntrinsicElementProps<HeadingJSXProps>;
5888
6391
  }
5889
6392
  }
5890
6393
  }
5891
6394
  declare module 'react' {
5892
6395
  namespace JSX {
5893
6396
  interface IntrinsicElements {
5894
- [tagName$6]: TimePickerJSXProps &
5895
- BaseElementPropsWithChildren<TimePickerJSXProps>;
6397
+ [tagName$6]: IntrinsicElementProps<TimePickerJSXProps>;
5896
6398
  }
5897
6399
  }
5898
6400
  }
5899
6401
  declare global {
5900
6402
  namespace JSX {
5901
6403
  interface IntrinsicElements {
5902
- [tagName$6]: TimePickerJSXProps &
5903
- BaseElementPropsWithChildren<TimePickerJSXProps>;
6404
+ [tagName$6]: IntrinsicElementProps<TimePickerJSXProps>;
5904
6405
  }
5905
6406
  }
5906
6407
  }
5907
6408
  declare module 'react' {
5908
6409
  namespace JSX {
5909
6410
  interface IntrinsicElements {
5910
- [tagName$5]: ImageJSXProps & BaseElementPropsWithChildren<ImageJSXProps>;
6411
+ [tagName$5]: IntrinsicElementProps<ImageJSXProps>;
5911
6412
  }
5912
6413
  }
5913
6414
  }
5914
6415
  declare global {
5915
6416
  namespace JSX {
5916
6417
  interface IntrinsicElements {
5917
- [tagName$5]: ImageJSXProps & BaseElementPropsWithChildren<ImageJSXProps>;
6418
+ [tagName$5]: IntrinsicElementProps<ImageJSXProps>;
5918
6419
  }
5919
6420
  }
5920
6421
  }
5921
6422
  declare module 'react' {
5922
6423
  namespace JSX {
5923
6424
  interface IntrinsicElements {
5924
- [tagName$4]: Omit<PageJSXProps, 'secondaryActions' | 'aside'> &
5925
- BaseElementPropsWithChildren<
5926
- Omit<PageJSXProps, 'secondaryActions' | 'aside'>
5927
- >;
6425
+ [tagName$4]: IntrinsicElementProps<ElementProps$1>;
5928
6426
  }
5929
6427
  }
5930
6428
  }
5931
6429
  declare global {
5932
6430
  namespace JSX {
5933
6431
  interface IntrinsicElements {
5934
- [tagName$4]: Omit<PageJSXProps, 'secondaryActions' | 'aside'> &
5935
- BaseElementPropsWithChildren<
5936
- Omit<PageJSXProps, 'secondaryActions' | 'aside'>
5937
- >;
6432
+ [tagName$4]: IntrinsicElementProps<ElementProps$1>;
5938
6433
  }
5939
6434
  }
5940
6435
  }
5941
6436
  declare module 'react' {
5942
6437
  namespace JSX {
5943
6438
  interface IntrinsicElements {
5944
- [tagName$3]: TimeFieldJSXProps &
5945
- BaseElementPropsWithChildren<TimeFieldJSXProps>;
6439
+ [tagName$3]: IntrinsicElementProps<TimeFieldJSXProps>;
5946
6440
  }
5947
6441
  }
5948
6442
  }
5949
6443
  declare global {
5950
6444
  namespace JSX {
5951
6445
  interface IntrinsicElements {
5952
- [tagName$3]: TimeFieldJSXProps &
5953
- BaseElementPropsWithChildren<TimeFieldJSXProps>;
6446
+ [tagName$3]: IntrinsicElementProps<TimeFieldJSXProps>;
5954
6447
  }
5955
6448
  }
5956
6449
  }
5957
6450
  declare module 'react' {
5958
6451
  namespace JSX {
5959
6452
  interface IntrinsicElements {
5960
- [tagName$2]: Omit<PosBlockJSXProps, 'secondaryActions'> &
5961
- BaseElementPropsWithChildren<
5962
- Omit<PosBlockJSXProps, 'secondaryActions'>
5963
- >;
6453
+ [tagName$2]: IntrinsicElementProps<ElementProps>;
5964
6454
  }
5965
6455
  }
5966
6456
  }
5967
6457
  declare global {
5968
6458
  namespace JSX {
5969
6459
  interface IntrinsicElements {
5970
- [tagName$2]: Omit<PosBlockJSXProps, 'secondaryActions'> &
5971
- BaseElementPropsWithChildren<
5972
- Omit<PosBlockJSXProps, 'secondaryActions'>
5973
- >;
6460
+ [tagName$2]: IntrinsicElementProps<ElementProps>;
5974
6461
  }
5975
6462
  }
5976
6463
  }
5977
6464
  declare module 'react' {
5978
6465
  namespace JSX {
5979
6466
  interface IntrinsicElements {
5980
- [tagName$1]: QrCodeJSXProps & BaseElementProps<QrCodeJSXProps>;
6467
+ [tagName$1]: IntrinsicElementProps<QrCodeJSXProps>;
5981
6468
  }
5982
6469
  }
5983
6470
  }
5984
6471
  declare global {
5985
6472
  namespace JSX {
5986
6473
  interface IntrinsicElements {
5987
- [tagName$1]: QrCodeJSXProps & BaseElementProps<QrCodeJSXProps>;
6474
+ [tagName$1]: IntrinsicElementProps<QrCodeJSXProps>;
5988
6475
  }
5989
6476
  }
5990
6477
  }
5991
6478
  declare module 'react' {
5992
6479
  namespace JSX {
5993
6480
  interface IntrinsicElements {
5994
- [tagName]: DividerJSXProps &
5995
- BaseElementPropsWithChildren<DividerJSXProps>;
6481
+ [tagName]: IntrinsicElementProps<DividerJSXProps>;
5996
6482
  }
5997
6483
  }
5998
6484
  }
5999
6485
  declare global {
6000
6486
  namespace JSX {
6001
6487
  interface IntrinsicElements {
6002
- [tagName]: DividerJSXProps &
6003
- BaseElementPropsWithChildren<DividerJSXProps>;
6488
+ [tagName]: IntrinsicElementProps<DividerJSXProps>;
6004
6489
  }
6005
6490
  }
6006
6491
  }