@hfunlabs/hyperliquid 0.27.1-hfunlabs.5 → 0.29.1-hfunlabs.1

package/esm/src/transport/websocket/mod.js

@@ -1,213 +1,126 @@
-import { TransportError } from "../base.js";
+import { TransportError } from "../../_errors.js";
 import { AbortSignal_ } from "../_polyfills.js";
-import { ReconnectingWebSocket, ReconnectingWebSocketError } from "@nktkas/rews";
-import { HyperliquidEventTarget } from "./_hyperliquid_event_target.js";
-import { WebSocketAsyncRequest, WebSocketRequestError } from "./_websocket_async_request.js";
-export { ReconnectingWebSocketError, WebSocketRequestError };
-/** WebSocket implementation of the REST and Subscription transport interfaces. */
+import { ReconnectingWebSocket } from "@nktkas/rews";
+import { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
+import { WebSocketAsyncRequest, WebSocketRequestError } from "./_postRequest.js";
+import { WebSocketSubscriptionManager } from "./_subscriptionManager.js";
+export { WebSocketRequestError };
+/** Mainnet API WebSocket URL. */
+export const MAINNET_API_WS_URL = "wss://api.hyperliquid.xyz/ws";
+/** Testnet API WebSocket URL. */
+export const TESTNET_API_WS_URL = "wss://api.hyperliquid-testnet.xyz/ws";
+/** Mainnet RPC WebSocket URL. */
+export const MAINNET_RPC_WS_URL = "wss://rpc.hyperliquid.xyz/ws";
+/** Testnet RPC WebSocket URL. */
+export const TESTNET_RPC_WS_URL = "wss://rpc.hyperliquid-testnet.xyz/ws";
+/**
+ * WebSocket transport for Hyperliquid API.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests
+ */
 export class WebSocketTransport {
-    _wsRequester;
-    _hlEvents;
-    _keepAliveTimeout;
-    _subscriptions = new Map();
-    /** Indicates this transport uses testnet endpoint. */
     isTestnet;
-    /**
-     * Timeout for requests in ms.
-     * Set to `null` to disable.
-     */
     timeout;
-    /**
-     * Interval between sending ping messages in ms.
-     * Set to `null` to disable.
-     */
-    keepAliveInterval;
-    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
-    resubscribe;
     /** The WebSocket that is used for communication. */
     socket;
+    get resubscribe() {
+        return this._subscriptionManager.resubscribe;
+    }
+    set resubscribe(value) {
+        this._subscriptionManager.resubscribe = value;
+    }
+    _wsRequester;
+    _hlEvents;
+    _subscriptionManager;
+    _keepAliveInterval;
     /**
      * Creates a new WebSocket transport instance.
+     *
      * @param options - Configuration options for the WebSocket transport layer.
      */
     constructor(options) {
         this.isTestnet = options?.isTestnet ?? false;
         this.timeout = options?.timeout === undefined ? 10_000 : options.timeout;
-        this.keepAliveInterval = options?.keepAliveInterval ?? 30_000;
-        this.resubscribe = options?.resubscribe ?? true;
-        this.socket = new ReconnectingWebSocket(options?.url ?? (this.isTestnet ? "wss://api.hyperliquid-testnet.xyz/ws" : "wss://api.hyperliquid.xyz/ws"), options?.reconnect);
+        this.socket = new ReconnectingWebSocket(options?.url ?? (this.isTestnet ? TESTNET_API_WS_URL : MAINNET_API_WS_URL), options?.reconnect);
         this._hlEvents = new HyperliquidEventTarget(this.socket);
         this._wsRequester = new WebSocketAsyncRequest(this.socket, this._hlEvents);
-        // Initialize listeners
-        this.socket.addEventListener("open", () => {
-            this._keepAliveRun();
-            this._resubscribeRun();
-        });
-        const handleClose = () => {
-            this._keepAliveStop();
-            this._resubscribeStop();
-        };
-        this.socket.addEventListener("close", handleClose);
-        this.socket.addEventListener("error", handleClose);
+        this._subscriptionManager = new WebSocketSubscriptionManager(this.socket, this._wsRequester, this._hlEvents, options?.resubscribe ?? true);
+        this._initKeepAlive();
     }
-    /**
-     * Keep the connection alive.
-     * Sends ping only when no other requests were sent within the keep-alive interval.
-     */
-    _keepAliveRun() {
-        if (this.keepAliveInterval === null || this._keepAliveTimeout)
-            return;
-        const tick = async () => {
-            if (this.socket.readyState !== ReconnectingWebSocket.OPEN || !this._keepAliveTimeout ||
-                this.keepAliveInterval === null)
+    _initKeepAlive() {
+        const start = () => {
+            if (this._keepAliveInterval)
                 return;
-            // Check if the last request was sent more than the keep-alive interval ago
-            if (Date.now() - this._wsRequester.lastRequestTime >= this.keepAliveInterval) {
-                const timeoutSignal = this.timeout ? AbortSignal_.timeout(this.keepAliveInterval) : undefined;
-                await this._wsRequester.request("ping", timeoutSignal)
-                    .catch(() => undefined); // Ignore errors
-            }
-            // Schedule the next ping
-            if (this.socket.readyState === ReconnectingWebSocket.OPEN && this._keepAliveTimeout &&
-                this.keepAliveInterval !== null) {
-                const nextDelay = this.keepAliveInterval - (Date.now() - this._wsRequester.lastRequestTime);
-                this._keepAliveTimeout = setTimeout(tick, nextDelay);
-            }
+            this._keepAliveInterval = setInterval(() => {
+                this.socket.send('{"method":"ping"}');
+            }, 30_000);
         };
-        this._keepAliveTimeout = setTimeout(tick, this.keepAliveInterval);
-    }
-    _keepAliveStop() {
-        clearTimeout(this._keepAliveTimeout);
-        this._keepAliveTimeout = undefined;
-    }
-    /** Resubscribe to all existing subscriptions if auto-resubscribe is enabled. */
-    _resubscribeRun() {
-        if (this.resubscribe) {
-            for (const [id, subscription] of this._subscriptions.entries()) {
-                if (subscription.promiseFinished) { // reconnect only previously connected subscriptions to avoid double subscriptions due to message buffering.
-                    subscription.promise = this._wsRequester.request("subscribe", JSON.parse(id))
-                        .catch((error) => subscription.resubscribeAbortController.abort(error))
-                        .finally(() => subscription.promiseFinished = true);
-                    subscription.promiseFinished = false;
-                }
-            }
-        }
-    }
-    _resubscribeStop() {
-        if (!this.resubscribe || this.socket.terminationSignal.aborted) {
-            for (const subscriptionInfo of this._subscriptions.values()) {
-                for (const [_, unsubscribe] of subscriptionInfo.listeners) {
-                    unsubscribe(); // does not cause an error if used when the connection is closed
-                }
-            }
-        }
+        const stop = () => {
+            clearInterval(this._keepAliveInterval);
+            this._keepAliveInterval = undefined;
+        };
+        this.socket.addEventListener("open", start);
+        this.socket.addEventListener("close", stop);
+        this.socket.addEventListener("error", stop);
     }
     /**
      * Sends a request to the Hyperliquid API via WebSocket.
+     *
      * @param endpoint - The API endpoint to send the request to.
      * @param payload - The payload to send with the request.
-     * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request.
+     *
      * @returns A promise that resolves with parsed JSON response body.
+     *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
-    async request(type, payload, signal) {
-        try {
-            const timeoutSignal = this.timeout ? AbortSignal_.timeout(this.timeout) : undefined;
-            const combinedSignal = signal && timeoutSignal
-                ? AbortSignal_.any([signal, timeoutSignal])
-                : signal ?? timeoutSignal;
-            return await this._wsRequester.request("post", { type: type === "exchange" ? "action" : type, payload }, combinedSignal);
-        }
-        catch (error) {
+    async request(endpoint, payload, signal) {
+        const timeoutSignal = this.timeout ? AbortSignal_.timeout(this.timeout) : undefined;
+        const combinedSignal = signal && timeoutSignal
+            ? AbortSignal_.any([signal, timeoutSignal])
+            : signal ?? timeoutSignal;
+        const payload_ = { type: endpoint === "exchange" ? "action" : endpoint, payload };
+        return await this._wsRequester.request("post", payload_, combinedSignal)
+            .catch((error) => {
             if (error instanceof TransportError)
                 throw error; // Re-throw known errors
             throw new WebSocketRequestError(`Unknown error while making a WebSocket request: ${error}`, { cause: error });
-        }
+        });
     }
     /**
      * Subscribes to a Hyperliquid event channel.
      * Sends a subscription request to the server and listens for events.
+     *
      * @param channel - The event channel to listen to.
      * @param payload - A payload to send with the subscription request.
      * @param listener - A function to call when the event is dispatched.
-     * @returns A promise that resolves with a {@link Subscription} object to manage the subscription lifecycle.
+     *
+     * @returns A promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+     *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
-    async subscribe(channel, payload, listener) {
-        try {
-            // Create a unique identifier for the subscription
-            const id = WebSocketAsyncRequest.requestToId(payload);
-            // Initialize new subscription, if it doesn't exist
-            let subscription = this._subscriptions.get(id);
-            if (!subscription) {
-                // Send subscription request
-                const promise = this._wsRequester.request("subscribe", payload)
-                    .finally(() => subscription.promiseFinished = true);
-                // Cache subscription info
-                subscription = {
-                    listeners: new Map(),
-                    promise,
-                    promiseFinished: false,
-                    resubscribeAbortController: new AbortController(),
-                };
-                this._subscriptions.set(id, subscription);
-            }
-            // Initialize new listener, if it doesn't exist
-            let unsubscribe = subscription.listeners.get(listener);
-            if (!unsubscribe) {
-                // Create new unsubscribe function
-                unsubscribe = async () => {
-                    try {
-                        // Remove listener and cleanup
-                        this._hlEvents.removeEventListener(channel, listener);
-                        const subscription = this._subscriptions.get(id);
-                        subscription?.listeners.delete(listener);
-                        // If no listeners remain, remove subscription entirely
-                        if (subscription?.listeners.size === 0) {
-                            // Cleanup subscription
-                            this._subscriptions.delete(id);
-                            // If the socket is open, send unsubscription request
-                            if (this.socket.readyState === ReconnectingWebSocket.OPEN) {
-                                await this._wsRequester.request("unsubscribe", payload);
-                            }
-                        }
-                    }
-                    catch (error) {
-                        if (error instanceof TransportError)
-                            throw error; // Re-throw known errors
-                        throw new WebSocketRequestError(`Unknown error while unsubscribing from a WebSocket channel: ${error}`, { cause: error });
-                    }
-                };
-                // Add listener and cache unsubscribe function
-                this._hlEvents.addEventListener(channel, listener);
-                subscription.listeners.set(listener, unsubscribe);
-            }
-            // Wait for the initial subscription request to complete
-            await subscription.promise;
-            // Return subscription control object
-            return {
-                unsubscribe,
-                resubscribeSignal: subscription.resubscribeAbortController.signal,
-            };
-        }
-        catch (error) {
-            if (error instanceof TransportError)
-                throw error; // Re-throw known errors
-            throw new WebSocketRequestError(`Unknown error while subscribing to a WebSocket channel: ${error}`, { cause: error });
-        }
+    subscribe(channel, payload, listener) {
+        return this._subscriptionManager.subscribe(channel, payload, listener);
     }
     /**
      * Waits until the WebSocket connection is ready.
-     * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the promise by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     *
+     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     *
      * @returns A promise that resolves when the connection is ready.
+     *
+     * @throws {WebSocketRequestError} When the connection cannot be established.
      */
     ready(signal) {
         return new Promise((resolve, reject) => {
             const combinedSignal = signal
                 ? AbortSignal_.any([this.socket.terminationSignal, signal])
                 : this.socket.terminationSignal;
-            if (combinedSignal.aborted)
-                return reject(combinedSignal.reason);
+            if (combinedSignal.aborted) {
+                return reject(new WebSocketRequestError("Failed to establish WebSocket connection", { cause: combinedSignal.reason }));
+            }
             if (this.socket.readyState === ReconnectingWebSocket.OPEN)
                 return resolve();
             const handleOpen = () => {
@@ -216,7 +129,7 @@ export class WebSocketTransport {
             };
             const handleAbort = () => {
                 this.socket.removeEventListener("open", handleOpen);
-                reject(combinedSignal.reason);
+                return reject(new WebSocketRequestError("Failed to establish WebSocket connection", { cause: combinedSignal.reason }));
             };
             this.socket.addEventListener("open", handleOpen, { once: true });
             combinedSignal.addEventListener("abort", handleAbort, { once: true });
@@ -224,13 +137,18 @@ export class WebSocketTransport {
     }
     /**
      * Closes the WebSocket connection and waits until it is fully closed.
-     * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the promise by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     *
+     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     *
      * @returns A promise that resolves when the connection is fully closed.
+     *
+     * @throws {WebSocketRequestError} When the connection cannot be closed.
      */
     close(signal) {
         return new Promise((resolve, reject) => {
-            if (signal?.aborted)
-                return reject(signal.reason);
+            if (signal?.aborted) {
+                return reject(new WebSocketRequestError("Failed to close WebSocket connection", { cause: signal.reason }));
+            }
             if (this.socket.readyState === ReconnectingWebSocket.CLOSED)
                 return resolve();
             const handleClose = () => {
@@ -238,7 +156,7 @@ export class WebSocketTransport {
                 resolve();
             };
             const handleAbort = () => {
-                reject(signal?.reason);
+                return reject(new WebSocketRequestError("Failed to close WebSocket connection", { cause: signal?.reason }));
             };
             this.socket.addEventListener("close", handleClose, { once: true, signal });
             this.socket.addEventListener("error", handleClose, { once: true, signal });

package/esm/src/transport/websocket/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../../src/src/transport/websocket/mod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../../src/src/transport/websocket/mod.ts"],"names":[],"mappings":"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"}

package/esm/src/utils/format.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Format price according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * - Maximum 5 significant figures
+ * - Maximum 6 (for perp) or 8 (for spot) - `szDecimals` decimal places
+ * - Integer prices are always allowed regardless of significant figures
+ *
+ * @param price - The price to format (as string or number).
+ * @param szDecimals - The size decimals of the asset.
+ * @param type - The market type: "perp" for perpetuals or "spot" for spot markets. Default is "perp".
+ *
+ * @throws {RangeError} If the formatted price is 0
+ *
+ * @example
+ * ```ts
+ * import { formatPrice } from "@nktkas/hyperliquid/utils";
+ * const price = formatPrice("0.0000123456789", 0, "spot"); // → "0.00001234"
+ * ```
+ */
+export declare function formatPrice(price: string | number, szDecimals: number, type?: "perp" | "spot"): string;
+/**
+ * Format size according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * - Truncate decimal places to `szDecimals`
+ *
+ * @param size - The size to format (as string or number).
+ * @param szDecimals - The size decimals of the asset.
+ *
+ * @throws {RangeError} If the formatted size is 0
+ *
+ * @example
+ * ```ts
+ * import { formatSize } from "@nktkas/hyperliquid/utils";
+ *
+ * const size = formatSize("1.23456789", 5); // → "1.23456"
+ * ```
+ */
+export declare function formatSize(size: string | number, szDecimals: number): string;
+//# sourceMappingURL=format.d.ts.map

package/esm/src/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CAmB9G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAY5E"}

package/esm/src/utils/format.js

@@ -0,0 +1,174 @@
+/**
+ * Format price according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * - Maximum 5 significant figures
+ * - Maximum 6 (for perp) or 8 (for spot) - `szDecimals` decimal places
+ * - Integer prices are always allowed regardless of significant figures
+ *
+ * @param price - The price to format (as string or number).
+ * @param szDecimals - The size decimals of the asset.
+ * @param type - The market type: "perp" for perpetuals or "spot" for spot markets. Default is "perp".
+ *
+ * @throws {RangeError} If the formatted price is 0
+ *
+ * @example
+ * ```ts
+ * import { formatPrice } from "@nktkas/hyperliquid/utils";
+ * const price = formatPrice("0.0000123456789", 0, "spot"); // → "0.00001234"
+ * ```
+ */
+export function formatPrice(price, szDecimals, type = "perp") {
+    price = price.toString().trim();
+    assertNumberString(price);
+    // Integer prices are always allowed
+    if (/^-?\d+$/.test(price))
+        return formatDecimalString(price);
+    // Apply decimal limit: max 6 (perp) or 8 (spot) - szDecimals
+    const maxDecimals = Math.max((type === "perp" ? 6 : 8) - szDecimals, 0);
+    price = StringMath.toFixedTruncate(price, maxDecimals);
+    // Apply sig figs limit: max 5 significant figures
+    price = StringMath.toPrecisionTruncate(price, 5);
+    if (price === "0") {
+        throw new RangeError("Price is too small and was truncated to 0");
+    }
+    return price;
+}
+/**
+ * Format size according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * - Truncate decimal places to `szDecimals`
+ *
+ * @param size - The size to format (as string or number).
+ * @param szDecimals - The size decimals of the asset.
+ *
+ * @throws {RangeError} If the formatted size is 0
+ *
+ * @example
+ * ```ts
+ * import { formatSize } from "@nktkas/hyperliquid/utils";
+ *
+ * const size = formatSize("1.23456789", 5); // → "1.23456"
+ * ```
+ */
+export function formatSize(size, szDecimals) {
+    size = size.toString().trim();
+    assertNumberString(size);
+    // Apply decimal limit: szDecimals
+    size = StringMath.toFixedTruncate(size, szDecimals);
+    if (size === "0") {
+        throw new RangeError("Size is too small and was truncated to 0");
+    }
+    return size;
+}
+/** String-based Math operations for arbitrary precision */
+const StringMath = {
+    /** Floor log10 (magnitude): position of most significant digit */
+    log10Floor(value) {
+        const abs = value[0] === "-" ? value.slice(1) : value;
+        // Check if zero or invalid
+        const num = Number(abs);
+        if (num === 0 || isNaN(num))
+            return -Infinity;
+        const [int, dec] = abs.split(".");
+        // Number >= 1: magnitude = length of integer part - 1
+        if (Number(int) !== 0) {
+            const trimmed = int.replace(/^0+/, "");
+            return trimmed.length - 1;
+        }
+        // Number < 1: count leading zeros in decimal part
+        const leadingZeros = dec.match(/^0*/)?.[0].length ?? 0;
+        return -(leadingZeros + 1);
+    },
+    /** Multiply by 10^exp: shift decimal point left (negative) or right (positive) */
+    multiplyByPow10(value, exp) {
+        if (!Number.isInteger(exp))
+            throw new RangeError("Exponent must be an integer");
+        if (exp === 0)
+            return formatDecimalString(value);
+        const neg = value[0] === "-";
+        const abs = neg ? value.slice(1) : value;
+        const [intRaw, dec = ""] = abs.split(".");
+        // Normalize empty integer part to "0" (handles ".5" → "0.5")
+        const int = intRaw || "0";
+        let result;
+        if (exp > 0) {
+            // Shift right: move digits from decimal to integer
+            if (exp >= dec.length) {
+                result = int + dec + "0".repeat(exp - dec.length);
+            }
+            else {
+                result = int + dec.slice(0, exp) + "." + dec.slice(exp);
+            }
+        }
+        else {
+            // Shift left: move digits from integer to decimal
+            const absExp = -exp;
+            if (absExp >= int.length) {
+                result = "0." + "0".repeat(absExp - int.length) + int + dec;
+            }
+            else {
+                result = int.slice(0, -absExp) + "." + int.slice(-absExp) + dec;
+            }
+        }
+        return formatDecimalString((neg ? "-" : "") + result);
+    },
+    /** Returns the integer part of a number by removing any fractional digits */
+    trunc(value) {
+        const dotIndex = value.indexOf(".");
+        return dotIndex === -1 ? value : value.slice(0, dotIndex) || "0";
+    },
+    /** Truncate to a certain number of significant figures */
+    toPrecisionTruncate(value, precision) {
+        if (!Number.isInteger(precision))
+            throw new RangeError("Precision must be an integer");
+        if (precision < 1)
+            throw new RangeError("Precision must be positive");
+        if (/^-?0+(\.0*)?$/.test(value))
+            return "0"; // zero is special case (don't work with log10)
+        const neg = value[0] === "-";
+        const abs = neg ? value.slice(1) : value;
+        // Calculate how much to shift: align most significant digit to ones place + (maxSigFigs-1)
+        const magnitude = StringMath.log10Floor(abs);
+        const shiftAmount = precision - magnitude - 1;
+        // Shift right, truncate integer part, shift back
+        const shifted = StringMath.multiplyByPow10(abs, shiftAmount);
+        const truncated = StringMath.trunc(shifted);
+        const result = StringMath.multiplyByPow10(truncated, -shiftAmount);
+        // build final result and trim zeros
+        return formatDecimalString(neg ? "-" + result : result);
+    },
+    /** Truncate to a certain number of decimal places */
+    toFixedTruncate(value, decimals) {
+        if (!Number.isInteger(decimals))
+            throw new RangeError("Decimals must be an integer");
+        if (decimals < 0)
+            throw new RangeError("Decimals must be non-negative");
+        // Match number with up to `decimals` decimal places
+        const regex = new RegExp(`^-?(?:\\d+)?(?:\\.\\d{0,${decimals}})?`);
+        const result = value.match(regex)?.[0];
+        if (!result) {
+            throw new TypeError("Invalid number format");
+        }
+        // Trim zeros after truncation
+        return formatDecimalString(result);
+    },
+};
+function formatDecimalString(value) {
+    return value
+        // remove leading/trailing whitespace
+        .trim() // "  123.45  " → "123.45"
+        // remove leading zeros
+        .replace(/^(-?)0+(?=\d)/, "$1") // "00123" → "123", "-00.5" → "-0.5"
+        // remove trailing zeros
+        .replace(/\.0*$|(\.\d+?)0+$/, "$1") // "1.2000" → "1.2", "5.0" → "5"
+        // add leading zero if starts with decimal point
+        .replace(/^(-?)\./, "$10.") // ".5" → "0.5", "-.5" → "-0.5"
+        // add "0" if string is empty after trimming
+        .replace(/^-?$/, "0") // "" → "0", "-" → "0"
+        // normalize negative zero
+        .replace(/^-0$/, "0"); // "-0" → "0"
+}
+function assertNumberString(value) {
+    if (!/^-?(\d+\.?\d*|\.\d*)$/.test(value)) {
+        throw new TypeError("Invalid number format");
+    }
+}
+//# sourceMappingURL=format.js.map

package/esm/src/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/src/utils/format.ts"],"names":[],"mappings":"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"}

package/esm/src/utils/mod.d.ts

@@ -1,4 +1,3 @@
-export * from "./_symbolConverter.js";
-export * from "./_format.js";
-export * from "./_recover.js";
+export * from "./symbolConverter.js";
+export * from "./format.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/src/utils/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/esm/src/utils/mod.js

@@ -1,4 +1,3 @@
-export * from "./_symbolConverter.js";
-export * from "./_format.js";
-export * from "./_recover.js";
+export * from "./symbolConverter.js";
+export * from "./format.js";
 //# sourceMappingURL=mod.js.map

package/esm/src/utils/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}