@thenamespace/ens-components 1.3.1 → 1.5.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import * as _thenamespace_offchain_manager from '@thenamespace/offchain-manager'
 import { ChainName as ChainName$2, OffchainClient } from '@thenamespace/offchain-manager';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
+import { UploadResult } from '@thenamespace/avatar';
 
 interface EnsRecords$1 {
     addresses: EnsAddressRecord$1[];
@@ -172,6 +173,45 @@ declare const yearsFromSeconds: (seconds: number) => number;
  */
 declare const formatDurationSummary: (durationSeconds: number) => string;
 
+/**
+ * Pure helpers for formatting ETH/USD pricing in the registration UI.
+ *
+ * Display rules:
+ *  - ETH is rendered at a fixed 4 decimals.
+ *  - Non-zero values smaller than 0.0001 ETH render as the literal "<0.0001"
+ *    so cheap-gas rows stay informative without claiming a misleading exact
+ *    figure. The USD subtitle is derived from wei (when available) so it
+ *    stays numerically honest even when the ETH cell is rounded.
+ *  - "Free" and "N/A" are sentinel strings — they bypass formatting and
+ *    suppress the USD subtitle.
+ */
+declare const ETH_SENTINELS: readonly ["Free", "N/A"];
+type EthSentinel = (typeof ETH_SENTINELS)[number];
+declare const isSentinel: (amount: number | string) => amount is EthSentinel;
+/**
+ * Format an ETH amount for display at a fixed 4 decimals.
+ *
+ * Any positive value below the 4-decimal threshold renders as the literal
+ * "<0.0001" — honest about the rounding direction, and (crucially) avoids
+ * the misleading 1:1 read against the wei-derived USD subtitle when the
+ * true amount is much smaller than 0.0001 ETH.
+ */
+declare const formatEth: (eth: number) => string;
+/**
+ * Convert wei → USD. Note the `Number(bigint)` cast loses exactness above
+ * 2^53 wei (~0.009 ETH); the resulting error is < 1e-7 relative, which is
+ * invisible after `.toFixed(2)` for any realistic ENS registration total.
+ */
+declare const usdFromWei: (wei: bigint, rate: number) => number;
+/**
+ * Compute the `≈ $X.XX` subtitle for a fee row.
+ *
+ * Prefers `weiAmount` (precise) over the displayed string (which may have
+ * been rounded by `formatEth`). Returns `null` when the row is loading,
+ * unpriced, a sentinel ("Free"/"N/A"), or otherwise unparseable.
+ */
+declare const computeUsd: (amount: number | string, weiAmount: bigint | undefined, ethUsdRate: number | null | undefined, isChecking: boolean) => string | null;
+
 interface EnsRecordsFormProps {
     resolverChainId?: number;
     resolverAddress?: Address;
@@ -459,20 +499,20 @@ interface ProgressBarProps {
 }
 declare function ProgressBar({ progress }: ProgressBarProps): react_jsx_runtime.JSX.Element;
 
+interface FeeRow {
+    amount: number | string;
+    isChecking: boolean;
+    /** Optional precise wei value. When provided, USD is computed from wei
+     *  rather than from the (possibly rounded) display string. See
+     *  `usdFromWei` for the precision bound. */
+    weiAmount?: bigint;
+}
 interface PricingDisplayProps {
-    primaryFee: {
+    primaryFee: FeeRow & {
         label: string;
-        amount: number | string;
-        isChecking: boolean;
-    };
-    networkFees?: {
-        amount: number | string;
-        isChecking: boolean;
-    };
-    total: {
-        amount: number | string;
-        isChecking: boolean;
     };
+    networkFees?: FeeRow;
+    total: FeeRow;
     expiryPicker?: {
         durationSeconds: number;
         onDurationChange: (seconds: number) => void;
@@ -853,24 +893,6 @@ declare const useMintSubname: ({ chainId }: {
 
 declare const useOffchainManager: (name: string, apiKeyOrToken: string, isTestnet?: boolean) => _thenamespace_offchain_manager.OffchainClient;
 
-/**
- * Upload result
- */
-interface UploadResult {
-    /** URL of the uploaded image */
-    url: string;
-    /** Upload timestamp */
-    uploadedAt: string;
-    /** File size in bytes */
-    fileSize: number;
-    /** Whether this was an update to existing image */
-    isUpdate: boolean;
-    /** Whether the upload is pending (for unregistered names) */
-    pending?: boolean;
-    /** Optional message from the server */
-    message?: string;
-}
-
 interface UseAvatarClientParams {
     isTestnet?: boolean;
     domain?: string;
@@ -889,5 +911,5 @@ declare const useAvatarClient: ({ isTestnet, domain }: UseAvatarClientParams) =>
     getErrorMessage: (err: unknown, imageType?: UploadImageType) => string;
 };
 
-export { Accordion, Alert, Button, Card, ChainIcon, ConnectAndSetChain, ContenthashIcon, ContenthashProtocol, ContractErrorLabel, Dropdown, DurationPicker, ENS_RESOLVER_ABI, EnsNameRegistrationForm, EnsRecordsForm, Icon, Input, ListingNetwork, ListingType, MIN_REGISTRATION_SECONDS, MULTICALL, Modal, ONE_DAY, ONE_YEAR, OffchainSubnameForm, PricingDisplay, ProfileHeader, ProgressBar, SET_ADDRESS_FUNC, SET_CONTENTHASH_FUNC, SET_TEXT_FUNC, SelectRecordsForm, ShurikenSpinner, SubnameMintForm, Text, TextRecordCategory, Textarea, ThemeProvider, Tooltip, TransactionPendingScreen, TxProgress, capitalize, convertEVMChainIdToCoinType, convertToMulticallResolverData, convertToResolverData, createEnsReferer, debounce, deepCopy, diffToEnsRecords, ensureFloatInput, equalsIgnoreCase, formatDurationSummary, formatFloat, getAvatarUploadErrorMessage, getBlockExplorer, getBlockExplorerAddressUrl, getBlockExplorerName, getBlockExplorerTransactionUrl, getChainIdForListingNetwork, getEnsAppUrl, getEnsRecordsDiff, getImageUploadErrorMessage, getSupportedAddressByChainId, getSupportedAddressByCoin, getSupportedAddressByName, getSupportedAddressMap, getSupportedChashByProtocol, getSupportedText, isCommitmentToNewErr, isContenthashValid, isUserDeniedError, roundDurationWithDay, secondsFromYears, secondsToDateInput, supportedAddresses, supportedContenthashRecords, supportedTexts, useAvatarClient, useENSResolver, useEthDollarValue, useMintManager, useMintSubname, useOffchainManager, useRegisterENS, useTheme, useWaitTransaction, validateEnsRecords, wait, yearsFromSeconds };
-export type { AccordionProps, AlertPosition, AlertProps, AlertVariant, ButtonProps, ButtonSize, ButtonVariant, ChainName$1 as ChainName, ConnectAndSetChainProps, ContractErrorLabelProps, DropdownProps, DurationPickerProps, EnsAddressRecord$1 as EnsAddressRecord, EnsContenthashRecord, EnsRecords$1 as EnsRecords, EnsRecordsDiff, EnsTextRecord$1 as EnsTextRecord, EstimatedFees, IconName, IconProps, InputProps, InputSize, InputType, ModalPresentation, ModalProps, ModalResponsivePresentation, ModalSize, NameListing, OffchainSubnameCreatedData, PricingDisplayProps, ProfileHeaderProps, RecordValidationError, RegistrationFeeEstimate, RegistrationRequest, ShurikenSpinnerProps, SupportedContenthashRecord, SupportedEnsAddress, SupportedText, SupportedTextRecord, TextCategory, TextColor, TextProps, TextSize, TextWeight, TextareaProps, TextareaSize, ThemeContextValue, ThemeName, ThemeProviderProps, TooltipPosition, TooltipProps, UploadAvatarParams, UploadImageType };
+export { Accordion, Alert, Button, Card, ChainIcon, ConnectAndSetChain, ContenthashIcon, ContenthashProtocol, ContractErrorLabel, Dropdown, DurationPicker, ENS_RESOLVER_ABI, ETH_SENTINELS, EnsNameRegistrationForm, EnsRecordsForm, Icon, Input, ListingNetwork, ListingType, MIN_REGISTRATION_SECONDS, MULTICALL, Modal, ONE_DAY, ONE_YEAR, OffchainSubnameForm, PricingDisplay, ProfileHeader, ProgressBar, SET_ADDRESS_FUNC, SET_CONTENTHASH_FUNC, SET_TEXT_FUNC, SelectRecordsForm, ShurikenSpinner, SubnameMintForm, Text, TextRecordCategory, Textarea, ThemeProvider, Tooltip, TransactionPendingScreen, TxProgress, capitalize, computeUsd, convertEVMChainIdToCoinType, convertToMulticallResolverData, convertToResolverData, createEnsReferer, debounce, deepCopy, diffToEnsRecords, ensureFloatInput, equalsIgnoreCase, formatDurationSummary, formatEth, formatFloat, getAvatarUploadErrorMessage, getBlockExplorer, getBlockExplorerAddressUrl, getBlockExplorerName, getBlockExplorerTransactionUrl, getChainIdForListingNetwork, getEnsAppUrl, getEnsRecordsDiff, getImageUploadErrorMessage, getSupportedAddressByChainId, getSupportedAddressByCoin, getSupportedAddressByName, getSupportedAddressMap, getSupportedChashByProtocol, getSupportedText, isCommitmentToNewErr, isContenthashValid, isSentinel, isUserDeniedError, roundDurationWithDay, secondsFromYears, secondsToDateInput, supportedAddresses, supportedContenthashRecords, supportedTexts, usdFromWei, useAvatarClient, useENSResolver, useEthDollarValue, useMintManager, useMintSubname, useOffchainManager, useRegisterENS, useTheme, useWaitTransaction, validateEnsRecords, wait, yearsFromSeconds };
+export type { AccordionProps, AlertPosition, AlertProps, AlertVariant, ButtonProps, ButtonSize, ButtonVariant, ChainName$1 as ChainName, ConnectAndSetChainProps, ContractErrorLabelProps, DropdownProps, DurationPickerProps, EnsAddressRecord$1 as EnsAddressRecord, EnsContenthashRecord, EnsRecords$1 as EnsRecords, EnsRecordsDiff, EnsTextRecord$1 as EnsTextRecord, EstimatedFees, EthSentinel, IconName, IconProps, InputProps, InputSize, InputType, ModalPresentation, ModalProps, ModalResponsivePresentation, ModalSize, NameListing, OffchainSubnameCreatedData, PricingDisplayProps, ProfileHeaderProps, RecordValidationError, RegistrationFeeEstimate, RegistrationRequest, ShurikenSpinnerProps, SupportedContenthashRecord, SupportedEnsAddress, SupportedText, SupportedTextRecord, TextCategory, TextColor, TextProps, TextSize, TextWeight, TextareaProps, TextareaSize, ThemeContextValue, ThemeName, ThemeProviderProps, TooltipPosition, TooltipProps, UploadAvatarParams, UploadImageType };