cardbuddy 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/dist/init.js +0 -2
  2. package/dist/preview-editor/assets/index-CXDf5tVg.css +1 -0
  3. package/dist/preview-editor/assets/{index-CIIfMlwI.js → index-DLQkCPLT.js} +113 -86
  4. package/dist/preview-editor/index.html +2 -2
  5. package/dist/vendored/card-editor/runtime/adapter.js +2 -2
  6. package/dist/vendored/mcp/client.mjs +1 -1
  7. package/dist/vendored/server/core/ai-chat.js +251 -80
  8. package/dist/vendored/server/core/browser.js +17 -0
  9. package/dist/vendored/server/core/cardFiles.js +49 -1
  10. package/dist/vendored/server/core/cardImage.js +103 -2
  11. package/dist/vendored/server/core/cardValidate.js +16 -5
  12. package/dist/vendored/server/core/screenshot.js +94 -0
  13. package/dist/vendored/skills/card-skill-trainer/SKILL.md +68 -13
  14. package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +14 -82
  15. package/dist/vendored/skills/card-skill-trainer/scripts/lib/diagnosis.mjs +207 -0
  16. package/dist/vendored/skills/card-skill-trainer/scripts/lib/layout-correction-sim.mjs +62 -0
  17. package/dist/vendored/skills/card-skill-trainer/scripts/lib/paradigm-router.mjs +76 -0
  18. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker-runner.mjs +31 -0
  19. package/dist/vendored/skills/card-skill-trainer/scripts/lib/pixel-worker.mjs +138 -0
  20. package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +24 -20
  21. package/dist/vendored/skills/card-skill-trainer/scripts/lib/telemetry.mjs +46 -0
  22. package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs +5 -2
  23. package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +286 -92
  24. package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +74 -2
  25. package/dist/vendored/skills/card-skill-trainer/scripts/sink_rules.mjs +127 -0
  26. package/dist/vendored/skills/dsl-card-generator/SKILL.md +93 -27
  27. package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +14 -0
  28. package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +1 -15
  29. package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +11 -20
  30. package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +217 -44
  31. package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +87 -3
  32. package/dist/vendored/skills/dsl-card-generator/references/iteration_protocol.md +35 -6
  33. package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +21 -0
  34. package/dist/vendored/skills/dsl-card-generator/references/quickref.md +28 -27
  35. package/dist/vendored/skills/dsl-card-generator/references/recipes.md +30 -8
  36. package/dist/vendored/skills/dsl-card-generator/references/rules.md +3 -2
  37. package/dist/vendored/skills/dsl-card-generator/references/scripts_reference.md +5 -2
  38. package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +2 -3
  39. package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +1 -4
  40. package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +5 -14
  41. package/dist/vendored/skills/dsl-card-generator/scripts/autofix_schema.py +88 -0
  42. package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +143 -42
  43. package/dist/vendored/skills/dsl-card-generator/scripts/check_topology.py +0 -35
  44. package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +99 -53
  45. package/dist/vendored/skills/dsl-card-generator/scripts/gate.mjs +5 -2
  46. package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +388 -29
  47. package/dist/vendored/skills/dsl-card-generator/scripts/lib/component_contract.mjs +315 -0
  48. package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +1 -1
  49. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +23 -0
  50. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.py +0 -37
  51. package/dist/vendored/skills/dsl-card-generator/scripts/lib/python.mjs +99 -0
  52. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/adaptive-width.mjs +105 -0
  53. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/bindings.mjs +260 -0
  54. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/expr.mjs +52 -0
  55. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/image.mjs +96 -0
  56. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/registry.mjs +166 -0
  57. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/structure.mjs +127 -0
  58. package/dist/vendored/skills/dsl-card-generator/scripts/lib/rules/walk.mjs +61 -0
  59. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +48 -1
  60. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scope_alias.mjs +125 -0
  61. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_assemble.mjs +366 -45
  62. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_extract.mjs +169 -12
  63. package/dist/vendored/skills/dsl-card-generator/scripts/lib/v3_shared.mjs +17 -9
  64. package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +119 -78
  65. package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +48 -50
  66. package/dist/vendored/skills/dsl-card-generator/scripts/readiness.mjs +634 -0
  67. package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +5 -8
  68. package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +5 -10
  69. package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +122 -8
  70. package/dist/vendored/skills/dsl-card-generator/scripts/v3_regression.mjs +11 -2
  71. package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py +23 -15
  72. package/dist/vendored/skills/finmall-card-sync/scripts/api_batch_sync.mjs +46 -2
  73. package/dist/vendored/skills/mbank-design-gen/SKILL.md +76 -0
  74. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-apps.png +0 -0
  75. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-arrow-right-blue.png +0 -0
  76. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-check.png +0 -0
  77. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-settings.png +0 -0
  78. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-sound.png +0 -0
  79. package/dist/vendored/skills/mbank-design-gen/assets/icons/icon-voice-switch.png +0 -0
  80. package/dist/vendored/skills/mbank-design-gen/assets/icons/progress-thumb.png +0 -0
  81. package/dist/vendored/skills/mbank-design-gen/assets/icons/tag-bg.png +0 -0
  82. package/dist/vendored/skills/mbank-design-gen/assets/icons/vs-badge.png +0 -0
  83. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-chat-options.png +0 -0
  84. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-home-scene.png +0 -0
  85. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-product-detail.png +0 -0
  86. package/dist/vendored/skills/mbank-design-gen/assets/ref/ref-rate-table.png +0 -0
  87. package/dist/vendored/skills/mbank-design-gen/assets/robot.png +0 -0
  88. package/dist/vendored/skills/mbank-design-gen/references/component-library.md +127 -0
  89. package/dist/vendored/skills/mbank-design-gen/references/design-spec.md +261 -0
  90. package/dist/vendored/skills/mbank-design-gen/templates/mockup-template.html +138 -0
  91. package/dist/vendored/skills/mbank-design-gen/tools/screenshot.mjs +34 -0
  92. package/dist/vendored/skills/shared/exit-codes.md +79 -0
  93. package/dist/vendored/skills/shared/spec-contract.md +127 -0
  94. package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +27 -10
  95. package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +3 -3
  96. package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +0 -8
  97. package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +14 -25
  98. package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +121 -47
  99. package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +0 -5
  100. package/dist/vendored/skills/sketch-spec-to-card/scripts/test_text_only_artboard.py +98 -16
  101. package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +55 -37
  102. package/dist/vendored/templates/helloCard/schema.json +62 -1
  103. package/dist/vendored/tools/finmall-env.mjs +1 -18
  104. package/package.json +1 -1
  105. package/dist/preview-editor/assets/index-DQn0zQBP.css +0 -1
  106. package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +0 -122
  107. package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +0 -153
@@ -324,7 +324,21 @@ export function extractSemantics(spec, cardIndex = 0, opts = {}) {
324
324
  && (tr.x || 0) >= left - 24 && (tr.x || 0) <= left + 24
325
325
  && (ts(text).fontSize || 0) >= 14
326
326
  }).sort((a, b) => (rect(b).y || 0) - (rect(a).y || 0))
327
- const labelEl = labelCands[0] || null
327
+ let labelEl = labelCands[0] || null
328
+ let _sideLabel = false
329
+ if (!labelEl) {
330
+ // Side label: text at same y (vertically overlapping), to the LEFT of the group
331
+ const _grpCY = top + (bottom - top) / 2
332
+ const _sideCands = texts.filter((text) => {
333
+ const tr = rect(text)
334
+ const tcY = (tr.y || 0) + (tr.height || 0) / 2
335
+ return !memberTexts.has(text)
336
+ && Math.abs(tcY - _grpCY) <= Math.max(15, (bottom - top) * 0.6)
337
+ && (tr.x || 0) + (tr.width || 0) <= left + 4
338
+ && (ts(text).fontSize || 0) >= 13
339
+ }).sort((a, b) => (rect(a).x || 0) - (rect(b).x || 0))
340
+ if (_sideCands[0]) { labelEl = _sideCands[0]; _sideLabel = true }
341
+ }
328
342
  const labelStyle = labelEl ? ts(labelEl) : null
329
343
  groups.push({
330
344
  x: left,
@@ -338,9 +352,12 @@ export function extractSemantics(spec, cardIndex = 0, opts = {}) {
338
352
  fontSize: labelStyle.fontSize || 16,
339
353
  fontWeight: labelStyle.fontWeight || '500',
340
354
  height: rect(labelEl).height || (labelStyle.fontSize || 16) * 1.4,
355
+ x: rect(labelEl).x || 0,
356
+ y: rect(labelEl).y || 0,
357
+ width: rect(labelEl).width || 0,
341
358
  } : null,
342
359
  members,
343
- sourceLabelEl: labelEl,
360
+ sourceLabelEl: labelEl, sideLabel: _sideLabel,
344
361
  sourceTextEls: members.map((m) => m.sourceTextEl).filter(Boolean),
345
362
  })
346
363
  segment = []
@@ -589,7 +606,64 @@ export function extractSemantics(spec, cardIndex = 0, opts = {}) {
589
606
  })
590
607
  }
591
608
 
592
- // —— 重复面板组(同尺寸壳纵向等距重复、壳内结构同构)→ 面板列表 ——
609
+ // 空间散布的图表顶点标签(如雷达图五边形周围的类别 pill):
610
+ // 动作按钮必然横向成排(y-span ≤ 30px),若 ≥3 个候选按钮的 y 跨度 > 40px
611
+ // 且分布在 ≥3 个 y 带,判为空间散布的图表顶点标签而非按钮排。
612
+ // 检出后:收集这些 pill + 其周围的文本/形状为一个 vertexRegion(AbsoluteLayout 整块渲染),
613
+ // 从 buttons / auxTexts / postAmountTexts / isolatedBlocks 等路径排除以防重影。
614
+ let vertexClusters = null
615
+ const _vertexConsumedEls = new Set()
616
+ if (buttons.length >= 3) {
617
+ const ys = buttons.map((b) => b.y || 0)
618
+ const xs = buttons.map((b) => b.x || 0)
619
+ const ySpan = Math.max(...ys) - Math.min(...ys)
620
+ const xSpan = Math.max(...xs) - Math.min(...xs)
621
+ if (ySpan > 40 && xSpan > 80) {
622
+ const yBands = new Set(ys.map((y) => Math.floor(y / 20)))
623
+ if (yBands.size >= 3) {
624
+ vertexClusters = buttons.map((btn, bi) => {
625
+ const bx = btn.x || 0, by = btn.y || 0
626
+ const bw = btn.width || 0, bh = btn.height || 0
627
+ const pillShape = buttonShapeSorted[bi]
628
+ if (pillShape) _vertexConsumedEls.add(pillShape)
629
+ if (btn.sourceEl) _vertexConsumedEls.add(btn.sourceEl)
630
+ const clusterEls = content.filter((e) => {
631
+ if (e === btn.sourceEl || (pillShape && e === pillShape)) return false
632
+ if (_vertexConsumedEls.has(e)) return false
633
+ const r = rect(e)
634
+ const ex = (r.x || 0) + (r.width || 0) / 2
635
+ const ey = (r.y || 0) + (r.height || 0) / 2
636
+ return ex >= bx - 15 && ex <= bx + bw + 15
637
+ && ey >= by - 8 && ey <= by + bh + 35
638
+ })
639
+ clusterEls.forEach((e) => _vertexConsumedEls.add(e))
640
+ return {
641
+ pill: {
642
+ text: btn.text, color: btn.color, fontSize: btn.fontSize,
643
+ fontWeight: btn.fontWeight || '400',
644
+ fillColor: btn.fillColor, radius: btn.radius,
645
+ shape: pillShape, sourceEl: btn.sourceEl,
646
+ },
647
+ texts: clusterEls.filter((e) => textOf(e)),
648
+ shapes: clusterEls.filter((e) => !textOf(e)),
649
+ x: bx, y: by, width: bw, height: bh,
650
+ }
651
+ })
652
+ buttons.length = 0
653
+ for (let ti = texts.length - 1; ti >= 0; ti--)
654
+ if (_vertexConsumedEls.has(texts[ti])) texts.splice(ti, 1)
655
+ for (let si = shapes.length - 1; si >= 0; si--)
656
+ if (_vertexConsumedEls.has(shapes[si])) shapes.splice(si, 1)
657
+ for (let ci2 = content.length - 1; ci2 >= 0; ci2--)
658
+ if (_vertexConsumedEls.has(content[ci2])) content.splice(ci2, 1)
659
+ for (let bs2 = buttonShapes.length - 1; bs2 >= 0; bs2--)
660
+ if (_vertexConsumedEls.has(buttonShapes[bs2])) buttonShapes.splice(bs2, 1)
661
+ }
662
+ for (let si3 = slices.length - 1; si3 >= 0; si3--)
663
+ if (_vertexConsumedEls.has(slices[si3])) slices.splice(si3, 1)
664
+ }
665
+ }
666
+ // 重复面板组(同尺寸壳纵向等距重复、壳内结构同构)→ 面板列表 ——
593
667
  // 纯几何识别,无任何业务词:
594
668
  // ① ≥2 个同尺寸(±4px)带填充/渐变的壳(非按钮、非全卡背景)
595
669
  // ② 纵向 pitch 一致(±8px)
@@ -2365,6 +2439,31 @@ export function extractSemantics(spec, cardIndex = 0, opts = {}) {
2365
2439
  .sort((a, b) => a.y - b.y || a.x - b.x)
2366
2440
  // 浮动装饰切片回收:isolatedBlocks 先于 orphanSlices 消费切片(卡头月亮等贴缘叠装饰),
2367
2441
  // 命中「与文本带竖直重叠 + 贴卡缘」者改走绝对定位叠层,不占流式行高。
2442
+ // Chart center media (radar/ring vector group): when vertexClusters exist,
2443
+ // pull it from isolatedBlocks into vertexClusters.chartMedia so assemble can
2444
+ // render both in the SAME AbsoluteLayout (shared coordinate system).
2445
+ if (vertexClusters && vertexClusters.length >= 3) {
2446
+ const vcXs = vertexClusters.map((vc) => vc.x || 0)
2447
+ const vcXRights = vertexClusters.map((vc, i) => (vc.x || 0) + (vc.width || 88))
2448
+ const vcYs = vertexClusters.map((vc) => vc.y || 0)
2449
+ const vcYBottoms = vertexClusters.map((vc, i) => (vc.y || 0) + (vc.height || 30))
2450
+ const vcCx = (Math.min(...vcXs) + Math.max(...vcXRights)) / 2
2451
+ const vcCy = (Math.min(...vcYs) + Math.max(...vcYBottoms)) / 2
2452
+ for (let ib = isolatedBlocks.length - 1; ib >= 0; ib--) {
2453
+ const blk = isolatedBlocks[ib]
2454
+ const bw = blk.width || 0, bh = blk.height || 0
2455
+ if (bw < 50 || bh < 50 || bw > 200 || bh > 200) continue
2456
+ if (Math.abs(bw - bh) > 30) continue
2457
+ const bcx = (blk.x || 0) + bw / 2
2458
+ const bcy = (blk.y || 0) + bh / 2
2459
+ if (Math.hypot(bcx - vcCx, bcy - vcCy) > 80) continue
2460
+ vertexClusters.chartMedia = blk
2461
+ isolatedBlocks.splice(ib, 1)
2462
+ _vertexConsumedEls.add(blk.element)
2463
+ break
2464
+ }
2465
+ }
2466
+
2368
2467
  const floatDecos = []
2369
2468
  {
2370
2469
  const cRd = rect(card)
@@ -2412,6 +2511,10 @@ const floatDecos = []
2412
2511
  if (formConsumed.has(t) || panelTextConsumed.has(t)) return false
2413
2512
  if (subAmountEls.has(t)) return false
2414
2513
  if (_panelGroupMemberEls.has(t)) return false
2514
+ // 序号徽章行成员(数字壳 + 右侧内容)已被 badgeRows 通道整体渲染:同一文本元素不得
2515
+ // 再被 listTitle 认领。否则徽章行内容二次渲染(重影),且 postAmountTexts 的 y 上界被
2516
+ // 这个假标题截断——假标题下方的段落/页脚文案整批静默丢失(r265 实测 5 段文案蒸发)。
2517
+ if (_badgeRowTextEls.has(t)) return false
2415
2518
  // 复合行模式:行标题判定 = 候选下方 18-110px 有波段,且【另一文本】在相同相对距离(±4px)也有波段
2416
2519
  // (行结构周期性重复)。卡标题(如「我的账户」距首波段 88px,无周期同伴)不受影响。
2417
2520
  if (repeatRowMode) {
@@ -2819,6 +2922,9 @@ const floatDecos = []
2819
2922
  }))
2820
2923
  // 面板组成员:由面板列表模板整体接管
2821
2924
  && !_panelGroupMemberEls.has(t)
2925
+ // 序号徽章行成员(数字 + 右侧内容):行结构已由 badgeRows 通道还原,
2926
+ // 再当列表项标题会把同一行渲染两次(徽章行 + ListLayout 项重影)。
2927
+ && !_badgeRowTextEls.has(t)
2822
2928
  })
2823
2929
  // 同 y(±10)的 first-col 文本聚合为一项;按 y 排序
2824
2930
  // P0/P1 升级:列表项必须存在「标题下方 18-36px 的描述文本」(desc)——否则摘要区
@@ -3491,20 +3597,46 @@ const floatDecos = []
3491
3597
  } : null
3492
3598
 
3493
3599
  // —— 底部控制件:只用“按钮区下方 + 居中 + 小尺寸近似方形媒体”判定;低置信度的纯文本不建模。
3600
+ // 「折叠/展开控件」是**卡底**控件,判据必须锚在卡底区域,不能只锚「按钮区之下」:
3601
+ // 无按钮卡里 buttonShapes 为空会让 btnRegionBottom 塌成 0,于是卡中任何
3602
+ // 「小尺寸近方形 + 横向居中」的切片都被误认(如账户行左侧的圆形卡标,
3603
+ // r282 实测:同一图标在账户行与卡底各渲染一次,且卡底多出的那一行把
3604
+ // 底部按钮整体顶出内容区,单带像素差异 88%)。
3605
+ // 补一道真值门:切片必须落在卡内下缘带内(底沿不低于卡底 − 带高),
3606
+ // 且不得高于卡片内容区(文本/媒体)底沿——控件在内容之下,不在内容之中。
3494
3607
  const collapseBtn = (() => {
3608
+ const cardRectR = rect(card)
3609
+ const cardBottom = (cardRectR.y || 0) + (cardRectR.height || 0)
3495
3610
  const btnRegionBottom = buttonShapes.length
3496
3611
  ? Math.max(...buttonShapes.map((s) => (rect(s).y || 0) + (rect(s).height || 0)))
3497
3612
  : 0
3613
+ // 卡内下缘带高:不超过卡高 22%,至少容得下控件自身高度
3614
+ const bottomBandHeight = Math.max(24, Math.round((cardRectR.height || 0) * 0.22))
3615
+ // 内容底沿:所有文本/媒体元素的最低底沿(归一化对象用 rect() 读不到时按 0 略过)
3616
+ let contentBottom = 0
3617
+ for (const t of texts) {
3618
+ const tr = rect(t)
3619
+ contentBottom = Math.max(contentBottom, (tr.y || 0) + (tr.height || 0))
3620
+ }
3621
+ for (const s of slices) {
3622
+ const sr = rect(s)
3623
+ contentBottom = Math.max(contentBottom, (sr.y || 0) + (sr.height || 0))
3624
+ }
3498
3625
  const mediaSlice = slices.find((s) => {
3499
3626
  const sr = rect(s)
3500
3627
  const width = sr.width || 0
3501
3628
  const height = sr.height || 0
3502
3629
  const center = (sr.x || 0) + width / 2
3503
- const cardCenter = (rect(card).x || 0) + ((rect(card).width || 0) / 2)
3630
+ const cardCenter = (cardRectR.x || 0) + ((cardRectR.width || 0) / 2)
3631
+ const bottom = (sr.y || 0) + height
3504
3632
  return width >= 12 && width <= 36 && height >= 12 && height <= 36
3505
3633
  && Math.abs(width - height) <= Math.max(10, width * 0.5)
3506
3634
  && (sr.y || 0) > btnRegionBottom
3507
- && Math.abs(center - cardCenter) <= Math.max(24, (rect(card).width || 0) * 0.12)
3635
+ // 落在卡内下缘带内(真值门)
3636
+ && bottom >= cardBottom - bottomBandHeight
3637
+ // 在内容之下而非内容之中:控件顶沿不得低于内容底沿减去自身高度容差
3638
+ && (sr.y || 0) >= contentBottom - height - 4
3639
+ && Math.abs(center - cardCenter) <= Math.max(24, (cardRectR.width || 0) * 0.12)
3508
3640
  })
3509
3641
  const textEl = null
3510
3642
  if (!mediaSlice) return null
@@ -3919,8 +4051,9 @@ const orphanSlices = slices.filter((s) => {
3919
4051
  }
3920
4052
 
3921
4053
  // —— 壳内右列文本(两列拓扑)——
3922
- // 内容壳(面板壳/渐变壳)右半区独立成列的文本:>=2 个文本左边界落在壳宽 45% 之后且互相成列
3923
- // (x 差 <=8、分属不同行),壳内左侧另有 >=2 个文本 → 该壳是「左列 + 右列」拓扑而非竖排单列。
4054
+ // 内容壳(面板壳/渐变壳)右半区独立成列的文本:>=2 个文本左边界落在列界之后且互相成列
4055
+ // (x 差 <=8、分属不同行),壳内左侧另有 >=2 个文本、或存在前导媒体(整块图/大切片)→
4056
+ // 该壳是「左列 + 右列」拓扑而非竖排单列。列界取前导媒体右缘,无媒体才回退「壳宽 45%」。
3924
4057
  // 此前右列文本或被压成竖排堆叠(panelRows 路径),或整段落进主视觉死区不渲染(渐变壳路径)。
3925
4058
  const shellButtonTextEls = new Set(buttons.map((button) => button.sourceEl).filter(Boolean))
3926
4059
  const shellRightColumns = []
@@ -3932,7 +4065,22 @@ const orphanSlices = slices.filter((s) => {
3932
4065
  // 标题行(与壳内首个文本同 band)整体保留为整行:名称 + 紧邻短标签不是右列成员
3933
4066
  const headerEls = inner.filter((t) => Math.abs((rect(t).y || 0) - topY) <= 8)
3934
4067
  const headerSet = new Set(headerEls)
3935
- const splitX = (sr.x || 0) + (sr.width || 0) * 0.45
4068
+ // 前导媒体(壳内左侧的整块图 / 大切片):高显著大于壳内行高、右缘落在壳左半区。
4069
+ // 右列左界此前固定取「壳宽 45%」——该比例隐含「前导媒体宽 ≈ 壳宽一半」的假设;
4070
+ // 媒体较窄时(80px 图 / 311px 壳)右列起点落在比例线左侧,右列文本整体被划到左列一侧
4071
+ // → left.length 恒 < 2 → 两列拓扑被整条判死,右列文本退化成全宽竖排行。
4072
+ // 有前导媒体时改用其右缘为列界(几何真值),无媒体才回退比例线。
4073
+ const innerHeights = inner.map((t) => rect(t).height || 0).sort((a, b) => a - b)
4074
+ const innerLineH = innerHeights[Math.floor(innerHeights.length / 2)] || 14
4075
+ const leadMedia = [...isolatedBlocks, ...slices]
4076
+ .filter((el) => thinInside(el, shape))
4077
+ .map((el) => rect(el))
4078
+ .filter((r) => (r.height || 0) >= Math.max(24, innerLineH * 1.8)
4079
+ && (r.x || 0) + (r.width || 0) <= (sr.x || 0) + (sr.width || 0) * 0.5)
4080
+ .sort((a, b) => ((a.x || 0) + (a.width || 0)) - ((b.x || 0) + (b.width || 0)))[0] || null
4081
+ const splitX = leadMedia
4082
+ ? Math.max((sr.x || 0) + 2, (leadMedia.x || 0) + (leadMedia.width || 0) + 2)
4083
+ : (sr.x || 0) + (sr.width || 0) * 0.45
3936
4084
  const columns = []
3937
4085
  for (const t of inner.filter((item) => !headerSet.has(item) && (rect(item).x || 0) >= splitX)
3938
4086
  .slice().sort((a, b) => (rect(a).x || 0) - (rect(b).x || 0))) {
@@ -3948,7 +4096,9 @@ const orphanSlices = slices.filter((s) => {
3948
4096
  if (!best) continue
3949
4097
  const bestSet = new Set(best.items)
3950
4098
  const left = inner.filter((t) => !headerSet.has(t) && !bestSet.has(t) && (rect(t).x || 0) < splitX)
3951
- if (left.length < 2) continue
4099
+ // 左列成员可以是一张整块图而非文本(「产品图 + 右列信息」是常见形态):
4100
+ // 有前导媒体时左列无文本也成立,否则该形态永远进不了两列通道。
4101
+ if (left.length < 2 && !leadMedia) continue
3952
4102
  shellRightColumns.push({
3953
4103
  shapeEl: shape,
3954
4104
  x: sr.x || 0, y: sr.y || 0, width: sr.width || 0, height: sr.height || 0,
@@ -3991,7 +4141,12 @@ const optionTextStrings = new Set([...optionTextSet].map((t) => textOf(t)))
3991
4141
  artboardType: spec.artboardType || 'card',
3992
4142
  cardRect: rect(card), // 卡片容器几何(用于底部留白/顶部留白几何推导)
3993
4143
  cardFill: card.cardFill || null,
3994
- cardRadius: (card.mask && card.mask.radius && card.mask.radius[0]) || null,
4144
+ // 契约 skills/shared/spec-contract.md §cards[].mask.radius:
4145
+ // null = 上游没找到带圆角的卡壳(_card_mask_info 返回 (None, fill)),
4146
+ // 下游兜底点在 v3_assemble.mjs 的 `sem.cardRadius || T.radius('card')`(契约规定的默认圆角)。
4147
+ // 取用必须用 ?? 而非 ||:`radius[0] === 0` 是合法值(真·直角卡),用 || 会被吞成 null
4148
+ // 从而错误地套上默认圆角。(存量数据无此值,属防御性修正。)
4149
+ cardRadius: card.mask?.radius?.[0] ?? null,
3995
4150
  tabs, buttons, optionGroups, primaryAmount, subAmounts, auxTexts, postAmountTexts, tabY, badgeRows,
3996
4151
  topTintBlobs,
3997
4152
  listTitle, sampleItems, allItems, viewMore, collapseBtn, countdown, topDecoration, formRows, midCluster: midCluster && (midCluster.items || []).length >= 2 && !(midCluster.items || []).every((it) => optionTextStrings.has(it.text)) ? midCluster : null, bindings,
@@ -4004,11 +4159,13 @@ const optionTextStrings = new Set([...optionTextSet].map((t) => textOf(t)))
4004
4159
  panelRows,
4005
4160
  titleUnderlines,
4006
4161
  subAmountPanel,
4007
- orphanSlices, floatDecos,
4162
+ orphanSlices: (orphanSlices || []).filter((s) => !_vertexConsumedEls.has(s)),
4163
+ floatDecos: (floatDecos || []).filter((fd) => !_vertexConsumedEls.has(fd)),
4008
4164
  thinShellRows, thinShellStrips, shellRightColumns,
4009
4165
  gradientPanels, panelGroup,
4010
4166
  richBlocks,
4011
4167
  chartClusters,
4168
+ vertexClusters,
4012
4169
  shellLayers,
4013
4170
  contentBounds: (() => {
4014
4171
  const cardWidth = rect(card).width || 0
@@ -4044,7 +4201,7 @@ const optionTextStrings = new Set([...optionTextSet].map((t) => textOf(t)))
4044
4201
  (rect(card).x || 0) + (rect(card).width || 0),
4045
4202
  }
4046
4203
  })(),
4047
- slices: slices.map((s) => s),
4204
+ slices: slices.filter((s) => !_vertexConsumedEls.has(s)).map((s) => s),
4048
4205
  slicesExports: spec.slices || [],
4049
4206
  allTexts: texts.map((t) => ({ text: textOf(t), ...ts(t), sourceEl: t })),
4050
4207
  }
@@ -179,8 +179,17 @@ export function fixFlexShrinkOverflow(root) {
179
179
  const children = getChildren(node)
180
180
  if (!isAutoSize && children.length >= 2) {
181
181
  const allShrinkZero = children.every((child) => getStyleVal(child, 'flex', 'flexShrink') === '0')
182
- if (allShrinkZero) {
183
- // Set the last child to flexShrink:1 (typically the most flexible content area)
182
+ // 「子节点全为固定 px 宽」= 这些宽度是设计稿逐个标注出来的(并排药丸/标签/统计块),
183
+ // 它们的和就是设计真值。此时**不得**为末位放开可缩点:药丸被压窄后内部文案换行、
184
+ // 行高撑高,连带 textOverflow 与 structure 一起掉(r284 实测:149+12+150 恰等于
185
+ // 组宽 311,却被压成两行,textOverflow 0.889 < 门 0.90)。
186
+ // 真正的「溢出兜底」场景是子节点里混有 auto/百分比宽(内容长度不可知),
187
+ // 那种才需要放开一个可缩点让内容有地方收缩。
188
+ const allFixedPx = children.every((child) => {
189
+ const cw = getStyleVal(child, 'rect', 'width')
190
+ return cw != null && /^\d+(\.\d+)?$/.test(String(cw))
191
+ })
192
+ if (allShrinkZero && !allFixedPx) {
184
193
  setStyleVal(children[children.length - 1], 'flex', 'flexShrink', '1')
185
194
  }
186
195
  }
@@ -422,12 +431,6 @@ export function imageOrPlaceholder(sliceEl, specSlices) {
422
431
  return img || placeholderImage(sliceEl)
423
432
  }
424
433
 
425
- /** 在 sem.slices(切片元素数组)中按导出相对路径反查切片元素(用于取 rect 尺寸) */
426
- export function findSliceElByExport(sem, exportRel) {
427
- if (!exportRel) return null
428
- const base = stripScale(String(exportRel).split('/').pop())
429
- return (sem.slices || []).find((s) => stripScale(String(s.name || '').split('/').pop()) === base) || null
430
- }
431
434
  /** 把金额字符串(如 "¥5,638.00" / "-¥23.50")解析为数字 */
432
435
  export function parseAmount(text) {
433
436
  if (!text) return null
@@ -480,9 +483,14 @@ export function amountExpr(varName, srcText, opts = {}) {
480
483
  const unit = JSON.stringify(unitMatch[2])
481
484
  return `${sign} + ${abs} + ${unit}`
482
485
  }
486
+ // 货币符号必须进表达式:spec 把「¥」与「5,638.00」拆成两层时,裸符号层会被合并段
487
+ // (mergeCurrencyLayer)吞掉,表达式是符号唯一的载体——不输出前缀 ⇒ 渲染只剩数字
488
+ // ("¥5,638.00" → "5,638.00")。前缀取自原文、运行时与负号拼接顺序固定(负号在前)。
489
+ // 纯数字原文("2000" 配相邻"万元")不写前缀,避免凭空加符号。
490
+ const cur = hasCurrency ? JSON.stringify(curPrefix) + ' + ' : ''
483
491
  // 列表行模板共用一套表达式:货币前缀必须逐行数据驱动($amtCurN),否则首行符号套到全行
484
492
  if (opts.prefixVar) return `${sign} + $${opts.prefixVar} + ${abs}`
485
- return `${sign} + ${abs}`
493
+ return `${sign} + ${cur}${abs}`
486
494
  }
487
495
 
488
496
  export function amountValueExpr(varName, srcText, { currencyPrefix = true } = {}) {
@@ -25,6 +25,7 @@
25
25
  * 15. 切图引用含 URL 保留字符(r31b):`# ? % & +` 会被浏览器当 fragment/query 截掉 → 图片静默不显示(R31 的补充,R31 只拦空格)。
26
26
  * 16. 横向流父容器里的容器子节点未写 rect.width + flexShrink:0(r22b):渲染器按 component-meta 默认「100%」出 → 吃掉整行,同排兄弟被压成 0 宽或被顶出卡外。
27
27
  * 17. 切图引用在 src/slices 里没有对应文件(r31c):渲染时 404,图片位置空白且控制台零报错 —— R31(空格)/R31b(保留字符)之外的第三种「引用与磁盘名不同源」。
28
+ * 18. 组件契约(r28 / r28b-*):属性键 / 样式组 / 样式子键必须在 component-meta.json + style-meta.json 白名单内 —— 不存在的键被运行时**整条静默丢弃**(Image 的键写成 image 而非 value ⇒ 图片变破图,而四道闸全绿)。
28
29
  *
29
30
  * 用法:
30
31
  * node lint_card.mjs --id <cardId> # 体检单张卡
@@ -44,6 +45,12 @@ import { fileURLToPath } from 'node:url'
44
45
  import { cardsDir, cardSchemaPath, cardDataPath, readJson, metaDir, slicesDir } from './lib/paths.mjs'
45
46
  import { buildContentIndex, buildSliceFileIndex, checkSliceName, collectSliceRefStrings, duplicatePeers, findUrlReservedChars, isRemoteSliceRef, resolveSliceRefOnDisk, sliceNameFromRef } from './lib/slice_dedupe.mjs'
46
47
  import { collectRowChildNoWidth } from './lib/layout_rules.mjs'
48
+ import { collectFullwidthFixedPx } from './lib/rules/adaptive-width.mjs'
49
+ import { loadContract, collectContractViolations, describeViolation } from './lib/component_contract.mjs'
50
+ import { collectImageValueFrom, collectImageNoHeight } from './lib/rules/image.mjs'
51
+ import { collectExprNoMathRound, numericHint } from './lib/rules/expr.mjs'
52
+ import { collectRepeaterDefects, collectStaticTileExpansion, collectArrayConsumption } from './lib/rules/bindings.mjs'
53
+ import { collectSlotMultiChildren, collectNullChildren, collectDuplicateStyleChildren, collectAlertDataWholeState, collectIconNoRect, collectRootFixedHeight } from './lib/rules/structure.mjs'
47
54
 
48
55
  // src/slices 内容索引(sha256 → 文件名)进程内只建一次,--all 体检全量卡时复用
49
56
  let SLICE_CONTENT_INDEX = null
@@ -252,6 +259,25 @@ export function lint(schema, data) {
252
259
  const view = schema.view
253
260
  if (!view) return [{ severity: 'error', code: 'no-view', message: 'schema 没有 view 字段' }]
254
261
 
262
+ // 0. 组件契约:属性键 / 样式组 / 样式子键必须落在白名单内(唯一来源 component-meta.json + style-meta.json)。
263
+ //
264
+ // 2026-09-24 事故:模型给 Image 写 itemKey:"image",而该组件元数据里图片地址的键**只有 value**。
265
+ // 运行时按 itemKey 绑定组件 props,不存在的键被**整条静默丢弃** ⇒ value 为空 ⇒ 图片渲染成破图。
266
+ // 而 validate / lint / preflight / elements.missing 当时**全部放行**(preflight 的 Check 3/5 都用
267
+ // getProp(n,'value'),取不到就 continue —— 键写错反而把检查链短路了)。
268
+ // 全仓 82 处 Image 里 81 处写 value,唯一写 image 的就是这张卡 ⇒ 模型会偶发编造键名,必须机械兜底。
269
+ {
270
+ const contract = loadContract({ metaDir })
271
+ for (const v of collectContractViolations(schema, contract)) {
272
+ out.push({
273
+ severity: v.severity,
274
+ code: v.code === 'unknown-class' ? 'r28-unknown-class' : `r28b-${v.code}`,
275
+ componentId: v.componentId,
276
+ message: describeViolation(v),
277
+ })
278
+ }
279
+ }
280
+
255
281
  // 1. 脚手架前缀残留("示例"是 scaffold_card.mjs 默认占位文本)
256
282
  if (data && typeof data === 'object') {
257
283
  for (const [k, v] of Object.entries(data)) {
@@ -615,16 +641,9 @@ export function lint(schema, data) {
615
641
  }
616
642
 
617
643
  // ── R61: 静态文案 / 字典默认值含疑似运行期数字(rules.md §十四,提醒级 WARN)──
618
- // 只作「提醒 AI 语义复核」的启发式:命中 ≠ 违规(版本号 / 固定营销话术会误报),故 WARN 不阻塞。
619
- const NUMERIC_LITERAL_PATTERNS = [
620
- { re: /\d{1,3}(,\d{3})+(\.\d+)?/, label: '千分号数字' },
621
- { re: /[¥¥]\s*\d+(\.\d+)?/, label: '货币符+数字' },
622
- { re: /\d+(\.\d+)?\s*(元|笔|次|个|条)/, label: '数字+单位词' },
623
- ]
624
- const numericHit = (str) => {
625
- for (const { re, label } of NUMERIC_LITERAL_PATTERNS) if (re.test(str)) return label
626
- return null
627
- }
644
+ // 形态表共享 lib/rules/expr.mjs(NUMERIC_HINT_PATTERNS + numericHint,测试直测):
645
+ // 只作「提醒 AI 语义复核」的启发式:命中 ≠ 违规(版本号 / 固定营销话术会误报),故 WARN 不阻塞。
646
+ const numericHit = numericHint
628
647
  walk(view, (n) => {
629
648
  if (n.className !== 'Text') return
630
649
  for (const p of n.properties || []) {
@@ -654,79 +673,65 @@ export function lint(schema, data) {
654
673
  })
655
674
  }
656
675
 
657
- // ── R32: Image 缺 rect.height → CSS aspect-ratio:16/9 压缩 ──
658
- walk(view, (n) => {
659
- if (n.className !== 'Image') return
660
- const sp = (n.style && n.style.properties) || []
661
- const rectGroup = sp.find(p => p.itemKey === 'rect')
662
- const rectChildren = (rectGroup && rectGroup.itemChildren && rectGroup.itemChildren.properties) || []
663
- const hChild = rectChildren.find(c => c.itemKey === 'height')
664
- if (!hChild || !String(hChild.itemValue).trim()) {
676
+ // ── R32 / R25: Image 硬契约(缺 rect.height、itemValueFrom 三态)──
677
+ // 判定与文案共享 lib/rules/image.mjs(与 preflight 同一实现,避免「同一张卡两处措辞/结论不同」)。
678
+ // 这里显式挑选字段构造 finding,保持 lint 输出形状与重构前逐字一致。
679
+ for (const f of collectImageNoHeight(view)) {
680
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
681
+ }
682
+ for (const f of collectImageValueFrom(view)) {
683
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
684
+ }
685
+
686
+ // ── R23: 百分比表达式缺 Math.round → JS 浮点精度 ──(共享 lib/rules/expr.mjs)
687
+ for (const f of collectExprNoMathRound(view)) {
688
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
689
+ }
690
+
691
+ // ── 数据绑定完备:列表数组化三件套 ──(共享 lib/rules/bindings.mjs,2026-09-25)
692
+ // 复现器硬伤是 error(渲染 0 项 / 空壳,必然错);未消费数组与静态 tile 是 warn
693
+ // (像素可以很高但数据维度缺失;硬拦在 readiness 的 bindings/lists 门——有视觉提名背书才拦)。
694
+ for (const f of collectRepeaterDefects(view)) {
695
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
696
+ }
697
+ for (const f of collectStaticTileExpansion(view)) {
698
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
699
+ }
700
+ {
701
+ const { unconsumed } = collectArrayConsumption(schema, data || {})
702
+ for (const u of unconsumed) {
665
703
  out.push({
666
- severity: 'error',
667
- code: 'r32-image-no-height',
668
- componentId: n.componentId || '',
669
- message: `Image "${n.componentId}" 缺 rect.height → CSS aspect-ratio:16/9 压缩图片高度(R32)。设显式高度`,
704
+ severity: 'warn',
705
+ code: 'binding-array-unconsumed',
706
+ componentId: '',
707
+ message: `data["${u.name}"](${u.len} 项)没有任何列表消费(复现器 value / slotScope 模板 / 事件代码 / 表达式都找不到引用)→ ` +
708
+ (u.semantic
709
+ ? '名字带列表语义却没被任何列表使用:设计稿若有重复数据行,应 ListLayout/GridLayout + $' + u.name + ' + slotScope 模板(ir-format.md §2e);若该数组确无视图用途应从 data.json 删除'
710
+ : '若为 Canvas 图表 / 运行时配置数据可忽略本预警'),
670
711
  })
671
712
  }
672
- })
713
+ }
673
714
 
674
- // ── R25: Image itemValueFrom 三态精确映射 ──
675
- walk(view, (n) => {
676
- if (n.className !== 'Image') return
677
- for (const p of n.properties || []) {
678
- if (p.itemKey !== 'value') continue
679
- const from = String(p.itemValueFrom || '')
680
- const val = String(p.itemValue || '')
681
- if (from === '0' && !val.startsWith('$')) {
682
- out.push({
683
- severity: 'error',
684
- code: 'r25-image-from-0',
685
- componentId: n.componentId || '',
686
- message: `Image "${n.componentId}" itemValueFrom="0"(常量) → 渲染器不走图片逻辑,空白(R25)。静态路径用 "2"`,
687
- })
688
- }
689
- if (from === '1' && !val.startsWith('$')) {
690
- out.push({
691
- severity: 'error',
692
- code: 'r25-image-from-1',
693
- componentId: n.componentId || '',
694
- message: `Image "${n.componentId}" itemValueFrom="1"(变量) 但值不以 $ 开头 → 表达式求值失败,空白(R25)`,
695
- })
696
- }
697
- if (from === '2' && val.startsWith('$')) {
698
- out.push({
699
- severity: 'error',
700
- code: 'r25-image-from-2',
701
- componentId: n.componentId || '',
702
- message:
703
- `Image "${n.componentId}" itemValueFrom="2"(图片/文件值) 但值是表达式 "${val}" → ` +
704
- `运行时对 "2" 是原样透传(property.js onPreview),该字符串直接进 background-image:url(${val}),` +
705
- `画布必然空白(R25)。变量绑定必须改 "1"`,
706
- })
707
- }
708
- }
709
- })
715
+ // ── 宽度自适应契约(ir-format.md §2f;判定共享 lib/rules/adaptive-width.mjs,2026-09-25)──
716
+ // 容器类在纵向流父级里把占满语义写死成 px(98%~103% 占满父内容盒)→ error。
717
+ // meta 默认 rect.width 就是 100%,覆盖成 px = 显式锁死;改 100% 与设计宽逐像素等价且自适应。
718
+ for (const f of collectFullwidthFixedPx(view)) {
719
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
720
+ }
710
721
 
711
- // ── R23: 百分比表达式缺 Math.round → JS 浮点精度 ──
712
- walk(view, (n) => {
713
- const allProps = [...(n.properties || [])]
714
- for (const sp of n.style?.properties || []) {
715
- for (const c of sp.itemChildren?.properties || []) allProps.push(c)
716
- }
717
- for (const p of allProps) {
718
- if (String(p.itemValueFrom) === '1' && typeof p.itemValue === 'string') {
719
- if (/\*\s*100/.test(p.itemValue) && !/Math\.round/.test(p.itemValue)) {
720
- out.push({
721
- severity: 'error',
722
- code: 'r23-no-math-round',
723
- componentId: n.componentId || '',
724
- message: `"${n.componentId}" 表达式含 *100 但无 Math.round → JS 浮点精度溢出(R23): ${p.itemValue.slice(0, 50)}`,
725
- })
726
- }
727
- }
728
- }
729
- })
722
+ // ── 结构与事件代码:pitfalls 教训 → 机器 gate ──(共享 lib/rules/structure.mjs,2026-09-25)
723
+ // §27 slot 平铺 / R34 null 子节点 / §20.4 style 重复子项是 error(必然错、存量零命中);
724
+ // §10 整体回传 / R20 Icon 缺 rect / R38 Root 定高是 warn(存量有命中或语义复核兜底)。
725
+ for (const f of [
726
+ ...collectSlotMultiChildren(view),
727
+ ...collectNullChildren(view),
728
+ ...collectDuplicateStyleChildren(view),
729
+ ...collectAlertDataWholeState(view),
730
+ ...collectIconNoRect(view),
731
+ ...collectRootFixedHeight(view),
732
+ ]) {
733
+ out.push({ severity: f.severity, code: f.code, componentId: f.componentId, message: f.message })
734
+ }
730
735
 
731
736
  // R17/R22: flexShrink 铁律
732
737
  // R17: 关键 Text(金额/数字/标签/标题/占比/单位)必须 flexShrink:0(防换行)
@@ -1200,6 +1205,42 @@ export function lint(schema, data) {
1200
1205
  }
1201
1206
  })
1202
1207
 
1208
+ // R50b: 未归一化的列表作用域别名(哨兵,**不是**「禁止 $item」的规则)。
1209
+ //
1210
+ // 2026-09-24 定论:`$item.xxx` 不是模型的问题 —— 我们自己把它手写进了系统提示词
1211
+ // (提交 56e9894)与 ir-format.md,模型只是照做。所以处理方式是**编译器归一化**:
1212
+ // · IR → schema:expand_ir.mjs 的 expandIR() 开头调用 lib/scope_alias.mjs 改写;
1213
+ // · schema 级:autofix_schema.py 规则 5 改写(gate 第 1 步 / iterate 内建 autofix 都会跑到)。
1214
+ // 规范形只有三种:`$<字段名>` / `$$` / `$_index`(运行时 makeSlotScope 的作用域没有 `item` 键)。
1215
+ //
1216
+ // 那这条规则还拦什么:**未走过归一化管线的 schema**(外部手改、老产物、绕过 expand/autofix
1217
+ // 直接写盘)。此时 lint 是最后一道可机械判定的闸 —— 命中说明该 schema 该跑一次
1218
+ // `autofix_schema.py`,而不是说作者写错了字。CI 对已提交 schema 跑 lint 时它是唯一防线。
1219
+ walk(view, (n) => {
1220
+ const cid = n.componentId || '(root)'
1221
+ const hit = []
1222
+ const scan = (where, val) => {
1223
+ const s = String(val || '')
1224
+ if (!/\$item(?![A-Za-z0-9_$])/.test(s)) return
1225
+ hit.push(`${where}: ${s.length > 90 ? s.slice(0, 90) + '…' : s}`)
1226
+ }
1227
+ for (const p of (n.properties || [])) if (String(p.itemValueFrom) === '1') scan(p.itemKey || '?', p.itemValue)
1228
+ for (const g of (n.style?.properties || [])) {
1229
+ for (const c of (g.itemChildren?.properties || [])) if (String(c.itemValueFrom) === '1') scan(`style.${g.itemKey}.${c.itemKey}`, c.itemValue)
1230
+ }
1231
+ for (const d of (n.directives || [])) if (String(d.itemValueFrom) === '1') scan(`directive.${d.itemKey}`, d.itemValue)
1232
+ for (const ea of (n.eventactions || [])) {
1233
+ for (const p of (ea?.action?.properties || [])) if (p?.itemValue?.code) scan(`action.${p.itemKey}.code`, p.itemValue.code)
1234
+ }
1235
+ if (!hit.length) return
1236
+ out.push({
1237
+ severity: 'error',
1238
+ code: 'r50b-unnormalized-scope-alias',
1239
+ componentId: cid,
1240
+ message: `${n.className} "${cid}" 的绑定里含未归一化的列表作用域别名 $item —— 运行时 makeSlotScope 的作用域里**没有 item 这个键**(它是「item 字段逐个展开 ∪ {$$: 整项, _index: 索引}」),求值恒为 undefined 且不抛错(validate/preflight/render 全绿,只在 /__render-status 的 bindingErrors 留痕)。规范形:字段写 \`$<字段名>\`、整项写 \`$$\`、索引写 \`$_index\`。**这不是要你手改**:跑一次 \`autofix_schema.py <schema>\`(或 \`expand_ir.mjs\` 重新展开 IR)即自动归一化;命中说明该 schema 绕过了归一化管线。命中:${hit.join(' | ')}`,
1241
+ })
1242
+ })
1243
+
1203
1244
  // R51: customAction 里 this.data 只允许读 Input 绑定键的实时输入值;运行态变量一律 this.state
1204
1245
  const inputBoundKeys = new Set()
1205
1246
  walk(view, (n) => {