@shopify/ui-extensions 2026.4.0 → 2026.4.1

package/build/ts/surfaces/admin/api/generated/generated.d.ts

@@ -0,0 +1,62 @@
+/** Response handle on `shopify.intents.response` with a typed `ok` payload. */
+export interface ShopifyGeneratedIntentResponse<Data = unknown> {
+    ok(data?: Data): Promise<void>;
+}
+export interface ShopifyGeneratedIntentVariant<Request = unknown, ResponseData = unknown> {
+    request: Request;
+    response?: ShopifyGeneratedIntentResponse<ResponseData>;
+}
+type ReplaceSubscribableValue<Base, Value> = Base extends {
+    value: unknown;
+    subscribe: (callback: (value: infer _) => void) => () => void;
+} ? Omit<Base, 'value' | 'subscribe'> & {
+    readonly value: Value;
+    subscribe: (callback: (value: Value) => void) => () => void;
+} : {
+    readonly value: Value;
+    subscribe: (callback: (value: Value) => void) => () => void;
+};
+type MergeGeneratedIntentResponse<BaseIntents, Variants> = Variants extends infer Variant ? Variant extends {
+    request: infer GeneratedRequest;
+} ? Omit<Variant, 'request' | 'response'> & {
+    request: BaseIntents extends {
+        request: infer BaseRequest;
+    } ? ReplaceSubscribableValue<BaseRequest, GeneratedRequest | null> : {
+        readonly value: GeneratedRequest | null;
+        subscribe: (callback: (value: GeneratedRequest | null) => void) => () => void;
+    };
+} & (Variant extends {
+    response: infer GeneratedResponse;
+} ? BaseIntents extends {
+    response: infer BaseResponse;
+} ? {
+    response: Omit<NonNullable<BaseResponse>, 'ok'> & NonNullable<GeneratedResponse>;
+} : {
+    response: NonNullable<GeneratedResponse>;
+} : unknown) : Variant : never;
+/**
+ * Merges generated intent variants into a target's base `Api`. Narrows
+ * `intents.request` to the union and specialises `intents.response.ok`;
+ * introduces `intents` if the base has none.
+ */
+export type WithGeneratedIntents<Api, Variants> = Api extends {
+    intents?: infer BaseIntents;
+} ? Omit<Api, 'intents'> & {
+    intents: Omit<NonNullable<BaseIntents>, 'request' | 'response'> & MergeGeneratedIntentResponse<NonNullable<BaseIntents>, Variants>;
+} : Api & {
+    intents: Variants;
+};
+/**
+ * Merges generated tool registrations into a target's base `Api`. Replaces
+ * `tools.register` with the typed overloads in `Tools`; introduces `tools` if
+ * the base has none.
+ */
+export type WithGeneratedTools<Api, Tools> = Api extends {
+    tools?: infer BaseTools;
+} ? Omit<Api, 'tools'> & {
+    tools: Omit<NonNullable<BaseTools>, 'register'> & Tools;
+} : Api & {
+    tools: Tools;
+};
+export {};
+//# sourceMappingURL=generated.d.ts.map

package/build/ts/surfaces/admin/api/generated/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/generated/generated.ts"],"names":[],"mappings":"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"}

package/build/ts/surfaces/admin/api.d.ts

@@ -13,4 +13,5 @@ export type { ValidationSettingsApi } from './api/checkout-rules/validation-sett
 export type { PurchaseOptionsCardConfigurationApi } from './api/purchase-options-card-action';
 export type { DiscountFunctionSettingsApi } from './api/discount-function-settings/discount-function-settings';
 export type { IntentRenderApi } from './api/intents/intent-render';
+export type { ShopifyGeneratedIntentResponse, ShopifyGeneratedIntentVariant, WithGeneratedIntents, WithGeneratedTools, } from './api/generated/generated';
 //# sourceMappingURL=api.d.ts.map

package/build/ts/surfaces/admin/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/admin/api.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,IAAI,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AACnD,YAAY,EAAC,WAAW,EAAE,OAAO,EAAC,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAC,6BAA6B,EAAC,MAAM,mCAAmC,CAAC;AACrF,YAAY,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,2DAA2D,CAAC;AACnE,YAAY,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAC,uBAAuB,EAAC,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAC,8BAA8B,EAAC,MAAM,2DAA2D,CAAC;AAC9G,YAAY,EAAC,qCAAqC,EAAC,MAAM,mEAAmE,CAAC;AAC7H,YAAY,EAAC,mBAAmB,EAAC,MAAM,6CAA6C,CAAC;AACrF,YAAY,EAAC,qBAAqB,EAAC,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAC,mCAAmC,EAAC,MAAM,oCAAoC,CAAC;AAC5F,YAAY,EAAC,2BAA2B,EAAC,MAAM,6DAA6D,CAAC;AAC7G,YAAY,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/admin/api.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,IAAI,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AACnD,YAAY,EAAC,WAAW,EAAE,OAAO,EAAC,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAC,6BAA6B,EAAC,MAAM,mCAAmC,CAAC;AACrF,YAAY,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,2DAA2D,CAAC;AACnE,YAAY,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAC,uBAAuB,EAAC,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAC,8BAA8B,EAAC,MAAM,2DAA2D,CAAC;AAC9G,YAAY,EAAC,qCAAqC,EAAC,MAAM,mEAAmE,CAAC;AAC7H,YAAY,EAAC,mBAAmB,EAAC,MAAM,6CAA6C,CAAC;AACrF,YAAY,EAAC,qBAAqB,EAAC,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAC,mCAAmC,EAAC,MAAM,oCAAoC,CAAC;AAC5F,YAAY,EAAC,2BAA2B,EAAC,MAAM,6DAA6D,CAAC;AAC7G,YAAY,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AACjE,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC"}

package/build/ts/surfaces/checkout/api/address-autocomplete/standard.d.ts

@@ -78,7 +78,7 @@ export interface AddressAutocompleteStandardApi<Target extends 'purchase.address
      *
      * If the previous token expires, this value will reflect a new session token with a new signature and expiry.
      *
-     * Refer to [session token examples](https://shopify.dev/docs/api/checkout-ui-extensions/apis/session-token) for more information.
+     * Learn more about [session tokens](/docs/apps/build/authentication-authorization/session-tokens).
      */
     sessionToken: SessionToken;
     /**

package/build/ts/surfaces/checkout/api/standard/standard.d.ts

@@ -624,7 +624,7 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
      *
      * If the previous token expires, this value reflects a new session token with a new signature and expiry.
      *
-     * Refer to [session token examples](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/session-token) for more information.
+     * Learn more about [session tokens](/docs/apps/build/authentication-authorization/session-tokens).
      */
     sessionToken: SessionToken;
     /**
@@ -1238,7 +1238,7 @@ export type Interceptor = (interceptorProps: InterceptorProps) => InterceptorReq
  */
 export interface Customer {
     /**
-     * A globally-unique identifier for the customer in the format `gid://shopify/Customer/<id>`.
+     * An identifier for the customer in the format `gid://shopify/Customer/<id>`. This value is unique per shop.
      *
      * {% include /apps/checkout/privacy-icon.md %} Requires level 1 access to [protected customer data](https://shopify.dev/docs/apps/store/data-protection/protected-customer-data).
      *

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

@@ -26,10 +26,7 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends Base
 }
 
 declare const tagName = "s-abbreviation";
-/**
- * The element props interface for the Abbreviation component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface AbbreviationElementProps extends Pick<AbbreviationProps$1, 'title' | 'id'> {
 }
 export interface AbbreviationElement extends AbbreviationElementProps, Omit<HTMLElement, 'id' | 'title'> {

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

@@ -60,9 +60,7 @@ export interface ToggleArgumentsEvent {
 declare const tagName = "s-announcement";
 export interface AnnouncementEvents extends Pick<AnnouncementProps$1, 'onAfterToggle' | 'onDismiss' | 'onToggle'> {
 }
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface AnnouncementElementEvents {
     /**
      * A callback that fires when the element state changes, after any toggle animations have finished.
@@ -104,9 +102,7 @@ export interface AnnouncementMethods {
      */
     dismiss: () => void;
 }
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface AnnouncementElementMethods {
     /**
      * Programmatically dismisses the announcement. This triggers the `dismiss` event callback.

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

@@ -35,9 +35,7 @@ declare const CHECKOUT_AVAILABLE_ICONS: readonly ["alert-circle", "alert-triangl
 export type ReducedIconTypes = (typeof CHECKOUT_AVAILABLE_ICONS)[number];
 
 declare const tagName = "s-badge";
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface BadgeElementProps extends Pick<BadgeProps$1, 'color' | 'icon' | 'iconPosition' | 'id' | 'size' | 'tone'> {
     /**
      * The size of the badge.

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

@@ -38,9 +38,7 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-banner";
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface BannerElementProps extends Pick<BannerProps$1, 'collapsible' | 'dismissible' | 'heading' | 'hidden' | 'id' | 'tone'> {
     /**
      * Whether the banner content can be collapsed and expanded by the user. A collapsible banner conceals child elements initially, allowing the user to expand the banner to reveal them.
@@ -93,9 +91,7 @@ export interface BannerElementProps extends Pick<BannerProps$1, 'collapsible' |
 }
 export interface BannerEvents extends Pick<BannerProps$1, 'onAfterHide' | 'onDismiss'> {
 }
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface BannerElementEvents {
     /**
      * A callback that fires when the banner has fully hidden, including after any hide animations have completed.

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

@@ -46,9 +46,7 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends Base
 }
 
 declare const tagName = "s-box";
-/**
- * @publicDocs
- */
+/** @publicDocs */
 export interface BoxElementProps 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'> {
     /**
      * The background color of the box.

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

@@ -38,10 +38,7 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-button";
-/**
- * Configure the following properties on the button component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ButtonElementProps extends Pick<ButtonProps$1, 'accessibilityLabel' | 'command' | 'commandFor' | 'disabled' | 'href' | 'id' | 'inlineSize' | 'interestFor' | 'loading' | 'target' | 'tone' | 'type' | 'variant'> {
     target?: Extract<ButtonProps$1['target'], 'auto' | '_blank'>;
     tone?: Extract<ButtonProps$1['tone'], 'auto' | 'neutral' | 'critical'>;
@@ -50,10 +47,7 @@ export interface ButtonElementProps extends Pick<ButtonProps$1, 'accessibilityLa
 }
 export interface ButtonEvents extends Pick<ButtonProps$1, 'onClick'> {
 }
-/**
- * The button component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ButtonElementEvents {
     /**
      * A callback fired when the button is clicked. This will be called before the action indicated by `type`.

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

@@ -32,20 +32,13 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-checkbox";
-/**
- * Configure the following properties on the checkbox component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface CheckboxElementProps extends Pick<CheckboxProps$1, 'accessibilityLabel' | 'checked' | 'command' | 'commandFor' | 'defaultChecked' | 'disabled' | 'error' | 'id' | 'label' | 'name' | 'required' | 'value'> {
     command?: Extract<CheckboxProps$1['command'], '--auto' | '--show' | '--hide' | '--toggle'>;
 }
 export interface CheckboxEvents extends Pick<CheckboxProps$1, 'onChange'> {
 }
-/**
- * The checkbox component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface CheckboxElementEvents {
     /**
      * A callback fired when the checkbox value changes.

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

@@ -26,21 +26,13 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends Base
 }
 
 declare const tagName = "s-chip";
-/**
- * Configure the following properties on the chip component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChipElementProps extends Pick<ChipProps$1, 'accessibilityLabel' | 'id'> {
 }
-/**
- * The chip component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChipElementSlots {
     /**
-     * The graphic to display inside of the chip.
-     *
-     * Only `s-icon` element and its `type` attribute are supported.
+     * An optional graphic displayed at the start of the chip, such as an icon to visually reinforce the chip's label. Only the `s-icon` element and its `type` attribute are supported.
      */
     graphic?: HTMLElement;
 }

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

@@ -26,16 +26,10 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends Base
 }
 
 declare const tagName = "s-choice";
-/**
- * Configure the following properties on the choice component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChoiceElementProps extends Pick<ChoiceProps$1, 'accessibilityLabel' | 'defaultSelected' | 'disabled' | 'id' | 'selected' | 'error' | 'value'> {
 }
-/**
- * The choice component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChoiceElementSlots {
     /**
      * Additional text to provide context or guidance for the input.

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

@@ -38,19 +38,12 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-choice-list";
-/**
- * Configure the following properties on the choice list component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChoiceListElementProps extends Pick<ChoiceListProps$1, 'disabled' | 'error' | 'id' | 'label' | 'labelAccessibilityVisibility' | 'multiple' | 'name' | 'values' | 'variant'> {
 }
 export interface ChoiceListEvents extends Pick<ChoiceListProps$1, 'onChange'> {
 }
-/**
- * The choice list component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface ChoiceListElementEvents {
     /**
      * A callback fired when the choice list value changes.

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

@@ -58,10 +58,7 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-clickable";
-/**
- * Configure the following properties on the clickable component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClickableElementProps extends Pick<ClickableProps$1, 'accessibilityLabel' | 'accessibilityVisibility' | 'background' | 'blockSize' | 'border' | 'borderRadius' | 'borderStyle' | 'borderWidth' | 'command' | 'commandFor' | 'disabled' | 'display' | 'href' | 'id' | 'inlineSize' | 'interestFor' | 'lang' | 'loading' | 'maxBlockSize' | 'maxInlineSize' | 'minBlockSize' | 'minInlineSize' | 'overflow' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart' | 'target' | 'type'> {
     background?: Extract<ClickableProps$1['background'], 'transparent' | 'subdued' | 'base'>;
     border?: BorderShorthand;
@@ -72,10 +69,7 @@ export interface ClickableElementProps extends Pick<ClickableProps$1, 'accessibi
 }
 export interface ClickableEvents extends Pick<ClickableProps$1, 'onBlur' | 'onClick' | 'onFocus'> {
 }
-/**
- * The clickable component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClickableElementEvents {
     /**
      * A callback fired when the component loses focus.

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

@@ -38,18 +38,12 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-clickable-chip";
-/**
- * Configure the following properties on the clickable chip component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClickableChipElementProps extends Pick<ClickableChipProps$1, 'accessibilityLabel' | 'disabled' | 'hidden' | 'href' | 'id' | 'removable'> {
 }
 export interface ClickableChipEvents extends Pick<ClickableChipProps$1, 'onAfterHide' | 'onClick' | 'onRemove'> {
 }
-/**
- * The clickable chip component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClickableChipElementEvents {
     /**
      * A callback fired after the chip is hidden. The `hidden` property will be `true` when this event fires.
@@ -66,15 +60,10 @@ export interface ClickableChipElementEvents {
      */
     remove?: CallbackEventListener<typeof tagName>;
 }
-/**
- * The clickable chip component supports slots for additional content placement. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClickableChipElementSlots {
     /**
-     * The graphic to display inside of the chip.
-     *
-     * Only `s-icon` element and its `type` attribute are supported.
+     * An optional graphic displayed at the start of the chip, such as an icon to visually reinforce the chip's label. Only the `s-icon` element and its `type` attribute are supported.
      */
     graphic?: HTMLElement;
 }

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

@@ -32,18 +32,12 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-clipboard-item";
-/**
- * Configure the following properties on the clipboard item component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClipboardItemElementProps extends Pick<ClipboardItemProps$1, 'id' | 'text'> {
 }
 export interface ClipboardItemEvents extends Pick<ClipboardItemProps$1, 'onCopy' | 'onCopyError'> {
 }
-/**
- * The clipboard item component provides event callbacks for handling copy interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- * @publicDocs
- */
+/** @publicDocs */
 export interface ClipboardItemElementEvents {
     /**
      * A callback fired when the text is successfully copied to the clipboard. Use this to show a confirmation message or update the UI.

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

@@ -56,20 +56,19 @@ declare module 'preact' {
 }
 
 declare const tagName = "s-consent-checkbox";
-/**
- * Configure the following properties on the consent checkbox component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ConsentCheckboxElementProps extends Pick<ConsentCheckboxProps$1, 'accessibilityLabel' | 'checked' | 'command' | 'commandFor' | 'defaultChecked' | 'disabled' | 'error' | 'id' | 'label' | 'name' | 'policy' | 'value'> {
     command?: Extract<ConsentCheckboxProps$1['command'], '--auto' | '--show' | '--hide' | '--toggle'>;
+    /**
+     * The policy for which buyer consent is being collected. Used by the [consent checkbox](/docs/api/{API_NAME}/{API_VERSION}/web-components/forms/consent-checkbox) and [consent phone field](/docs/api/{API_NAME}/{API_VERSION}/web-components/forms/consent-phone-field) components to identify the type of marketing permission requested.
+     *
+     * - `sms-marketing`: Represents the policy for SMS marketing consent.
+     */
+    policy?: ConsentCheckboxProps$1['policy'];
 }
 export interface ConsentCheckboxEvents extends Pick<CheckboxEvents, 'onChange'> {
 }
-/**
- * The consent checkbox component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface ConsentCheckboxElementEvents {
     /**
      * A callback fired when the consent checkbox value changes.

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

@@ -69,24 +69,23 @@ declare module 'preact' {
 }
 
 declare const tagName = "s-consent-phone-field";
-/**
- * Configure the following properties on the consent phone field component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface ConsentPhoneFieldElementProps extends Pick<ConsentPhoneFieldProps$1, 'autocomplete' | 'defaultValue' | 'disabled' | 'error' | 'id' | 'label' | 'labelAccessibilityVisibility' | 'name' | 'policy' | 'readOnly' | 'required' | 'type' | 'value'> {
     /**
      * @deprecated Use `label` instead.
      * @private
      */
     placeholder?: string;
+    /**
+     * The policy for which buyer consent is being collected. Used by the [consent checkbox](/docs/api/{API_NAME}/{API_VERSION}/web-components/forms/consent-checkbox) and [consent phone field](/docs/api/{API_NAME}/{API_VERSION}/web-components/forms/consent-phone-field) components to identify the type of marketing permission requested.
+     *
+     * - `sms-marketing`: Represents the policy for SMS marketing consent.
+     */
+    policy?: ConsentPhoneFieldProps$1['policy'];
 }
 export interface ConsentPhoneFieldEvents extends Pick<PhoneFieldEvents, 'onBlur' | 'onChange' | 'onFocus' | 'onInput'> {
 }
-/**
- * The consent phone field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface ConsentPhoneFieldElementEvents {
     /**
      * A callback fired when the consent phone field loses focus.
@@ -119,11 +118,7 @@ export interface ConsentPhoneFieldElement extends ConsentPhoneFieldElementProps,
     onfocus: ConsentPhoneFieldEvents['onFocus'];
     oninput: ConsentPhoneFieldEvents['onInput'];
 }
-/**
- * The consent phone field component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface ConsentPhoneFieldElementSlots {
     /**
      * Additional interactive content displayed within the field. Accepts button and clickable components with text content only. Other component types or complex layouts are not supported.

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

@@ -32,10 +32,7 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-date-field";
-/**
- * Configure the following properties on the date field component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface DateFieldElementProps extends Pick<DateFieldProps$1, 'allow' | 'allowDays' | 'autocomplete' | 'defaultValue' | 'defaultView' | 'disabled' | 'disallow' | 'disallowDays' | 'error' | 'id' | 'label' | 'name' | 'readOnly' | 'required' | 'value' | 'view'> {
     /**
      * @deprecated Use `label` instead.
@@ -45,11 +42,7 @@ export interface DateFieldElementProps extends Pick<DateFieldProps$1, 'allow' |
 }
 export interface DateFieldEvents extends Pick<DateFieldProps$1, 'onBlur' | 'onChange' | 'onFocus' | 'onInput' | 'onInvalid' | 'onViewChange'> {
 }
-/**
- * The date field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface DateFieldElementEvents {
     /**
      * A callback fired when the date field loses focus.

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

@@ -32,19 +32,12 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-date-picker";
-/**
- * Configure the following properties on the date picker component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface DatePickerElementProps extends Pick<DatePickerProps$1, 'allow' | 'allowDays' | 'defaultValue' | 'defaultView' | 'disabled' | 'disallow' | 'disallowDays' | 'id' | 'name' | 'type' | 'value' | 'view'> {
 }
 export interface DatePickerEvents extends Pick<DatePickerProps$1, 'onBlur' | 'onChange' | 'onFocus' | 'onInput' | 'onViewChange'> {
 }
-/**
- * The date picker component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface DatePickerElementEvents {
     /**
      * A callback fired when the date picker loses focus.

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

@@ -43,42 +43,33 @@ export interface ToggleArgumentsEvent {
 }
 
 declare const tagName = "s-details";
-/**
- * The element props interface for the Details component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface DetailsElementProps extends Pick<DetailsProps$1, 'defaultOpen' | 'id' | 'open' | 'toggleTransition'> {
 }
 export interface DetailsEvents extends Pick<DetailsProps$1, 'onToggle' | 'onAfterToggle'> {
 }
-/**
- * The events interface for the Details component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface DetailsElementEvents {
     /**
-     * Callback straight after the element state changes.
+     * A callback fired immediately when the element state changes, before any animations.
      *
      * - If the element is transitioning from hidden to showing, the `oldState` property will be set to `closed` and the
      *   `newState` property will be set to `open`.
-     * - If the element is transitioning from showing to hidden, then `oldState` property will be set to `open` and the
+     * - If the element is transitioning from showing to hidden, then the `oldState` property will be set to `open` and the
      *   `newState` will be `closed`.
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+     * Learn more about the [`toggle` event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event), and the [`newState`](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState) and [`oldState`](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState) properties.
      */
     toggle?: CallbackEventListener<typeof tagName, ToggleArgumentsEvent>;
     /**
-     * Callback fired when the element state changes **after** any animations have finished.
+     * A callback fired when the element state changes, after any toggle animations have finished.
      *
      * - If the element transitioned from hidden to showing, the `oldState` property will be set to `closed` and the
      *   `newState` property will be set to `open`.
      * - If the element transitioned from showing to hidden, the `oldState` property will be set to `open` and the
      *   `newState` will be `closed`.
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+     * Learn more about the [`newState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState) and [`oldState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState).
      */
     aftertoggle?: CallbackEventListener<typeof tagName, ToggleArgumentsEvent>;
 }

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

@@ -32,19 +32,12 @@ export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap,
 }) | null;
 
 declare const tagName = "s-drop-zone";
-/**
- * Configure the following properties on the drop zone component.
- * @publicDocs
- */
+/** @publicDocs */
 export interface DropZoneElementProps extends Pick<DropZoneProps$1, 'accept' | 'accessibilityLabel' | 'disabled' | 'error' | 'id' | 'label' | 'multiple' | 'name' | 'required' | 'value'> {
 }
 export interface DropZoneEvents extends Pick<DropZoneProps$1, 'onDropRejected' | 'onInput' | 'onChange'> {
 }
-/**
- * The drop zone component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
- *
- * @publicDocs
- */
+/** @publicDocs */
 export interface DropZoneElementEvents {
     /**
      * A callback fired when files are rejected based on the `accept` prop.