@openocean.finance/widget 1.0.4 → 1.0.8

package/dist/esm/types/widget.d.ts

@@ -0,0 +1,227 @@
+import type { Components, PaletteMode, PaletteOptions, Shape, SxProps, Theme } from '@mui/material';
+import type { TypographyOptions } from '@mui/material/styles/createTypography.js';
+import type { BaseToken, ChainType, ContractCall, Order, RouteOptions, SDKConfig, StaticToken, Token } from '@openocean.finance/widget-sdk';
+import type { CSSProperties, MutableRefObject, ReactNode, RefObject } from 'react';
+import type { CoinbaseWalletParameters, MetaMaskParameters, WalletConnectParameters } from 'wagmi/connectors';
+import type { LanguageKey, LanguageResources } from '../providers/I18nProvider/types.js';
+import type { DefaultFieldValues } from '../stores/form/types.js';
+export type WidgetVariant = 'compact' | 'wide' | 'drawer';
+export type WidgetSubvariant = 'default' | 'split' | 'custom' | 'refuel';
+export type SplitSubvariant = 'bridge' | 'swap';
+export type CustomSubvariant = 'checkout' | 'deposit';
+export interface SubvariantOptions {
+    split?: SplitSubvariant;
+    custom?: CustomSubvariant;
+}
+export type Appearance = PaletteMode | 'auto';
+export interface NavigationProps {
+    /**
+     * If given, uses a negative margin to counteract the padding on sides for navigation elements like icon buttons.
+     * @default true
+     */
+    edge?: boolean;
+}
+export type WidgetThemeComponents = Pick<Components<Theme>, 'MuiAppBar' | 'MuiAvatar' | 'MuiButton' | 'MuiCard' | 'MuiIconButton' | 'MuiInputCard' | 'MuiTabs' | 'MuiTypography'>;
+export type WidgetTheme = {
+    palette?: Pick<PaletteOptions, 'background' | 'grey' | 'primary' | 'secondary' | 'text'>;
+    shape?: Partial<Shape>;
+    typography?: TypographyOptions;
+    components?: WidgetThemeComponents;
+    container?: CSSProperties;
+    header?: CSSProperties;
+    playground?: CSSProperties;
+    navigation?: NavigationProps;
+};
+export declare enum DisabledUI {
+    FromAmount = "fromAmount",
+    FromToken = "fromToken",
+    ToAddress = "toAddress",
+    ToToken = "toToken"
+}
+export type DisabledUIType = `${DisabledUI}`;
+export declare enum HiddenUI {
+    Appearance = "appearance",
+    DrawerCloseButton = "drawerCloseButton",
+    History = "history",
+    Language = "language",
+    PoweredBy = "poweredBy",
+    ToAddress = "toAddress",
+    ToToken = "toToken",
+    WalletMenu = "walletMenu",
+    IntegratorStepDetails = "integratorStepDetails",
+    ReverseTokensButton = "reverseTokensButton",
+    RouteTokenDescription = "routeTokenDescription"
+}
+export type HiddenUIType = `${HiddenUI}`;
+export declare enum RequiredUI {
+    ToAddress = "toAddress"
+}
+export type RequiredUIType = `${RequiredUI}`;
+export interface WidgetWalletConfig {
+    onConnect?(): void;
+    walletConnect?: WalletConnectParameters;
+    coinbase?: CoinbaseWalletParameters;
+    metaMask?: MetaMaskParameters;
+    /**
+     * Determines whether the widget should provide partial wallet management functionality.
+     *
+     * In partial mode, external wallet management will be used for "opt-out" providers,
+     * while the internal management is applied for any remaining providers that do not opt out.
+     * This allows a flexible balance between the integrator's custom wallet menu and the widget's native wallet menu.
+     * @default false
+     */
+    usePartialWalletManagement?: boolean;
+}
+export interface WidgetSDKConfig extends Omit<SDKConfig, 'apiKey' | 'disableVersionCheck' | 'integrator' | 'routeOptions' | 'widgetVersion'> {
+    routeOptions?: Omit<RouteOptions, 'bridges' | 'exchanges'>;
+}
+export interface WidgetContractTool {
+    name: string;
+    logoURI: string;
+}
+export interface CalculateFeeParams {
+    fromChainId: number;
+    toChainId: number;
+    fromTokenAddress: string;
+    toTokenAddress: string;
+    fromAddress?: string;
+    toAddress?: string;
+    fromAmount?: bigint;
+    toAmount?: bigint;
+    slippage?: number;
+}
+export interface WidgetFeeConfig {
+    name?: string;
+    logoURI?: string;
+    fee?: number;
+    /**
+     * Function to calculate fees before fetching quotes.
+     * If provided, this function will be used instead of the `fee` parameter.
+     * Only one of `fee` or `calculateFee` should be used.
+     *
+     * @param params Object containing the fee calculation parameters
+     * @returns A promise that resolves to the calculated fee as a number (e.g., 0.03 represents a 3% fee)
+     */
+    calculateFee?(params: CalculateFeeParams): Promise<number | undefined>;
+}
+export interface ToAddress {
+    name?: string;
+    address: string;
+    chainType: ChainType;
+    logoURI?: string;
+}
+export interface AllowDeny<T> {
+    allow?: T[];
+    deny?: T[];
+}
+export type WidgetChains = {
+    from?: AllowDeny<number>;
+    to?: AllowDeny<number>;
+    types?: AllowDeny<ChainType>;
+} & AllowDeny<number>;
+export type WidgetTokens = {
+    featured?: StaticToken[];
+    include?: Token[];
+    popular?: StaticToken[];
+} & AllowDeny<BaseToken>;
+export type WidgetLanguages = {
+    default?: LanguageKey;
+} & AllowDeny<LanguageKey>;
+export type PoweredByType = 'default' | 'jumper';
+export interface RouteLabel {
+    text: string;
+    sx?: SxProps<Theme>;
+}
+export interface RouteLabelRule {
+    label: RouteLabel;
+    bridges?: AllowDeny<string>;
+    exchanges?: AllowDeny<string>;
+    fromChainId?: number[];
+    toChainId?: number[];
+    fromTokenAddress?: string[];
+    toTokenAddress?: string[];
+}
+export interface WidgetConfig {
+    fromChain?: number;
+    toChain?: number;
+    fromToken?: string;
+    toToken?: string;
+    toAddress?: ToAddress;
+    toAddresses?: ToAddress[];
+    fromAmount?: number | string;
+    toAmount?: number | string;
+    formUpdateKey?: string;
+    contractCalls?: ContractCall[];
+    contractComponent?: ReactNode;
+    contractSecondaryComponent?: ReactNode;
+    contractCompactComponent?: ReactNode;
+    contractTool?: WidgetContractTool;
+    integrator: string;
+    apiKey?: string;
+    fee?: number;
+    feeConfig?: WidgetFeeConfig;
+    referrer?: {
+        address: string;
+        fee: string;
+    };
+    routePriority?: Order;
+    slippage?: number;
+    variant?: WidgetVariant;
+    subvariant?: WidgetSubvariant;
+    subvariantOptions?: SubvariantOptions;
+    appearance?: Appearance;
+    theme?: WidgetTheme;
+    disabledUI?: DisabledUIType[];
+    hiddenUI?: HiddenUIType[];
+    requiredUI?: RequiredUIType[];
+    useRecommendedRoute?: boolean;
+    useRelayerRoutes?: boolean;
+    walletConfig?: WidgetWalletConfig;
+    sdkConfig?: WidgetSDKConfig;
+    buildUrl?: boolean;
+    keyPrefix?: string;
+    bridges?: AllowDeny<string>;
+    exchanges?: AllowDeny<string>;
+    chains?: WidgetChains;
+    tokens?: WidgetTokens;
+    languages?: WidgetLanguages;
+    languageResources?: LanguageResources;
+    explorerUrls?: Record<number, string[]> & Partial<Record<'internal', string[]>>;
+    poweredBy?: PoweredByType;
+    /**
+     * Custom labels/badges to show on routes based on specified rules
+     */
+    routeLabels?: RouteLabelRule[];
+}
+export interface FormFieldOptions {
+    setUrlSearchParam: boolean;
+}
+export interface FieldValues extends Omit<DefaultFieldValues, 'fromAmount' | 'toAmount' | 'toAddress'> {
+    fromAmount?: number | string;
+    toAmount?: number | string;
+    toAddress?: ToAddress | string;
+}
+export type FieldNames = keyof FieldValues;
+export type SetFieldValueFunction = <K extends FieldNames>(key: K, value: FieldValues[K], options?: FormFieldOptions) => void;
+export type FormState = {
+    setFieldValue: SetFieldValueFunction;
+};
+export type FormRef = MutableRefObject<FormState | null>;
+export interface FormRefProps {
+    formRef?: FormRef;
+}
+export interface WidgetConfigProps extends FormRefProps {
+    config: WidgetConfig;
+}
+export interface WidgetConfigPartialProps {
+    config?: Partial<WidgetConfig>;
+}
+export type WidgetProps = WidgetDrawerProps & WidgetConfig & WidgetConfigPartialProps & FormRefProps;
+export interface WidgetDrawerProps extends WidgetConfigPartialProps {
+    elementRef?: RefObject<HTMLDivElement>;
+    open?: boolean;
+    /**
+     * Make sure to make the onClose callback stable (e.g. using useCallback) to avoid causing re-renders of the entire widget
+     */
+    onClose?(): void;
+}

package/dist/esm/types/widget.js

@@ -0,0 +1,26 @@
+export var DisabledUI;
+(function (DisabledUI) {
+    DisabledUI["FromAmount"] = "fromAmount";
+    DisabledUI["FromToken"] = "fromToken";
+    DisabledUI["ToAddress"] = "toAddress";
+    DisabledUI["ToToken"] = "toToken";
+})(DisabledUI || (DisabledUI = {}));
+export var HiddenUI;
+(function (HiddenUI) {
+    HiddenUI["Appearance"] = "appearance";
+    HiddenUI["DrawerCloseButton"] = "drawerCloseButton";
+    HiddenUI["History"] = "history";
+    HiddenUI["Language"] = "language";
+    HiddenUI["PoweredBy"] = "poweredBy";
+    HiddenUI["ToAddress"] = "toAddress";
+    HiddenUI["ToToken"] = "toToken";
+    HiddenUI["WalletMenu"] = "walletMenu";
+    HiddenUI["IntegratorStepDetails"] = "integratorStepDetails";
+    HiddenUI["ReverseTokensButton"] = "reverseTokensButton";
+    HiddenUI["RouteTokenDescription"] = "routeTokenDescription";
+})(HiddenUI || (HiddenUI = {}));
+export var RequiredUI;
+(function (RequiredUI) {
+    RequiredUI["ToAddress"] = "toAddress";
+})(RequiredUI || (RequiredUI = {}));
+//# sourceMappingURL=widget.js.map

package/dist/esm/types/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../../src/types/widget.ts"],"names":[],"mappings":"AA+EA,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,uCAAyB,CAAA;IACzB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,iCAAmB,CAAA;AACrB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAGD,MAAM,CAAN,IAAY,QAYX;AAZD,WAAY,QAAQ;IAClB,qCAAyB,CAAA;IACzB,mDAAuC,CAAA;IACvC,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;IACnB,qCAAyB,CAAA;IACzB,2DAA+C,CAAA;IAC/C,uDAA2C,CAAA;IAC3C,2DAA+C,CAAA;AACjD,CAAC,EAZW,QAAQ,KAAR,QAAQ,QAYnB;AAGD,MAAM,CAAN,IAAY,UAEX;AAFD,WAAY,UAAU;IACpB,qCAAuB,CAAA;AACzB,CAAC,EAFW,UAAU,KAAV,UAAU,QAErB"}

package/dist/esm/utils/chainType.d.ts

@@ -0,0 +1,8 @@
+import { ChainId, ChainType } from '@openocean.finance/widget-sdk';
+export declare const getChainTypeFromAddress: (address: string) => ChainType | undefined;
+export declare const defaultChainIdsByType: {
+    EVM: ChainId;
+    SVM: ChainId;
+    UTXO: ChainId;
+    MVM: ChainId;
+};

package/dist/esm/utils/chainType.js

@@ -0,0 +1,24 @@
+import { isUTXOAddress } from '@bigmi/core';
+import { ChainId, ChainType, isSVMAddress } from '@openocean.finance/widget-sdk';
+import { isAddress as isEVMAddress } from 'viem';
+const chainTypeAddressValidation = {
+    [ChainType.EVM]: isEVMAddress,
+    [ChainType.SVM]: isSVMAddress,
+    [ChainType.UTXO]: isUTXOAddress,
+    [ChainType.MVM]: () => false,
+};
+export const getChainTypeFromAddress = (address) => {
+    for (const chainType in chainTypeAddressValidation) {
+        const isChainType = chainTypeAddressValidation[chainType](address);
+        if (isChainType) {
+            return chainType;
+        }
+    }
+};
+export const defaultChainIdsByType = {
+    [ChainType.EVM]: ChainId.ETH,
+    [ChainType.SVM]: ChainId.SOL,
+    [ChainType.UTXO]: ChainId.BTC,
+    [ChainType.MVM]: ChainId.SUI,
+};
+//# sourceMappingURL=chainType.js.map

package/dist/esm/utils/chainType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainType.js","sourceRoot":"","sources":["../../../src/utils/chainType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAChF,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,MAAM,MAAM,CAAA;AAEhD,MAAM,0BAA0B,GAAG;IACjC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY;IAC7B,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,YAAY;IAC7B,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,aAAa;IAC/B,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,OAAe,EACQ,EAAE;IACzB,KAAK,MAAM,SAAS,IAAI,0BAA0B,EAAE,CAAC;QACnD,MAAM,WAAW,GACf,0BAA0B,CAAC,SAAsB,CAAC,CAAC,OAAO,CAAC,CAAA;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,SAAsB,CAAA;QAC/B,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5B,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5B,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG;IAC7B,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG;CAC7B,CAAA"}

package/dist/esm/utils/colors.d.ts

@@ -0,0 +1,15 @@
+import type { Theme } from '@mui/material';
+export declare const getContrastAlphaColor: (theme: Theme, value: number) => string;
+export declare const getWarningBackgroundColor: (theme: Theme) => string;
+export declare const getInfoBackgroundColor: (theme: Theme) => string;
+/**
+ * https://github.com/mui/material-ui/blob/next/packages/mui-system/src/colorManipulator/colorManipulator.js
+ * Blend a transparent overlay color with a background color, resulting in a single
+ * RGB color.
+ * Remove in favor of MUI one once the next major version is released.
+ * @param {string} background - CSS color
+ * @param {string} overlay - CSS color
+ * @param {number} opacity - Opacity multiplier in the range 0 - 1
+ * @param {number} [gamma=1.0] - Gamma correction factor. For gamma-correct blending, 2.2 is usual.
+ */
+export declare function blend(background: string, overlay: string, opacity: number, gamma?: number): string;

package/dist/esm/utils/colors.js

@@ -0,0 +1,35 @@
+import { alpha, decomposeColor, recomposeColor } from '@mui/material';
+export const getContrastAlphaColor = (theme, value) => theme.palette.mode === 'light'
+    ? alpha(theme.palette.common.black, value)
+    : alpha(theme.palette.common.white, value);
+export const getWarningBackgroundColor = (theme) => theme.palette.mode === 'light'
+    ? alpha(theme.palette.warning.main, 0.32)
+    : alpha(theme.palette.warning.main, 0.16);
+export const getInfoBackgroundColor = (theme) => theme.palette.mode === 'light'
+    ? alpha(theme.palette.info.main, 0.12)
+    : alpha(theme.palette.info.main, 0.16);
+/**
+ * https://github.com/mui/material-ui/blob/next/packages/mui-system/src/colorManipulator/colorManipulator.js
+ * Blend a transparent overlay color with a background color, resulting in a single
+ * RGB color.
+ * Remove in favor of MUI one once the next major version is released.
+ * @param {string} background - CSS color
+ * @param {string} overlay - CSS color
+ * @param {number} opacity - Opacity multiplier in the range 0 - 1
+ * @param {number} [gamma=1.0] - Gamma correction factor. For gamma-correct blending, 2.2 is usual.
+ */
+export function blend(background, overlay, opacity, gamma = 1.0) {
+    const blendChannel = (b, o) => Math.round((b ** (1 / gamma) * (1 - opacity) + o ** (1 / gamma) * opacity) ** gamma);
+    const backgroundColor = decomposeColor(background);
+    const overlayColor = decomposeColor(overlay);
+    const rgb = [
+        blendChannel(backgroundColor.values[0], overlayColor.values[0]),
+        blendChannel(backgroundColor.values[1], overlayColor.values[1]),
+        blendChannel(backgroundColor.values[2], overlayColor.values[2]),
+    ];
+    return recomposeColor({
+        type: 'rgb',
+        values: rgb,
+    });
+}
+//# sourceMappingURL=colors.js.map

package/dist/esm/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAErE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAY,EAAE,KAAa,EAAE,EAAE,CACnE,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;IAC5B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;IAC1C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAE9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAY,EAAE,EAAE,CACxD,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;IAC5B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IACzC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAY,EAAE,EAAE,CACrD,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;IAC5B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IACtC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAE1C;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CACnB,UAAkB,EAClB,OAAe,EACf,OAAe,EACf,KAAK,GAAG,GAAG;IAEX,MAAM,YAAY,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAC5C,IAAI,CAAC,KAAK,CACR,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,CACzE,CAAA;IAEH,MAAM,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IAClD,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAE5C,MAAM,GAAG,GAA6B;QACpC,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAChE,CAAA;IAED,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,GAAG;KACZ,CAAC,CAAA;AACJ,CAAC"}

package/dist/esm/utils/compactNumberFormatter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formats numbers with special handling for small decimal values, converting runs of leading zeros
+ * into a more compact subscript notation.
+ *
+ * @param value - The numeric value to format (expected to be a string representing a BigInt)
+ * @param lng - The locale string for number formatting
+ * @param options - Formatting options including decimals and Intl.NumberFormat options
+ * @returns A formatted string with subscript notation for leading zeros
+ */
+export declare const compactNumberFormatter: (lng: string | undefined, options: any) => (value: any) => string;

package/dist/esm/utils/compactNumberFormatter.js

@@ -0,0 +1,81 @@
+/**
+ * Converts a non-negative integer to its subscript representation using Unicode subscript characters.
+ * @param n - The number to convert to subscript
+ * @returns A string where each digit is converted to its subscript equivalent
+ * @example
+ * toSubscript(5) => '₅'
+ * toSubscript(10) => '₁₀'
+ */
+function toSubscript(n) {
+    return n
+        .toString()
+        .split('')
+        .map((digit) => String.fromCharCode(8320 + Number(digit)))
+        .join('');
+}
+/**
+ * Formats numbers with special handling for small decimal values, converting runs of leading zeros
+ * into a more compact subscript notation.
+ *
+ * @param value - The numeric value to format (expected to be a string representing a BigInt)
+ * @param lng - The locale string for number formatting
+ * @param options - Formatting options including decimals and Intl.NumberFormat options
+ * @returns A formatted string with subscript notation for leading zeros
+ */
+export const compactNumberFormatter = (lng, options) => {
+    const formatter = new Intl.NumberFormat(lng, {
+        notation: 'standard',
+        roundingPriority: 'morePrecision',
+        maximumSignificantDigits: 21,
+        maximumFractionDigits: 21,
+        ...options,
+    });
+    return (value) => {
+        if (!Number.parseFloat(value) || Number.isNaN(Number(value))) {
+            return '0';
+        }
+        const parts = formatter.formatToParts(value);
+        let integerPart = '';
+        let fractionPart = '';
+        let decimalSeparator = '';
+        let minusSign = '';
+        for (const p of parts) {
+            switch (p.type) {
+                case 'integer':
+                case 'group':
+                    integerPart += p.value;
+                    break;
+                case 'fraction':
+                    fractionPart += p.value;
+                    break;
+                case 'decimal':
+                    decimalSeparator = p.value;
+                    break;
+                case 'minusSign':
+                    minusSign = p.value;
+                    break;
+            }
+        }
+        // For numbers with no decimal part, return early
+        if (!fractionPart) {
+            return `${minusSign}${integerPart}`;
+        }
+        // Count consecutive leading zeros in the fraction part
+        const match = fractionPart.match(/^0+/);
+        const leadingZerosCount = match ? match[0].length : 0;
+        // For numbers with few leading zeros (≤ 3), format normally
+        // but limit the total length and trim trailing zeros
+        if (leadingZerosCount <= 3) {
+            fractionPart = fractionPart.slice(0, 6).replace(/0+$/, '');
+            return `${minusSign}${integerPart}${decimalSeparator}${fractionPart}`;
+        }
+        // For numbers with many leading zeros (> 3), use subscript notation
+        // Format: "0.0₍number_of_zeros₎significant_digits"
+        const zerosSubscript = toSubscript(leadingZerosCount);
+        const remainder = fractionPart
+            .slice(leadingZerosCount, leadingZerosCount + 4)
+            .replace(/0+$/, '');
+        return `${minusSign}${integerPart}${decimalSeparator}0${zerosSubscript}${remainder}`;
+    };
+};
+//# sourceMappingURL=compactNumberFormatter.js.map

package/dist/esm/utils/compactNumberFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactNumberFormatter.js","sourceRoot":"","sources":["../../../src/utils/compactNumberFormatter.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/compactNumberFormatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/utils/compactNumberFormatter.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest';
+import { compactNumberFormatter } from './compactNumberFormatter.js';
+describe('Compact Number Formatter', () => {
+    describe('basic formatting', () => {
+        const testCases = [
+            { input: '0.123456789', expected: '0.123456' },
+            { input: '0.0123456', expected: '0.012345' },
+            { input: '0.00123456', expected: '0.001234' },
+            { input: '0.000123456', expected: '0.000123' },
+            { input: '0.06942', expected: '0.06942' },
+            { input: '0.006942', expected: '0.006942' },
+            { input: '0.0006942', expected: '0.000694' },
+            { input: '0.00006942', expected: '0.0₄6942' },
+            { input: '0.00000123456', expected: '0.0₅1234' },
+            { input: '0.000006942', expected: '0.0₅6942' },
+            { input: '0.00000000001', expected: '0.0₁₀1' },
+            { input: '0.00000006942', expected: '0.0₇6942' },
+            { input: '0.0000000694269', expected: '0.0₇6942' },
+            { input: '0.0000000694069', expected: '0.0₇694' },
+            { input: '0.000000006942', expected: '0.0₈6942' },
+            {
+                input: '0.000000000000006942',
+                expected: '0.0₁₄6942',
+            },
+            { input: '-0.0000042', expected: '-0.0₅42' },
+            { input: '-0.000000042', expected: '-0.0₇42' },
+            { input: '1.0000000042', expected: '1.0₈42' },
+            { input: '123456789.00042', expected: '123456789.00042' },
+            {
+                input: '123456789.000042',
+                expected: '123456789.0₄42',
+            },
+            {
+                input: '123456789.0000042',
+                expected: '123456789.0₅42',
+            },
+            { input: '1234567.000000042', expected: '1234567.0₇42' },
+            {
+                input: '1234567.000000042',
+                expected: '1,234,567.0₇42',
+                lng: 'en',
+                useGrouping: true,
+            },
+            {
+                input: '1234567.987654321',
+                expected: '1,234,567.987654',
+                lng: 'en',
+                useGrouping: true,
+            },
+            {
+                input: '1234567.000000042',
+                expected: '1.234.567,0₇42',
+                lng: 'de',
+                useGrouping: true,
+            },
+        ];
+        testCases.forEach(({ input, expected, lng, useGrouping = false }) => {
+            it(`should format ${input} correctly`, () => {
+                expect(compactNumberFormatter(lng, { useGrouping })(input)).toBe(expected);
+            });
+        });
+    });
+});
+//# sourceMappingURL=compactNumberFormatter.test.js.map

package/dist/esm/utils/compactNumberFormatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactNumberFormatter.test.js","sourceRoot":"","sources":["../../../src/utils/compactNumberFormatter.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/converters.d.ts

@@ -0,0 +1,3 @@
+import type { FullStatusData, ToolsResponse } from '@openocean.finance/widget-sdk';
+import type { RouteExecution } from '../stores/routes/types.js';
+export declare const buildRouteFromTxHistory: (tx: FullStatusData, tools?: ToolsResponse) => RouteExecution;