cj-tauri 2.0.0 → 2.1.0

package/src/tests/system_host_test.cj

@@ -1,81 +1,99 @@
-package cjTauri.tests
-
-import cjTauri.*
-import std.collection.*
-import stdx.encoding.json.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * 内置命令 system:host 的用例。
- *
- * 覆盖的是「能力位 → 具名布尔 JSON」这一段：能力位从调用窗口的宿主来，经 hub 注入的取值通道
- * （生产环境里由 TauriApp 接到 hostCapabilities()）变成 HostCapabilities。用例不建窗口，
- * 替身就是那条注入通道——顺带钉住「system:host 走的是通道，不是 hub 自己去摸窗口注册表」。
- *
- * 断言一律**解析 JSON 再取字段**（不靠子串）：序列化格式（空白、键序）不是契约，字段值是。
- */
-
-/** 造一个「通道给 bits」的 hub + 会话上下文（window = main） */
-func hostCtxWith(bits: Int32, asked: ArrayList<String>): IpcContext {
-    let hub = IpcHub()
-    hub.hostCapabilitiesSink = { label =>
-        asked.add(label)
-        bits
-    }
-    return IpcContext(DEFAULT_WINDOW_LABEL, hub)
-}
-
-@Test
-func testSystemHostReportsNamedBooleansForInjectedBits(): Unit {
-    let asked = ArrayList<String>()
-    // 有菜单 + 有托盘、没有拖入：三位各自独立翻名，不能整体按 true/false 一刀切
-    let ctx = hostCtxWith(CJ_CAP_MENU | CJ_CAP_TRAY, asked)
-    let data = SystemCommands().handle("system:host", JsonObject(), ctx).asObject()
-    @Expect(data.get("menu").getOrThrow().asBool().getValue(), true)
-    @Expect(data.get("tray").getOrThrow().asBool().getValue(), true)
-    @Expect(data.get("dragDrop").getOrThrow().asBool().getValue(), false)
-    // platform 由仓颉侧条件编译给（windows / linux），不该是空串
-    @Expect(data.get("platform").getOrThrow().asString().getValue().size > 0, true)
-    // logFile（RFC-003 第 5 期）：进程级字段，用例环境没开日志 → 空串（字段在、值才空）
-    @Expect(data.get("logFile").getOrThrow().asString().getValue(), "")
-    // 取的是**发起命令那个窗口**的能力位
-    @Expect(asked[0], DEFAULT_WINDOW_LABEL)
-}
-
-@Test
-func testSystemHostReportsAllFalseWhenPlatformHasNothing(): Unit {
-    let asked = ArrayList<String>()
-    let ctx = hostCtxWith(0, asked)
-    let data = SystemCommands().handle("system:host", JsonObject(), ctx).asObject()
-    @Expect(data.get("menu").getOrThrow().asBool().getValue(), false)
-    @Expect(data.get("tray").getOrThrow().asBool().getValue(), false)
-    @Expect(data.get("dragDrop").getOrThrow().asBool().getValue(), false)
-}
-
-@Test
-func testSystemHostResolvesThroughHubWhenDeclared(): Unit {
-    // 三处联动的第三处：清单里声明了 system:host，前端才调得到（走完整 IPC 链路 + 异步分发）
-    let out = ArrayList<String>()
-    let hub = hubWith(["system:host"], [], out)
-    hub.hostCapabilitiesSink = { _ => CJ_CAP_MENU }
-    hub.register("system:host", SystemCommands())
-    hub.handleRawMessage("{\"type\":\"invoke\",\"id\":21,\"cmd\":\"system:host\"}")
-    waitSink(out, 1)
-    let reply = JsonValue.fromStr(out[0]).asObject()
-    @Expect(reply.get("ok").getOrThrow().asBool().getValue(), true)
-    let data = reply.get("data").getOrThrow().asObject()
-    @Expect(data.get("menu").getOrThrow().asBool().getValue(), true)
-}
-
-@Test
-func testSystemHostIsDeniedWithoutCapability(): Unit {
-    // 三处联动缺了清单那一处：能力清单没声明 system:host → 调用线程上同步拒绝
-    let out = ArrayList<String>()
-    let hub = hubWith([], [], out)
-    hub.hostCapabilitiesSink = { _ => CJ_CAP_MENU }
-    hub.register("system:host", SystemCommands())
-    hub.handleRawMessage("{\"type\":\"invoke\",\"id\":23,\"cmd\":\"system:host\"}")
-    waitSink(out, 1)
-    @Expect(out[0].contains("command not allowed"), true)
-}
+package cjTauri.tests
+
+import cjTauri.*
+import std.collection.*
+import stdx.encoding.json.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 内置命令 system:host 的用例。
+ *
+ * 覆盖的是「能力位 → 具名布尔 JSON」这一段：能力位从调用窗口的宿主来，经 hub 注入的取值通道
+ * （生产环境里由 TauriApp 接到 hostCapabilities()）变成 HostCapabilities。用例不建窗口，
+ * 替身就是那条注入通道——顺带钉住「system:host 走的是通道，不是 hub 自己去摸窗口注册表」。
+ *
+ * 断言一律**解析 JSON 再取字段**（不靠子串）：序列化格式（空白、键序）不是契约，字段值是。
+ */
+
+/** 造一个「通道给 bits」的 hub + 会话上下文（window = main） */
+func hostCtxWith(bits: Int32, asked: ArrayList<String>): IpcContext {
+    let hub = IpcHub()
+    hub.hostCapabilitiesSink = { label =>
+        asked.add(label)
+        bits
+    }
+    return IpcContext(DEFAULT_WINDOW_LABEL, hub)
+}
+
+@Test
+func testSystemHostReportsNamedBooleansForInjectedBits(): Unit {
+    let asked = ArrayList<String>()
+    // 有菜单 + 有托盘、没有拖入：三位各自独立翻名，不能整体按 true/false 一刀切
+    let ctx = hostCtxWith(CJ_CAP_MENU | CJ_CAP_TRAY, asked)
+    let data = SystemCommands().handle("system:host", JsonObject(), ctx).asObject()
+    @Expect(data.get("menu").getOrThrow().asBool().getValue(), true)
+    @Expect(data.get("tray").getOrThrow().asBool().getValue(), true)
+    @Expect(data.get("dragDrop").getOrThrow().asBool().getValue(), false)
+    // notification（CJ_CAP_NOTIFICATION = 8）：与 dragDrop(4) / hotkey(16) 是三个独立的位；
+    // 这一位曾整条漏在仓颉侧（C 桥置了、可读形态里没有字段），所以单独钉一条
+    @Expect(data.get("notification").getOrThrow().asBool().getValue(), false)
+    // platform 由仓颉侧条件编译给（windows / linux），不该是空串
+    @Expect(data.get("platform").getOrThrow().asString().getValue().size > 0, true)
+    // logFile（RFC-003 第 5 期）：进程级字段，用例环境没开日志 → 空串（字段在、值才空）
+    @Expect(data.get("logFile").getOrThrow().asString().getValue(), "")
+    // 取的是**发起命令那个窗口**的能力位
+    @Expect(asked[0], DEFAULT_WINDOW_LABEL)
+}
+
+@Test
+func testSystemHostReportsAllFalseWhenPlatformHasNothing(): Unit {
+    let asked = ArrayList<String>()
+    let ctx = hostCtxWith(0, asked)
+    let data = SystemCommands().handle("system:host", JsonObject(), ctx).asObject()
+    @Expect(data.get("menu").getOrThrow().asBool().getValue(), false)
+    @Expect(data.get("tray").getOrThrow().asBool().getValue(), false)
+    @Expect(data.get("dragDrop").getOrThrow().asBool().getValue(), false)
+    @Expect(data.get("notification").getOrThrow().asBool().getValue(), false)
+}
+
+@Test
+func testSystemHostMapsNotificationBitIndependently(): Unit {
+    // 只置通知位（8）：它左右两个邻居 dragDrop(4) / hotkey(16) 必须仍是 false。
+    // 这一条正是那位曾经的缺口——C 侧 `CJ_CAP_NOTIFICATION` 置了、仓颉侧没有对应的位与字段，
+    // `system:host` 少了 notification 键（不是值为 false，是根本没这个键），页面读到的就是 undefined。
+    let asked = ArrayList<String>()
+    let ctx = hostCtxWith(CJ_CAP_NOTIFICATION, asked)
+    let data = SystemCommands().handle("system:host", JsonObject(), ctx).asObject()
+    @Expect(data.get("notification").getOrThrow().asBool().getValue(), true)
+    @Expect(data.get("dragDrop").getOrThrow().asBool().getValue(), false)
+    @Expect(data.get("hotkey").getOrThrow().asBool().getValue(), false)
+    @Expect(data.get("menu").getOrThrow().asBool().getValue(), false)
+}
+
+@Test
+func testSystemHostResolvesThroughHubWhenDeclared(): Unit {
+    // 三处联动的第三处：清单里声明了 system:host，前端才调得到（走完整 IPC 链路 + 异步分发）
+    let out = ArrayList<String>()
+    let hub = hubWith(["system:host"], [], out)
+    hub.hostCapabilitiesSink = { _ => CJ_CAP_MENU }
+    hub.register("system:host", SystemCommands())
+    hub.handleRawMessage("{\"type\":\"invoke\",\"id\":21,\"cmd\":\"system:host\"}")
+    waitSink(out, 1)
+    let reply = JsonValue.fromStr(out[0]).asObject()
+    @Expect(reply.get("ok").getOrThrow().asBool().getValue(), true)
+    let data = reply.get("data").getOrThrow().asObject()
+    @Expect(data.get("menu").getOrThrow().asBool().getValue(), true)
+}
+
+@Test
+func testSystemHostIsDeniedWithoutCapability(): Unit {
+    // 三处联动缺了清单那一处：能力清单没声明 system:host → 调用线程上同步拒绝
+    let out = ArrayList<String>()
+    let hub = hubWith([], [], out)
+    hub.hostCapabilitiesSink = { _ => CJ_CAP_MENU }
+    hub.register("system:host", SystemCommands())
+    hub.handleRawMessage("{\"type\":\"invoke\",\"id\":23,\"cmd\":\"system:host\"}")
+    waitSink(out, 1)
+    @Expect(out[0].contains("command not allowed"), true)
+}

package/src/tests/urlutil_test.cj

@@ -1,53 +1,53 @@
-package cjTauri.tests
-
-import cjTauri.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * SNI 的目标怎么定：`urlHostOf` 取主机名，`isIpLiteralHost` 判「是不是 IP 字面量」——
- * 域名才带 `serverName`（stdx 默认不发 SNI，多租户 HTTPS 边缘会当场以 handshake failure 拒掉，
- * 实测 Cloudflare 后面的 api 域名，见 D-022）；IP 字面量不带（RFC 6066 不许，且直连 IP 原本可用）。
- */
-
-@Test
-func testIpLiteralHostRecognizesIpv4AndIpv6(): Unit {
-    @Expect(isIpLiteralHost("127.0.0.1"), true)
-    @Expect(isIpLiteralHost("192.168.1.10"), true)
-    @Expect(isIpLiteralHost("255.255.255.255"), true)
-    @Expect(isIpLiteralHost("[::1]"), true)
-    @Expect(isIpLiteralHost("::1"), true)
-    @Expect(isIpLiteralHost("2606:4700:681a:e1a::1"), true)
-}
-
-@Test
-func testIpLiteralHostRejectsHostnames(): Unit {
-    @Expect(isIpLiteralHost("ai.novacode.top"), false)
-    @Expect(isIpLiteralHost("localhost"), false)
-    // 全是十六进制字母的域名（含点）**不是** IP——按「四段十进制」判就不会误伤
-    @Expect(isIpLiteralHost("dead.beef"), false)
-    @Expect(isIpLiteralHost("127.0.0.1.evil.com"), false)
-    @Expect(isIpLiteralHost("1.2.3"), false)
-    @Expect(isIpLiteralHost("999.1.1.1"), false)
-    @Expect(isIpLiteralHost("1.2.3.4.5"), false)
-    @Expect(isIpLiteralHost(""), false)
-}
-
-@Test
-func testSniTargetDecisionFromUrl(): Unit {
-    // 域名 → 带 SNI（这一条正是 ai.novacode.top 那轮修掉的东西）
-    let named = match (urlHostOf("https://ai.novacode.top/v1/models")) {
-        case Some(h) => h
-        case None => ""
-    }
-    @Expect(named, "ai.novacode.top")
-    @Expect(isIpLiteralHost(named), false)
-
-    // 直连 IP（带端口）→ 不带 SNI，连接与验证照旧
-    let byIp = match (urlHostOf("https://127.0.0.1:8765/api/health")) {
-        case Some(h) => h
-        case None => ""
-    }
-    @Expect(byIp, "127.0.0.1")
-    @Expect(isIpLiteralHost(byIp), true)
-}
+package cjTauri.tests
+
+import cjTauri.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * SNI 的目标怎么定：`urlHostOf` 取主机名，`isIpLiteralHost` 判「是不是 IP 字面量」——
+ * 域名才带 `serverName`（stdx 默认不发 SNI，多租户 HTTPS 边缘会当场以 handshake failure 拒掉，
+ * 实测 Cloudflare 后面的 api 域名，见 D-022）；IP 字面量不带（RFC 6066 不许，且直连 IP 原本可用）。
+ */
+
+@Test
+func testIpLiteralHostRecognizesIpv4AndIpv6(): Unit {
+    @Expect(isIpLiteralHost("127.0.0.1"), true)
+    @Expect(isIpLiteralHost("192.168.1.10"), true)
+    @Expect(isIpLiteralHost("255.255.255.255"), true)
+    @Expect(isIpLiteralHost("[::1]"), true)
+    @Expect(isIpLiteralHost("::1"), true)
+    @Expect(isIpLiteralHost("2606:4700:681a:e1a::1"), true)
+}
+
+@Test
+func testIpLiteralHostRejectsHostnames(): Unit {
+    @Expect(isIpLiteralHost("ai.novacode.top"), false)
+    @Expect(isIpLiteralHost("localhost"), false)
+    // 全是十六进制字母的域名（含点）**不是** IP——按「四段十进制」判就不会误伤
+    @Expect(isIpLiteralHost("dead.beef"), false)
+    @Expect(isIpLiteralHost("127.0.0.1.evil.com"), false)
+    @Expect(isIpLiteralHost("1.2.3"), false)
+    @Expect(isIpLiteralHost("999.1.1.1"), false)
+    @Expect(isIpLiteralHost("1.2.3.4.5"), false)
+    @Expect(isIpLiteralHost(""), false)
+}
+
+@Test
+func testSniTargetDecisionFromUrl(): Unit {
+    // 域名 → 带 SNI（这一条正是 ai.novacode.top 那轮修掉的东西）
+    let named = match (urlHostOf("https://ai.novacode.top/v1/models")) {
+        case Some(h) => h
+        case None => ""
+    }
+    @Expect(named, "ai.novacode.top")
+    @Expect(isIpLiteralHost(named), false)
+
+    // 直连 IP（带端口）→ 不带 SNI，连接与验证照旧
+    let byIp = match (urlHostOf("https://127.0.0.1:8765/api/health")) {
+        case Some(h) => h
+        case None => ""
+    }
+    @Expect(byIp, "127.0.0.1")
+    @Expect(isIpLiteralHost(byIp), true)
+}

package/src/tests/version_test.cj

@@ -1,75 +1,75 @@
-package cjTauri.tests
-
-import cjTauri.*
-import stdx.encoding.json.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * 版本与内置命令的一致性测试。
- * 版本号的权威目标是 CHANGELOG.md，四处常量由 scripts/check-version.sh 巡检；
- * 这里只锁「代码里的单一来源不漂移」。
- */
-
-@Test
-func testVersionConstantNotEmpty(): Unit {
-    @Expect(CJ_TAURI_VERSION.size > 0, true)
-}
-
-@Test
-func testSystemVersionReportsConstant(): Unit {
-    let commands = SystemCommands()
-    let v = commands.handle("system:version", JsonObject(), IpcContext("main", IpcHub()))
-    let o = v.asObject()
-    // 命令报告的版本必须就是常量本身（防止有人改了其中一处）
-    @Expect(o.get("version").getOrThrow().asString().getValue(), CJ_TAURI_VERSION)
-    @Expect(o.get("name").getOrThrow().asString().getValue(), "cj-tauri")
-    @Expect(o.get("protocol").getOrThrow().asString().getValue(), CJ_IPC_PROTOCOL)
-    @Expect(o.get("platform").getOrThrow().asString().getValue(), currentPlatform())
-    @Expect(currentPlatform().size > 0, true)
-}
-
-@Test
-func testIpcProtocolConstantPresent(): Unit {
-    // 协议版本常量：非空、纯数字（抬版本时按「删字段/改语义必须 +1」的纪律走）
-    @Expect(CJ_IPC_PROTOCOL.size > 0, true)
-    for (b in CJ_IPC_PROTOCOL.toArray()) {
-        @Expect(b >= 48u8 && b <= 57u8, true)
-    }
-}
-
-@Test
-func testSystemPingEchoAndUnknown(): Unit {
-    let commands = SystemCommands()
-    let ctx = IpcContext("main", IpcHub())
-    @Expect(commands.handle("system:ping", JsonObject(), ctx).asString().getValue(), "pong")
-
-    var args = JsonObject()
-    args.put("who", JsonString("cj"))
-    let echoed = commands.handle("system:echo", args, ctx).asObject()
-    @Expect(echoed.get("who").getOrThrow().asString().getValue(), "cj")
-
-    // 未定义的 system:* 走 CommandException，前端拿到的是这句原文
-    var thrown = ""
-    try {
-        commands.handle("system:nope", JsonObject(), ctx)
-    } catch (e: CommandException) {
-        thrown = e.message
-    }
-    @Expect(thrown, "unknown system command: system:nope")
-}
-
-@Test
-func testWindowConfigDefaultsMatchBridgeHardcoding(): Unit {
-    // 默认值必须与桥里此前的硬编码一致（标题 cj-tauri / 900x640），否则不调 window() 的应用会变样
-    let def = WindowConfig()
-    @Expect(def.title, "cj-tauri")
-    @Expect(def.width, 900)
-    @Expect(def.height, 640)
-    @Expect(def.devTools, true)
-
-    let custom = WindowConfig("我的应用", 1200, 800)
-    @Expect(custom.title, "我的应用")
-    @Expect(custom.width, 1200)
-    @Expect(custom.height, 800)
-}
+package cjTauri.tests
+
+import cjTauri.*
+import stdx.encoding.json.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 版本与内置命令的一致性测试。
+ * 版本号的权威目标是 CHANGELOG.md，四处常量由 scripts/check-version.sh 巡检；
+ * 这里只锁「代码里的单一来源不漂移」。
+ */
+
+@Test
+func testVersionConstantNotEmpty(): Unit {
+    @Expect(CJ_TAURI_VERSION.size > 0, true)
+}
+
+@Test
+func testSystemVersionReportsConstant(): Unit {
+    let commands = SystemCommands()
+    let v = commands.handle("system:version", JsonObject(), IpcContext("main", IpcHub()))
+    let o = v.asObject()
+    // 命令报告的版本必须就是常量本身（防止有人改了其中一处）
+    @Expect(o.get("version").getOrThrow().asString().getValue(), CJ_TAURI_VERSION)
+    @Expect(o.get("name").getOrThrow().asString().getValue(), "cj-tauri")
+    @Expect(o.get("protocol").getOrThrow().asString().getValue(), CJ_IPC_PROTOCOL)
+    @Expect(o.get("platform").getOrThrow().asString().getValue(), currentPlatform())
+    @Expect(currentPlatform().size > 0, true)
+}
+
+@Test
+func testIpcProtocolConstantPresent(): Unit {
+    // 协议版本常量：非空、纯数字（抬版本时按「删字段/改语义必须 +1」的纪律走）
+    @Expect(CJ_IPC_PROTOCOL.size > 0, true)
+    for (b in CJ_IPC_PROTOCOL.toArray()) {
+        @Expect(b >= 48u8 && b <= 57u8, true)
+    }
+}
+
+@Test
+func testSystemPingEchoAndUnknown(): Unit {
+    let commands = SystemCommands()
+    let ctx = IpcContext("main", IpcHub())
+    @Expect(commands.handle("system:ping", JsonObject(), ctx).asString().getValue(), "pong")
+
+    var args = JsonObject()
+    args.put("who", JsonString("cj"))
+    let echoed = commands.handle("system:echo", args, ctx).asObject()
+    @Expect(echoed.get("who").getOrThrow().asString().getValue(), "cj")
+
+    // 未定义的 system:* 走 CommandException，前端拿到的是这句原文
+    var thrown = ""
+    try {
+        commands.handle("system:nope", JsonObject(), ctx)
+    } catch (e: CommandException) {
+        thrown = e.message
+    }
+    @Expect(thrown, "unknown system command: system:nope")
+}
+
+@Test
+func testWindowConfigDefaultsMatchBridgeHardcoding(): Unit {
+    // 默认值必须与桥里此前的硬编码一致（标题 cj-tauri / 900x640），否则不调 window() 的应用会变样
+    let def = WindowConfig()
+    @Expect(def.title, "cj-tauri")
+    @Expect(def.width, 900)
+    @Expect(def.height, 640)
+    @Expect(def.devTools, true)
+
+    let custom = WindowConfig("我的应用", 1200, 800)
+    @Expect(custom.title, "我的应用")
+    @Expect(custom.width, 1200)
+    @Expect(custom.height, 800)
+}