Signor1 · Signor1 · May 29, 2026 · May 29, 2026
diff --git a/.changeset/feebearer-and-quote-fix.md b/.changeset/feebearer-and-quote-fix.md
diff --git a/apps/docs/CHANGELOG.md b/apps/docs/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/docs
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/apps/docs/package.json b/apps/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/docs",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Whisk marketing landing + fumadocs documentation. Served at usewhisk.vercel.app (marketing) and usewhisk.vercel.app/docs (docs).",
   "type": "module",

diff --git a/examples/donate-button/CHANGELOG.md b/examples/donate-button/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/example-donate-button
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/donate-button/package.json b/examples/donate-button/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/example-donate-button",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Vite + React donation page. Recipient locked, amount free — donor picks how generous they feel today.",
   "type": "module",

diff --git a/examples/ecommerce-checkout/CHANGELOG.md b/examples/ecommerce-checkout/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/example-ecommerce-checkout
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/ecommerce-checkout/package.json b/examples/ecommerce-checkout/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/example-ecommerce-checkout",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "E-commerce checkout. Whisk locked to a fixed price + merchant address — the widget is just the confirm-and-pay surface.",
   "type": "module",

diff --git a/examples/invoice-link/CHANGELOG.md b/examples/invoice-link/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/example-invoice-link
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/invoice-link/package.json b/examples/invoice-link/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/example-invoice-link",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Invoice payment links. The merchant shares /pay?to=…&amount=…&chain=…; Whisk reads the params and pre-fills.",
   "type": "module",

diff --git a/examples/payroll-batch/CHANGELOG.md b/examples/payroll-batch/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/example-payroll-batch
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/payroll-batch/package.json b/examples/payroll-batch/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/example-payroll-batch",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Vite + React admin tool. A list of payees, click one, the same Whisk widget repopulates with their address + amount.",
   "type": "module",

diff --git a/examples/themed-saas/CHANGELOG.md b/examples/themed-saas/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @usewhisk/example-themed-saas
 
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+  - @usewhisk/react@0.1.0
+
 ## 0.0.3
 
 ### Patch Changes

diff --git a/examples/themed-saas/package.json b/examples/themed-saas/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/example-themed-saas",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": true,
   "description": "Theme override demo. Whisk's CSS tokens replaced with a corporate teal/navy palette to match a SaaS dashboard.",
   "type": "module",

diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @usewhisk/core
 
+## 0.1.0
+
+### Minor Changes
+
+- 631b659: Fee bearer control and a stale-quote fix.
+
+  **`feeBearer`** — new config option. Default `"receiver"` preserves current behavior (CCTP + Forwarder fees come out of the transfer). Set `feeBearer: "sender"` to size the burn up by the estimated fees so the recipient receives the full amount — useful for checkout, payroll, and invoice flows. Quotes now expose `amountBurned` (the on-chain transfer amount) alongside `amountIn` (sender debit) and `amountOut` (recipient receives). In sender mode the gross-up pads the forwarding portion by a small margin (2%); the forwarder fee is re-priced from destination gas at mint time, so the cushion keeps the recipient at or above the requested amount despite drift, with any unused margin minted to them.
+
+  **Fix** — changing the destination chain after the recipient resolved kept quoting against the original chain. A host-pinned recipient was resolved only once (a one-shot `useRef` latch) and the "Review" gate ignored the chain, so switching destinations reused the stale resolution and bridged to the wrong chain. Auto-resolve is now keyed on recipient + destination, and a resolved recipient whose chain no longer matches the selected destination is re-resolved before quoting.
+
+  **Fix** — host theme overrides were ignored in dark mode. The widget's dark palette lived on `[data-whisk][data-whisk-theme="dark"]` (specificity 0,2,0), which out-specified a host re-theming `--whisk-*` on `[data-whisk]` (0,1,0) — so a dark integration kept the default wine/terracotta colors. The theme discriminators are now wrapped in `:where()`, keeping every theme block at `[data-whisk]` specificity, so host overrides win in light, dark, and system (on the card and in portals).
+
+  **Fix** — wallet errors surfaced the raw viem/App Kit dump (`Request Arguments: …`, `Version: viem@…`). Declining the wallet prompt now reads "You cancelled the transaction in your wallet.", and other errors are trimmed to their human first line (App Kit's "Unknown blockchain error on \<chain\>:" wrapper and the argument dump are stripped). The full provider error is preserved on `cause` for debugging. This cleanup now covers every surface that renders an error — the transfer result screen, the connect modal (EVM and Solana), the manual-mint flow, and the ENS resolver — not just the bridge path. The message cleaner is also exported as `cleanErrorMessage` for custom surfaces.
+
 ## 0.0.4
 
 ### Patch Changes

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/core",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "description": "Whisk core — framework-agnostic engine, types, errors, and state machine for the Whisk USDC widget.",
   "license": "MIT",
   "author": "SignorDev (https://github.com/Signor1)",

diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
@@ -1,5 +1,24 @@
 # @usewhisk/react
 
+## 0.1.0
+
+### Minor Changes
+
+- 631b659: Fee bearer control and a stale-quote fix.
+
+  **`feeBearer`** — new config option. Default `"receiver"` preserves current behavior (CCTP + Forwarder fees come out of the transfer). Set `feeBearer: "sender"` to size the burn up by the estimated fees so the recipient receives the full amount — useful for checkout, payroll, and invoice flows. Quotes now expose `amountBurned` (the on-chain transfer amount) alongside `amountIn` (sender debit) and `amountOut` (recipient receives). In sender mode the gross-up pads the forwarding portion by a small margin (2%); the forwarder fee is re-priced from destination gas at mint time, so the cushion keeps the recipient at or above the requested amount despite drift, with any unused margin minted to them.
+
+  **Fix** — changing the destination chain after the recipient resolved kept quoting against the original chain. A host-pinned recipient was resolved only once (a one-shot `useRef` latch) and the "Review" gate ignored the chain, so switching destinations reused the stale resolution and bridged to the wrong chain. Auto-resolve is now keyed on recipient + destination, and a resolved recipient whose chain no longer matches the selected destination is re-resolved before quoting.
+
+  **Fix** — host theme overrides were ignored in dark mode. The widget's dark palette lived on `[data-whisk][data-whisk-theme="dark"]` (specificity 0,2,0), which out-specified a host re-theming `--whisk-*` on `[data-whisk]` (0,1,0) — so a dark integration kept the default wine/terracotta colors. The theme discriminators are now wrapped in `:where()`, keeping every theme block at `[data-whisk]` specificity, so host overrides win in light, dark, and system (on the card and in portals).
+
+  **Fix** — wallet errors surfaced the raw viem/App Kit dump (`Request Arguments: …`, `Version: viem@…`). Declining the wallet prompt now reads "You cancelled the transaction in your wallet.", and other errors are trimmed to their human first line (App Kit's "Unknown blockchain error on \<chain\>:" wrapper and the argument dump are stripped). The full provider error is preserved on `cause` for debugging. This cleanup now covers every surface that renders an error — the transfer result screen, the connect modal (EVM and Solana), the manual-mint flow, and the ENS resolver — not just the bridge path. The message cleaner is also exported as `cleanErrorMessage` for custom surfaces.
+
+### Patch Changes
+
+- Updated dependencies [631b659]
+  - @usewhisk/core@0.1.0
+
 ## 0.0.4
 
 ### Patch Changes

diff --git a/packages/react/package.json b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usewhisk/react",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "description": "Whisk React — embeddable USDC send & bridge widget components, hooks, and providers built on Circle App Kit.",
   "license": "MIT",
   "author": "SignorDev (https://github.com/Signor1)",