@liberfi.io/ui-perpetuals 0.2.4 → 0.2.5

package/dist/index.d.mts

@@ -12,7 +12,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.2.4";
+declare const _default: "0.2.5";
 
 /**
  * Trading pair symbol format
@@ -566,6 +566,13 @@ declare class HyperliquidPerpetualsClient implements IPerpetualsClient {
     private readonly timeout;
     private readonly environment;
     private wsManager;
+    /**
+     * Reference count of active WebSocket consumers. The connection is
+     * established on the first `connectWebSocket()` call and torn down
+     * only when the last consumer disconnects — see the matching comment
+     * on {@link LiberFiPerpetualsClient}.
+     */
+    private wsRefCount;
     /**
      * 构造 Hyperliquid 客户端
      *
@@ -709,7 +716,10 @@ declare class HyperliquidPerpetualsClient implements IPerpetualsClient {
     /**
      * Disconnect from WebSocket server
      *
-     * Closes WebSocket connection and cleans up all subscriptions.
+     * Decrements the consumer ref count. The underlying socket is closed
+     * only when the last consumer disconnects, so concurrent widgets
+     * (order book, trades, ticker) can mount/unmount independently
+     * without stealing each other's stream.
      */
     disconnectWebSocket(): void;
     /**
@@ -1071,6 +1081,14 @@ declare class LiberFiPerpetualsClient implements IPerpetualsClient {
     private readonly wsEndpoint;
     private readonly signTypedData?;
     private wsManager;
+    /**
+     * Reference count of active WebSocket consumers (one per React hook
+     * instance). The underlying connection is opened lazily on the first
+     * connect() call and torn down only when the last consumer leaves —
+     * this prevents one widget's unmount from killing the live stream
+     * other widgets (order book, trades, ticker) still depend on.
+     */
+    private wsRefCount;
     constructor(config: LiberFiPerpetualsClientConfig);
     getSupportedCoins(): Promise<string[]>;
     getMarket(symbol: string): Promise<MarketData | null>;
@@ -1956,9 +1974,16 @@ type PlaceOrderFormWidgetProps = {
     maxLeverage?: number;
     onSuccess?: () => void;
     onError?: (error: Error) => void;
+    /**
+     * Optional callback fired when the user clicks "Add More Funds".
+     * The host app typically opens its deposit dialog here. When omitted,
+     * the button is hidden so the form doesn't expose a non-functional
+     * control.
+     */
+    onAddFunds?: () => void;
     className?: string;
 };
-declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PlaceOrderFormData = {
     price?: number;
@@ -2012,8 +2037,15 @@ type PlaceOrderFormUIProps = {
     accountValue: number;
     currentPosition?: number;
     maxLeverage: number;
+    /**
+     * Optional callback fired when the user clicks the "Add More Funds"
+     * button (typically wired by the host app to open a deposit dialog).
+     * The button is hidden when this prop is omitted, so consumers that
+     * don't support a deposit flow don't render a dead control.
+     */
+    onAddFunds?: () => void;
 };
-declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage, onAddFunds, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
 
 type PositionsWidgetProps = {
     userAddress?: string;
@@ -2229,9 +2261,16 @@ interface DepositConfirmUIProps {
 declare function DepositConfirmUI({ isOpen, quote, isExecuting, isExpired, onConfirm, onCancel, onExpire, error, }: DepositConfirmUIProps): react_jsx_runtime.JSX.Element;
 
 /**
- * Pure presentational status panel.
+ * Polished progress / result panel for the SOL → Hyperliquid USDC
+ * deposit flow.
+ *
+ * Visual design intentionally mirrors the swap-style deposit form
+ * modal (dark surface, 14 px radius, accent-color spinner / icons,
+ * pill-style transaction links) so the in-flight, success and failure
+ * states all feel like the same product surface rather than a generic
+ * HeroUI dialog.
  *
- * Renders one of four visual states:
+ * Renders one of four visual states based on the FSM phase:
  *  - in-progress (broadcasting / submitted / tracking)
  *  - succeeded
  *  - refunded

package/dist/index.d.ts

@@ -12,7 +12,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.2.4";
+declare const _default: "0.2.5";
 
 /**
  * Trading pair symbol format
@@ -566,6 +566,13 @@ declare class HyperliquidPerpetualsClient implements IPerpetualsClient {
     private readonly timeout;
     private readonly environment;
     private wsManager;
+    /**
+     * Reference count of active WebSocket consumers. The connection is
+     * established on the first `connectWebSocket()` call and torn down
+     * only when the last consumer disconnects — see the matching comment
+     * on {@link LiberFiPerpetualsClient}.
+     */
+    private wsRefCount;
     /**
      * 构造 Hyperliquid 客户端
      *
@@ -709,7 +716,10 @@ declare class HyperliquidPerpetualsClient implements IPerpetualsClient {
     /**
      * Disconnect from WebSocket server
      *
-     * Closes WebSocket connection and cleans up all subscriptions.
+     * Decrements the consumer ref count. The underlying socket is closed
+     * only when the last consumer disconnects, so concurrent widgets
+     * (order book, trades, ticker) can mount/unmount independently
+     * without stealing each other's stream.
      */
     disconnectWebSocket(): void;
     /**
@@ -1071,6 +1081,14 @@ declare class LiberFiPerpetualsClient implements IPerpetualsClient {
     private readonly wsEndpoint;
     private readonly signTypedData?;
     private wsManager;
+    /**
+     * Reference count of active WebSocket consumers (one per React hook
+     * instance). The underlying connection is opened lazily on the first
+     * connect() call and torn down only when the last consumer leaves —
+     * this prevents one widget's unmount from killing the live stream
+     * other widgets (order book, trades, ticker) still depend on.
+     */
+    private wsRefCount;
     constructor(config: LiberFiPerpetualsClientConfig);
     getSupportedCoins(): Promise<string[]>;
     getMarket(symbol: string): Promise<MarketData | null>;
@@ -1956,9 +1974,16 @@ type PlaceOrderFormWidgetProps = {
     maxLeverage?: number;
     onSuccess?: () => void;
     onError?: (error: Error) => void;
+    /**
+     * Optional callback fired when the user clicks "Add More Funds".
+     * The host app typically opens its deposit dialog here. When omitted,
+     * the button is hidden so the form doesn't expose a non-functional
+     * control.
+     */
+    onAddFunds?: () => void;
     className?: string;
 };
-declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PlaceOrderFormData = {
     price?: number;
@@ -2012,8 +2037,15 @@ type PlaceOrderFormUIProps = {
     accountValue: number;
     currentPosition?: number;
     maxLeverage: number;
+    /**
+     * Optional callback fired when the user clicks the "Add More Funds"
+     * button (typically wired by the host app to open a deposit dialog).
+     * The button is hidden when this prop is omitted, so consumers that
+     * don't support a deposit flow don't render a dead control.
+     */
+    onAddFunds?: () => void;
 };
-declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage, onAddFunds, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
 
 type PositionsWidgetProps = {
     userAddress?: string;
@@ -2229,9 +2261,16 @@ interface DepositConfirmUIProps {
 declare function DepositConfirmUI({ isOpen, quote, isExecuting, isExpired, onConfirm, onCancel, onExpire, error, }: DepositConfirmUIProps): react_jsx_runtime.JSX.Element;
 
 /**
- * Pure presentational status panel.
+ * Polished progress / result panel for the SOL → Hyperliquid USDC
+ * deposit flow.
+ *
+ * Visual design intentionally mirrors the swap-style deposit form
+ * modal (dark surface, 14 px radius, accent-color spinner / icons,
+ * pill-style transaction links) so the in-flight, success and failure
+ * states all feel like the same product surface rather than a generic
+ * HeroUI dialog.
  *
- * Renders one of four visual states:
+ * Renders one of four visual states based on the FSM phase:
  *  - in-progress (broadcasting / submitted / tracking)
  *  - succeeded
  *  - refunded