@shopify/ui-extensions 2025.10.13 → 2025.10.14

package/src/surfaces/point-of-sale/components/components-shared.d.ts

@@ -32,11 +32,11 @@ export interface GlobalProps {
  */
 export interface ActionSlots {
   /**
-   * The primary action element to display, typically a `Button` or clickable link representing the most important action available in the current context. This action aligns with the user's primary goal or the main purpose of the interface (for example, "Save changes", "Checkout", "Add to cart", "Submit order"). The primary action receives visual emphasis through styling to draw user attention. Only one primary action is displayed to maintain clear focus on the main call-to-action.
+   * The primary action element to display, typically a button or clickable link representing the most important action available in the current context. This action aligns with the user's primary goal or the main purpose of the interface (for example, "Save changes", "Checkout", "Add to cart", "Submit order"). The primary action receives visual emphasis through styling to draw user attention. Only one primary action is displayed to maintain clear focus on the main call-to-action.
    */
   primaryAction?: ComponentChildren;
   /**
-   * Secondary action elements to display, typically `Button` or clickable link elements representing alternative or supporting actions that are less important than the primary action (for example, "Cancel", "Save draft", "Skip", "Learn more"). Secondary actions receive less visual prominence than the primary action to maintain clear hierarchy. Multiple secondary actions can be provided and are displayed together, often in a different visual style or position than the primary action. The order of actions in the array may affect their display order depending on the component.
+   * Secondary action elements to display, typically button or clickable link elements representing alternative or supporting actions that are less important than the primary action (for example, "Cancel", "Save draft", "Skip", "Learn more"). Secondary actions receive less visual prominence than the primary action to maintain clear hierarchy. Multiple secondary actions can be provided and are displayed together, often in a different visual style or position than the primary action. The order of actions in the array may affect their display order depending on the component.
    */
   secondaryActions?: ComponentChildren;
 }
@@ -879,7 +879,7 @@ export type AccessibilityRole =
   | 'footer'
   /**
    * Used to indicate a thematic grouping of content.
-   * Sections should always have a `Heading` or an accessible name provided in the `accessibilityLabel` property.
+   * Sections should always have a heading or an accessible name provided in the `accessibilityLabel` property.
    *
    * In an HTML host `section` will render a `<section>` element.
    * Learn more about the [`<section>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/section) and its [implicit role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/region_role) in the MDN web docs.
@@ -1193,7 +1193,7 @@ export interface OverflowProps {
    * Controls how the container handles content that exceeds its dimensions:
    * - `'visible'`: Content extends beyond the container's boundaries without clipping or scrolling. Overflow content is fully visible and may overlap other elements. This is the default behavior and works well for containers that should expand to fit their content naturally.
    * - `'hidden'`: Content that exceeds the container is clipped and hidden from view—users can't see or access the overflow content. No scrollbars appear. Typically applied to intentionally limit visible content, create masked effects, or prevent content from breaking layouts. Hidden content may include important information users can't access.
-   * - `'auto'`: Only available in some components like `ScrollBox`. Adds scrollbars automatically when content exceeds the container, allowing users to scroll to view overflow content. Scrollbars only appear when needed. Commonly applied to scrollable regions, content lists, or containers where users should access all content but space is limited.
+   * - `'auto'`: Only available in some components like scroll box. Adds scrollbars automatically when content exceeds the container, allowing users to scroll to view overflow content. Scrollbars only appear when needed. Commonly applied to scrollable regions, content lists, or containers where users should access all content but space is limited.
    *
    * The choice depends on layout needs: `'visible'` for flexible layouts, `'hidden'` for strict boundaries, `'auto'` for user-controlled scrolling. Setting overflow establishes a new block formatting context, which affects layout behaviors like margin collapsing and positioning.
    *
@@ -1330,7 +1330,7 @@ export interface ButtonProps extends GlobalProps, BaseClickableProps {
    */
   accessibilityLabel?: string;
   /**
-   * The child elements to render within this component. Button content must be plain text.
+   * The child elements to render within this component. button content must be plain text.
    */
   children?: ComponentChildren;
   /**
@@ -1423,7 +1423,7 @@ export interface MultipleInputProps extends BaseInputProps {
    */
   onInput?: (event: Event) => void;
   /**
-   * An array containing the values of currently selected options in a multi-select choice list. When provided, this creates a controlled component where this array must be updated in response to user selections using the `onChange` callback. The array contains the `value` properties of selected child `Choice` components. For single-select lists (`multiple={false}`), this array contains zero or one items. For multi-select lists, it can contain multiple items. This is a convenience property that automatically sets the `selected` state on matching child choices based on their `value` properties. When a choice's value appears in this array, it's automatically marked as selected. The array should be updated immutably in callbacks (creating new arrays rather than mutating existing ones).
+   * An array containing the values of currently selected options in a multi-select choice list. When provided, this creates a controlled component where this array must be updated in response to user selections using the `onChange` callback. The array contains the `value` properties of selected child choice components. For single-select lists (`multiple={false}`), this array contains zero or one items. For multi-select lists, it can contain multiple items. This is a convenience property that automatically sets the `selected` state on matching child choices based on their `value` properties. When a choice's value appears in this array, it's automatically marked as selected. The array should be updated immutably in callbacks (creating new arrays rather than mutating existing ones).
    */
   values?: string[];
 }
@@ -1509,7 +1509,7 @@ export interface FieldDecorationProps {
    */
   icon?: IconType | AnyString;
   /**
-   * Additional interactive content displayed within the field, typically positioned at the end of the field after the input area. Only text-only `Button` and `Clickable` components are supported—no icons or complex content. Use the `slot="accessory"` attribute to place elements here. Common uses include action buttons (for example, "Copy" button, "Generate" button, "Clear" button), toggle visibility controls (for example, "Show password" button), or quick actions related to the field (for example, "Paste from clipboard"). The accessory must not interfere with the field's primary input functionality. Ensure sufficient contrast and touch target sizes for mobile usability.
+   * Additional interactive content displayed within the field, typically positioned at the end of the field after the input area. Only text-only button and clickable components are supported—no icons or complex content. Use the `slot="accessory"` attribute to place elements here. Common uses include action buttons (for example, "Copy" button, "Generate" button, "Clear" button), toggle visibility controls (for example, "Show password" button), or quick actions related to the field (for example, "Paste from clipboard"). The accessory must not interfere with the field's primary input functionality. Ensure sufficient contrast and touch target sizes for mobile usability.
    */
   accessory?: ComponentChildren;
 }
@@ -1578,7 +1578,7 @@ export interface BaseSelectableProps {
    */
   disabled?: boolean;
   /**
-   * The unique value associated with this selectable option. This value is what gets submitted with forms when the option is selected, and is used to identify which options are selected in the parent `ChoiceList`'s `values` array. The value should be unique among siblings within the same choice list to avoid selection ambiguity. When a choice is selected, this value appears in form data and in the parent's `values` array. Use meaningful, stable values that identify the choice semantically (for example, `"small"`, `"express-shipping"`, `"agree-to-terms"`) rather than display text which may change or be localized. The value isn't displayed to users—use the choice's `children` or label for visible text.
+   * The unique value associated with this selectable option. This value is what gets submitted with forms when the option is selected, and is used to identify which options are selected in the parent choice list's `values` array. The value should be unique among siblings within the same choice list to avoid selection ambiguity. When a choice is selected, this value appears in form data and in the parent's `values` array. Use meaningful, stable values that identify the choice semantically (for example, `"small"`, `"express-shipping"`, `"agree-to-terms"`) rather than display text which may change or be localized. The value isn't displayed to users—use the choice's `children` or label for visible text.
    */
   value?: string;
 }
@@ -1653,7 +1653,7 @@ export interface ChoiceListProps
    */
   multiple?: boolean;
   /**
-   * The child elements to render within this component. Within `ChoiceList`, use only `Choice` components as children. Other component types can't be used as options within the choice list.
+   * The child elements to render within this component. Within choice list, use only choice components as children. Other component types can't be used as options within the choice list.
    */
   children?: ComponentChildren;
   /**
@@ -2337,7 +2337,7 @@ export interface ModalProps
   /**
    * Controls the display size of the modal:
    * - Size keywords (for example, `'small'`, `'base'`, `'large'`): Fixed size options.
-   * - `'max'`: Modal expands to fill the maximum available space.
+   * - `'max'`: The modal expands to fill the maximum available space.
    *
    * @default 'base'
    */
@@ -2390,7 +2390,7 @@ export interface PageProps extends GlobalProps, ActionSlots {
    */
   subheading?: string;
   /**
-   * Additional content displayed in the header area, typically action buttons or clickable text elements that complement the primary and secondary actions. Only `Button` and `Clickable` components with text content are supported in this slot. Elements must use the `slot="accessory"` attribute to be placed in this area. Commonly displays contextual actions like "View history", "Export data", or status indicators.
+   * Additional content displayed in the header area, typically action buttons or clickable text elements that complement the primary and secondary actions. Only button and clickable components with text content are supported in this slot. Elements must use the `slot="accessory"` attribute to be placed in this area. Commonly displays contextual actions like "View history", "Export data", or status indicators.
    */
   accessory?: ComponentChildren;
   /**

package/src/surfaces/point-of-sale/components.d.ts

@@ -34,11 +34,11 @@ export interface GlobalProps {
  */
 export interface ActionSlots {
   /**
-   * The primary action element to display, typically a `Button` or clickable link representing the most important action the user can take in the current context. This action should align with the user's primary goal or the main purpose of the interface. For example, "Save changes", "Checkout", "Add to cart", or "Submit order". The primary action typically receives visual emphasis through styling to draw user attention. Only one primary action should be provided to avoid confusion about the main call-to-action. If no primary action is needed, omit this property rather than providing an empty or placeholder action.
+   * The primary action element to display, typically a button or clickable link representing the most important action the user can take in the current context. This action should align with the user's primary goal or the main purpose of the interface. For example, "Save changes", "Checkout", "Add to cart", or "Submit order". The primary action typically receives visual emphasis through styling to draw user attention. Only one primary action should be provided to avoid confusion about the main call-to-action. If no primary action is needed, omit this property rather than providing an empty or placeholder action.
    */
   primaryAction?: ComponentChildren;
   /**
-   * Secondary action elements to display, typically `Button` or clickable link elements representing alternative or supporting actions that are less important than the primary action. These might include "Cancel", "Save draft", "Skip", "Learn more", or other optional actions. Secondary actions receive less visual prominence than the primary action to maintain clear hierarchy. Multiple secondary actions can be provided and will typically be displayed together, often in a different visual style or position than the primary action. If no secondary actions are needed, omit this property. The order of actions in the array may affect their display order depending on the component.
+   * Secondary action elements to display, typically a button or clickable link elements representing alternative or supporting actions that are less important than the primary action. These might include "Cancel", "Save draft", "Skip", "Learn more", or other optional actions. Secondary actions receive less visual prominence than the primary action to maintain clear hierarchy. Multiple secondary actions can be provided and will typically be displayed together, often in a different visual style or position than the primary action. If no secondary actions are needed, omit this property. The order of actions in the array may affect their display order depending on the component.
    */
   secondaryActions?: ComponentChildren;
 }
@@ -884,7 +884,7 @@ export type AccessibilityRole =
   | 'footer'
   /**
    * Used to indicate a generic section.
-   * Sections should always have a `Heading` or an accessible name provided in the `accessibilityLabel` property.
+   * Sections should always have a heading or an accessible name provided in the `accessibilityLabel` property.
    *
    * In an HTML host `section` will render a `<section>` element.
    * Learn more about the [`<section>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/section) and its [implicit role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/region_role) in the MDN web docs.
@@ -1341,7 +1341,7 @@ export interface ButtonProps extends GlobalProps, BaseClickableProps {
    */
   accessibilityLabel?: string;
   /**
-   * The child elements to render within this component. Button content must be plain text.
+   * The child elements to render within this component. button content must be plain text.
    */
   children?: ComponentChildren;
   /**
@@ -1437,7 +1437,7 @@ export interface MultipleInputProps extends BaseInputProps {
    */
   onInput?: (event: Event) => void;
   /**
-   * An array containing the values of currently selected options in a multi-select choice list. When provided, this creates a controlled component where this array must be updated in response to user selections using the `onChange` callback. The array should contain the `value` properties of selected child `Choice` components. For single-select lists (`multiple={false}`), this array should contain zero or one items. For multi-select lists, it can contain multiple items. This is a convenience property that automatically sets the `selected` state on matching child choices based on their `value` properties. When a choice's value appears in this array, it's automatically marked as selected. Update this array immutably in callbacks (create new arrays rather than mutating).
+   * An array containing the values of currently selected options in a multi-select choice list. When provided, this creates a controlled component where this array must be updated in response to user selections using the `onChange` callback. The array should contain the `value` properties of selected child choice components. For single-select lists (`multiple={false}`), this array should contain zero or one items. For multi-select lists, it can contain multiple items. This is a convenience property that automatically sets the `selected` state on matching child choices based on their `value` properties. When a choice's value appears in this array, it's automatically marked as selected. Update this array immutably in callbacks (create new arrays rather than mutating).
    */
   values?: string[];
 }
@@ -1523,7 +1523,7 @@ export interface FieldDecorationProps {
    */
   icon?: IconType | AnyString;
   /**
-   * Additional interactive content displayed within the field, typically positioned at the end of the field after the input area. Only text-only `Button` and `Clickable` components are supported—no icons or complex content. Use the `slot="accessory"` attribute to place elements here. Common uses include action buttons (for example, "Copy" button, "Generate" button, "Clear" button), toggle visibility controls (for example, "Show password" button), or quick actions related to the field (for example, "Paste from clipboard"). The accessory must not interfere with the field's primary input functionality. Ensure sufficient contrast and touch target sizes for mobile usability.
+   * Additional interactive content displayed within the field, typically positioned at the end of the field after the input area. Only text-only button and clickable components are supported—no icons or complex content. Use the `slot="accessory"` attribute to place elements here. Common uses include action buttons (for example, "Copy" button, "Generate" button, "Clear" button), toggle visibility controls (for example, "Show password" button), or quick actions related to the field (for example, "Paste from clipboard"). The accessory must not interfere with the field's primary input functionality. Ensure sufficient contrast and touch target sizes for mobile usability.
    */
   accessory?: ComponentChildren;
 }
@@ -1592,7 +1592,7 @@ export interface BaseSelectableProps {
    */
   disabled?: boolean;
   /**
-   * The unique value associated with this selectable option. This value is what gets submitted with forms when the option is selected, and is used to identify which options are selected in the parent `ChoiceList`'s `values` array. The value should be unique among siblings within the same choice list to avoid selection ambiguity. When a choice is selected, this value appears in form data and in the parent's `values` array. Use meaningful, stable values that identify the choice semantically (for example, `"small"`, `"express-shipping"`, `"agree-to-terms"`) rather than display text which may change or be localized. The value isn't displayed to users—use the choice's `children` or label for visible text.
+   * The unique value associated with this selectable option. This value is what gets submitted with forms when the option is selected, and is used to identify which options are selected in the parent choice list's `values` array. The value should be unique among siblings within the same choice list to avoid selection ambiguity. When a choice is selected, this value appears in form data and in the parent's `values` array. Use meaningful, stable values that identify the choice semantically (for example, `"small"`, `"express-shipping"`, `"agree-to-terms"`) rather than display text which may change or be localized. The value isn't displayed to users—use the choice's `children` or label for visible text.
    */
   value?: string;
 }
@@ -1667,7 +1667,7 @@ export interface ChoiceListProps
    */
   multiple?: boolean;
   /**
-   * The child elements to render within this component. Within `ChoiceList`, use only `Choice` components as children. Other component types can't be used as options within the choice list.
+   * The child elements to render within this component. Within choice list, use only choice components as children. Other component types can't be used as options within the choice list.
    */
   children?: ComponentChildren;
   /**
@@ -2360,7 +2360,7 @@ export interface ModalProps
   /**
    * Controls the display size of the modal:
    * - Size keywords (for example, `'small'`, `'base'`, `'large'`): Fixed size options.
-   * - `'max'`: Modal expands to fill the maximum available space.
+   * - `'max'`: The modal expands to fill the maximum available space.
    *
    * @default 'base'
    */
@@ -2413,7 +2413,7 @@ export interface PageProps extends GlobalProps, ActionSlots {
    */
   subheading?: string;
   /**
-   * The additional content displayed in the header area. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content displayed in the header area. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: ComponentChildren;
   /**
@@ -3964,7 +3964,7 @@ interface TextFieldJSXProps
    */
   onFocus?: ((event: CallbackEvent<typeof tagName$h>) => void) | null;
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: ComponentChild;
 }
@@ -4046,7 +4046,7 @@ interface EmailFieldJSXProps
    */
   onFocus?: ((event: CallbackEvent<typeof tagName$f>) => void) | null;
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: ComponentChild;
 }
@@ -4120,7 +4120,7 @@ interface TextAreaJSXProps
    */
   onFocus?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: ComponentChild;
 }
@@ -4188,7 +4188,7 @@ interface NumberFieldJSXProps
    */
   placeholder?: NumberFieldProps['placeholder'];
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: ComponentChild;
   /**
@@ -4340,7 +4340,7 @@ interface SectionJSXProps extends Pick<SectionProps, 'id'> {
    */
   heading?: string;
   /**
-   * Button element to display in the section heading. A single button is supported.
+   * A button element to display in the section heading. A single button is supported.
    */
   secondaryActions?: ComponentChild;
   /**
@@ -4456,7 +4456,7 @@ interface PageJSXProps extends Pick<PageProps, 'id'> {
    */
   subheading?: PageProps['subheading'];
   /**
-   * Button element to display in the action bar. Only a single button is supported.
+   * A button element to display in the action bar. Only a single button is supported.
    */
   secondaryActions?: ComponentChild;
   /**
@@ -4635,7 +4635,7 @@ interface Badge {
 }
 
 /**
- * The `Banner` component supports slots for additional content placement within the banner. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The banner component supports slots for additional content placement within the banner. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface BannerSlots {
   /**
@@ -4774,7 +4774,7 @@ interface Box {
 }
 
 /**
- * The `Button` component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The button component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface ButtonEvents {
   /**
@@ -4864,7 +4864,7 @@ interface Choice {
 }
 
 /**
- * The `ChoiceList` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The choice list component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface ChoiceListEvents {
   /**
@@ -4895,7 +4895,7 @@ interface ChoiceList {
 }
 
 /**
- * The `Clickable` component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The clickable component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface ClickableEvents {
   /**
@@ -4916,7 +4916,7 @@ interface Clickable {
 }
 
 /**
- * The `DateField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The date field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface DateFieldEvents {
   /**
@@ -4967,7 +4967,7 @@ interface DateField {
 }
 
 /**
- * The `DatePicker` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The date picker component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface DatePickerEvents {
   /**
@@ -5002,7 +5002,7 @@ interface DatePicker {
 }
 
 /**
- * The `DateSpinner` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The date spinner component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface DateSpinnerEvents {
   /**
@@ -5052,7 +5052,7 @@ interface Divider {
 }
 
 /**
- * The `EmailField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The email field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface EmailFieldEvents {
   /**
@@ -5074,11 +5074,11 @@ interface EmailFieldEvents {
 }
 
 /**
- * The `EmailField` component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The email field component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface EmailFieldSlots {
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: HTMLElement;
 }
@@ -5199,7 +5199,7 @@ interface Image {
 }
 
 /**
- * The `Modal` component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The modal component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface ModalEvents {
   /**
@@ -5213,7 +5213,7 @@ interface ModalEvents {
 }
 
 /**
- * The `Modal` component supports slots for additional content placement within the modal. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The modal component supports slots for additional content placement within the modal. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface ModalSlots {
   /**
@@ -5238,7 +5238,7 @@ interface Modal {
 }
 
 /**
- * The `NumberField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The number field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface NumberFieldEvents {
   /**
@@ -5260,11 +5260,11 @@ interface NumberFieldEvents {
 }
 
 /**
- * The `NumberField` component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The number field component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface NumberFieldSlots {
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: HTMLElement;
 }
@@ -5342,7 +5342,7 @@ interface NumberField {
 }
 
 /**
- * The `Page` component supports slots for additional content placement within the page. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The page component supports slots for additional content placement within the page. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface PageSlots {
   /**
@@ -5373,7 +5373,7 @@ interface Page {
 }
 
 /**
- * The `PosBlock` component supports slots for additional content placement within the block. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The POS block component supports slots for additional content placement within the block. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface PosBlockSlots {
   /**
@@ -5503,7 +5503,7 @@ interface ScrollBox {
 }
 
 /**
- * The `SearchField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The search field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface SearchFieldEvents {
   /**
@@ -5546,7 +5546,7 @@ interface SearchField {
 }
 
 /**
- * The `Section` component supports slots for additional content placement within the section. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The section component supports slots for additional content placement within the section. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface SectionSlots {
   /**
@@ -5752,7 +5752,7 @@ interface Text {
 }
 
 /**
- * The `TextArea` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The text area component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface TextAreaEvents {
   /**
@@ -5774,11 +5774,11 @@ interface TextAreaEvents {
 }
 
 /**
- * The `TextArea` component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The text area component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface TextAreaSlots {
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: HTMLElement;
 }
@@ -5835,7 +5835,7 @@ interface TextArea {
 }
 
 /**
- * The `TextField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The text field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface TextFieldEvents {
   /**
@@ -5857,11 +5857,11 @@ interface TextFieldEvents {
 }
 
 /**
- * The `TextField` component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * The text field component supports slots for additional content placement within the field. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
  */
 interface TextFieldSlots {
   /**
-   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only `Button` and `Clickable` components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
+   * The additional content to be displayed in the field. Commonly used to display clickable text or action elements. Only button and clickable components with text content only are supported in this slot. Use the `slot="accessory"` attribute to place elements in this area.
    */
   accessory?: HTMLElement;
 }
@@ -5954,7 +5954,7 @@ interface Tile {
 }
 
 /**
- * The `TimeField` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The time field component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface TimeFieldEvents {
   /**
@@ -6005,7 +6005,7 @@ interface TimeField {
 }
 
 /**
- * The `TimePicker` component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * The time picker component provides event callbacks for handling user interactions and validation. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
  */
 interface TimePickerEvents {
   /**

package/src/surfaces/point-of-sale/event/data/ReprintReceiptData.ts

@@ -1,4 +1,5 @@
 import {BaseTransactionComplete} from '../../types/base-transaction-complete';
+import {LineItem} from '../../types/cart';
 import {OrderLineItem} from '../../types/order';
 
 /**
@@ -6,11 +7,31 @@ import {OrderLineItem} from '../../types/order';
  */
 export interface ReprintReceiptData extends BaseTransactionComplete {
   /**
-   * The transaction type identifier, always 'Sale' for sale transactions.
+   * The transaction type identifier, always 'Reprint' for reprint transactions.
    */
   transactionType: 'Reprint';
   /**
-   * An array of line items included in the sale transaction.
+   * An array of line items included in the transaction.
    */
   lineItems: OrderLineItem[];
+  /**
+   * The refund ID if a refund was issued for the return.
+   */
+  refundId?: number;
+  /**
+   * The return ID for the completed return transaction.
+   */
+  returnId?: number;
+  /**
+   * The exchange ID if the return is part of an exchange transaction.
+   */
+  exchangeId?: number;
+  /**
+   * An array of line items added to the customer in the exchange.
+   */
+  lineItemsAdded?: LineItem[];
+  /**
+   * An array of line items removed from the customer in the exchange.
+   */
+  lineItemsRemoved?: LineItem[];
 }

package/src/surfaces/admin/api/intents/examples/create-article.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Article');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Article created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-catalog.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Catalog');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Catalog created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-collection.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Collection');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Collection created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-customer.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Customer');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Customer created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-discount.js

@@ -1,11 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Discount', {
-  data: {type: 'amount-off-product'},
-});
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Discount created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-market.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Market');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Market created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-menu.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Menu');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Menu created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-metafield-definition.js

@@ -1,11 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/MetafieldDefinition', {
-  data: {ownerType: 'product'},
-});
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Metafield definition created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-metaobject-definition.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/MetaobjectDefinition');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Metaobject definition created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-metaobject.js

@@ -1,11 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Metaobject', {
-  data: {type: 'shopify--color-pattern'},
-});
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Metaobject created:', response.data);
-}

package/src/surfaces/admin/api/intents/examples/create-page.js

@@ -1,9 +0,0 @@
-const {intents} = useApi(TARGET);
-
-const activity = await intents.invoke('create:shopify/Page');
-
-const response = await activity.complete;
-
-if (response.code === 'ok') {
-  console.log('Page created:', response.data);
-}