merge main

Author: sawka

.kilocode/skills/electron-api/SKILL.md

@@ -7,11 +7,12 @@ description: Guide for adding new Electron APIs to Wave Terminal. Use when imple
 
 Electron APIs allow the frontend to call Electron main process functionality directly via IPC.
 
-## Three Files to Edit
+## Four Files to Edit
 
 1. [`frontend/types/custom.d.ts`](frontend/types/custom.d.ts) - TypeScript [`ElectronApi`](frontend/types/custom.d.ts:82) type
 2. [`emain/preload.ts`](emain/preload.ts) - Expose method via `contextBridge`
 3. [`emain/emain-ipc.ts`](emain/emain-ipc.ts) - Implement IPC handler
+4. [`frontend/preview/preview-electron-api.ts`](frontend/preview/preview-electron-api.ts) - Add a no-op stub to keep the `previewElectronApi` object in sync with the `ElectronApi` type
 
 ## Three Communication Patterns
 
@@ -54,7 +55,15 @@ electron.ipcMain.handle("capture-screenshot", async (event, rect) => {
 });
 ```
 
-### 4. Call from Frontend
+### 4. Add Preview Stub
+
+In [`frontend/preview/preview-electron-api.ts`](frontend/preview/preview-electron-api.ts):
+
+```typescript
+captureScreenshot: (_rect: Electron.Rectangle) => Promise.resolve(""),
+```
+
+### 5. Call from Frontend
 
 ```typescript
 import { getApi } from "@/store/global";
@@ -167,6 +176,7 @@ webContents.send("zoom-factor-change", newZoomFactor);
 - [ ] Include IPC channel name in comment
 - [ ] Expose in [`preload.ts`](emain/preload.ts)
 - [ ] Implement in [`emain-ipc.ts`](emain/emain-ipc.ts)
+- [ ] Add no-op stub to [`preview-electron-api.ts`](frontend/preview/preview-electron-api.ts)
 - [ ] IPC channel names match exactly
 - [ ] **For sync**: Set `event.returnValue` (or browser hangs!)
 - [ ] Test end-to-end

cmd/generatets/main-generatets.go

@@ -112,6 +112,14 @@ func generateWshClientApiFile(tsTypeMap map[reflect.Type]string) error {
 	fmt.Fprintf(&buf, "// SPDX-License-Identifier: Apache-2.0\n\n")
 	fmt.Fprintf(&buf, "// generated by cmd/generate/main-generatets.go\n\n")
 	fmt.Fprintf(&buf, "import { WshClient } from \"./wshclient\";\n\n")
+	fmt.Fprintf(&buf, "export interface MockRpcClient {\n")
+	fmt.Fprintf(&buf, "    mockWshRpcCall(client: WshClient, command: string, data: any, opts?: RpcOpts): Promise<any>;\n")
+	fmt.Fprintf(&buf, "    mockWshRpcStream(client: WshClient, command: string, data: any, opts?: RpcOpts): AsyncGenerator<any, void, boolean>;\n")
+	fmt.Fprintf(&buf, "}\n\n")
+	fmt.Fprintf(&buf, "let mockClient: MockRpcClient = null;\n\n")
+	fmt.Fprintf(&buf, "export function setMockRpcClient(client: MockRpcClient): void {\n")
+	fmt.Fprintf(&buf, "    mockClient = client;\n")
+	fmt.Fprintf(&buf, "}\n\n")
 	orderedKeys := utilfn.GetOrderedMapKeys(declMap)
 	fmt.Fprintf(&buf, "// WshServerCommandToDeclMap\n")
 	fmt.Fprintf(&buf, "class RpcApiType {\n")

frontend/app/modals/about.tsx

@@ -1,13 +1,16 @@
-// Copyright 2025, Command Line Inc.
+// Copyright 2026, Command Line Inc.
 // SPDX-License-Identifier: Apache-2.0
 
 import Logo from "@/app/asset/logo.svg";
+import { OnboardingGradientBg } from "@/app/onboarding/onboarding-common";
 import { modalsModel } from "@/app/store/modalmodel";
-import { Modal } from "./modal";
-
+import { RpcApi } from "@/app/store/wshclientapi";
+import { TabRpcClient } from "@/app/store/wshrpcutil";
 import { isDev } from "@/util/isdev";
-import { useState } from "react";
+import { fireAndForget } from "@/util/util";
+import { useEffect, useState } from "react";
 import { getApi } from "../store/global";
+import { Modal } from "./modal";
 
 interface AboutModalVProps {
     versionString: string;
@@ -19,13 +22,14 @@ const AboutModalV = ({ versionString, updaterChannel, onClose }: AboutModalVProp
     const currentDate = new Date();
 
     return (
-        <Modal className="pt-[34px] pb-[34px]" onClose={onClose}>
-            <div className="flex flex-col gap-[26px] w-full">
+        <Modal className="pt-[34px] pb-[34px] overflow-hidden w-[450px]" onClose={onClose}>
+            <OnboardingGradientBg />
+            <div className="flex flex-col gap-[26px] w-full relative z-10">
                 <div className="flex flex-col items-center justify-center gap-4 self-stretch w-full text-center">
                     <Logo />
                     <div className="text-[25px]">Wave Terminal</div>
                     <div className="leading-5">
-                        Open-Source AI-Native Terminal
+                        Open-Source AI-Integrated Terminal
                         <br />
                         Built for Seamless Workflows
                     </div>
@@ -35,30 +39,38 @@ const AboutModalV = ({ versionString, updaterChannel, onClose }: AboutModalVProp
                     <br />
                     Update Channel: {updaterChannel}
                 </div>
-                <div className="flex items-start gap-[10px] self-stretch w-full text-center">
+                <div className="grid grid-cols-2 gap-[10px] self-stretch w-full">
                     <a
                         href="https://github.com/wavetermdev/waveterm?ref=about"
                         target="_blank"
                         rel="noopener"
-                        className="inline-flex items-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
+                        className="inline-flex items-center justify-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
                     >
-                        <i className="fa-brands fa-github mr-2"></i>Github
+                        <i className="fa-brands fa-github mr-2"></i>GitHub
                     </a>
                     <a
                         href="https://www.waveterm.dev/?ref=about"
                         target="_blank"
                         rel="noopener"
-                        className="inline-flex items-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
+                        className="inline-flex items-center justify-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
                     >
                         <i className="fa-sharp fa-light fa-globe mr-2"></i>Website
                     </a>
                     <a
                         href="https://github.com/wavetermdev/waveterm/blob/main/ACKNOWLEDGEMENTS.md"
                         target="_blank"
                         rel="noopener"
-                        className="inline-flex items-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
+                        className="inline-flex items-center justify-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
                     >
-                        <i className="fa-sharp fa-light fa-heart mr-2"></i>Acknowledgements
+                        <i className="fa-sharp fa-light fa-book mr-2"></i>Open Source
+                    </a>
+                    <a
+                        href="https://github.com/sponsors/wavetermdev"
+                        target="_blank"
+                        rel="noopener"
+                        className="inline-flex items-center justify-center px-4 py-2 rounded border border-border hover:bg-hoverbg transition-colors duration-200"
+                    >
+                        <i className="fa-sharp fa-light fa-heart mr-2"></i>Sponsor
                     </a>
                 </div>
                 <div className="items-center gap-4 self-stretch w-full text-center">
@@ -76,6 +88,16 @@ const AboutModal = () => {
     const [updaterChannel] = useState(() => getApi().getUpdaterChannel());
     const versionString = `${details.version} (${isDev() ? "dev-" : ""}${details.buildTime})`;
 
+    useEffect(() => {
+        fireAndForget(async () => {
+            RpcApi.RecordTEventCommand(
+                TabRpcClient,
+                { event: "action:other", props: { "action:type": "about" } },
+                { noresponse: true }
+            );
+        });
+    }, []);
+
     return (
         <AboutModalV
             versionString={versionString}

frontend/app/modals/modalregistry.tsx

@@ -4,6 +4,7 @@
 import { MessageModal } from "@/app/modals/messagemodal";
 import { NewInstallOnboardingModal } from "@/app/onboarding/onboarding";
 import { UpgradeOnboardingModal } from "@/app/onboarding/onboarding-upgrade";
+import { UpgradeOnboardingPatch } from "@/app/onboarding/onboarding-upgrade-patch";
 import { DeleteFileModal, PublishAppModal, RenameFileModal } from "@/builder/builder-apppanel";
 import { SetSecretDialog } from "@/builder/tabs/builder-secrettab";
 import { AboutModal } from "./about";
@@ -12,6 +13,7 @@ import { UserInputModal } from "./userinputmodal";
 const modalRegistry: { [key: string]: React.ComponentType<any> } = {
     [NewInstallOnboardingModal.displayName || "NewInstallOnboardingModal"]: NewInstallOnboardingModal,
     [UpgradeOnboardingModal.displayName || "UpgradeOnboardingModal"]: UpgradeOnboardingModal,
+    [UpgradeOnboardingPatch.displayName || "UpgradeOnboardingPatch"]: UpgradeOnboardingPatch,
     [UserInputModal.displayName || "UserInputModal"]: UserInputModal,
     [AboutModal.displayName || "AboutModal"]: AboutModal,
     [MessageModal.displayName || "MessageModal"]: MessageModal,

frontend/app/onboarding/onboarding-upgrade-patch.tsx

@@ -32,6 +32,10 @@ interface VersionConfig {
     nextText?: string;
 }
 
+interface UpgradeOnboardingPatchProps {
+    isReleaseNotes?: boolean;
+}
+
 interface UpgradeOnboardingFooterProps {
     hasPrev: boolean;
     hasNext: boolean;
@@ -131,7 +135,7 @@ export const UpgradeOnboardingVersions: VersionConfig[] = [
     },
 ];
 
-const UpgradeOnboardingPatch = () => {
+const UpgradeOnboardingPatch = ({ isReleaseNotes = false }: UpgradeOnboardingPatchProps) => {
     const modalRef = useRef<HTMLDivElement | null>(null);
     const [isCompact, setIsCompact] = useState<boolean>(window.innerHeight < 800);
     const [currentIndex, setCurrentIndex] = useState<number>(UpgradeOnboardingVersions.length - 1);
@@ -174,13 +178,21 @@ const UpgradeOnboardingPatch = () => {
     }, []);
 
     const doClose = () => {
-        globalStore.set(modalsModel.upgradeOnboardingOpen, false);
+        if (isReleaseNotes) {
+            modalsModel.popModal();
+        } else {
+            globalStore.set(modalsModel.upgradeOnboardingOpen, false);
+        }
         setTimeout(() => {
             globalRefocus();
         }, 10);
     };
 
     const handleClose = () => {
+        if (isReleaseNotes) {
+            doClose();
+            return;
+        }
         const clientId = ClientModel.getInstance().clientId;
         RpcApi.SetMetaCommand(TabRpcClient, {
             oref: WOS.makeORef("client", clientId),

frontend/app/onboarding/onboarding.tsx

@@ -29,7 +29,13 @@ type PageName = "init" | "notelemetrystar" | "features";
 
 const pageNameAtom: PrimitiveAtom<PageName> = atom<PageName>("init");
 
-const InitPage = ({ isCompact }: { isCompact: boolean }) => {
+const InitPage = ({
+    isCompact,
+    telemetryUpdateFn,
+}: {
+    isCompact: boolean;
+    telemetryUpdateFn: (value: boolean) => Promise<void>;
+}) => {
     const telemetrySetting = useSettingsKeyAtom("telemetry:enabled");
     const clientData = useAtomValue(ClientModel.getInstance().clientAtom);
     const [telemetryEnabled, setTelemetryEnabled] = useState<boolean>(!!telemetrySetting);
@@ -63,7 +69,7 @@ const InitPage = ({ isCompact }: { isCompact: boolean }) => {
 
     const setTelemetry = (value: boolean) => {
         fireAndForget(() =>
-            services.ClientService.TelemetryUpdate(value).then(() => {
+            telemetryUpdateFn(value).then(() => {
                 setTelemetryEnabled(value);
             })
         );
@@ -319,7 +325,7 @@ const NewInstallOnboardingModal = () => {
     let pageComp: React.JSX.Element = null;
     switch (pageName) {
         case "init":
-            pageComp = <InitPage isCompact={isCompact} />;
+            pageComp = <InitPage isCompact={isCompact} telemetryUpdateFn={services.ClientService.TelemetryUpdate} />;
             break;
         case "notelemetrystar":
             pageComp = <NoTelemetryStarPage isCompact={isCompact} />;

frontend/app/store/client-model.ts

@@ -1,4 +1,4 @@
-// Copyright 2025, Command Line Inc
+// Copyright 2026, Command Line Inc
 // SPDX-License-Identifier: Apache-2.0
 
 import * as WOS from "@/app/store/wos";
@@ -33,4 +33,4 @@ class ClientModel {
     }
 }
 
-export { ClientModel };
+export { ClientModel };

frontend/app/store/global-atoms.ts

@@ -15,7 +15,7 @@ function initGlobalAtoms(initOpts: GlobalInitOptions) {
     const windowIdAtom = atom(initOpts.windowId) as PrimitiveAtom<string>;
     const builderIdAtom = atom(initOpts.builderId) as PrimitiveAtom<string>;
     const builderAppIdAtom = atom<string>(null) as PrimitiveAtom<string>;
-    setWaveWindowType(initOpts.builderId != null ? "builder" : "tab");
+    setWaveWindowType(initOpts.isPreview ? "preview" : initOpts.builderId != null ? "builder" : "tab");
     const uiContextAtom = atom((get) => {
         const uiContext: UIContext = {
             windowid: initOpts.windowId,

frontend/app/store/services.ts

@@ -113,12 +113,6 @@ class WindowServiceType {
         return WOS.callBackendService("window", "GetWindow", Array.from(arguments))
     }
 
-    // move block to new window
-    // @returns object updates
-    MoveBlockToNewWindow(currentTabId: string, blockId: string): Promise<void> {
-        return WOS.callBackendService("window", "MoveBlockToNewWindow", Array.from(arguments))
-    }
-
     // set window position and size
     // @returns object updates
     SetWindowPosAndSize(windowId: string, pos: Point, size: WinSize): Promise<void> {

frontend/app/store/wos.ts

@@ -4,6 +4,7 @@
 // WaveObjectStore
 
 import { waveEventSubscribeSingle } from "@/app/store/wps";
+import { isPreviewWindow } from "@/app/store/windowtype";
 import { getWebServerEndpoint } from "@/util/endpoints";
 import { fetch } from "@/util/fetchutil";
 import { fireAndForget } from "@/util/util";
@@ -57,7 +58,19 @@ function makeORef(otype: string, oid: string): string {
     return `${otype}:${oid}`;
 }
 
+const previewMockObjects: Map<string, WaveObj> = new Map();
+
+function mockObjectForPreview<T extends WaveObj>(oref: string, obj: T): void {
+    if (!isPreviewWindow()) {
+        throw new Error("mockObjectForPreview can only be called in a preview window");
+    }
+    previewMockObjects.set(oref, obj);
+}
+
 function GetObject<T>(oref: string): Promise<T> {
+    if (isPreviewWindow()) {
+        return Promise.resolve((previewMockObjects.get(oref) as T) ?? null);
+    }
     return callBackendService("object", "GetObject", [oref], true);
 }
 
@@ -105,7 +118,9 @@ function callBackendService(service: string, method: string, args: any[], noUICo
     const usp = new URLSearchParams();
     usp.set("service", service);
     usp.set("method", method);
-    const url = getWebServerEndpoint() + "/wave/service?" + usp.toString();
+    const webEndpoint = getWebServerEndpoint();
+    if (webEndpoint == null) throw new Error(`cannot call ${methodName}: no web endpoint`);
+    const url = webEndpoint + "/wave/service?" + usp.toString();
     const fetchPromise = fetch(url, {
         method: "POST",
         body: JSON.stringify(waveCall),
@@ -315,6 +330,7 @@ export {
     getWaveObjectLoadingAtom,
     loadAndPinWaveObject,
     makeORef,
+    mockObjectForPreview,
     reloadWaveObject,
     setObjectValue,
     splitORef,