cj-tauri 2.0.0 → 2.1.0

package/src/urlutil.cj

@@ -1,159 +1,159 @@
-package cjTauri
-
-/**
- * URL → host 提取（核心共享层）：http 与 ws 两个插件共用同一套解析与大小写口径。
- *
- * 为什么放核心不放插件：主机白名单的「匹配目标」只要有第二份实现，就一定会有一份
- * 是错的——与 scope 判定同一条铁律（AGENTS §2：安全校验不吃「各插件各写一套」）。
- * 插件只管调，不自己扫字节。
- *
- * 语义：从 `scheme://[user@]host[:port][/path]` 提取 host（小写返回）。
- * 协议只认 http / https / ws / wss；解析不出 host 返回 None。按字节扫（URL 结构
- * 是 ASCII），不用 String 切片撞 UTF-8 边界。public 是为了单测可直接构造（跨包须 public）。
- */
-public func urlHostOf(rawUrl: String): Option<String> {
-    let b = rawUrl.toArray()
-    // 找 "://"（58 47 47）
-    var schemeEnd: Int64 = -1
-    var i: Int64 = 0
-    while (i + 2 < b.size) {
-        if (b[i] == 58u8 && b[i + 1] == 47u8 && b[i + 2] == 47u8) {
-            schemeEnd = i
-            break
-        }
-        i++
-    }
-    if (schemeEnd <= 0) {
-        return None
-    }
-    let scheme = asciiLowerOf(b[0..schemeEnd])
-    if (scheme != "http" && scheme != "https" && scheme != "ws" && scheme != "wss") {
-        return None
-    }
-    // host 段：到 '/' '?' '#' 为止
-    var start = schemeEnd + 3
-    var end = start
-    while (end < b.size) {
-        let c = b[end]
-        if (c == 47u8 || c == 63u8 || c == 35u8) {
-            break
-        }
-        end++
-    }
-    if (end == start) {
-        return None
-    }
-    // 去 userinfo（最后一个 '@' 之前的部分）
-    var at: Int64 = -1
-    var k = end - 1
-    while (k >= start) {
-        if (b[k] == 64u8) {
-            at = k
-            break
-        }
-        k--
-    }
-    if (at >= 0) {
-        start = at + 1
-    }
-    // 去端口（第一个 ':' 之后）——IPv6 字面量 [..] 截到 ']' 为止，方括号内不拆
-    if (b[start] == 91u8) {
-        var close: Int64 = -1
-        var m = start + 1
-        while (m < end) {
-            if (b[m] == 93u8) {
-                close = m
-                break
-            }
-            m++
-        }
-        if (close >= 0) {
-            end = close + 1
-        }
-    } else {
-        var colon: Int64 = -1
-        var m = start
-        while (m < end) {
-            if (b[m] == 58u8) {
-                colon = m
-                break
-            }
-            m++
-        }
-        if (colon >= 0) {
-            end = colon
-        }
-    }
-    if (end <= start) {
-        return None
-    }
-    let host = asciiLowerOf(b[start..end])
-    if (host.size == 0) {
-        return None
-    }
-    return Some(host)
-}
-
-/**
- * host 是不是 IP 字面量（IPv4 / IPv6，可带方括号）。
- *
- * 为什么需要它：建 TLS 客户端时要用 host 当 **SNI**（`serverName`），而 RFC 6066 明确不许 SNI 里放
- * IP 字面量——stdx 默认不发 SNI，本仓给「域名」补上 SNI 的那一轮必须把 IP 排除在外，否则
- * 「https 直连 IP」这类原本可用的端点会被对端当场拒掉（修一个坑别踩出另一个）。
- * 判定只认严格形态：四段十进制且每段 <= 255 的 IPv4，或含冒号 / 带方括号的 IPv6——
- * 纯十六进制字母的域名（如 `dead.beef`）是域名，不是 IP。
- */
-public func isIpLiteralHost(host: String): Bool {
-    if (host.size == 0) {
-        return false
-    }
-    let b = host.toArray()
-    // 带方括号 = IPv6 字面量（urlHostOf 会把方括号一起返回）
-    if (b[0] == 91u8 && b[b.size - 1] == 93u8) {
-        return true
-    }
-    for (i in 0..b.size) {
-        if (b[i] == 58u8) {
-            return true    // 含冒号即 IPv6（含 ::1 这类简写）
-        }
-    }
-    var segs = 0
-    var digits = 0
-    var value: Int64 = 0
-    for (i in 0..b.size) {
-        let c = b[i]
-        if (c == 46u8) {
-            if (digits == 0 || value > 255) {
-                return false
-            }
-            segs = segs + 1
-            digits = 0
-            value = 0
-        } else if (c >= 48u8 && c <= 57u8) {
-            digits = digits + 1
-            if (digits > 3) {
-                return false
-            }
-            value = value * 10 + Int64(c - 48u8)
-        } else {
-            return false
-        }
-    }
-    if (digits == 0 || value > 255) {
-        return false
-    }
-    return segs == 3
-}
-
-/** ASCII 字节 → 小写字符串（非 ASCII 原样保留）；host 匹配统一走这里 */
-private func asciiLowerOf(bytes: Array<Byte>): String {
-    let out = Array<Byte>(bytes.size, repeat: 0)
-    for (i in 0..bytes.size) {
-        var c = bytes[i]
-        if (c >= 65u8 && c <= 90u8) {
-            c = c + 32u8
-        }
-        out[i] = c
-    }
-    return String.fromUtf8(out)
-}
+package cjTauri
+
+/**
+ * URL → host 提取（核心共享层）：http 与 ws 两个插件共用同一套解析与大小写口径。
+ *
+ * 为什么放核心不放插件：主机白名单的「匹配目标」只要有第二份实现，就一定会有一份
+ * 是错的——与 scope 判定同一条铁律（AGENTS §2：安全校验不吃「各插件各写一套」）。
+ * 插件只管调，不自己扫字节。
+ *
+ * 语义：从 `scheme://[user@]host[:port][/path]` 提取 host（小写返回）。
+ * 协议只认 http / https / ws / wss；解析不出 host 返回 None。按字节扫（URL 结构
+ * 是 ASCII），不用 String 切片撞 UTF-8 边界。public 是为了单测可直接构造（跨包须 public）。
+ */
+public func urlHostOf(rawUrl: String): Option<String> {
+    let b = rawUrl.toArray()
+    // 找 "://"（58 47 47）
+    var schemeEnd: Int64 = -1
+    var i: Int64 = 0
+    while (i + 2 < b.size) {
+        if (b[i] == 58u8 && b[i + 1] == 47u8 && b[i + 2] == 47u8) {
+            schemeEnd = i
+            break
+        }
+        i++
+    }
+    if (schemeEnd <= 0) {
+        return None
+    }
+    let scheme = asciiLowerOf(b[0..schemeEnd])
+    if (scheme != "http" && scheme != "https" && scheme != "ws" && scheme != "wss") {
+        return None
+    }
+    // host 段：到 '/' '?' '#' 为止
+    var start = schemeEnd + 3
+    var end = start
+    while (end < b.size) {
+        let c = b[end]
+        if (c == 47u8 || c == 63u8 || c == 35u8) {
+            break
+        }
+        end++
+    }
+    if (end == start) {
+        return None
+    }
+    // 去 userinfo（最后一个 '@' 之前的部分）
+    var at: Int64 = -1
+    var k = end - 1
+    while (k >= start) {
+        if (b[k] == 64u8) {
+            at = k
+            break
+        }
+        k--
+    }
+    if (at >= 0) {
+        start = at + 1
+    }
+    // 去端口（第一个 ':' 之后）——IPv6 字面量 [..] 截到 ']' 为止，方括号内不拆
+    if (b[start] == 91u8) {
+        var close: Int64 = -1
+        var m = start + 1
+        while (m < end) {
+            if (b[m] == 93u8) {
+                close = m
+                break
+            }
+            m++
+        }
+        if (close >= 0) {
+            end = close + 1
+        }
+    } else {
+        var colon: Int64 = -1
+        var m = start
+        while (m < end) {
+            if (b[m] == 58u8) {
+                colon = m
+                break
+            }
+            m++
+        }
+        if (colon >= 0) {
+            end = colon
+        }
+    }
+    if (end <= start) {
+        return None
+    }
+    let host = asciiLowerOf(b[start..end])
+    if (host.size == 0) {
+        return None
+    }
+    return Some(host)
+}
+
+/**
+ * host 是不是 IP 字面量（IPv4 / IPv6，可带方括号）。
+ *
+ * 为什么需要它：建 TLS 客户端时要用 host 当 **SNI**（`serverName`），而 RFC 6066 明确不许 SNI 里放
+ * IP 字面量——stdx 默认不发 SNI，本仓给「域名」补上 SNI 的那一轮必须把 IP 排除在外，否则
+ * 「https 直连 IP」这类原本可用的端点会被对端当场拒掉（修一个坑别踩出另一个）。
+ * 判定只认严格形态：四段十进制且每段 <= 255 的 IPv4，或含冒号 / 带方括号的 IPv6——
+ * 纯十六进制字母的域名（如 `dead.beef`）是域名，不是 IP。
+ */
+public func isIpLiteralHost(host: String): Bool {
+    if (host.size == 0) {
+        return false
+    }
+    let b = host.toArray()
+    // 带方括号 = IPv6 字面量（urlHostOf 会把方括号一起返回）
+    if (b[0] == 91u8 && b[b.size - 1] == 93u8) {
+        return true
+    }
+    for (i in 0..b.size) {
+        if (b[i] == 58u8) {
+            return true    // 含冒号即 IPv6（含 ::1 这类简写）
+        }
+    }
+    var segs = 0
+    var digits = 0
+    var value: Int64 = 0
+    for (i in 0..b.size) {
+        let c = b[i]
+        if (c == 46u8) {
+            if (digits == 0 || value > 255) {
+                return false
+            }
+            segs = segs + 1
+            digits = 0
+            value = 0
+        } else if (c >= 48u8 && c <= 57u8) {
+            digits = digits + 1
+            if (digits > 3) {
+                return false
+            }
+            value = value * 10 + Int64(c - 48u8)
+        } else {
+            return false
+        }
+    }
+    if (digits == 0 || value > 255) {
+        return false
+    }
+    return segs == 3
+}
+
+/** ASCII 字节 → 小写字符串（非 ASCII 原样保留）；host 匹配统一走这里 */
+private func asciiLowerOf(bytes: Array<Byte>): String {
+    let out = Array<Byte>(bytes.size, repeat: 0)
+    for (i in 0..bytes.size) {
+        var c = bytes[i]
+        if (c >= 65u8 && c <= 90u8) {
+            c = c + 32u8
+        }
+        out[i] = c
+    }
+    return String.fromUtf8(out)
+}

package/src/version.cj

@@ -1,44 +1,44 @@
-package cjTauri
-
-/**
- * 框架版本：仓颉侧的单一代码来源（`system:version` 命令返回它）。
- *
- * 发版时必须与以下位置同步，改完跑 `bash scripts/check-version.sh` 自检：
- *   - cjpm.toml               的 version（框架包）
- *   - cli/cjpm.toml           的 version（CLI 包）
- *   - cli/src/project.cj      的 cliVersion()
- *   - CHANGELOG.md            顶部第一个已发版段
- */
-public let CJ_TAURI_VERSION = "2.0.0"
-
-/**
- * IPC 报文协议版本（报文形状是跨层契约，加版本字段是协议治理惯例）：事件 / 回执信封的 `protocol` 字段
- * 与 `system:version` 返回的 `protocol` 字段都来自这里——单一代码来源，改协议时同步抬版本。
- *
- * 为什么同进程也要有：报文形状现在是跨层契约（C 桥 bridge_js.h 的页面侧解析、CLI 的
- * manifest 消费、将来 HarmonyOS/独立进程形态的跨进程边界），有版本字段才能在「旧页面
- * 配新框架」这类错配时给出可诊断的信号，而不是行为悄悄漂移。
- * v1：`type` + `event`/`id` + `payload` (+ 可选 `coalesce`/`window`)；本字段加入记 v1，
- * 此后任何「删字段 / 改语义」必须抬到 v2。
- */
-public let CJ_IPC_PROTOCOL = "1"
-
-/** 当前宿主平台标识（`system:version` 的 platform 字段） */
-// 鸿蒙目标的 `os` 仍报 Linux（实测），所以 `os` 维度分不开「GTK 宿主」与「ArkWeb 宿主」。
-// 判据用 `env`：鸿蒙目标（`aarch64-linux-ohos`）是 `ohos`，桌面 Linux 是 `gnu`——两者互斥；
-// 而 `arch` 不行（桌面 aarch64 Linux 同样是 `aarch64`，会被误报成鸿蒙）。
-// 平台标识必须是真实的那一个：`linux` / `ohos` 混用会让前端与证据链分不清跑在哪个宿主上。
-@When[os == "Linux" && env != "ohos"]
-public func currentPlatform(): String {
-    return "linux"
-}
-
-@When[env == "ohos"]
-public func currentPlatform(): String {
-    return "ohos"
-}
-
-@When[os == "Windows"]
-public func currentPlatform(): String {
-    return "windows"
-}
+package cjTauri
+
+/**
+ * 框架版本：仓颉侧的单一代码来源（`system:version` 命令返回它）。
+ *
+ * 发版时必须与以下位置同步，改完跑 `bash scripts/check-version.sh` 自检：
+ *   - cjpm.toml               的 version（框架包）
+ *   - cli/cjpm.toml           的 version（CLI 包）
+ *   - cli/src/project.cj      的 cliVersion()
+ *   - CHANGELOG.md            顶部第一个已发版段
+ */
+public let CJ_TAURI_VERSION = "2.1.0"
+
+/**
+ * IPC 报文协议版本（报文形状是跨层契约，加版本字段是协议治理惯例）：事件 / 回执信封的 `protocol` 字段
+ * 与 `system:version` 返回的 `protocol` 字段都来自这里——单一代码来源，改协议时同步抬版本。
+ *
+ * 为什么同进程也要有：报文形状现在是跨层契约（C 桥 bridge_js.h 的页面侧解析、CLI 的
+ * manifest 消费、将来 HarmonyOS/独立进程形态的跨进程边界），有版本字段才能在「旧页面
+ * 配新框架」这类错配时给出可诊断的信号，而不是行为悄悄漂移。
+ * v1：`type` + `event`/`id` + `payload` (+ 可选 `coalesce`/`window`)；本字段加入记 v1，
+ * 此后任何「删字段 / 改语义」必须抬到 v2。
+ */
+public let CJ_IPC_PROTOCOL = "1"
+
+/** 当前宿主平台标识（`system:version` 的 platform 字段） */
+// 鸿蒙目标的 `os` 仍报 Linux（实测），所以 `os` 维度分不开「GTK 宿主」与「ArkWeb 宿主」。
+// 判据用 `env`：鸿蒙目标（`aarch64-linux-ohos`）是 `ohos`，桌面 Linux 是 `gnu`——两者互斥；
+// 而 `arch` 不行（桌面 aarch64 Linux 同样是 `aarch64`，会被误报成鸿蒙）。
+// 平台标识必须是真实的那一个：`linux` / `ohos` 混用会让前端与证据链分不清跑在哪个宿主上。
+@When[os == "Linux" && env != "ohos"]
+public func currentPlatform(): String {
+    return "linux"
+}
+
+@When[env == "ohos"]
+public func currentPlatform(): String {
+    return "ohos"
+}
+
+@When[os == "Windows"]
+public func currentPlatform(): String {
+    return "windows"
+}

package/src/window.cj

@@ -1,51 +1,51 @@
-package cjTauri
-
-/**
- * 窗口配置（对标 tauri.conf.json 的 app.windows[] 项）
- *
- * 用法：
- *   let app = TauriApp().window(WindowConfig("我的应用", 1200, 800))
- *
- *   // 要自定义窗口图标（可选）：
- *   var cfg = WindowConfig("我的应用", 1200, 800)
- *   cfg.iconPath = "assets/app.ico"
- *   let app = TauriApp().window(cfg)
- *
- * 默认值与此前桥内硬编码的值一致（标题 cj-tauri / 900x640），
- * 因此不调用 window() 的应用行为不变。
- */
-public class WindowConfig {
-    public var title: String
-    public var width: Int64
-    public var height: Int64
-    // 是否允许打开开发者工具（WebView2 的 AreDevToolsEnabled / WebKit 的 developer extras）
-    public var devTools: Bool
-    // 窗口图标路径：Windows 用 .ico（LoadImageW 只认 .ico）；Linux 走 GTK，png/ico 都行。
-    // 空字符串 = 用系统默认图标（默认行为，不影响老应用）。
-    public var iconPath: String
-
-    // 最小化到托盘（B 项）：用户在标题栏点「最小化」时窗口**隐藏**（从任务栏消失、只留托盘图标），
-    // 而不是缩成任务栏按钮。默认 false = 老行为不变。
-    // 必须与服务端配套：应用得先 setTray(...)，否则隐藏之后界面上没有任何入口——
-    // 框架不替应用拦这个组合（它不知道应用的托盘菜单长什么样），但真到最小化那一刻平台会
-    // 复核托盘是否**真的**装上了：没装就降级为普通最小化并打一行 stderr，避免「窗口没了也点不回来」。
-    public var minimizeToTray: Bool
-
-    public init() {
-        this.title = "cj-tauri"
-        this.width = 900
-        this.height = 640
-        this.devTools = true
-        this.iconPath = ""
-        this.minimizeToTray = false
-    }
-
-    public init(title: String, width: Int64, height: Int64) {
-        this.title = title
-        this.width = width
-        this.height = height
-        this.devTools = true
-        this.iconPath = ""
-        this.minimizeToTray = false
-    }
-}
+package cjTauri
+
+/**
+ * 窗口配置（对标 tauri.conf.json 的 app.windows[] 项）
+ *
+ * 用法：
+ *   let app = TauriApp().window(WindowConfig("我的应用", 1200, 800))
+ *
+ *   // 要自定义窗口图标（可选）：
+ *   var cfg = WindowConfig("我的应用", 1200, 800)
+ *   cfg.iconPath = "assets/app.ico"
+ *   let app = TauriApp().window(cfg)
+ *
+ * 默认值与此前桥内硬编码的值一致（标题 cj-tauri / 900x640），
+ * 因此不调用 window() 的应用行为不变。
+ */
+public class WindowConfig {
+    public var title: String
+    public var width: Int64
+    public var height: Int64
+    // 是否允许打开开发者工具（WebView2 的 AreDevToolsEnabled / WebKit 的 developer extras）
+    public var devTools: Bool
+    // 窗口图标路径：Windows 用 .ico（LoadImageW 只认 .ico）；Linux 走 GTK，png/ico 都行。
+    // 空字符串 = 用系统默认图标（默认行为，不影响老应用）。
+    public var iconPath: String
+
+    // 最小化到托盘（B 项）：用户在标题栏点「最小化」时窗口**隐藏**（从任务栏消失、只留托盘图标），
+    // 而不是缩成任务栏按钮。默认 false = 老行为不变。
+    // 必须与服务端配套：应用得先 setTray(...)，否则隐藏之后界面上没有任何入口——
+    // 框架不替应用拦这个组合（它不知道应用的托盘菜单长什么样），但真到最小化那一刻平台会
+    // 复核托盘是否**真的**装上了：没装就降级为普通最小化并打一行 stderr，避免「窗口没了也点不回来」。
+    public var minimizeToTray: Bool
+
+    public init() {
+        this.title = "cj-tauri"
+        this.width = 900
+        this.height = 640
+        this.devTools = true
+        this.iconPath = ""
+        this.minimizeToTray = false
+    }
+
+    public init(title: String, width: Int64, height: Int64) {
+        this.title = title
+        this.width = width
+        this.height = height
+        this.devTools = true
+        this.iconPath = ""
+        this.minimizeToTray = false
+    }
+}