thirdweb 5.105.4 → 5.105.6-nightly-9f88b5c2beedd51730dbe4f2dfdd15e6bcb6e967-20250703000433

package/src/bridge/OnrampStatus.ts

@@ -1,5 +1,6 @@
 import type { Hex as ox__Hex } from "ox";
 import type { ThirdwebClient } from "../client/client.js";
+import type { PurchaseData } from "../pay/types.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
 import { ApiError } from "./types/Errors.js";
@@ -108,7 +109,7 @@ export declare namespace status {
           chainId: number;
           transactionHash: ox__Hex.Hex;
         }>;
-        purchaseData?: unknown;
+        purchaseData?: PurchaseData;
       }
     | {
         status: "PENDING";
@@ -116,7 +117,7 @@ export declare namespace status {
           chainId: number;
           transactionHash: ox__Hex.Hex;
         }>;
-        purchaseData?: unknown;
+        purchaseData?: PurchaseData;
       }
     | {
         status: "CREATED";
@@ -124,7 +125,7 @@ export declare namespace status {
           chainId: number;
           transactionHash: ox__Hex.Hex;
         }>;
-        purchaseData?: unknown;
+        purchaseData?: PurchaseData;
       }
     | {
         status: "FAILED";
@@ -132,6 +133,6 @@ export declare namespace status {
           chainId: number;
           transactionHash: ox__Hex.Hex;
         }>;
-        purchaseData?: unknown;
+        purchaseData?: PurchaseData;
       };
 }

package/src/bridge/Sell.ts

@@ -1,6 +1,7 @@
 import type { Address as ox__Address } from "ox";
 import { defineChain } from "../chains/utils.js";
 import type { ThirdwebClient } from "../client/client.js";
+import type { PurchaseData } from "../pay/types.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
 import { stringify } from "../utils/json.js";
@@ -402,7 +403,7 @@ export declare namespace prepare {
     sender: ox__Address.Address;
     receiver: ox__Address.Address;
     client: ThirdwebClient;
-    purchaseData?: unknown;
+    purchaseData?: PurchaseData;
     maxSteps?: number;
     /**
      * @hidden
@@ -419,7 +420,7 @@ export declare namespace prepare {
       amount: bigint;
       sender: ox__Address.Address;
       receiver: ox__Address.Address;
-      purchaseData?: unknown;
+      purchaseData?: PurchaseData;
     };
   };
 }

package/src/bridge/Transfer.ts

@@ -1,6 +1,7 @@
 import type { Address as ox__Address } from "ox";
 import { defineChain } from "../chains/utils.js";
 import type { ThirdwebClient } from "../client/client.js";
+import type { PurchaseData } from "../pay/types.js";
 import { getThirdwebBaseUrl } from "../utils/domains.js";
 import { getClientFetch } from "../utils/fetch.js";
 import { stringify } from "../utils/json.js";
@@ -258,7 +259,7 @@ export declare namespace prepare {
     receiver: ox__Address.Address;
     amount: bigint;
     client: ThirdwebClient;
-    purchaseData?: unknown;
+    purchaseData?: PurchaseData;
     feePayer?: "sender" | "receiver";
     /**
      * @hidden
@@ -273,7 +274,7 @@ export declare namespace prepare {
       amount: bigint;
       sender: ox__Address.Address;
       receiver: ox__Address.Address;
-      purchaseData?: unknown;
+      purchaseData?: PurchaseData;
       feePayer?: "sender" | "receiver";
     };
   };

package/src/bridge/types/Status.ts

@@ -1,4 +1,5 @@
 import type { Address as ox__Address, Hex as ox__Hex } from "ox";
+import type { PurchaseData } from "../../pay/types.js";
 import type { Token } from "./Token.js";
 export type Status =
   | {
@@ -18,7 +19,7 @@ export type Status =
         chainId: number;
         transactionHash: ox__Hex.Hex;
       }>;
-      purchaseData?: unknown;
+      purchaseData?: PurchaseData;
     }
   | {
       status: "PENDING";
@@ -36,7 +37,7 @@ export type Status =
         chainId: number;
         transactionHash: ox__Hex.Hex;
       }>;
-      purchaseData?: unknown;
+      purchaseData?: PurchaseData;
     }
   | {
       status: "FAILED";
@@ -45,7 +46,7 @@ export type Status =
         chainId: number;
         transactionHash: ox__Hex.Hex;
       }>;
-      purchaseData?: unknown;
+      purchaseData?: PurchaseData;
     }
   | {
       status: "NOT_FOUND";

package/src/chains/chain-definitions/core-mainnet.ts

@@ -0,0 +1,20 @@
+import { defineChain } from "../utils.js";
+
+/**
+ * @chain
+ */
+export const coreMainnet = /* @__PURE__ */ defineChain({
+  blockExplorers: [
+    {
+      name: "Core Scan",
+      url: "https://scan.coredao.org/",
+    },
+  ],
+  id: 1116,
+  name: "Core",
+  nativeCurrency: {
+    decimals: 18,
+    name: "Ether",
+    symbol: "ETH",
+  },
+});

package/src/chains/chain-definitions/core-testnet.ts

@@ -0,0 +1,21 @@
+import { defineChain } from "../utils.js";
+
+/**
+ * @chain
+ */
+export const coreTestnet = /* @__PURE__ */ defineChain({
+  blockExplorers: [
+    {
+      name: "Core Testnet Scan",
+      url: "https://scan.test2.btcs.network/",
+    },
+  ],
+  id: 1114,
+  name: "Core Testnet",
+  nativeCurrency: {
+    decimals: 18,
+    name: "Ether",
+    symbol: "ETH",
+  },
+  testnet: true,
+});

package/src/chains/chain-definitions/somniaTestnet.ts

@@ -0,0 +1,18 @@
+import { defineChain } from "../utils.js";
+
+/**
+ * @chain
+ */
+export const somniaTestnet = /*@__PURE__*/ defineChain({
+  blockExplorers: [
+    {
+      apiUrl: "https://shannon-explorer.somnia.network/api",
+      name: "Somnia Testnet Explorer",
+      url: "https://shannon-explorer.somnia.network/",
+    },
+  ],
+  id: 50312,
+  name: "Somnia Testnet",
+  nativeCurrency: { decimals: 18, name: "Somnia Testnet Token", symbol: "STT" },
+  testnet: true,
+});

package/src/exports/chains.ts

@@ -24,6 +24,8 @@ export { bsc } from "../chains/chain-definitions/bsc.js";
 export { bscTestnet } from "../chains/chain-definitions/bsc-testnet.js";
 export { celo } from "../chains/chain-definitions/celo.js";
 export { celoAlfajoresTestnet } from "../chains/chain-definitions/celo-alfajores-testnet.js";
+export { coreMainnet } from "../chains/chain-definitions/core-mainnet.js";
+export { coreTestnet } from "../chains/chain-definitions/core-testnet.js";
 export { cronos } from "../chains/chain-definitions/cronos.js";
 export { degen } from "../chains/chain-definitions/degen.js";
 // mainnet = alias for ethereum
@@ -68,6 +70,7 @@ export { scroll } from "../chains/chain-definitions/scroll.js";
 export { scrollAlphaTestnet } from "../chains/chain-definitions/scroll-alpha-testnet.js";
 export { scrollSepoliaTestnet } from "../chains/chain-definitions/scroll-sepolia-testnet.js";
 export { sepolia } from "../chains/chain-definitions/sepolia.js";
+export { somniaTestnet } from "../chains/chain-definitions/somniaTestnet.js";
 export { soneiumMinato } from "../chains/chain-definitions/soneium-minato.js";
 export { treasure } from "../chains/chain-definitions/treasure.js";
 export { treasureTopaz } from "../chains/chain-definitions/treasureTopaz.js";
@@ -78,6 +81,7 @@ export { zkSync } from "../chains/chain-definitions/zksync.js";
 export { zkSyncSepolia } from "../chains/chain-definitions/zksync-sepolia.js";
 export { zora } from "../chains/chain-definitions/zora.js";
 export { zoraSepolia } from "../chains/chain-definitions/zora-sepolia.js";
+
 export type { Chain, ChainMetadata, ChainOptions } from "../chains/types.js";
 // define chain, chainMetadata
 export {

package/src/extensions/erc7702/account/createSessionKey.ts

@@ -52,7 +52,7 @@ export type CreateSessionKeyOptions = {
  * @returns The transaction object to be sent.
  * @example
  * ```ts
- * import { createSessionKey } from 'thirdweb/extensions/7702';
+ * import { createSessionKey } from 'thirdweb/wallets/in-app';
  * import { sendTransaction } from 'thirdweb';
  *
  * const transaction = createSessionKey({

package/src/pay/buyWithCrypto/getQuote.ts

@@ -7,6 +7,7 @@ import { NATIVE_TOKEN_ADDRESS } from "../../constants/addresses.js";
 import { getContract } from "../../contract/contract.js";
 import { decimals } from "../../extensions/erc20/read/decimals.js";
 import type { PrepareTransactionOptions } from "../../transaction/prepare-transaction.js";
+import type { PurchaseData } from "../types.js";
 import type {
   QuoteApprovalInfo,
   QuotePaymentToken,
@@ -76,7 +77,7 @@ export type GetBuyWithCryptoQuoteParams = {
    *
    * This details will be stored with the purchase and can be retrieved later via the status API or Webhook
    */
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
 
   /**
    * The maximum slippage in basis points (bps) allowed for the swap.

package/src/pay/buyWithCrypto/getStatus.ts

@@ -3,6 +3,7 @@ import type { Token } from "../../bridge/types/Token.js";
 import type { ThirdwebClient } from "../../client/client.js";
 import type { Hex } from "../../utils/encoding/hex.js";
 import { toTokens } from "../../utils/units.js";
+import type { PurchaseData } from "../types.js";
 import type {
   PayOnChainTransactionDetails,
   PayTokenInfo,
@@ -80,7 +81,7 @@ export type BuyWithCryptoStatus =
       toAddress: string;
       failureMessage?: string;
       bridge?: string;
-      purchaseData?: object;
+      purchaseData?: PurchaseData;
     };
 
 export type ValidBuyWithCryptoStatus = Exclude<
@@ -162,7 +163,7 @@ export async function getBuyWithCryptoStatus(
           originTokenAddress: result.originTokenAddress,
           originTransaction,
           paymentId: result.paymentId,
-          purchaseData: result.purchaseData as object | undefined,
+          purchaseData: result.purchaseData,
           receiver: result.receiver,
           sender: result.sender,
           status: result.status,
@@ -178,7 +179,7 @@ export async function getBuyWithCryptoStatus(
           originToken: result.originToken,
           originTokenAddress: result.originTokenAddress,
           paymentId: result.paymentId,
-          purchaseData: result.purchaseData as object | undefined,
+          purchaseData: result.purchaseData,
           receiver: result.receiver,
           sender: result.sender,
           status: result.status,
@@ -202,7 +203,7 @@ export async function getBuyWithCryptoStatus(
           originTokenAddress: "",
           originTransaction,
           paymentId: "",
-          purchaseData: result.purchaseData as object | undefined,
+          purchaseData: result.purchaseData,
           receiver: "",
           sender: "",
           status: result.status,
@@ -230,7 +231,7 @@ function toBuyWithCryptoStatus(args: {
   originChainId: number;
   destinationChainId: number;
   status: Status["status"];
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
   sender: string;
   receiver: string;
   paymentId: string;
@@ -277,7 +278,7 @@ function toBuyWithCryptoStatus(args: {
       transactionHash: destinationTransaction?.transactionHash ?? "",
     },
     fromAddress: sender,
-    purchaseData: purchaseData as object | undefined, // TODO transfer type?
+    purchaseData: purchaseData,
     quote: {
       createdAt: new Date().toISOString(),
       estimated: {

package/src/pay/buyWithCrypto/getTransfer.ts

@@ -7,6 +7,7 @@ import { NATIVE_TOKEN_ADDRESS } from "../../constants/addresses.js";
 import { getContract } from "../../contract/contract.js";
 import { decimals } from "../../extensions/erc20/read/decimals.js";
 import type { PrepareTransactionOptions } from "../../transaction/prepare-transaction.js";
+import type { PurchaseData } from "../types.js";
 import type { QuoteApprovalInfo, QuotePaymentToken } from "./commonTypes.js";
 
 /**
@@ -54,7 +55,7 @@ export type GetBuyWithCryptoTransferParams = {
    *
    * This details will be stored with the purchase and can be retrieved later via the status API or Webhook
    */
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
 
   /**
    * For direct transfers, specify who will pay for the transfer fee. Can be "sender" or "receiver".

package/src/pay/buyWithFiat/getQuote.ts

@@ -6,6 +6,7 @@ import { getContract } from "../../contract/contract.js";
 import { decimals } from "../../extensions/erc20/read/decimals.js";
 import type { CurrencyMeta } from "../../react/web/ui/ConnectWallet/screens/Buy/fiat/currencies.js";
 import { toTokens, toUnits } from "../../utils/units.js";
+import type { PurchaseData } from "../types.js";
 import type { FiatProvider, PayTokenInfo } from "../utils/commonTypes.js";
 /**
  * Parameters for [`getBuyWithFiatQuote`](https://portal.thirdweb.com/references/typescript/v5/getBuyWithFiatQuote) function
@@ -80,7 +81,7 @@ export type GetBuyWithFiatQuoteParams = {
    *
    * This details will be stored with the purchase and can be retrieved later via the status API or Webhook
    */
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
 
   /**
    * Optional parameter to onramp gas with the purchase

package/src/pay/buyWithFiat/getStatus.ts

@@ -1,5 +1,6 @@
 import { status as onrampStatus } from "../../bridge/OnrampStatus.js";
 import type { ThirdwebClient } from "../../client/client.js";
+import type { PurchaseData } from "../types.js";
 import type {
   PayOnChainTransactionDetails,
   PayTokenInfo,
@@ -109,7 +110,7 @@ export type BuyWithFiatStatus =
       /**
        * Arbitrary data sent at the time of fetching the quote
        */
-      purchaseData?: object;
+      purchaseData?: PurchaseData;
     };
 
 /**
@@ -202,7 +203,7 @@ function buildPlaceholderStatus(args: {
     | "PENDING_PAYMENT"
     | "PAYMENT_FAILED"
     | "ON_RAMP_TRANSFER_COMPLETED";
-  purchaseData?: unknown;
+  purchaseData?: PurchaseData;
 }): BuyWithFiatStatus {
   const { intentId, status, purchaseData } = args;
 
@@ -253,7 +254,7 @@ function buildPlaceholderStatus(args: {
   const base: Exclude<BuyWithFiatStatus, { status: "NOT_FOUND" }> = {
     fromAddress: "",
     intentId,
-    purchaseData: purchaseData as object | undefined,
+    purchaseData,
     quote,
     status,
     toAddress: "",

package/src/pay/types.ts

@@ -0,0 +1 @@
+export type PurchaseData = Record<string, unknown>;

package/src/react/core/hooks/connection/ConnectButtonProps.ts

@@ -4,6 +4,7 @@ import type { ThirdwebClient } from "../../../../client/client.js";
 import type { BuyWithCryptoStatus } from "../../../../pay/buyWithCrypto/getStatus.js";
 import type { BuyWithFiatStatus } from "../../../../pay/buyWithFiat/getStatus.js";
 import type { SupportedFiatCurrency } from "../../../../pay/convert/type.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import type { FiatProvider } from "../../../../pay/utils/commonTypes.js";
 import type { AssetTabs } from "../../../../react/web/ui/ConnectWallet/screens/ViewAssets.js";
 import type { PreparedTransaction } from "../../../../transaction/prepare-transaction.js";
@@ -117,7 +118,7 @@ export type PayUIOptions = Prettify<
      *
      * This details will be stored with the purchase and can be retrieved later via the status API or Webhook
      */
-    purchaseData?: object;
+    purchaseData?: PurchaseData;
 
     /**
      * Callback to be called when the user successfully completes the purchase.

package/src/react/core/hooks/transaction/useSendTransaction.ts

@@ -6,6 +6,7 @@ import * as Bridge from "../../../../bridge/index.js";
 import type { Chain } from "../../../../chains/types.js";
 import type { BuyWithCryptoStatus } from "../../../../pay/buyWithCrypto/getStatus.js";
 import type { BuyWithFiatStatus } from "../../../../pay/buyWithFiat/getStatus.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import type { FiatProvider } from "../../../../pay/utils/commonTypes.js";
 import type { GaslessOptions } from "../../../../transaction/actions/gasless/types.js";
 import { sendTransaction } from "../../../../transaction/actions/send-transaction.js";
@@ -65,7 +66,7 @@ export type SendTransactionPayModalConfig =
             testMode?: boolean;
             preferredProvider?: FiatProvider;
           };
-      purchaseData?: object;
+      purchaseData?: PurchaseData;
       /**
        * Callback to be called when the user successfully completes the purchase.
        */

package/src/react/web/ui/Bridge/BridgeOrchestrator.tsx

@@ -2,6 +2,7 @@
 import { useCallback, useMemo } from "react";
 import type { Token } from "../../../../bridge/types/Token.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import type { PreparedTransaction } from "../../../../transaction/prepare-transaction.js";
 import type { Address } from "../../../../utils/address.js";
 import { webLocalStorage } from "../../../../utils/storage/webStorage.js";
@@ -102,7 +103,7 @@ export interface BridgeOrchestratorProps {
   /**
    * Optional purchase data for the payment
    */
-  purchaseData: object | undefined;
+  purchaseData?: PurchaseData;
 
   /**
    * Optional payment link ID for the payment

package/src/react/web/ui/Bridge/BuyWidget.tsx

@@ -7,6 +7,7 @@ import type { Chain } from "../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../constants/addresses.js";
 import { getToken } from "../../../../pay/convert/get-token.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import {
   type Address,
   checksumAddress,
@@ -139,7 +140,7 @@ export type BuyWidgetProps = {
   /**
    * Arbitrary data to be included in the returned status and webhook events.
    */
-  purchaseData?: Record<string, unknown>;
+  purchaseData?: PurchaseData;
 
   /**
    * Callback triggered when the purchase is successful.

package/src/react/web/ui/Bridge/CheckoutWidget.tsx

@@ -7,6 +7,7 @@ import type { Chain } from "../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../constants/addresses.js";
 import { getToken } from "../../../../pay/convert/get-token.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import { type Address, checksumAddress } from "../../../../utils/address.js";
 import { stringify } from "../../../../utils/json.js";
 import type { Wallet } from "../../../../wallets/interfaces/wallet.js";
@@ -145,7 +146,7 @@ export type CheckoutWidgetProps = {
   /**
    * Arbitrary data to be included in the returned status and webhook events.
    */
-  purchaseData?: Record<string, unknown>;
+  purchaseData?: PurchaseData;
 
   /**
    * Callback triggered when the purchase is successful.

package/src/react/web/ui/Bridge/FundWallet.tsx

@@ -3,6 +3,7 @@ import { useRef, useState } from "react";
 import type { Token } from "../../../../bridge/types/Token.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import { type Address, getAddress } from "../../../../utils/address.js";
+import { numberToPlainString } from "../../../../utils/formatNumber.js";
 import { useCustomTheme } from "../../../core/design-system/CustomThemeProvider.js";
 import {
   fontSize,
@@ -112,9 +113,9 @@ export function FundWallet({
     // Convert USD amount to token amount using token price
     const tokenAmount = usdAmount / uiOptions.destinationToken.priceUsd;
     // Format to reasonable decimal places (up to 6 decimals, remove trailing zeros)
-    const formattedAmount = Number.parseFloat(
-      tokenAmount.toFixed(6),
-    ).toString();
+    const formattedAmount = numberToPlainString(
+      Number.parseFloat(tokenAmount.toFixed(6)),
+    );
     setAmount(formattedAmount);
   };
 

package/src/react/web/ui/Bridge/QuoteLoader.tsx

@@ -4,6 +4,7 @@ import { useEffect } from "react";
 import { trackPayEvent } from "../../../../analytics/track/pay.js";
 import type { Token } from "../../../../bridge/types/Token.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import { toUnits } from "../../../../utils/units.js";
 import {
   type BridgePrepareRequest,
@@ -69,7 +70,7 @@ interface QuoteLoaderProps {
   /**
    * Optional purchase data for the payment
    */
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
 
   /**
    * Optional payment link ID for the payment
@@ -175,7 +176,7 @@ function getBridgeParams(args: {
   client: ThirdwebClient;
   sender?: string;
   feePayer?: "sender" | "receiver";
-  purchaseData?: object;
+  purchaseData?: PurchaseData;
   paymentLinkId?: string;
 }): UseBridgePrepareParams {
   const { paymentMethod, amount, destinationToken, receiver, client, sender } =

package/src/react/web/ui/Bridge/TransactionWidget.tsx

@@ -7,6 +7,7 @@ import type { Chain } from "../../../../chains/types.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import { NATIVE_TOKEN_ADDRESS } from "../../../../constants/addresses.js";
 import { getToken } from "../../../../pay/convert/get-token.js";
+import type { PurchaseData } from "../../../../pay/types.js";
 import {
   type PreparedTransaction,
   prepareTransaction,
@@ -143,7 +144,7 @@ export type TransactionWidgetProps = {
   /**
    * Arbitrary data to be included in the returned status and webhook events.
    */
-  purchaseData?: Record<string, unknown>;
+  purchaseData?: PurchaseData;
 
   /**
    * Callback triggered when the purchase is successful.

package/src/react/web/ui/Bridge/common/TokenAndChain.tsx

@@ -138,10 +138,10 @@ function TokenIconWithFallback(props: {
         border: `1px solid ${theme.colors.borderColor}`,
         borderRadius: "50%",
         display: "flex",
-        height: `${iconSize.md}px`,
+        height: `${iconSize[props.size]}px`,
         justifyContent: "center",
         padding: spacing.xs,
-        width: `${iconSize.md}px`,
+        width: `${iconSize[props.size]}px`,
       }}
     >
       <Text

package/src/react/web/ui/PayEmbed.tsx

@@ -363,6 +363,7 @@ export function PayEmbed(props: PayEmbedProps) {
               ? ["card"]
               : ["crypto", "card"]
         }
+        purchaseData={props.payOptions?.purchaseData}
         theme={theme}
         title={metadata?.name || "Buy"}
         tokenAddress={
@@ -387,6 +388,7 @@ export function PayEmbed(props: PayEmbedProps) {
             ? ["crypto"]
             : ["crypto", "card"]
         }
+        purchaseData={props.payOptions?.purchaseData}
         seller={props.payOptions.paymentInfo.sellerAddress as Address}
         theme={theme}
         tokenAddress={
@@ -408,6 +410,7 @@ export function PayEmbed(props: PayEmbedProps) {
             ? ["crypto"]
             : ["crypto", "card"]
         }
+        purchaseData={props.payOptions?.purchaseData}
         theme={theme}
         title={metadata?.name}
         transaction={props.payOptions.transaction}

package/src/utils/format-number.test.ts

@@ -1,5 +1,5 @@
 import { expect, test } from "vitest";
-import { formatNumber } from "./formatNumber.js";
+import { formatNumber, numberToPlainString } from "./formatNumber.js";
 
 test("formatNumber", () => {
   // no decimals
@@ -27,3 +27,52 @@ test("formatNumber", () => {
   expect(formatNumber(0.00000000000009, 3)).toEqual(0.001);
   expect(formatNumber(0.00000000000001, 3)).toEqual(0.001);
 });
+
+test("numberToPlainString", () => {
+  // Numbers without exponential notation (should return as-is)
+  expect(numberToPlainString(123)).toEqual("123");
+  expect(numberToPlainString(0.123)).toEqual("0.123");
+  expect(numberToPlainString(0)).toEqual("0");
+  expect(numberToPlainString(-456)).toEqual("-456");
+  expect(numberToPlainString(-0.789)).toEqual("-0.789");
+
+  // Small numbers with negative exponents
+  expect(numberToPlainString(1e-1)).toEqual("0.1");
+  expect(numberToPlainString(1e-2)).toEqual("0.01");
+  expect(numberToPlainString(1e-3)).toEqual("0.001");
+  expect(numberToPlainString(1.23e-4)).toEqual("0.000123");
+  expect(numberToPlainString(1.2345e-6)).toEqual("0.0000012345");
+  expect(numberToPlainString(5e-10)).toEqual("0.0000000005");
+  expect(numberToPlainString(-5e-10)).toEqual("-0.0000000005");
+
+  // Large numbers with positive exponents - zerosNeeded >= 0
+  expect(numberToPlainString(1e1)).toEqual("10");
+  expect(numberToPlainString(1e2)).toEqual("100");
+  expect(numberToPlainString(1.23e3)).toEqual("1230");
+  expect(numberToPlainString(1.23e5)).toEqual("123000");
+  expect(numberToPlainString(5.67e10)).toEqual("56700000000");
+
+  // Large numbers with positive exponents - zerosNeeded < 0 (decimal point insertion)
+  expect(numberToPlainString(1.2345e2)).toEqual("123.45");
+  expect(numberToPlainString(1.23e1)).toEqual("12.3");
+  expect(numberToPlainString(9.876e2)).toEqual("987.6");
+  expect(numberToPlainString(1.23456e3)).toEqual("1234.56");
+  expect(numberToPlainString(5.4321e1)).toEqual("54.321");
+
+  // Edge cases where exponent equals decimal length
+  expect(numberToPlainString(1.23e2)).toEqual("123");
+  expect(numberToPlainString(1.234e3)).toEqual("1234");
+
+  // Negative numbers
+  expect(numberToPlainString(-1.2345e2)).toEqual("-123.45");
+  expect(numberToPlainString(-1.23e-4)).toEqual("-0.000123");
+
+  // Very large numbers (JavaScript precision limits apply)
+  expect(numberToPlainString(1.0523871386385944e21)).toEqual(
+    "1052387138638594400000",
+  );
+
+  // Numbers that would normally show exponential notation
+  expect(numberToPlainString(0.0000001)).toEqual("0.0000001");
+  expect(numberToPlainString(10000000)).toEqual("10000000");
+});