@shopify/ui-extensions 2026.4.1 → 2026.4.3

package/build/cjs/surfaces/checkout/preact/localized-fields.js

@@ -33,6 +33,8 @@ function useLocalizedFields(keys) {
 /**
  * Returns the current localized field or undefined for the specified
  * localized field key and re-renders your component if the value changes.
+ *
+ * Returns `undefined` when no field is configured for the buyer's country.
  * @publicDocs
  */
 function useLocalizedField(key) {

package/build/esm/surfaces/checkout/preact/localized-fields.mjs

@@ -29,6 +29,8 @@ function useLocalizedFields(keys) {
 /**
  * Returns the current localized field or undefined for the specified
  * localized field key and re-renders your component if the value changes.
+ *
+ * Returns `undefined` when no field is configured for the buyer's country.
  * @publicDocs
  */
 function useLocalizedField(key) {

package/build/esnext/surfaces/checkout/preact/localized-fields.esnext

@@ -29,6 +29,8 @@ function useLocalizedFields(keys) {
 /**
  * Returns the current localized field or undefined for the specified
  * localized field key and re-renders your component if the value changes.
+ *
+ * Returns `undefined` when no field is configured for the buyer's country.
  * @publicDocs
  */
 function useLocalizedField(key) {

package/build/ts/surfaces/admin/api/discount-function-settings/launch-options.d.ts

@@ -27,6 +27,10 @@ export type DiscountClass = 'product' | 'order' | 'shipping';
  * @publicDocs
  */
 export type DiscountMethod = 'automatic' | 'code';
+/**
+ * The purchase type that determines which purchases the discount applies to. Use `'one_time_purchase'` for one-time purchases only, `'subscription'` for subscription purchases only, or `'both'` for both.
+ */
+export type PurchaseType = 'one_time_purchase' | 'subscription' | 'both';
 /**
  * The `data` object exposed to discount function settings extensions in the `admin.discount-details.function-settings.render` target. Use this to access the current discount configuration and populate your settings interface with existing values.
  * @publicDocs
@@ -54,5 +58,21 @@ export interface DiscountsApi {
      * A signal that contains the discount method (`'automatic'` or `'code'`). Read this to determine whether the discount applies automatically at checkout or requires a customer-entered code.
      */
     discountMethod: ReadonlySignalLike<DiscountMethod>;
+    /**
+     * A signal that contains the purchase type. Read this to determine whether the discount applies to one-time purchases, subscriptions, or both.
+     */
+    purchaseType: ReadonlySignalLike<PurchaseType>;
+    /**
+     * A function that updates the purchase type to change which types of purchases the discount applies to. Call this with a `PurchaseType` value (`'one_time_purchase'`, `'subscription'`, or `'both'`).
+     */
+    updatePurchaseType: UpdateSignalFunction<PurchaseType>;
+    /**
+     * A signal that contains the recurring cycle limit for subscription purchases. A positive integer limits how many billing cycles the discount applies for. Both `0` and `null` mean unlimited (no limit). `null` is the default when no value has been explicitly set.
+     */
+    recurringCycleLimit: ReadonlySignalLike<number | null>;
+    /**
+     * A function that updates the recurring cycle limit for subscription purchases. Pass a positive integer to limit the number of billing cycles, `0` or `null` to remove the limit.
+     */
+    updateRecurringCycleLimit: UpdateSignalFunction<number | null>;
 }
 //# sourceMappingURL=launch-options.d.ts.map

package/build/ts/surfaces/admin/api/discount-function-settings/launch-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-options.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/launch-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,qKAAqK;IACrK,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mIAAmI;IACnI,EAAE,EAAE,MAAM,CAAC;IACX,2JAA2J;IAC3J,SAAS,EAAE,MAAM,CAAC;IAClB,mMAAmM;IACnM,GAAG,EAAE,MAAM,CAAC;IACZ,8HAA8H;IAC9H,KAAK,EAAE,MAAM,CAAC;IACd,sMAAsM;IACtM,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4PAA4P;IAC5P,EAAE,EAAE,MAAM,CAAC;IACX,2PAA2P;IAC3P,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,eAAe,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;IACrD;;OAEG;IACH,qBAAqB,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CACpD"}
+{"version":3,"file":"launch-options.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/launch-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,qKAAqK;IACrK,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mIAAmI;IACnI,EAAE,EAAE,MAAM,CAAC;IACX,2JAA2J;IAC3J,SAAS,EAAE,MAAM,CAAC;IAClB,mMAAmM;IACnM,GAAG,EAAE,MAAM,CAAC;IACZ,8HAA8H;IAC9H,KAAK,EAAE,MAAM,CAAC;IACd,sMAAsM;IACtM,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4PAA4P;IAC5P,EAAE,EAAE,MAAM,CAAC;IACX,2PAA2P;IAC3P,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,eAAe,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;IACrD;;OAEG;IACH,qBAAqB,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACnD;;OAEG;IACH,YAAY,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC/C;;OAEG;IACH,kBAAkB,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACvD;;OAEG;IACH,mBAAmB,EAAE,kBAAkB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD;;OAEG;IACH,yBAAyB,EAAE,oBAAoB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE"}

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

@@ -26,7 +26,7 @@ type MergeGeneratedIntentResponse<BaseIntents, Variants> = Variants extends infe
         subscribe: (callback: (value: GeneratedRequest | null) => void) => () => void;
     };
 } & (Variant extends {
-    response: infer GeneratedResponse;
+    response?: infer GeneratedResponse;
 } ? BaseIntents extends {
     response: infer BaseResponse;
 } ? {

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

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

@@ -55,7 +55,7 @@ export interface AddressAutocompleteStandardApi<Target extends 'purchase.address
     /**
      * The details about the location, language, and currency of the customer. For utilities to easily
      * format and translate content based on these details, you can use the
-     * [`i18n`](https://shopify.dev/docs/api/checkout-ui-extensions/apis/localization#standardapi-propertydetail-i18n)
+     * [`i18n`](https://shopify.dev/docs/api/checkout-ui-extensions/apis/localization#properties-propertydetail-i18n)
      * object instead.
      */
     localization: Localization;

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

@@ -49,8 +49,8 @@ interface Target {
 export interface AddressAutocompleteSuggestOutput {
     /**
      * An array of address autocomplete suggestions to show to the buyer.
-     *
-     * > Note: Only the first five suggestions will be displayed to the buyer.
+     * Checkout displays up to five address suggestions. Return no more
+     * than five. Additional suggestions are ignored.
      */
     suggestions: AddressAutocompleteSuggestion[];
 }

package/build/ts/surfaces/checkout/api/cart-line/cart-line-item.d.ts

@@ -6,6 +6,10 @@ export interface CartLineItemApi {
      * The cart line that this extension is attached to. Use this to read the
      * line item's merchandise, quantity, cost, and attributes.
      *
+     * Available only on the corresponding item target. Shipping option item
+     * targets expose shipping option properties; pickup location item targets
+     * expose pickup location properties.
+     *
      * > Note: Until version `2023-04`, this property was a `ReadonlySignalLike<PresentmentCartLine>`.
      */
     target: SubscribableSignalLike<CartLine>;

package/build/ts/surfaces/checkout/api/cart-line/cart-line-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart-line-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/cart-line/cart-line-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAEnD,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"cart-line-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/cart-line/cart-line-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAEnD,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC1C"}

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

@@ -50,6 +50,9 @@ export interface NoteChangeResultError {
     /**
      * A message that explains the error. This message is useful for debugging.
      * It isn't localized and shouldn't be displayed to the buyer.
+     *
+     * Render your own localized error text rather than displaying this message
+     * to the buyer.
      */
     message: string;
 }
@@ -149,6 +152,9 @@ export interface CartLineChangeResultError {
     /**
      * A message that explains the error. This message is useful for debugging.
      * It isn't localized and shouldn't be displayed to the buyer.
+     *
+     * Render your own localized error text rather than displaying this message
+     * to the buyer.
      */
     message: string;
 }
@@ -384,6 +390,9 @@ export interface GiftCardChangeResultError {
     /**
      * A message that explains the error. This message is useful for debugging.
      * It isn't localized and shouldn't be displayed to the buyer.
+     *
+     * Render your own localized error text rather than displaying this message
+     * to the buyer.
      */
     message: string;
 }
@@ -461,6 +470,9 @@ export interface MetafieldChangeResultError {
     /**
      * A message that explains the error. This message is useful for debugging.
      * It isn't localized and shouldn't be displayed to the buyer.
+     *
+     * Render your own localized error text rather than displaying this message
+     * to the buyer.
      */
     message: string;
 }
@@ -546,30 +558,36 @@ export type ShippingAddressChangeResult = ShippingAddressChangeResultSuccess | S
 export interface CheckoutApi {
     /**
      * Updates or removes an attribute on the cart and checkout. On success, the
-     * [`attributes`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/attributes#standardapi-propertydetail-attributes) property updates to reflect the change.
+     * [`attributes`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/attributes#properties-propertydetail-attributes) property updates to reflect the change.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `attributes.canUpdateAttributes` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `attributes.canUpdateAttributes` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      *
      * @deprecated Use cart metafields instead.
      */
     applyAttributeChange(change: AttributeChange): Promise<AttributeChangeResult>;
     /**
-     * Adds, removes, or updates line items in the cart. The returned promise resolves when the change has been applied by the server, and the [`lines`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-lines#standardapi-propertydetail-lines) property updates with the new state.
+     * Adds, removes, or updates line items in the cart. The returned promise resolves when the change has been applied by the server, and the [`lines`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-lines#properties-propertydetail-lines) property updates with the new state.
+     *
+     * Accepts a single change per call. To make multiple changes, call this
+     * method separately for each one.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `lines.canAddCartLine` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `lines.canAddCartLine` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      */
     applyCartLinesChange(change: CartLineChange): Promise<CartLineChangeResult>;
     /**
-     * Adds or removes a discount code on the checkout. The returned promise resolves when the change has been applied by the server, and the [`discountCodes`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/discounts#standardapi-propertydetail-discountcodes) property updates with the new state.
+     * Adds or removes a discount code on the checkout. The returned promise resolves when the change has been applied by the server, and the [`discountCodes`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/discounts#properties-propertydetail-discountcodes) property updates with the new state.
      *
      * > Caution:
      * > See [security considerations](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/configuration#network-access) if your extension retrieves discount codes through a network call.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `discounts.canUpdateDiscountCodes` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `discounts.canUpdateDiscountCodes` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      */
     applyDiscountCodeChange(change: DiscountCodeChange): Promise<DiscountCodeChangeResult>;
     /**
-     * Adds or removes a gift card from the checkout. The returned promise resolves when the change has been applied by the server, and the [`appliedGiftCards`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/gift-cards#standardapi-propertydetail-appliedgiftcards) property updates with the new state.
+     * Adds or removes a gift card from the checkout. The returned promise resolves when the change has been applied by the server, and the [`appliedGiftCards`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/gift-cards#properties-propertydetail-appliedgiftcards) property updates with the new state.
+     *
+     * Unlike other write operations, gift card changes aren't gated by a cart
+     * instruction flag.
      *
      * > Caution:
      * > See [security considerations](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/configuration#network-access) if your extension retrieves gift card codes through a network call.
@@ -579,19 +597,19 @@ export interface CheckoutApi {
     applyGiftCardChange(change: GiftCardChange): Promise<GiftCardChangeResult>;
     /**
      * Creates, updates, or removes a cart metafield on the checkout. On success, the
-     * [`metafields`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/metafields#standardapi-propertydetail-metafields) property updates to reflect the change.
+     * [`metafields`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/metafields#properties-propertydetail-metafields) property updates to reflect the change.
      *
      * Cart metafields are copied to order metafields at order creation time if there's a matching order metafield definition with the [`cart to order copyable`](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities#cart-to-order-copyable) capability enabled.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `metafields.canSetCartMetafields` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `metafields.canSetCartMetafields` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      */
     applyMetafieldChange(change: MetafieldChange): Promise<MetafieldChangeResult>;
     /**
      * Sets or removes the buyer's note on the checkout. On success, the
-     * [`note`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/note#standardapi-propertydetail-note)
+     * [`note`](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/note#properties-propertydetail-note)
      * property updates to reflect the change.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `notes.canUpdateNote` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `notes.canUpdateNote` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      */
     applyNoteChange(change: NoteChange): Promise<NoteChangeResult>;
     /**
@@ -603,7 +621,7 @@ export interface CheckoutApi {
      * are merged into the existing address without prompting the buyer. On success,
      * the `shippingAddress` property updates to reflect the change.
      *
-     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#standardapi-propertydetail-instructions) `delivery.canSelectCustomAddress` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
+     * > Note: This method returns an error if the [cart instruction](https://shopify.dev/docs/api/checkout-ui-extensions/{API_VERSION}/apis/cart-instructions#properties-propertydetail-instructions) `delivery.canSelectCustomAddress` is false, or the buyer is using an accelerated checkout method, such as Apple Pay or Google Pay.
      *
      * {% include /apps/checkout/privacy-icon.md %} Requires access to [protected customer data](https://shopify.dev/docs/apps/store/data-protection/protected-customer-data).
      */

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

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

package/build/ts/surfaces/checkout/api/order-confirmation/order-confirmation.d.ts

@@ -15,6 +15,8 @@ export interface OrderConfirmation {
      * A randomly generated alpha-numeric identifier for the order, distinct
      * from `order.id`. The value is `undefined` for orders that were created
      * before this field was introduced. All recent orders have a number.
+     *
+     * Optional. Might not be present for orders created before 2024.
      */
     number?: string;
     /**

package/build/ts/surfaces/checkout/api/order-confirmation/order-confirmation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order-confirmation.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/order-confirmation/order-confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAEzD,kBAAkB;AAClB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE;QACL;;;;;;WAMG;QACH,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,kBAAkB;AAClB,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,iBAAiB,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;CAC9D"}
+{"version":3,"file":"order-confirmation.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/order-confirmation/order-confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAEzD,kBAAkB;AAClB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE;QACL;;;;;;WAMG;QACH,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,kBAAkB;AAClB,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,iBAAiB,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;CAC9D"}

package/build/ts/surfaces/checkout/api/pickup/pickup-location-item.d.ts

@@ -4,10 +4,18 @@ import type { PickupLocationOption } from '../standard/standard';
 export interface PickupLocationItemApi {
     /**
      * The pickup location that this extension is attached to. Use this to read the location's name, address, and other details.
+     *
+     * Available only on the corresponding item target. Shipping option item
+     * targets expose shipping option properties; pickup location item targets
+     * expose pickup location properties.
      */
     target: SubscribableSignalLike<PickupLocationOption>;
     /**
      * Whether the buyer has selected the target pickup location. When `true`, the target location is the buyer's active choice. When `false`, the buyer has chosen a different pickup location.
+     *
+     * Available only on the corresponding item target. Shipping option item
+     * targets expose shipping option properties; pickup location item targets
+     * expose pickup location properties.
      */
     isTargetSelected: SubscribableSignalLike<boolean>;
 }

package/build/ts/surfaces/checkout/api/pickup/pickup-location-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pickup-location-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/pickup/pickup-location-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE/D,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAErD;;OAEG;IACH,gBAAgB,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;CACnD"}
+{"version":3,"file":"pickup-location-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/pickup/pickup-location-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE/D,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,gBAAgB,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;CACnD"}

package/build/ts/surfaces/checkout/api/pickup/pickup-point-list.d.ts

@@ -2,9 +2,9 @@ import type { SubscribableSignalLike } from '../../shared';
 /** @publicDocs */
 export interface PickupPointListApi {
     /**
-     * Whether the location search form is currently visible to the buyer.
-     * Use this to conditionally render UI that depends on the buyer actively
-     * searching for pickup points.
+     * Reflects which view was active when the extension loaded. When the
+     * buyer moves to the next view, the extension restarts with the
+     * current value rather than updating in place.
      */
     isLocationFormVisible: SubscribableSignalLike<boolean>;
 }

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

@@ -54,6 +54,9 @@ export interface Attribute {
      * The value associated with the attribute key. This is a freeform string
      * that can store any information the buyer or app provides.
      *
+     * Attribute values are always strings. To store structured data, serialize
+     * it to JSON and parse it when reading.
+     *
      * @example 'Please use red wrapping paper'
      */
     value: string;

package/build/ts/surfaces/checkout/api/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/checkout/api/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAEjD,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/checkout/api/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAEjD,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/build/ts/surfaces/checkout/api/shipping/shipping-option-item.d.ts

@@ -4,10 +4,18 @@ import type { ShippingOption } from '../standard/standard';
 export interface ShippingOptionItemApi {
     /**
      * The shipping option that this extension is attached to. Use this to read the option's cost, carrier, delivery estimate, and other details.
+     *
+     * Available only on the corresponding item target. Shipping option item
+     * targets expose shipping option properties; pickup location item targets
+     * expose pickup location properties.
      */
     target: SubscribableSignalLike<ShippingOption>;
     /**
      * Whether the buyer has selected the target shipping option. When `true`, the target option is the buyer's active choice. When `false`, the buyer has chosen a different shipping option.
+     *
+     * Available only on the corresponding item target. Shipping option item
+     * targets expose shipping option properties; pickup location item targets
+     * expose pickup location properties.
      */
     isTargetSelected: SubscribableSignalLike<boolean>;
     /**

package/build/ts/surfaces/checkout/api/shipping/shipping-option-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shipping-option-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/shipping/shipping-option-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAE/C;;OAEG;IACH,gBAAgB,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAElD;;OAEG;IACH,UAAU,EAAE,4BAA4B,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"shipping-option-item.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/checkout/api/shipping/shipping-option-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAE/C;;;;;;OAMG;IACH,gBAAgB,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAElD;;OAEG;IACH,UAAU,EAAE,4BAA4B,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB"}