cardbuddy 0.11.0 → 0.12.1

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 (313) hide show
  1. package/README.md +46 -5
  2. package/dist/cli.js +51 -1
  3. package/dist/config.js +51 -16
  4. package/dist/core.js +2 -2
  5. package/dist/init.js +425 -0
  6. package/dist/preview-editor/assets/index-CHuGGIR3.js +276 -0
  7. package/dist/preview-editor/assets/{index-B4VZgNSK.css → index-CQScMhyg.css} +1 -1
  8. package/dist/preview-editor/index.html +2 -2
  9. package/dist/standalone.js +8 -0
  10. package/dist/vendored/mcp/client.mjs +537 -0
  11. package/dist/vendored/mcp/tools.mjs +268 -0
  12. package/dist/vendored/preview/assets/default-image.png +0 -0
  13. package/dist/{server-core → vendored/server/core}/ai-chat.js +82 -38
  14. package/dist/{server-core → vendored/server/core}/browser.js +1 -1
  15. package/dist/{server-core → vendored/server/core}/cardSave.js +8 -3
  16. package/dist/{server-core → vendored/server/core}/cardSync.js +6 -14
  17. package/dist/{server-core → vendored/server/core}/cardValidate.js +11 -8
  18. package/dist/{server-core → vendored/server/core}/index.js +5 -3
  19. package/dist/vendored/server/core/skillPaths.js +124 -0
  20. package/dist/{server-core → vendored/server/core}/sliceUpload.js +5 -8
  21. package/dist/vendored/skills/README.md +93 -0
  22. package/dist/vendored/skills/card-doctor/SKILL.md +52 -0
  23. package/dist/vendored/skills/card-skill-trainer/SKILL.md +312 -0
  24. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r038n.json +43 -0
  25. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r039n.json +47 -0
  26. package/dist/vendored/skills/card-skill-trainer/baselines/v3-r050n.json +48 -0
  27. package/dist/vendored/skills/card-skill-trainer/scripts/build_dataset.py +472 -0
  28. package/dist/vendored/skills/card-skill-trainer/scripts/build_sample.mjs +162 -0
  29. package/dist/vendored/skills/card-skill-trainer/scripts/diagnose_case.mjs +241 -0
  30. package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs +525 -0
  31. package/dist/vendored/skills/card-skill-trainer/scripts/round_diff.mjs +133 -0
  32. package/dist/vendored/skills/card-skill-trainer/scripts/run_round.mjs +1043 -0
  33. package/dist/vendored/skills/card-skill-trainer/scripts/score_round.mjs +195 -0
  34. package/dist/vendored/skills/card-skill-trainer/scripts/test_missing_slice.py +122 -0
  35. package/dist/vendored/skills/dsl-card-ai/SKILL.md +191 -0
  36. package/dist/vendored/skills/dsl-card-generator/SKILL.md +480 -0
  37. package/dist/vendored/skills/dsl-card-generator/config/render-contract.json +11 -0
  38. package/dist/vendored/skills/dsl-card-generator/references/amount_formatting.md +138 -0
  39. package/dist/vendored/skills/dsl-card-generator/references/card_index.json +1597 -0
  40. package/dist/vendored/skills/dsl-card-generator/references/card_templates.json +384 -0
  41. package/dist/vendored/skills/dsl-card-generator/references/card_to_summary.md +56 -0
  42. package/dist/vendored/skills/dsl-card-generator/references/component_rules.md +76 -0
  43. package/dist/vendored/skills/dsl-card-generator/references/component_specs.md +393 -0
  44. package/dist/vendored/skills/dsl-card-generator/references/dsl_structure.md +208 -0
  45. package/dist/vendored/skills/dsl-card-generator/references/event_patterns.md +287 -0
  46. package/dist/vendored/skills/dsl-card-generator/references/expression_engine.md +121 -0
  47. package/dist/vendored/skills/dsl-card-generator/references/field_name_dict.json +34 -0
  48. package/dist/vendored/skills/dsl-card-generator/references/field_naming.md +101 -0
  49. package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md +928 -0
  50. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/README.md +69 -0
  51. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/examples_index.json +2967 -0
  52. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/patterns.json +2835 -0
  53. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2.json +648 -0
  54. package/dist/vendored/skills/dsl-card-generator/references/handcrafted/recipes_v2_schema.md +295 -0
  55. package/dist/vendored/skills/dsl-card-generator/references/image_diff.md +48 -0
  56. package/dist/vendored/skills/dsl-card-generator/references/image_to_card.md +129 -0
  57. package/dist/vendored/skills/dsl-card-generator/references/ir-format.md +212 -0
  58. package/dist/vendored/skills/dsl-card-generator/references/message-center-pattern.md +149 -0
  59. package/dist/vendored/skills/dsl-card-generator/references/platform_jsapi.md +196 -0
  60. package/dist/vendored/skills/dsl-card-generator/references/previewer_contract.md +54 -0
  61. package/dist/vendored/skills/dsl-card-generator/references/quickref.md +197 -0
  62. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/absolute-badge.json +84 -0
  63. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/accordion-group-toggle.json +18 -0
  64. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertCard-pair.json +12 -0
  65. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/alertDialog-call.json +12 -0
  66. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-countdown.json +15 -0
  67. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-donut.json +15 -0
  68. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-gauge-score.json +11 -0
  69. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-radar.json +10 -0
  70. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/canvas-title-head.json +13 -0
  71. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/globalSet.json +12 -0
  72. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/label-col-modes.json +21 -0
  73. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/list-expand-collapse.json +17 -0
  74. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/money-format.json +11 -0
  75. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/opacity-switch.json +130 -0
  76. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/progress-bar.json +25 -0
  77. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/tab-billMode.json +15 -0
  78. package/dist/vendored/skills/dsl-card-generator/references/recipe_snippets/title-underline-overlay.json +21 -0
  79. package/dist/vendored/skills/dsl-card-generator/references/recipes.md +797 -0
  80. package/dist/vendored/skills/dsl-card-generator/references/rules.md +235 -0
  81. package/dist/vendored/skills/dsl-card-generator/references/slices_convention.md +177 -0
  82. package/dist/vendored/skills/dsl-card-generator/references/spec_to_schema_patterns.md +609 -0
  83. package/dist/vendored/skills/dsl-card-generator/references/ui_fidelity_rules.md +131 -0
  84. package/dist/vendored/skills/dsl-card-generator/scripts/add_component.mjs +118 -0
  85. package/dist/vendored/skills/dsl-card-generator/scripts/analyze_component_usage.mjs +153 -0
  86. package/dist/vendored/skills/dsl-card-generator/scripts/apply_opacity_pattern.mjs +343 -0
  87. package/dist/vendored/skills/dsl-card-generator/scripts/build_card_index.mjs +108 -0
  88. package/dist/vendored/skills/dsl-card-generator/scripts/build_card_templates.mjs +190 -0
  89. package/dist/vendored/skills/dsl-card-generator/scripts/check_fidelity.mjs +257 -0
  90. package/dist/vendored/skills/dsl-card-generator/scripts/check_magic_values.mjs +79 -0
  91. package/dist/vendored/skills/dsl-card-generator/scripts/crop_slices.mjs +98 -0
  92. package/dist/vendored/skills/dsl-card-generator/scripts/describe_card.mjs +265 -0
  93. package/dist/vendored/skills/dsl-card-generator/scripts/diff_bands.mjs +257 -0
  94. package/dist/vendored/skills/dsl-card-generator/scripts/diff_card.mjs +316 -0
  95. package/dist/vendored/skills/dsl-card-generator/scripts/expand_ir.mjs +873 -0
  96. package/dist/vendored/skills/dsl-card-generator/scripts/extract_handcrafted.py +1199 -0
  97. package/dist/vendored/skills/dsl-card-generator/scripts/extract_subtree.mjs +191 -0
  98. package/dist/vendored/skills/dsl-card-generator/scripts/generate_cards.mjs +389 -0
  99. package/dist/vendored/skills/dsl-card-generator/scripts/inventory_schemas.py +160 -0
  100. package/dist/vendored/skills/dsl-card-generator/scripts/iterate.mjs +700 -0
  101. package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_image.mjs +56 -0
  102. package/dist/vendored/skills/dsl-card-generator/scripts/lib/design_sample.mjs +328 -0
  103. package/dist/vendored/skills/dsl-card-generator/scripts/lib/layout-tokens.mjs +79 -0
  104. package/dist/vendored/skills/dsl-card-generator/scripts/lib/paths.mjs +103 -0
  105. package/dist/vendored/skills/dsl-card-generator/scripts/lib/scaffold.mjs +575 -0
  106. package/dist/vendored/skills/dsl-card-generator/scripts/lib/slicePath.mjs +81 -0
  107. package/dist/vendored/skills/dsl-card-generator/scripts/lib/slice_dedupe.mjs +147 -0
  108. package/dist/vendored/skills/dsl-card-generator/scripts/lint_autofix.mjs +363 -0
  109. package/dist/vendored/skills/dsl-card-generator/scripts/lint_card.mjs +1399 -0
  110. package/dist/vendored/skills/dsl-card-generator/scripts/preflight.mjs +249 -0
  111. package/dist/vendored/skills/dsl-card-generator/scripts/register_card_template.mjs +208 -0
  112. package/dist/vendored/skills/dsl-card-generator/scripts/render_baseline.mjs +231 -0
  113. package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs +801 -0
  114. package/dist/vendored/skills/dsl-card-generator/scripts/render_diff.mjs +239 -0
  115. package/dist/vendored/skills/dsl-card-generator/scripts/resolve_card_template.mjs +73 -0
  116. package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs +447 -0
  117. package/dist/vendored/skills/dsl-card-generator/scripts/scaffold_card.mjs +81 -0
  118. package/dist/vendored/skills/dsl-card-generator/scripts/slices_normalize.mjs +316 -0
  119. package/dist/vendored/skills/dsl-card-generator/scripts/spec_audit.mjs +462 -0
  120. package/dist/vendored/skills/dsl-card-generator/scripts/spec_to_schema_v3.mjs +7735 -0
  121. package/dist/vendored/skills/dsl-card-generator/scripts/spec_tree.mjs +355 -0
  122. package/dist/vendored/skills/dsl-card-generator/scripts/validate_all_schemas.py +71 -0
  123. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/default-image-wzZYQ86K.png +0 -0
  124. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-C9k-07y7.css +1 -0
  125. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/standalone-oFRM4f4V.js +55 -0
  126. package/dist/vendored/skills/dsl-card-generator/vendor/preview/assets/svg-symbols-B2exBrAr.svg +118 -0
  127. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/component-meta.json +2714 -0
  128. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/directive-meta.json +40 -0
  129. package/dist/vendored/skills/dsl-card-generator/vendor/preview/meta/style-meta.json +1086 -0
  130. package/dist/vendored/{standalone.html → skills/dsl-card-generator/vendor/preview/standalone.html} +2 -1
  131. package/dist/vendored/skills/finmall-card-sync/SKILL.md +262 -0
  132. package/dist/vendored/skills/finmall-session-navigator/SKILL.md +169 -0
  133. package/dist/vendored/skills/finmall-session-navigator/scripts/finmall_login.mjs +882 -0
  134. package/dist/vendored/skills/finmall-session-navigator/scripts/package-lock.json +59 -0
  135. package/dist/vendored/skills/finmall-session-navigator/scripts/package.json +10 -0
  136. package/dist/vendored/skills/finmall-session-navigator/scripts/session-manager.mjs +96 -0
  137. package/dist/vendored/skills/shared/README.md +55 -0
  138. package/dist/vendored/skills/shared/auth-model.md +79 -0
  139. package/dist/vendored/skills/sketch-spec-to-card/SKILL.md +329 -0
  140. package/dist/vendored/skills/sketch-spec-to-card/references/boundary.json +14 -0
  141. package/dist/vendored/skills/sketch-spec-to-card/references/card_refs.json +13 -0
  142. package/dist/vendored/skills/sketch-spec-to-card/references/spec-schema.md +103 -0
  143. package/dist/vendored/skills/sketch-spec-to-card/scripts/build_prompt.py +797 -0
  144. package/dist/vendored/skills/sketch-spec-to-card/scripts/card_refs.py +94 -0
  145. package/dist/vendored/skills/sketch-spec-to-card/scripts/cluster_states.py +706 -0
  146. package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py +1781 -0
  147. package/dist/vendored/skills/sketch-spec-to-card/scripts/png_utils.py +318 -0
  148. package/dist/vendored/skills/sketch-spec-to-card/scripts/vision.py +1118 -0
  149. package/dist/vendored/templates/helloCard/data.json +10 -0
  150. package/dist/vendored/templates/helloCard/schema.json +238 -0
  151. package/dist/vendored/tools/link-skills.mjs +485 -0
  152. package/package.json +2 -1
  153. package/dist/preview-editor/assets/index-jl4YJzKv.js +0 -180
  154. package/dist/vendored/App.vue +0 -2858
  155. package/dist/vendored/ansi.js +0 -185
  156. package/dist/vendored/assets/apple-touch-icon.png +0 -0
  157. package/dist/vendored/assets/default-image.png +0 -0
  158. package/dist/vendored/assets/favicon-16.png +0 -0
  159. package/dist/vendored/assets/favicon-32.png +0 -0
  160. package/dist/vendored/assets/site-icon.png +0 -0
  161. package/dist/vendored/assets/svgIcons/icons.svg +0 -87
  162. package/dist/vendored/assets/svgIcons/index.js +0 -39
  163. package/dist/vendored/components/AiSettings.vue +0 -392
  164. package/dist/vendored/components/AlertCardInstance.vue +0 -58
  165. package/dist/vendored/components/AlertCardLayer.vue +0 -59
  166. package/dist/vendored/components/ApiCallPanel.vue +0 -127
  167. package/dist/vendored/components/ApiPayloadTree.vue +0 -201
  168. package/dist/vendored/components/AppToast.vue +0 -37
  169. package/dist/vendored/components/CardGallery.vue +0 -291
  170. package/dist/vendored/components/CardPreview.vue +0 -72
  171. package/dist/vendored/components/CardSelect.vue +0 -206
  172. package/dist/vendored/components/ChatComposer.vue +0 -413
  173. package/dist/vendored/components/ChatMessage.vue +0 -383
  174. package/dist/vendored/components/ChatPanel.vue +0 -937
  175. package/dist/vendored/components/ComponentPalette.vue +0 -301
  176. package/dist/vendored/components/ConfirmDialog.vue +0 -54
  177. package/dist/vendored/components/DatePickerOverlay.vue +0 -345
  178. package/dist/vendored/components/DebugPanel.vue +0 -1734
  179. package/dist/vendored/components/DeviceOverlay.vue +0 -70
  180. package/dist/vendored/components/Dropdown.vue +0 -193
  181. package/dist/vendored/components/EventEditor.vue +0 -273
  182. package/dist/vendored/components/HoverGuides.vue +0 -122
  183. package/dist/vendored/components/JsonTree.vue +0 -547
  184. package/dist/vendored/components/LogValue.vue +0 -52
  185. package/dist/vendored/components/MarkdownBody.vue +0 -64
  186. package/dist/vendored/components/NewCardDialog.vue +0 -132
  187. package/dist/vendored/components/NodeInspector.vue +0 -295
  188. package/dist/vendored/components/NumberStepper.vue +0 -125
  189. package/dist/vendored/components/PickerOverlay.vue +0 -131
  190. package/dist/vendored/components/PropControl.vue +0 -245
  191. package/dist/vendored/components/PropTree.vue +0 -128
  192. package/dist/vendored/components/RemotePreview.vue +0 -173
  193. package/dist/vendored/components/SelectionOverlay.vue +0 -105
  194. package/dist/vendored/components/StructureTree.vue +0 -1002
  195. package/dist/vendored/components/Switch.vue +0 -38
  196. package/dist/vendored/components/setters/SetBgPosition.vue +0 -64
  197. package/dist/vendored/components/setters/SetBgSize.vue +0 -90
  198. package/dist/vendored/components/setters/SetCode.vue +0 -198
  199. package/dist/vendored/components/setters/SetColor.vue +0 -244
  200. package/dist/vendored/components/setters/SetCustomSelect.vue +0 -58
  201. package/dist/vendored/components/setters/SetExpr.vue +0 -107
  202. package/dist/vendored/components/setters/SetGradient.vue +0 -125
  203. package/dist/vendored/components/setters/SetGrid9.vue +0 -68
  204. package/dist/vendored/components/setters/SetIconSelect.vue +0 -67
  205. package/dist/vendored/components/setters/SetIfForm.vue +0 -61
  206. package/dist/vendored/components/setters/SetImage.vue +0 -43
  207. package/dist/vendored/components/setters/SetList.vue +0 -139
  208. package/dist/vendored/components/setters/SetNumber.vue +0 -118
  209. package/dist/vendored/components/setters/SetNumberStyle.vue +0 -113
  210. package/dist/vendored/components/setters/SetPadding.vue +0 -77
  211. package/dist/vendored/components/setters/SetSegment.vue +0 -160
  212. package/dist/vendored/components/setters/SetSelect.vue +0 -51
  213. package/dist/vendored/components/setters/SetSwitch.vue +0 -49
  214. package/dist/vendored/components/setters/SetText.vue +0 -52
  215. package/dist/vendored/components/setters/props.js +0 -23
  216. package/dist/vendored/fidelity/baseline-messageOverview.json +0 -87
  217. package/dist/vendored/fidelity/calibration.json +0 -29
  218. package/dist/vendored/fidelity/fidelity-messageOverview-after.html +0 -114
  219. package/dist/vendored/fidelity/fidelity-messageOverview-after.json +0 -272
  220. package/dist/vendored/fidelity/fidelity-messageOverview.html +0 -185
  221. package/dist/vendored/fidelity/fidelity-messageOverview.json +0 -336
  222. package/dist/vendored/fidelity/fidelity-messageOverview_v2.html +0 -262
  223. package/dist/vendored/fidelity/fidelity-messageOverview_v2.json +0 -502
  224. package/dist/vendored/fidelity/fidelity-messageOverview_v3.html +0 -201
  225. package/dist/vendored/fidelity/fidelity-messageOverview_v3.json +0 -417
  226. package/dist/vendored/fidelity/fidelity-messageOverview_visual.html +0 -125
  227. package/dist/vendored/fidelity/fidelity-messageOverview_visual.json +0 -338
  228. package/dist/vendored/index.html +0 -16
  229. package/dist/vendored/main.js +0 -37
  230. package/dist/vendored/runtime/ai-api.js +0 -165
  231. package/dist/vendored/runtime/alert-card.js +0 -125
  232. package/dist/vendored/runtime/app-toast.js +0 -33
  233. package/dist/vendored/runtime/clipboard-node.js +0 -78
  234. package/dist/vendored/runtime/clipboard.js +0 -29
  235. package/dist/vendored/runtime/event-model.js +0 -300
  236. package/dist/vendored/runtime/hoverGuide.js +0 -31
  237. package/dist/vendored/runtime/jsapi-mock.js +0 -256
  238. package/dist/vendored/runtime/markdown.js +0 -140
  239. package/dist/vendored/runtime/node-model.js +0 -217
  240. package/dist/vendored/skills/.manifest.json +0 -1101
  241. package/dist/vendored/standalone-main.js +0 -36
  242. package/dist/vendored/styles/ai-chat.css +0 -1850
  243. package/dist/vendored/styles/app.css +0 -3648
  244. package/dist/vendored/styles/card-gallery.css +0 -285
  245. package/dist/vendored/styles/card-select.css +0 -288
  246. package/dist/vendored/styles/components.css +0 -383
  247. package/dist/vendored/styles/dropdown.css +0 -324
  248. package/dist/vendored/styles/json-tree.css +0 -308
  249. package/dist/vendored/styles/node-inspector.css +0 -800
  250. package/dist/vendored/styles/setters.css +0 -1050
  251. package/dist/vendored/styles/standalone.css +0 -27
  252. package/dist/vendored/styles/structure-tree.css +0 -460
  253. /package/dist/vendored/{api.js → preview/api.js} +0 -0
  254. /package/dist/vendored/{assets → preview/assets}/svg-symbols.svg +0 -0
  255. /package/dist/vendored/{components → preview/components}/AbsoluteLayout.vue +0 -0
  256. /package/dist/vendored/{components → preview/components}/Button.vue +0 -0
  257. /package/dist/vendored/{components → preview/components}/Canvas.vue +0 -0
  258. /package/dist/vendored/{components → preview/components}/CheckGroup.vue +0 -0
  259. /package/dist/vendored/{components → preview/components}/Column.vue +0 -0
  260. /package/dist/vendored/{components → preview/components}/CustomPlaceholder.vue +0 -0
  261. /package/dist/vendored/{components → preview/components}/Divider.vue +0 -0
  262. /package/dist/vendored/{components → preview/components}/GridLayout.vue +0 -0
  263. /package/dist/vendored/{components → preview/components}/Icon.vue +0 -0
  264. /package/dist/vendored/{components → preview/components}/Image.vue +0 -0
  265. /package/dist/vendored/{components → preview/components}/Input.vue +0 -0
  266. /package/dist/vendored/{components → preview/components}/ListLayout.vue +0 -0
  267. /package/dist/vendored/{components → preview/components}/Map.vue +0 -0
  268. /package/dist/vendored/{components → preview/components}/MultiColumn.vue +0 -0
  269. /package/dist/vendored/{components → preview/components}/MultiText.vue +0 -0
  270. /package/dist/vendored/{components → preview/components}/ProgressSlider.vue +0 -0
  271. /package/dist/vendored/{components → preview/components}/RadioButton.vue +0 -0
  272. /package/dist/vendored/{components → preview/components}/RenderTree.vue +0 -0
  273. /package/dist/vendored/{components → preview/components}/Root.vue +0 -0
  274. /package/dist/vendored/{components → preview/components}/Row.vue +0 -0
  275. /package/dist/vendored/{components → preview/components}/SvgCode.vue +0 -0
  276. /package/dist/vendored/{components → preview/components}/SvgSymbols.vue +0 -0
  277. /package/dist/vendored/{components → preview/components}/Text.vue +0 -0
  278. /package/dist/vendored/{components → preview/components}/Video.vue +0 -0
  279. /package/dist/vendored/{components → preview/components}/ViewContainer.vue +0 -0
  280. /package/dist/vendored/{components → preview/components}/base.js +0 -0
  281. /package/dist/vendored/{components → preview/components}/icons.js +0 -0
  282. /package/dist/vendored/{components → preview/components}/index.js +0 -0
  283. /package/dist/vendored/{meta → preview/meta}/component-meta.json +0 -0
  284. /package/dist/vendored/{meta → preview/meta}/directive-meta.json +0 -0
  285. /package/dist/vendored/{meta → preview/meta}/style-meta.json +0 -0
  286. /package/dist/vendored/{runtime → preview/runtime}/StyleParser.js +0 -0
  287. /package/dist/vendored/{runtime → preview/runtime}/adapter.js +0 -0
  288. /package/dist/vendored/{runtime → preview/runtime}/assets.js +0 -0
  289. /package/dist/vendored/{runtime → preview/runtime}/canvas-context.js +0 -0
  290. /package/dist/vendored/{runtime → preview/runtime}/card-runtime.js +0 -0
  291. /package/dist/vendored/{runtime → preview/runtime}/evaluate.js +0 -0
  292. /package/dist/vendored/{runtime → preview/runtime}/property.js +0 -0
  293. /package/dist/vendored/{runtime → preview/runtime}/selectionOverlay.js +0 -0
  294. /package/dist/vendored/{runtime → preview/runtime}/toPreview.js +0 -0
  295. /package/dist/{server-core → vendored/server/core}/assetProxy.js +0 -0
  296. /package/dist/{server-core → vendored/server/core}/bbox.js +0 -0
  297. /package/dist/{server-core → vendored/server/core}/buildDataFromSchema.js +0 -0
  298. /package/dist/{server-core → vendored/server/core}/cardFiles.js +0 -0
  299. /package/dist/{server-core → vendored/server/core}/cardHistory.js +0 -0
  300. /package/dist/{server-core → vendored/server/core}/cardImage.js +0 -0
  301. /package/dist/{server-core → vendored/server/core}/cardImportMeta.js +0 -0
  302. /package/dist/{server-core → vendored/server/core}/cardListCache.js +0 -0
  303. /package/dist/{server-core → vendored/server/core}/cardOpenFolder.js +0 -0
  304. /package/dist/{server-core → vendored/server/core}/cardSidecar.js +0 -0
  305. /package/dist/{server-core → vendored/server/core}/codeBridge.js +0 -0
  306. /package/dist/{server-core → vendored/server/core}/logStream.js +0 -0
  307. /package/dist/{server-core → vendored/server/core}/logger.js +0 -0
  308. /package/dist/{server-core → vendored/server/core}/nodeModels.js +0 -0
  309. /package/dist/{server-core → vendored/server/core}/renderStatus.js +0 -0
  310. /package/dist/{server-core → vendored/server/core}/screenshot.js +0 -0
  311. /package/dist/{server-core → vendored/server/core}/sliceStatic.js +0 -0
  312. /package/dist/vendored/{meta → skills/dsl-card-generator/vendor/preview/meta}/action-meta.json +0 -0
  313. /package/dist/{server-core/_vendor → vendored/tools}/finmall-env.mjs +0 -0
@@ -0,0 +1,287 @@
1
+ # 事件模式与运行时机制(Event Patterns & Runtime Mechanics)
2
+
3
+ 49 张导出 + vendor/preview/runtime/{card-runtime.js,alert-card.js,jsapi-mock.js} + RenderTree.vue 的提炼。事件机制、运行时数据模型、JSAPI 调用范式。
4
+
5
+ ## eventaction 形状
6
+
7
+ ```
8
+ {
9
+ "eventactions": [
10
+ {
11
+ "event": { "eventName": "点击事件", "eventKey": "click" },
12
+ "action": {
13
+ "actionType": "customAction",
14
+ "properties": [
15
+ { "itemKey": "function", "itemValue": { "code": "var that = this;\n...", "compiled": "var that = this;\n..." } }
16
+ ]
17
+ }
18
+ }
19
+ ]
20
+ }
21
+ ```
22
+
23
+ 生成 customAction 时 code 与 compiled 保持同步(compiled 是 var 形式)。
24
+
25
+ ## 三个易混概念
26
+
27
+ - event.eventKey:卡片引擎事件(click)。
28
+ - action.actionType:DSL action 包装(customAction)。
29
+ - ynet.callJSAPI(...):customAction JS 里调的原生/客户端 API。
30
+
31
+ ## eventKey(49 卡实测)
32
+
33
+ | eventKey | 次数 | 典型节点 | 用途 |
34
+ | --- | --- | --- | --- |
35
+ | click | 132 | Row/Button/Icon/Text/列表容器 | 用户交互 |
36
+ | onReady | 29 | Root | 初始化、路由启动、数据监听注册 |
37
+ | onMeasured | 26 | Canvas | Canvas 测量与绘图 |
38
+
39
+ 就绪类生命周期 eventKey(""/onReady/onLoad/onCreate)在首帧前由 runLoadActions 执行一次,不注册成被动 handler(避免与组件自身 emit 重复触发)。其余事件(click/onMeasured)注册成被动 handler,由交互/组件触发。
40
+
41
+ ## actionType(49 卡实测)
42
+
43
+ | actionType | 次数 | 结构 | 说明 |
44
+ | --- | --- | --- | --- |
45
+ | customAction | 190 | properties[].itemKey="function" 含 JS | 逻辑主形态 |
46
+ | startRouter | — | urlType/targetUrl/isLoginNeeded | 路由跳转,可作直接 action 或 JSAPI |
47
+ | closeAlertCard | 3 | 直接 action 无需 properties | 关闭当前弹窗卡 |
48
+ | sendAiChatMessage | 1 | 直接 action 含 message | 发 AI 消息 |
49
+
50
+ alertCard/alertDialog/showToast/showPicker/showDatePicker/showLoadingEx/showKeyboard/hideKeyboard/copyToClipboard/mockReceiveMessage 等**不是** actionType,是 customAction 里的 JSAPI 调用。
51
+
52
+ ## 运行时数据模型(customAction 的 this)
53
+
54
+ > **关键**:事件代码读写运行态变量一律用 **`this.state`**(即 rt.state,写走 `this.setData`);**`this.data` 仅允许读 Input 绑定键的实时输入值**(渲染层 onInput 兜底把 Input 输入回写 rt.state)。预览运行时把 this.data 别名到 rt.state 属兼容行为,平台约定不允许把 this.data 当通用变量通道——用它读普通运行态会被 lint `r51` 拦截。**调试交互(输入、点击切换)一律只写 rt.state、绝不回写 rt.rootScope**——这就是打字不触发"保存到本地"脏标记的原因。
55
+
56
+ | API | 含义 |
57
+ | --- | --- |
58
+ | this.state | 可变运行态(= rt.state)。setData 后保存于 JS 的可改值 |
59
+ | this.data | **仅**读 Input 绑定键的实时输入值(唯一合法用途);运行态变量一律 this.state |
60
+ | this.setData(patch) | 合并到 state 并 markDirty 重渲染 |
61
+ | this.setRootData(patch) | 改根作用域 rt.rootScope(持久化数据,触发"保存到本地"脏标记)——只在确实要写盘时用 |
62
+ | this.addEventListener(name, fn) | 注册内部事件监听器 |
63
+ | this.postMessage(name, payload) | 向注册同名监听器的节点发消息 |
64
+ | event | 事件载荷。含 instanceId;onMeasured 提供 event.canvas |
65
+
66
+ 读写约定:
67
+ - 运行态变量(选中态/锁定态/用户输入/绑定派生值等)一律用 this.state 读(如 this.state.payAmount 拿 Input 当前输入);**唯一例外**:Input 绑定键的实时输入值可用 this.data 读(如 this.data.payAmount)。
68
+ - 持久卡片态存 this.state;写一律走 this.setData。
69
+ - 任何应重渲染的改动后调 this.setData(...)。
70
+ - **绝不**通过 this.setRootData 把调试交互写回 rootScope(会污染"保存到本地"基线)。
71
+ - **指针安全(铁律)**:customAction 的 `code` 第一行写 `var self = this;`,**嵌套回调里一律用 `self` 不用 `this`**(`this` 在回调里被重绑会指向错误对象)。完整约束见 `references/rules.md §四`。
72
+ - **分号铁律**:customAction 的 `code` / `compiled` 每条 JS 语句结尾**必须带 `;`**,禁止依赖 ASI 省略(避免 `return`/对象字面量换行陷阱,且与导出卡风格一致)。完整约束见 `references/rules.md §四`。
73
+
74
+ ## 写值范式
75
+
76
+ ```javascript
77
+ // 整体替换
78
+ this.state.showAll = !this.state.showAll;
79
+ this.setData(this.state);
80
+
81
+ // 小更新
82
+ this.setData({ cannotClick: true });
83
+
84
+ // Input 实时值读取:this.data 是唯一入口(渲染层 onInput 兜底回写 rt.state)
85
+ // 普通运行态变量一律 this.state 读(this.data 读普通变量会被 lint r51 拦截)
86
+ var amount = this.data.payAmount; // 仅因 payAmount 绑 Input value 才合法
87
+ ```
88
+
89
+ ## 内部事件(addEventListener / postMessage)
90
+
91
+ 49 卡实测内部事件名:updateData、globalSet、globalUpdateItem、syncList、clearVerifyTimer、sendVerfiyClick、refreshCardMoney、appThemeChanged。
92
+
93
+ 典型结构:
94
+
95
+ ```javascript
96
+ var self = this;
97
+ this.addEventListener('updateData', function (event) {
98
+ var data = event.data;
99
+ self.state[data.key] = data.value;
100
+ self.setData(self.state);
101
+ });
102
+ ```
103
+
104
+ globalSet 是子→父数据透传的标准模式。**铁律 r54**:List/GridLayout item 事件里修改绑定数据一律 `postMessage('globalSet', patch)`(patch 与 setData 入参逐字一致),根节点 onReady `addEventListener('globalSet')` 监听代 `setData(patch)`;完整代码见 recipes.md §globalSet(历史卡 {key,value}+$set 为卡内旧实现,非现范式)。
105
+
106
+ **铁律 r55(item 字段在事件里直读)**:slotScope 事件脚本里读当前 item 字段直接 `this.state.<field>`(如 `var q = this.state.query;`),平台保证字段已展开到 state;**禁止 `$$` / `this.state.$$` / `$$.field` 及任何「$$ 兜底判断」**(如 `if (q === undefined && this.state.$$) q = this.state.$$.query;`)——这类写法把平台保证误当成不确定行为,lint `r55` ERROR 拦截。
107
+
108
+ ## JSAPI 调用范式
109
+
110
+ **铁律 r56**:一律裸调 `ynet.callJSAPI(name, params, cb)`(ynet 为平台注入全局);禁止 `window.ynet` 前缀与 `typeof window !== 'undefined' && window.ynet && ...` 存在性守卫,lint `r56` ERROR 拦截。
111
+
112
+ ### onReady 初始化(assetOverview 风格)
113
+
114
+ ```javascript
115
+ var that = this;
116
+ this.state.cannotClick = false;
117
+ var result = (this.state.currCard.balanceList || []).find(function (item) {
118
+ return item.code === that.state.currentCurrency.code;
119
+ });
120
+ this.state.currBalance = result ? result.amount : '0';
121
+ this.state.amountUnavailable = Number(this.state.foreignAmount) > Number(this.state.currBalance);
122
+ this.setData(this.state);
123
+ ```
124
+
125
+ ### 外部数据更新监听
126
+
127
+ ```javascript
128
+ var self = this;
129
+ this.addEventListener('updateData', function (event) {
130
+ var key = event.data.key;
131
+ var val = event.data.value;
132
+ self.state[key] = val;
133
+ self.setData(self.state);
134
+ });
135
+ ```
136
+
137
+ ### Picker
138
+
139
+ ```javascript
140
+ var that = this;
141
+ var list = this.state.currencyList.map(function (item) {
142
+ return { text: item.text, key: item.code, data: item, children: [] };
143
+ });
144
+ ynet.callJSAPI('showPicker', {
145
+ title: '选择币种',
146
+ mode: 'single',
147
+ dataSource: list,
148
+ currentValue: [[that.state.currentCurrency.code]]
149
+ }, function (res) {
150
+ if (res.error === '0') {
151
+ var item = res.result[0].data;
152
+ that.setData({ currentCurrency: item });
153
+ }
154
+ });
155
+ ```
156
+
157
+ ### Date Picker
158
+
159
+ ```javascript
160
+ var that = this;
161
+ ynet.callJSAPI('showDatePicker', {
162
+ title: '选择日期',
163
+ type: 'year_month_day',
164
+ dateFormat: 'YYYY-MM-dd',
165
+ startDate: '1970-1-1',
166
+ endDate: '2100-12-31'
167
+ }, function (res) {
168
+ var val = res.data || res.currentDate;
169
+ if (res.error === '0') {
170
+ that.setData({ payeeBirthday: val });
171
+ }
172
+ });
173
+ ```
174
+
175
+ ### Toast / AlertDialog
176
+
177
+ ```javascript
178
+ ynet.callJSAPI('showToast', { message: '请输入还款金额', showIcon: '0' }, function () {});
179
+ ynet.callJSAPI('alertDialog', {
180
+ title: '温馨提示', message: '余额不足',
181
+ okButton: '确定', cancelButton: '',
182
+ clickBgToHide: false, cancelGrayStyle: true
183
+ }, function (data) {});
184
+ ```
185
+
186
+ ### 提交守卫(cannotClick)
187
+
188
+ ```javascript
189
+ if (!this.state.cannotClick) {
190
+ // 校验...
191
+ this.state.cannotClick = true;
192
+ this.setData(this.state);
193
+ ynet.callJSAPI('sendAiChatMessage', { message: '确认还款', data: { formData: JSON.stringify(this.state) } }, function () {});
194
+ }
195
+ ```
196
+
197
+ ### 步骤导航
198
+
199
+ ```javascript
200
+ if (this.state.formStep > 2) { this.setData({ formStep: 2 }); }
201
+ ```
202
+
203
+ ### startRouter(直接 action)
204
+
205
+ ```
206
+ {
207
+ "event": { "eventName": "初始化完成", "eventKey": "onReady" },
208
+ "action": {
209
+ "actionType": "startRouter",
210
+ "properties": [
211
+ { "itemKey": "urlType", "itemValue": "2" },
212
+ { "itemKey": "targetUrl", "itemValue": "" },
213
+ { "itemKey": "isLoginNeeded", "itemValue": "1" }
214
+ ]
215
+ }
216
+ }
217
+ ```
218
+
219
+ ### Canvas onMeasured
220
+
221
+ ```javascript
222
+ var canvas = event.canvas;
223
+ var ctx = canvas.getContext('2d');
224
+ ctx.font = 'bold 16px Arial';
225
+ ctx.fillStyle = '#333';
226
+ ctx.fillText(this.state.title, 0, canvas.height / 2);
227
+ ```
228
+
229
+ 仅 Canvas 的 onMeasured 有 event.canvas;click 事件无 event.canvas。完整画布标题头见 recipes.md §Canvas。
230
+
231
+ ## alertCard / closeAlertCard
232
+
233
+ alertCard(JSAPI,非 actionType):
234
+
235
+ ```javascript
236
+ ynet.callJSAPI('alertCard', {
237
+ cardCode: 'billListDialog',
238
+ data: { title: '账单详情', list: this.state.billList, parentInstanceId: event.instanceId },
239
+ gravity: 'bottom'
240
+ }, function (data) {
241
+ if (data.success) { /* data.data.event === 'hidden' 或子卡回传 */ }
242
+ });
243
+ ```
244
+
245
+ closeAlertCard:
246
+
247
+ ```javascript
248
+ // 仅关闭
249
+ ynet.callJSAPI('closeAlertCard', { cardCode: 'billListDialog' }, function () {});
250
+ // 关闭并回传「选中项」——只回传父卡需要的字段,绝不把整个 this.state 甩给父卡
251
+ ynet.callJSAPI('closeAlertCard', {
252
+ data: {
253
+ selected: {
254
+ acctNum: this.state.acctNum,
255
+ branchNodeName: this.state.branchNodeName,
256
+ balance: this.state.balance
257
+ }
258
+ }
259
+ }, function () {});
260
+ ```
261
+
262
+ > **参数传递铁律(消此类 bug)**:子卡 `closeAlertCard` 回传的 `data` 必须**显式构造、只含父卡需要的字段**,禁止 `data: this.state`(会把 `list`/`title`/`parentInstanceId` 等父卡注入的 payload 连同整个子卡作用域一起甩给父卡)。
263
+ > 父卡 `alertCard` 回调里**绝不直接 `that.state.xxx = res.data` / `that.state.xxx = res.data.currCard` 整体赋值**——必须按字段显式提取,例如:
264
+ > ```javascript
265
+ > that.state.currCard = {
266
+ > acctNum: res.data.selected.acctNum,
267
+ > branchNodeName: res.data.selected.branchNodeName,
268
+ > balance: res.data.selected.balance
269
+ > };
270
+ > that.setData(that.state);
271
+ > ```
272
+ > 原因:运行时 `rt.state` 是 `reactive`,父卡读到的是 Vue 包在子卡对象外的 **Proxy**;子卡 `this.state` 还混有父卡传入的 `list`/`title`/`parentInstanceId`,直接整体赋值会让父卡 `currCard` 字段对不上(缺 `acctNum`/`branchNodeName`/`balance`,或混入无关字段)。实测案例:`transfersjump/row_2d` 接收 `accountCardList` 回传,原 `that.state.currCard = tmp.currCard` 导致字段缺失。详见 `references/generation_pitfalls.md §10`。
273
+
274
+ 同名 Dialog 表与"查看更多"两种模式(就地展开 vs 弹窗)见 recipes.md §alertCard 与 §列表展开收起。
275
+
276
+ ## 生成清单
277
+
278
+ - eventKey 匹配组件在样板里支持的行为。
279
+ - 用 customAction 写 JS 逻辑。
280
+ - 区分 this.state(运行态变量统一读写入口)/ this.data(仅读 Input 绑定键实时输入值)与 setRootData(写持久化 rt.rootScope);调试交互绝不写 setRootData。
281
+ - 状态改后调 this.setData(...)。
282
+ - 开子/alert 卡需回信时传 parentInstanceId: event.instanceId。
283
+ - 重复点击敏感的提交按钮用 cannotClick 守卫。
284
+ - 勿臆造 JSAPI 名;复用实测名或查 platform_jsapi.md。
285
+ - 勿仅凭 palette/源码注册就声称组件或 action 可用;要求导出 JSON 形状。
286
+ - 保留 itemValueFrom/itemDefaultValue/itemCondition/itemChildren;customAction 保留 code 与 compiled。
287
+ - 生成代码只用实测出现过的 API。
@@ -0,0 +1,121 @@
1
+ # 表达式引擎与数据绑定(Expression Engine & Data Binding)
2
+
3
+ 卡片 DSL 的数据绑定不是 {{ }} 模板,而是 **$ 前缀的 JS 表达式**。本文是 vendor/preview/runtime/evaluate.js + property.js + toPreview.js 的提炼,给出可安全生成的表达式规则与片段库。
4
+
5
+ ## 1. 求值模型(evalExpr)
6
+
7
+ - 作用域对象先转成 $ 前缀形式:{ list: [], _index: 0 } → { $list: [], $_index: 0 }。唯一例外是 $$(作用域插槽当前 item)保持原名。
8
+ - 求值用 `new Function('vars', 'with(vars){ return (expr) }')`,vars 用 Proxy 包裹:未定义的 $ 变量解析为 undefined(不抛 ReferenceError),故 `$foo || 默认值` 兜底可正常生效;真正的语法错误仍抛错并被上层 try/catch。
9
+ - 示例:`$amount > 0 ? '#f00' : '#0a0'`、`$theme[$level*1-1].bg`、`$title.length*16`、`$billMode === '1' ? '已出账单' : '未出账单'`。
10
+
11
+ ## 2. itemValueFrom 三态
12
+
13
+ | itemValueFrom | 含义 | itemValue | itemDefaultValue |
14
+ | --- | --- | --- | --- |
15
+ | "0" | 常量 | 直接用作最终值 | 不需要 |
16
+ | "1" | 变量/表达式 | JS 表达式($ 前缀) | **必须**带(字段要在,值由 meta 决定,见下) |
17
+ | "2" | 图片/文件值 | 资源路径 | 不需要 |
18
+
19
+ - `itemValueFrom:"1"` 的属性**必须**带 `itemDefaultValue` 字段:渲染时先取默认值占位,表达式登记到 vars[点号路径],applyVars 时再求值;求值失败则保持占位值。缺了就渲染空。
20
+ - **⚠️ 占位值取自 meta,不是 schema 里写的那个**(2026-09-09 实测):`Property` 由 `new Property(meta)` 构造,`itemDefaultValue` 来自 `preview/meta/*.json`;`onRestore` 不会用 schema 实例里的 `itemDefaultValue` 覆盖它,`onExport` 再把 meta 的值写回 schema(`property.js` 变量绑定分支注释即「值先取 meta 默认值」)。所以 **schema.json 里的 `itemDefaultValue` 只是 meta 默认值的序列化副本,作者改它不产生任何渲染兜底效果**。
21
+ - 实测:把装饰条 `rect.width` 绑定为 `$title.length * 17`、schema 里 `itemDefaultValue` 写 `"102"`,当 `$title` 为 null/缺失时 `evalExpr` 抛错被 applyVars 逐项 catch,渲染出的是 `width:;`(空)而非 `102px`——因为 `style-meta.json` 里 width 的 `itemDefaultValue` 是 `""`。
22
+ - 推论:**绑定表达式不要指望 itemDefaultValue 兜底**。要么保证被引用变量一定存在(声明进 `dictionary.inputParams` 并给 `defaultValue`),要么在表达式内部自兜底(如 `($title || '').length * 17`、`$foo || 默认值`——Proxy 把未定义 `$` 变量解析成 `undefined` 而不抛错,所以 `||` 兜底可用;只有对 null/undefined 取 `.length` 这类才会抛错走 catch)。
23
+ - 写 schema 时 `itemDefaultValue` 保持与 meta 一致(多数为空串),与 `assetAllocRadar` / `loanQuery` / `fundTypeSelect` 等导出卡的既有形态对齐。
24
+ - 保留导出里的 `itemValueFrom` 值("0"/"1"/"2"),不要归一化。
25
+
26
+ ## 3. 作用域插槽(ListLayout / GridLayout)
27
+
28
+ `slotScope:true` 的插槽,子作用域 = 父作用域 ∪ 当前 item 展开 ∪ $$ (整个 item) ∪ _index (索引)。
29
+
30
+ - 列表项内既能写 `$fieldName`(item 的字段),也能写 `$$`(整个 item)和 `$_index`(索引)。
31
+ - **以上 $ 作用域只适用于绑定表达式 / v-show 条件**。**事件脚本(customAction)里没有 `$$`**:slotScope 当前 item 的字段已展开到 `this.state`,直接 `this.state.<field>` 读取(铁律 r55,禁 `$$` / `this.state.$$` / 「$$ 兜底判断」,lint ERROR)。
32
+ - ListLayout.value = "$payeeList",item = { acctName:"张三", amount:"100.00" },子 Text.value = "$acctName" 渲染当前项 acctName。
33
+ - 常见表达式:
34
+ - `$showAll ? $list : $list.slice(0, 3)` —— 展开收起(绑在 ListLayout.value)。
35
+ - `$_index < 3 || $showAll` —— v-show 条件,前 3 项或展开时显示。
36
+ - `$action === 'onSelect' || ($_index < 3 || $showAll) || $action === 'multi'` —— 复合条件(accountCreditedlist)。
37
+ - `$accountNum.slice(-4)` —— 取尾号 4 位。
38
+ - `$cardType + $cardNum.slice(-4)` —— 拼接。
39
+
40
+ ## 4. applyVars 逐项 try/catch
41
+
42
+ - buildPreview 把每个 `itemValueFrom:"1"` 的表达式收集到预览对象的 `__vars__`(路径 → 表达式)。
43
+ - applyVars 逐项 setByPath + evalExpr,**单独 try/catch**:某项求值失败时该项保持 meta 默认值(而非 undefined)。所以引用了未定义变量的卡仍能渲染(如 billListDialog)。
44
+ - 渲染层(RenderTree)对 properties 与 style.properties 各跑一次 applyVars;v-show 条件单独 evalExpr(失败按 showType 兜底:01 显 / 02 隐)。
45
+
46
+ ## 5. itemCondition 属性级可见性
47
+
48
+ 属性 itemCondition 控制同级属性的显隐(meta 级,非 v-show)。语法:
49
+
50
+ - `a.b`:同级中 itemCondition==="a" 的属性其值须等于 "b",本属性才可见。
51
+ - `a.!b`:取反(值不等于 b)。
52
+ - `a.b|c`:多选其一(值等于 b 或 c)。
53
+ - 段数为奇数的项自身是"条件源"(提供比较值),不算可见性条件。
54
+
55
+ 常见条件源:`showType`、`paddingType`、`marginType`、`borderRadiusType`、`isBorder`、`isShadow`、`isMaxLine`、`backgroundType`。例:
56
+
57
+ - `condition` 属性带 `itemCondition:"showType.01|02"`(v-show 里 showType 为 01 或 02 时才显示条件输入)。
58
+ - **显隐设置显示名 `condition.name` 必填(不能为空)**:表达式 <15 字符时 name 与表达式一致(如 `$showOverall`);>=15 字符时设合适短命名(如 `$overallLevel > 0` → 「整体评价已选档」),不得抄表达式。expand_ir:<15 自动补 name、>=15 缺 name 报错;validate 缺名 ERROR;lint `r52` 命名不合规 WARN。
59
+ - `padding` 带 `itemCondition:"paddingType.0"`;`paddingLeft` 等带 `paddingType.1`。
60
+ - `backgroundColor` 带 `backgroundType.01`;`backgroundImage` 带 `backgroundType.02`;`backgroundGradient` 带 `backgroundType.03`。
61
+ - `maxLine` 带 `isMaxLine.1`。
62
+ - `borderWidth` 带 `isBorder.1`。
63
+
64
+ 生成新属性时照抄同组件导出里的 itemCondition,否则编辑器/预览可见性会错。
65
+
66
+ ## 6. v-show 指令
67
+
68
+ 组件级显隐,在 `directives[]` 里:
69
+
70
+ ```
71
+ {
72
+ "itemId": "001",
73
+ "itemKey": "v-show",
74
+ "itemValueFrom": "0",
75
+ "itemValue": {},
76
+ "itemChildren": {
77
+ "properties": [
78
+ { "itemId": "001", "itemKey": "showType", "itemValueFrom": "0", "itemValue": "00" },
79
+ { "itemId": "002", "itemKey": "condition", "itemValueFrom": "0", "itemValue": { "name": "", "expression": "$flag === '1'" } }
80
+ ]
81
+ }
82
+ }
83
+ ```
84
+
85
+ - showType:00 始终显示;01 满足条件显示;02 满足条件隐藏。
86
+ - condition.expression 是 $ 表达式,渲染期 evalExpr 实时算。无表达式时兜底:01 显 / 02 隐。
87
+ - **关键陷阱(tab↔header)**:`activeTab` 默认值(如 "1")不随 billMode 变。依赖 `$activeTab` 的面板可见性必须 AND `$billMode === '0'` 再 OR 强制模式,否则首个面板泄漏到其他模式:
88
+ - 错:`$activeTab === '1' || $billMode === '1'`(billMode='2' 时 activeTab 仍是 '1' → 首面板错显)。
89
+ - 对:`($billMode === '0' && $activeTab === '1') || $billMode === '1'`。
90
+
91
+ ## 7. Input 双向回写
92
+
93
+ - Input 的 value 绑定形如 `$key` 时,渲染层兜底:onInput 时 `rt.state[key] = v`(**只写运行期克隆 `rt.state`,绝不碰持久化 `rt.rootScope`**,故打字过程不会触发「保存到本地」脏标记)。
94
+ - `rt.state` 是响应式的,赋值即触发依赖它的节点重渲染,无需 markDirty。
95
+ - Input 绑定键的实时输入值在事件代码里**仅用 `this.data.xxx` 读**(this.data 的唯一合法用途:渲染层 onInput 兜底把输入回写 `rt.state`),所以 `this.data.payAmount`、`this.data.remark` 读到的就是当前实时输入值,**无需任何"交互前 flush"**;其余任何运行态变量一律用 `this.state` 读(lint `r51` 拦截误用)。
96
+ - 参考用例(均为 Input 绑定键,属 this.data 合法用途):creditCardPayment 的 `this.data.payAmount`、dreamPlan 的 `this.data.targetName`、transfersjump 的 `this.data.remark`。
97
+ - Input 无可绑定事件(events:[]),卡片无法自己接 change,回写由渲染层兜底(见 RenderTree.vue 行 306-315)。
98
+
99
+ ## 8. 表达式片段库(export-proven)
100
+
101
+ ### 金额 / 千分号(规范见 `references/amount_formatting.md`,canonical 范例 = multiMonthTransitionList)
102
+
103
+ - 带 `¥` 前缀的总额:`'¥'+($totalIncome * 1).toFixed(2).replace(/\B(?=(\d{3})+(?!\d))/g, ',')`
104
+ - 纯数字(无前缀):`($amt * 1).toFixed(2).replace(/\B(?=(\d{3})+(?!\d))/g, ',')`
105
+ - 带前缀文案:`'剩余应还¥' + ($currentPeriodAmount * 1).toFixed(2).replace(/\B(?=(\d{3})+(?!\d))/g, ',')`
106
+ - 列表项 fallback(收入或支出取其一,先去已有逗号):`((($income || $disburse) + '').replace(/,/g, '') * 1).toFixed(2).replace(/\B(?=(\d{3})+(?!\d))/g, ',')`
107
+ - 反向解析(需从展示值取回原始数值做计算 / 绘制 / 比较):`Number(String($totalIncome).replace('¥','').replace(/,/g,''))`
108
+ - 注意:上面是 JS 源码形态;写进 schema.json 的 `itemValue` 时反斜杠须再转义一次(`\B`→`\\B`,`\d`→`\\d`)。
109
+ - 账号尾号:`'账号尾号(' + $accountNum.slice(-4) + ')'`
110
+ - 三元取色:`$amount > 0 ? '#f00' : '#0a0'`
111
+ - 主题数组取值:`$theme[$level * 1 - 1].bg`(注意 *1 把字符串转数字)
112
+ - 标题长度算宽:`$title.length * 16`(Canvas 宽度表达式)
113
+ - 展开收起三元:`$showAll ? $list : $list.slice(0, 3)`
114
+ - 文案切换:`$showAll ? '收起' : '查看更多活动'`
115
+ - 模式三元:`$billMode === '1' ? '已出账单' : '未出账单'`
116
+
117
+ ## 9. 求值错误处理
118
+
119
+ - 绑定类错误(bind/vshow/render/refresh)每渲染重新收集(渲染期缓冲区,渲染结束 commit)。
120
+ - 事件类错误(customAction/listener)跨渲染保留(切卡才清空)。
121
+ - 生成时:表达式语法必须合法;引用未定义 $ 变量是安全的(兜底 undefined);不要引用 $$ 之外的保留名。
@@ -0,0 +1,34 @@
1
+ {
2
+ "_comment": "通用「中文 UI 标签 → 语义化英文字段名」词典(泛化,非卡片硬编码)。",
3
+ "_usage": "v3 生成器用 label 文本(表单行左标签 / 副值行标签 / 辅助文案)做前缀包含匹配,命中则用映射的英文 key 作为字段/对象/变量名;未命中回退到值格式角色名(amount/cardNumber/phone/...)。同义词数组按序试探,最长词优先命中;映射求稳(短、明确、无保留字)。fieldKey=字段级(对象内的值字段名),entityKey=对象级(实体对象名);entityKey 缺失时回退 fieldKey。",
4
+ "displayPrefixes": ["转账给", "给", "收款人", "付款人", "付给", "还给", "转给", "付给"],
5
+ "entries": [
6
+ { "labels": ["转出账号", "转出账户", "付款账号", "付款账户", "转出卡号"], "fieldKey": "outAccountNo", "entityKey": "outAccount", "desc": "转出侧账号/卡号" },
7
+ { "labels": ["收款账号", "收款账户", "收款卡号", "入账账号"], "fieldKey": "payeeAccountNo", "entityKey": "payeeAccount", "desc": "收款侧账号/卡号" },
8
+ { "labels": ["收款人", "收 款 人", "收款方", "收款户名", "收款姓名", "转账给"], "fieldKey": "payeeName", "entityKey": "payee", "desc": "收款人姓名(含「转账给」动词前缀)" },
9
+ { "labels": ["付款人", "付款方", "付款户名", "付款姓名", "本人"], "fieldKey": "payerName", "entityKey": "payer", "desc": "付款人姓名" },
10
+ { "labels": ["转账金额", "付款金额", "申请金额", "充值金额", "借款金额", "支付金额", "购买金额"], "fieldKey": "transferAmount", "entityKey": "transfer", "desc": "本次交易/支付金额" },
11
+ { "labels": ["可用余额", "账户余额", "当前余额", "卡内余额"], "fieldKey": "availableBalance", "entityKey": "balance", "desc": "账户当前可用余额" },
12
+ { "labels": ["附言", "备注", "留言", "转账附言", "汇款附言", "备注信息"], "fieldKey": "remark", "entityKey": "remark", "desc": "用户输入/展示的附言备注" },
13
+ { "labels": ["银行卡号", "卡号", "银行卡"], "fieldKey": "cardNumber", "entityKey": "card", "desc": "银行卡号(16-19位数字)" },
14
+ { "labels": ["手机号", "手机号码", "联系电话", "电话号码", "联系方式"], "fieldKey": "phone", "entityKey": "contact", "desc": "手机/联系电话" },
15
+ { "labels": ["姓名", "持卡人", "住户姓名", "客户姓名", "账户名"], "fieldKey": "name", "entityKey": "person", "desc": "姓名" },
16
+ { "labels": ["身份证", "证件号", "证件号码"], "fieldKey": "idNumber", "entityKey": "id", "desc": "身份证/证件号" },
17
+ { "labels": ["验证码", "短信验证码", "动态码"], "fieldKey": "verifyCode", "entityKey": "verify", "desc": "短信/动态验证码" },
18
+ { "labels": ["账单日期", "交易日期", "还款日期", "日期", "时间"], "fieldKey": "date", "entityKey": "date", "desc": "日期/时间" },
19
+ { "labels": ["本期应还", "应还金额", "账单金额", "待还金额", "还款金额", "还款总额"], "fieldKey": "currentDueAmount", "entityKey": "due", "desc": "本期应还/账单金额" },
20
+ { "labels": ["最低应还", "最低还款"], "fieldKey": "minimumDueAmount", "entityKey": "due", "desc": "最低应还金额" },
21
+ { "labels": ["剩余应还", "剩余应还金额", "剩余待还"], "fieldKey": "remainingDueAmount", "entityKey": "due", "desc": "剩余应还金额" },
22
+ { "labels": ["还款账户", "还款卡号", "还款银行卡"], "fieldKey": "repayAccountNo", "entityKey": "repayAccount", "desc": "还款账户/还款卡号" },
23
+ { "labels": ["银行", "开户行", "所属银行"], "fieldKey": "bankName", "entityKey": "bank", "desc": "银行名称" },
24
+ { "labels": ["币种", "货币"], "fieldKey": "currency", "entityKey": "currency", "desc": "币种" },
25
+ { "labels": ["订单号", "订单编号", "交易单号", "流水号", "交易号"], "fieldKey": "orderNo", "entityKey": "order", "desc": "订单/交易单号" },
26
+ { "labels": ["状态", "订单状态", "交易状态"], "fieldKey": "status", "entityKey": "status", "desc": "状态" },
27
+ { "labels": ["标题", "名称", "科目", "用途", "说明"], "fieldKey": "title", "entityKey": "title", "desc": "标题/名称类文本" },
28
+ { "labels": ["利率", "年利率", "利息", "手续费", "费用"], "fieldKey": "rate", "entityKey": "rate", "desc": "利率/费用比例" },
29
+ { "labels": ["期限", "期数", "周期", "贷款期限"], "fieldKey": "term", "entityKey": "term", "desc": "期限/期数" },
30
+ { "labels": ["积分", "红包", "奖励", "优惠券"], "fieldKey": "bonus", "entityKey": "bonus", "desc": "积分/红包/奖励" },
31
+ { "labels": ["明细", "详情", "账单明细", "交易明细"], "fieldKey": "detail", "entityKey": "detailList", "desc": "明细/详情(对象级用于列表数据变量)" },
32
+ { "labels": ["总额", "总金额", "合计", "总计"], "fieldKey": "totalAmount", "entityKey": "total", "desc": "总额/合计" }
33
+ ]
34
+ }
@@ -0,0 +1,101 @@
1
+ # 字段命名规范(双层机制:标签词典 + 智能体复核)
2
+
3
+ > 适用:dsl-card-generator 生成/编辑卡片时的 inputParams 变量名。
4
+ > 目标:字段名反映实际业务含义(`outAccount`/`availableBalance`/`cardNumber`),**永不出现 `obj_N` / `amount_0` / `subAmount_<i>` 序号名**;命名规则**泛化**,不针对任何具体卡片硬编码。
5
+
6
+ ## 1. 双层机制
7
+
8
+ ### 1.1 脚本层(确定性兜底,v3 已实现)
9
+ `spec_to_schema_v3.mjs` 自动命名,两层:
10
+
11
+ 1. **标签词典 `references/field_name_dict.json`**:UI 中文标签 → 语义化英文驼峰 key。
12
+ - 词典是**领域通用词表**(账号/金额/人/日期/状态等高频表单标签),不是某张卡的专属映射。
13
+ - 匹配:label 文本去冒号空格后做**前缀包含 + 最长词优先**匹配。
14
+ - 每条目含 `fieldKey`(字段级:对象内的值字段名)与 `entityKey`(对象级:实体对象名)。
15
+ 2. **值格式角色兜底**:词典未命中时按值格式命名 `cardNumber` / `amount` / `phone` / `name` / `date` / `code`。
16
+
17
+ **兜底纪律**:词典未命中时只能退到值格式角色名,**不得臆造业务词,不得回退 obj_N 序号名**。
18
+
19
+ ### 1.2 智能体层(语义主判,生成后必做)
20
+ 脚本产物出来后,Agent(生成卡片时的执行者)必须复核:
21
+
22
+ 1. 通读 `dictionary.inputParams` 的每个 key,对照 UI 稿标签(表单行左标签 / 副值行标签 / 辅助文案)确认含义相符。
23
+ 2. 词典未覆盖的新业务标签 → 按 UI 实际含义补语义化 key(camelCase 英文),并**同步修正**:
24
+ - `data.json` 的对应 key;
25
+ - schema 中所有绑定表达式(`$key` 或 `$obj.field`);
26
+ - `literalBind` / 脱敏 / 千分号表达式中的变量引用。
27
+ 3. 检查产物中无 `obj_N` / `amount_0` / `subAmount_<i>` 残留(有则改成语义名)。
28
+
29
+ > 智能体是命名的**主判者**:词典只是参考词表与脚本兜底,不是唯一来源。UI 标签的实际语义就是命名的依据。
30
+
31
+ ## 2. 命名规范
32
+
33
+ - **风格**:首字母小写 camelCase 英文(`outAccount`、`availableBalance`、`currentDueAmount`)。
34
+ - **私有性(铁律)**:仅供卡片内部状态使用、不支持外部传参的绑定字段,key 必须以 `_` 前缀(如 `_expanded`);支持外部传参的字段禁止 `_` 前缀。key 带 `_` = 私有,外部不支持传入。细则见 `rules.md §三`。
35
+ - **语义来源**:UI 稿标签文本(「转出账号」→ `outAccount`、「可用余额:」→ `availableBalance`、「本期应还」→ `currentDueAmount`)。
36
+ - **禁止**:
37
+ - `obj_N` / `amount_0` / `subAmount_<i>` 序号名(无含义);
38
+ - 与卡片 id 绑定(`transferProcessing_xxx`);
39
+ - 臆造与 UI 无关的字段(设计稿没有的字段不许凭空加变量);
40
+ - 中文 key / 含非法字符(表达式引擎 `$key` 需是合法标识符)。
41
+ - **对象与字段**:同一实体多个值 → 对象参数 `$obj.field`(如 `outAccount.outAccountNo`、`outAccount.availableBalance`);单字段实体 → 提升为顶层变量(`cardNumber` 而非 `cardNumberItem`)。
42
+ - **唯一性**:同名冲突自动加 `_N` 后缀(脚本 uniqueKey 处理;同构多组金额属正常必要区分)。
43
+
44
+ ## 3. 通用词表(词典已收录,直接命中)
45
+
46
+ | 中文标签(含同义词) | fieldKey | entityKey |
47
+ |---|---|---|
48
+ | 转出账号/转出账户/付款账号… | outAccountNo | outAccount |
49
+ | 收款账号/收款账户/入账账号… | payeeAccountNo | payeeAccount |
50
+ | 收款人/收款方/转账给… | payeeName | payee |
51
+ | 付款人/付款方/本人… | payerName | payer |
52
+ | 转账金额/付款金额/申请金额… | transferAmount | transfer |
53
+ | 可用余额/账户余额/当前余额… | availableBalance | balance |
54
+ | 附言/备注/留言… | remark | remark |
55
+ | 银行卡号/卡号 | cardNumber | card |
56
+ | 手机号/联系电话… | phone | contact |
57
+ | 姓名/持卡人/客户姓名… | name | person |
58
+ | 身份证/证件号 | idNumber | id |
59
+ | 验证码/短信验证码 | verifyCode | verify |
60
+ | 日期/时间 | date | date |
61
+ | 本期应还/应还金额/账单金额… | currentDueAmount | due |
62
+ | 最低应还/最低还款 | minimumDueAmount | due |
63
+ | 银行/开户行 | bankName | bank |
64
+ | 币种/货币 | currency | currency |
65
+ | 订单号/流水号/交易单号… | orderNo | order |
66
+ | 状态/订单状态 | status | status |
67
+ | 标题/名称/用途/说明… | title | title |
68
+ | 利率/利息/手续费… | rate | rate |
69
+ | 期限/期数/周期… | term | term |
70
+ | 积分/红包/奖励… | bonus | bonus |
71
+ | 明细/详情/账单明细… | detail | detailList(列表变量用) |
72
+ | 总额/总金额/合计… | totalAmount | total |
73
+
74
+ > 主金额(无标签时)→ `amount`;列表变量(标题命中明细/详情)→ `detailList`,否则 → `list`;附言 Input → `remark`;Tab 切换 → `activeTab`(通用语义,保留)。
75
+
76
+ ## 3.1 数组统计字段(枚举统计行,泛用命名)
77
+
78
+ > 适用:文本含「类型/分类标签 + 数量/金额」枚举统计结构(`动账 5 · 转账 2 · 站内 1 · 其他 4`、`待处理 3 · 已完成 8`)。见 `spec_to_schema_patterns.md §19`。
79
+
80
+ - **字段形态**:`type:"array"`,每项 `{ label, value[, unit] }`——`label` 存设计稿标签**原文**(中文数据值,非 key),`value` 存数字(number),`unit` 可选(金额量纲)。
81
+ - **字段命名**:`<类型域语义>Breakdown` / `<类型域语义>Stats`。类型域语义来自**整行文本的语境**(如未读消息 → `unreadBreakdown`、状态 → `statusBreakdown`、分类 → `categoryStats`),未命中语境 → 兜底 `statBreakdown` / `categoryStats`。
82
+ - **禁止**:
83
+ - 把类型词写进 key(`dongZhangCount`/`transferCount_1`)——类型是**数据**不是结构,类型数量可变、业务词不可泛化;
84
+ - 把整行绑成一个字符串变量(数字失去结构化);
85
+ - 序号名(`stat_0`/`stat_1`)。
86
+ - **项内字段固定**:`label`/`value`(+可选 `unit`)不随业务变,任何枚举统计场景复用同一形状。
87
+
88
+ ## 4. 词典增补
89
+
90
+ 新增标签语义 → 编辑 `references/field_name_dict.json` 增补词条(labels 同义词数组 + fieldKey + entityKey),增补即全局生效(所有卡片复用)。**不要**为单张卡片写特殊分支。
91
+
92
+ ## 5. 复核清单(生成后逐项过)
93
+
94
+ - [ ] inputParams 无 `obj_N` / `amount_0` / `subAmount_<i>` 残留
95
+ - [ ] 每个 key 都能从 UI 标签或值格式解释其含义
96
+ - [ ] `data.json` 与 inputParams key 完全一致(`derive_data_json.py --check`)
97
+ - [ ] 绑定表达式 `$key` / `$obj.field` 全部指向存在的参数
98
+ - [ ] 无中文 key / 非法标识符
99
+ - [ ] 未引入卡片 id 或与 UI 无关的字段
100
+ - [ ] 枚举统计行(`类型+数字` 多段文本)已拆为数组字段(`{label, value}`),未整行绑字符串、未把类型词写进 key
101
+ - [ ] 中文+数字混排串里的运行期数字已抽成语义变量(`availableAmount` / `tradeCount` / `remainDays`),展示走表达式拼接;`defaultValue` 无格式化串(`12,300.00`)/ 带货币符串(rules.md §十四)