@loom-framework/core 0.1.0-alpha.83 → 0.1.0-alpha.85

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 (309) hide show
  1. package/builtin-skills/antd/SKILL.md +266 -0
  2. package/builtin-skills/antv-g2-chart/SKILL.md +1067 -0
  3. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-intro.md +176 -0
  4. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-keyframe.md +149 -0
  5. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-types.md +253 -0
  6. package/builtin-skills/antv-g2-chart/references/components/g2-comp-annotation.md +237 -0
  7. package/builtin-skills/antv-g2-chart/references/components/g2-comp-axis-config.md +648 -0
  8. package/builtin-skills/antv-g2-chart/references/components/g2-comp-axis-radar.md +219 -0
  9. package/builtin-skills/antv-g2-chart/references/components/g2-comp-label-config.md +174 -0
  10. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-category.md +278 -0
  11. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-config.md +363 -0
  12. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-continuous.md +264 -0
  13. package/builtin-skills/antv-g2-chart/references/components/g2-comp-scrollbar.md +276 -0
  14. package/builtin-skills/antv-g2-chart/references/components/g2-comp-slider.md +333 -0
  15. package/builtin-skills/antv-g2-chart/references/components/g2-comp-title.md +149 -0
  16. package/builtin-skills/antv-g2-chart/references/components/g2-comp-tooltip-config.md +358 -0
  17. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-facet-circle.md +97 -0
  18. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-facet-rect.md +241 -0
  19. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-geo-map.md +210 -0
  20. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-geoview.md +143 -0
  21. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-repeat-matrix.md +171 -0
  22. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-space-flex.md +142 -0
  23. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-space-layer.md +149 -0
  24. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-timing-keyframe.md +91 -0
  25. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-view.md +309 -0
  26. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-chart-selection.md +235 -0
  27. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-color-theory.md +287 -0
  28. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-visual-channels.md +180 -0
  29. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-cartesian.md +131 -0
  30. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-fisheye.md +131 -0
  31. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-helix.md +141 -0
  32. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-parallel.md +129 -0
  33. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-polar.md +143 -0
  34. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-radial.md +214 -0
  35. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-theta.md +171 -0
  36. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-transpose.md +195 -0
  37. package/builtin-skills/antv-g2-chart/references/core/g2-core-chart-init.md +266 -0
  38. package/builtin-skills/antv-g2-chart/references/core/g2-core-encode-channel.md +197 -0
  39. package/builtin-skills/antv-g2-chart/references/core/g2-core-view-composition.md +224 -0
  40. package/builtin-skills/antv-g2-chart/references/data/g2-data-ema.md +190 -0
  41. package/builtin-skills/antv-g2-chart/references/data/g2-data-fetch.md +167 -0
  42. package/builtin-skills/antv-g2-chart/references/data/g2-data-filter.md +212 -0
  43. package/builtin-skills/antv-g2-chart/references/data/g2-data-fold.md +260 -0
  44. package/builtin-skills/antv-g2-chart/references/data/g2-data-format-tabular.md +280 -0
  45. package/builtin-skills/antv-g2-chart/references/data/g2-data-kde.md +426 -0
  46. package/builtin-skills/antv-g2-chart/references/data/g2-data-log.md +140 -0
  47. package/builtin-skills/antv-g2-chart/references/data/g2-data-slice.md +147 -0
  48. package/builtin-skills/antv-g2-chart/references/data/g2-data-sort.md +251 -0
  49. package/builtin-skills/antv-g2-chart/references/data/g2-data-sortby.md +183 -0
  50. package/builtin-skills/antv-g2-chart/references/data/g2-data-transform-patterns.md +394 -0
  51. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-adaptive-filter.md +118 -0
  52. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-axis.md +112 -0
  53. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-filter.md +122 -0
  54. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-x-y-highlight.md +127 -0
  55. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-xy.md +118 -0
  56. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush.md +184 -0
  57. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushx-filter.md +170 -0
  58. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushx-highlight.md +186 -0
  59. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushy-filter.md +170 -0
  60. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushy-highlight.md +185 -0
  61. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-chart-index.md +127 -0
  62. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-drilldown.md +149 -0
  63. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-highlight-by.md +125 -0
  64. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-highlight.md +235 -0
  65. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-hover-scale.md +109 -0
  66. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-point-move.md +152 -0
  67. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-select-by.md +133 -0
  68. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-select.md +249 -0
  69. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-fisheye.md +117 -0
  70. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-legend-filter.md +130 -0
  71. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-legend-highlight.md +130 -0
  72. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-poptip.md +105 -0
  73. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-scrollbar-filter.md +144 -0
  74. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-slider-filter.md +231 -0
  75. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-slider-wheel.md +138 -0
  76. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-tooltip.md +192 -0
  77. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-treemap-drilldown.md +152 -0
  78. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-contrast-reverse.md +170 -0
  79. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-exceed-adjust.md +146 -0
  80. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overflow-hide.md +185 -0
  81. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overflow-stroke.md +147 -0
  82. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overlap-dodge-y.md +225 -0
  83. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overlap-hide.md +213 -0
  84. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-diagram.md +196 -0
  85. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-donut.md +148 -0
  86. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-pie.md +212 -0
  87. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-area-basic.md +168 -0
  88. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-area-stacked.md +150 -0
  89. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-beeswarm.md +134 -0
  90. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-bi-directional-bar.md +297 -0
  91. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-box-boxplot.md +163 -0
  92. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-boxplot.md +340 -0
  93. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-bullet.md +203 -0
  94. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-cell-heatmap.md +370 -0
  95. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-chord.md +341 -0
  96. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-connector.md +126 -0
  97. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-contourline.md +243 -0
  98. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-density.md +457 -0
  99. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-distribution-curve.md +298 -0
  100. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-funnel.md +329 -0
  101. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-gantt.md +208 -0
  102. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-gauge.md +247 -0
  103. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-heatmap.md +130 -0
  104. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-histogram.md +186 -0
  105. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-image.md +129 -0
  106. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-basic.md +528 -0
  107. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-grouped.md +161 -0
  108. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-normalized.md +147 -0
  109. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-stacked.md +183 -0
  110. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-k-chart.md +237 -0
  111. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-line-basic.md +353 -0
  112. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-line-multi.md +156 -0
  113. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-linex-liney.md +176 -0
  114. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-link.md +134 -0
  115. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-liquid.md +125 -0
  116. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-mosaic.md +257 -0
  117. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-pack.md +424 -0
  118. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-parallel.md +195 -0
  119. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-partition.md +275 -0
  120. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-path.md +135 -0
  121. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-point-bubble.md +138 -0
  122. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-point-scatter.md +177 -0
  123. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-polygon.md +130 -0
  124. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-radar.md +231 -0
  125. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-radial-bar.md +226 -0
  126. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-range-rangey.md +253 -0
  127. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rangex.md +293 -0
  128. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rect.md +115 -0
  129. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-regression-curve.md +276 -0
  130. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rose.md +182 -0
  131. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-sankey.md +217 -0
  132. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-shape.md +160 -0
  133. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-spiral.md +257 -0
  134. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-sunburst.md +327 -0
  135. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-text.md +309 -0
  136. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-tree.md +235 -0
  137. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-treemap.md +426 -0
  138. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-vector.md +108 -0
  139. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-venn.md +204 -0
  140. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-violin.md +307 -0
  141. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-wordcloud.md +155 -0
  142. package/builtin-skills/antv-g2-chart/references/palette/g2-palette-category10.md +196 -0
  143. package/builtin-skills/antv-g2-chart/references/palette/g2-palette-category20.md +238 -0
  144. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-performance.md +181 -0
  145. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-responsive.md +232 -0
  146. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-v4-to-v5.md +223 -0
  147. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-band.md +127 -0
  148. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-linear.md +259 -0
  149. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-log.md +226 -0
  150. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-ordinal.md +135 -0
  151. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-point.md +242 -0
  152. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-pow-sqrt.md +124 -0
  153. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-quantile-quantize.md +119 -0
  154. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-sequential.md +267 -0
  155. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-threshold.md +133 -0
  156. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-time.md +159 -0
  157. package/builtin-skills/antv-g2-chart/references/themes/g2-theme-builtin.md +192 -0
  158. package/builtin-skills/antv-g2-chart/references/themes/g2-theme-custom.md +183 -0
  159. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-bin.md +153 -0
  160. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-binx.md +133 -0
  161. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-diffy.md +130 -0
  162. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-dodgex.md +90 -0
  163. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-flexx.md +115 -0
  164. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-group.md +233 -0
  165. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupcolor.md +182 -0
  166. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupx.md +265 -0
  167. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupy.md +167 -0
  168. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jitter.md +149 -0
  169. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jitterx.md +177 -0
  170. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jittery.md +177 -0
  171. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-normalizey.md +83 -0
  172. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-pack.md +164 -0
  173. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sample.md +143 -0
  174. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-select.md +147 -0
  175. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-selectx.md +179 -0
  176. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-selecty.md +179 -0
  177. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sort-color.md +115 -0
  178. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sortx.md +285 -0
  179. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sorty.md +117 -0
  180. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-stack-enter.md +158 -0
  181. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-stacky.md +218 -0
  182. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-symmetryy.md +122 -0
  183. package/builtin-skills/chart-visualization/SKILL.md +101 -0
  184. package/{templates/loom-skill → builtin-skills/loom}/SKILL.md +37 -22
  185. package/{templates/loom-skill → builtin-skills/loom}/references/README.md +3 -3
  186. package/builtin-skills/loom/references/dashboard.md +196 -0
  187. package/{templates/loom-skill → builtin-skills/loom}/references/data-model.md +1 -1
  188. package/dist/capability-generator.d.ts +1 -1
  189. package/dist/capability-generator.js +3 -3
  190. package/dist/capability-generator.js.map +1 -1
  191. package/dist/cli/commands/generate-dashboard.js +2 -2
  192. package/dist/cli/commands/generate-dashboard.js.map +1 -1
  193. package/dist/cli/commands/generate-page.d.ts.map +1 -1
  194. package/dist/cli/commands/generate-page.js +1 -163
  195. package/dist/cli/commands/generate-page.js.map +1 -1
  196. package/dist/cli/commands/init.d.ts.map +1 -1
  197. package/dist/cli/commands/init.js +57 -294
  198. package/dist/cli/commands/init.js.map +1 -1
  199. package/dist/cli/generators/capability-generator.d.ts +35 -0
  200. package/dist/cli/generators/capability-generator.d.ts.map +1 -0
  201. package/dist/cli/generators/capability-generator.js +115 -0
  202. package/dist/cli/generators/capability-generator.js.map +1 -0
  203. package/dist/cli/helpers/app-tsx-wiring.d.ts +3 -1
  204. package/dist/cli/helpers/app-tsx-wiring.d.ts.map +1 -1
  205. package/dist/cli/helpers/app-tsx-wiring.js +34 -23
  206. package/dist/cli/helpers/app-tsx-wiring.js.map +1 -1
  207. package/dist/cli/helpers/column-template.d.ts +18 -0
  208. package/dist/cli/helpers/column-template.d.ts.map +1 -0
  209. package/dist/cli/helpers/column-template.js +151 -0
  210. package/dist/cli/helpers/column-template.js.map +1 -0
  211. package/dist/cli/helpers/field-template.d.ts +4 -0
  212. package/dist/cli/helpers/field-template.d.ts.map +1 -1
  213. package/dist/cli/helpers/field-template.js +4 -3
  214. package/dist/cli/helpers/field-template.js.map +1 -1
  215. package/dist/cli/templates/backend-entry.d.ts +5 -0
  216. package/dist/cli/templates/backend-entry.d.ts.map +1 -0
  217. package/dist/cli/templates/backend-entry.js +17 -0
  218. package/dist/cli/templates/backend-entry.js.map +1 -0
  219. package/dist/cli/templates/frontend-entry.d.ts +11 -0
  220. package/dist/cli/templates/frontend-entry.d.ts.map +1 -0
  221. package/dist/cli/templates/frontend-entry.js +77 -0
  222. package/dist/cli/templates/frontend-entry.js.map +1 -0
  223. package/dist/cli/templates/gitignore.d.ts +5 -0
  224. package/dist/cli/templates/gitignore.d.ts.map +1 -0
  225. package/dist/cli/templates/gitignore.js +13 -0
  226. package/dist/cli/templates/gitignore.js.map +1 -0
  227. package/dist/cli/templates/index.d.ts +12 -0
  228. package/dist/cli/templates/index.d.ts.map +1 -0
  229. package/dist/cli/templates/index.js +12 -0
  230. package/dist/cli/templates/index.js.map +1 -0
  231. package/dist/cli/templates/loom-config.d.ts +10 -0
  232. package/dist/cli/templates/loom-config.d.ts.map +1 -0
  233. package/dist/cli/templates/loom-config.js +31 -0
  234. package/dist/cli/templates/loom-config.js.map +1 -0
  235. package/dist/cli/templates/package-json.d.ts +9 -0
  236. package/dist/cli/templates/package-json.d.ts.map +1 -0
  237. package/dist/cli/templates/package-json.js +39 -0
  238. package/dist/cli/templates/package-json.js.map +1 -0
  239. package/dist/cli/templates/readme.d.ts +9 -0
  240. package/dist/cli/templates/readme.d.ts.map +1 -0
  241. package/dist/cli/templates/readme.js +47 -0
  242. package/dist/cli/templates/readme.js.map +1 -0
  243. package/dist/cli/templates/tsconfig.d.ts +6 -0
  244. package/dist/cli/templates/tsconfig.d.ts.map +1 -0
  245. package/dist/cli/templates/tsconfig.js +41 -0
  246. package/dist/cli/templates/tsconfig.js.map +1 -0
  247. package/dist/cli/templates/vite-config.d.ts +5 -0
  248. package/dist/cli/templates/vite-config.d.ts.map +1 -0
  249. package/dist/cli/templates/vite-config.js +24 -0
  250. package/dist/cli/templates/vite-config.js.map +1 -0
  251. package/dist/commands.d.ts +1 -5
  252. package/dist/commands.d.ts.map +1 -1
  253. package/dist/commands.js +0 -11
  254. package/dist/commands.js.map +1 -1
  255. package/dist/config.d.ts +15 -122
  256. package/dist/config.d.ts.map +1 -1
  257. package/dist/config.js +2 -52
  258. package/dist/config.js.map +1 -1
  259. package/dist/dashboard-config.d.ts +117 -0
  260. package/dist/dashboard-config.d.ts.map +1 -0
  261. package/dist/dashboard-config.js +59 -0
  262. package/dist/dashboard-config.js.map +1 -0
  263. package/dist/index.d.ts +2 -2
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +1 -1
  266. package/dist/index.js.map +1 -1
  267. package/dist/server-bin.js +30 -62
  268. package/dist/server-bin.js.map +1 -1
  269. package/dist/types/adapter.d.ts +28 -0
  270. package/dist/types/adapter.d.ts.map +1 -0
  271. package/dist/types/adapter.js +5 -0
  272. package/dist/types/adapter.js.map +1 -0
  273. package/dist/types/ai.d.ts +52 -0
  274. package/dist/types/ai.d.ts.map +1 -0
  275. package/dist/types/ai.js +5 -0
  276. package/dist/types/ai.js.map +1 -0
  277. package/dist/types/chat.d.ts +46 -0
  278. package/dist/types/chat.d.ts.map +1 -0
  279. package/dist/types/chat.js +5 -0
  280. package/dist/types/chat.js.map +1 -0
  281. package/dist/types/command.d.ts +25 -0
  282. package/dist/types/command.d.ts.map +1 -0
  283. package/dist/types/command.js +5 -0
  284. package/dist/types/command.js.map +1 -0
  285. package/dist/types/config.d.ts +30 -0
  286. package/dist/types/config.d.ts.map +1 -0
  287. package/dist/types/config.js +5 -0
  288. package/dist/types/config.js.map +1 -0
  289. package/dist/types/dashboard.d.ts +42 -0
  290. package/dist/types/dashboard.d.ts.map +1 -0
  291. package/dist/types/dashboard.js +5 -0
  292. package/dist/types/dashboard.js.map +1 -0
  293. package/dist/types/index.d.ts +14 -0
  294. package/dist/types/index.d.ts.map +1 -0
  295. package/dist/types/index.js +8 -0
  296. package/dist/types/index.js.map +1 -0
  297. package/dist/types/model.d.ts +59 -0
  298. package/dist/types/model.d.ts.map +1 -0
  299. package/dist/types/model.js +5 -0
  300. package/dist/types/model.js.map +1 -0
  301. package/dist/types.d.ts +4 -250
  302. package/dist/types.d.ts.map +1 -1
  303. package/dist/types.js +4 -3
  304. package/dist/types.js.map +1 -1
  305. package/package.json +2 -2
  306. package/templates/loom-skill/references/dashboard.md +0 -161
  307. /package/{templates → builtin-skills}/app-skill/SKILL.md +0 -0
  308. /package/{templates → builtin-skills}/app-skill/references/data-semantics.md +0 -0
  309. /package/{templates → builtin-skills}/app-skill/references/models.md +0 -0
@@ -0,0 +1,648 @@
1
+ ---
2
+ id: "g2-comp-axis-config"
3
+ title: "G2 坐标轴配置(axis)"
4
+ description: |
5
+ 详解 G2 v5 Spec 模式中 axis 字段的配置,涵盖轴标题、刻度、标签格式化、
6
+ 网格线、轴线样式等,支持对 x、y 轴独立配置。
7
+
8
+ library: "g2"
9
+ version: "5.x"
10
+ category: "components"
11
+ tags:
12
+ - "axis"
13
+ - "坐标轴"
14
+ - "轴标题"
15
+ - "刻度"
16
+ - "标签格式化"
17
+ - "网格线"
18
+ - "spec"
19
+
20
+ related:
21
+ - "g2-core-chart-init"
22
+ - "g2-scale-linear"
23
+ - "g2-scale-time"
24
+ - "g2-scale-band"
25
+
26
+ use_cases:
27
+ - "自定义坐标轴标题"
28
+ - "格式化轴刻度标签(百分比、货币、日期等)"
29
+ - "控制刻度数量和网格线"
30
+ - "隐藏坐标轴"
31
+
32
+ difficulty: "beginner"
33
+ completeness: "full"
34
+ created: "2024-01-01"
35
+ updated: "2025-03-26"
36
+ author: "antv-team"
37
+ source_url: "https://g2.antv.antgroup.com/manual/component/axis"
38
+ ---
39
+
40
+ ## 基本用法
41
+
42
+ ```javascript
43
+ import { Chart } from '@antv/g2';
44
+
45
+ const chart = new Chart({ container: 'container', width: 640, height: 480 });
46
+
47
+ chart.options({
48
+ type: 'interval',
49
+ data,
50
+ encode: { x: 'month', y: 'revenue' },
51
+ axis: {
52
+ x: { title: '月份' },
53
+ y: { title: '收入(万元)' },
54
+ },
55
+ });
56
+
57
+ chart.render();
58
+ ```
59
+
60
+ ---
61
+
62
+ ## 增量修改配置
63
+
64
+ 如果已有图表,只想修改某个配置项(如标签颜色),可以使用以下方式:
65
+
66
+ ```javascript
67
+ // 方式一:重新调用 options,只传需要修改的配置
68
+ chart.options({
69
+ axis: {
70
+ y: {
71
+ labelFill: 'red', // 只修改标签颜色
72
+ },
73
+ },
74
+ });
75
+ chart.render(); // 需要重新渲染
76
+
77
+ // 方式二:完整配置后修改
78
+ const options = {
79
+ type: 'line',
80
+ data,
81
+ encode: { x: 'date', y: 'value' },
82
+ axis: { x: { title: '日期' } },
83
+ };
84
+ chart.options(options);
85
+
86
+ // 后续修改
87
+ options.axis = { y: { labelFill: 'red' } };
88
+ chart.options(options);
89
+ chart.render();
90
+ ```
91
+
92
+ ---
93
+
94
+ ## 完整配置项参考
95
+
96
+ ### 通用配置
97
+
98
+ | 属性 | 描述 | 类型 | 默认值 |
99
+ |------|------|------|--------|
100
+ | `position` | 坐标轴位置 | `'left' \| 'right' \| 'top' \| 'bottom'` | x: `'bottom'`, y: `'left'` |
101
+ | `animate` | 是否开启动画 | `boolean` | - |
102
+
103
+ ### 轴标题样式(title)
104
+
105
+ | 属性 | 描述 | 类型 | 默认值 |
106
+ |------|------|------|--------|
107
+ | `title` | 标题内容 | `string \| false` | - |
108
+ | `titleSpacing` | 标题到坐标轴的距离 | `number` | `10` |
109
+ | `titlePosition` | 标题相对坐标轴的位置 | `'top' \| 'bottom' \| 'left' \| 'right'` | `'lb'` |
110
+ | `titleFontSize` | **标题文字大小** | `number` | - |
111
+ | `titleFontWeight` | 标题文字字体粗细 | `number \| string` | - |
112
+ | `titleFontFamily` | 标题文字字体 | `string` | - |
113
+ | `titleLineHeight` | 标题文字行高 | `number` | `1` |
114
+ | `titleTextAlign` | 标题文字水平对齐方式 | `string` | `'start'` |
115
+ | `titleTextBaseline` | 标题文字垂直基线 | `string` | `'middle'` |
116
+ | `titleFill` | **标题文字填充色** | `string` | - |
117
+ | `titleFillOpacity` | 标题文字填充透明度 | `number` | `1` |
118
+ | `titleStroke` | 标题文字描边颜色 | `string` | `transparent` |
119
+ | `titleStrokeOpacity` | 标题文字描边透明度 | `number` | `1` |
120
+ | `titleLineWidth` | 标题文字描边宽度 | `number` | `0` |
121
+ | `titleLineDash` | 标题文字描边虚线配置 | `number[]` | `[]` |
122
+ | `titleOpacity` | 标题文字整体透明度 | `number` | `1` |
123
+ | `titleShadowColor` | 标题文字阴影颜色 | `string` | `transparent` |
124
+ | `titleShadowBlur` | 标题文字阴影模糊系数 | `number` | `0` |
125
+ | `titleShadowOffsetX` | 标题文字阴影水平偏移量 | `number` | `0` |
126
+ | `titleShadowOffsetY` | 标题文字阴影垂直偏移量 | `number` | `0` |
127
+ | `titleCursor` | 标题文字鼠标样式 | `string` | `default` |
128
+ | `titleDx` | 标题文字水平偏移量 | `number` | `0` |
129
+ | `titleDy` | 标题文字垂直偏移量 | `number` | `0` |
130
+
131
+ ### 轴线样式(line)
132
+
133
+ | 属性 | 描述 | 类型 | 默认值 |
134
+ |------|------|------|--------|
135
+ | `line` | 是否显示轴线 | `boolean` | `false` |
136
+ | `arrow` | 是否显示箭头 | `boolean` | `true` |
137
+ | `lineExtension` | 轴线两侧的延长线 | `[number, number]` | - |
138
+ | `lineArrow` | 轴线箭头形状 | `DisplayObject` | - |
139
+ | `lineArrowOffset` | 箭头偏移长度 | `number` | `15` |
140
+ | `lineArrowSize` | 箭头尺寸 | `number` | - |
141
+ | `lineStroke` | **轴线描边颜色** | `string` | - |
142
+ | `lineStrokeOpacity` | 轴线描边透明度 | `number` | - |
143
+ | `lineLineWidth` | **轴线描边宽度** | `number` | - |
144
+ | `lineLineDash` | 轴线描边虚线配置 | `[number, number]` | - |
145
+ | `lineOpacity` | 轴线整体透明度 | `number` | `1` |
146
+ | `lineShadowColor` | 轴线阴影颜色 | `string` | - |
147
+ | `lineShadowBlur` | 轴线阴影模糊系数 | `number` | - |
148
+ | `lineShadowOffsetX` | 轴线阴影水平偏移量 | `number` | - |
149
+ | `lineShadowOffsetY` | 轴线阴影垂直偏移量 | `number` | - |
150
+ | `lineCursor` | 轴线鼠标样式 | `string` | `default` |
151
+
152
+ ### 刻度线样式(tick)
153
+
154
+ | 属性 | 描述 | 类型 | 默认值 |
155
+ |------|------|------|--------|
156
+ | `tick` | 是否显示刻度 | `boolean` | `true` |
157
+ | `tickCount` | 推荐生成的刻度数量 | `number` | - |
158
+ | `tickMethod` | 自定义刻度生成方法 | `(start, end, count) => number[]` | - |
159
+ | `tickFilter` | 刻度线过滤 | `(datum, index, data) => boolean` | - |
160
+ | `tickFormatter` | 刻度线格式化 | `(datum, index, data, Vector) => DisplayObject` | - |
161
+ | `tickDirection` | 刻度朝向 | `'positive' \| 'negative'` | `'positive'` |
162
+ | `tickLength` | **刻度线长度** | `number` | `15` |
163
+ | `tickStroke` | **刻度线描边颜色** | `string` | - |
164
+ | `tickStrokeOpacity` | 刻度线描边透明度 | `number` | - |
165
+ | `tickLineWidth` | 刻度线描边宽度 | `number` | - |
166
+ | `tickLineDash` | 刻度线描边虚线配置 | `[number, number]` | - |
167
+ | `tickOpacity` | 刻度线整体透明度 | `number` | - |
168
+ | `tickShadowColor` | 刻度线阴影颜色 | `string` | - |
169
+ | `tickShadowBlur` | 刻度线阴影模糊系数 | `number` | - |
170
+ | `tickShadowOffsetX` | 刻度线阴影水平偏移量 | `number` | - |
171
+ | `tickShadowOffsetY` | 刻度线阴影垂直偏移量 | `number` | - |
172
+ | `tickCursor` | 刻度线鼠标样式 | `string` | `default` |
173
+
174
+ ### 刻度标签样式(label)
175
+
176
+ | 属性 | 描述 | 类型 | 默认值 |
177
+ |------|------|------|--------|
178
+ | `labelFormatter` | **标签格式化** | `string \| (datum, index, data) => string` | - |
179
+ | `labelFilter` | 标签过滤 | `(datum, index, data) => boolean` | - |
180
+ | `labelAutoRotate` | 标签过长时自动旋转 | `boolean` | - |
181
+ | `labelAutoHide` | 标签过密时自动隐藏 | `boolean` | - |
182
+ | `labelSpacing` | 标签与刻度线的间距 | `number` | - |
183
+ | `labelFontSize` | **标签文字大小** | `number` | - |
184
+ | `labelFontWeight` | 标签文字字体粗细 | `number \| string` | - |
185
+ | `labelFontFamily` | 标签文字字体 | `string` | - |
186
+ | `labelLineHeight` | 标签文字行高 | `number` | - |
187
+ | `labelTextAlign` | 标签文字水平对齐方式 | `string` | - |
188
+ | `labelTextBaseline` | 标签文字垂直基线 | `string` | - |
189
+ | `labelFill` | **标签文字填充色** | `string` | - |
190
+ | `labelFillOpacity` | 标签文字填充透明度 | `number` | - |
191
+ | `labelStroke` | 标签文字描边颜色 | `string` | - |
192
+ | `labelStrokeOpacity` | 标签文字描边透明度 | `number` | - |
193
+ | `labelLineWidth` | 标签文字描边宽度 | `number` | - |
194
+ | `labelLineDash` | 标签文字描边虚线配置 | `number[]` | - |
195
+ | `labelOpacity` | 标签文字整体透明度 | `number` | - |
196
+ | `labelShadowColor` | 标签文字阴影颜色 | `string` | - |
197
+ | `labelShadowBlur` | 标签文字阴影模糊系数 | `number` | - |
198
+ | `labelShadowOffsetX` | 标签文字阴影水平偏移量 | `number` | - |
199
+ | `labelShadowOffsetY` | 标签文字阴影垂直偏移量 | `number` | - |
200
+ | `labelCursor` | 标签文字鼠标样式 | `string` | `default` |
201
+ | `labelDx` | 标签文字水平偏移量 | `number` | - |
202
+ | `labelDy` | 标签文字垂直偏移量 | `number` | - |
203
+
204
+ ### 刻度标签样式(label,补充)
205
+
206
+ | 属性 | 描述 | 类型 | 默认值 |
207
+ |------|------|------|--------|
208
+ | `labelRender` | 自定义标签渲染,支持 HTML 字符串,用法同 `labelFormatter` | `string \| (datum, index, array) => string` | - |
209
+ | `labelAlign` | 刻度值对齐方式 | `'horizontal' \| 'parallel' \| 'perpendicular'` | `'parallel'` |
210
+ | `labelDirection` | 刻度值相对轴线的位置 | `'positive' \| 'negative'` | `'positive'` |
211
+ | `labelAutoEllipsis` | 自动缩略过长的刻度值 | `boolean` | - |
212
+ | `labelAutoWrap` | 自动换行刻度值 | `boolean` | - |
213
+
214
+ ### 网格线样式(grid)
215
+
216
+ | 属性 | 描述 | 类型 | 默认值 |
217
+ |------|------|------|--------|
218
+ | `grid` | 是否显示网格线 | `boolean` | - |
219
+ | `gridAreaFill` | **网格线区域填充色**,支持交替颜色数组或函数 | `string \| string[] \| (datum, index, data) => string` | - |
220
+ | `gridFilter` | 网格线过滤,返回 false 隐藏该网格线 | `(datum, index, data) => boolean` | - |
221
+ | `gridLength` | 网格线长度 | `number` | `0` |
222
+ | `gridStroke` | **网格线描边颜色** | `string` | - |
223
+ | `gridStrokeOpacity` | 网格线描边透明度 | `number` | - |
224
+ | `gridLineWidth` | **网格线描边宽度** | `number` | - |
225
+ | `gridLineDash` | **网格线描边虚线配置** | `[number, number]` | - |
226
+ | `gridOpacity` | 网格线整体透明度 | `number` | - |
227
+ | `gridShadowColor` | 网格线阴影颜色 | `string` | - |
228
+ | `gridShadowBlur` | 网格线阴影模糊系数 | `number` | - |
229
+ | `gridShadowOffsetX` | 网格线阴影水平偏移量 | `number` | - |
230
+ | `gridShadowOffsetY` | 网格线阴影垂直偏移量 | `number` | - |
231
+ | `gridCursor` | 网格线鼠标样式 | `string` | `default` |
232
+
233
+ ---
234
+
235
+ ## 常用配置示例
236
+
237
+ ### 完整配置示例
238
+
239
+ ```javascript
240
+ chart.options({
241
+ type: 'line',
242
+ data,
243
+ encode: { x: 'date', y: 'value' },
244
+ axis: {
245
+ x: {
246
+ title: '日期',
247
+ titleFontSize: 14,
248
+ titleFill: '#666',
249
+ tickCount: 6,
250
+ labelFormatter: 'YYYY-MM',
251
+ labelFontSize: 11,
252
+ labelFill: '#888',
253
+ tick: true,
254
+ tickLength: 5,
255
+ line: true,
256
+ grid: true,
257
+ gridLineDash: [4, 4],
258
+ },
259
+ y: {
260
+ title: '收入(万元)',
261
+ labelFormatter: (v) => `¥${v}`,
262
+ },
263
+ },
264
+ });
265
+ ```
266
+
267
+ ### 刻度相关配置职责速查
268
+
269
+ 刻度控制有三个配置项,职责不同,不能混用:
270
+
271
+ | 配置项 | 签名 | 职责 | 使用频率 |
272
+ |--------|------|------|---------|
273
+ | `labelFormatter` | `(value, index, array) => string` | 刻度**文字内容** | ⭐ 最常用 |
274
+ | `tickMethod` | `(start, end, tickCount) => number[]` | 刻度**数值位置** | 偶尔使用 |
275
+ | `tickFormatter` | `(datum, index, array, vector) => DisplayObject` | 刻度**线图形** | 极少使用 |
276
+
277
+ > ❌ 常见错误:把 `tickFormatter` 当 `labelFormatter` 用——`tickFormatter` 返回的是图形对象,不是字符串,用错会导致标签不显示。
278
+
279
+ ### 常用格式化场景
280
+
281
+ ```javascript
282
+ // 数值格式化
283
+ axis: { y: { labelFormatter: (v) => `${(v / 1000).toFixed(0)}K` } }
284
+
285
+ // 百分比格式化
286
+ axis: { y: { labelFormatter: (v) => `${(v * 100).toFixed(0)}%` } }
287
+
288
+ // 货币格式化
289
+ axis: { y: { labelFormatter: (v) => `¥${v.toLocaleString()}` } }
290
+
291
+ // 日期格式化(x 轴为 Date 类型)
292
+ axis: { x: { labelFormatter: 'MM/DD' } }
293
+
294
+ // 保留两位小数(纯 d3-format,不能追加文字单位)
295
+ axis: { y: { labelFormatter: '.2f' } } // ✅ 纯 d3-format
296
+ // axis: { y: { labelFormatter: '.2f 元' } } // ❌ 无效!d3-format 后不能加文字
297
+ ```
298
+
299
+ ### 隐藏坐标轴
300
+
301
+ ```javascript
302
+ // 完全隐藏某轴
303
+ axis: { x: false }
304
+
305
+ // 只隐藏标题
306
+ axis: { y: { title: false } }
307
+
308
+ // 只隐藏网格线
309
+ axis: { y: { grid: false } }
310
+ ```
311
+
312
+ ### 修改坐标轴文本配色
313
+
314
+ ```javascript
315
+ chart.options({
316
+ type: 'line',
317
+ data,
318
+ encode: { x: 'date', y: 'value' },
319
+ axis: {
320
+ x: {
321
+ labelFill: '#8c8c8c', // 标签文字颜色
322
+ labelFontSize: 12,
323
+ titleFill: '#595959', // 标题文字颜色
324
+ titleFontSize: 13,
325
+ titleFontWeight: 'bold',
326
+ },
327
+ y: {
328
+ labelFill: '#8c8c8c',
329
+ titleFill: '#595959',
330
+ },
331
+ },
332
+ });
333
+ ```
334
+
335
+ ### 网格线区域交替填充(gridAreaFill)
336
+
337
+ ```javascript
338
+ chart.options({
339
+ type: 'line',
340
+ data,
341
+ encode: { x: 'month', y: 'value' },
342
+ axis: {
343
+ y: {
344
+ grid: true,
345
+ gridAreaFill: ['rgba(0,0,0,0.04)', 'transparent'], // 交替填充,增强可读性
346
+ gridLineWidth: 0, // 隐藏网格线本身,只显示区域色
347
+ },
348
+ },
349
+ });
350
+
351
+ // 也可以用函数控制
352
+ axis: {
353
+ y: {
354
+ gridAreaFill: (datum, index) => index % 2 === 0 ? 'rgba(0,0,0,0.04)' : '',
355
+ },
356
+ }
357
+ ```
358
+
359
+ ### 断轴(breaks)—— 跳过数据空洞
360
+
361
+ ```javascript
362
+ // 当数据中某段范围远超其他值,用断轴压缩该区间
363
+ chart.options({
364
+ type: 'interval',
365
+ data: [
366
+ { x: 'A', y: 100 },
367
+ { x: 'B', y: 200 },
368
+ { x: 'C', y: 95000 }, // 异常值,导致其他柱看不清
369
+ { x: 'D', y: 150 },
370
+ ],
371
+ encode: { x: 'x', y: 'y' },
372
+ axis: {
373
+ y: {
374
+ breaks: [
375
+ {
376
+ start: 500, // 断轴起点
377
+ end: 90000, // 断轴终点(跳过这段区间)
378
+ gap: '3%', // 断轴占画布高度比例
379
+ },
380
+ ],
381
+ },
382
+ },
383
+ });
384
+ ```
385
+
386
+ ### 双 y 轴
387
+
388
+ ```javascript
389
+ // 使用 view 容器 + 不同 y 比例尺实现双轴
390
+ chart.options({
391
+ type: 'view',
392
+ data,
393
+ children: [
394
+ {
395
+ type: 'interval',
396
+ encode: { x: 'month', y: 'revenue' },
397
+ axis: { y: { title: '收入', position: 'left' } },
398
+ },
399
+ {
400
+ type: 'line',
401
+ encode: { x: 'month', y: 'growth' },
402
+ scale: { y: { key: 'right' } },
403
+ axis: { y: { title: '增速', position: 'right' } },
404
+ },
405
+ ],
406
+ });
407
+ ```
408
+
409
+ ---
410
+
411
+ ## 常见错误与修正
412
+
413
+ ### 错误 1:axis 写在 encode 或 scale 里
414
+
415
+ ```javascript
416
+ // ❌ 错误:axis 是独立的顶级字段
417
+ chart.options({
418
+ encode: { x: 'month', y: 'value' },
419
+ scale: { x: { title: '月份' } }, // title 不在 scale 里
420
+ });
421
+
422
+ // ✅ 正确:axis 是与 encode/scale 平级的字段
423
+ chart.options({
424
+ encode: { x: 'month', y: 'value' },
425
+ axis: { x: { title: '月份' } },
426
+ });
427
+ ```
428
+
429
+ ### 错误 2:样式属性名错误
430
+
431
+ ```javascript
432
+ // ❌ 错误的属性名
433
+ axis: { x: { fontSize: 12 } } // 不存在
434
+
435
+ // ✅ 正确的属性名(带前缀)
436
+ axis: { x: { labelFontSize: 12 } } // 标签字体大小
437
+ axis: { x: { titleFontSize: 14 } } // 标题字体大小
438
+ ```
439
+
440
+ ### 错误 3:混淆轴标题与图表标题
441
+
442
+ ```javascript
443
+ // ❌ 轴标题写在 title 里
444
+ title: { title: '月份' } // 这是图表标题
445
+
446
+ // ✅ 轴标题在 axis 里
447
+ axis: { x: { title: '月份' } } // 这是 X 轴标题
448
+ ```
449
+
450
+ ### 错误 4:用 tickFormatter 格式化标签文字
451
+
452
+ ```javascript
453
+ // ❌ 错误:tickFormatter 返回的是 DisplayObject(图形对象),不是字符串
454
+ axis: {
455
+ y: {
456
+ tickFormatter: (v) => `${v / 1000}K`, // ❌ 返回字符串给 tickFormatter 无效
457
+ },
458
+ }
459
+
460
+ // ✅ 正确:标签文字格式化用 labelFormatter
461
+ axis: {
462
+ y: {
463
+ labelFormatter: (v) => `${v / 1000}K`, // ✅ labelFormatter 返回 string
464
+ },
465
+ }
466
+ ```
467
+
468
+ ### 错误 5:在 scale.tickMethod 里格式化标签或接收 scale 对象
469
+
470
+ ```javascript
471
+ // ❌ 错误:tickMethod 参数不是 scale 对象,返回值不是对象数组
472
+ scale: {
473
+ y: {
474
+ tickMethod: (scale) => { // ❌ 参数不是 scale 对象
475
+ return scale.ticks().map(v => ({ // ❌ scale.ticks() 不存在
476
+ value: v, text: `${v}K` // ❌ 不能返回对象,只能返回 number[]
477
+ }));
478
+ },
479
+ },
480
+ }
481
+
482
+ // ✅ 正确:tickMethod 签名是 (min, max, count) => number[]
483
+ // 格式化文字另用 labelFormatter
484
+ scale: {
485
+ y: {
486
+ tickMethod: (min, max, count) => [100, 500, 1000, 5000, 10000], // ✅ number[]
487
+ },
488
+ },
489
+ axis: {
490
+ y: {
491
+ labelFormatter: (v) => `${v / 1000}K`, // ✅ 文字格式化在 axis
492
+ },
493
+ }
494
+ ```
495
+
496
+ ### 错误 6:labelFormatter 用 d3-format 字符串拼接单位
497
+
498
+ `labelFormatter` 与 `tooltip.items[].valueFormatter` 一样,支持函数或 d3-format 字符串两种形式。**d3-format 字符串只格式化数字,不能在后面追加文字单位**——`'.2f 元'`、`'.0f 米'` 是无效写法。
499
+
500
+ ```javascript
501
+ // ❌ 错误:d3-format 字符串后追加文字单位
502
+ axis: {
503
+ y: { labelFormatter: '.2f 元' }, // ❌ d3-format 不支持拼接文字,标签异常
504
+ x: { labelFormatter: '.0f 米' }, // ❌ 同上
505
+ }
506
+
507
+ // ✅ 正确:需要拼接单位时必须用函数形式
508
+ axis: {
509
+ y: { labelFormatter: (v) => `${v.toFixed(2)} 元` }, // ✅ 函数,可拼接任意文字
510
+ x: { labelFormatter: (v) => `${Math.round(v)} 米` }, // ✅ 函数
511
+ }
512
+
513
+ // ✅ 纯数字格式化(不加单位)可用 d3-format 字符串
514
+ axis: {
515
+ y: { labelFormatter: '.2f' }, // ✅ 保留两位小数
516
+ x: { labelFormatter: ',.0f' }, // ✅ 千分位整数
517
+ z: { labelFormatter: '.1%' }, // ✅ 百分比
518
+ }
519
+ ```
520
+
521
+ ### 错误 7:labelFormatter 回调函数签名错误
522
+
523
+ `labelFormatter` 的回调函数签名应为 `(datum, index, array) => string`,其中:
524
+
525
+ - `datum`: 当前刻度值(通常是数值或字符串)
526
+ - `index`: 当前刻度索引
527
+ - `array`: 所有刻度值组成的数组
528
+
529
+ ```javascript
530
+ // ❌ 错误:参数顺序错误或使用了不存在的参数
531
+ axis: {
532
+ x: {
533
+ labelFormatter: (task, item) => { // ❌ item 参数不存在
534
+ return `${item.data.stage}-${task}`;
535
+ }
536
+ }
537
+ }
538
+
539
+ // ✅ 正确:使用正确的参数签名
540
+ axis: {
541
+ x: {
542
+ labelFormatter: (datum, index, array) => {
543
+ // 注意:此时 datum 是原始数据中的字段值,不是整个数据项
544
+ return `${datum}`; // 返回字符串即可
545
+ }
546
+ }
547
+ }
548
+
549
+ // ✅ 更推荐的做法:在 encode 中预处理复合标签
550
+ chart.options({
551
+ encode: {
552
+ x: (d) => `${d.stage} - ${d.task}`, // 在 encode 中构造复合标签
553
+ y: 'start',
554
+ y1: 'end'
555
+ },
556
+ axis: {
557
+ x: {
558
+ labelTransform: 'rotate(30)' // 如需旋转标签防止重叠
559
+ }
560
+ }
561
+ });
562
+ ```
563
+
564
+ ### 错误 8:legend.labelFormatter 与 axis.labelFormatter 混淆
565
+
566
+ 虽然两者都用于格式化标签,但它们作用的对象不同。`legend.labelFormatter` 用于图例标签,而 `axis.labelFormatter` 用于坐标轴刻度标签。
567
+
568
+ ```javascript
569
+ // ❌ 错误:在 legend 中使用 axis.labelFormatter
570
+ legend: {
571
+ color: {
572
+ labelFormatter: '.0%' // ❌ legend 不支持 axis 的 labelFormatter
573
+ }
574
+ }
575
+
576
+ // ✅ 正确:legend 使用自己的 labelFormatter
577
+ legend: {
578
+ color: {
579
+ labelFormatter: (value) => `${Math.round(value)}%` // ✅ 函数形式
580
+ }
581
+ }
582
+ ```
583
+
584
+ ### 错误 9:tooltip.valueFormatter 与 axis.labelFormatter 混淆
585
+
586
+ `tooltip.valueFormatter` 用于格式化提示框中的值,而 `axis.labelFormatter` 用于坐标轴标签。
587
+
588
+ ```javascript
589
+ // ❌ 错误:在 tooltip.items 中使用 axis.labelFormatter
590
+ tooltip: {
591
+ items: [
592
+ { channel: 'y', labelFormatter: '.2f' } // ❌ tooltip.items 不支持 labelFormatter
593
+ ]
594
+ }
595
+
596
+ // ✅ 正确:tooltip.items 使用 valueFormatter
597
+ tooltip: {
598
+ items: [
599
+ { channel: 'y', valueFormatter: '.2f' } // ✅ 使用 valueFormatter
600
+ ]
601
+ }
602
+ ```
603
+
604
+ ### 错误 10:cell 图表中 style.inset 设置不当导致渲染空白
605
+
606
+ 在 `cell` 类型图表中,`style.inset` 控制单元格的内边距。如果设置过大,可能导致单元格不可见。
607
+
608
+ ```javascript
609
+ // ❌ 错误:inset 设置过大
610
+ chart.options({
611
+ type: 'cell',
612
+ data,
613
+ encode: { x: 'x', y: 'y', color: 'value' },
614
+ style: {
615
+ inset: 10 // ❌ inset 太大,可能使矩形不可见
616
+ }
617
+ });
618
+
619
+ // ✅ 正确:合理设置 inset
620
+ chart.options({
621
+ type: 'cell',
622
+ data,
623
+ encode: { x: 'x', y: 'y', color: 'value' },
624
+ style: {
625
+ inset: 0.5 // ✅ 合理的 inset 值
626
+ }
627
+ });
628
+ ```
629
+
630
+ ### 错误 11:legend.layout 配置错误导致布局异常
631
+
632
+ `legend.layout` 使用 Flexbox 布局模型,若配置不当会影响图例排版。
633
+
634
+ ```javascript
635
+ // ❌ 错误:justifyContent 写错或不支持的值
636
+ legend: {
637
+ color: {
638
+ layout: { justifyContent: 'centered' } // ❌ 不支持的值
639
+ }
640
+ }
641
+
642
+ // ✅ 正确:使用合法的 Flexbox 值
643
+ legend: {
644
+ color: {
645
+ layout: { justifyContent: 'center' } // ✅ 正确值
646
+ }
647
+ }
648
+ ```