二七王：布局求解器补齐显式失败与运行时注入契约，配置补 runtime/targetKind 声明

求解器（ui/LayoutSolver.js）：
- 按方向校验 anchor：竖排只收 top/bottom/center、横排只收 left/right/center，
  未知 direction 一并拒绝。框架 AlignmentUtils 的 switch 对写错方向的 anchor 落到
  default（居中），笔误会被静默吞掉——ROOM_CATEGORY_COLUMN 就是这么把前两行摆到画布外的。
- grid 校验合并 ctx 后的 cols/rows 必须是数字：缺 rows 时 capacity=NaN 让超载守卫失效、
  循环一次不跑，静默返回空数组（一个矩形都不产出）。
- line/fan/grid 要求 anchorX/anchorY 必须是数字（框架的 anchorY||0 会把缺失变成 0）；
  point 要求 x/y 必须是数字。
- apply() 精灵数与矩形数不等时抛错，不再静默截断：截断会让多余精灵停在上一手牌的旧坐标上。
- 统一运行时注入：ctx 里的 INJECT_KEYS（target/x/y/w/h/anchorX/anchorY/rows/
  itemWidth/itemHeight）覆盖配置同名字段，优先级 ctx > bySeat > base。
- line + items 竖排显式拒绝（只实现了水平）。

配置：
- ROOM_CATEGORY_COLUMN anchor 由 'left' 改为 'top'（竖排语义）。
- ROOM_OPTION_OVERFLOW_GRID 补 rows（runtime）、槽尺寸与 anchor 沿用 ROOM_OPTION_ROW，
  cols 直接引用 ROOM_OPTION_MAX_PER_ROW；ROOM_OPTION_ROW 补上注释里已声明的 itemHeight。
- 所有依赖运行时注入的节点加 runtime 声明，所有 attach 节点加 targetKind
  （sprite / layout / platform），显式区分「忘了写」与「故意延后到运行时」。

守卫（tests/test_constants.js）：
- 求解冒烟改为只对 runtime 声明过的键注入假值，没声明却缺字段的照常抛错变红。
- 补矩形数量断言（line/fan/grid 按项数、point/attach 恒 1）——此前只查数组与坐标类型，
  空数组照样通过，「少画了几张牌」对守卫完全不可见。
- attach.target 改为只在 targetKind 指定的那一个命名空间里校验存在。
- 补 runtime 声明自身的合法性检查与布局节点总数（62）钉死。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

client/js/01_SubGame/codes/config/Layout_Action.js

@@ -21,10 +21,16 @@ EQW_Layout.CALL_BTN_GRID = {
 //档位分数文字：贴对应档位按钮居中。CALL_BTN_1..14 是 14 个固定精灵，但本节点是共用模板，
 //target 由调用方按第几档注入（不预置单一 target）。宽高随数字位数变化，清单未给固定值，
 //资源 NUM_CALL_SCORE 单字位 30×40 仅供参考，不作为本节点的 w/h
-EQW_Layout.CALL_BTN_SCORE_TEXT = { kind: 'attach', hAlign: 'center', vAlign: 'middle', offsetY: 4 };
+EQW_Layout.CALL_BTN_SCORE_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle', offsetY: 4,
+    runtime: ['target', 'w', 'h']
+};
 
 //档位子数角标：贴对应档位按钮右上角，纯文字无底图，清单未给宽高（同上，调用方注入 target）
-EQW_Layout.CALL_BTN_MULTIPLE_BADGE = { kind: 'attach', corner: 'topRight', offsetX: -30, offsetY: 2 };
+EQW_Layout.CALL_BTN_MULTIPLE_BADGE = {
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -30, offsetY: 2,
+    runtime: ['target', 'w', 'h']
+};
 
 EQW_Layout.CALL_BTN_NONE = { kind: 'point', x: 553, y: 345, w: 184, h: 57 };
 
@@ -44,14 +50,23 @@ EQW_Layout.MAIN_SUIT_LINE = {
 };
 
 //花色图标：贴对应花色按钮左侧（资源 SUIT_ICON_L 46×46）。target 由调用方按花色序号注入
-EQW_Layout.MAIN_SUIT_ICON = { kind: 'attach', hAlign: 'left', vAlign: 'middle', offsetX: 14, w: 46, h: 46 };
+EQW_Layout.MAIN_SUIT_ICON = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'left', vAlign: 'middle', offsetX: 14, w: 46, h: 46,
+    runtime: ['target']
+};
 
 //张数大字：贴对应花色按钮居中，纯文字，清单未给宽高（调用方注入 target）
-EQW_Layout.MAIN_SUIT_COUNT_TEXT = { kind: 'attach', hAlign: 'center', vAlign: 'middle', offsetX: 14 };
+EQW_Layout.MAIN_SUIT_COUNT_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle', offsetX: 14,
+    runtime: ['target', 'w', 'h']
+};
 
 //对数角标底：贴对应花色按钮右上角（资源 BADGE_MULTIPLE 帧1 34×18）。
 //角标文字复用同一矩形，不单独配置（调用方注入 target）
-EQW_Layout.MAIN_SUIT_PAIR_BADGE = { kind: 'attach', corner: 'topRight', offsetX: -36, offsetY: 2, w: 34, h: 18 };
+EQW_Layout.MAIN_SUIT_PAIR_BADGE = {
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -36, offsetY: 2, w: 34, h: 18,
+    runtime: ['target']
+};
 
 //===== 埋牌 / 出牌操作条 =====
 

client/js/01_SubGame/codes/config/Layout_Cards.js

@@ -69,7 +69,7 @@ EQW_Layout.PLAY_AREA = {
 //已出牌 · 牌型标签：贴该区第一张牌。首槽是固定精灵（PLAY_SELF_1 / PLAY_LEFT_1 / PLAY_RIGHT_1），非动态目标。
 //资源 LABEL_CARDTYPE 76×24（清单 §3）
 EQW_Layout.PLAY_TYPE_LABEL = {
-    kind: 'attach', corner: 'bottomLeft', offsetX: 0, offsetY: -24, w: 76, h: 24,
+    kind: 'attach', targetKind: 'sprite', corner: 'bottomLeft', offsetX: 0, offsetY: -24, w: 76, h: 24,
     bySeat: {
         SELF:  { target: 'PLAY_SELF_1' },
         LEFT:  { target: 'PLAY_LEFT_1' },
@@ -82,7 +82,8 @@ EQW_Layout.PLAY_TYPE_LABEL = {
 //EQW_LayoutSolver.solve——这是有意的动态目标模式，不在配置里预置 target（清单未给尺寸；
 //两种资源分别是 MARK_BANKER_CORNER 28×28 / MARK_JOKER_BIG 34×34，按实际显示的是哪个徽标取值）
 EQW_Layout.PLAY_CARD_CORNER_MARK = {
-    kind: 'attach', corner: 'topRight', offsetX: -28, offsetY: 0
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -28, offsetY: 0,
+    runtime: ['target', 'w', 'h']
 };
 
 //冲关牌（叠加层）：精灵复制场景（§5.6a），spacingMin 放宽到 -88 以容纳 20+ 张的极端情况。

client/js/01_SubGame/codes/config/Layout_CreateRoom.js

@@ -9,45 +9,70 @@ var EQW_Layout = EQW_Layout || {};
 //两层嵌套：类别竖排（ROOM_CATEGORY_COLUMN）+ 类别内选项槽横排（ROOM_OPTION_ROW）。
 //本节数值按参考图比例估，实际以平台建房界面尺寸为准（清单 §6.9b 原文，不是本文件误差）。
 
-//类别竖排。itemWidth 清单未给——类别行宽度等于平台内容区实际宽度，由调用方按实际面板尺寸处理
+//类别竖排。itemWidth 清单未给——类别行宽度等于平台内容区实际宽度，由调用方按实际面板尺寸注入。
+//anchor 必须是竖排语义的 top/bottom/center：写成水平语义的 'left' 会被框架 switch 的 default
+//当成居中（3 个类别时算出 y=[-56,-16,24]，前两行跑到画布外），求解器现已按方向校验并抛错
 EQW_Layout.ROOM_CATEGORY_COLUMN = {
     kind: 'line', direction: 'vertical', anchorX: 0, anchorY: 0,
-    itemHeight: 32, spacing: 8, anchor: 'left'
+    itemHeight: 32, spacing: 8, anchor: 'top',
+    runtime: ['itemWidth']
 };
 
 //类别标题：贴所在类别行。该行是 ROOM_CATEGORY_COLUMN 求解结果的第 N 项，不是固定精灵，
 //target 由调用方按类别序号注入。资源 ROOM_CAT_TITLE 60×24（清单 §3）
-EQW_Layout.ROOM_CATEGORY_TITLE = { kind: 'attach', hAlign: 'left', vAlign: 'middle', offsetX: 0, w: 60, h: 24 };
+EQW_Layout.ROOM_CATEGORY_TITLE = {
+    kind: 'attach', targetKind: 'layout', hAlign: 'left', vAlign: 'middle', offsetX: 0, w: 60, h: 24,
+    runtime: ['target']
+};
 
 //类别内选项槽横排。anchorY 清单未给（随所在类别行的 y 浮动，由调用方按该行位置注入）；
 //itemHeight 清单未给，沿用 ROOM_CATEGORY_COLUMN.itemHeight（同一行内选择框与文字纵向居中）
 EQW_Layout.ROOM_OPTION_ROW = {
     kind: 'line', direction: 'horizontal', anchorX: 70,
-    itemWidth: 150, spacing: 0, anchor: 'left'
+    itemWidth: 150, itemHeight: EQW_Layout.ROOM_CATEGORY_COLUMN.itemHeight, spacing: 0, anchor: 'left',
+    runtime: ['anchorY']
 };
 
 //选项组之间的额外间隔（同类别下两个选项组之间比组内选项多留的间距）
 EQW_Layout.ROOM_OPTION_GROUP_GAP = 40;
 
 //选择框：贴所在选项槽左侧（资源 ROOM_OPT_BOX 22×22）。target 由调用方按选项槽注入
-EQW_Layout.ROOM_OPTION_BOX = { kind: 'attach', hAlign: 'left', vAlign: 'middle', w: 22, h: 22 };
+//（槽是 ROOM_OPTION_ROW 求解结果的第 N 项，故 targetKind 是 layout 而非精灵键）
+EQW_Layout.ROOM_OPTION_BOX = {
+    kind: 'attach', targetKind: 'layout', hAlign: 'left', vAlign: 'middle', w: 22, h: 22,
+    runtime: ['target']
+};
 
-//选项文字：贴同槽选择框右侧，纯文字，清单未给宽高。
+//选项文字：贴同槽选择框右侧（target 是该槽的 ROOM_BOX_* 精灵，由调用方按选项配置的 box 键注入），
+//纯文字，清单未给宽高，由调用方按渲染出的文案尺寸注入。
 //选中态变橙见 EQW_Layout.TEXT_STYLE.ROOM_OPT（normal / selected 两态，由调用方按选中状态二选一）
-EQW_Layout.ROOM_OPTION_TEXT = { kind: 'attach', hAlign: 'right', vAlign: 'middle', offsetX: 8 };
+EQW_Layout.ROOM_OPTION_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'right', vAlign: 'middle', offsetX: 8,
+    runtime: ['target', 'w', 'h']
+};
 
-//房卡附注：贴扣卡组最后一个选项（固定精灵 ROOM_BOX_CARD_2）右侧
+//房卡附注：贴扣卡组最后一个选项（固定精灵 ROOM_BOX_CARD_2）右侧。纯文字，宽高随文案运行时注入
 EQW_Layout.ROOM_CARD_COST_NOTE = {
-    kind: 'attach', target: 'ROOM_BOX_CARD_2', hAlign: 'right', vAlign: 'middle', offsetX: 20,
-    textStyle: EQW_Layout.TEXT_STYLE.ROOM_CARD_COST_NOTE
+    kind: 'attach', targetKind: 'sprite', target: 'ROOM_BOX_CARD_2',
+    hAlign: 'right', vAlign: 'middle', offsetX: 20,
+    textStyle: EQW_Layout.TEXT_STYLE.ROOM_CARD_COST_NOTE,
+    runtime: ['w', 'h']
 };
 
 //折行：选项数超过 maxPerRow 时改用 grid。二七王每组最多 2 项，不会触发（清单 §6.9b 原文）；
 //清单原文是 grid{cols:maxPerRow, spacingX:0, spacingY:8, fillOrder:'row'}，cols 直接取自 maxPerRow，
-//故与 spacingX/spacingY/fillOrder 一并记为已定的四个字段；itemWidth / itemHeight / anchorX / anchorY
-//清单未给（该分支未被实际使用）
+//故与 spacingX/spacingY/fillOrder 一并记为已定的四个字段。
+//rows 由实际选项数决定（ceil(选项数 / cols)），anchorX/anchorY 随所在类别行浮动 —— 三者都是运行时值，
+//在 runtime 里显式声明；缺 rows 时求解器会抛错，不再静默返回空数组（一个矩形都不产出）。
+//itemWidth / itemHeight 清单同样未给：折行摆的还是同一批选项槽，沿用 ROOM_OPTION_ROW 的槽尺寸，
+//不另编一套数值；anchor 同理沿用 ROOM_OPTION_ROW 的 'left'（折行前后左边缘对齐一致）
 EQW_Layout.ROOM_OPTION_MAX_PER_ROW = 4;
-EQW_Layout.ROOM_OPTION_OVERFLOW_GRID = { kind: 'grid', cols: 4, spacingX: 0, spacingY: 8, fillOrder: 'row' };
+EQW_Layout.ROOM_OPTION_OVERFLOW_GRID = {
+    kind: 'grid', cols: EQW_Layout.ROOM_OPTION_MAX_PER_ROW, spacingX: 0, spacingY: 8, fillOrder: 'row',
+    itemWidth: EQW_Layout.ROOM_OPTION_ROW.itemWidth, itemHeight: EQW_Layout.ROOM_OPTION_ROW.itemHeight,
+    anchor: 'left',
+    runtime: ['rows', 'anchorX', 'anchorY']
+};
 
 ///////////////////////////////////////////////////////////////
 ////////// EQW_RoomOptions: 建房规则选项配置（清单 §1.1）///////

client/js/01_SubGame/codes/config/Layout_Result.js

@@ -9,7 +9,9 @@ EQW_Layout.RESULT_BOTTOM_PANEL = { kind: 'point', x: 430, y: 140, w: 420, h: 148
 
 //底牌说明文字：贴面板底部，纯文字，清单未给宽高
 EQW_Layout.RESULT_BOTTOM_TEXT = {
-    kind: 'attach', target: 'RESULT_BOTTOM_PANEL', hAlign: 'center', vAlign: 'bottom', offsetY: -14
+    kind: 'attach', targetKind: 'layout', target: 'RESULT_BOTTOM_PANEL',
+    hAlign: 'center', vAlign: 'bottom', offsetY: -14,
+    runtime: ['w', 'h']
 };
 
 //三家分数光晕
@@ -24,7 +26,8 @@ EQW_Layout.RESULT_GLOW = {
 
 //三家总分大字：贴对应光晕居中。target 直接指向光晕精灵键（固定，非动态）
 EQW_Layout.RESULT_SCORE_TEXT = {
-    kind: 'attach', hAlign: 'center', vAlign: 'middle', textStyle: EQW_Layout.TEXT_STYLE.SCORE_BIG,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle',
+    textStyle: EQW_Layout.TEXT_STYLE.SCORE_BIG, runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },
@@ -34,7 +37,8 @@ EQW_Layout.RESULT_SCORE_TEXT = {
 
 //三家『牌局分』：贴对应光晕左下
 EQW_Layout.RESULT_JF_TEXT = {
-    kind: 'attach', hAlign: 'left', vAlign: 'bottom', offsetX: -15, offsetY: 24,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'left', vAlign: 'bottom', offsetX: -15, offsetY: 24,
+    runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },
@@ -44,7 +48,8 @@ EQW_Layout.RESULT_JF_TEXT = {
 
 //三家『冲关分』：贴对应光晕右下
 EQW_Layout.RESULT_AW_TEXT = {
-    kind: 'attach', hAlign: 'right', vAlign: 'bottom', offsetX: 15, offsetY: 24,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'right', vAlign: 'bottom', offsetX: 15, offsetY: 24,
+    runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },

client/js/01_SubGame/codes/config/Layout_Table.js

@@ -12,19 +12,28 @@ EQW_Layout.TOP_INFO_BG = { kind: 'point', x: 486, y: 4, w: 276, h: 68 };
 
 //顶部 · 花色图标：贴信息条内部左下角（资源 SUIT_ICON_S 30×30，清单 §3）
 EQW_Layout.TOP_SUIT_ICON = {
-    kind: 'attach', target: 'TOP_INFO_BG',
+    kind: 'attach', targetKind: 'layout', target: 'TOP_INFO_BG',
     hAlign: 'left', vAlign: 'bottom', offsetX: 20, offsetY: -8, w: 30, h: 30
 };
 
+//顶部 · 叫分数值文字 / 抓分数值文字：【清单 §6.5 未给出位置】——那张表只列了两个角标底与角标
+//文字，而角标底又必须贴在这两段数值文字身上。此处显式占位：坐标与宽高全部标为运行时注入，
+//由调用方按信息条内的三列表格实际排布给出；设计稿补齐后把 x/y/w/h 回填成固定值即可。
+//显式占位是为了避免 C 阶段在渲染代码里就地硬编码一组坐标——那样这两处位置就再也无从统一修改
+EQW_Layout.TOP_CALL_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
+EQW_Layout.TOP_GRADE_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
+
 //顶部 · 叫分角标底：贴叫分数值文字右上角（资源 BADGE_MULTIPLE 帧1 34×18）。
 //角标数值文字复用同一矩形，不单独配置（清单未给独立位置，下同）
 EQW_Layout.TOP_CALL_BADGE_BG = {
-    kind: 'attach', target: 'TOP_CALL_TEXT', corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
+    kind: 'attach', targetKind: 'layout', target: 'TOP_CALL_TEXT',
+    corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
 };
 
 //顶部 · 抓分角标底：贴抓分数值文字右上角（资源 BADGE_MULTIPLE 帧2 34×18）
 EQW_Layout.TOP_GRADE_BADGE_BG = {
-    kind: 'attach', target: 'TOP_GRADE_TEXT', corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
+    kind: 'attach', targetKind: 'layout', target: 'TOP_GRADE_TEXT',
+    corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
 };
 
 //亮牌信息条
@@ -81,7 +90,7 @@ EQW_Layout.PLAYER_AVATAR_FRAME_REF = {
 //会合并包括 kind 在内的所有字段，这里利用该机制表达「底栏庄标是固定坐标、不贴附任何目标」，
 //与 LEFT/RIGHT 两个上家贴头像框（attach）是不同的定位方式，不是笔误
 EQW_Layout.P_BANKER_MARK = {
-    kind: 'attach', w: 40, h: 40,
+    kind: 'attach', targetKind: 'platform', w: 40, h: 40,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR',  corner: 'topRight', offsetX: 7,   offsetY: 8 },
         RIGHT: { target: 'P_RIGHT_AVATAR', corner: 'topLeft',  offsetX: -40, offsetY: 8 },
@@ -91,7 +100,7 @@ EQW_Layout.P_BANKER_MARK = {
 
 //『主N』角标底：仅左右两家（自己主/对数已在手牌区可见，无此角标）。w/h 为清单 §6.6 实测值
 EQW_Layout.P_ZHU_BADGE = {
-    kind: 'attach', corner: 'bottomLeft', offsetX: 0, offsetY: 6, w: 40, h: 19,
+    kind: 'attach', targetKind: 'platform', corner: 'bottomLeft', offsetX: 0, offsetY: 6, w: 40, h: 19,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR' },
         RIGHT: { target: 'P_RIGHT_AVATAR' }
@@ -101,7 +110,7 @@ EQW_Layout.P_ZHU_BADGE = {
 //『对N』角标底：贴主N角标右侧。w/h 清单未重复给出，沿用主N角标同尺寸
 //（同资源 BADGE_ZHU_PAIR 的另一帧，帧1黄底=主N、帧2白底=对N，尺寸一致）
 EQW_Layout.P_PAIR_BADGE = {
-    kind: 'attach', target: 'P_ZHU_BADGE', hAlign: 'right', vAlign: 'middle',
+    kind: 'attach', targetKind: 'layout', target: 'P_ZHU_BADGE', hAlign: 'right', vAlign: 'middle',
     offsetX: 44, offsetY: 0, w: 40, h: 19
 };
 
@@ -127,7 +136,7 @@ EQW_Layout.P_COUNTDOWN = {
 //提示气泡（踩/没分/有分）：朝向 arrowRight 是配置项，不按座位硬判（清单 §6.6）。
 //w/h 清单 §3 标『待定』，此处用示意尺寸占位，资源定稿后回填（不影响 kind/字段结构）
 EQW_Layout.TISHI_BUBBLE = {
-    kind: 'attach', w: 96, h: 44,
+    kind: 'attach', targetKind: 'platform', w: 96, h: 44,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR',  hAlign: 'right', vAlign: 'middle', offsetX: 10,  arrowRight: false },
         RIGHT: { target: 'P_RIGHT_AVATAR', hAlign: 'left',  vAlign: 'middle', offsetX: -10, arrowRight: true },