cj-tauri 0.8.0 → 1.1.0

package/src/tests/fake_host.cj

@@ -25,13 +25,26 @@ class FakeHost <: WebViewHost {
     // 对话框入参按「调一次记一次」存成字符串：桩不真弹窗，用例要断言的是「谁被调了、带了什么」
     public var fileDialogArgs: String = ""
     public var messageDialogArgs: String = ""
+    // 选目录与文件框分开记：用例要断言「走的是目录那条路」，不能与 fileDialogArgs 混为一谈
+    public var folderDialogTitle: String = ""
     // 菜单：线路文本 / 单项状态按原样记下（桩不建真菜单，用例断言的是投下来的内容）
     public var menuWire: String = ""
     public var menuItemStateArgs: String = ""
+    // 标题栏副标题：桩只记最后一次文本（用例断言的是「投下来的是什么」）
+    public var titlebarSubtitleText: String = ""
+    public var dragDropArgs: String = ""
+    public var hotkeyWire: String = ""
+    public var trayWire: String = ""
+    public var windowVisibleValue: Bool = true
+    public var minimizeToTrayValue: Bool = false
     // shell 事件回调（菜单点击等）：用例可以自己调它，模拟「桥把事件送进来了」
     public var shellHandler: (String) -> Unit = { _ => }
     // 销毁回调：用例可以自己调它，模拟「桥通知本窗销毁了」
     public var destroyHandler: () -> Unit = { => }
+    // 剪贴板 / 通知：写与通知按「调一次记一次」，读值可注入（默认空，用例按需设）
+    public var clipboardWritten: String = ""
+    public var clipboardReadValue: Option<String> = None<String>
+    public var notifiedArgs: String = ""
     // 能力位：桩给「有菜单」，用例要测「平台没这个本事」时自行覆盖它
     public var caps: Int32 = CJ_CAP_MENU
 
@@ -67,26 +80,51 @@ class FakeHost <: WebViewHost {
         this.devToolsEnabled = enabled
     }
 
-    public func openDevTools(): Unit {}
-
-    public func setMenu(wire: String): Unit {
-        this.menuWire = wire
-    }
-
-    public func setMenuItemState(id: String, enabled: Bool, checked: Bool): Unit {
-        this.menuItemStateArgs = "${id}|${enabled}|${checked}"
-    }
-
-    public func hostCapabilities(): Int32 {
-        return this.caps
-    }
-
-    public func setShellHandler(handler: (String) -> Unit): Unit {
-        this.shellHandler = handler
-    }
-
-    public func setDestroyHandler(handler: () -> Unit): Unit {
-        this.destroyHandler = handler
+    public func openDevTools(): Unit {}
+
+    public func setMenu(wire: String): Unit {
+        this.menuWire = wire
+    }
+
+    public func setMenuItemState(id: String, enabled: Bool, checked: Bool): Unit {
+        this.menuItemStateArgs = "${id}|${enabled}|${checked}"
+    }
+
+    public func setTitlebarSubtitle(text: String): Unit {
+        this.titlebarSubtitleText = text
+    }
+
+    public func setDragDropPolicy(enabled: Bool, files: Bool): Unit {
+        this.dragDropArgs = "${enabled}|${files}"
+    }
+
+    public func setGlobalHotkeys(wire: String): Unit {
+        this.hotkeyWire = wire
+    }
+
+    public func setTray(wire: String): Unit {
+        this.trayWire = wire
+    }
+
+    // 窗口可见性 / 最小化策略：桩只记最后一次设置（用例断言的是「谁被调了、带了什么」）
+    public func setWindowVisible(visible: Bool): Unit {
+        this.windowVisibleValue = visible
+    }
+
+    public func setMinimizeToTray(enabled: Bool): Unit {
+        this.minimizeToTrayValue = enabled
+    }
+
+    public func hostCapabilities(): Int32 {
+        return this.caps
+    }
+
+    public func setShellHandler(handler: (String) -> Unit): Unit {
+        this.shellHandler = handler
+    }
+
+    public func setDestroyHandler(handler: () -> Unit): Unit {
+        this.destroyHandler = handler
     }
 
     public func showFileDialog(save: Bool, title: String, filter: String): String {
@@ -94,11 +132,38 @@ class FakeHost <: WebViewHost {
         return ""
     }
 
+    public func showFileDialogPreset(save: Bool, title: String, filter: String,
+                                     defaultName: String): String {
+        // 记痕带预置名：多窗取证靠它断言「本窗拿到的是本窗预置的名字」
+        this.fileDialogArgs = "${save}|${title}|${filter}|${defaultName}"
+        return ""
+    }
+
+    public func showFolderDialog(title: String): String {
+        // 桩不真弹窗：记下标题即可（用例断言的是「谁被调了、带了什么」）
+        this.folderDialogTitle = title
+        return ""
+    }
+
     public func showMessageDialog(kind: String, title: String, message: String): Bool {
         this.messageDialogArgs = "${kind}|${title}|${message}"
         return false
     }
 
+    public func clipboardWriteText(text: String): Bool {
+        this.clipboardWritten = text
+        return true
+    }
+
+    public func clipboardReadText(): Option<String> {
+        return this.clipboardReadValue
+    }
+
+    public func notify(title: String, body: String): Bool {
+        this.notifiedArgs = "${title}|${body}"
+        return true
+    }
+
     public func runJs(js: String): Unit {
         this.jsCalls.add(js)
     }

package/src/tests/ipc_hub_test.cj

@@ -15,6 +15,9 @@ import std.unittest.testmacro.*
 /** 固定返回 "ok" 的处理器 */
 class OkHandler <: CommandHandler {
     public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        let _ = cmd
+        let _ = args
+        let _ = ipc
         return JsonString("ok")
     }
 }
@@ -22,6 +25,9 @@ class OkHandler <: CommandHandler {
 /** 抛 CommandException 的处理器（预期内的失败） */
 class BoomHandler <: CommandHandler {
     public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        let _ = cmd
+        let _ = args
+        let _ = ipc
         throw CommandException("boom")
     }
 }
@@ -29,6 +35,9 @@ class BoomHandler <: CommandHandler {
 /** 抛普通异常的处理器（预期外的失败） */
 class CrashHandler <: CommandHandler {
     public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        let _ = cmd
+        let _ = args
+        let _ = ipc
         throw Exception("crash")
     }
 }
@@ -236,6 +245,9 @@ func testIpcMessageResolveKeepsPayload(): Unit {
 /** 睡 300ms 再回答：模拟 `shell:exec` 这类慢命令 */
 class SlowHandler <: CommandHandler {
     public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        let _ = cmd
+        let _ = args
+        let _ = ipc
         sleep(Duration.millisecond * 300)
         return JsonString("slow-ok")
     }
@@ -304,6 +316,7 @@ func testConcurrentInvokesEachResolveExactlyOnce(): Unit {
 
 /** 抛异常的监听器：验证「一个听众崩了不牵连别的听众与发送方」 */
 func boomListener(p: JsonValue): Unit {
+    let _ = p
     throw Exception("listener boom")
 }
 

package/src/tests/jsutil_test.cj

@@ -0,0 +1,62 @@
+package cjTauri.tests
+
+import cjTauri.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * JS 字符串字面量转义的用例（鸿蒙 ArkWeb 侧的 label 注入靠它）。
+ *
+ * 为什么值得单独测：这段逻辑的失效形状是**静默的**——生成的脚本当场语法错误，
+ * 页面里 `__CJ_TAURI_LABEL__` 停在默认值 `main`，于是「按 label 过滤的事件」全部失灵，
+ * 而宿主与页面两边都不报错（AGENTS §4 同族坑）。原先它带 `@When[env == "ohos"]`
+ * 门禁、桌面 `cjpm test` 编不到，所以下沉到共享层后必须在这里锁住。
+ *
+ * 断言取**字符层面**的期望值（`\"` 就是两个字符：反斜杠 + 引号），
+ * 不整体比对拼好的脚本——那样改一改前缀就得连带改一堆测试。
+ */
+
+@Test
+func testJsStringLiteralWrapsPlainText(): Unit {
+    @Expect(jsStringLiteral("main"), "\"main\"")
+}
+
+@Test
+func testJsStringLiteralEscapesDoubleQuote(): Unit {
+    // 不转义的话 label 一变就提前收敛，脚本变成 `= "a";b";` —— 语法错误
+    @Expect(jsStringLiteral("a\"b"), "\"a\\\"b\"")
+}
+
+@Test
+func testJsStringLiteralEscapesBackslash(): Unit {
+    // Windows 风格 label / 路径片段带反斜杠：不转义会把后一个字符一起吃掉
+    @Expect(jsStringLiteral("a\\b"), "\"a\\\\b\"")
+}
+
+@Test
+func testJsStringLiteralKeepsUtf8Bytes(): Unit {
+    // 按字节扫，汉字不能被拆分或改写（三字节序列原样带过）
+    @Expect(jsStringLiteral("窗口"), "\"窗口\"")
+}
+
+@Test
+func testJsStringLiteralHandlesEmptyString(): Unit {
+    @Expect(jsStringLiteral(""), "\"\"")
+}
+
+@Test
+func testJsStringLiteralCombinesQuoteAndBackslash(): Unit {
+    // 两者相邻时最容易漏转义：期望 `"` `\` `\` `"` `\` `\` ...` 严格交错
+    @Expect(jsStringLiteral("\"\\"), "\"\\\"\\\\\"")
+}
+
+@Test
+func testJsStringLiteralLeavesOtherControlCharsAlone(): Unit {
+    // 口径是「只转义反斜杠与双引号」：制表符 / 换行不属于 label 语义，
+    // 这里断言**不**做额外加工，避免将来有人把它改成全量 JSON 编码器而悄悄改变契约
+    let tab = "\t"
+    let got = jsStringLiteral(tab)
+    // 未转义 = 长度只多出两侧引号（2 + 1 字节的制表符）
+    @Expect(got.size, 3)
+    @Expect(got.contains("\t"), true)
+}

package/src/tests/logging_test.cj

@@ -0,0 +1,62 @@
+package cjTauri.tests
+
+import cjTauri.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 日志落盘的策略层用例（RFC-003 第 5 期）。
+ *
+ * 只测**纯函数**（默认目录推导、环境变量回退、路径拼接）：真的开 fd 那一段归桩自检
+ * （`native/tests/test_bridge_core.c` 的 `log file` 用例）与实机 E2E——单测里调桥的
+ * `foreign func` 会踩「子包调不了 foreign func」那条（AGENTS §4，链接期报未定义符号）。
+ *
+ * 环境变量类的用例一律用**肯定不存在**的变量名：跑测试的机器上 `CJ_TAURI_LOG` 之类
+ * 可能真的设着，拿它当「未设置」来断言就是一条会随机器飘的红线。
+ */
+
+/** 保证不存在的变量名（前缀统一，便于将来 grep） */
+let ABSENT_LOG_ENV: String = "CJ_TAURI_LOG_TEST_ABSENT"
+
+@Test
+func testLogEnvFallsBackWhenVariableMissing(): Unit {
+    @Expect(logEnvOr(ABSENT_LOG_ENV, "dflt"), "dflt")
+}
+
+@Test
+func testLogBudgetFallsBackWhenVariableMissing(): Unit {
+    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 7), 7)
+    // 0 与负数在调用方语义里是「不轮转」，不是「用 0 当默认」——回退值原样带回
+    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 0), 0)
+}
+
+@Test
+func testDefaultLogPathUsesAppNameAndPlatformDir(): Unit {
+    let p = defaultLogPath("music")
+    // 分隔符按平台给，所以不整体比对路径；钉的是「文件名 = 应用名」、「落在 cj-tauri 目录下」
+    @Expect(p.endsWith("music.log"), true)
+    @Expect(p.contains("cj-tauri"), true)
+    // 应用没给名字时走兜底：不能拼出没有主名的 ".log"
+    @Expect(defaultLogPath("").endsWith("app.log"), true)
+}
+
+@Test
+func testDefaultLogDirIsNonEmptyAndConventional(): Unit {
+    let d = defaultLogDir()
+    @Expect(d.size > 0, true)
+    @Expect(d.contains("cj-tauri"), true)
+    // 默认预算是个能落地的值：>0 才会轮转，keep>0 才有档案可留
+    @Expect(CJ_LOG_DEFAULT_MAX_KB > 0, true)
+    @Expect(CJ_LOG_DEFAULT_KEEP > 0, true)
+}
+
+@Test
+func testLogPathOrDefaultPrefersEnvOverPlatformDir(): Unit {
+    // 报障路径优先：环境变量给了路径就用它，平台惯例目录被忽略（人家不必知道目录在哪）
+    @Expect(logPathOrDefault("/tmp/from-env.log", "music"), "/tmp/from-env.log")
+    // 空串＝未设置，才落平台惯例目录，文件名跟应用名走（与 logEnvOr 同口径）
+    let d = logPathOrDefault("", "music")
+    @Expect(d.endsWith("music.log"), true)
+    @Expect(d.contains("cj-tauri"), true)
+    @Expect(d == defaultLogPath("music"), true)
+}