@bananapus/nana-sdk-core 6.1.0 → 6.3.0

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

@@ -0,0 +1,30 @@
+import type { Address } from "viem";
+/**
+ * A form's own write, by the account that sent it and its reservation:
+ * `owned` (its success not shown yet: a later run of the form closes on it)
+ * until `shown` (its done rendered, or its close acknowledged it), which is
+ * final. `dismissed` lists the runs whose own showing the user closed: a
+ * showing by one of them never counts.
+ */
+export type OwnEntry = {
+    readonly account: Address;
+    readonly reservation: string;
+    readonly state: "owned" | "shown";
+    readonly dismissed: readonly number[];
+};
+/** What happened to a form's write: kept, dismissed by `run`, or shown (by `run`). */
+export type OwnChange = {
+    kind: "keep";
+} | {
+    kind: "dismiss";
+    run: number;
+} | {
+    kind: "shown";
+    run?: number;
+};
+/**
+ * The one way an entry changes: it only moves forward. A shown entry stays
+ * shown, and a dismissing run, once listed, is never dropped.
+ */
+export declare function mergeOwn(entry: OwnEntry | undefined, account: Address, reservation: string, change: OwnChange): OwnEntry;
+//# sourceMappingURL=ownership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../../src/review/react/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,QAAQ,CAiBV"}

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

@@ -0,0 +1,24 @@
+/**
+ * The one way an entry changes: it only moves forward. A shown entry stays
+ * shown, and a dismissing run, once listed, is never dropped.
+ */
+export function mergeOwn(entry, account, reservation, change) {
+    const now = entry ?? {
+        account,
+        reservation,
+        state: "owned",
+        dismissed: [],
+    };
+    if (now.state === "shown")
+        return now;
+    if (change.kind === "dismiss")
+        return now.dismissed.includes(change.run)
+            ? now
+            : { ...now, dismissed: [...now.dismissed, change.run] };
+    if (change.kind === "shown")
+        return change.run !== undefined && now.dismissed.includes(change.run)
+            ? now
+            : { ...now, state: "shown" };
+    return now;
+}
+//# sourceMappingURL=ownership.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../../../../src/review/react/ownership.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAA2B,EAC3B,OAAgB,EAChB,WAAmB,EACnB,MAAiB;IAEjB,MAAM,GAAG,GAAa,KAAK,IAAI;QAC7B,OAAO;QACP,WAAW;QACX,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,EAAE;KACd,CAAC;IACF,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC;IACtC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAC3B,OAAO,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;YACvC,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;QACzB,OAAO,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;YACnE,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACjC,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -1,4 +1,4 @@
-import { type HeldWriteView, type ReviewedAction, type ReviewedProgress, type ReviewedResult, type ReviewedRunStatus, type ReviewedSendDeps, type completeReviewedStep, type resumeReviewed, type sendReviewed } from "../index.js";
+import { type HeldWriteView, type ReviewedAction, type ReviewedCall, type ReviewedProgress, type ReviewedResult, type ReviewedRunStatus, type ReviewedSendDeps, type completeReviewedStep, type resumeReviewed, type sendReviewed } from "../index.js";
 import { type HeldViewActions } from "./heldView.js";
 import type { Address, Hex, TransactionReceipt } from "viem";
 /** The send engine: the review model, its decoder and the ABIs it reads. */
@@ -17,6 +17,8 @@ export type UseReviewedRunDeps = ReviewedSendDeps & {
      * again only after a load failed.
      */
     engine: () => Promise<ReviewedEngine>;
+    /** A held step `dismiss` closed later succeeded: refresh its reads. */
+    onDismissedSettled?: (call: ReviewedCall) => void;
 };
 /** A run that failed: `error` is the line to show, `failure` the value thrown. */
 export type ReviewedRunFailed = {
@@ -59,11 +61,13 @@ export type UseReviewedRunResult = {
      * `follow.timeoutMs` (2 minutes by default); only then does the run resolve
      * `receipt`, and the hook follows the hold until it settles.
      * `onCancelled` runs once when the run ends `cancelled`: nothing sent and
-     * nothing held.
+     * nothing held; `onStopped` once when it ends `stopped`, with the last step
+     * sent. Both are told once that state rendered.
      */
     run: (action: Omit<ReviewedAction, "account" | "guard"> & {
         account?: Address;
         onCancelled?: () => void;
+        onStopped?: (step: number) => void;
     }) => Promise<ReviewedResult | ReviewedRunReceipt | ReviewedRunFailed | null>;
     /**
      * The highest step of the action whose hash the wallet returned in the
@@ -73,8 +77,10 @@ export type UseReviewedRunResult = {
     lastSubmittedStep: number | null;
     /** The run's status, from `reviewedRunStatus`: the one every app shows. */
     status: ReviewedRunStatus;
-    /** Reviewing, simulating, signing or confirming a receipt: the action waits. */
+    /** Reviewing, simulating, signing or confirming in place (not `following`). */
     busy: boolean;
+    /** The run only follows a sent step's hold: the confirm can close. */
+    following: boolean;
     phase: ReviewedProgress["phase"] | "idle";
     step: number;
     total: number;
@@ -109,6 +115,14 @@ export type UseReviewedRunResult = {
      */
     held: HeldWriteView | null;
     reset: () => void;
+    /**
+     * Closes the confirm; false while the review or wallet is open. A held
+     * earlier step ends the run (nothing more reviewed; its hold followed
+     * detached, `onDismissedSettled`). A held last step only ends the wait
+     * (`ended()` null) and stays shown. Otherwise it resets, following any hold
+     * it showed detached. Never evidence a step can be resent.
+     */
+    dismiss: () => boolean;
     /**
      * Loads the send engine now (on hover, focus or pointerdown of the action),
      * so the review opens without a wait. Safe to call any number of times: it

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

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