cj-tauri 2.0.0 → 2.1.0

package/src/window_registry.cj

@@ -1,116 +1,116 @@
-package cjTauri
-
-import std.collection.*
-
-/**
- * 一个窗口的记录：label 唯一，config 是它创建时的窗口配置快照
- *
- * label 是窗口对外的**唯一身份**（Tauri 同样按 label 寻址）：前端页面只认 label，
- * C 侧句柄是跨 FFI 的不透明指针，留在宿主实现内部、不越过 IPC 协议（见
- * docs/架构演进-多平台与多窗口.md §7.2）。
- */
-public class WindowRecord {
-    public let label: String
-    public let host: WebViewHost
-    public let config: WindowConfig
-
-    public init(label: String, host: WebViewHost, config: WindowConfig) {
-        this.label = label
-        this.host = host
-        this.config = config
-    }
-}
-
-/**
- * label → 窗口记录（批次 2 的地基）
- *
- * 单窗口阶段只登记一条 "main"——与桥 JS 的 windowLabel 缺省值、旧代码里写死的 "main"
- * 是同一个约定（**默认值不能变**，否则现有示例与探针会静默收不到事件，见架构文档 §6.4）。
- * 多窗口落地后它是「label → 宿主」的唯一权威来源：事件定向投递（emitToWindow）与
- * 命令上下文（IpcContext.window）都从这里查。
- *
- * 为什么重复 label 直接抛而不是覆盖：覆盖会让「一个 label 后面挂着两个宿主」静默成立，
- * 而这类 bug 的表现是「事件忽而收得到、忽而收不到」，是最难查的一类。
- */
-class WindowRegistry {
-    private var windows: HashMap<String, WindowRecord> = HashMap<String, WindowRecord>()
-    // 为什么另存一份插入顺序：HashMap 不承诺迭代顺序，而广播要按确定顺序投递——
-    // 否则多窗口下事件的到达顺序随机，测试也没法断言（labels() 直接给这张表）。
-    private var order: ArrayList<String> = ArrayList<String>()
-
-    /**
-     * 登记一个窗口：label 非空且未被占用
-     */
-    func add(record: WindowRecord): Unit {
-        if (record.label.size == 0) {
-            throw Exception("window label 不能为空")
-        }
-        if (this.windows.contains(record.label)) {
-            throw Exception("duplicate window label: \"${record.label}\"")
-        }
-        this.windows.add(record.label, record)
-        this.order.add(record.label)
-    }
-
-    /**
-     * 按 label 取窗口；未登记返回 None（调用方决定是降级还是报错）
-     */
-    func get(label: String): Option<WindowRecord> {
-        return this.windows.get(label)
-    }
-
-    /**
-     * 全部 label，**按登记顺序**（广播路径据此保持确定顺序）
-     */
-    func labels(): ArrayList<String> {
-        let out = ArrayList<String>()
-        for (l in this.order) {
-            out.add(l)
-        }
-        return out
-    }
-
-    /**
-     * 解析投递目标：空串 = 广播（按登记顺序给出全部窗口），非空 = 命中则单元素、否则空表
-     *
-     * 路由决策放在这里而不是调用方：它是纯函数（不碰宿主）因而能单测，调用方只剩
-     * 「投给谁」与「一个都没命中时怎么报」两件事。**未注册的 label 不回落成广播**——
-     * 写错 label 就该什么都收不到（由调用方打一条 stderr），静默变成广播比丢事件更难查。
-     */
-    func targets(window: String): ArrayList<WindowRecord> {
-        let out = ArrayList<WindowRecord>()
-        if (window.size == 0) {
-            for (l in this.order) {
-                out.add(this.windows.get(l).getOrThrow())
-            }
-            return out
-        }
-        match (this.windows.get(window)) {
-            case Some(rec) => out.add(rec)
-            case None => ()
-        }
-        return out
-    }
-
-    /**
-     * 注销窗口；label 不存在时为空操作（关窗路径可能重复触发，不该被异常打断）
-     */
-    func remove(label: String): Unit {
-        if (!this.windows.contains(label)) {
-            return
-        }
-        let _ = this.windows.remove(label)
-        // 顺序表同步：重建一遍（窗口数以个位计，不值得为它引一个索引表）
-        let kept = ArrayList<String>()
-        for (l in this.order) {
-            if (l != label) {
-                kept.add(l)
-            }
-        }
-        this.order = kept
-    }
-
-    func size(): Int64 {
-        return this.windows.size
-    }
-}
+package cjTauri
+
+import std.collection.*
+
+/**
+ * 一个窗口的记录：label 唯一，config 是它创建时的窗口配置快照
+ *
+ * label 是窗口对外的**唯一身份**（Tauri 同样按 label 寻址）：前端页面只认 label，
+ * C 侧句柄是跨 FFI 的不透明指针，留在宿主实现内部、不越过 IPC 协议（见
+ * docs/架构演进-多平台与多窗口.md §7.2）。
+ */
+public class WindowRecord {
+    public let label: String
+    public let host: WebViewHost
+    public let config: WindowConfig
+
+    public init(label: String, host: WebViewHost, config: WindowConfig) {
+        this.label = label
+        this.host = host
+        this.config = config
+    }
+}
+
+/**
+ * label → 窗口记录（批次 2 的地基）
+ *
+ * 单窗口阶段只登记一条 "main"——与桥 JS 的 windowLabel 缺省值、旧代码里写死的 "main"
+ * 是同一个约定（**默认值不能变**，否则现有示例与探针会静默收不到事件，见架构文档 §6.4）。
+ * 多窗口落地后它是「label → 宿主」的唯一权威来源：事件定向投递（emitToWindow）与
+ * 命令上下文（IpcContext.window）都从这里查。
+ *
+ * 为什么重复 label 直接抛而不是覆盖：覆盖会让「一个 label 后面挂着两个宿主」静默成立，
+ * 而这类 bug 的表现是「事件忽而收得到、忽而收不到」，是最难查的一类。
+ */
+class WindowRegistry {
+    private var windows: HashMap<String, WindowRecord> = HashMap<String, WindowRecord>()
+    // 为什么另存一份插入顺序：HashMap 不承诺迭代顺序，而广播要按确定顺序投递——
+    // 否则多窗口下事件的到达顺序随机，测试也没法断言（labels() 直接给这张表）。
+    private var order: ArrayList<String> = ArrayList<String>()
+
+    /**
+     * 登记一个窗口：label 非空且未被占用
+     */
+    func add(record: WindowRecord): Unit {
+        if (record.label.size == 0) {
+            throw Exception("window label 不能为空")
+        }
+        if (this.windows.contains(record.label)) {
+            throw Exception("duplicate window label: \"${record.label}\"")
+        }
+        this.windows.add(record.label, record)
+        this.order.add(record.label)
+    }
+
+    /**
+     * 按 label 取窗口；未登记返回 None（调用方决定是降级还是报错）
+     */
+    func get(label: String): Option<WindowRecord> {
+        return this.windows.get(label)
+    }
+
+    /**
+     * 全部 label，**按登记顺序**（广播路径据此保持确定顺序）
+     */
+    func labels(): ArrayList<String> {
+        let out = ArrayList<String>()
+        for (l in this.order) {
+            out.add(l)
+        }
+        return out
+    }
+
+    /**
+     * 解析投递目标：空串 = 广播（按登记顺序给出全部窗口），非空 = 命中则单元素、否则空表
+     *
+     * 路由决策放在这里而不是调用方：它是纯函数（不碰宿主）因而能单测，调用方只剩
+     * 「投给谁」与「一个都没命中时怎么报」两件事。**未注册的 label 不回落成广播**——
+     * 写错 label 就该什么都收不到（由调用方打一条 stderr），静默变成广播比丢事件更难查。
+     */
+    func targets(window: String): ArrayList<WindowRecord> {
+        let out = ArrayList<WindowRecord>()
+        if (window.size == 0) {
+            for (l in this.order) {
+                out.add(this.windows.get(l).getOrThrow())
+            }
+            return out
+        }
+        match (this.windows.get(window)) {
+            case Some(rec) => out.add(rec)
+            case None => ()
+        }
+        return out
+    }
+
+    /**
+     * 注销窗口；label 不存在时为空操作（关窗路径可能重复触发，不该被异常打断）
+     */
+    func remove(label: String): Unit {
+        if (!this.windows.contains(label)) {
+            return
+        }
+        let _ = this.windows.remove(label)
+        // 顺序表同步：重建一遍（窗口数以个位计，不值得为它引一个索引表）
+        let kept = ArrayList<String>()
+        for (l in this.order) {
+            if (l != label) {
+                kept.add(l)
+            }
+        }
+        this.order = kept
+    }
+
+    func size(): Int64 {
+        return this.windows.size
+    }
+}

package/src/plugins/serial/serial_ohos_stub.cj

@@ -1,61 +0,0 @@
-package cjTauri.plugins.serial
-
-/**
- * ohos 侧 serial 桩（RFC §4.6.4 P-1）：插件子包三端必须可编译——某端未接通的能力，
- * 在子包内给「调用即可照做地报错」的桩实现（业务 build() 三端共用、import 全部所用插件，
- * 不能靠编译期排除子包兜底——与「业务零平台分支」冲突，RFC §4.6.4 有完整论证）。
- *
- * 真实现批次 4 走 NDK FFI 接通（§4.6.5 四通道决策）；届时删掉本文件的桩，
- * 并在 serial_bridge.cj / plugin_serial.cj 的同名函数上补 ohos 实现段。
- * 桩行为与 SerialPlugin.describe().supportedHosts（webkitgtk + webview2）严格一致（P-2）。
- */
-
-@When[env == "ohos"]
-import std.collection.*
-
-@When[env == "ohos"]
-import cjTauri.*
-
-@When[env == "ohos"]
-public func serialOpen(path: String, baud: Int32, dataBits: Int32, parity: Int32,
-                       stopBits: Int32): Int64 {
-    throw CommandException("serial: 打开串口在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-}
-
-/**
- * 桩的 lastError 返回可读文案而不是抛异常：桌面口径里它出现在错误消息拼接里
- * （`serial:open failed (code …): ${serialLastError()}`），抛异常会打断拼接。
- */
-@When[env == "ohos"]
-public func serialLastError(): String {
-    return "serial: 串口在 ohos 端尚未接通（P-1 桩，批次 4 走 NDK FFI，见 RFC §4.6.4）"
-}
-
-@When[env == "ohos"]
-public func serialListC(): Option<ArrayList<String>> {
-    return None
-}
-
-@When[env == "ohos"]
-public func serialRead(h: Int64, maxBytes: Int32, timeoutMs: Int32): Array<UInt8> {
-    throw CommandException("serial: 读串口在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-}
-
-@When[env == "ohos"]
-public func serialWrite(h: Int64, data: Array<UInt8>, timeoutMs: Int32): Int32 {
-    throw CommandException("serial: 写串口在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-}
-
-@When[env == "ohos"]
-public func serialClose(h: Int64): Int32 {
-    throw CommandException("serial: 关闭串口在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-}
-
-/**
- * 枚举桩抛异常而不是返回空数组：空数组在页面侧语义是「没有串口」，
- * 与「端不支持」是两回事（P-2 的如实失败）。
- */
-@When[env == "ohos"]
-public func serialPortList(): ArrayList<String> {
-    throw CommandException("serial: 枚举串口在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-}

package/src/plugins/sqlite/sqlite_ohos_stub.cj

@@ -1,91 +0,0 @@
-package cjTauri.plugins.sqlite
-
-/**
- * ohos 侧 sqlite 桩（RFC §4.6.4 P-1）：FFI 直连系统 sqlite3 在鸿蒙 hap 里没有链接对象，
- * 桌面实现整体门禁（plugin_sqlite.cj / sqlite_ffi.cj 的 `@When[env != "ohos"]`），
- * 本文件提供同名的桩类占住装配位——业务 build() 三端共用、import 全部所用插件，
- * 不能靠编译期排除子包（与「业务零平台分支」冲突，RFC §4.6.4 有完整论证）。
- *
- * 桩语义：命令表 / 权限集 / 前端 shim 与桌面版完全一致（页面 API 面不变），
- * 但每条命令运行期抛「端不支持」——P-2 的如实失败，与 describe().supportedHosts
- * （webkitgtk）严格一致。真实现批次 4 走 NDK FFI 接通（§4.6.5 四通道决策）后，
- * 删掉本文件、在桌面声明上补 ohos 实现段。
- */
-
-@When[env == "ohos"]
-import std.collection.*
-
-@When[env == "ohos"]
-import stdx.encoding.json.*
-
-@When[env == "ohos"]
-import cjTauri.*
-
-@When[env == "ohos"]
-public class SqlitePlugin <: Plugin {
-    public init() {}
-
-    /** 自描述与桌面版一致（P-2：桩行为与 supportedHosts 严格对齐） */
-    public func describe(): PluginManifest {
-        let hosts = ArrayList<String>()
-        hosts.add("webkitgtk")
-        return PluginManifest(hosts, ArrayList<String>())
-    }
-
-    public func name(): String {
-        return "sqlite"
-    }
-
-    /** 与桌面版一致：path 参数吃 scope 校验（桩不碰路径，语义保持一致免得两端行为分叉） */
-    public func scopeAware(): Bool {
-        return true
-    }
-
-    /** 命令表与桌面版同形（常量共用 plugin_sqlite.cj 的门禁外 let），每条指向桩处理器 */
-    public func commands(): HashMap<String, CommandHandler> {
-        let m = HashMap<String, CommandHandler>()
-        for (short in SQLITE_PLUGIN_COMMANDS) {
-            m.add(short, SqliteOhosStubHandler())
-        }
-        return m
-    }
-
-    public func permissions(): HashMap<String, ArrayList<String>> {
-        let m = HashMap<String, ArrayList<String>>()
-        let ro = ArrayList<String>()
-        for (short in SQLITE_READONLY_COMMANDS) {
-            ro.add(short)
-        }
-        m.add("readonly", ro)
-        let all = ArrayList<String>()
-        for (short in SQLITE_PLUGIN_COMMANDS) {
-            all.add(short)
-        }
-        m.add("default", all)
-        return m
-    }
-
-    /** 前端 shim 与桌面版逐字一致：页面 __CJ_TAURI__.sqlite 命名空间照常存在，调用得到可读错误 */
-    public func jsShim(): String {
-        return "(function () { var t = window.__CJ_TAURI__ || (window.__CJ_TAURI__ = {});" +
-            " t.sqlite = {" +
-            " info: function (args) { return window.__CJ_TAURI__.invoke('sqlite:info', args); }," +
-            " tables: function (args) { return window.__CJ_TAURI__.invoke('sqlite:tables', args); }," +
-            " schema: function (args) { return window.__CJ_TAURI__.invoke('sqlite:schema', args); }," +
-            " page: function (args) { return window.__CJ_TAURI__.invoke('sqlite:page', args); }," +
-            " query: function (args) { return window.__CJ_TAURI__.invoke('sqlite:query', args); }," +
-            " exec: function (args) { return window.__CJ_TAURI__.invoke('sqlite:exec', args); }," +
-            " env: function (args) { return window.__CJ_TAURI__.invoke('sqlite:env', args); }" +
-            " }; })();\n"
-    }
-}
-
-/** 桩处理器：不分命令、一律如实报错（可照做：换端或等批次 4） */
-@When[env == "ohos"]
-class SqliteOhosStubHandler <: CommandHandler {
-    public init() {}
-
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        throw CommandException("sqlite: ${cmd} 在 ohos 端暂不支持（P-1 桩，批次 4 走 NDK FFI 接通，见 RFC §4.6.4）")
-    }
-}