@shopify/ui-extensions 2026.7.4 → 2026.10.0-rc.10

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

@@ -416,6 +416,24 @@ export interface ExtensionTargets {
     BlockExtensionComponents
   >;
 
+  // Configuration shouldRender targets
+
+  /**
+   * A non-rendering target that controls whether the product details configuration extension renders. Use this to conditionally show or hide your configuration extension based on product properties, user permissions, or external data.
+   */
+  'admin.product-details.configuration.should-render': RunnableExtension<
+    ShouldRenderApi<'admin.product-details.configuration.should-render'>,
+    ShouldRenderOutput
+  >;
+
+  /**
+   * A non-rendering target that controls whether the product variant details configuration extension renders. Use this to conditionally show or hide your configuration extension based on product variant properties, user permissions, or external data.
+   */
+  'admin.product-variant-details.configuration.should-render': RunnableExtension<
+    ShouldRenderApi<'admin.product-variant-details.configuration.should-render'>,
+    ShouldRenderOutput
+  >;
+
   /**
    * A function settings target that renders within order routing settings, allowing merchants to configure order routing rule functions.
    * @private

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

@@ -436,12 +436,15 @@ export interface Localization {
   /**
    * The [market](/docs/apps/build/markets) context of the checkout,
    * carried over from the cart context. Markets group countries and
-   * regions with shared pricing, languages, and domains. The market
-   * context updates when the buyer changes the country of their
-   * shipping address. The value is `undefined` if the market is unknown.
+   * regions with shared pricing, languages, and domains. In cases where
+   * multiple markets match, this returns the most narrowly scoped
+   * country region market. The market context updates when the buyer
+   * changes the country of their shipping address. The value is
+   * `undefined` if the market is unknown.
    *
-   * @deprecated Merchants now manage which extensions load for each
-   * market, so extensions no longer need to check this value.
+   * > Caution: This `market` field is deprecated and will be removed in a future version of the API.
+   *
+   * @deprecated This `market` field will be removed in a future version of the API.
    */
   market: SubscribableSignalLike<Market | undefined>;
 }

package/src/surfaces/checkout/components/Box.d.ts

@@ -8,7 +8,7 @@
 /* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
-import type {BoxProps$1,MaybeAllValuesShorthandProperty,BorderSizeKeyword, BorderStyleKeyword,ColorKeyword} from './components-shared.d.ts';
+import type {BoxProps$1,MaybeAllValuesShorthandProperty,BorderSizeKeyword, BorderStyleKeyword, SizeUnits,ColorKeyword} from './components-shared.d.ts';
 
 /**
  * The subset of border size values available for this component.
@@ -84,6 +84,61 @@ export interface BoxElementProps extends Pick<BoxProps$1, 'accessibilityLabel' |
      * @default 'none'
      */
     borderRadius?: MaybeAllValuesShorthandProperty<Extract<BoxProps$1['borderRadius'], 'none' | 'small-100' | 'small' | 'base' | 'large' | 'large-100' | 'max'>>;
+    /**
+     * Sets the box's block position by specifying offsets from the box's
+     * default position, following the CSS `inset-block` shorthand:
+     * a block-start offset followed by a block-end offset, where only one
+     * of the two can be a size so each axis is only offset once.
+     *
+     * When `position` is set to `absolute`, offsets are insets from the
+     * nearest positioned ancestor. A percentage value refers to the block
+     * size of that ancestor.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inset-block
+     *
+     * @default 'auto'
+     * @private
+     */
+    insetBlock?: `auto ${SizeUnits}` | `${SizeUnits} auto` | 'auto';
+    /**
+     * Sets the box's inline position by specifying offsets from the box's
+     * default position, following the CSS `inset-inline` shorthand:
+     * an inline-start offset followed by an inline-end offset, where only
+     * one of the two can be a size so each axis is only offset once.
+     *
+     * When `position` is set to `absolute`, offsets are insets from the
+     * nearest positioned ancestor. A percentage value refers to the inline
+     * size of that ancestor.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/inset-inline
+     *
+     * @default 'auto'
+     * @private
+     */
+    insetInline?: `auto ${SizeUnits}` | `${SizeUnits} auto` | 'auto';
+    /**
+     * Changes how the box is positioned.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/position
+     *
+     * @default 'relative'
+     * @private
+     */
+    position?: 'absolute' | 'relative';
+    /**
+     * Specifies a transformation of the box.
+     *
+     * Only two-dimensional translations are supported. The first value
+     * translates along the inline axis and the second along the block axis;
+     * inline translations are flipped in right-to-left writing modes.
+     * A percentage value refers to the corresponding size of the box itself.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/CSS/transform
+     *
+     * @default 'none'
+     * @private
+     */
+    transform?: `translate(${SizeUnits})` | `translate(${SizeUnits}, ${SizeUnits})` | `translate(${SizeUnits},${SizeUnits})` | 'none';
 }
 export interface BoxElement extends BoxElementProps, Omit<HTMLElement, 'id'> {
 }

package/src/surfaces/checkout/components/components-shared.d.ts

@@ -1384,7 +1384,7 @@ export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
 }
 export interface LinkBehaviorProps extends InteractionProps, FocusEventProps {
 	/**
-	 * The URL to navigate to when clicked. The `click` event fires first, then navigation occurs. If `commandFor` is also set, the command executes instead of navigation.
+	 * The URL to navigate to when clicked, including `mailto:` and `tel:` URLs. The `click` event fires first, then navigation occurs. If `commandFor` is also set, the command executes instead of navigation.
 	 */
 	href?: string;
 	/**

package/src/surfaces/checkout/preact/market.ts

@@ -5,8 +5,14 @@ import {useApi} from './api';
 import {useSubscription} from './subscription';
 
 /**
- * Returns the market of the checkout, and automatically re-renders
- * your component if it changes.
+ * Returns the market of the checkout, carried over from the cart context.
+ * In cases where multiple markets match, this returns the most narrowly
+ * scoped country region market. Automatically re-renders your component
+ * if it changes.
+ *
+ * > Caution: This hook is deprecated and will be removed in a future version of the API.
+ *
+ * @deprecated This hook will be removed in a future version of the API.
  * @publicDocs
  */
 export function useLocalizationMarket<

package/src/surfaces/checkout/shared.ts

@@ -70,15 +70,10 @@ export const SUPPORTED_COMPONENTS = [
   'UrlField',
 ] as const;
 
-/** @private */
-export type PrivateComponent = 'LoginWithShop';
-
 export type ThankYouComponent = 'Announcement';
 
 /** @publicDocs */
-export type AnyComponent =
-  | (typeof SUPPORTED_COMPONENTS)[number]
-  | PrivateComponent;
+export type AnyComponent = (typeof SUPPORTED_COMPONENTS)[number];
 
 /**
  * The list of supported components.

package/src/surfaces/customer-account/api/order-status/order-status.ts

@@ -201,7 +201,12 @@ export interface OrderStatusLocalization {
   /**
    * The [market](/docs/apps/build/markets) associated with the order, carried
    * over from the cart context. Markets group countries and regions with shared pricing,
-   * languages, and domains. The value is `undefined` if the market is unknown.
+   * languages, and domains. In cases where multiple markets match, this returns the most
+   * narrowly scoped country region market. The value is `undefined` if the market is unknown.
+   *
+   * > Caution: This `market` field is deprecated and will be removed in a future version of the API.
+   *
+   * @deprecated This `market` field will be removed in a future version of the API.
    */
   market: SubscribableSignalLike<Market | undefined>;
 }

package/src/surfaces/customer-account/preact/market.ts

@@ -6,8 +6,14 @@ import {useSubscription} from './subscription';
 import {ExtensionHasNoFieldError} from './errors';
 
 /**
- * Returns the market of the checkout, and automatically re-renders
- * your component if it changes.
+ * Returns the market associated with the order, carried over from the cart
+ * context. In cases where multiple markets match, this returns the most
+ * narrowly scoped country region market. Automatically re-renders your
+ * component if it changes.
+ *
+ * > Caution: This hook is deprecated and will be removed in a future version of the API.
+ *
+ * @deprecated This hook will be removed in a future version of the API.
  */
 export function useLocalizationMarket<
   Target extends RenderOrderStatusExtensionTarget = RenderOrderStatusExtensionTarget,

package/src/surfaces/point-of-sale/api/cart-api/cart-api.ts

@@ -138,6 +138,20 @@ export interface MutableCartApiContent {
     options?: AddLineItemOptions,
   ): Promise<string>;
 
+  /**
+   * Set the quantity of an existing line item identified by its `UUID`, preserving the line item's properties, discounts, and selling plans. This is equivalent to a merchant adjusting the quantity on the native cart line.
+   *
+   * If POS has split the line into multiple allocations that share the same `UUID` (for example, lines split across delivery methods), the target line is ambiguous and the call throws instead of guessing.
+   *
+   * Only available on API version `2026-10` and later.
+   *
+   * @param uuid the UUID of the line item to update
+   * @param quantity the new absolute quantity; must be an integer of 1 or greater. To remove a line item, use `removeLineItem` instead.
+   * @returns A promise that resolves after the cart state reflects the change.
+   * @throws {Error} if the line item is not found, the `UUID` matches multiple split-line allocations, the quantity is invalid, the cart is not editable because it is a return or exchange, or the POS app version does not support this method.
+   */
+  updateLineItemQuantity(uuid: string, quantity: number): Promise<void>;
+
   /**
    * Remove a specific line item from the cart using its `UUID`. The line item will be completely removed from the cart along with any associated discounts, properties, or selling plans.
    *

package/src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts

@@ -0,0 +1,24 @@
+import type {ReadonlySignalLike} from '../../../../shared';
+
+/**
+ * The `ResolutionApi` object gives a validation resolution target access to
+ * the data of the intercepted event it was opened to resolve. Access it
+ * through `shopify.resolution`.
+ *
+ * @private
+ */
+export interface ResolutionApi<TEventData> {
+  resolution: ResolutionApiContent<TEventData>;
+}
+
+/**
+ * @private
+ */
+export interface ResolutionApiContent<TEventData> {
+  /**
+   * The data of the intercepted event this resolution target was opened for.
+   * The `value` property provides the current data, and `subscribe` allows
+   * listening for host-owned revalidation updates.
+   */
+  event: ReadonlySignalLike<TEventData>;
+}

package/src/surfaces/point-of-sale/api.ts

@@ -21,10 +21,15 @@ export type {
 } from './api/extension-api/extension-api';
 export type {ActionTargetApi} from './api/action-target-api/action-target-api';
 export type {DataTargetApi} from './api/data-target-api/data-target-api';
+export type {
+  ResolutionApi,
+  ResolutionApiContent,
+} from './api/resolution-api/resolution-api';
 export type {
   TransactionCompleteEvent,
   CashTrackingSessionStartEvent,
   CashTrackingSessionCompleteEvent,
+  ScanEvent,
   ShopifyEventMap,
 } from './events';
 
@@ -145,7 +150,8 @@ export type {
 export type {CountryCode} from './types/country-code';
 
 export type {Session, StaffMember} from './types/session';
-export type {Storage} from './types/storage';
+export type {Storage, SubscribableStorage} from './types/storage';
+
 export {StorageError} from './types/storage';
 
 export type {PinPadApiContent, PinPadApi} from './api/pin-pad-api';

package/src/surfaces/point-of-sale/components/targets/ResolutionComponents.ts

@@ -0,0 +1,13 @@
+import type {StandardComponents} from './StandardComponents';
+
+/**
+ * Components available on validation resolution targets. Resolution UI renders
+ * inside a POS-owned flow step, so page-level and block-level containers are
+ * excluded, along with the smart-grid-only `Tile`.
+ *
+ * @private
+ */
+export type ResolutionComponents = Exclude<
+  StandardComponents,
+  'Page' | 'POSBlock' | 'PosBlock' | 'Tile'
+>;

package/src/surfaces/point-of-sale/events/scan-event.ts

@@ -0,0 +1,34 @@
+import type {ScannerSource} from '../api/scanner-api/scanner-api';
+
+/**
+ * Dispatched once for each successful scan captured by a camera, external,
+ * or embedded scanner. Every event carries a decoded `data` value and its
+ * `source`; no event is dispatched for initial or empty scanner state.
+ *
+ * The event is delivered only after POS has finished handling the scan
+ * itself.
+ *
+ * @example
+ * ```ts
+ * shopify.addEventListener('scan', (event) => {
+ *   handleScan(event.data, event.source);
+ * });
+ * ```
+ * @publicDocs
+ */
+export interface ScanEvent {
+  /** The event name. */
+  readonly type: 'scan';
+  /**
+   * The decoded string captured by the scan. Contains the scanned barcode, QR code, or other scannable data. Always present: an event is only dispatched for a successful scan.
+   */
+  readonly data: string;
+  /**
+   * The scanner source that captured the scan. 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
+   */
+  readonly source: ScannerSource;
+}

package/src/surfaces/point-of-sale/events.ts

@@ -3,6 +3,9 @@ import type {
   CashTrackingSessionStartEvent,
   CashTrackingSessionCompleteEvent,
 } from './events/cash-tracking-session-events';
+import type {ScanEvent} from './events/scan-event';
+import type {Cart} from './types/cart';
+import type {MoneyV2} from './types/money';
 
 /**
  * Canonical event-name constants for POS host events. Prefer these over string
@@ -14,6 +17,18 @@ export const POS_EVENT_NAMES = {
   TRANSACTION_COMPLETE: 'transactioncomplete',
   CASH_TRACKING_SESSION_START: 'cashtrackingsessionstart',
   CASH_TRACKING_SESSION_COMPLETE: 'cashtrackingsessioncomplete',
+  SCAN: 'scan',
+} as const;
+
+/**
+ * Canonical workflow-name constants for POS host interceptions. Prefer these
+ * over string literals when calling `shopify.intercept`.
+ *
+ * @private
+ */
+export const POS_INTERCEPT_NAMES = {
+  CART_VALIDATIONS: 'cartvalidations',
+  PAYMENT_VALIDATIONS: 'paymentvalidations',
 } as const;
 
 /**
@@ -34,10 +49,210 @@ export interface ShopifyEventMap {
   [POS_EVENT_NAMES.CASH_TRACKING_SESSION_START]: CashTrackingSessionStartEvent;
   /** Dispatched when a cash tracking session closes after reconciliation. */
   [POS_EVENT_NAMES.CASH_TRACKING_SESSION_COMPLETE]: CashTrackingSessionCompleteEvent;
+  /**
+   * Dispatched once for each successful scan captured by a camera, external,
+   * or embedded scanner, after POS has finished handling the scan itself.
+   * Every event carries decoded `data` and its `source`.
+   */
+  [POS_EVENT_NAMES.SCAN]: ScanEvent;
+}
+
+/**
+ * Maps POS interceptable workflow names to their corresponding `Event` types.
+ *
+ * Used as the generic type parameter for `shopify.intercept`.
+ *
+ * @private
+ */
+export interface ShopifyInterceptMap {
+  [POS_INTERCEPT_NAMES.CART_VALIDATIONS]: CartValidationsEvent;
+  [POS_INTERCEPT_NAMES.PAYMENT_VALIDATIONS]: PaymentValidationsEvent;
+}
+
+/**
+ * The data carried by a `cartvalidations` event.
+ *
+ * @private
+ */
+export interface CartValidationsEventData {
+  /** A snapshot of the POS cart taken when the event was produced. */
+  readonly cart: Cart;
+}
+
+/**
+ * The event a `cartvalidations` interceptor receives. Carries a snapshot of
+ * the POS cart taken when the event was produced.
+ *
+ * @private
+ */
+export interface CartValidationsEvent extends CartValidationsEventData {
+  readonly type: typeof POS_INTERCEPT_NAMES.CART_VALIDATIONS;
+}
+
+/**
+ * The kind of payment method being attempted.
+ *
+ * @private
+ */
+export type InterceptedPaymentMethodType = 'cash';
+
+/**
+ * Identifies the payment method being attempted.
+ *
+ * `type` alone identifies singleton methods (for example `cash`). `identifier`
+ * disambiguates method types a shop can have several of (for example custom
+ * payment methods) as they become interceptable.
+ *
+ * @private
+ */
+export interface InterceptedPaymentMethod {
+  readonly type: InterceptedPaymentMethodType;
+
+  /** Present when `type` alone is ambiguous. Matching is exact on the pair. */
+  readonly identifier?: string;
+}
+
+/**
+ * The event a `paymentvalidations` interceptor receives. Carries the tender
+ * attempt's payment method and amount; split payments produce one event per
+ * tender, each with its own amount.
+ *
+ * @private
+ */
+export interface PaymentValidationsEvent extends PaymentValidationsEventData {
+  readonly type: typeof POS_INTERCEPT_NAMES.PAYMENT_VALIDATIONS;
+}
+
+/**
+ * The data carried by a `paymentvalidations` event.
+ *
+ * @private
+ */
+export interface PaymentValidationsEventData {
+  /** The payment method staff selected. */
+  readonly paymentMethod: InterceptedPaymentMethod;
+
+  /** The amount this tender would charge, in presentment currency. */
+  readonly amount: MoneyV2;
+}
+
+/**
+ * Targets the whole cart rather than a specific line item.
+ *
+ * @private
+ */
+export type CartTarget = '$.cart';
+
+/**
+ * Targets one cart line item by its `uuid` from this event's `cart` snapshot,
+ * for example `$.cart.lineItems['adfd6b06-4a24-4f5f-9f4b-ea21f4432dd4']`.
+ *
+ * @private
+ */
+export type CartLineItemTarget = `$.cart.lineItems['${string}']`;
+
+/** @private */
+export type CartValidationTarget = CartTarget | CartLineItemTarget;
+
+/**
+ * Targets the payment attempt being intercepted.
+ *
+ * @private
+ */
+export type PaymentTarget = '$.payment';
+
+/** @private */
+export type PaymentValidationTarget = PaymentTarget;
+
+/**
+ * Where a validation applies, as an enumerated token. Targets are matched
+ * as exact strings, never evaluated as JSON paths.
+ *
+ * @private
+ */
+export type ValidationTarget = CartValidationTarget | PaymentValidationTarget;
+
+/**
+ * Maps POS interceptable workflow names to their valid validation targets.
+ *
+ * @private
+ */
+interface ValidationTargetMap {
+  [POS_INTERCEPT_NAMES.CART_VALIDATIONS]: CartValidationTarget;
+  [POS_INTERCEPT_NAMES.PAYMENT_VALIDATIONS]: PaymentValidationTarget;
+}
+
+/**
+ * The interceptor callback for a POS interceptable workflow, keyed by the
+ * workflow name so the event and its valid validation targets stay paired.
+ *
+ * @private
+ */
+export type ShopifyInterceptor<K extends keyof ShopifyInterceptMap> = (
+  event: ShopifyInterceptMap[K],
+) => InterceptResult<ValidationTargetMap[K]>;
+
+/**
+ * The result an interceptor returns. An empty `operations` list allows the
+ * workflow; an `ERROR` validation blocks it.
+ *
+ * @private
+ */
+export interface InterceptResult<
+  TTarget extends ValidationTarget = ValidationTarget,
+> {
+  operations: Operation<TTarget>[];
+}
+
+/**
+ * A single host operation produced by an interceptor.
+ *
+ * @private
+ */
+export interface Operation<
+  TTarget extends ValidationTarget = ValidationTarget,
+> {
+  validationAdd?: ValidationAdd<TTarget>;
+}
+
+/** @private */
+export type ValidationLevel = 'WARNING' | 'ERROR';
+
+/**
+ * Adds a validation to the workflow being intercepted.
+ *
+ * @private
+ */
+export interface ValidationAdd<
+  TTarget extends ValidationTarget = ValidationTarget,
+> {
+  /** `ERROR` blocks the workflow. `WARNING` does not. */
+  level: ValidationLevel;
+
+  /**
+   * Stable identifier for this validation. Handles are namespaced per
+   * extension and may repeat across targets: the same handle on two line
+   * items is two validations.
+   */
+  handle: string;
+
+  /**
+   * Locates the data the validation applies to; the host decides where it
+   * renders. Omitted or unrecognized targets fall back to the event's root
+   * scope (`$.cart` / `$.payment`) — the validation still applies, rendered
+   * less specifically.
+   *
+   * Line item uuids are only valid within the event that delivered them:
+   * use `lineItems[n].uuid` from this event's cart snapshot, don't cache
+   * uuids across events. Bundle components are not addressable; target
+   * their parent line.
+   */
+  target?: TTarget;
 }
 
 export type {
   TransactionCompleteEvent,
   CashTrackingSessionStartEvent,
   CashTrackingSessionCompleteEvent,
+  ScanEvent,
 };

package/src/surfaces/point-of-sale/extension-targets.ts

@@ -14,12 +14,20 @@ import type {
   OrderApi,
   StorageApi,
   CashDrawerApi,
+  ReadonlyCartApi,
+  ScannerApi,
+  ResolutionApi,
 } from './api';
+import type {
+  CartValidationsEventData,
+  PaymentValidationsEventData,
+} from './events';
 import type {ActionExtensionComponents} from './components/targets/ActionExtensionComponents';
 import type {BlockExtensionComponents} from './components/targets/BlockExtensionComponents';
 import type {SmartGridComponents} from './components/targets/SmartGridComponents';
 import type {ReceiptComponents} from './components/targets/ReceiptComponents';
 import type {BasicComponents} from './components/targets/BasicComponents';
+import type {ResolutionComponents} from './components/targets/ResolutionComponents';
 import type {TransactionCompleteWithReprintData} from './event/data';
 
 /**
@@ -309,11 +317,10 @@ export interface RenderExtensionTargets {
   /**
    * Renders a full-screen modal interface launched from cart line item menu items. Use this target for complex line item workflows that require forms, multi-step processes, or detailed information displays beyond what a simple button can provide.
    *
-   * Extensions at this target have access to detailed line item data through the Cart Line Item API and support workflows with multiple screens, navigation, and interactive components.
+   * Extensions at this target have access to detailed line item data through the Cart Line Item API and support workflows with multiple screens, navigation, and interactive components. Action render targets are themselves the modal destination, so the Action API (`shopify.action.presentModal()`) is not available here; use the Navigation API for in-workflow navigation.
    */
   'pos.cart.line-item-details.action.render': RenderExtension<
     ActionTargetApi<'pos.cart.line-item-details.action.render'> &
-      ActionApi &
       CartApi &
       CartLineItemApi,
     BasicComponents
@@ -371,6 +378,30 @@ export interface RenderExtensionTargets {
       CashDrawerApi,
     BlockExtensionComponents
   >;
+  /**
+   * Renders the remediation interface when a `cartvalidations` interceptor returns a validation. Use this target to resolve all of the app's findings for the event.
+   *
+   * @private
+   */
+  'pos.cart.validations.resolution.render': RenderExtension<
+    StandardApi<'pos.cart.validations.resolution.render'> &
+      ScannerApi &
+      CartApi &
+      ResolutionApi<CartValidationsEventData>,
+    ResolutionComponents
+  >;
+  /**
+   * Renders the remediation interface when a `paymentvalidations` interceptor returns a validation. Use this target to resolve all of the app's findings for the event.
+   *
+   * @private
+   */
+  'pos.payment.validations.resolution.render': RenderExtension<
+    StandardApi<'pos.payment.validations.resolution.render'> &
+      ScannerApi &
+      ReadonlyCartApi &
+      ResolutionApi<PaymentValidationsEventData>,
+    ResolutionComponents
+  >;
 }
 
 /**

package/src/surfaces/point-of-sale/globals.ts

@@ -1,5 +1,9 @@
 import type {Navigation} from './api/navigation-api/navigation-api';
-import type {ShopifyEventMap} from './events';
+import type {
+  ShopifyEventMap,
+  ShopifyInterceptMap,
+  ShopifyInterceptor,
+} from './events';
 
 /**
  * The `shopify` global provides APIs that are available to all POS extensions
@@ -36,6 +40,17 @@ export interface BackgroundShopifyGlobal extends ShopifyGlobal {
     type: K,
     listener: (event: ShopifyEventMap[K]) => void,
   ): void;
+
+  /**
+   * Register an interceptor for a POS host workflow that can be blocked.
+   * Returns a function that unregisters the interceptor.
+   *
+   * @private
+   */
+  intercept<K extends keyof ShopifyInterceptMap>(
+    type: K,
+    interceptor: ShopifyInterceptor<K>,
+  ): () => void;
 }
 
 declare global {

package/src/surfaces/point-of-sale/types/cart.ts

@@ -23,6 +23,10 @@ export interface Cart {
    * The final total amount including all items, taxes, and discounts, formatted as a currency string.
    */
   grandTotal: string;
+  /**
+   * The ISO 4217 currency code for this cart.
+   */
+  currency: string;
   /**
    * The cart note to set during bulk update. Replaces existing note or sets new note if none exists. Set to `undefined` to remove current note.
    */