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

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

@@ -1,9 +1,14 @@
 /**
  * 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.
+ * @publicDocs
  */
 export interface CustomerApi {
     customer: CustomerApiContent;
 }
+/**
+ * The `CustomerApi` object provides customer information for the active context.
+ * @publicDocs
+ */
 export interface CustomerApiContent {
     /**
      * The unique identifier for the customer. Use for customer lookups, applying customer-specific pricing, enabling personalized features, and integrating with external systems.

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;;GAEG;AACH,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;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;GAGG;AACH,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,3 +1,7 @@
+/**
+ * The `DeviceApi` object provides device details and capabilities.
+ * @publicDocs
+ */
 export interface DeviceApiContent {
     /**
      * 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.
@@ -19,6 +23,7 @@ export interface DeviceApiContent {
 }
 /**
  * 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.
+ * @publicDocs
  */
 export interface DeviceApi {
     device: DeviceApiContent;

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

@@ -1 +1 @@
-{"version":3,"file":"device-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/device-api/device-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"device-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/device-api/device-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

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

@@ -1,9 +1,14 @@
 /**
  * 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.
+ * @publicDocs
  */
 export interface DraftOrderApi {
     draftOrder: DraftOrderApiContent;
 }
+/**
+ * The `DraftOrderApi` object provides draft order details for the active context.
+ * @publicDocs
+ */
 export interface DraftOrderApiContent {
     /**
      * The unique identifier for the draft order. Use for draft order lookups, implementing order-specific functionality, and integrating with external systems.

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;;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"}
+{"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;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;;GAGG;AACH,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,4 +1,8 @@
 import type { ReadonlySignalLike } from '../../../../shared';
+/**
+ * The `LocaleApi` object provides the current locale and locale updates.
+ * @publicDocs
+ */
 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. Use for internationalization, locale-specific formatting, and reactive updates when merchants change language settings.
@@ -7,6 +11,7 @@ export interface LocaleApiContent {
 }
 /**
  * The `LocaleApi` object provides access to current locale information and change notifications. Access these properties through `shopify.locale` to retrieve and monitor locale data.
+ * @publicDocs
  */
 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;;OAEG;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;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;GAGG;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,5 +1,6 @@
 /**
  * Specifies configuration options for navigation operations. Allows passing state data that persists across navigation transitions.
+ * @publicDocs
  */
 export interface NavigationNavigateOptions {
     /**
@@ -9,6 +10,7 @@ export interface NavigationNavigateOptions {
 }
 /**
  * Represents a single entry in the navigation history stack. Contains the URL and unique identifier for tracking navigation state and implementing history-based navigation.
+ * @publicDocs
  */
 export interface NavigationHistoryEntry {
     /**
@@ -26,6 +28,7 @@ export interface NavigationHistoryEntry {
 }
 /**
  * The event object for the `currententrychange` event, which fires when `Navigation.currentEntry` has changed due to navigation within the extension modal. Use to access information about the previous navigation entry when responding to navigation changes.
+ * @publicDocs
  */
 export interface NavigationCurrentEntryChangeEvent {
     /**
@@ -33,6 +36,10 @@ export interface NavigationCurrentEntryChangeEvent {
      */
     from: NavigationHistoryEntry;
 }
+/**
+ * The `Navigation` object provides navigation controls for extension modals.
+ * @publicDocs
+ */
 export interface Navigation {
     /**
      * 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.
@@ -61,6 +68,7 @@ export interface Navigation {
 }
 /**
  * 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.
+ * @publicDocs
  */
 export interface Window {
     /**
@@ -70,6 +78,7 @@ export interface Window {
 }
 /**
  * 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.
+ * @publicDocs
  */
 export interface Window {
     /**

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;;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;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,IAAI,EAAE,sBAAsB,CAAC;CAC9B;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;IACb;;;;OAIG;IACH,gBAAgB,CACd,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GACrD,IAAI,CAAC;IACR;;;;OAIG;IACH,mBAAmB,CACjB,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GACrD,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,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;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;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;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED;;;GAGG;AACH,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;IACb;;;;OAIG;IACH,gBAAgB,CACd,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GACrD,IAAI,CAAC;IACR;;;;OAIG;IACH,mBAAmB,CACjB,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GACrD,IAAI,CAAC;CACT;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;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,11 +1,13 @@
 /**
  * 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.
+ * @publicDocs
  */
 export interface OrderApi {
     order: OrderApiContent;
 }
 /**
  * The `OrderApi` object provides access to order data. Access this property through `shopify.order` to interact with the current order context.
+ * @publicDocs
  */
 export interface OrderApiContent {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"order-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/order-api/order-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;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":"order-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/order-api/order-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;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/pin-pad-api.d.ts

@@ -1,4 +1,8 @@
 import { PinPadOptions, PinValidationResult } from '../types/pin-pad';
+/**
+ * The `PinPadApi` object provides PIN entry and validation functionality.
+ * @publicDocs
+ */
 export interface PinPadApiContent {
     /**
      * 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'`.
@@ -13,6 +17,7 @@ export interface PinPadApiContent {
 }
 /**
  * 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.
+ * @publicDocs
  */
 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;;;;;;;;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"}
+{"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;;;GAGG;AACH,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;;;GAGG;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,5 +1,6 @@
 /**
  * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
+ * @publicDocs
  */
 export interface PrintApiContent {
     /**
@@ -18,6 +19,7 @@ export interface PrintApiContent {
 }
 /**
  * The `PrintApi` object provides methods for triggering document printing. Access these methods through `shopify.print` to initiate print operations with various document types.
+ * @publicDocs
  */
 export interface PrintApi {
     /**

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;;;;;;;;;;;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"}
+{"version":3,"file":"print-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/print-api/print-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;GAGG;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,9 +1,14 @@
 /**
  * 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.
+ * @publicDocs
  */
 export interface ProductApi {
     product: ProductApiContent;
 }
+/**
+ * The `ProductApi` object provides product and variant details for the active context.
+ * @publicDocs
+ */
 export interface ProductApiContent {
     /**
      * The unique identifier for the product. Use for product lookups, implementing product-specific functionality, and integrating with external systems.

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;;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"}
+{"version":3,"file":"product-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/product-api/product-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;GAGG;AACH,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

@@ -1,9 +1,13 @@
 import type { MultipleResourceResult } from '../../types/multiple-resource-result';
 import type { PaginatedResult } from '../../types/paginated-result';
 import type { Product, ProductVariant } from '../../types/product';
+/**
+ * @publicDocs
+ */
 export type ProductSortType = 'RECENTLY_ADDED' | 'RECENTLY_ADDED_ASCENDING' | 'ALPHABETICAL_A_TO_Z' | 'ALPHABETICAL_Z_TO_A';
 /**
  * Specifies parameters for cursor-based pagination. Includes the cursor position and the number of results to retrieve per page.
+ * @publicDocs
  */
 export interface PaginationParams {
     /**
@@ -17,6 +21,7 @@ export interface PaginationParams {
 }
 /**
  * Specifies the parameters for searching products. Includes query text, pagination options, and sorting preferences for product search operations.
+ * @publicDocs
  */
 export interface ProductSearchParams extends PaginationParams {
     /**
@@ -28,6 +33,10 @@ export interface ProductSearchParams extends PaginationParams {
      */
     sortType?: ProductSortType;
 }
+/**
+ * The `ProductSearchApi` object provides product search and lookup methods.
+ * @publicDocs
+ */
 export interface ProductSearchApiContent {
     /**
      * 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.
@@ -74,6 +83,7 @@ export interface ProductSearchApiContent {
 }
 /**
  * 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.
+ * @publicDocs
  */
 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;;;;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"}
+{"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;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;GAGG;AACH,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;;;GAGG;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,8 +1,12 @@
 import type { ReadonlySignalLike } from '../../../../shared';
-/** The scanner source the POS device supports. */
+/**
+ * The scanner source the POS device supports.
+ * @publicDocs
+ */
 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.
+ * @publicDocs
  */
 export interface ScannerSubscriptionResult {
     /**
@@ -20,6 +24,7 @@ export interface ScannerSubscriptionResult {
 }
 /**
  * Represents the available scanner hardware sources on the device. Provides reactive access to the list of scanners that can be used for scanning operations.
+ * @publicDocs
  */
 export interface ScannerSources {
     /**
@@ -29,6 +34,7 @@ export interface ScannerSources {
 }
 /**
  * Represents the scanner interface for accessing scan events and subscription management. Provides real-time access to scanned data through a reactive signal pattern.
+ * @publicDocs
  */
 export interface ScannerData {
     /**
@@ -36,6 +42,10 @@ export interface ScannerData {
      */
     current: ReadonlySignalLike<ScannerSubscriptionResult>;
 }
+/**
+ * The `ScannerApi` object provides scan results and scanner controls.
+ * @publicDocs
+ */
 export interface ScannerApiContent {
     /**
      * Access current scan data and subscribe to new scan events. Use to receive real-time scan results.
@@ -56,6 +66,7 @@ export interface ScannerApiContent {
 }
 /**
  * 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.
+ * @publicDocs
  */
 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;;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;IACxB;;OAEG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;OAEG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,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;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;OAEG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;OAEG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;GAGG;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,4 +1,8 @@
 import type { Session } from '../../types/session';
+/**
+ * The `SessionApi` object provides session details and authentication methods.
+ * @publicDocs
+ */
 export interface SessionApiContent {
     /**
      * 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.
@@ -21,6 +25,7 @@ export interface SessionApiContent {
 }
 /**
  * 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).
+ * @publicDocs
  */
 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;;OAEG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;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;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}

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

@@ -9,6 +9,9 @@ import { PrintApi } from '../print-api/print-api';
 import { StorageApi } from '../storage-api/storage-api';
 import { PinPadApi } from '../pin-pad-api';
 import type { I18n } from '../../../../api';
+/**
+ * @publicDocs
+ */
 export type StandardApi<T> = {
     [key: string]: any;
 } & {

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

@@ -1 +1 @@
-{"version":3,"file":"standard-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/standard/standard-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAE1C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,GAAG;IAClD,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,SAAS,GACX,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,gBAAgB,GAChB,SAAS,GACT,eAAe,GACf,UAAU,GACV,SAAS,GACT,SAAS,CAAC"}
+{"version":3,"file":"standard-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/standard/standard-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAC,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,GAAG;IAClD,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,SAAS,GACX,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,gBAAgB,GAChB,SAAS,GACT,eAAe,GACf,UAAU,GACV,SAAS,GACT,SAAS,CAAC"}

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

@@ -1,6 +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.
+ * @publicDocs
  */
 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;;GAEG;AACH,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;;;GAGG;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,3 +1,7 @@
+/**
+ * The `ToastApi` object provides methods for showing toast notifications.
+ * @publicDocs
+ */
 export interface ToastApiContent {
     /**
      * 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.
@@ -8,6 +12,7 @@ export interface ToastApiContent {
 }
 /**
  * The `ToastApi` object provides methods for displaying temporary notification messages. Access these methods through `shopify.toast` to show user feedback and status updates.
+ * @publicDocs
  */
 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,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,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;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB"}

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

@@ -10,9 +10,11 @@
 /// <reference lib="DOM" />
 import type {BadgeProps, Key, Ref} from './components-shared.d.ts';
 
+/** @publicDocs */
 export type ComponentChildren = any;
 /**
  * The base props for elements without children, providing key, ref, and slot properties.
+ * @publicDocs
  */
 export interface BaseElementProps<TClass = HTMLElement> {
   /**
@@ -30,6 +32,7 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * The base props for elements with children, extending `BaseElementProps` with children support.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
@@ -38,9 +41,11 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 
 declare const tagName = 's-badge';
+/** @publicDocs */
 export interface BadgeJSXProps extends Pick<BadgeProps, 'id'> {
   /**
    * Determines the visual appearance and semantic meaning of the badge. Badges rely on the tone system for semantic meaning, so using custom styling may not clearly convey meaning to merchants. Available options:

package/build/ts/surfaces/point-of-sale/components/Banner.d.ts

@@ -15,9 +15,11 @@ import type {
   ComponentChild,
 } from './components-shared.d.ts';
 
+/** @publicDocs */
 export type ComponentChildren = any;
 /**
  * The base props for elements without children, providing key, ref, and slot properties.
+ * @publicDocs
  */
 export interface BaseElementProps<TClass = HTMLElement> {
   /**
@@ -35,6 +37,7 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * The base props for elements with children, extending `BaseElementProps` with children support.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
@@ -43,9 +46,11 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 
 declare const tagName = 's-banner';
+/** @publicDocs */
 export interface BannerJSXProps extends Pick<BannerProps, 'heading' | 'id'> {
   /**
    * Controls whether the banner is visible or hidden. When set to `true`, the banner will be hidden from view. Use this to programmatically show or hide banners based on application state. Default is `false`.
@@ -77,6 +82,7 @@ export interface BannerJSXProps extends Pick<BannerProps, 'heading' | 'id'> {
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type ElementProps = Omit<BannerJSXProps, 'primaryAction'>;
 declare global {
   interface HTMLElementTagNameMap {

package/build/ts/surfaces/point-of-sale/components/Box.d.ts

@@ -19,9 +19,11 @@ import type {
   Ref,
 } from './components-shared.d.ts';
 
+/** @publicDocs */
 export type ComponentChildren = any;
 /**
  * The base props for elements without children, providing key, ref, and slot properties.
+ * @publicDocs
  */
 export interface BaseElementProps<TClass = HTMLElement> {
   /**
@@ -39,6 +41,7 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * The base props for elements with children, extending `BaseElementProps` with children support.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
@@ -47,13 +50,16 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 
 declare const tagName = 's-box';
 /**
  * Defines the available padding size options using a semantic scale. Provides consistent spacing values that align with the POS design system.
+ * @publicDocs
  */
 export type PaddingKeyword = SizeKeyword | 'none';
+/** @publicDocs */
 export interface BoxJSXProps {
   /**
    * A unique identifier for the element used for targeting with CSS, JavaScript, or accessibility features.

package/build/ts/surfaces/point-of-sale/components/Button.d.ts

@@ -10,9 +10,11 @@
 /// <reference lib="DOM" />
 import type {ButtonProps, Key, Ref} from './components-shared.d.ts';
 
+/** @publicDocs */
 export type ComponentChildren = any;
 /**
  * The base props for elements without children, providing key, ref, and slot properties.
+ * @publicDocs
  */
 export interface BaseElementProps<TClass = HTMLElement> {
   /**
@@ -30,6 +32,7 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * The base props for elements with children, extending `BaseElementProps` with children support.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
@@ -38,9 +41,11 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 /**
  * Represents the event object passed to callback functions when interactive events occur. Contains metadata about the event, including the target element, event phase, and propagation behavior.
+ * @publicDocs
  */
 export interface CallbackEvent<T extends keyof HTMLElementTagNameMap> {
   /**
@@ -74,6 +79,7 @@ export interface CallbackEvent<T extends keyof HTMLElementTagNameMap> {
 }
 
 declare const tagName = 's-button';
+/** @publicDocs */
 export interface ButtonJSXProps
   extends Pick<
     ButtonProps,

package/build/ts/surfaces/point-of-sale/components/Choice.d.ts

@@ -10,9 +10,11 @@
 /// <reference lib="DOM" />
 import type {ChoiceProps, Key, Ref} from './components-shared.d.ts';
 
+/** @publicDocs */
 export type ComponentChildren = any;
 /**
  * The base props for elements without children, providing key, ref, and slot properties.
+ * @publicDocs
  */
 export interface BaseElementProps<TClass = HTMLElement> {
   /**
@@ -30,6 +32,7 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * The base props for elements with children, extending `BaseElementProps` with children support.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
@@ -38,9 +41,11 @@ export interface BaseElementPropsWithChildren<TClass = HTMLElement>
    */
   children?: ComponentChildren;
 }
+/** @publicDocs */
 export type IntrinsicElementProps<T> = T & BaseElementPropsWithChildren<T & HTMLElement>;
 
 declare const tagName = 's-choice';
+/** @publicDocs */
 export interface ChoiceJSXProps
   extends Pick<ChoiceProps, 'id' | 'value' | 'disabled' | 'selected'> {
   children?: ComponentChildren;