@shopify/ui-extensions 2025.10.2 → 2025.10.4

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -20,6 +20,20 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
       (event: CallbackEvent<T>): void;
     })
   | null;
+/** Used when an element does not have children. */
+export interface PreactBaseElementProps<TClass extends HTMLElement> {
+  /** Assigns a unique key to this element. */
+  key?: preact.Key;
+  /** Assigns a ref (generally from `useRef()`) to this element. */
+  ref?: preact.Ref<TClass>;
+  /** Assigns this element to a parent's slot. */
+  slot?: Lowercase<string>;
+}
+/** Used when an element has children. */
+export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
+  extends PreactBaseElementProps<TClass> {
+  children?: preact.ComponentChildren;
+}
 
 export type RequiredAlignedModalProps = Required<ModalProps$1>;
 export interface ModalProps
@@ -102,15 +116,39 @@ declare abstract class PreactCustomElement extends BaseClass {
   click({sourceEvent}?: ClickOptions): void;
 }
 
+export interface PreactOverlayControlProps
+  extends Pick<InteractionProps, 'commandFor' | 'interestFor'> {
+  /**
+   * Sets the action the [command](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command) should take when this clickable is activated.
+   *
+   * See the documentation of particular components for the actions they support.
+   *
+   * - `--auto`: a default action for the target component.
+   * - `--show`: shows the target component.
+   * - `--hide`: hides the target component.
+   * - `--toggle`: toggles the target component.
+   *
+   * @default '--auto'
+   */
+  command: Extract<
+    InteractionProps['command'],
+    '--show' | '--hide' | '--toggle' | '--auto'
+  >;
+  /**
+   * Sets the element the [commandFor](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#commandfor) should act on when this clickable is activated.
+   */
+  commandFor: Extract<InteractionProps['commandFor'], string>;
+  /**
+   * Sets the element the [interestFor](https://open-ui.org/components/interest-invokers.explainer/#the-pitch-in-code) should act on when this clickable is activated.
+   */
+  interestFor: Extract<InteractionProps['interestFor'], string>;
+}
+
 /**
  * Shared symbols for overlay control functionality.
  * These symbols are used by components that implement overlay behavior
  * (like Popover, Tooltip, Modal, etc.) to communicate with the overlay control system.
  */
-/**
- * Symbol used to invoke the method for overlay commands, e.g. `--show`, `--hide`, etc.
- */
-declare const overlayCommand: unique symbol;
 /**
  * Symbol used to track the open or closed state of the overlay.
  */
@@ -120,6 +158,21 @@ declare const overlayHidden: unique symbol;
  */
 declare const overlayActivator: unique symbol;
 declare const overlayHideFrameId: unique symbol;
+export type PolyfillCommandEventInit = EventInit & {
+  source: HTMLElement | null | undefined;
+  command: PreactOverlayControlProps['command'];
+};
+export type PolyfillCommandEvent = Event & {
+  source: PolyfillCommandEventInit['source'];
+  command: PolyfillCommandEventInit['command'];
+  /** Have to use `_s_shadowSource` because `source` is retargeted to the shadow host by browsers */
+  _s_shadowSource: PolyfillCommandEventInit['source'];
+};
+declare global {
+  interface GlobalEventHandlersEventMap {
+    command: PolyfillCommandEvent;
+  }
+}
 
 declare class PreactOverlayElement extends PreactCustomElement {
   constructor(renderImpl: RenderImpl);
@@ -129,25 +182,52 @@ declare class PreactOverlayElement extends PreactCustomElement {
   [overlayActivator]: HTMLElement | null | undefined;
   /** @private */
   [overlayHideFrameId]?: number;
-  /** @private */
-  [overlayCommand](
-    command: InteractionProps['command'],
-    overlayActivatorEl: HTMLElement | null | undefined,
-  ): void;
+}
+
+export interface Context<T> {
+  readonly defaultValue: T;
+}
+/**
+ * A callback which is provided by a context requester and is called with the value satisfying the request.
+ * This callback can be called multiple times by context providers as the requested value is changed.
+ */
+export type ContextCallback<T> = (value: T) => void;
+/**
+ * An event fired by a context requester to signal it desires a named context.
+ *
+ * A provider should inspect the `context` property of the event to determine if it has a value that can
+ * satisfy the request, calling the `callback` with the requested value if so.
+ */
+declare class ContextRequestEvent<T> extends Event {
+  readonly context: Context<T>;
+  readonly callback: ContextCallback<T>;
+  constructor(context: Context<T>, callback: ContextCallback<T>);
+}
+declare global {
+  interface HTMLElementEventMap {
+    /**
+     * A 'context-request' event can be emitted by any element which desires
+     * a context value to be injected by an external provider.
+     */
+    'context-request': ContextRequestEvent<unknown>;
+  }
 }
 
 declare const hasOpenChildModal: unique symbol;
 
-declare const open: unique symbol;
 declare const show: unique symbol;
 declare const hide: unique symbol;
+declare const isOpen: unique symbol;
 declare const dialog: unique symbol;
+declare const dismiss: unique symbol;
+declare const focusedElement: unique symbol;
 declare const onEscape: unique symbol;
 declare const nestedModals: unique symbol;
 declare const onBackdropClick: unique symbol;
 declare const abortController: unique symbol;
 declare const onChildModalChange: unique symbol;
 declare const childrenRerenderObserver: unique symbol;
+declare const shadowDomRerenderObserver: unique symbol;
 declare class Modal extends PreactOverlayElement implements ModalProps {
   accessor accessibilityLabel: ModalProps['accessibilityLabel'];
   accessor heading: ModalProps['heading'];
@@ -162,17 +242,23 @@ declare class Modal extends PreactOverlayElement implements ModalProps {
   /** @private */
   [dialog]: HTMLDialogElement | null;
   /** @private */
+  [focusedElement]: HTMLElement | null;
+  /** @private */
   [nestedModals]: Map<Modal, boolean>;
   /** @private */
   [childrenRerenderObserver]: MutationObserver;
   /** @private */
+  [shadowDomRerenderObserver]: MutationObserver;
+  /** @private */
   [onEscape]: (event: KeyboardEvent) => void;
   /** @private */
   [onBackdropClick]: (event: MouseEvent) => void;
   /** @private */
   [onChildModalChange]: EventListenerOrEventListenerObject;
   /** @private */
-  get [open](): boolean;
+  get [isOpen](): boolean;
+  /** @private */
+  [dismiss](): void;
   /** @private */
   get [hasOpenChildModal](): boolean;
   /** @private */
@@ -196,7 +282,8 @@ declare global {
 declare module 'preact' {
   namespace createElement.JSX {
     interface IntrinsicElements {
-      [tagName]: Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'>;
+      [tagName]: Omit<ModalJSXProps, 'primaryAction' | 'secondaryActions'> &
+        PreactBaseElementPropsWithChildren<Modal>;
     }
   }
 }
@@ -204,7 +291,11 @@ declare module 'preact' {
 declare const tagName = 's-modal';
 export interface ModalJSXProps
   extends Partial<ModalProps>,
-    Pick<ModalProps$1, 'id'> {
+    Pick<ModalProps$1, 'id' | 'children'> {
+  /**
+   * The content of the Modal.
+   */
+  children?: ComponentChildren;
   /**
    * The primary action to perform.
    *
@@ -214,7 +305,7 @@ export interface ModalJSXProps
   /**
    * The secondary actions to perform.
    *
-   * Only `ButtonGroup` or `Button` with a variant of `secondary` or `auto` are allowed.
+   * Only `Button` elements with a variant of `secondary` or `auto` are allowed.
    */
   secondaryActions?: ComponentChildren;
   onHide?: ((event: CallbackEvent<typeof tagName>) => void) | null;

package/build/ts/surfaces/admin/components/MoneyField/MoneyField.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MoneyField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/MoneyField/MoneyField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"MoneyField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/MoneyField/MoneyField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAwIX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

package/build/ts/surfaces/admin/components/NumberField/NumberField.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/NumberField/NumberField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"NumberField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/NumberField/NumberField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAkGX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -111,7 +111,12 @@ declare module 'preact' {
 declare const tagName = 's-option';
 export interface OptionJSXProps
   extends Partial<OptionProps>,
-    Pick<OptionProps$1, 'id'> {}
+    Pick<OptionProps$1, 'id' | 'children'> {
+  /**
+   * The content to use as the label.
+   */
+  children?: ComponentChildren;
+}
 
 export {Option};
 export type {OptionJSXProps};

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -111,7 +111,14 @@ declare module 'preact' {
 declare const tagName = 's-option-group';
 export interface OptionGroupJSXProps
   extends Partial<OptionGroupProps>,
-    Pick<OptionGroupProps$1, 'id'> {}
+    Pick<OptionGroupProps$1, 'id' | 'children'> {
+  /**
+   * The options a user can select from.
+   *
+   * Accepts `Option` components.
+   */
+  children?: ComponentChildren;
+}
 
 export {OptionGroup};
 export type {OptionGroupJSXProps};

package/build/ts/surfaces/admin/components/OrderedList/OrderedList.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrderedList.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/OrderedList/OrderedList.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAIpE,QAAA,MAAM,IAAI,EAAE,kCAkCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"OrderedList.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/OrderedList/OrderedList.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAIpE,QAAA,MAAM,IAAI,EAAE,kCAyHX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -107,7 +107,14 @@ declare module 'preact' {
 declare const tagName = 's-ordered-list';
 export interface OrderedListJSXProps
   extends Partial<OrderedListProps>,
-    Pick<OrderedListProps$1, 'id'> {}
+    Pick<OrderedListProps$1, 'id'> {
+  /**
+   * The items of the OrderedList.
+   *
+   * Only ListItems are accepted.
+   */
+  children?: ComponentChildren;
+}
 
 export {OrderedList};
 export type {OrderedListJSXProps};

package/build/ts/surfaces/admin/components/Page/Page.ab.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Page.ab.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Page/Page.ab.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA+BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Page.ab.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Page/Page.ab.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA6GX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -92,7 +92,9 @@ declare class Page extends PreactCustomElement implements PageProps {
   accessor inlineSize: PageProps['inlineSize'];
   accessor heading: PageProps['heading'];
   constructor();
+  /** @private */
   connectedCallback(): void;
+  /** @private */
   disconnectedCallback(): void;
 }
 declare global {
@@ -115,7 +117,11 @@ declare module 'preact' {
 declare const tagName = 's-page';
 export interface PageJSXProps
   extends Partial<PageProps>,
-    Pick<PageProps$1, 'id'> {
+    Pick<PageProps$1, 'id' | 'children'> {
+  /**
+   * The content of the Page.
+   */
+  children?: ComponentChildren;
   /**
    * The content to display in the aside section of the page.
    *

package/build/ts/surfaces/admin/components/Paragraph/Paragraph.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Paragraph.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Paragraph/Paragraph.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAqJX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Paragraph.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Paragraph/Paragraph.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA6LX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -21,7 +21,6 @@ export interface ParagraphProps
     >
   > {
   color: Extract<ParagraphProps$1['color'], 'base' | 'subdued'>;
-  lineClamp: Extract<ParagraphProps$1['lineClamp'], number>;
 }
 
 export type Styles = string;
@@ -129,7 +128,12 @@ declare module 'preact' {
 declare const tagName = 's-paragraph';
 export interface ParagraphJSXProps
   extends Partial<ParagraphProps>,
-    Pick<ParagraphProps$1, 'id'> {}
+    Pick<ParagraphProps$1, 'id' | 'children'> {
+  /**
+   * The content of the Paragraph.
+   */
+  children?: ComponentChildren;
+}
 
 export {Paragraph};
 export type {ParagraphJSXProps};

package/build/ts/surfaces/admin/components/PasswordField/PasswordField.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PasswordField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/PasswordField/PasswordField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"PasswordField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/PasswordField/PasswordField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAuIX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

package/build/ts/surfaces/admin/components/Popover/Popover.ab.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.ab.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Popover/Popover.ab.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAmCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Popover.ab.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Popover/Popover.ab.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAmIX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/components/QueryContainer/QueryContainer.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryContainer.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/QueryContainer/QueryContainer.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAiCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"QueryContainer.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/QueryContainer/QueryContainer.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAkEX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -8,6 +8,21 @@
 /// <reference lib="DOM" />
 import type {ComponentChildren, QueryContainerProps$1} from './shared.d.ts';
 
+/** Used when an element does not have children. */
+export interface PreactBaseElementProps<TClass extends HTMLElement> {
+  /** Assigns a unique key to this element. */
+  key?: preact.Key;
+  /** Assigns a ref (generally from `useRef()`) to this element. */
+  ref?: preact.Ref<TClass>;
+  /** Assigns this element to a parent's slot. */
+  slot?: Lowercase<string>;
+}
+/** Used when an element has children. */
+export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
+  extends PreactBaseElementProps<TClass> {
+  children?: preact.ComponentChildren;
+}
+
 export type Styles = string;
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   ShadowRoot: (element: any) => ComponentChildren;
@@ -88,7 +103,8 @@ declare global {
 declare module 'preact' {
   namespace createElement.JSX {
     interface IntrinsicElements {
-      [tagName]: QueryContainerJSXProps;
+      [tagName]: QueryContainerJSXProps &
+        PreactBaseElementPropsWithChildren<QueryContainer>;
     }
   }
 }
@@ -96,7 +112,12 @@ declare module 'preact' {
 declare const tagName = 's-query-container';
 export interface QueryContainerJSXProps
   extends Partial<QueryContainerProps$1>,
-    Pick<QueryContainerProps$1, 'id'> {}
+    Pick<QueryContainerProps$1, 'id' | 'children'> {
+  /**
+   * The content of the container.
+   */
+  children?: ComponentChildren;
+}
 
 export {QueryContainer};
 export type {QueryContainerJSXProps};

package/build/ts/surfaces/admin/components/SearchField/SearchField.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/SearchField/SearchField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"SearchField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/SearchField/SearchField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAqHX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

package/build/ts/surfaces/admin/components/Section/Section.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Section.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Section/Section.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA+CX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Section.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Section/Section.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAsIX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -117,7 +117,12 @@ declare module 'preact' {
 declare const tagName = 's-section';
 export interface SectionJSXProps
   extends Partial<SectionProps>,
-    Pick<SectionProps$1, 'id'> {}
+    Pick<SectionProps$1, 'id' | 'children'> {
+  /**
+   * The content of the Section.
+   */
+  children?: ComponentChildren;
+}
 
 export {Section};
 export type {SectionJSXProps};

package/build/ts/surfaces/admin/components/Select/Select.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Select/Select.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAKpE,QAAA,MAAM,IAAI,EAAE,kCAsDX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Select.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Select/Select.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAKpE,QAAA,MAAM,IAAI,EAAE,kCAiLX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -202,7 +202,13 @@ declare module 'preact' {
 declare const tagName = 's-select';
 export interface SelectJSXProps
   extends Partial<SelectProps>,
-    Pick<SelectProps$1, 'id'> {
+    Pick<SelectProps$1, 'id' | 'children'> {
+  /**
+   * The options a user can select from.
+   *
+   * Accepts `Option` and `OptionGroup` components.
+   */
+  children?: ComponentChildren;
   onChange?: (event: CallbackEvent<typeof tagName>) => void;
   onInput?: (event: CallbackEvent<typeof tagName>) => void;
   onBlur?: (event: CallbackEvent<typeof tagName>) => void;

package/build/ts/surfaces/admin/components/Spinner/Spinner.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Spinner/Spinner.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAuBX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Spinner.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Spinner/Spinner.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA4FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

package/build/ts/surfaces/admin/components/Stack/Stack.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stack.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Stack/Stack.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAmDX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Stack.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Stack/Stack.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA+JX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,4 +1,4 @@
-/** VERSION: 1.20.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
@@ -299,7 +299,7 @@ export interface StackProps
    * Adjust spacing between elements.
    *
    * `gap` can either accept:
-   * - a single SpacingKeyword value applied to both axes (e.g. `large-100`)
+   * - a single [SpacingKeyword](https://shopify.dev/docs/api/app-home/using-polaris-components#scale) value applied to both axes (e.g. `large-100`)
    * - OR a pair of values (eg `large-100 large-500`) can be used to set the inline and block axes respectively
    * - OR a [responsive value](https://shopify.dev/docs/api/app-home/using-polaris-components#responsive-values) string with the supported SpacingKeyword as a query value.
    *
@@ -311,7 +311,7 @@ export interface StackProps
    *
    * This overrides the row value of `gap`.
    * `rowGap` either accepts:
-   * - a single SpacingKeyword value (e.g. `large-100`)
+   * - a single [SpacingKeyword](https://shopify.dev/docs/api/app-home/using-polaris-components#scale) value (e.g. `large-100`)
    * - OR a [responsive value](https://shopify.dev/docs/api/app-home/using-polaris-components#responsive-values) string with the supported SpacingKeyword as a query value.
    *
    * @default '' - meaning no override
@@ -322,7 +322,7 @@ export interface StackProps
    *
    * This overrides the column value of `gap`.
    * `columnGap` either accepts:
-   * - a single SpacingKeyword value (e.g. `large-100`)
+   * - a single [SpacingKeyword](https://shopify.dev/docs/api/app-home/using-polaris-components#scale) value (e.g. `large-100`)
    * - OR a [responsive value](https://shopify.dev/docs/api/app-home/using-polaris-components#responsive-values) string with the supported SpacingKeyword as a query value.
    *
    * @default '' - meaning no override
@@ -471,7 +471,12 @@ declare module 'preact' {
 declare const tagName = 's-stack';
 export interface StackJSXProps
   extends Partial<StackProps>,
-    Pick<StackProps$1, 'id'> {}
+    Pick<StackProps$1, 'id' | 'children'> {
+  /**
+   * The content of the Stack.
+   */
+  children?: ComponentChildren;
+}
 
 export {Stack};
 export type {StackJSXProps};

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

@@ -1,3 +1,3 @@
-export type StandardComponents = 'Avatar' | 'Badge' | 'Banner' | 'Box' | 'Button' | 'ButtonGroup' | 'Checkbox' | 'Chip' | 'Choice' | 'ChoiceList' | 'Clickable' | 'ClickableChip' | 'ColorField' | 'ColorPicker' | 'DateField' | 'DatePicker' | 'Divider' | 'EmailField' | 'Grid' | 'GridItem' | 'Heading' | 'Icon' | 'Image' | 'Link' | 'ListItem' | 'Menu' | 'MoneyField' | 'NumberField' | 'Option' | 'OptionGroup' | 'OrderedList' | 'Paragraph' | 'PasswordField' | 'QueryContainer' | 'Section' | 'Select' | 'Spinner' | 'Stack' | 'Table' | 'TableBody' | 'TableCell' | 'TableHeader' | 'TableHeaderRow' | 'TableRow' | 'Text' | 'TextArea' | 'TextField' | 'Thumbnail' | 'Tooltip' | 'UnorderedList' | 'URLField';
+export type StandardComponents = 'Avatar' | 'Badge' | 'Banner' | 'Box' | 'Button' | 'ButtonGroup' | 'Checkbox' | 'Chip' | 'Choice' | 'ChoiceList' | 'Clickable' | 'ClickableChip' | 'ColorField' | 'ColorPicker' | 'DateField' | 'DatePicker' | 'DropZone' | 'Divider' | 'EmailField' | 'Grid' | 'GridItem' | 'Heading' | 'Icon' | 'Image' | 'Link' | 'ListItem' | 'Menu' | 'MoneyField' | 'NumberField' | 'Option' | 'OptionGroup' | 'OrderedList' | 'Paragraph' | 'PasswordField' | 'QueryContainer' | 'SearchField' | 'Section' | 'Select' | 'Spinner' | 'Stack' | 'Switch' | 'Table' | 'TableBody' | 'TableCell' | 'TableHeader' | 'TableHeaderRow' | 'TableRow' | 'Text' | 'TextArea' | 'TextField' | 'Thumbnail' | 'Tooltip' | 'UnorderedList' | 'URLField';
 export default StandardComponents;
 //# sourceMappingURL=StandardComponents.d.ts.map

package/build/ts/surfaces/admin/components/StandardComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardComponents.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/admin/components/StandardComponents.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,aAAa,GACb,UAAU,GACV,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,eAAe,GACf,YAAY,GACZ,aAAa,GACb,WAAW,GACX,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,MAAM,GACN,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,YAAY,GACZ,aAAa,GACb,QAAQ,GACR,aAAa,GACb,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,MAAM,GACN,UAAU,GACV,WAAW,GACX,WAAW,GACX,SAAS,GACT,eAAe,GACf,UAAU,CAAC;AAEf,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"StandardComponents.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/admin/components/StandardComponents.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,aAAa,GACb,UAAU,GACV,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,eAAe,GACf,YAAY,GACZ,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,SAAS,GACT,YAAY,GACZ,MAAM,GACN,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,YAAY,GACZ,aAAa,GACb,QAAQ,GACR,aAAa,GACb,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,OAAO,GACP,WAAW,GACX,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,MAAM,GACN,UAAU,GACV,WAAW,GACX,WAAW,GACX,SAAS,GACT,eAAe,GACf,UAAU,CAAC;AAEf,eAAe,kBAAkB,CAAC"}

package/build/ts/surfaces/admin/components/Switch/Switch.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Switch.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Switch/Switch.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCA4BX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Switch.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Switch/Switch.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAyKX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

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

package/build/ts/surfaces/admin/components/Table/Table.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Table.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Table/Table.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AASpE,QAAA,MAAM,IAAI,EAAE,kCA6FX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Table.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Table/Table.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AASpE,QAAA,MAAM,IAAI,EAAE,kCAyMX,CAAC;AAEF,eAAe,IAAI,CAAC"}