@shopify/ui-extensions 2026.10.0-rc.4 → 2026.10.0-rc.7

package/build/cjs/surfaces/point-of-sale/events.js

@@ -21,7 +21,8 @@ const POS_EVENT_NAMES = {
  * @private
  */
 const POS_INTERCEPT_NAMES = {
-  BEFORE_CHECKOUT: 'beforecheckout'
+  CART_VALIDATIONS: 'cartvalidations',
+  PAYMENT_VALIDATIONS: 'paymentvalidations'
 };
 
 /**
@@ -42,13 +43,91 @@ const POS_INTERCEPT_NAMES = {
  */
 
 /**
- * Dispatched when staff attempts to leave the active cart for checkout.
+ * The data carried by a `cartvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * The event a `cartvalidations` interceptor receives. Carries a snapshot of
+ * the POS cart taken when the event was produced.
+ *
+ * @private
+ */
+
+/**
+ * The kind of payment method being attempted.
+ *
+ * @private
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * The data carried by a `paymentvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * Targets the whole cart rather than a specific line item.
+ *
+ * @private
+ */
+
+/**
+ * Targets one cart line item by its `uuid` from this event's `cart` snapshot,
+ * for example `$.cart.lineItems['adfd6b06-4a24-4f5f-9f4b-ea21f4432dd4']`.
  *
  * @private
  */
 
 /** @private */
 
+/**
+ * Targets the payment attempt being intercepted.
+ *
+ * @private
+ */
+
+/** @private */
+
+/**
+ * Where a validation applies, as an enumerated token. Targets are matched
+ * as exact strings, never evaluated as JSON paths.
+ *
+ * @private
+ */
+
+/**
+ * Maps POS interceptable workflow names to their valid validation targets.
+ *
+ * @private
+ */
+
+/**
+ * The interceptor callback for a POS interceptable workflow, keyed by the
+ * workflow name so the event and its valid validation targets stay paired.
+ *
+ * @private
+ */
+
 /**
  * The result an interceptor returns. An empty `operations` list allows the
  * workflow; an `ERROR` validation blocks it.

package/build/esm/surfaces/point-of-sale/events.mjs

@@ -17,7 +17,8 @@ const POS_EVENT_NAMES = {
  * @private
  */
 const POS_INTERCEPT_NAMES = {
-  BEFORE_CHECKOUT: 'beforecheckout'
+  CART_VALIDATIONS: 'cartvalidations',
+  PAYMENT_VALIDATIONS: 'paymentvalidations'
 };
 
 /**
@@ -38,13 +39,91 @@ const POS_INTERCEPT_NAMES = {
  */
 
 /**
- * Dispatched when staff attempts to leave the active cart for checkout.
+ * The data carried by a `cartvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * The event a `cartvalidations` interceptor receives. Carries a snapshot of
+ * the POS cart taken when the event was produced.
+ *
+ * @private
+ */
+
+/**
+ * The kind of payment method being attempted.
+ *
+ * @private
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * The data carried by a `paymentvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * Targets the whole cart rather than a specific line item.
+ *
+ * @private
+ */
+
+/**
+ * Targets one cart line item by its `uuid` from this event's `cart` snapshot,
+ * for example `$.cart.lineItems['adfd6b06-4a24-4f5f-9f4b-ea21f4432dd4']`.
  *
  * @private
  */
 
 /** @private */
 
+/**
+ * Targets the payment attempt being intercepted.
+ *
+ * @private
+ */
+
+/** @private */
+
+/**
+ * Where a validation applies, as an enumerated token. Targets are matched
+ * as exact strings, never evaluated as JSON paths.
+ *
+ * @private
+ */
+
+/**
+ * Maps POS interceptable workflow names to their valid validation targets.
+ *
+ * @private
+ */
+
+/**
+ * The interceptor callback for a POS interceptable workflow, keyed by the
+ * workflow name so the event and its valid validation targets stay paired.
+ *
+ * @private
+ */
+
 /**
  * The result an interceptor returns. An empty `operations` list allows the
  * workflow; an `ERROR` validation blocks it.

package/build/esnext/surfaces/point-of-sale/events.esnext

@@ -17,7 +17,8 @@ const POS_EVENT_NAMES = {
  * @private
  */
 const POS_INTERCEPT_NAMES = {
-  BEFORE_CHECKOUT: 'beforecheckout'
+  CART_VALIDATIONS: 'cartvalidations',
+  PAYMENT_VALIDATIONS: 'paymentvalidations'
 };
 
 /**
@@ -38,13 +39,91 @@ const POS_INTERCEPT_NAMES = {
  */
 
 /**
- * Dispatched when staff attempts to leave the active cart for checkout.
+ * The data carried by a `cartvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * The event a `cartvalidations` interceptor receives. Carries a snapshot of
+ * the POS cart taken when the event was produced.
+ *
+ * @private
+ */
+
+/**
+ * The kind of payment method being attempted.
+ *
+ * @private
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * 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
+ */
+
+/**
+ * The data carried by a `paymentvalidations` event.
+ *
+ * @private
+ */
+
+/**
+ * Targets the whole cart rather than a specific line item.
+ *
+ * @private
+ */
+
+/**
+ * Targets one cart line item by its `uuid` from this event's `cart` snapshot,
+ * for example `$.cart.lineItems['adfd6b06-4a24-4f5f-9f4b-ea21f4432dd4']`.
  *
  * @private
  */
 
 /** @private */
 
+/**
+ * Targets the payment attempt being intercepted.
+ *
+ * @private
+ */
+
+/** @private */
+
+/**
+ * Where a validation applies, as an enumerated token. Targets are matched
+ * as exact strings, never evaluated as JSON paths.
+ *
+ * @private
+ */
+
+/**
+ * Maps POS interceptable workflow names to their valid validation targets.
+ *
+ * @private
+ */
+
+/**
+ * The interceptor callback for a POS interceptable workflow, keyed by the
+ * workflow name so the event and its valid validation targets stay paired.
+ *
+ * @private
+ */
+
 /**
  * The result an interceptor returns. An empty `operations` list allows the
  * workflow; an `ERROR` validation blocks it.

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

@@ -0,0 +1,23 @@
+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>;
+}
+//# sourceMappingURL=resolution-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolution-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,UAAU;IACvC,UAAU,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,UAAU;IAC9C;;;;OAIG;IACH,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CACvC"}

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

@@ -6,6 +6,7 @@ export type { StandardApi } from './api/standard/standard-api';
 export type { ExtensionApi, ExtensionApiContent, } 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, ShopifyEventMap, } from './events';
 export type { CameraApi, CameraApiContent, CameraMediaOptions, CameraMediaResponse, } from './api/camera-api/camera-api';
 export type { ConnectivityStateSeverity, ConnectivityState, ConnectivityApiContent, ConnectivityApi, } from './api/connectivity-api/connectivity-api';

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

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

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

@@ -116,12 +116,13 @@ export interface ButtonJSXProps
   >;
   /**
    * Changes the visual appearance of the button.
+   * - `auto`: Automatically determines the button variant based on its context.
    * - `primary`: Creates a prominent call-to-action button with high visual emphasis for the most important action on a screen.
    * - `secondary`: Provides a less prominent button appearance for supporting actions and secondary interactions.
    *
-   * @default 'auto' - the variant is automatically determined by the button's context
+   * @default 'auto'
    */
-  variant?: Extract<ButtonProps['variant'], 'primary' | 'secondary'>;
+  variant?: Extract<ButtonProps['variant'], 'auto' | 'primary' | 'secondary'>;
   /**
    * An event that's called when the button is activated.
    */

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

@@ -8,7 +8,13 @@
 /* eslint-disable import-x/namespace */
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
-import type {ImageProps, Key, Ref} from './components-shared.d.ts';
+import type {
+  BorderRadiusKeyword,
+  ImageProps,
+  Key,
+  MaybeAllValuesShorthandProperty,
+  Ref,
+} from './components-shared.d.ts';
 
 /** @publicDocs */
 export type ComponentChildren = any;
@@ -60,6 +66,25 @@ export interface ImageJSXProps extends Pick<ImageProps, 'id' | 'objectFit'> {
    * The image source URL (remote URL or local file resource). When loading or no src is provided, a placeholder is rendered. Ensure URLs are properly formatted and properly formatted.
    */
   src?: ImageProps['src'];
+  /**
+   * Border radius for the image corners.
+   *
+   * [1-to-4-value syntax](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties#edges_of_a_box) is
+   * supported. Note that, contrary to CSS, it uses flow-relative values and the order is:
+   *
+   * - 4 values: `start-start start-end end-end end-start`
+   * - 3 values: `start-start (start-end & end-start) end-end`
+   * - 2 values: `(start-start & end-end) (start-end & end-start)`
+   *
+   * For example:
+   * - `base` means all corners have `base` radius
+   * - `base none` means start-start and end-end corners are `base`, start-end and end-start corners are `none`
+   * - `base none large` means start-start is `base`, start-end and end-start are `none`, end-end is `large`
+   * - `base none large small` means start-start is `base`, start-end is `none`, end-end is `large`, end-start is `small`
+   *
+   * @default 'none'
+   */
+  borderRadius?: MaybeAllValuesShorthandProperty<BorderRadiusKeyword>;
 }
 declare global {
   interface HTMLElementTagNameMap {

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

@@ -1438,7 +1438,7 @@ export interface ButtonProps extends GlobalProps, BaseClickableProps {
   /**
    * Changes the visual appearance of the button.
    *
-   * @default 'auto' - the variant is automatically determined by the button's context
+   * @default 'auto'
    */
   variant?: 'auto' | 'primary' | 'secondary' | 'tertiary';
   /**

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

@@ -0,0 +1,10 @@
+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'>;
+//# sourceMappingURL=ResolutionComponents.d.ts.map

package/build/ts/surfaces/point-of-sale/components/targets/ResolutionComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolutionComponents.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/point-of-sale/components/targets/ResolutionComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,kBAAkB,EAClB,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAC1C,CAAC"}

package/build/ts/surfaces/point-of-sale/events.d.ts

@@ -1,6 +1,7 @@
 import type { TransactionCompleteEvent } from './events/transaction-complete-event';
 import type { CashTrackingSessionStartEvent, CashTrackingSessionCompleteEvent } from './events/cash-tracking-session-events';
 import type { Cart } from './types/cart';
+import type { MoneyV2 } from './types/money';
 /**
  * Canonical event-name constants for POS host events. Prefer these over string
  * literals when calling `shopify.addEventListener` / `removeEventListener`.
@@ -19,7 +20,8 @@ export declare const POS_EVENT_NAMES: {
  * @private
  */
 export declare const POS_INTERCEPT_NAMES: {
-    readonly BEFORE_CHECKOUT: "beforecheckout";
+    readonly CART_VALIDATIONS: "cartvalidations";
+    readonly PAYMENT_VALIDATIONS: "paymentvalidations";
 };
 /**
  * Maps Shopify POS event names to their corresponding payload types.
@@ -48,36 +50,130 @@ export interface ShopifyEventMap {
  * @private
  */
 export interface ShopifyInterceptMap {
-    [POS_INTERCEPT_NAMES.BEFORE_CHECKOUT]: BeforeCheckoutEvent;
+    [POS_INTERCEPT_NAMES.CART_VALIDATIONS]: CartValidationsEvent;
+    [POS_INTERCEPT_NAMES.PAYMENT_VALIDATIONS]: PaymentValidationsEvent;
 }
 /**
- * Dispatched when staff attempts to leave the active cart for checkout.
+ * The data carried by a `cartvalidations` event.
  *
  * @private
  */
-export interface BeforeCheckoutEvent extends Event {
-    readonly type: typeof POS_INTERCEPT_NAMES.BEFORE_CHECKOUT;
-    /** The POS cart at the point checkout was requested. */
+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 ShopifyInterceptor<TEvent extends Event> = (event: TEvent) => InterceptResult;
+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 {
-    operations: Operation[];
+export interface InterceptResult<TTarget extends ValidationTarget = ValidationTarget> {
+    operations: Operation<TTarget>[];
 }
 /**
  * A single host operation produced by an interceptor.
  *
  * @private
  */
-export interface Operation {
-    validationAdd?: ValidationAdd;
+export interface Operation<TTarget extends ValidationTarget = ValidationTarget> {
+    validationAdd?: ValidationAdd<TTarget>;
 }
 /** @private */
 export type ValidationLevel = 'WARNING' | 'ERROR';
@@ -86,13 +182,27 @@ export type ValidationLevel = 'WARNING' | 'ERROR';
  *
  * @private
  */
-export interface ValidationAdd {
+export interface ValidationAdd<TTarget extends ValidationTarget = ValidationTarget> {
     /** `ERROR` blocks the workflow. `WARNING` does not. */
     level: ValidationLevel;
-    /** Stable identifier for this validation. */
+    /**
+     * 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;
-    /** JSON-path locator for where the validation applies. */
-    target?: 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, };
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/point-of-sale/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;IACjE,qDAAqD;IACrD,CAAC,eAAe,CAAC,2BAA2B,CAAC,EAAE,6BAA6B,CAAC;IAC7E,2EAA2E;IAC3E,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE,gCAAgC,CAAC;CACpF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CAC5D;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC,eAAe,CAAC;IAC1D,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED,eAAe;AACf,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,KAAK,IAAI,CACrD,KAAK,EAAE,MAAM,KACV,eAAe,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,eAAe;AACf,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,KAAK,EAAE,eAAe,CAAC;IAEvB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,GACjC,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/surfaces/point-of-sale/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;IACjE,qDAAqD;IACrD,CAAC,eAAe,CAAC,2BAA2B,CAAC,EAAE,6BAA6B,CAAC;IAC7E,2EAA2E;IAC3E,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE,gCAAgC,CAAC;CACpF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IAC7D,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IACpE,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC,gBAAgB,CAAC;CAC5D;AAED;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAE5C,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B;IAC1E,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC,mBAAmB,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;IAEjD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,MAAM,IAAI,CAAC;AAEjE,eAAe;AACf,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,eAAe;AACf,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAE9E;;;;GAIG;AACH,UAAU,mBAAmB;IAC3B,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IAC7D,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,mBAAmB,IAAI,CACpE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC1B,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAC9B,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CACxB,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,aAAa,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,eAAe;AACf,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAC5B,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,uDAAuD;IACvD,KAAK,EAAE,eAAe,CAAC;IAEvB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,GACjC,CAAC"}