@liberfi.io/ui-perpetuals 0.2.18 → 0.2.19

package/dist/index.d.mts

@@ -12,7 +12,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.2.18";
+declare const _default: "0.2.19";
 
 /**
  * Trading pair symbol format
@@ -2223,9 +2223,17 @@ type PlaceOrderFormWidgetProps = {
      * control.
      */
     onAddFunds?: () => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage value
+     * in the leverage modal. The host app should sign + relay the
+     * `updateLeverage` action to Hyperliquid and surface a toast. While
+     * the returned promise is pending the modal's button shows a spinner;
+     * if it rejects, the modal stays open so the user can retry.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
     className?: string;
 };
-declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, onUpdateLeverage, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PlaceOrderFormData = {
     price?: number;
@@ -2242,6 +2250,19 @@ type UsePlaceOrderFormScriptParams = {
     maxLeverage?: number;
     onSuccess?: () => void;
     onError?: (error: Error) => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage value
+     * in the leverage modal. The host app is expected to sign + relay the
+     * `updateLeverage` action to Hyperliquid (and surface a toast). The
+     * widget tracks the returned promise to drive the modal's button
+     * loading state — when the promise rejects, the modal stays open so
+     * the user can retry.
+     *
+     * When omitted, the modal falls back to a local-only update: the
+     * leverage slider commits to the form state without contacting the
+     * exchange.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
 type UsePlaceOrderFormScriptResult = {
     form: ReturnType<typeof useForm<PlaceOrderFormData>>;
@@ -2265,8 +2286,10 @@ type UsePlaceOrderFormScriptResult = {
      * symbol (and therefore no per-asset leverage to read).
      */
     currentLeverage?: number;
+    /** Forwarded callback (see {@link UsePlaceOrderFormScriptParams.onUpdateLeverage}). */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
-declare function usePlaceOrderFormScript({ symbol, userAddress, maxLeverage: maxLeverageProp, onSuccess, onError, }: UsePlaceOrderFormScriptParams): UsePlaceOrderFormScriptResult;
+declare function usePlaceOrderFormScript({ symbol, userAddress, maxLeverage: maxLeverageProp, onSuccess, onError, onUpdateLeverage, }: UsePlaceOrderFormScriptParams): UsePlaceOrderFormScriptResult;
 
 type PlaceOrderFormUIProps = {
     methods: UseFormReturn<PlaceOrderFormData>;
@@ -2292,8 +2315,17 @@ type PlaceOrderFormUIProps = {
      * don't support a deposit flow don't render a dead control.
      */
     onAddFunds?: () => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage in
+     * the leverage modal. The widget tracks the returned promise to
+     * drive the modal's button loading state — when it rejects the
+     * modal stays open so the caller can retry. When omitted, the
+     * leverage value is committed to the form locally without contacting
+     * the exchange.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
-declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage: _maxLeverage, onAddFunds, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage: _maxLeverage, onAddFunds, onUpdateLeverage, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
 
 type PositionsWidgetProps = {
     userAddress?: string;

package/dist/index.d.ts

@@ -12,7 +12,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.2.18";
+declare const _default: "0.2.19";
 
 /**
  * Trading pair symbol format
@@ -2223,9 +2223,17 @@ type PlaceOrderFormWidgetProps = {
      * control.
      */
     onAddFunds?: () => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage value
+     * in the leverage modal. The host app should sign + relay the
+     * `updateLeverage` action to Hyperliquid and surface a toast. While
+     * the returned promise is pending the modal's button shows a spinner;
+     * if it rejects, the modal stays open so the user can retry.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
     className?: string;
 };
-declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormWidget({ symbol, userAddress, maxLeverage, onSuccess, onError, onAddFunds, onUpdateLeverage, className, }: PlaceOrderFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PlaceOrderFormData = {
     price?: number;
@@ -2242,6 +2250,19 @@ type UsePlaceOrderFormScriptParams = {
     maxLeverage?: number;
     onSuccess?: () => void;
     onError?: (error: Error) => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage value
+     * in the leverage modal. The host app is expected to sign + relay the
+     * `updateLeverage` action to Hyperliquid (and surface a toast). The
+     * widget tracks the returned promise to drive the modal's button
+     * loading state — when the promise rejects, the modal stays open so
+     * the user can retry.
+     *
+     * When omitted, the modal falls back to a local-only update: the
+     * leverage slider commits to the form state without contacting the
+     * exchange.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
 type UsePlaceOrderFormScriptResult = {
     form: ReturnType<typeof useForm<PlaceOrderFormData>>;
@@ -2265,8 +2286,10 @@ type UsePlaceOrderFormScriptResult = {
      * symbol (and therefore no per-asset leverage to read).
      */
     currentLeverage?: number;
+    /** Forwarded callback (see {@link UsePlaceOrderFormScriptParams.onUpdateLeverage}). */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
-declare function usePlaceOrderFormScript({ symbol, userAddress, maxLeverage: maxLeverageProp, onSuccess, onError, }: UsePlaceOrderFormScriptParams): UsePlaceOrderFormScriptResult;
+declare function usePlaceOrderFormScript({ symbol, userAddress, maxLeverage: maxLeverageProp, onSuccess, onError, onUpdateLeverage, }: UsePlaceOrderFormScriptParams): UsePlaceOrderFormScriptResult;
 
 type PlaceOrderFormUIProps = {
     methods: UseFormReturn<PlaceOrderFormData>;
@@ -2292,8 +2315,17 @@ type PlaceOrderFormUIProps = {
      * don't support a deposit flow don't render a dead control.
      */
     onAddFunds?: () => void;
+    /**
+     * Optional callback fired when the user confirms a new leverage in
+     * the leverage modal. The widget tracks the returned promise to
+     * drive the modal's button loading state — when it rejects the
+     * modal stays open so the caller can retry. When omitted, the
+     * leverage value is committed to the form locally without contacting
+     * the exchange.
+     */
+    onUpdateLeverage?: (leverage: number) => Promise<void>;
 };
-declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage: _maxLeverage, onAddFunds, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
+declare function PlaceOrderFormUI({ methods, side, orderType, onSideChange, onOrderTypeChange, onSubmit, isSubmitting, symbol, currentPrice, estimatedFee, liquidationPrice, availableMargin, accountValue, currentPosition, maxLeverage: _maxLeverage, onAddFunds, onUpdateLeverage, }: PlaceOrderFormUIProps): react_jsx_runtime.JSX.Element;
 
 type PositionsWidgetProps = {
     userAddress?: string;