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

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

@@ -11,6 +11,7 @@
  * https://github.com/Shopify/ui-api-design/issues/139
  */
 export type ComponentChildren = any;
+export type StringChildren = string;
 export interface GlobalProps {
 	/**
 	 * A unique identifier for the element.
@@ -43,6 +44,109 @@ export interface ActionSlots {
 	 */
 	secondaryActions?: ComponentChildren;
 }
+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;
+}
+export interface FocusEventProps {
+	/**
+	 * Callback when the element loses focus.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event
+	 */
+	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.
+	 */
+	waitUntil?: (promise: Promise<void>) => void;
+}
 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;
@@ -64,7 +168,7 @@ export interface BackgroundProps {
  *
  * @default 'auto'
  */
-export type ToneKeyword = "auto" | "neutral" | "info" | "success" | "caution" | "warning" | "critical" | "custom";
+export type ToneKeyword = "auto" | "neutral" | "info" | "success" | "caution" | "warning" | "critical" | "accent" | "custom";
 declare const privateIconArray: readonly [
 	"adjust",
 	"affiliate",
@@ -73,23 +177,23 @@ declare const privateIconArray: readonly [
 	"alert-circle",
 	"alert-diamond",
 	"alert-location",
-	"alert-octagon-filled",
 	"alert-octagon",
-	"alert-triangle-filled",
+	"alert-octagon-filled",
 	"alert-triangle",
+	"alert-triangle-filled",
 	"app-extension",
 	"apps",
 	"archive",
+	"arrow-down",
 	"arrow-down-circle",
 	"arrow-down-right",
-	"arrow-down",
-	"arrow-left-circle",
 	"arrow-left",
-	"arrow-right-circle",
+	"arrow-left-circle",
 	"arrow-right",
+	"arrow-right-circle",
+	"arrow-up",
 	"arrow-up-circle",
 	"arrow-up-right",
-	"arrow-up",
 	"arrows-in-horizontal",
 	"arrows-out-horizontal",
 	"attachment",
@@ -98,36 +202,39 @@ declare const privateIconArray: readonly [
 	"bag",
 	"bank",
 	"barcode",
+	"battery-low",
 	"bill",
 	"blank",
 	"blog",
-	"bolt-filled",
 	"bolt",
-	"book-open",
+	"bolt-filled",
 	"book",
+	"book-open",
 	"bug",
 	"bullet",
 	"business-entity",
-	"button-press",
 	"button",
+	"button-press",
 	"calculator",
+	"calendar",
 	"calendar-check",
 	"calendar-compare",
 	"calendar-list",
 	"calendar-time",
-	"calendar",
-	"camera-flip",
 	"camera",
+	"camera-flip",
 	"caret-down",
 	"caret-left",
 	"caret-right",
 	"caret-up",
+	"cart",
 	"cart-abandoned",
 	"cart-discount",
 	"cart-down",
+	"cart-filled",
 	"cart-sale",
+	"cart-send",
 	"cart-up",
-	"cart",
 	"cash-dollar",
 	"cash-euro",
 	"cash-pound",
@@ -139,8 +246,8 @@ declare const privateIconArray: readonly [
 	"chart-cohort",
 	"chart-donut",
 	"chart-funnel",
-	"chart-histogram-first-last",
 	"chart-histogram-first",
+	"chart-histogram-first-last",
 	"chart-histogram-flat",
 	"chart-histogram-full",
 	"chart-histogram-growth",
@@ -151,36 +258,36 @@ declare const privateIconArray: readonly [
 	"chart-popular",
 	"chart-stacked",
 	"chart-vertical",
+	"chat",
 	"chat-new",
 	"chat-referral",
-	"chat",
-	"check-circle-filled",
-	"check-circle",
 	"check",
+	"check-circle",
+	"check-circle-filled",
 	"checkbox",
-	"chevron-down-circle",
 	"chevron-down",
-	"chevron-left-circle",
+	"chevron-down-circle",
 	"chevron-left",
-	"chevron-right-circle",
+	"chevron-left-circle",
 	"chevron-right",
-	"chevron-up-circle",
+	"chevron-right-circle",
 	"chevron-up",
-	"circle-dashed",
+	"chevron-up-circle",
 	"circle",
+	"circle-dashed",
+	"clipboard",
 	"clipboard-check",
 	"clipboard-checklist",
-	"clipboard",
-	"clock-revert",
 	"clock",
-	"code-add",
+	"clock-revert",
 	"code",
+	"code-add",
+	"collection",
 	"collection-featured",
 	"collection-list",
 	"collection-reference",
-	"collection",
-	"color-none",
 	"color",
+	"color-none",
 	"compass",
 	"complete",
 	"compose",
@@ -191,76 +298,81 @@ declare const privateIconArray: readonly [
 	"corner-pill",
 	"corner-round",
 	"corner-square",
+	"credit-card",
 	"credit-card-cancel",
 	"credit-card-percent",
+	"credit-card-reader",
 	"credit-card-reader-chip",
 	"credit-card-reader-tap",
-	"credit-card-reader",
 	"credit-card-secure",
 	"credit-card-tap-chip",
-	"credit-card",
 	"crop",
 	"currency-convert",
+	"cursor",
 	"cursor-banner",
 	"cursor-option",
-	"cursor",
 	"data-presentation",
 	"data-table",
+	"database",
 	"database-add",
 	"database-connect",
-	"database",
 	"delete",
 	"delivered",
 	"delivery",
 	"desktop",
 	"disabled",
+	"disabled-filled",
+	"discount",
 	"discount-add",
+	"discount-automatic",
 	"discount-code",
-	"discount",
+	"discount-remove",
 	"dns-settings",
 	"dock-floating",
 	"dock-side",
+	"domain",
 	"domain-landing-page",
 	"domain-new",
 	"domain-redirect",
-	"domain",
 	"download",
 	"drag-drop",
 	"drag-handle",
+	"drawer",
 	"duplicate",
 	"edit",
+	"email",
 	"email-follow-up",
 	"email-newsletter",
-	"email",
 	"empty",
 	"enabled",
 	"enter",
-	"envelope-soft-pack",
 	"envelope",
+	"envelope-soft-pack",
 	"eraser",
 	"exchange",
 	"exit",
 	"export",
 	"external",
 	"eye-check-mark",
-	"eye-dropper-list",
 	"eye-dropper",
+	"eye-dropper-list",
 	"eye-first",
 	"eyeglasses",
 	"fav",
 	"favicon",
-	"file-list",
 	"file",
+	"file-list",
 	"filter",
+	"filter-active",
 	"flag",
 	"flip-horizontal",
 	"flip-vertical",
 	"flower",
+	"folder",
 	"folder-add",
 	"folder-down",
 	"folder-remove",
 	"folder-up",
-	"folder",
 	"food",
 	"foreground",
 	"forklift",
@@ -268,56 +380,62 @@ declare const privateIconArray: readonly [
 	"games",
 	"gauge",
 	"geolocation",
-	"gift-card",
 	"gift",
+	"gift-card",
 	"git-branch",
 	"git-commit",
 	"git-repository",
+	"globe",
 	"globe-asia",
 	"globe-europe",
 	"globe-lines",
 	"globe-list",
-	"globe",
+	"graduation-hat",
 	"grid",
+	"hashtag",
 	"hashtag-decimal",
 	"hashtag-list",
-	"hashtag",
 	"heart",
-	"hide-filled",
 	"hide",
+	"hide-filled",
 	"home",
+	"home-filled",
 	"icons",
 	"identity-card",
+	"image",
 	"image-add",
 	"image-alt",
 	"image-explore",
 	"image-magic",
 	"image-none",
 	"image-with-text-overlay",
-	"image",
 	"images",
 	"import",
 	"in-progress",
 	"incentive",
 	"incoming",
 	"incomplete",
-	"info-filled",
 	"info",
+	"info-filled",
 	"inheritance",
-	"inventory-updated",
 	"inventory",
+	"inventory-edit",
+	"inventory-list",
+	"inventory-transfer",
+	"inventory-updated",
 	"iq",
 	"key",
+	"keyboard",
 	"keyboard-filled",
 	"keyboard-hide",
-	"keyboard",
+	"keypad",
 	"label-printer",
-	"language-translate",
 	"language",
+	"language-translate",
 	"layout-block",
+	"layout-buy-button",
 	"layout-buy-button-horizontal",
 	"layout-buy-button-vertical",
-	"layout-buy-button",
 	"layout-column-1",
 	"layout-columns-2",
 	"layout-columns-3",
@@ -330,64 +448,73 @@ declare const privateIconArray: readonly [
 	"layout-sidebar-left",
 	"layout-sidebar-right",
 	"lightbulb",
-	"link-list",
 	"link",
+	"link-list",
 	"list-bulleted",
+	"list-bulleted-filled",
 	"list-numbered",
 	"live",
-	"location-none",
+	"live-critical",
+	"live-none",
 	"location",
+	"location-none",
 	"lock",
 	"map",
+	"markets",
 	"markets-euro",
 	"markets-rupee",
 	"markets-yen",
-	"markets",
 	"maximize",
-	"measurement-size-list",
 	"measurement-size",
-	"measurement-volume-list",
+	"measurement-size-list",
 	"measurement-volume",
-	"measurement-weight-list",
+	"measurement-volume-list",
 	"measurement-weight",
+	"measurement-weight-list",
 	"media-receiver",
 	"megaphone",
 	"mention",
+	"menu",
+	"menu-filled",
 	"menu-horizontal",
 	"menu-vertical",
-	"menu",
 	"merge",
 	"metafields",
+	"metaobject",
 	"metaobject-list",
 	"metaobject-reference",
-	"metaobject",
 	"microphone",
 	"minimize",
-	"minus-circle",
 	"minus",
+	"minus-circle",
 	"mobile",
-	"money-none",
 	"money",
+	"money-none",
+	"money-split",
 	"moon",
 	"nature",
-	"note-add",
 	"note",
+	"note-add",
 	"notification",
+	"order",
 	"order-batches",
 	"order-draft",
+	"order-filled",
 	"order-first",
 	"order-fulfilled",
 	"order-repeat",
 	"order-unfulfilled",
-	"order",
 	"orders-status",
 	"organization",
 	"outdent",
 	"outgoing",
+	"package",
+	"package-cancel",
 	"package-fulfilled",
 	"package-on-hold",
+	"package-reassign",
 	"package-returned",
-	"package",
+	"page",
 	"page-add",
 	"page-attachment",
 	"page-clock",
@@ -398,7 +525,6 @@ declare const privateIconArray: readonly [
 	"page-remove",
 	"page-report",
 	"page-up",
-	"page",
 	"pagination-end",
 	"pagination-start",
 	"paint-brush-flat",
@@ -408,50 +534,55 @@ declare const privateIconArray: readonly [
 	"passkey",
 	"paste",
 	"pause-circle",
-	"payment-capture",
 	"payment",
+	"payment-capture",
+	"payout",
 	"payout-dollar",
 	"payout-euro",
 	"payout-pound",
 	"payout-rupee",
 	"payout-yen",
-	"payout",
+	"person",
 	"person-add",
 	"person-exit",
+	"person-filled",
 	"person-list",
 	"person-lock",
 	"person-remove",
 	"person-segment",
-	"person",
 	"personalized-text",
+	"phablet",
+	"phone",
 	"phone-in",
 	"phone-out",
-	"phone",
-	"pin-remove",
 	"pin",
+	"pin-remove",
 	"plan",
-	"play-circle",
 	"play",
+	"play-circle",
+	"plus",
+	"plus-circle",
 	"plus-circle-down",
 	"plus-circle-filled",
 	"plus-circle-up",
-	"plus-circle",
-	"plus",
 	"point-of-sale",
+	"point-of-sale-register",
 	"price-list",
 	"print",
+	"product",
 	"product-add",
 	"product-cost",
+	"product-filled",
 	"product-list",
 	"product-reference",
 	"product-remove",
 	"product-return",
 	"product-unavailable",
-	"product",
-	"profile-filled",
 	"profile",
-	"question-circle-filled",
+	"profile-filled",
 	"question-circle",
+	"question-circle-filled",
+	"receipt",
 	"receipt-dollar",
 	"receipt-euro",
 	"receipt-folded",
@@ -460,7 +591,6 @@ declare const privateIconArray: readonly [
 	"receipt-refund",
 	"receipt-rupee",
 	"receipt-yen",
-	"receipt",
 	"receivables",
 	"redo",
 	"referral-code",
@@ -478,11 +608,12 @@ declare const privateIconArray: readonly [
 	"sandbox",
 	"save",
 	"savings",
+	"scan-qr-code",
+	"search",
 	"search-add",
 	"search-list",
 	"search-recent",
 	"search-resource",
-	"search",
 	"select",
 	"send",
 	"settings",
@@ -492,6 +623,7 @@ declare const privateIconArray: readonly [
 	"shield-pending",
 	"shield-person",
 	"shipping-label",
+	"shipping-label-cancel",
 	"shopcodes",
 	"slideshow",
 	"smiley-happy",
@@ -500,68 +632,70 @@ declare const privateIconArray: readonly [
 	"smiley-sad",
 	"social-ad",
 	"social-post",
+	"sort",
 	"sort-ascending",
 	"sort-descending",
-	"sort",
 	"sound",
 	"sports",
+	"star",
+	"star-circle",
 	"star-filled",
 	"star-half",
 	"star-list",
-	"star",
-	"status-active",
 	"status",
+	"status-active",
 	"stop-circle",
+	"store",
 	"store-import",
 	"store-managed",
 	"store-online",
-	"store",
 	"sun",
-	"table-masonry",
 	"table",
+	"table-masonry",
 	"tablet",
 	"target",
 	"tax",
 	"team",
+	"text",
 	"text-align-center",
 	"text-align-left",
 	"text-align-right",
 	"text-block",
 	"text-bold",
 	"text-color",
-	"text-font-list",
 	"text-font",
+	"text-font-list",
 	"text-grammar",
 	"text-in-columns",
 	"text-in-rows",
-	"text-indent-remove",
 	"text-indent",
+	"text-indent-remove",
 	"text-italic",
 	"text-quote",
 	"text-title",
 	"text-underline",
 	"text-with-image",
-	"text",
+	"theme",
 	"theme-edit",
 	"theme-store",
 	"theme-template",
-	"theme",
 	"three-d-environment",
 	"thumbs-down",
 	"thumbs-up",
 	"tip-jar",
 	"toggle-off",
 	"toggle-on",
+	"transaction",
+	"transaction-fee-add",
 	"transaction-fee-dollar",
 	"transaction-fee-euro",
 	"transaction-fee-pound",
 	"transaction-fee-rupee",
 	"transaction-fee-yen",
-	"transaction",
+	"transfer",
 	"transfer-in",
 	"transfer-internal",
 	"transfer-out",
-	"transfer",
 	"truck",
 	"undo",
 	"unknown-device",
@@ -577,12 +711,12 @@ declare const privateIconArray: readonly [
 	"wand",
 	"watch",
 	"wifi",
-	"work-list",
 	"work",
+	"work-list",
 	"wrench",
-	"x-circle-filled",
+	"x",
 	"x-circle",
-	"x"
+	"x-circle-filled"
 ];
 export type IconType = (typeof privateIconArray)[number];
 /**
@@ -591,6 +725,7 @@ export type IconType = (typeof privateIconArray)[number];
 export type ExtractStrict<T, U extends T> = Extract<T, U>;
 export type MaybeAllValuesShorthandProperty<T extends string> = T | `${T} ${T}` | `${T} ${T} ${T}` | `${T} ${T} ${T} ${T}`;
 export type MaybeTwoValuesShorthandProperty<T extends string> = T | `${T} ${T}`;
+export type MaybeResponsive<T> = T | `@container${string}`;
 /**
  * Prevents widening string literal types in a union to `string`.
  * @example
@@ -726,7 +861,7 @@ export interface DisplayProps {
 	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/display
 	 * @default 'auto'
 	 */
-	display?: "auto" | "none";
+	display?: MaybeResponsive<"auto" | "none">;
 }
 export interface AccessibilityRoleProps {
 	/**
@@ -901,7 +1036,7 @@ export interface PaddingProps {
 	 *
 	 * @default 'none'
 	 */
-	padding?: MaybeAllValuesShorthandProperty<PaddingKeyword>;
+	padding?: MaybeResponsive<MaybeAllValuesShorthandProperty<PaddingKeyword>>;
 	/**
 	 * Adjust the block-padding.
 	 *
@@ -911,7 +1046,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingBlock?: MaybeTwoValuesShorthandProperty<PaddingKeyword> | "";
+	paddingBlock?: MaybeResponsive<MaybeTwoValuesShorthandProperty<PaddingKeyword> | "">;
 	/**
 	 * Adjust the block-start padding.
 	 *
@@ -919,7 +1054,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingBlockStart?: PaddingKeyword | "";
+	paddingBlockStart?: MaybeResponsive<PaddingKeyword | "">;
 	/**
 	 * Adjust the block-end padding.
 	 *
@@ -927,7 +1062,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingBlockEnd?: PaddingKeyword | "";
+	paddingBlockEnd?: MaybeResponsive<PaddingKeyword | "">;
 	/**
 	 * Adjust the inline padding.
 	 *
@@ -937,7 +1072,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingInline?: MaybeTwoValuesShorthandProperty<PaddingKeyword> | "";
+	paddingInline?: MaybeResponsive<MaybeTwoValuesShorthandProperty<PaddingKeyword> | "">;
 	/**
 	 * Adjust the inline-start padding.
 	 *
@@ -945,7 +1080,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingInlineStart?: PaddingKeyword | "";
+	paddingInlineStart?: MaybeResponsive<PaddingKeyword | "">;
 	/**
 	 * Adjust the inline-end padding.
 	 *
@@ -953,7 +1088,7 @@ export interface PaddingProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	paddingInlineEnd?: PaddingKeyword | "";
+	paddingInlineEnd?: MaybeResponsive<PaddingKeyword | "">;
 }
 export type SizeUnits = `${number}px` | `${number}%` | `0`;
 export type SizeUnitsOrAuto = SizeUnits | "auto";
@@ -966,7 +1101,7 @@ export interface SizingProps {
 	 *
 	 * @default 'auto'
 	 */
-	blockSize?: SizeUnitsOrAuto;
+	blockSize?: MaybeResponsive<SizeUnitsOrAuto>;
 	/**
 	 * Adjust the minimum block size.
 	 *
@@ -974,7 +1109,7 @@ export interface SizingProps {
 	 *
 	 * @default '0'
 	 */
-	minBlockSize?: SizeUnits;
+	minBlockSize?: MaybeResponsive<SizeUnits>;
 	/**
 	 * Adjust the maximum block size.
 	 *
@@ -982,7 +1117,7 @@ export interface SizingProps {
 	 *
 	 * @default 'none'
 	 */
-	maxBlockSize?: SizeUnitsOrNone;
+	maxBlockSize?: MaybeResponsive<SizeUnitsOrNone>;
 	/**
 	 * Adjust the inline size.
 	 *
@@ -990,7 +1125,7 @@ export interface SizingProps {
 	 *
 	 * @default 'auto'
 	 */
-	inlineSize?: SizeUnitsOrAuto;
+	inlineSize?: MaybeResponsive<SizeUnitsOrAuto>;
 	/**
 	 * Adjust the minimum inline size.
 	 *
@@ -998,7 +1133,7 @@ export interface SizingProps {
 	 *
 	 * @default '0'
 	 */
-	minInlineSize?: SizeUnits;
+	minInlineSize?: MaybeResponsive<SizeUnits>;
 	/**
 	 * Adjust the maximum inline size.
 	 *
@@ -1006,7 +1141,7 @@ export interface SizingProps {
 	 *
 	 * @default 'none'
 	 */
-	maxInlineSize?: SizeUnitsOrNone;
+	maxInlineSize?: MaybeResponsive<SizeUnitsOrNone>;
 }
 export type BorderStyleKeyword = "none" | "solid" | "dashed" | "dotted" | "auto";
 export type BorderSizeKeyword = SizeKeyword | "none";
@@ -1103,92 +1238,35 @@ export interface OverflowProps {
 	/**
 	 * Sets the overflow behavior of the element.
 	 *
-	 * - `hidden`: clips the content when it is larger than the element’s container.
-	 * The element will not be scrollable and the users will not be able
-	 * to access the clipped content by dragging or using a scroll wheel on a mouse.
-	 * - `visible`: the content that extends beyond the element’s container is visible.
-	 *
-	 * @default 'visible'
-	 */
-	overflow?: "hidden" | "visible";
-}
-export interface BaseBoxProps extends AccessibilityVisibilityProps, BackgroundProps, DisplayProps, SizingProps, PaddingProps, BorderProps, OverflowProps {
-	/**
-	 * The content of the Box.
-	 */
-	children?: ComponentChildren;
-	/**
-	 * A label that describes the purpose or contents of the element.
-	 * When set, it will be announced to users using assistive technologies and will provide them with more context.
-	 *
-	 * Only use this when the element's content is not enough context for users using assistive technologies.
-	 */
-	accessibilityLabel?: string;
-}
-export interface BaseBoxPropsWithRole extends BaseBoxProps, AccessibilityRoleProps {
-}
-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?: (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`.
+	 * - `hidden`: clips the content when it is larger than the element’s container.
+	 * The element will not be scrollable and the users will not be able
+	 * to access the clipped content by dragging or using a scroll wheel on a mouse.
+	 * - `visible`: the content that extends beyond the element’s container is visible.
 	 *
-	 * @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
+	 * @default 'visible'
 	 */
-	onToggle?: (event: ToggleEvent$1) => void;
-}
-export type ToggleState = "open" | "closed";
-interface ToggleEvent$1 extends Event {
-	readonly newState: ToggleState;
-	readonly oldState: ToggleState;
+	overflow?: "hidden" | "visible";
 }
-export interface ExtendableEvent extends Event {
+export interface BaseBoxProps extends AccessibilityVisibilityProps, BackgroundProps, DisplayProps, SizingProps, PaddingProps, BorderProps, OverflowProps {
 	/**
-	 * 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.
+	 * The content of the Box.
+	 */
+	children?: ComponentChildren;
+	/**
+	 * A label that describes the purpose or contents of the element.
+	 * When set, it will be announced to users using assistive technologies and will provide them with more context.
 	 *
-	 * However, this may only be called synchronously during the dispatch of the event.
-	 * As in, you cannot call it after a `setTimeout` or microtask.
+	 * Only use this when the element's content is not enough context for users using assistive technologies.
 	 */
-	waitUntil?: (promise: Promise<void>) => void;
+	accessibilityLabel?: string;
+}
+export interface BaseBoxPropsWithRole extends BaseBoxProps, AccessibilityRoleProps {
+}
+interface BoxProps$1 extends BaseBoxPropsWithRole, GlobalProps {
 }
 export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
-	 * The behavior of the button.
+	 * The behavior of the Button.
 	 *
 	 * - `submit`: Used to indicate the component acts as a submit button, meaning it submits the closest form.
 	 * - `button`: Used to indicate the component acts as a button, meaning it has no default action.
@@ -1200,14 +1278,14 @@ export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 	 */
 	type?: "submit" | "button" | "reset";
 	/**
-	 * Callback when the button is activated.
+	 * 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?: (event: Event) => void;
 	/**
-	 * Disables the button, meaning it cannot be clicked or receive focus.
+	 * Disables the Button meaning it cannot be clicked or receive focus.
 	 *
 	 * @default false
 	 */
@@ -1215,7 +1293,7 @@ export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
 	 * Replaces content with a loading indicator while a background action is being performed.
 	 *
-	 * This also disables the button.
+	 * This also disables the Button.
 	 *
 	 * @default false
 	 */
@@ -1245,7 +1323,7 @@ export interface LinkBehaviorProps extends InteractionProps, FocusEventProps {
 	target?: "auto" | "_blank" | "_self" | "_parent" | "_top" | AnyString;
 	/**
 	 * Causes the browser to treat the linked URL as a download with the string being the file name.
-	 * Download only works for same-origin URLs, or the blob: and data: schemes.
+	 * Download only works for same-origin URLs or the `blob:` and `data:` schemes.
 	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download
 	 */
 	download?: string;
@@ -1293,7 +1371,7 @@ interface ButtonProps$1 extends GlobalProps, BaseClickableProps {
 	/**
 	 * A label that describes the purpose or contents of the Button. It will be read to users using assistive technologies such as screen readers.
 	 *
-	 * Use this when using only an icon or the button text is not enough context
+	 * Use this when using only an icon or the Button text is not enough context
 	 * for users using assistive technologies.
 	 */
 	accessibilityLabel?: string;
@@ -1302,13 +1380,13 @@ interface ButtonProps$1 extends GlobalProps, BaseClickableProps {
 	 */
 	children?: ComponentChildren;
 	/**
-	 * The type of icon to be displayed in the button.
+	 * The type of icon to be displayed in the Button.
 	 *
 	 * @default ''
 	 */
 	icon?: IconType | AnyString;
 	/**
-	 * The displayed inline width of the button.
+	 * The displayed inline width of the Button.
 	 *
 	 * - `auto`: the size of the button depends on the surface and context.
 	 * - `fill`: the button will takes up 100% of the available inline size.
@@ -1324,7 +1402,7 @@ interface ButtonProps$1 extends GlobalProps, BaseClickableProps {
 	 */
 	variant?: "auto" | "primary" | "secondary" | "tertiary";
 	/**
-	 * Sets the tone of the Button, based on the intention of the information being conveyed.
+	 * Sets the tone of the Button based on the intention of the information being conveyed.
 	 *
 	 * @default 'auto'
 	 */
@@ -1372,22 +1450,54 @@ export interface InputProps extends BaseInputProps {
 	 */
 	defaultValue?: string;
 }
-export interface FileInputProps<T extends File[] | File = File[]> extends BaseInputProps {
+export interface MultipleInputProps extends BaseInputProps {
 	/**
-	 * Callback when the user has **finished editing** a field, e.g. once they have blurred the field.
+	 * Callback when the user has selected option(s).
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event
 	 */
-	onChange?: (newValue: T) => void;
+	onChange?: (event: Event) => void;
 	/**
-	 * Callback when the user makes any changes in the field.
+	 * Callback when the user has selected option(s).
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event
+	 */
+	onInput?: (event: Event) => void;
+	/**
+	 * An array of the `value`s of the selected options.
+	 *
+	 * This is a convenience prop for setting the `selected` prop on child options.
+	 */
+	values?: string[];
+}
+export interface FileInputProps extends BaseInputProps {
+	/**
+	 * Callback when the user has **finished selecting** a file or files.
+	 */
+	onChange?: (event: Event) => void;
+	/**
+	 * Callback when the user makes any changes in the file selection.
 	 */
-	onInput?: (newValue: T) => void;
+	onInput?: (event: Event) => void;
+	/**
+	 * A string that represents the path to the selected file(s). If no file is selected yet, the value is an empty string ("").
+	 * When the user selected multiple files, the value represents the first file in the list of files they selected.
+	 * The value is always the file's name prefixed with "C:\fakepath\", which isn't the real path of the file.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/file#value
+	 *
+	 * @default ''
+	 */
+	value?: string;
 	/**
-	 * The current value for the field.
+	 * An array of File objects representing the files currently selected by the user.
+	 *
+	 * This property is read-only and cannot be directly modified.
+	 * To clear the selected files, set the `value` prop to an empty string or null.
 	 *
-	 * TODO: This is a read-only getter.
-	 * We haven't agreed how to represent that yet.
+	 * @default []
 	 */
-	value?: T;
+	files?: readonly File[];
 }
 export interface FieldErrorProps {
 	/**
@@ -1634,6 +1744,82 @@ interface CheckboxProps$1 extends GlobalProps, BaseCheckableProps, FieldErrorPro
 	 */
 	required?: boolean;
 }
+interface ChoiceProps$1 extends GlobalProps, BaseOptionProps {
+	/**
+	 * Content to use as the choice label.
+	 *
+	 * @implementation (StringChildren) The label is produced by extracting and
+	 * concatenating the text nodes from the provided content; any markup or
+	 * element structure is ignored.
+	 *
+	 * @implementation (ComponentChildren) Behaves as a slot: any elements passed
+	 * are rendered as the label content (subject to surface constraints); there
+	 * is no coercion to a string.
+	 */
+	children?: ComponentChildren | StringChildren;
+	/**
+	 * Additional text to provide context or guidance for the input.
+	 *
+	 * This text is displayed along with the input and its label
+	 * to offer more information or instructions to the user.
+	 *
+	 * @implementation this content should be linked to the input with an `aria-describedby` attribute.
+	 */
+	details?: ComponentChildren;
+	/**
+	 * Set to `true` to associate a choice with the error passed to `ChoiceList`
+	 *
+	 * @default false
+	 */
+	error?: boolean;
+	/**
+	 * Secondary content for a choice.
+	 */
+	secondaryContent?: ComponentChildren;
+	/**
+	 * Content to display when the option is selected.
+	 *
+	 * This can be used to provide additional information or options related to the choice.
+	 */
+	selectedContent?: ComponentChildren;
+}
+interface ChoiceListProps$1 extends GlobalProps, Pick<BasicFieldProps, "label" | "labelAccessibilityVisibility" | "error">, MultipleInputProps, FieldDetailsProps {
+	/**
+	 * Whether multiple choices can be selected.
+	 *
+	 * @default false
+	 */
+	multiple?: boolean;
+	/**
+	 * The choices a user can select from.
+	 *
+	 * Accepts `Choice` components.
+	 */
+	children?: ComponentChildren;
+	/**
+	 * Disables the field, disallowing any interaction.
+	 *
+	 * `disabled` on any child choices is ignored when this is true.
+	 *
+	 * @default false
+	 */
+	disabled?: MultipleInputProps["disabled"];
+	/**
+	 * The variant of the choice grid.
+	 *
+	 * - `auto`: The variant is determined by the context.
+	 * - `list`: The choices are displayed in a list.
+	 * - `inline`: The choices are displayed on the inline axis.
+	 * - `block`: The choices are displayed on the block axis.
+	 * - `grid`: The choices are displayed in a grid.
+	 *
+	 * @implementation The `block`, `inline` and `grid` variants are more suitable for button looking choices, but it's at the
+	 * discretion of each surface.
+	 *
+	 * @default 'auto'
+	 */
+	variant?: "auto" | "list" | "inline" | "block" | "grid";
+}
 interface ClickableProps$1 extends GlobalProps, BaseBoxProps, BaseClickableProps {
 	/**
 	 * Disables the clickable, and indicates to assistive technology that the loading is in progress.
@@ -1730,6 +1916,181 @@ interface PhoneFieldProps$1 extends GlobalProps, BaseTextFieldProps, Pick<FieldD
 	 */
 	type?: "mobile" | "";
 }
+interface DatePickerProps$1 extends GlobalProps, InputProps, FocusEventProps {
+	/**
+	 * Default month to display in `YYYY-MM` format.
+	 *
+	 * This value is used until `view` is set, either directly or as a result of user interaction.
+	 *
+	 * Defaults to the current month in the user's locale.
+	 */
+	defaultView?: string;
+	/**
+	 * Displayed month in `YYYY-MM` format.
+	 *
+	 * `onViewChange` is called when this value changes.
+	 *
+	 * Defaults to `defaultView`.
+	 */
+	view?: string;
+	/**
+	 * Called whenever the month to display changes.
+	 *
+	 * @param view The new month to display in `YYYY-MM` format.
+	 */
+	onViewChange?: (view: string) => void;
+	/**
+	 * The type of selection the date picker allows.
+	 *
+	 * - `single` allows selecting a single date.
+	 * - `multiple` allows selecting multiple non-contiguous dates.
+	 * - `range` allows selecting a single range of dates.
+	 *
+	 * @default "single"
+	 */
+	type?: "single" | "multiple" | "range";
+	/**
+	 * Dates that can be selected.
+	 *
+	 * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
+	 *
+	 * The default `''` allows all dates.
+	 *
+	 * - Dates in `YYYY-MM-DD` format allow a single date.
+	 * - Dates in `YYYY-MM` format allow a whole month.
+	 * - Dates in `YYYY` format allow a whole year.
+	 * - Ranges are expressed as `start--end`.
+	 *     - Ranges are inclusive.
+	 *     - If either `start` or `end` is omitted, the range is unbounded in that direction.
+	 *     - If parts of the date are omitted for `start`, they are assumed to be the minimum possible value.
+	 *       So `2024--` is equivalent to `2024-01-01--`.
+	 *     - If parts of the date are omitted for `end`, they are assumed to be the maximum possible value.
+	 *       So `--2024` is equivalent to `--2024-12-31`.
+	 *     - Whitespace is allowed either side of `--`.
+	 *
+	 * @default ""
+	 *
+	 * @example
+	 * `2024-02--2025` // allow any date from February 2024 to the end of 2025
+	 * `2024-02--` // allow any date from February 2024 to the end of the month
+	 * `2024-05-09, 2024-05-11` // allow only the 9th and 11th of May 2024
+	 */
+	allow?: string;
+	/**
+	 * Dates that cannot be selected. These subtract from `allow`.
+	 *
+	 * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
+	 *
+	 * The default `''` has no effect on `allow`.
+	 *
+	 * - Dates in `YYYY-MM-DD` format disallow a single date.
+	 * - Dates in `YYYY-MM` format disallow a whole month.
+	 * - Dates in `YYYY` format disallow a whole year.
+	 * - Ranges are expressed as `start--end`.
+	 *     - Ranges are inclusive.
+	 *     - If either `start` or `end` is omitted, the range is unbounded in that direction.
+	 *     - If parts of the date are omitted for `start`, they are assumed to be the minimum possible value.
+	 *       So `2024--` is equivalent to `2024-01-01--`.
+	 *     - If parts of the date are omitted for `end`, they are assumed to be the maximum possible value.
+	 *       So `--2024` is equivalent to `--2024-12-31`.
+	 *     - Whitespace is allowed either side of `--`.
+	 *
+	 * @default ""
+	 *
+	 * @example
+	 * `--2024-02` // disallow any date before February 2024
+	 * `2024-05-09, 2024-05-11` // disallow the 9th and 11th of May 2024
+	 */
+	disallow?: string;
+	/**
+	 * Days of the week that can be selected. These intersect with the result of `allow` and `disallow`.
+	 *
+	 * A comma-separated list of days. Whitespace is allowed after commas.
+	 *
+	 * The default `''` has no effect on the result of `allow` and `disallow`.
+	 *
+	 * Days are `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.
+	 *
+	 * @default ""
+	 *
+	 * @example
+	 * 'saturday, sunday' // allow only weekends within the result of `allow` and `disallow`.
+	 */
+	allowDays?: string;
+	/**
+	 * Days of the week that cannot be selected. This subtracts from `allowDays`, and intersects with the result of `allow` and `disallow`.
+	 *
+	 * A comma-separated list of days. Whitespace is allowed after commas.
+	 *
+	 * The default `''` has no effect on `allowDays`.
+	 *
+	 * Days are `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.
+	 *
+	 * @default ""
+	 *
+	 * @example
+	 * 'saturday, sunday' // disallow weekends within the result of `allow` and `disallow`.
+	 */
+	disallowDays?: string;
+	/**
+	 * Default selected value.
+	 *
+	 * The default means no date is selected.
+	 *
+	 * If the provided value is invalid, no date is selected.
+	 *
+	 * - If `type="single"`, this is a date in `YYYY-MM-DD` format.
+	 * - If `type="multiple"`, this is a comma-separated list of dates in `YYYY-MM-DD` format.
+	 * - If `type="range"`, this is a range in `YYYY-MM-DD--YYYY-MM-DD` format. The range is inclusive.
+	 *
+	 * @default ""
+	 */
+	defaultValue?: string;
+	/**
+	 * Current selected value.
+	 *
+	 * The default means no date is selected.
+	 *
+	 * If the provided value is invalid, no date is selected.
+	 *
+	 * Otherwise:
+	 *
+	 * - If `type="single"`, this is a date in `YYYY-MM-DD` format.
+	 * - If `type="multiple"`, this is a comma-separated list of dates in `YYYY-MM-DD` format.
+	 * - If `type="range"`, this is a range in `YYYY-MM-DD--YYYY-MM-DD` format. The range is inclusive.
+	 *
+	 * @default ""
+	 */
+	value?: string;
+	/**
+	 * Callback when any date is selected. Will fire before `onChange`.
+	 */
+	onInput?: (event: Event) => void;
+	/**
+	 * Callback when the `value` is changed. For `type="single"` and `type="multiple"`, this is the same as `onInput`.
+	 *      For `type="range"`, this is only called when the range is completed by selecting the end date of the range.
+	 */
+	onChange?: (event: Event) => void;
+}
+interface DateFieldProps$1 extends GlobalProps, BaseTextFieldProps, Pick<DatePickerProps$1, "view" | "defaultView" | "value" | "defaultValue" | "allow" | "disallow" | "allowDays" | "disallowDays" | "onViewChange">, AutocompleteProps<DateAutocompleteField> {
+	/**
+	 * Callback when the field has an invalid date.
+	 * This callback will be called, if the date typed is invalid or disabled.
+	 *
+	 * Dates that don’t exist or have formatting errors are considered invalid. Some examples of invalid dates are:
+	 * - 2021-02-31: February doesn’t have 31 days
+	 * - 2021-02-00: The day can’t be 00
+	 *
+	 * Disallowed dates are considered invalid.
+	 *
+	 * It’s important to note that this callback will be called only when the user **finishes editing** the date,
+	 * and it’s called right after the `onChange` callback.
+	 * The field is **not** validated on every change to the input. Once the buyer has signalled that
+	 * they have finished editing the field (typically, by blurring the field), the field gets validated and the callback is run if the value is invalid.
+	 */
+	onInvalid?: (event: Event) => void;
+}
+export type DateAutocompleteField = ExtractStrict<AnyAutocompleteField, "bday" | "bday-day" | "bday-month" | "bday-year" | "cc-expiry" | "cc-expiry-month" | "cc-expiry-year">;
 interface DetailsProps$1 extends GlobalProps, ToggleEventProps {
 	/**
 	 * The content of the details.
@@ -1770,13 +2131,7 @@ interface DetailsProps$1 extends GlobalProps, ToggleEventProps {
 }
 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.
+	 * Specify the direction of the divider. This uses [logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
 	 *
 	 * @default 'inline'
 	 */
@@ -1788,16 +2143,17 @@ interface DividerProps$1 extends GlobalProps {
 	 */
 	color?: ColorKeyword;
 }
-interface DropZoneProps$1 extends GlobalProps, FileInputProps<File[]>, BasicFieldProps {
+interface DropZoneProps$1 extends GlobalProps, FileInputProps, BasicFieldProps {
 	/**
-	 * A string representing the types of files that are accepted by the dropzone.
+	 * A string representing the types of files that are accepted by the drop zone.
 	 * This string is a comma-separated list of unique file type specifiers which can be one of the following:
 	 * - A file extension starting with a period (".") character (e.g. .jpg, .pdf, .doc)
 	 * - A valid MIME type string with no extensions
 	 *
-	 * If left empty, the dropzone will accept all files.
+	 * If omitted, all file types are accepted.
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/accept
+	 * @default ''
 	 */
 	accept?: string;
 	/**
@@ -1807,15 +2163,16 @@ interface DropZoneProps$1 extends GlobalProps, FileInputProps<File[]>, BasicFiel
 	 */
 	accessibilityLabel?: string;
 	/**
-	 * Defines if the user can select or drop multiple files at once.
+	 * Whether multiple files can be selected or dropped at once.
 	 *
 	 * @default false
 	 */
 	multiple?: boolean;
 	/**
-	 * Callback when rejected files are dropped. Files are rejected based on the `accept` prop.
+	 * Callback fired when rejected files are dropped.
+	 * Files are rejected based on the `accept` prop and are not added to `files`.
 	 */
-	onDropRejected?: (files: File[]) => void;
+	onDropRejected?: (event: Event) => void;
 }
 interface EmailFieldProps$1 extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<EmailAutocompleteField> {
 }
@@ -1858,7 +2215,7 @@ export interface GapProps {
 	 *
 	 * @default 'none'
 	 */
-	gap?: MaybeTwoValuesShorthandProperty<SpacingKeyword>;
+	gap?: MaybeResponsive<MaybeTwoValuesShorthandProperty<SpacingKeyword>>;
 	/**
 	 * Adjust spacing between elements in the block axis.
 	 *
@@ -1866,7 +2223,7 @@ export interface GapProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	rowGap?: SpacingKeyword | "";
+	rowGap?: MaybeResponsive<SpacingKeyword | "">;
 	/**
 	 * Adjust spacing between elements in the inline axis.
 	 *
@@ -1874,7 +2231,7 @@ export interface GapProps {
 	 *
 	 * @default '' - meaning no override
 	 */
-	columnGap?: SpacingKeyword | "";
+	columnGap?: MaybeResponsive<SpacingKeyword | "">;
 }
 export type BaselinePosition = "baseline" | "first baseline" | "last baseline";
 export type ContentDistribution = "space-between" | "space-around" | "space-evenly" | "stretch";
@@ -1911,14 +2268,14 @@ interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-columns
 	  @default 'none'
 	*/
-	gridTemplateColumns?: string;
+	gridTemplateColumns?: MaybeResponsive<string>;
 	/**
 	  Define rows and specify their size.
   
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/grid-template-rows
 	  @default 'none'
 	*/
-	gridTemplateRows?: string;
+	gridTemplateRows?: MaybeResponsive<string>;
 	/**
 	  Aligns the grid items along the inline (row) axis.
   
@@ -1927,7 +2284,7 @@ interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-items
 	  @default '' - meaning no override
 	*/
-	justifyItems?: JustifyItemsKeyword | "";
+	justifyItems?: MaybeResponsive<JustifyItemsKeyword | "">;
 	/**
 	  Aligns the grid items along the block (column) axis.
   
@@ -1936,14 +2293,14 @@ interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-items
 	  @default '' - meaning no override
 	*/
-	alignItems?: AlignItemsKeyword | "";
+	alignItems?: MaybeResponsive<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;
+	placeItems?: MaybeResponsive<`${AlignItemsKeyword} ${JustifyItemsKeyword}` | AlignItemsKeyword>;
 	/**
 	  Aligns the grid along the inline (row) axis.
   
@@ -1952,7 +2309,7 @@ interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
 	  @default '' - meaning no override
 	*/
-	justifyContent?: JustifyContentKeyword | "";
+	justifyContent?: MaybeResponsive<JustifyContentKeyword | "">;
 	/**
 	  Aligns the grid along the block (column) axis.
   
@@ -1961,14 +2318,14 @@ interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	  @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-content
 	  @default '' - meaning no override
 	*/
-	alignContent?: AlignContentKeyword | "";
+	alignContent?: MaybeResponsive<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;
+	placeContent?: MaybeResponsive<`${AlignContentKeyword} ${JustifyContentKeyword}` | AlignContentKeyword>;
 }
 interface GridItemProps$1 extends GlobalProps, BaseBoxPropsWithRole {
 	/**
@@ -2067,7 +2424,7 @@ interface HeadingProps$1 extends GlobalProps, AccessibilityVisibilityProps, Bloc
 	 */
 	accessibilityRole?: "heading" | ExtractStrict<AccessibilityRole, "presentation" | "none">;
 }
-interface IconProps$1 extends GlobalProps {
+interface IconProps$1 extends GlobalProps, Pick<InteractionProps, "interestFor"> {
 	/**
 	 * Sets the tone of the icon, based on the intention of the information being conveyed.
 	 *
@@ -2361,52 +2718,6 @@ interface MapMarkerProps$1 extends GlobalProps, InteractionProps, Pick<SizingPro
 	 */
 	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,
@@ -2446,6 +2757,9 @@ interface ModalProps$1 extends GlobalProps, BaseOverlayProps, BaseOverlayMethods
 	 */
 	children?: ComponentChildren;
 }
+interface MoneyFieldProps$1 extends GlobalProps, BaseTextFieldProps, NumberConstraintsProps, AutocompleteProps<MoneyAutocompleteField> {
+}
+export type MoneyAutocompleteField = ExtractStrict<AnyAutocompleteField, "transaction-amount">;
 interface NumberFieldProps$1 extends GlobalProps, BaseTextFieldProps, AutocompleteProps<NumberAutocompleteField>, NumberConstraintsProps, FieldDecorationProps {
 	/**
 	 * Sets the virtual keyboard.
@@ -2522,6 +2836,22 @@ interface PopoverProps$1 extends GlobalProps, BaseOverlayProps, BaseOverlayMetho
 	 */
 	children?: ComponentChildren;
 }
+interface PressButtonProps$1 extends GlobalProps, Pick<ButtonProps$1, "accessibilityLabel" | "children" | "icon" | "inlineSize" | "lang" | "tone" | "variant" | "disabled" | "loading" | "onClick" | "onBlur" | "onFocus"> {
+	/**
+	 * Whether the button is pressed.
+	 *
+	 * @default false
+	 */
+	pressed?: boolean;
+	/**
+	 * Whether the button is pressed by default.
+	 *
+	 * @default false
+	 *
+	 * @implementation `defaultPressed` reflects to the `pressed` attribute.
+	 */
+	defaultPressed?: boolean;
+}
 interface ProductThumbnailProps$1 extends GlobalProps, BaseImageProps {
 	/**
 	 * Decorates the product thumbnail with the quantity of the product.
@@ -2631,6 +2961,26 @@ interface QRCodeProps$1 extends GlobalProps {
 	 */
 	logo?: string;
 }
+interface QueryContainerProps$1 extends GlobalProps {
+	/**
+	 * The content of the container.
+	 */
+	children?: ComponentChildren;
+	/**
+	 * The name of the container, which can be used in your container queries to target this container specifically.
+	 *
+	 * We place the container name of `s-default` on every container. Because of this, it is not required to add a `containerName` identifier in your queries. For example, a `@container (inline-size <= 300px) none, auto` query is equivalent to `@container s-default (inline-size <= 300px) none, auto`.
+	 *
+	 * Any value set in `containerName` will be set alongside alongside `s-default`. For example, `containerName="my-container-name"` will result in a value of `s-default my-container-name` set on the `container-name` CSS property of the rendered HTML.
+	 *
+	 * @default ''
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/container-name
+	 *
+	 * @implementation You must always have a CSS `container-name` of `s-default` for this component.
+	 */
+	containerName?: string;
+}
 export type OverflowKeyword = "auto" | "hidden";
 interface ScrollBoxProps$1 extends GlobalProps, Omit<BaseBoxPropsWithRole, "overflow"> {
 	/**
@@ -2769,34 +3119,34 @@ interface StackProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
 	 */
 	children?: ComponentChildren;
 	/**
-	 * Sets how the children are placed within the Stack.
+	 * Sets how the children are placed within the Stack. This uses [logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
 	 *
 	 * @default 'block'
 	 *
 	 * @implementation the content will wrap if the direction is 'inline', and not wrap if the direction is 'block'
 	 */
-	direction?: "block" | "inline";
+	direction?: MaybeResponsive<"block" | "inline">;
 	/**
 	 * Aligns the Stack along the main axis.
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content
 	 * @default 'normal'
 	 */
-	justifyContent?: JustifyContentKeyword;
+	justifyContent?: MaybeResponsive<JustifyContentKeyword>;
 	/**
 	 * Aligns the Stack's children along the cross axis.
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-items
 	 * @default 'normal'
 	 */
-	alignItems?: AlignItemsKeyword;
+	alignItems?: MaybeResponsive<AlignItemsKeyword>;
 	/**
 	 * Aligns the Stack along the cross axis.
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/align-content
 	 * @default 'normal'
 	 */
-	alignContent?: AlignContentKeyword;
+	alignContent?: MaybeResponsive<AlignContentKeyword>;
 }
 interface SummaryProps$1 extends GlobalProps {
 	/**
@@ -2816,7 +3166,7 @@ interface SummaryProps$1 extends GlobalProps {
 }
 interface SwitchProps$1 extends GlobalProps, BaseCheckableProps, BasicFieldProps, FieldDetailsProps, FieldErrorProps {
 }
-interface TextProps$1 extends GlobalProps, AccessibilityVisibilityProps, BaseTypographyProps, DisplayProps {
+interface TextProps$1 extends GlobalProps, AccessibilityVisibilityProps, BaseTypographyProps, DisplayProps, Pick<InteractionProps, "interestFor"> {
 	/**
 	 * The content of the Text.
 	 */
@@ -2824,7 +3174,7 @@ interface TextProps$1 extends GlobalProps, AccessibilityVisibilityProps, BaseTyp
 	/**
 	 * Provide semantic meaning and default styling to the text.
 	 *
-	 * Other presentation properties on `<s-text>` override the default styling.
+	 * Other presentation properties on Text override the default styling.
 	 *
 	 * @default 'generic'
 	 */
@@ -2938,6 +3288,12 @@ interface TimeProps$1 extends GlobalProps {
 	 */
 	dateTime?: string;
 }
+interface TooltipProps$1 extends GlobalProps {
+	/**
+	 * The content of the Tooltip.
+	 */
+	children?: ComponentChildren;
+}
 interface UnorderedListProps$1 extends GlobalProps {
 }
 export interface URLFieldProps extends GlobalProps, BaseTextFieldProps, MinMaxLengthProps, AutocompleteProps<URLAutocompleteField> {