@lifi/perps-sdk 0.2.0-alpha.0 → 1.0.1

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

@@ -0,0 +1,66 @@
+/**
+ * Options shared by the human-facing display formatters.
+ *
+ * @public
+ */
+export interface FormatOptions {
+    /** Fixed number of decimal places. Defaults are per-formatter. */
+    decimals?: number;
+    /** Rendered when the value is null/undefined/NaN/non-finite. Defaults to `'—'`. */
+    placeholder?: string;
+    /** BCP 47 locale controlling digit grouping and separators (e.g. `'en-US'`). */
+    locale?: string;
+}
+type FormatInput = number | string | null | undefined;
+/**
+ * Format a USD value, unsigned: `$1,234.50`, `-$1,500.00`, `$0.00`.
+ *
+ * Two decimal places with locale digit grouping. Negatives place the `-`
+ * before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatUsd(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a USD value with an explicit sign: `+$1.43`, `-$1.43`, `$0.00`.
+ *
+ * The sign is derived after rounding, so sub-cent magnitudes render `$0.00`
+ * (no spurious `+`/`-`). Null/undefined/non-finite input renders the
+ * placeholder.
+ *
+ * @public
+ */
+export declare function formatSignedUsd(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a percentage with an explicit sign and no grouping: `+1.43%`,
+ * `-1.43%`, `0.00%`.
+ *
+ * The sign is derived after rounding, so sub-threshold magnitudes render
+ * `0.00%`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatSignedPercent(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a price, unsigned, with decimals auto-detected from magnitude:
+ * `$1,234.50`, `$0.1234`, `-$1,500.00`.
+ *
+ * Decimals follow {@link autoDecimals} unless `options.decimals` is given.
+ * Grouping applies once the absolute value reaches 1000. Negatives place the
+ * `-` before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatPrice(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a USD value compactly with a `B`/`M`/`K` suffix: `$1.23B`, `$45.6M`,
+ * `$789.0K`, `$12.34`.
+ *
+ * Negatives place the `-` before the `$`. Null/undefined/non-finite input
+ * renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatCompactUsd(value: FormatInput, options?: FormatOptions): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AA+DrD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAcR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAcR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAUR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkBR"}

package/dist/esm/utils/format.js

@@ -0,0 +1,171 @@
+const DEFAULT_PLACEHOLDER = '—';
+/**
+ * Tolerantly coerce a display input to a finite number.
+ *
+ * Strips `$`, `,`, and surrounding whitespace from strings. Returns `null`
+ * when the value is null/undefined/blank or does not resolve to a finite
+ * number, so callers can render a placeholder instead of `$0.00` or `$NaN`.
+ */
+function toFiniteNumber(value) {
+    let n;
+    if (typeof value === 'string') {
+        const cleaned = value.replace(/[$,\s]/g, '');
+        if (!cleaned) {
+            return null;
+        }
+        n = Number(cleaned);
+    }
+    else if (typeof value === 'number') {
+        n = value;
+    }
+    else {
+        return null;
+    }
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Round to `decimals` then split into a sign (`'-'` or `''`) and the
+ * locale-formatted absolute body. Deriving the sign from the rounded value
+ * avoids `-$0.00` for values that round to zero.
+ */
+function signAndBody(n, decimals, locale, grouping) {
+    const rounded = Number(n.toFixed(decimals));
+    const sign = rounded < 0 ? '-' : '';
+    const body = Math.abs(rounded).toLocaleString(locale, {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        useGrouping: grouping,
+    });
+    return { sign, body };
+}
+/**
+ * Auto-detect a sensible number of decimal places from a value's magnitude:
+ * `>=1` → 2, `>=0.1` → 4, `>=0.01` → 5, otherwise 6.
+ */
+function autoDecimals(abs) {
+    if (abs >= 1) {
+        return 2;
+    }
+    if (abs >= 0.1) {
+        return 4;
+    }
+    if (abs >= 0.01) {
+        return 5;
+    }
+    return 6;
+}
+/**
+ * Format a USD value, unsigned: `$1,234.50`, `-$1,500.00`, `$0.00`.
+ *
+ * Two decimal places with locale digit grouping. Negatives place the `-`
+ * before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export function formatUsd(value, options = {}) {
+    const { decimals = 2, placeholder = DEFAULT_PLACEHOLDER, locale } = options;
+    const n = toFiniteNumber(value);
+    if (n === null) {
+        return placeholder;
+    }
+    const { sign, body } = signAndBody(n, decimals, locale, true);
+    return `${sign}$${body}`;
+}
+/**
+ * Format a USD value with an explicit sign: `+$1.43`, `-$1.43`, `$0.00`.
+ *
+ * The sign is derived after rounding, so sub-cent magnitudes render `$0.00`
+ * (no spurious `+`/`-`). Null/undefined/non-finite input renders the
+ * placeholder.
+ *
+ * @public
+ */
+export function formatSignedUsd(value, options = {}) {
+    const { decimals = 2, placeholder = DEFAULT_PLACEHOLDER, locale } = options;
+    const n = toFiniteNumber(value);
+    if (n === null) {
+        return placeholder;
+    }
+    const rounded = Number(n.toFixed(decimals));
+    const sign = rounded > 0 ? '+' : rounded < 0 ? '-' : '';
+    const body = Math.abs(rounded).toLocaleString(locale, {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        useGrouping: true,
+    });
+    return `${sign}$${body}`;
+}
+/**
+ * Format a percentage with an explicit sign and no grouping: `+1.43%`,
+ * `-1.43%`, `0.00%`.
+ *
+ * The sign is derived after rounding, so sub-threshold magnitudes render
+ * `0.00%`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export function formatSignedPercent(value, options = {}) {
+    const { decimals = 2, placeholder = DEFAULT_PLACEHOLDER, locale } = options;
+    const n = toFiniteNumber(value);
+    if (n === null) {
+        return placeholder;
+    }
+    const rounded = Number(n.toFixed(decimals));
+    const sign = rounded > 0 ? '+' : rounded < 0 ? '-' : '';
+    const body = Math.abs(rounded).toLocaleString(locale, {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        useGrouping: false,
+    });
+    return `${sign}${body}%`;
+}
+/**
+ * Format a price, unsigned, with decimals auto-detected from magnitude:
+ * `$1,234.50`, `$0.1234`, `-$1,500.00`.
+ *
+ * Decimals follow {@link autoDecimals} unless `options.decimals` is given.
+ * Grouping applies once the absolute value reaches 1000. Negatives place the
+ * `-` before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export function formatPrice(value, options = {}) {
+    const { placeholder = DEFAULT_PLACEHOLDER, locale } = options;
+    const n = toFiniteNumber(value);
+    if (n === null) {
+        return placeholder;
+    }
+    const abs = Math.abs(n);
+    const decimals = options.decimals ?? autoDecimals(abs);
+    const { sign, body } = signAndBody(n, decimals, locale, abs >= 1000);
+    return `${sign}$${body}`;
+}
+/**
+ * Format a USD value compactly with a `B`/`M`/`K` suffix: `$1.23B`, `$45.6M`,
+ * `$789.0K`, `$12.34`.
+ *
+ * Negatives place the `-` before the `$`. Null/undefined/non-finite input
+ * renders the placeholder.
+ *
+ * @public
+ */
+export function formatCompactUsd(value, options = {}) {
+    const { decimals = 2, placeholder = DEFAULT_PLACEHOLDER } = options;
+    const n = toFiniteNumber(value);
+    if (n === null) {
+        return placeholder;
+    }
+    const sign = n < 0 ? '-' : '';
+    const abs = Math.abs(n);
+    if (abs >= 1_000_000_000) {
+        return `${sign}$${(abs / 1_000_000_000).toFixed(decimals)}B`;
+    }
+    if (abs >= 1_000_000) {
+        return `${sign}$${(abs / 1_000_000).toFixed(decimals)}M`;
+    }
+    if (abs >= 1_000) {
+        return `${sign}$${(abs / 1_000).toFixed(decimals)}K`;
+    }
+    return `${sign}$${abs.toFixed(decimals)}`;
+}
+//# sourceMappingURL=format.js.map

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

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

package/dist/esm/utils/orderClassification.d.ts

@@ -6,24 +6,42 @@
  * for classification — no string matching.
  */
 import type { OpenOrder } from '@lifi/perps-types';
-import { FillClassification, OrderSide } from '@lifi/perps-types';
+import { FillClassification, OrderSide, OrderStatus } from '@lifi/perps-types';
 export { FillClassification };
 /**
  * Check if an open order is a Take Profit trigger order.
+ * @public
  */
 export declare function isTakeProfitOrder(order: Pick<OpenOrder, 'type'>): boolean;
 /**
  * Check if an open order is a Stop Loss trigger order.
+ * @public
  */
 export declare function isStopLossOrder(order: Pick<OpenOrder, 'type'>): boolean;
 /**
  * Check if an open order is a TP or SL trigger order.
+ * @public
  */
 export declare function isTpSlOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Order statuses representing an order still resting on the book (visible
+ * in `openOrders` / `triggerOrders`). Anything not in this set is terminal —
+ * filled, cancelled, rejected, expired — and should be evicted from the
+ * cached orders list when seen in a WS update.
+ * @public
+ */
+export declare const ACTIVE_ORDER_STATUSES: ReadonlySet<OrderStatus>;
+/**
+ * Whether `status` is one of {@link ACTIVE_ORDER_STATUSES}.
+ *
+ * @public
+ */
+export declare function isActiveOrderStatus(status: OrderStatus): boolean;
 /**
  * Classify a fill as open or close based on realizedPnl.
  * @deprecated Use `Fill.classification` instead — it uses startPosition
  * for accurate open/increase/reduce/close/reverse classification.
+ * @public
  */
 export declare function classifyFill(side: OrderSide, realizedPnl: string | null | undefined): FillClassification;
 //# sourceMappingURL=orderClassification.d.ts.map

package/dist/esm/utils/orderClassification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orderClassification.d.ts","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAA;AAG5E,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAY7B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,kBAAkB,CAUpB"}
+{"version":3,"file":"orderClassification.d.ts","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EAEZ,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAY7B;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,WAAW,CAKzD,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,kBAAkB,CAUpB"}

package/dist/esm/utils/orderClassification.js

@@ -5,7 +5,7 @@
  * order categories (TP/SL, open/close). These use the OrderType enum
  * for classification — no string matching.
  */
-import { FillClassification, OrderSide, OrderType } from '@lifi/perps-types';
+import { FillClassification, OrderSide, OrderStatus, OrderType, } from '@lifi/perps-types';
 import { stringToFloat } from './parse.js';
 export { FillClassification };
 const TP_TYPES = new Set([
@@ -18,26 +18,51 @@ const SL_TYPES = new Set([
 ]);
 /**
  * Check if an open order is a Take Profit trigger order.
+ * @public
  */
 export function isTakeProfitOrder(order) {
     return TP_TYPES.has(order.type);
 }
 /**
  * Check if an open order is a Stop Loss trigger order.
+ * @public
  */
 export function isStopLossOrder(order) {
     return SL_TYPES.has(order.type);
 }
 /**
  * Check if an open order is a TP or SL trigger order.
+ * @public
  */
 export function isTpSlOrder(order) {
     return TP_TYPES.has(order.type) || SL_TYPES.has(order.type);
 }
+/**
+ * Order statuses representing an order still resting on the book (visible
+ * in `openOrders` / `triggerOrders`). Anything not in this set is terminal —
+ * filled, cancelled, rejected, expired — and should be evicted from the
+ * cached orders list when seen in a WS update.
+ * @public
+ */
+export const ACTIVE_ORDER_STATUSES = new Set([
+    OrderStatus.OPEN,
+    OrderStatus.PENDING,
+    OrderStatus.PARTIALLY_FILLED,
+    OrderStatus.TRIGGERED,
+]);
+/**
+ * Whether `status` is one of {@link ACTIVE_ORDER_STATUSES}.
+ *
+ * @public
+ */
+export function isActiveOrderStatus(status) {
+    return ACTIVE_ORDER_STATUSES.has(status);
+}
 /**
  * Classify a fill as open or close based on realizedPnl.
  * @deprecated Use `Fill.classification` instead — it uses startPosition
  * for accurate open/increase/reduce/close/reverse classification.
+ * @public
  */
 export function classifyFill(side, realizedPnl) {
     const isClose = realizedPnl != null && stringToFloat(realizedPnl) !== 0;

package/dist/esm/utils/orderClassification.js.map

@@ -1 +1 @@
-{"version":3,"file":"orderClassification.js","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY;IAClC,SAAS,CAAC,kBAAkB;IAC5B,SAAS,CAAC,iBAAiB;CAC5B,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY;IAClC,SAAS,CAAC,WAAW;IACrB,SAAS,CAAC,UAAU;CACrB,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA8B;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAA8B;IAC5D,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAe,EACf,WAAsC;IAEtC,MAAM,OAAO,GAAG,WAAW,IAAI,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACvE,IAAI,IAAI,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,OAAO;YACZ,CAAC,CAAC,kBAAkB,CAAC,YAAY;YACjC,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAA;IACpC,CAAC;IACD,OAAO,OAAO;QACZ,CAAC,CAAC,kBAAkB,CAAC,WAAW;QAChC,CAAC,CAAC,kBAAkB,CAAC,YAAY,CAAA;AACrC,CAAC"}
+{"version":3,"file":"orderClassification.js","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY;IAClC,SAAS,CAAC,kBAAkB;IAC5B,SAAS,CAAC,iBAAiB;CAC5B,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY;IAClC,SAAS,CAAC,WAAW;IACrB,SAAS,CAAC,UAAU;CACrB,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA8B;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAA8B;IAC5D,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B,IAAI,GAAG,CAAC;IACrE,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,gBAAgB;IAC5B,WAAW,CAAC,SAAS;CACtB,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAe,EACf,WAAsC;IAEtC,MAAM,OAAO,GAAG,WAAW,IAAI,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACvE,IAAI,IAAI,KAAK,SAAS,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,OAAO;YACZ,CAAC,CAAC,kBAAkB,CAAC,YAAY;YACjC,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAA;IACpC,CAAC;IACD,OAAO,OAAO;QACZ,CAAC,CAAC,kBAAkB,CAAC,WAAW;QAChC,CAAC,CAAC,kBAAkB,CAAC,YAAY,CAAA;AACrC,CAAC"}

package/dist/esm/utils/orderMath.d.ts

@@ -1,11 +1,12 @@
 import { type OpenOrder, type Position, type TriggerOrder } from '@lifi/perps-types';
 /**
- * Pick the matching open position for an order's asset, if any.
+ * Pick the matching open position for an order's market, if any.
  *
- * @param assetId - The order's `asset.assetId`.
- * @param positions - Open positions list (any symbol).
+ * @param marketId - The order's `market.id`.
+ * @param positions - Open positions list (any market).
+ * @public
  */
-export declare function findMatchingPosition(assetId: string, positions: readonly Position[]): Position | undefined;
+export declare function findMatchingPosition(marketId: string, positions: readonly Position[]): Position | undefined;
 /**
  * Resolve the close-size against a position, applying the spec's cap rules:
  *  - `orderSize === 0` is the Hyperliquid convention for "close entire
@@ -14,6 +15,7 @@ export declare function findMatchingPosition(assetId: string, positions: readonl
  *    position can only close what's open.
  *
  * Inputs are non-negative magnitudes.
+ * @public
  */
 export declare function resolveCloseSize(orderSize: number, positionSize: number): number;
 /**
@@ -24,6 +26,7 @@ export declare function resolveCloseSize(orderSize: number, positionSize: number
  *
  * @returns Realised PnL if the order would reduce the position, otherwise
  *   `null`.
+ * @public
  */
 export declare function expectedRealizedPnlForOpenOrder(order: OpenOrder, position: Position | undefined): number | null;
 /**
@@ -35,6 +38,7 @@ export declare function expectedRealizedPnlForOpenOrder(order: OpenOrder, positi
  * `TriggerOrder` shape) is used as the rPnL price; the optional `limitPrice`
  * for STOP_LIMIT / TAKE_PROFIT_LIMIT is the post-trigger limit, not the rPnL
  * price.
+ * @public
  */
 export declare function expectedRealizedPnlForTriggerOrder(order: TriggerOrder, position: Position | undefined): number | null;
 //# sourceMappingURL=orderMath.d.ts.map

package/dist/esm/utils/orderMath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orderMath.d.ts","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,QAAQ,EAEb,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAkCf;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA2Bf"}
+{"version":3,"file":"orderMath.d.ts","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,QAAQ,EAEb,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAkCf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA2Bf"}

package/dist/esm/utils/orderMath.js

@@ -1,13 +1,14 @@
 import { OrderSide, PositionSide, } from '@lifi/perps-types';
 import { realizedPnlOnClose } from './positionMath.js';
 /**
- * Pick the matching open position for an order's asset, if any.
+ * Pick the matching open position for an order's market, if any.
  *
- * @param assetId - The order's `asset.assetId`.
- * @param positions - Open positions list (any symbol).
+ * @param marketId - The order's `market.id`.
+ * @param positions - Open positions list (any market).
+ * @public
  */
-export function findMatchingPosition(assetId, positions) {
-    return positions.find((p) => p.asset.assetId === assetId);
+export function findMatchingPosition(marketId, positions) {
+    return positions.find((p) => p.market.id === marketId);
 }
 /**
  * Resolve the close-size against a position, applying the spec's cap rules:
@@ -17,6 +18,7 @@ export function findMatchingPosition(assetId, positions) {
  *    position can only close what's open.
  *
  * Inputs are non-negative magnitudes.
+ * @public
  */
 export function resolveCloseSize(orderSize, positionSize) {
     if (orderSize === 0) {
@@ -32,6 +34,7 @@ export function resolveCloseSize(orderSize, positionSize) {
  *
  * @returns Realised PnL if the order would reduce the position, otherwise
  *   `null`.
+ * @public
  */
 export function expectedRealizedPnlForOpenOrder(order, position) {
     if (!position) {
@@ -71,6 +74,7 @@ export function expectedRealizedPnlForOpenOrder(order, position) {
  * `TriggerOrder` shape) is used as the rPnL price; the optional `limitPrice`
  * for STOP_LIMIT / TAKE_PROFIT_LIMIT is the post-trigger limit, not the rPnL
  * price.
+ * @public
  */
 export function expectedRealizedPnlForTriggerOrder(order, position) {
     if (!position) {

package/dist/esm/utils/orderMath.js.map

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

package/dist/esm/utils/parse.d.ts

@@ -1,6 +1,3 @@
-/**
- * Robust string-to-number parsing utilities.
- */
 /**
  * Parse a string to a float, stripping common formatting artefacts.
  *
@@ -11,8 +8,14 @@
  * - Percentage suffixes (%)
  * - Whitespace
  *
- * @param value - The string to parse
- * @returns Parsed number, or NaN if the string contains no valid number
+ * @returns Parsed number; `0` for empty/blank input, `NaN` when a non-empty
+ *   string contains no parseable number
+ * @example
+ * ```ts
+ * stringToFloat('$1,234.50') // 1234.5
+ * stringToFloat('') // 0
+ * ```
+ * @public
  */
 export declare function stringToFloat(value: string): number;
 //# sourceMappingURL=parse.d.ts.map

package/dist/esm/utils/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD"}

package/dist/esm/utils/parse.js

@@ -1,6 +1,3 @@
-/**
- * Robust string-to-number parsing utilities.
- */
 /**
  * Parse a string to a float, stripping common formatting artefacts.
  *
@@ -11,14 +8,19 @@
  * - Percentage suffixes (%)
  * - Whitespace
  *
- * @param value - The string to parse
- * @returns Parsed number, or NaN if the string contains no valid number
+ * @returns Parsed number; `0` for empty/blank input, `NaN` when a non-empty
+ *   string contains no parseable number
+ * @example
+ * ```ts
+ * stringToFloat('$1,234.50') // 1234.5
+ * stringToFloat('') // 0
+ * ```
+ * @public
  */
 export function stringToFloat(value) {
     if (!value) {
         return 0;
     }
-    // Strip whitespace, currency symbols, thousands commas, and % suffix
     const cleaned = value.trim().replace(/[$%]/g, '').replace(/,/g, '').trim();
     if (!cleaned) {
         return 0;

package/dist/esm/utils/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAA;IACV,CAAC;IACD,qEAAqE;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAA;IACV,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC"}

package/dist/esm/utils/positionMath.d.ts

@@ -10,8 +10,33 @@
  *
  * @param isLong - True for long positions, false for short.
  * @returns +1 for long, -1 for short.
+ * @public
  */
 export declare function directionSign(isLong: boolean): 1 | -1;
+/**
+ * Estimated liquidation price for an isolated-margin position, parameterised
+ * by the venue's maintenance margin rate.
+ *
+ * Standard isolated-margin model (new position, no existing exposure):
+ *   margin_per_unit      = entryPrice / leverage
+ *   maintenance_per_unit = entryPrice * mmr
+ *   margin_available     = margin_per_unit - maintenance_per_unit
+ *   liq_price            = entryPrice - side * margin_available / (1 - mmr * side)
+ *
+ * For existing positions, prefer `Position.liquidationPrice` from the venue.
+ *
+ * @param maintenanceMarginRate - Venue maintenance margin rate as a fraction
+ *   (e.g. 0.01 = 1%).
+ * @returns Estimated liquidation price, or undefined if the inputs cannot
+ *   produce one (zero leverage, degenerate denominator).
+ * @public
+ */
+export declare function estimateIsolatedLiquidationPrice(params: {
+    entryPrice: number;
+    leverage: number;
+    isLong: boolean;
+    maintenanceMarginRate: number;
+}): number | undefined;
 /**
  * Predicted average entry price after adding to an existing position.
  *
@@ -26,6 +51,7 @@ export declare function directionSign(isLong: boolean): 1 | -1;
  *   market, limitPrice for limit orders).
  * @returns The new weighted-average entry price, or undefined if the inputs
  *   cannot produce a valid average (zero combined size, non-finite values).
+ * @public
  */
 export declare function predictAverageEntryPrice(params: {
     currentSize: number;
@@ -42,6 +68,7 @@ export declare function predictAverageEntryPrice(params: {
  *
  * @returns The new effective leverage, or undefined if total margin is
  *   non-positive.
+ * @public
  */
 export declare function predictNewLeverage(params: {
     currentNotional: number;
@@ -55,6 +82,7 @@ export declare function predictNewLeverage(params: {
  * `pnl = (markPrice - entryPrice) * size * directionSign(isLong)`
  *
  * @param size - Position size as a non-negative magnitude.
+ * @public
  */
 export declare function predictUnrealizedPnl(params: {
     entryPrice: number;
@@ -68,6 +96,7 @@ export declare function predictUnrealizedPnl(params: {
  * `rPnl = (closePrice - entryPrice) * closeSize * directionSign(isLong)`
  *
  * @param closeSize - Size being closed as a non-negative magnitude.
+ * @public
  */
 export declare function realizedPnlOnClose(params: {
     entryPrice: number;

package/dist/esm/utils/positionMath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"positionMath.d.ts","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAErD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAUrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT"}
+{"version":3,"file":"positionMath.d.ts","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAErD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,qBAAqB,EAAE,MAAM,CAAA;CAC9B,GAAG,MAAM,GAAG,SAAS,CAYrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAUrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAGT"}