stripe-pwa-elements 3.2.0 → 4.0.1

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 (237) hide show
  1. package/dist/cjs/app-globals-V2Kpy_OQ.js +0 -3
  2. package/dist/cjs/error-FFC4kSs5.js +0 -3
  3. package/dist/cjs/{factory-CbbbSvkg.js → factory-Cd2VI_N2.js} +216 -77
  4. package/dist/cjs/{index-Ba1pBePA.js → index-CYbA1N_k.js} +24 -6
  5. package/dist/cjs/index-Dkb0SxZc.js +4694 -0
  6. package/dist/cjs/index.cjs.js +0 -1
  7. package/dist/cjs/ion-icon.cjs.entry.js +22 -13
  8. package/dist/cjs/loader.cjs.js +2 -3
  9. package/dist/cjs/stripe-address-element.cjs.entry.js +41 -26
  10. package/dist/cjs/stripe-card-element-modal.cjs.entry.js +6 -7
  11. package/dist/cjs/stripe-card-element_2.cjs.entry.js +129 -72
  12. package/dist/cjs/stripe-currency-selector.cjs.entry.js +20 -10
  13. package/dist/cjs/stripe-elements.cjs.js +31 -5
  14. package/dist/cjs/stripe-express-checkout-element.cjs.entry.js +32 -22
  15. package/dist/cjs/stripe-link-authentication-element.cjs.entry.js +20 -10
  16. package/dist/cjs/stripe-payment-element.cjs.entry.js +283 -167
  17. package/dist/cjs/stripe-payment-request-button.cjs.entry.js +30 -18
  18. package/dist/collection/collection-manifest.json +6 -5
  19. package/dist/collection/components/stripe-address-element/stripe-address-element.js +36 -21
  20. package/dist/collection/components/stripe-card-element/stripe-card-element.helpers.js +57 -0
  21. package/dist/collection/components/stripe-card-element/stripe-card-element.js +62 -68
  22. package/dist/collection/components/stripe-card-element-modal/stripe-card-element-modal.js +15 -11
  23. package/dist/collection/components/stripe-currency-selector/stripe-currency-selector.js +17 -6
  24. package/dist/collection/components/stripe-express-checkout-element/stripe-express-checkout-element.js +35 -20
  25. package/dist/collection/components/stripe-link-authentication-element/stripe-link-authentication-element.js +19 -7
  26. package/dist/collection/components/stripe-modal/stripe-modal.js +18 -7
  27. package/dist/collection/components/stripe-payment-element/stripe-payment-element.helpers.js +114 -0
  28. package/dist/collection/components/stripe-payment-element/stripe-payment-element.js +162 -162
  29. package/dist/collection/components/stripe-payment-request-button/stripe-payment-request-button.js +48 -19
  30. package/dist/collection/index.js +0 -1
  31. package/dist/collection/interfaces.js +0 -1
  32. package/dist/collection/services/address-element-manager.js +3 -4
  33. package/dist/collection/services/card-element-manager.js +3 -4
  34. package/dist/collection/services/currency-selector-element-manager.js +3 -4
  35. package/dist/collection/services/express-checkout-element-manager.js +9 -10
  36. package/dist/collection/services/factory.js +0 -1
  37. package/dist/collection/services/interfaces.js +0 -1
  38. package/dist/collection/services/link-authentication-element-manager.js +3 -4
  39. package/dist/collection/services/payment-element-manager.js +4 -5
  40. package/dist/collection/services/stripe-service.js +27 -10
  41. package/dist/collection/utils/element-finder.js +2 -3
  42. package/dist/collection/utils/error.js +0 -1
  43. package/dist/collection/utils/i18n.js +0 -1
  44. package/dist/collection/utils/platform.js +0 -1
  45. package/dist/collection/utils/test-setup.js +0 -1
  46. package/dist/collection/utils/utils.js +2 -3
  47. package/dist/components/error.js +1 -16
  48. package/dist/components/factory.js +1 -3736
  49. package/dist/components/icon.js +1 -459
  50. package/dist/components/index.d.ts +2 -0
  51. package/dist/components/index.js +1 -4
  52. package/dist/components/index2.js +1 -192
  53. package/dist/components/ion-icon.js +1 -9
  54. package/dist/components/stripe-address-element.js +1 -327
  55. package/dist/components/stripe-card-element-modal.js +1 -174
  56. package/dist/components/stripe-card-element.js +1 -9
  57. package/dist/components/stripe-card-element2.js +1 -440
  58. package/dist/components/stripe-currency-selector.js +1 -218
  59. package/dist/components/stripe-express-checkout-element.js +1 -332
  60. package/dist/components/stripe-link-authentication-element.js +1 -256
  61. package/dist/components/stripe-modal.js +1 -9
  62. package/dist/components/stripe-modal2.js +1 -112
  63. package/dist/components/stripe-payment-element.js +1 -510
  64. package/dist/components/stripe-payment-request-button.js +1 -9
  65. package/dist/components/stripe-payment-request-button2.js +1 -224
  66. package/dist/components/utils.js +1 -89
  67. package/dist/esm/app-globals-DQuL1Twl.js +0 -3
  68. package/dist/esm/error-XRfh5Wrs.js +0 -3
  69. package/dist/esm/{factory-Drde6-y7.js → factory-VTa1Gc94.js} +216 -77
  70. package/dist/esm/index-C6bbmyga.js +4677 -0
  71. package/dist/esm/{index-BHDCxQOb.js → index-CBXaOfXU.js} +24 -6
  72. package/dist/esm/index.js +0 -1
  73. package/dist/esm/ion-icon.entry.js +22 -13
  74. package/dist/esm/loader.js +3 -4
  75. package/dist/esm/stripe-address-element.entry.js +41 -26
  76. package/dist/esm/stripe-card-element-modal.entry.js +6 -7
  77. package/dist/esm/stripe-card-element_2.entry.js +129 -72
  78. package/dist/esm/stripe-currency-selector.entry.js +20 -10
  79. package/dist/esm/stripe-elements.js +32 -6
  80. package/dist/esm/stripe-express-checkout-element.entry.js +32 -22
  81. package/dist/esm/stripe-link-authentication-element.entry.js +20 -10
  82. package/dist/esm/stripe-payment-element.entry.js +283 -167
  83. package/dist/esm/stripe-payment-request-button.entry.js +27 -15
  84. package/dist/stripe-elements/index.esm.js +0 -2
  85. package/dist/stripe-elements/p-1bd46766.entry.js +1 -0
  86. package/dist/stripe-elements/p-1c6e0a45.entry.js +1 -0
  87. package/dist/stripe-elements/p-3f42ca0c.entry.js +1 -0
  88. package/dist/stripe-elements/p-5cf62945.entry.js +1 -0
  89. package/dist/stripe-elements/p-74de1556.entry.js +1 -0
  90. package/dist/stripe-elements/p-76e57d78.entry.js +1 -0
  91. package/dist/stripe-elements/p-840d499f.entry.js +1 -0
  92. package/dist/stripe-elements/p-C6bbmyga.js +2 -0
  93. package/dist/stripe-elements/p-CBXaOfXU.js +1 -0
  94. package/dist/stripe-elements/p-CrjrbGJ3.js +1 -0
  95. package/dist/stripe-elements/p-DQuL1Twl.js +1 -2
  96. package/dist/stripe-elements/p-XRfh5Wrs.js +1 -2
  97. package/dist/stripe-elements/p-ae0c336e.entry.js +1 -0
  98. package/dist/stripe-elements/p-cfd8e081.entry.js +1 -0
  99. package/dist/stripe-elements/stripe-elements.esm.js +1 -2
  100. package/dist/stripe-elements/svg/.gitignore +4 -0
  101. package/dist/types/components/stripe-address-element/stripe-address-element.d.ts +6 -0
  102. package/dist/types/components/stripe-card-element/stripe-card-element.d.ts +11 -1
  103. package/dist/types/components/stripe-card-element/stripe-card-element.helpers.d.ts +29 -0
  104. package/dist/types/components/stripe-card-element-modal/stripe-card-element-modal.d.ts +4 -4
  105. package/dist/types/components/stripe-currency-selector/stripe-currency-selector.d.ts +6 -0
  106. package/dist/types/components/stripe-express-checkout-element/stripe-express-checkout-element.d.ts +6 -0
  107. package/dist/types/components/stripe-link-authentication-element/stripe-link-authentication-element.d.ts +6 -0
  108. package/dist/types/components/stripe-modal/stripe-modal.d.ts +1 -0
  109. package/dist/types/components/stripe-payment-element/stripe-payment-element.d.ts +20 -2
  110. package/dist/types/components/stripe-payment-element/stripe-payment-element.helpers.d.ts +54 -0
  111. package/dist/types/components/stripe-payment-request-button/stripe-payment-request-button.d.ts +14 -1
  112. package/dist/types/components.d.ts +139 -29
  113. package/dist/types/index.d.ts +1 -0
  114. package/dist/types/services/interfaces.d.ts +4 -3
  115. package/dist/types/services/stripe-service.d.ts +8 -4
  116. package/dist/types/stencil-public-runtime.d.ts +110 -5
  117. package/package.json +50 -30
  118. package/readme.md +386 -133
  119. package/dist/cjs/app-globals-V2Kpy_OQ.js.map +0 -1
  120. package/dist/cjs/error-FFC4kSs5.js.map +0 -1
  121. package/dist/cjs/factory-CbbbSvkg.js.map +0 -1
  122. package/dist/cjs/index-BXVW_rzh.js +0 -1932
  123. package/dist/cjs/index-BXVW_rzh.js.map +0 -1
  124. package/dist/cjs/index-Ba1pBePA.js.map +0 -1
  125. package/dist/cjs/index.cjs.js.map +0 -1
  126. package/dist/cjs/ion-icon.entry.cjs.js.map +0 -1
  127. package/dist/cjs/loader.cjs.js.map +0 -1
  128. package/dist/cjs/stripe-address-element.entry.cjs.js.map +0 -1
  129. package/dist/cjs/stripe-card-element-modal.entry.cjs.js.map +0 -1
  130. package/dist/cjs/stripe-card-element.stripe-modal.entry.cjs.js.map +0 -1
  131. package/dist/cjs/stripe-currency-selector.entry.cjs.js.map +0 -1
  132. package/dist/cjs/stripe-elements.cjs.js.map +0 -1
  133. package/dist/cjs/stripe-express-checkout-element.entry.cjs.js.map +0 -1
  134. package/dist/cjs/stripe-link-authentication-element.entry.cjs.js.map +0 -1
  135. package/dist/cjs/stripe-payment-element.entry.cjs.js.map +0 -1
  136. package/dist/cjs/stripe-payment-request-button.entry.cjs.js.map +0 -1
  137. package/dist/collection/components/stripe-address-element/stripe-address-element.js.map +0 -1
  138. package/dist/collection/components/stripe-card-element/stripe-card-element.js.map +0 -1
  139. package/dist/collection/components/stripe-card-element-modal/stripe-card-element-modal.js.map +0 -1
  140. package/dist/collection/components/stripe-currency-selector/stripe-currency-selector.js.map +0 -1
  141. package/dist/collection/components/stripe-express-checkout-element/stripe-express-checkout-element.js.map +0 -1
  142. package/dist/collection/components/stripe-link-authentication-element/stripe-link-authentication-element.js.map +0 -1
  143. package/dist/collection/components/stripe-modal/stripe-modal.js.map +0 -1
  144. package/dist/collection/components/stripe-payment-element/stripe-payment-element.js.map +0 -1
  145. package/dist/collection/components/stripe-payment-request-button/stripe-payment-request-button.js.map +0 -1
  146. package/dist/collection/index.js.map +0 -1
  147. package/dist/collection/interfaces.js.map +0 -1
  148. package/dist/collection/services/address-element-manager.js.map +0 -1
  149. package/dist/collection/services/card-element-manager.js.map +0 -1
  150. package/dist/collection/services/currency-selector-element-manager.js.map +0 -1
  151. package/dist/collection/services/express-checkout-element-manager.js.map +0 -1
  152. package/dist/collection/services/factory.js.map +0 -1
  153. package/dist/collection/services/interfaces.js.map +0 -1
  154. package/dist/collection/services/link-authentication-element-manager.js.map +0 -1
  155. package/dist/collection/services/payment-element-manager.js.map +0 -1
  156. package/dist/collection/services/stripe-service.js.map +0 -1
  157. package/dist/collection/utils/element-finder.js.map +0 -1
  158. package/dist/collection/utils/error.js.map +0 -1
  159. package/dist/collection/utils/i18n.js.map +0 -1
  160. package/dist/collection/utils/platform.js.map +0 -1
  161. package/dist/collection/utils/test-setup.js.map +0 -1
  162. package/dist/collection/utils/utils.js.map +0 -1
  163. package/dist/components/error.js.map +0 -1
  164. package/dist/components/factory.js.map +0 -1
  165. package/dist/components/icon.js.map +0 -1
  166. package/dist/components/index.js.map +0 -1
  167. package/dist/components/index2.js.map +0 -1
  168. package/dist/components/ion-icon.js.map +0 -1
  169. package/dist/components/stripe-address-element.js.map +0 -1
  170. package/dist/components/stripe-card-element-modal.js.map +0 -1
  171. package/dist/components/stripe-card-element.js.map +0 -1
  172. package/dist/components/stripe-card-element2.js.map +0 -1
  173. package/dist/components/stripe-currency-selector.js.map +0 -1
  174. package/dist/components/stripe-express-checkout-element.js.map +0 -1
  175. package/dist/components/stripe-link-authentication-element.js.map +0 -1
  176. package/dist/components/stripe-modal.js.map +0 -1
  177. package/dist/components/stripe-modal2.js.map +0 -1
  178. package/dist/components/stripe-payment-element.js.map +0 -1
  179. package/dist/components/stripe-payment-request-button.js.map +0 -1
  180. package/dist/components/stripe-payment-request-button2.js.map +0 -1
  181. package/dist/components/utils.js.map +0 -1
  182. package/dist/esm/app-globals-DQuL1Twl.js.map +0 -1
  183. package/dist/esm/error-XRfh5Wrs.js.map +0 -1
  184. package/dist/esm/factory-Drde6-y7.js.map +0 -1
  185. package/dist/esm/index-BHDCxQOb.js.map +0 -1
  186. package/dist/esm/index-DJwTOfxZ.js +0 -1920
  187. package/dist/esm/index-DJwTOfxZ.js.map +0 -1
  188. package/dist/esm/index.js.map +0 -1
  189. package/dist/esm/ion-icon.entry.js.map +0 -1
  190. package/dist/esm/loader.js.map +0 -1
  191. package/dist/esm/stripe-address-element.entry.js.map +0 -1
  192. package/dist/esm/stripe-card-element-modal.entry.js.map +0 -1
  193. package/dist/esm/stripe-card-element.stripe-modal.entry.js.map +0 -1
  194. package/dist/esm/stripe-currency-selector.entry.js.map +0 -1
  195. package/dist/esm/stripe-elements.js.map +0 -1
  196. package/dist/esm/stripe-express-checkout-element.entry.js.map +0 -1
  197. package/dist/esm/stripe-link-authentication-element.entry.js.map +0 -1
  198. package/dist/esm/stripe-payment-element.entry.js.map +0 -1
  199. package/dist/esm/stripe-payment-request-button.entry.js.map +0 -1
  200. package/dist/stripe-elements/index.esm.js.map +0 -1
  201. package/dist/stripe-elements/ion-icon.entry.esm.js.map +0 -1
  202. package/dist/stripe-elements/loader.esm.js.map +0 -1
  203. package/dist/stripe-elements/p-02f6e421.entry.js +0 -2
  204. package/dist/stripe-elements/p-02f6e421.entry.js.map +0 -1
  205. package/dist/stripe-elements/p-19888fa6.entry.js +0 -2
  206. package/dist/stripe-elements/p-19888fa6.entry.js.map +0 -1
  207. package/dist/stripe-elements/p-4d505729.entry.js +0 -2
  208. package/dist/stripe-elements/p-4d505729.entry.js.map +0 -1
  209. package/dist/stripe-elements/p-7e7ad92a.entry.js +0 -2
  210. package/dist/stripe-elements/p-7e7ad92a.entry.js.map +0 -1
  211. package/dist/stripe-elements/p-8bb4212c.entry.js +0 -2
  212. package/dist/stripe-elements/p-8bb4212c.entry.js.map +0 -1
  213. package/dist/stripe-elements/p-9aee2b6b.entry.js +0 -2
  214. package/dist/stripe-elements/p-9aee2b6b.entry.js.map +0 -1
  215. package/dist/stripe-elements/p-BHDCxQOb.js +0 -2
  216. package/dist/stripe-elements/p-BHDCxQOb.js.map +0 -1
  217. package/dist/stripe-elements/p-DI2vmGaI.js +0 -2
  218. package/dist/stripe-elements/p-DI2vmGaI.js.map +0 -1
  219. package/dist/stripe-elements/p-DJwTOfxZ.js +0 -3
  220. package/dist/stripe-elements/p-DJwTOfxZ.js.map +0 -1
  221. package/dist/stripe-elements/p-DQuL1Twl.js.map +0 -1
  222. package/dist/stripe-elements/p-XRfh5Wrs.js.map +0 -1
  223. package/dist/stripe-elements/p-ba251393.entry.js +0 -2
  224. package/dist/stripe-elements/p-ba251393.entry.js.map +0 -1
  225. package/dist/stripe-elements/p-c649edfc.entry.js +0 -2
  226. package/dist/stripe-elements/p-c649edfc.entry.js.map +0 -1
  227. package/dist/stripe-elements/p-e8bb43ae.entry.js +0 -2
  228. package/dist/stripe-elements/p-e8bb43ae.entry.js.map +0 -1
  229. package/dist/stripe-elements/stripe-address-element.entry.esm.js.map +0 -1
  230. package/dist/stripe-elements/stripe-card-element-modal.entry.esm.js.map +0 -1
  231. package/dist/stripe-elements/stripe-card-element.stripe-modal.entry.esm.js.map +0 -1
  232. package/dist/stripe-elements/stripe-currency-selector.entry.esm.js.map +0 -1
  233. package/dist/stripe-elements/stripe-elements.esm.js.map +0 -1
  234. package/dist/stripe-elements/stripe-express-checkout-element.entry.esm.js.map +0 -1
  235. package/dist/stripe-elements/stripe-link-authentication-element.entry.esm.js.map +0 -1
  236. package/dist/stripe-elements/stripe-payment-element.entry.esm.js.map +0 -1
  237. package/dist/stripe-elements/stripe-payment-request-button.entry.esm.js.map +0 -1
@@ -114,7 +114,7 @@ export namespace Components {
114
114
  * Get Stripe.js, and initialize elements
115
115
  * @param publishableKey
116
116
  * @param options
117
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { tripeElement.initStripe('pk_test_XXXXXXXXX') }) ```
117
+ * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement.initStripe('pk_test_XXXXXXXXX') }) ```
118
118
  */
119
119
  "initStripe": (publishableKey: string, options?: InitStripeOptions) => Promise<void>;
120
120
  /**
@@ -136,7 +136,7 @@ export namespace Components {
136
136
  * Set error message
137
137
  * @param errorMessage string
138
138
  * @returns
139
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { // You must set the attributes to stop running default form submit action when you want to listen the 'formSubmit' event. stripeElement.setAttribute('should-use-default-form-submit-action', false) stripeElement.addEventListener('formSubmit', async props => { try { throw new Error('debug') } catch (e) { stripeElement.setErrorMessage(`Error: ${e.message}`) stripeElement.updateProgress('failure') } }); })
139
+ * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { // You must set the attributes to stop running default form submit action when you want to listen the 'formSubmit' event. stripeElement.setAttribute('should-use-default-form-submit-action', false) stripeElement.addEventListener('formSubmit', async props => { try { throw new Error('debug') } catch (e) { stripeElement.setErrorMessage(`Error: ${e.message}`) stripeElement.updateProgress('failure') } }); }) ```
140
140
  */
141
141
  "setErrorMessage": (errorMessage: string) => Promise<this>;
142
142
  /**
@@ -176,7 +176,7 @@ export namespace Components {
176
176
  * Update the form submit progress
177
177
  * @param progress
178
178
  * @returns
179
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { // You must set the attributes to stop running default form submit action when you want to listen the 'formSubmit' event. stripeElement.setAttribute('should-use-default-form-submit-action', false) stripeElement.addEventListener('formSubmit', async props => { const { detail: { stripe, cardNumber, event }, } = props; const result = await stripe.createPaymentMethod({ type: 'card', card: cardNumber, }); console.log(result); stripeElement.updateProgress('success') }); })
179
+ * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { // You must set the attributes to stop running default form submit action when you want to listen the 'formSubmit' event. stripeElement.setAttribute('should-use-default-form-submit-action', false) stripeElement.addEventListener('formSubmit', async props => { const { detail: { stripe, cardNumber, event }, } = props; const result = await stripe.createPaymentMethod({ type: 'card', card: cardNumber, }); console.log(result); stripeElement.updateProgress('success') }); }) ```
180
180
  */
181
181
  "updateProgress": (progress: ProgressStatus) => Promise<this>;
182
182
  /**
@@ -208,13 +208,13 @@ export namespace Components {
208
208
  "handleSubmit": FormSubmitHandler;
209
209
  /**
210
210
  * The client secret from paymentIntent.create response
211
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement.setAttribute('intent-client-secret', 'dummy') }) ```
212
- * @example ``` <stripe-card-element intent-client-secret="dummy" /> ```
211
+ * @example ``` const stripeElement = document.createElement('stripe-card-element-modal'); customElements .whenDefined('stripe-card-element-modal') .then(() => { stripeElement.setAttribute('intent-client-secret', 'dummy') }) ```
212
+ * @example ``` <stripe-card-element-modal intent-client-secret="dummy" /> ```
213
213
  */
214
214
  "intentClientSecret"?: string;
215
215
  /**
216
216
  * Default submit handle type. If you want to use `setupIntent`, should update this attribute.
217
- * @example ``` <stripe-card-element intent-type="setup" /> ```
217
+ * @example ``` <stripe-card-element-modal intent-type="setup" /> ```
218
218
  * @default 'payment'
219
219
  */
220
220
  "intentType": IntentType;
@@ -576,6 +576,13 @@ export namespace Components {
576
576
  */
577
577
  "updateProgress": (progress: ProgressStatus) => Promise<this>;
578
578
  }
579
+ /**
580
+ * @deprecated `stripe-payment-request-button` is deprecated and will be removed in a future release.
581
+ * `stripe.paymentRequest()` is being removed in Stripe.js 9.x (deprecated as of 2025-09-30 / 2026-03-25).
582
+ * Please migrate to `<stripe-express-checkout-element>` which supports Apple Pay, Google Pay, Link, PayPal,
583
+ * and more via the modern Express Checkout Element API.
584
+ * Migration guide: https://hideokamoto.github.io/stripe-pwa-elements/guides/migrate-payment-request-button-to-express-checkout/
585
+ */
579
586
  interface StripePaymentRequestButton {
580
587
  /**
581
588
  * Overwrite the application name that registered For wrapper library (like Capacitor)
@@ -844,6 +851,13 @@ declare global {
844
851
  interface HTMLStripePaymentRequestButtonElementEventMap {
845
852
  "stripeLoaded": StripeLoadedEvent;
846
853
  }
854
+ /**
855
+ * @deprecated `stripe-payment-request-button` is deprecated and will be removed in a future release.
856
+ * `stripe.paymentRequest()` is being removed in Stripe.js 9.x (deprecated as of 2025-09-30 / 2026-03-25).
857
+ * Please migrate to `<stripe-express-checkout-element>` which supports Apple Pay, Google Pay, Link, PayPal,
858
+ * and more via the modern Express Checkout Element API.
859
+ * Migration guide: https://hideokamoto.github.io/stripe-pwa-elements/guides/migrate-payment-request-button-to-express-checkout/
860
+ */
847
861
  interface HTMLStripePaymentRequestButtonElement extends Components.StripePaymentRequestButton, HTMLStencilElement {
848
862
  addEventListener<K extends keyof HTMLStripePaymentRequestButtonElementEventMap>(type: K, listener: (this: HTMLStripePaymentRequestButtonElement, ev: StripePaymentRequestButtonCustomEvent<HTMLStripePaymentRequestButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
849
863
  addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
@@ -961,12 +975,12 @@ declare namespace LocalJSX {
961
975
  "intentType"?: IntentType;
962
976
  /**
963
977
  * Recieve the result of defaultFormSubmit event
964
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement.addEventListener('defaultFormSubmitResult', async ({detail}) => { if (detail instanceof Error) { console.error(detail) } else { console.log(detail) } }) })
978
+ * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement.addEventListener('defaultFormSubmitResult', async ({detail}) => { if (detail instanceof Error) { console.error(detail) } else { console.log(detail) } }) }) ```
965
979
  */
966
980
  "onDefaultFormSubmitResult"?: (event: StripeCardElementCustomEvent<DefaultFormSubmitResult>) => void;
967
981
  /**
968
982
  * Form submit event
969
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement .addEventListener('formSubmit', async props => { const { detail: { stripe, cardNumber, event }, } = props; const result = await stripe.createPaymentMethod({ type: 'card', card: cardNumber, }); console.log(result); }) })
983
+ * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement .addEventListener('formSubmit', async props => { const { detail: { stripe, cardNumber, event }, } = props; const result = await stripe.createPaymentMethod({ type: 'card', card: cardNumber, }); console.log(result); }) }) ```
970
984
  */
971
985
  "onFormSubmit"?: (event: StripeCardElementCustomEvent<FormSubmitEvent>) => void;
972
986
  /**
@@ -1027,13 +1041,13 @@ declare namespace LocalJSX {
1027
1041
  "handleSubmit"?: FormSubmitHandler;
1028
1042
  /**
1029
1043
  * The client secret from paymentIntent.create response
1030
- * @example ``` const stripeElement = document.createElement('stripe-card-element'); customElements .whenDefined('stripe-card-element') .then(() => { stripeElement.setAttribute('intent-client-secret', 'dummy') }) ```
1031
- * @example ``` <stripe-card-element intent-client-secret="dummy" /> ```
1044
+ * @example ``` const stripeElement = document.createElement('stripe-card-element-modal'); customElements .whenDefined('stripe-card-element-modal') .then(() => { stripeElement.setAttribute('intent-client-secret', 'dummy') }) ```
1045
+ * @example ``` <stripe-card-element-modal intent-client-secret="dummy" /> ```
1032
1046
  */
1033
1047
  "intentClientSecret"?: string;
1034
1048
  /**
1035
1049
  * Default submit handle type. If you want to use `setupIntent`, should update this attribute.
1036
- * @example ``` <stripe-card-element intent-type="setup" /> ```
1050
+ * @example ``` <stripe-card-element-modal intent-type="setup" /> ```
1037
1051
  * @default 'payment'
1038
1052
  */
1039
1053
  "intentType"?: IntentType;
@@ -1334,6 +1348,13 @@ declare namespace LocalJSX {
1334
1348
  */
1335
1349
  "stripeDidLoaded"?: StripeDidLoadedHandler;
1336
1350
  }
1351
+ /**
1352
+ * @deprecated `stripe-payment-request-button` is deprecated and will be removed in a future release.
1353
+ * `stripe.paymentRequest()` is being removed in Stripe.js 9.x (deprecated as of 2025-09-30 / 2026-03-25).
1354
+ * Please migrate to `<stripe-express-checkout-element>` which supports Apple Pay, Google Pay, Link, PayPal,
1355
+ * and more via the modern Express Checkout Element API.
1356
+ * Migration guide: https://hideokamoto.github.io/stripe-pwa-elements/guides/migrate-payment-request-button-to-express-checkout/
1357
+ */
1337
1358
  interface StripePaymentRequestButton {
1338
1359
  /**
1339
1360
  * Overwrite the application name that registered For wrapper library (like Capacitor)
@@ -1374,31 +1395,113 @@ declare namespace LocalJSX {
1374
1395
  */
1375
1396
  "stripeDidLoaded"?: StripeDidLoadedHandler;
1376
1397
  }
1398
+
1399
+ interface StripeAddressElementAttributes {
1400
+ "mode": 'shipping' | 'billing';
1401
+ "sheetTitle": string;
1402
+ "buttonLabel": string;
1403
+ "publishableKey": string;
1404
+ "stripeAccount": string;
1405
+ "applicationName": string;
1406
+ "showLabel": boolean;
1407
+ "defaultCountry": string;
1408
+ }
1409
+ interface StripeCardElementAttributes {
1410
+ "intentType": IntentType;
1411
+ "zip": boolean;
1412
+ "sheetTitle": string;
1413
+ "buttonLabel": string;
1414
+ "publishableKey": string;
1415
+ "stripeAccount": string;
1416
+ "applicationName": string;
1417
+ "showLabel": boolean;
1418
+ "intentClientSecret": string;
1419
+ "shouldUseDefaultFormSubmitAction": boolean;
1420
+ "showPaymentRequestButton": boolean;
1421
+ }
1422
+ interface StripeCardElementModalAttributes {
1423
+ "publishableKey": string;
1424
+ "stripeAccount": string;
1425
+ "applicationName": string;
1426
+ "showLabel": boolean;
1427
+ "sheetTitle": string;
1428
+ "buttonLabel": string;
1429
+ "intentClientSecret": string;
1430
+ "shouldUseDefaultFormSubmitAction": boolean;
1431
+ "intentType": IntentType;
1432
+ "showCloseButton": boolean;
1433
+ "zip": boolean;
1434
+ "open": boolean;
1435
+ }
1436
+ interface StripeCurrencySelectorAttributes {
1437
+ "publishableKey": string;
1438
+ "stripeAccount": string;
1439
+ "applicationName": string;
1440
+ "clientSecret": string;
1441
+ }
1442
+ interface StripeExpressCheckoutElementAttributes {
1443
+ "intentType": IntentType;
1444
+ "publishableKey": string;
1445
+ "stripeAccount": string;
1446
+ "applicationName": string;
1447
+ "clientSecret": string;
1448
+ "amount": number;
1449
+ "currency": string;
1450
+ "buttonHeight": string;
1451
+ "shouldUseDefaultConfirmAction": boolean;
1452
+ }
1453
+ interface StripeLinkAuthenticationElementAttributes {
1454
+ "publishableKey": string;
1455
+ "stripeAccount": string;
1456
+ "applicationName": string;
1457
+ "defaultEmail": string;
1458
+ }
1459
+ interface StripeModalAttributes {
1460
+ "showCloseButton": boolean;
1461
+ "open": boolean;
1462
+ }
1463
+ interface StripePaymentElementAttributes {
1464
+ "intentType": IntentType;
1465
+ "sheetTitle": string;
1466
+ "buttonLabel": string;
1467
+ "publishableKey": string;
1468
+ "stripeAccount": string;
1469
+ "applicationName": string;
1470
+ "intentClientSecret": string;
1471
+ "checkoutSessionClientSecret": string;
1472
+ "shouldUseDefaultFormSubmitAction": boolean;
1473
+ }
1474
+ interface StripePaymentRequestButtonAttributes {
1475
+ "publishableKey": string;
1476
+ "stripeAccount": string;
1477
+ "applicationName": string;
1478
+ }
1479
+
1377
1480
  interface IntrinsicElements {
1378
- "stripe-address-element": StripeAddressElement;
1379
- "stripe-card-element": StripeCardElement;
1380
- "stripe-card-element-modal": StripeCardElementModal;
1381
- "stripe-currency-selector": StripeCurrencySelector;
1382
- "stripe-express-checkout-element": StripeExpressCheckoutElement;
1383
- "stripe-link-authentication-element": StripeLinkAuthenticationElement;
1384
- "stripe-modal": StripeModal;
1385
- "stripe-payment-element": StripePaymentElement;
1386
- "stripe-payment-request-button": StripePaymentRequestButton;
1481
+ "stripe-address-element": Omit<StripeAddressElement, keyof StripeAddressElementAttributes> & { [K in keyof StripeAddressElement & keyof StripeAddressElementAttributes]?: StripeAddressElement[K] } & { [K in keyof StripeAddressElement & keyof StripeAddressElementAttributes as `attr:${K}`]?: StripeAddressElementAttributes[K] } & { [K in keyof StripeAddressElement & keyof StripeAddressElementAttributes as `prop:${K}`]?: StripeAddressElement[K] };
1482
+ "stripe-card-element": Omit<StripeCardElement, keyof StripeCardElementAttributes> & { [K in keyof StripeCardElement & keyof StripeCardElementAttributes]?: StripeCardElement[K] } & { [K in keyof StripeCardElement & keyof StripeCardElementAttributes as `attr:${K}`]?: StripeCardElementAttributes[K] } & { [K in keyof StripeCardElement & keyof StripeCardElementAttributes as `prop:${K}`]?: StripeCardElement[K] };
1483
+ "stripe-card-element-modal": Omit<StripeCardElementModal, keyof StripeCardElementModalAttributes> & { [K in keyof StripeCardElementModal & keyof StripeCardElementModalAttributes]?: StripeCardElementModal[K] } & { [K in keyof StripeCardElementModal & keyof StripeCardElementModalAttributes as `attr:${K}`]?: StripeCardElementModalAttributes[K] } & { [K in keyof StripeCardElementModal & keyof StripeCardElementModalAttributes as `prop:${K}`]?: StripeCardElementModal[K] };
1484
+ "stripe-currency-selector": Omit<StripeCurrencySelector, keyof StripeCurrencySelectorAttributes> & { [K in keyof StripeCurrencySelector & keyof StripeCurrencySelectorAttributes]?: StripeCurrencySelector[K] } & { [K in keyof StripeCurrencySelector & keyof StripeCurrencySelectorAttributes as `attr:${K}`]?: StripeCurrencySelectorAttributes[K] } & { [K in keyof StripeCurrencySelector & keyof StripeCurrencySelectorAttributes as `prop:${K}`]?: StripeCurrencySelector[K] };
1485
+ "stripe-express-checkout-element": Omit<StripeExpressCheckoutElement, keyof StripeExpressCheckoutElementAttributes> & { [K in keyof StripeExpressCheckoutElement & keyof StripeExpressCheckoutElementAttributes]?: StripeExpressCheckoutElement[K] } & { [K in keyof StripeExpressCheckoutElement & keyof StripeExpressCheckoutElementAttributes as `attr:${K}`]?: StripeExpressCheckoutElementAttributes[K] } & { [K in keyof StripeExpressCheckoutElement & keyof StripeExpressCheckoutElementAttributes as `prop:${K}`]?: StripeExpressCheckoutElement[K] };
1486
+ "stripe-link-authentication-element": Omit<StripeLinkAuthenticationElement, keyof StripeLinkAuthenticationElementAttributes> & { [K in keyof StripeLinkAuthenticationElement & keyof StripeLinkAuthenticationElementAttributes]?: StripeLinkAuthenticationElement[K] } & { [K in keyof StripeLinkAuthenticationElement & keyof StripeLinkAuthenticationElementAttributes as `attr:${K}`]?: StripeLinkAuthenticationElementAttributes[K] } & { [K in keyof StripeLinkAuthenticationElement & keyof StripeLinkAuthenticationElementAttributes as `prop:${K}`]?: StripeLinkAuthenticationElement[K] };
1487
+ "stripe-modal": Omit<StripeModal, keyof StripeModalAttributes> & { [K in keyof StripeModal & keyof StripeModalAttributes]?: StripeModal[K] } & { [K in keyof StripeModal & keyof StripeModalAttributes as `attr:${K}`]?: StripeModalAttributes[K] } & { [K in keyof StripeModal & keyof StripeModalAttributes as `prop:${K}`]?: StripeModal[K] };
1488
+ "stripe-payment-element": Omit<StripePaymentElement, keyof StripePaymentElementAttributes> & { [K in keyof StripePaymentElement & keyof StripePaymentElementAttributes]?: StripePaymentElement[K] } & { [K in keyof StripePaymentElement & keyof StripePaymentElementAttributes as `attr:${K}`]?: StripePaymentElementAttributes[K] } & { [K in keyof StripePaymentElement & keyof StripePaymentElementAttributes as `prop:${K}`]?: StripePaymentElement[K] };
1489
+ "stripe-payment-request-button": Omit<StripePaymentRequestButton, keyof StripePaymentRequestButtonAttributes> & { [K in keyof StripePaymentRequestButton & keyof StripePaymentRequestButtonAttributes]?: StripePaymentRequestButton[K] } & { [K in keyof StripePaymentRequestButton & keyof StripePaymentRequestButtonAttributes as `attr:${K}`]?: StripePaymentRequestButtonAttributes[K] } & { [K in keyof StripePaymentRequestButton & keyof StripePaymentRequestButtonAttributes as `prop:${K}`]?: StripePaymentRequestButton[K] };
1387
1490
  }
1388
1491
  }
1389
1492
  export { LocalJSX as JSX };
1390
1493
  declare module "@stencil/core" {
1391
1494
  export namespace JSX {
1392
1495
  interface IntrinsicElements {
1393
- "stripe-address-element": LocalJSX.StripeAddressElement & JSXBase.HTMLAttributes<HTMLStripeAddressElementElement>;
1394
- "stripe-card-element": LocalJSX.StripeCardElement & JSXBase.HTMLAttributes<HTMLStripeCardElementElement>;
1395
- "stripe-card-element-modal": LocalJSX.StripeCardElementModal & JSXBase.HTMLAttributes<HTMLStripeCardElementModalElement>;
1496
+ "stripe-address-element": LocalJSX.IntrinsicElements["stripe-address-element"] & JSXBase.HTMLAttributes<HTMLStripeAddressElementElement>;
1497
+ "stripe-card-element": LocalJSX.IntrinsicElements["stripe-card-element"] & JSXBase.HTMLAttributes<HTMLStripeCardElementElement>;
1498
+ "stripe-card-element-modal": LocalJSX.IntrinsicElements["stripe-card-element-modal"] & JSXBase.HTMLAttributes<HTMLStripeCardElementModalElement>;
1396
1499
  /**
1397
1500
  * Stripe Currency Selector Element
1398
1501
  * Allows customers to select their preferred currency for Adaptive Pricing
1399
1502
  * @info https://docs.stripe.com/elements/currency-selector-element
1400
1503
  */
1401
- "stripe-currency-selector": LocalJSX.StripeCurrencySelector & JSXBase.HTMLAttributes<HTMLStripeCurrencySelectorElement>;
1504
+ "stripe-currency-selector": LocalJSX.IntrinsicElements["stripe-currency-selector"] & JSXBase.HTMLAttributes<HTMLStripeCurrencySelectorElement>;
1402
1505
  /**
1403
1506
  * Express Checkout Element Component
1404
1507
  * Provides one-click payment methods (Apple Pay, Google Pay, Link, PayPal, etc.)
@@ -1411,11 +1514,18 @@ declare module "@stencil/core" {
1411
1514
  * />
1412
1515
  * ```
1413
1516
  */
1414
- "stripe-express-checkout-element": LocalJSX.StripeExpressCheckoutElement & JSXBase.HTMLAttributes<HTMLStripeExpressCheckoutElementElement>;
1415
- "stripe-link-authentication-element": LocalJSX.StripeLinkAuthenticationElement & JSXBase.HTMLAttributes<HTMLStripeLinkAuthenticationElementElement>;
1416
- "stripe-modal": LocalJSX.StripeModal & JSXBase.HTMLAttributes<HTMLStripeModalElement>;
1417
- "stripe-payment-element": LocalJSX.StripePaymentElement & JSXBase.HTMLAttributes<HTMLStripePaymentElementElement>;
1418
- "stripe-payment-request-button": LocalJSX.StripePaymentRequestButton & JSXBase.HTMLAttributes<HTMLStripePaymentRequestButtonElement>;
1517
+ "stripe-express-checkout-element": LocalJSX.IntrinsicElements["stripe-express-checkout-element"] & JSXBase.HTMLAttributes<HTMLStripeExpressCheckoutElementElement>;
1518
+ "stripe-link-authentication-element": LocalJSX.IntrinsicElements["stripe-link-authentication-element"] & JSXBase.HTMLAttributes<HTMLStripeLinkAuthenticationElementElement>;
1519
+ "stripe-modal": LocalJSX.IntrinsicElements["stripe-modal"] & JSXBase.HTMLAttributes<HTMLStripeModalElement>;
1520
+ "stripe-payment-element": LocalJSX.IntrinsicElements["stripe-payment-element"] & JSXBase.HTMLAttributes<HTMLStripePaymentElementElement>;
1521
+ /**
1522
+ * @deprecated `stripe-payment-request-button` is deprecated and will be removed in a future release.
1523
+ * `stripe.paymentRequest()` is being removed in Stripe.js 9.x (deprecated as of 2025-09-30 / 2026-03-25).
1524
+ * Please migrate to `<stripe-express-checkout-element>` which supports Apple Pay, Google Pay, Link, PayPal,
1525
+ * and more via the modern Express Checkout Element API.
1526
+ * Migration guide: https://hideokamoto.github.io/stripe-pwa-elements/guides/migrate-payment-request-button-to-express-checkout/
1527
+ */
1528
+ "stripe-payment-request-button": LocalJSX.IntrinsicElements["stripe-payment-request-button"] & JSXBase.HTMLAttributes<HTMLStripePaymentRequestButtonElement>;
1419
1529
  }
1420
1530
  }
1421
1531
  }
@@ -1,2 +1,3 @@
1
1
  export { Components, JSX } from './components';
2
+ export type { FormSubmitEvent, FormSubmitHandler, StripeLoadedEvent, StripeDidLoadedHandler, ProgressStatus, IntentType, InitStripeOptions, LinkAuthenticationElementChangeEvent, LinkAuthenticationElementChangeHandler, CurrencySelectorChangeEvent, CurrencySelectorChangeHandler, DefaultFormSubmitResult, } from './interfaces';
2
3
  import 'ionicons';
@@ -1,4 +1,4 @@
1
- import { Stripe, StripeElements, StripeCardNumberElement, StripeCardExpiryElement, StripeCardCvcElement, StripePaymentElement, StripeAddressElement, StripeLinkAuthenticationElement, StripeCurrencySelectorElement, StripeExpressCheckoutElement, StripeExpressCheckoutElementConfirmEvent, StripeExpressCheckoutElementClickEvent, StripeExpressCheckoutElementShippingAddressChangeEvent, StripeExpressCheckoutElementShippingRateChangeEvent, StripeCheckout, StripeCheckoutElementsOptions } from '@stripe/stripe-js';
1
+ import { Stripe, StripeElements, StripeCardNumberElement, StripeCardExpiryElement, StripeCardCvcElement, StripePaymentElement, StripeAddressElement, StripeLinkAuthenticationElement, StripeCurrencySelectorElement, StripeExpressCheckoutElement, StripeExpressCheckoutElementConfirmEvent, StripeExpressCheckoutElementClickEvent, StripeExpressCheckoutElementShippingAddressChangeEvent, StripeExpressCheckoutElementShippingRateChangeEvent, StripeCheckoutElementsSdk, StripeCheckoutElementsOptions } from '@stripe/stripe-js';
2
2
  import { ProgressStatus } from '../interfaces';
3
3
  /**
4
4
  * Checkout session initialization options
@@ -19,7 +19,7 @@ export type StripeServiceState = {
19
19
  /**
20
20
  * Checkout instance for Checkout Session mode
21
21
  */
22
- checkout?: StripeCheckout;
22
+ checkout?: StripeCheckoutElementsSdk;
23
23
  /**
24
24
  * Whether the service is initialized with Checkout Session
25
25
  */
@@ -75,6 +75,7 @@ export interface IStripeService {
75
75
  initialize(publishableKey: string, options?: {
76
76
  stripeAccount?: string;
77
77
  applicationName?: string;
78
+ clientSecret?: string;
78
79
  }): Promise<void>;
79
80
  /**
80
81
  * Initialize Stripe.js with Checkout Session mode
@@ -101,7 +102,7 @@ export interface IStripeService {
101
102
  /**
102
103
  * Get Checkout instance (for Checkout Session mode)
103
104
  */
104
- getCheckout(): StripeCheckout | undefined;
105
+ getCheckout(): StripeCheckoutElementsSdk | undefined;
105
106
  /**
106
107
  * Reset service (for testing)
107
108
  */
@@ -1,4 +1,4 @@
1
- import { Stripe, StripeElements, StripeCheckout } from '@stripe/stripe-js';
1
+ import { Stripe, StripeElements, StripeCheckoutElementsSdk } from '@stripe/stripe-js';
2
2
  import type { IStripeService, StripeServiceState, CheckoutSessionOptions } from './interfaces';
3
3
  /**
4
4
  * Core Stripe Service
@@ -7,6 +7,9 @@ import type { IStripeService, StripeServiceState, CheckoutSessionOptions } from
7
7
  */
8
8
  declare class StripeServiceClass implements IStripeService {
9
9
  private store;
10
+ private intentClientSecret?;
11
+ /** Incremented on every init so that a slower, older call cannot overwrite newer state */
12
+ private initGeneration;
10
13
  private changeListeners;
11
14
  /**
12
15
  * Get the reactive state object
@@ -23,17 +26,18 @@ declare class StripeServiceClass implements IStripeService {
23
26
  /**
24
27
  * Initialize Stripe.js client with Payment Intent mode
25
28
  * @param publishableKey - Your Stripe publishable API key
26
- * @param options - Optional configuration
29
+ * @param options - Optional configuration (`clientSecret` is the PaymentIntent / SetupIntent client secret)
27
30
  */
28
31
  initialize(publishableKey: string, options?: {
29
32
  stripeAccount?: string;
30
33
  applicationName?: string;
34
+ clientSecret?: string;
31
35
  }): Promise<void>;
32
36
  /**
33
37
  * Initialize Stripe.js client with Checkout Session mode
34
38
  * @param publishableKey - Your Stripe publishable API key
35
39
  * @param checkoutSessionClientSecret - The client secret from Checkout Session
36
- * @param options - Optional configuration
40
+ * @param options - Optional configuration (`clientSecret` is the PaymentIntent / SetupIntent client secret)
37
41
  */
38
42
  initializeWithCheckoutSession(publishableKey: string, checkoutSessionClientSecret: string, options?: {
39
43
  stripeAccount?: string;
@@ -50,7 +54,7 @@ declare class StripeServiceClass implements IStripeService {
50
54
  /**
51
55
  * Get the current Checkout instance (for Checkout Session mode)
52
56
  */
53
- getCheckout(): StripeCheckout | undefined;
57
+ getCheckout(): StripeCheckoutElementsSdk | undefined;
54
58
  /**
55
59
  * Reset the service to initial state
56
60
  * Useful for testing and cleanup
@@ -63,6 +63,12 @@ export interface ShadowRootOptions {
63
63
  * focusable part is given focus, and the shadow host is given any available `:focus` styling.
64
64
  */
65
65
  delegatesFocus?: boolean;
66
+ /**
67
+ * Sets the slot assignment mode for the shadow root. When set to `'manual'`, enables imperative
68
+ * slotting using the `HTMLSlotElement.assign()` method. Defaults to `'named'` for standard
69
+ * declarative slotting behavior.
70
+ */
71
+ slotAssignment?: 'manual' | 'named';
66
72
  }
67
73
  export interface ModeStyles {
68
74
  [modeName: string]: string | string[];
@@ -119,12 +125,34 @@ export interface EventOptions {
119
125
  */
120
126
  composed?: boolean;
121
127
  }
128
+ export interface AttachInternalsOptions {
129
+ /**
130
+ * Initial custom states to set on the ElementInternals.states CustomStateSet.
131
+ * Each key is the state name and the value is the initial boolean state.
132
+ *
133
+ * These states can be targeted with the CSS `:state()` pseudo-class.
134
+ *
135
+ * @example
136
+ * ```tsx
137
+ * @AttachInternals({ states: { open: true, active: false } })
138
+ * internals: ElementInternals;
139
+ * ```
140
+ *
141
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet
142
+ */
143
+ states?: {
144
+ [stateName: string]: boolean;
145
+ };
146
+ }
122
147
  export interface AttachInternalsDecorator {
123
- (): PropertyDecorator;
148
+ (opts?: AttachInternalsOptions): PropertyDecorator;
124
149
  }
125
150
  export interface ListenDecorator {
126
151
  (eventName: string, opts?: ListenOptions): CustomMethodDecorator<any>;
127
152
  }
153
+ export interface ResolveVarFunction {
154
+ <T>(variable: T): string;
155
+ }
128
156
  export interface ListenOptions {
129
157
  /**
130
158
  * Handlers can also be registered for an event other than the host itself.
@@ -153,7 +181,9 @@ export interface StateDecorator {
153
181
  (): PropertyDecorator;
154
182
  }
155
183
  export interface WatchDecorator {
156
- (propName: any): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
184
+ (propName: any, watchOptions?: {
185
+ immediate?: boolean;
186
+ }): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
157
187
  }
158
188
  export interface PropSerializeDecorator {
159
189
  (propName: any): CustomMethodDecorator<(newValue?: any, propName?: string, ...args: any[]) => string | null>;
@@ -208,6 +238,24 @@ export declare const AttachInternals: AttachInternalsDecorator;
208
238
  * https://stenciljs.com/docs/events#listen-decorator
209
239
  */
210
240
  export declare const Listen: ListenDecorator;
241
+ /**
242
+ * The `resolveVar()` function is a compile-time utility that resolves const variables
243
+ * and object properties to their string literal values. This allows variables to be
244
+ * used in `@Listen` and `@Event` decorators instead of hardcoded strings.
245
+ *
246
+ * @example
247
+ * ```ts
248
+ * const MY_EVENT = 'myEvent';
249
+ * @Listen(resolveVar(MY_EVENT))
250
+ * ```
251
+ *
252
+ * @example
253
+ * ```ts
254
+ * const EVENTS = { MY_EVENT: 'myEvent' } as const;
255
+ * @Event({ eventName: resolveVar(EVENTS.MY_EVENT) })
256
+ * ```
257
+ */
258
+ export declare const resolveVar: ResolveVarFunction;
211
259
  /**
212
260
  * The `@Method()` decorator is used to expose methods on the public API.
213
261
  * Class methods decorated with the @Method() decorator can be called directly
@@ -365,6 +413,27 @@ export declare function readTask(task: RafCallback): void;
365
413
  * Unhandled exception raised while rendering, during event handling, or lifecycles will trigger the custom event handler.
366
414
  */
367
415
  export declare const setErrorHandler: (handler: ErrorHandler) => void;
416
+ export type TagTransformer = (tag: string) => string;
417
+ /**
418
+ * Sets a tag transformer to be used when rendering your custom elements.
419
+ * ```ts
420
+ * setTagTransformer((tag) => {
421
+ * if (tag.startsWith('my-')) return `new-${tag}`
422
+ * return tag;
423
+ * });
424
+ * ```
425
+ * Will mean all your components that start with `my-` are defined instead with `new-my-` prefix.
426
+ *
427
+ * @param transformer the transformer function to use which must return a string.
428
+ */
429
+ export declare function setTagTransformer(transformer: TagTransformer): void;
430
+ /**
431
+ * Transforms a tag name using a transformer set via `setTagTransformer`
432
+ *
433
+ * @param tag - the tag to transform e.g. `my-tag`
434
+ * @returns the transformed tag e.g. `new-my-tag`
435
+ */
436
+ export declare function transformTag(tag: string): string;
368
437
  /**
369
438
  * @deprecated - Use `MixedInCtor` instead:
370
439
  * ```ts
@@ -568,7 +637,7 @@ export interface FunctionalUtilities {
568
637
  map: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => ChildNode) => VNode[];
569
638
  }
570
639
  export interface FunctionalComponent<T = {}> {
571
- (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[];
640
+ (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[] | null;
572
641
  }
573
642
  /**
574
643
  * A Child VDOM node
@@ -610,6 +679,7 @@ export declare namespace h {
610
679
  function h(sel: any, data: VNodeData | null, text: string): VNode;
611
680
  function h(sel: any, data: VNodeData | null, children: Array<VNode | undefined | null>): VNode;
612
681
  function h(sel: any, data: VNodeData | null, children: VNode): VNode;
682
+ function h(sel: any, data: VNodeData | null, ...children: (VNode | string | number)[]): VNode;
613
683
  namespace JSX {
614
684
  interface IntrinsicElements extends LocalJSX.IntrinsicElements, JSXBase.IntrinsicElements {
615
685
  [tagName: string]: any;
@@ -624,6 +694,36 @@ export declare function h(sel: any, children: Array<VNode | undefined | null>):
624
694
  export declare function h(sel: any, data: VNodeData | null, text: string): VNode;
625
695
  export declare function h(sel: any, data: VNodeData | null, children: Array<VNode | undefined | null>): VNode;
626
696
  export declare function h(sel: any, data: VNodeData | null, children: VNode): VNode;
697
+ export declare function h(sel: any, data: VNodeData | null, ...children: (VNode | string | number)[]): VNode;
698
+ /**
699
+ * Automatic JSX runtime functions for TypeScript's react-jsx mode.
700
+ * These functions are called automatically by TypeScript when using "jsx": "react-jsx".
701
+ * @param type type of node
702
+ * @param props properties of node
703
+ * @param key optional key for the node
704
+ * @returns a jsx vnode
705
+ */
706
+ export declare function jsx(type: any, props: any, key?: string): VNode;
707
+ /**
708
+ * Automatic JSX runtime functions for TypeScript's react-jsxmode with multiple children.
709
+ * @param type type of node
710
+ * @param props properties of node
711
+ * @param key optional key for the node
712
+ * @returns a jsx vnode
713
+ */
714
+ export declare function jsxs(type: any, props: any, key?: string): VNode;
715
+ /**
716
+ * Automatic JSX runtime functions for TypeScript's react-jsxdev mode.
717
+ * These functions are called automatically by TypeScript when using "jsx": "react-jsxdev".
718
+ * @param type type of node
719
+ * @param props properties of node
720
+ * @param key optional key for the node
721
+ * @param isStaticChildren indicates if the children are static
722
+ * @param source source information
723
+ * @param self reference to the component instance
724
+ * @returns a jsx vnode
725
+ */
726
+ export declare function jsxDEV(type: any, props: any, key?: string | number, isStaticChildren?: boolean, source?: any, self?: any): VNode;
627
727
  /**
628
728
  * A virtual DOM node
629
729
  */
@@ -653,7 +753,7 @@ declare namespace LocalJSX {
653
753
  export { LocalJSX as JSX };
654
754
  export declare namespace JSXBase {
655
755
  interface IntrinsicElements {
656
- slot: JSXBase.SlotAttributes;
756
+ slot: JSXBase.SlotAttributes<HTMLSlotElement>;
657
757
  a: JSXBase.AnchorHTMLAttributes<HTMLAnchorElement>;
658
758
  abbr: JSXBase.HTMLAttributes;
659
759
  address: JSXBase.HTMLAttributes;
@@ -823,7 +923,7 @@ export declare namespace JSXBase {
823
923
  use: JSXBase.SVGAttributes;
824
924
  view: JSXBase.SVGAttributes;
825
925
  }
826
- interface SlotAttributes extends JSXAttributes {
926
+ interface SlotAttributes<T = HTMLSlotElement> extends JSXAttributes<T> {
827
927
  name?: string;
828
928
  slot?: string;
829
929
  onSlotchange?: (event: Event) => void;
@@ -879,6 +979,9 @@ export declare namespace JSXBase {
879
979
  popoverTargetAction?: string;
880
980
  popoverTargetElement?: Element | null;
881
981
  popoverTarget?: string;
982
+ command?: string;
983
+ commandFor?: string;
984
+ commandfor?: string;
882
985
  }
883
986
  interface CanvasHTMLAttributes<T> extends HTMLAttributes<T> {
884
987
  height?: number | string;
@@ -967,6 +1070,7 @@ export declare namespace JSXBase {
967
1070
  importance?: 'low' | 'auto' | 'high';
968
1071
  height?: number | string;
969
1072
  loading?: 'lazy' | 'auto' | 'eager';
1073
+ referrerPolicy?: ReferrerPolicy;
970
1074
  sizes?: string;
971
1075
  src?: string;
972
1076
  srcSet?: string;
@@ -1747,6 +1851,7 @@ export interface CustomElementsDefineOptions {
1747
1851
  exclude?: string[];
1748
1852
  resourcesUrl?: string;
1749
1853
  syncQueue?: boolean;
1854
+ /** @deprecated in-favour of `setTagTransformer` and `transformTag` */
1750
1855
  transformTagName?: (tagName: string) => string;
1751
1856
  jmp?: (c: Function) => any;
1752
1857
  raf?: (c: FrameRequestCallback) => number;