From 7910d5e3b9ce2f34e1a166acce131b13d092ff01 Mon Sep 17 00:00:00 2001
From: Victor Chu <victor.chu@shopify.com>
Date: Thu, 13 Aug 2026 17:18:58 -0700
Subject: [PATCH] docs(pos): document Discount.amount read behavior from
 2026-10

Assisted-By: devx/ebf9cf26-03bb-4c3e-9919-a083a362bb2b
---
 packages/ui-extensions/checkout/preact.esnext                | 1 +
 packages/ui-extensions/checkout/preact.js                    | 1 +
 packages/ui-extensions/checkout/preact.mjs                   | 1 +
 packages/ui-extensions/customer-account/preact.esnext        | 1 +
 packages/ui-extensions/customer-account/preact.js            | 1 +
 packages/ui-extensions/customer-account/preact.mjs           | 1 +
 .../ui-extensions/src/surfaces/point-of-sale/types/cart.ts   | 5 +++++
 7 files changed, 11 insertions(+)
 create mode 100644 packages/ui-extensions/checkout/preact.esnext
 create mode 100644 packages/ui-extensions/checkout/preact.js
 create mode 100644 packages/ui-extensions/checkout/preact.mjs
 create mode 100644 packages/ui-extensions/customer-account/preact.esnext
 create mode 100644 packages/ui-extensions/customer-account/preact.js
 create mode 100644 packages/ui-extensions/customer-account/preact.mjs

diff --git a/packages/ui-extensions/checkout/preact.esnext b/packages/ui-extensions/checkout/preact.esnext
new file mode 100644
index 0000000000..db07a7fe09
--- /dev/null
+++ b/packages/ui-extensions/checkout/preact.esnext
@@ -0,0 +1 @@
+export * from "./build/esnext/surfaces/checkout/preact/index.esnext";
\ No newline at end of file
diff --git a/packages/ui-extensions/checkout/preact.js b/packages/ui-extensions/checkout/preact.js
new file mode 100644
index 0000000000..4817d591e7
--- /dev/null
+++ b/packages/ui-extensions/checkout/preact.js
@@ -0,0 +1 @@
+module.exports = require("./build/cjs/surfaces/checkout/preact/index.js");
\ No newline at end of file
diff --git a/packages/ui-extensions/checkout/preact.mjs b/packages/ui-extensions/checkout/preact.mjs
new file mode 100644
index 0000000000..0222f36339
--- /dev/null
+++ b/packages/ui-extensions/checkout/preact.mjs
@@ -0,0 +1 @@
+export * from "./build/esm/surfaces/checkout/preact/index.mjs";
\ No newline at end of file
diff --git a/packages/ui-extensions/customer-account/preact.esnext b/packages/ui-extensions/customer-account/preact.esnext
new file mode 100644
index 0000000000..05783b904d
--- /dev/null
+++ b/packages/ui-extensions/customer-account/preact.esnext
@@ -0,0 +1 @@
+export * from "./build/esnext/surfaces/customer-account/preact/index.esnext";
\ No newline at end of file
diff --git a/packages/ui-extensions/customer-account/preact.js b/packages/ui-extensions/customer-account/preact.js
new file mode 100644
index 0000000000..d8294bd399
--- /dev/null
+++ b/packages/ui-extensions/customer-account/preact.js
@@ -0,0 +1 @@
+module.exports = require("./build/cjs/surfaces/customer-account/preact/index.js");
\ No newline at end of file
diff --git a/packages/ui-extensions/customer-account/preact.mjs b/packages/ui-extensions/customer-account/preact.mjs
new file mode 100644
index 0000000000..0bdbe20753
--- /dev/null
+++ b/packages/ui-extensions/customer-account/preact.mjs
@@ -0,0 +1 @@
+export * from "./build/esm/surfaces/customer-account/preact/index.mjs";
\ No newline at end of file
diff --git a/packages/ui-extensions/src/surfaces/point-of-sale/types/cart.ts b/packages/ui-extensions/src/surfaces/point-of-sale/types/cart.ts
index 84c95d079b..861c895413 100644
--- a/packages/ui-extensions/src/surfaces/point-of-sale/types/cart.ts
+++ b/packages/ui-extensions/src/surfaces/point-of-sale/types/cart.ts
@@ -50,6 +50,11 @@ export interface LineItem {
 }
 
 export interface Discount {
+  /**
+   * The discount value to apply. For `'Percentage'` type, this is the percentage value (for example, `10` for 10% off). For `'FixedAmount'` type, this is the fixed monetary amount to deduct.
+   *
+   * From API version 2026-10, reading a manual discount from the cart returns the same value that was applied, so discounts can be passed back to `bulkCartUpdate` unchanged. This also requires a POS app version with the corresponding fix; on older POS app versions, reads return the calculated monetary total of the discount instead (the behavior of all API versions before 2026-10).
+   */
   amount: number;
   currency?: string;
   discountDescription?: string;