@gearbox-protocol/ui-kit 3.14.0-next.12 → 3.14.0-next.14

package/dist/types/components/composites/tx-preview/state-change/PoolStateChangeCard.d.ts

@@ -0,0 +1,18 @@
+import { AddressBalanceChanges, PoolOperation } from '@gearbox-protocol/sdk/preview';
+import { Address } from 'viem';
+import { GearboxSDKLike } from '../types';
+export interface PoolStateChangeCardProps {
+    sdk: GearboxSDKLike;
+    /** The decoded pool deposit/redeem operation. */
+    operation: PoolOperation;
+    /** Balance changes grouped by watched address (from a successful simulation). */
+    balanceChanges: AddressBalanceChanges[];
+    /** Wallet whose balances are highlighted. */
+    wallet: Address;
+}
+/**
+ * Pool-specific state-change content: balance changes grouped by address (wallet
+ * and, when distinct, the recipient). Renders content only; the surrounding card
+ * chrome, loading, and error handling live in {@link StateChangeCard}.
+ */
+export declare function PoolStateChangeCard({ sdk, operation, balanceChanges, wallet, }: PoolStateChangeCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/composites/tx-preview/state-change/StateChangeCard.d.ts

@@ -0,0 +1,21 @@
+import { Operation, PoolSimulationResult } from '@gearbox-protocol/sdk/preview';
+import { Address } from 'viem';
+import { GearboxSDKLike } from '../types';
+export interface StateChangeCardProps {
+    sdk: GearboxSDKLike;
+    /** Parsed operation that drives which specific state-change card is shown. */
+    data: Operation;
+    /** Stage-2 simulation outcome; `undefined` while it is loading. */
+    simulation: PoolSimulationResult | undefined;
+    /** Whether the simulation is still running. */
+    isLoading: boolean;
+    /** Wallet whose balances/transfers are highlighted. */
+    wallet: Address;
+}
+/**
+ * Parent card for transaction state changes. Owns the common logic (collapsible
+ * card shell, loading skeleton, card-styled error, and no-data handling) and
+ * decides which specific state-change card to render: pool balance changes,
+ * credit account changes (not yet supported), or the decoded revert reason.
+ */
+export declare function StateChangeCard({ sdk, data, simulation, isLoading, wallet, }: StateChangeCardProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/composites/tx-preview/state-change/index.d.ts

@@ -0,0 +1,4 @@
+export * from './BalanceChangeGroup';
+export * from './BalanceChangeRow';
+export * from './PoolStateChangeCard';
+export * from './StateChangeCard';

package/dist/types/components/composites/tx-preview/types.d.ts

@@ -0,0 +1,19 @@
+import { Address } from 'viem';
+/**
+ * Minimal SDK surface for tx-preview UI + hooks.
+ * Satisfied by verify OnchainSDK and client preview SDK instances.
+ */
+export interface GearboxSDKLike {
+    chainId: number;
+    tokensMeta: {
+        get(address: Address): {
+            symbol?: string;
+            decimals?: number;
+            name?: string;
+        } | undefined;
+    };
+    readonly plugins: {
+        adapters: unknown;
+    };
+    client: unknown;
+}

package/dist/types/components/composites/tx-preview/utils/addressLabels.d.ts

@@ -0,0 +1,16 @@
+import { PoolOperation } from '@gearbox-protocol/sdk/preview';
+import { Address } from 'viem';
+import { AddressLabels } from '../components';
+import { GearboxSDKLike } from '../types';
+/**
+ * Builds the UI label map for a pool deposit/redeem operation.
+ *
+ * "Our" addresses (wallet, receiver, redeem owner) are flagged `ours: true`; the
+ * pool is labeled with its name and flagged `ours: false`. When the receiver /
+ * owner coincides with the wallet, it is labeled "Your wallet".
+ *
+ * Note: the `ours` flag is a UI-only concept and is derived locally here; it is
+ * intentionally decoupled from the simulation watch set in the SDK preview
+ * `simulate` module.
+ */
+export declare function buildPoolOperationLabels(sdk: GearboxSDKLike, op: PoolOperation, wallet: Address): AddressLabels;

package/dist/types/components/composites/tx-preview/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './addressLabels';
+export * from './poolTokenInfo';

package/dist/types/components/composites/tx-preview/utils/poolTokenInfo.d.ts

@@ -0,0 +1,14 @@
+import { Address } from 'viem';
+import { GearboxSDKLike } from '../types';
+export interface TokenInfo {
+    symbol: string;
+    decimals: number;
+    /** Human-readable token/pool name, when available. */
+    name?: string;
+}
+/**
+ * Resolves a token's symbol, decimals and name from `sdk.tokensMeta`, falling
+ * back to a shortened address / 18 decimals when the token is not in the
+ * registry. For pools, the diesel-token meta carries the pool name.
+ */
+export declare function resolveToken(sdk: GearboxSDKLike, address: Address): TokenInfo;

package/dist/types/components/legal-agreement/index.d.ts

@@ -1 +1,5 @@
-export { type AppName, BlockedRegionDialog, type BlockedRegionDialogProps, createGearboxAppConfig, createLegalAgreementConfig, createPermissionlessInterfaceConfig, createPermissionlessSafeConfig, type LegalAgreementCheckboxItem, LegalAgreementDialog, type LegalAgreementDialogConfig, type LegalAgreementDialogLinks, type LegalAgreementDialogProps, } from './legal-agreement-dialog';
+export { LegalAgreementAwaitingPanel, type LegalAgreementAwaitingPanelProps, LegalAgreementAwaitingPanelTest, } from './legal-agreement-awaiting-panel';
+export { BlockedRegionDialog, type BlockedRegionDialogProps, type LegalAgreementCheckboxItem, LegalAgreementDialog, type LegalAgreementDialogConfig, type LegalAgreementDialogProps, } from './legal-agreement-dialog';
+export { LegalAgreementLink, type LegalAgreementLinkProps, } from './legal-agreement-link';
+export { LegalAgreementPanel, type LegalAgreementPanelProps, LegalAgreementPanelTest, } from './legal-agreement-panel';
+export { type LegalAgreementThemeVariantProps, type LegalAgreementVisualTheme, legalAgreementAwaitingDescriptionVariants, legalAgreementAwaitingRootVariants, legalAgreementAwaitingTitleVariants, legalAgreementLinkVariants, legalAgreementPanelCheckboxLabelVariants, legalAgreementPanelCheckboxListTitleVariants, legalAgreementPanelCheckboxListVariants, legalAgreementPanelCheckboxRowVariants, legalAgreementPanelNotificationVariants, legalAgreementPanelRootVariants, legalAgreementPanelV2BannerVariants, } from './legal-agreement-theme';

package/dist/types/components/legal-agreement/legal-agreement-awaiting-panel.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { LegalAgreementVisualTheme } from './legal-agreement-theme';
+export declare class LegalAgreementAwaitingPanelTest {
+    static root: string;
+}
+export interface LegalAgreementAwaitingPanelProps {
+    readonly waitingForSignatureText?: string;
+    readonly theme?: LegalAgreementVisualTheme;
+}
+export declare function LegalAgreementAwaitingPanel({ waitingForSignatureText, theme, }: LegalAgreementAwaitingPanelProps): React.ReactElement;

package/dist/types/components/legal-agreement/legal-agreement-dialog.d.ts

@@ -1,13 +1,9 @@
+import { LegalAgreementVisualTheme } from './legal-agreement-theme';
 import * as React from "react";
 export interface LegalAgreementCheckboxItem {
     id: string;
     content: React.ReactNode;
 }
-export interface LegalAgreementDialogLinks {
-    termsOfService: string;
-    privacyNotice: string;
-    riskDisclosure: string;
-}
 export interface LegalAgreementDialogConfig {
     /**
      * Product/service name (e.g., "Permissionless Interface", "Permissionless Safe", "Gearbox App")
@@ -41,6 +37,15 @@ export interface LegalAgreementDialogConfig {
      * Defaults to "Please sign the message in your wallet to agree to the Terms of Service."
      */
     waitingForSignatureText?: string;
+    /**
+     * Notice shown when terms are updated (hasV2Signature is true).
+     * Host app supplies legal copy; ui-kit only renders layout.
+     */
+    updatedTermsNoticeText?: React.ReactNode;
+    /**
+     * Optional heading above checkbox list (e.g. warranty section title).
+     */
+    checkboxListTitle?: React.ReactNode;
 }
 export interface LegalAgreementDialogProps {
     open: boolean;
@@ -50,6 +55,7 @@ export interface LegalAgreementDialogProps {
     hasV2Signature?: boolean;
     isAwaitingSignature?: boolean;
     config: LegalAgreementDialogConfig;
+    theme?: LegalAgreementVisualTheme;
 }
 /**
  * LegalAgreementDialog — dialog component for legal agreement signing.
@@ -77,59 +83,20 @@ export interface LegalAgreementDialogProps {
  * Note: Displays checkboxes for user agreement and handles signing flow.
  * Shows waiting state during signature process.
  *
- * Example usage with helper function:
+ * Example usage — host app supplies config (legal copy is app-owned):
  * ```tsx
- * import { LegalAgreementDialog, createLegalAgreementConfig } from '@gearbox-protocol/ui-kit';
+ * import { LegalAgreementDialog, LegalAgreementLink } from '@gearbox-protocol/ui-kit';
  *
- * const links = {
- *   termsOfService: 'https://gearbox.fi/terms',
- *   privacyNotice: 'https://gearbox.fi/privacy',
- *   riskDisclosure: 'https://gearbox.fi/risks',
+ * const config = {
+ *   productName: 'My App',
+ *   notificationText: <>…your legal copy with <LegalAgreementLink href="…">ToS</LegalAgreementLink>…</>,
+ *   checkboxItems: [{ id: 'consent', content: <>…</> }],
  * };
  *
- * // You can use any app name. For "Permissionless Interface" and "Permissionless Safe"
- * // it uses simplified consent flow. For other names (e.g., "Gearbox App") it uses
- * // extended consent flow with additional checkboxes.
- * const config = createLegalAgreementConfig("Permissionless Interface", links);
- *
- * <LegalAgreementDialog
- *   open={isOpen}
- *   onClose={handleClose}
- *   onSign={handleSign}
- *   isSigning={isSigning}
- *   config={config}
- * />
+ * <LegalAgreementDialog open={isOpen} onClose={handleClose} onSign={handleSign} isSigning={isSigning} config={config} />
  * ```
  */
-export declare function LegalAgreementDialog({ open, onClose, onSign, isSigning, hasV2Signature, isAwaitingSignature, config, }: LegalAgreementDialogProps): import("react/jsx-runtime").JSX.Element;
-export type AppName = string;
-/**
- * Creates configuration for legal agreement dialog based on app name.
- * @param appName - Name of the application (any string, e.g., "Permissionless Interface", "Permissionless Safe", "Gearbox App", etc.)
- * @param links - URLs for legal documents
- * @param options - Optional configuration overrides
- */
-export declare function createLegalAgreementConfig(appName: AppName, links: LegalAgreementDialogLinks, options?: {
-    agreeButtonText?: string;
-}): LegalAgreementDialogConfig;
-/**
- * @deprecated Use createLegalAgreementConfig("Permissionless Interface", links, options) instead
- */
-export declare function createPermissionlessInterfaceConfig(links: LegalAgreementDialogLinks, options?: {
-    agreeButtonText?: string;
-}): LegalAgreementDialogConfig;
-/**
- * @deprecated Use createLegalAgreementConfig("Permissionless Safe", links, options) instead
- */
-export declare function createPermissionlessSafeConfig(links: LegalAgreementDialogLinks, options?: {
-    agreeButtonText?: string;
-}): LegalAgreementDialogConfig;
-/**
- * @deprecated Use createLegalAgreementConfig("Gearbox App", links, options) instead
- */
-export declare function createGearboxAppConfig(links: LegalAgreementDialogLinks, options?: {
-    agreeButtonText?: string;
-}): LegalAgreementDialogConfig;
+export declare function LegalAgreementDialog({ open, onClose, onSign, isSigning, hasV2Signature, isAwaitingSignature, config, theme, }: LegalAgreementDialogProps): import("react/jsx-runtime").JSX.Element;
 export interface BlockedRegionDialogProps {
     open: boolean;
     onClose: () => void;

package/dist/types/components/legal-agreement/legal-agreement-link.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { LegalAgreementVisualTheme } from './legal-agreement-theme';
+export interface LegalAgreementLinkProps {
+    readonly href: string;
+    readonly children: React.ReactNode;
+    readonly theme?: LegalAgreementVisualTheme;
+}
+/**
+ * Styled external link for legal agreement copy supplied by the host app.
+ */
+export declare function LegalAgreementLink({ href, children, theme, }: LegalAgreementLinkProps): React.ReactElement;

package/dist/types/components/legal-agreement/legal-agreement-panel.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { LegalAgreementDialogConfig } from './legal-agreement-dialog';
+import { LegalAgreementVisualTheme } from './legal-agreement-theme';
+export declare class LegalAgreementPanelTest {
+    static root: string;
+}
+export interface LegalAgreementPanelProps {
+    readonly config: LegalAgreementDialogConfig;
+    readonly checkedItems: Readonly<Record<string, boolean>>;
+    readonly onCheckedChange: (id: string) => void;
+    readonly hasV2Signature?: boolean;
+    readonly showTitle?: boolean;
+    readonly checkboxIdPrefix?: string;
+    readonly theme?: LegalAgreementVisualTheme;
+}
+export declare function LegalAgreementPanel({ config, checkedItems, onCheckedChange, hasV2Signature, showTitle, checkboxIdPrefix, theme, }: LegalAgreementPanelProps): React.ReactElement;

package/dist/types/components/legal-agreement/legal-agreement-theme.d.ts

@@ -0,0 +1,36 @@
+import { VariantProps } from 'class-variance-authority';
+export type LegalAgreementVisualTheme = "default" | "gearboxV3";
+export declare const legalAgreementPanelRootVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelNotificationVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelCheckboxListVariants: (props?: ({
+    readonly theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelCheckboxListTitleVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelCheckboxRowVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelCheckboxLabelVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementPanelV2BannerVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementAwaitingRootVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementAwaitingTitleVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementAwaitingDescriptionVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const legalAgreementLinkVariants: (props?: ({
+    theme?: "default" | "gearboxV3" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export type LegalAgreementThemeVariantProps = VariantProps<typeof legalAgreementPanelRootVariants>;

package/dist/types/components/legal-agreement/legal-agreement.stories-config.d.ts

@@ -0,0 +1,11 @@
+import { LegalAgreementDialogConfig } from './legal-agreement-dialog';
+import { LegalAgreementVisualTheme } from './legal-agreement-theme';
+export declare function createStoryPermissionlessLegalConfig(theme?: LegalAgreementVisualTheme): LegalAgreementDialogConfig;
+export declare function createStoryExtendedLegalConfig(theme?: LegalAgreementVisualTheme): LegalAgreementDialogConfig;
+export declare function createStoryRwaLegalConfig(theme?: LegalAgreementVisualTheme): LegalAgreementDialogConfig;
+/** Storybook-only sample config (single-checkbox flow). Not exported from ui-kit. */
+export declare const storyPermissionlessLegalConfig: LegalAgreementDialogConfig;
+/** Storybook-only sample config (three-checkbox flow). Not exported from ui-kit. */
+export declare const storyExtendedLegalConfig: LegalAgreementDialogConfig;
+/** Storybook-only RWA sample config. Not exported from ui-kit. */
+export declare const storyRwaLegalConfig: LegalAgreementDialogConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/ui-kit",
-  "version": "3.14.0-next.12",
+  "version": "3.14.0-next.14",
   "description": "Internal UI components",
   "repository": "https://github.com/gearbox-protocol/ui-kit",
   "license": "MIT",
@@ -54,6 +54,16 @@
       "types": "./dist/types/components/next/connectkit/index.d.ts",
       "import": "./dist/esm/components/next/connectkit/index.js",
       "default": "./dist/cjs/components/next/connectkit/index.cjs"
+    },
+    "./tx-preview": {
+      "types": "./dist/types/components/composites/tx-preview/index.d.ts",
+      "import": "./dist/esm/components/composites/tx-preview/index.js",
+      "default": "./dist/cjs/components/composites/tx-preview/index.cjs"
+    },
+    "./tx-preview/*": {
+      "types": "./dist/types/components/composites/tx-preview/*.d.ts",
+      "import": "./dist/esm/components/composites/tx-preview/*.js",
+      "default": "./dist/cjs/components/composites/tx-preview/*.cjs"
     }
   },
   "files": [
@@ -153,7 +163,7 @@
     "@commitlint/cli": "^20.1.0",
     "@commitlint/config-conventional": "^20.0.0",
     "@gearbox-protocol/biome-config": "^1.0.2",
-    "@gearbox-protocol/sdk": "14.8.5",
+    "@gearbox-protocol/sdk": "14.11.0-next.4",
     "@rollup/plugin-typescript": "^12.3.0",
     "@storybook/addon-a11y": "^10.0.8",
     "@storybook/addon-docs": "^10.0.8",