Add WebViewEnv and wire web preview to the mock WaveEnv contract

[Copilot]

The webview preview existed, but the webview feature was still reading key dependencies from global helpers instead of a narrowed WaveEnv, which left the preview without a proper mock environment contract. This change introduces a dedicated WebViewEnv and routes the webview model/view through it so preview/test mocks can supply the same dependencies explicitly.

• WaveEnv narrowing for webview

  • Added frontend/app/view/webview/webviewenv.ts
  • Declares the exact webview dependencies used by the feature:
    • electron: openExternal, getWebviewPreload, clearWebviewStorage, getConfigDir, setWebviewFocus
    • rpc: FetchSuggestionsCommand, SetMetaCommand, SetConfigCommand
    • wos, createBlock
    • getSettingsKeyAtom("web:defaulturl" | "web:defaultsearch")
    • getBlockMetaKeyAtom("web:hidenav" | "web:useragenttype" | "web:zoom" | "web:partition")

• WebView model/view now consume env-provided dependencies

  • WebViewModel now stores and uses waveEnv instead of reaching into global singletons for WOS, settings, block meta, RPC, and Electron APIs.
  • The React view now reads web:defaultsearch, web:zoom, and web:partition from useWaveEnv<WebViewEnv>().
  • Webview event paths that create blocks / manage focus / use Electron preload are now driven by the env contract.

• Preview/mock behavior aligned with production semantics

  • Updated the web preview mock search template to use {query}, matching the webview search-template substitution logic.
  • Fixed mock SetConfigCommand behavior so settings updates remain observable through getSettingsKeyAtom, which is required for env-driven preview behavior.
  • Clearing block homepage now removes pinnedurl via null, matching the mock RPC meta-deletion semantics.

• Focused coverage

  • Extended the existing webview test to verify that homepage resolution and config updates flow through the supplied mock env rather than global helpers.

export type WebViewEnv = WaveEnvSubset<{
    electron: {
        openExternal: WaveEnv["electron"]["openExternal"];
        getWebviewPreload: WaveEnv["electron"]["getWebviewPreload"];
        clearWebviewStorage: WaveEnv["electron"]["clearWebviewStorage"];
        getConfigDir: WaveEnv["electron"]["getConfigDir"];
        setWebviewFocus: WaveEnv["electron"]["setWebviewFocus"];
    };
    rpc: {
        FetchSuggestionsCommand: WaveEnv["rpc"]["FetchSuggestionsCommand"];
        SetMetaCommand: WaveEnv["rpc"]["SetMetaCommand"];
        SetConfigCommand: WaveEnv["rpc"]["SetConfigCommand"];
    };
    wos: WaveEnv["wos"];
    createBlock: WaveEnv["createBlock"];
    getSettingsKeyAtom: SettingsKeyAtomFnType<"web:defaulturl" | "web:defaultsearch">;
    getBlockMetaKeyAtom: BlockMetaKeyAtomFnType<
        "web:hidenav" | "web:useragenttype" | "web:zoom" | "web:partition"
    >;
}>;

• Screenshot
  • https://github.com/user-attachments/assets/8921737f-490d-4719-8131-15f07c15a74c

---

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

[cloudflare-workers-and-pages]

Deploying waveterm with    Cloudflare Pages

Latest commit:	c2fe9d4
Status:	✅  Deploy successful!
Preview URL:	https://d514e4df.waveterm.pages.dev
Branch Preview URL:	https://copilot-add-webview-env-mock.waveterm.pages.dev

View logs