@cofhe/react 0.0.0-alpha-20260527080106 → 0.0.0-alpha-20260602122344

package/dist/{types-BTBGwral.d.cts → StatusBarContent-BOe91ztF.d.cts}

@@ -1,5 +1,6 @@
 import { FheTypeValue } from '@cofhe/sdk';
 import { Address } from 'viem';
+import { ReactNode } from 'react';
 
 interface BaseProps {
     /** Additional CSS class names */
@@ -67,6 +68,51 @@ interface CofheFloatingButtonProps extends BaseProps {
     darkMode?: boolean;
     overriddingPage?: PageState;
 }
+declare const CofheStatusActionIntents: {
+    readonly openPermits: "open-permits";
+    readonly openClaimableTokens: "open-claimable-tokens";
+};
+type CofheStatusActionIntent = (typeof CofheStatusActionIntents)[keyof typeof CofheStatusActionIntents];
+/**
+ * Status ids emitted by the SDK's built-in status watchers.
+ *
+ * `useCofheStatuses()` may still include additional custom statuses added by
+ * internal or app-specific flows, so treat this as the known built-in subset.
+ */
+declare const COFHE_STATUS_IDS: {
+    readonly claimsAvailable: "claims-available";
+    readonly missingPermit: "missing-permit";
+    readonly permitExpired: "permit-expired";
+    readonly permitExpiringSoon: "permit-expiring-soon";
+    readonly permitShared: "permit-shared";
+};
+type CofheStatusId = (typeof COFHE_STATUS_IDS)[keyof typeof COFHE_STATUS_IDS];
+type CofheStatusAction = {
+    label: string;
+    intent: CofheStatusActionIntent;
+};
+/**
+ * Public status shape exposed to consumers.
+ *
+ * Consumer-facing status actions must declare an intent so the widget can map
+ * them to the correct internal handler.
+ */
+type CofheStatus = {
+    id: string;
+    variant: CofheStatusVariant;
+    title: string;
+    description?: string;
+    action?: CofheStatusAction;
+};
+type CofheStatusVariant = 'error' | 'warning' | 'info';
+
+/**
+ * Returns the public consumer-facing status list.
+ *
+ * Only statuses with the public intent-based action shape are exposed here.
+ * Internal callback-action statuses remain widget-only and are filtered out.
+ */
+declare const useCofheStatuses: () => readonly CofheStatus[];
 
 /**
  * Token types shared across hooks/components/utils.
@@ -89,11 +135,13 @@ type Erc20Pair = {
     decimals: number;
     logoURI?: string;
 };
+type TokenWrapperKind = 'erc20' | 'native';
+type TokenConfidentialValueType = 'uint64' | 'uint128';
 declare const TOKEN_CONFIDENTIALITY_SUPPORT: {
     readonly wrapped: {
         readonly enabled: true;
         readonly label: "Wrapped confidential token";
-        readonly confidentialValueType: "uint128";
+        readonly confidentialValueType: "uint64";
         readonly publicBalanceSource: "erc20Pair";
         readonly operations: {
             readonly confidentialBalance: true;
@@ -147,12 +195,23 @@ type Token = {
     extensions: Record<string, unknown> & {
         fhenix: {
             confidentialityType: TokenConfidentialityType;
-            confidentialValueType: 'uint64' | 'uint128';
+            confidentialValueType: TokenConfidentialValueType;
+            wrapperKind?: TokenWrapperKind;
             /** ERC20 pair for wrapped tokens - contains underlying token info */
             erc20Pair?: Erc20Pair;
         };
     };
 };
+type SourceToken = Omit<Token, 'extensions'> & {
+    extensions?: Record<string, unknown> & {
+        fhenix?: {
+            confidentialityType?: string;
+            confidentialValueType?: TokenConfidentialValueType;
+            erc20Pair?: Erc20Pair;
+        };
+        erc20Pair?: Erc20Pair;
+    };
+};
 
 /**
  * Gets the block explorer URL for a given chain ID
@@ -231,4 +290,70 @@ declare module '../../../pagesConfig/types' {
     }
 }
 
-export { type BaseProps as B, type CofheFloatingButtonProps as C, type DropdownOption as D, ETH_ADDRESS_LOWERCASE as E, type FloatingButtonPosition as F, type GeneratePermitPageProps as G, type Token as T, type Erc20Pair as a, FheTypesList as b, getBlockExplorerTxUrl as c, getBlockExplorerAddressUrl as d, getBlockExplorerTokenUrl as e, formatRelativeTime as f, getBlockExplorerUrl as g, isWrappedEthToken as h, isEthPair as i, type ComponentSize as j, type EncryptionStartData as k, type EncryptionProgressData as l, type EncryptionResultData as m, truncateHash as t };
+type DelegatePermitPageProps = {
+    onSuccessNavigateTo?: () => void;
+    onCancel?: () => void;
+    onBack?: () => void;
+};
+declare module '../../../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.DelegatePermits]: DelegatePermitPageProps;
+    }
+}
+
+type TokenInfoPageProps = {
+    token: Token;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.TokenInfo]: TokenInfoPageProps;
+    }
+}
+
+type SendPageProps = {
+    token: Token;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.Send]: SendPageProps;
+    }
+}
+
+type Mode = 'shield' | 'unshield';
+type ShieldPageProps = {
+    token: Token;
+    defaultMode?: Mode;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.Shield]: ShieldPageProps;
+    }
+}
+
+interface CofheFloatingButtonProviderProps {
+    children?: ReactNode;
+}
+declare const CofheFloatingButtonProvider: React.FC<CofheFloatingButtonProviderProps>;
+
+/**
+ * Internal-only action shape used inside the React widget implementation.
+ *
+ * The callback form must not cross the public API boundary. Any status exposed
+ * to consumers should be represented as {@link CofheStatus} with an intent.
+ */
+type CofheFloatingButtonInternalAction = CofheStatusAction | {
+    label: string;
+    onClick: () => void;
+};
+/**
+ * Internal widget status shape stored and rendered by the floating button.
+ *
+ * Use {@link CofheStatus} for any consumer-facing API.
+ */
+type CofheFloatingButtonInternalStatus = Omit<CofheStatus, 'action'> & {
+    action?: CofheFloatingButtonInternalAction;
+};
+
+declare function sortCofheStatuses(a: Pick<CofheFloatingButtonInternalStatus, 'id'>, b: Pick<CofheFloatingButtonInternalStatus, 'id'>): number;
+
+export { type BaseProps as B, CofheFloatingButtonProvider as C, type DropdownOption as D, ETH_ADDRESS_LOWERCASE as E, type FloatingButtonPosition as F, type GeneratePermitPageProps as G, type SourceToken as S, type Token as T, type Erc20Pair as a, FheTypesList as b, getBlockExplorerTokenUrl as c, getBlockExplorerTxUrl as d, getBlockExplorerUrl as e, formatRelativeTime as f, getBlockExplorerAddressUrl as g, isWrappedEthToken as h, isEthPair as i, COFHE_STATUS_IDS as j, CofheStatusActionIntents as k, type CofheStatus as l, type CofheStatusActionIntent as m, type CofheStatusId as n, type ComponentSize as o, type EncryptionStartData as p, type EncryptionProgressData as q, type EncryptionResultData as r, sortCofheStatuses as s, truncateHash as t, useCofheStatuses as u, type CofheFloatingButtonProps as v };

package/dist/{types-BTBGwral.d.ts → StatusBarContent-BOe91ztF.d.ts}

@@ -1,5 +1,6 @@
 import { FheTypeValue } from '@cofhe/sdk';
 import { Address } from 'viem';
+import { ReactNode } from 'react';
 
 interface BaseProps {
     /** Additional CSS class names */
@@ -67,6 +68,51 @@ interface CofheFloatingButtonProps extends BaseProps {
     darkMode?: boolean;
     overriddingPage?: PageState;
 }
+declare const CofheStatusActionIntents: {
+    readonly openPermits: "open-permits";
+    readonly openClaimableTokens: "open-claimable-tokens";
+};
+type CofheStatusActionIntent = (typeof CofheStatusActionIntents)[keyof typeof CofheStatusActionIntents];
+/**
+ * Status ids emitted by the SDK's built-in status watchers.
+ *
+ * `useCofheStatuses()` may still include additional custom statuses added by
+ * internal or app-specific flows, so treat this as the known built-in subset.
+ */
+declare const COFHE_STATUS_IDS: {
+    readonly claimsAvailable: "claims-available";
+    readonly missingPermit: "missing-permit";
+    readonly permitExpired: "permit-expired";
+    readonly permitExpiringSoon: "permit-expiring-soon";
+    readonly permitShared: "permit-shared";
+};
+type CofheStatusId = (typeof COFHE_STATUS_IDS)[keyof typeof COFHE_STATUS_IDS];
+type CofheStatusAction = {
+    label: string;
+    intent: CofheStatusActionIntent;
+};
+/**
+ * Public status shape exposed to consumers.
+ *
+ * Consumer-facing status actions must declare an intent so the widget can map
+ * them to the correct internal handler.
+ */
+type CofheStatus = {
+    id: string;
+    variant: CofheStatusVariant;
+    title: string;
+    description?: string;
+    action?: CofheStatusAction;
+};
+type CofheStatusVariant = 'error' | 'warning' | 'info';
+
+/**
+ * Returns the public consumer-facing status list.
+ *
+ * Only statuses with the public intent-based action shape are exposed here.
+ * Internal callback-action statuses remain widget-only and are filtered out.
+ */
+declare const useCofheStatuses: () => readonly CofheStatus[];
 
 /**
  * Token types shared across hooks/components/utils.
@@ -89,11 +135,13 @@ type Erc20Pair = {
     decimals: number;
     logoURI?: string;
 };
+type TokenWrapperKind = 'erc20' | 'native';
+type TokenConfidentialValueType = 'uint64' | 'uint128';
 declare const TOKEN_CONFIDENTIALITY_SUPPORT: {
     readonly wrapped: {
         readonly enabled: true;
         readonly label: "Wrapped confidential token";
-        readonly confidentialValueType: "uint128";
+        readonly confidentialValueType: "uint64";
         readonly publicBalanceSource: "erc20Pair";
         readonly operations: {
             readonly confidentialBalance: true;
@@ -147,12 +195,23 @@ type Token = {
     extensions: Record<string, unknown> & {
         fhenix: {
             confidentialityType: TokenConfidentialityType;
-            confidentialValueType: 'uint64' | 'uint128';
+            confidentialValueType: TokenConfidentialValueType;
+            wrapperKind?: TokenWrapperKind;
             /** ERC20 pair for wrapped tokens - contains underlying token info */
             erc20Pair?: Erc20Pair;
         };
     };
 };
+type SourceToken = Omit<Token, 'extensions'> & {
+    extensions?: Record<string, unknown> & {
+        fhenix?: {
+            confidentialityType?: string;
+            confidentialValueType?: TokenConfidentialValueType;
+            erc20Pair?: Erc20Pair;
+        };
+        erc20Pair?: Erc20Pair;
+    };
+};
 
 /**
  * Gets the block explorer URL for a given chain ID
@@ -231,4 +290,70 @@ declare module '../../../pagesConfig/types' {
     }
 }
 
-export { type BaseProps as B, type CofheFloatingButtonProps as C, type DropdownOption as D, ETH_ADDRESS_LOWERCASE as E, type FloatingButtonPosition as F, type GeneratePermitPageProps as G, type Token as T, type Erc20Pair as a, FheTypesList as b, getBlockExplorerTxUrl as c, getBlockExplorerAddressUrl as d, getBlockExplorerTokenUrl as e, formatRelativeTime as f, getBlockExplorerUrl as g, isWrappedEthToken as h, isEthPair as i, type ComponentSize as j, type EncryptionStartData as k, type EncryptionProgressData as l, type EncryptionResultData as m, truncateHash as t };
+type DelegatePermitPageProps = {
+    onSuccessNavigateTo?: () => void;
+    onCancel?: () => void;
+    onBack?: () => void;
+};
+declare module '../../../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.DelegatePermits]: DelegatePermitPageProps;
+    }
+}
+
+type TokenInfoPageProps = {
+    token: Token;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.TokenInfo]: TokenInfoPageProps;
+    }
+}
+
+type SendPageProps = {
+    token: Token;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.Send]: SendPageProps;
+    }
+}
+
+type Mode = 'shield' | 'unshield';
+type ShieldPageProps = {
+    token: Token;
+    defaultMode?: Mode;
+};
+declare module '../pagesConfig/types' {
+    interface FloatingButtonPagePropsRegistry {
+        [FloatingButtonPage.Shield]: ShieldPageProps;
+    }
+}
+
+interface CofheFloatingButtonProviderProps {
+    children?: ReactNode;
+}
+declare const CofheFloatingButtonProvider: React.FC<CofheFloatingButtonProviderProps>;
+
+/**
+ * Internal-only action shape used inside the React widget implementation.
+ *
+ * The callback form must not cross the public API boundary. Any status exposed
+ * to consumers should be represented as {@link CofheStatus} with an intent.
+ */
+type CofheFloatingButtonInternalAction = CofheStatusAction | {
+    label: string;
+    onClick: () => void;
+};
+/**
+ * Internal widget status shape stored and rendered by the floating button.
+ *
+ * Use {@link CofheStatus} for any consumer-facing API.
+ */
+type CofheFloatingButtonInternalStatus = Omit<CofheStatus, 'action'> & {
+    action?: CofheFloatingButtonInternalAction;
+};
+
+declare function sortCofheStatuses(a: Pick<CofheFloatingButtonInternalStatus, 'id'>, b: Pick<CofheFloatingButtonInternalStatus, 'id'>): number;
+
+export { type BaseProps as B, CofheFloatingButtonProvider as C, type DropdownOption as D, ETH_ADDRESS_LOWERCASE as E, type FloatingButtonPosition as F, type GeneratePermitPageProps as G, type SourceToken as S, type Token as T, type Erc20Pair as a, FheTypesList as b, getBlockExplorerTokenUrl as c, getBlockExplorerTxUrl as d, getBlockExplorerUrl as e, formatRelativeTime as f, getBlockExplorerAddressUrl as g, isWrappedEthToken as h, isEthPair as i, COFHE_STATUS_IDS as j, CofheStatusActionIntents as k, type CofheStatus as l, type CofheStatusActionIntent as m, type CofheStatusId as n, type ComponentSize as o, type EncryptionStartData as p, type EncryptionProgressData as q, type EncryptionResultData as r, sortCofheStatuses as s, truncateHash as t, useCofheStatuses as u, type CofheFloatingButtonProps as v };