@payai/x402-evm 2.3.6 → 2.4.0

package/dist/esm/upto/server/index.mjs

@@ -0,0 +1,145 @@
+import {
+  getDefaultAsset
+} from "../../chunk-NSFLAANF.mjs";
+
+// src/upto/server/scheme.ts
+import { getAddress } from "viem";
+var UptoEvmScheme = class {
+  constructor() {
+    this.scheme = "upto";
+    this.moneyParsers = [];
+  }
+  /**
+   * Registers a custom money parser for converting prices to asset amounts.
+   *
+   * @param parser - The money parser function to register
+   * @returns This instance for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Returns the decimal precision of the default stablecoin for the given network.
+   * Implements the optional AssetDecimalsProvider interface used by resolveSettlementOverrideAmount.
+   *
+   * @param _asset - The asset symbol (unused; defaults to the network's default stablecoin)
+   * @param network - The network to look up the default asset for
+   * @returns The number of decimal places for the asset
+   */
+  getAssetDecimals(_asset, network) {
+    try {
+      return getDefaultAsset(network).decimals;
+    } catch {
+      return 6;
+    }
+  }
+  /**
+   * Parses a price into an asset amount for the given network.
+   *
+   * @param price - The price to parse (string, number, or AssetAmount)
+   * @param network - The target network
+   * @returns Promise resolving to an asset amount
+   */
+  async parsePrice(price, network) {
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * Enhances payment requirements with upto-specific metadata.
+   *
+   * @param paymentRequirements - The base payment requirements
+   * @param supportedKind - The supported scheme/network kind
+   * @param supportedKind.x402Version - The x402 protocol version
+   * @param supportedKind.scheme - The payment scheme name
+   * @param supportedKind.network - The target network
+   * @param supportedKind.extra - Optional extra metadata
+   * @param extensionKeys - Extension keys to include
+   * @returns Promise resolving to enhanced payment requirements
+   */
+  enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    return Promise.resolve({
+      ...paymentRequirements,
+      extra: {
+        ...paymentRequirements.extra,
+        assetTransferMethod: "permit2",
+        ...supportedKind.extra?.facilitatorAddress ? { facilitatorAddress: getAddress(supportedKind.extra.facilitatorAddress) } : {}
+      }
+    });
+  }
+  /**
+   * Parses a money string or number into a decimal value.
+   *
+   * @param money - The money value to parse
+   * @returns The parsed decimal amount
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Converts a numeric dollar amount to an AssetAmount using the default token for the network.
+   *
+   * @param amount - The dollar amount as a number
+   * @param network - The target network
+   * @returns The converted asset amount with token metadata
+   */
+  defaultMoneyConversion(amount, network) {
+    const assetInfo = getDefaultAsset(network);
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), assetInfo.decimals);
+    return {
+      amount: tokenAmount,
+      asset: assetInfo.address,
+      extra: {
+        name: assetInfo.name,
+        version: assetInfo.version,
+        assetTransferMethod: "permit2"
+      }
+    };
+  }
+  /**
+   * Converts a decimal string amount to an integer token amount using the given decimals.
+   *
+   * @param decimalAmount - The amount as a decimal string (e.g. "1.5")
+   * @param decimals - The number of decimal places for the token
+   * @returns The token amount as an integer string in smallest units
+   */
+  convertToTokenAmount(decimalAmount, decimals) {
+    const amount = parseFloat(decimalAmount);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid amount: ${decimalAmount}`);
+    }
+    const [intPart, decPart = ""] = String(amount).split(".");
+    const paddedDec = decPart.padEnd(decimals, "0").slice(0, decimals);
+    const tokenAmount = (intPart + paddedDec).replace(/^0+/, "") || "0";
+    return tokenAmount;
+  }
+};
+export {
+  UptoEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/upto/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/upto/server/scheme.ts"],"sourcesContent":["import {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@payai/x402/types\";\nimport { getAddress } from \"viem\";\nimport { getDefaultAsset } from \"../../shared/defaultAssets\";\n\n/**\n * EVM server implementation for the Upto payment scheme.\n * Handles price parsing, payment requirements enhancement, and default asset resolution.\n */\nexport class UptoEvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"upto\";\n  private moneyParsers: MoneyParser[] = [];\n\n  /**\n   * Registers a custom money parser for converting prices to asset amounts.\n   *\n   * @param parser - The money parser function to register\n   * @returns This instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): UptoEvmScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Returns the decimal precision of the default stablecoin for the given network.\n   * Implements the optional AssetDecimalsProvider interface used by resolveSettlementOverrideAmount.\n   *\n   * @param _asset - The asset symbol (unused; defaults to the network's default stablecoin)\n   * @param network - The network to look up the default asset for\n   * @returns The number of decimal places for the asset\n   */\n  getAssetDecimals(_asset: string, network: Network): number {\n    try {\n      return getDefaultAsset(network).decimals;\n    } catch {\n      return 6;\n    }\n  }\n\n  /**\n   * Parses a price into an asset amount for the given network.\n   *\n   * @param price - The price to parse (string, number, or AssetAmount)\n   * @param network - The target network\n   * @returns Promise resolving to an asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    const amount = this.parseMoneyToDecimal(price);\n\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhances payment requirements with upto-specific metadata.\n   *\n   * @param paymentRequirements - The base payment requirements\n   * @param supportedKind - The supported scheme/network kind\n   * @param supportedKind.x402Version - The x402 protocol version\n   * @param supportedKind.scheme - The payment scheme name\n   * @param supportedKind.network - The target network\n   * @param supportedKind.extra - Optional extra metadata\n   * @param extensionKeys - Extension keys to include\n   * @returns Promise resolving to enhanced payment requirements\n   */\n  enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      x402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    void extensionKeys;\n    return Promise.resolve({\n      ...paymentRequirements,\n      extra: {\n        ...paymentRequirements.extra,\n        assetTransferMethod: \"permit2\",\n        ...(supportedKind.extra?.facilitatorAddress\n          ? { facilitatorAddress: getAddress(supportedKind.extra.facilitatorAddress as string) }\n          : {}),\n      },\n    });\n  }\n\n  /**\n   * Parses a money string or number into a decimal value.\n   *\n   * @param money - The money value to parse\n   * @returns The parsed decimal amount\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Converts a numeric dollar amount to an AssetAmount using the default token for the network.\n   *\n   * @param amount - The dollar amount as a number\n   * @param network - The target network\n   * @returns The converted asset amount with token metadata\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const assetInfo = getDefaultAsset(network);\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), assetInfo.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: assetInfo.address,\n      extra: {\n        name: assetInfo.name,\n        version: assetInfo.version,\n        assetTransferMethod: \"permit2\",\n      },\n    };\n  }\n\n  /**\n   * Converts a decimal string amount to an integer token amount using the given decimals.\n   *\n   * @param decimalAmount - The amount as a decimal string (e.g. \"1.5\")\n   * @param decimals - The number of decimal places for the token\n   * @returns The token amount as an integer string in smallest units\n   */\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    const amount = parseFloat(decimalAmount);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`);\n    }\n    const [intPart, decPart = \"\"] = String(amount).split(\".\");\n    const paddedDec = decPart.padEnd(decimals, \"0\").slice(0, decimals);\n    const tokenAmount = (intPart + paddedDec).replace(/^0+/, \"\") || \"0\";\n    return tokenAmount;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/esm/v1/index.d.mts

@@ -24,6 +24,8 @@ declare const EVM_NETWORK_CHAIN_ID_MAP: {
     readonly monad: 143;
     readonly kiteai: 2366;
     readonly "kiteai-testnet": 2368;
+    readonly stable: 988;
+    readonly "stable-testnet": 2201;
 };
 type EvmNetworkV1 = keyof typeof EVM_NETWORK_CHAIN_ID_MAP;
 declare const NETWORKS: string[];

package/dist/esm/v1/index.mjs

@@ -3,7 +3,8 @@ import {
   ExactEvmSchemeV12 as ExactEvmSchemeV1,
   NETWORKS,
   getEvmChainIdV1
-} from "../chunk-PCJKIY5G.mjs";
+} from "../chunk-RYT6M3PA.mjs";
+import "../chunk-C4ZQMS77.mjs";
 export {
   EVM_NETWORK_CHAIN_ID_MAP,
   ExactEvmSchemeV1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payai/x402-evm",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
@@ -93,6 +93,36 @@
         "types": "./dist/cjs/exact/v1/facilitator/index.d.ts",
         "default": "./dist/cjs/exact/v1/facilitator/index.js"
       }
+    },
+    "./upto/client": {
+      "import": {
+        "types": "./dist/esm/upto/client/index.d.mts",
+        "default": "./dist/esm/upto/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/upto/client/index.d.ts",
+        "default": "./dist/cjs/upto/client/index.js"
+      }
+    },
+    "./upto/server": {
+      "import": {
+        "types": "./dist/esm/upto/server/index.d.mts",
+        "default": "./dist/esm/upto/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/upto/server/index.d.ts",
+        "default": "./dist/cjs/upto/server/index.js"
+      }
+    },
+    "./upto/facilitator": {
+      "import": {
+        "types": "./dist/esm/upto/facilitator/index.d.mts",
+        "default": "./dist/esm/upto/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/upto/facilitator/index.d.ts",
+        "default": "./dist/cjs/upto/facilitator/index.js"
+      }
     }
   },
   "files": [

package/dist/esm/chunk-GD4MKCN7.mjs

@@ -1,57 +0,0 @@
-// src/exact/extensions.ts
-var EIP2612_GAS_SPONSORING_KEY = "eip2612GasSponsoring";
-var ERC20_APPROVAL_GAS_SPONSORING_KEY = "erc20ApprovalGasSponsoring";
-var ERC20_APPROVAL_GAS_SPONSORING_VERSION = "1";
-function _extractInfo(payload, extensionKey) {
-  const extensions = payload.extensions;
-  if (!extensions) return null;
-  const extension = extensions[extensionKey];
-  if (!extension?.info) return null;
-  return extension.info;
-}
-function extractEip2612GasSponsoringInfo(payload) {
-  const info = _extractInfo(payload, EIP2612_GAS_SPONSORING_KEY);
-  if (!info) return null;
-  if (!info.from || !info.asset || !info.spender || !info.amount || !info.nonce || !info.deadline || !info.signature || !info.version) {
-    return null;
-  }
-  return info;
-}
-function validateEip2612GasSponsoringInfo(info) {
-  const addressPattern = /^0x[a-fA-F0-9]{40}$/;
-  const numericPattern = /^[0-9]+$/;
-  const hexPattern = /^0x[a-fA-F0-9]+$/;
-  const versionPattern = /^[0-9]+(\.[0-9]+)*$/;
-  return addressPattern.test(info.from) && addressPattern.test(info.asset) && addressPattern.test(info.spender) && numericPattern.test(info.amount) && numericPattern.test(info.nonce) && numericPattern.test(info.deadline) && hexPattern.test(info.signature) && versionPattern.test(info.version);
-}
-function extractErc20ApprovalGasSponsoringInfo(payload) {
-  const info = _extractInfo(payload, ERC20_APPROVAL_GAS_SPONSORING_KEY);
-  if (!info) return null;
-  if (!info.from || !info.asset || !info.spender || !info.amount || !info.signedTransaction || !info.version) {
-    return null;
-  }
-  return info;
-}
-function validateErc20ApprovalGasSponsoringInfo(info) {
-  const addressPattern = /^0x[a-fA-F0-9]{40}$/;
-  const numericPattern = /^[0-9]+$/;
-  const hexPattern = /^0x[a-fA-F0-9]+$/;
-  const versionPattern = /^[0-9]+(\.[0-9]+)*$/;
-  return addressPattern.test(info.from) && addressPattern.test(info.asset) && addressPattern.test(info.spender) && numericPattern.test(info.amount) && hexPattern.test(info.signedTransaction) && versionPattern.test(info.version);
-}
-function resolveErc20ApprovalExtensionSigner(extension, network) {
-  if (!extension) return void 0;
-  return extension.signerForNetwork?.(network) ?? extension.signer;
-}
-
-export {
-  EIP2612_GAS_SPONSORING_KEY,
-  ERC20_APPROVAL_GAS_SPONSORING_KEY,
-  ERC20_APPROVAL_GAS_SPONSORING_VERSION,
-  extractEip2612GasSponsoringInfo,
-  validateEip2612GasSponsoringInfo,
-  extractErc20ApprovalGasSponsoringInfo,
-  validateErc20ApprovalGasSponsoringInfo,
-  resolveErc20ApprovalExtensionSigner
-};
-//# sourceMappingURL=chunk-GD4MKCN7.mjs.map

package/dist/esm/chunk-GD4MKCN7.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/exact/extensions.ts"],"sourcesContent":["import type { PaymentPayload } from \"@payai/x402/types\";\nimport type { FacilitatorEvmSigner } from \"../signer\";\n\nexport const EIP2612_GAS_SPONSORING_KEY = \"eip2612GasSponsoring\" as const;\nexport const ERC20_APPROVAL_GAS_SPONSORING_KEY = \"erc20ApprovalGasSponsoring\" as const;\nexport const ERC20_APPROVAL_GAS_SPONSORING_VERSION = \"1\" as const;\n\nexport interface Eip2612GasSponsoringInfo {\n  [key: string]: unknown;\n  from: string;\n  asset: string;\n  spender: string;\n  amount: string;\n  nonce: string;\n  deadline: string;\n  signature: string;\n  version: string;\n}\n\nexport interface Erc20ApprovalGasSponsoringInfo {\n  [key: string]: unknown;\n  from: `0x${string}`;\n  asset: `0x${string}`;\n  spender: `0x${string}`;\n  amount: string;\n  signedTransaction: `0x${string}`;\n  version: string;\n}\n\n/**\n * A single transaction to be executed by the signer.\n * - `0x${string}`: a pre-signed serialized transaction (broadcast as-is via sendRawTransaction)\n * - `{ to, data, gas? }`: an unsigned call intent (signer signs and broadcasts)\n */\nexport type TransactionRequest =\n  | `0x${string}`\n  | { to: `0x${string}`; data: `0x${string}`; gas?: bigint };\n\nexport type Erc20ApprovalGasSponsoringSigner = FacilitatorEvmSigner & {\n  sendTransactions(transactions: TransactionRequest[]): Promise<`0x${string}`[]>;\n  simulateTransactions?(transactions: TransactionRequest[]): Promise<boolean>;\n};\n\nexport interface Erc20ApprovalGasSponsoringFacilitatorExtension {\n  key: typeof ERC20_APPROVAL_GAS_SPONSORING_KEY;\n  signer?: Erc20ApprovalGasSponsoringSigner;\n  signerForNetwork?: (network: string) => Erc20ApprovalGasSponsoringSigner | undefined;\n}\n\n/**\n * Extracts a typed `info` payload from an extension entry.\n *\n * @param payload - Payment payload containing optional extensions.\n * @param extensionKey - Extension key to extract.\n * @returns The extension `info` object when present; otherwise null.\n */\nfunction _extractInfo(\n  payload: PaymentPayload,\n  extensionKey: string,\n): Record<string, unknown> | null {\n  const extensions = payload.extensions;\n  if (!extensions) return null;\n  const extension = extensions[extensionKey] as { info?: Record<string, unknown> } | undefined;\n  if (!extension?.info) return null;\n  return extension.info;\n}\n\n/**\n * Extracts and validates required EIP-2612 gas sponsoring fields.\n *\n * @param payload - Payment payload returned by the client scheme.\n * @returns Parsed EIP-2612 gas sponsoring info when available and complete.\n */\nexport function extractEip2612GasSponsoringInfo(\n  payload: PaymentPayload,\n): Eip2612GasSponsoringInfo | null {\n  const info = _extractInfo(payload, EIP2612_GAS_SPONSORING_KEY);\n  if (!info) return null;\n  if (\n    !info.from ||\n    !info.asset ||\n    !info.spender ||\n    !info.amount ||\n    !info.nonce ||\n    !info.deadline ||\n    !info.signature ||\n    !info.version\n  ) {\n    return null;\n  }\n  return info as unknown as Eip2612GasSponsoringInfo;\n}\n\n/**\n * Validates the structure and formatting of EIP-2612 sponsoring info.\n *\n * @param info - EIP-2612 extension info to validate.\n * @returns True when all required fields match expected patterns.\n */\nexport function validateEip2612GasSponsoringInfo(info: Eip2612GasSponsoringInfo): boolean {\n  const addressPattern = /^0x[a-fA-F0-9]{40}$/;\n  const numericPattern = /^[0-9]+$/;\n  const hexPattern = /^0x[a-fA-F0-9]+$/;\n  const versionPattern = /^[0-9]+(\\.[0-9]+)*$/;\n  return (\n    addressPattern.test(info.from) &&\n    addressPattern.test(info.asset) &&\n    addressPattern.test(info.spender) &&\n    numericPattern.test(info.amount) &&\n    numericPattern.test(info.nonce) &&\n    numericPattern.test(info.deadline) &&\n    hexPattern.test(info.signature) &&\n    versionPattern.test(info.version)\n  );\n}\n\n/**\n * Extracts and validates required ERC-20 approval sponsoring fields.\n *\n * @param payload - Payment payload returned by the client scheme.\n * @returns Parsed ERC-20 approval sponsoring info when available and complete.\n */\nexport function extractErc20ApprovalGasSponsoringInfo(\n  payload: PaymentPayload,\n): Erc20ApprovalGasSponsoringInfo | null {\n  const info = _extractInfo(payload, ERC20_APPROVAL_GAS_SPONSORING_KEY);\n  if (!info) return null;\n  if (\n    !info.from ||\n    !info.asset ||\n    !info.spender ||\n    !info.amount ||\n    !info.signedTransaction ||\n    !info.version\n  ) {\n    return null;\n  }\n  return info as unknown as Erc20ApprovalGasSponsoringInfo;\n}\n\n/**\n * Validates the structure and formatting of ERC-20 approval sponsoring info.\n *\n * @param info - ERC-20 approval extension info to validate.\n * @returns True when all required fields match expected patterns.\n */\nexport function validateErc20ApprovalGasSponsoringInfo(\n  info: Erc20ApprovalGasSponsoringInfo,\n): boolean {\n  const addressPattern = /^0x[a-fA-F0-9]{40}$/;\n  const numericPattern = /^[0-9]+$/;\n  const hexPattern = /^0x[a-fA-F0-9]+$/;\n  const versionPattern = /^[0-9]+(\\.[0-9]+)*$/;\n  return (\n    addressPattern.test(info.from) &&\n    addressPattern.test(info.asset) &&\n    addressPattern.test(info.spender) &&\n    numericPattern.test(info.amount) &&\n    hexPattern.test(info.signedTransaction) &&\n    versionPattern.test(info.version)\n  );\n}\n\n/**\n * Resolves the ERC-20 approval extension signer for a specific network.\n *\n * @param extension - Optional facilitator extension config.\n * @param network - CAIP-2 network identifier.\n * @returns A network-specific signer when available, else the default signer.\n */\nexport function resolveErc20ApprovalExtensionSigner(\n  extension: Erc20ApprovalGasSponsoringFacilitatorExtension | undefined,\n  network: string,\n): Erc20ApprovalGasSponsoringSigner | undefined {\n  if (!extension) return undefined;\n  return extension.signerForNetwork?.(network) ?? extension.signer;\n}\n"],"mappings":";AAGO,IAAM,6BAA6B;AACnC,IAAM,oCAAoC;AAC1C,IAAM,wCAAwC;AAmDrD,SAAS,aACP,SACA,cACgC;AAChC,QAAM,aAAa,QAAQ;AAC3B,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,YAAY,WAAW,YAAY;AACzC,MAAI,CAAC,WAAW,KAAM,QAAO;AAC7B,SAAO,UAAU;AACnB;AAQO,SAAS,gCACd,SACiC;AACjC,QAAM,OAAO,aAAa,SAAS,0BAA0B;AAC7D,MAAI,CAAC,KAAM,QAAO;AAClB,MACE,CAAC,KAAK,QACN,CAAC,KAAK,SACN,CAAC,KAAK,WACN,CAAC,KAAK,UACN,CAAC,KAAK,SACN,CAAC,KAAK,YACN,CAAC,KAAK,aACN,CAAC,KAAK,SACN;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAQO,SAAS,iCAAiC,MAAyC;AACxF,QAAM,iBAAiB;AACvB,QAAM,iBAAiB;AACvB,QAAM,aAAa;AACnB,QAAM,iBAAiB;AACvB,SACE,eAAe,KAAK,KAAK,IAAI,KAC7B,eAAe,KAAK,KAAK,KAAK,KAC9B,eAAe,KAAK,KAAK,OAAO,KAChC,eAAe,KAAK,KAAK,MAAM,KAC/B,eAAe,KAAK,KAAK,KAAK,KAC9B,eAAe,KAAK,KAAK,QAAQ,KACjC,WAAW,KAAK,KAAK,SAAS,KAC9B,eAAe,KAAK,KAAK,OAAO;AAEpC;AAQO,SAAS,sCACd,SACuC;AACvC,QAAM,OAAO,aAAa,SAAS,iCAAiC;AACpE,MAAI,CAAC,KAAM,QAAO;AAClB,MACE,CAAC,KAAK,QACN,CAAC,KAAK,SACN,CAAC,KAAK,WACN,CAAC,KAAK,UACN,CAAC,KAAK,qBACN,CAAC,KAAK,SACN;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAQO,SAAS,uCACd,MACS;AACT,QAAM,iBAAiB;AACvB,QAAM,iBAAiB;AACvB,QAAM,aAAa;AACnB,QAAM,iBAAiB;AACvB,SACE,eAAe,KAAK,KAAK,IAAI,KAC7B,eAAe,KAAK,KAAK,KAAK,KAC9B,eAAe,KAAK,KAAK,OAAO,KAChC,eAAe,KAAK,KAAK,MAAM,KAC/B,WAAW,KAAK,KAAK,iBAAiB,KACtC,eAAe,KAAK,KAAK,OAAO;AAEpC;AASO,SAAS,oCACd,WACA,SAC8C;AAC9C,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,UAAU,mBAAmB,OAAO,KAAK,UAAU;AAC5D;","names":[]}