@bananapus/nana-sdk-core 2.39.0 → 2.41.0

package/dist/esm/review/intents.js

@@ -97,4 +97,56 @@ export function liquidityIntent({ chainId, pool, positions, }) {
         positions: canonicalIds(positions),
     });
 }
+/** Redeeming shop items: the collection, the token id set and the holder. No terminal, payout token or minimum. */
+export function redeemIntent({ chainId, project, hook, tokenIds, holder, }) {
+    return writeIntentKey("redeem-items", {
+        chainId,
+        project: id(project),
+        hook: intent.address(hook),
+        tokenIds: canonicalIds(tokenIds),
+        holder: intent.address(holder),
+    });
+}
+/** Paying out from a project's surplus allowance: the allowance line and beneficiary. No amount or minimum. */
+export function allowanceIntent({ chainId, project, terminal, token, currency, beneficiary, }) {
+    return writeIntentKey("use-allowance", {
+        chainId,
+        project: id(project),
+        terminal: intent.address(terminal),
+        token: intent.address(token),
+        currency: id(currency),
+        beneficiary: intent.address(beneficiary),
+    });
+}
+/** Burning a holder's project tokens. No amount. */
+export function burnIntent({ chainId, project, holder, }) {
+    return writeIntentKey("burn", {
+        chainId,
+        project: id(project),
+        holder: intent.address(holder),
+    });
+}
+/**
+ * Proposing one batch to a Safe: the Safe and its exact calls, in order. A
+ * generic batch has no coarser identity, so its calls are the user's choice.
+ */
+export function safeBatchIntent({ chainId, safe, calls, }) {
+    return writeIntentKey("safe-batch", {
+        chainId,
+        safe: intent.address(safe),
+        calls: calls.map((call) => ({
+            to: intent.address(call.to),
+            data: intent.hex(call.data),
+            value: id(call.value ?? 0n),
+        })),
+    });
+}
+/** Syncing a bridge's accounting through one sucker. No fee. */
+export function syncIntent({ chainId, sucker, account, }) {
+    return writeIntentKey("bridge-sync", {
+        chainId,
+        sucker: intent.address(sucker),
+        account: intent.address(account),
+    });
+}
 //# sourceMappingURL=intents.js.map

package/dist/esm/review/intents.js.map

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

package/dist/esm/review/react/HeldWritesNotice.d.ts

@@ -0,0 +1,11 @@
+import type { HeldWriteItem } from "./useHeldWrites.js";
+/**
+ * The one app-wide notice of held writes: each with its action's label, its
+ * line, any warning, and the release when its hold offers the exit. Feed it
+ * useHeldWrites, useHeldIntents, or both. Unstyled: `className` is the hook.
+ */
+export declare function HeldWritesNotice({ items, className, }: {
+    items: readonly HeldWriteItem[];
+    className?: string;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=HeldWritesNotice.d.ts.map

package/dist/esm/review/react/HeldWritesNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeldWritesNotice.d.ts","sourceRoot":"","sources":["../../../../src/review/react/HeldWritesNotice.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,SAAS,GACV,EAAE;IACD,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,sCA4BA"}

package/dist/esm/review/react/HeldWritesNotice.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { HELD_RELEASE_LABEL } from "../index.js";
+import { useState } from "react";
+/**
+ * The one app-wide notice of held writes: each with its action's label, its
+ * line, any warning, and the release when its hold offers the exit. Feed it
+ * useHeldWrites, useHeldIntents, or both. Unstyled: `className` is the hook.
+ */
+export function HeldWritesNotice({ items, className, }) {
+    const [busy, setBusy] = useState(null);
+    const shown = items.filter(({ view }) => view.line);
+    if (!shown.length)
+        return null;
+    return (_jsx("div", { role: "status", className: className, children: shown.map(({ key, label, view, release }) => (_jsxs("div", { "data-phase": view.phase, children: [label ? _jsx("p", { children: label }) : null, _jsx("p", { children: view.line }), view.warning ? _jsx("p", { children: view.warning }) : null, view.notice ? _jsx("p", { children: view.notice }) : null, view.exit ? (_jsx("button", { type: "button", disabled: busy === key, onClick: () => {
+                        setBusy(key);
+                        void release().finally(() => setBusy(null));
+                    }, children: HELD_RELEASE_LABEL })) : null] }, key))) }));
+}
+//# sourceMappingURL=HeldWritesNotice.js.map

package/dist/esm/review/react/HeldWritesNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeldWritesNotice.js","sourceRoot":"","sources":["../../../../src/review/react/HeldWritesNotice.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGjC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,KAAK,EACL,SAAS,GAIV;IACC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,CACL,cAAK,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAE,SAAS,YACpC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAC5C,6BAA2B,IAAI,CAAC,KAAK,aAClC,KAAK,CAAC,CAAC,CAAC,sBAAI,KAAK,GAAK,CAAC,CAAC,CAAC,IAAI,EAC9B,sBAAI,IAAI,CAAC,IAAI,GAAK,EACjB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAI,IAAI,CAAC,OAAO,GAAK,CAAC,CAAC,CAAC,IAAI,EAC3C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAI,IAAI,CAAC,MAAM,GAAK,CAAC,CAAC,CAAC,IAAI,EACzC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CACX,iBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,IAAI,KAAK,GAAG,EACtB,OAAO,EAAE,GAAG,EAAE;wBACZ,OAAO,CAAC,GAAG,CAAC,CAAC;wBACb,KAAK,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC9C,CAAC,YAEA,kBAAkB,GACZ,CACV,CAAC,CAAC,CAAC,IAAI,KAhBA,GAAG,CAiBP,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/esm/review/react/heldView.d.ts

@@ -0,0 +1,25 @@
+import { type HeldWriteView, type HeldWriteViewController } from "../index.js";
+/** The actions a shown held-write view offers, the one way both hooks show them. */
+export type HeldViewActions = {
+    /** The exit the hold offers now, with its label; null when none. */
+    exitAction: {
+        label: string;
+        run: () => Promise<boolean>;
+    } | null;
+    /**
+     * On a success settled while away ("This went through while you were
+     * away."): the user's choice to send it again. Null otherwise.
+     */
+    sendAgainAction: {
+        label: string;
+        run: () => Promise<void>;
+    } | null;
+};
+export declare const IDLE: HeldWriteView;
+export declare const none: () => () => void;
+export declare const idle: () => HeldWriteView;
+/** A value's identity for a memo key, wei amounts (bigints) included. */
+export declare const keyOf: (value: unknown) => string;
+/** The exit and send-again actions of what `view` shows. */
+export declare function actionsOf(shown: HeldWriteView, view: HeldWriteViewController | undefined): HeldViewActions;
+//# sourceMappingURL=heldView.d.ts.map

package/dist/esm/review/react/heldView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heldView.d.ts","sourceRoot":"","sources":["../../../../src/review/react/heldView.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG;IAC5B,oEAAoE;IACpE,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE;;;OAGG;IACH,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CACrE,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,aAMlB,CAAC;AACF,eAAO,MAAM,IAAI,kBAAiB,CAAC;AACnC,eAAO,MAAM,IAAI,qBAAa,CAAC;AAC/B,yEAAyE;AACzE,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,WAGjC,CAAC;AAEJ,4DAA4D;AAC5D,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,uBAAuB,GAAG,SAAS,GACxC,eAAe,CASjB"}

package/dist/esm/review/react/heldView.js

@@ -0,0 +1,22 @@
+import { HELD_EXIT_LABEL, HELD_SEND_AGAIN_LABEL, } from "../index.js";
+export const IDLE = {
+    phase: "clear",
+    state: null,
+    line: null,
+    exit: false,
+    adopting: false,
+};
+export const none = () => () => { };
+export const idle = () => IDLE;
+/** A value's identity for a memo key, wei amounts (bigints) included. */
+export const keyOf = (value) => JSON.stringify(value, (_, field) => typeof field === "bigint" ? `${field}n` : field);
+/** The exit and send-again actions of what `view` shows. */
+export function actionsOf(shown, view) {
+    return {
+        exitAction: shown.exit && view ? { label: HELD_EXIT_LABEL, run: view.exit } : null,
+        sendAgainAction: shown.phase === "succeeded" && view
+            ? { label: HELD_SEND_AGAIN_LABEL, run: view.acknowledge }
+            : null,
+    };
+}
+//# sourceMappingURL=heldView.js.map

package/dist/esm/review/react/heldView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heldView.js","sourceRoot":"","sources":["../../../../src/review/react/heldView.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,GAGtB,MAAM,aAAa,CAAC;AAarB,MAAM,CAAC,MAAM,IAAI,GAAkB;IACjC,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;CAChB,CAAC;AACF,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;AAC/B,yEAAyE;AACzE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CACtC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACjC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAChD,CAAC;AAEJ,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CACvB,KAAoB,EACpB,IAAyC;IAEzC,OAAO;QACL,UAAU,EACR,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;QACxE,eAAe,EACb,KAAK,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI;YACjC,CAAC,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE;YACzD,CAAC,CAAC,IAAI;KACX,CAAC;AACJ,CAAC"}

package/dist/esm/review/react/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./HeldWritesNotice.js";
+export * from "./useHeldWrite.js";
+export * from "./useHeldWrites.js";
+export * from "./useSavedAttempt.js";
+export * from "./useHeldSend.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/review/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/esm/review/react/index.js

@@ -0,0 +1,6 @@
+export * from "./HeldWritesNotice.js";
+export * from "./useHeldWrite.js";
+export * from "./useHeldWrites.js";
+export * from "./useSavedAttempt.js";
+export * from "./useHeldSend.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/review/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/esm/review/react/useHeldSend.d.ts

@@ -0,0 +1,30 @@
+import { type HeldWriteView, type WriteHoldGate, type WriteHoldHandle } from "../index.js";
+import type { Hex } from "viem";
+import { type HeldViewActions } from "./heldView.js";
+import type { UseHeldWriteOptions } from "./useHeldWrite.js";
+/** One send's hold: what useHeldWrite takes up front, known only at send time. */
+export type HeldSendInput = Pick<UseHeldWriteOptions, "chainId" | "account" | "safe" | "namespace" | "legacy"> & {
+    /** The reviewed call this send sends. */
+    call: NonNullable<UseHeldWriteOptions["call"]>;
+};
+export type UseHeldSendOptions = Pick<UseHeldWriteOptions, "hold" | "client" | "pollMs" | "onSettled" | "onReleased"> & {
+    /** False when the app follows the transaction or proposal itself. */
+    follow?: boolean;
+};
+export type UseHeldSendResult = HeldWriteView & HeldViewActions & {
+    /** Send `call` under its hold: its intent's (or call's) view, made or reused, shows from now. */
+    send: (input: HeldSendInput, run: (gate: WriteHoldGate) => Promise<Hex>) => Promise<Hex>;
+    /** Ask the chain now about the current send. */
+    check: () => Promise<HeldWriteView>;
+    /** The current send's hold handle. */
+    handle: WriteHoldHandle | undefined;
+};
+/**
+ * Held sends whose call is known only at send time (a generic contract write
+ * or Safe transaction): each send runs through the held-write view of its
+ * intent or exact call, made once and reused, and the result shows the
+ * current send's line, notice and exit as {@link useHeldWrite} does. Only
+ * the current send's view runs and reaches the app's callbacks.
+ */
+export declare function useHeldSend(options: UseHeldSendOptions): UseHeldSendResult;
+//# sourceMappingURL=useHeldSend.d.ts.map

package/dist/esm/review/react/useHeldSend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHeldSend.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useHeldSend.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,mBAAmB,EACnB,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CACxD,GAAG;IACF,yCAAyC;IACzC,IAAI,EAAE,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,mBAAmB,EACnB,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAC1D,GAAG;IACF,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAC3C,eAAe,GAAG;IAChB,iGAAiG;IACjG,IAAI,EAAE,CACJ,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,GAAG,CAAC,KACvC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,sCAAsC;IACtC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;CACrC,CAAC;AAIJ;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA0F1E"}

package/dist/esm/review/react/useHeldSend.js

@@ -0,0 +1,77 @@
+import { createHeldWriteView, } from "../index.js";
+import { useEffect, useMemo, useRef, useState, useSyncExternalStore, } from "react";
+import { actionsOf, IDLE, idle, keyOf, none, } from "./heldView.js";
+/**
+ * Held sends whose call is known only at send time (a generic contract write
+ * or Safe transaction): each send runs through the held-write view of its
+ * intent or exact call, made once and reused, and the result shows the
+ * current send's line, notice and exit as {@link useHeldWrite} does. Only
+ * the current send's view runs and reaches the app's callbacks.
+ */
+export function useHeldSend(options) {
+    const { hold, client, pollMs, follow } = options;
+    const latest = useRef(options);
+    latest.current = options;
+    /** This hold and client's views, by their send's identity. */
+    const views = useMemo(() => new Map(), [hold, client, pollMs, follow]);
+    const [current, setCurrent] = useState();
+    // A view of an earlier hold or client shows nothing.
+    const held = current?.views === views ? current.held : undefined;
+    const view = held?.view;
+    /**
+     * The one view running, started at its send: a replaced view is stopped
+     * then, so only the current send's view ever tells the app anything, and
+     * a success it never told stays pending for the gate.
+     */
+    const running = useRef(undefined);
+    useEffect(() => () => {
+        if (running.current?.views !== views)
+            return;
+        running.current.stop();
+        running.current = undefined;
+    }, [views]);
+    const shown = useSyncExternalStore(view?.subscribe ?? none, view?.get ?? idle, view?.get ?? idle);
+    return {
+        ...shown,
+        ...actionsOf(shown, view),
+        send: (input, run) => {
+            if (!client)
+                return Promise.reject(new Error("Connect a wallet and build the call before sending."));
+            const { chainId, account, safe = false, namespace, legacy, call } = input;
+            const key = keyOf([
+                chainId,
+                account.toLowerCase(),
+                safe,
+                namespace ?? null,
+                call,
+                legacy ?? null,
+            ]);
+            let next = views.get(key);
+            if (!next) {
+                const handle = hold.open({ chainId, account, safe, call, ...(namespace ? { namespace } : {}) }, legacy ? { legacy } : undefined);
+                const created = createHeldWriteView(handle, {
+                    client,
+                    pollMs,
+                    ...(follow === undefined ? {} : { follow }),
+                    // A stopped view tells no settlement; a late release is dropped here.
+                    onSettled: (settled, receipt) => latest.current.onSettled?.(settled, receipt),
+                    onReleased: (by) => {
+                        if (running.current?.view === created)
+                            latest.current.onReleased?.(by);
+                    },
+                });
+                next = { handle, view: created };
+                views.set(key, next);
+            }
+            if (running.current?.view !== next.view) {
+                running.current?.stop();
+                running.current = { views, view: next.view, stop: next.view.start() };
+            }
+            setCurrent({ views, held: next });
+            return next.view.send(run);
+        },
+        check: () => (view ? view.check() : Promise.resolve(IDLE)),
+        handle: held?.handle,
+    };
+}
+//# sourceMappingURL=useHeldSend.js.map

package/dist/esm/review/react/useHeldSend.js.map

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

package/dist/esm/review/react/useHeldWrite.d.ts

@@ -0,0 +1,51 @@
+import { type HeldWriteEvidence, type HeldWriteView, type ReviewedWriteRecoveryInput, type WriteHold, type WriteHoldClient, type WriteHoldGate, type WriteHoldHandle, type WriteHoldSettled, type WriteHoldState } from "../index.js";
+import type { Address, Hex, TransactionReceipt } from "viem";
+import { type HeldViewActions } from "./heldView.js";
+export type UseHeldWriteOptions = {
+    /** The app's one write hold controller (createWriteHold()). */
+    hold: WriteHold;
+    chainId: number;
+    /** The account that sends: the wallet, or the Safe. */
+    account: Address;
+    /** Whether `account` is a Safe whose writes are proposals. */
+    safe?: boolean;
+    /** The action's intent key (payIntent and the other builders). */
+    namespace?: string;
+    /** Keys an earlier version held this write under. */
+    legacy?: Parameters<WriteHold["open"]>[1] extends infer O ? O extends {
+        legacy?: infer L;
+    } ? L : never : never;
+    /** The reviewed call, when built; without one, the hold is found by `namespace`. */
+    call?: ReviewedWriteRecoveryInput["call"];
+    /** Reads the account's chain. */
+    client: WriteHoldClient | undefined;
+    /** A previous deploy's saved evidence of this write: adopted before any send. */
+    adopt?: () => Promise<HeldWriteEvidence | null | undefined>;
+    onAdopted?: (state: WriteHoldState) => void;
+    /** The hold settled what this view saw held, on authenticated evidence: once. */
+    onSettled?: (settled: WriteHoldSettled, receipt: TransactionReceipt | null) => void;
+    /** Released: by the user's exit (reopen the review), or by another window. */
+    onReleased?: (by: "user" | "other-tab") => void;
+    /** How often a held write is asked again (15 s to 60 s, 30 s by default). */
+    pollMs?: number;
+};
+export type UseHeldWriteResult = HeldWriteView & HeldViewActions & {
+    /** Send under the hold, once any adoption is done. */
+    send: (run: (gate: WriteHoldGate) => Promise<Hex>) => Promise<Hex>;
+    /** Ask the chain now. */
+    check: () => Promise<HeldWriteView>;
+    /** The hold handle, for anything else. */
+    handle: WriteHoldHandle | undefined;
+};
+/**
+ * One held write, the one way every app runs it: its send under the hold,
+ * the watch, the shared follower of its transaction or Safe proposal, its
+ * one line, its exit and the adoption of a previous deploy's record.
+ *
+ * The exit ("I checked my wallet") only releases the hold: `onReleased("user")`
+ * is where the app reopens its review, so a resend always shows the values it
+ * sends. A release by another window is neutral (`releasedBy: "other-tab"`),
+ * and `onSettled` fires only for a settlement of what this view saw held.
+ */
+export declare function useHeldWrite(options: UseHeldWriteOptions): UseHeldWriteResult;
+//# sourceMappingURL=useHeldWrite.d.ts.map

package/dist/esm/review/react/useHeldWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHeldWrite.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useHeldWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAElB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAQvB,MAAM,MAAM,mBAAmB,GAAG;IAChC,+DAA+D;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GACrD,CAAC,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAC5B,CAAC,GACD,KAAK,GACP,KAAK,CAAC;IACV,oFAAoF;IACpF,IAAI,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC1C,iCAAiC;IACjC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,iFAAiF;IACjF,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,kBAAkB,GAAG,IAAI,KAC/B,IAAI,CAAC;IACV,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC;IAChD,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAC5C,eAAe,GAAG;IAChB,sDAAsD;IACtD,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACnE,yBAAyB;IACzB,KAAK,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,0CAA0C;IAC1C,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;CACrC,CAAC;AAEJ;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA2F7E"}

package/dist/esm/review/react/useHeldWrite.js

@@ -0,0 +1,91 @@
+import { createHeldWriteView, } from "../index.js";
+import { useEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { actionsOf, IDLE, idle, keyOf, none, } from "./heldView.js";
+/** A call stand-in for a hold found by its intent alone, before any call is built. */
+const NO_CALL = {
+    to: "0x0000000000000000000000000000000000000000",
+    data: "0x",
+};
+/**
+ * One held write, the one way every app runs it: its send under the hold,
+ * the watch, the shared follower of its transaction or Safe proposal, its
+ * one line, its exit and the adoption of a previous deploy's record.
+ *
+ * The exit ("I checked my wallet") only releases the hold: `onReleased("user")`
+ * is where the app reopens its review, so a resend always shows the values it
+ * sends. A release by another window is neutral (`releasedBy: "other-tab"`),
+ * and `onSettled` fires only for a settlement of what this view saw held.
+ */
+export function useHeldWrite(options) {
+    const { hold, chainId, account, safe = false, namespace, client, pollMs, } = options;
+    const callKey = keyOf(options.call ?? null);
+    const legacyKey = keyOf(options.legacy ?? null);
+    const latest = useRef(options);
+    latest.current = options;
+    const handle = useMemo(() => {
+        const call = latest.current.call;
+        if (!call && !namespace)
+            return undefined;
+        const legacy = latest.current.legacy;
+        return hold.open({
+            chainId,
+            account,
+            safe,
+            call: call ?? NO_CALL,
+            ...(namespace ? { namespace } : {}),
+        }, legacy ? { legacy } : undefined);
+        // The call and legacy keys stand for their values.
+    }, [hold, chainId, account, safe, namespace, callKey, legacyKey]);
+    // Whether the app has a previous deploy's record to adopt: a change makes a
+    // new view, whose adoption runs before any send.
+    const adopts = !!options.adopt;
+    /** The view whose callbacks are the app's now: an earlier one's late answers reach none. */
+    const active = useRef(undefined);
+    const view = useMemo(() => {
+        if (!handle || !client)
+            return undefined;
+        /** Only while this view is the app's: an earlier one's late answers reach no callback. */
+        const own = (callback) => (...args) => {
+            if (active.current === created)
+                callback(...args);
+        };
+        const created = createHeldWriteView(handle, {
+            client,
+            pollMs,
+            onSettled: own((settled, receipt) => latest.current.onSettled?.(settled, receipt)),
+            onReleased: own((by) => latest.current.onReleased?.(by)),
+            onAdopted: own((state) => latest.current.onAdopted?.(state)),
+            // A view made with a provider: the app's current one (a removed one
+            // makes a new view, and this one stops).
+            ...(adopts ? { adopt: () => latest.current.adopt() } : {}),
+        });
+        return created;
+    }, [handle, client, pollMs, adopts]);
+    useEffect(() => {
+        if (!view)
+            return;
+        active.current = view;
+        const stop = view.start();
+        return () => {
+            if (active.current === view)
+                active.current = undefined;
+            stop();
+        };
+    }, [view]);
+    const shown = useSyncExternalStore(view?.subscribe ?? none, view?.get ?? idle, view?.get ?? idle);
+    return {
+        ...shown,
+        ...actionsOf(shown, view),
+        send: (run) => {
+            if (!view)
+                return Promise.reject(new Error("Connect a wallet and build the call before sending."));
+            // A record to adopt that this view doesn't know of yet: never send past it.
+            if (!!latest.current.adopt !== adopts)
+                return Promise.reject(new Error("Saved transactions are still being checked. Try again in a moment."));
+            return view.send(run);
+        },
+        check: () => (view ? view.check() : Promise.resolve(IDLE)),
+        handle,
+    };
+}
+//# sourceMappingURL=useHeldWrite.js.map

package/dist/esm/review/react/useHeldWrite.js.map

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

package/dist/esm/review/react/useHeldWrites.d.ts

@@ -0,0 +1,40 @@
+import { type HeldWriteView, type WriteHold, type WriteHoldClient } from "../index.js";
+import type { Address } from "viem";
+/** One held write an app-wide notice shows. */
+export type HeldWriteItem = {
+    key: string;
+    /** What the action is, when the app names it. */
+    label?: string;
+    view: HeldWriteView;
+    /** Release it (the notice's exit): true when released. */
+    release: () => Promise<boolean>;
+};
+/**
+ * The holds of a fixed set of actions, found by their intents alone and
+ * shown with their lines and exits, whatever the actions' buttons allow now.
+ */
+export declare function useHeldIntents({ hold, chainId, account, client, intents, pollMs, }: {
+    hold: WriteHold;
+    chainId: number;
+    account: Address | undefined;
+    client: WriteHoldClient | undefined;
+    intents: readonly {
+        namespace: string;
+        label?: string;
+    }[];
+    pollMs?: number;
+}): HeldWriteItem[];
+/**
+ * Every write held for `account` on `chainId`, whatever action made it
+ * (`hold.list`), read again when another window changes one and every poll.
+ */
+export declare function useHeldWrites({ hold, chainId, account, client, label, pollMs, }: {
+    hold: WriteHold;
+    chainId: number;
+    account: Address | undefined;
+    client: WriteHoldClient | undefined;
+    /** The app's name for a listed write's action, when it knows it. */
+    label?: (record: ReturnType<WriteHold["list"]>[number]["record"]) => string | undefined;
+    pollMs?: number;
+}): HeldWriteItem[];
+//# sourceMappingURL=useHeldWrites.d.ts.map

package/dist/esm/review/react/useHeldWrites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHeldWrites.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useHeldWrites.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,SAAS,EACd,KAAK,eAAe,EAErB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,OAAO,EAAO,MAAM,MAAM,CAAC;AAEzC,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAqDF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,OAAO,EACP,MAAM,EACN,OAAO,EACP,MAAM,GACP,EAAE;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,SAAS;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,EAAE,CAqBlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,OAAO,EACP,OAAO,EACP,MAAM,EACN,KAAK,EACL,MAAe,GAChB,EAAE;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,oEAAoE;IACpE,KAAK,CAAC,EAAE,CACN,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KACpD,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,EAAE,CA6BlB"}

package/dist/esm/review/react/useHeldWrites.js

@@ -0,0 +1,91 @@
+import { createHeldWriteView, } from "../index.js";
+import { useEffect, useMemo, useState, useSyncExternalStore } from "react";
+/** Watch each entry's hold as one held write view; held ones (and fresh results) come back as items. */
+function useHeldViews(entries, client, pollMs) {
+    const views = useMemo(() => client
+        ? entries.map((entry) => ({
+            entry,
+            view: createHeldWriteView(entry.handle, { client, pollMs }),
+        }))
+        : [], [entries, client, pollMs]);
+    useEffect(() => {
+        const stops = views.map(({ view }) => view.start());
+        return () => stops.forEach((stop) => stop());
+    }, [views]);
+    const store = useMemo(() => feed(views.map(({ view }) => view)), [views]);
+    const shown = useSyncExternalStore(store.subscribe, store.get, store.get);
+    return views
+        .map(({ entry, view }, index) => ({
+        key: entry.key,
+        ...(entry.label ? { label: entry.label } : {}),
+        view: shown[index],
+        release: view.exit,
+    }))
+        .filter(({ view }) => view.phase !== "clear");
+}
+/** Several views as one store: a snapshot array that changes when any view does. */
+function feed(views) {
+    let snapshot = views.map((view) => view.get());
+    return {
+        subscribe(listener) {
+            const stops = views.map((view) => view.subscribe(() => {
+                snapshot = views.map((each) => each.get());
+                listener();
+            }));
+            return () => stops.forEach((stop) => stop());
+        },
+        get: () => snapshot,
+    };
+}
+/**
+ * The holds of a fixed set of actions, found by their intents alone and
+ * shown with their lines and exits, whatever the actions' buttons allow now.
+ */
+export function useHeldIntents({ hold, chainId, account, client, intents, pollMs, }) {
+    const intentsKey = JSON.stringify(intents);
+    const entries = useMemo(() => account
+        ? intents.map(({ namespace, label }) => ({
+            key: namespace,
+            label,
+            handle: hold.open({
+                chainId,
+                account,
+                safe: false,
+                namespace,
+                call: { to: account, data: "0x" },
+            }),
+        }))
+        : [], 
+    // The intents key stands for the intents.
+    [hold, chainId, account, intentsKey]);
+    return useHeldViews(entries, client, pollMs);
+}
+/**
+ * Every write held for `account` on `chainId`, whatever action made it
+ * (`hold.list`), read again when another window changes one and every poll.
+ */
+export function useHeldWrites({ hold, chainId, account, client, label, pollMs = 30_000, }) {
+    const [generation, setGeneration] = useState(0);
+    useEffect(() => {
+        const again = () => setGeneration((value) => value + 1);
+        globalThis.addEventListener?.("storage", again);
+        const timer = setInterval(again, pollMs);
+        return () => {
+            globalThis.removeEventListener?.("storage", again);
+            clearInterval(timer);
+        };
+    }, [pollMs]);
+    const listed = useMemo(() => (account ? hold.list({ account, chainId }) : []), [hold, account, chainId, generation]);
+    const listedKey = listed
+        .map(({ key, record }) => `${key}:${record.id}`)
+        .join("|");
+    const entries = useMemo(() => listed.map(({ key, record, handle }) => ({
+        key,
+        label: label?.(record),
+        handle,
+    })), 
+    // The listed key stands for the list.
+    [listedKey]);
+    return useHeldViews(entries, client, pollMs);
+}
+//# sourceMappingURL=useHeldWrites.js.map

package/dist/esm/review/react/useHeldWrites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHeldWrites.js","sourceRoot":"","sources":["../../../../src/review/react/useHeldWrites.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAMpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAe3E,wGAAwG;AACxG,SAAS,YAAY,CACnB,OAAyB,EACzB,MAAmC,EACnC,MAA0B;IAE1B,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,MAAM;QACJ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtB,KAAK;YACL,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAC5D,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,EACR,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAC1B,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;QAClB,OAAO,EAAE,IAAI,CAAC,IAAI;KACnB,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,oFAAoF;AACpF,SAAS,IAAI,CAAC,KAAyC;IACrD,IAAI,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,OAAO;QACL,SAAS,CAAC,QAAoB;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBAClB,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC3C,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC,CACH,CAAC;YACF,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,OAAO,EACP,MAAM,EACN,OAAO,EACP,MAAM,GAQP;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CACH,OAAO;QACL,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACrC,GAAG,EAAE,SAAS;YACd,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;gBAChB,OAAO;gBACP,OAAO;gBACP,IAAI,EAAE,KAAK;gBACX,SAAS;gBACT,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAW,EAAE;aACzC,CAAC;SACH,CAAC,CAAC;QACL,CAAC,CAAC,EAAE;IACR,0CAA0C;IAC1C,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CACrC,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,OAAO,EACP,OAAO,EACP,MAAM,EACN,KAAK,EACL,MAAM,GAAG,MAAM,GAWhB;IACC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACxD,UAAU,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,mBAAmB,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACnD,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EACtD,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CACrC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM;SACrB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;SAC/C,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,GAAG;QACH,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC;QACtB,MAAM;KACP,CAAC,CAAC;IACL,sCAAsC;IACtC,CAAC,SAAS,CAAC,CACZ,CAAC;IACF,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}