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
@@ -1,8 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * preflight.mjs — 生成前/后一键机械检查(替代 AI 手动过 Pre-flight Checklist)。
3
+ * preflight.mjs — 生成前/后一键机械检查(把 AI 需手动过的机械项一次性跑完)。
4
4
  *
5
- * 检查项(对应 quickref.md Pre-flight Checklist 12 条中可机械化的 13 条):
5
+ * 检查项(共 14 项;语义清单见 SKILL.md §8 Workflow A 步骤 4):
6
6
  * 1. 元素清单:spec text/slice/shape 数 vs schema 节点数(R29)
7
7
  * 2. 组件白名单:className ∈ component-meta.json(R28)
8
8
  * 3. Image itemValueFrom:静态路径必须 "2",变量 "1"(双向都拦:`"0"` 常量放路径、
@@ -17,7 +17,9 @@
17
17
  * 11. 切图引用含 URL 保留字符(`# ? % & +`)→ 浏览器截断请求、图片静默不显示(R31b)
18
18
  * 12. 横向流父容器里的容器子节点未写 rect.width + flexShrink:0 → 默认 100% 吃掉整行(R22b)
19
19
  * 13. 切图引用在 src/slices 里没有对应文件 → 渲染 404、图空白零报错(R31c)
20
- * —— 11/12/13 与 lint_card.mjs 共用 lib/layout_rules.mjs 与 lib/slice_dedupe.mjs,避免双写漂移。
20
+ * 14. 组件契约:属性键 / 样式组 / 样式子键必须在 component-meta.json + style-meta.json 白名单内(R28b)
21
+ * —— 不存在的键被运行时**整条静默丢弃**(Image 键写错 ⇒ 破图),历史四道闸全放行。
22
+ * —— 11/12/13 与 lint_card.mjs 共用 lib/layout_rules.mjs 与 lib/slice_dedupe.mjs;14 共用 lib/component_contract.mjs,避免双写漂移。
21
23
  *
22
24
  * 用法:
23
25
  * node preflight.mjs --spec UI/<画板>/spec.json --id <卡id>
@@ -31,6 +33,9 @@ import path from 'node:path'
31
33
  import { metaDir, cardsDir, slicesDir } from './lib/paths.mjs'
32
34
  import { buildSliceFileIndex, collectSliceRefStrings, findUrlReservedChars, isRemoteSliceRef, resolveSliceRefOnDisk, sliceNameFromRef } from './lib/slice_dedupe.mjs'
33
35
  import { collectRowChildNoWidth } from './lib/layout_rules.mjs'
36
+ import { loadContract, collectContractViolations, describeViolation } from './lib/component_contract.mjs'
37
+ import { collectImageValueFrom, collectImageNoHeight } from './lib/rules/image.mjs'
38
+ import { collectExprNoMathRound } from './lib/rules/expr.mjs'
34
39
 
35
40
  /* ── args ── */
36
41
  const args = {}
@@ -60,10 +65,12 @@ if (!schema) {
60
65
  const spec = args.spec ? loadJSONSafe(args.spec) : null
61
66
  const specCards = spec?.cards || []
62
67
 
63
- /* ── Load meta ── */
64
- const CM = loadJSONSafe(path.join(metaDir, 'component-meta.json'))
65
- const SM = loadJSONSafe(path.join(metaDir, 'style-meta.json'))
66
- const knownClasses = new Set(Object.keys(CM?.components || {}))
68
+ /* ── Load meta ──
69
+ * 组件/样式白名单唯一来源:lib/component_contract.mjs(内部编译 component-meta.json + style-meta.json)。
70
+ * 原先这里自建 `new Set(Object.keys(CM.components))`,与 lint 侧经 loadContract 得到的
71
+ * `contract.classes` **并不相等**——后者含内置类 `Root`(CM 里没有),且元数据读不到时
72
+ * 前者会把全部组件报成「不在白名单」。统一到一处,消除这条口径差。 */
73
+ const contract = loadContract({ metaDir })
67
74
 
68
75
  /* ── helpers ── */
69
76
  function getStyleChild(node, groupKey, childKey) {
@@ -113,40 +120,28 @@ if (specCards.length > 0) {
113
120
  }
114
121
  }
115
122
 
116
- /* ══ Check 2: Component whitelist (R28) ══ */
117
- for (const n of allNodes) {
118
- if (n.className && !knownClasses.has(n.className)) {
119
- check('r28-unknown-class', 'error', `${n.className} "${n.componentId}" 不在 component-meta.json 中 → 渲染空白(R28)`)
123
+ /* ══ Check 2: Component whitelist (R28) ══
124
+ * 白名单 = contract.classes(component-meta.json 的 components 键 ∪ 内置类 Root)。
125
+ * 元数据读不到时**不报**——满屏「不在白名单」只会淹没真正的问题(与 lint 同口径)。 */
126
+ if (contract.loaded.components) {
127
+ for (const n of allNodes) {
128
+ if (n.className && !contract.classes.has(n.className)) {
129
+ check('r28-unknown-class', 'error', `${n.className} "${n.componentId}" 不在 component-meta.json 中 → 渲染空白(R28)`)
130
+ }
120
131
  }
121
132
  }
122
133
 
123
- /* ══ Check 3: Image itemValueFrom (R25) ══ */
124
- for (const n of allNodes.filter(n => n.className === 'Image')) {
125
- const valProp = getProp(n, 'value')
126
- if (!valProp) continue
127
- const from = String(valProp.itemValueFrom || '')
128
- const val = String(valProp.itemValue || '')
129
- if (from === '0' && !val.startsWith('$')) {
130
- check('r25-image-from-0', 'error', `Image "${n.componentId}" itemValueFrom="0"(常量) 但值是路径 → 渲染器不走图片逻辑,空白(R25)。静态路径用 "2"`)
131
- }
132
- if (from === '1' && !val.startsWith('$')) {
133
- check('r25-image-from-1', 'error', `Image "${n.componentId}" itemValueFrom="1"(变量) 但值不以 $ 开头 → 表达式求值失败,空白(R25)`)
134
- }
135
- if (from === '2' && val.startsWith('$')) {
136
- check(
137
- 'r25-image-from-2',
138
- 'error',
139
- `Image "${n.componentId}" itemValueFrom="2"(图片/文件值) 但值是表达式 "${val}" → 运行时对 "2" 是**原样透传**(property.js onPreview),该字符串会直接进 background-image:url(${val}),画布必然空白(R25)。变量绑定必须改 "1"`,
140
- )
141
- }
134
+ /* ══ Check 3: Image itemValueFrom (R25) ══
135
+ * 判定与文案共享 lib/rules/image.mjs(与 lint_card.mjs 同一实现)。
136
+ * reportMissingProp=true —— 键名写错(如 itemKey:"image")会让本项与 Check 5 **双双短路跳过**,
137
+ * 四道闸全绿而图片死掉,故缺失 value 本身必须是 ERROR。 */
138
+ for (const f of collectImageValueFrom(schema.view, { reportMissingProp: true })) {
139
+ check(f.code, f.severity, f.message, f.detail)
142
140
  }
143
141
 
144
- /* ══ Check 4: Image rect.height (R32) ══ */
145
- for (const n of allNodes.filter(n => n.className === 'Image')) {
146
- const h = getStyleChild(n, 'rect', 'height')
147
- if (!h || !String(h.itemValue).trim()) {
148
- check('r32-image-no-height', 'error', `Image "${n.componentId}" 缺 rect.height → CSS aspect-ratio:16/9 会压缩图片高度(R32)。设显式高度`)
149
- }
142
+ /* ══ Check 4: Image rect.height (R32) ══(共享 lib/rules/image.mjs) */
143
+ for (const f of collectImageNoHeight(schema.view)) {
144
+ check(f.code, f.severity, f.message, f.detail)
150
145
  }
151
146
 
152
147
  /* ══ Check 5: Slice filename spaces (R31) ══ */
@@ -169,21 +164,10 @@ for (const n of allNodes.filter(n => n.className === 'Icon')) {
169
164
  }
170
165
  }
171
166
 
172
- /* ══ Check 7: Percentage expression Math.round (R23) ══ */
173
- function walkExprs(node) {
174
- const props = [...(node.properties || [])]
175
- for (const sp of node.style?.properties || []) {
176
- for (const c of sp.itemChildren?.properties || []) props.push(c)
177
- }
178
- for (const p of props) {
179
- if (String(p.itemValueFrom) === '1' && typeof p.itemValue === 'string') {
180
- if (/\*\s*100/.test(p.itemValue) && !/Math\.round/.test(p.itemValue)) {
181
- check('r23-no-math-round', 'error', `"${node.componentId}" 表达式含 *100 但无 Math.round → JS 浮点精度问题(R23): ${p.itemValue.slice(0, 50)}`)
182
- }
183
- }
184
- }
167
+ /* ══ Check 7: Percentage expression Math.round (R23) ══(共享 lib/rules/expr.mjs) */
168
+ for (const f of collectExprNoMathRound(schema.view)) {
169
+ check(f.code, f.severity, f.message, f.detail)
185
170
  }
186
- for (const n of allNodes) walkExprs(n)
187
171
 
188
172
  /* ══ Check 8: Divider for separators (R28) ══ */
189
173
  // Heuristic: Row with height ≤2 and background color but no children = likely a divider
@@ -273,6 +257,20 @@ for (const hit of collectRowChildNoWidth(schema.view)) {
273
257
  }
274
258
  }
275
259
 
260
+ /* ══ Check 14: Component contract — 属性键 / 样式组 / 样式子键白名单 ══
261
+ * 2026-09-24 事故:模型给 Image 写 itemKey:"image"(合法键只有 "value"),
262
+ * 运行时按 itemKey 绑定、不存在的键被整条静默丢弃 ⇒ value 为空、图片渲染成破图;
263
+ * 而 validate / lint / preflight / elements.missing **全部放行**。
264
+ * 全仓 82 处 Image 有 81 处写 value,唯一写 image 的正是这张卡 ⇒ 必须机械兜底。
265
+ * 白名单唯一来源 card-editor/meta/component-meta.json(经 lib/component_contract.mjs 编译)。 */
266
+ {
267
+ for (const v of collectContractViolations(schema, contract)) {
268
+ // unknown-class 由 Check 2 报(r28-unknown-class),此处只报属性键 / 样式组 / 样式子键
269
+ if (v.code === 'unknown-class') continue
270
+ check(`r28b-${v.code}`, v.severity, describeViolation(v), v.where ? `节点路径 ${v.where}` : '')
271
+ }
272
+ }
273
+
276
274
  /* ── Output ── */
277
275
  const errors = results.filter(r => r.severity === 'error')
278
276
  const warns = results.filter(r => r.severity === 'warn')