@shopify/ui-extensions 2026.10.0-rc.9 → 2026.10.1

package/src/surfaces/admin/components/Progress.d.ts

@@ -0,0 +1,155 @@
+/** VERSION: 2.26.1 **/
+/* eslint-disable import/extensions */
+
+/* eslint-disable @typescript-eslint/no-namespace */
+/* eslint-disable @typescript-eslint/member-ordering */
+
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
+/// <reference lib="DOM" />
+import type {
+  ProgressProps$1,
+  PreactCustomElement,
+  RenderImpl,
+} from './shared.d.ts';
+import * as preact$1 from 'preact';
+import {ReactNode, RefAttributes} from 'react';
+
+export type ReactIntrinsicElementChildren<PreactProps extends object> =
+  'children' extends keyof PreactProps
+    ? {
+        children?: ReactNode;
+      }
+    : Record<never, never>;
+export type ReactIntrinsicElementProps<
+  PreactProps extends object,
+  ElementType,
+> = Omit<PreactProps, 'children' | 'key' | 'ref' | 'slot'> &
+  ReactIntrinsicElementChildren<PreactProps> &
+  RefAttributes<ElementType> & {
+    slot?: Lowercase<string>;
+  };
+export type ReactIntrinsicElements = {
+  [Tag in Exclude<
+    Extract<keyof preact$1.createElement.JSX.IntrinsicElements, `s-${string}`>,
+    `s-test-${string}`
+  >]: ReactIntrinsicElementProps<
+    preact$1.createElement.JSX.IntrinsicElements[Tag],
+    Tag extends keyof HTMLElementTagNameMap
+      ? HTMLElementTagNameMap[Tag]
+      : HTMLElement
+  >;
+};
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicElements extends ReactIntrinsicElements {}
+  }
+}
+
+/**
+ * Configure the following properties on the progress component.
+ */
+export interface ProgressProps
+  extends Pick<
+    ProgressProps$1,
+    'accessibilityLabel' | 'max' | 'tone' | 'value'
+  > {
+  /**
+   * A label that describes the purpose or content of the component for assistive technologies like screen readers. Use this to provide additional context when the visible content alone doesn't clearly convey what is progressing.
+   */
+  accessibilityLabel: Required<ProgressProps$1>['accessibilityLabel'];
+  /**
+   * How much work the task requires in total. Must be greater than `0`.
+   *
+   * @default 1
+   */
+  max: Required<ProgressProps$1>['max'];
+  /**
+   * The semantic meaning and color treatment of the component.
+   *
+   * - `auto`: Automatically determined based on context.
+   * - `neutral`: General information without specific intent.
+   * - `info`: Informational content or helpful tips.
+   * - `success`: Positive outcomes or successful states.
+   * - `caution`: Advisory notices that need attention.
+   * - `warning`: Important warnings about potential issues.
+   * - `critical`: Urgent problems or destructive actions.
+   *
+   * @default 'auto'
+   */
+  tone: Extract<
+    ProgressProps$1['tone'],
+    'auto' | 'neutral' | 'info' | 'success' | 'caution' | 'warning' | 'critical'
+  >;
+  /**
+   * How much of the task has been completed, as a number between `0` and `max`.
+   *
+   * Without a `value` the progress is indeterminate: the task is ongoing with no
+   * indication of how long it is expected to take.
+   *
+   * @default 0
+   */
+  value: Required<ProgressProps$1>['value'];
+}
+
+declare class PolarisCustomElement extends PreactCustomElement {
+  constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
+  /** @private */
+  connectedCallback(): void;
+  /** @private */
+  adoptedCallback(): void;
+}
+
+/**
+ * Base props for Preact custom elements without children support. Includes common properties like key, ref, and slot for elements that don't accept child content.
+ * @publicDocs
+ */
+export interface PreactBaseElementProps<TClass extends HTMLElement> {
+  /**
+   * A unique identifier for this element, used by the virtual DOM to efficiently track and update elements in lists.
+   * Essential for maintaining component state and optimizing re-renders when lists change.
+   */
+  key?: preact.Key;
+  /**
+   * A reference to access the underlying DOM element directly.
+   * Typically created using `useRef()` to interact with the element imperatively or measure its properties.
+   */
+  ref?: preact.Ref<TClass>;
+  /**
+   * The named slot to which this element is assigned in the parent component's shadow DOM.
+   *
+   * Used for advanced component composition with web components.
+   */
+  slot?: Lowercase<string>;
+}
+
+/**
+ * Configure the following properties on the progress component.
+ * @publicDocs
+ */
+declare class Progress extends PolarisCustomElement implements ProgressProps {
+  accessor accessibilityLabel: string;
+  accessor max: ProgressProps['max'];
+  accessor tone: ProgressProps['tone'];
+  accessor value: ProgressProps['value'];
+  constructor();
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    [tagName]: Progress;
+  }
+}
+declare module 'preact' {
+  namespace createElement.JSX {
+    interface IntrinsicElements {
+      [tagName]: ProgressJSXProps & PreactBaseElementProps<Progress>;
+    }
+  }
+}
+
+declare const tagName = 's-progress';
+export interface ProgressJSXProps
+  extends Partial<ProgressProps>,
+    Pick<ProgressProps$1, 'id'> {}
+
+export {Progress};
+export type {ProgressJSXProps};

package/src/surfaces/admin/components/QueryContainer.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/SearchField.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Section.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -134,6 +134,12 @@ declare abstract class SectionBase
   implements SectionProps
 {
   constructor(renderImpl: RenderImpl);
+  /**
+   * The element the section currently renders as its graphic, which sizes a
+   * Badge inside it.
+   * @private
+   */
+  setGraphicNode(node: Element | null): void;
   /** @private */
   connectedCallback(): void;
   /** @private */
@@ -193,13 +199,15 @@ export interface SectionJSXProps
   /**
    * A decorative visual that reinforces the heading, rendered before it.
    *
-   * Accepts a single icon-only Badge (`icon` set, no text content) with a `size` of `large`. The heading identifies the section, so this content is not announced by assistive technologies, and it is not rendered at all when the section has no `heading`.
+   * Accepts a single Icon with a `size` of `base`, or an icon-only Badge (`icon` set, no text content) with a `size` of `large`. The heading identifies the section, so this content is not announced by assistive technologies, and it is not rendered at all when the section has no `heading`.
    */
   graphic?: ComponentChildren;
   /**
    * Additional contextual information that qualifies the heading, rendered inline beside the heading text.
    *
-   * Only accepts Badge, Icon, Button, Menu, Text, Avatar, and Thumbnail elements. Text must use `tone`, `fontSize`, and `fontWeight` of `auto`; Icon, Avatar, and Thumbnail must use `size="base"`; Badge must use `size="base"` and `color="base"`; Button must use `inlineSize="auto"`.
+   * Only accepts Badge, Icon, Button, Menu, Text, Avatar, Thumbnail, and Tooltip elements. Text must use `tone`, `fontSize`, and `fontWeight` of `auto`; Icon, Avatar, and Thumbnail must use `size="base"`; Badge must use `size="base"` and `color="base"`; Button must use `inlineSize="auto"`.
+   *
+   * A Tooltip an accessory element's `interestFor` points at can be slotted here beside it.
    */
   accessory?: ComponentChildren;
   /**

package/src/surfaces/admin/components/Select.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Spinner.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Stack.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/StandardComponents.ts

@@ -21,6 +21,7 @@ export type StandardComponents =
   | 'DropZone'
   | 'Divider'
   | 'EmailField'
+  | 'EmptyState'
   | 'Grid'
   | 'GridItem'
   | 'Heading'
@@ -30,6 +31,7 @@ export type StandardComponents =
   | 'ListItem'
   | 'Menu'
   | 'MoneyField'
+  | 'Number'
   | 'NumberField'
   | 'Option'
   | 'OptionGroup'
@@ -37,6 +39,7 @@ export type StandardComponents =
   | 'Paragraph'
   | 'PasswordField'
   | 'Popover'
+  | 'Progress'
   | 'QueryContainer'
   | 'SearchField'
   | 'Section'

package/src/surfaces/admin/components/Switch.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -144,7 +144,7 @@ export interface PreactCheckboxProps
     >
   > {
   /**
-   * The value used in form data when the checkbox is checked.
+   * The value used in form data when the control is checked.
    */
   value: Required<CheckboxProps>['value'];
 }
@@ -156,7 +156,7 @@ declare class PreactCheckboxElement
   get checked(): boolean;
   set checked(checked: PreactCheckboxProps['checked']);
   /**
-   * The value used in form data when the checkbox is checked.
+   * The value used in form data when the control is checked.
    */
   get value(): string;
   set value(value: string);

package/src/surfaces/admin/components/Table.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TableBody.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TableCell.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TableHeader.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TableHeaderRow.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TableRow.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Text.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TextArea.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/TextField.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Thumbnail.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/Tooltip.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/URLField.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

package/src/surfaces/admin/components/UnorderedList.d.ts

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */

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

@@ -1,4 +1,4 @@
-/** VERSION: 2.23.0 **/
+/** VERSION: 2.26.1 **/
 
 /* eslint-disable @typescript-eslint/ban-types */
 
@@ -3039,7 +3039,7 @@ export interface FileInputProps extends BaseInputProps {
  */
 export interface FieldErrorProps {
   /**
-   * An error message displayed below the checkbox to indicate validation problems. When set, the checkbox is styled with error indicators and the message is announced to screen readers.
+   * An error message displayed below the field to indicate validation problems. When set, the field is styled with error indicators and the message is announced to screen readers.
    *
    * @implementation (string) The error is a simple string that will be displayed to the user.
    *
@@ -3077,7 +3077,7 @@ export interface BasicFieldProps
  */
 export interface FieldDetailsProps {
   /**
-   * Supplementary text displayed below the checkbox to provide additional context, instructions, or help. Use this to explain what checking the box means or provide guidance to users. This text is announced to screen readers.
+   * Supplementary text displayed below the field to provide additional context, instructions, or help. Use this to clarify the expected input or provide guidance to users. This text is announced to screen readers.
    *
    * @implementation (string) The details is a simple string that will be displayed to the user.
    *
@@ -3776,13 +3776,13 @@ export interface BaseSelectableProps {
    */
   accessibilityLabel?: string;
   /**
-   * Whether the checkbox is disabled, preventing user interaction. Disabled checkboxes appear dimmed and their values aren't submitted with forms.
+   * Whether the control is disabled, preventing user interaction. Disabled controls appear dimmed and their values aren't submitted with forms.
    *
    * @default false
    */
   disabled?: boolean;
   /**
-   * The value submitted with the form when this checkbox is checked. If not specified, the default value is "on".
+   * The value submitted with the form when this control is selected. If not specified, the default value is "on".
    */
   value?: string;
 }
@@ -3814,7 +3814,7 @@ export interface BaseCheckableProps
     LabelAccessibilityVisibilityProps,
     InteractionProps {
   /**
-   * The text label displayed next to the checkbox that describes what the checkbox controls. Clicking the label will also toggle the checkbox state.
+   * The text label displayed next to the control that describes what it does. Clicking the label will also toggle the control state.
    *
    * @implementation (string) The label is a simple string that will be displayed to the user.
    *
@@ -3838,7 +3838,7 @@ export interface BaseCheckableProps
    */
   defaultChecked?: boolean;
   /**
-   * The name used to identify this checkbox in form submissions. When the checkbox is checked, its `name` and `value` are included in the form data. Must be unique within the containing form.
+   * The name used to identify this control in form submissions. When the control is checked, its `name` and `value` are included in the form data. Must be unique within the containing form.
    */
   name?: string;
   /**
@@ -6226,6 +6226,46 @@ interface PressButtonProps$1
    */
   defaultPressed?: boolean;
 }
+interface ProgressProps$1 extends GlobalProps {
+  /**
+   * A label that describes the purpose of the progress. When set,
+   * it will be announced to users using assistive technologies and will
+   * provide them with more context.
+   *
+   * Use it to provide context of what is progressing.
+   */
+  accessibilityLabel?: string;
+  /**
+   * Sets the tone of the progress, based on the intention of the information being conveyed.
+   *
+   * @default 'auto'
+   */
+  tone?: ToneKeyword;
+  /**
+   * Specifies how much of the task has been completed.
+   *
+   * It must be a valid floating point number between 0 and `max`, or between 0 and 1 if `max` is omitted.
+   * If there is no value attribute, the progress bar is indeterminate;
+   * this indicates that an activity is ongoing with no indication of how long it is expected to take.
+   *
+   * @implementation Surfaces should apply styling to cover that indeterminate state.
+   * @implementation In a HTML host, you can customize the progress animation via the :indeterminate pseudo-class.
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress#value
+   * @see https://developer.mozilla.org/en-US/docs/Web/CSS/:indeterminate#progress_bar
+   */
+  value?: number;
+  /**
+   * This attribute describes how much work the task indicated by the progress element requires.
+   *
+   * The `max` attribute, if present, must have a value greater than 0 and be a valid floating point number.
+   *
+   * @default 1
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress#max
+   */
+  max?: number;
+}
 interface QueryContainerProps$1 extends GlobalProps {
   /**
    * The content of the container.