@shopify/ui-extensions 2025.10.8 → 2025.10.9

package/build/ts/surfaces/point-of-sale/api/connectivity-api/connectivity-api.d.ts

@@ -1,20 +1,22 @@
 import type { ReadonlySignalLike } from '../../../../shared';
 export type ConnectivityStateSeverity = 'Connected' | 'Disconnected';
+/**
+ * Represents the current Internet connectivity status of the device. Indicates whether the device is connected or disconnected from the Internet.
+ */
 export interface ConnectivityState {
     /**
-     * Whether the device is connected to the internet
+     * The Internet connection status of the POS device.
      */
     internetConnected: ConnectivityStateSeverity;
 }
 export interface ConnectivityApiContent {
     /**
-     * Provides read-only access to the current connectivity state and allows subscribing to connectivity changes.
-     * The `value` property provides the current connectivity state, and `subscribe` allows listening to changes.
+     * Provides read-only access to the current connectivity state and allows subscribing to connectivity changes. Use for implementing connectivity-aware functionality and reactive connectivity handling.
      */
     current: ReadonlySignalLike<ConnectivityState>;
 }
 /**
- * Access information about the device connectivity
+ * The `ConnectivityApi` object provides access to current connectivity information and change notifications. Access these properties through `shopify.connectivity` to monitor network status.
  */
 export interface ConnectivityApi {
     connectivity: ConnectivityApiContent;

package/build/ts/surfaces/point-of-sale/api/connectivity-api/connectivity-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectivity-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/connectivity-api/connectivity-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,cAAc,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,yBAAyB,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,sBAAsB,CAAC;CACtC"}
+{"version":3,"file":"connectivity-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/connectivity-api/connectivity-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,cAAc,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,yBAAyB,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,sBAAsB,CAAC;CACtC"}

package/build/ts/surfaces/point-of-sale/api/customer-api/customer-api.d.ts

@@ -1,9 +1,12 @@
+/**
+ * The `CustomerApi` object provides access to customer data in customer-specific extension contexts. Access this property through `shopify.customer` to retrieve information about the customer currently being viewed or interacted with in the POS interface.
+ */
 export interface CustomerApi {
     customer: CustomerApiContent;
 }
 export interface CustomerApiContent {
     /**
-     * The unique identifier for the customer
+     * The unique identifier for the customer. Use for customer lookups, applying customer-specific pricing, enabling personalized features, and integrating with external systems.
      */
     id: number;
 }

package/build/ts/surfaces/point-of-sale/api/customer-api/customer-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customer-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/customer-api/customer-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ"}
+{"version":3,"file":"customer-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/customer-api/customer-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/build/ts/surfaces/point-of-sale/api/device-api/device-api.d.ts

@@ -1,19 +1,19 @@
 export interface DeviceApiContent {
     /**
-     * The name of the device
+     * The name of the device as configured by the merchant or system. Use for displaying device information in interfaces, logging, or support contexts where device identification is helpful.
      */
     name: string;
     /**
-     * The string ID of the device
+     * Retrieves the unique string identifier for the device. Returns a promise that resolves to the device ID. Use for device-specific data storage, analytics tracking, or implementing device-based permissions and configurations.
      */
     getDeviceId(): Promise<string>;
     /**
-     * Whether the device is a tablet
+     * Determines whether the device is a tablet form factor. Returns a promise that resolves to `true` for tablets, `false` for other device types. Use for implementing responsive design, optimizing touch targets, or providing device-appropriate user experiences.
      */
     isTablet(): Promise<boolean>;
 }
 /**
- * Access information about the device, like name and ID
+ * The `DeviceApi` object provides access to device information and capabilities. Access these properties and methods through `shopify.device` to retrieve device details and check device characteristics.
  */
 export interface DeviceApi {
     device: DeviceApiContent;

package/build/ts/surfaces/point-of-sale/api/draft-order-api/draft-order-api.d.ts

@@ -1,17 +1,20 @@
+/**
+ * The `DraftOrderApi` object provides access to draft order data in draft order-specific extension contexts. Access this property through `shopify.draftOrder` to retrieve information about the draft order currently being viewed or interacted with in the POS interface.
+ */
 export interface DraftOrderApi {
     draftOrder: DraftOrderApiContent;
 }
 export interface DraftOrderApiContent {
     /**
-     * The unique identifier for the draft order
+     * The unique identifier for the draft order. Use for draft order lookups, implementing order-specific functionality, and integrating with external systems.
      */
     id: number;
     /**
-     * The name of the draft order
+     * The name of the draft order as configured by the merchant. Use for draft order identification, displays, and customer-facing interfaces.
      */
     name: string;
     /**
-     * The unique identifier of the customer associated with the draft order
+     * The unique identifier of the customer associated with the draft order. Returns `undefined` if no customer is associated. Use for customer-specific functionality and personalized experiences.
      */
     customerId?: number;
 }

package/build/ts/surfaces/point-of-sale/api/draft-order-api/draft-order-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft-order-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/draft-order-api/draft-order-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"draft-order-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/draft-order-api/draft-order-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/build/ts/surfaces/point-of-sale/api/locale-api/locale-api.d.ts

@@ -1,13 +1,12 @@
 import type { ReadonlySignalLike } from '../../../../shared';
 export interface LocaleApiContent {
     /**
-     * Provides read-only access to the current IETF-formatted locale and allows subscribing to locale changes.
-     * The `value` property provides the current locale, and `subscribe` allows listening to changes.
+     * Provides read-only access to the current IETF-formatted locale and allows subscribing to locale changes. The `value` property provides the current locale, and `subscribe` allows listening to changes. Use for internationalization, locale-specific formatting, and reactive updates when merchants change language settings.
      */
     current: ReadonlySignalLike<string>;
 }
 /**
- * Access the merchant’s current locale (in [IETF format](https://en.wikipedia.org/wiki/IETF_language_tag)) to internationalize your extension content.
+ * The `LocaleApi` object provides access to current locale information and change notifications. Access these properties through `shopify.locale` to retrieve and monitor locale data.
  */
 export interface LocaleApi {
     locale: LocaleApiContent;

package/build/ts/surfaces/point-of-sale/api/locale-api/locale-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/locale-api/locale-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"locale-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/locale-api/locale-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/build/ts/surfaces/point-of-sale/api/navigation-api/navigation-api.d.ts

@@ -1,41 +1,49 @@
+/**
+ * Specifies configuration options for navigation operations. Allows passing state data that persists across navigation transitions.
+ */
 export interface NavigationNavigateOptions {
     /**
-     * Developer-defined information to be stored in the associated NavigationHistoryEntry once the navigation is complete, retrievable via getState().
+     * Developer-defined information to be stored in the associated `NavigationHistoryEntry` once the navigation is complete, retrievable using `getState()`. Use to pass data between navigation states or implement stateful navigation workflows.
      */
     state?: unknown;
 }
 /**
- * The NavigationHistoryEntry interface of the Navigation API represents a single navigation history entry.
+ * Represents a single entry in the navigation history stack. Contains the URL and unique identifier for tracking navigation state and implementing history-based navigation.
  */
 export interface NavigationHistoryEntry {
-    /** Returns the key of the history entry. This is a unique, UA-generated value that represents the history entry's slot in the entries list rather than the entry itself. */
+    /**
+     * A unique, UA-generated value that represents the history entry's slot in the entries list rather than the entry itself. Use for tracking navigation history or implementing navigation-based logic.
+     */
     key: string;
     /**
-     * Returns the URL of this history entry.
+     * The URL of this history entry. Returns `null` if no URL is associated with the entry. Use for URL-based navigation logic, deep-linking, or displaying current location information.
      */
     url: string | null;
     /**
-     * Returns a clone of the available state associated with this history entry.
+     * Returns a clone of the available state associated with this history entry. Use to retrieve navigation state data that was passed during navigation or to implement state-based navigation logic.
      */
     getState(): unknown;
 }
 export interface Navigation {
     /**
-     * The navigate() method navigates to a specific URL, updating any provided state in the history entries list.
+     * Navigates to a specific URL, updating any provided state in the history entries list. Returns a promise that resolves when navigation is complete. Use for programmatic navigation between screens, implementing custom navigation controls, or deep-linking to specific modal states.
      */
     navigate: (url: string, options?: NavigationNavigateOptions) => Promise<void>;
     /**
-     * The currentEntry read-only property of the Navigation interface returns a NavigationHistoryEntry object representing the location the user is currently navigated to right now.
+     * Returns a `NavigationHistoryEntry` object representing the location the user is currently navigated to. Use to access current URL, navigation state, or implement navigation-aware functionality based on the current location.
      */
     currentEntry: NavigationHistoryEntry;
     /**
-     * The back() method of the Navigation interface navigates to the previous entry in the history list.
+     * Navigates to the previous entry in the history list. Use for implementing back buttons, breadcrumb navigation, or allowing users to return to previous screens in multi-step workflows.
      */
     back(): void;
 }
+/**
+ * The global `window` object provides control over the extension modal lifecycle. Access these properties and methods directly through the global `window` object to manage the modal interface programmatically.
+ */
 export interface Window {
     /**
-     * The close() method of the window interface closes the extension screen.
+     * Closes the extension screen and dismisses the modal interface. Use to programmatically close the modal after completing a workflow, canceling an operation, or when user action is no longer required. This provides the same behavior as the user dismissing the modal through the UI.
      */
     close(): void;
 }

package/build/ts/surfaces/point-of-sale/api/navigation-api/navigation-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/navigation-api/navigation-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4KAA4K;IAC5K,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;OAEG;IACH,YAAY,EAAE,sBAAsB,CAAC;IACrC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"navigation-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/navigation-api/navigation-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;OAEG;IACH,YAAY,EAAE,sBAAsB,CAAC;IACrC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/build/ts/surfaces/point-of-sale/api/order-api/order-api.d.ts

@@ -1,23 +1,23 @@
 /**
- * Interface to access the order
+ * The `OrderApi` object provides access to order data in order-specific extension contexts. Access this property through `shopify.order` to retrieve information about the order currently being viewed or interacted with in the POS interface.
  */
 export interface OrderApi {
     order: OrderApiContent;
 }
 /**
- * Interface for Order details
+ * The `OrderApi` object provides access to order data. Access this property through `shopify.order` to interact with the current order context.
  */
 export interface OrderApiContent {
     /**
-     * The unique identifier for the order
+     * The unique identifier for the order. Use for order lookups, implementing order-specific functionality, and integrating with external systems.
      */
     id: number;
     /**
-     * The name of the order
+     * The name of the order as configured by the merchant. Use for order identification, displays, and customer-facing interfaces.
      */
     name: string;
     /**
-     * The unique identifier of the customer associated with the order
+     * The unique identifier of the customer associated with the order. Returns `undefined` if no customer is associated. Use for customer-specific functionality and personalized experiences.
      */
     customerId?: number;
 }

package/build/ts/surfaces/point-of-sale/api/pin-pad-api.d.ts

@@ -1,22 +1,18 @@
 import { PinPadOptions, PinValidationResult } from '../types/pin-pad';
 export interface PinPadApiContent {
-    /** Shows a PIN pad to the user in a modal dialog.
+    /**
+     * Shows a PIN pad to the user in a modal dialog. The `onSubmit` function is called when the PIN is submitted and should validate the PIN, returning `'accept'` or `'reject'`.
      *
-     * `onSubmit` is called when the PIN is submitted for validation by the user. The callback
-     * should validate the PIN and accept or reject it.
+     * • **When accepted**: Modal dismisses and triggers the `onDismissed` callback—perform any post-validation navigation in this callback rather than in `onSubmit`.
      *
-     * If the PIN is accepted, the modal will be dismissed and the `onDismissed` callback
-     * (provided via `options`) will be called. It is recommended that any post-validation
-     * navigation is performed in this callback rather than in `onSubmit`.
-     *
-     * If the PIN is rejected, the optional `errorMessage` will be displayed to the user and the modal
-     * will not be dismissed.
+     * • **When rejected**: Displays the optional `errorMessage` and keeps the modal open.
      *
+     * Use for implementing secure authentication workflows, access control, or PIN-based verification systems.
      */
     showPinPad(onSubmit: (pin: number[]) => Promise<PinValidationResult> | PinValidationResult, options?: PinPadOptions): void;
 }
 /**
- * Access the PIN Pad API for PIN pad functionality in a modal.
+ * The `PinPadApi` object provides methods for displaying secure PIN entry interfaces. Access these methods through `shopify.pinPad` to show PIN pad modals and handle PIN validation.
  */
 export interface PinPadApi {
     pinPad: PinPadApiContent;

package/build/ts/surfaces/point-of-sale/api/pin-pad-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pin-pad-api.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/point-of-sale/api/pin-pad-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,EAAE,KACV,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,EACvD,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"pin-pad-api.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/point-of-sale/api/pin-pad-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,EAAE,KACV,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,EACvD,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/build/ts/surfaces/point-of-sale/api/print-api/print-api.d.ts

@@ -1,19 +1,15 @@
 /**
- * Access the print API for printing functionality
+ * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
  */
 export interface PrintApiContent {
     /**
-     * Trigger a print dialog.
+     * Triggers a print dialog for the specified document source. The `print()` method accepts either:
      *
-     * The src must be either:
-     * - A relative path that will be appended to your app's [application_url](/docs/apps/build/cli-for-apps/app-configuration#application_url)
-     * - A full URL to your app's backend that will be used to return the document to print
+     * • A relative path that will be appended to your app's [`application_url`](/docs/apps/build/cli-for-apps/app-configuration)
      *
-     * Supported document types:
-     * - HTML documents (recommended for best printing experience)
-     * - Text files
-     * - Image files (PNG, JPEG, etc.)
-     * - PDF files (Note: On Android devices, PDFs will be downloaded and must be printed using an external application)
+     * • A full URL to your app's backend that will be used to return the document to print
+     *
+     * Returns a promise that resolves when content is ready and the native print dialog appears. Use for printing custom documents, receipts, labels, or reports.
      *
      * @param src the source URL of the content to print.
      * @returns Promise<void> that resolves when content is ready and native print dialog appears.
@@ -21,9 +17,12 @@ export interface PrintApiContent {
     print(src: string): Promise<void>;
 }
 /**
- * Interface for printing
+ * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
  */
 export interface PrintApi {
+    /**
+     * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
+     */
     print: PrintApiContent;
 }
 //# sourceMappingURL=print-api.d.ts.map

package/build/ts/surfaces/point-of-sale/api/print-api/print-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"print-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/print-api/print-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB"}
+{"version":3,"file":"print-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/print-api/print-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/build/ts/surfaces/point-of-sale/api/product-api/product-api.d.ts

@@ -1,13 +1,16 @@
+/**
+ * The `ProductApi` object provides access to product and variant data in product-specific extension contexts. Access this property through `shopify.product` to retrieve information about the product or variant currently being viewed or interacted with in the POS interface.
+ */
 export interface ProductApi {
     product: ProductApiContent;
 }
 export interface ProductApiContent {
     /**
-     * The unique identifier for the product.
+     * The unique identifier for the product. Use for product lookups, implementing product-specific functionality, and integrating with external systems.
      */
     id: number;
     /**
-     * The unique identifier for the product variant.
+     * The unique identifier for the product variant. Use for variant-specific operations, cart additions, and inventory management.
      */
     variantId: number;
 }

package/build/ts/surfaces/point-of-sale/api/product-api/product-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/product-api/product-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"product-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/product-api/product-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/build/ts/surfaces/point-of-sale/api/product-search-api/product-search-api.d.ts

@@ -3,7 +3,7 @@ import type { PaginatedResult } from '../../types/paginated-result';
 import type { Product, ProductVariant } from '../../types/product';
 export type ProductSortType = 'RECENTLY_ADDED' | 'RECENTLY_ADDED_ASCENDING' | 'ALPHABETICAL_A_TO_Z' | 'ALPHABETICAL_Z_TO_A';
 /**
- * Base interface for pagination.
+ * Specifies parameters for cursor-based pagination. Includes the cursor position and the number of results to retrieve per page.
  */
 export interface PaginationParams {
     /**
@@ -16,7 +16,7 @@ export interface PaginationParams {
     afterCursor?: string;
 }
 /**
- * Interface for product search
+ * Specifies the parameters for searching products. Includes query text, pagination options, and sorting preferences for product search operations.
  */
 export interface ProductSearchParams extends PaginationParams {
     /**
@@ -29,37 +29,51 @@ export interface ProductSearchParams extends PaginationParams {
     sortType?: ProductSortType;
 }
 export interface ProductSearchApiContent {
-    /** Search for products on the POS device.
+    /**
+     * Searches for products on the POS device using text queries and sorting options. Returns paginated results with up to 50 products per page. When a query string is provided, results are sorted by relevance. Use for implementing custom search interfaces, product discovery features, or filtered product listings.
+     *
      * @param searchParams The parameters for the product search.
      */
     searchProducts(searchParams: ProductSearchParams): Promise<PaginatedResult<Product>>;
-    /** Fetches a single product's details.
+    /**
+     * Retrieves detailed information for a single product by its ID. Returns `undefined` if the product doesn't exist or isn't available on the POS device. Use for displaying product details, validating product availability, or building product-specific workflows.
+     *
      * @param productId The ID of the product to lookup.
      */
     fetchProductWithId(productId: number): Promise<Product | undefined>;
-    /** Fetches multiple products' details.
+    /**
+     * Retrieves detailed information for multiple products by their IDs. Limited to 50 products maximum—additional IDs are automatically removed. Returns results with both found and not found products clearly identified. Use for bulk product lookups, building product collections, or validating product lists.
+     *
      * @param productIds Specifies the array of product IDs to lookup. This is limited to 50 products. All excess requested IDs will be removed from the array.
      */
     fetchProductsWithIds(productIds: number[]): Promise<MultipleResourceResult<Product>>;
-    /** Fetches a single product variant's details.
+    /**
+     * Retrieves detailed information for a single product variant by its ID. Returns `undefined` if the variant doesn't exist or isn't available. Use for displaying variant-specific details like pricing, inventory, or options when working with specific product configurations.
+     *
      * @param productVariantId The ID of the product variant to lookup.
      */
     fetchProductVariantWithId(productVariantId: number): Promise<ProductVariant | undefined>;
-    /** Fetches multiple product variants' details.
+    /**
+     * Retrieves detailed information for multiple product variants by their IDs. Limited to 50 variants maximum—additional IDs are automatically removed. Returns results with both found and not found variants clearly identified. Use for bulk variant lookups or building variant-specific collections.
+     *
      * @param productVariantIds Specifies the array of product variant IDs to lookup. This is limited to 50 product variants. All excess requested IDs will be removed from the array.
      */
     fetchProductVariantsWithIds(productVariantIds: number[]): Promise<MultipleResourceResult<ProductVariant>>;
-    /** Fetches all product variants associated with a product.
+    /**
+     * Retrieves all product variants associated with a specific product ID. Returns all variants at once without pagination. Use for displaying complete variant options, building variant selectors, or analyzing all available configurations for a product.
+     *
      * @param productId The product ID. All variants' details associated with this product ID are returned.
      */
     fetchProductVariantsWithProductId(productId: number): Promise<ProductVariant[]>;
-    /** Fetches a page of product variants associated with a product.
+    /**
+     * Retrieves product variants for a specific product with pagination support. Use when a product has many variants and you need to load them incrementally for better performance. Ideal for products with extensive variant collections that would be too large to load at once.
+     *
      * @param paginationParams The parameters for pagination.
      */
     fetchPaginatedProductVariantsWithProductId(productId: number, paginationParams: PaginationParams): Promise<PaginatedResult<ProductVariant>>;
 }
 /**
- * Access Point of Sale's native product search functionality.
+ * The `ProductSearchApi` object provides methods for searching and retrieving product information. Access these methods through `shopify.productSearch` to search products and fetch detailed product data.
  */
 export interface ProductSearchApi {
     productSearch: ProductSearchApiContent;

package/build/ts/surfaces/point-of-sale/api/product-search-api/product-search-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-search-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/product-search-api/product-search-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAC,OAAO,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,cAAc,CACZ,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAErC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAEpE;;OAEG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,yBAAyB,CACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAEvC;;OAEG;IACH,2BAA2B,CACzB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,iCAAiC,CAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;OAEG;IACH,0CAA0C,CACxC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,uBAAuB,CAAC;CACxC"}
+{"version":3,"file":"product-search-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/product-search-api/product-search-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAC,OAAO,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,cAAc,CACZ,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAErC;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAEpE;;;;OAIG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5C;;;;OAIG;IACH,yBAAyB,CACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAEvC;;;;OAIG;IACH,2BAA2B,CACzB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;IAEnD;;;;OAIG;IACH,iCAAiC,CAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;;OAIG;IACH,0CAA0C,CACxC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,uBAAuB,CAAC;CACxC"}

package/build/ts/surfaces/point-of-sale/api/scanner-api/scanner-api.d.ts

@@ -1,36 +1,54 @@
 import type { ReadonlySignalLike } from '../../../../shared';
 /** The scanner source the POS device supports. */
 export type ScannerSource = 'camera' | 'external' | 'embedded';
+/**
+ * Represents the data from a scanner event. Contains the scanned string data and the hardware source that captured the scan.
+ */
 export interface ScannerSubscriptionResult {
-    /** The string data from the last scanner event received. */
+    /**
+     * The string data from the last scanner event received. Contains the scanned barcode, QR code, or other scannable data. Returns `undefined` when no scan data is available. Use to process scanned content and implement scan-based business logic.
+     */
     data?: string;
-    /** The scanning source from which the scan event came. */
+    /**
+     * The scanning source from which the scan event came. Returns one of the following scanner types:
+     *
+     * • `'camera'` - Built-in device camera used for scanning
+     * • `'external'` - External scanner hardware connected to the device
+     * • `'embedded'` - Embedded scanner hardware built into the device
+     */
     source?: ScannerSource;
 }
+/**
+ * Represents the available scanner hardware sources on the device. Provides reactive access to the list of scanners that can be used for scanning operations.
+ */
 export interface ScannerSources {
     /**
-     * The current available scanner sources.
-     * The `value` property provides the current sources, and `subscribe` allows listening to changes.
+     * Current available scanner sources with subscription support. The `value` property provides current sources, and `subscribe` listens for changes. Use to monitor which scanners are available.
      */
     current: ReadonlySignalLike<ScannerSource[]>;
 }
+/**
+ * Represents the scanner interface for accessing scan events and subscription management. Provides real-time access to scanned data through a reactive signal pattern.
+ */
 export interface ScannerData {
     /**
-     * The current scan data.
-     * The `value` property provides the current scan result, and `subscribe` allows listening to new scans.
+     * Current available scanner sources with subscription support. The `value` property provides current sources, and `subscribe` listens for changes. Use to monitor which scanners are available.
      */
     current: ReadonlySignalLike<ScannerSubscriptionResult>;
 }
 export interface ScannerApiContent {
     /**
-     * Provides read-only access to scanner data and allows subscribing to new scan events.
+     * Access current scan data and subscribe to new scan events. Use to receive real-time scan results.
      */
     scannerData: ScannerData;
     /**
-     * Provides read-only access to the available scanner sources on the POS device.
+     * Access available scanner sources on the device. Use to check which scanners are available (camera, external, or embedded).
      */
     sources: ScannerSources;
 }
+/**
+ * The `ScannerApi` object provides access to scanning functionality and scanner source information. Access these properties through `shopify.scanner` to monitor scan events and available scanner sources.
+ */
 export interface ScannerApi {
     scanner: ScannerApiContent;
 }

package/build/ts/surfaces/point-of-sale/api/scanner-api/scanner-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/scanner-api/scanner-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}
+{"version":3,"file":"scanner-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/scanner-api/scanner-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}

package/build/ts/surfaces/point-of-sale/api/session-api/session-api.d.ts

@@ -1,19 +1,16 @@
 import type { Session } from '../../types/session';
 export interface SessionApiContent {
     /**
-     * Access information on the current POS session.
+     * Provides comprehensive information about the current POS session including shop details, user authentication, location data, staff member information, currency settings, and POS version. This data is static for the duration of the session and updates when users switch locations or staff members change.
      */
     currentSession: Session;
     /**
-     * Get a fresh session token for communication with your app's backend service.
-     * When the authenticated user (the user that logged into Shopify POS with their email address) doesn't have the correct app permissions enabled for your app, null will be returned. This is irrelevant of which POS Staff member is pinned in, as those are not authenticated users.
-     * For more information, see our [app permissions documentation](https://help.shopify.com/en/manual/your-account/users/roles/permissions/store-permissions#apps-and-channels-permissions).
-     * Calls to Shopify APIs must be made by your app’s backend service.
+     * Generates a fresh session token for secure communication with your app's backend service. Returns `undefined` when the authenticated user lacks proper app permissions. The token is a Shopify OpenID Connect ID Token that should be used in `Authorization` headers for backend API calls. This is based on the authenticated user, not the pinned staff member.
      */
     getSessionToken: () => Promise<string | undefined>;
 }
 /**
- * Access information on the current Session, including data on the current shop, user, staff and location.
+ * The `SessionApi` object provides access to current session information and authentication methods. Access these properties and methods through `shopify.session` to retrieve shop data and generate secure tokens. These methods enable secure API calls while maintaining user privacy and [app permissions](https://help.shopify.com/manual/your-account/users/roles/permissions/store-permissions#apps-and-channels-permissions).
  */
 export interface SessionApi {
     session: SessionApiContent;

package/build/ts/surfaces/point-of-sale/api/session-api/session-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/session-api/session-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}
+{"version":3,"file":"session-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/session-api/session-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}

package/build/ts/surfaces/point-of-sale/api/storage-api/storage-api.d.ts

@@ -1,4 +1,7 @@
 import { Storage } from '../../types/storage';
+/**
+ * The `StorageApi` object provides access to persistent local storage methods for your POS UI extension. Access these methods through `shopify.storage` to store, retrieve, and manage data that persists across sessions.
+ */
 export interface StorageApi {
     storage: Storage;
 }

package/build/ts/surfaces/point-of-sale/api/storage-api/storage-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/storage-api/storage-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"storage-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/storage-api/storage-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/build/ts/surfaces/point-of-sale/api/toast-api/toast-api.d.ts

@@ -1,14 +1,24 @@
+/**
+ * Specifies configuration options for displaying toast notifications. Controls the duration and display behavior of temporary notification messages.
+ */
 export interface ShowToastOptions {
+    /**
+     * The duration in milliseconds that the toast message should remain visible before automatically dismissing. If not specified, the toast will use the default system duration. Use shorter durations for simple confirmations and longer durations for important messages that users need time to read.
+     */
     duration?: number;
 }
 export interface ToastApiContent {
     /**
-     * Show a toast.
+     * Displays a toast notification with the specified text content. The message appears as a temporary overlay that automatically dismisses after the specified duration. Use for providing immediate user feedback, confirming actions, or communicating status updates without interrupting the user's workflow.
+     *
      * @param content The text content to display.
      * @param options An object containing ShowToastOptions.
      */
     show: (content: string, options?: ShowToastOptions) => void;
 }
+/**
+ * The `ToastApi` object provides methods for displaying temporary notification messages. Access these methods through `shopify.toast` to show user feedback and status updates.
+ */
 export interface ToastApi {
     toast: ToastApiContent;
 }

package/build/ts/surfaces/point-of-sale/api/toast-api/toast-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/toast-api/toast-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB"}
+{"version":3,"file":"toast-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/toast-api/toast-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/build/ts/surfaces/point-of-sale/components/Badge/Badge.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Badge.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/components/Badge/Badge.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAwDX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Badge.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/components/Badge/Badge.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAqDX,CAAC;AAEF,eAAe,IAAI,CAAC"}