@thenamespace/ens-components 0.37.0 → 1.1.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Address, Hash, ContractFunctionExecutionError, TransactionReceipt } from 'viem';
 import * as React$1 from 'react';
-import React__default, { ReactNode, PropsWithChildren } from 'react';
+import React__default, { ReactNode } from 'react';
 
 interface EnsRecords$1 {
     addresses: EnsAddressRecord$1[];
@@ -61,12 +61,18 @@ declare enum ListingNetwork {
 }
 declare const getChainIdForListingNetwork: (network: ListingNetwork) => number;
 
+interface AvatarUploadContext {
+    ensName: string;
+    isTestnet?: boolean;
+    siweDomain?: string;
+}
 interface SelectRecordsFormProps {
     records: EnsRecords$1;
     onRecordsUpdated: (records: EnsRecords$1) => void;
     actionButtons?: React.ReactNode;
+    avatarUpload?: AvatarUploadContext;
 }
-declare const SelectRecordsForm: ({ records, onRecordsUpdated, actionButtons, }: SelectRecordsFormProps) => react_jsx_runtime.JSX.Element;
+declare const SelectRecordsForm: ({ records, onRecordsUpdated, actionButtons, avatarUpload, }: SelectRecordsFormProps) => react_jsx_runtime.JSX.Element;
 
 interface EnsNameRegistrationFormProps {
     name?: string;
@@ -74,9 +80,15 @@ interface EnsNameRegistrationFormProps {
     referrer?: Address;
     noBorder?: boolean;
     className?: string;
+    title?: string;
+    subtitle?: string;
+    bannerImage?: string;
+    hideBanner?: boolean;
+    bannerWidth?: number;
     onRegistrationSuccess?: (result: RegistrationSuccessData) => void;
     onClose?: (isSuccess: boolean) => void;
     onRegistrationStart?: (name: string) => void;
+    onConnectWallet?: () => void;
 }
 interface RegistrationSuccessData {
     expiryInYears: number;
@@ -145,13 +157,14 @@ interface EnsRecordsFormProps {
     existingRecords: EnsRecords$1;
     noBorder?: boolean;
     className?: string;
+    avatarUploadDomain?: string;
     onCancel?: () => void;
     onRecordsUpdated?: (newRecords: EnsRecordsDiff) => void;
     onGreat?: () => void;
     onTransactionSent?: (hash: Hash) => void;
     txConfirmations?: number;
 }
-declare const EnsRecordsForm: ({ name, existingRecords, resolverChainId, isTestnet, resolverAddress, noBorder, className, onCancel, onGreat, onRecordsUpdated, onTransactionSent, txConfirmations }: EnsRecordsFormProps) => react_jsx_runtime.JSX.Element;
+declare const EnsRecordsForm: ({ name, existingRecords, resolverChainId, isTestnet, resolverAddress, noBorder, className, avatarUploadDomain, onCancel, onGreat, onRecordsUpdated, onTransactionSent, txConfirmations }: EnsRecordsFormProps) => react_jsx_runtime.JSX.Element;
 
 interface MintSuccessData {
     fullName: string;
@@ -181,8 +194,9 @@ interface SubnameMintFormProps {
     onSuccess?: (data: MintSuccessData) => void;
     onSubnameMinted?: (data: SubnameMintedData) => void;
     txConfirmations?: number;
+    onConnectWallet?: () => void;
 }
-declare const SubnameMintForm: ({ parentName, label, isTestnet, onCancel, onSuccess, onSubnameMinted, txConfirmations }: SubnameMintFormProps) => react_jsx_runtime.JSX.Element;
+declare const SubnameMintForm: ({ parentName, label, isTestnet, onCancel, onSuccess, onSubnameMinted, txConfirmations, onConnectWallet, }: SubnameMintFormProps) => react_jsx_runtime.JSX.Element;
 
 interface OffchainSubnameCreatedData {
     label: string;
@@ -198,9 +212,10 @@ interface OffchainSubnameFormProps {
     hideTitle?: boolean;
     onCancel?: () => void;
     isTestnet?: boolean;
+    avatarUploadDomain?: string;
     onSuccess?: (data: OffchainSubnameCreatedData) => void;
 }
-declare const OffchainSubnameForm: ({ apiKeyOrToken, name, label: propLabel, hideTitle, isTestnet, onCancel, onSuccess, }: OffchainSubnameFormProps) => react_jsx_runtime.JSX.Element;
+declare const OffchainSubnameForm: ({ apiKeyOrToken, name, label: propLabel, hideTitle, isTestnet, avatarUploadDomain, onCancel, onSuccess, }: OffchainSubnameFormProps) => react_jsx_runtime.JSX.Element;
 
 type ButtonVariant = "solid" | "outline" | "ghost" | "destructive";
 type ButtonSize = "sm" | "md" | "lg";
@@ -251,7 +266,7 @@ interface TextProps extends React__default.HTMLAttributes<HTMLSpanElement> {
 }
 declare const Text: React__default.FC<TextProps>;
 
-type IconName = "person" | "x" | "search" | "square-user" | "globe" | "pin" | "box" | "book" | "map-pin" | "mail" | "discord" | "github" | "telegram" | "youtube" | "image" | "circle-person" | "twitter" | "circle-alert" | "check-circle" | "check" | "alert-triangle" | "info" | "x-circle" | "rotate-circle" | "logout" | "edit" | "copy" | "clock" | "image" | "xSocial" | "chevron-up" | "chevron-down" | "chevron-left";
+type IconName = "person" | "x" | "search" | "square-user" | "globe" | "pin" | "box" | "book" | "map-pin" | "mail" | "discord" | "github" | "telegram" | "youtube" | "image" | "circle-person" | "twitter" | "circle-alert" | "check-circle" | "check" | "alert-triangle" | "info" | "x-circle" | "rotate-circle" | "logout" | "edit" | "copy" | "clock" | "plus" | "image" | "xSocial" | "chevron-up" | "chevron-down" | "chevron-left";
 interface IconProps {
     name: IconName;
     color?: string;
@@ -324,6 +339,11 @@ interface AlertProps {
 declare const Alert: React__default.FC<AlertProps>;
 
 type ModalSize = "sm" | "md" | "lg";
+type ModalPresentation = "dialog" | "drawer";
+interface ModalResponsivePresentation {
+    mobile?: ModalPresentation;
+    breakpointPx?: number;
+}
 interface ModalProps {
     isOpen: boolean;
     onClose: () => void;
@@ -341,6 +361,10 @@ interface ModalProps {
     className?: string;
     /** Optional styles for the dialog container */
     style?: React__default.CSSProperties;
+    /** Visual presentation mode */
+    presentation?: ModalPresentation;
+    /** Optional responsive presentation overrides */
+    responsivePresentation?: ModalResponsivePresentation;
 }
 declare const Modal: React__default.FC<ModalProps>;
 
@@ -528,8 +552,6 @@ declare const ENS_RESOLVER_ABI: readonly [{
     readonly outputs: readonly [];
 }];
 
-declare const WalletConnectProvider: ({ children }: PropsWithChildren) => react_jsx_runtime.JSX.Element;
-
 type ThemeName = "light" | "dark";
 interface ThemeContextValue {
     theme: ThemeName;
@@ -1090,6 +1112,24 @@ interface OffchainClient {
      * ```
      */
     setDefaultApiKey(apiKey: string): void;
+    /**
+     * Set custom HTTP headers to be sent with each request.
+     * Useful for tracing, multi-tenant routing, or additional auth metadata.
+     *
+     * WARNING: The API key is sent using the "x-auth-token" header by default.
+     * If you pass a header with the same name here, it will overwrite the
+     * API key value used for authentication.
+     *
+     * @param headers - A record of header keys and values
+     * @example
+     * ```typescript
+     * client.setCustomHeaders({
+     *   'x-trace-id': '123',
+     *   'x-tenant-id': 'my-tenant',
+     * });
+     * ```
+     */
+    setCustomHeaders(headers: Record<string, any>): void;
     /**
      * Create a new ENS subname with optional records.
      * @param request - Subname creation parameters
@@ -1290,5 +1330,41 @@ interface OffchainClient {
 
 declare const useOffchainManager: (name: string, apiKeyOrToken: string, isTestnet?: boolean) => OffchainClient;
 
-export { Accordion, Alert, Button, Card, ChainIcon, ConnectAndSetChain, ContenthashIcon, ContenthashProtocol, ContractErrorLabel, Dropdown, ENS_RESOLVER_ABI, EnsNameRegistrationForm, EnsRecordsForm, Icon, Input, ListingNetwork, ListingType, MULTICALL, Modal, OffchainSubnameForm, PricingDisplay, ProfileHeader, ProgressBar, SET_ADDRESS_FUNC, SET_CONTENTHASH_FUNC, SET_TEXT_FUNC, SelectRecordsForm, ShurikenSpinner, SubnameMintForm, Text, TextRecordCategory, Textarea, ThemeProvider, Tooltip, TxProgress, WalletConnectProvider, capitalize, convertEVMChainIdToCoinType, convertToMulticallResolverData, convertToResolverData, createEnsReferer, debounce, deepCopy, diffToEnsRecords, ensureFloatInput, equalsIgnoreCase, formatFloat, getBlockExplorer, getBlockExplorerAddressUrl, getBlockExplorerName, getBlockExplorerTransactionUrl, getChainIdForListingNetwork, getEnsAppUrl, getEnsRecordsDiff, getSupportedAddressByChainId, getSupportedAddressByCoin, getSupportedAddressByName, getSupportedAddressMap, getSupportedChashByProtocol, getSupportedText, isCommitmentToNewErr, isContenthashValid, isUserDeniedError, supportedAddresses, supportedContenthashRecords, supportedTexts, useENSResolver, useMintManager, useMintSubname, useOffchainManager, useRegisterENS, useTheme, useWaitTransaction, validateEnsRecords, wait };
-export type { AccordionProps, AlertPosition, AlertProps, AlertVariant, ButtonProps, ButtonSize, ButtonVariant, ChainName$2 as ChainName, ConnectAndSetChainProps, ContractErrorLabelProps, DropdownProps, EnsAddressRecord$1 as EnsAddressRecord, EnsContenthashRecord, EnsRecords$1 as EnsRecords, EnsRecordsDiff, EnsTextRecord$1 as EnsTextRecord, EstimatedFees, IconName, IconProps, InputProps, InputSize, InputType, ModalProps, ModalSize, NameListing, PricingDisplayProps, ProfileHeaderProps, RecordValidationError, RegistrationRequest, ShurikenSpinnerProps, SupportedContenthashRecord, SupportedEnsAddress, SupportedText, SupportedTextRecord, TextCategory, TextColor, TextProps, TextSize, TextWeight, TextareaProps, TextareaSize, ThemeContextValue, ThemeName, ThemeProviderProps, TooltipPosition, TooltipProps };
+/**
+ * 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;
+}
+interface UploadAvatarParams {
+    ensName: string;
+    file: File;
+    onProgress?: (progress: number) => void;
+}
+type UploadImageType = "avatar" | "header";
+declare const getAvatarUploadErrorMessage: (err: unknown) => string;
+declare const getImageUploadErrorMessage: (err: unknown, imageType?: UploadImageType) => string;
+declare const useAvatarClient: ({ isTestnet, domain }: UseAvatarClientParams) => {
+    uploadAvatar: (params: UploadAvatarParams) => Promise<UploadResult>;
+    uploadHeader: (params: UploadAvatarParams) => Promise<UploadResult>;
+    getErrorMessage: (err: unknown, imageType?: UploadImageType) => string;
+};
+
+export { Accordion, Alert, Button, Card, ChainIcon, ConnectAndSetChain, ContenthashIcon, ContenthashProtocol, ContractErrorLabel, Dropdown, ENS_RESOLVER_ABI, EnsNameRegistrationForm, EnsRecordsForm, Icon, Input, ListingNetwork, ListingType, MULTICALL, Modal, OffchainSubnameForm, PricingDisplay, ProfileHeader, ProgressBar, SET_ADDRESS_FUNC, SET_CONTENTHASH_FUNC, SET_TEXT_FUNC, SelectRecordsForm, ShurikenSpinner, SubnameMintForm, Text, TextRecordCategory, Textarea, ThemeProvider, Tooltip, TxProgress, capitalize, convertEVMChainIdToCoinType, convertToMulticallResolverData, convertToResolverData, createEnsReferer, debounce, deepCopy, diffToEnsRecords, ensureFloatInput, equalsIgnoreCase, formatFloat, getAvatarUploadErrorMessage, getBlockExplorer, getBlockExplorerAddressUrl, getBlockExplorerName, getBlockExplorerTransactionUrl, getChainIdForListingNetwork, getEnsAppUrl, getEnsRecordsDiff, getImageUploadErrorMessage, getSupportedAddressByChainId, getSupportedAddressByCoin, getSupportedAddressByName, getSupportedAddressMap, getSupportedChashByProtocol, getSupportedText, isCommitmentToNewErr, isContenthashValid, isUserDeniedError, supportedAddresses, supportedContenthashRecords, supportedTexts, useAvatarClient, useENSResolver, useMintManager, useMintSubname, useOffchainManager, useRegisterENS, useTheme, useWaitTransaction, validateEnsRecords, wait };
+export type { AccordionProps, AlertPosition, AlertProps, AlertVariant, ButtonProps, ButtonSize, ButtonVariant, ChainName$2 as ChainName, ConnectAndSetChainProps, ContractErrorLabelProps, DropdownProps, 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, PricingDisplayProps, ProfileHeaderProps, RecordValidationError, RegistrationRequest, ShurikenSpinnerProps, SupportedContenthashRecord, SupportedEnsAddress, SupportedText, SupportedTextRecord, TextCategory, TextColor, TextProps, TextSize, TextWeight, TextareaProps, TextareaSize, ThemeContextValue, ThemeName, ThemeProviderProps, TooltipPosition, TooltipProps, UploadAvatarParams, UploadImageType };