@shopify/ui-extensions 2026.1.3 → 2026.1.4

package/build/ts/surfaces/customer-account/components/polaris-elements.d.ts

@@ -0,0 +1,151 @@
+// Polaris web component element types for customer-account surface
+// These are required for public docs and must be exported for doc generation.
+// Each export is tagged with @publicDocs and a placeholder JSDoc. Update descriptions as needed.
+
+// Button
+/**
+ * Properties for the button component element.
+ * @publicDocs
+ */
+export type ButtonElementProps =
+  import('../../checkout/components/Button').ButtonElementProps;
+/**
+ * Events for the button component element.
+ * @publicDocs
+ */
+export type ButtonElementEvents =
+  import('../../checkout/components/Button').ButtonElementEvents;
+/**
+ * Slots for the button component element.
+ * @publicDocs
+ */
+export type ButtonElementSlots =
+  import('../../checkout/components/Button').ButtonElementSlots;
+/**
+ * Methods for the button component element.
+ * @publicDocs
+ */
+export type ButtonElementMethods =
+  import('../../checkout/components/Button').ButtonElementMethods;
+
+// Add similar exports for all other missing Polaris web components (TextField, Checkbox, etc.) following this pattern.
+
+// Checkbox
+/**
+ * Properties for the Checkbox component element.
+ * @publicDocs
+ */
+export type CheckboxElementProps =
+  import('../../checkout/components/Checkbox').CheckboxElementProps;
+/**
+ * Events for the Checkbox component element.
+ * @publicDocs
+ */
+export type CheckboxElementEvents =
+  import('../../checkout/components/Checkbox').CheckboxElementEvents;
+// No slots or methods for Checkbox in checkout
+
+// TextField
+/**
+ * Properties for the TextField component element.
+ * @publicDocs
+ */
+export type TextFieldElementProps =
+  import('../../checkout/components/TextField').TextFieldElementProps;
+/**
+ * Events for the TextField component element.
+ * @publicDocs
+ */
+export type TextFieldElementEvents =
+  import('../../checkout/components/TextField').TextFieldElementEvents;
+/**
+ * Slots for the TextField component element.
+ * @publicDocs
+ */
+export type TextFieldElementSlots =
+  import('../../checkout/components/TextField').TextFieldElementSlots;
+// No methods for TextField in checkout
+
+// Select
+/**
+ * Properties for the Select component element.
+ * @publicDocs
+ */
+export type SelectElementProps =
+  import('../../checkout/components/Select').SelectElementProps;
+/**
+ * Events for the Select component element.
+ * @publicDocs
+ */
+export type SelectElementEvents =
+  import('../../checkout/components/Select').SelectElementEvents;
+// No slots or methods for Select in checkout
+
+// ClickableChip
+/**
+ * Slots for the ClickableChip component element.
+ * @publicDocs
+ */
+export type ClickableChipElementSlots =
+  import('../../checkout/components/ClickableChip').ClickableChipElementSlots;
+
+/**
+ * Events for the ClickableChip component element.
+ * @publicDocs
+ */
+export type ClickableChipElementEvents =
+  import('../../checkout/components/ClickableChip').ClickableChipElementEvents;
+
+// Badge
+/**
+ * Properties for the Badge component element.
+ * @publicDocs
+ */
+export type BadgeElementProps =
+  import('../../checkout/components/Badge').BadgeElementProps;
+
+// Spinner
+/**
+ * Properties for the Spinner component element.
+ * @publicDocs
+ */
+export type SpinnerElementProps =
+  import('../../checkout/components/Spinner').SpinnerElementProps;
+
+// Tooltip
+/**
+ * Properties for the Tooltip component element.
+ * @publicDocs
+ */
+export type TooltipElementProps =
+  import('../../checkout/components/Tooltip').TooltipElementProps;
+
+// Chip
+/**
+ * Properties for the Chip component element.
+ * @publicDocs
+ */
+export type ChipElementProps =
+  import('../../checkout/components/Chip').ChipElementProps;
+/**
+ * Slots for the Chip component element.
+ * @publicDocs
+ */
+export type ChipElementSlots =
+  import('../../checkout/components/Chip').ChipElementSlots;
+
+// UnorderedList
+/**
+ * Properties for the UnorderedList component element.
+ * @publicDocs
+ */
+export type UnorderedListElementProps =
+  import('../../checkout/components/UnorderedList').UnorderedListElementProps;
+
+// OrderedList
+/**
+ * Properties for the OrderedList component element.
+ * @publicDocs
+ */
+export type OrderedListElementProps =
+  import('../../checkout/components/OrderedList').OrderedListElementProps;

package/build/ts/surfaces/customer-account/components/shared.d.ts

@@ -1,19 +1,40 @@
+/**
+ * Provides an `id` property for uniquely identifying elements. This is used across customer account components to enable targeting specific elements for styling, scripting, or accessibility purposes.
+ */
 export interface IdProps {
     /**
-     * A unique identifier for the element.
+     * A unique identifier for the element. Use this to target the element with CSS, JavaScript, or accessibility attributes. The `id` must be unique within the document.
      */
     id?: string;
 }
+/**
+ * The design system's size scale, used to control the dimensions of components like avatars, icons, and thumbnails. Values range from `'small-500'` (smallest) through `'base'` (standard) to `'large-500'` (largest). Not all components support every size — check the component's `size` property type for its available options.
+ */
 export type SizeKeyword = 'small-500' | 'small-400' | 'small-300' | 'small-200' | 'small-100' | 'small' | 'base' | 'large' | 'large-100' | 'large-200' | 'large-300' | 'large-400' | 'large-500';
+/**
+ * The base properties for elements that don't have children, providing essential attributes like keys and refs for component management.
+ */
 export interface BaseElementProps<TClass = HTMLElement> {
+    /**
+     * A unique identifier for this element within its parent. Used by Preact for efficient rendering and reconciliation when lists of elements change by tracking which items have been added, removed, or reordered.
+     */
     key?: preact.Key;
+    /**
+     * A reference to the underlying DOM element, typically created using `useRef()`. This allows you to access and manipulate the DOM element directly in your component logic for imperative operations.
+     */
     ref?: preact.Ref<TClass>;
+    /**
+     * Assigns this element to a named slot in a parent component that uses slot-based composition patterns.
+     */
     slot?: Lowercase<string>;
 }
 /**
- * Used when an element has children.
+ * The base properties for elements that have children, extending `BaseElementProps` with children support.
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
+    /**
+     * The child elements to render within this component.
+     */
     children?: preact.ComponentChildren;
 }
 //# sourceMappingURL=shared.d.ts.map

package/build/ts/surfaces/customer-account/components/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/customer-account/components/shared.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,OAAO,GACP,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,WAAW;IAEpD,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC;IAEjB,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzB,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAAC,MAAM,GAAG,WAAW,CAChE,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC;CACrC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/customer-account/components/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,OAAO,GACP,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,WAAW;IACpD;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAAC,MAAM,GAAG,WAAW,CAChE,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC;CACrC"}

package/build/ts/surfaces/customer-account/components/shared.ts

@@ -1,10 +1,16 @@
+/**
+ * Provides an `id` property for uniquely identifying elements. This is used across customer account components to enable targeting specific elements for styling, scripting, or accessibility purposes.
+ */
 export interface IdProps {
   /**
-   * A unique identifier for the element.
+   * A unique identifier for the element. Use this to target the element with CSS, JavaScript, or accessibility attributes. The `id` must be unique within the document.
    */
   id?: string;
 }
 
+/**
+ * The design system's size scale, used to control the dimensions of components like avatars, icons, and thumbnails. Values range from `'small-500'` (smallest) through `'base'` (standard) to `'large-500'` (largest). Not all components support every size — check the component's `size` property type for its available options.
+ */
 export type SizeKeyword =
   | 'small-500'
   | 'small-400'
@@ -20,19 +26,31 @@ export type SizeKeyword =
   | 'large-400'
   | 'large-500';
 
+/**
+ * The base properties for elements that don't have children, providing essential attributes like keys and refs for component management.
+ */
 export interface BaseElementProps<TClass = HTMLElement> {
-  // Assigns a unique key to this element.
+  /**
+   * A unique identifier for this element within its parent. Used by Preact for efficient rendering and reconciliation when lists of elements change by tracking which items have been added, removed, or reordered.
+   */
   key?: preact.Key;
-  // Assigns a ref (generally from `useRef()`) to this element.
+  /**
+   * A reference to the underlying DOM element, typically created using `useRef()`. This allows you to access and manipulate the DOM element directly in your component logic for imperative operations.
+   */
   ref?: preact.Ref<TClass>;
-  // Assigns this element to a parent's slot.
+  /**
+   * Assigns this element to a named slot in a parent component that uses slot-based composition patterns.
+   */
   slot?: Lowercase<string>;
 }
 
 /**
- * Used when an element has children.
+ * The base properties for elements that have children, extending `BaseElementProps` with children support.
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement>
   extends BaseElementProps<TClass> {
+  /**
+   * The child elements to render within this component.
+   */
   children?: preact.ComponentChildren;
 }

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

@@ -1,12 +1,15 @@
+/**
+ * The `ActionApi` object provides properties for presenting modal interfaces. Access these properties through `shopify.action` to launch full-screen modal experiences.
+ *
+ * @publicDocs
+ */
 export interface ActionApiContent {
     /**
      * Presents the corresponding action (modal) target on top of the current view as a full-screen modal. For example, calling this method from `pos.purchase.post.action.menu-item.render` presents `pos.purchase.post.action.render`. Use to launch detailed workflows, complex forms, or multi-step processes that require more screen space than simple components provide.
      */
     presentModal(): void;
 }
-/**
- * The `ActionApi` object provides methods for presenting modal interfaces. Access these methods through `shopify.action` to launch full-screen modal experiences.
- */
+/** @publicDocs */
 export interface ActionApi {
     action: ActionApiContent;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"action-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/action-api/action-api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"action-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/action-api/action-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;CACtB;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

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

@@ -1,5 +1,6 @@
 import { ScannerApi } from '../scanner-api/scanner-api';
 import { StandardApi } from '../standard/standard-api';
+/** @publicDocs */
 export type ActionTargetApi<T> = {
     [key: string]: any;
 } & {

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

@@ -1 +1 @@
-{"version":3,"file":"action-target-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/action-target-api/action-target-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,GAAG;IACtD,cAAc,EAAE,CAAC,CAAC;CACnB,GAAG,WAAW,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC"}
+{"version":3,"file":"action-target-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/action-target-api/action-target-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,kBAAkB;AAClB,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,GAAG;IACtD,cAAc,EAAE,CAAC,CAAC;CACnB,GAAG,WAAW,CAAC,CAAC,CAAC,GAChB,UAAU,CAAC"}

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

@@ -42,7 +42,9 @@ export interface CameraMediaResponse {
     type: string;
 }
 /**
- * Provides camera capabilities for the POS device.
+ * The `CameraApi` object provides properties for capturing photos using the device camera. Access these properties through `shopify.camera` to take photos and retrieve image data with metadata.
+ *
+ * @publicDocs
  */
 export interface CameraApiContent {
     /**
@@ -57,10 +59,7 @@ export interface CameraApiContent {
      */
     takePhoto: (options?: CameraMediaOptions) => Promise<CameraMediaResponse>;
 }
-/**
- * The `CameraApi` object provides access to device camera functionality for capturing photos.
- * Access these properties through `shopify.camera`.
- */
+/** @publicDocs */
 export interface CameraApi {
     camera: CameraApiContent;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"camera-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/camera-api/camera-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3E;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"camera-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/camera-api/camera-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3E;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

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

@@ -1,8 +1,6 @@
 import type { ReadonlySignalLike } from '../../../../shared';
 import type { Address, Cart, CartUpdateInput, Customer, CustomSale, SetLineItemDiscountInput, SetLineItemPropertiesInput, SetLineItemSellingPlanInput } from '../../types/cart';
-/**
- * The `CartApi` object provides access to cart management functionality and real-time cart state monitoring. Access these properties through `shopify.cart` to interact with the current POS cart.
- */
+/** @publicDocs */
 export interface CartApi {
     cart: CartApiContent;
 }
@@ -14,6 +12,11 @@ export type CartDiscountType = 'Percentage' | 'FixedAmount' | 'Code';
  * Defines the type of discount applied to individual line items. Specifies whether the discount is percentage-based or a fixed amount reduction.
  */
 export type LineItemDiscountType = 'Percentage' | 'FixedAmount';
+/**
+ * The `CartApi` object provides access to cart management functionality and real-time cart state monitoring. Access these properties through `shopify.cart` to interact with the current POS cart.
+ *
+ * @publicDocs
+ */
 export interface CartApiContent {
     /**
      * Provides read-only access to the current cart state and allows subscribing to cart changes. The `value` property provides the current cart state, and `subscribe` allows listening to changes with improved performance and memory management.

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

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

package/build/ts/surfaces/point-of-sale/api/cart-line-item-api/cart-line-item-api.d.ts

@@ -1,6 +1,8 @@
 import type { LineItem } from '../../types/cart';
 /**
- * The `CartLineItemApi` object provides access to the current line item. Access this property through `api.cartLineItem` to interact with the current line item context.
+ * The `CartLineItemApi` object provides access to the current line item. Access these properties through `api.cartLineItem` to interact with the current line item context.
+ *
+ * @publicDocs
  */
 export interface CartLineItemApi {
     /**

package/build/ts/surfaces/point-of-sale/api/cart-line-item-api/cart-line-item-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart-line-item-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/cart-line-item-api/cart-line-item-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,EAAE,QAAQ,CAAC;CACxB"}
+{"version":3,"file":"cart-line-item-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/cart-line-item-api/cart-line-item-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,EAAE,QAAQ,CAAC;CACxB"}

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

@@ -1,5 +1,7 @@
 /**
- * The `CashDrawerApi` object provides methods for controlling cash drawer hardware. Access these methods through `shopify.cashDrawer` to trigger cash drawer operations.
+ * The `CashDrawerApi` object provides properties for controlling cash drawer hardware. Access these properties through `shopify.cashDrawer` to trigger cash drawer operations.
+ *
+ * @publicDocs
  */
 export interface CashDrawerApiContent {
     /**
@@ -9,13 +11,8 @@ export interface CashDrawerApiContent {
      */
     open(): Promise<void>;
 }
-/**
- * The `CashDrawerApi` object provides methods for controlling cash drawer hardware. Access these methods through `shopify.cashDrawer` to trigger cash drawer operations.
- */
+/** @publicDocs */
 export interface CashDrawerApi {
-    /**
-     * The `CashDrawerApi` object provides methods for controlling cash drawer hardware. Access these methods through `shopify.cashDrawer` to trigger cash drawer operations.
-     */
     cashDrawer: CashDrawerApiContent;
 }
 //# sourceMappingURL=cash-drawer-api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cash-drawer-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/cash-drawer-api/cash-drawer-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,EAAE,oBAAoB,CAAC;CAClC"}
+{"version":3,"file":"cash-drawer-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/cash-drawer-api/cash-drawer-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,oBAAoB,CAAC;CAClC"}

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

@@ -9,15 +9,18 @@ export interface ConnectivityState {
      */
     internetConnected: ConnectivityStateSeverity;
 }
+/**
+ * The `ConnectivityApi` object provides access to current connectivity information and change notifications. Access these properties through `shopify.connectivity` to monitor network status.
+ *
+ * @publicDocs
+ */
 export interface ConnectivityApiContent {
     /**
      * 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>;
 }
-/**
- * The `ConnectivityApi` object provides access to current connectivity information and change notifications. Access these properties through `shopify.connectivity` to monitor network status.
- */
+/** @publicDocs */
 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;;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"}
+{"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;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAChD;AAED,kBAAkB;AAClB,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.
- */
+/** @publicDocs */
 export interface CustomerApi {
     customer: CustomerApiContent;
 }
+/**
+ * The `CustomerApi` object provides access to customer data. Access these properties through `shopify.customer` to interact with the current customer 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,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;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,8 @@
+/**
+ * The `DeviceApi` object provides access to device information and capabilities. Access these properties through `shopify.device` to retrieve device details and check device characteristics.
+ *
+ * @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.
@@ -17,9 +22,7 @@ export interface DeviceApiContent {
      */
     isTablet(): Promise<boolean>;
 }
-/**
- * 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;;;;GAIG;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,kBAAkB;AAClB,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,12 @@
-/**
- * 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 access to draft order data. Access these properties through `api.draftOrder` to interact with the current draft order 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,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;;;GAIG;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,13 +1,16 @@
 import type { ReadonlySignalLike } from '../../../../shared';
+/**
+ * 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 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.
      */
     current: ReadonlySignalLike<string>;
 }
-/**
- * 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;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

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

@@ -33,6 +33,11 @@ export interface NavigationCurrentEntryChangeEvent {
      */
     from: NavigationHistoryEntry;
 }
+/**
+ * The global `navigation` object provides web-standard navigation functionality. Access these properties directly through the global `navigation` object to manage navigation within modal interfaces.
+ *
+ * @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.
@@ -60,16 +65,9 @@ export interface Navigation {
     removeEventListener(type: 'currententrychange', cb: (event: NavigationCurrentEntryChangeEvent) => void): 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 {
-    /**
-     * 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;
-}
-/**
- * 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.
+ * The global `window` object provides control over the extension screen lifecycle. Access these properties directly through the global `window` object to manage the modal interface.
+ *
+ * @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;;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;;;;GAIG;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;;;;GAIG;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,11 @@
-/**
- * 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.
+ * The `OrderApi` object provides access to order data. Access these properties 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,kBAAkB;AAClB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;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,9 @@
 import { PinPadOptions, PinValidationResult } from '../types/pin-pad';
+/**
+ * The `PinPadApi` object provides properties for displaying secure PIN entry interfaces. Access these properties through `shopify.pinPad` to show PIN pad modals and handle PIN validation.
+ *
+ * @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'`.
@@ -11,9 +16,7 @@ export interface PinPadApiContent {
      */
     showPinPad(onSubmit: (pin: number[]) => Promise<PinValidationResult> | PinValidationResult, options?: PinPadOptions): void;
 }
-/**
- * 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;
 }