@seedhape/core 0.1.0

package/dist/india/vda-tax.js

@@ -0,0 +1,226 @@
+/**
+ * India VDA tax engine.
+ *
+ * ⚠️  This is engineering scaffolding, not tax advice. The rates, thresholds and
+ * section references below must be reviewed and signed off by a chartered
+ * accountant before you go live, and re-checked every Finance Act. In
+ * particular: the Income-tax Act, 2025 renumbers the provisions that the
+ * Income-tax Act, 1961 called 115BBH and 194S. Section labels are therefore
+ * configuration, not constants — see `TaxRuleSet`.
+ *
+ * Why this module exists at all:
+ *
+ * Under the Indian VDA regime, spending USDC is a *transfer of a virtual
+ * digital asset*, not a payment. That has two consequences most agentic-payment
+ * stacks ignore entirely:
+ *
+ *   1. Every spend realises a capital gain or loss against the INR cost at
+ *      which that USDC was acquired. Gains are taxed at a flat 30% (plus
+ *      surcharge and cess) with no deduction other than cost of acquisition,
+ *      and losses cannot be set off against anything or carried forward. So
+ *      you must track lots, not just a balance.
+ *
+ *   2. The payer is the deductor for 1% TDS on the consideration. You cannot
+ *      withhold 1% out of an on-chain micropayment — the merchant's 402
+ *      challenge demands an exact amount. The workable pattern is to accrue the
+ *      liability against a pool funded at onramp time and remit it on the
+ *      statutory cycle. `TdsAccrual` implements that accrual.
+ *
+ * A stack that skips this leaves its users with an unreconcilable year-end.
+ */
+export const RULES_FY_2026_27_SPECIFIED_PERSON = {
+    financialYear: "2026-27",
+    vdaGainRateBps: 3000,
+    cessBps: 400,
+    tdsRateBps: 100,
+    tdsThresholdPaise: 5000000n, // ₹50,000
+    allowLossSetOff: false,
+    labels: {
+        gainSection: "115BBH (ITA 1961) / VDA income provisions (ITA 2025)",
+        tdsSection: "194S (ITA 1961) / corresponding TDS provision (ITA 2025)",
+        tdsFormSpecifiedPerson: "26QE",
+        tdsFormOther: "26Q",
+    },
+};
+export const RULES_FY_2026_27_OTHER = {
+    ...RULES_FY_2026_27_SPECIFIED_PERSON,
+    tdsThresholdPaise: 1000000n, // ₹10,000
+};
+export class InsufficientLotsError extends Error {
+    shortfall;
+    constructor(shortfall) {
+        super(`Not enough acquired USDC to account for this disposal; short by ${shortfall} base units. ` +
+            `This usually means USDC arrived in the wallet outside a tracked onramp (a direct transfer, ` +
+            `a refund, or an airdrop) and needs a manual cost-basis entry.`);
+        this.shortfall = shortfall;
+        this.name = "InsufficientLotsError";
+    }
+}
+/**
+ * Consume lots FIFO. Mutates `remaining` on the supplied lots — callers should
+ * persist them afterwards inside the same transaction as the spend record.
+ */
+export function consumeFifo(lots, quantity, proceedsInrPaise) {
+    const ordered = [...lots]
+        .filter((l) => l.remaining > 0n)
+        .sort((a, b) => a.acquiredAt - b.acquiredAt);
+    let outstanding = quantity;
+    let cost = 0n;
+    const consumptions = [];
+    for (const lot of ordered) {
+        if (outstanding === 0n)
+            break;
+        const take = outstanding < lot.remaining ? outstanding : lot.remaining;
+        // Proportional cost of the slice. Integer maths throughout; the rounding
+        // residue stays with the lot so total cost never drifts above what was paid.
+        const sliceCost = (lot.costInrPaise * take) / lot.quantity;
+        lot.remaining -= take;
+        outstanding -= take;
+        cost += sliceCost;
+        consumptions.push({ lotId: lot.id, quantity: take, costInrPaise: sliceCost });
+    }
+    if (outstanding > 0n)
+        throw new InsufficientLotsError(outstanding);
+    return {
+        quantity,
+        proceedsInrPaise,
+        costInrPaise: cost,
+        gainInrPaise: proceedsInrPaise - cost,
+        consumptions,
+    };
+}
+/**
+ * Accrue TDS for one transfer given the FY-to-date cumulative consideration.
+ *
+ * Threshold semantics: once cumulative consideration in the financial year
+ * exceeds the threshold, TDS is due on the whole consideration for the year,
+ * not merely the excess. So the transfer that crosses the line carries a
+ * catch-up for everything that preceded it.
+ */
+export function accrueTds(rules, considerationPaise, priorCumulativePaise, priorTdsPaidPaise) {
+    const cumulative = priorCumulativePaise + considerationPaise;
+    if (cumulative <= rules.tdsThresholdPaise) {
+        return {
+            considerationPaise,
+            tdsPaise: 0n,
+            cumulativeConsiderationPaise: cumulative,
+            thresholdCrossed: false,
+            catchUpPaise: 0n,
+        };
+    }
+    const totalTdsDue = (cumulative * BigInt(rules.tdsRateBps)) / 10000n;
+    const thisTransferTds = (considerationPaise * BigInt(rules.tdsRateBps)) / 10000n;
+    const crossed = priorCumulativePaise <= rules.tdsThresholdPaise;
+    const catchUp = crossed ? totalTdsDue - priorTdsPaidPaise - thisTransferTds : 0n;
+    return {
+        considerationPaise,
+        tdsPaise: thisTransferTds,
+        cumulativeConsiderationPaise: cumulative,
+        thresholdCrossed: crossed,
+        catchUpPaise: catchUp > 0n ? catchUp : 0n,
+    };
+}
+/**
+ * Build the FY report. Recomputes disposals from scratch against a copy of the
+ * lots so the report is reproducible and never mutates stored state.
+ */
+export function buildVdaTaxReport(input) {
+    const { rules } = input;
+    const lots = input.lots.map((l) => ({ ...l, remaining: l.quantity }));
+    const warnings = [];
+    const settled = input.spends
+        .filter((s) => s.status === "settled")
+        .sort((a, b) => a.createdAt - b.createdAt);
+    const lines = [];
+    let gains = 0n;
+    let losses = 0n;
+    let consideration = 0n;
+    let tdsAccrued = 0n;
+    let cumulative = 0n;
+    for (const s of settled) {
+        let disposal;
+        try {
+            disposal = consumeFifo(lots, s.amount, s.inrPaise);
+        }
+        catch (e) {
+            if (e instanceof InsufficientLotsError) {
+                warnings.push(`Spend ${s.id}: no cost basis available (short ${e.shortfall} base units). ` +
+                    `Treated as zero cost, which overstates the gain. Add a manual acquisition lot.`);
+                disposal = {
+                    quantity: s.amount,
+                    proceedsInrPaise: s.inrPaise,
+                    costInrPaise: 0n,
+                    gainInrPaise: s.inrPaise,
+                    consumptions: [],
+                };
+            }
+            else
+                throw e;
+        }
+        const tds = accrueTds(rules, s.inrPaise, cumulative, tdsAccrued);
+        cumulative = tds.cumulativeConsiderationPaise;
+        const tdsThisLine = tds.tdsPaise + tds.catchUpPaise;
+        tdsAccrued += tdsThisLine;
+        consideration += s.inrPaise;
+        if (disposal.gainInrPaise >= 0n)
+            gains += disposal.gainInrPaise;
+        else
+            losses += -disposal.gainInrPaise;
+        lines.push({
+            spendId: s.id,
+            date: new Date(s.createdAt * 1000).toISOString(),
+            counterparty: s.payTo,
+            resource: s.resource,
+            quantity: s.amount,
+            proceedsInrPaise: s.inrPaise,
+            costInrPaise: disposal.costInrPaise,
+            gainInrPaise: disposal.gainInrPaise,
+            tdsPaise: tdsThisLine,
+        });
+    }
+    const taxableBase = rules.allowLossSetOff ? gains - losses : gains;
+    const base = taxableBase > 0n ? taxableBase : 0n;
+    const taxOnGains = (base * BigInt(rules.vdaGainRateBps)) / 10000n;
+    const cess = (taxOnGains * BigInt(rules.cessBps)) / 10000n;
+    const totalTax = taxOnGains + cess;
+    if (!rules.allowLossSetOff && losses > 0n) {
+        warnings.push(`₹${paiseToInr(losses)} of losses are NOT deductible under the VDA regime and cannot be ` +
+            `carried forward. They are reported for completeness only.`);
+    }
+    return {
+        financialYear: rules.financialYear,
+        rules,
+        totalSpends: settled.length,
+        totalConsiderationPaise: consideration,
+        totalGainsPaise: gains,
+        totalLossesPaise: losses,
+        netPaise: gains - losses,
+        taxOnGainsPaise: taxOnGains,
+        cessPaise: cess,
+        totalTaxPaise: totalTax,
+        tdsAccruedPaise: tdsAccrued,
+        balancePayablePaise: totalTax - tdsAccrued > 0n ? totalTax - tdsAccrued : 0n,
+        lines,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+export function paiseToInr(paise) {
+    const neg = paise < 0n;
+    const abs = neg ? -paise : paise;
+    const rupees = abs / 100n;
+    const p = abs % 100n;
+    return `${neg ? "-" : ""}${groupIndian(rupees)}.${p.toString().padStart(2, "0")}`;
+}
+/** Indian digit grouping: 1,23,45,678 rather than 12,345,678. */
+function groupIndian(n) {
+    const s = n.toString();
+    if (s.length <= 3)
+        return s;
+    const last3 = s.slice(-3);
+    const rest = s.slice(0, -3);
+    return rest.replace(/\B(?=(\d{2})+(?!\d))/g, ",") + "," + last3;
+}
+//# sourceMappingURL=vda-tax.js.map

package/dist/india/vda-tax.js.map

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

package/dist/mandate-builder.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Mandate builder.
+ *
+ * An agent asking a user to sign an Intent Mandate has one shot at being
+ * understood. The typed-data prompt the wallet renders is the only thing
+ * standing between the user and a blank cheque, so this builder is opinionated:
+ * every mandate has a hard expiry, every mandate has a transaction-count cap,
+ * and there is no "unlimited" option.
+ */
+import type { Address, AssetRef, Hex, IntentMandate, SignedIntentMandate } from "./types.js";
+export interface MandateSpec {
+    subject: Address;
+    agent: Address;
+    purpose: string;
+    /** Human units, e.g. "0.50" USDC. */
+    maxPerTransaction: string;
+    maxPerPeriod: string;
+    period: "hour" | "day" | "week" | "month";
+    maxTxPerPeriod: number;
+    /** Days until expiry. Capped at 90 — a mandate is not a standing order. */
+    validForDays: number;
+    allowedHosts?: string[];
+    allowedPayTo?: Address[];
+    asset: AssetRef;
+    chainId: number;
+}
+export declare const MAX_MANDATE_DAYS = 90;
+export declare class MandateValidationError extends Error {
+    readonly problems: string[];
+    constructor(problems: string[]);
+}
+export declare function buildIntentMandate(spec: MandateSpec): IntentMandate;
+/** Everything a wallet needs to render and sign the mandate. */
+export declare function mandateSigningRequest(m: IntentMandate): {
+    hash: `0x${string}`;
+    typedData: {
+        domain: import("viem").TypedDataDomain;
+        types: {
+            readonly IntentMandate: readonly [{
+                readonly name: "subject";
+                readonly type: "address";
+            }, {
+                readonly name: "agent";
+                readonly type: "address";
+            }, {
+                readonly name: "purpose";
+                readonly type: "string";
+            }, {
+                readonly name: "maxPerTransaction";
+                readonly type: "uint256";
+            }, {
+                readonly name: "maxPerPeriod";
+                readonly type: "uint256";
+            }, {
+                readonly name: "periodSeconds";
+                readonly type: "uint64";
+            }, {
+                readonly name: "maxTxPerPeriod";
+                readonly type: "uint32";
+            }, {
+                readonly name: "allowedPayToRoot";
+                readonly type: "bytes32";
+            }, {
+                readonly name: "allowedHostsRoot";
+                readonly type: "bytes32";
+            }, {
+                readonly name: "asset";
+                readonly type: "address";
+            }, {
+                readonly name: "notBefore";
+                readonly type: "uint64";
+            }, {
+                readonly name: "expiry";
+                readonly type: "uint64";
+            }, {
+                readonly name: "nonce";
+                readonly type: "bytes32";
+            }];
+        };
+        primaryType: "IntentMandate";
+        message: {
+            subject: `0x${string}`;
+            agent: `0x${string}`;
+            purpose: string;
+            maxPerTransaction: bigint;
+            maxPerPeriod: bigint;
+            periodSeconds: bigint;
+            maxTxPerPeriod: number;
+            allowedPayToRoot: `0x${string}`;
+            allowedHostsRoot: `0x${string}`;
+            asset: `0x${string}`;
+            notBefore: bigint;
+            expiry: bigint;
+            nonce: `0x${string}`;
+        };
+    };
+    /** Plain-language summary to show alongside the raw typed data. */
+    summary: string;
+};
+export declare function attachSignature(m: IntentMandate, signature: Hex): SignedIntentMandate;
+export declare function describeMandate(m: IntentMandate): string;
+//# sourceMappingURL=mandate-builder.d.ts.map

package/dist/mandate-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandate-builder.d.ts","sourceRoot":"","sources":["../src/mandate-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,OAAO,EACP,QAAQ,EACR,GAAG,EACH,aAAa,EACb,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,qBAAa,sBAAuB,SAAQ,KAAK;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;gBAAlB,QAAQ,EAAE,MAAM,EAAE;CAIxC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CA+CnE;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIlD,mEAAmE;;EAGtE;AAED,wBAAgB,eAAe,CAC7B,CAAC,EAAE,aAAa,EAChB,SAAS,EAAE,GAAG,GACb,mBAAmB,CAErB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAsBxD"}

package/dist/mandate-builder.js

@@ -0,0 +1,99 @@
+/**
+ * Mandate builder.
+ *
+ * An agent asking a user to sign an Intent Mandate has one shot at being
+ * understood. The typed-data prompt the wallet renders is the only thing
+ * standing between the user and a blank cheque, so this builder is opinionated:
+ * every mandate has a hard expiry, every mandate has a transaction-count cap,
+ * and there is no "unlimited" option.
+ */
+import { randomBytes } from "node:crypto";
+import { toHex, parseUnits } from "viem";
+import { hashIntentMandate, intentTypedData } from "./ap2/mandates.js";
+const PERIOD_SECONDS = {
+    hour: 3_600,
+    day: 86_400,
+    week: 604_800,
+    month: 2_592_000,
+};
+export const MAX_MANDATE_DAYS = 90;
+export class MandateValidationError extends Error {
+    problems;
+    constructor(problems) {
+        super(problems.join(" "));
+        this.problems = problems;
+        this.name = "MandateValidationError";
+    }
+}
+export function buildIntentMandate(spec) {
+    const problems = [];
+    const perTx = parseUnits(spec.maxPerTransaction, spec.asset.decimals);
+    const perPeriod = parseUnits(spec.maxPerPeriod, spec.asset.decimals);
+    if (perTx <= 0n)
+        problems.push("maxPerTransaction must be greater than zero.");
+    if (perPeriod <= 0n)
+        problems.push("maxPerPeriod must be greater than zero.");
+    if (perTx > perPeriod) {
+        problems.push("maxPerTransaction cannot exceed maxPerPeriod — a single payment would " +
+            "exhaust the whole budget, which makes the period cap meaningless.");
+    }
+    if (spec.maxTxPerPeriod < 1)
+        problems.push("maxTxPerPeriod must be at least 1.");
+    if (spec.validForDays < 1)
+        problems.push("validForDays must be at least 1.");
+    if (spec.validForDays > MAX_MANDATE_DAYS) {
+        problems.push(`validForDays cannot exceed ${MAX_MANDATE_DAYS}. Long-lived mandates are the ` +
+            `main way agentic spend goes wrong; renew instead.`);
+    }
+    if (!spec.purpose || spec.purpose.trim().length < 8) {
+        problems.push("purpose must be a real description — it is what the user reads in the " +
+            "signing prompt and what appears in the audit log.");
+    }
+    if (problems.length)
+        throw new MandateValidationError(problems);
+    const now = Math.floor(Date.now() / 1000);
+    return {
+        subject: spec.subject,
+        agent: spec.agent,
+        purpose: spec.purpose.trim(),
+        maxPerTransaction: perTx,
+        maxPerPeriod: perPeriod,
+        periodSeconds: PERIOD_SECONDS[spec.period],
+        maxTxPerPeriod: spec.maxTxPerPeriod,
+        allowedPayTo: spec.allowedPayTo ?? [],
+        allowedHosts: spec.allowedHosts ?? [],
+        asset: spec.asset,
+        notBefore: now,
+        expiry: now + spec.validForDays * 86_400,
+        nonce: toHex(randomBytes(32)),
+        chainId: spec.chainId,
+    };
+}
+/** Everything a wallet needs to render and sign the mandate. */
+export function mandateSigningRequest(m) {
+    return {
+        hash: hashIntentMandate(m),
+        typedData: intentTypedData(m),
+        /** Plain-language summary to show alongside the raw typed data. */
+        summary: describeMandate(m),
+    };
+}
+export function attachSignature(m, signature) {
+    return { mandate: m, hash: hashIntentMandate(m), signature };
+}
+export function describeMandate(m) {
+    const unit = (v) => `${(Number(v) / 10 ** m.asset.decimals).toFixed(m.asset.decimals > 4 ? 4 : 2)} ${m.asset.symbol}`;
+    const period = Object.entries(PERIOD_SECONDS).find(([, s]) => s === m.periodSeconds)?.[0] ??
+        `${m.periodSeconds}s`;
+    const scope = m.allowedHosts.length > 0
+        ? `only to ${m.allowedHosts.join(", ")}`
+        : "to any x402 endpoint";
+    const payees = m.allowedPayTo.length > 0
+        ? ` and only to the payees ${m.allowedPayTo.join(", ")}`
+        : "";
+    return (`Authorise the agent at ${m.agent} to spend up to ${unit(m.maxPerTransaction)} per payment, ` +
+        `at most ${unit(m.maxPerPeriod)} and ${m.maxTxPerPeriod} payments per ${period}, ${scope}${payees}. ` +
+        `Purpose: ${m.purpose}. Expires ${new Date(m.expiry * 1000).toUTCString()}. ` +
+        `Revocable at any time.`);
+}
+//# sourceMappingURL=mandate-builder.js.map

package/dist/mandate-builder.js.map

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

package/dist/mpp.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MPP (Machine Payments Protocol) HTTP Authentication Scheme primitives.
+ *
+ * This module deliberately implements only the provider-neutral wire format.
+ * A parsed credential is untrusted input; a payment-method adapter must verify
+ * it, enforce the shared spending policy, and settle before fulfillment.
+ */
+export type MppChallenge = {
+    id: string;
+    realm: string;
+    method: string;
+    intent: string;
+    request: Record<string, unknown>;
+    expires?: number;
+    [key: string]: unknown;
+};
+export type MppCredential = {
+    challenge: MppChallenge;
+    payload: Record<string, unknown>;
+    source?: Record<string, unknown>;
+};
+export type MppReceipt = {
+    status: string;
+    method: string;
+    timestamp: number;
+    reference: string;
+    [key: string]: unknown;
+};
+/** Serialize a `WWW-Authenticate: Payment ...` challenge. */
+export declare function formatMppChallenge(challenge: MppChallenge): string;
+/** Parse a `WWW-Authenticate: Payment ...` challenge and reject duplicates. */
+export declare function parseMppChallenge(header: string): MppChallenge;
+/** Serialize an MPP `Authorization: Payment <base64url>` credential. */
+export declare function formatMppCredential(credential: MppCredential): string;
+/** Parse an MPP `Authorization: Payment <base64url>` credential. */
+export declare function parseMppCredential(header: string): MppCredential;
+/** Serialize an MPP `Payment-Receipt` response header. */
+export declare function formatMppReceipt(receipt: MppReceipt): string;
+/** Parse an MPP `Payment-Receipt` response header. */
+export declare function parseMppReceipt(header: string): MppReceipt;
+export type MppOutboundResult = {
+    response: Response;
+    challenge?: MppChallenge;
+    receipt?: MppReceipt;
+};
+/**
+ * Execute one MPP-protected request. Credential creation is injected so the
+ * caller can enforce its own user mandate, budget, and provider policy before
+ * producing a payment credential. The transport retries at most once after a
+ * valid 402 challenge and never retries an ambiguous response.
+ */
+export declare function fetchWithMpp(input: string | URL | Request, init: RequestInit | undefined, createCredential: (challenge: MppChallenge) => Promise<MppCredential>, fetchImpl?: typeof fetch): Promise<MppOutboundResult>;
+//# sourceMappingURL=mpp.d.ts.map

package/dist/mpp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp.d.ts","sourceRoot":"","sources":["../src/mpp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AA+CF,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAalE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAuB9D;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAGrE;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAMhE;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAG5D;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAI1D;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAEvG;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,gBAAgB,EAAE,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,CAAC,EACrE,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAa5B"}