mcpp:plugins 0.3.0 —— 嵌入载荷用 import 到达,以及规则包自带语言 (#367)

一份嵌入载荷现在由 `import` 到达,而不是 include 一个规则挑名字的头文件。
模块根取自 `[package] name`,访问器取自文件的 stem 与 stage,组基准目录以下
的子目录成为命名空间段 —— 于是两个同 stem 的 shader 是两份载荷而不是一次冲突。
工程里没有任何一行写出生成物的名字。

两个新成员:

  rules-slang   Slang 是一门语言而不是 GLSL 的第二个驱动。`.slang` **不在**
                引擎的设备源扩展名表里(任何版本都不在),这个 feature 自己声明
                `device_extensions` 与 `rule_module`,引擎据此路由。这就是整个
                安排的判据:一门新设备语言不需要引擎发版。
  tools-island  生成设备岛的 `extern "C"` 边界 —— 它的编译器读的头文件,和
                C++ 侧 import 的模块,来自标在定义处的声明。把 seam 的两个半边
                都交给它时,两个把同一个名字声明得不一样的定义会被拒绝:两者永不
                同链且 C 链接不做名字修饰,所以那是两份文本唯一同时在场的地方。

文档化的下界移到 2026.9.7.1,也就是读这两个键的那一版。低于它的客户端不会得到
一个降级的表面,而是得到一次「规则从不路由」的构建 —— 文件掉进普通源集,mcpp 说
它对这个扩展名没有角色。

`latest` 的三行是**替换**而不是新增:Lua 表构造器对重复键取最后一次赋值,第二个
`["latest"]` 会让它退回上一版,而每个精确 pin 仍然正确,所以只有不带版本的
`mcpp add` 会拿到旧包。

发布前对着已发布的 2026.9.7.1 二进制跑过四组:模块表面工程、同一个工程但完全没有
`build.mcpp`、一个 `.slang` 工程**以及去掉规则 feature 后同一个文件被拒绝**、
object 存储(字在 `.incbin` 载荷里而不在任何头文件里)。18 条断言,0 失败。

CN 资产与 GitHub 归档逐字节相同,所以一个 sha256 同时命名两边。

Author: Sunrisepeak

pkgs/m/mcpp.plugins.lua

@@ -2,13 +2,47 @@
 -- each member selected by a feature.
 --
 --   [dependencies.mcpp]
---   plugins = { version = "0.2.6", features = ["rules-spirv"], host-module = true }
+--   plugins = { version = "0.3.0", features = ["rules-spirv"], host-module = true }
 --
 --   // build.mcpp
 --   import mcpp;
 --   import mcpp.rules.spirv;
 --
--- Members of 0.2.6, with the mcpp release each relies on:
+-- 0.3.0 is the release in which an embedded payload is reached by IMPORTING a
+-- module rather than by including a header whose name the rule chose. It also
+-- adds two members and the two declarations that let a rule package introduce a
+-- device language on its own. It requires **mcpp 2026.9.7.1**, which is where
+-- those declarations are read.
+--
+--   mcpp.rules.slang  `rules-slang`  >= 2026.9.7.1. Slang is a language rather
+--                                    than a second driver for GLSL -- its own
+--                                    module system, generics, and targets
+--                                    beyond SPIR-V -- so it has its own rule
+--                                    and its own extension. `.slang` is NOT in
+--                                    the engine's built-in table: this feature
+--                                    declares `device_extensions = [".slang"]`
+--                                    and `rule_module = "mcpp.rules.slang"`,
+--                                    and the engine routes it from there. That
+--                                    is the criterion for the whole
+--                                    arrangement -- a new device language costs
+--                                    no engine release
+--   mcpp.tools.island `tools-island` >= 2026.9.7.1. Generates the `extern "C"`
+--                                    boundary a device island is reached
+--                                    across: the header its compiler reads and
+--                                    the module the C++ side imports, from
+--                                    declarations marked where they are
+--                                    defined. Handed both halves of a seam, it
+--                                    refuses two that declare one name
+--                                    differently -- the only check available at
+--                                    a boundary where C linkage does not mangle
+--                                    and the two halves never meet at the link
+--
+-- Every rule that generates a consumer-facing declaration now chooses a module
+-- interface or a header from `[language] modules`, which the engine reports; and
+-- a project that declares its rules needs no `build.mcpp` at all, because mcpp
+-- writes the program those declarations describe.
+--
+-- Members of 0.3.0, with the mcpp release each relies on:
 --
 --   mcpp.rules.cuda   `rules-cuda`   >= 2026.9.5.2
 --   mcpp.rules.spirv  `rules-spirv`  >= 2026.9.5.3; since 0.2.0 it drives glslc
@@ -174,8 +208,13 @@
 -- adds the engine's half -- a device source that reached no action is refused,
 -- naming the file -- but a rule package does not require it to work.
 --
--- The floor is the HIGHEST of those, and from 0.2.4 every member shares one:
--- 2026.9.6.6. It is DOCUMENTATION rather than a gate -- nothing in this
+-- The floor is the HIGHEST of those, and from 0.3.0 every member shares one:
+-- 2026.9.7.1 -- the release that reads `device_extensions` and `rule_module`,
+-- reports `[language] modules` and the package's own name to a build program,
+-- and writes the build program a declared rule set describes. A client below it
+-- does not see a degraded surface, it sees the rules never route: the file falls
+-- through to the ordinary source scan and mcpp says it has no role for the
+-- extension. It is DOCUMENTATION rather than a gate -- nothing in this
 -- descriptor or in the package's manifest records a per-package engine floor,
 -- and the index-level `min_mcpp` is deliberately not raised for a package
 -- (raising it would make the whole index unreadable to clients stopped below
@@ -209,6 +248,13 @@ package = {
 
     xpm = {
         linux = {
+            ["0.3.0"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.3.0.tar.gz",
+                    CN     = "https://gitcode.com/mcpp-res/mcpp-plugins/releases/download/0.3.0/mcpp-plugins-0.3.0.tar.gz",
+                },
+                sha256 = "c4ce00e2b79c43ee4a08a8876a8ab7113f41081895a6036dfede6aa7719d731b",
+            },
             ["0.2.6"] = {
                 url = {
                     GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.2.6.tar.gz",
@@ -272,9 +318,16 @@ package = {
                 },
                 sha256 = "adf1f9d6691a5d05a8a4a94e83c733ea39caee1510ce2c9af4cb23bebabea9f5",
             },
-            ["latest"] = { ref = "0.2.6" },
+            ["latest"] = { ref = "0.3.0" },
         },
         macosx = {
+            ["0.3.0"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.3.0.tar.gz",
+                    CN     = "https://gitcode.com/mcpp-res/mcpp-plugins/releases/download/0.3.0/mcpp-plugins-0.3.0.tar.gz",
+                },
+                sha256 = "c4ce00e2b79c43ee4a08a8876a8ab7113f41081895a6036dfede6aa7719d731b",
+            },
             ["0.2.6"] = {
                 url = {
                     GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.2.6.tar.gz",
@@ -338,9 +391,16 @@ package = {
                 },
                 sha256 = "adf1f9d6691a5d05a8a4a94e83c733ea39caee1510ce2c9af4cb23bebabea9f5",
             },
-            ["latest"] = { ref = "0.2.6" },
+            ["latest"] = { ref = "0.3.0" },
         },
         windows = {
+            ["0.3.0"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.3.0.tar.gz",
+                    CN     = "https://gitcode.com/mcpp-res/mcpp-plugins/releases/download/0.3.0/mcpp-plugins-0.3.0.tar.gz",
+                },
+                sha256 = "c4ce00e2b79c43ee4a08a8876a8ab7113f41081895a6036dfede6aa7719d731b",
+            },
             ["0.2.6"] = {
                 url = {
                     GLOBAL = "https://github.com/mcpp-community/mcpp-plugins/archive/refs/tags/v0.2.6.tar.gz",
@@ -404,7 +464,7 @@ package = {
                 },
                 sha256 = "adf1f9d6691a5d05a8a4a94e83c733ea39caee1510ce2c9af4cb23bebabea9f5",
             },
-            ["latest"] = { ref = "0.2.6" },
+            ["latest"] = { ref = "0.3.0" },
         },
     },