fix(模块): 托管方不是负责方 —— 改名 cairo/displayinfo,并补齐两个不完备的包装体

[Sunrisepeak]

一、改名:索引 namespace 是货架标签,从不进模块名

包(索引键)	旧模块名	新模块名
freedesktop.cairo	freedesktop.cairo	cairo
freedesktop.libdisplay-info	freedesktop.displayinfo	displayinfo

cairo 是它自己的项目,freedesktop.org 托管 git 但不拥有那套接口;libdisplay-info 解析的是 VESA 的 EDID/DisplayID,freedesktop.* 这个模块前缀留给 freedesktop 自己的规范(像 freedesktop.wayland.client)。同一条规则下 freedesktop.egl 导出的是 khronos.egl。

改名会让老消费者编译报错并点名模块 —— 最该发现问题的地方。

二、⭐ 而且两个包装体都不完备

	导出	缺了什么
cairo	470 → 697	cairo_t,以及全部 192 个枚举量
displayinfo	206 → 501	全部 295 个枚举量

cairo_t 的原因很具体 —— 正则是 cairo_[a-z0-9_]+_t,要求 cairo_ 与 _t 之间至少有一个字符:

typedef struct _cairo cairo_t;      /* cairo.h:135 */

这个库里用得最多的类型,恰好是它唯一匹配不到的名字。

为什么一直没人发现 —— 这才是要记的

• cairo:唯一 import 那个模块的测试同时写了 #include <cairo.h>,头文件把模块缺的都补上了。

  一个从没被要求独立站住的 import,不是被测试了,是被装饰了。

• displayinfo:没有任何测试点过一个枚举量。而且只在 GCC 上加一个也发现不了 —— 导出 enum 会让枚举量在 GCC 可见,clang 拒绝同一个文件(§21.5 那条)。

三、它是从外面被发现的

gnome.pangocairo 不能混用两条消费路线(pangocairo.h 经 glib 到 <stdio.h>,混用让 struct _IO_FILE 变成两个实体),所以它只能问模块要 cairo_t —— 什么都没拿到。

pango 那一版因此带了个变通:自己扫 cairo.h。现在 cairo 修好了,那个变通已经删掉,普通的 export import cairo; 就够了 —— 本来就该够。

一个包的包装体缺不缺,自己的测试可能永远问不出来;是别的包在用它的时候问出来的。

四、发布形态

cairo / libdisplay-info 用的是 release 资产而不是 tag 归档,所以走 -mcpp3 新资产:tag 不动,零窗口,资产名自带修订号。pango 用 tag 归档,原地重切(sha 0882a260…,CN 容器 tag 1.56.1-5)。

⚠️ 验证时撞上了「包版本与上游对齐」的固定代价:本地 store 按 (name, version) 索引,已解开过 1.18.2 的机器拿不到新资产,报 failed to read compiled module,清掉 store 条目才对。已写进 §23.4。

五、测试形态也改了

• cairo:拆成两个文件,一条路线一个。tests/module.cpp 一个头都不包 —— 缺名字就是编译错误。
• displayinfo:比较两个枚举量,导出清单再塌陷就是编译错误。

验证

五个示例(cairo、libdisplay-info、pango、pangoft2、pangocairo)× 两条工具链(gcc 16.1 / llvm 22.1)全绿;两个 fork 仓库本地双绿。