boardplot 0.57.0 → 0.58.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 (496) hide show
  1. package/CHANGELOG.md +311 -0
  2. package/README.md +48 -14
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-FXNTFSA4.js} +2 -2
  4. package/dist/{ReaderBox-GCIITQCX.js → ReaderBox-WVOT7VVJ.js} +8 -7
  5. package/dist/{annotateEngine-JMZI6QEG.js → annotateEngine-57L26X77.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-6LQKU6YN.js → chunk-23FT7RLN.js} +11 -10
  8. package/dist/{chunk-5WSIH4SR.js → chunk-2CQBBN7M.js} +4 -4
  9. package/dist/chunk-2DS4MT7T.js +25 -0
  10. package/dist/{chunk-QFIRPOXR.js → chunk-2HII2B6S.js} +3 -3
  11. package/dist/{chunk-JMOBA5ES.js → chunk-2IRMGCYE.js} +2 -2
  12. package/dist/{chunk-JKXJWCJ5.js → chunk-2SWSUNA4.js} +116 -54
  13. package/dist/{chunk-O7Y6RJ4D.js → chunk-33EBLJVZ.js} +11 -11
  14. package/dist/{chunk-EHQLLZCQ.js → chunk-34PKJZRY.js} +59 -34
  15. package/dist/{chunk-SHAAMKN7.js → chunk-35ZJUZUO.js} +18 -18
  16. package/dist/{chunk-TGR6PRKG.js → chunk-3BMPYY26.js} +6 -3
  17. package/dist/{chunk-XJUZC53Y.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-H3EWFSWI.js → chunk-3ESWPMDW.js} +43 -29
  19. package/dist/{chunk-6KHRMK3I.js → chunk-3M2F7KSS.js} +158 -75
  20. package/dist/{chunk-UBXIGE2P.js → chunk-3MFVJMP6.js} +2 -2
  21. package/dist/{chunk-MOQFYJ3F.js → chunk-3OSQ32GN.js} +5 -5
  22. package/dist/{chunk-HGPFEG2L.js → chunk-3RXUA6VY.js} +5 -5
  23. package/dist/{chunk-I65OLJ2X.js → chunk-42QKUSHJ.js} +13 -3
  24. package/dist/{chunk-FAFUMSPR.js → chunk-4DK67I3B.js} +83 -51
  25. package/dist/{chunk-EEBMK6T6.js → chunk-4DMRIL5K.js} +8 -8
  26. package/dist/chunk-4M3UADCM.js +602 -0
  27. package/dist/{chunk-WSKZZ2ZB.js → chunk-4OJF6DXL.js} +538 -503
  28. package/dist/{chunk-UD6U4EF5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-I7KDPCC7.js → chunk-4TUU3UGY.js} +18 -10
  30. package/dist/{chunk-6ZN2XJFI.js → chunk-54YO56IK.js} +1 -1
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-BQIADGJB.js → chunk-5CYLT6FJ.js} +5 -5
  33. package/dist/{chunk-IVQT2E3Y.js → chunk-5I4RPBNE.js} +13 -13
  34. package/dist/{chunk-LW4ZQGVL.js → chunk-5KAYLRRP.js} +7 -8
  35. package/dist/{chunk-2BHLRHF2.js → chunk-5SVGTQTW.js} +4 -4
  36. package/dist/{chunk-5JTRCSBN.js → chunk-62BDQTO6.js} +2 -2
  37. package/dist/{chunk-4RN4OM6I.js → chunk-63JUV7NR.js} +3 -3
  38. package/dist/chunk-645BGVPP.js +26 -0
  39. package/dist/{chunk-JIH52I36.js → chunk-65U6ZBZZ.js} +119 -85
  40. package/dist/{chunk-3DUGZ7ML.js → chunk-6ALORYH7.js} +46 -31
  41. package/dist/{chunk-HB3TH7GY.js → chunk-6AVUTZ6W.js} +10 -6
  42. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  43. package/dist/{chunk-W5SVS4B6.js → chunk-6JFQCVNN.js} +4 -4
  44. package/dist/{chunk-IZRTNCJQ.js → chunk-6JTCFPAD.js} +5 -5
  45. package/dist/{chunk-5TUDYKNL.js → chunk-6NGKQNTB.js} +42 -29
  46. package/dist/{chunk-IUVJVMKS.js → chunk-6V3A3MTG.js} +55 -32
  47. package/dist/{chunk-FJKFYQ5I.js → chunk-6YBNVI5I.js} +36 -28
  48. package/dist/chunk-76GPN6AT.js +72 -0
  49. package/dist/{chunk-SHCW2TCA.js → chunk-7GRR72MY.js} +25 -23
  50. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  51. package/dist/{chunk-Y5IKCXQR.js → chunk-7YZZCQT3.js} +5 -5
  52. package/dist/chunk-A65B23JK.js +113 -0
  53. package/dist/{chunk-2WTD3GCR.js → chunk-A6N24NGW.js} +3 -3
  54. package/dist/{chunk-72OJBDRB.js → chunk-AAQWFTDM.js} +52 -41
  55. package/dist/{chunk-4JNHF6JW.js → chunk-AGJ2QL4A.js} +84 -40
  56. package/dist/{chunk-I3DLERI7.js → chunk-AICO24HJ.js} +5 -2
  57. package/dist/{chunk-LSKCKGCF.js → chunk-AJGSCVVW.js} +2 -2
  58. package/dist/{chunk-7P7D6WXR.js → chunk-AKZOQGF3.js} +3 -3
  59. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  60. package/dist/{chunk-VY67Q6CJ.js → chunk-AMBQ6SWU.js} +36 -33
  61. package/dist/{chunk-73O6AOAA.js → chunk-AQ2PQ7FK.js} +241 -140
  62. package/dist/{chunk-XFCBH3TI.js → chunk-BHLNSJG7.js} +3 -3
  63. package/dist/{chunk-6XU5XGYV.js → chunk-BQ7SN7AW.js} +5 -5
  64. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  65. package/dist/{chunk-LSR3SBJ4.js → chunk-BSZOQJXB.js} +234 -136
  66. package/dist/{chunk-KJLH5EHD.js → chunk-BVIJCUWW.js} +175 -110
  67. package/dist/{chunk-2AJWRVZ2.js → chunk-C47POAC5.js} +1 -1
  68. package/dist/{chunk-AOIZJ7GR.js → chunk-C4SQU2PB.js} +6 -6
  69. package/dist/{chunk-Y7Q3VEYC.js → chunk-CCAAI56H.js} +30 -10
  70. package/dist/{chunk-T3WCDDIL.js → chunk-CDUR3KWV.js} +2 -2
  71. package/dist/{chunk-T5MBORBK.js → chunk-CFESVCZR.js} +1 -1
  72. package/dist/{chunk-EEL2N4Y6.js → chunk-CKEFAD4R.js} +5 -5
  73. package/dist/{chunk-WE5WVQE4.js → chunk-CMPHT2LS.js} +3 -3
  74. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  75. package/dist/{chunk-JSA3ESEJ.js → chunk-CR5FP5SF.js} +1 -1
  76. package/dist/{chunk-NCCDEUHD.js → chunk-CSMVKG2C.js} +1 -1
  77. package/dist/{chunk-JHWDTV4K.js → chunk-D2TQX7UJ.js} +2 -2
  78. package/dist/{chunk-GHFTKVJN.js → chunk-DHGE46UK.js} +1 -1
  79. package/dist/{chunk-26WNBTWB.js → chunk-DORE2RHL.js} +5 -5
  80. package/dist/{chunk-AFA32LHN.js → chunk-DUOGEFLG.js} +62 -36
  81. package/dist/{chunk-WZB6R2ZX.js → chunk-DZYTXZNS.js} +11 -3
  82. package/dist/{chunk-O4D27FKH.js → chunk-E5YF236N.js} +4 -1
  83. package/dist/{chunk-6EE6XEMA.js → chunk-EB4PQEI3.js} +26 -17
  84. package/dist/{chunk-ANNQJWDX.js → chunk-EBWMTQ4U.js} +285 -34
  85. package/dist/{chunk-EHNGPUTO.js → chunk-EDW5HQND.js} +5 -5
  86. package/dist/{chunk-VM5CQ7CG.js → chunk-EHRRHSPV.js} +2 -2
  87. package/dist/{chunk-PYGEIPPH.js → chunk-EILNJQMN.js} +32 -12
  88. package/dist/{chunk-KGS5Z7SL.js → chunk-ERDKMZ7O.js} +2 -2
  89. package/dist/{chunk-USFIDSTO.js → chunk-ETUKDEGL.js} +18 -11
  90. package/dist/chunk-F2ET5ZTT.js +49 -0
  91. package/dist/{chunk-HVX2E26J.js → chunk-F3XOBFS4.js} +9 -8
  92. package/dist/{chunk-I4NUYVP5.js → chunk-FB6X7QHA.js} +1 -1
  93. package/dist/{chunk-LO3AGGE3.js → chunk-FJNZ7NWD.js} +5 -5
  94. package/dist/{chunk-IRXTNSZL.js → chunk-FPFRLRQO.js} +40 -22
  95. package/dist/{chunk-YTEJYLU7.js → chunk-FRR7BJ3B.js} +2 -2
  96. package/dist/{chunk-DPUCT567.js → chunk-FVWHEM2N.js} +7 -5
  97. package/dist/{chunk-A33MFWHW.js → chunk-G7BCLYL4.js} +2 -2
  98. package/dist/{chunk-2KCK63DD.js → chunk-G7CXJPEN.js} +2 -2
  99. package/dist/{chunk-2X6XY4K4.js → chunk-GB3RZYTK.js} +39 -19
  100. package/dist/{chunk-MTCDGSYW.js → chunk-GHCU6OSE.js} +2 -2
  101. package/dist/{chunk-AFGQXMKT.js → chunk-GNMB72V7.js} +161 -67
  102. package/dist/chunk-GOFS336W.js +24 -0
  103. package/dist/{chunk-JMXNXLAC.js → chunk-GQYT7G4F.js} +2 -2
  104. package/dist/{chunk-RRPTQGRU.js → chunk-H3VICNTN.js} +1 -1
  105. package/dist/{chunk-JRRSKCGG.js → chunk-H4EDDGGX.js} +3 -3
  106. package/dist/{chunk-5H4HFRDO.js → chunk-H7BCNS5J.js} +5 -5
  107. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  108. package/dist/chunk-HF4BCPIV.js +26 -0
  109. package/dist/{chunk-YCUNFAEE.js → chunk-HM4AJ5U4.js} +238 -127
  110. package/dist/{chunk-7FAO4ICF.js → chunk-HO4ILCW7.js} +2 -2
  111. package/dist/{chunk-ZV3SNRJI.js → chunk-HTQGJQZN.js} +4 -2
  112. package/dist/{chunk-G5BUGYIL.js → chunk-I52OMC5B.js} +192 -113
  113. package/dist/{chunk-TMXRTYGT.js → chunk-I5VNHDPR.js} +3 -2
  114. package/dist/{chunk-M74H7QYD.js → chunk-IDXYHDQY.js} +1 -1
  115. package/dist/{chunk-SSZB3VXG.js → chunk-IFUAPFL5.js} +102 -47
  116. package/dist/{chunk-IPWUBZ4P.js → chunk-IIWZJ5ZM.js} +1 -1
  117. package/dist/{chunk-KF3ZHLHQ.js → chunk-IMUMPKXF.js} +5 -5
  118. package/dist/{chunk-HC6WHTBX.js → chunk-IPBOREIY.js} +1 -1
  119. package/dist/{chunk-76UL4CT4.js → chunk-IPZJCBWD.js} +27 -22
  120. package/dist/{chunk-5P4MXWKP.js → chunk-ITEJQHXE.js} +4 -4
  121. package/dist/{chunk-WDAZ2MT4.js → chunk-IVDTP6SV.js} +4 -4
  122. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  123. package/dist/{chunk-K6Y4HBK7.js → chunk-IXU5C3YY.js} +1000 -904
  124. package/dist/{chunk-EDBUVDRI.js → chunk-JBAVMO56.js} +372 -93
  125. package/dist/{chunk-VY2NPB2Q.js → chunk-JNDWRV34.js} +4 -4
  126. package/dist/{chunk-XYUXB5VK.js → chunk-JT3UTEWZ.js} +3 -3
  127. package/dist/{chunk-A6XCVOC5.js → chunk-JY4LTPOV.js} +1 -1
  128. package/dist/{chunk-VT7PBGL2.js → chunk-JYSFAH7C.js} +23 -36
  129. package/dist/chunk-K7XPTQBJ.js +267 -0
  130. package/dist/{chunk-2I76VFMZ.js → chunk-KI7VCHNZ.js} +49 -37
  131. package/dist/{chunk-YB6QGOCO.js → chunk-KUWIRCYJ.js} +2 -2
  132. package/dist/{chunk-MQ5EKWIG.js → chunk-KVBLTAO7.js} +5 -5
  133. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  134. package/dist/{chunk-BY5JGQFZ.js → chunk-KWIP5YRA.js} +4 -4
  135. package/dist/{chunk-KAAB2DIV.js → chunk-LJDATBPB.js} +6 -6
  136. package/dist/{chunk-TDDSWNGD.js → chunk-LOXZSTIM.js} +30 -28
  137. package/dist/{chunk-ZTSJ7NY6.js → chunk-LPMSGO7L.js} +3 -3
  138. package/dist/{chunk-IXM6BAM4.js → chunk-LXH4RPY4.js} +1 -1
  139. package/dist/{chunk-D5G67OER.js → chunk-LYAT62UT.js} +1 -1
  140. package/dist/{chunk-EFKFZNQC.js → chunk-M5LPP2GQ.js} +34 -20
  141. package/dist/{chunk-QZMLSK43.js → chunk-MALSSEXO.js} +294 -145
  142. package/dist/{chunk-XN7JDII2.js → chunk-MB5EX2YG.js} +230 -107
  143. package/dist/{chunk-PSYPB22T.js → chunk-MGXHFRQK.js} +5 -5
  144. package/dist/{chunk-GADI2DU7.js → chunk-MVR7YKBF.js} +152 -27
  145. package/dist/{chunk-IFURKTOL.js → chunk-MXUPMGRY.js} +2 -2
  146. package/dist/{chunk-C5SQEYTQ.js → chunk-NFGV5OAR.js} +153 -65
  147. package/dist/{chunk-RZNYW7UP.js → chunk-NNIZG3TH.js} +8 -0
  148. package/dist/{chunk-AKJO6N4K.js → chunk-NQPJWQTW.js} +11 -4
  149. package/dist/{chunk-YFI5PN5O.js → chunk-NSMYIUBZ.js} +34 -11
  150. package/dist/{chunk-H6EJ63QN.js → chunk-NT3HCXQC.js} +144 -83
  151. package/dist/chunk-NZ7FX3AE.js +65 -0
  152. package/dist/chunk-O3LT4TAI.js +34 -0
  153. package/dist/{chunk-L2XRUG4P.js → chunk-OELB7MTE.js} +5 -5
  154. package/dist/{chunk-7MYJUJZV.js → chunk-OMNB27GM.js} +4 -4
  155. package/dist/{chunk-GS5UG6QD.js → chunk-OO63YP35.js} +1 -1
  156. package/dist/{chunk-CEMXGMQN.js → chunk-OQUH7I5T.js} +3 -3
  157. package/dist/{chunk-Q7VPTN5X.js → chunk-OS7C2KMQ.js} +4 -4
  158. package/dist/{chunk-NRYERHEI.js → chunk-OTWIW2L3.js} +5 -5
  159. package/dist/chunk-OUNYHYJL.js +27 -0
  160. package/dist/{chunk-54HEIM2A.js → chunk-OUR5ZHCB.js} +2 -2
  161. package/dist/{chunk-Z257SH5U.js → chunk-OZA7HA6L.js} +1 -1
  162. package/dist/{chunk-WJQX7HBH.js → chunk-OZLKEBCD.js} +2 -2
  163. package/dist/{chunk-YGPLUENN.js → chunk-P3NMDPDP.js} +132 -83
  164. package/dist/{chunk-NINK4G7U.js → chunk-P5RCP4NK.js} +2 -2
  165. package/dist/{chunk-DYSEZVIJ.js → chunk-P6DEFCMQ.js} +2 -2
  166. package/dist/{chunk-J22ETKDJ.js → chunk-P7UOOMXE.js} +2 -2
  167. package/dist/chunk-PMT75APP.js +94 -0
  168. package/dist/{chunk-KLQKHA3T.js → chunk-PNYWBY4K.js} +5 -5
  169. package/dist/{chunk-XNV7VOIT.js → chunk-PVGJM2HP.js} +4 -4
  170. package/dist/{chunk-4U2WSW6F.js → chunk-Q2I3QLE3.js} +65 -36
  171. package/dist/{chunk-LGMV7ZV4.js → chunk-QATOOZMH.js} +5 -5
  172. package/dist/{chunk-H2POQ4LB.js → chunk-QFNWGSCT.js} +4 -4
  173. package/dist/{chunk-CIDOL4FO.js → chunk-QQMESIDA.js} +5 -5
  174. package/dist/{chunk-OTGNVAI4.js → chunk-R3VSWOTI.js} +4 -4
  175. package/dist/{chunk-UCIAHSJK.js → chunk-R5SGE2NS.js} +7 -3
  176. package/dist/{chunk-FX5VZK5F.js → chunk-RJICOOB3.js} +14 -8
  177. package/dist/{chunk-RMVCKO6N.js → chunk-RLH2CQCD.js} +458 -136
  178. package/dist/{chunk-VFLMBA2M.js → chunk-RPGEB3Z5.js} +19 -18
  179. package/dist/{chunk-KIXNHDXS.js → chunk-RQKDEJFQ.js} +5 -5
  180. package/dist/chunk-SBKM6XFS.js +211 -0
  181. package/dist/{chunk-TQ5HHNM3.js → chunk-SCAYWQZK.js} +2 -2
  182. package/dist/{chunk-Y5WHM2Q5.js → chunk-SH4FLUAD.js} +1 -1
  183. package/dist/{chunk-7EQU2TUN.js → chunk-SH4UGK5U.js} +84 -53
  184. package/dist/{chunk-EY4OA4OF.js → chunk-SHYS52VO.js} +370 -785
  185. package/dist/{chunk-ZSYU6LIH.js → chunk-SKPOXLG5.js} +5 -5
  186. package/dist/{chunk-OAT6FWKL.js → chunk-T7PRG6AO.js} +5 -5
  187. package/dist/chunk-TBZT5WUT.js +39 -0
  188. package/dist/{chunk-5HTGSB6Y.js → chunk-TKH655ON.js} +3 -3
  189. package/dist/{chunk-YO5UKKCQ.js → chunk-TMEUK2WS.js} +6 -2
  190. package/dist/{chunk-X5OVVMZX.js → chunk-TVOMGNFQ.js} +1 -1
  191. package/dist/{chunk-JARJP576.js → chunk-TX5FSNAU.js} +435 -29
  192. package/dist/{chunk-LUZ7HXBT.js → chunk-U52PNFPX.js} +1 -1
  193. package/dist/{chunk-OKM5LYYP.js → chunk-U6QZOMYC.js} +5 -5
  194. package/dist/{chunk-F4JAGDPD.js → chunk-UBYDY4B7.js} +8 -8
  195. package/dist/{chunk-V3UE3TB7.js → chunk-UCKUAKYQ.js} +2 -2
  196. package/dist/{chunk-NO7GRVUU.js → chunk-UOOXWGBU.js} +8 -8
  197. package/dist/{chunk-LFX5BERN.js → chunk-USMKNNOU.js} +47 -33
  198. package/dist/chunk-USSG6TJV.js +23 -0
  199. package/dist/{chunk-HFFKN7PA.js → chunk-UY34DDUM.js} +3 -3
  200. package/dist/{chunk-3LNVEE5Z.js → chunk-V7FV66KL.js} +1 -1
  201. package/dist/{chunk-62JZL6FW.js → chunk-V7JFT7NQ.js} +56 -42
  202. package/dist/{chunk-UP4JSNDR.js → chunk-V7NUJEJE.js} +1 -1
  203. package/dist/{chunk-FERP4WS3.js → chunk-VACZGW5R.js} +16 -18
  204. package/dist/{chunk-BO5EJBLH.js → chunk-VC62V7CX.js} +82 -47
  205. package/dist/{chunk-53OEKS4L.js → chunk-VESSIKBG.js} +6 -3
  206. package/dist/chunk-VJULLJLN.js +70 -0
  207. package/dist/{chunk-QLWUFEKR.js → chunk-VKNQOSGW.js} +8 -8
  208. package/dist/{chunk-BFDPY7JM.js → chunk-VTY6YHQZ.js} +11 -6
  209. package/dist/{chunk-UFZXZJJG.js → chunk-W2QILXAL.js} +5 -5
  210. package/dist/{chunk-QHPJ5ZKS.js → chunk-W6XSIBLR.js} +5 -5
  211. package/dist/{chunk-DJBMA4FW.js → chunk-WDJSDJLV.js} +4 -6
  212. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  213. package/dist/{chunk-IW3YUMPI.js → chunk-WFBN2HXR.js} +2 -2
  214. package/dist/chunk-WGJIYFVQ.js +24 -0
  215. package/dist/{chunk-43PCSBVQ.js → chunk-WKXLJNHW.js} +634 -8
  216. package/dist/{chunk-EWR6WVOV.js → chunk-WLH5IBFY.js} +6 -6
  217. package/dist/{chunk-RHVP62HI.js → chunk-WMQ57FOP.js} +5 -5
  218. package/dist/{chunk-GKQLKUMF.js → chunk-WNTUBGBB.js} +41 -32
  219. package/dist/{chunk-RHBQ2Q5H.js → chunk-WOICFLOJ.js} +60 -43
  220. package/dist/{chunk-QNLESRH6.js → chunk-WUP6C4ZD.js} +2 -2
  221. package/dist/chunk-WVCDISZP.js +89 -0
  222. package/dist/{chunk-CT4RFZO4.js → chunk-WW4KLAVO.js} +38 -23
  223. package/dist/{chunk-I5ZADE2U.js → chunk-X3QUASBR.js} +1 -1
  224. package/dist/{chunk-TXMS7QUJ.js → chunk-X46PSAJ7.js} +6 -6
  225. package/dist/{chunk-Z2BDTZDT.js → chunk-XC32OSCD.js} +97 -39
  226. package/dist/{chunk-M2OQK2FO.js → chunk-XD5XB22R.js} +2 -2
  227. package/dist/chunk-XLLWIHN2.js +24 -0
  228. package/dist/{chunk-SD6ENKTO.js → chunk-XMX4PCFL.js} +3 -3
  229. package/dist/{chunk-BM2A3IGQ.js → chunk-XO44IJGZ.js} +1 -1
  230. package/dist/{chunk-2HD5RY2U.js → chunk-XRRG4MBM.js} +3 -3
  231. package/dist/chunk-XSC4IXXC.js +24 -0
  232. package/dist/{chunk-D5RAVZ5C.js → chunk-XSEETONJ.js} +10 -9
  233. package/dist/{chunk-YBYV56FS.js → chunk-XZOFKLTD.js} +3 -3
  234. package/dist/{chunk-YNHPPZ7S.js → chunk-XZXZNI7A.js} +1 -1
  235. package/dist/{chunk-W7Q6PLT4.js → chunk-Y6E4JU3U.js} +37 -37
  236. package/dist/{chunk-XR7VOF2V.js → chunk-YGWPOYDE.js} +25 -13
  237. package/dist/{chunk-HDSHS2QZ.js → chunk-YJUBX3QF.js} +70 -47
  238. package/dist/{chunk-BDCKHLUB.js → chunk-YLRAAJYV.js} +72 -304
  239. package/dist/{chunk-I6QGYRY4.js → chunk-YW35KSXR.js} +2 -2
  240. package/dist/{chunk-GAFEN3H7.js → chunk-Z3WQXVFV.js} +2 -2
  241. package/dist/{chunk-WKWCNS6K.js → chunk-Z62TJQO5.js} +5 -5
  242. package/dist/{chunk-D3PQAVFW.js → chunk-Z6DUNKFU.js} +152 -29
  243. package/dist/{chunk-FF7MV4D4.js → chunk-Z6H5ED2I.js} +1 -1
  244. package/dist/{chunk-TWRFVW3J.js → chunk-ZB3JIL3L.js} +138 -89
  245. package/dist/{chunk-KUMJI5B6.js → chunk-ZBCCJPGW.js} +17 -14
  246. package/dist/{chunk-CV3NC75L.js → chunk-ZBOOMLHD.js} +1 -1
  247. package/dist/{chunk-QRZESG66.js → chunk-ZCHKIR7C.js} +64 -239
  248. package/dist/{chunk-ZDD3MJ2H.js → chunk-ZDJ7C64T.js} +1 -1
  249. package/dist/{chunk-KQ2WZ6BY.js → chunk-ZG4BMJRL.js} +1 -1
  250. package/dist/{chunk-QYOZ46ZQ.js → chunk-ZIVCPXXL.js} +467 -650
  251. package/dist/{chunk-V62B23VC.js → chunk-ZNRSYS76.js} +8 -2
  252. package/dist/{chunk-NIDH22DI.js → chunk-ZSYFQSPF.js} +12 -2
  253. package/dist/cli/index.js +8 -3
  254. package/dist/{core-5S5CJHBG.js → core-2GWH3ED7.js} +2 -1
  255. package/dist/{core-ZSERZGK6.js → core-3LCSHMKN.js} +3 -1
  256. package/dist/{core-FTQBESDS.js → core-3NQ5TXOJ.js} +3 -1
  257. package/dist/{core-D2OIGYC7.js → core-3XGQBHJI.js} +4 -1
  258. package/dist/{core-T3OSZOVV.js → core-4N6WH3IF.js} +3 -1
  259. package/dist/{core-VRVL6LIM.js → core-5CRTPVYA.js} +3 -1
  260. package/dist/{core-7XKNJM7Y.js → core-5K4HRIHX.js} +5 -1
  261. package/dist/{core-CCB3IXGD.js → core-743ZXTWK.js} +3 -1
  262. package/dist/{core-4M4RY7MX.js → core-7OAGK7ZJ.js} +3 -1
  263. package/dist/{core-VT35VDVS.js → core-7YDNMUU3.js} +6 -1
  264. package/dist/{core-4PW4MXWR.js → core-AAPPZSSZ.js} +4 -1
  265. package/dist/{core-OBPTBKX6.js → core-AC5AKSCM.js} +2 -1
  266. package/dist/{core-QFAVWFI3.js → core-AEALAFRA.js} +2 -1
  267. package/dist/{core-WXZJ7V7S.js → core-BEK6EPVF.js} +4 -1
  268. package/dist/{core-WP73P4CW.js → core-BRBJ3LPF.js} +5 -1
  269. package/dist/{core-AVA4XLQ2.js → core-EGTJOQK7.js} +2 -1
  270. package/dist/{core-XKXDXALI.js → core-FE4THVV3.js} +6 -1
  271. package/dist/{core-MAW4S3KA.js → core-FEBNVNVE.js} +5 -1
  272. package/dist/{core-L3UR75IJ.js → core-HIONDJGC.js} +4 -1
  273. package/dist/{core-GS4DXDDG.js → core-HMBMMF5Z.js} +4 -1
  274. package/dist/{core-QM34237W.js → core-LSYX4UQQ.js} +2 -1
  275. package/dist/{core-N2JEWJ7D.js → core-MIERUUUT.js} +2 -1
  276. package/dist/{core-A7HXVSKB.js → core-NTOOJZRA.js} +2 -1
  277. package/dist/{core-JDZDBTID.js → core-O5S2NETE.js} +2 -1
  278. package/dist/{core-OFPPRHYY.js → core-Q2Y3JEWL.js} +3 -1
  279. package/dist/{core-BJZEJ63L.js → core-RTBPKALG.js} +3 -1
  280. package/dist/{core-WNT6ZMRO.js → core-T7CKLMT2.js} +2 -1
  281. package/dist/{core-VWYXK2R3.js → core-TIIPSEK3.js} +4 -1
  282. package/dist/{core-EMSJRGSE.js → core-VBMWBPKM.js} +2 -1
  283. package/dist/{core-WPEYRK6Y.js → core-VLXOQ5CK.js} +4 -1
  284. package/dist/{core-7TTM4KRP.js → core-VYHQ5JY6.js} +3 -1
  285. package/dist/{core-DMDAXVMY.js → core-XJZWD43V.js} +2 -1
  286. package/dist/{core-AMWCZTOT.js → core-XUNZB6BM.js} +5 -1
  287. package/dist/{core-UNX4ZV4M.js → core-YKDDPMWW.js} +5 -1
  288. package/dist/{core-SKMHEA4Y.js → core-YN2VVGUL.js} +3 -1
  289. package/dist/{core-ZACFV6XR.js → core-YP4MNIMV.js} +5 -1
  290. package/dist/{core-FCSA74RT.js → core-ZETBHLSV.js} +3 -1
  291. package/dist/{dataTable-7IO546LM.js → dataTable-FEQZSDUZ.js} +7 -2
  292. package/dist/{engine-US3N6UCH.js → engine-SCQVNSAM.js} +23 -18
  293. package/dist/fixtures.js +2 -1
  294. package/dist/flags-BVLSAXT3.js +10 -0
  295. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  296. package/dist/geo/dach.js +1 -1
  297. package/dist/geo/de-states.js +1 -1
  298. package/dist/geo/eu27.js +1 -1
  299. package/dist/geo/europe.js +1 -1
  300. package/dist/geo/index.js +2 -2
  301. package/dist/geo/us-states.js +1 -1
  302. package/dist/geo/world.js +1 -1
  303. package/dist/index.js +27 -20
  304. package/dist/{main-2UWKGUHR.js → main-7UKLXCIL.js} +50 -119
  305. package/dist/mcp/server.js +121 -118
  306. package/dist/react/bar.js +5 -1
  307. package/dist/react/bartable.js +3 -1
  308. package/dist/react/box.js +3 -1
  309. package/dist/react/bullet.js +4 -1
  310. package/dist/react/butterfly.js +5 -1
  311. package/dist/react/choropleth.js +3 -1
  312. package/dist/react/cohort.js +3 -1
  313. package/dist/react/column.js +5 -1
  314. package/dist/react/combo.js +5 -1
  315. package/dist/react/creative.js +4 -1
  316. package/dist/react/diagram.js +3 -1
  317. package/dist/react/dimswitch.js +6 -1
  318. package/dist/react/dot.js +4 -1
  319. package/dist/react/export.js +29 -18
  320. package/dist/react/funnel.js +4 -1
  321. package/dist/react/gantt.js +3 -1
  322. package/dist/react/grid.js +6 -1
  323. package/dist/react/heatmap.js +3 -1
  324. package/dist/react/histogram.js +6 -1
  325. package/dist/react/index.js +92 -85
  326. package/dist/react/kpi.js +4 -1
  327. package/dist/react/likert.js +6 -1
  328. package/dist/react/line.js +4 -1
  329. package/dist/react/mekko.js +5 -1
  330. package/dist/react/pareto.js +6 -1
  331. package/dist/react/pie.js +4 -1
  332. package/dist/react/prepare.js +35 -22
  333. package/dist/react/pvm.js +6 -1
  334. package/dist/react/pyramid.js +5 -1
  335. package/dist/react/sankey.js +3 -1
  336. package/dist/react/scatter.js +3 -1
  337. package/dist/react/slope.js +4 -1
  338. package/dist/react/sparkline.js +4 -1
  339. package/dist/react/spec.js +17 -13
  340. package/dist/react/status.js +3 -1
  341. package/dist/react/story.js +3 -2
  342. package/dist/react/table.js +4 -1
  343. package/dist/react/theme.js +5 -3
  344. package/dist/react/tilemap.js +3 -1
  345. package/dist/react/treemap.js +3 -1
  346. package/dist/react/variance.js +5 -1
  347. package/dist/react/waffle.js +3 -1
  348. package/dist/react/waterfall.js +5 -1
  349. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  350. package/dist/rows.js +2 -2
  351. package/dist/{rowsModule-DYDVHBAX.js → rowsModule-WJH4QNXZ.js} +1 -1
  352. package/dist/{schema-YDZCGL56.js → schema-2R32F6AW.js} +1 -3
  353. package/dist/{schema-A2XUZUCV.js → schema-2TPGJGVR.js} +1 -3
  354. package/dist/{schema-MD22QYZU.js → schema-47BG2TZA.js} +1 -3
  355. package/dist/{schema-HEB6ZDI5.js → schema-56MOEOVR.js} +1 -3
  356. package/dist/{schema-K4V4PYBO.js → schema-5MSR4LNN.js} +1 -3
  357. package/dist/{schema-NOBNFD2F.js → schema-5RIYEWE6.js} +1 -3
  358. package/dist/{schema-OXO2XY4Y.js → schema-ALBF6V7Y.js} +1 -3
  359. package/dist/{schema-F2Q6MH7W.js → schema-BA6WP5YZ.js} +1 -3
  360. package/dist/{schema-G5KSSI5W.js → schema-CBL2SMVR.js} +1 -3
  361. package/dist/{schema-WFGDVBJK.js → schema-CWKGLDSR.js} +1 -3
  362. package/dist/{schema-DHMMGDTI.js → schema-DBIQFL56.js} +1 -3
  363. package/dist/{schema-626QXX4G.js → schema-DL7V6NN2.js} +1 -3
  364. package/dist/{schema-FC6J6KZC.js → schema-DUVJMFKQ.js} +1 -3
  365. package/dist/{schema-LGLQBRC4.js → schema-ECJERHKF.js} +1 -2
  366. package/dist/{schema-4JRNXEZF.js → schema-EDSEKZDJ.js} +1 -3
  367. package/dist/{schema-I44IDRGD.js → schema-ESR6ZIK4.js} +1 -3
  368. package/dist/{schema-FSYDLMGD.js → schema-F7TWGLRZ.js} +1 -3
  369. package/dist/{schema-JCU6LTYD.js → schema-FGB6IGZM.js} +1 -3
  370. package/dist/{schema-MGETMQYC.js → schema-FKGGTM4Z.js} +1 -2
  371. package/dist/{schema-XIHAKX3B.js → schema-JIAQE7WO.js} +1 -1
  372. package/dist/{schema-6V5K3J2V.js → schema-JYZ4RF6S.js} +1 -3
  373. package/dist/{schema-GXOG4MXL.js → schema-K7F6TEDK.js} +1 -2
  374. package/dist/{schema-NMIYKGHE.js → schema-KAK6DZX4.js} +1 -3
  375. package/dist/{schema-PHIHMDVB.js → schema-KCJ6WTGV.js} +1 -3
  376. package/dist/{schema-XRSORYBI.js → schema-MOKWIGF7.js} +1 -3
  377. package/dist/{schema-3KMU5737.js → schema-MQT6BMNK.js} +1 -3
  378. package/dist/{schema-JJWORI7D.js → schema-MR3BPPQR.js} +1 -3
  379. package/dist/{schema-IFTIMTS3.js → schema-OPXZYIW7.js} +1 -3
  380. package/dist/{schema-UXWKA3PI.js → schema-PV7JGX5H.js} +1 -3
  381. package/dist/{schema-CNJ4Y6CT.js → schema-PWPQF5RC.js} +1 -3
  382. package/dist/{schema-WBOPCTPC.js → schema-PYQEUC5P.js} +1 -3
  383. package/dist/{schema-J4HCSD5C.js → schema-Q5DACE4I.js} +6 -2
  384. package/dist/{schema-IUY7VYHJ.js → schema-R42VXFIS.js} +1 -3
  385. package/dist/{schema-WX2RS4OU.js → schema-TVUJNEX7.js} +1 -3
  386. package/dist/{schema-6PL46VXZ.js → schema-WZOSDDDJ.js} +1 -3
  387. package/dist/{schema-FGE5YK3S.js → schema-Y4TI2T3T.js} +1 -3
  388. package/dist/{schema-MQB6CE5V.js → schema-ZU2EU2VP.js} +1 -3
  389. package/dist/{specValidation-XGELWQUU.js → specValidation-DC4TVHWD.js} +3 -1
  390. package/dist/theme.js +4 -3
  391. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  392. package/dist/types/core/annotate.d.ts +27 -2
  393. package/dist/types/core/annotateArms.d.ts +3 -1
  394. package/dist/types/core/annotateTargets.d.ts +4 -0
  395. package/dist/types/core/annotationOrigin.d.ts +13 -0
  396. package/dist/types/core/axis.d.ts +2 -2
  397. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  398. package/dist/types/core/charts/column/model.d.ts +13 -0
  399. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  400. package/dist/types/core/charts/gantt/calendar.d.ts +4 -0
  401. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  402. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  403. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  404. package/dist/types/core/charts/pvm/types.d.ts +1 -0
  405. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  406. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  407. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  408. package/dist/types/core/charts/table/resolve.d.ts +8 -3
  409. package/dist/types/core/charts/table/view.d.ts +24 -1
  410. package/dist/types/core/claims/browser.d.ts +2 -0
  411. package/dist/types/core/claims/ids.d.ts +38 -0
  412. package/dist/types/core/deferred.d.ts +1 -0
  413. package/dist/types/core/diagnostics/describe.d.ts +6 -1
  414. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  415. package/dist/types/core/formatSpec.d.ts +33 -14
  416. package/dist/types/core/frame.d.ts +25 -58
  417. package/dist/types/core/frameText.d.ts +203 -0
  418. package/dist/types/core/geometry.d.ts +2 -0
  419. package/dist/types/core/label/categoryRow.d.ts +19 -2
  420. package/dist/types/core/label/solver.d.ts +23 -2
  421. package/dist/types/core/normalize/shared.d.ts +12 -2
  422. package/dist/types/core/notes.d.ts +15 -2
  423. package/dist/types/core/reading.d.ts +12 -1
  424. package/dist/types/core/request.d.ts +1 -1
  425. package/dist/types/core/schema/capability.d.ts +12 -0
  426. package/dist/types/core/seriesIdentity.d.ts +4 -1
  427. package/dist/types/core/sizing.d.ts +37 -1
  428. package/dist/types/core/structureCounts.d.ts +3 -1
  429. package/dist/types/core/theme.d.ts +33 -4
  430. package/dist/types/core/themeRules.d.ts +2 -0
  431. package/dist/types/core/types/annotations.d.ts +74 -4
  432. package/dist/types/core/types/options.d.ts +35 -3
  433. package/dist/types/core/types/scene.d.ts +30 -2
  434. package/dist/types/core/types/table.d.ts +6 -0
  435. package/dist/types/core/types/theme.d.ts +23 -0
  436. package/dist/types/react/TableChart.d.ts +5 -0
  437. package/dist/validate.js +13 -6
  438. package/docs/TELEMETRY.md +2 -2
  439. package/docs/manual.md +252 -62
  440. package/docs/reference/bar.md +12 -4
  441. package/docs/reference/bartable.md +2 -2
  442. package/docs/reference/box.md +8 -4
  443. package/docs/reference/bullet.md +9 -5
  444. package/docs/reference/butterfly.md +10 -5
  445. package/docs/reference/choropleth.md +3 -5
  446. package/docs/reference/cohort.md +1 -1
  447. package/docs/reference/column.md +18 -4
  448. package/docs/reference/combo.md +10 -5
  449. package/docs/reference/creative.md +3 -7
  450. package/docs/reference/diagram.md +1 -1
  451. package/docs/reference/dimswitch.md +23 -88
  452. package/docs/reference/dot.md +9 -5
  453. package/docs/reference/fixtures.md +37 -1
  454. package/docs/reference/funnel.md +9 -5
  455. package/docs/reference/gantt.md +8 -15
  456. package/docs/reference/grid.md +5 -2
  457. package/docs/reference/heatmap.md +10 -6
  458. package/docs/reference/kpi.md +1 -1
  459. package/docs/reference/likert.md +9 -4
  460. package/docs/reference/line.md +18 -5
  461. package/docs/reference/mekko.md +10 -5
  462. package/docs/reference/options.md +17 -13
  463. package/docs/reference/pareto.md +8 -4
  464. package/docs/reference/pie.md +9 -5
  465. package/docs/reference/pvm.md +9 -5
  466. package/docs/reference/pyramid.md +8 -4
  467. package/docs/reference/react.md +5 -5
  468. package/docs/reference/sankey.md +2 -2
  469. package/docs/reference/scatter.md +8 -4
  470. package/docs/reference/slope.md +9 -5
  471. package/docs/reference/sparkline.md +1 -1
  472. package/docs/reference/status.md +1 -1
  473. package/docs/reference/table.md +33 -114
  474. package/docs/reference/theme.md +12 -4
  475. package/docs/reference/tilemap.md +2 -4
  476. package/docs/reference/treemap.md +1 -1
  477. package/docs/reference/variance.md +12 -6
  478. package/docs/reference/waffle.md +1 -1
  479. package/docs/reference/warnings.md +1077 -0
  480. package/docs/reference/waterfall.md +16 -4
  481. package/docs/use-cases.md +25 -13
  482. package/llms.txt +19 -6
  483. package/package.json +18 -3
  484. package/dist/chunk-5RHP7YTL.js +0 -24
  485. package/dist/chunk-6VU2XI3W.js +0 -89
  486. package/dist/chunk-6WJOHZPW.js +0 -26
  487. package/dist/chunk-FL3FQ2YA.js +0 -27
  488. package/dist/chunk-G5CELEUR.js +0 -26
  489. package/dist/chunk-M4SPKUZE.js +0 -7
  490. package/dist/chunk-OF7FMGH5.js +0 -24
  491. package/dist/chunk-S2TSXUYP.js +0 -24
  492. package/dist/chunk-TKERVBJ3.js +0 -23
  493. package/dist/chunk-VMGTNB6H.js +0 -25
  494. package/dist/chunk-WZL4EEBS.js +0 -11
  495. package/dist/chunk-YJGFT63R.js +0 -27
  496. package/dist/chunk-ZNX5J7D7.js +0 -47
package/docs/manual.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # Boardplot manual
2
2
 
3
+ Contents: [What Boardplot is](#what-boardplot-is), [The spec](#the-spec), [Choosing a chart](#choosing-a-chart), [Bartable totals](#bartable-totals), [Getting a chart with MCP](#getting-a-chart-with-mcp), [Getting a chart with the CLI](#getting-a-chart-with-the-cli), [Getting a chart in React](#getting-a-chart-in-react), [Story steps](#story-steps), [Notes under the chart](#notes-under-the-chart), [Sizing](#sizing), [Reading errors and warnings](#reading-errors-and-warnings), [Position of bar value labels](#position-of-bar-value-labels), [Moving text and drawing on a chart](#moving-text-and-drawing-on-a-chart), [Log scales on a line](#log-scales-on-a-line), [Named reference bands on a line](#named-reference-bands-on-a-line), [Times and numbers on the x axis of a line](#times-and-numbers-on-the-x-axis-of-a-line), [Calendar ticks on dated categories](#calendar-ticks-on-dated-categories), [Themes](#themes), [Where the reference is](#where-the-reference-is).
4
+
3
5
  To have an AI agent build a slide deck, an analysis page, a React dashboard or a report with Boardplot charts, start with [Use cases](use-cases.md).
4
6
 
5
7
  ## What Boardplot is
@@ -41,7 +43,7 @@ Every chart is one JSON object, the spec.
41
43
 
42
44
  `options.valueAxis.tickStep` sets ticks at multiples of a positive step and extends the linear axis outward without cutting data, except that dot keeps its data ends when at least two multiples fit inside. The step must give 1 to 20 intervals, otherwise nice ticks are drawn with `tick-step-ignored`.
43
45
 
44
- A field the type does not list is an error. `boardplot_render`, `boardplot_measure`, the CLI and the React component `BoardplotChart` all take this spec.
46
+ Use `boardplot_describe` with a field `path` to check whether a type accepts a setting. Compact responses omit shared option details. `boardplot_render`, `boardplot_measure`, the CLI and the React component `BoardplotChart` take the same spec.
45
47
 
46
48
  A KPI accepts `data.label: ""` to omit its label and the space for the label. The accessible name falls back to `KPI`.
47
49
 
@@ -53,14 +55,14 @@ The table maps a frequent business message to a Boardplot type, the most common
53
55
 
54
56
  | Message | Type and key options | Fixture | Common pitfall |
55
57
  |---|---|---|---|
56
- | Actual vs plan per period | `grid`, `sharedAxis: "category"`: a `column` panel with AC and the PL series as `role: "reference"`, a `variance` panel with `variant: "absolute"` and `variance: { vs: "pl" }` | `weekly-actual-vs-plan` | AC and PL as grouped columns: the reader must find each gap by eye. |
58
+ | Actual vs plan per period | `grid`, `sharedAxis: "category"`: a `column` panel with AC and the PL series as `role: "reference"`, a `variance` panel with `variant: "absolute"` and `variance: { vs: "pl" }`. The ΔPL tier stands over the columns; `variancePosition: "below"` puts it under them | `weekly-actual-vs-plan`, `weekly-actual-vs-plan-variance-below` | AC and PL as grouped columns: the reader must find each gap by eye. |
57
59
  | Actual vs prior year | `column`, `variant: "stacked"`, one PY series with `role: "reference"`; for ΔPY tiers, `grid` with `variance` panels | `integrated-stacked-variance`, `three-tier` | A PY series without `role: "reference"` draws as one more data series. |
58
60
  | Ranking | `bar`, `sort: { categories: "desc" }` | `margin-by-brand` | Columns with long category names; a bar keeps the names on one line. |
59
61
  | Trend against plan | `line`, the actual series and a plan series with `scenario: "PL"`, `gapFill` between them | `option-cost-gap` | `gapFill` tones follow the order in `between`: with the cost named first, above plan is bad, so set `positiveTone: "bad"`. |
60
62
  | KPIs and a margin statement by channel over weeks | `dimswitch`, `dimension.sums: true`, measures with a `value` formula over the sums, `partOf` and `result` for the statement lines | `statement-channels` | A rate in the sums: the Total adds it up across the channels. Put counts and amounts in the sums, and let the formula divide. |
61
63
  | Revenue report by segment against prior year and plan | `table`, `variant: "hierarchy"`, one `columnGroups` block per period, `computed` YoY and vs-plan columns | `management-report-compact` | A typed percentage column: parent rows add up the children's percentages. A `computed` column derives each row's own ratio. |
62
64
  | Bridge: what moved the number | `waterfall`, `items[].type` `"total"` at both ends, deltas between; `pvm` for price, volume and mix | `ebit-bridge` | A typed end total: Boardplot sums the deltas, and a total value that differs warns `derived-mismatch`. |
63
- | Mix or share | `column`, `variant: "stacked100"` | `stacked100-energy-mix` | A pie with more than six slices warns `pie-too-many-slices`, and pies do not compare periods. |
65
+ | Mix or share | `column`, `variant: "stacked100"` | `stacked100-energy-mix` | A pie with more than six slices gets the advice `pie-too-many-slices`, and pies do not compare periods. |
64
66
  | KPI overview | `kpi` with `data.delta: { vs, scenario }` per card; for many metrics, `table` with `variant: "steering"` | `arr-card`, `steering-monthly` | A long row of cards where one table compares the metrics. |
65
67
  | Status review | `status`, `options.states` with a `tone` each and a `pattern` on the at-risk state | `programme-rollout-rag` | Tone alone: a state without a pattern is lost in a grayscale print. |
66
68
  | Distribution | `histogram` for one group, `box` for several | `order-value-distribution`, `deal-size-by-region` | A column of averages hides the spread and the skew. |
@@ -72,43 +74,11 @@ The `bartable` Total adds the rows given; if you cut rows, send a residual row w
72
74
 
73
75
  ## Getting a chart with MCP
74
76
 
75
- The MCP server `boardplot` has six tools. Each answers with JSON; a rejected call carries `ok: false` and an `errors` list. Every answer carries `engineRev` and `version`, the build exactly as `boardplot --version` prints it, so a host can tell a stale server from the CLI beside it.
76
-
77
- | Tool | Call it to | What comes back |
78
- |---|---|---|
79
- | `boardplot_list` | see which chart types exist | each type, the most common first, with summary, use cases, chart IDs (`type.variant`), aliases and size floor; the shared options; the theme presets; chart forms Boardplot does not draw |
80
- | `boardplot_describe` | write a spec for one type | the data fields, the options with values and defaults, a minimal spec, the size floor, the annotation kinds and fixture ids |
81
- | `boardplot_render` | draw a spec | a reading of the drawing (derived numbers, labels placed and dropped), warnings, the SVG on request, a PNG with `format: "png"` |
82
- | `boardplot_measure` | fit a chart to a known width | the minimum, natural and comfortable size, the number of title lines, a refusal with the pixels it needs |
83
- | `boardplot_fixtures` | start from a complete example | runnable specs with real-looking data, by `type` or `id` |
84
- | `boardplot_feedback` | report a Boardplot problem | a draft report and `issueUrl`, a prefilled GitHub issue the user opens and submits; it sends nothing |
85
-
86
- A render refusal keeps its size estimate in `expected.minimum` and `fix`. Library `canDraw()` returns it as `minimum`. A render that draws reports `plot-under-floor`, `aspect-cap`, `height-off-ladder` and `plot-under-min` with no `fix`, because render has not drawn the height a patch would name. Their `suggest` says to call `measure` for a verified size or to leave the height out, and for the aspect warnings also to widen the chart. Measurement draws each size it names. For `plot-under-floor` and a refusal it names a size that draws without a size warning, and CLI and MCP measurement return the refusal size as `required`. For `aspect-cap`, `height-off-ladder` and `plot-under-min` it tries the heights of the standard ladder that the aspect cap allows, nearest first, and names the first that draws with no size warning. A table with a fixed height that draws wider than its frame reports `table-overflow` with no `fix` in a render, and measurement names the width and the height the wider frame needs. A data warning such as `dual-axis` does not reject a size. The height search is bounded. If no tested size draws within the bound, the warning carries no `fix`, and `suggest` asks for less content, a wider chart or a changed setting.
77
+ Call `boardplot_render` directly when you have a valid spec. Use `boardplot_describe` to learn a known type, or `boardplot_list` to choose a type. Each tool returns JSON with `ok`, `engineRev` and `version`. A rejected call returns `ok: false` and an `errors` list. `version` identifies the running build, as `boardplot --version` does for the CLI.
87
78
 
88
- A worked example, an EBIT bridge. Ask for the waterfall contract:
89
-
90
- ```json
91
- { "name": "boardplot_describe", "arguments": { "type": "waterfall" } }
92
- ```
79
+ ### Draw a chart
93
80
 
94
- The answer has a minimal spec and one line per field, the first clause of its description; a line that ends in … leaves text out, and `path` returns all of it. `"detail": "full"` (MCP), or `boardplot describe <type> --full` (CLI), returns the whole description of each field and every fixture id. `"path": "valueAxis.break"` returns that one field and the fields below it in full, or, when the type refuses the field, the reason under `refused`; a leading `data.` or `options.` picks the half, as in `data.items[].value`. `"schema": "data"` or `"options"` returns the JSON Schema of that half, for a generator that fills a schema. An excerpt of the plain answer:
95
-
96
- ```json
97
- {
98
- "ok": true,
99
- "type": "waterfall",
100
- "data": {
101
- "items": "array, required. Ordered bridge items…",
102
- "items[].id": "string, required. Unique bridge-item identity used by connectors and annotations.",
103
- "items[].label": "string. Displayed bridge-item name…",
104
- "items[].type": "\"delta\" | \"subtotal\" | \"total\". Delta contribution by default…",
105
- "items[].value": "cell. Signed delta contribution, or an optional check value for a subtotal or total…"
106
- },
107
- "sizing": { "minWidth": 280, "minHeight": 270, "fit": "fill" }
108
- }
109
- ```
110
-
111
- Then draw it:
81
+ This call requests an EBIT bridge as PNG:
112
82
 
113
83
  ```json
114
84
  {
@@ -132,7 +102,9 @@ Then draw it:
132
102
  }
133
103
  ```
134
104
 
135
- The result holds the chart as an image content block and this JSON, shown here in part:
105
+ The `fy25` item has no value, so Boardplot computes the FY25 total as 133. When a total has a supplied value, Boardplot checks that value against the sum. A mismatch produces `derived-mismatch` and draws the computed total.
106
+
107
+ A successful PNG render returns an image content block and JSON such as this excerpt. With `outDir` and `return: []` it writes the files and returns only their paths in `outputs`, with no image block. Check the actual output before placing it: a PNG request can fall back to SVG. [PNG output](#png-output) explains the conditions.
136
108
 
137
109
  ```json
138
110
  {
@@ -146,7 +118,45 @@ The result holds the chart as an image content block and this JSON, shown here i
146
118
  }
147
119
  ```
148
120
 
149
- Each derived reading has `visible: true` when it has displayed text. A calculation that is not printed has `visible: false` and `displayed: "Not displayed"`. `reading.omissions` lists each hidden label and its destination. This includes axis labels removed before placement and values moved straight to a note. A label without a replacement label or note has destination `reading.omissions`, which keeps its text. One `label-hidden` warning reports the missing labels for the chart. Redundant labels, whose information is printed elsewhere, do not cause this warning.
121
+ ### Choose a tool
122
+
123
+ | Tool | Use when | Result |
124
+ |---|---|---|
125
+ | `boardplot_render` | A spec is ready to draw | Validation, a reading of the chart, warnings, optional SVG markup or a requested PNG image |
126
+ | `boardplot_describe` | You need the fields for a known chart type | Data and options, a starter spec, size floors, annotations and fixture IDs |
127
+ | `boardplot_list` | You need to choose a chart type | Types, use cases, aliases, variants, shared options, themes and supported alternatives |
128
+ | `boardplot_fixtures` | You need a complete example | Runnable specs, filtered by type or retrieved by type and ID |
129
+ | `boardplot_measure` | The chart must fit a known container, or rendering reports a size problem | Minimum, natural and comfortable dimensions at the requested width |
130
+ | `boardplot_feedback` | Boardplot fails, refuses valid input or draws something misleading | A draft report and prefilled `issueUrl` for the user to review and submit. Nothing is sent |
131
+
132
+ ### Read a chart contract
133
+
134
+ For a known type, request its compact contract:
135
+
136
+ ```json
137
+ { "name": "boardplot_describe", "arguments": { "type": "waterfall" } }
138
+ ```
139
+
140
+ The response includes a starter spec and the type's data and option fields. `sharedOptions` names additional accepted shared options. The response defines value cells and annotation anchors when it uses those concepts. A field omitted from the compact option rows can still be supported.
141
+
142
+ - To resolve one field, pass `path`, such as `options.valueAxis.break` or `data.items[].value`. The response gives that field and its children in full, or explains a refusal under `refused`.
143
+ - A description ending in … is shortened. Query that path when you need the remaining text.
144
+ - When you need the whole contract, pass `detail: "full"` for an exhaustive reference with all effective option fields and every fixture ID. Use compact detail and `path` for routine chart requests. The CLI equivalent is `boardplot describe waterfall --full`.
145
+ - To obtain a JSON Schema, pass `schema: "data"` or `schema: "options"`. Use `schema` or `path` in one call, not both.
146
+ - When the response includes `design`, use `path: "design"` if the design decision needs the complete guidance.
147
+ - To define a theme, pass `type: "theme"`. Theme discovery accepts `detail`, but not `path` or `schema`.
148
+
149
+ ### Retrieve examples
150
+
151
+ Call `boardplot_fixtures` with `type` to list examples of that chart type. Retrieve a chosen fixture with its `type` and `id`, then replace the example's data and text. An ID is unique within its chart type.
152
+
153
+ Listings return up to 25 fixtures. When `nextCursor` is present, pass it as `cursor` with the same `type` and `kind` to retrieve the next page. Omitting `type` lists examples across all types. `kind` filters listings to `example` (default), `torture` (stress cases) or `all`. Retrieving a specific ID bypasses the `kind` filter.
154
+
155
+ ### Read a render result
156
+
157
+ Check `ok`, `warnings` and `reading` before using the chart. `reading` reports the drawn series, label counts, omitted content and computed values. Image content carries PNG, `svg` carries inline SVG, and `outputs` lists written files.
158
+
159
+ Each derived reading has `visible: true` when it has displayed text. `displayed` is always the text printed on the chart. A calculation that is not printed has `visible: false` and `displayed: "Not displayed"`. Where a chart type states a value in words, such as a status count ("Done 6") or a waffle segment ("41.3% = 41 of 100 cells"), the optional `description` holds those words. `reading.omissions` lists each hidden label and its destination. This includes axis labels removed before placement and values moved straight to a note. A label without a replacement label or note has destination `reading.omissions`, which keeps its text. One `label-hidden` warning reports the missing labels for the chart. Redundant labels, whose information is printed elsewhere, do not cause this warning.
150
160
 
151
161
  A treemap leaves out items whose `value` is zero or null, warns `treemap-item-left-out` and names the items in a note. Only drawn items enter totals, shares and cell counts; negative values and data without a value above zero are refused.
152
162
 
@@ -156,9 +166,40 @@ A football field leaves out methods whose cells are null or have no `range`, war
156
166
 
157
167
  `reading.counts` lists structural counts and their exact phrases in the accessible description. A host can match these phrases without parsing prose. See [Chart reading counts](reference/reading.md).
158
168
 
159
- The last item has no value, so the engine computed the FY25 total of 133. A total that carries a value is checked against the sum; the computed value is drawn and the render warns `derived-mismatch`.
169
+ ### Output settings
170
+
171
+ | Argument | Meaning |
172
+ |---|---|
173
+ | `format` | Requested `svg` or `png`. Without an explicit format, a `.svg` or `.png` output filename selects the format. Otherwise the default is SVG with a reading-only response |
174
+ | `return` | Response fields. Default `["reading"]`. Add `"svg"` for inline markup |
175
+ | `outDir` | Absolute output directory, or a `.svg` or `.png` file path for one chart. Omit it when files are unnecessary. `outputs` lists the paths written |
176
+ | `overwrite` | Default `false`: a taken filename gets a numbered suffix. `true` replaces existing output files |
177
+ | `target` | Reading context: `report`, `dashboard`, `slide` or `print`. See [Sizing](#sizing) |
178
+ | `width`, `height` | Layout pixels. Put pt or mm dimensions in `spec.options.size` with `unit` |
179
+ | `scale` | PNG device pixels per layout pixel. Default 2 |
180
+ | `background` | Default `theme`. `transparent` omits the canvas, while halos and hollow marks retain the theme background colour. Use a display surface of that colour |
181
+
182
+ ### PNG output
183
+
184
+ PNG rendering uses the optional `@resvg/resvg-js` package, or Chrome or Chromium. Boardplot checks the usual browser paths and `BOARDPLOT_CHROME_PATH`. With no rasterizer, Boardplot returns SVG and the warning `no-rasterizer`.
185
+
186
+ On Linux, resvg uses the first installed family in the theme stack, then tries Liberation Sans, Arimo, Nimbus Sans, DejaVu Sans or Noto Sans. Without those fonts, Chrome draws the PNG. If Chrome is unavailable too, Boardplot returns SVG with `raster-fonts-missing`.
187
+
188
+ Characters missing from the theme's width tables, such as emoji or CJK, use Chrome when available. Chrome clears the coverage warning on macOS and Windows, which ship those fonts. On other systems, `png-glyph-coverage` remains because the installed fonts may still lack the glyphs. Without Chrome, Boardplot keeps the resvg PNG and warns `png-glyph-coverage`, naming labels that can be lost.
160
189
 
161
- `boardplot_render` takes `spec` and optionally `format` (`svg` or `png`), `target` (see [Sizing](#sizing)), `width` and `height` in px, `scale` (PNG pixels per layout pixel, default 2), `background` (`theme` by default; `transparent` leaves the canvas out, while halos and hollow marks keep the theme background colour, so place the chart on a surface of that colour), `return` (`["reading"]` by default; add `"svg"` for the markup) and `outDir`, an absolute directory to write the files to. PNG uses `@resvg/resvg-js`, an optional dependency, when it is installed, and otherwise Chrome or Chromium, found on the usual paths or through `BOARDPLOT_CHROME_PATH`. With neither, the render returns the SVG and the warning `no-rasterizer`. Chrome's exit code does not decide: on a busy machine Chrome writes the PNG and then exits 2, so a PNG that decodes at the requested size counts as drawn. Without one, Boardplot runs Chrome once more and then fails with `png-export-failed` (exit 2), whose message names the cause: a browser that would not start, the 60 s timeout, a crash, or Chrome's exit code with its last line of output. On Linux, resvg draws with the first family of the theme stack that fontconfig lists, else Liberation Sans, Arimo, Nimbus Sans, DejaVu Sans or Noto Sans; with none of them installed Chrome draws the PNG, and without Chrome the render returns the SVG and the warning `raster-fonts-missing`. A chart with characters the theme font has no width for, such as emoji or CJK, is drawn by Chrome when Chrome is installed, because resvg draws them as boxes and loses the whole label with them. On macOS and Windows, which ship those fonts, Chrome clears the warning; on other systems the warning `png-glyph-coverage` stays, because Chrome draws boxes when no installed font covers a character. Without Chrome the render keeps the resvg PNG and warns `png-glyph-coverage`, naming the labels that can be lost. A PNG above 100 million pixels (width x height x `scale` squared) is refused with `png-too-large` (exit 1), because the rasterizer would run out of memory; draw the SVG, lower `scale` or shrink the canvas. `boardplot_list` reports the limit as `limits.pngPixelsMax`. A PNG records 96 dpi times `scale`. [PowerPoint or Keynote deck](use-cases.md#powerpoint-or-keynote-deck) says how slide and document tools place it.
190
+ Boardplot accepts a browser PNG only when it decodes at the requested size, even if the browser exits with an error. A failed browser export is retried once, then returns `png-export-failed` with exit code 2. The error names a start failure, the 60-second timeout, a crash, or the browser's exit code and last output line.
191
+
192
+ A PNG above 100 million pixels (`width × height × scale²`) is refused with `png-too-large` and exit code 1. Lower `scale`, reduce the canvas, or use SVG. `boardplot_list` reports the limit as `limits.pngPixelsMax`. PNG records `96 × scale` dpi. [Deck guidance](use-cases.md#powerpoint-or-keynote-deck) explains placement in slide and document tools.
193
+
194
+ ### Size warnings and refusals
195
+
196
+ A size refusal includes `expected.minimum` and `fix` when Boardplot found a size that fits. Library `canDraw()` returns the estimate as `minimum`. CLI and MCP measurement can return `ok: true` with a non-null `refused` result. Check `refused.required` for verified dimensions when present, or follow `refused.suggest`.
197
+
198
+ A drawn chart can report `plot-under-floor`, `aspect-cap`, `height-off-ladder` or `plot-under-min` without a `fix`. Render has not drawn the height that a repair would name. Follow `suggest`: measure a verified size, omit the height, or widen the chart for an aspect warning.
199
+
200
+ Measurement draws each size it names. For `plot-under-floor` and refusals, measurement names a size that draws without a size warning. For `aspect-cap`, `height-off-ladder` and `plot-under-min`, measurement tries the allowed standard heights, nearest first. A fixed-height table that extends beyond its frame reports `table-overflow`. Measurement names the width and height the wider frame needs. A data warning such as `dual-axis` does not reject a size.
201
+
202
+ The height search is bounded. When no tested size fits, the warning has no `fix`. Follow `suggest` to reduce content, widen the chart or change a setting.
162
203
 
163
204
  ### Accepted input forms
164
205
 
@@ -174,7 +215,11 @@ Explicit `--format svg` or MCP `format: "svg"`, without return or an output path
174
215
 
175
216
  ### Rows as data
176
217
 
177
- A query result does not have to be copied into `data`. `boardplot_render` and `boardplot_measure` take a flat table, one row per category and series pair, as `rows` inline or as `rowsFile`, the absolute path of a local `.json` file (an array of row objects), or a `.csv`, `.tsv` or `.txt` file (a header row) of at most 10 MB. A CSV whose header line holds more semicolons than commas is read as semicolon-separated, as German-locale exports are, and a file whose header line holds more tabs than commas and semicolons is read as tab-separated, as a table pasted from a spreadsheet is; a tab-separated file keeps the dot as its decimal mark. In a semicolon file the value column reads a decimal comma as a decimal (0,505 is 0.505); a number with grouping marks such as 1.234,5 is refused with its row, and so is 1.234, which could be 1234 or 1.234. A leading byte order mark is skipped. Read from a file, the numbers never pass through the model. `columns` names the source column for each role: `category`, `series` and `value` are required, `categoryLabel`, `seriesLabel`, `unit`, `date` and `state` (`na`, `nm` or `suppressed` for a cell whose value is null; a heatmap keeps it as the series' `states`) are optional. Each role names its own column, with one exception: `date` may name the category column, so one SQL date column gives both the category ids and their dates. A category without a `categoryLabel` gets no label, so an ISO date id such as `2026-01-01` prints as a short date ('Jan', with the year on its own row) on the axis and in the hover card. `valueKind` says how the value column is written: `number` (the default), `percent` (50.5 is 50.5 %) or `fraction` (0.505 is 50.5 %).
218
+ For supported chart types, `boardplot_render` and `boardplot_measure` can fill one bare spec from a query result. Pass either inline `rows` or `rowsFile`, never both. A versioned document of several charts does not take row input. Category charts use one row per category and series pair. `rowsFile` is the absolute path of a local `.json` file (an array of row objects), or a `.csv`, `.tsv` or `.txt` file (a header row) of at most 10 MB. A CSV whose header line holds more semicolons than commas is read as semicolon-separated, as German-locale exports are, and a file whose header line holds more tabs than commas and semicolons is read as tab-separated, as a table pasted from a spreadsheet is; a tab-separated file keeps the dot as its decimal mark. In a semicolon file the value column reads a decimal comma as a decimal (0,505 is 0.505); a number with grouping marks such as 1.234,5 is refused with its row, and so is 1.234, which could be 1234 or 1.234. A leading byte order mark is skipped. Read from a file, the numbers never pass through the model.
219
+
220
+ For category charts, `columns` maps roles to source field names, such as `{ "category": "region", "series": "product", "value": "revenue" }`. `category`, `series` and `value` are required, `categoryLabel`, `seriesLabel`, `unit`, `date` and `state` (`na`, `nm` or `suppressed` for a cell whose value is null; a heatmap keeps it as the series' `states`) are optional. Each role names its own column, with one exception: `date` may name the category column, so one SQL date column gives both the category ids and their dates. A category without a `categoryLabel` gets no label, so an ISO date id such as `2026-01-01` prints as a short date ('Jan', with the year on its own row) on the axis and in the hover card.
221
+
222
+ `valueKind` says how the value column is written: `number` (the default), `percent` (50.5 is 50.5 %) or `fraction` (0.505 is 50.5 %). Table, histogram, box and Sankey row mappings accept `number` only.
178
223
 
179
224
  The MCP server reads a `rowsFile` only from an allowed folder. The allowed folders are the roots the client sends (the server asks for them when the client declares the roots capability), the server's working directory (unless it is the filesystem root), the system temp folder, and every folder in the environment variable `BOARDPLOT_ROWS_ROOTS` (several separated by `:`, on Windows by `;`). The check runs on the resolved path, so a symlink that points outside is refused too. A file outside these folders is refused with `rows-outside-roots`, and nothing is read. `outDir` follows the same rule: a path outside these folders, also through a symlinked folder, is refused with `out-outside-roots`, and nothing is written. The CLI's `--rows` and `--out` take any path you name.
180
225
 
@@ -208,9 +253,9 @@ Waterfall (alias `bridge`) takes one row per item. Use `--columns label=item,val
208
253
 
209
254
  Scatter (alias `bubble`) takes one row per point. Use `--columns x=effort,y=output,size=volume,label=item,group=team`, or the same roles in the MCP `columns` object. Only `x` and `y` are required. `size` supplies bubble magnitude. `label` supplies the point name. `group` fills `points[].group` and creates `data.groups` in first-appearance order. A matching group in the spec keeps its label and style. With no group column, the spec's groups stay as authored. With no label column, point labels use their generated ids.
210
255
 
211
- Sankey takes one row per link, the shape of a `GROUP BY source, target` result. Use `--columns source=from_page,target=to_page,value=visits`, or the same roles in the MCP `columns` object. `source`, `target` and `value` are required. For flows between segments month to month, add `sourceStage` and `targetStage` (for example the month and the next month): then a node is the pair of stage and id, so the same segment in two months is two nodes. A numeric id is read as text. Rows with the same ends add up.
256
+ Sankey takes one row per link, the shape of a `GROUP BY source, target` result. Use `--columns source=from_page,target=to_page,value=visits`, or the same roles in the MCP `columns` object. `source`, `target` and `value` are required. For flows between segments month to month, add `sourceStage` and `targetStage` (for example the month and the next month): then a node is the pair of stage and id, so the same segment in two months is two nodes. A numeric id is read as text. Rows with the same ends add up. Sankey accepts `valueKind: "number"` only. To label flows as shares, keep numeric counts and use `options.nodeValue: "share"`.
212
257
 
213
- Both mappings generate ids `row-1`, `row-2`, and so on. Labels can repeat. Rows replace `data.items` or `data.points`; other authored data stays in the spec. Named columns must exist in the source. Invalid cells report their source row and column. The reading and measure report the row count, SHA-256 and ignored columns, as for category rows. `valueKind` applies to the waterfall value or both scatter coordinates; bubble size stays a number. For different coordinate kinds, pass numeric cells in JSON rows and set each axis format in the spec. These mappings work with CLI render/measure and MCP `boardplot_render`/`boardplot_measure`, for inline rows and JSON or CSV files.
258
+ The waterfall and scatter mappings generate ids `row-1`, `row-2`, and so on. Labels can repeat. Rows replace `data.items` or `data.points`; other authored data stays in the spec. Named columns must exist in the source. Invalid cells report their source row and column. The reading and measure report the row count, SHA-256 and ignored columns, as for category rows. `valueKind` applies to the waterfall value or both scatter coordinates; bubble size stays a number. For different coordinate kinds, pass numeric cells in JSON rows and set each axis format in the spec. These mappings work with CLI render/measure and MCP `boardplot_render`/`boardplot_measure`, for inline rows and JSON or CSV files.
214
259
 
215
260
  ### Table rows
216
261
 
@@ -249,7 +294,7 @@ Other data schemas refuse the field. For a combo rate, keep its separate percent
249
294
 
250
295
  ### Small values
251
296
 
252
- Without an authored format, each table column and each chart series gets one precision from its largest value. Below 1, that value keeps two significant digits: 0.0341 gives three decimals, so 0.0123 and 0.0051 print 0.012 and 0.005. No automatic format prints more than four decimals. A nonzero value below the last shown digit prints its bound: `<0.001` at three decimals, `>−0.001` below zero, `<1` for whole numbers. A signed change label keeps its sign: `<+0.001` and `>−0.001`, so it reads as a change like its neighbours. Below 0.0001 it prints in scientific form, `1.2 × 10⁻⁹`. A true zero prints in the column's format, such as `0.0`. Set `options.smallValues: "zero"` for spreadsheet style (`0.000`) or `"scientific"` for a power of ten. `"p-value"` prints every value from 0 to 1 as APA 7 writes a p-value: three decimals without the leading zero (`.042`) and `<.001` below. An authored format prints as authored.
297
+ Without an authored format, each table column and each chart series gets one precision from its largest value. A table column also takes its magnitude from its largest value. Where that magnitude would print another nonzero value of the column as a bound (17,600 orders beside $3.8M revenue print `<0.1` in millions), each row of that column without a format of its own prints at its own scale: `3.6M`, `17,000`, `2.3`. Below 1, that value keeps two significant digits: 0.0341 gives three decimals, so 0.0123 and 0.0051 print 0.012 and 0.005. No automatic format prints more than four decimals. A nonzero value below the last shown digit prints its bound: `<0.001` at three decimals, `>−0.001` below zero, `<1` for whole numbers. A signed change label keeps its sign: `<+0.001` and `>−0.001`, so it reads as a change like its neighbours. Below 0.0001 it prints in scientific form, `1.2 × 10⁻⁹`. A true zero prints in the column's format, such as `0.0`. Set `options.smallValues: "zero"` for spreadsheet style (`0.000`) or `"scientific"` for a power of ten. `"p-value"` prints every value from 0 to 1 as APA 7 writes a p-value: three decimals without the leading zero (`.042`) and `<.001` below. An authored format prints as authored.
253
298
 
254
299
  A `k`, `M` or `B` after the digits scales the value: `"$1.2M"` prints 2,456,000 as `$2.5M`. A spaced magnitude beside a currency (`"$1.2 k"`) also scales. A scale inside a currency affix (`"USDm 1.2"`, `"1.2 €m"`) holds its divisor. Without a currency, spaced letters remain units: `"12 m/s"` and `"50 B"` print the value as it is. The words `mn`, `bn`, `Mio.`, `Mrd.`, `thousand`, `million` and `billion` scale with or without a space.
255
300
 
@@ -293,7 +338,9 @@ Dated variance, bullet and butterfly categories keep authored order when a growt
293
338
  - Dot keeps the n largest absolute first-series values, or absolute gaps on a dumbbell.
294
339
  - Variance keeps the n largest absolute drawn differences: delta percent in `relative`, absolute difference otherwise. Missing differences count as zero.
295
340
 
296
- Dot and variance draw no Others row because scores and ratios are not additive. Kept categories retain authored order unless `sort.categories` reorders them. A disclosure note and `topn-omitted` name the kept count, total count and omitted categories. When a cut is needed, authored `rest: true`, `restLabel`, `showRestCount` or `threshold` produces one `topn-rest-unsupported` warning that names the ignored settings. A request with `n` at least the category count changes nothing and adds no topN warning.
341
+ Dot and variance draw no Others row because scores and ratios are not additive. Kept categories retain authored order unless `sort.categories` reorders them. A disclosure note and `topn-omitted` name the kept count, total count and omitted categories. When a cut is needed, authored `rest: true`, `restLabel` or `showRestCount` produces one `topn-rest-unsupported` warning that names the ignored settings. A request with `n` at least the category count changes nothing and adds no topN warning. On dot, pareto, variance, pie, mekko and butterfly, `threshold` is ignored with a warning. A choropleth refuses it.
342
+
343
+ On bar, column and table, `threshold` also drops a kept category whose absolute total is below it, also when `n` keeps every category. The largest category always stays.
297
344
 
298
345
  ### Missing stack parts
299
346
 
@@ -517,17 +564,17 @@ The panel shows up to four title lines and ten body lines. A cut title or body r
517
564
 
518
565
  Boardplot sorts every note under a chart by kind. In the live React chart, the render target decides how much of it the frame prints. A React chart with `fit="content"` takes its height from its content and prints the footer of the static image: every note of the kinds `notes.show` lists, in full, with no line budget, so it is as tall as `boardplot render` at the same width. Under `notes.placement: 'info'` a "Notes and sources (N)" button opens the notes the image does not print; it sits in the space the image leaves free for it.
519
566
 
520
- Boardplot prints none of its own notes under a chart by default, on every target and surface: the `method` and `disclosure` notes go to the notes list only. `notes.show` prints them where the author asks for them. A spec that asks for notes another way gets them too: `methodNote: true` or an authored `notes.placement` prints the method notes and disclosures, as `notes.show: ['note', 'method', 'disclosure']` does. A changed note wording alone (`strings.incompleteStacks`) prints nothing. Static SVG, PNG and clipboard images print the full author notes, the kinds `notes.show` adds, the source and the credit. Compact charts retain note reference numbers. Grid panels move notes that do not fit into the outer footer, under the panel title and ID. They have no notes button or "+N notes" pointer. The notes start at the normal footer gap below the chart's last element. They use the existing footer space first. If they need more room, the canvas grows below its original boundary. The plot keeps its position and size. `footnotes: false` still suppresses notes other than the disclosures `notes.show` prints.
567
+ Boardplot prints none of its own notes under a chart by default, on every target and surface: the `method` and `disclosure` notes go to the notes list only. `notes.show` prints them where the author asks for them. A spec that asks for notes another way gets them too: `methodNote: true` or an authored `notes.placement` prints the method notes and disclosures within the line budget, after the author notes. What does not fit goes to the notes list, and the pointer counts it. A changed note wording alone (`strings.incompleteStacks`) prints nothing. Static SVG, PNG and clipboard images print the full author notes, the kinds `notes.show` adds, the source and the credit. Compact charts retain note reference numbers. Grid panels move notes that do not fit into the outer footer, under the panel title and ID. They have no notes button or "+N notes" pointer. The notes start at the normal footer gap below the chart's last element. They use the existing footer space first. If they need more room, the canvas grows below its original boundary. The plot keeps its position and size. `footnotes: false` still suppresses notes other than the disclosures `notes.show` prints.
521
568
 
522
569
  | Kind | What it is | Where it goes |
523
570
  |---|---|---|
524
571
  | `note` | Your `footnotes`, in your order | The frame, within the line budget |
525
572
  | `method` | Boardplot's text on how a number is built (likert net, the pvm split) | The notes list; `notes.show: ['note', 'method']` prints its one-line short form |
526
- | `disclosure` | Boardplot's text on how to read the chart: a key to an encoding ("One cell = 5%", "W38 partial", "Columns by rank"), a change to the data ("1 value below zero shown as 0."), or the marks the drawing leaves unlabelled ("Not labelled on the chart: ...") | The notes list and its warnings (`values-in-note`, `labels-as-ranks`); `notes.show` with `'disclosure'` prints it in the frame, outside the line budget |
573
+ | `disclosure` | Boardplot's text on how to read the chart: a key to an encoding ("One cell = 5%", "W38 partial", "Columns by rank"), a change to the data ("1 value below zero shown as 0."), or the marks the drawing leaves unlabelled ("Not labelled on the chart: ...") | The notes list and its warnings (`values-in-note`, `labels-as-ranks`); `notes.show` with `'disclosure'` prints it in the frame, outside the line budget; `methodNote: true` or a `notes.placement` prints it within the budget |
527
574
  | `source` | Your `source` | Always in the frame, last line |
528
575
  | `credit` | A map pack's licence credit | Under the source line when the licence requires it (de-states, us-states), else the notes list |
529
576
 
530
- The line budget counts the notes and the source line; a required credit and a disclosure do not count. A numbered author note that a mark on the chart points at ("1)" beside a category) prints on every target, like a required credit. A mark that points at one of Boardplot's own notes prints only where that note prints: without `'disclosure'` in `notes.show`, a column row draws no rank numbers and no note mark on a cut name, a gantt milestone keeps its diamond without a key number, a table head drops its † and a dimswitch period its *. `footnotes: false` keeps a disclosure that `notes.show` prints; it leaves a pointed note off with the other notes and hands it to the host in the `footnotes-off` lint. Report and dashboard take 3 lines (2 under 720 px wide), slide 2 and print 3. A note that does not fit moves to the notes list with every note after it, and the source line ends with "+N notes". The pointer counts only the hidden notes of the kinds `notes.show` prints. A slide prints only the source line, the credit and the pointer by default (`notes.placement: 'list'`); set `notes.placement: 'frame'` for its 2 lines of notes.
577
+ The line budget counts the notes and the source line. Outside it print only a required credit, an author note a mark points at, a disclosure a drawn mark points at (the rank key under ranked columns, a numbered note on a cut name), and a disclosure where the author lists `'disclosure'` in `notes.show`. A numbered author note that a mark on the chart points at ("1)" beside a category) prints on every target, like a required credit. A mark that points at one of Boardplot's own notes prints only where that note prints: without `'disclosure'` in `notes.show`, a column row draws no rank numbers and no note mark on a cut name, a gantt milestone keeps its diamond without a key number, a table head drops its † and a dimswitch period its *. `footnotes: false` keeps a disclosure that `notes.show` prints; it leaves a pointed note off with the other notes and hands it to the host in the `footnotes-off` lint. Report and dashboard take 3 lines (2 under 720 px wide), slide 2 and print 3. A note that does not fit moves to the notes list with every note after it, and the source line ends with "+N notes". The pointer counts only the hidden notes of the kinds `notes.show` prints. A slide prints only the source line, the credit and the pointer by default (`notes.placement: 'list'`); set `notes.placement: 'frame'` for its 2 lines of notes.
531
578
 
532
579
  Every render returns the notes list, so a host can build an appendix or a backup slide from it: `notes` on each chart of the CLI and MCP result, `notes` in the reading, and `geometry.frame.noteList` in the library. Each entry is `{ n, kind, text, short, inFrame }`; a credit adds `links`, and a note the chart numbers adds `ref`, the number it prints with.
533
580
 
@@ -537,8 +584,8 @@ The options:
537
584
 
538
585
  - `notes.placement`: 'frame', 'list' or 'info'. 'info' is the dashboard default: in React one line holds the source and a required credit, and a "Notes and sources (N)" button opens a panel with every other note, Boardplot's hidden notes included. Static output and a content-fit React chart print every note of the kinds `notes.show` lists for all three placements. Under 'info' a static footer (except a table's) keeps the width of the button free after the source line or its last line, or an empty row under its last line where the button fits after neither; a content-fit React chart puts the button in that space, and it opens the notes the footer does not print. `onNotes` and `renderNotes` still hand the host every note.
539
586
  - `notes.maxLines`: the live chart's line budget. Static output and a content-fit React chart have no line limit.
540
- - `notes.show`: the kinds the frame prints, default `['note']`, on every surface; `['note', 'method', 'disclosure']` where the spec sets `methodNote: true` or `notes.placement`. An authored `notes.show` always decides alone. Add `'method'` for the method notes and `'disclosure'` for the disclosures, for example `notes: { show: ['note', 'disclosure'] }`. On a pinned height, printed disclosures never take the plot under its floor: the chart refuses with `size-below-floor` and the height that seats both. On an open height the chart still gets the height a printed disclosure would take when the labels need it, so a hidden note does not cost a label.
541
- - `notes.pointer`: false drops "+N notes", and in React the button and panel. Static output always has the full notes and no pointer.
587
+ - `notes.show`: the kinds the frame prints, default `['note']`, on every surface; `['note', 'method', 'disclosure']` where the spec sets `methodNote: true` or `notes.placement`, all within the line budget. An authored `notes.show` always decides alone, and only the disclosures it lists print outside the budget. Add `'method'` for the method notes and `'disclosure'` for the disclosures, for example `notes: { show: ['note', 'disclosure'] }`. On a pinned height, printed disclosures never take the plot under its floor: the chart refuses with `size-below-floor` and the height that seats both. On an open height the chart still gets the height a printed disclosure would take when the labels need it, so a hidden note does not cost a label.
588
+ - `notes.pointer`: false drops "+N notes", and in React the button and panel. Where a live chart then leaves author notes out, it warns `notes-left-out` with the count, the `notes.maxLines` that prints them, and a patch that removes `notes.pointer: false`. Static output always has the full notes and no pointer.
542
589
  - `notes.maxListed`: the items a disclosure names before it counts the rest, default 8. `'all'` names every item; `0` only counts them.
543
590
 
544
591
  The de-states pack prints "Map: © BKG (2026) dl-de/by-2-0 (data changed), Datenquellen: <URL>" in SVG, PNG and PDF at every width, and under `footnotes: false`. React shows the full credit at every width and in print. The credit wraps as needed, with "BKG", "dl-de/by-2-0" and "Datenquellen" as links. The us-states pack prints "Map: U.S. Census Bureau (2025)". The Natural Earth packs (eu27, europe, world, dach) need no visible credit; theirs is in the notes list. NOTICE.md has the full licence texts.
@@ -595,9 +642,9 @@ The SVG shrinks to a narrower container, and its text shrinks with it. An SVG ma
595
642
 
596
643
  A chart in a narrow phone layout needs a new layout, not shrinking. Render it again at the phone width, where many types draw in compact mode; use a simpler chart; or keep a readable minimum width with horizontal scrolling or a full-size view.
597
644
 
598
- Each type has a floor, `minWidth` × `minHeight` in layout px, and a fit, listed by `boardplot_list` and `boardplot_describe`. A `fill` type uses the whole frame. A `content` type such as `bar`, `table` or `kpi` takes the height its rows need.
645
+ Each type has a floor, `minWidth` × `minHeight` in layout px, and a fit, listed by `boardplot_list` and `boardplot_describe`. A `fill` type uses the whole frame. A `content` type such as `bar`, `table` or `kpi` takes the height its rows need. A size refusal for a width alone names the width from which the request draws under its own `belowMinimum` setting: the compact chart's where it falls back to compact. Render, `measure`, `canDraw` and React name the same width.
599
646
 
600
- The width floor of a row chart (bar, bartable, funnel, butterfly, likert, gantt, cohort, heatmap) and of a band chart (waterfall, pareto, variance, pyramid, box, mekko, pvm) is the width its content measures, and never less than the card minimum of 280 px. The chart draws full where its content fits. Below that it draws compact, and it is refused only when compact does not fit either; the refusal names the size compact needs. This also holds for a width alone. Every row and band type has a compact form, except mekko, whose `mode` names its calculation, and bullet, which compacts only by `density: 'compact'`. A horizontal waterfall and a status grid keep a 480 px floor for now. A bullet chart's width floor is the width its rows measure. A diagram draws on a card down to 280 px when no card or group text is cut and no group frame overlaps another there; otherwise it keeps a 480 px floor. A node, group, caption, badge or edge label that the narrow card would hide, or an edge label it would cut, also keeps the 480 px floor. Column, line, combo, histogram, scatter and dot keep a 480 px floor and draw below `minWidth` or `minHeight`, on either axis, down to a `compactFloor`. A KPI card, a pie, a choropleth and a column also draw narrower than 280 px, down to 120 px (160 px for a map) and below their `compactFloor`, while their content fits: the KPI's figure, the pie's circle and labels, the map's key and small members, and the column's bars, each at least 3 px wide. Otherwise the refusal names the width the content needs. A pie keeps its 320 px height floor for an automatic height; a pinned pie draws compact below it, down to 160 px, while its circle keeps a radius of at least 36 px. A pinned slope draws compact under its 270 px height floor, down to 180 px, while its plot keeps 80 px; with an automatic height it takes its content height. An authored grid of several columns that refuses under 480 px draws compact: its panels stack in one column, in authored order, down to the width its widest panel measures. Metric stacks, category tiers, legacy facet grids and grids with `anchors` or `alignmentRules` have no compact form.
647
+ The width floor of a row chart (bar, bartable, funnel, butterfly, likert, gantt, cohort, heatmap) and of a band chart (waterfall, pareto, variance, pyramid, box, mekko, pvm) is the width its content measures, and never less than the card minimum of 280 px. The chart draws full where its content fits. Below that it draws compact, and it is refused only when compact does not fit either; the refusal names the size compact needs. This also holds for a width alone. Every row and band type has a compact form, except mekko, whose `mode` names its calculation, and bullet, which compacts only by `density: 'compact'`. A status grid and a horizontal waterfall have no compact form. They draw full down to the 280 px card minimum, the status grid with its column heads wrapped and the waterfall with its step values thinned. A bullet chart's width floor is the width its rows measure. A bullet row keeps its natural pitch of 44 px (more when target values print above their ticks) in a frame taller than the rows need, and the extra height stays empty below the chart. A diagram draws on a card down to 280 px when no card or group text is cut and no group frame overlaps another there; otherwise it keeps a 480 px floor. A node, group, caption, badge or edge label that the narrow card would hide, or an edge label it would cut, also keeps the 480 px floor. Column, line, combo, histogram, scatter and dot keep a 480 px floor and draw below `minWidth` or `minHeight`, on either axis, down to a `compactFloor`. A KPI card, a pie, a choropleth and a column also draw narrower than 280 px, down to 120 px (160 px for a map) and below their `compactFloor`, while their content fits: the KPI's figure, the pie's circle and labels, the map's key and small members, and the column's bars, each at least 3 px wide. Otherwise the refusal names the width the content needs. A pie keeps its 320 px height floor for an automatic height; a pinned pie draws compact below it, down to 160 px, while its circle keeps a radius of at least 36 px. A pinned slope draws compact under its 270 px height floor, down to 180 px, while its plot keeps 80 px; with an automatic height it takes its content height. An authored grid of several columns that refuses under 480 px draws compact: its panels stack in one column, in authored order, down to the width its widest panel measures. Metric stacks, category tiers, legacy facet grids and grids with `anchors` or `alignmentRules` have no compact form.
601
648
 
602
649
  Compact mode sets minimal labels, tight spacing and the key in the footnote size. It keeps the series key, the whole title and the subtitle; a canvas too short for them is refused with the height they need. A `fill` chart in compact mode keeps a plot of at least 80 px, whichever side of the canvas is short. On a fixed width and height a canvas that cannot hold it draws the plot under that floor, down to the type's hard minimum (step 7 under "Fixed height"), and warns `plot-under-floor` with the height it needs. `belowMinimum: 'refuse'` refuses below the measured floor instead of drawing compact. A type without a compact floor refuses below its minimum. Every refusal names the minimum it needs.
603
650
 
@@ -608,8 +655,8 @@ These rules apply on every target.
608
655
  - The title is never cut. It wraps to three lines; a title that needs more takes more lines. The subtitle wraps until every word shows. The frame grows; the plot does not shrink for it.
609
656
  - A chart with two or more series always names them: a key row or a direct name at each series. Compact mode keeps the key, in the footnote size, and keeps an explicit `options.legend`. A line whose end names do not fit puts its key in a row above the plot at 480 px wide and narrower, never beside the plot.
610
657
  - `options.legend` takes `'top'` (the default: one row above the plot), `'bottom'`, `'right'`, `'left'`, `'none'` or `'auto'`. `'right'` and `'left'` put the key in a column beside the plot where the plot block keeps at least 68% of the chart width and the column fits the height. Otherwise the key stays in the row above the plot and the warning `legend-side-fallback` says why. A tilemap and a choropleth take the same values. The gradient key of a heatmap stands at the right edge for `'right'` and stays above the matrix for `'left'`.
611
- - A grid panel names its own series when its title names its one series, when a line or combo draws an end label with the name of every series, or when the panel draws its own key row. A grid whose panels all name their series draws no grid key under `legend: 'none'`. Otherwise the grid key row lists only the series no panel names, and the info lint `grid-legend-required` names them. A grid with no `legend` set follows the same rule when a chart panel draws two or more series.
612
- - An automatic height (no height, or a width alone) reserves the plot first. The plot gets at least half of the canvas and at least 160 px (`dashboard`: 140 px). Title lines, key, annotations and notes then grow the canvas. A `fill` type starts at its own minimum height, never at a 16:9 strip of a narrow width, and at card widths (under 480 px) a fill chart is never shorter than at 480 px, compact or full. Pie, waffle, choropleth and tilemap take the height of their content, and a framed sparkline card scales its trend band with its width (an authored width, or any width from 320 px on a dashboard): their marks scale with the width, so a narrower card of these can be shorter. Wider charts keep their aspect height. A chart whose plot does not take more height (variance tiers) keeps its start height. A `content` type keeps the height of its content; at card widths a butterfly, diagram, funnel, grid, heatmap, KPI or status card is never shorter than at the next wider card step (400, then 480 px). A grid of fill panels also keeps the plot floor. When title, key, notes and the axis-label row take more of a fill chart's automatic height than the furniture budget (half of the canvas under 720 px, 40% from 720 px), the chart grows to the smallest height inside the size ladder that keeps the budget, never past the tallest ladder step; where no such height exists, the `furniture-budget` warning stands.
658
+ - A grid panel names its own series when its title names its one series, when a line or combo draws an end label with the name of every series, or when the panel draws its own key row. A grid whose panels all name their series draws no grid key under `legend: 'none'`. Otherwise the grid key row lists only the series no panel names, and the warning `grid-legend-required` names them. A grid with no `legend` set follows the same rule when a chart panel draws two or more series.
659
+ - An automatic height (no height, or a width alone) reserves the plot first. The plot gets at least half of the canvas and at least 160 px (`dashboard`: 140 px). Title lines, key, annotations and notes then grow the canvas. A `fill` type starts at its own minimum height, never at a 16:9 strip of a narrow width, and at card widths (under 480 px) a fill chart is never shorter than at 480 px, compact or full. Pie, waffle, choropleth and tilemap take the height of their content, and a framed sparkline card scales its trend band with its width (an authored width, or any width from 320 px on a dashboard): their marks scale with the width, so a narrower card of these can be shorter. Wider charts keep their aspect height. A chart whose plot does not take more height (variance tiers) keeps its start height. A `content` type keeps the height of its content; at card widths a butterfly, diagram, funnel, grid, heatmap, KPI or status card is never shorter than at the next wider card step (400, then 480 px). A grid of fill panels also keeps the plot floor. A grid whose callout or note finds no seat at that height grows until the note seats, and a grid that would drop a note at its content height keeps the taller start height. A lone callout or note on a column wraps on two lines straight above it before it moves aside on a leader. When title, key, notes and the axis-label row take more of a fill chart's automatic height than the furniture budget (half of the canvas under 720 px, 40% from 720 px), the chart grows to the smallest height inside the size ladder that keeps the budget, never past the tallest ladder step; where no such height exists, the `furniture-budget` warning stands.
613
660
 
614
661
  ### Fixed height
615
662
 
@@ -659,6 +706,8 @@ A size up to 0.5 px under a minimum still fits, for every type. A browser lays a
659
706
  }
660
707
  ```
661
708
 
709
+ For a width alone, `minWidth` is the narrowest width from which every wider width draws in full mode, and `compactFloor.width` the narrowest from which every wider width draws at all. A form that refuses only in a narrow band between two widths that draw can stay unseen.
710
+
662
711
  `measure` reports two minimum heights. The minimum height depends on the width: text wraps, and notes grow with the frame. So `minHeightAtWidth` is the height needed at exactly the width you asked for (the minimum width when you asked for less): a chart pinned at that width and that height draws in full mode. `minHeight` is checked at the minimum width as well, so a chart pinned at `minWidth` × `minHeight` draws too. In a wide slot `minHeight` can be taller than the slot needs, because the narrow case sets it. A 280-day combo at 1168 px wide reports `minHeight` 522, `minHeightAtWidth` 404 and `naturalHeight` 657. Do not read the minimum from a layout that was drawn taller (`geometry.sizing`): it holds for that frame only. `canDraw` answers a size refusal with the same at-width height when the request has a width.
663
712
 
664
713
  Which value to use for a card:
@@ -740,6 +789,10 @@ The KPI hero figure prefers 1.5 × the M title size, rounded in the table unit,
740
789
 
741
790
  ## Reading errors and warnings
742
791
 
792
+ On line charts and plain slope charts, `options.highlight` selects drawn data series by ID. On one plain data line without a fan, a category ID also selects that point. For example, `"highlight": ["w5"]` enlarges W5's marker and paints the marker and its value in the theme's focus ink. The line keeps its paint and width. The marker grows by the theme's focus-to-data stroke ratio. An authored series fill keeps priority, as with series emphasis. Marker shapes, hollow forecast markers and explicit `marker: "none"` remain effective. Point values stay at their regular weight unless the series itself is also highlighted.
793
+
794
+ Category emphasis adds the selected value to the requested value labels. Explicit `labels: false`, `labels.point: false`, `valueLabels: "none"` and cell `label: false` still hide it. Reference series do not count as data lines. Several data series, area, stacked, bump and fan forms keep series-only highlighting. Series IDs take precedence when a category has the same ID. An unsupported category ID, reference-series ID or unknown ID produces one `highlight-unknown-id` warning without changing the chart. A list that also names a valid series keeps that series highlighted. Remove the category ID from `highlight` to restore the ordinary marker and value.
795
+
743
796
  A callout that uses a side other than `preferSide` reports `callout-side-changed` at info level. The warning names the callout and the side used. It does not change placement.
744
797
 
745
798
  A callout or note text wider than any free seat wraps to two to four lines at the width that fits, next to its point. A line break written as `\n` stays where the author put it. Text that still finds no seat is named in the "Not labelled on the chart" note, as before.
@@ -773,10 +826,11 @@ EOF
773
826
  }
774
827
  ```
775
828
 
776
- - `path` is a JSON Pointer into the spec you sent.
777
- - `fix` is a JSON Patch. Apply it to that spec as it is, or read `suggest` and change the field yourself. It is absent when the engine has no single repair. A size warning on a chart that draws never carries one, and `measure` names a drawn size instead.
829
+ - `path` is a JSON Pointer into the submitted spec or tool arguments. An inline-row finding can point to `/rows/0/revenue`. A file-row finding points to `/rowsFile`, with the source row and column in `displayPath`, for example `rowsFile row 1.revenue`. An argument error can point to `/width` or `/columns/value`.
830
+ - `fix` contains proposed JSON Patch operations. Apply spec paths to the submitted spec and argument paths to the tool arguments. For a file-row finding, edit the source cell named by `displayPath` instead of replacing the `rowsFile` path. Follow `suggest` when no single repair is available. A size warning on a chart that draws has no `fix`. Use `measure` to find a size that draws.
778
831
  - `docs` names the reference section that describes the field.
779
- - Errors come sorted by path, at most ten, then one `more-errors` entry with the count.
832
+ - Spec errors come sorted by path, at most ten, then one `more-errors` entry with the count. Tool-argument validation can return only its first error.
833
+ - `ok: false` means nothing was drawn. A `warn` warning needs a review of the drawing. `info` and `advice` need no retry.
780
834
 
781
835
  `options.locale: "de"` means `{ language: "de" }`. A language sets words only. Decimal and grouping marks come only from `options.locale.decimal` and `options.locale.thousands`. A root `locale` on a bare chart remains invalid, with a fix that moves its value into options.
782
836
 
@@ -784,7 +838,7 @@ Column, combo, bar and line charts use locale strings for built-in labels and no
784
838
 
785
839
  A partial category is named once, such as `W38 to date`. On combo, column, bar and variance charts, and on a line chart with one line, the words stand under the running value itself where a single value or total prints there and they fit its column; the chart then draws no partial key or axis words. On a time axis (`xAxis.type: "time"`), the words stand under the running value where they have room, else after the end value in the key, else under the reading below the axis, in a row of their own where the tick rows have no room. Otherwise its key comes after the series keys. With no partial key, the chart adds a note. Set `strings.toDate` to change the suffix and `strings.partial` to change a generic partial key. Combo charts hide the default value axis when all column totals are labelled. An explicit `valueAxis.show` still wins. Column and combo category rows try a smaller font before rotation. Combo line end labels stay inside the plot and clear the columns; a moved label has a leader to its point.
786
840
 
787
- Warnings have the same shape, arrive in `warnings`, and leave the drawing in place. `label-hidden`, for example, says the solver dropped a label that had no free space; `derived-mismatch` says an authored total differs from the computed one. A label collision that no size resolves refuses the chart with the error `label-collision`, which names each hidden label and what blocks it. More room does not lift it, so React shows it at once. A size refusal, and a hidden-label refusal that more width can clear, waits in a container that is still growing until the size holds still. A value, a series name, a value line or a pinned label that finds no seat is still on the page: the chart names it in a note, "Not labelled on the chart: North 42 (Q3).". The note is a disclosure: it is in the notes list and the `values-in-note` warning, and prints under the plot, also under `footnotes: false`, where `notes.show` lists `'disclosure'`. It is one note per chart. It names as many items as fit two footer lines at the drawn width, at most 8, reference lines and line end values first, then the rest in data order, and ends with a count, "and 236 more". A lone last item is named instead of "and 1 more" when it fits. When not even one name fits, the note only counts, "18 of 36 values". On a pinned height where the two-line note would push values off the plot, the note counts instead. A callout or note annotation that prints a value with `${value}` is that value's label, so the note does not name the value again. When the height is not pinned the chart first tries more height, so labels that can be drawn are drawn; the cap applies to what is left. Every item stays in the reading's `omissions` and in the hover records. `notes.maxListed` sets the number: `'all'` names every item, and `0` names none and only counts them, "18 of 36 values". `strings.moreListed` sets the wording of the count (a React chart with hover on adds "(tap or hover shows each value)" to the default). The info warning `values-in-note` lists every value and name a chart moved into a note, once per chart, so a check of the warnings sees them. A canvas too small to name them all is refused with `size-below-floor` and the height it needs. `unknown-slot` and `pin-blocked` list a label's valid slots and, apart, the ones free now, so a pin can be corrected from the message alone.
841
+ Warnings have the same shape, arrive in `warnings`, and leave the drawing in place. `label-hidden`, for example, says the solver dropped a label that had no free space; `derived-mismatch` says an authored total differs from the computed one. A label collision that no size resolves refuses the chart with the error `label-collision`, which names each hidden label and what blocks it. More room does not lift it, so React shows it at once. A size refusal, and a hidden-label refusal that more width can clear, waits in a container that is still growing until the size holds still. A value, a series name, a value line or a pinned label that finds no seat is still on the page: the chart names it in a note, "Not labelled on the chart: North 42 (Q3).". The note is a disclosure: it is in the notes list and the `values-in-note` warning, and prints under the plot, also under `footnotes: false`, where `notes.show` lists `'disclosure'`. It is one note per chart. It names as many items as fit two footer lines at the drawn width, at most 8, reference lines and line end values first, then the rest in data order, and ends with a count, "and 236 more". A lone last item is named instead of "and 1 more" when it fits. When not even one name fits, the note only counts, "18 of 36 values". On a pinned height where the two-line note would push values off the plot, the note counts instead. A callout or note annotation that prints a value with `${value}` is that value's label, so the note does not name the value again. When the height is not pinned the chart first tries more height, so labels that can be drawn are drawn; the cap applies to what is left. Every item stays in the reading's `omissions` and in the hover records. `notes.maxListed` sets the number: `'all'` names every item, and `0` names none and only counts them, "18 of 36 values". `strings.moreListed` sets the wording of the count (a React chart with hover on adds "(tap or hover shows each value)" to the default). The info warning `values-in-note` counts the values and names a chart moved into a note and lists each one in `detail.values`, once per chart, so a check of the warnings sees them. A canvas too small to name them all is refused with `size-below-floor` and the height it needs. `unknown-slot` and `pin-blocked` list a label's valid slots and, apart, the ones free now, so a pin can be corrected from the message alone.
788
842
 
789
843
  A chart with nothing to draw (no categories, series, rows or points) is reported with the one code `empty-data`, in the CLI and MCP findings, in the layout error and in React. In React, `onEmpty` is called once, and the chart shows `strings.emptyMessage` of the provider (default "No data to show.") instead of an error. `canDraw(request)` from `boardplot` answers without drawing: `{ ok: true }`, or `{ ok: false, code, minimum? }`, where `code` is `empty-data`, `too-many-items` or `size-below-floor` and `minimum` is the size the chart needs, so a host can hide a card. A table with no rows still draws its header and counts as drawn.
790
844
 
@@ -812,7 +866,140 @@ An option a chart type does not read is ignored with an `option-ignored` warning
812
866
 
813
867
  ### Design advice
814
868
 
815
- Bar, line, waterfall and diagram have a design card: what the chart says, when to use it and when not, and four to eight rules. `boardplot_describe` prints the message, the use, the not-when and the first two rules; `path: "design"` (CLI: `boardplot describe bar --path design`) prints every rule. Each rule is marked `engine` or `describe`. Render checks the `engine` rules on the drawn chart and returns each finding as a warning with severity `advice`, a code that starts with `design-`, one sentence and a `docs` link to the rule. A `fix` patch is included only when it can apply to the input as sent. Otherwise follow `suggest`; for example, a waterfall built from rows gets written advice when a patch would target generated items. Advice never changes the drawing and never refuses. A render returns at most three, the MCP server returns each code once per session, and a refused render returns none. The `describe` rules need the author's judgment, such as the business order of a bridge.
869
+ A chart contract can include a `design` card: what the chart says, when to use it, when another type fits better, and design guidance. Compact `boardplot_describe` prints the message, use, limitations and first two rules; `path: "design"` (CLI: `boardplot describe bar --path design`) prints every rule. Each rule is marked `engine` or `describe`. Render checks the `engine` rules on the drawn chart and returns each finding as a warning with severity `advice`, a code that starts with `design-`, one sentence and a `docs` link to the rule. A `fix` patch is included only when it can apply to the input as sent. Otherwise follow `suggest`; for example, a waterfall built from rows gets written advice when a patch would target generated items. Advice never changes the drawing and never refuses. A render returns at most three, the MCP server returns each code once per session, and a refused render returns none. The `describe` rules need the author's judgment, such as the business order of a bridge.
870
+
871
+ Other checks also return `advice`: `height-off-ladder` (an authored height between the standard height steps), `dead-band` (an empty band on the canvas), `missing-message-title`, `series-overload`, `pie-too-many-slices`, `legend-redundant`, `line-peer-overload` and `pareto-tail-crowded`. They do not count towards the three design findings, and the MCP server returns them with every chart that has them.
872
+
873
+ ## Position of bar value labels
874
+
875
+ Set `options.labelPosition` once to move the values on a chart's bars. The four positions match the choices in Excel. Omit the option, or use `'auto'`, to keep the chart's normal placement.
876
+
877
+ | Value | Position |
878
+ |---|---|
879
+ | `'center'` | The middle of the drawn bar on each axis. |
880
+ | `'insideEnd'` | Inside the edge farther from zero. |
881
+ | `'insideBase'` | Inside the edge nearer zero. |
882
+ | `'outsideEnd'` | Outside the edge farther from zero. |
883
+
884
+ The end is the edge with the larger absolute value. The definition applies to bars on an axis and to floating bridge steps. A falling bridge step above zero has its end at the top and its base at the bottom. Below zero, the edges reverse. A step that crosses zero uses the top edge on a tie. For horizontal bars, read right and left for top and bottom.
885
+
886
+ A requested seat must fit and stay clear of other text, lines and axis-break gaps. Inside text needs its width plus 8 px and its height plus 2 px. A vertical edge seat needs its height plus 4 px. When an inside seat cannot be used, a floating bridge step tries above the bar, then below. A horizontal bridge step tries right, then left. The floating-step fallback keeps that order below zero too. A bridge total or a bar on an axis falls back outside its end. A zero-length bar uses an outside seat. Segment values keep their existing thin-segment fallbacks. Values with muted words such as “to date” or “(partial)” use outside seats.
887
+
888
+ Integrated variance totals use the requested seat only when one paint holds the whole label. Their fallbacks remain `insideBase`, then `insideEnd`. Integrated totals never move outside. The variance caps and delta labels keep their positions.
889
+
890
+ On a column with a reference series (`role: "reference"`, drawn as a tick), the plan tick draws behind its column and reaches up to 4 px past each side, or 2 px where a plan value beside it needs the room. The column stays whole, and the two ends that stand out beside it mark the plan, however near the plan is to the column's top. A column short of its plan prints its value inside its end, under the tick, and not above the tick, where it would read as the plan's value. Every column short of plan takes that one seat, at every width. To draw the tick over the column on a page-colour band, the earlier look, set `referenceTick: { position: "front" }`. The value of a column short of plan then stands between the column and the tick where it fits. To keep the value above the tick, pin it: `labelPlacements: { "point:revenue:fy23": "outsideTopShifted" }`. A reference value beside its tick stays in the gaps beside its own column. Where only a seat over a neighbour's column is free, the value goes to the notes. Where the chart has one reference series, the key names it and a named value ("400 Plan") is too wide for the gap beside its column, every value of that series prints the number alone ("400"). To keep the name, set the tick content: `labels: { tick: ["absolute", "series"] }`.
891
+
892
+ | Chart and variant | Supported values |
893
+ |---|---|
894
+ | Waterfall, vertical or horizontal, including cases; PVM | All |
895
+ | Grouped column and bar; histogram; absolute variance | All |
896
+ | Mekko bar; butterfly; pyramid | All |
897
+ | Combo with one column series; Pareto | All |
898
+ | Stacked and stacked100 column and bar; stacked and stacked100 Mekko; Likert | All except `'outsideEnd'` |
899
+ | Combo with two or more column series; integrated variance | All except `'outsideEnd'` |
900
+
901
+ A total above two or more stack parts stays above the stack. A stacked column or bar with one drawn part moves its total with the option, except in stacked100. A combo column with one drawn part moves its total too. Waterfall segment values and the sums or totals of segmented bridge bars keep their existing seats. PVM's net change takes the space directly past the closing bar when its total moves inside.
902
+
903
+ `labelPlacements` pins take precedence and keep their existing slot meanings. `labelDensity`, `valueLabels`, `labels` and authored cell labels still decide which values print. `labelPosition` takes precedence over the theme's `marks.barLabels` setting. The chart keeps the plot room reserved by its normal placement. A grid panel accepts the option through that panel's own options.
904
+
905
+ Football-field and tornado bars, relative variance, bullet, funnel, bartable and chart types without supported bar values do not accept the option. A combo without column series accepts only `'auto'`. Unsupported variants and values report `label-position-unsupported` at `options.labelPosition` and list accepted values.
906
+
907
+ ## Moving text and drawing on a chart
908
+
909
+ This section covers three things: moving a label, a bracket's seat, and four drawing annotations.
910
+
911
+ ### Which option moves a label
912
+
913
+ - Use `labelPosition` to move all values on a chart's bars to one named position.
914
+ - Use `labelPlacements` to pin one label to a named slot that the chart offers.
915
+ - Use `labelOffsets` to move one label by a set distance from the seat it would take.
916
+
917
+ On one plain data line without a fan, `options.pointLabelSide` defaults to `"shape"`. The first finite value prefers the left of its point, a strict local peak prefers above, a strict local trough prefers below, and the last finite value prefers the right. The endpoint values get room beside their points only where the plot can spare it. The centred end room must print every category name, the names must print the same with the side room, and no label that the centred end room prints may be lost. Otherwise the endpoint values keep the centred end room. Flat plateaus keep their previous preference. Reference series do not count as data lines. Several data series, area, stacked, bump and fan forms keep the previous placement. The label solver can use a fallback to avoid collisions, and `labelPlacements` pins take precedence. A reference line through a preferred seat blocks that seat. The solver uses the next candidate instead of cutting the reference line around the value. Set `"pointLabelSide": "auto"` to restore the previous candidate order and endpoint reserves. `valueLabels`, `labels` and cell labels still decide which values print.
918
+
919
+ A shaded band's name keeps its existing placement preference within the plot, including reserved annotation headroom. A name that would leave the plot tries the existing inside seats first, on one line and then two lines. To keep the previous outside seat of a band with `id: "maintenance"`, set `options.labelPlacements` to `{ "annotation:maintenance": "aboveBandEnd" }`. Pins keep their previous candidate order. The solver still checks a pinned seat for collisions and uses a fallback when the seat is blocked.
920
+
921
+ ### Read a label's id
922
+
923
+ Each label of an SVG render carries `label:` and its id in `data-id`, such as `label:annotation:callout-2` for the id `annotation:callout-2` or `label:sum:price` for `sum:price`. An annotation's id comes from its `id`, otherwise from its kind and its position in `annotations`. To list every id, give `labelOffsets` an id that does not exist: the warning `label-offset-unknown` names the valid ids of that render.
924
+
925
+ ### `labelOffsets`
926
+
927
+ `options.labelOffsets` maps a label id to `{ x, y }`, in px on the rendered chart. Positive `x` moves right, and positive `y` moves down.
928
+
929
+ ```json
930
+ {
931
+ "type": "waterfall",
932
+ "data": {
933
+ "items": [
934
+ { "id": "open", "label": "Opening", "type": "total", "value": 200 },
935
+ { "id": "volume", "label": "Volume", "value": 42 },
936
+ { "id": "costs", "label": "Costs", "value": -36 },
937
+ { "id": "close", "label": "Closing", "type": "total" }
938
+ ]
939
+ },
940
+ "annotations": [{ "kind": "callout", "at": "costs", "text": "Energy contracts renewed" }],
941
+ "options": { "labelOffsets": { "annotation:callout-1": { "y": -40 } } }
942
+ }
943
+ ```
944
+
945
+ - The solver chooses the seat first, with any pin, and the offset moves it. Natural seats do not change.
946
+ - A move that meets another mark, another label or the canvas edge is not made. The label stays in its chosen seat, and the warning `label-offset-blocked` names what blocks it. If no seat is free, the moved first seat is tried once before the label is hidden. An offset never hides a label that would otherwise draw.
947
+ - A label moved 12 px or more off its own bar gets a leader back to its mark, unless the label is a value that takes none. A seat that already has a leader keeps it. A leader that would cross text is not drawn, and the chart warns `label-offset-blocked`.
948
+ - A value moved off its bar leads from the top or end of its own bar into the near edge of its text. A move that sets a value beside its bar, where a level leader would read as a minus sign or as a neighbour's value, is not made and warns `label-offset-blocked`. Move it further up or down.
949
+ - A value moved within its bar stays 4 px inside the bar's edges.
950
+ - A moved callout's leader starts at its mark.
951
+ - An annotation's drawing stays where it is, and a move onto that drawing is blocked.
952
+ - A value moved within its own bar keeps its ink. A value moved off its bar prints in page ink with a halo, so white text never lands on the page.
953
+ - A callout with an icon or a status moves with its chip, and its leader still ends at its anchor.
954
+ - A bracket's offset moves its label only, not its run.
955
+ - On a horizontal waterfall, `x` and `y` stay screen pixels.
956
+
957
+ ### Where a bracket stands
958
+
959
+ The `bracket`s of one waterfall stand on one row: the lowest row that clears every bracketed span and its values. A single bracket stands directly above its own bars and their values. A bracket moves to the row at the top of the plot when its label, run or ticks would meet something on its row. The plot keeps room above it for that top row only where a bracket stands there. Where every bracket stands on its row below, the empty band goes back to the plot. `bracketRow: "span"` stands each bracket directly above its own bars and their values instead. A `valueLine` authored after a bracket is not yet claimed when the bracket chooses its seat, so author the value line first to keep the bracket off it.
960
+
961
+ On a waterfall, the total change, a `diff` or `delta` between the bridge's first and last total, runs as the growth bracket, as a far difference does on a column chart: a leg up from each total, a run above the brackets, and the difference on the run, such as `+6 (+3%)` for `mode: "both"`. A difference between other totals, or one that names a step or a case, keeps the arrow at the bars. `placement: "label"` keeps that arrow for the total change too.
962
+
963
+ ### Drawing annotations
964
+
965
+ Four annotation kinds draw on data positions, so a drawing stays on its data at every size.
966
+
967
+ | Kind | Fields | Draws |
968
+ |---|---|---|
969
+ | `text` | `at`, `text`, `id`, `priority` | Text on the point, or above, below, right or left of it, 8 px away. Text inside a bar gets a halo, and text never straddles a bar's edge. Text that finds no seat, such as on a pie slice or a filled heatmap cell, goes to the note with a warning. `${value}` prints as written. |
970
+ | `line` | `from`, `to`, `dashed`, `id` | A straight line. |
971
+ | `arrow` | `from`, `to`, `dashed`, `id` | A straight arrow, with its head at `to`. |
972
+ | `box` | `from`, `to`, `dashed`, `id` | An unfilled box, with `from` and `to` as opposite corners. A corner given by category takes the outer edge of that category's band, so the box wraps whole bars and their values. `from` and `to` may name one category. |
973
+
974
+ A point is an anchor such as `"q2"`, `{ "categoryId": "q2", "seriesId": "plan" }` or `{ "pointId": "p7" }`, or a category with a value in axis units: `{ "categoryId": "q2", "value": 120 }`. A `line` or `arrow` end given by category sits on the category's centre.
975
+
976
+ A `line` or `arrow` end may also be `{ "annotationId": "launch-note" }`, the `id` of a `text` annotation. The end then attaches to the nearest edge of that text, 4 px away for an arrow and 3 px for a line, wherever the text seats at the drawn width. An id that names no text annotation, and a text that finds no seat, give `bad-anchor` and draw nothing.
977
+
978
+ ```json
979
+ {
980
+ "type": "column",
981
+ "data": {
982
+ "categories": [{ "id": "q1", "label": "Q1" }, { "id": "q2", "label": "Q2" }, { "id": "q3", "label": "Q3" }],
983
+ "series": [{ "id": "orders", "label": "Orders", "values": [30, 60, 45] }]
984
+ },
985
+ "annotations": [
986
+ { "kind": "text", "id": "contract", "at": { "categoryId": "q1", "value": 70 }, "text": "New contract" },
987
+ { "kind": "arrow", "from": { "annotationId": "contract" }, "to": { "categoryId": "q2", "value": 64 } }
988
+ ],
989
+ "options": { "valueAxis": { "min": 0, "max": 80 } }
990
+ }
991
+ ```
992
+
993
+ - A value outside the plot, a chart with no value scale and an anchor that does not resolve give the warning `bad-anchor` and draw nothing. A drawing does not extend the axis.
994
+ - Lines and boxes take the ink and rule width of a bracket and no other styling. A label may sit inside a box, because only the box's edges block it.
995
+ - Every annotation arrow follows one standard: a drawn arrow, a callout arrow, a CAGR bracket or growth arrow, a difference, a link, a gap bracket and a band bracket. The head is filled, 8 px long and 7 px wide, in the ink colour. The shaft is the thin `stroke.rule` line; `marks.arrow.stroke` sets its width in px. An arrow to a data point stops 6 px off the edge of the point's marker, and its tail starts 4 px off its text. A difference between line points keeps the same 6 px off the marker at both ends. A CAGR bracket leg reaches 16 px past the shaft's end, head included, because its arm carries the length. The plot keeps its height. A difference or a bracket still touches its level guide. A drawn arrow whose shaft is shorter than 24 px warns `arrow-short`. A callout arrow seats its text far enough out for a 24 px shaft; where no seat leaves that room, the callout draws without the arrow and warns `callout-arrow-no-room`. The theme key `marks.arrow` holds the numbers, and `marks.arrow.style: "compact"` brings back the smaller arrows of 0.57.
996
+ - On a bar chart, a `diff` between two categories of one series rides in the shorter bar's row: a dotted guide drops from the longer bar's end, and an arrow runs along the row to the `to` end with the number in a break of its shaft. Where the row is too short for the number and a head on each side, the arrow stays off the rows as before. `placement: "label"` keeps that older form: the arrow between the rows and the number beside it.
997
+ - A callout, a note or a delta on a column stands straight above it, without a leader. Two or more on the same column stack there in the order they are listed. The stack starts over the column's own value printed above it and over a reference tick that crosses the column's end. A `preferSide` with free room still wins: `preferSide: "left"` puts a callout beside the column on a leader, as before.
998
+ - A `delta` prints the value difference by default. `mode: "relative"` prints the percent change from `vs` to `at`, for example `+36%`. `mode: "both"` prints the two together, `+149 (+36%)`. Both percent modes need a nonzero `vs`; a `vs` of 0 warns `ref-zero` and draws nothing.
999
+ - A `diff` prints the percent change by default. `mode: "absolute"` prints the value difference, and `mode: "both"` the two together, `+149 (+36%)`.
1000
+ - A `diff` or `delta` between the totals of two columns that are not neighbours runs as the growth bracket over the columns, as a `cagr` does: a leg up from each column and an arm over the columns between, with the difference on the arm. The plot keeps its width, so the column values keep their row. A difference between segments of a stacked column, or between neighbours, keeps the arrow at the columns. `placement: "label"` keeps that arrow for any pair: a `diff` stands in a free gap between the columns with its number beside it, and a `delta` prints over its column.
1001
+ - No line crosses text. A stretch that would cross a label is cut around it with 2 px of air, and the warning `draw-crosses-text` names the annotation. The rest of the drawing stays. A value or a name that seats after a drawing keeps off its strokes.
1002
+ - These kinds take bar, box, bullet, butterfly, column, combo, dot, funnel, heatmap, line, Mekko, Pareto, pie, likert, pyramid, PVM, scatter, slope, variance and waterfall, and a grid panel of those types through its options. Other chart types drop them with the warning `unsupported-annotation`. A horizontal waterfall draws no annotations, and a warning says so.
816
1003
 
817
1004
  ## Log scales on a line
818
1005
 
@@ -853,6 +1040,8 @@ The line reference has the full recipe under "Cycle bands", and the fixture `cyc
853
1040
 
854
1041
  `valueLine.text` is read as `label` when `label` is absent or equal, with an info warning and a rename fix. Different `text` and `label` values remain refused. `indicator100.text` remains refused.
855
1042
 
1043
+ A named `valueLine` prints its name and its number, "Normal load 53%". Where the series prints the same number at its end beside the line, the name stands alone just left of that value, so the number prints once: "Normal load" next to "53%". A `label` with `${value}`, such as `"Normal load ${value}"`, always prints the number.
1044
+
856
1045
  For a `valueLine` with `value: "mean"`, `seriesId` selects the series. A paired `from` and `to` selects the inclusive category window. The mean line spans only that window. Adjacent shaded `band` annotations have a hairline between them, so each period remains distinct.
857
1046
 
858
1047
  ## Times and numbers on the x axis of a line
@@ -949,7 +1138,7 @@ Keep shared design tokens in application data when possible. If CSS owns the tok
949
1138
 
950
1139
  ### Stable series colours
951
1140
 
952
- Assign `colorRole` from one map keyed by series id before filtering or rendering. Use the same map for every chart and export. A `series-N` role always selects step N of `color.series`, with N starting at 1. It does not select a step of `options.palette`. An explicit `fill` still wins over `colorRole`.
1141
+ Assign `colorRole` from one map keyed by series id before filtering or rendering. Use the same map for every chart and export. A `series-N` role always selects step N of `color.series`, with N starting at 1. It does not select a step of `options.palette`. An explicit `fill` still wins over `colorRole`. Series of one chart that share a role draw in distinct steps of its colour. Gantt bars, sankey nodes, status cells and slope lines without a key keep the one colour, because their position or label names each item.
953
1142
 
954
1143
  ```ts
955
1144
  const series = [{ id: 'core', values: [42] }, { id: 'extra', values: [18] }];
@@ -981,4 +1170,5 @@ Layout measures text with bundled width tables for Geist, Helvetica and Arial, t
981
1170
  - [reference/theme.md](reference/theme.md): presets, every token and the theme errors.
982
1171
  - [reference/react.md](reference/react.md): `BoardplotChart`, the per-type components, container sizing, server preparation and export.
983
1172
  - [reference/fixtures.md](reference/fixtures.md): every fixture by type.
1173
+ - [reference/warnings.md](reference/warnings.md): every warning and refusal code, its severities and the chart types that return it.
984
1174
  - [FONTS.md](FONTS.md): width tables for a licensed font.