aegis-swap-widget 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] - 2026-06-08
+
+### Added
+- Added controlled Trade details drawer state via `executionDetailsOpen` and
+  `onExecutionDetailsOpenChange`. Hosts can now coordinate the drawer with
+  their own layout while the widget keeps its existing uncontrolled
+  `defaultExecutionDetailsOpen` behavior when the controlled prop is omitted.
+
+## [0.3.1] - 2026-06-08
+
+### Added
+- Added a `Trade` / `Latest tx` switch inside the Trade details drawer. After a
+  successful swap, the drawer opens to a session-local receipt showing the
+  latest confirmed transaction's received amount, network fee, gas price, gas
+  used, block, and explorer link.
+- Added an in-flight quote shimmer on the quote-derived amount field and a
+  wallet-step hint before approval or Permit2 signing.
+
+### Changed
+- Softened the widget chrome by replacing several resting borders with tonal
+  elevation, quieter segmented controls, and a tighter Trade details surface.
+- Reskinned the local demo surface so the playground reads like a host app demo
+  instead of a secondary widget.
+- Resolved OS theme changes through `useSyncExternalStore`.
+
+### Documentation
+- Clarified the widget integration contract: production props stay real, while
+  demo wallets, fake transaction flows, scenario controls, and mock host shells
+  belong in the separate playground.
+
 ## [0.3.0] - 2026-06-08
 
 ### Removed (breaking)
@@ -192,7 +222,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial embeddable direct-pool Aegis swap widget for WATER, WOOD, GRASS, and STONE.
 - Generic pool widget API; ERC-20 → Permit2 approval and Permit2 batch signing.
 
-[Unreleased]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.3.2...HEAD
+[0.3.2]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.1.3...v0.2.0
 [0.1.3]: https://github.com/amplifi-liquidity/aegis-widget/compare/v0.1.2...v0.1.3

package/README.md

@@ -42,31 +42,31 @@ Token icons are hydrated from the same metadata table used by the Aegis website:
 `GlobalToken.iconURL` from the Aegis metadata GraphQL API. The default endpoint is
 `https://aegis.markets/graphql/meta`.
 
-## Headless Core
+## Integration Contract
 
-Use the root import for the React widget and CSS. Use the `/core` entry when a
-host, backend-backed client, or future query layer needs the swap primitives
-without importing the widget UI:
+`aegis-swap-widget` is the production widget SDK. It uses real providers, RPCs,
+pool config, approvals, Permit2 authorization, swap submission, and callbacks.
 
-```ts
-import {
-  AEGIS_SWAP_MARKETS,
-  createSwapPublicClient,
-  fetchDirectSwapQuote,
-} from 'aegis-swap-widget/core'
-```
+Demo wallets, fake transaction flows, scenario controls, and mock host shells
+belong in the separate playground. They are not exposed as production widget
+props, so an embedded widget cannot accidentally run in a fake mode.
 
-The core entry exports chain and pool config helpers, quote fetching, calldata
-encoding, Permit2 helpers, wallet/provider utilities, metadata fetchers, and the
-pure transaction-progress helpers. It does not import the React widget or the
-package stylesheet.
+Hosts should customize through `pools`, `chains`, `rpcUrls`,
+`metadataEndpoint`, wallet/provider callbacks, status surfaces, `accentColor`,
+`accentTextColor`, `className`, `style`, `title`, and `subtitle`. The widget is
+meant to blend into a host app without forking its internals.
 
-To render token icons with the widget's exact resolution order (config
-`iconUrl` → metadata endpoint → ICHI guess), use `resolveTokenIconUrl`:
+Treat contract addresses as trusted integration config. Pool and chain config
+can provide `router`, `permit2`, `quoter`, `poolKey`, and `poolId`; the widget
+normalizes addresses and validates shape, but it cannot prove that a host's
+override points at the intended Aegis or Uniswap deployment. Source those values
+from your own audited config or backend, not from user input.
 
-```ts
-import { resolveTokenIconUrl, fetchGlobalTokenMetadata } from 'aegis-swap-widget/core'
-```
+`onSubmitted`, `onSuccess`, `onError`, `onQuote`, `onStatusChange`, and
+`onPoolChange` are the supported host signals. The in-widget "Latest tx" drawer
+is a session-local UI receipt for the most recent confirmed swap; it is not a
+transaction history API. If a host needs durable history, record
+`onSubmitted`/`onSuccess` on the host side.
 
 ## Appearance
 
@@ -520,7 +520,7 @@ No other props changed. See the [CHANGELOG](./CHANGELOG.md) for the full entry.
 - `getProvider`: optional provider resolver for wallet libraries with async providers.
 - `onConnectWallet`: optional callback for opening the host wallet modal. It may return `{ provider, account }`.
 - `onSubmitted`: `(hash, swap?)` fired when the swap transaction is sent. `swap` carries mode, token symbols, amounts, and fee for analytics.
-- `onSuccess`: `({ hash, explorerUrl, swap? })` fired when the receipt confirms.
+- `onSuccess`: `({ hash, explorerUrl, swap? })` fired when the receipt confirms. Receipt gas/block facts are rendered inside the widget's session-local Latest tx view, not exposed through this callback.
 - `onError`: `(error)` fired on approval/swap failures (after the widget shows its own message).
 - `onQuote`: `(quote)` fired on every quote refresh.
 - `onStatusChange`: `(snapshot)` fired on every lifecycle transition with what the top progress rail shows (see Transaction Status).
@@ -546,8 +546,10 @@ No other props changed. See the [CHANGELOG](./CHANGELOG.md) for the full entry.
 - `showPoolLink`: whether to render the direct-pool link when the active chain provides `poolExplorerUrl`.
 - `defaultApprovalMode`: `exact` approves only the current quote spend by default; `max` opts into the old unlimited ERC-20 to Permit2 approval behavior.
 - `showApprovalMode`: whether the details drawer exposes the Exact/Max approval toggle. Defaults to `true`.
-- `showExecutionDetails`: whether to render the collapsible settings drawer for slippage, approval mode, and route. Defaults to `true`.
+- `showExecutionDetails`: whether to render the collapsible drawer for trade details and, after a confirmed swap, the session-local Latest tx receipt. Defaults to `true`.
 - `defaultExecutionDetailsOpen`: whether that settings drawer starts expanded. Defaults to `false`.
+- `executionDetailsOpen`: controlled open state for the Trade details drawer. Omit this for the widget's internal open/closed state.
+- `onExecutionDetailsOpenChange`: fired when the user toggles the drawer, switches to `Trade` / `Latest tx`, or a successful swap requests the Latest tx view. In controlled mode, update `executionDetailsOpen` in response to actually open or close the drawer.
 - `statusSurface`: where transaction status is surfaced — `'rail'` (default), `'toast'`, `'both'`, or `'none'`. The root `data-progress-state` attribute stays on regardless (see Toasts).
 - `toastPosition`: viewport corner for the widget-provided toaster. Defaults to `'bottom-right'`; ignored once a host mounts `<AegisSwapToaster />`.