@shopify/ui-extensions 2025.10.0-rc.4 → 2025.10.0-rc.40

package/src/surfaces/checkout/components/components-shared.d.ts

@@ -1,17 +1,23 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 /**
  * TODO: Update `any` type here after this is resolved
  * https://github.com/Shopify/ui-api-design/issues/139
  */
 export type ComponentChildren = any;
-interface AbbreviationProps$1 {
+export interface GlobalProps {
+	/**
+	 * A unique identifier for the element.
+	 */
+	id?: string;
+}
+interface AbbreviationProps$1 extends GlobalProps {
 	/**
 	 * The content of the abbreviation or acronym.
 	 */
@@ -27,14 +33,18 @@ interface AbbreviationProps$1 {
 	 */
 	title?: string;
 }
-export type SizeKeyword = "small-500" | "small-400" | "small-300" | "small-200" | "small-100" | "small" | "base" | "large" | "large-100" | "large-200" | "large-300" | "large-400" | "large-500";
-export type ColorKeyword = "subdued" | "base" | "strong";
-export interface GlobalProps {
+export interface ActionSlots {
 	/**
-	 * A unique identifier for the element.
+	 * The primary action to perform, provided as a button or link type element.
 	 */
-	id?: string;
+	primaryAction?: ComponentChildren;
+	/**
+	 * The secondary actions to perform, provided as button or link type elements.
+	 */
+	secondaryActions?: ComponentChildren;
 }
+export type SizeKeyword = "small-500" | "small-400" | "small-300" | "small-200" | "small-100" | "small" | "base" | "large" | "large-100" | "large-200" | "large-300" | "large-400" | "large-500";
+export type ColorKeyword = "subdued" | "base" | "strong";
 export type BackgroundColorKeyword = "transparent" | ColorKeyword;
 export interface BackgroundProps {
 	/**
@@ -65,8 +75,8 @@ declare const privateIconArray: readonly [
 	"alert-location",
 	"alert-octagon-filled",
 	"alert-octagon",
-	"alert-triangle",
 	"alert-triangle-filled",
+	"alert-triangle",
 	"app-extension",
 	"apps",
 	"archive",
@@ -109,6 +119,8 @@ declare const privateIconArray: readonly [
 	"camera-flip",
 	"camera",
 	"caret-down",
+	"caret-left",
+	"caret-right",
 	"caret-up",
 	"cart-abandoned",
 	"cart-discount",
@@ -289,8 +301,9 @@ declare const privateIconArray: readonly [
 	"incentive",
 	"incoming",
 	"incomplete",
-	"info",
 	"info-filled",
+	"info",
+	"inheritance",
 	"inventory-updated",
 	"inventory",
 	"iq",
@@ -414,14 +427,15 @@ declare const privateIconArray: readonly [
 	"phone-in",
 	"phone-out",
 	"phone",
-	"pin",
 	"pin-remove",
+	"pin",
 	"plan",
 	"play-circle",
 	"play",
-	"plus-circle",
 	"plus-circle-down",
+	"plus-circle-filled",
 	"plus-circle-up",
+	"plus-circle",
 	"plus",
 	"point-of-sale",
 	"price-list",
@@ -464,6 +478,7 @@ declare const privateIconArray: readonly [
 	"sandbox",
 	"save",
 	"savings",
+	"search-add",
 	"search-list",
 	"search-recent",
 	"search-resource",
@@ -585,44 +600,48 @@ export type MaybeTwoValuesShorthandProperty<T extends string> = T | `${T} ${T}`;
  * //   ^? 'foo' | 'bar' | (string & {})
  */
 export type AnyString = string & {};
-export interface ActionSlots {
+/**
+ * This is purely to give the ability
+ * to have a space or not in the string literal types.
+ *
+ * For example in the `aspectRatio` property, `16/9` and `16 / 9` are both valid.
+ */
+export type optionalSpace = "" | " ";
+interface BadgeProps$1 extends GlobalProps {
 	/**
-	 * The primary action to perform, provided as a button or link type element.
+	 * The content of the Badge.
 	 */
-	primaryAction?: ComponentChildren;
+	children?: ComponentChildren;
 	/**
-	 * The secondary actions to perform, provided as button or link type elements.
+	 * Sets the tone of the Badge, based on the intention of the information being conveyed.
+	 *
+	 * @default 'auto'
 	 */
-	secondaryActions?: ComponentChildren;
-}
-/**
- * Used for Container Query-related props.
- */
-export interface ContainerProps {
+	tone?: ToneKeyword;
 	/**
-	 * The name of the container used for Container Queries.
+	 * Modify the color to be more or less intense.
 	 *
-	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/container-name
+	 * @default 'base'
+	 */
+	color?: ColorKeyword;
+	/**
+	 * The type of icon to be displayed in the badge.
 	 *
 	 * @default ''
-	 *
-	 * @implementation All components that implement this interface must put a containerName of `s-default` on the root element of that component, regardless of the value of `containerType`.
-	 * The developer-supplied containerName here would be in addition to the above-mentioned containerName.
 	 */
-	containerName?: string;
+	icon?: IconType | AnyString;
 	/**
-	 * The type of container used for Container Queries.
-	 *
-	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/container-type
-	 *
-	 * - `normal`: The element is not a query container for any container size queries.
-	 * - `inline-size`: Establishes a query container for dimensional queries on the inline axis of the container. Applies layout, style, and inline-size containment to the element.
+	 * The position of the icon in relation to the text.
+	 */
+	iconPosition?: "start" | "end";
+	/**
+	 * Adjusts the size.
 	 *
-	 * @default 'normal'
+	 * @default 'base'
 	 */
-	containerType?: "normal" | "inline-size";
+	size?: SizeKeyword;
 }
-interface BannerProps$1 extends GlobalProps, ActionSlots, ContainerProps {
+interface BannerProps$1 extends GlobalProps, ActionSlots {
 	/**
 	 * The title of the banner.
 	 *
@@ -673,7 +692,7 @@ interface BannerProps$1 extends GlobalProps, ActionSlots, ContainerProps {
 	 *
 	 * The `hidden` property will be `false` when this event fires.
 	 */
-	onDismiss?: () => void;
+	onDismiss?: (event: Event) => void;
 	/**
 	 * Event handler when the banner has fully hidden.
 	 *
@@ -683,7 +702,7 @@ interface BannerProps$1 extends GlobalProps, ActionSlots, ContainerProps {
 	 * this event must fire after the banner has fully hidden.
 	 * We can add an `onHide` event in future if we want to provide a hook for the start of the animation.
 	 */
-	onAfterHide?: () => void;
+	onAfterHide?: (event: Event) => void;
 	/**
 	 * Determines whether the banner is hidden.
 	 *
@@ -1093,7 +1112,7 @@ export interface OverflowProps {
 	 */
 	overflow?: "hidden" | "visible";
 }
-export interface BaseBoxProps extends GlobalProps, AccessibilityVisibilityProps, BackgroundProps, DisplayProps, SizingProps, PaddingProps, BorderProps, OverflowProps, ContainerProps {
+export interface BaseBoxProps extends AccessibilityVisibilityProps, BackgroundProps, DisplayProps, SizingProps, PaddingProps, BorderProps, OverflowProps {
 	/**
 	 * The content of the Box.
 	 */
@@ -1108,17 +1127,64 @@ export interface BaseBoxProps extends GlobalProps, AccessibilityVisibilityProps,
 }
 export interface BaseBoxPropsWithRole extends BaseBoxProps, AccessibilityRoleProps {
 }
-interface BoxProps$1 extends BaseBoxPropsWithRole {
+interface BoxProps$1 extends BaseBoxPropsWithRole, GlobalProps {
 }
 export interface FocusEventProps {
 	/**
 	 * Callback when the element loses focus.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event
 	 */
-	onBlur?: () => void;
+	onBlur?: (event: FocusEvent) => void;
 	/**
 	 * Callback when the element receives focus.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event
+	 */
+	onFocus?: (event: FocusEvent) => void;
+}
+export interface ToggleEventProps {
+	/**
+	 * Callback fired when the element state changes **after** any animations have finished.
+	 *
+	 * - If the element transitioned from hidden to showing, the `oldState` property will be set to `closed` and the
+	 *   `newState` property will be set to `open`.
+	 * - If the element transitioned from showing to hidden, the `oldState` property will be set to `open` and the
+	 *   `newState` will be `closed`.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+	 */
+	onAfterToggle?: (event: ToggleEvent$1) => void;
+	/**
+	 * Callback straight after the element state changes.
+	 *
+	 * - If the element is transitioning from hidden to showing, the `oldState` property will be set to `closed` and the
+	 *   `newState` property will be set to `open`.
+	 * - If the element is transitioning from showing to hidden, then `oldState` property will be set to `open` and the
+	 *   `newState` will be `closed`.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+	 */
+	onToggle?: (event: ToggleEvent$1) => void;
+}
+export type ToggleState = "open" | "closed";
+interface ToggleEvent$1 extends Event {
+	readonly newState: ToggleState;
+	readonly oldState: ToggleState;
+}
+export interface ExtendableEvent extends Event {
+	/**
+	 * Provide a promise that signals the length, and eventual success or failure of actions relating to the event.
+	 *
+	 * This may be called many times, which adds promises to the event.
+	 *
+	 * However, this may only be called synchronously during the dispatch of the event.
+	 * As in, you cannot call it after a `setTimeout` or microtask.
 	 */
-	onFocus?: () => void;
+	waitUntil?: (promise: Promise<void>) => void;
 }
 export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
@@ -1136,8 +1202,10 @@ export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
 	 * Callback when the button is activated.
 	 * This will be called before the action indicated by `type`.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event
 	 */
-	onClick?: () => void;
+	onClick?: (event: Event) => void;
 	/**
 	 * Disables the button, meaning it cannot be clicked or receive focus.
 	 *
@@ -1184,8 +1252,10 @@ export interface LinkBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
 	 * Callback when the link is activated.
 	 * This will be called before navigating to the location specified by `href`.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event
 	 */
-	onClick?: () => void;
+	onClick?: (event: Event) => void;
 }
 export interface InteractionProps {
 	/**
@@ -1212,6 +1282,10 @@ export interface InteractionProps {
 	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
 	 */
 	command?: "--auto" | "--show" | "--hide" | "--toggle" | "--copy";
+	/**
+	 * ID of a component that should respond to interest (e.g. hover and focus) on this component.
+	 */
+	interestFor?: string;
 }
 export interface BaseClickableProps extends ButtonBehaviorProps, LinkBehaviorProps {
 }
@@ -1277,12 +1351,16 @@ export interface BaseInputProps {
 export interface InputProps extends BaseInputProps {
 	/**
 	 * Callback when the user has **finished editing** a field, e.g. once they have blurred the field.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event
 	 */
-	onChange?: (newValue: string) => void;
+	onChange?: (event: Event) => void;
 	/**
 	 * Callback when the user makes any changes in the field.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event
 	 */
-	onInput?: (newValue: string) => void;
+	onInput?: (event: Event) => void;
 	/**
 	 * The current value for the field. If omitted, the field will be empty.
 	 */
@@ -1396,6 +1474,48 @@ export interface FieldDecorationProps {
 	 */
 	accessory?: ComponentChildren;
 }
+export interface NumberConstraintsProps {
+	/**
+	 * The highest decimal or integer to be accepted for the field.
+	 * When used with `step` the value will round down to the max number.
+	 *
+	 * Note: a user will still be able to use the keyboard to input a number higher than
+	 * the max. It is up to the developer to add appropriate validation.
+	 *
+	 * @default Infinity
+	 */
+	max?: number;
+	/**
+	 * The lowest decimal or integer to be accepted for the field.
+	 * When used with `step` the value will round up to the min number.
+	 *
+	 * Note: a user will still be able to use the keyboard to input a number lower than
+	 * the min. It is up to the developer to add appropriate validation.
+	 *
+	 * @default -Infinity
+	 */
+	min?: number;
+	/**
+	 * The amount the value can increase or decrease by. This can be an integer or decimal.
+	 * If a `max` or `min` is specified with `step` when increasing/decreasing the value
+	 * via the buttons, the final value will always round to the `max` or `min`
+	 * rather than the closest valid amount.
+	 *
+	 * @default 1
+	 */
+	step?: number;
+	/**
+	 * Sets the type of controls displayed in the field.
+	 *
+	 * - `stepper`: displays buttons to increase or decrease the value of the field by the stepping interval defined in the `step` property.
+	 * Appropriate mouse and [keyboard interactions](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/spinbutton_role#keyboard_interactions) to control the value of the field are enabled.
+	 * - `none`: no controls are displayed and users must input the value manually. Arrow keys and scroll wheels can’t be used either to avoid accidental changes.
+	 * - `auto`: the presence of the controls depends on the surface and context.
+	 *
+	 * @default 'auto'
+	 */
+	controls?: "auto" | "stepper" | "none";
+}
 export interface MinMaxLengthProps {
 	/**
 	 * Specifies the maximum number of characters allowed.
@@ -1410,6 +1530,138 @@ export interface MinMaxLengthProps {
 	 */
 	minLength?: number;
 }
+export interface BaseSelectableProps {
+	/**
+	 * A label used for users using assistive technologies like screen readers. When set, any children or `label` supplied will not be announced.
+	 * This can also be used to display a control without a visual label, while still providing context to users using screen readers.
+	 */
+	accessibilityLabel?: string;
+	/**
+	 * Disables the control, disallowing any interaction.
+	 *
+	 * @default false
+	 */
+	disabled?: boolean;
+	/**
+	 * The value used in form data when the control is checked.
+	 */
+	value?: string;
+}
+export interface BaseOptionProps extends BaseSelectableProps {
+	/**
+	 * Whether the control is active.
+	 *
+	 * @default false
+	 */
+	selected?: boolean;
+	/**
+	 * Whether the control is active by default.
+	 *
+	 * @implementation `defaultSelected` reflects to the `selected` attribute.
+	 *
+	 * @default false
+	 */
+	defaultSelected?: boolean;
+}
+export interface BaseCheckableProps extends BaseSelectableProps, InteractionProps {
+	/**
+	 * Visual content to use as the control label.
+	 */
+	label?: string;
+	/**
+	 * Whether the control is active.
+	 *
+	 * @default false
+	 */
+	checked?: boolean;
+	/**
+	 * Whether the control is active by default.
+	 *
+	 * @implementation `defaultChecked` reflects to the `checked` attribute.
+	 *
+	 * @default false
+	 */
+	defaultChecked?: boolean;
+	/**
+	 * An identifier for the control that is unique within the nearest
+	 * containing `Form` component.
+	 */
+	name?: string;
+	/**
+	 * A callback that is run whenever the control is changed.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event
+	 */
+	onChange?: (event: Event) => void;
+	/**
+	 * A callback that is run whenever the control is changed.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event
+	 */
+	onInput?: (event: Event) => void;
+}
+interface CheckboxProps$1 extends GlobalProps, BaseCheckableProps, FieldErrorProps, FieldDetailsProps {
+	/**
+	 * Whether to display the checkbox in an indeterminate state (neither checked or unchecked).
+	 *
+	 * In terms of appearance, this takes priority over the `checked` prop.
+	 * But this is purely a visual change.
+	 * Whether the value is submitted along with a form is still down to the `checked` prop.
+	 *
+	 * If `indeterminate` has not been explicitly set, and the `indeterminate` state hasn't been modified by the user (via clicking),
+	 * then `indeterminate` returns the value of `defaultIndeterminate`.
+	 *
+	 * @implementation The `indeterminate` property doesn't reflect to any attribute.
+	 */
+	indeterminate?: boolean;
+	/**
+	 * Whether the checkbox is in an `indeterminate` state by default.
+	 *
+	 * Similar to `defaultValue` and `defaultChecked`, this value applies until `indeterminate` is set, or user changes the state of the checkbox.
+	 *
+	 * @implementation `defaultIndeterminate` reflects to the `indeterminate` attribute.
+	 *
+	 * @default false
+	 */
+	defaultIndeterminate?: boolean;
+	/**
+	 * Whether the field needs a value. This requirement adds semantic value
+	 * to the field, but it will not cause an error to appear automatically.
+	 * If you want to present an error when this field is empty, you can do
+	 * so with the `error` property.
+	 *
+	 * @default false
+	 */
+	required?: boolean;
+}
+interface ClickableProps$1 extends GlobalProps, BaseBoxProps, BaseClickableProps {
+	/**
+	 * Disables the clickable, and indicates to assistive technology that the loading is in progress.
+	 *
+	 * This also disables the clickable.
+	 */
+	loading?: BaseClickableProps["loading"];
+	/**
+	 * Disables the clickable, meaning it cannot be clicked or receive focus.
+	 *
+	 * In this state, onClick will not fire.
+	 * If the click event originates from a child element, the event will immediately stop propagating from this element.
+	 *
+	 * However, items within the clickable can still receive focus and be interacted with.
+	 *
+	 * This has no impact on the visual state by default,
+	 * but developers are encouraged to style the clickable accordingly.
+	 */
+	disabled?: BaseClickableProps["disabled"];
+	/**
+	 * Indicate the text language. Useful when the text is in a different language than the rest of the page.
+	 * It will allow assistive technologies such as screen readers to invoke the correct pronunciation.
+	 * [Reference of values](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry) ("subtag" label)
+	 *
+	 * @default ''
+	 */
+	lang?: string;
+}
 interface ClipboardItemProps$1 extends GlobalProps {
 	/**
 	 * Plain text to be written to the clipboard.
@@ -1420,11 +1672,11 @@ interface ClipboardItemProps$1 extends GlobalProps {
 	/**
 	 * Callback run when the copy to clipboard succeeds.
 	 */
-	onCopy?: () => void;
+	onCopy?: (event: ClipboardEvent) => void;
 	/**
 	 * Callback run when the copy to clipboard fails.
 	 */
-	onCopyError?: () => void;
+	onCopyError?: (event: Event) => void;
 }
 export interface AutocompleteProps<AutocompleteField extends AnyAutocompleteField> {
 	/**
@@ -1467,6 +1719,75 @@ export type AutocompleteGroup = "shipping" | "billing";
 export type AutocompleteAddressGroup = "fax" | "home" | "mobile" | "pager";
 export type AnyAutocompleteField = "additional-name" | "address-level1" | "address-level2" | "address-level3" | "address-level4" | "address-line1" | "address-line2" | "address-line3" | "country-name" | "country" | "current-password" | "email" | "family-name" | "given-name" | "honorific-prefix" | "honorific-suffix" | "language" | "name" | "new-password" | "nickname" | "one-time-code" | "organization-title" | "organization" | "photo" | "postal-code" | "sex" | "street-address" | "transaction-amount" | "transaction-currency" | "url" | "username" | "bday-day" | "bday-month" | "bday-year" | "bday" | "cc-additional-name" | "cc-expiry-month" | "cc-expiry-year" | "cc-expiry" | "cc-family-name" | "cc-given-name" | "cc-name" | "cc-number" | "cc-csc" | "cc-type" | `${AutocompleteAddressGroup} email` | "impp" | `${AutocompleteAddressGroup} impp` | "tel" | "tel-area-code" | "tel-country-code" | "tel-extension" | "tel-local-prefix" | "tel-local-suffix" | "tel-local" | "tel-national" | `${AutocompleteAddressGroup} tel` | `${AutocompleteAddressGroup} tel-area-code` | `${AutocompleteAddressGroup} tel-country-code` | `${AutocompleteAddressGroup} tel-extension` | `${AutocompleteAddressGroup} tel-local-prefix` | `${AutocompleteAddressGroup} tel-local-suffix` | `${AutocompleteAddressGroup} tel-local` | `${AutocompleteAddressGroup} tel-national`;
 export type TextAutocompleteField = ExtractStrict<AnyAutocompleteField, "additional-name" | "address-level1" | "address-level2" | "address-level3" | "address-level4" | "address-line1" | "address-line2" | "address-line3" | "country-name" | "country" | "family-name" | "given-name" | "honorific-prefix" | "honorific-suffix" | "language" | "name" | "nickname" | "one-time-code" | "organization-title" | "organization" | "postal-code" | "sex" | "street-address" | "transaction-currency" | "username" | "cc-name" | "cc-given-name" | "cc-additional-name" | "cc-family-name" | "cc-type">;
+export type PhoneAutocompleteField = ExtractStrict<AnyAutocompleteField, "tel" | "tel-area-code" | "tel-country-code" | "tel-extension" | "tel-local-prefix" | "tel-local-suffix" | "tel-local" | "tel-national" | `${AutocompleteAddressGroup} tel` | `${AutocompleteAddressGroup} tel-area-code` | `${AutocompleteAddressGroup} tel-country-code` | `${AutocompleteAddressGroup} tel-extension` | `${AutocompleteAddressGroup} tel-local-prefix` | `${AutocompleteAddressGroup} tel-local-suffix` | `${AutocompleteAddressGroup} tel-local` | `${AutocompleteAddressGroup} tel-national`>;
+interface PhoneFieldProps$1 extends GlobalProps, BaseTextFieldProps, Pick<FieldDecorationProps, "accessory">, AutocompleteProps<PhoneAutocompleteField> {
+	/**
+	 * The type of number to collect.
+	 *
+	 * Specific style may be applied to each type to provide extra guidance to users. Note that no extra validation is performed based on the type.
+	 *
+	 * @default '' meaning no specific kind of phone number
+	 */
+	type?: "mobile" | "";
+}
+interface DetailsProps$1 extends GlobalProps, ToggleEventProps {
+	/**
+	 * The content of the details.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details
+	 */
+	children?: ComponentChildren;
+	/**
+	 * Name of the element.
+	 *
+	 * This can be used to create multiple named disclosure boxes that where only one can be open at a time.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details#multiple_named_disclosure_boxes
+	 */
+	name?: string;
+	/**
+	 * Whether the element is open.
+	 *
+	 * This does not reflect to any attribute.
+	 *
+	 * @default false
+	 */
+	open?: boolean;
+	/**
+	 * Indicates whether the element should be open by default.
+	 *
+	 * This reflects to the `open` attribute.
+	 *
+	 * @default false
+	 */
+	defaultOpen?: boolean;
+	/**
+	 * Sets the transition between the two states.
+	 *
+	 * @default 'auto'
+	 */
+	toggleTransition?: "none" | "auto";
+}
+interface DividerProps$1 extends GlobalProps {
+	/**
+	 * Specify the direction of the divider.
+	 *
+	 * An 'inline' divider separates blocks of content.
+	 * In a left-to-right or right-to-left writing mode, this would typically be a horizontal line.
+	 *
+	 * A 'block' divider separates items within the current line of content.
+	 * In a left-to-right or right-to-left writing mode, this would typically be a vertical line.
+	 *
+	 * @default 'inline'
+	 */
+	direction?: "inline" | "block";
+	/**
+	 * Modify the color to be more or less intense.
+	 *
+	 * @default 'base'
+	 */
+	color?: ColorKeyword;
+}
 interface DropZoneProps$1 extends GlobalProps, FileInputProps<File[]>, BasicFieldProps {
 	/**
 	 * A string representing the types of files that are accepted by the dropzone.
@@ -1494,32 +1815,25 @@ interface DropZoneProps$1 extends GlobalProps, FileInputProps<File[]>, BasicFiel
 	/**
 	 * Callback when rejected files are dropped. Files are rejected based on the `accept` prop.
 	 */
-	onDropRejected?(files: File[]): void;
+	onDropRejected?: (files: File[]) => void;
 }
-export interface ExtendableEvent extends Event {
-	/**
-	 * Provide a promise that signals the length, and eventual success or failure of actions relating to the event.
-	 *
-	 * This may be called many times, which adds promises to the event.
-	 *
-	 * However, this may only be called synchronously during the dispatch of the event.
-	 * As in, you cannot call it after a `setTimeout` or microtask.
-	 */
-	waitUntil: (promise: Promise<void>) => void;
+interface EmailFieldProps$1 extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<EmailAutocompleteField> {
 }
-interface FormProps$1 extends GlobalProps, ContainerProps {
+export type EmailAutocompleteField = ExtractStrict<AnyAutocompleteField, "email" | `${AutocompleteAddressGroup} email`>;
+interface FormProps$1 extends GlobalProps {
 	/**
-	 * Whether input elements within the form can be automatically completed by the browser.
-	 *
-	 * @default 'on'
+	 * The content of the form.
 	 */
-	autocomplete?: "on" | "off";
+	children?: ComponentChildren;
 	/**
 	 * Whether the form is able to be submitted.
 	 *
 	 * When set to `true`, this will also disable the implicit submit behavior of the form.
 	 *
 	 * @default false
+	 *
+	 * @deprecated Prevent default within the onSubmit callback using a local state instead. Deprecated in v1.6.0
+	 * @private
 	 */
 	disabled?: boolean;
 	/**
@@ -1532,11 +1846,7 @@ interface FormProps$1 extends GlobalProps, ContainerProps {
 	/**
 	 * A callback that is run when the form is reset.
 	 */
-	onReset?: () => void;
-	/**
-	 * The content of the form.
-	 */
-	children?: ComponentChildren;
+	onReset?: (event: Event) => void;
 }
 export type SpacingKeyword = SizeKeyword | "none";
 export interface GapProps {
@@ -1570,6 +1880,12 @@ export type BaselinePosition = "baseline" | "first baseline" | "last baseline";
 export type ContentDistribution = "space-between" | "space-around" | "space-evenly" | "stretch";
 export type ContentPosition = "center" | "start" | "end";
 export type OverflowPosition = `unsafe ${ContentPosition}` | `safe ${ContentPosition}`;
+/**
+ * Justify items defines the default justify-self for all items of the box, giving them all a default way of justifying each box along the appropriate axis.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-items
+ */
+export type JustifyItemsKeyword = "normal" | "stretch" | BaselinePosition | OverflowPosition | ContentPosition;
 /**
  * Align items sets the align-self value on all direct children as a group.
  *
@@ -1588,6 +1904,90 @@ export type JustifyContentKeyword = "normal" | ContentDistribution | OverflowPos
  * @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-content
  */
 export type AlignContentKeyword = "normal" | BaselinePosition | ContentDistribution | OverflowPosition | ContentPosition;
+interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
+	/**
+	  Define columns and specify their size.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-columns
+	  @default 'none'
+	*/
+	gridTemplateColumns?: string;
+	/**
+	  Define rows and specify their size.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-rows
+	  @default 'none'
+	*/
+	gridTemplateRows?: string;
+	/**
+	  Aligns the grid items along the inline (row) axis.
+  
+	  This overrides the inline value of `placeItems`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-items
+	  @default '' - meaning no override
+	*/
+	justifyItems?: JustifyItemsKeyword | "";
+	/**
+	  Aligns the grid items along the block (column) axis.
+  
+	  This overrides the block value of `placeItems`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-items
+	  @default '' - meaning no override
+	*/
+	alignItems?: AlignItemsKeyword | "";
+	/**
+	  A shorthand property for `justify-items` and `align-items`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/place-items
+	  @default 'normal normal'
+	*/
+	placeItems?: `${AlignItemsKeyword} ${JustifyItemsKeyword}` | AlignItemsKeyword;
+	/**
+	  Aligns the grid along the inline (row) axis.
+  
+	  This overrides the inline value of `placeContent`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
+	  @default '' - meaning no override
+	*/
+	justifyContent?: JustifyContentKeyword | "";
+	/**
+	  Aligns the grid along the block (column) axis.
+  
+	  This overrides the block value of `placeContent`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-content
+	  @default '' - meaning no override
+	*/
+	alignContent?: AlignContentKeyword | "";
+	/**
+	  A shorthand property for `justify-content` and `align-content`.
+  
+	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/place-content
+	  @default 'normal normal'
+	*/
+	placeContent?: `${AlignContentKeyword} ${JustifyContentKeyword}` | AlignContentKeyword;
+}
+interface GridItemProps$1 extends GlobalProps, BaseBoxPropsWithRole {
+	/**
+	 * Number of columns the item will span across
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-column
+	 *
+	 * @default 'auto'
+	 */
+	gridColumn?: `span ${number}` | "auto";
+	/**
+	 * Number of rows the item will span across
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-row
+	 *
+	 * @default 'auto'
+	 */
+	gridRow?: `span ${number}` | "auto";
+}
 export interface BaseTypographyProps {
 	/**
 	 * Modify the color to be more or less intense.
@@ -1643,7 +2043,7 @@ export interface BlockTypographyProps {
 	 */
 	lineClamp?: number;
 }
-interface HeadingProps$1 extends GlobalProps, AccessibilityVisibilityProps, BlockTypographyProps, ContainerProps {
+interface HeadingProps$1 extends GlobalProps, AccessibilityVisibilityProps, BlockTypographyProps {
 	/**
 	 * The content of the Heading.
 	 */
@@ -1733,13 +2133,6 @@ export interface BaseImageProps {
 	 */
 	srcSet?: string;
 }
-/**
- * This is purely to give the ability
- * to have a space or not in the string literal types.
- *
- * For example in the `aspectRatio` property, `16/9` and `16 / 9` are both valid.
- */
-export type optionalSpace = "" | " ";
 interface ImageProps$1 extends GlobalProps, BaseImageProps, BorderProps {
 	/**
 	 * Sets the semantic meaning of the component’s content. When set,
@@ -1803,13 +2196,13 @@ interface ImageProps$1 extends GlobalProps, BaseImageProps, BorderProps {
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onload
 	 */
-	onLoad?: () => void;
+	onLoad?: (event: Event) => void;
 	/**
 	 * Invoked on load error.
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onerror
 	 */
-	onError?: () => void;
+	onError?: (event: Event) => void;
 }
 interface LinkProps$1 extends GlobalProps, LinkBehaviorProps {
 	/**
@@ -1842,9 +2235,236 @@ interface ListItemProps$1 extends GlobalProps {
 	 */
 	children?: ComponentChildren;
 }
+interface MapProps$1 extends GlobalProps, SizingProps {
+	/**
+	 * A valid API key for the map service provider.
+	 *
+	 * The map service provider may require an API key. Without an API key the map could be hidden or render in a limited developer mode.
+	 */
+	apiKey?: string;
+	/**
+	 * Map center’s latitude in degrees.
+	 *
+	 * @default 0
+	 */
+	latitude?: number;
+	/**
+	 * Map center’s longitude in degrees.
+	 *
+	 * @default 0
+	 */
+	longitude?: number;
+	/**
+	 * A label that describes the purpose or contents of the map.
+	 *
+	 * When set, it will be announced to users using assistive technologies and will provide them with more context.
+	 */
+	accessibilityLabel?: string;
+	/**
+	 * The initial Map zoom level.
+	 *
+	 * Valid zoom values are numbers from zero up to 18.
+	 * Larger zoom values correspond to a higher resolution.
+	 *
+	 * @default 4
+	 */
+	zoom?: number;
+	/**
+	 * The maximum zoom level which will be displayed on the map.
+	 *
+	 * Valid zoom values are numbers from zero up to 18.
+	 *
+	 * @default 18
+	 */
+	maxZoom?: number;
+	/**
+	 * The minimum zoom level which will be displayed on the map.
+	 *
+	 * Valid zoom values are numbers from zero up to 18.
+	 *
+	 * @default 0
+	 */
+	minZoom?: number;
+	/**
+	 * Callback when the viewport bounds have changed or the map is resized.
+	 */
+	onBoundsChange?: (event: MapBoundsChangeEvent) => void;
+	/**
+	 * Callback when the map view changes.
+	 */
+	onViewChange?: (event: MapViewChangeEvent) => void;
+	/**
+	 * Callback when the user clicks on the map.
+	 */
+	onClick?: (event: MapClickEvent) => void;
+	/**
+	 * Callback when the user double-clicks on the map.
+	 */
+	onDblClick?: (event: MapDblClickEvent) => void;
+}
+interface Location$1 {
+	latitude?: number;
+	longitude?: number;
+}
+export interface Bounds {
+	northEast?: Location$1;
+	southWest?: Location$1;
+}
+export interface MapViewChangeEvent extends Event {
+	location?: Location$1;
+	zoom?: number;
+}
+export interface MapBoundsChangeEvent extends Event {
+	bounds?: Bounds;
+}
+export interface MapClickEvent extends Event {
+	location?: Location$1;
+}
+export interface MapDblClickEvent extends Event {
+	location?: Location$1;
+}
+interface MapMarkerProps$1 extends GlobalProps, InteractionProps, Pick<SizingProps, "blockSize" | "inlineSize"> {
+	/**
+	 * Marker’s location latitude in degrees.
+	 *
+	 * @default 0
+	 */
+	latitude?: number;
+	/**
+	 * Marker’s longitude latitude in degrees.
+	 *
+	 * @default 0
+	 */
+	longitude?: number;
+	/**
+	 * A label that describes the purpose of the marker. When set,
+	 * it will be announced to users using assistive technologies and will
+	 * provide them with more context.
+	 */
+	accessibilityLabel?: string;
+	/**
+	 * Allows grouping the marker in clusters when zoomed out.
+	 *
+	 * @default false
+	 */
+	clusterable?: boolean;
+	/**
+	 * The graphic to use as the marker.
+	 *
+	 * If unset, it will default to the provider’s default marker.
+	 */
+	graphic?: ComponentChildren;
+	/**
+	 * Callback when a marker is clicked.
+	 *
+	 * It does not trigger a click event on the map itself.
+	 */
+	onClick?: (event: Event) => void;
+}
+export interface BaseOverlayProps {
+	/**
+	 * Callback fired after the overlay is shown.
+	 */
+	onShow?: (event: Event) => void;
+	/**
+	 * Callback fired when the overlay is shown **after** any animations to show the overlay have finished.
+	 */
+	onAfterShow?: (event: Event) => void;
+	/**
+	 * Callback fired after the overlay is hidden.
+	 */
+	onHide?: (event: Event) => void;
+	/**
+	 * Callback fired when the overlay is hidden **after** any animations to hide the overlay have finished.
+	 */
+	onAfterHide?: (event: Event) => void;
+}
+/**
+ * Shared interfaces for web component methods.
+ *
+ * Methods are required (not optional) because:
+ * - Components implementing this interface must provide all methods
+ * - Unlike props/attributes, methods are not rendered in HTML but are JavaScript APIs
+ * - Consumers expect these methods to be consistently available on all instances
+ */
+export interface BaseOverlayMethods {
+	/**
+	 * Method to show an overlay.
+	 *
+	 * @implementation This is a method to be called on the element and not a callback and should hence be camelCase
+	 */
+	showOverlay: () => void;
+	/**
+	 * Method to hide an overlay.
+	 *
+	 * @implementation This is a method to be called on the element and not a callback and should hence be camelCase
+	 */
+	hideOverlay: () => void;
+	/**
+	 * Method to toggle the visiblity of an overlay.
+	 *
+	 * @implementation This is a method to be called on the element and not a callback and should hence be camelCase
+	 */
+	toggleOverlay: () => void;
+}
+interface ModalProps$1 extends GlobalProps, BaseOverlayProps, BaseOverlayMethods, ActionSlots {
+	/**
+	 * A label that describes the purpose of the modal. When set,
+	 * it will be announced to users using assistive technologies and will
+	 * provide them with more context.
+	 *
+	 * This overrides the `heading` prop for screen readers.
+	 */
+	accessibilityLabel?: string;
+	/**
+	 * A title that describes the content of the Modal.
+	 *
+	 */
+	heading?: string;
+	/**
+	 * Adjust the padding around the Modal content.
+	 *
+	 * `base`: applies padding that is appropriate for the element.
+	 *
+	 * `none`: removes all padding from the element. This can be useful when elements inside the Modal need to span
+	 * to the edge of the Modal. For example, a full-width image. In this case, rely on `Box` with a padding of 'base'
+	 * to bring back the desired padding for the rest of the content.
+	 *
+	 * @default 'base'
+	 */
+	padding?: "base" | "none";
+	/**
+	 * Adjust the size of the Modal.
+	 *
+	 * `max`: expands the Modal to its maximum size as defined by the host application, on both the horizontal and vertical axes.
+	 *
+	 * @default 'base'
+	 */
+	size?: SizeKeyword | "max";
+	/**
+	 * The content of the Modal.
+	 */
+	children?: ComponentChildren;
+}
+interface NumberFieldProps$1 extends GlobalProps, BaseTextFieldProps, AutocompleteProps<NumberAutocompleteField>, NumberConstraintsProps, FieldDecorationProps {
+	/**
+	 * Sets the virtual keyboard.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode
+	 * @default 'decimal'
+	 */
+	inputMode?: "decimal" | "numeric";
+}
+export type NumberAutocompleteField = ExtractStrict<AnyAutocompleteField, "one-time-code" | "cc-number" | "cc-csc">;
+interface OptionProps$1 extends GlobalProps, BaseOptionProps {
+	/**
+	 * The content to use as the label.
+	 */
+	children?: ComponentChildren;
+}
 interface OrderedListProps$1 extends GlobalProps {
 }
-interface ParagraphProps$1 extends GlobalProps, BaseTypographyProps, BlockTypographyProps, AccessibilityVisibilityProps, ContainerProps {
+interface ParagraphProps$1 extends GlobalProps, BaseTypographyProps, BlockTypographyProps, AccessibilityVisibilityProps {
 	/**
 	 * The content of the Text.
 	 */
@@ -1876,6 +2496,9 @@ export type ParagraphType =
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/small
  */
  | "small";
+interface PasswordFieldProps$1 extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<PasswordAutocompleteField> {
+}
+export type PasswordAutocompleteField = ExtractStrict<AnyAutocompleteField, "new-password" | "current-password">;
 interface PaymentIconProps$1 extends GlobalProps {
 	/**
 	 * The icon type of the payment method
@@ -1893,6 +2516,36 @@ interface PaymentIconProps$1 extends GlobalProps {
 	accessibilityLabel?: string;
 }
 export type PaymentIconName = "abn" | "acima-leasing" | "acuotaz" | "ada" | "addi" | "adyen" | "aeropay" | "affin-bank" | "affirm" | "aftee" | "afterpay-paynl-version" | "afterpay" | "airtel-money" | "airteltigo-mobile-money" | "aktia" | "akulaku-paylater" | "akulaku" | "alandsbanken" | "alfamart" | "alfamidi" | "alipay-hk" | "alipay-paynl-version" | "alipay" | "alliance-bank" | "alma" | "aman" | "amazon" | "ambank" | "american-express" | "amex" | "ansa-stored-value" | "ansa" | "anyday" | "apecoin" | "aplazo" | "apple-pay" | "aqsat" | "arbitrum" | "arhaus" | "arvato" | "ashley-plcc" | "ask" | "astrapay" | "atm-bersama" | "atobaraidotcom" | "atome" | "atone" | "atrato" | "au-kantan-kessai" | "au-pay" | "authorize-net" | "avalanche" | "axs" | "bancnet" | "banco-azteca" | "bancomat" | "bancontact" | "bangkok-bank" | "bank-islam" | "bank-muamalat" | "bank-rakyat" | "barclays" | "base" | "bbva-cie" | "bc-card" | "bca-klikpay" | "bca" | "bdo" | "belfius" | "benefit" | "best-buy-card" | "biercheque-paynl-version" | "bigc" | "billease" | "biller-paynl-version" | "billie" | "billink-method" | "billink" | "bitcoin-cash" | "bitcoin" | "bizum" | "blik" | "bnbchain" | "bni" | "bnp" | "bogus-app-coin" | "bogus" | "boleto" | "boodil" | "boost" | "bpi" | "braintree" | "bread-pay" | "bread" | "bri-direct-debit" | "bri" | "brimo" | "bsi" | "bsn" | "bss" | "busd" | "careem-pay" | "cartes-bancaires" | "cash-app-pay" | "cash" | "cashew" | "cashinvoice-latin-america" | "catch-payments" | "cebuana" | "cembrapay" | "centi" | "cetelem" | "checkout-finance" | "chinabank" | "cimb-clicks" | "cimb" | "circle-k" | "citadele" | "citi-pay" | "clave-telered" | "clearpay" | "clerq" | "cleverpay" | "clip" | "cliq" | "codensa" | "coinsph" | "collector-bank" | "coop" | "coppel-pay" | "credit-agricole" | "credit-key" | "creditclick-paynl-version" | "credix" | "cuotas" | "d-barai" | "dai" | "daily-yamazaki" | "dan-dan" | "dana" | "danamon-online" | "dankort" | "danske-bank" | "dappmx" | "dash" | "daviplata" | "de-cadeaukaart" | "depay" | "deutsche-bank" | "dinacard" | "diners-club" | "direct-bank-transfer-latin-america" | "directa24" | "directpay" | "discover" | "divido" | "dnb" | "docomo-barai" | "dogecoin" | "dropp" | "duitnow" | "duologi" | "dwolla" | "easywallet" | "ebucks" | "echelon-financing" | "ecpay" | "edenred" | "efecty" | "eft-secure" | "eftpos-au" | "eghl" | "elo" | "elv" | "empty" | "enets" | "eos" | "epayments" | "epospay" | "eps" | "erste" | "escrowcom" | "esr-paymentslip-switzerland" | "ethereum" | "etihad-guest-pay" | "etika" | "ewallet-indonesia" | "ewallet-philippines" | "ewallet-southkorea" | "facebook-pay" | "fairstone-payments" | "fam" | "familymart" | "fantom" | "farmlands" | "fashion-giftcard-paynlversion" | "fashioncheque" | "favepay" | "fawry" | "finloup" | "fintecture" | "fintoc" | "flexiti" | "float-payments" | "flying-blue-plus" | "forbrugsforeningen" | "forsa" | "fortiva" | "fps" | "fpx" | "freecharge" | "freedompay" | "futurepay-mytab" | "gcash" | "generalfinancing" | "generic" | "genoapay" | "gezondheidsbon-paynl-version" | "giftcard" | "giropay" | "givacard" | "glbe-paypal" | "glbe-plus" | "gmo-atokara" | "gmo-bank-transfer" | "gmo-postpay" | "gmo-virtualaccount" | "gnosis" | "google-pay" | "google-wallet" | "gopay" | "grabpay" | "grailpay" | "gusd" | "hana-card" | "handelsbanken" | "happy-pay" | "hello-clever" | "heylight" | "hitrustpay-transfer" | "home-credit" | "hong-leong-bank" | "hong-leong-connect" | "hsbc" | "huis-tuin-cadeau" | "humm" | "hyper" | "hypercard" | "hypercash" | "hyundai-card" | "ibexpay" | "ideal" | "in3-via-ideal" | "in3" | "inbank" | "indomaret" | "ing-homepay" | "interac" | "ivy" | "iwocapay-pay-later" | "jcb" | "jenius" | "jko" | "jousto" | "kakao-pay" | "kakebaraidotcom" | "kasikornbank" | "kasssh" | "katapult" | "kb-card" | "kbc-cbc" | "kcp-credit-card" | "kfast" | "khqr" | "klarna-pay-later" | "klarna-pay-now" | "klarna-slice-it" | "klarna" | "knaken-settle" | "knet" | "koalafi" | "koin" | "krediidipank" | "kredivo" | "krungsri" | "krungthai-bank" | "kueski-pay" | "kunst-en-cultuur-cadeaukaart" | "kuwait-finance-house" | "land-bank" | "laser" | "latitude-creditline-au" | "latitude-gem-au" | "latitude-gem-nz" | "latitude-go-au" | "latitudepay" | "lawson" | "laybuy-heart" | "laybuy" | "lbc" | "lhv" | "line-pay" | "linkaja" | "linkpay" | "litecoin" | "lku" | "lloyds" | "lotte-card" | "lpb" | "luminor" | "lunch-check" | "lydia" | "mach" | "mada" | "maestro" | "mandiri" | "mash" | "master" | "mastercard" | "masterpass" | "maxima" | "maya-bank" | "maya" | "maybank-qrpay" | "maybank" | "maybankm2u" | "mb-way" | "mb" | "mcash" | "medicinos-bankas" | "meeza" | "mercado-credito" | "mercado-pago" | "merpay" | "meta-pay" | "metro-bank" | "military-starcard" | "minicuotas" | "ministop" | "mobicred" | "mobikwik" | "mobilepay" | "mode" | "mokka" | "momopay" | "mondido" | "monero" | "monzo" | "mpesa" | "mtn-mobile-money" | "multisafepay" | "mybank" | "myfatoorah" | "n26" | "naps" | "nationale-bioscoopbon" | "nationale-entertainmentcard" | "natwest" | "naver-pay" | "nelo" | "nequi" | "netbanking" | "neteller" | "nh-card" | "nordea" | "notyd" | "novuna" | "npatobarai" | "npkakebarai" | "oca" | "ocbc-bank" | "octo-clicks" | "octopus" | "offline-bank-transfer-latin-america" | "ola-money" | "omannet" | "omasp" | "oney" | "online-banking" | "online-banktransfer" | "op" | "opay" | "openpay" | "optimism" | "orange-mobile-money" | "overstock-citicobrand" | "overstock-citiplcc" | "ovo" | "oxxo" | "ozow" | "pagoefectivo" | "paid" | "paidy" | "palawa" | "palawan" | "pastpay" | "pay-after-delivery-instalments" | "pay-by-bank-us" | "pay-by-bank" | "pay-easy" | "pay-pay" | "paybylink" | "paycash" | "payco" | "payconiq" | "payd" | "payfast-instant-eft" | "payflex" | "payid" | "payitmonthly" | "payjustnow" | "paymark-online-eftpos" | "paymaya" | "payme" | "paynow-mbank" | "paynow" | "payoo-qr" | "payoo" | "paypal" | "payplan" | "paypo" | "payrexx-bank-transfer" | "payright" | "paysafecard-paynl-version" | "paysafecard" | "paysafecash" | "paysera" | "paysquad" | "paytm" | "payto" | "paytomorrow" | "payu" | "payzapp" | "pei" | "perlasfinance" | "permata" | "pf-pay" | "pivo" | "pix" | "podium-cadeaukaart" | "pointspay" | "poli" | "polygon" | "poppankki" | "postfinance-card" | "postfinance-efinance" | "postpay" | "powered-by-ansa-stored-value" | "powered-by-ansa" | "powerpay" | "pps" | "prepaysolutions" | "progressive-leasing" | "przelew24" | "przelewy24-paynl-version" | "przelewy24" | "pse" | "public-bank" | "publicbank-pbe" | "qasitli" | "qliro" | "qr-promptpay" | "qris" | "qrph" | "rabbit-line-pay" | "rabobank" | "rakuten-pay" | "rapid-transfer" | "ratepay" | "raty-pekao" | "rcbc" | "rcs" | "reka" | "resolve-pay" | "revolut" | "rhb-bank" | "rhb-now" | "rietumu" | "riverty-paynl-version" | "riverty" | "rupay" | "saastopankki" | "sadad" | "sam" | "samsung-card" | "samsung-pay" | "santander" | "satisfi" | "satispay" | "sbpl" | "scalapay" | "scream-truck-wallet" | "scream-truck" | "seb" | "seicomart" | "sepa-bank-transfer" | "sepa-direct-debit" | "sequra" | "seven-eleven" | "sezzle" | "shib" | "shinhan-card" | "shop-pay" | "shopeepay" | "shopify-pay" | "siam-commercial" | "siauliu-bankas" | "siirto" | "sika-fsa" | "sika-hsa" | "sika" | "simpl" | "simple-pay" | "sinpe-movil" | "sistecredito" | "skeps" | "skrill-digital-wallet" | "slice-fnbo" | "smartpay" | "snap-checkout" | "snapmint" | "societe-generale" | "sofort" | "softbank" | "solana-pay-helio" | "solana-pay" | "solana" | "souhoola" | "spankki" | "sparkasse" | "spei" | "splitit" | "spotii" | "spraypay" | "standard-chartered" | "stc-pay" | "stoov" | "store-credit" | "stripe" | "sunkus" | "super-payments" | "svea-b2b-faktura" | "svea-b2b-invoice" | "svea-checkout" | "svea-credit-account" | "svea-delbetalning" | "svea-faktura" | "svea-invoice" | "svea-lasku" | "svea-ostukonto" | "svea-part-payment" | "svea-yrityslasku" | "sveaeramaksu" | "swedbank" | "swiftpay" | "swish" | "swissbilling" | "sympl" | "synchrony-pay" | "synchrony" | "tabby" | "tabit" | "taly" | "tamara" | "tandympayment" | "tasa-cero" | "tbi-bank" | "tcf" | "tendopay" | "tensile" | "tesco-lotus" | "thanachart-bank" | "timepayment" | "tiptop" | "todopay" | "toss" | "touch-n-go" | "tpay" | "trevipay" | "truelayer" | "truemoney-pay" | "trustly" | "twig-pay" | "twint" | "twoinvoice" | "uae-visa" | "uangme" | "ubp" | "underpay" | "unionpay" | "unipay" | "uob-ez-pay" | "uob-thai" | "uob" | "upi" | "urbo" | "urpay" | "usdc" | "usdp" | "v-pay" | "valu" | "venmo" | "ventipay" | "venus-plcc" | "viabill" | "vipps" | "visa-electron" | "visa" | "volksbank" | "volt" | "vvv-cadeaukaart-paynl-version" | "vvv-giftcard" | "waave-pay-by-bank" | "wallet" | "walley" | "wbtc" | "webshop-giftcard" | "wechat-pay" | "wechat-paynl-version" | "wegetfinancing" | "whish-checkout" | "whish-pay" | "wise" | "wissel" | "world-chain" | "xrp" | "yape" | "yappy" | "ymobile" | "younited-pay" | "zalopay" | "zapper" | "zingala" | "zinia" | "zip" | "zoodpay" | "zulily-credit-card" | "zustaina";
+interface PopoverProps$1 extends GlobalProps, BaseOverlayProps, BaseOverlayMethods, ToggleEventProps, SizingProps {
+	/**
+	 * The content of the popover.
+	 */
+	children?: ComponentChildren;
+}
+interface ProductThumbnailProps$1 extends GlobalProps, BaseImageProps {
+	/**
+	 * Decorates the product thumbnail with the quantity of the product.
+	 */
+	totalItems?: number;
+	/**
+	 * Adjusts the size the product thumbnail image.
+	 *
+	 * @default 'base'
+	 */
+	size?: SizeKeyword;
+	/**
+	 * Invoked when load of provided image completes successfully.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onload
+	 */
+	onLoad?: (event: Event) => void;
+	/**
+	 * Invoked on load error of provided image.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onerror
+	 */
+	onError?: (event: Event) => void;
+}
 interface ProgressProps$1 extends GlobalProps {
 	/**
 	 * A label that describes the purpose of the progress. When set,
@@ -1970,7 +2623,7 @@ interface QRCodeProps$1 extends GlobalProps {
 	 * Invoked when the conversion of `content` to a QR code fails.
 	 * If an error occurs, the QR code and its child elements will not be displayed.
 	 */
-	onError?: () => void;
+	onError?: (event: Event) => void;
 	/**
 	 * URL of an image to be displayed in the center of the QR code.
 	 * This is useful for branding or to indicate to the user what scanning the QR code will do.
@@ -1978,7 +2631,25 @@ interface QRCodeProps$1 extends GlobalProps {
 	 */
 	logo?: string;
 }
-interface SectionProps$1 extends GlobalProps, ContainerProps {
+export type OverflowKeyword = "auto" | "hidden";
+interface ScrollBoxProps$1 extends GlobalProps, Omit<BaseBoxPropsWithRole, "overflow"> {
+	/**
+	 * Sets the overflow behavior of the element.
+	 *
+	 * - `hidden`: clips the content when it is larger than the element’s container and the element will not be scrollable in that axis.
+	 * - `auto`: clips the content when it is larger than the element’s container and make it scrollable in that axis.
+	 *
+	 * 1-to-2-value syntax is supported but note that, contrary to the CSS, it uses flow-relative values and the order is:
+	 *
+	 * - 2 values: `block inline`
+	 *
+	 * @default 'auto'
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/overflow
+	 */
+	overflow?: OverflowKeyword | `${OverflowKeyword} ${OverflowKeyword}`;
+}
+interface SectionProps$1 extends GlobalProps, ActionSlots {
 	/**
 	 * The content of the Section.
 	 */
@@ -2008,6 +2679,74 @@ interface SectionProps$1 extends GlobalProps, ContainerProps {
 	 */
 	padding?: "base" | "none";
 }
+interface SelectProps$1 extends GlobalProps, AutocompleteProps<AnyAutocompleteField>, Pick<FieldDecorationProps, "icon">, Omit<FieldProps, "defaultValue">, FocusEventProps {
+	/**
+	 * The options a user can select from.
+	 *
+	 * Accepts `Option` and `OptionGroup` components.
+	 */
+	children?: ComponentChildren;
+}
+interface SheetProps$1 extends BaseOverlayProps, BaseOverlayMethods, ToggleEventProps, GlobalProps, ActionSlots {
+	/**
+	 * A label that describes the purpose of the sheet. When set,
+	 * it will be announced to users using assistive technologies and will
+	 * provide them with more context.
+	 *
+	 * This overrides the `heading` prop for screen readers.
+	 */
+	accessibilityLabel?: string;
+	/**
+	 * The content of the Sheet.
+	 */
+	children?: ComponentChildren;
+	/**
+	 * Indicates whether the Sheet should be open by default.
+	 * This property is necessary in some cases, but its usage is generally discouraged due to potential negative impacts on user experience.
+	 *
+	 * Developers should:
+	 * - Only set this property to true when there are vitally important behaviors of the application that depend on the user interacting with the sheet.
+	 * - Make every effort to conditionally hide the sheet based on the state of checkout. An explicit example is custom privacy consent, where the sheet should only be displayed when consent is necessary and has not yet been explicitly given by the user.
+	 *
+	 * This property is useful for when the Sheet needs to be rendered on the page load and not triggered by a user action.
+	 * The property should only take effect when the `Sheet` is rendered for the first time.
+	 * To toggle the Sheet after it has been rendered, use the `ui.showOverlay()` method instead.
+	 *
+	 * @default false
+	 */
+	defaultOpen?: boolean;
+	/**
+	 * A title that describes the content of the sheet.
+	 */
+	heading?: string;
+	/**
+	 * Adjust the padding of all edges.
+	 *
+	 * `base`: applies padding that is appropriate for the element. Note that it may result in no padding if Shopify
+	 * believes this is the right design decision in a particular context.
+	 *
+	 * `none`: removes all padding from the element. This can be useful when elements inside the Sheet need to span
+	 * to the edge of the Sheet. For example, a full-width image. In this case, rely on `Box` with a padding of 'base'
+	 * to bring back the desired padding for the rest of the content.
+	 *
+	 * @default 'base'
+	 */
+	padding?: "base" | "none";
+}
+interface SkeletonParagraphProps$1 extends GlobalProps {
+	/**
+	 * The content to be used as a base for the skeleton. This content will be hidden when the skeleton is visible.
+	 *
+	 * This can be useful when the skeleton is representing a known piece of content which is part of a larger
+	 * element that has not yet fully loaded.
+	 *
+	 * @implementation When `content` is specified, the visual skeleton should be the size of the content. The element should
+	 * still be a block layout.
+	 *
+	 * @default ''
+	 */
+	content?: string;
+}
 interface SpinnerProps$1 extends GlobalProps {
 	/**
 	 * Adjusts the size of the spinner icon.
@@ -2024,7 +2763,7 @@ interface SpinnerProps$1 extends GlobalProps {
 	 */
 	accessibilityLabel?: string;
 }
-interface StackProps$1 extends BaseBoxPropsWithRole, GapProps {
+interface StackProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	/**
 	 * The content of the Stack.
 	 */
@@ -2059,6 +2798,24 @@ interface StackProps$1 extends BaseBoxPropsWithRole, GapProps {
 	 */
 	alignContent?: AlignContentKeyword;
 }
+interface SummaryProps$1 extends GlobalProps {
+	/**
+	 * The content to use as the label.
+	 *
+	 * Interactive content is disallowed. For example, you can use a `<Text>` element for extra formatting but
+	 * elements like buttons and fields are not allowed.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary
+	 *
+	 * @implementation Surfaces may apply styling to this element. An icon suggesting the state (open or closed) of the
+	 * details element is recommended.
+	 *
+	 * @implementation Surface may decide to warn when interactive elements are used.
+	 */
+	children?: ComponentChildren;
+}
+interface SwitchProps$1 extends GlobalProps, BaseCheckableProps, BasicFieldProps, FieldDetailsProps, FieldErrorProps {
+}
 interface TextProps$1 extends GlobalProps, AccessibilityVisibilityProps, BaseTypographyProps, DisplayProps {
 	/**
 	 * The content of the Text.
@@ -2155,9 +2912,17 @@ export type TextType =
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span
  */
  | "generic";
+interface TextAreaProps$1 extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<TextAutocompleteField> {
+	/**
+	 * A number of visible text lines.
+	 *
+	 * @default 2
+	 */
+	rows?: number;
+}
 interface TextFieldProps$1 extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<TextAutocompleteField>, FieldDecorationProps {
 }
-interface TimeProps$1 {
+interface TimeProps$1 extends GlobalProps {
 	/**
 	 * The content of the Time.
 	 */
@@ -2175,5 +2940,8 @@ interface TimeProps$1 {
 }
 interface UnorderedListProps$1 extends GlobalProps {
 }
+export interface URLFieldProps extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<URLAutocompleteField> {
+}
+export type URLAutocompleteField = ExtractStrict<AnyAutocompleteField, "url" | "photo" | "impp" | `${AutocompleteAddressGroup} impp`>;