cj-tauri 2.0.0 → 2.1.0

package/src/tests/window_registry_test.cj

@@ -1,123 +1,123 @@
-package cjTauri.tests
-
-import cjTauri.*
-import std.collection.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * 窗口注册表单测：纯逻辑，不创建窗口，可在无 GUI 环境跑。
- * 两条对外契约借用例钉住：① label 缺省值 "main"（现有示例与探针写死它）；
- * ② labels() 按登记顺序（广播据此保持确定顺序，HashMap 的迭代顺序不保证）。
- */
-
-/** 断言某段调用抛异常（此处要断的是「拒绝」这个行为本身，@Expect 断言不了） */
-func thrownBy(body: () -> Unit): Bool {
-    try {
-        body()
-        return false
-    } catch (e: Exception) {
-        return true
-    }
-}
-
-func rec(label: String): WindowRecord {
-    return WindowRecord(label, FakeHost(label), WindowConfig())
-}
-
-@Test
-func testRegistryAddAndGet(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    @Expect(reg.size(), 1)
-    @Expect(reg.get("main").isSome(), true)
-    @Expect(reg.get("main").getOrThrow().label, "main")
-}
-
-@Test
-func testRegistryRejectsDuplicateLabel(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    // 覆盖会让「一个 label 挂着两个宿主」静默成立，必须抛
-    @Expect(thrownBy({ => reg.add(rec("main")) }), true)
-    @Expect(reg.size(), 1)
-}
-
-@Test
-func testRegistryRejectsEmptyLabel(): Unit {
-    let reg = WindowRegistry()
-    @Expect(thrownBy({ => reg.add(rec("")) }), true)
-    @Expect(reg.size(), 0)
-}
-
-@Test
-func testRegistryMissingLabelIsNone(): Unit {
-    let reg = WindowRegistry()
-    @Expect(reg.get("settings").isNone(), true)
-}
-
-@Test
-func testRegistryLabelsKeepInsertionOrder(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    reg.add(rec("settings"))
-    reg.add(rec("log"))
-    let ls = reg.labels()
-    @Expect(ls.size, 3)
-    @Expect(ls[0], "main")
-    @Expect(ls[1], "settings")
-    @Expect(ls[2], "log")
-}
-
-@Test
-func testRegistryRemoveIsIdempotent(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    reg.add(rec("settings"))
-    reg.remove("main")
-    @Expect(reg.size(), 1)
-    @Expect(reg.get("main").isNone(), true)
-    // 关窗路径可能重复触发：删不存在的 label 不该抛
-    reg.remove("main")
-    @Expect(reg.size(), 1)
-    let ls = reg.labels()
-    @Expect(ls.size, 1)
-    @Expect(ls[0], "settings")
-}
-
-@Test
-func testRecordKeepsConfigSnapshot(): Unit {
-    let r = WindowRecord("main", FakeHost("main"), WindowConfig("编辑器", 1024, 768))
-    @Expect(r.config.title, "编辑器")
-    @Expect(r.config.width, 1024)
-    @Expect(r.config.height, 768)
-}
-
-@Test
-func testTargetsBroadcastKeepsOrder(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    reg.add(rec("settings"))
-    let ts = reg.targets("")
-    @Expect(ts.size, 2)
-    @Expect(ts[0].label, "main")
-    @Expect(ts[1].label, "settings")
-}
-
-@Test
-func testTargetsSingleWindow(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    reg.add(rec("settings"))
-    let ts = reg.targets("settings")
-    @Expect(ts.size, 1)
-    @Expect(ts[0].label, "settings")
-}
-
-@Test
-func testTargetsUnknownLabelIsEmpty(): Unit {
-    let reg = WindowRegistry()
-    reg.add(rec("main"))
-    // 未注册的 label 不回落成广播：写错 label 就该听不到，由调用方打日志
-    @Expect(reg.targets("nope").size, 0)
-}
+package cjTauri.tests
+
+import cjTauri.*
+import std.collection.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 窗口注册表单测：纯逻辑，不创建窗口，可在无 GUI 环境跑。
+ * 两条对外契约借用例钉住：① label 缺省值 "main"（现有示例与探针写死它）；
+ * ② labels() 按登记顺序（广播据此保持确定顺序，HashMap 的迭代顺序不保证）。
+ */
+
+/** 断言某段调用抛异常（此处要断的是「拒绝」这个行为本身，@Expect 断言不了） */
+func thrownBy(body: () -> Unit): Bool {
+    try {
+        body()
+        return false
+    } catch (e: Exception) {
+        return true
+    }
+}
+
+func rec(label: String): WindowRecord {
+    return WindowRecord(label, FakeHost(label), WindowConfig())
+}
+
+@Test
+func testRegistryAddAndGet(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    @Expect(reg.size(), 1)
+    @Expect(reg.get("main").isSome(), true)
+    @Expect(reg.get("main").getOrThrow().label, "main")
+}
+
+@Test
+func testRegistryRejectsDuplicateLabel(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    // 覆盖会让「一个 label 挂着两个宿主」静默成立，必须抛
+    @Expect(thrownBy({ => reg.add(rec("main")) }), true)
+    @Expect(reg.size(), 1)
+}
+
+@Test
+func testRegistryRejectsEmptyLabel(): Unit {
+    let reg = WindowRegistry()
+    @Expect(thrownBy({ => reg.add(rec("")) }), true)
+    @Expect(reg.size(), 0)
+}
+
+@Test
+func testRegistryMissingLabelIsNone(): Unit {
+    let reg = WindowRegistry()
+    @Expect(reg.get("settings").isNone(), true)
+}
+
+@Test
+func testRegistryLabelsKeepInsertionOrder(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    reg.add(rec("settings"))
+    reg.add(rec("log"))
+    let ls = reg.labels()
+    @Expect(ls.size, 3)
+    @Expect(ls[0], "main")
+    @Expect(ls[1], "settings")
+    @Expect(ls[2], "log")
+}
+
+@Test
+func testRegistryRemoveIsIdempotent(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    reg.add(rec("settings"))
+    reg.remove("main")
+    @Expect(reg.size(), 1)
+    @Expect(reg.get("main").isNone(), true)
+    // 关窗路径可能重复触发：删不存在的 label 不该抛
+    reg.remove("main")
+    @Expect(reg.size(), 1)
+    let ls = reg.labels()
+    @Expect(ls.size, 1)
+    @Expect(ls[0], "settings")
+}
+
+@Test
+func testRecordKeepsConfigSnapshot(): Unit {
+    let r = WindowRecord("main", FakeHost("main"), WindowConfig("编辑器", 1024, 768))
+    @Expect(r.config.title, "编辑器")
+    @Expect(r.config.width, 1024)
+    @Expect(r.config.height, 768)
+}
+
+@Test
+func testTargetsBroadcastKeepsOrder(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    reg.add(rec("settings"))
+    let ts = reg.targets("")
+    @Expect(ts.size, 2)
+    @Expect(ts[0].label, "main")
+    @Expect(ts[1].label, "settings")
+}
+
+@Test
+func testTargetsSingleWindow(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    reg.add(rec("settings"))
+    let ts = reg.targets("settings")
+    @Expect(ts.size, 1)
+    @Expect(ts[0].label, "settings")
+}
+
+@Test
+func testTargetsUnknownLabelIsEmpty(): Unit {
+    let reg = WindowRegistry()
+    reg.add(rec("main"))
+    // 未注册的 label 不回落成广播：写错 label 就该听不到，由调用方打日志
+    @Expect(reg.targets("nope").size, 0)
+}

package/src/tray.cj

@@ -1,90 +1,90 @@
-package cjTauri
-
-import std.collection.*
-
-/**
- * 托盘的**纯仓颉模型**（RFC-002 §5.1 / §7.C）：只描述意图，不含任何平台概念。
- *
- * 分层与菜单同构：模型（本文件）→ `WebViewHost.setTray()` → C 桥 `cj_bridge_set_tray` →
- * 平台翻译层（Linux = libayatana-appindicator3，可选编译；Windows 桩如实报未实现）。
- *
- * 托盘是**应用级**资源（一个进程一个图标）：重复 setTray = 整体重建（图标 / 提示 / 菜单一起换）；
- * 空线路 = 移除托盘。菜单项复用 `MenuItem`（v1 只收 Normal / Checkbox / Separator，
- * Submenu 整条跳过并打 stderr——托盘菜单平铺，别给子菜单）。
- *
- * 线路格式（与 `native/core/bridge_core.h` 的 `pending_tray` 注释逐字对应）：
- *
- *     icon\t<路径>\n        （空路径 = 平台用主题默认图标兜底）
- *     tooltip\t<文本>\n
- *     <kind>\t<id>\t<label>\t<flags>\t<accel>\n   （与菜单线路同格式，平铺一层）
- *
- * 菜单项被点以 `{"kind":"tray","id":"…"}` 走 shell 通道回投（前端事件 `tray:click`，
- * 需在能力清单 `events` 声明）。图标 / 提示文本来自应用作者，不做转义；
- * 字段含制表符 / 换行的头部值整体丢弃为空（wire 的结构字符，与菜单同一铁律）。
- */
-public class TrayModel {
-    /** 图标路径（png/ico 绝对路径）；空串 = 平台用主题默认图标兜底 */
-    public let icon: String
-
-    /** 悬停提示文本；空串 = 不设 */
-    public let tooltip: String
-
-    /** 托盘右键菜单（平铺一层；Submenu 项会被 toWire 丢弃并打 stderr） */
-    public let items: ArrayList<MenuItem>
-
-    public init(icon: String, tooltip: String, items: ArrayList<MenuItem>) {
-        this.icon = icon
-        this.tooltip = tooltip
-        this.items = items
-    }
-
-    /** 无菜单托盘（纯图标 + 提示） */
-    public init(icon: String, tooltip: String) {
-        this.icon = icon
-        this.tooltip = tooltip
-        this.items = ArrayList<MenuItem>()
-    }
-
-    /** 线路文本（三段：icon 行 / tooltip 行 / 菜单行走 MenuModel.emit 同一遍发射器） */
-    public func toWire(): String {
-        // 托盘菜单平铺：Submenu 整条出局（枚举不能写 ==，AGENTS §4，走 match）
-        let flat = ArrayList<MenuItem>()
-        for (it in this.items) {
-            if (TrayModel.isSubmenu(it.kind)) {
-                eprintln("[cj-tauri] tray: submenu item dropped (v1 tray menu is flat): ${it.label}")
-                continue
-            }
-            flat.add(it)
-        }
-        // 头部两行的结构字符会让整份线路解析错位：宁可丢提示也不装错
-        var icon = this.icon
-        var tooltip = this.tooltip
-        if (TrayModel.hasStructChar(icon) || TrayModel.hasStructChar(tooltip)) {
-            eprintln("[cj-tauri] tray: icon/tooltip contains tab or newline - dropped to empty")
-            icon = ""
-            tooltip = ""
-        }
-        var out = "icon\t" + icon + "\n"
-        out += "tooltip\t" + tooltip + "\n"
-        out += MenuModel.emit(flat, 0)
-        return out
-    }
-
-    /** 枚举判别只能走 match（`==` 编译不过，见 MenuModel.isSubmenu 的实测注释） */
-    private static func isSubmenu(kind: MenuItemKind): Bool {
-        match (kind) {
-            case MenuItemKind.Submenu => true
-            case _ => false
-        }
-    }
-
-    /** 结构字符（tab/LF/CR）检查——wire 的分隔符就是它们 */
-    private static func hasStructChar(s: String): Bool {
-        for (b in s) {
-            if (b == 9u8 || b == 10u8 || b == 13u8) {
-                return true
-            }
-        }
-        return false
-    }
-}
+package cjTauri
+
+import std.collection.*
+
+/**
+ * 托盘的**纯仓颉模型**（RFC-002 §5.1 / §7.C）：只描述意图，不含任何平台概念。
+ *
+ * 分层与菜单同构：模型（本文件）→ `WebViewHost.setTray()` → C 桥 `cj_bridge_set_tray` →
+ * 平台翻译层（Linux = libayatana-appindicator3，可选编译；Windows 桩如实报未实现）。
+ *
+ * 托盘是**应用级**资源（一个进程一个图标）：重复 setTray = 整体重建（图标 / 提示 / 菜单一起换）；
+ * 空线路 = 移除托盘。菜单项复用 `MenuItem`（v1 只收 Normal / Checkbox / Separator，
+ * Submenu 整条跳过并打 stderr——托盘菜单平铺，别给子菜单）。
+ *
+ * 线路格式（与 `native/core/bridge_core.h` 的 `pending_tray` 注释逐字对应）：
+ *
+ *     icon\t<路径>\n        （空路径 = 平台用主题默认图标兜底）
+ *     tooltip\t<文本>\n
+ *     <kind>\t<id>\t<label>\t<flags>\t<accel>\n   （与菜单线路同格式，平铺一层）
+ *
+ * 菜单项被点以 `{"kind":"tray","id":"…"}` 走 shell 通道回投（前端事件 `tray:click`，
+ * 需在能力清单 `events` 声明）。图标 / 提示文本来自应用作者，不做转义；
+ * 字段含制表符 / 换行的头部值整体丢弃为空（wire 的结构字符，与菜单同一铁律）。
+ */
+public class TrayModel {
+    /** 图标路径（png/ico 绝对路径）；空串 = 平台用主题默认图标兜底 */
+    public let icon: String
+
+    /** 悬停提示文本；空串 = 不设 */
+    public let tooltip: String
+
+    /** 托盘右键菜单（平铺一层；Submenu 项会被 toWire 丢弃并打 stderr） */
+    public let items: ArrayList<MenuItem>
+
+    public init(icon: String, tooltip: String, items: ArrayList<MenuItem>) {
+        this.icon = icon
+        this.tooltip = tooltip
+        this.items = items
+    }
+
+    /** 无菜单托盘（纯图标 + 提示） */
+    public init(icon: String, tooltip: String) {
+        this.icon = icon
+        this.tooltip = tooltip
+        this.items = ArrayList<MenuItem>()
+    }
+
+    /** 线路文本（三段：icon 行 / tooltip 行 / 菜单行走 MenuModel.emit 同一遍发射器） */
+    public func toWire(): String {
+        // 托盘菜单平铺：Submenu 整条出局（枚举不能写 ==，AGENTS §4，走 match）
+        let flat = ArrayList<MenuItem>()
+        for (it in this.items) {
+            if (TrayModel.isSubmenu(it.kind)) {
+                eprintln("[cj-tauri] tray: submenu item dropped (v1 tray menu is flat): ${it.label}")
+                continue
+            }
+            flat.add(it)
+        }
+        // 头部两行的结构字符会让整份线路解析错位：宁可丢提示也不装错
+        var icon = this.icon
+        var tooltip = this.tooltip
+        if (TrayModel.hasStructChar(icon) || TrayModel.hasStructChar(tooltip)) {
+            eprintln("[cj-tauri] tray: icon/tooltip contains tab or newline - dropped to empty")
+            icon = ""
+            tooltip = ""
+        }
+        var out = "icon\t" + icon + "\n"
+        out += "tooltip\t" + tooltip + "\n"
+        out += MenuModel.emit(flat, 0)
+        return out
+    }
+
+    /** 枚举判别只能走 match（`==` 编译不过，见 MenuModel.isSubmenu 的实测注释） */
+    private static func isSubmenu(kind: MenuItemKind): Bool {
+        match (kind) {
+            case MenuItemKind.Submenu => true
+            case _ => false
+        }
+    }
+
+    /** 结构字符（tab/LF/CR）检查——wire 的分隔符就是它们 */
+    private static func hasStructChar(s: String): Bool {
+        for (b in s) {
+            if (b == 9u8 || b == 10u8 || b == 13u8) {
+                return true
+            }
+        }
+        return false
+    }
+}