From 57f6c69c4a94286f4a87faf03e2c9ab0f464ee53 Mon Sep 17 00:00:00 2001 From: Sunrisepeak Date: Sun, 22 Nov 2026 02:23:48 +0900 Subject: [PATCH] compat.slint depends on compat.glx-runtime (the GL vendor); a lint for capabilities nobody provides Slint's windowed run aborted on an NVIDIA X11 desktop: libglvnd is only the dispatcher, and compat.slint named no package that wires the vendor (Mesa or NVIDIA) into it. compat.glfw already depends on compat.glx-runtime, which depends on xim:graphics; compat.slint now does the same on Linux. tests/check_capability_providers.lua reports a declared runtime capability that no package in the dependency closure provides (warning; --strict fails). It currently also reports compat.sdl2 and the two names compat.slint keeps on purpose (display, opengl.egl.driver). The plan records both. --- ...-host-driver-link-and-display-path-plan.md | 123 ++++++++++++++++++ .github/workflows/validate.yml | 5 + CHANGELOG.md | 2 + pkgs/c/compat.slint.lua | 28 +++- tests/check_capability_providers.lua | 123 ++++++++++++++++++ tests/test_check_capability_providers.py | 74 +++++++++++ 6 files changed, 349 insertions(+), 6 deletions(-) create mode 100644 .agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md create mode 100644 tests/check_capability_providers.lua create mode 100644 tests/test_check_capability_providers.py diff --git a/.agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md b/.agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md new file mode 100644 index 00000000..555264db --- /dev/null +++ b/.agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md @@ -0,0 +1,123 @@ +# 修复方案:Slint 真窗口在 NVIDIA 桌面上 abort —— GL 厂商提供者缺失(v2,重写) + +状态:**草案 v2,待维护者评审**(2026-11-22)。本文**取代**同名文件的 v1:v1 把原因判断为“宿主 NVIDIA 驱动桥接包过期”,这一判断已被实验推翻(§3)。本文含:结论与证据(§1)、三个现象各自的状态(§2)、被推翻的分析与教训(§3)、修复方案(§4)、以 Slint 为金丝雀的验证(§5)、实施计划与任务关系(§6)、独立且不阻塞的事项(§7)、风险与未验证项(§8)、待决问题(§9)。 +事实均为实测所得,出处写在各条之后。**本文不改 mcpp 仓库**;mcpp issue #995 已关闭(§7)。 + +## 0. 问题 + +`mcpp new counter --template mcpplibs.mwrap.slint` 生成的 Slint hello 模板,在带 NVIDIA GPU 的 Linux 桌面(X11)上 `mcpp run` 会 abort;`SLINT_HEADLESS=1` 正常。 + +## 1. 结论与证据 + +**结论。** `compat.slint`(及它背后的 `xim:slint` 配方)依赖 libglvnd,也就是 GL 的**分发器**,却没有依赖任何提供 GL **厂商**的包。`compat.glx-runtime`(`compat.glfw` 依赖它)、`compat.libgbm`,以及 godot、chatgpt、xdesk、luban-os、qemu-system-gl 都依赖 `xim:graphics`(mesa + `nvidia-gl-host-link` + glvnd 的 `glx-vendor` 布线),Slint 没有。NVIDIA 的 X 服务器要求 GLX 厂商是 NVIDIA,glvnd 要加载 `libGLX_nvidia.so.0`,mcpp 的 registry 里没有它,GLX 就没有厂商,glutin 失败,Slint 的 femtovg 渲染器没有回退,`unwrap` abort。 + +| # | 证据(在 NVIDIA 580.178.04、X11 的真机上) | +|---|---| +| a | 探针 A(按 mcpp 构建的程序现在的方式运行)与 C(经 `mcpp run`):`libGLX_nvidia.so.0`、`libEGL_nvidia.so.0` 找不到(不是“找到但缺依赖”);**EGL on X11 由 Mesa 提供,50 个窗口配置**;**GLX:`client vendor: (null)`,`glXChooseFBConfig` 0 个配置** | +| b | `check-homes.sh`:`~/.mcpp/registry` 里**没有** `nvidia-gl-host-link`(`~/.xlings` 里有 0.1.3 和 0.1.4 两个版本,与 mcpp 无关) | +| c | C 的环境:`mcpp run` 把 `__EGL_VENDOR_LIBRARY_DIRS`、`LIBGL_DRIVERS_PATH`、`GBM_BACKENDS_PATH` 指向 registry 的 subos,所以**EGL 是封闭的**(总有 Mesa 兜底);GLX 没有对应变量,厂商由 X 服务器决定 | +| d | Slint 的六种运行方式:默认与 `winit-femtovg` **abort**(`glutin: argument does not name a valid config`);`winit-software` 正常;GLX 厂商强制为 mesa(单独,或与 EGL 一起)正常(软件渲染:`failed to load driver: nouveau`) | +| e | 对照实验 1:在项目里加 `[xlings.workspace] "xim:graphics" = "0.1.5"`:registry 里出现 `nvidia-gl-host-link` 0.1.4(驱动记账 580.178.04,25 个链接全有效),glvnd 的 `glx-vendor` 里有 `libGLX_nvidia.so.0`;六种运行方式**全部**窗口正常 | +| f | 对照实验 2:在项目的 `[dependencies]` 里加 `compat.glx-runtime = "2026.09.11"`(`compat.glfw` 的做法):`mcpp run` 正常 | +| g | **静态证据:** 索引里共有 14 个能力名,其中只有 2 个没有任何包 `provides`:`display` 与 `opengl.egl.driver`,**都只由 `compat.slint` 声明**。其余 12 个都有提供者(`opengl.glx.driver`、`x11.display` ← `compat.glx-runtime` 等) | + +g 说明这是一个**能被静态发现的描述符缺陷**:compat.slint 声明了没有人提供的能力,也没有依赖任何提供者。 + +## 2. 三个现象各自的状态 + +| # | 现象 | 状态 | +|---|---|---| +| E1 | `mcpp new --template mcpplibs.mwrap.slint@1.19.0` 报 `constraint '=1.19.0' matches none of: [1.19.0.3, …]` | **与本事无关**:命令行的 `@<版本>` 按前缀读是 mcpp 2026.11.21.1 起的行为(`docs/mwrap.md` 已写),该版本尚未发布;现在用 `@1.19.0.3` 或不写版本 | +| E2 | `Failed to load one of xlib's shared libraries` | **已修**(`xim:slint` revision 1 补了 X11、xcb、xkbcommon、wayland、glvnd 的依赖)。已装的 revision 0 载荷不会被自动刷新,且 compat.slint 里指向它的符号链接在删载荷后悬空;恢复路径:同时删 `~/.mcpp/xpkgs/compat-x-slint` 与对应的构建缓存,再 `mcpp run`(已在隔离环境验证) | +| E3 | `glutin: argument does not name a valid config`(本文的主体) | **根因已定位,修复未做**(§4) | + +## 3. 被推翻的分析与教训 + +v1 的判断是:xim 的 `nvidia-gl-host-link` 在安装时按驱动版本快照了宿主驱动库的符号链接,宿主升级驱动后悬空;mcpp 的私有 registry 与全局 xlings 各存一份、互相漂移;方案是按驱动版本生成并共享状态。**这个判断对你的机器不成立。** 错在哪里: + +1. **我把沙箱的状态当成了你机器的状态。** 我的会话把 `/home` 绑定到 `~/.xlings/subos/speak-agent-private/home`,我读到的 `~/.mcpp` 是那里的私有 registry:它确实有一份 0.1.3 且 22 条链接悬空。你的真实 `~/.mcpp/registry` 里根本没有这个包。教训:**关于用户机器状态的断言,必须来自用户运行的输出**;我看到的 `~` 不是用户的 `~`。 +2. **我的探针有错误。** 探针向 GLX 要 stencil 位时用了 `0x1A`,应为 13(`0xD`):NVIDIA 对未知属性返回空,Mesa 忽略,所以第一次运行里 B 的 GLX“0 个配置”是假象。已修正。 +3. **把一个真实存在的相邻问题当成了原因。** 过期的 host-link 确实存在(`~/.xlings` 里的 0.1.3,以及 `chatgpt-e2e`、`verify-0930` 等 subos 里各 24 条悬空),但与这次崩溃无关(§7)。 +4. **“为什么只有 Slint”曾被我误答成“其他程序也会走同一批过期链接”。** 实际是其他程序**声明了提供者**,Slint 没有。 + +## 4. 修复方案 + +| # | 决策 | 理由 | +|---|---|---| +| D1 | `compat.slint` 在 Linux 上**依赖 `compat.glx-runtime`**,写法同 `compat.glfw`(放在 `mcpp` 表的 `linux` 段的 `deps` 里) | 复用已有的、被 glfw 验证过的提供者约定(实验 f);比直接依赖 `xim:graphics` 更符合现有约定,也不会让只用 `slint-compiler` 的使用者装上 35 个图形包 | +| D2 | `compat.slint` 的能力声明补上 `x11.display`、`opengl.glx.driver`(这是 `compat.glx-runtime` 提供的名字),`dlopen_libs` 补 `libGLX.so.0`;原有的 `display`、`opengl.egl.driver` **暂时保留** | Slint 在 X11 上实际走的是 GLX。保留原名是因为已发布且被打包逻辑读取(#867:声明宿主能力的程序不能用 `--mode self-contained`);是否去掉要实测(U3) | +| D3 | **不改 `xim:slint`** | 它也被当纯工具用(`slint-compiler`),不应背上 GL 提供者;它的 revision 1 注释只描述窗口系统库,不动 | +| D4 | 新增 lint:**一个包声明的能力,必须有它的某个依赖 `provides` 它**(先作警告,扫描一遍现状后再定是否转为失败) | 静态证据 g:现在整个索引只有 compat.slint 的两个能力违反,零误报;这个缺陷类型以后能在 CI 里被发现,不需要等到用户的桌面上 | +| D5 | 验证以**真机检查**为准,CI 只覆盖能自动做的(§5) | GPU 与真窗口没法在 CI 里验证,不假装覆盖了 | +| D6 | 把探针目录整理成 slint-m 里的自检工具(`tools/check_display/`)并在文档里说明 | 这次排查里它几分钟就定位了问题,使用者遇到类似现象可以自己跑 | +| D7 | 已关闭的 mcpp issue 不再另开新的;留给 mcpp 维护者的两点只记在本文 §7 | 维护者的要求 | + +**Wayland 上的 EGL 路径:** 索引里没有任何包提供 `opengl.egl.driver`(静态证据 g)。本方案不处理 Wayland,也没有验证;记为缺口 G1(§8)。 + +## 5. 以 Slint 为金丝雀的验证 + +| 项 | 内容 | 在哪里跑 | 修复前 | 期望(修复后) | +|---|---|---|---|---| +| V1 | 无头 hello(GLOBAL 与 CN 冷装,现有) | CI + 验收脚本 | 通过 | 不变 | +| V2 | **能力有提供者**的静态检查(D4) | CI,lint | compat.slint 的 2 个违反 | compat.slint 的 `x11.display`、`opengl.glx.driver` 不再被报;因 D2 保留的 `display`、`opengl.egl.driver` 仍是 2 条警告(G1);另新发现 compat.sdl2(G2) | +| V3 | 候选索引构建:`tests/mwrap/slint-ui` 与冷装验收 | CI | 通过 | 通过(确认新依赖在三个平台上解析、构建;glx-runtime 只在 Linux) | +| V4 | 真机:**不加任何项目级的图形依赖**,`mcpp new` 后 `mcpp run` | 维护者的 NVIDIA 桌面 | abort | 窗口起来 | +| V5 | 真机:`slint-variants.sh` 六种运行方式 | 同上 | 默认与 `femtovg` abort | 全部起来 | +| V6 | 真机:探针 A/C:`libGLX_nvidia.so.0` 为 `loaded`,GLX 厂商为 NVIDIA 且配置数 > 0 | 同上 | `(null)`、0 | 通过,说明走的是 GPU | +| V7 | 软件 X 服务器上同样六种方式 | 我的沙箱(已有 `:99`)/ CI(需要 X 服务器包,U1) | 通过 | 通过(不回归) | +| V8 | 已装旧版 compat.slint 的机器在升级后是否按新依赖重新解析 | 维护者机器 | — | 不需要手动删缓存(U2) | + +验收口径:V1–V3 进 CI;V4–V6 在维护者机器上跑,结果写进 PR;V7 若 CI 能提供 X 服务器就进 CI。 + +## 6. 实施计划与任务关系 + +| 任务 | 仓库 | 内容 | 前置 | 验收 | +|---|---|---|---|---| +| **T0** | mcpp-index | 本文评审,决定 §9 | — | 确认 | +| **T1** | mcpp-index | `pkgs/c/compat.slint.lua`:`mcpp.linux` 段加 `deps = { ["compat.glx-runtime"] = "2026.09.11" }`;能力与 `dlopen_libs` 按 D2;更正该文件里“xim:slint declares the packages…”的注释;CHANGELOG | T0 | V2、V3 通过;V4–V6 在真机通过;老版本的已发布行不变 | +| **T2** | mcpp-index | `tests/check_capability_providers.lua`(D4)及正反例测试,接入 `validate.yml` 的 lint;先作警告 | T0 | 对现状报 compat.slint 的两项;T1 合入后 compat.slint 只剩按 D2 保留的两项(`display`、`opengl.egl.driver`),不会归零;反例被报告 | +| **T3** | slint-m | `docs/usage.md`、README 中英文:真窗口的前提、GL 提供者由 compat.slint 带入、NVIDIA 与 `SLINT_BACKEND` 开关;`tools/check_display/`(探针与三个脚本,D6) | T1 | 文档合入;脚本在真机上能跑 | +| **T4** | 真机 | V4、V5、V6、V8 的结果贴在 T1、T3 的 PR 里 | T1 | §5 的真机项全绿 | + +``` +T0 评审 + ├─► T1 mcpp-index: compat.slint 依赖与能力 ──► T3 slint-m: 文档 + check_display ──► T4 真机验证 + └─► T2 mcpp-index: 能力提供者 lint(警告) (与 T1 互不依赖;T1 合入后 compat.slint 的 GLX 一项消失,D2 保留的两项仍报警告) +``` + +- 每个仓库尽量单 PR,CI 通过后 squash 合入;T1 不需要发 slint-m 的新版本(compat.slint 是索引里的描述符,不在 slint-m 的归档里)。 +- 不需要改 `xim-pkgindex`、`xlings`、`mcpp`。 + +## 7. 独立且不阻塞的事项 + +**7.1 过期的 `nvidia-gl-host-link`(与这次崩溃无关,但真实存在)。** 现状:`~/.xlings` 里 0.1.3(550.144.03,23 个链接,24 个悬空)与 0.1.4(580.178.04,正常)并存;`chatgpt-e2e`、`verify-0930` 等 subos 里各有 24 条悬空链接。这是 xlings 图形栈设计文档里记录的已知失效模式(驱动升级后链接悬空)。v1 设计过一套按驱动版本生成、稳定的 `current` 入口、使用点检查的机制,并且已验证“按当前驱动版本 glob 宿主库生成目录”这一核心做法在你机器上可行(探针 B 第 3 部分:NVIDIA 的 EGL 配置 64 个)。**不在本方案内做**;如果 xim-pkgindex / xlings 的维护者想做,v1 的设计思路可作参考,由他们决定。 + +**7.2 留给 mcpp 维护者的两点(已不再作为 issue,仅记录)。** +1. **没有提供者的能力在解析期和运行期都没有任何提示。** 这次的缺陷本可以在两处被发现:声明的能力在依赖图里没有提供者;或者在目标自己的加载器下验证声明的 `runtime.dlopen_libs` 是否能解析(我的探针就是这么做的)。 +2. **同版本号下 xim 载荷的 revision 变化不会被刷新,依赖它的 compat 包在载荷被删后留下悬空链接**(E2)。 + +## 8. 风险与未验证项 + +| # | 项 | 状态 / 处理 | +|---|---|---| +| U1 | CI 里是否有可用的 X 服务器包(Xvfb 或同类);我的沙箱里有一个软件 X 服务器 `:99`,来源没有查 | T3 前确认;没有则 V7 只在本机跑 | +| U2 | compat.slint 的**描述符**改了依赖后,已经装过 compat.slint 的机器是否会按新依赖重新解析(`mcpp` 表的改动不在版本行里,审计不要求 revision,但缓存是否跟随没有实测) | V8;若不跟随,评估是否给 1.19.0 行加 `revision` | +| U3 | 去掉 `display`、`opengl.egl.driver` 是否影响打包逻辑(#867 的行为) | 先保留;用 `check_installed_template.py --deploy` 验证后再决定 | +| U4 | glutin 在 X11 上 GLX 优先、EGL 兜底的顺序,是我凭记忆说的,没有对照源码 | 不影响修复(实验 e、f 已证明依赖到位后可行) | +| U5 | 加了 `compat.glx-runtime` 后,渲染是否走 GPU:窗口起来了,但 `GL_RENDERER` 没有打印 | V6 | +| U6 | `compat.glx-runtime` 只在 Linux 上存在;macOS、Windows 的 compat.slint 路径不受影响,应在候选 CI 里确认 | V3 | +| U7 | 本文假设维护者的 NVIDIA 桌面是 X11 会话(`XDG_SESSION_TYPE=x11`);Wayland 会话没有测 | G1 | + +**G1(缺口):** 索引里没有任何包提供 `opengl.egl.driver`(也没有 `display`);Slint 在 Wayland 上的 GL 路径没有提供者,也没有验证。D2 保留这两个名字,因此 lint 对 compat.slint 仍有 2 条警告,这是已知并接受的。 + +**G2(新发现):** lint 首次运行就报出 `compat.sdl2` 声明了 `x11.display` 却不依赖任何提供者(`compat.glx-runtime` 提供)。形态与 compat.slint 相同,但没有在真机上复现过,本次**不改** compat.sdl2;需要在 NVIDIA 桌面上用 SDL2 程序确认后另行处理。 + +## 9. 决定与执行记录 + +**已决定:** Q1 依赖 `compat.glx-runtime`(与 compat.glfw 一致);Q2 保留 `display`、`opengl.egl.driver`;Q3 lint 先作警告;Q4 探针进 slint-m `tools/check_display/`;Q5 向 xlings 提一个 issue 说明过期 host-link 的隐患(§7.1),不在本方案内修。 + +**执行(mcpp-index 单 PR):** +- `pkgs/c/compat.slint.lua`:`linux.deps` 加 `compat.glx-runtime`;`dlopen_libs` 加 `libGLX.so.0`;`capabilities` 加 `x11.display`、`opengl.glx.driver`;头部与 linux 注释更正(libglvnd 只是分发器,厂商库来自 glx-runtime)。 +- `tests/check_capability_providers.lua` + `tests/test_check_capability_providers.py`(8 个用例);`validate.yml` 的 lint 前加一步,警告模式;`--strict` 可转失败。 +- 本地验证(候选索引):`tests/mwrap/slint-ui`、`tests/mwrap/slint-rule` 通过;冷装模板验收通过(含打包、relocated bundle)。 +- 真机项 V4–V6、V8 由维护者在 NVIDIA 桌面上跑,结果记在 PR 里;U2(旧机器是否按新依赖重新解析)、U3(去掉能力名对打包的影响)依然未验证。 diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index 4812889e..9b2dccdc 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -478,6 +478,11 @@ jobs: - name: Build-plugin lints (tests of tests/check_mplugin_layout.lua and check_reserved_namespace.lua) run: python3 tests/test_check_mplugin.py + - name: Capability providers (a declared capability has a provider the package depends on; warnings) + run: | + python3 tests/test_check_capability_providers.py + lua5.4 tests/check_capability_providers.lua pkgs/*/*.lua + - name: Lint package descriptors run: | fail=0 diff --git a/CHANGELOG.md b/CHANGELOG.md index 9cfdb5e3..f49d71dc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,8 @@ ### Added +- **compat.slint 依赖 compat.glx-runtime(Linux),声明 GLX 的能力:修复 NVIDIA 桌面上真窗口 abort。** compat.slint 依赖 libglvnd(GL 分发器),却没有依赖任何 GL 厂商的提供者;`compat.glfw`(经 compat.glx-runtime)、compat.libgbm、godot 等都依赖 `xim:graphics`(mesa、nvidia-gl-host-link、glvnd 的 glx-vendor 布线),Slint 没有。NVIDIA 的 X 服务器要求 GLX 厂商是 NVIDIA,glvnd 找不到 `libGLX_nvidia.so.0`,`glXChooseFBConfig` 返回 0 个配置,glutin 报 “argument does not name a valid config”,femtovg 没有回退,程序 abort;无头与软件渲染不受影响。现在 Linux 上 compat.slint 依赖 `compat.glx-runtime` 2026.09.11(与 compat.glfw 同写法),`runtime.capabilities` 补 `x11.display`、`opengl.glx.driver`,`dlopen_libs` 补 `libGLX.so.0`。在 NVIDIA 580.178.04、X11 的真机上,项目只加这一个依赖时 `mcpp run` 即可运行。原有的 `display`、`opengl.egl.driver` 暂时保留(没有任何包提供它们,Wayland 上的 EGL 路径没有提供者,也未验证)。 +- **新 lint:声明的能力必须有它依赖的包提供(`tests/check_capability_providers.lua`,警告,`--strict` 才失败)。** 索引里 14 个能力名中,当时只有 compat.slint 的 `display` 与 `opengl.egl.driver` 没有任何包提供;lint 同时报告 compat.sdl2 声明了 `x11.display` 却不依赖提供它的 compat.glx-runtime(未处理,需要在真机上确认 SDL2 的路径)。接入 `validate.yml`,测试在 `tests/test_check_capability_providers.py`。方案与证据见 `.agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md`。 - **官方的 mcpp.plugins 与 mcpp.platforms 搬进 `pkgs/mcpp/`**(纯重命名,文件名不变,已发布的行字节不变;构建插件规范 docs/build-plugins.md 的布局)。成员选择按身份匹配,搬迁前后选出的成员集合一致(`tests/select_members.py`);客户端按描述符声明的身份扫描 `pkgs` 的子目录,与 `pkgs/mwrap/` 相同。 - **构建插件的命名与布局规范(docs/build-plugins.md)与第一个新形态的包 mcpplibs.mplugin.slint 1.19.0。** 构建插件的 id 是 `.mplugin.`,模块名与 C++ 命名空间就是这个 id(`mcpplibs.mplugin.slint`、`mcpplibs::mplugin::slint`),`mcpp.*` 保留给官方;`mplugin` 是种类段,如同封装包的 `mwrap`,所以引擎不被遮蔽,规则代码直接写 `mcpp::…`,在 CI 固定的 mcpp(2026.11.18.1)上实测零警告。描述符放在新目录 `pkgs/mcpp/`(完整 id 作文件名;目录是 mcpp 自己加载的包,身份仍以描述符声明为准)。新增 lint:`tests/check_mplugin_layout.lua`(`.mplugin` ↔ `pkgs/mcpp/`,owner 与 name 是标识符);`check_reserved_namespace.lua` 另拒绝 owner 为 `mcpp`、保留名、`platforms` 与种类段(`tests/test_check_mplugin.py`)。`mcpplibs.mplugin.slint@1.19.0` 的归档是 slint-m 的 `mwrap-1.19.0.3`(同一字节、GLOBAL 与 CN),规则版本与封装包修订脱钩;`mcpplibs.mwrap.slint@1.19.0.3` 把规则 reexport,使用方仍只依赖封装包。成员 tests/mwrap/slint-rule 只测 build.mcpp 对该描述符的解析与规则运行(构建包与库包分开测)。设计与实施计划见 `.agents/docs/2026-11-21-mcpp-build-plugin-naming-plan.md`。 - **mcpplibs.slintgen 冻结:** 被 mcpplibs.mplugin.slint 取代;1.19.0.1 与 1.19.0.2 的行与归档保持原样、仍可使用,不再有新版本,描述写明 FROZEN。写了老 id 的工程改依赖名即可迁移;只依赖封装包的工程不受影响。 diff --git a/pkgs/c/compat.slint.lua b/pkgs/c/compat.slint.lua index cb0d3905..4564a539 100644 --- a/pkgs/c/compat.slint.lua +++ b/pkgs/c/compat.slint.lua @@ -25,7 +25,8 @@ -- The headers state them (SLINT_FEATURE_* in private/slint_generated_public.h), -- and a consumer needs no define. Built so, libslint_cpp NEEDs fontconfig and -- the C runtime only — X11, Wayland and GL are dlopen()ed — and xim:slint --- declares xim:fontconfig, so the program's run-time closure is the ecosystem's. +-- declares xim:fontconfig and the windowing libraries, so the program's run-time +-- closure is the ecosystem's; on Linux the GL vendors come from compat.glx-runtime. -- Other feature sets (Skia, LinuxKMS) are later payloads of the same recipe; -- this version names none. -- @@ -96,18 +97,33 @@ int mcpp_compat_slint_anchor() { return 0; } -- libslint_cpp dlopen()s its windowing and GL libraries (the sonames -- its winit and femtovg backends name, read from the library itself); - -- they are required at run time, and xim:slint declares the packages - -- that provide them, so its DT_RUNPATH reaches them. - linux = { runtime = { + -- they are required at run time. xim:slint declares the packages that + -- provide the windowing libraries (X11, xcb, xkbcommon, wayland) and + -- libglvnd, so its DT_RUNPATH reaches them. + -- + -- libglvnd is only the GL DISPATCHER. The GL VENDOR it dispatches to + -- (Mesa, or the host's NVIDIA driver through nvidia-gl-host-link, wired + -- into glvnd's glx-vendor directory) comes from the graphics bundle, and + -- that is what compat.glx-runtime depends on, as compat.glfw does. On an + -- NVIDIA X server the GLX vendor is NVIDIA's: without a provider glvnd + -- finds no vendor, glXChooseFBConfig gives no configuration and the + -- program aborts with "argument does not name a valid config" (femtovg + -- has no fallback). The capabilities below are the names compat.glx-runtime + -- provides (`x11.display`, `opengl.glx.driver`); `display` and + -- `opengl.egl.driver` were declared first and no package provides them + -- (tests/check_capability_providers.lua says so), so they are kept for the + -- reading of the packaging logic and are not satisfied by anything. + -- The Wayland EGL path has no provider yet and is not covered. + linux = { deps = { ["compat.glx-runtime"] = "2026.09.11" }, runtime = { libraries = { "slint_cpp" }, link_library_dirs = { "mcpp_generated/slint/lib" }, runtime_search_dirs = { "mcpp_generated/slint/lib" }, dlopen_libs = { "libX11.so.6", "libX11-xcb.so.1", "libxcb.so.1", "libXcursor.so.1", "libXi.so.6", "libXrender.so.1", "libxkbcommon.so.0", "libxkbcommon-x11.so.0", - "libwayland-client.so.0", "libwayland-egl.so.1", "libEGL.so.1", "libGL.so.1", + "libwayland-client.so.0", "libwayland-egl.so.1", "libEGL.so.1", "libGL.so.1", "libGLX.so.0", }, - capabilities = { "display", "opengl.egl.driver" }, + capabilities = { "display", "opengl.egl.driver", "x11.display", "opengl.glx.driver" }, } }, macosx = { ldflags = { "-Wl,-rpath,@loader_path" }, runtime = { libraries = { "slint_cpp" }, diff --git a/tests/check_capability_providers.lua b/tests/check_capability_providers.lua new file mode 100644 index 00000000..4e3e6ef5 --- /dev/null +++ b/tests/check_capability_providers.lua @@ -0,0 +1,123 @@ +-- Lint: a capability a package declares has a provider the package depends on. +-- +-- A package says what its program needs from the machine at run time with +-- `runtime.capabilities` (`opengl.glx.driver`, `x11.display`, `vulkan.icd.driver`, ...). +-- A package that supplies one says so with `provides`, and the consumer lists it in `deps` +-- (compat.glfw depends on compat.glx-runtime, which provides the two GL ones). Nothing +-- connects the two spellings: a capability nobody provides, or one whose provider the package +-- does not depend on, is not an error anywhere. The program builds, and only on a machine +-- where the host does not happen to supply the thing does it fail, far from the cause. +-- compat.slint declared `display` and `opengl.egl.driver`, which no package provides, and +-- depended on no GL provider: on an NVIDIA X server GLX had no vendor and the program aborted +-- (.agents/docs/2026-11-22-host-driver-link-and-display-path-plan.md). +-- +-- Two findings, per declared capability of a package P: +-- * nobody provides it, anywhere in the index; +-- * somebody does, but no package P depends on (directly or through other packages) does. +-- A package that provides a capability itself satisfies it. +-- +-- A finding is a warning (exit 0); `--strict` makes any finding a failure. +-- +-- Usage: lua5.4 tests/check_capability_providers.lua [--strict] pkgs/*/*.lua + +function import(...) + return setmetatable({}, {__index = function() return function() end end}) +end + +local strict, files = false, {} +for i = 1, #arg do + if arg[i] == "--strict" then strict = true else files[#files + 1] = arg[i] end +end +if #files == 0 then + io.stderr:write("usage: check_capability_providers.lua [--strict] ...\n") + os.exit(2) +end + +-- Everything under `package.mcpp` (platform sections included): capabilities, provides, deps. +local function collect(node, acc) + if type(node) ~= "table" then return end + if type(node.capabilities) == "table" then + for _, c in ipairs(node.capabilities) do if type(c) == "string" then acc.caps[c] = true end end + end + if type(node.provides) == "table" then + for _, c in ipairs(node.provides) do if type(c) == "string" then acc.provides[c] = true end end + end + if type(node.deps) == "table" then + for k, v in pairs(node.deps) do + local spelled = type(k) == "string" and k or v + if type(spelled) == "string" then acc.deps[(spelled:gsub("@.*$", ""))] = true end + end + end + for k, v in pairs(node) do + if type(v) == "table" and k ~= "capabilities" and k ~= "provides" and k ~= "deps" then collect(v, acc) end + end +end + +local packages = {} -- [id] = {file=, caps=, provides=, deps=} +local providers = {} -- [capability] = { [id] = true } +for _, f in ipairs(files) do + package = nil + local chunk = loadfile(f, "t") + if chunk then + pcall(chunk) + local p = package + if type(p) == "table" and type(p.name) == "string" and type(p.mcpp) == "table" then + local id = (type(p.namespace) == "string" and p.namespace ~= "") and (p.namespace .. "." .. p.name) or p.name + local acc = {file = f, caps = {}, provides = {}, deps = {}} + collect(p.mcpp, acc) + packages[id] = acc + for c in pairs(acc.provides) do + providers[c] = providers[c] or {} + providers[c][id] = true + end + end + end +end + +-- Packages reachable from `id` through `deps` (not including `id`). +local function reachable(id) + local seen, stack = {}, {id} + while #stack > 0 do + local cur = table.remove(stack) + local pk = packages[cur] + if pk then + for dep in pairs(pk.deps) do + if not seen[dep] then seen[dep] = true; stack[#stack + 1] = dep end + end + end + end + return seen +end + +local findings = 0 +local ids = {} +for id in pairs(packages) do ids[#ids + 1] = id end +table.sort(ids) +for _, id in ipairs(ids) do + local pk = packages[id] + local caps = {} + for c in pairs(pk.caps) do caps[#caps + 1] = c end + table.sort(caps) + local reach + for _, c in ipairs(caps) do + local who = providers[c] + if not who then + findings = findings + 1 + print(string.format("::warning file=%s::%s declares the capability '%s' and no package in the index provides it", pk.file, id, c)) + elseif not pk.provides[c] then + reach = reach or reachable(id) + local ok = false + for q in pairs(who) do if reach[q] then ok = true break end end + if not ok then + local names = {} + for q in pairs(who) do names[#names + 1] = q end + table.sort(names) + findings = findings + 1 + print(string.format("::warning file=%s::%s declares the capability '%s' but depends on no package that provides it (%s does)", pk.file, id, c, table.concat(names, ", "))) + end + end + end +end + +if findings == 0 then print("Every declared capability has a provider the package depends on.") end +os.exit((strict and findings > 0) and 1 or 0) diff --git a/tests/test_check_capability_providers.py b/tests/test_check_capability_providers.py new file mode 100644 index 00000000..9eb57c7f --- /dev/null +++ b/tests/test_check_capability_providers.py @@ -0,0 +1,74 @@ +"""tests/check_capability_providers.lua on small descriptors in a temporary tree. + + python3 tests/test_check_capability_providers.py +""" +import subprocess +import tempfile +import unittest +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +def descriptor(name, mcpp, namespace="compat"): + return f'package = {{ spec = "1", namespace = "{namespace}", name = "{name}", type = "package", mcpp = {mcpp} }}\n' + + +def run(files, *flags): + with tempfile.TemporaryDirectory() as tmp: + paths = [] + for name, text in files.items(): + path = Path(tmp) / f"{name}.lua" + path.write_text(text) + paths.append(str(path)) + result = subprocess.run(["lua5.4", str(ROOT / "tests/check_capability_providers.lua"), *flags, *paths], + capture_output=True, text=True) + return result.returncode, result.stdout + + +PROVIDER = descriptor("glx", '{ runtime = { capabilities = { "gl" }, provides = { "gl" } } }') + + +class CapabilityProviders(unittest.TestCase): + def test_a_capability_with_a_provider_the_package_depends_on_is_clean(self): + rc, out = run({"glx": PROVIDER, "app": descriptor("app", '{ deps = { ["compat.glx"] = "1" }, runtime = { capabilities = { "gl" } } }')}) + self.assertEqual(rc, 0) + self.assertNotIn("warning", out) + + def test_a_provider_reached_through_another_package_counts(self): + rc, out = run({"glx": PROVIDER, + "mid": descriptor("mid", '{ deps = { ["compat.glx"] = "1" } }'), + "app": descriptor("app", '{ deps = { ["compat.mid"] = "1" }, runtime = { capabilities = { "gl" } } }')}) + self.assertNotIn("warning", out) + + def test_a_platform_section_is_read(self): + rc, out = run({"glx": PROVIDER, + "app": descriptor("app", '{ linux = { deps = { ["compat.glx"] = "1" }, runtime = { capabilities = { "gl" } } } }')}) + self.assertNotIn("warning", out) + + def test_a_package_that_provides_it_itself_is_clean(self): + rc, out = run({"glx": PROVIDER}) + self.assertNotIn("warning", out) + + def test_a_capability_nobody_provides_is_reported(self): + rc, out = run({"app": descriptor("app", '{ runtime = { capabilities = { "display" } } }')}) + self.assertEqual(rc, 0) + self.assertIn("no package in the index provides it", out) + + def test_a_provider_the_package_does_not_depend_on_is_reported(self): + rc, out = run({"glx": PROVIDER, "app": descriptor("app", '{ runtime = { capabilities = { "gl" } } }')}) + self.assertEqual(rc, 0) + self.assertIn("depends on no package that provides it (compat.glx does)", out) + + def test_strict_turns_a_finding_into_a_failure(self): + rc, _ = run({"app": descriptor("app", '{ runtime = { capabilities = { "display" } } }')}, "--strict") + self.assertEqual(rc, 1) + + def test_a_form_a_descriptor_is_ignored(self): + rc, out = run({"app": 'package = { spec = "1", namespace = "compat", name = "app", type = "package", mcpp = "*/mcpp.toml" }\n'}) + self.assertEqual(rc, 0) + self.assertNotIn("warning", out) + + +if __name__ == "__main__": + unittest.main()