@shopify/ui-extensions 2026.4.0-rc.3 → 2026.4.1

package/src/surfaces/admin/extension-targets.ts

@@ -13,6 +13,7 @@ import type {
   CustomerSegmentTemplateApi,
   CustomerSegmentTemplate,
   StandardApi,
+  IntentRenderApi,
 } from './api';
 import {
   ShouldRenderApi,
@@ -22,9 +23,12 @@ import type {BlockExtensionComponents} from './components/BlockExtensionComponen
 import type {ActionExtensionComponents} from './components/ActionExtensionComponents';
 import type {PrintActionExtensionComponents} from './components/PrintActionExtensionComponents';
 import type {FunctionSettingsComponents} from './components/FunctionSettingsComponents';
+import type {FormExtensionComponents} from './components/FormExtensionComponents';
 
 /**
  * Maps extension target identifiers to their corresponding extension types. Each target represents a specific location or context in the Shopify admin where extensions can render or execute. Use these targets to define where your extension appears and what capabilities it has access to.
+ *
+ * @publicDocs
  */
 export interface ExtensionTargets {
   /**
@@ -663,6 +667,14 @@ export interface ExtensionTargets {
     StandardApi<'admin.app.tools.data'>,
     undefined
   >;
+
+  /**
+   * Renders an admin extension for handling app intents.
+   */
+  'admin.app.intent.render': RenderExtension<
+    IntentRenderApi<'admin.app.intent.render'>,
+    FormExtensionComponents
+  >;
 }
 
 /**

package/src/surfaces/checkout/api/address-autocomplete/format-suggestion.ts

@@ -3,6 +3,7 @@ import type {
   AutocompleteAddress,
 } from './shared';
 
+/** @publicDocs */
 export interface AddressAutocompleteFormatSuggestionApi {
   /**
    * The autocomplete suggestion that the buyer selected during checkout.
@@ -16,6 +17,7 @@ interface Target {
   selectedSuggestion: AddressAutocompleteSuggestion;
 }
 
+/** @publicDocs */
 export interface AddressAutocompleteFormatSuggestionOutput {
   /**
    * The formatted address that will be used to populate the native address fields.

package/src/surfaces/checkout/api/address-autocomplete/shared.ts

@@ -4,6 +4,7 @@ import type {MailingAddress} from '../../../checkout';
  * An address object used to auto-populate the address form fields.
  *
  * All fields are optional
+ * @publicDocs
  */
 export interface AutocompleteAddress
   extends Pick<
@@ -35,6 +36,7 @@ export interface AutocompleteAddress
   longitude?: number;
 }
 
+/** @publicDocs */
 export interface AddressAutocompleteSuggestion {
   /**
    * The address suggestion text presented to the buyer in the list of autocomplete suggestions.
@@ -72,6 +74,7 @@ export interface AddressAutocompleteSuggestion {
   formattedAddress?: AutocompleteAddress;
 }
 
+/** @publicDocs */
 export interface MatchedSubstring {
   /**
    * The start location of the matched substring in the suggestion label text.

package/src/surfaces/checkout/api/address-autocomplete/standard.ts

@@ -23,6 +23,7 @@ import type {
   Timezone,
 } from '../../../../shared';
 
+/** @publicDocs */
 export interface AddressAutocompleteStandardApi<
   Target extends
     | 'purchase.address-autocomplete.suggest'
@@ -109,7 +110,7 @@ export interface AddressAutocompleteStandardApi<
    *
    * 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/src/surfaces/checkout/api/address-autocomplete/suggest.ts

@@ -2,6 +2,7 @@ import type {CountryCode} from '../../../checkout';
 
 import type {AddressAutocompleteSuggestion} from './shared';
 
+/** @publicDocs */
 export interface AddressAutocompleteSuggestApi {
   /**
    * The signal that the extension should listen to for cancellation requests.
@@ -51,6 +52,7 @@ interface Target {
   selectedCountryCode?: CountryCode;
 }
 
+/** @publicDocs */
 export interface AddressAutocompleteSuggestOutput {
   /**
    * An array of address autocomplete suggestions to show to the buyer.

package/src/surfaces/checkout/api/announcement/announcement.ts

@@ -1,3 +1,4 @@
+/** @publicDocs */
 export interface Announcement {
   announcement: {
     close(): void;

package/src/surfaces/checkout/api/cart-line/cart-line-item.ts

@@ -1,9 +1,13 @@
 import type {SubscribableSignalLike} from '../../shared';
 import type {CartLine} from '../standard/standard';
 
+/** @publicDocs */
 export interface CartLineItemApi {
   /**
-   * The cart line the extension is attached to. Until version `2023-04`, this property was a `ReadonlySignalLike<PresentmentCartLine>`.
+   * The cart line that this extension is attached to. Use this to read the
+   * line item's merchandise, quantity, cost, and attributes.
+   *
+   * > Note: Until version `2023-04`, this property was a `ReadonlySignalLike<PresentmentCartLine>`.
    */
   target: SubscribableSignalLike<CartLine>;
 }