@shopify/ui-extensions 2025.10.0-rc.3 → 2025.10.0-rc.30

package/build/ts/surfaces/admin/components/shared.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 1.0.0 **/
+/** VERSION: 1.10.0 **/
 
 /* eslint-disable @typescript-eslint/ban-types */
 
@@ -8,7 +8,105 @@
  * TODO: Update `any` type here after this is resolved
  * https://github.com/Shopify/ui-api-design/issues/139
  */
-export type ComponentChildren = any;
+type ComponentChildren = any;
+export type StringChildren = string;
+export interface GlobalProps {
+  /**
+   * A unique identifier for the element.
+   */
+  id?: string;
+}
+export interface ActionProps {
+  /**
+   * The text to use as the Action modal’s title. If not provided, the name of the extension will be used.
+   */
+  heading?: string;
+}
+export interface ActionSlots {
+  /**
+   * The primary action to perform, provided as a button or link type element.
+   */
+  primaryAction?: ComponentChildren;
+  /**
+   * The secondary actions to perform, provided as button or link type elements.
+   */
+  secondaryActions?: ComponentChildren;
+}
+interface AdminActionProps$1 extends GlobalProps, ActionProps, ActionSlots {
+  /**
+   * Whether the action is in a loading state, such as initial page load or action opening.
+   * When true, the action could be in an inert state, which prevents user interaction.
+   *
+   * @default false
+   */
+  loading?: boolean;
+}
+interface AdminBlockProps$1 extends GlobalProps {
+  /**
+   * The text to use as the Block title in the block header. If not provided, the name of the
+   * extension will be used.
+   */
+  heading?: string;
+  /**
+   * The summary to display when the app block is collapsed.
+   * Summary longer than 30 characters will be truncated.
+   */
+  collapsedSummary?: string;
+}
+interface AdminPrintActionProps$1 extends GlobalProps {
+  /**
+   * Sets the src URL of the preview and the document to print.
+   * If not provided, the preview will show an empty state and the print button will be disabled.
+   * HTML, PDFs and images are supported.
+   */
+  src?: string;
+}
+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 type SizeKeyword =
   | 'small-500'
   | 'small-400'
@@ -24,11 +122,40 @@ export type SizeKeyword =
   | 'large-400'
   | 'large-500';
 export type ColorKeyword = 'subdued' | 'base' | 'strong';
-export interface GlobalProps {
+interface AvatarProps$1 extends GlobalProps {
   /**
-   * A unique identifier for the element.
+   * Initials to display in the avatar.
    */
-  id?: string;
+  initials?: string;
+  /**
+   * The URL or path to the image.
+   *
+   * Initials will be rendered as a fallback if `src` is not provided, fails to load or does not load quickly
+   */
+  src?: string;
+  /**
+   * 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;
+  /**
+   * Size of the avatar.
+   *
+   * @default 'base'
+   */
+  size?: SizeKeyword;
+  /**
+   * An alternative text that describes the avatar for the reader
+   * to understand what it is about or identify the user the avatar belongs to.
+   */
+  alt?: string;
 }
 export type BackgroundColorKeyword = 'transparent' | ColorKeyword;
 export interface BackgroundProps {
@@ -68,8 +195,8 @@ declare const privateIconArray: readonly [
   'alert-location',
   'alert-octagon-filled',
   'alert-octagon',
-  'alert-triangle',
   'alert-triangle-filled',
+  'alert-triangle',
   'app-extension',
   'apps',
   'archive',
@@ -112,6 +239,8 @@ declare const privateIconArray: readonly [
   'camera-flip',
   'camera',
   'caret-down',
+  'caret-left',
+  'caret-right',
   'caret-up',
   'cart-abandoned',
   'cart-discount',
@@ -242,6 +371,7 @@ declare const privateIconArray: readonly [
   'favicon',
   'file-list',
   'file',
+  'filter-active',
   'filter',
   'flag',
   'flip-horizontal',
@@ -292,8 +422,9 @@ declare const privateIconArray: readonly [
   'incentive',
   'incoming',
   'incomplete',
-  'info',
   'info-filled',
+  'info',
+  'inheritance',
   'inventory-updated',
   'inventory',
   'iq',
@@ -417,14 +548,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',
@@ -467,6 +599,7 @@ declare const privateIconArray: readonly [
   'sandbox',
   'save',
   'savings',
+  'search-add',
   'search-list',
   'search-recent',
   'search-resource',
@@ -592,6 +725,13 @@ export type MaybeTwoValuesShorthandProperty<T extends string> = T | `${T} ${T}`;
  * //   ^? 'foo' | 'bar' | (string & {})
  */
 export type AnyString = 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 BadgeProps$1 extends GlobalProps {
   /**
    * The content of the Badge.
@@ -626,50 +766,7 @@ interface BadgeProps$1 extends GlobalProps {
    */
   size?: SizeKeyword;
 }
-export interface ActionProps {
-  /**
-   * The text to use as the Action modal’s title. If not provided, the name of the extension will be used.
-   */
-  heading?: string;
-}
-export interface ActionSlots {
-  /**
-   * The primary action to perform, provided as a button or link type element.
-   */
-  primaryAction?: ComponentChildren;
-  /**
-   * The secondary actions to perform, provided as button or link type elements.
-   */
-  secondaryActions?: ComponentChildren;
-}
-/**
- * Used for Container Query-related props.
- */
-export interface ContainerProps {
-  /**
-   * The name of the container used for Container Queries.
-   *
-   * @see https://developer.mozilla.org/en-US/docs/Web/CSS/container-name
-   *
-   * @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;
-  /**
-   * 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.
-   *
-   * @default 'normal'
-   */
-  containerType?: 'normal' | 'inline-size';
-}
-interface BannerProps$1 extends GlobalProps, ActionSlots, ContainerProps {
+interface BannerProps$1 extends GlobalProps, ActionSlots {
   /**
    * The title of the banner.
    *
@@ -720,7 +817,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.
    *
@@ -730,7 +827,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.
    *
@@ -1152,15 +1249,13 @@ export interface OverflowProps {
   overflow?: 'hidden' | 'visible';
 }
 export interface BaseBoxProps
-  extends GlobalProps,
-    AccessibilityVisibilityProps,
+  extends AccessibilityVisibilityProps,
     BackgroundProps,
     DisplayProps,
     SizingProps,
     PaddingProps,
     BorderProps,
-    OverflowProps,
-    ContainerProps {
+    OverflowProps {
   /**
    * The content of the Box.
    */
@@ -1176,16 +1271,69 @@ export interface BaseBoxProps
 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;
+}
+interface AggregateError$1<T extends Error> extends Error {
+  errors: T[];
+}
+export interface ArgregatedErrorEvent<T extends Error> extends ErrorEvent {
+  error: AggregateError$1<T>;
 }
 export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
   /**
@@ -1203,8 +1351,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.
    *
@@ -1251,8 +1401,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 {
   /**
@@ -1279,6 +1431,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,
@@ -1330,6 +1486,23 @@ interface ButtonProps$1 extends GlobalProps, BaseClickableProps {
    */
   lang?: string;
 }
+interface ButtonGroupProps$1 extends GlobalProps, ActionSlots {
+  /**
+   * The content of the ButtonGroup.
+   */
+  children?: ComponentChildren;
+  /**
+   * The gap between elements.
+   * @default 'base'
+   */
+  gap?: 'base' | 'none';
+  /**
+   * Label for the button group that describes the content of the group for screen reader users to understand what's included.
+   *
+   * @implementation Used as a hidden heading or an aria-label on the wrapping element.
+   */
+  accessibilityLabel?: string;
+}
 export interface BaseInputProps {
   /**
    * An identifier for the field that is unique within the nearest containing form.
@@ -1345,12 +1518,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.
    */
@@ -1364,13 +1541,17 @@ export interface InputProps extends BaseInputProps {
 }
 export interface MultipleInputProps extends BaseInputProps {
   /**
-   * Callback when the user has selected file(s).
+   * Callback when the user has selected option(s).
+   *
+   * @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 has selected file(s).
+   * Callback when the user has selected option(s).
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event
    */
-  onInput?: (newValue: string[]) => void;
+  onInput?: (event: Event) => void;
   /**
    * An array of the `value`s of the selected options.
    *
@@ -1378,6 +1559,35 @@ export interface MultipleInputProps extends BaseInputProps {
    */
   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?: (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;
+  /**
+   * 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.
+   *
+   * @default []
+   */
+  files?: ReadonlyArray<File>;
+}
 export interface FieldErrorProps {
   /**
    * Indicate an error to the user. The field will be given a specific stylistic treatment
@@ -1586,12 +1796,16 @@ export interface BaseCheckableProps
   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?: (checked: boolean) => void;
+  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?: (checked: boolean) => void;
+  onInput?: (event: Event) => void;
 }
 interface CheckboxProps$1
   extends GlobalProps,
@@ -1631,11 +1845,42 @@ interface CheckboxProps$1
    */
   required?: boolean;
 }
+export interface ChipProps$1 {
+  /**
+   * The content of the chip.
+   */
+  children?: ComponentChildren;
+  /**
+   * The graphic to display inside of the chip.
+   *
+   * @implementation Only `s-icon` is supported.
+   */
+  graphic?: ComponentChildren;
+  /**
+   * A label that describes the purpose or contents of the Chip. It will be read to users using assistive technologies such as screen readers.
+   */
+  accessibilityLabel?: string;
+  /**
+   * Modify the color to be more or less intense.
+   *
+   * @default 'base'
+   */
+  color?: ColorKeyword;
+}
+interface ChipProps$2 extends ChipProps$1, GlobalProps {}
 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.
    */
-  label?: string;
+  children?: ComponentChildren | StringChildren;
   /**
    * Additional text to provide context or guidance for the input.
    *
@@ -1644,13 +1889,23 @@ interface ChoiceProps$1 extends GlobalProps, BaseOptionProps {
    *
    * @implementation this content should be linked to the input with an `aria-describedby` attribute.
    */
-  details?: string;
+  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,
@@ -1677,8 +1932,26 @@ interface ChoiceListProps$1
    * @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 BaseBoxProps, BaseClickableProps {
+interface ClickableProps$1
+  extends GlobalProps,
+    BaseBoxProps,
+    BaseClickableProps {
   /**
    * Disables the clickable, and indicates to assistive technology that the loading is in progress.
    *
@@ -1706,158 +1979,95 @@ interface ClickableProps$1 extends BaseBoxProps, BaseClickableProps {
    */
   lang?: string;
 }
-interface DatePickerProps$1 extends GlobalProps, InputProps, FocusEventProps {
+interface ClickableChipProps$1 extends ChipProps$1, GlobalProps {
   /**
-   * 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.
+   * Callback when the chip is clicked.
    */
-  defaultView?: string;
+  onClick?: (event: Event) => void;
   /**
-   * Displayed month in `YYYY-MM` format.
-   *
-   * `onViewChange` is called when this value changes.
+   * The URL to link to.
    *
-   * Defaults to `defaultView`.
+   * - If set, it will navigate to the location specified by `href` after executing the `click` event.
    */
-  view?: string;
+  href?: string;
   /**
-   * Called whenever the month to display changes.
+   * Whether the chip is removable.
    *
-   * @param view The new month to display in `YYYY-MM` format.
+   * @default false
    */
-  onViewChange?: (view: string) => void;
+  removable?: boolean;
   /**
-   * The type of selection the date picker allows.
+   * Callback when the chip is removed.
+   */
+  onRemove?: (event: Event) => void;
+  /**
+   * Determines whether the chip is hidden.
    *
-   * - `single` allows selecting a single date.
-   * - `multiple` allows selecting multiple non-contiguous dates.
-   * - `range` allows selecting a single range of dates.
+   * If this property is being set on each framework render (as in 'controlled' usage),
+   * and the chip is `removable`,
+   * ensure you update app state for this property when the `remove` event fires.
    *
-   * @default "single"
+   * If the chip is not `removable`, it can still be hidden by setting this property.
+   *
+   * @default false
    */
-  type?: 'single' | 'multiple' | 'range';
+  hidden?: boolean;
   /**
-   * Dates that can be selected.
-   *
-   * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
-   *
-   * The default `''` allows all dates.
+   * Event handler when the chip has fully hidden.
    *
-   * - 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 ""
+   * The `hidden` property will be `true` when this event fires.
    *
-   * @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
+   * @implementation If implementations animate the hiding of the chip,
+   * this event must fire after the chip has fully hidden.
+   * We can add an `onHide` event in future if we want to provide a hook for the start of the animation.
    */
-  allow?: string;
+  onAfterHide?: (event: Event) => void;
   /**
-   * Dates that cannot be selected. These subtract from `allowDates`.
-   *
-   * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
+   * Disables the chip, disallowing any interaction.
    *
-   * The default `''` has no effect on `allowDates`.
-   *
-   * - 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
+   * @default false
    */
-  disallow?: string;
+  disabled?: boolean;
+}
+interface ColorPickerProps$1 extends GlobalProps, InputProps {
   /**
-   * Days of the week that can be selected. These intersect with the result of `allowDates` and `disallowDates`.
-   *
-   * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
-   *
-   * The default `''` has no effect on the result of `allowDates` and `disallowDates`.
-   *
-   * Days are `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.
+   * Allow user to select an alpha value.
    *
-   * @default ""
-   *
-   * @example
-   * 'saturday, sunday' // allow only weekends within the result of `allowDates` and `disallowDates`.
+   * @default false
    */
-  allowDays?: string;
+  alpha?: boolean;
   /**
-   * Days of the week that cannot be selected. This subtracts from `allowDays`, and intersects with the result of `allowDates` and `disallowDates`.
-   *
-   * A comma-separated list of dates, date ranges. Whitespace is allowed after commas.
-   *
-   * The default `''` has no effect on `allowDays`.
-   *
-   * Days are `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.
-   *
-   * @default ""
+   * This callback will emit the value in hex.
    *
-   * @example
-   * 'saturday, sunday' // disallow weekends within the result of `allowDates` and `disallowDates`.
+   * If the `alpha` prop is `true`, `onChange` will emit an 8-value hex (#RRGGBBAA).
+   * If the `alpha` prop is `false`, `onChange` will emit a 6-value hex (#RRGGBB).
    */
-  disallowDays?: string;
+  onChange?: InputProps['onChange'];
   /**
-   * Default selected value.
+   * This callback will emit the value in hex.
    *
-   * 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 ""
+   * If the `alpha` prop is `true`, `onInput` will emit an 8-value hex (#RRGGBBAA).
+   * If the `alpha` prop is `false`, `onInput` will emit a 6-value hex (#RRGGBB).
    */
-  defaultValue?: string;
+  onInput?: InputProps['onChange'];
   /**
-   * Current selected value.
-   *
-   * The default means no date is selected.
-   *
-   * If the provided value is invalid, no date is selected.
+   * The currently selected color.
    *
-   * 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.
+   * Supported formats include:
+   * - HSL @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/hsl
+   * - HSLA @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/hsla
+   * - RGB @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/rgb
+   * - RGBA @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/rgb
+   * - Hex (3-value, 4-value, 6-value, 8-value) @see https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color
    *
-   * Events:
+   * For RGB and RGBA, both the legacy syntax (comma-separated) and modern syntax (space-separate) are supported.
+   * @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/rgb
    *
-   * - `onInput` - Invoked when any date is selected. Will fire before `onChange`.
-   * - `onChange` - Invoked 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.
+   * If the value is invalid, the component will select rgb(0, 0, 0).
    *
-   * @default ""
+   * Note that the `onChange` handler will emit the value in hex.
    */
-  value?: string;
+  value?: InputProps['value'];
 }
 export interface AutocompleteProps<
   AutocompleteField extends AnyAutocompleteField,
@@ -2004,6 +2214,168 @@ export type TextAutocompleteField = ExtractStrict<
   | 'cc-family-name'
   | 'cc-type'
 >;
+interface ColorFieldProps$1
+  extends GlobalProps,
+    BaseTextFieldProps,
+    Pick<ColorPickerProps$1, 'alpha' | 'value' | 'defaultValue'> {
+  autocomplete?: Extract<
+    AutocompleteProps<never>['autocomplete'],
+    'on' | 'off'
+  >;
+}
+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.
+   *
+   * Events:
+   *
+   * - `onInput` - Invoked when any date is selected. Will fire before `onChange`.
+   * - `onChange` - Invoked 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.
+   *
+   * @default ""
+   */
+  value?: string;
+}
 interface DividerProps$1 extends GlobalProps {
   /**
    * Specify the direction of the divider.
@@ -2024,6 +2396,37 @@ interface DividerProps$1 extends GlobalProps {
    */
   color?: ColorKeyword;
 }
+interface DropZoneProps$1 extends GlobalProps, FileInputProps, BasicFieldProps {
+  /**
+   * 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 omitted, all file types are accepted.
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/accept
+   * @default ''
+   */
+  accept?: string;
+  /**
+   * A label that describes the purpose or contents of the item. When set,
+   * it will be announced to buyers using assistive technologies and will
+   * provide them with more context.
+   */
+  accessibilityLabel?: string;
+  /**
+   * Whether multiple files can be selected or dropped at once.
+   *
+   * @default false
+   */
+  multiple?: boolean;
+  /**
+   * Callback fired when rejected files are dropped.
+   * Files are rejected based on the `accept` prop and are not added to `files`.
+   */
+  onDropRejected?: (event: Event) => void;
+}
 interface EmailFieldProps$1
   extends GlobalProps,
     BaseTextFieldProps,
@@ -2033,6 +2436,68 @@ export type EmailAutocompleteField = ExtractStrict<
   AnyAutocompleteField,
   'email' | `${AutocompleteAddressGroup} email`
 >;
+interface FormProps$1 extends GlobalProps {
+  /**
+   * The content of the form.
+   */
+  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;
+  /**
+   * A callback that is run when the form is submitted.
+   *
+   * Use `event.waitUntil` to signal how long it takes to save the data,
+   * and whether it was successful or not.
+   */
+  onSubmit?: (event: ExtendableEvent) => void;
+  /**
+   * A callback that is run when the form is reset.
+   */
+  onReset?: (event: Event) => void;
+}
+interface FunctionSettingsProps$1 extends GlobalProps, FormProps$1 {
+  /**
+   * An optional callback function that will be run by the admin when the user
+   * commits their changes in the admin-rendered part of the function settings
+   * experience. If `event.waitUntil` is called with a promise, the admin will wait for the
+   * promise to resolve before committing any changes to Shopify’s servers. If
+   * the promise rejects, the admin will abort the changes and display an error,
+   * using the `message` property of the error you reject with.
+   */
+  onSubmit?: (event: ExtendableEvent) => void;
+  /**
+   * An optional callback function that will be run by the admin when
+   * committing the changes to Shopify’s servers fails. The error event you receive includes
+   * an `error` property that is an `AggregateError` object. This object includes
+   * an array of errors that were caused by data your extension provided.
+   * Network errors and user errors that are out of your control will not be reported here.
+   *
+   * In the `onError` callback, you should update your extension’s UI to
+   * highlight the fields that caused the errors, and display the error messages
+   * to the user.
+   */
+  onError?: (event: ArgregatedErrorEvent<FunctionSettingsError>) => void;
+}
+export interface FunctionSettingsError extends Error {
+  /**
+   * A unique identifier describing the “class” of error. These will match
+   * the GraphQL error codes as closely as possible. For example the enums
+   * returned by the `metafieldsSet` mutation
+   *
+   * @see https://shopify.dev/docs/api/admin-graphql/latest/enums/MetafieldsSetUserErrorCode
+   */
+  code: string;
+  name: 'FunctionSettingsError';
+}
 export type SpacingKeyword = SizeKeyword | 'none';
 export interface GapProps {
   /**
@@ -2114,7 +2579,7 @@ export type AlignContentKeyword =
   | ContentDistribution
   | OverflowPosition
   | ContentPosition;
-interface GridProps$1 extends BaseBoxPropsWithRole, GapProps {
+interface GridProps$1 extends GlobalProps, BaseBoxPropsWithRole, GapProps {
   /**
 	  Define columns and specify their size.
   
@@ -2184,7 +2649,7 @@ interface GridProps$1 extends BaseBoxPropsWithRole, GapProps {
     | `${AlignContentKeyword} ${JustifyContentKeyword}`
     | AlignContentKeyword;
 }
-interface GridItemProps$1 extends BaseBoxPropsWithRole {
+interface GridItemProps$1 extends GlobalProps, BaseBoxPropsWithRole {
   /**
    * Number of columns the item will span across
    *
@@ -2260,8 +2725,7 @@ export interface BlockTypographyProps {
 interface HeadingProps$1
   extends GlobalProps,
     AccessibilityVisibilityProps,
-    BlockTypographyProps,
-    ContainerProps {
+    BlockTypographyProps {
   /**
    * The content of the Heading.
    */
@@ -2287,7 +2751,9 @@ interface HeadingProps$1
     | '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.
    *
@@ -2353,13 +2819,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,
@@ -2427,13 +2886,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 {
   /**
@@ -2466,189 +2925,26 @@ interface ListItemProps$1 extends GlobalProps {
    */
   children?: ComponentChildren;
 }
+interface MenuProps$1 extends GlobalProps {
+  /**
+   * A label that describes the purpose or contents of the element. When set,
+   * it will be announced using assistive technologies and provide additional context.
+   */
+  accessibilityLabel?: string;
+  /**
+   * The children define the actions to render inside the Menu. Only Button components are allowed as children of a Menu, and these Buttons can perform actions (using `onClick`) or link to other parts of the application (using `to`/ `href`). Any other component placed here will be ignored.
+   */
+  children?: ComponentChildren;
+}
 interface MoneyFieldProps$1
   extends GlobalProps,
     BaseTextFieldProps,
     NumberConstraintsProps,
-    AutocompleteProps<MoneyAutocompleteField> {
-  /**
-   * Specifies the currency code that will be displayed.
-   *
-   * @default ''
-   */
-  currencyCode?: CurrencyCode | AnyString;
-}
+    AutocompleteProps<MoneyAutocompleteField> {}
 export type MoneyAutocompleteField = ExtractStrict<
   AnyAutocompleteField,
   'transaction-amount'
 >;
-/**
- * Supported monetary currencies from [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html).
- *
- * @see https://www.iso.org/iso-4217-currency-codes.html
- */
-export type CurrencyCode =
-  | 'USD'
-  | 'EUR'
-  | 'GBP'
-  | 'CAD'
-  | 'AFN'
-  | 'ALL'
-  | 'DZD'
-  | 'AOA'
-  | 'ARS'
-  | 'AMD'
-  | 'AWG'
-  | 'AUD'
-  | 'BBD'
-  | 'AZN'
-  | 'BDT'
-  | 'BSD'
-  | 'BHD'
-  | 'BIF'
-  | 'BZD'
-  | 'BMD'
-  | 'BTN'
-  | 'BAM'
-  | 'BRL'
-  | 'BOB'
-  | 'BWP'
-  | 'BND'
-  | 'BGN'
-  | 'MMK'
-  | 'KHR'
-  | 'CVE'
-  | 'KYD'
-  | 'XAF'
-  | 'CLP'
-  | 'CNY'
-  | 'COP'
-  | 'KMF'
-  | 'CDF'
-  | 'CRC'
-  | 'HRK'
-  | 'CZK'
-  | 'DKK'
-  | 'DOP'
-  | 'XCD'
-  | 'EGP'
-  | 'ETB'
-  | 'XPF'
-  | 'FJD'
-  | 'GMD'
-  | 'GHS'
-  | 'GTQ'
-  | 'GYD'
-  | 'GEL'
-  | 'HTG'
-  | 'HNL'
-  | 'HKD'
-  | 'HUF'
-  | 'ISK'
-  | 'INR'
-  | 'IDR'
-  | 'ILS'
-  | 'IQD'
-  | 'JMD'
-  | 'JPY'
-  | 'JEP'
-  | 'JOD'
-  | 'KZT'
-  | 'KES'
-  | 'KWD'
-  | 'KGS'
-  | 'LAK'
-  | 'LVL'
-  | 'LBP'
-  | 'LSL'
-  | 'LRD'
-  | 'LTL'
-  | 'MGA'
-  | 'MKD'
-  | 'MOP'
-  | 'MWK'
-  | 'MVR'
-  | 'MXN'
-  | 'MYR'
-  | 'MUR'
-  | 'MDL'
-  | 'MAD'
-  | 'MNT'
-  | 'MZN'
-  | 'NAD'
-  | 'NPR'
-  | 'ANG'
-  | 'NZD'
-  | 'NIO'
-  | 'NGN'
-  | 'NOK'
-  | 'OMR'
-  | 'PAB'
-  | 'PKR'
-  | 'PGK'
-  | 'PYG'
-  | 'PEN'
-  | 'PHP'
-  | 'PLN'
-  | 'QAR'
-  | 'RON'
-  | 'RUB'
-  | 'RWF'
-  | 'WST'
-  | 'SAR'
-  | 'RSD'
-  | 'SCR'
-  | 'SGD'
-  | 'SDG'
-  | 'SYP'
-  | 'ZAR'
-  | 'KRW'
-  | 'SSP'
-  | 'SBD'
-  | 'LKR'
-  | 'SRD'
-  | 'SZL'
-  | 'SEK'
-  | 'CHF'
-  | 'TWD'
-  | 'THB'
-  | 'TZS'
-  | 'TTD'
-  | 'TND'
-  | 'TRY'
-  | 'TMT'
-  | 'UGX'
-  | 'UAH'
-  | 'AED'
-  | 'UYU'
-  | 'UZS'
-  | 'VUV'
-  | 'VND'
-  | 'XOF'
-  | 'YER'
-  | 'ZMW'
-  | 'BYN'
-  | 'BYR'
-  | 'DJF'
-  | 'ERN'
-  | 'FKP'
-  | 'GIP'
-  | 'GNF'
-  | 'IRR'
-  | 'KID'
-  | 'LYD'
-  | 'MRU'
-  | 'SLL'
-  | 'SHP'
-  | 'SOS'
-  | 'STD'
-  | 'STN'
-  | 'TJS'
-  | 'TOP'
-  | 'VED'
-  | 'VEF'
-  | 'VES'
-  | 'XXX';
 interface NumberFieldProps$1
   extends GlobalProps,
     BaseTextFieldProps,
@@ -2692,7 +2988,7 @@ interface OptionGroupProps$1 extends GlobalProps {
   children?: ComponentChildren;
 }
 interface OrderedListProps$1 extends GlobalProps {}
-interface PageProps$1 extends GlobalProps, ContainerProps {
+interface PageProps$1 extends GlobalProps {
   /**
    * The content of the Page.
    */
@@ -2705,6 +3001,10 @@ interface PageProps$1 extends GlobalProps, ContainerProps {
    * The text to be used as subtitle.
    */
   subheading?: string;
+  /**
+   * Additional contextual information about the page.
+   */
+  accessory?: ComponentChildren;
   /**
    * The primary action to perform, provided as a button or link type element.
    * When a `Button` is added to the `primaryAction` it's variant is set to `primary`
@@ -2737,8 +3037,7 @@ interface ParagraphProps$1
   extends GlobalProps,
     BaseTypographyProps,
     BlockTypographyProps,
-    AccessibilityVisibilityProps,
-    ContainerProps {
+    AccessibilityVisibilityProps {
   /**
    * The content of the Text.
    */
@@ -2779,7 +3078,38 @@ export type PasswordAutocompleteField = ExtractStrict<
   AnyAutocompleteField,
   'new-password' | 'current-password'
 >;
-interface SectionProps$1 extends GlobalProps, ContainerProps {
+interface PopoverProps$1
+  extends GlobalProps,
+    BaseOverlayProps,
+    BaseOverlayMethods,
+    ToggleEventProps,
+    SizingProps {
+  /**
+   * The content of the popover.
+   */
+  children?: ComponentChildren;
+}
+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;
+}
+interface SectionProps$1 extends GlobalProps, ActionSlots {
   /**
    * The content of the Section.
    */
@@ -2838,7 +3168,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.
    */
@@ -2889,11 +3219,11 @@ export interface PaginationProps {
   /**
    * Called when the previous page button is clicked.
    */
-  onPreviousPage?: () => void;
+  onPreviousPage?: (event: Event) => void;
   /**
    * Called when the next page button is clicked.
    */
-  onNextPage?: () => void;
+  onNextPage?: (event: Event) => void;
   /**
    * Whether there's an additional page of data.
    *
@@ -2914,7 +3244,7 @@ export interface PaginationProps {
    */
   loading?: boolean;
 }
-interface TableProps$1 extends GlobalProps, PaginationProps, ContainerProps {
+interface TableProps$1 extends GlobalProps, PaginationProps {
   /**
    * The content of the Table.
    */
@@ -2938,11 +3268,11 @@ interface TableBodyProps$1 extends GlobalProps {
   /**
    * The body of the table. May not have any semantic meaning in the Table's `list` variant.
    */
-  children: ComponentChildren;
+  children?: ComponentChildren;
 }
 interface TableCellProps$1 extends GlobalProps {
   /**
-   * The content of the table data.
+   * The content of the table cell.
    */
   children?: ComponentChildren;
 }
@@ -2969,6 +3299,16 @@ interface TableHeaderProps$1 extends GlobalProps {
    * @default 'labeled'
    */
   listSlot?: ListSlotType;
+  /**
+   * The format of the column. Will automatically apply styling and alignment to cell content based on the value.
+   *
+   * - `base`: The base format for columns.
+   * - `currency`: Formats the column as currency.
+   * - `numeric`: Formats the column as a number.
+   *
+   * @default 'base'
+   */
+  format?: 'base' | 'currency' | 'numeric';
 }
 interface TableHeaderRowProps$1 extends GlobalProps {
   /**
@@ -2981,12 +3321,24 @@ interface TableRowProps$1 extends GlobalProps {
    * The content of a TableRow, which should be `TableCell` components.
    */
   children?: ComponentChildren;
+  /**
+   * The ID of an interactive element (e.g. `s-link`) in the row that will be the target of the click when the row is clicked.
+   * This is the primary action for the row; it should not be used for secondary actions.
+   *
+   * This is a click-only affordance, and does not introduce any keyboard or screen reader affordances.
+   * Which is why the target element must be in the table; so that keyboard and screen reader users can interact with it normally.
+   *
+   * @implementation no focus or keyboard affordances are introduced by this property. No aria attributes need to be added to the table row.
+   * @implementation the row and/or delegate should have some affordance that indicates it is clickable. This may be a background color, a border, a hover effect, etc.
+   */
+  clickDelegate?: string;
 }
 interface TextProps$1
   extends GlobalProps,
     AccessibilityVisibilityProps,
     BaseTypographyProps,
-    DisplayProps {
+    DisplayProps,
+    Pick<InteractionProps, 'interestFor'> {
   /**
    * The content of the Text.
    */
@@ -3094,22 +3446,207 @@ interface TextAreaProps$1
    */
   rows?: number;
 }
-interface TextFieldProps$1
-  extends GlobalProps,
-    BaseTextFieldProps,
-    MinMaxLengthProps,
-    AutocompleteProps<TextAutocompleteField>,
-    FieldDecorationProps {}
-interface UnorderedListProps$1 extends GlobalProps {}
-interface URLFieldProps$1
-  extends GlobalProps,
-    BaseTextFieldProps,
-    MinMaxLengthProps,
-    AutocompleteProps<URLAutocompleteField> {}
-export type URLAutocompleteField = ExtractStrict<
-  AnyAutocompleteField,
-  'url' | 'photo' | 'impp' | `${AutocompleteAddressGroup} impp`
->;
+interface TextFieldProps$1
+  extends GlobalProps,
+    BaseTextFieldProps,
+    MinMaxLengthProps,
+    AutocompleteProps<TextAutocompleteField>,
+    FieldDecorationProps {}
+interface ThumbnailProps$1 extends GlobalProps, BaseImageProps {
+  /**
+   * 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;
+  /**
+   * Adjusts the size the product thumbnail image.
+   *
+   * @default 'base'
+   */
+  size?: SizeKeyword;
+}
+interface TooltipProps$1 extends GlobalProps {
+  /**
+   * The content of the Tooltip.
+   */
+  children?: ComponentChildren;
+}
+interface UnorderedListProps$1 extends GlobalProps {}
+interface URLFieldProps$1
+  extends GlobalProps,
+    BaseTextFieldProps,
+    MinMaxLengthProps,
+    AutocompleteProps<URLAutocompleteField> {}
+export type URLAutocompleteField = ExtractStrict<
+  AnyAutocompleteField,
+  'url' | 'photo' | 'impp' | `${AutocompleteAddressGroup} impp`
+>;
+//
+// Preact Virtual DOM
+// -----------------------------------
+export interface VNode<P = {}> {
+  type: ComponentType<P> | string;
+  props: P & {
+    children: ComponentChildren$1;
+  };
+  key: Key;
+  /**
+   * ref is not guaranteed by React.ReactElement, for compatibility reasons
+   * with popular react libs we define it as optional too
+   */
+  ref?: Ref<any> | null;
+  /**
+   * The time this `vnode` started rendering. Will only be set when
+   * the devtools are attached.
+   * Default value: `0`
+   */
+  startTime?: number;
+  /**
+   * The time that the rendering of this `vnode` was completed. Will only be
+   * set when the devtools are attached.
+   * Default value: `-1`
+   */
+  endTime?: number;
+}
+//
+// Preact Component interface
+// -----------------------------------
+export type Key = string | number | any;
+export interface RefObject<T> {
+  current: T | null;
+}
+export type RefCallback<T> = (instance: T | null) => void;
+export type Ref<T> = RefObject<T> | RefCallback<T> | null;
+export type ComponentChild =
+  | VNode<any>
+  | object
+  | string
+  | number
+  | bigint
+  | boolean
+  | null
+  | undefined;
+type ComponentChildren$1 = ComponentChild[] | ComponentChild;
+export interface Attributes {
+  key?: Key | undefined;
+  jsx?: boolean | undefined;
+}
+export interface ErrorInfo {
+  componentStack?: string;
+}
+export type RenderableProps<P, RefType = any> = P &
+  Readonly<
+    Attributes & {
+      children?: ComponentChildren$1;
+      ref?: Ref<RefType>;
+    }
+  >;
+export type ComponentType<P = {}> = ComponentClass<P> | FunctionComponent<P>;
+export interface FunctionComponent<P = {}> {
+  (props: RenderableProps<P>, context?: any): ComponentChildren$1;
+  displayName?: string;
+  defaultProps?: Partial<P> | undefined;
+}
+export interface ComponentClass<P = {}, S = {}> {
+  new (props: P, context?: any): Component<P, S>;
+  displayName?: string;
+  defaultProps?: Partial<P>;
+  contextType?: Context<any>;
+  getDerivedStateFromProps?(
+    props: Readonly<P>,
+    state: Readonly<S>,
+  ): Partial<S> | null;
+  getDerivedStateFromError?(error: any): Partial<S> | null;
+}
+export interface Component<P = {}, S = {}> {
+  componentWillMount?(): void;
+  componentDidMount?(): void;
+  componentWillUnmount?(): void;
+  getChildContext?(): object;
+  componentWillReceiveProps?(nextProps: Readonly<P>, nextContext: any): void;
+  shouldComponentUpdate?(
+    nextProps: Readonly<P>,
+    nextState: Readonly<S>,
+    nextContext: any,
+  ): boolean;
+  componentWillUpdate?(
+    nextProps: Readonly<P>,
+    nextState: Readonly<S>,
+    nextContext: any,
+  ): void;
+  getSnapshotBeforeUpdate?(oldProps: Readonly<P>, oldState: Readonly<S>): any;
+  componentDidUpdate?(
+    previousProps: Readonly<P>,
+    previousState: Readonly<S>,
+    snapshot: any,
+  ): void;
+  componentDidCatch?(error: any, errorInfo: ErrorInfo): void;
+}
+declare abstract class Component<P, S> {
+  constructor(props?: P, context?: any);
+  static displayName?: string;
+  static defaultProps?: any;
+  static contextType?: Context<any>;
+  // Static members cannot reference class type parameters. This is not
+  // supported in TypeScript. Reusing the same type arguments from `Component`
+  // will lead to an impossible state where one cannot satisfy the type
+  // constraint under no circumstances, see #1356.In general type arguments
+  // seem to be a bit buggy and not supported well at the time of this
+  // writing with TS 3.3.3333.
+  static getDerivedStateFromProps?(
+    props: Readonly<object>,
+    state: Readonly<object>,
+  ): object | null;
+
+  static getDerivedStateFromError?(error: any): object | null;
+  state: Readonly<S>;
+  props: RenderableProps<P>;
+  context: any;
+  base?: Element | Text;
+  // From https://github.com/DefinitelyTyped/DefinitelyTyped/blob/e836acc75a78cf0655b5dfdbe81d69fdd4d8a252/types/react/index.d.ts#L402
+  // // We MUST keep setState() as a unified signature because it allows proper checking of the method return type.
+  // // See: https://github.com/DefinitelyTyped/DefinitelyTyped/issues/18365#issuecomment-351013257
+  setState<K extends keyof S>(
+    state:
+      | ((
+          prevState: Readonly<S>,
+          props: Readonly<P>,
+        ) => Pick<S, K> | Partial<S> | null)
+      | (Pick<S, K> | Partial<S> | null),
+    callback?: () => void,
+  ): void;
+
+  forceUpdate(callback?: () => void): void;
+  abstract render(
+    props?: RenderableProps<P>,
+    state?: Readonly<S>,
+    context?: any,
+  ): ComponentChildren$1;
+}
+//
+// Context
+// -----------------------------------
+export interface Consumer<T>
+  extends FunctionComponent<{
+    children: (value: T) => ComponentChildren$1;
+  }> {}
+export interface Provider<T>
+  extends FunctionComponent<{
+    value: T;
+    children?: ComponentChildren$1;
+  }> {}
+export interface Context<T> extends Provider<T> {
+  Consumer: Consumer<T>;
+  Provider: Provider<T>;
+  displayName?: string;
+}
 type IconType$1 =
   | 'adjust'
   | 'affiliate'
@@ -3150,6 +3687,7 @@ type IconType$1 =
   | 'book-open'
   | 'bug'
   | 'bullet'
+  | 'business-entity'
   | 'button'
   | 'button-press'
   | 'calculator'
@@ -3161,6 +3699,8 @@ type IconType$1 =
   | 'camera'
   | 'camera-flip'
   | 'caret-down'
+  | 'caret-left'
+  | 'caret-right'
   | 'caret-up'
   | 'cart'
   | 'cart-abandoned'
@@ -3288,6 +3828,7 @@ type IconType$1 =
   | 'file'
   | 'file-list'
   | 'filter'
+  | 'filter-active'
   | 'flag'
   | 'flip-horizontal'
   | 'flip-vertical'
@@ -3336,6 +3877,7 @@ type IconType$1 =
   | 'incoming'
   | 'incomplete'
   | 'info'
+  | 'inheritance'
   | 'inventory'
   | 'inventory-updated'
   | 'iq'
@@ -3466,6 +4008,7 @@ type IconType$1 =
   | 'plus'
   | 'plus-circle'
   | 'plus-circle-down'
+  | 'plus-circle-filled'
   | 'plus-circle-up'
   | 'point-of-sale'
   | 'price-list'
@@ -3506,6 +4049,7 @@ type IconType$1 =
   | 'sandbox'
   | 'save'
   | 'search'
+  | 'search-add'
   | 'search-list'
   | 'search-recent'
   | 'search-resource'
@@ -3605,191 +4149,3 @@ type IconType$1 =
   | 'wrench'
   | 'x'
   | 'x-circle';
-//
-// Preact Virtual DOM
-// -----------------------------------
-export interface VNode<P = {}> {
-  type: ComponentType<P> | string;
-  props: P & {
-    children: ComponentChildren$1;
-  };
-  key: Key;
-  /**
-   * ref is not guaranteed by React.ReactElement, for compatibility reasons
-   * with popular react libs we define it as optional too
-   */
-  ref?: Ref<any> | null;
-  /**
-   * The time this `vnode` started rendering. Will only be set when
-   * the devtools are attached.
-   * Default value: `0`
-   */
-  startTime?: number;
-  /**
-   * The time that the rendering of this `vnode` was completed. Will only be
-   * set when the devtools are attached.
-   * Default value: `-1`
-   */
-  endTime?: number;
-}
-//
-// Preact Component interface
-// -----------------------------------
-export type Key = string | number | any;
-export interface RefObject<T> {
-  current: T | null;
-}
-export type RefCallback<T> = (instance: T | null) => void;
-export type Ref<T> = RefObject<T> | RefCallback<T> | null;
-export type ComponentChild =
-  | VNode<any>
-  | object
-  | string
-  | number
-  | bigint
-  | boolean
-  | null
-  | undefined;
-type ComponentChildren$1 = ComponentChild[] | ComponentChild;
-export interface Attributes {
-  key?: Key | undefined;
-  jsx?: boolean | undefined;
-}
-export interface ErrorInfo {
-  componentStack?: string;
-}
-export type RenderableProps<P, RefType = any> = P &
-  Readonly<
-    Attributes & {
-      children?: ComponentChildren$1;
-      ref?: Ref<RefType>;
-    }
-  >;
-export type ComponentType<P = {}> = ComponentClass<P> | FunctionComponent<P>;
-export interface FunctionComponent<P = {}> {
-  (props: RenderableProps<P>, context?: any): ComponentChildren$1;
-  displayName?: string;
-  defaultProps?: Partial<P> | undefined;
-}
-export interface ComponentClass<P = {}, S = {}> {
-  new (props: P, context?: any): Component<P, S>;
-  displayName?: string;
-  defaultProps?: Partial<P>;
-  contextType?: Context<any>;
-  getDerivedStateFromProps?(
-    props: Readonly<P>,
-    state: Readonly<S>,
-  ): Partial<S> | null;
-  getDerivedStateFromError?(error: any): Partial<S> | null;
-}
-export interface Component<P = {}, S = {}> {
-  componentWillMount?(): void;
-  componentDidMount?(): void;
-  componentWillUnmount?(): void;
-  getChildContext?(): object;
-  componentWillReceiveProps?(nextProps: Readonly<P>, nextContext: any): void;
-  shouldComponentUpdate?(
-    nextProps: Readonly<P>,
-    nextState: Readonly<S>,
-    nextContext: any,
-  ): boolean;
-  componentWillUpdate?(
-    nextProps: Readonly<P>,
-    nextState: Readonly<S>,
-    nextContext: any,
-  ): void;
-  getSnapshotBeforeUpdate?(oldProps: Readonly<P>, oldState: Readonly<S>): any;
-  componentDidUpdate?(
-    previousProps: Readonly<P>,
-    previousState: Readonly<S>,
-    snapshot: any,
-  ): void;
-  componentDidCatch?(error: any, errorInfo: ErrorInfo): void;
-}
-declare abstract class Component<P, S> {
-  constructor(props?: P, context?: any);
-  static displayName?: string;
-  static defaultProps?: any;
-  static contextType?: Context<any>;
-  // Static members cannot reference class type parameters. This is not
-  // supported in TypeScript. Reusing the same type arguments from `Component`
-  // will lead to an impossible state where one cannot satisfy the type
-  // constraint under no circumstances, see #1356.In general type arguments
-  // seem to be a bit buggy and not supported well at the time of this
-  // writing with TS 3.3.3333.
-  static getDerivedStateFromProps?(
-    props: Readonly<object>,
-    state: Readonly<object>,
-  ): object | null;
-
-  static getDerivedStateFromError?(error: any): object | null;
-  state: Readonly<S>;
-  props: RenderableProps<P>;
-  context: any;
-  base?: Element | Text;
-  // From https://github.com/DefinitelyTyped/DefinitelyTyped/blob/e836acc75a78cf0655b5dfdbe81d69fdd4d8a252/types/react/index.d.ts#L402
-  // // We MUST keep setState() as a unified signature because it allows proper checking of the method return type.
-  // // See: https://github.com/DefinitelyTyped/DefinitelyTyped/issues/18365#issuecomment-351013257
-  setState<K extends keyof S>(
-    state:
-      | ((
-          prevState: Readonly<S>,
-          props: Readonly<P>,
-        ) => Pick<S, K> | Partial<S> | null)
-      | (Pick<S, K> | Partial<S> | null),
-    callback?: () => void,
-  ): void;
-
-  forceUpdate(callback?: () => void): void;
-  abstract render(
-    props?: RenderableProps<P>,
-    state?: Readonly<S>,
-    context?: any,
-  ): ComponentChildren$1;
-}
-//
-// Context
-// -----------------------------------
-export interface Consumer<T>
-  extends FunctionComponent<{
-    children: (value: T) => ComponentChildren$1;
-  }> {}
-export interface Provider<T>
-  extends FunctionComponent<{
-    value: T;
-    children?: ComponentChildren$1;
-  }> {}
-export interface Context<T> extends Provider<T> {
-  Consumer: Consumer<T>;
-  Provider: Provider<T>;
-  displayName?: string;
-}
-interface AdminActionProps$1 extends GlobalProps, ActionProps, ActionSlots {
-  /**
-   * Whether the action is in a loading state, such as initial page load or action opening.
-   * When true, the action could be in an inert state, which prevents user interaction.
-   *
-   * @default false
-   */
-  loading?: boolean;
-}
-interface AdminBlockProps$1 extends GlobalProps {
-  /**
-   * The text to use as the Block title in the block header. If not provided, the name of the
-   * extension will be used.
-   */
-  heading?: string;
-  /**
-   * The summary to display when the app block is collapsed.
-   * Summary longer than 30 characters will be truncated.
-   */
-  collapsedSummary?: string;
-}
-interface AdminPrintActionProps$1 extends GlobalProps {
-  /**
-   * Sets the src URL of the preview and the document to print.
-   * If not provided, the preview will show an empty state and the print button will be disabled.
-   * HTML, PDFs and images are supported.
-   */
-  src?: string;
-}