@lunatest/react 0.1.0 → 0.1.1

package/dist/LunaTestProvider.js

@@ -1,14 +1,16 @@
 import React, { createContext, useMemo, useState } from "react";
 import { createLunaProvider } from "./luna-provider.js";
+import { createProviderOptionsKey } from "./provider-options.js";
 export const LunaTestContext = createContext(null);
 export function LunaTestProvider(props) {
     const [scenarioId, setScenarioId] = useState(props.initialScenarioId);
+    const optionsKey = createProviderOptionsKey(props.options);
     const provider = useMemo(() => {
         if (props.provider) {
             return props.provider;
         }
         return createLunaProvider(props.options ?? {});
-    }, [props.provider, props.options]);
+    }, [props.provider, optionsKey, props.options?.callHandler]);
     const value = useMemo(() => ({
         provider,
         scenarioId,

package/dist/bootstrap.d.ts

@@ -1,15 +1,32 @@
-import type { LuaConfig } from "@lunatest/core";
+import { type LunaWalletAssetState, type LunaWalletPermission } from "@lunatest/contracts";
+import type { LuaConfig } from "@lunatest/core/browser";
+import { type PresetRegistry, type ProjectPresetSources } from "@lunatest/core/browser";
 import { type LunaRuntimeInterceptConfig } from "@lunatest/runtime-intercept";
 export type LunaBootstrapOptions = {
+    enable?: boolean;
     source?: string | URL;
     nodeEnv?: string;
     mountDevtools?: boolean;
     devtoolsTargetId?: string;
+    presetRegistry?: PresetRegistry;
+    projectPresetSources?: ProjectPresetSources;
+    protocolPresetId?: string;
+    protocolPresetParams?: Record<string, unknown>;
+    walletPresetId?: string;
+    walletPresetParams?: Record<string, unknown>;
+    walletFallbackMode?: "off" | "manual-toggle";
+    walletPreset?: {
+        address: string;
+        chainId?: string;
+        permissions?: Array<LunaWalletPermission | string>;
+        assets?: Partial<LunaWalletAssetState>;
+    };
     configOverride?: Partial<LunaRuntimeInterceptConfig>;
 };
 export type LunaBootstrapResult = {
     enabled: boolean;
+    configLoaded: boolean;
     unmountDevtools?: () => void;
-    config: LuaConfig;
+    config?: LuaConfig;
 };
 export declare function bootstrapLunaRuntime(options?: LunaBootstrapOptions): Promise<LunaBootstrapResult>;

package/dist/bootstrap.js

@@ -1,9 +1,11 @@
-import { loadLunaConfig } from "@lunatest/core";
-import { applyInterceptState, enableLunaRuntimeIntercept, setRouteMocks, } from "@lunatest/runtime-intercept";
+import { createLunaWalletAssetState, normalizeWalletPermissions, } from "@lunatest/contracts";
+import { loadLunaConfig, createPresetRegistry, materializeProtocolPreset, materializeWalletPreset, } from "@lunatest/core/browser";
+import { applyInterceptState, disableLunaRuntimeIntercept, enableLunaRuntimeIntercept, resolveEnabled, setWalletSession, setRouteMocks, } from "@lunatest/runtime-intercept";
 import { mountLunaDevtools } from "./devtools/mount.js";
 import { resolveNodeEnv } from "./node-env.js";
-function toRuntimeConfig(config, configOverride) {
+function toRuntimeConfig(config, enable, configOverride) {
     return {
+        enable,
         ...configOverride,
         intercept: {
             ...configOverride?.intercept,
@@ -15,34 +17,85 @@ function toRuntimeConfig(config, configOverride) {
         },
     };
 }
+function resolveBootstrapEnabled(options, nodeEnv) {
+    if (typeof options.enable === "boolean") {
+        return options.enable;
+    }
+    return resolveEnabled({
+        enable: options.configOverride?.enable,
+    }, nodeEnv);
+}
 export async function bootstrapLunaRuntime(options = {}) {
-    const config = await loadLunaConfig(options.source ?? "./lunatest.lua");
     const nodeEnv = resolveNodeEnv(options.nodeEnv);
-    const runtimeConfig = toRuntimeConfig(config, options.configOverride);
+    const bootstrapEnabled = resolveBootstrapEnabled(options, nodeEnv);
+    if (!bootstrapEnabled) {
+        return {
+            enabled: false,
+            configLoaded: false,
+        };
+    }
+    const config = await loadLunaConfig(options.source ?? "./lunatest.lua");
+    const presetRegistry = options.presetRegistry ??
+        createPresetRegistry({
+            projectSources: options.projectPresetSources,
+        });
+    const runtimeConfig = toRuntimeConfig(config, options.enable ?? options.configOverride?.enable, options.configOverride);
     const enabled = enableLunaRuntimeIntercept(runtimeConfig, nodeEnv);
     if (!enabled) {
         return {
             enabled: false,
             config,
+            configLoaded: true,
         };
     }
-    const routeMocks = options.configOverride?.intercept?.routes ?? config.intercept?.routes ?? [];
-    setRouteMocks(routeMocks);
-    if (config.given) {
-        applyInterceptState(config.given);
+    try {
+        const routeMocks = options.configOverride?.intercept?.routes ?? config.intercept?.routes ?? [];
+        setRouteMocks(routeMocks);
+        if (config.given) {
+            applyInterceptState(config.given);
+        }
+        if (config.intercept?.state) {
+            applyInterceptState(config.intercept.state);
+        }
+        if (options.protocolPresetId) {
+            const materialized = await materializeProtocolPreset(options.protocolPresetId, options.protocolPresetParams, presetRegistry);
+            setRouteMocks(materialized.routeMocks);
+            applyInterceptState(materialized.interceptState);
+            setWalletSession(materialized.walletSession);
+        }
+        if (options.walletPresetId) {
+            const materialized = await materializeWalletPreset(options.walletPresetId, options.walletPresetParams, presetRegistry);
+            setWalletSession(materialized.walletSession);
+        }
+        if (options.walletPreset) {
+            setWalletSession({
+                enabled: false,
+                connected: false,
+                chainId: options.walletPreset.chainId ?? "0x1",
+                accounts: [options.walletPreset.address],
+                permissions: normalizeWalletPermissions(options.walletPreset.permissions),
+                assets: createLunaWalletAssetState(options.walletPreset.assets),
+            });
+        }
+        const unmountDevtools = options.mountDevtools === false
+            ? undefined
+            : mountLunaDevtools({
+                targetId: options.devtoolsTargetId,
+                nodeEnv,
+                panelProps: {
+                    presetRegistry,
+                    walletFallbackMode: options.walletFallbackMode ?? "off",
+                },
+            }) ?? undefined;
+        return {
+            enabled: true,
+            configLoaded: true,
+            unmountDevtools,
+            config,
+        };
     }
-    if (config.intercept?.state) {
-        applyInterceptState(config.intercept.state);
+    catch (error) {
+        disableLunaRuntimeIntercept();
+        throw error;
     }
-    const unmountDevtools = options.mountDevtools === false
-        ? undefined
-        : mountLunaDevtools({
-            targetId: options.devtoolsTargetId,
-            nodeEnv,
-        }) ?? undefined;
-    return {
-        enabled: true,
-        unmountDevtools,
-        config,
-    };
 }

package/dist/browser.d.ts

@@ -0,0 +1,5 @@
+export type { LunaBootstrapOptions, LunaBootstrapResult } from "./bootstrap.js";
+export { bootstrapLunaRuntime } from "./bootstrap.js";
+export { enableLunaIntercept } from "./intercept.js";
+export { LunaDevtoolsPanel } from "./devtools/LunaDevtoolsPanel.js";
+export { mountLunaDevtools } from "./devtools/mount.js";

package/dist/browser.js

@@ -0,0 +1,4 @@
+export { bootstrapLunaRuntime } from "./bootstrap.js";
+export { enableLunaIntercept } from "./intercept.js";
+export { LunaDevtoolsPanel } from "./devtools/LunaDevtoolsPanel.js";
+export { mountLunaDevtools } from "./devtools/mount.js";

package/dist/devtools/LunaDevtoolsPanel.d.ts

@@ -1,3 +1,5 @@
+import { type PresetRegistry } from "@lunatest/core/browser";
+import type { PresetDiagnostic } from "@lunatest/contracts";
 import { type RouteMock } from "@lunatest/runtime-intercept";
 type LunaDevtoolsPanelProps = {
     title?: string;
@@ -15,6 +17,9 @@ type LunaDevtoolsPanelProps = {
     };
     onSetRouteMocks?: (routes: RouteMock[]) => void | Promise<void>;
     onPatchState?: (patch: Record<string, unknown>) => void | Promise<void>;
+    initialPresetDiagnostics?: PresetDiagnostic[];
+    presetRegistry?: PresetRegistry;
+    walletFallbackMode?: "off" | "manual-toggle";
 };
 export declare function LunaDevtoolsPanel(props: LunaDevtoolsPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/devtools/LunaDevtoolsPanel.js

@@ -1,11 +1,39 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo, useState } from "react";
-import { executeLuaScenario, loadLunaConfig } from "@lunatest/core";
-import { applyInterceptState, getInterceptState, setRouteMocks, } from "@lunatest/runtime-intercept";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { createPresetRegistry, executeLuaScenario, getPresetDiagnostics, listProtocolPresets, listWalletPresets, loadLunaConfig, materializeProtocolPreset, materializeWalletPreset, } from "@lunatest/core/browser";
+import { applyInterceptState, connectWalletSession, disconnectWalletSession, getInterceptState, getWalletSession, setWalletSession, setRouteMocks, } from "@lunatest/runtime-intercept";
 function toPrettyJson(input) {
     return JSON.stringify(input, null, 2);
 }
+function buildDefaultParamValues(schema) {
+    return Object.fromEntries(schema.map((item) => [item.key, item.default === undefined ? "" : String(item.default)]));
+}
+function parsePresetValue(descriptor, value) {
+    if (descriptor.type === "number" || descriptor.type === "chainId") {
+        return Number(value);
+    }
+    if (descriptor.type === "boolean") {
+        return value === "true";
+    }
+    return value;
+}
+function resolveWalletSelectionId(walletPresets, candidateId) {
+    const exact = walletPresets.find((item) => item.qualifiedId === candidateId);
+    if (exact) {
+        return exact.qualifiedId;
+    }
+    const builtin = walletPresets.find((item) => item.qualifiedId === `builtin/${candidateId}`);
+    if (builtin) {
+        return builtin.qualifiedId;
+    }
+    const project = walletPresets.find((item) => item.qualifiedId === `project/${candidateId}`);
+    if (project) {
+        return project.qualifiedId;
+    }
+    return candidateId;
+}
 export function LunaDevtoolsPanel(props) {
+    const presetRegistry = useMemo(() => props.presetRegistry ?? createPresetRegistry(), [props.presetRegistry]);
     const initialLuaScript = useMemo(() => props.initialLua ??
         `scenario {
   name = "swap-warning",
@@ -33,6 +61,114 @@ export function LunaDevtoolsPanel(props) {
     const [status, setStatus] = useState("idle");
     const [error, setError] = useState(null);
     const [diff, setDiff] = useState(null);
+    const [protocolPresets, setProtocolPresets] = useState([]);
+    const [walletPresets, setWalletPresets] = useState([]);
+    const [selectedProtocolPresetId, setSelectedProtocolPresetId] = useState("");
+    const [selectedWalletPresetId, setSelectedWalletPresetId] = useState("");
+    const [selectedBuiltinScenarioId, setSelectedBuiltinScenarioId] = useState("");
+    const [presetParamValues, setPresetParamValues] = useState({});
+    const [presetParamsJson, setPresetParamsJson] = useState("{}");
+    const [materializedPreview, setMaterializedPreview] = useState("");
+    const [presetDiagnostics, setPresetDiagnostics] = useState(props.initialPresetDiagnostics ?? []);
+    const [walletSession, setWalletSessionState] = useState(() => {
+        try {
+            return getWalletSession();
+        }
+        catch {
+            return null;
+        }
+    });
+    const refreshWalletSession = () => {
+        try {
+            setWalletSessionState(getWalletSession());
+        }
+        catch {
+            setWalletSessionState(null);
+        }
+    };
+    const refreshPresetDiagnostics = async () => {
+        try {
+            const diagnostics = await getPresetDiagnostics(presetRegistry);
+            const projectDiagnostics = diagnostics.filter((item) => item.source === "project");
+            setPresetDiagnostics(projectDiagnostics.length > 0 ? projectDiagnostics : diagnostics);
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
+    };
+    useEffect(() => {
+        let cancelled = false;
+        async function loadBuiltIns() {
+            try {
+                const [protocols, wallets] = await Promise.all([
+                    listProtocolPresets(presetRegistry),
+                    listWalletPresets(presetRegistry),
+                ]);
+                if (cancelled) {
+                    return;
+                }
+                setProtocolPresets(protocols);
+                setWalletPresets(wallets);
+                setSelectedProtocolPresetId((current) => current || protocols[0]?.qualifiedId || "");
+                setSelectedWalletPresetId((current) => current || wallets[0]?.qualifiedId || "");
+                await refreshPresetDiagnostics();
+            }
+            catch (cause) {
+                if (!cancelled) {
+                    setError(cause instanceof Error ? cause.message : String(cause));
+                }
+            }
+        }
+        void loadBuiltIns();
+        return () => {
+            cancelled = true;
+        };
+    }, [presetRegistry]);
+    const selectedProtocolPreset = useMemo(() => protocolPresets.find((item) => item.qualifiedId === selectedProtocolPresetId) ?? null, [protocolPresets, selectedProtocolPresetId]);
+    const selectedWalletPreset = useMemo(() => walletPresets.find((item) => item.qualifiedId === selectedWalletPresetId) ?? null, [walletPresets, selectedWalletPresetId]);
+    const recommendedDescriptors = useMemo(() => {
+        const descriptors = new Map();
+        if (selectedProtocolPreset) {
+            const keys = new Set(selectedProtocolPreset.recommendedControls);
+            for (const descriptor of selectedProtocolPreset.paramsSchema) {
+                if (keys.has(descriptor.key)) {
+                    descriptors.set(descriptor.key, descriptor);
+                }
+            }
+        }
+        if (selectedWalletPreset?.paramsSchema) {
+            const keys = new Set(selectedWalletPreset.recommendedControls ?? []);
+            for (const descriptor of selectedWalletPreset.paramsSchema) {
+                if (keys.has(descriptor.key) && !descriptors.has(descriptor.key)) {
+                    descriptors.set(descriptor.key, descriptor);
+                }
+            }
+        }
+        return Array.from(descriptors.values());
+    }, [selectedProtocolPreset, selectedWalletPreset]);
+    useEffect(() => {
+        if (!selectedProtocolPreset) {
+            return;
+        }
+        setPresetParamValues(buildDefaultParamValues(selectedProtocolPreset.paramsSchema));
+        setSelectedBuiltinScenarioId(selectedProtocolPreset.builtinScenarios[0]?.id ?? "");
+        setSelectedWalletPresetId(resolveWalletSelectionId(walletPresets, selectedProtocolPreset.defaultWalletPreset.id));
+    }, [selectedProtocolPreset, walletPresets]);
+    const buildPresetParams = () => {
+        const params = {};
+        for (const descriptor of recommendedDescriptors) {
+            const current = presetParamValues[descriptor.key];
+            if (current === undefined || current === "") {
+                continue;
+            }
+            params[descriptor.key] = parsePresetValue(descriptor, current);
+        }
+        const advanced = JSON.parse(presetParamsJson);
+        return {
+            ...params,
+            ...advanced,
+        };
+    };
     const handleRun = async () => {
         setError(null);
         setDiff(null);
@@ -76,6 +212,8 @@ export function LunaDevtoolsPanel(props) {
             if (executed.diff) {
                 setDiff(executed.diff);
             }
+            refreshWalletSession();
+            await refreshPresetDiagnostics();
         }
         catch (cause) {
             setStatus("failed");
@@ -95,6 +233,8 @@ export function LunaDevtoolsPanel(props) {
                 setRouteMocks(parsed);
             }
             setStatus("routes-updated");
+            refreshWalletSession();
+            await refreshPresetDiagnostics();
         }
         catch (cause) {
             setStatus("failed");
@@ -114,6 +254,7 @@ export function LunaDevtoolsPanel(props) {
                 applyInterceptState(parsed);
             }
             setStatus("state-patched");
+            refreshWalletSession();
         }
         catch (cause) {
             setStatus("failed");
@@ -127,6 +268,60 @@ export function LunaDevtoolsPanel(props) {
         setStatus("reset");
         setError(null);
         setDiff(null);
+        refreshWalletSession();
+        void refreshPresetDiagnostics();
+    };
+    const handleApplyProtocolPreset = async () => {
+        if (!selectedProtocolPresetId) {
+            return;
+        }
+        setError(null);
+        setStatus("applying-protocol-preset");
+        try {
+            const params = buildPresetParams();
+            const materialized = await materializeProtocolPreset(selectedProtocolPresetId, params, presetRegistry);
+            let nextWalletSession = materialized.walletSession;
+            if (selectedWalletPresetId && selectedWalletPresetId !== materialized.walletPresetId) {
+                const walletMaterialized = await materializeWalletPreset(selectedWalletPresetId, params, presetRegistry);
+                nextWalletSession = walletMaterialized.walletSession;
+            }
+            setWalletSession(nextWalletSession);
+            setRouteMocks(materialized.routeMocks);
+            applyInterceptState(materialized.interceptState);
+            setMaterializedPreview(toPrettyJson(materialized));
+            setSelectedWalletPresetId(materialized.walletPresetId);
+            const scenario = materialized.builtinScenarios.find((item) => item.id === selectedBuiltinScenarioId) ??
+                materialized.builtinScenarios[0];
+            if (scenario) {
+                setLuaScript(scenario.lua);
+            }
+            refreshWalletSession();
+            await refreshPresetDiagnostics();
+            setStatus("protocol-preset-applied");
+        }
+        catch (cause) {
+            setStatus("failed");
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
+    };
+    const handleApplyWalletPreset = async () => {
+        if (!selectedWalletPresetId) {
+            return;
+        }
+        setError(null);
+        setStatus("applying-wallet-preset");
+        try {
+            const materialized = await materializeWalletPreset(selectedWalletPresetId, buildPresetParams(), presetRegistry);
+            setWalletSession(materialized.walletSession);
+            setMaterializedPreview(toPrettyJson(materialized));
+            refreshWalletSession();
+            await refreshPresetDiagnostics();
+            setStatus("wallet-preset-applied");
+        }
+        catch (cause) {
+            setStatus("failed");
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
     };
     return (_jsxs("aside", { "data-lunatest-devtools": true, style: {
             position: "fixed",
@@ -144,5 +339,46 @@ export function LunaDevtoolsPanel(props) {
             fontSize: 12,
             color: "#0f172a",
             padding: 12,
-        }, children: [_jsx("h3", { style: { margin: 0, marginBottom: 8 }, children: props.title ?? "LunaTest Devtools" }), _jsx("p", { style: { margin: 0, marginBottom: 10, color: "#334155" }, children: "Lua DSL\uACFC \uC778\uD130\uC149\uD2B8 \uC0C1\uD0DC\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uBC14\uB85C \uC218\uC815\uD569\uB2C8\uB2E4." }), _jsx("label", { htmlFor: "lunatest-lua-script", children: "Lua Scenario" }), _jsx("textarea", { id: "lunatest-lua-script", value: luaScript, onChange: (event) => setLuaScript(event.currentTarget.value), style: { width: "100%", minHeight: 140, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handleRun, children: "Run Scenario" }), _jsx("hr", {}), _jsx("label", { htmlFor: "lunatest-routes", children: "Route Mocks (JSON array)" }), _jsx("textarea", { id: "lunatest-routes", value: routeJson, onChange: (event) => setRouteJson(event.currentTarget.value), style: { width: "100%", minHeight: 110, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handleApplyRoutes, children: "Apply Routes" }), _jsx("hr", {}), _jsx("label", { htmlFor: "lunatest-state", children: "Intercept State Patch (JSON object)" }), _jsx("textarea", { id: "lunatest-state", value: stateJson, onChange: (event) => setStateJson(event.currentTarget.value), style: { width: "100%", minHeight: 110, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handlePatchState, children: "Patch State" }), _jsx("button", { type: "button", onClick: handleReset, style: { marginLeft: 8 }, children: "Reset" }), _jsxs("p", { style: { marginTop: 10, marginBottom: 0 }, children: ["status: ", status] }), error ? (_jsxs("p", { style: { marginTop: 4, marginBottom: 0, color: "#b91c1c" }, children: ["error: ", error] })) : null, diff ? (_jsxs("pre", { style: { marginTop: 8, marginBottom: 0, color: "#7f1d1d", whiteSpace: "pre-wrap" }, children: ["diff: ", diff] })) : null] }));
+        }, children: [_jsx("h3", { style: { margin: 0, marginBottom: 8 }, children: props.title ?? "LunaTest Devtools" }), _jsx("p", { style: { margin: 0, marginBottom: 10, color: "#334155" }, children: "Lua DSL\uACFC \uC778\uD130\uC149\uD2B8 \uC0C1\uD0DC\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uBC14\uB85C \uC218\uC815\uD569\uB2C8\uB2E4." }), _jsx("label", { htmlFor: "lunatest-lua-script", children: "Lua Scenario" }), _jsx("textarea", { id: "lunatest-lua-script", value: luaScript, onChange: (event) => setLuaScript(event.currentTarget.value), style: { width: "100%", minHeight: 140, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handleRun, children: "Run Scenario" }), _jsx("hr", {}), _jsxs("h4", { style: { margin: 0, marginBottom: 8 }, children: ["Diagnostics (", presetDiagnostics.length, ")"] }), presetDiagnostics.length === 0 ? (_jsx("p", { style: { margin: 0, marginBottom: 10, color: "#334155" }, children: "No preset diagnostics." })) : (_jsx("div", { style: { marginBottom: 12 }, children: presetDiagnostics.map((diagnostic) => (_jsxs("div", { style: {
+                        border: "1px solid #cbd5e1",
+                        borderRadius: 8,
+                        padding: 8,
+                        marginBottom: 8,
+                    }, children: [_jsxs("p", { style: { margin: 0, marginBottom: 4 }, children: ["[", diagnostic.source, "] ", diagnostic.code] }), _jsx("p", { style: { margin: 0, marginBottom: 4 }, children: diagnostic.message }), diagnostic.qualifiedId ? (_jsxs("p", { style: { margin: 0, marginBottom: 4 }, children: ["preset: ", diagnostic.qualifiedId] })) : null, diagnostic.hint ? _jsxs("p", { style: { margin: 0 }, children: ["hint: ", diagnostic.hint] }) : null] }, `${diagnostic.code}:${diagnostic.qualifiedId ?? "none"}`))) })), _jsx("hr", {}), _jsx("h4", { style: { margin: 0, marginBottom: 8 }, children: "Protocol Preset" }), _jsx("label", { htmlFor: "lunatest-protocol-preset", children: "Protocol Preset" }), _jsx("select", { id: "lunatest-protocol-preset", value: selectedProtocolPresetId, onChange: (event) => setSelectedProtocolPresetId(event.currentTarget.value), style: { width: "100%", marginBottom: 8 }, children: protocolPresets.map((preset) => (_jsxs("option", { value: preset.qualifiedId, children: ["[", preset.source, "] ", preset.label] }, preset.qualifiedId))) }), _jsx("label", { htmlFor: "lunatest-wallet-preset", children: "Wallet Preset" }), _jsx("select", { id: "lunatest-wallet-preset", value: selectedWalletPresetId, onChange: (event) => setSelectedWalletPresetId(event.currentTarget.value), style: { width: "100%", marginBottom: 8 }, children: walletPresets.map((preset) => (_jsxs("option", { value: preset.qualifiedId, children: ["[", preset.source, "] ", preset.label] }, preset.qualifiedId))) }), recommendedDescriptors.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("h4", { style: { margin: 0, marginBottom: 8 }, children: "Recommended Controls" }), recommendedDescriptors.map((descriptor) => (_jsxs("div", { style: { marginBottom: 8 }, children: [_jsx("label", { htmlFor: `preset-control-${descriptor.key}`, children: descriptor.label }), _jsx("input", { id: `preset-control-${descriptor.key}`, value: presetParamValues[descriptor.key] ?? "", onChange: (event) => setPresetParamValues((current) => ({
+                                    ...current,
+                                    [descriptor.key]: event.currentTarget.value,
+                                })), style: { width: "100%" } })] }, descriptor.key)))] })) : null, _jsx("label", { htmlFor: "lunatest-preset-params", children: "Advanced Preset Params (JSON)" }), _jsx("textarea", { id: "lunatest-preset-params", value: presetParamsJson, onChange: (event) => setPresetParamsJson(event.currentTarget.value), style: { width: "100%", minHeight: 90, marginBottom: 8 } }), selectedProtocolPreset?.builtinScenarios?.length ? (_jsxs(_Fragment, { children: [_jsx("label", { htmlFor: "lunatest-builtin-scenario", children: "Built-in Scenario" }), _jsx("select", { id: "lunatest-builtin-scenario", value: selectedBuiltinScenarioId, onChange: (event) => setSelectedBuiltinScenarioId(event.currentTarget.value), style: { width: "100%", marginBottom: 8 }, children: selectedProtocolPreset.builtinScenarios.map((scenario) => (_jsx("option", { value: scenario.id, children: scenario.label }, scenario.id))) })] })) : null, _jsx("button", { type: "button", onClick: handleApplyProtocolPreset, children: "Apply Protocol Preset" }), _jsx("button", { type: "button", style: { marginLeft: 8 }, onClick: handleApplyWalletPreset, children: "Apply Wallet Preset" }), materializedPreview ? (_jsxs(_Fragment, { children: [_jsx("p", { style: { marginTop: 10, marginBottom: 4 }, children: "materialized:" }), _jsx("pre", { style: { marginTop: 0, whiteSpace: "pre-wrap" }, children: materializedPreview })] })) : null, props.walletFallbackMode === "manual-toggle" ? (_jsxs(_Fragment, { children: [_jsx("hr", {}), _jsx("h4", { style: { margin: 0, marginBottom: 8 }, children: "Luna Wallet" }), _jsx("p", { style: { margin: 0, marginBottom: 8, color: "#334155" }, children: "\uC9C0\uAC11\uC774 \uC5C6\uC5B4\uB3C4 wallet RPC\uB97C Luna session\uC73C\uB85C \uD558\uC774\uC7AC\uD0B9\uD569\uB2C8\uB2E4." }), _jsxs("p", { style: { margin: 0, marginBottom: 8 }, children: ["mode: ", walletSession?.enabled ? "on" : "off", " / connected: ", walletSession?.connected ? "yes" : "no"] }), _jsxs("p", { style: { margin: 0, marginBottom: 8 }, children: ["account: ", walletSession?.accounts?.[0] ?? "n/a"] }), _jsxs("p", { style: { margin: 0, marginBottom: 8 }, children: ["chain: ", walletSession?.chainId ?? "n/a"] }), _jsxs("p", { style: { margin: 0, marginBottom: 8 }, children: ["permissions: ", walletSession?.permissions?.map((item) => item.parentCapability).join(", ") || "none"] }), _jsx("button", { type: "button", onClick: () => {
+                            try {
+                                if (walletSession?.enabled) {
+                                    disconnectWalletSession();
+                                }
+                                else {
+                                    connectWalletSession();
+                                }
+                                refreshWalletSession();
+                                setStatus("wallet-updated");
+                                setError(null);
+                            }
+                            catch (cause) {
+                                setStatus("failed");
+                                setError(cause instanceof Error ? cause.message : String(cause));
+                            }
+                        }, children: walletSession?.enabled ? "Disable Luna Wallet" : "Enable Luna Wallet" }), _jsx("button", { type: "button", style: { marginLeft: 8 }, onClick: () => {
+                            try {
+                                setWalletSession({
+                                    enabled: walletSession?.enabled ?? false,
+                                    connected: walletSession?.connected ?? false,
+                                    chainId: "0xaa36a7",
+                                    accounts: ["0x1111111111111111111111111111111111111111"],
+                                    permissions: walletSession?.permissions ?? [],
+                                });
+                                refreshWalletSession();
+                                setStatus("wallet-updated");
+                                setError(null);
+                            }
+                            catch (cause) {
+                                setStatus("failed");
+                                setError(cause instanceof Error ? cause.message : String(cause));
+                            }
+                        }, children: "Reset Session" })] })) : null, _jsx("hr", {}), _jsx("label", { htmlFor: "lunatest-routes", children: "Route Mocks (JSON array)" }), _jsx("textarea", { id: "lunatest-routes", value: routeJson, onChange: (event) => setRouteJson(event.currentTarget.value), style: { width: "100%", minHeight: 110, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handleApplyRoutes, children: "Apply Routes" }), _jsx("hr", {}), _jsx("label", { htmlFor: "lunatest-state", children: "Intercept State Patch (JSON object)" }), _jsx("textarea", { id: "lunatest-state", value: stateJson, onChange: (event) => setStateJson(event.currentTarget.value), style: { width: "100%", minHeight: 110, marginBottom: 8 } }), _jsx("button", { type: "button", onClick: handlePatchState, children: "Patch State" }), _jsx("button", { type: "button", onClick: handleReset, style: { marginLeft: 8 }, children: "Reset" }), _jsxs("p", { style: { marginTop: 10, marginBottom: 0 }, children: ["status: ", status] }), error ? (_jsxs("p", { style: { marginTop: 4, marginBottom: 0, color: "#b91c1c" }, children: ["error: ", error] })) : null, diff ? (_jsxs("pre", { style: { marginTop: 8, marginBottom: 0, color: "#7f1d1d", whiteSpace: "pre-wrap" }, children: ["diff: ", diff] })) : null] }));
 }

package/dist/devtools/mount.js

@@ -5,6 +5,7 @@ import { resolveNodeEnv } from "../node-env.js";
 const DEFAULT_TARGET_ID = "lunatest-devtools-root";
 let activeRoot = null;
 let activeTarget = null;
+let activeTargetOwned = false;
 export function mountLunaDevtools(options = {}) {
     if (typeof document === "undefined") {
         return null;
@@ -26,16 +27,18 @@ export function mountLunaDevtools(options = {}) {
     }
     activeRoot = createRoot(target);
     activeTarget = target;
+    activeTargetOwned = !existing;
     activeRoot.render(React.createElement(LunaDevtoolsPanel, options.panelProps));
     return () => {
         if (!activeRoot || !activeTarget) {
             return;
         }
         activeRoot.unmount();
-        if (activeTarget.id === DEFAULT_TARGET_ID) {
+        if (activeTargetOwned) {
             activeTarget.remove();
         }
         activeRoot = null;
         activeTarget = null;
+        activeTargetOwned = false;
     };
 }

package/dist/hooks/useLunaProvider.js

@@ -1,5 +1,7 @@
 import { useMemo } from "react";
 import { createLunaProvider } from "../luna-provider.js";
+import { createProviderOptionsKey } from "../provider-options.js";
 export function useLunaProvider(options) {
-    return useMemo(() => createLunaProvider(options), [options]);
+    const optionsKey = createProviderOptionsKey(options);
+    return useMemo(() => createLunaProvider(options), [optionsKey, options.callHandler]);
 }

package/dist/provider-options.d.ts

@@ -0,0 +1,2 @@
+import type { LunaProviderOptions } from "@lunatest/core";
+export declare function createProviderOptionsKey(options: LunaProviderOptions | undefined): string;

package/dist/provider-options.js

@@ -0,0 +1,29 @@
+function stableStringify(value) {
+    if (value === null || value === undefined) {
+        return String(value);
+    }
+    if (typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    const entries = Object.entries(value)
+        .filter((entry) => entry[1] !== undefined)
+        .sort(([left], [right]) => left.localeCompare(right));
+    return `{${entries
+        .map(([key, nested]) => `${JSON.stringify(key)}:${stableStringify(nested)}`)
+        .join(",")}}`;
+}
+export function createProviderOptionsKey(options) {
+    if (!options) {
+        return "undefined";
+    }
+    const serializable = {
+        chainId: options.chainId,
+        accounts: options.accounts,
+        balances: options.balances,
+        wallet: options.wallet,
+    };
+    return stableStringify(serializable);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunatest/react",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -21,8 +26,9 @@
     "dist"
   ],
   "dependencies": {
-    "@lunatest/core": "0.1.0",
-    "@lunatest/runtime-intercept": "0.1.0"
+    "@lunatest/core": "0.1.1",
+    "@lunatest/runtime-intercept": "0.1.0",
+    "@lunatest/contracts": "0.1.0"
   },
   "peerDependencies": {
     "react": "^18.3.1 || ^19.0.0",
@@ -34,9 +40,14 @@
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/songforthemute/lunatest",
+    "directory": "packages/react"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "vitest run",
-    "lint": "tsc -p tsconfig.json --noEmit"
+    "lint": "tsc -p tsconfig.lint.json --pretty false"
   }
 }