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

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

@@ -0,0 +1,98 @@
+import type { HttpTransport } from "../transport/http/mod.js";
+import type { WebSocketTransport } from "../transport/websocket/mod.js";
+/** Options for creating a {@link SymbolConverter} instance. */
+export interface SymbolConverterOptions {
+    /** Transport instance to use for API requests. */
+    transport: HttpTransport | WebSocketTransport;
+    /** 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 declare class SymbolConverter {
+    private readonly transport;
+    private readonly dexOption;
+    private readonly nameToAssetId;
+    private readonly nameToSzDecimals;
+    private readonly nameToSpotPairId;
+    private constructor();
+    /**
+     * Create and initialize a SymbolConverter instance.
+     *
+     * @param options - Configuration options including transport and optional dex support.
+     *
+     * @returns 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 create(options: SymbolConverterOptions): Promise<SymbolConverter>;
+    /**
+     * Reload asset mappings from the API.
+     * Useful for refreshing data when new assets are added.
+     */
+    reload(): Promise<void>;
+    private processDefaultPerps;
+    private processBuilderDexs;
+    private processBuilderDexResult;
+    private processSpotAssets;
+    /**
+     * 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 "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
+     */
+    getAssetId(name: string): number | undefined;
+    /**
+     * 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 "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
+     */
+    getSzDecimals(name: string): number | undefined;
+    /**
+     * 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 "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name: string): string | undefined;
+}
+//# sourceMappingURL=symbolConverter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAUxE,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAE9C,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,OAAO;IAKP;;;;;;;;;;;;;;;OAeG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B7B,OAAO,CAAC,mBAAmB;YAOb,kBAAkB;IA6BhC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}

package/esm/src/utils/symbolConverter.js

@@ -0,0 +1,179 @@
+import { meta, perpDexs, spotMeta, } from "../api/info/mod.js";
+/**
+ * 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 {
+    transport;
+    dexOption;
+    nameToAssetId = new Map();
+    nameToSzDecimals = new Map();
+    nameToSpotPairId = new Map();
+    constructor(options) {
+        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.
+     *
+     * @returns 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) {
+        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() {
+        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);
+        }
+    }
+    processDefaultPerps(perpMetaData) {
+        perpMetaData.universe.forEach((asset, index) => {
+            this.nameToAssetId.set(asset.name, index);
+            this.nameToSzDecimals.set(asset.name, asset.szDecimals);
+        });
+    }
+    async processBuilderDexs(perpDexsData) {
+        if (!perpDexsData || perpDexsData.length <= 1)
+            return;
+        const builderDexs = perpDexsData
+            .map((dex, index) => ({ dex, index }))
+            .filter((item) => {
+            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.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);
+        });
+    }
+    processBuilderDexResult(dexMeta, perpDexIndex) {
+        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);
+        });
+    }
+    processSpotAssets(spotMetaData) {
+        const tokenMap = new Map();
+        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 "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
+     */
+    getAssetId(name) {
+        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 "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
+     */
+    getSzDecimals(name) {
+        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 "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name) {
+        return this.nameToSpotPairId.get(name);
+    }
+}
+//# sourceMappingURL=symbolConverter.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hfunlabs/hyperliquid",
-  "version": "0.27.1-hfunlabs.5",
+  "version": "0.29.1-hfunlabs.1",
   "description": "Unofficial Hyperliquid API SDK for all major JS runtimes, written in TypeScript.",
   "keywords": [
     "api",
@@ -46,16 +46,16 @@
       "require": "./script/src/utils/mod.js"
     },
     "./api/exchange": {
-      "import": "./esm/src/api/exchange/~mod.js",
-      "require": "./script/src/api/exchange/~mod.js"
+      "import": "./esm/src/api/exchange/mod.js",
+      "require": "./script/src/api/exchange/mod.js"
     },
     "./api/info": {
-      "import": "./esm/src/api/info/~mod.js",
-      "require": "./script/src/api/info/~mod.js"
+      "import": "./esm/src/api/info/mod.js",
+      "require": "./script/src/api/info/mod.js"
     },
     "./api/subscription": {
-      "import": "./esm/src/api/subscription/~mod.js",
-      "require": "./script/src/api/subscription/~mod.js"
+      "import": "./esm/src/api/subscription/mod.js",
+      "require": "./script/src/api/subscription/mod.js"
     }
   },
   "scripts": {},
@@ -67,10 +67,8 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@henrygd/semaphore": "0.1.0",
     "@nktkas/rews": "^1.2.1",
     "@noble/hashes": "^2.0.1",
-    "@noble/secp256k1": "^3.0.0",
     "valibot": "1.2.0"
   },
   "_generatedBy": "dnt@dev"

package/script/_dnt.shims.d.ts

@@ -0,0 +1,2 @@
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/script/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,gCAA2C,CAAC"}

package/script/_dnt.shims.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = void 0;
+const dntGlobals = {};
+exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}
+//# sourceMappingURL=_dnt.shims.js.map

package/script/_dnt.shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.js","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":";;;AAAA,MAAM,UAAU,GAAG,EAClB,CAAC;AACW,QAAA,aAAa,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAEtE,SAAS,gBAAgB,CACvB,OAAU,EACV,MAAS;IAET,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS;YAC1B,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK;YACtB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YACA,OAAe,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI;YAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;gBAC7B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,OAAQ,OAAe,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,OAAO;YACb,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI;YAChC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wBAAwB,CAAC,OAAO,EAAE,IAAI;YACpC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO,OAAO,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC;QAC3C,CAAC;KACF,CAAQ,CAAC;AACZ,CAAC"}

package/script/bin/_utils.d.ts

@@ -1,80 +1,98 @@
-export type RawArgs = {
-    [key: string]: string | undefined;
-} & {
+export type RawArgs<Collect extends boolean = true, DoubleDash extends boolean = false> = {
     _: string[];
-};
-export type ParseOptions = {
+} & (DoubleDash extends true ? {
+    "--": string[];
+} : {
+    "--"?: never;
+}) & Record<string, Collect extends false ? string : string | string[]>;
+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[];
-};
-/**
- * Parse command-line arguments into a key-value object.
- * Does not transform values.
- */
-export declare function parseArgs(args: string[], options?: ParseOptions): RawArgs;
-export interface TransformOptions {
     /**
-     * Transform rule for flags (keys without values).
-     * @value `undefined`
-     * @default "true"
+     * 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
      */
-    flag?: "true" | "false" | ((key: string) => "true" | "false");
+    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). */
+export declare function extractArgs<Collect extends boolean = true, DoubleDash extends boolean = false>(args: string[], options?: ExtractOptions<Collect, DoubleDash>): RawArgs<Collect, DoubleDash>;
+export interface TransformOptions {
     /**
      * Transform rule for null values.
      * @value `"null"` (case insensitive)
-     * @default "null"
+     * @default null
      */
-    null?: "null" | "string" | ((key: string, value: string) => "null" | "string");
+    null?: "null" | "string";
     /**
      * Transform rule for boolean values.
-     * @value `"true"`, `"false"` (case insensitive)
-     * @default "bool"
+     * @value `"true"` / `"false"` (case insensitive)
+     * @default bool
      */
-    bool?: "bool" | "string" | ((key: string, value: string) => "bool" | "string");
+    bool?: "bool" | "string";
     /**
      * Transform rule for hexadecimal values.
-     * @value `"0xff"`, `"0X1A"` (case insensitive) (0x prefix required)
+     * @value `"0xff"` (case insensitive) (0x prefix required)
      * @default "string"
      */
-    hex?: "string" | "number" | ((key: string, value: string) => "string" | "number");
+    hex?: "string" | "number";
     /**
      * Transform rule for special numeric values.
-     * @value `"Infinity"`, `"-Infinity"`, `"NaN"`, `"-NaN"` (case insensitive)
-     * @default "string"
+     * @value `"Infinity"` / `"NaN"` (case insensitive) (may include leading sign)
+     * @default "number"
      */
-    specialNumber?: "string" | "number" | ((key: string, value: string) => "string" | "number");
+    specialNumber?: "string" | "number";
     /**
      * Transform rule for numeric values.
-     * @value `"123"`, `"12.3"`, `"1e+2"`, `"+123"`, `"-123"` (anything that can be parsed by `Number(value)`) (excludes hex values)
+     * @value `"123"` / `"12.3"` / `"1e+2"` / `"-123"` (anything that can be parsed by `Number(value)`; excludes hex values)
      * @default "number"
      */
-    number?: "number" | "string" | ((key: string, value: string) => "number" | "string");
+    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" | ((key: string, value: string) => "object" | "string");
+    json?: "object" | "string";
 }
-export interface Args {
-    [key: string]: string | number | boolean | null | Record<string, unknown> | unknown[];
+type TransformedValue = string | number | boolean | null | Record<string, unknown> | unknown[];
+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. flag (`undefined`)
- * 2. null (`"null"`)
- * 3. boolean (`"true"`, `"false"`)
- * 4. hex (`"0x..."`)
- * 5. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
- * 6. number (numeric strings)
- * 7. json (object/array strings)
- * 8. string (default)
+ * 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)
  */
-export declare function transformArgs(args: RawArgs, options?: TransformOptions): Args;
+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/script/bin/_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../src/bin/_utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,GAAG;IACF,CAAC,EAAE,MAAM,EAAE,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CA8BzE;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,CAAC;IAC9D;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/E;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/E;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAClF;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5F;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACrF;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;IACtF,CAAC,EAAE,MAAM,EAAE,CAAC;CACb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAmE7E"}
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../src/bin/_utils.ts"],"names":[],"mappings":"AAIA,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,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,0FAA0F;AAC1F,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,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,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;;;;;;;;;;;GAWG;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"}