@shopify/ui-extensions 2025.10.0-rc.6 → 2025.10.0-rc.8

package/build/ts/surfaces/admin/targets/admin.settings.validation.render.d.ts

@@ -100,6 +100,58 @@ export interface UnorderedListProps extends UnorderedListProps$1 {
 declare const UnorderedListtagName = 's-unordered-list';
 declare const UnorderedListBaseClass: typeof globalThis.HTMLElement;
 
+declare module 'preact' {
+    namespace createElement.JSX {
+        interface IntrinsicElements {
+            [ThumbnailtagName]: ThumbnailJSXProps & ThumbnailPreactBaseElementProps<Thumbnail>;
+        }
+    }
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        [ThumbnailtagName]: Thumbnail;
+    }
+}
+
+export interface ThumbnailJSXProps extends Partial<ThumbnailProps>, Pick<ThumbnailProps$1, 'id'> {
+    onLoad?: ((event: CallbackEvent<typeof ThumbnailtagName>) => void) | null;
+    onError?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+
+export interface ThumbnailClickOptions {
+    /**
+     * The event you want to influence the synthetic click.
+     */
+    sourceEvent?: ThumbnailActivationEventEsque;
+}
+
+export interface ThumbnailActivationEventEsque {
+    shiftKey: boolean;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    button: number;
+}
+
+export interface ThumbnailPreactBaseElementProps<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>;
+}
+
+export interface ThumbnailProps extends Required<Pick<ThumbnailProps$1, 'src' | 'alt'>> {
+    size: Extract<
+        ThumbnailProps$1['size'],
+        'small-200' | 'small-100' | 'small' | 'base' | 'large' | 'large-100'
+        >;
+}
+
+declare const ThumbnailtagName = 's-thumbnail';
+declare const ThumbnailBaseClass: typeof globalThis.HTMLElement;
+
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
@@ -3426,7 +3478,7 @@ import { PasswordField, PasswordFieldProps } from "../../../../../src/surfaces/a
 import { QueryContainer } from "../../../../../src/surfaces/admin/components/QueryContainer";
 import { RequiredSectionProps, Section } from "../../../../../src/surfaces/admin/components/Section";
 import { Select } from "../../../../../src/surfaces/admin/components/Select";
-import { BadgeProps$1, BannerProps$1, BoxProps$1, ButtonProps$1, CheckboxProps$1, ChoiceListProps$1, ChoiceProps$1, ClickableProps$1, ComponentChild, DatePickerProps$1, DividerProps$1, EmailFieldProps$1, GridItemProps$1, GridProps$1, HeadingProps$1, IconProps$1, IconType, ImageProps$1, InteractionProps, LinkProps$1, ListItemProps$1, MaybeAllValuesShorthandProperty, MoneyFieldProps$1, NumberFieldProps$1, OptionGroupProps$1, OptionProps$1, OrderedListProps$1, ParagraphProps$1, PasswordFieldProps$1, QueryContainerProps$1, SectionProps$1, SelectProps$1, SpinnerProps$1, StackProps$1, TableBodyProps$1, TableCellProps$1, TableHeaderProps$1, TableHeaderRowProps$1, TableProps$1, TableRowProps$1, TextAreaProps$1, TextFieldProps$1, TextProps$1, URLFieldProps$1, UnorderedListProps$1 } from "../../../../../src/surfaces/admin/components/shared";
+import { BadgeProps$1, BannerProps$1, BoxProps$1, ButtonProps$1, CheckboxProps$1, ChoiceListProps$1, ChoiceProps$1, ClickableProps$1, ComponentChild, DatePickerProps$1, DividerProps$1, EmailFieldProps$1, GridItemProps$1, GridProps$1, HeadingProps$1, IconProps$1, IconType, ImageProps$1, InteractionProps, LinkProps$1, ListItemProps$1, MaybeAllValuesShorthandProperty, MoneyFieldProps$1, NumberFieldProps$1, OptionGroupProps$1, OptionProps$1, OrderedListProps$1, ParagraphProps$1, PasswordFieldProps$1, QueryContainerProps$1, SectionProps$1, SelectProps$1, SpinnerProps$1, StackProps$1, TableBodyProps$1, TableCellProps$1, TableHeaderProps$1, TableHeaderRowProps$1, TableProps$1, TableRowProps$1, TextAreaProps$1, TextFieldProps$1, TextProps$1, ThumbnailProps$1, URLFieldProps$1, UnorderedListProps$1 } from "../../../../../src/surfaces/admin/components/shared";
 import { Spinner } from "../../../../../src/surfaces/admin/components/Spinner";
 import { AlignedStackProps, ResponsiveStackProps, Stack } from "../../../../../src/surfaces/admin/components/Stack";
 import { Table } from "../../../../../src/surfaces/admin/components/Table";
@@ -3437,6 +3489,7 @@ import { TableHeaderRow } from "../../../../../src/surfaces/admin/components/Tab
 import { TableRow } from "../../../../../src/surfaces/admin/components/TableRow";
 import { TextArea, TextAreaProps } from "../../../../../src/surfaces/admin/components/TextArea";
 import { TextField, TextFieldProps } from "../../../../../src/surfaces/admin/components/TextField";
+import { Thumbnail } from "../../../../../src/surfaces/admin/components/Thumbnail";
 import { UnorderedList } from "../../../../../src/surfaces/admin/components/UnorderedList";
 import { URLField, URLFieldProps } from "../../../../../src/surfaces/admin/components/URLField";
 import type { ExtensionTargets } from '../extension-targets';

package/build/ts/surfaces/checkout/components/Abbreviation.d.ts

@@ -1,32 +1,44 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {AbbreviationProps$1} from './components-shared.d.ts';
 
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
+}
+/**
+ * Used when an element has children.
+ */
+export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    children?: preact.ComponentChildren;
+}
+
+declare const tagName = "s-abbreviation";
 export interface AbbreviationProps extends Pick<AbbreviationProps$1, 'title'> {
 }
 export interface AbbreviationElement extends AbbreviationProps, Omit<HTMLElement, 'id' | 'title'> {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-abbreviation': AbbreviationElement;
+        [tagName]: AbbreviationElement;
     }
 }
 declare module 'preact' {
-    interface BaseProps {
-        children?: preact.ComponentChildren;
-        slot?: Lowercase<string>;
-    }
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-abbreviation': AbbreviationProps & BaseProps;
+            [tagName]: AbbreviationProps & BaseElementPropsWithChildren<AbbreviationElement>;
         }
     }
 }

package/build/ts/surfaces/checkout/components/Banner/Banner.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Banner.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/Banner/Banner.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAG1E,QAAA,MAAM,IAAI,EAAE,6BAkCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Banner.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/Banner/Banner.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAI1E,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/checkout/components/Banner.d.ts

@@ -1,37 +1,76 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {BannerProps$1} from './components-shared.d.ts';
 
-export interface BannerProps extends Pick<BannerProps$1, 'collapsible' | 'dismissible' | 'heading' | 'hidden' | 'id' | 'onAfterHide' | 'onDismiss' | 'tone'> {
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
+}
+/**
+ * Used when an element has children.
+ */
+export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    children?: preact.ComponentChildren;
+}
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+
+declare const tagName = "s-banner";
+export interface BannerBaseProps extends Pick<BannerProps$1, 'collapsible' | 'dismissible' | 'heading' | 'hidden' | 'id' | 'tone'> {
     tone?: Extract<BannerProps$1['tone'], 'auto' | 'info' | 'success' | 'warning' | 'critical'>;
 }
-export interface BannerElement extends Omit<BannerProps, 'onAfterHide' | 'onDismiss'>, Omit<HTMLElement, 'id' | 'title' | 'hidden'> {
-    onafterhide: BannerProps['onAfterHide'];
-    ondismiss: BannerProps['onDismiss'];
+export interface BannerEvents extends Pick<BannerProps$1, 'onAfterHide' | 'onDismiss'> {
+}
+export interface BannerElementEvents {
+    /**
+     * Event handler when the banner has fully hidden.
+     *
+     * The `hidden` property will be `true` when this event fires.
+     *
+     * @implementation If implementations animate the hiding of the banner,
+     * this event must fire after the banner has fully hidden.
+     * We can add an `onHide` event in future if we want to provide a hook for the start of the animation.
+     */
+    afterhide?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+    /**
+     * Event handler when the banner is dismissed by the user.
+     *
+     * This does not fire when setting `hidden` manually.
+     *
+     * The `hidden` property will be `false` when this event fires.
+     */
+    dismiss?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+export interface BannerElement extends BannerBaseProps, Omit<BannerEvents, 'onAfterHide' | 'onDismiss'>, Omit<HTMLElement, 'id' | 'title' | 'hidden'> {
+    onafterhide: BannerEvents['onAfterHide'];
+    ondismiss: BannerEvents['onDismiss'];
+}
+export interface BannerProps extends BannerBaseProps, BannerEvents {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-banner': BannerElement;
+        [tagName]: BannerElement;
     }
 }
 declare module 'preact' {
-    interface BaseProps {
-        children?: preact.ComponentChildren;
-        slot?: Lowercase<string>;
-    }
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-banner': BannerProps & BaseProps;
+            [tagName]: BannerProps & BaseElementPropsWithChildren<BannerElement>;
         }
     }
 }
 
-export type { BannerElement, BannerProps };
+export type { BannerBaseProps, BannerElement, BannerElementEvents, BannerEvents, BannerProps };

package/build/ts/surfaces/checkout/components/Box.d.ts

@@ -1,11 +1,11 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {BoxProps$1,MaybeAllValuesShorthandProperty,BorderSizeKeyword, BorderStyleKeyword,ColorKeyword} from './components-shared.d.ts';
@@ -13,8 +13,23 @@ import type {BoxProps$1,MaybeAllValuesShorthandProperty,BorderSizeKeyword, Borde
 export type ReducedBorderSizeKeyword = Extract<BorderSizeKeyword, 'none' | 'base' | 'large' | 'large-100' | 'large-200'>;
 export type ReducedColorKeyword = Extract<ColorKeyword, 'base'>;
 export type BorderShorthand = ReducedBorderSizeKeyword | `${ReducedBorderSizeKeyword} ${ReducedColorKeyword}` | `${ReducedBorderSizeKeyword} ${ReducedColorKeyword} ${BorderStyleKeyword}`;
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
+}
+/**
+ * Used when an element has children.
+ */
+export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    children?: preact.ComponentChildren;
+}
 
-export interface BoxProps extends Pick<BoxProps$1, 'accessibilityLabel' | 'accessibilityRole' | 'accessibilityVisibility' | 'background' | 'border' | 'borderRadius' | 'borderStyle' | 'borderWidth' | 'display' | 'id' | 'maxBlockSize' | 'maxInlineSize' | 'minBlockSize' | 'minInlineSize' | 'overflow' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart'> {
+declare const tagName = "s-box";
+export interface BoxProps extends Pick<BoxProps$1, 'accessibilityLabel' | 'accessibilityRole' | 'accessibilityVisibility' | 'background' | 'blockSize' | 'border' | 'borderRadius' | 'borderStyle' | 'borderWidth' | 'display' | 'id' | 'inlineSize' | 'maxBlockSize' | 'maxInlineSize' | 'minBlockSize' | 'minInlineSize' | 'overflow' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart'> {
     background?: Extract<BoxProps$1['background'], 'transparent' | 'subdued' | 'base'>;
     border?: BorderShorthand;
     borderWidth?: MaybeAllValuesShorthandProperty<ReducedBorderSizeKeyword> | '';
@@ -24,17 +39,13 @@ export interface BoxElement extends BoxProps, Omit<HTMLElement, 'id'> {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-box': BoxElement;
+        [tagName]: BoxElement;
     }
 }
 declare module 'preact' {
-    interface BaseProps {
-        children?: preact.ComponentChildren;
-        slot?: Lowercase<string>;
-    }
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-box': BoxProps & BaseProps;
+            [tagName]: BoxProps & BaseElementPropsWithChildren<BoxElement>;
         }
     }
 }

package/build/ts/surfaces/checkout/components/Button/Button.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/Button/Button.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAG1E,QAAA,MAAM,IAAI,EAAE,6BAkCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Button.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/Button/Button.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAI1E,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/checkout/components/Button.d.ts

@@ -1,39 +1,65 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {ButtonProps$1} from './components-shared.d.ts';
 
-export interface ButtonProps extends Pick<ButtonProps$1, 'accessibilityLabel' | 'command' | 'commandFor' | 'disabled' | 'href' | 'id' | 'inlineSize' | 'loading' | 'onClick' | 'target' | 'tone' | 'type' | 'variant'> {
-    target?: Extract<ButtonProps$1['target'], 'auto' | '_self' | '_blank'>;
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
+}
+/**
+ * Used when an element has children.
+ */
+export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    children?: preact.ComponentChildren;
+}
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+
+declare const tagName = "s-button";
+export interface ButtonBaseProps extends Pick<ButtonProps$1, 'accessibilityLabel' | 'command' | 'commandFor' | 'disabled' | 'href' | 'id' | 'inlineSize' | 'loading' | 'target' | 'tone' | 'type' | 'variant'> {
+    target?: Extract<ButtonProps$1['target'], 'auto' | '_blank'>;
     tone?: Extract<ButtonProps$1['tone'], 'auto' | 'neutral' | 'critical'>;
     type?: Extract<ButtonProps$1['type'], 'submit' | 'button'>;
     variant?: Extract<ButtonProps$1['variant'], 'auto' | 'primary' | 'secondary'>;
 }
-export interface ButtonElement extends Omit<ButtonProps, 'onClick'>, Omit<HTMLElement, 'id' | 'onclick'> {
-    onclick: ButtonProps['onClick'];
+export interface ButtonEvents extends Pick<ButtonProps$1, 'onClick'> {
+}
+export interface ButtonElementEvents {
+    /**
+     * Callback when the button is activated.
+     * This will be called before the action indicated by `type`.
+     */
+    click?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+export interface ButtonElement extends ButtonBaseProps, Omit<ButtonEvents, 'onClick'>, Omit<HTMLElement, 'id' | 'onclick'> {
+    onclick: ButtonEvents['onClick'];
+}
+export interface ButtonProps extends ButtonBaseProps, ButtonEvents {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-button': ButtonElement;
+        [tagName]: ButtonElement;
     }
 }
 declare module 'preact' {
-    interface BaseProps {
-        children?: preact.ComponentChildren;
-        slot?: Lowercase<string>;
-    }
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-button': ButtonProps & BaseProps;
+            [tagName]: ButtonProps & BaseElementPropsWithChildren<ButtonElement>;
         }
     }
 }
 
-export type { ButtonElement, ButtonProps };
+export type { ButtonBaseProps, ButtonElement, ButtonElementEvents, ButtonEvents, ButtonProps };

package/build/ts/surfaces/checkout/components/Checkbox/Checkbox.doc.d.ts

@@ -0,0 +1,4 @@
+import type { ReferenceEntityTemplateSchema } from '@shopify/generate-docs';
+declare const data: ReferenceEntityTemplateSchema;
+export default data;
+//# sourceMappingURL=Checkbox.doc.d.ts.map

package/build/ts/surfaces/checkout/components/Checkbox/Checkbox.doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/Checkbox/Checkbox.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAI1E,QAAA,MAAM,IAAI,EAAE,6BA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/checkout/components/Checkbox.d.ts

@@ -0,0 +1,54 @@
+/** VERSION: 0.0.0 **/
+/* eslint-disable import-x/extensions */
+/* eslint-disable @typescript-eslint/no-namespace */
+/* eslint-disable @typescript-eslint/member-ordering */
+/* eslint-disable line-comment-position */
+/* eslint-disable @typescript-eslint/unified-signatures */
+/* eslint-disable no-var */
+/* eslint-disable import-x/namespace */
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
+/// <reference lib="DOM" />
+import type {CheckboxProps$1} from './components-shared.d.ts';
+
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
+}
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+
+declare const tagName = "s-checkbox";
+export interface CheckboxBaseProps extends Pick<CheckboxProps$1, 'accessibilityLabel' | 'checked' | 'command' | 'commandFor' | 'defaultChecked' | 'disabled' | 'error' | 'id' | 'label' | 'name' | 'required' | 'value'> {
+}
+export interface CheckboxEvents extends Pick<CheckboxProps$1, 'onChange'> {
+}
+export interface CheckboxElementEvents {
+    /**
+     * A callback that is run whenever the control is changed.
+     */
+    change?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+export interface CheckboxElement extends CheckboxBaseProps, Omit<CheckboxEvents, 'onChange'>, Omit<HTMLElement, 'id' | 'onchange'> {
+    onchange: CheckboxEvents['onChange'];
+}
+export interface CheckboxProps extends CheckboxBaseProps, CheckboxEvents {
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        [tagName]: CheckboxElement;
+    }
+}
+declare module 'preact' {
+    namespace createElement.JSX {
+        interface IntrinsicElements {
+            [tagName]: CheckboxProps & BaseElementProps<CheckboxElement>;
+        }
+    }
+}
+
+export type { CheckboxBaseProps, CheckboxElement, CheckboxElementEvents, CheckboxEvents, CheckboxProps };

package/build/ts/surfaces/checkout/components/ClipboardItem.d.ts

@@ -1,32 +1,59 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {ClipboardItemProps$1} from './components-shared.d.ts';
 
-export interface ClipboardItemProps extends ClipboardItemProps$1 {
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
 }
-export interface ClipboardItemElement extends Omit<ClipboardItemProps, 'onCopy' | 'onCopyError'>, Omit<HTMLElement, 'id' | 'oncopy'> {
-    oncopy: ClipboardItemProps['onCopy'];
-    oncopyerror: ClipboardItemProps['onCopyError'];
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+
+declare const tagName = "s-clipboard-item";
+export interface ClipboardItemBaseProps extends Pick<ClipboardItemProps$1, 'id' | 'text'> {
+}
+export interface ClipboardItemEvents extends Pick<ClipboardItemProps$1, 'onCopy' | 'onCopyError'> {
+}
+export interface ClipboardItemElementEvents {
+    /**
+     * Callback run when the copy to clipboard succeeds.
+     */
+    copy?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+    /**
+     * Callback run when the copy to clipboard fails.
+     */
+    copyerror?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+export interface ClipboardItemElement extends ClipboardItemBaseProps, Omit<ClipboardItemEvents, 'onCopy' | 'onCopyError'>, Omit<HTMLElement, 'id' | 'oncopy'> {
+    oncopy: ClipboardItemEvents['onCopy'];
+    oncopyerror: ClipboardItemEvents['onCopyError'];
+}
+export interface ClipboardItemProps extends ClipboardItemBaseProps, ClipboardItemEvents {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-clipboard-item': ClipboardItemElement;
+        [tagName]: ClipboardItemElement;
     }
 }
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-clipboard-item': ClipboardItemProps;
+            [tagName]: ClipboardItemProps & BaseElementProps<ClipboardItemElement>;
         }
     }
 }
 
-export type { ClipboardItemElement, ClipboardItemProps };
+export type { ClipboardItemBaseProps, ClipboardItemElement, ClipboardItemElementEvents, ClipboardItemEvents, ClipboardItemProps };

package/build/ts/surfaces/checkout/components/DropZone/DropZone.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DropZone.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/DropZone/DropZone.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAG1E,QAAA,MAAM,IAAI,EAAE,6BAmDX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"DropZone.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/DropZone/DropZone.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAI1E,QAAA,MAAM,IAAI,EAAE,6BAwDX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/checkout/components/DropZone.d.ts

@@ -1,32 +1,59 @@
 /** VERSION: 0.0.0 **/
-/* eslint-disable import/extensions */
+/* eslint-disable import-x/extensions */
 /* eslint-disable @typescript-eslint/no-namespace */
 /* eslint-disable @typescript-eslint/member-ordering */
 /* eslint-disable line-comment-position */
 /* eslint-disable @typescript-eslint/unified-signatures */
 /* eslint-disable no-var */
-/* eslint-disable import/namespace */
+/* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
 import type {DropZoneProps$1} from './components-shared.d.ts';
 
-export interface DropZoneProps extends Pick<DropZoneProps$1, 'accept' | 'accessibilityLabel' | 'disabled' | 'error' | 'id' | 'label' | 'multiple' | 'name' | 'onDropRejected' | 'onInput' | 'required'> {
+/**
+ * Used when an element does not have children.
+ */
+export interface BaseElementProps<TClass = HTMLElement> {
+    key?: preact.Key;
+    ref?: preact.Ref<TClass>;
+    slot?: Lowercase<string>;
 }
-export interface DropZoneElement extends Omit<DropZoneProps, 'onDropRejected' | 'onInput'>, Omit<HTMLElement, 'id' | 'oninput'> {
-    ondroprejected: DropZoneProps['onDropRejected'];
-    oninput: DropZoneProps['onInput'];
+export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
+    currentTarget: HTMLElementTagNameMap[TTagName];
+};
+
+declare const tagName = "s-drop-zone";
+export interface DropZoneBaseProps extends Pick<DropZoneProps$1, 'accept' | 'accessibilityLabel' | 'disabled' | 'error' | 'id' | 'label' | 'multiple' | 'name' | 'required'> {
+}
+export interface DropZoneEvents extends Pick<DropZoneProps$1, 'onDropRejected' | 'onInput'> {
+}
+export interface DropZoneElementEvents {
+    /**
+     * Callback when rejected files are dropped. Files are rejected based on the `accept` prop.
+     */
+    droprejected?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+    /**
+     * Callback when the user makes any changes in the field.
+     */
+    input?: ((event: CallbackEvent<typeof tagName>) => void) | null;
+}
+export interface DropZoneElement extends DropZoneBaseProps, Omit<DropZoneEvents, 'onDropRejected' | 'onInput'>, Omit<HTMLElement, 'id' | 'oninput'> {
+    ondroprejected: DropZoneEvents['onDropRejected'];
+    oninput: DropZoneEvents['onInput'];
+}
+export interface DropZoneProps extends DropZoneBaseProps, DropZoneEvents {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        's-drop-zone': DropZoneElement;
+        [tagName]: DropZoneElement;
     }
 }
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            's-drop-zone': DropZoneProps;
+            [tagName]: DropZoneProps & BaseElementProps<DropZoneElement>;
         }
     }
 }
 
-export type { DropZoneElement, DropZoneProps };
+export type { DropZoneBaseProps, DropZoneElement, DropZoneElementEvents, DropZoneEvents, DropZoneProps };

package/build/ts/surfaces/checkout/components/EmailField/EmailField.doc.d.ts

@@ -0,0 +1,4 @@
+import type { ReferenceEntityTemplateSchema } from '@shopify/generate-docs';
+declare const data: ReferenceEntityTemplateSchema;
+export default data;
+//# sourceMappingURL=EmailField.doc.d.ts.map

package/build/ts/surfaces/checkout/components/EmailField/EmailField.doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailField.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/components/EmailField/EmailField.doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAI1E,QAAA,MAAM,IAAI,EAAE,6BA8BX,CAAC;AAEF,eAAe,IAAI,CAAC"}