aegis-swap-widget 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## 0.10.1
+
+### Patch Changes
+
+- 57b9f65: Wolf Game launch feedback: the Wolf preset stops rendering the game-signal strip above the surfaces (weather and community readouts live in the game), the store sheet keeps a drafted quantity when flipping Buy/Sell and defaults its balance readout to resource units behind a '#'/'$' toggle, and the simple-yield form defaults to token-unit entry, labels the field "Deposit Amount" with a "Deposit" submit in the Wolf preset, and shows the available balance in dollars and units together.
+
+## 0.10.0
+
+### Minor Changes
+
+- 3429c86: Launch the focused Wolf Game Trade and Earn integration without coupling the
+  SDK packages to the playground host.
+
+  Core now exports `summarizeEngineSimpleYieldPosition` for React-free lender
+  share valuation, add-funds projection, and realized historical weekly growth.
+  It uses live shares when available, falls back to trusted indexed shares, and
+  never presents the market's modeled `lendApyPct` as realized earnings. Core also
+  classifies RPC simulation failures for wallet-safe preflight messaging and
+  re-quotes direct swaps after permissions settle before submission.
+
+  Widget adds the Store buy presentation and the `simple-yield` Earn
+  presentation, including compact position growth, historical earnings context,
+  transparent partial withdrawals, stable loading states, and transaction-step
+  progress. The new `aegis-swap-widget/presets/wolf-game` export provides the
+  four-resource catalogue, focused defaults, and a helper that keeps the Store
+  pool and Earn market synchronized from one controlled resource.
+
+  The generic opt-in capabilities remain available to other hosts:
+  `surfaceLabels` renames exposed tabs, `lendPresentation` selects a built-in
+  plain-language presentation, and `onInteractionLockChange` reports when host
+  navigation must stay fixed.
+
+  Add the opt-in `showTransactionSteps` prop to Swap and Engine. It renders a
+  compact ordered wallet journey only while an action is active, with the total
+  step count, completed steps, current wallet or network wait, and the next step.
+  The Wolf Game preset enables it for Trade and Earn.
+
+  Trade rechecks price after wallet permissions without weakening the reviewed
+  protection or exceeding the signed spend cap. Receipt recovery keeps an
+  unconfirmed permission transaction on its permission step instead of implying
+  that the final Trade or Earn action was submitted.
+
+  `lendPresentation` selects a built-in lexicon, exported as `AegisEngineLendCopy`
+  and overridable per string through the new `lendCopy` prop. Hosts supply their
+  own vocabulary rather than inheriting another integration's.
+
+  `marketId` and `defaultMarketId` now compare `evm_`-prefixed ids case
+  insensitively inside the widget, so externally supplied casing cannot lose a
+  controlled market selection. Uncontrolled hosts are unaffected — both sides of
+  that comparison come from the same market list.
+
+  Use these in the Wolf Game preview to launch a focused Trade and Earn flow,
+  keep one resource selected across both actions, and leave the game dashboard
+  context behind an explicit optional Showroom mode.
+
+### Patch Changes
+
+- Updated dependencies [3429c86]
+  - @aegis-engine/core@0.6.0
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -60,6 +60,83 @@ export function Engine({ account, provider }) {
 }
 ```
 
+## Wolf Game Trade and Earn preset
+
+The Wolf preset reproduces the focused gamer flow: a resource Store under
+**Trade** and one-token full-range liquidity under **Earn**. It hides DeFi
+plumbing by default, but it does not hide execution protection or withdrawal
+outputs.
+
+The preset is React-free and is available from a small dedicated export. The
+host still owns wallet connection, data routes, selected resource, navigation,
+and lifecycle callbacks:
+
+```tsx
+import * as React from 'react'
+import { AegisEngineWidget } from 'aegis-swap-widget'
+import {
+  WOLF_GAME_ENGINE_WIDGET_PRESET,
+  WOLF_GAME_RESOURCE_ORDER,
+  wolfGameResourceWidgetProps,
+  type WolfGameResourceSymbol
+} from 'aegis-swap-widget/presets/wolf-game'
+import 'aegis-swap-widget/styles.css'
+
+export function WolfTradeAndEarn({ account, provider }) {
+  const [resource, setResource] = React.useState<WolfGameResourceSymbol>('GRASS')
+  const [interactionLocked, setInteractionLocked] = React.useState(false)
+  const resourceProps = React.useMemo(
+    () => wolfGameResourceWidgetProps(resource, setResource),
+    [resource]
+  )
+
+  return (
+    <AegisEngineWidget
+      {...WOLF_GAME_ENGINE_WIDGET_PRESET}
+      {...resourceProps}
+      account={account}
+      provider={provider}
+      chains={engineChains}
+      engineDataSource={{ kind: 'rest', baseUrl: '/api/engine/wolf' }}
+      backendBaseUrl="/api/aegis"
+      onInteractionLockChange={setInteractionLocked}
+      resourceNavigation={
+        <nav aria-label="Resource">
+          {WOLF_GAME_RESOURCE_ORDER.map((symbol) => (
+            <button
+              key={symbol}
+              type="button"
+              aria-pressed={resource === symbol}
+              disabled={interactionLocked}
+              onClick={() => setResource(symbol)}
+            >
+              {symbol}
+            </button>
+          ))}
+        </nav>
+      }
+    />
+  )
+}
+```
+
+`engineDataSource` must expose Wolf-scoped Engine markets, positions, activity,
+and history. `backendBaseUrl` is a separate Swap data plane and must expose
+`/v1/config`, `/v1/markets`, `/v1/tokens`, and token price history. Do not point
+both props at a route that implements only the Engine endpoints.
+
+`wolfGameResourceWidgetProps` controls the Store pool and Earn market from one
+resource. It ignores an unknown Store pool instead of selecting an unrelated
+market. Spread the preset first, then the controlled resource props, and put
+host callbacks last when they intentionally override a default.
+
+The Wolf preset defaults `partnerContextVariant` to `embedded`, so it renders no
+standing game context above Trade and Earn. The published widget does not call
+Wolf Game itself. Hosts that opt into `partnerContextVariant="signal"` or
+`"showroom"` pass their server-normalized data through `partnerContext`; the
+signal places one game-condition line directly below the surface tabs. The
+Playground exposes the same choice as **Off / Game signal / Details hub**.
+
 ## Trade surface
 
 `'trade'` is opt-in. The default tab set is `['buy', 'borrow', 'lend',
@@ -164,26 +241,22 @@ submits a transaction or changes Aegis market data:
 
 ```tsx
 import { AegisEngineWidget } from 'aegis-swap-widget'
-import type { PartnerContext } from 'aegis-swap-widget/partner-context'
-
-const partnerContext = {
-  partner: { id: 'wolf-game', name: 'Wolf Game' },
-  actionRequirement: {
-    id: 'upgrade-barn-water',
-    label: 'Upgrade Barn',
-    resource: {
-      chainId: 1,
-      address: '0x828B22c9ea1c20B551EeFC6198174C4bb7a8CBF6',
-      symbol: 'WATER'
-    },
-    requiredAmount: '1000',
-    availableAmount: '660',
-    shortfallAmount: '340',
-    resourceUse: 'consumed'
-  }
-} satisfies PartnerContext
+import type {
+  PartnerActionRequirement,
+  PartnerContext,
+} from 'aegis-swap-widget/partner-context'
+
+export function GameMarket({
+  actionRequirement,
+}: {
+  // Load this from authoritative, authenticated game state.
+  actionRequirement: PartnerActionRequirement
+}) {
+  const partnerContext = {
+    partner: { id: 'your-game', name: 'Your Game' },
+    actionRequirement,
+  } satisfies PartnerContext
 
-export function GameMarket() {
   return (
     <AegisEngineWidget
       partnerContext={partnerContext}
@@ -220,31 +293,20 @@ to that event without duplicating its resource or amount:
 
 ```tsx
 import { partnerLaunchIntentForRequirement } from 'aegis-swap-widget/partner-context'
+import type { PartnerActionRequirement } from 'aegis-swap-widget/partner-context'
 
-const launchIntent = partnerLaunchIntentForRequirement(
-  partnerContext.actionRequirement,
-  'borrow',
-  crypto.randomUUID()
-)
-```
-
-The equivalent launch intent is:
-
-```ts
-{
-  requestId: 'new-id-for-this-click',
-  source: 'action-requirement',
-  requirementId: 'upgrade-barn-water',
-  surface: 'borrow',
-  resource: {
-    chainId: 1,
-    address: '0x828B22c9ea1c20B551EeFC6198174C4bb7a8CBF6',
-    symbol: 'WATER',
-  },
-  amount: '340',
+function createLaunchIntent(actionRequirement: PartnerActionRequirement) {
+  return partnerLaunchIntentForRequirement(
+    actionRequirement,
+    'borrow',
+    crypto.randomUUID()
+  )
 }
 ```
 
+The launch intent copies the validated requirement ID, resource, and shortfall.
+Do not hardcode a sample game cost into this path.
+
 Pass that value through `partnerLaunchIntent` and clear it after
 `onPartnerLaunchIntentApplied`. Use a new `requestId` for each external click.
 Borrow fills the debt token's “I need” field. Buy uses the matching direct pool
@@ -255,11 +317,13 @@ match.
 Use `partnerContextVariant="embedded"` inside an existing product shell. It is
 silent unless the host supplies an `actionRequirement`; then the widget places
 one compact purpose row beside the active Buy or Borrow transaction content.
-Partner identity, weather, aggregate balances, activities, secondary details,
-and navigation remain available only in the default `showroom` variant. If the
-host already owns resource selection, pass the selected token through
-`marketResource`. The widget resolves its eligible Lend/Borrow market from live
-Engine discovery on the active chain by exact address and symbol:
+Use `partnerContextVariant="signal"` for one environment line without partner
+identity, balances, activities, freshness, actions, or another dashboard.
+Partner identity and every supplied block remain available in the default
+`showroom` variant. If the host already owns resource selection, pass the
+selected token through `marketResource`. The widget resolves its eligible
+Lend/Borrow market from live Engine discovery on the active chain by exact
+address and symbol:
 
 ```tsx
 const wolfResources = {
@@ -290,11 +354,12 @@ widget should own selection. The nested Buy surface remains independently
 controlled through `buySwapConfig`; one-shot partner Buy intents already
 resolve their matching direct pool.
 
-Wolf Game's aggregate API provides game-wide balances plus weather and
-harvesting data for a selected community. It does not provide wallet-specific inventory, claimable
-resources, energy timing, or a concrete action requirement. A Wolf host must
-therefore create `actionRequirement` only from real game state. Do not derive it
-from aggregate weather or inventory alone.
+The current Wolf signal integration provides weather for a selected community.
+The optional showroom adds game-wide balances. Neither mode includes
+wallet-specific inventory, claimable resources, energy percentage, or a
+concrete action requirement. A Wolf host must create `actionRequirement` only
+from authoritative game state. Do not derive it from aggregate weather or
+inventory alone.
 
 The Engine discovery surface defaults to Amplifi's public production REST API.
 The production source implements
@@ -338,7 +403,8 @@ and is not inferred from `inCapEvent`.
 full-width sheet inside the widget's own bounds — the row stays live and
 pressing it again (or Escape, or tapping the scrim) brings the sheet back down,
 and the widget's height never changes. `'down'` expands the breakdown inline
-below the CTA, growing the widget.
+below the CTA, growing the widget. `'none'` removes the disclosure when the host
+already explains the action or wants the smallest flow.
 
 A lend or borrow renders one transaction lifecycle card in the form's outcome
 slot: Review (feasible quote) → Pending (in flight) → Confirmed (mined). The
@@ -349,6 +415,10 @@ the card header on confirm. `defaultTransactionDetailsOpen` (default `true`)
 sets whether the card's metric breakdown starts expanded; the Details row keeps
 its single trigger for the quote breakdown sheet.
 
+`lendPresentation="lp-fees"` uses the lighter game-facing lifecycle. The CTA
+shows the pending state without repeating the reviewed amount and market, and
+confirmation reduces to `Added` plus the transaction link.
+
 Product semantics are deliberately conservative:
 
 - A borrow requires an upfront collateral deposit.
@@ -1051,6 +1121,7 @@ No other props changed. See the [CHANGELOG](./CHANGELOG.md) for the full entry.
 - `approvalMode`: controlled Engine approval mode (`'exact'` or `'max'`). Omit it to initialize internal state from `defaultApprovalMode`.
 - `onApprovalModeChange`: fired when the Engine approval mode changes. A controlled host must update `approvalMode` in response.
 - `showExecutionDetails`: whether to render the collapsible drawer for trade details and, after a confirmed swap, the session-local Latest tx receipt. Defaults to `true`.
+- `showTransactionSteps`: whether to show a compact completed/current/next checklist while a Trade, Earn, or Borrow transaction is active. Defaults to `false`; the Wolf Game preset enables it.
 - `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.
@@ -1109,8 +1180,9 @@ pnpm --filter aegis-swap-widget dev
 
 Releases are automated with [changesets](https://github.com/changesets/changesets)
 from the monorepo root — no manual `npm version`/`npm publish`. `dist/` is not
-committed; the `prepack` hook rebuilds it on every pack/publish, and
-`prepublishOnly` runs the typecheck + test gate.
+committed. The Release workflow builds and validates every package once, then
+disables package lifecycle scripts while Changesets publishes packages concurrently.
+Local `pnpm pack:check` still runs each package's `prepack` build sequentially.
 
 ```bash
 pnpm changeset               # in your PR: pick aegis-swap-widget + bump, write the entry