aegis-swap-widget 0.3.2 → 0.3.4

package/dist/widget/useStatusSurface.d.ts

@@ -0,0 +1,32 @@
+import type { Hex } from 'viem';
+import { type AegisSwapChainConfig } from '../config';
+import { type AegisSwapStatusSnapshot, type SubmitStatus } from '../transactionProgress';
+import type { AegisSwapStatusSurface } from './types';
+export type UseStatusSurfaceParams = {
+    status: SubmitStatus;
+    txHash: Hex | null;
+    actionError: string | null;
+    inputSymbol: string;
+    approvalRequired: boolean;
+    approvalDone: boolean;
+    authorizationRequired: boolean;
+    statusSurface: AegisSwapStatusSurface;
+    activeChain: AegisSwapChainConfig;
+    onStatusChange?: (snapshot: AegisSwapStatusSnapshot) => void;
+    successDescription: string | null;
+};
+/**
+ * Shared status-surface wiring for both swap controllers: derives the progress
+ * view + state, the rail/toast visibility flags, and the explorer URL (with the
+ * `'#'` fallback guarded to null), then mirrors lifecycle snapshots to the host
+ * and drives the lifecycle toast. Deliberately scoped to the genuinely-shared
+ * core — `approvalHint` and the tx-receipt summary stay in each controller
+ * because they diverge between the direct and aggregated variants.
+ */
+export declare function useStatusSurface({ status, txHash, actionError, inputSymbol, approvalRequired, approvalDone, authorizationRequired, statusSurface, activeChain, onStatusChange, successDescription }: UseStatusSurfaceParams): {
+    progress: import("../transactionProgress").TransactionProgressView | null;
+    progressState: import("..").TransactionProgressState | null;
+    showRail: boolean;
+    showToast: boolean;
+    explorerUrl: string | null;
+};

package/dist/widget/useSwapController.d.ts

@@ -1,7 +1,7 @@
 import { type KeyboardEvent } from 'react';
 import { type AegisSwapMarket } from '../config';
 import { type AegisSwapApprovalMode } from '../hooks/useSubmitSwap';
-import type { AegisDirectSwapWidgetProps, AegisSwapWidgetStyle, SwapDirection } from './types';
+import type { AegisDirectSwapWidgetProps, SwapDirection } from './types';
 import { type ExecutionDetailsView, type LatestTransactionSummary } from './viewState';
 /**
  * Owns the entire swap form: configuration derivation, hook orchestration,
@@ -11,9 +11,9 @@ import { type ExecutionDetailsView, type LatestTransactionSummary } from './view
  * isolation through `renderHook`.
  */
 export declare function useSwapController(props: AegisDirectSwapWidgetProps): {
-    rootRef: import("react").MutableRefObject<HTMLElement | null>;
+    rootRef: import("react").RefObject<HTMLElement | null>;
     resolvedThemeMode: import("../hooks/useResolvedTheme").ResolvedThemeMode;
-    widgetStyle: AegisSwapWidgetStyle;
+    widgetStyle: import("./types").AegisSwapWidgetStyle;
     className: string | undefined;
     ariaLabel: string;
     title: string;
@@ -28,21 +28,21 @@ export declare function useSwapController(props: AegisDirectSwapWidgetProps): {
     showExecutionDetails: boolean;
     showPoolLink: boolean;
     showApprovalMode: boolean;
-    progress: import("..").TransactionProgressView | null;
+    progress: import("../transactionProgress").TransactionProgressView | null;
     progressState: import("..").TransactionProgressState | null;
     poolIds: string[];
     activePoolId: string;
     marketMap: Record<string, AegisSwapMarket>;
-    metadataByAddress: import("..").TokenMetadataByAddress;
-    poolButtonRefs: import("react").MutableRefObject<Map<string, HTMLButtonElement | null>>;
+    metadataByAddress: import("../metadata").TokenMetadataByAddress;
+    poolButtonRefs: import("react").RefObject<Map<string, HTMLButtonElement | null>>;
     onSelectPool: (poolId: string) => void;
     onPoolKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
-    activeChain: import("..").AegisSwapChainConfig;
+    activeChain: import("../config").AegisSwapChainConfig;
     networkOptions: import("./types").AegisSwapNetworkOption[] | undefined;
     hasAvailablePools: boolean;
     balances: import("../hooks/useTokenBalances").BalanceState;
     sellInputId: string;
-    inputToken: import("..").AegisSwapToken;
+    inputToken: import("../config").AegisSwapToken;
     sellFieldValue: string;
     sellInvalid: boolean;
     sellRefreshEnabled: boolean;
@@ -53,7 +53,7 @@ export declare function useSwapController(props: AegisDirectSwapWidgetProps): {
     market: AegisSwapMarket | null;
     onFlipDirection: () => void;
     buyInputId: string;
-    outputToken: import("..").AegisSwapToken;
+    outputToken: import("../config").AegisSwapToken;
     buyFieldValue: string;
     buyInvalid: boolean;
     buyRefreshEnabled: boolean;
@@ -77,20 +77,19 @@ export declare function useSwapController(props: AegisDirectSwapWidgetProps): {
     onSlippageBlur: () => void;
     approvalMode: AegisSwapApprovalMode;
     onApprovalModeChange: import("react").Dispatch<import("react").SetStateAction<AegisSwapApprovalMode>>;
-    counterToken: import("..").AegisSwapToken;
-    targetToken: import("..").AegisSwapToken;
+    counterToken: import("../config").AegisSwapToken;
+    targetToken: import("../config").AegisSwapToken;
     poolUrl: string | null;
     onCopyPoolId: () => Promise<void>;
     routePoolCopied: boolean;
-    status: import("..").SubmitStatus;
+    status: import("@aegis-engine/core").SubmitStatus;
     txHash: `0x${string}` | null;
-    quote: import("..").DirectSwapQuote | null;
+    quote: import("../quote").DirectSwapQuote | null;
     quoteError: string | null;
     quoteLoading: boolean;
     actionError: string | null;
     allowanceError: string | null;
     inlineTxExplorerHref: string | null;
-    txExplorerHref: string | null;
     approvalHint: string | null;
     txSummary: LatestTransactionSummary | null;
 };

package/dist/widget/useWidgetStyle.d.ts

@@ -0,0 +1,13 @@
+import type { AegisSwapWidgetStyle } from './types';
+/**
+ * Shared accent → CSS-variable derivation for both swap controllers. Writes
+ * `--aegis-swap-accent` from `accentColor` and derives a readable
+ * `--aegis-swap-accent-text` (pickReadableTextColor) unless the host supplies
+ * `accentTextColor`. Stabilizes the incoming host `style` so inline objects
+ * don't reset the memo every render.
+ */
+export declare function useWidgetStyle({ accentColor, accentTextColor, style }: {
+    accentColor?: string;
+    accentTextColor?: string;
+    style?: AegisSwapWidgetStyle;
+}): AegisSwapWidgetStyle;

package/dist/widget/viewState.d.ts

@@ -1,7 +1,9 @@
 import type { Hex } from 'viem';
 import type { DirectSwapQuote } from '../quote';
-import type { SubmitStatus } from '../transactionProgress';
+import type { AggregatedSwapQuote } from '../types/aggregatedSwap';
+import type { AegisSwapReceiptSummary, SubmitStatus } from '../transactionProgress';
 import type { AegisSwapWidgetDirection, SwapDirection } from './types';
+export declare function readRailResetDelayMs(root: HTMLElement | null): number;
 export declare function normalizeWidgetDirection(direction?: AegisSwapWidgetDirection): SwapDirection;
 export declare function formatRoutePoolId(poolId: Hex): string;
 export declare function nextRovingIndex(key: string, currentIndex: number, count: number): number | null;
@@ -63,3 +65,21 @@ export declare function getTradeDetailRows({ quote, inputSymbol, inputDecimals,
     outputSymbol: string;
     outputDecimals: number;
 }): TradeDetailRow[];
+export declare function getAggregatedTradeDetailRows({ quote, inputSymbol, inputDecimals, outputSymbol, outputDecimals }: {
+    quote: AggregatedSwapQuote | null;
+    inputSymbol: string;
+    inputDecimals: number;
+    outputSymbol: string;
+    outputDecimals: number;
+}): TradeDetailRow[];
+export declare function buildTxReceiptSummary({ receiptSummary, quote, outputDecimals, outputSymbol, isSuccess, explorerUrl, nativeSymbol }: {
+    receiptSummary: AegisSwapReceiptSummary | null;
+    quote: {
+        amountOut: bigint;
+    } | null;
+    outputDecimals: number;
+    outputSymbol: string;
+    isSuccess: boolean;
+    explorerUrl: string | null;
+    nativeSymbol: string;
+}): LatestTransactionSummary | null;

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "aegis-swap-widget",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Embeddable direct-pool Aegis swap widget for WATER, WOOD, GRASS, and STONE.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/amplifi-liquidity/aegis-widget.git"
-  },
-  "bugs": {
-    "url": "https://github.com/amplifi-liquidity/aegis-widget/issues"
+    "url": "git+https://github.com/amplifi-liquidity/aegis-widget.git",
+    "directory": "packages/widget"
   },
+  "bugs": "https://github.com/amplifi-liquidity/aegis-widget/issues",
   "homepage": "https://github.com/amplifi-liquidity/aegis-widget#readme",
   "keywords": [
     "aegis",
@@ -45,18 +44,6 @@
     "CHANGELOG.md",
     "DESIGN.md"
   ],
-  "scripts": {
-    "dev": "vite",
-    "typecheck": "tsc -p tsconfig.build.json --noEmit",
-    "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "coverage": "vitest run --coverage",
-    "build": "vite build && tsc -p tsconfig.build.json",
-    "preview": "vite preview",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run typecheck && npm run typecheck:test && npm run test && npm run build"
-  },
   "peerDependencies": {
     "react": ">=18 <20",
     "react-dom": ">=18 <20",
@@ -66,8 +53,8 @@
     "@testing-library/react": "^16.3.2",
     "@types/jsdom": "^28.0.3",
     "@types/node": "^25.9.1",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
     "@vitejs/plugin-react": "^4.3.4",
     "@vitest/coverage-v8": "^4.1.8",
     "jsdom": "^29.1.1",
@@ -77,6 +64,21 @@
     "vitest": "^4.1.8"
   },
   "dependencies": {
-    "lucide-react": "^0.562.0"
+    "lucide-react": "^0.562.0",
+    "@aegis-engine/core": "^0.1.2"
+  },
+  "engines": {
+    "node": ">=22.14"
+  },
+  "scripts": {
+    "dev": "vite",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "build:preview": "vite build --config vite.preview.config.ts",
+    "preview": "vite preview"
   }
-}
+}