@nktkas/hyperliquid 0.31.0 → 0.32.0

package/src/utils/_symbolConverter.ts

@@ -0,0 +1,254 @@
+import {
+  meta,
+  type MetaResponse,
+  perpDexs,
+  type PerpDexsResponse,
+  spotMeta,
+  type SpotMetaResponse,
+} from "../api/info/mod.js";
+import type { IRequestTransport } from "../transport/mod.js";
+
+/** Options for creating a {@link SymbolConverter} instance. */
+export interface SymbolConverterOptions {
+  /** Transport instance to use for API requests. */
+  transport: IRequestTransport;
+  /** Optional dex support: array of dex names, true for all dexs, or false/undefined to skip. */
+  dexs?: string[] | boolean;
+}
+
+/**
+ * Utility class for converting asset symbols to their corresponding IDs and size decimals.
+ * Supports perpetuals, spot markets, and optional builder dexs.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const converter = await SymbolConverter.create({ transport });
+ *
+ * // By default, dexs are not loaded; specify them when creating an instance
+ * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
+ *
+ * const btcId = converter.getAssetId("BTC"); // perpetual → 0
+ * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
+ * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
+ *
+ * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
+ * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
+ * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+ *
+ * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
+ */
+export class SymbolConverter {
+  private _transport: IRequestTransport;
+  private _dexOption: string[] | boolean;
+  private _nameToAssetId = new Map<string, number>();
+  private _nameToSzDecimals = new Map<string, number>();
+  private _nameToSpotPairId = new Map<string, string>();
+
+  /**
+   * Creates a new SymbolConverter instance, but does not initialize it.
+   * Run {@link reload} to load asset data or use {@link create} to create and initialize in one step.
+   *
+   * @param options Configuration options including transport and optional dex support.
+   */
+  constructor(options: SymbolConverterOptions) {
+    this._transport = options.transport;
+    this._dexOption = options.dexs ?? false;
+  }
+
+  /**
+   * Create and initialize a SymbolConverter instance.
+   *
+   * @param options Configuration options including transport and optional dex support.
+   * @return Initialized SymbolConverter instance.
+   *
+   * @example
+   * ```ts
+   * import { HttpTransport } from "@nktkas/hyperliquid";
+   * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+   *
+   * const transport = new HttpTransport(); // or `WebSocketTransport`
+   * const converter = await SymbolConverter.create({ transport });
+   * ```
+   */
+  static async create(options: SymbolConverterOptions): Promise<SymbolConverter> {
+    const instance = new SymbolConverter(options);
+    await instance.reload();
+    return instance;
+  }
+
+  /**
+   * Reload asset mappings from the API.
+   *
+   * Useful for refreshing data when new assets are added.
+   */
+  async reload(): Promise<void> {
+    const config = { transport: this._transport };
+    const needDexs = this._dexOption === true || (Array.isArray(this._dexOption) && this._dexOption.length > 0);
+
+    const [perpMetaData, spotMetaData, perpDexsData] = await Promise.all([
+      meta(config),
+      spotMeta(config),
+      needDexs ? perpDexs(config) : undefined,
+    ]);
+
+    if (!perpMetaData?.universe?.length) {
+      throw new Error("Invalid perpetual metadata response");
+    }
+
+    if (!spotMetaData?.universe?.length || !spotMetaData?.tokens?.length) {
+      throw new Error("Invalid spot metadata response");
+    }
+
+    this._nameToAssetId.clear();
+    this._nameToSzDecimals.clear();
+    this._nameToSpotPairId.clear();
+
+    this._processDefaultPerps(perpMetaData);
+    this._processSpotAssets(spotMetaData);
+
+    // Only process builder dexs if dex support is enabled
+    if (perpDexsData) {
+      await this._processBuilderDexs(perpDexsData);
+    }
+  }
+
+  private _processDefaultPerps(perpMetaData: MetaResponse): void {
+    perpMetaData.universe.forEach((asset, index) => {
+      this._nameToAssetId.set(asset.name, index);
+      this._nameToSzDecimals.set(asset.name, asset.szDecimals);
+    });
+  }
+
+  private async _processBuilderDexs(perpDexsData: PerpDexsResponse): Promise<void> {
+    if (!perpDexsData || perpDexsData.length <= 1) return;
+
+    const builderDexs = perpDexsData
+      .map((dex, index) => ({ dex, index }))
+      .filter((item): item is { dex: NonNullable<PerpDexsResponse[number]>; index: number } => {
+        return item.index > 0 && item.dex !== null && item.dex.name.length > 0;
+      });
+
+    if (builderDexs.length === 0) return;
+
+    // Filter dexs based on the dexOption
+    const dexsToProcess = Array.isArray(this._dexOption)
+      ? builderDexs.filter((item) => (this._dexOption as string[]).includes(item.dex.name))
+      : builderDexs; // true means process all
+
+    if (dexsToProcess.length === 0) return;
+
+    const config = { transport: this._transport };
+    const results = await Promise.allSettled(
+      dexsToProcess.map((item) => meta(config, { dex: item.dex.name })),
+    );
+
+    results.forEach((result, idx) => {
+      if (result.status !== "fulfilled") return;
+      this._processBuilderDexResult(result.value, dexsToProcess[idx].index);
+    });
+  }
+
+  private _processBuilderDexResult(dexMeta: MetaResponse, perpDexIndex: number): void {
+    const offset = 100000 + perpDexIndex * 10000;
+
+    dexMeta.universe.forEach((asset, index) => {
+      const assetId = offset + index;
+      this._nameToAssetId.set(asset.name, assetId);
+      this._nameToSzDecimals.set(asset.name, asset.szDecimals);
+    });
+  }
+
+  private _processSpotAssets(spotMetaData: SpotMetaResponse): void {
+    const tokenMap = new Map<number, { name: string; szDecimals: number }>();
+    spotMetaData.tokens.forEach((token) => {
+      tokenMap.set(token.index, { name: token.name, szDecimals: token.szDecimals });
+    });
+
+    spotMetaData.universe.forEach((market) => {
+      if (market.tokens.length < 2) return;
+      const baseToken = tokenMap.get(market.tokens[0]);
+      const quoteToken = tokenMap.get(market.tokens[1]);
+      if (!baseToken || !quoteToken) return;
+
+      const assetId = 10000 + market.index;
+      const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
+      this._nameToAssetId.set(baseQuoteKey, assetId);
+      this._nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
+      this._nameToSpotPairId.set(baseQuoteKey, market.name);
+    });
+  }
+
+  /**
+   * Get asset ID for a coin.
+   * - For Perpetuals, use the coin name (e.g., "BTC").
+   * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
+   * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
+   *
+   * @example
+   * ```ts
+   * import { HttpTransport } from "@nktkas/hyperliquid";
+   * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+   *
+   * const transport = new HttpTransport(); // or `WebSocketTransport`
+   * const converter = await SymbolConverter.create({ transport });
+   *
+   * converter.getAssetId("BTC"); // → 0
+   * converter.getAssetId("HYPE/USDC"); // → 10107
+   * converter.getAssetId("test:ABC"); // → 110000
+   * ```
+   */
+  getAssetId(name: string): number | undefined {
+    return this._nameToAssetId.get(name);
+  }
+
+  /**
+   * Get size decimals for a coin.
+   * - For Perpetuals, use the coin name (e.g., "BTC").
+   * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
+   * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
+   *
+   * @example
+   * ```ts
+   * import { HttpTransport } from "@nktkas/hyperliquid";
+   * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+   *
+   * const transport = new HttpTransport(); // or `WebSocketTransport`
+   * const converter = await SymbolConverter.create({ transport });
+   *
+   * converter.getSzDecimals("BTC"); // → 5
+   * converter.getSzDecimals("HYPE/USDC"); // → 2
+   * converter.getSzDecimals("test:ABC"); // → 0
+   * ```
+   */
+  getSzDecimals(name: string): number | undefined {
+    return this._nameToSzDecimals.get(name);
+  }
+
+  /**
+   * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
+   *
+   * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
+   *
+   * @example
+   * ```ts
+   * import { HttpTransport } from "@nktkas/hyperliquid";
+   * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+   *
+   * const transport = new HttpTransport(); // or `WebSocketTransport`
+   * const converter = await SymbolConverter.create({ transport });
+   *
+   * converter.getSpotPairId("HFUN/USDC"); // → "@2"
+   * converter.getSpotPairId("PURR/USDC"); // → "PURR/USDC" (exceptions exist for some pairs)
+   * ```
+   */
+  getSpotPairId(name: string): string | undefined {
+    return this._nameToSpotPairId.get(name);
+  }
+}

package/esm/bin/_utils.d.ts

@@ -1,148 +0,0 @@
-/**
- * Utility functions for command-line argument parsing and transformation.
- * More useful for working with proxy arguments.
- *
- * @example
- * ```ts
- * import { extractArgs, transformArgs } from "./_utils.ts";
- *
- * const args = ["info", "meta", "--user", "0x1234", "--limit", "10", "--verbose"];
- * const rawArgs = extractArgs(args, { flags: ["verbose"] });
- * // { _: ["info", "meta"], user: "0x1234", limit: "10", verbose: "true" }
- *
- * const typedArgs = transformArgs(rawArgs);
- * // { _: ["info", "meta"], user: "0x1234", limit: 10, verbose: true }
- * ```
- *
- * @module
- */
-/**
- * Raw parsed arguments with all values as strings.
- * @template Collect - If `true`, repeated keys accumulate into arrays.
- * @template DoubleDash - If `true`, includes `"--"` array for arguments after `--`.
- */
-export type RawArgs<Collect extends boolean = true, DoubleDash extends boolean = false> = {
-    _: string[];
-} & (DoubleDash extends true ? {
-    "--": string[];
-} : {
-    "--"?: never;
-}) & Record<string, Collect extends false ? string : string | string[]>;
-/**
- * Options for {@link extractArgs} function.
- * @template Collect - If `true`, repeated keys accumulate into arrays.
- * @template DoubleDash - If `true`, includes `"--"` array for arguments after `--`.
- */
-export type ExtractOptions<Collect extends boolean = true, DoubleDash extends boolean = false> = {
-    /**
-     * Consider these keys as flags (no value expected).
-     * Value going after a flag will be treated as a positional argument.
-     */
-    flags?: string[];
-    /**
-     * Collect repeated options into arrays.
-     * - `true` - repeated keys accumulate values into an array.
-     * - `false` - later values overwrite earlier ones.
-     * @default true
-     */
-    collect?: Collect;
-    /**
-     * Handle `--no-*` as negation (sets value to "false").
-     * - `true` - `--no-foo` becomes `{ foo: "false" }`.
-     * - `false` - `--no-foo` becomes `{ "no-foo": "true" }`.
-     * @default true
-     */
-    negatable?: boolean;
-    /**
-     * Store arguments after `--` in a separate array.
-     * - `true` - arguments after `--` are stored in `"--"` array.
-     * - `false` - arguments after `--` are added to `_` array.
-     * @default false
-     */
-    doubleDash?: DoubleDash;
-};
-/**
- * Extract command-line arguments into a key-value object (does not transform values).
- *
- * @example
- * ```ts
- * const args = ["info", "--user", "0x1234", "--verbose", "-n", "5"];
- * const result = extractArgs(args, { flags: ["verbose"] });
- * // { _: ["info"], user: "0x1234", verbose: "true", n: "5" }
- * ```
- */
-export declare function extractArgs<Collect extends boolean = true, DoubleDash extends boolean = false>(args: string[], options?: ExtractOptions<Collect, DoubleDash>): RawArgs<Collect, DoubleDash>;
-/** Options for {@link transformArgs} function. */
-export interface TransformOptions {
-    /**
-     * Transform rule for null values.
-     * @value `"null"` (case insensitive)
-     * @default null
-     */
-    null?: "null" | "string";
-    /**
-     * Transform rule for boolean values.
-     * @value `"true"` / `"false"` (case insensitive)
-     * @default bool
-     */
-    bool?: "bool" | "string";
-    /**
-     * Transform rule for hexadecimal values.
-     * @value `"0xff"` (case insensitive) (0x prefix required)
-     * @default "string"
-     */
-    hex?: "string" | "number";
-    /**
-     * Transform rule for special numeric values.
-     * @value `"Infinity"` / `"NaN"` (case insensitive) (may include leading sign)
-     * @default "number"
-     */
-    specialNumber?: "string" | "number";
-    /**
-     * Transform rule for numeric values.
-     * @value `"123"` / `"12.3"` / `"1e+2"` / `"-123"` (anything that can be parsed by `Number(value)`; excludes hex values)
-     * @default "number"
-     */
-    number?: "number" | "string";
-    /**
-     * Transform rule for JSON object/array values.
-     * @value `"{ \"a\": 1 }"`, `"[invalid array string]"` (anything that begins with `{` and ends with `}` or begins with `[` and ends with `]`)
-     * @default "object"
-     */
-    json?: "object" | "string";
-}
-type TransformedValue = string | number | boolean | null | Record<string, unknown> | unknown[];
-/**
- * Transformed arguments with typed values.
- * @template Collect - If `true`, repeated keys accumulate into arrays.
- * @template DoubleDash - If `true`, includes `"--"` array for arguments after `--`.
- */
-export type Args<Collect extends boolean = true, DoubleDash extends boolean = false> = {
-    _: string[];
-} & (DoubleDash extends true ? {
-    "--": string[];
-} : {
-    "--"?: never;
-}) & Record<string, Collect extends false ? TransformedValue : TransformedValue | TransformedValue[]>;
-/**
- * Transform raw args (string values) into typed args based on rules.
- *
- * Order of transformation:
- * 1. null (`"null"`)
- * 2. boolean (`"true"`, `"false"`)
- * 3. hex (`"0x..."`)
- * 4. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
- * 5. number (numeric strings)
- * 6. json (object/array strings)
- * 7. string (default)
- *
- * @example
- * ```ts
- * const rawArgs = { _: ["info"], limit: "10", verbose: "true" };
- * const result = transformArgs(rawArgs);
- * // { _: ["info"], limit: 10, verbose: true }
- * ```
- */
-export declare function transformArgs<Collect extends boolean = true, DoubleDash extends boolean = false>(args: RawArgs<Collect, DoubleDash>, options?: TransformOptions): Args<Collect, DoubleDash>;
-export {};
-//# sourceMappingURL=_utils.d.ts.map

package/esm/bin/_utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../src/bin/_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;;;GAIG;AACH,MAAM,MAAM,OAAO,CACjB,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,UAAU,SAAS,OAAO,GAAG,KAAK,IAEhC;IAAE,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACf,CAAC,UAAU,SAAS,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,GACjE,MAAM,CAAC,MAAM,EAAE,OAAO,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,CACxB,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,UAAU,SAAS,OAAO,GAAG,KAAK,IAChC;IACF;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,UAAU,SAAS,OAAO,GAAG,KAAK,EAElC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,GAC5C,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAwF9B;AAMD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC5B;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,IAAI,CACd,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,UAAU,SAAS,OAAO,GAAG,KAAK,IAEhC;IAAE,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACf,CAAC,UAAU,SAAS,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,GACjE,MAAM,CAAC,MAAM,EAAE,OAAO,SAAS,KAAK,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,EAAE,CAAC,CAAC;AA0DrG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,UAAU,SAAS,OAAO,GAAG,KAAK,EAElC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CA2B3B"}

package/esm/bin/_utils.js

@@ -1,220 +0,0 @@
-/**
- * Utility functions for command-line argument parsing and transformation.
- * More useful for working with proxy arguments.
- *
- * @example
- * ```ts
- * import { extractArgs, transformArgs } from "./_utils.ts";
- *
- * const args = ["info", "meta", "--user", "0x1234", "--limit", "10", "--verbose"];
- * const rawArgs = extractArgs(args, { flags: ["verbose"] });
- * // { _: ["info", "meta"], user: "0x1234", limit: "10", verbose: "true" }
- *
- * const typedArgs = transformArgs(rawArgs);
- * // { _: ["info", "meta"], user: "0x1234", limit: 10, verbose: true }
- * ```
- *
- * @module
- */
-/** Check if next argument can be used as a value. */
-function isValidValue(nextArg) {
-    if (typeof nextArg !== "string")
-        return false;
-    // Allow negative numbers as values (e.g., -5, -3.14)
-    if (nextArg.startsWith("-") && isNaN(Number(nextArg)))
-        return false;
-    return true;
-}
-/** Set value for a key, with optional array collection on repeat. */
-function setValue(result, key, value, collect) {
-    if (key in result && collect) {
-        // Key already exists and collect is enabled - convert to array or push
-        const existing = result[key];
-        if (Array.isArray(existing)) {
-            existing.push(value); // Already an array - just push
-        }
-        else {
-            result[key] = [existing, value]; // First repeat - convert to array
-        }
-    }
-    else {
-        // First occurrence or collect disabled - set/overwrite value
-        result[key] = value;
-    }
-}
-/**
- * Extract command-line arguments into a key-value object (does not transform values).
- *
- * @example
- * ```ts
- * const args = ["info", "--user", "0x1234", "--verbose", "-n", "5"];
- * const result = extractArgs(args, { flags: ["verbose"] });
- * // { _: ["info"], user: "0x1234", verbose: "true", n: "5" }
- * ```
- */
-export function extractArgs(args, options) {
-    const flags = options?.flags ?? [];
-    const collect = options?.collect ?? true;
-    const negatable = options?.negatable ?? true;
-    const doubleDash = options?.doubleDash ?? false;
-    const result = (doubleDash ? { _: [], "--": [] } : { _: [] });
-    let terminated = false; // After "--", all args are positional
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        // After "--" terminator, all arguments are positional
-        if (terminated) {
-            if (doubleDash) {
-                result["--"].push(arg);
-            }
-            else {
-                result._.push(arg);
-            }
-            continue;
-        }
-        // Options terminator: "--"
-        if (arg === "--") {
-            terminated = true;
-            continue;
-        }
-        // Positional argument (doesn't start with "-")
-        if (!arg.startsWith("-")) {
-            result._.push(arg);
-            continue;
-        }
-        const isLongOption = arg.startsWith("--");
-        // Handle long options (--key, --key=value, --no-key)
-        if (isLongOption) {
-            const rawKey = arg.slice(2);
-            const equalsIndex = rawKey.indexOf("=");
-            const hasInlineValue = equalsIndex !== -1;
-            let key = hasInlineValue ? rawKey.substring(0, equalsIndex) : rawKey;
-            // Skip reserved keys "_" and "--"
-            if (key === "_" || key === "--")
-                continue;
-            let value;
-            if (negatable && key.startsWith("no-") && !hasInlineValue) { // Handle --no-* negation
-                key = key.slice(3); // Remove "no-" prefix
-                value = "false";
-            }
-            else if (hasInlineValue) { // Handle --key=value
-                value = rawKey.substring(equalsIndex + 1);
-            }
-            else if (!flags.includes(key) && isValidValue(args[i + 1])) { // Handle --key value
-                value = args[++i];
-            }
-            else { // Flag without value
-                value = "true";
-            }
-            setValue(result, key, value, collect);
-        } // Handle short options (-v, -f value, -abc)
-        else {
-            const chars = arg.slice(1);
-            // Single short option: -f
-            if (chars.length === 1) {
-                const key = chars;
-                if (key === "_")
-                    continue; // Skip reserved key
-                let value;
-                if (!flags.includes(key) && isValidValue(args[i + 1])) { // Handle -f value
-                    value = args[++i];
-                }
-                else { // Flag without value
-                    value = "true";
-                }
-                setValue(result, key, value, collect);
-            } // Grouped short flags: -abc → a, b, c (all flags, no values)
-            else {
-                for (const char of chars) {
-                    if (char === "_")
-                        continue; // Skip reserved key
-                    setValue(result, char, "true", collect);
-                }
-            }
-        }
-    }
-    return result;
-}
-/** Transform a single string value based on rules. */
-function transformValue(value, opts) {
-    // null
-    if (value.toLowerCase() === "null") {
-        return opts.null === "null" ? null : value;
-    }
-    // boolean
-    if (value.toLowerCase() === "true" || value.toLowerCase() === "false") {
-        return opts.bool === "bool" ? value.toLowerCase() === "true" : value;
-    }
-    // hex
-    if ((value.startsWith("0x") || value.startsWith("0X")) &&
-        !isNaN(Number(value))) {
-        return opts.hex === "string" ? value : Number(value);
-    }
-    // special number
-    if (value.toLowerCase() === "infinity" ||
-        value.toLowerCase() === "-infinity" ||
-        value.toLowerCase() === "nan" ||
-        value.toLowerCase() === "-nan") {
-        return opts.specialNumber === "string" ? value : Number(value);
-    }
-    // number
-    if (!isNaN(Number(value))) {
-        return opts.number === "number" ? Number(value) : value;
-    }
-    // json object/array
-    if ((value.startsWith("{") && value.endsWith("}")) ||
-        (value.startsWith("[") && value.endsWith("]"))) {
-        if (opts.json === "object") {
-            try {
-                return JSON.parse(value);
-            }
-            catch { /** Ignore invalid JSON */ }
-        }
-        return value; // as string if parsing fails or opts is "string"
-    }
-    // string (default)
-    return value;
-}
-/**
- * Transform raw args (string values) into typed args based on rules.
- *
- * Order of transformation:
- * 1. null (`"null"`)
- * 2. boolean (`"true"`, `"false"`)
- * 3. hex (`"0x..."`)
- * 4. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
- * 5. number (numeric strings)
- * 6. json (object/array strings)
- * 7. string (default)
- *
- * @example
- * ```ts
- * const rawArgs = { _: ["info"], limit: "10", verbose: "true" };
- * const result = transformArgs(rawArgs);
- * // { _: ["info"], limit: 10, verbose: true }
- * ```
- */
-export function transformArgs(args, options) {
-    const opts = {
-        null: options?.null ?? "null",
-        bool: options?.bool ?? "bool",
-        hex: options?.hex ?? "string",
-        specialNumber: options?.specialNumber ?? "number",
-        number: options?.number ?? "number",
-        json: options?.json ?? "object",
-    };
-    const result = ("--" in args ? { _: args._, "--": args["--"] } : { _: args._ });
-    for (const key in args) {
-        if (key === "_" || key === "--")
-            continue; // Skip positional args arrays
-        const value = args[key];
-        // Handle arrays (repeated options)
-        if (Array.isArray(value)) {
-            result[key] = value.map((v) => transformValue(v, opts));
-        }
-        else {
-            result[key] = transformValue(value, opts);
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=_utils.js.map

package/esm/bin/_utils.js.map

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

package/esm/bin/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/esm/bin/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}