boardplot 0.56.0 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (552) hide show
  1. package/CHANGELOG.md +408 -0
  2. package/README.md +49 -15
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-VGSL4NJK.js} +1 -1
  4. package/dist/{ReaderBox-GLCKYXBU.js → ReaderBox-MHMXIDAJ.js} +8 -7
  5. package/dist/{annotateEngine-QVNAE3EH.js → annotateEngine-753KQBNN.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-HZUAEMN5.js → chunk-2CQBBN7M.js} +4 -4
  8. package/dist/{chunk-K3VZ5QJK.js → chunk-2ETK5TSA.js} +4 -4
  9. package/dist/{chunk-HHXIVFAU.js → chunk-2ETSI2EL.js} +11 -9
  10. package/dist/{chunk-ECBUFKCP.js → chunk-2GRXHWRH.js} +3 -3
  11. package/dist/{chunk-ZVM5TFGR.js → chunk-2HII2B6S.js} +6 -2
  12. package/dist/{chunk-WBETBGSC.js → chunk-2LC2H3ZM.js} +1003 -907
  13. package/dist/chunk-2NX7EO7H.js +23 -0
  14. package/dist/{chunk-52WNCUIN.js → chunk-2QI2PK2O.js} +1 -1
  15. package/dist/{chunk-QWCLWFKC.js → chunk-2VKQQLP7.js} +180 -58
  16. package/dist/chunk-3DOVXJ6K.js +602 -0
  17. package/dist/{chunk-CAJ54IEP.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-MOS6WFWM.js → chunk-3HA4IJTO.js} +9 -9
  19. package/dist/{chunk-JCIXYOND.js → chunk-3HPPTQEW.js} +4 -4
  20. package/dist/{chunk-7VVHTOE7.js → chunk-3KT2647F.js} +4 -2
  21. package/dist/{chunk-O6ZTIDWB.js → chunk-3MFVJMP6.js} +3 -2
  22. package/dist/{chunk-KQCKK3LD.js → chunk-3P3FKPFN.js} +170 -73
  23. package/dist/{chunk-WI5VOSQX.js → chunk-3XAJSMYD.js} +2 -2
  24. package/dist/{chunk-CPGASWNN.js → chunk-42QKUSHJ.js} +13 -3
  25. package/dist/{chunk-QB5HV4IY.js → chunk-44JU3VOT.js} +7 -8
  26. package/dist/{chunk-BYCJ6TKI.js → chunk-44K75CYE.js} +3 -3
  27. package/dist/{chunk-MS7O3KDJ.js → chunk-4FNM4D57.js} +6 -6
  28. package/dist/{chunk-BVYIKLQ5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-3V62N3Z7.js → chunk-4VV3KUFT.js} +7 -8
  30. package/dist/{chunk-MAFPVR4G.js → chunk-54YO56IK.js} +10 -5
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-6AMN7IKJ.js → chunk-5JEU6MWC.js} +49 -28
  33. package/dist/{chunk-NCLRZQR6.js → chunk-5JIB4VJA.js} +18 -10
  34. package/dist/{chunk-SXD3OYAR.js → chunk-5OP3E2ZD.js} +205 -96
  35. package/dist/{chunk-SS4YGK3E.js → chunk-5SLBD4BT.js} +72 -304
  36. package/dist/{chunk-XMP2DNLI.js → chunk-5SVGTQTW.js} +4 -4
  37. package/dist/chunk-5U567TYU.js +23 -0
  38. package/dist/chunk-5ZLF4S7X.js +40 -0
  39. package/dist/{chunk-T2YDWT54.js → chunk-5ZMTQATF.js} +261 -147
  40. package/dist/{chunk-WXJ5MHLH.js → chunk-62BDQTO6.js} +2 -2
  41. package/dist/chunk-64K3V4VN.js +25 -0
  42. package/dist/{chunk-BK6P6KMW.js → chunk-67YJJJIB.js} +1 -1
  43. package/dist/{chunk-32LLDRPI.js → chunk-6DJNFT2K.js} +42 -32
  44. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  45. package/dist/{chunk-7STMIK2X.js → chunk-6JFQCVNN.js} +4 -4
  46. package/dist/chunk-6JXBLQJ2.js +32 -0
  47. package/dist/{chunk-5TWY3ZIC.js → chunk-6XPV6M3Q.js} +5 -5
  48. package/dist/{chunk-MPO5TVGF.js → chunk-6ZDSEITW.js} +3 -3
  49. package/dist/{chunk-75WIUG2W.js → chunk-72HVDLMT.js} +172 -78
  50. package/dist/chunk-75NU5RLX.js +24 -0
  51. package/dist/chunk-76GPN6AT.js +72 -0
  52. package/dist/chunk-7BQK2UDV.js +13 -0
  53. package/dist/{chunk-CF4NMRN7.js → chunk-7CAYRPJV.js} +45 -25
  54. package/dist/{chunk-U3A6FMSI.js → chunk-7GWWBHVQ.js} +7 -7
  55. package/dist/{chunk-CHAS5A5B.js → chunk-7NYUFMLJ.js} +149 -86
  56. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  57. package/dist/chunk-A65B23JK.js +113 -0
  58. package/dist/{chunk-4KMZAK6J.js → chunk-A7R6FUS6.js} +4 -4
  59. package/dist/{chunk-E2ZUBP4Q.js → chunk-AEVGUOPB.js} +7 -8
  60. package/dist/chunk-AHIK2N72.js +53 -0
  61. package/dist/{chunk-KLB2QC24.js → chunk-AICO24HJ.js} +5 -2
  62. package/dist/{chunk-7KSUMFBK.js → chunk-AJGSCVVW.js} +5 -1
  63. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  64. package/dist/{chunk-E7V3OHQQ.js → chunk-AN2V2LC4.js} +37 -22
  65. package/dist/{chunk-JIEVDGAF.js → chunk-AOFUA5XP.js} +1 -1
  66. package/dist/chunk-B5A7X2BA.js +44 -0
  67. package/dist/{chunk-2HTYGMMG.js → chunk-BCMEGJRX.js} +2 -2
  68. package/dist/{chunk-KD5GOR2K.js → chunk-BDIKWR45.js} +124 -69
  69. package/dist/{chunk-FNRPQIQE.js → chunk-BG6AIWAK.js} +4 -6
  70. package/dist/{chunk-ZMPH2OC4.js → chunk-BOT6W3VB.js} +7 -8
  71. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  72. package/dist/{chunk-2DOEZ5QY.js → chunk-BZ67BJBH.js} +11 -10
  73. package/dist/{chunk-UBCVBBJJ.js → chunk-C47POAC5.js} +4 -3
  74. package/dist/{chunk-O7REHICC.js → chunk-C5OBPO4Z.js} +36 -28
  75. package/dist/{chunk-IGNBQT23.js → chunk-CCAAI56H.js} +121 -10
  76. package/dist/{chunk-RPIKNMZA.js → chunk-CDUR3KWV.js} +7 -2
  77. package/dist/{chunk-MZACASZY.js → chunk-CMPHT2LS.js} +14 -2
  78. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  79. package/dist/{chunk-IVRYF7QA.js → chunk-CR5FP5SF.js} +1 -1
  80. package/dist/{chunk-DD6RVD3S.js → chunk-D2TQX7UJ.js} +5 -1
  81. package/dist/{chunk-VVXKFU72.js → chunk-DEANHDXU.js} +62 -41
  82. package/dist/{chunk-GM3EGUYW.js → chunk-DHGE46UK.js} +1 -1
  83. package/dist/{chunk-UZTQUPTB.js → chunk-DIHX6NUB.js} +5 -5
  84. package/dist/{chunk-MD6DCQMA.js → chunk-DILQ34NW.js} +37 -37
  85. package/dist/{chunk-YMTXTQCN.js → chunk-DJKRYJP7.js} +6 -6
  86. package/dist/{chunk-JCAGVAB3.js → chunk-DKLC6QLF.js} +1200 -21
  87. package/dist/{chunk-SRAV6FPB.js → chunk-DNHTMCUP.js} +3 -3
  88. package/dist/{chunk-CKGSGRP7.js → chunk-DORE2RHL.js} +21 -5
  89. package/dist/{chunk-SMHZXHHD.js → chunk-DZYTXZNS.js} +15 -5
  90. package/dist/chunk-E262NRFP.js +39 -0
  91. package/dist/{chunk-V5JQQMFQ.js → chunk-E5YF236N.js} +4 -1
  92. package/dist/{chunk-IGJ2G5C6.js → chunk-EBUK7HJP.js} +6 -6
  93. package/dist/{chunk-ZL6IHMOW.js → chunk-ECBHC272.js} +198 -119
  94. package/dist/{chunk-SA46CNMS.js → chunk-ED7GLWTF.js} +4 -1
  95. package/dist/chunk-EFW43JQJ.js +24 -0
  96. package/dist/{chunk-5P2TTHBZ.js → chunk-EHRRHSPV.js} +2 -2
  97. package/dist/{chunk-JXBZIJCG.js → chunk-EILNJQMN.js} +32 -12
  98. package/dist/{chunk-GELSK76Y.js → chunk-ERDKMZ7O.js} +3 -3
  99. package/dist/{chunk-T2CYNDYU.js → chunk-ETRAPN5G.js} +366 -130
  100. package/dist/{chunk-JEUL777U.js → chunk-ETUKDEGL.js} +21 -12
  101. package/dist/chunk-F2ET5ZTT.js +49 -0
  102. package/dist/{chunk-2YO4WRJN.js → chunk-F3XOBFS4.js} +40 -29
  103. package/dist/{chunk-SPSGUFTI.js → chunk-FB6X7QHA.js} +1 -1
  104. package/dist/{chunk-5PPQIF4D.js → chunk-FGW54I23.js} +7 -8
  105. package/dist/{chunk-JTC5SEAQ.js → chunk-FP5B5XIL.js} +7 -3
  106. package/dist/{chunk-RJGCYGC3.js → chunk-FRHQGA5Q.js} +86 -250
  107. package/dist/{chunk-YZZLIYPA.js → chunk-FRR7BJ3B.js} +5 -1
  108. package/dist/{chunk-4DZFR52I.js → chunk-FVWHEM2N.js} +7 -5
  109. package/dist/{chunk-YPYD6OJ3.js → chunk-FWSMENKH.js} +2 -2
  110. package/dist/{chunk-YYJORENB.js → chunk-FWTUGNSF.js} +8 -8
  111. package/dist/{chunk-GIHH6VC2.js → chunk-FZKDZQ6U.js} +10 -6
  112. package/dist/{chunk-S7NRL66K.js → chunk-G4FF6G3I.js} +26 -17
  113. package/dist/{chunk-PQLAZEQV.js → chunk-GB6BZSTL.js} +248 -92
  114. package/dist/chunk-GCIHRRDJ.js +24 -0
  115. package/dist/{chunk-X3KCQEYZ.js → chunk-GHCU6OSE.js} +9 -1
  116. package/dist/chunk-GKDUIDU6.js +138 -0
  117. package/dist/chunk-GO66OCN7.js +24 -0
  118. package/dist/chunk-GOFS336W.js +24 -0
  119. package/dist/{chunk-AGDDH6XY.js → chunk-GQYT7G4F.js} +5 -1
  120. package/dist/{chunk-WN3HEU3P.js → chunk-GUTLXO7Q.js} +140 -89
  121. package/dist/chunk-H3VICNTN.js +47 -0
  122. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  123. package/dist/{chunk-CB4CERXZ.js → chunk-HBQHSZ6S.js} +11 -2
  124. package/dist/chunk-HTQGJQZN.js +124 -0
  125. package/dist/{chunk-F77TMAUY.js → chunk-HUQRO6VF.js} +39 -36
  126. package/dist/{chunk-4KQHKPB3.js → chunk-I5VDW2XZ.js} +543 -509
  127. package/dist/{chunk-43GGVT7W.js → chunk-I5VNHDPR.js} +11 -4
  128. package/dist/{chunk-4LTN7SND.js → chunk-IDXYHDQY.js} +1 -1
  129. package/dist/{chunk-Y54LU4CU.js → chunk-IIWZJ5ZM.js} +1 -1
  130. package/dist/{chunk-FMDNJ6PC.js → chunk-IPBOREIY.js} +2 -2
  131. package/dist/chunk-IU335UO7.js +27 -0
  132. package/dist/{chunk-JVZTKQFS.js → chunk-IVDTP6SV.js} +9 -5
  133. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  134. package/dist/{chunk-EIL3KHAL.js → chunk-J4QRB6DQ.js} +5 -5
  135. package/dist/{chunk-3465633G.js → chunk-JCMGKQVS.js} +3 -3
  136. package/dist/{chunk-YK2KWNTU.js → chunk-JM7UTLF3.js} +28 -14
  137. package/dist/{chunk-CXETOLPX.js → chunk-JNDWRV34.js} +4 -4
  138. package/dist/{chunk-DLUNQHFO.js → chunk-JSRQTDZZ.js} +26 -24
  139. package/dist/{chunk-WTQAG2OT.js → chunk-JT3UTEWZ.js} +8 -3
  140. package/dist/{chunk-GQT2SY2S.js → chunk-JUYRDZSV.js} +291 -151
  141. package/dist/{chunk-LKMFMNQX.js → chunk-JVGL2SCN.js} +1 -1
  142. package/dist/{chunk-4JC3SE4G.js → chunk-JY4LTPOV.js} +1 -1
  143. package/dist/chunk-K7XPTQBJ.js +267 -0
  144. package/dist/{chunk-P4SMC4BY.js → chunk-KGBUXMFP.js} +120 -86
  145. package/dist/{chunk-XC5IRUEL.js → chunk-KIE5V3DA.js} +2 -2
  146. package/dist/{chunk-RT66UTLJ.js → chunk-KU4PCG4W.js} +2 -2
  147. package/dist/{chunk-VPL3JYC6.js → chunk-KVBLTAO7.js} +52 -10
  148. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  149. package/dist/{chunk-PJBEJR2U.js → chunk-KWIP5YRA.js} +24 -7
  150. package/dist/{chunk-JYBT2JNY.js → chunk-LE3LSEUL.js} +27 -2
  151. package/dist/{chunk-R2IKOLBK.js → chunk-LG6M2JTH.js} +3 -3
  152. package/dist/{chunk-DF3XEFQ7.js → chunk-LIE2WSB4.js} +21 -18
  153. package/dist/{chunk-Z55DXFWS.js → chunk-LJDATBPB.js} +26 -16
  154. package/dist/{chunk-KLIZXSBK.js → chunk-LMMS675D.js} +10 -9
  155. package/dist/{chunk-MRAP2UVV.js → chunk-LPKGZ664.js} +286 -35
  156. package/dist/{chunk-JFFREZGT.js → chunk-LPMSGO7L.js} +6 -2
  157. package/dist/chunk-LQWINE7K.js +211 -0
  158. package/dist/{chunk-6MJUW5R5.js → chunk-MKMMQDIY.js} +139 -71
  159. package/dist/{chunk-F5BYLT3M.js → chunk-MQ4IEDM5.js} +462 -138
  160. package/dist/{chunk-QGFKSDQO.js → chunk-MRM4KJ2O.js} +2 -2
  161. package/dist/{chunk-ETMHDCEH.js → chunk-MX2OZHIT.js} +102 -42
  162. package/dist/{chunk-6EYTD777.js → chunk-MXUPMGRY.js} +2 -2
  163. package/dist/{chunk-2FKEF2AC.js → chunk-NHU26HQ7.js} +58 -35
  164. package/dist/{chunk-KBJMLXNW.js → chunk-NQVJ4FPY.js} +161 -78
  165. package/dist/chunk-NZ7FX3AE.js +65 -0
  166. package/dist/chunk-OALBVELJ.js +23 -0
  167. package/dist/{chunk-5S3JQ5AT.js → chunk-OGZ4UPYK.js} +183 -137
  168. package/dist/{chunk-6WHWXCHJ.js → chunk-OMNB27GM.js} +7 -3
  169. package/dist/{chunk-EGGDPDYJ.js → chunk-OO63YP35.js} +1 -1
  170. package/dist/{chunk-ZYQYX66L.js → chunk-OPYDTW5Q.js} +6 -6
  171. package/dist/{chunk-A2GAWGVJ.js → chunk-OSJN7KDS.js} +68 -39
  172. package/dist/{chunk-RMC4OONA.js → chunk-OSJXIW6I.js} +1030 -1123
  173. package/dist/{chunk-X23SZHV5.js → chunk-OVVE42P4.js} +6 -6
  174. package/dist/{chunk-CCJP6QZO.js → chunk-OZA7HA6L.js} +1 -1
  175. package/dist/chunk-OZLKEBCD.js +54 -0
  176. package/dist/{chunk-TE4M52AA.js → chunk-P6DEFCMQ.js} +18 -2
  177. package/dist/{chunk-AMR4SUAN.js → chunk-PDTIQL3B.js} +6 -6
  178. package/dist/{chunk-BIVL764T.js → chunk-PJ5BYZPN.js} +2 -2
  179. package/dist/{chunk-BISJK67O.js → chunk-PK7Z7WRJ.js} +98 -46
  180. package/dist/{chunk-7VMEM3LN.js → chunk-PL6NWB5U.js} +178 -113
  181. package/dist/chunk-PMT75APP.js +94 -0
  182. package/dist/chunk-PP6A4X55.js +11 -0
  183. package/dist/{chunk-I7H5DU34.js → chunk-PPCH3PLO.js} +25 -13
  184. package/dist/{chunk-BIGQKCU7.js → chunk-PPE6S7WU.js} +42 -24
  185. package/dist/{chunk-2NSQIPAA.js → chunk-PT7KSIEO.js} +23 -36
  186. package/dist/{chunk-KZJ5VM6E.js → chunk-PZ3TQFSY.js} +15 -1
  187. package/dist/{chunk-ZJFJ2IKQ.js → chunk-QAUGRVRU.js} +122 -23
  188. package/dist/{chunk-BTDGWHGJ.js → chunk-QMFWZG2P.js} +39 -19
  189. package/dist/{chunk-L6YVK6VC.js → chunk-QZGGCE45.js} +2 -2
  190. package/dist/{chunk-67QSW5RW.js → chunk-R2RJQ3BM.js} +4 -4
  191. package/dist/{chunk-ZY72LSQK.js → chunk-R7HBIQ63.js} +102 -61
  192. package/dist/{chunk-4JHMCXOB.js → chunk-RBNDZLYS.js} +77 -36
  193. package/dist/chunk-RCSY4CT4.js +2170 -0
  194. package/dist/{chunk-NGA7ICG4.js → chunk-RDJ3ZU6O.js} +16 -13
  195. package/dist/{chunk-2NN676RI.js → chunk-RHQRPJHS.js} +7 -8
  196. package/dist/chunk-RI6XQKWJ.js +26 -0
  197. package/dist/{chunk-YOOHNQ3L.js → chunk-RJICOOB3.js} +18 -8
  198. package/dist/{chunk-5DTCOOLU.js → chunk-RLAVNCQJ.js} +2 -2
  199. package/dist/{chunk-CYKXROFG.js → chunk-ROPPWJQB.js} +23 -12
  200. package/dist/{chunk-54ROMBU7.js → chunk-SELOV32X.js} +105 -50
  201. package/dist/{chunk-TUW5IYGA.js → chunk-SQI4NWTQ.js} +9 -9
  202. package/dist/{chunk-ZEYBI47P.js → chunk-SRJ74CMG.js} +11 -3
  203. package/dist/{chunk-NHC2ADGI.js → chunk-STWOURLG.js} +253 -144
  204. package/dist/chunk-SWMFXSVW.js +23 -0
  205. package/dist/chunk-SXAZDIGM.js +84 -0
  206. package/dist/{chunk-EMFUZKYK.js → chunk-SZ5VGWDY.js} +3 -3
  207. package/dist/{chunk-R5MEBBAA.js → chunk-T26G23RS.js} +442 -119
  208. package/dist/{chunk-QHRE2M6V.js → chunk-T2L5H2WW.js} +4 -3
  209. package/dist/chunk-T7GPIJ4L.js +89 -0
  210. package/dist/{chunk-MJPXHCBW.js → chunk-TAEB3RU6.js} +5 -5
  211. package/dist/{chunk-V7F4F6JA.js → chunk-TBDIMTRD.js} +37 -16
  212. package/dist/{chunk-63Y3ROZ7.js → chunk-TFFPEWNP.js} +102 -64
  213. package/dist/{chunk-EZZ533MH.js → chunk-TMEUK2WS.js} +6 -2
  214. package/dist/{chunk-37PKNVLS.js → chunk-TVOMGNFQ.js} +1 -1
  215. package/dist/{chunk-HJRNBKIT.js → chunk-TX5FSNAU.js} +436 -30
  216. package/dist/{chunk-V634AXDM.js → chunk-U52PNFPX.js} +1 -1
  217. package/dist/{chunk-QLANK3VN.js → chunk-U74AWJ3X.js} +6 -6
  218. package/dist/chunk-UC7LBW7N.js +26 -0
  219. package/dist/{chunk-PZ46S2SY.js → chunk-UCKUAKYQ.js} +2 -2
  220. package/dist/{chunk-KF7HD3EH.js → chunk-UCYL3YA7.js} +77 -55
  221. package/dist/{chunk-HOU2MZHC.js → chunk-UD2GI3CS.js} +11 -4
  222. package/dist/{chunk-SNQ7D5R7.js → chunk-UIHGGWES.js} +51 -11
  223. package/dist/{chunk-LGNJCPFP.js → chunk-ULQIC76A.js} +10 -13
  224. package/dist/{chunk-KTHFHD6C.js → chunk-UY34DDUM.js} +11 -6
  225. package/dist/{chunk-6QDMRPXI.js → chunk-UYMFLWM6.js} +215 -258
  226. package/dist/{chunk-KDSYZLF6.js → chunk-V5IFI3FV.js} +8 -1
  227. package/dist/{chunk-JTFKRDDA.js → chunk-V7FV66KL.js} +1 -1
  228. package/dist/{chunk-27OIGDRK.js → chunk-V7NUJEJE.js} +1 -1
  229. package/dist/{chunk-CCDXK5NA.js → chunk-VESSIKBG.js} +8 -3
  230. package/dist/{chunk-QSMGZOT5.js → chunk-VRFJAF3R.js} +7 -8
  231. package/dist/chunk-VS2R3OGN.js +34 -0
  232. package/dist/{chunk-RLMC5CUP.js → chunk-VS5B4J2D.js} +7 -8
  233. package/dist/{chunk-7M2GK7XQ.js → chunk-W4R6SGU3.js} +252 -121
  234. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  235. package/dist/{chunk-7DAH2E4T.js → chunk-WFBN2HXR.js} +2 -2
  236. package/dist/{chunk-DLDDRXAI.js → chunk-WJS6SAWA.js} +296 -145
  237. package/dist/{chunk-WWGPTEQB.js → chunk-WQYNKF33.js} +73 -22
  238. package/dist/{chunk-64LJDGJH.js → chunk-WUP6C4ZD.js} +4 -2
  239. package/dist/{chunk-F2EVCJ4U.js → chunk-X24WAHHV.js} +87 -43
  240. package/dist/{chunk-OJ5CQV7H.js → chunk-X3UCQPVV.js} +209 -96
  241. package/dist/{chunk-7FKY6YWU.js → chunk-X46PSAJ7.js} +6 -6
  242. package/dist/{chunk-H3IBJQ5A.js → chunk-XD5XB22R.js} +2 -2
  243. package/dist/chunk-XDIAQEYK.js +28 -0
  244. package/dist/{chunk-7PPMT5EJ.js → chunk-XFPNYHX3.js} +372 -105
  245. package/dist/{chunk-FCECYJVA.js → chunk-XIBVAKCO.js} +1 -1
  246. package/dist/{chunk-OG2YUVBW.js → chunk-XMX4PCFL.js} +8 -3
  247. package/dist/{chunk-2NRHD2G7.js → chunk-XRRG4MBM.js} +12 -4
  248. package/dist/{chunk-FNMH5WEY.js → chunk-XTFO6D4L.js} +1 -1
  249. package/dist/chunk-XWRI3N5O.js +70 -0
  250. package/dist/{chunk-ZKJ5L35C.js → chunk-XXPLPSOE.js} +36 -25
  251. package/dist/{chunk-XQMYQ4TN.js → chunk-XZXZNI7A.js} +1 -1
  252. package/dist/{chunk-E555EDOQ.js → chunk-YEJZ2OYS.js} +490 -182
  253. package/dist/chunk-YGZEG3JV.js +123 -0
  254. package/dist/{chunk-F6OLHND5.js → chunk-Z3WQXVFV.js} +2 -2
  255. package/dist/{chunk-FFJGC2DX.js → chunk-Z6DUNKFU.js} +173 -40
  256. package/dist/{chunk-N5HN5QGH.js → chunk-Z6H5ED2I.js} +1 -1
  257. package/dist/{chunk-7Q37C6GZ.js → chunk-ZBOOMLHD.js} +1 -1
  258. package/dist/{chunk-MOK3ZS6P.js → chunk-ZDJ7C64T.js} +1 -1
  259. package/dist/{chunk-GLQ3KCTY.js → chunk-ZGZLEUKM.js} +7 -8
  260. package/dist/{chunk-YHD2FZFP.js → chunk-ZHRGX225.js} +6 -6
  261. package/dist/{chunk-76Q7E3TM.js → chunk-ZIVCPXXL.js} +510 -646
  262. package/dist/{chunk-BSATR6ZO.js → chunk-ZNRSYS76.js} +21 -3
  263. package/dist/{chunk-DMAMWUYY.js → chunk-ZSLTSCTI.js} +5 -5
  264. package/dist/{chunk-IGVAWAOK.js → chunk-ZSYFQSPF.js} +43 -9
  265. package/dist/cli/index.js +8 -3
  266. package/dist/{core-7Y5BZZON.js → core-43GLGBOY.js} +8 -1
  267. package/dist/{core-7S3XMW5O.js → core-5GI3ERXO.js} +4 -1
  268. package/dist/{core-K3JX5WPM.js → core-5L7TMK7I.js} +6 -1
  269. package/dist/{core-LB5M7XL4.js → core-7TO4OVY5.js} +6 -1
  270. package/dist/{core-ILPXXC2Z.js → core-BJVENHFQ.js} +7 -1
  271. package/dist/{core-JDFUZFRH.js → core-BX4MFWKC.js} +6 -1
  272. package/dist/{core-XW7UJFJZ.js → core-C3KXTOIZ.js} +7 -1
  273. package/dist/{core-WJNK7F2J.js → core-C5Y6BFLL.js} +7 -1
  274. package/dist/{core-WZ4CHVYL.js → core-CLUSJ2SK.js} +5 -1
  275. package/dist/{core-TCSW24N6.js → core-E3IN2VVH.js} +5 -1
  276. package/dist/{core-MU4ALRR7.js → core-FD67NQOV.js} +6 -1
  277. package/dist/{core-YMXYUGF5.js → core-FDKMLRAK.js} +5 -1
  278. package/dist/{core-VKZSQFRG.js → core-FL6Z3VVX.js} +5 -1
  279. package/dist/{core-5UF44NDI.js → core-JC7JUFPY.js} +8 -1
  280. package/dist/{core-RR2CAZC5.js → core-JF33TADA.js} +8 -1
  281. package/dist/{core-4RR6VSXM.js → core-JH32ZAKM.js} +4 -1
  282. package/dist/{core-G3LXHW73.js → core-JYYZPPQV.js} +7 -1
  283. package/dist/{core-4HFVG4CP.js → core-KJTKCV4U.js} +4 -1
  284. package/dist/{core-GSILPKUR.js → core-LCQPE5Y6.js} +8 -1
  285. package/dist/{core-GLOZY6Z7.js → core-LHVGWE54.js} +6 -1
  286. package/dist/{core-J2JD5ODO.js → core-OVSNBOCE.js} +9 -1
  287. package/dist/{core-BLHEJ5OK.js → core-PPEC236B.js} +5 -1
  288. package/dist/{core-ZLSQHZ3I.js → core-QTJZDK5H.js} +5 -1
  289. package/dist/{core-TKZZZ6UW.js → core-R3YZCOUZ.js} +7 -1
  290. package/dist/{core-HTD5RHE7.js → core-RIBW5XU4.js} +7 -1
  291. package/dist/{core-AR2T32Y3.js → core-RJFILBWL.js} +8 -1
  292. package/dist/{core-A5AKUB7H.js → core-RWSXEKTE.js} +4 -1
  293. package/dist/{core-DD62MWEW.js → core-SOPPZLEH.js} +5 -1
  294. package/dist/{core-HDNWVLJW.js → core-TBUZCXLX.js} +5 -1
  295. package/dist/{core-BOG33BFD.js → core-TZ5QLTAX.js} +5 -1
  296. package/dist/{core-H5HO2CED.js → core-U7E5W4MY.js} +3 -1
  297. package/dist/{core-QPSAYRFT.js → core-UBNVSL44.js} +7 -1
  298. package/dist/{core-E2XOSHPR.js → core-UDRD4WIU.js} +6 -1
  299. package/dist/{core-DFZMOO7E.js → core-UVJZ4HY2.js} +7 -1
  300. package/dist/{core-LGJZUP6H.js → core-X7WWYQH4.js} +8 -1
  301. package/dist/{core-BBNY2BX4.js → core-XP56X47I.js} +5 -1
  302. package/dist/{core-3KLQSYWB.js → core-XQG54CYG.js} +6 -1
  303. package/dist/{dataTable-CNDRVGA5.js → dataTable-U7W4I6IF.js} +15 -2
  304. package/dist/{engine-FVEIM3WV.js → engine-O5V26MGR.js} +32 -19
  305. package/dist/fixtures.js +4 -1
  306. package/dist/flags-BVLSAXT3.js +10 -0
  307. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  308. package/dist/fonts.js +1 -1
  309. package/dist/geo/dach.js +1 -1
  310. package/dist/geo/de-states.js +1 -1
  311. package/dist/geo/eu27.js +1 -1
  312. package/dist/geo/europe.js +1 -1
  313. package/dist/geo/index.js +2 -2
  314. package/dist/geo/us-states.js +1 -1
  315. package/dist/geo/world.js +1 -1
  316. package/dist/index.js +41 -22
  317. package/dist/{main-THU6VIVU.js → main-35GS47XC.js} +68 -123
  318. package/dist/mcp/server.js +131 -118
  319. package/dist/react/bar.js +10 -1
  320. package/dist/react/bartable.js +10 -1
  321. package/dist/react/box.js +8 -1
  322. package/dist/react/bullet.js +10 -1
  323. package/dist/react/butterfly.js +10 -1
  324. package/dist/react/choropleth.js +10 -1
  325. package/dist/react/cohort.js +11 -1
  326. package/dist/react/column.js +10 -1
  327. package/dist/react/combo.js +10 -1
  328. package/dist/react/creative.js +11 -1
  329. package/dist/react/diagram.js +10 -1
  330. package/dist/react/dimswitch.js +11 -1
  331. package/dist/react/dot.js +9 -1
  332. package/dist/react/export.js +36 -18
  333. package/dist/react/funnel.js +9 -1
  334. package/dist/react/gantt.js +9 -1
  335. package/dist/react/grid.js +10 -1
  336. package/dist/react/heatmap.js +9 -1
  337. package/dist/react/histogram.js +11 -1
  338. package/dist/react/index.js +101 -85
  339. package/dist/react/kpi.js +10 -1
  340. package/dist/react/likert.js +11 -1
  341. package/dist/react/line.js +9 -1
  342. package/dist/react/mekko.js +10 -1
  343. package/dist/react/pareto.js +11 -1
  344. package/dist/react/pie.js +9 -1
  345. package/dist/react/prepare.js +49 -21
  346. package/dist/react/pvm.js +12 -1
  347. package/dist/react/pyramid.js +10 -1
  348. package/dist/react/sankey.js +10 -1
  349. package/dist/react/scatter.js +8 -1
  350. package/dist/react/slope.js +10 -1
  351. package/dist/react/sparkline.js +10 -1
  352. package/dist/react/spec.js +24 -14
  353. package/dist/react/status.js +9 -1
  354. package/dist/react/story.js +5 -2
  355. package/dist/react/table.js +9 -1
  356. package/dist/react/theme.js +10 -3
  357. package/dist/react/tilemap.js +9 -1
  358. package/dist/react/treemap.js +9 -1
  359. package/dist/react/variance.js +10 -1
  360. package/dist/react/waffle.js +9 -1
  361. package/dist/react/waterfall.js +11 -1
  362. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  363. package/dist/rows.js +3 -2
  364. package/dist/{rowsModule-LI6KOS46.js → rowsModule-H2S6WW4D.js} +2 -1
  365. package/dist/{schema-CGQID64D.js → schema-2R32F6AW.js} +1 -1
  366. package/dist/{schema-H2EC4GAQ.js → schema-2TPGJGVR.js} +1 -1
  367. package/dist/{schema-THXXFY6I.js → schema-47BG2TZA.js} +1 -3
  368. package/dist/{schema-AMT7P7KB.js → schema-56MOEOVR.js} +1 -1
  369. package/dist/{schema-GNTKL5DN.js → schema-5MSR4LNN.js} +1 -1
  370. package/dist/{schema-5ZTGVQAJ.js → schema-5RIYEWE6.js} +1 -1
  371. package/dist/{schema-LOQ3AFC7.js → schema-A26ZNGTZ.js} +1 -3
  372. package/dist/{schema-MMVPMJEF.js → schema-ALBF6V7Y.js} +1 -3
  373. package/dist/{schema-BKUFZLLI.js → schema-BA6WP5YZ.js} +1 -1
  374. package/dist/{schema-PQZWO3BP.js → schema-CBL2SMVR.js} +1 -3
  375. package/dist/{schema-BBTXTWYI.js → schema-CWKGLDSR.js} +1 -3
  376. package/dist/{schema-5KDEQBBT.js → schema-DBIQFL56.js} +1 -1
  377. package/dist/{schema-KPEPBGAX.js → schema-DL7V6NN2.js} +1 -1
  378. package/dist/{schema-PL3EU6EQ.js → schema-DUVJMFKQ.js} +4 -2
  379. package/dist/{schema-L5U4OROI.js → schema-ECJERHKF.js} +2 -1
  380. package/dist/{schema-YLE4XXQQ.js → schema-EDSEKZDJ.js} +1 -1
  381. package/dist/{schema-HH5HOORE.js → schema-ESR6ZIK4.js} +1 -3
  382. package/dist/{schema-5DUTAVO7.js → schema-F7TWGLRZ.js} +1 -3
  383. package/dist/{schema-B2GCEYXD.js → schema-FGB6IGZM.js} +1 -3
  384. package/dist/{schema-7NSV542V.js → schema-FKGGTM4Z.js} +2 -1
  385. package/dist/{schema-72EEMYS3.js → schema-FU2AFIEE.js} +1 -1
  386. package/dist/{schema-QORUB6EK.js → schema-JNJFCYBM.js} +18 -1
  387. package/dist/{schema-JH57NFXJ.js → schema-JYZ4RF6S.js} +2 -1
  388. package/dist/{schema-25INXAMY.js → schema-K7F6TEDK.js} +1 -2
  389. package/dist/{schema-OU35XA3Z.js → schema-KAK6DZX4.js} +1 -1
  390. package/dist/{schema-R5Y6NVBH.js → schema-MOKWIGF7.js} +1 -1
  391. package/dist/{schema-ZQSIR5UC.js → schema-MQT6BMNK.js} +1 -3
  392. package/dist/{schema-FDFQKIO5.js → schema-MR3BPPQR.js} +1 -1
  393. package/dist/{schema-VYECMPON.js → schema-OPXZYIW7.js} +1 -3
  394. package/dist/{schema-ZEVJMFLV.js → schema-PV7JGX5H.js} +1 -1
  395. package/dist/{schema-QPOBZUAR.js → schema-PWPQF5RC.js} +1 -1
  396. package/dist/{schema-GN6GAIU5.js → schema-PYQEUC5P.js} +1 -3
  397. package/dist/{schema-M5JBHQIV.js → schema-QPIC5MAG.js} +9 -2
  398. package/dist/{schema-QCIE6M2P.js → schema-R42VXFIS.js} +1 -1
  399. package/dist/{schema-J7TNCZIP.js → schema-TVUJNEX7.js} +1 -1
  400. package/dist/{schema-AXRDF6ND.js → schema-Y4TI2T3T.js} +1 -1
  401. package/dist/{schema-ZG6ZKFRZ.js → schema-ZU2EU2VP.js} +1 -1
  402. package/dist/{specValidation-VHLGDEME.js → specValidation-2NHJT7TQ.js} +4 -1
  403. package/dist/theme.js +7 -2
  404. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  405. package/dist/types/core/annotate.d.ts +27 -2
  406. package/dist/types/core/annotateArms.d.ts +3 -1
  407. package/dist/types/core/annotateTargets.d.ts +4 -0
  408. package/dist/types/core/annotationOrigin.d.ts +13 -0
  409. package/dist/types/core/axis.d.ts +2 -2
  410. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  411. package/dist/types/core/charts/bartable/types.d.ts +14 -1
  412. package/dist/types/core/charts/box/types.d.ts +3 -1
  413. package/dist/types/core/charts/choropleth/layout.d.ts +1 -5
  414. package/dist/types/core/charts/choropleth/types.d.ts +19 -0
  415. package/dist/types/core/charts/cohort/types.d.ts +16 -3
  416. package/dist/types/core/charts/column/model.d.ts +13 -0
  417. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  418. package/dist/types/core/charts/creative/types.d.ts +21 -0
  419. package/dist/types/core/charts/dimswitch/compile.d.ts +15 -2
  420. package/dist/types/core/charts/dimswitch/types.d.ts +24 -1
  421. package/dist/types/core/charts/gantt/calendar.d.ts +24 -0
  422. package/dist/types/core/charts/gantt/columns.d.ts +56 -0
  423. package/dist/types/core/charts/gantt/layout.d.ts +8 -2
  424. package/dist/types/core/charts/gantt/model.d.ts +296 -0
  425. package/dist/types/core/charts/grid/metricStack.d.ts +9 -0
  426. package/dist/types/core/charts/grid/metricStackSchema.d.ts +13 -0
  427. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  428. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  429. package/dist/types/core/charts/histogram/types.d.ts +8 -0
  430. package/dist/types/core/charts/likert/layout.d.ts +10 -8
  431. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  432. package/dist/types/core/charts/pvm/types.d.ts +10 -1
  433. package/dist/types/core/charts/pyramid/types.d.ts +3 -1
  434. package/dist/types/core/charts/sankey/types.d.ts +5 -1
  435. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  436. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  437. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  438. package/dist/types/core/charts/status/layout.d.ts +3 -0
  439. package/dist/types/core/charts/table/resolve.d.ts +22 -3
  440. package/dist/types/core/charts/table/view.d.ts +24 -1
  441. package/dist/types/core/claims/browser.d.ts +2 -0
  442. package/dist/types/core/claims/ids.d.ts +38 -0
  443. package/dist/types/core/deferred.d.ts +1 -0
  444. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  445. package/dist/types/core/footer.d.ts +2 -0
  446. package/dist/types/core/formatSpec.d.ts +43 -14
  447. package/dist/types/core/frame.d.ts +26 -59
  448. package/dist/types/core/frameText.d.ts +203 -0
  449. package/dist/types/core/geo/types.d.ts +2 -0
  450. package/dist/types/core/geometry.d.ts +3 -1
  451. package/dist/types/core/label/categoryRow.d.ts +19 -2
  452. package/dist/types/core/label/solver.d.ts +23 -2
  453. package/dist/types/core/normalize/shared.d.ts +14 -2
  454. package/dist/types/core/notes.d.ts +15 -2
  455. package/dist/types/core/reading.d.ts +12 -1
  456. package/dist/types/core/registry.d.ts +4 -5
  457. package/dist/types/core/request.d.ts +7 -1
  458. package/dist/types/core/schema/capability.d.ts +32 -7
  459. package/dist/types/core/schema/generatedColumns.d.ts +168 -0
  460. package/dist/types/core/seriesIdentity.d.ts +4 -1
  461. package/dist/types/core/sizing.d.ts +32 -1
  462. package/dist/types/core/structureCounts.d.ts +3 -1
  463. package/dist/types/core/text.d.ts +16 -0
  464. package/dist/types/core/theme.d.ts +33 -4
  465. package/dist/types/core/themeGeometry.d.ts +9 -0
  466. package/dist/types/core/themeRules.d.ts +2 -0
  467. package/dist/types/core/timeAxis.d.ts +6 -1
  468. package/dist/types/core/types/annotations.d.ts +74 -4
  469. package/dist/types/core/types/diagram.d.ts +7 -0
  470. package/dist/types/core/types/options.d.ts +118 -15
  471. package/dist/types/core/types/scene.d.ts +30 -2
  472. package/dist/types/core/types/table.d.ts +27 -3
  473. package/dist/types/core/types/theme.d.ts +23 -0
  474. package/dist/types/index.d.ts +2 -0
  475. package/dist/types/react/TableChart.d.ts +5 -0
  476. package/dist/types/react/barrelCharts.d.ts +16 -5
  477. package/dist/types/react/charts/butterfly.d.ts +2 -2
  478. package/dist/types/react/charts/dot.d.ts +7 -1
  479. package/dist/types/react/charts/pareto.d.ts +4 -1
  480. package/dist/types/react/charts/variance.d.ts +3 -1
  481. package/dist/types/react/hover/labelCard.d.ts +11 -2
  482. package/dist/types/react/prepare.d.ts +7 -1
  483. package/dist/types/theme.d.ts +2 -0
  484. package/dist/validate.js +23 -6
  485. package/docs/TELEMETRY.md +2 -2
  486. package/docs/manual.md +283 -65
  487. package/docs/reference/bar.md +15 -4
  488. package/docs/reference/bartable.md +17 -2
  489. package/docs/reference/box.md +15 -4
  490. package/docs/reference/bullet.md +21 -6
  491. package/docs/reference/butterfly.md +17 -6
  492. package/docs/reference/choropleth.md +16 -5
  493. package/docs/reference/cohort.md +25 -5
  494. package/docs/reference/column.md +19 -4
  495. package/docs/reference/combo.md +11 -5
  496. package/docs/reference/creative.md +17 -8
  497. package/docs/reference/diagram.md +6 -1
  498. package/docs/reference/dimswitch.md +71 -118
  499. package/docs/reference/dot.md +16 -7
  500. package/docs/reference/fixtures.md +94 -1
  501. package/docs/reference/funnel.md +14 -5
  502. package/docs/reference/gantt.md +17 -16
  503. package/docs/reference/grid.md +13 -3
  504. package/docs/reference/heatmap.md +16 -6
  505. package/docs/reference/histogram.md +2 -2
  506. package/docs/reference/kpi.md +5 -1
  507. package/docs/reference/likert.md +17 -4
  508. package/docs/reference/line.md +18 -5
  509. package/docs/reference/mekko.md +10 -5
  510. package/docs/reference/options.md +20 -15
  511. package/docs/reference/pareto.md +9 -5
  512. package/docs/reference/pie.md +9 -5
  513. package/docs/reference/pvm.md +16 -6
  514. package/docs/reference/pyramid.md +14 -4
  515. package/docs/reference/react.md +6 -7
  516. package/docs/reference/sankey.md +7 -3
  517. package/docs/reference/scatter.md +8 -4
  518. package/docs/reference/slope.md +15 -5
  519. package/docs/reference/sparkline.md +1 -1
  520. package/docs/reference/status.md +7 -1
  521. package/docs/reference/table.md +41 -110
  522. package/docs/reference/theme.md +12 -4
  523. package/docs/reference/tilemap.md +2 -4
  524. package/docs/reference/treemap.md +1 -1
  525. package/docs/reference/variance.md +12 -6
  526. package/docs/reference/waffle.md +1 -1
  527. package/docs/reference/warnings.md +1077 -0
  528. package/docs/reference/waterfall.md +20 -5
  529. package/docs/use-cases.md +25 -13
  530. package/llms.txt +19 -6
  531. package/package.json +18 -3
  532. package/dist/chunk-6364WO5D.js +0 -47
  533. package/dist/chunk-DQ7YMQVX.js +0 -26
  534. package/dist/chunk-EBB4PYBN.js +0 -24
  535. package/dist/chunk-FG5L2LUK.js +0 -89
  536. package/dist/chunk-IFQN4GKK.js +0 -1852
  537. package/dist/chunk-IRXVV65V.js +0 -24
  538. package/dist/chunk-JGFHNAHS.js +0 -22
  539. package/dist/chunk-JHWYG7V5.js +0 -24
  540. package/dist/chunk-M4SPKUZE.js +0 -7
  541. package/dist/chunk-O36WX56O.js +0 -13
  542. package/dist/chunk-QJWLNP64.js +0 -24
  543. package/dist/chunk-QZIHKQRH.js +0 -26
  544. package/dist/chunk-SE7MJ2LQ.js +0 -24
  545. package/dist/chunk-TXBO2LWM.js +0 -25
  546. package/dist/chunk-UPTXFTKH.js +0 -25
  547. package/dist/chunk-UREXN6WG.js +0 -25
  548. package/dist/chunk-UZLR25BW.js +0 -24
  549. package/dist/chunk-WIVFIVFZ.js +0 -27
  550. package/dist/chunk-WZL4EEBS.js +0 -11
  551. package/dist/chunk-XHRUXZD7.js +0 -28
  552. package/dist/chunk-ZWNRLIFT.js +0 -24
@@ -108,9 +108,12 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
108
108
  | legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Segment, case and scenario encodings keep their key because numeric bar labels do not name them. With these encodings, 'none' retains the key and reports waterfall-legend-required. A plain bridge keys its sign colours only when a lowerIsBetter step inverts them. |
109
109
  | axisTitles | object | | | Authored primary value-axis title above the vertical plot, using column title styling. Waterfall draws no value ticks. Horizontal mode accepts this key but does not print it. |
110
110
  | axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
111
- | variant | string | `'vertical'`, `'horizontal'` | | Left out: vertical columns, turned into a horizontal bridge when the step names would rotate, shorten or drop, the horizontal bridge draws without a new finding, and the spec has no cases and no annotations. 'vertical' always keeps columns. A horizontal bridge draws no annotations: it suppresses them and warns horizontal-annotations-unsupported, so use vertical for annotations. |
111
+ | variant | string | `'vertical'`, `'horizontal'` | | Left out: vertical columns, turned into a horizontal bridge when the step names would rotate, shorten or drop, the horizontal bridge draws without a new finding, and the spec has no cases and no annotations. 'vertical' always keeps columns. A horizontal bridge draws no annotations: an old spec draws without them and warns option-ignored, so use vertical for annotations. |
112
112
  | build | string | `'up'`, `'down'` | `'up'` | Build label in the accessible description; defaults to up. Item types and signed values determine accumulation in both modes. |
113
113
  | signColor | boolean | | | Paint each plain step good or bad by sign × item direction, as column's signColor; zero is neutral. Default true unless the theme sets marks.bridge or a palette is named; false paints steps neutral. colorblindSafe paints signed steps, labels and key swatches with the theme's colour-blind pair. |
114
+ | bracketRow | string | `'shared'`, `'span'` | | Where the step brackets stand. 'shared' (default): all brackets of the bridge on one row, the lowest row that clears every bracketed span and its values. 'span': each bracket right above its own steps and their values. Either way a bracket moves to the top row where its seat is taken. |
115
+ | columnOverrides | object | | | Horizontal bridge only: width in px of the name band (label) and the value band (value). With variant 'vertical' it is refused. Left out, the variant is chosen without it, and a bridge that draws vertical warns option-ignored. |
116
+ | columnOverrides.*.width | number | | | Track width in px. It beats the width the type would pick. |
114
117
 
115
118
  Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `valueAxis.min`, `valueAxis.max`, `valueAxis.tickStep`, `valueAxis.includeZero`, `valueAxis.percent`, `valueAxis.log`, `valueAxis.reverse`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
116
119
 
@@ -120,14 +123,18 @@ An annotation anchor is a category or item id string, or an object with category
120
123
 
121
124
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
122
125
  |---|---|---|---|---|---|
123
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
124
- | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
125
- | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
126
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
127
+ | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
128
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | |
126
129
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
127
- | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. A thin arrow from the text to the anchored point; the first line sits level with the point, right or left of it, where there is room. Not with icon or status. Example: "arrow": true. | |
130
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | |
128
131
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
129
132
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
130
133
  | bracket | Draws a bracket over an inclusive span of steps and prints the sum of their values, after an optional label. | from, to | from: categoryId; to: categoryId | label: string. Name printed before the sum, "Commercial +81". Without it the bracket prints the sum alone. | from and to are step ids, inclusive. The engine adds the steps up and prints the signed sum; every step in the span must be a delta, so a span that holds a total is refused with bracket-span-total. A step the bridge cannot add (an open start) refuses it with bracket-span-no-value. Brackets stand in one row above the steps. Vertical bridges only. |
134
+ | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
135
+ | line | Draws a straight line between two points or from a text annotation, in the ink and rule width of a bracket; a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the line in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the line starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
136
+ | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
137
+ | box | Draws an unfilled box with two points as opposite corners, wrapping whole category bands, in the ink and rule width of a bracket; text inside the box stays free. | from, to | from: AnchorRef \| { categoryId, value }; to: AnchorRef \| { categoryId, value } | dashed: boolean, default false. Draws the edges in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. from and to are opposite corners, the box has no fill, and text inside it stays free. A { categoryId, value } corner spans that category's whole band, so the box wraps whole bars, values and markers; from and to on one category wrap that category. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
131
138
 
132
139
  ## Sizing
133
140
 
@@ -144,6 +151,10 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
144
151
  | interview-status-buildup | example | Interview pipeline build-up by status |
145
152
  | revenue-build-up | example | Revenue → EBIT build-up with diff arrow |
146
153
  | step-brackets | example | Brackets over bridge steps print their sums |
154
+ | step-brackets-span | example | bracketRow 'span' stands each bracket right above its own steps |
155
+ | total-change-bracket | example | The total change runs as the growth bracket over the step brackets |
156
+ | callout-label-offset | example | labelOffsets moves a callout up from its step |
157
+ | bracket-low-steps | example | A bracket stands directly above low steps |
147
158
  | build-down | example | Build-down: revenue to net income |
148
159
  | whole-axis-opt-out | example | Whole value axis kept with an explicit false |
149
160
  | automatic-axis-break | example | Explicit automatic break makes small steps on a large base easier to compare |
@@ -165,3 +176,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
165
176
  | two-case-budget-bars | example | The two-case bridge as bars: each value stands past the end of its own bar |
166
177
  | single-segment-authored-format | example | One segment prints one value at the authored precision |
167
178
  | repeated-segment-key | torture | Equal segment names and colours share one key |
179
+ | column-overrides | example | A horizontal bridge with authored name and value bands |
180
+ | centered-values | example | Centered bridge values with a thin falling step |
181
+ | horizontal-centered-values | example | Centered horizontal bridge values |
182
+ | sign-inside-values | example | Inside values on signed bridge fills |
package/docs/use-cases.md CHANGED
@@ -1,14 +1,16 @@
1
1
  # Use cases: Boardplot with an AI agent
2
2
 
3
+ Contents: [Install](#install), [PowerPoint or Keynote deck](#powerpoint-or-keynote-deck), [Analysis page or Claude artifact](#analysis-page-or-claude-artifact), [React dashboard](#react-dashboard), [Word or PDF report](#word-or-pdf-report), [Recurring report](#recurring-report).
4
+
3
5
  This page shows how to get finished results from an AI agent such as Claude Code or Codex with Boardplot: a slide deck, an analysis page, a React dashboard, a Word report or a weekly report. Install Boardplot once, then name it in the prompt. The agent writes the chart specs, draws the charts with the Boardplot tools and puts them into the result.
4
6
 
5
- Each use case has the same parts: what you get, example prompts to copy, what the agent does, tips for better results, and the limits. Each use case also links a worked example in [examples](https://github.com/boardplot/boardplot/tree/main/docs/examples): the data, the specs, the finished file and the script that builds it, all with invented data. The [manual](manual.md) explains the spec, the tools and every option.
7
+ Choose the destination section for settings and examples. The [worked examples](https://github.com/boardplot/boardplot/tree/main/docs/examples) include invented data, specs, finished files and build scripts. The [manual](manual.md) is a reference for questions about the spec and tool behavior.
6
8
 
7
9
  ## Install
8
10
 
9
11
  - **Claude Code and Codex:** install the plugin. It adds the Boardplot MCP server and the `boardplot-chart` skill. See [AI agents](../README.md#ai-agents) in the README.
10
- - **Other MCP clients:** install the package globally and add the stdio server `boardplot-mcp`. The same README section has the config.
11
- - **React apps:** add the package to the project. See [React](../README.md#react) in the README.
12
+ - **Other MCP clients:** install the package globally and add the stdio server `boardplot-mcp`. See [MCP setup](../README.md#ai-agents) for the configuration.
13
+ - **React apps:** follow [React installation](#react-installation).
12
14
 
13
15
  To check the install, start a new session and ask:
14
16
 
@@ -16,18 +18,28 @@ To check the install, start a new session and ask:
16
18
  Use Boardplot to draw a small column chart from sample data as PNG. Tell me the Boardplot version and the file path.
17
19
  ```
18
20
 
19
- The agent calls `boardplot_render`, writes the PNG and reports the version that every Boardplot tool returns. [The plugin setup](../release/plugin/boardplot-marketplace/plugins/boardplot/SETUP.md) has the full checks and the troubleshooting.
21
+ The agent calls `boardplot_render` and reports the output path and running version. Confirm that the requested PNG was produced. A rasterizer warning can accompany SVG fallback. [The plugin setup](../release/plugin/boardplot-marketplace/plugins/boardplot/SETUP.md) has the full checks and the troubleshooting.
20
22
 
21
23
  **Tips for every use case:**
22
24
 
23
- - **Give the data as a file.** Name a CSV or JSON export in the prompt, for example `data/orders.csv`. The agent passes the file to Boardplot as `rowsFile`, so the numbers go from the file to the chart and never pass through the model. See [Rows as data](manual.md#rows-as-data).
25
+ - **Give the data as a file.** Name a CSV or JSON export in the prompt, for example `data/orders.csv`. For a supported row mapping, the agent passes the file as `rowsFile`, so the numbers go directly into the chart. Other chart data shapes go in `spec.data`. See [Rows as data](manual.md#rows-as-data).
24
26
  - **Name the destination.** Say "for a slide", "for a Word report" or "for a dashboard". The agent then sets the `target`, which sets the type sizes for that medium. See [Sizing](manual.md#sizing).
25
27
  - **Give your brand colours.** Give the hex codes of your highlight and series colours, or a theme file. The agent passes them as a theme, for example `{ "preset": "standard", "overrides": { "color": { "highlight": "#0B5CAD" } } }`. See [the theme reference](reference/theme.md).
26
28
  - **Say what each chart should show.** A title that states the finding, such as "Online orders keep growing", gives a better chart than "Orders by week".
27
29
 
30
+ ### React installation
31
+
32
+ In an existing React project, install Boardplot:
33
+
34
+ ```sh
35
+ npm install boardplot
36
+ ```
37
+
38
+ Boardplot uses the project's React and React DOM dependencies. Import charts from their per-type entries, such as `boardplot/react/column`. The [React reference](reference/react.md) covers components, sizing and server preparation.
39
+
28
40
  ## PowerPoint or Keynote deck
29
41
 
30
- **You get:** a new deck with Boardplot charts, or your existing deck with its charts replaced by Boardplot charts.
42
+ **You get:** a new deck with Boardplot charts, or the requested chart changes in an existing deck.
31
43
 
32
44
  **Example prompts:**
33
45
 
@@ -46,9 +58,9 @@ Add a revenue bridge from FY24 to FY25 to slide 4 of strategy.pptx, drawn with B
46
58
  **What the agent does:** Boardplot draws the chart images, and the agent's own PowerPoint tool, such as a pptx skill or a Python library, places them in the file. For each chart, the agent:
47
59
 
48
60
  1. Reads the data from your file, or from the chart it replaces.
49
- 2. Calls `boardplot_describe` for the chart type and writes the spec.
61
+ 2. Writes the spec, using `boardplot_describe` when the chart contract is unfamiliar.
50
62
  3. Calls `boardplot_render` with `target: "slide"`, `format: "png"` and the size of the picture box, for example `options.size: { "width": 660, "height": 372, "unit": "pt" }`.
51
- 4. Places the PNG in the picture box.
63
+ 4. Checks `ok`, warnings and the returned format, then places the chart in the picture box. A PNG request can return SVG when a rasterizer is unavailable. See [PNG output](manual.md#png-output).
52
64
 
53
65
  The PNG has 2 pixels per layout pixel, the default `scale`, and records 192 dpi. PowerPoint, Keynote and Word read the dpi, so they place a scale-2 PNG at the chart's own size, with sharp text. Without a size, a `slide` chart is 888 × 396 pt, the content area of a 16:9 slide.
54
66
 
@@ -88,7 +100,7 @@ Write a one-page HTML report on last month's marketing spend from exports/spend.
88
100
  **What the agent does:**
89
101
 
90
102
  1. Analyses the data and decides which finding each chart shows.
91
- 2. Calls `boardplot_render` with the data file as `rowsFile` and `return: ["reading", "svg"]`. The answer carries the chart's SVG markup in `svg`.
103
+ 2. Calls `boardplot_render` with `return: ["reading", "svg"]`. Uses `rowsFile` when the chart supports the file's row mapping, or supplies `spec.data`. The answer carries the chart's SVG markup in `svg`.
92
104
  3. Puts each SVG inline in the page. The page needs no script and loads nothing from the network to show the charts.
93
105
  4. Reads the `reading` of each render, the numbers Boardplot computed (totals, differences, growth rates), and uses them in the text, so text and chart agree.
94
106
 
@@ -123,7 +135,7 @@ Move the charts of this dashboard from our current chart library to Boardplot. K
123
135
 
124
136
  **What the agent does:**
125
137
 
126
- 1. Calls `boardplot_list` and `boardplot_describe` to choose the chart types and their options.
138
+ 1. Chooses chart types from the requested result. Calls `boardplot_list` when the type is uncertain and `boardplot_describe` when its fields are unfamiliar.
127
139
  2. Uses the per-type components, such as `ColumnChart` from `boardplot/react/column`, with `size="container"`, so each chart lays out in its card.
128
140
  3. Wraps the page in `BoardplotTheme` with `target="dashboard"` and your theme, so every chart shares one look.
129
141
  4. In Next.js, prepares the charts on the server with `prepareChart`, so the first paint shows the chart.
@@ -132,7 +144,7 @@ The [React reference](reference/react.md) has each part: [per-type components](r
132
144
 
133
145
  **Tips:**
134
146
 
135
- - Ask the agent to draw each chart once with `boardplot_render` before it writes the component. A refusal or a warning then shows up before the page is built.
147
+ - Inspect the component's refusals and warnings in the rendered page. MCP can check a standalone spec when needed. A separate MCP render is not required to build a React chart.
136
148
  - Name the chart for each card if you know it, for example "a waterfall for the margin bridge".
137
149
  - When you move a dashboard, ask the agent to list each old chart with the Boardplot type it chose.
138
150
 
@@ -191,7 +203,7 @@ Every Monday, read exports/orders.csv and write the weekly business review with
191
203
  Write a script that renders the charts in reports/specs/ from the latest exports with the Boardplot CLI, so our scheduled job can run it without an agent.
192
204
  ```
193
205
 
194
- **What the agent does:** in the first run, the agent writes one spec per chart and saves it as a template, without data. In each later run, it calls `boardplot_render` with the template, the new export as `rowsFile` and the column names in `columns`. A refused call has `ok: false` and errors with a `path`, a `suggest` sentence and often a `fix`, a JSON Patch the agent applies to the spec. See [Reading errors and warnings](manual.md#reading-errors-and-warnings).
206
+ **What the agent does:** for charts with a supported row mapping, save one spec template per chart. Keep required metadata such as map packs, table columns and series labels. In each later run, call `boardplot_render` with the template, the new export as `rowsFile` and the source column names in `columns`. A refused render returns `ok: false` and errors with a `path` and, when available, a `suggest` or `fix`. Apply spec repairs to the spec and argument repairs to the tool arguments. A file-row error points to `/rowsFile` and identifies its source cell in `displayPath`. Edit that cell in the data file. See [Reading errors and warnings](manual.md#reading-errors-and-warnings).
195
207
 
196
208
  A scheduled job needs no agent. It runs the CLI on the same templates:
197
209
 
@@ -213,7 +225,7 @@ It writes `out/<date>/weekly-orders.png`, named after the template's `name`, and
213
225
  **Limits:**
214
226
 
215
227
  - The MCP server reads `rowsFile` only from its allowed folders: the client's roots, its working directory, the system temp folder and the folders in `BOARDPLOT_ROWS_ROOTS`. Other paths are refused with `rows-outside-roots`.
216
- - PNG needs `@resvg/resvg-js`, an optional dependency, or Chrome. On a Linux server, install one of the fonts the manual lists, or the render returns only the SVG with the warning `raster-fonts-missing`. See [Getting a chart with MCP](manual.md#getting-a-chart-with-mcp).
228
+ - PNG needs `@resvg/resvg-js`, an optional dependency, or Chrome. On Linux, resvg also needs one of the fonts listed in the manual. Without those fonts, Boardplot tries Chrome. If Chrome is unavailable too, the render returns SVG with `raster-fonts-missing`. See [PNG output](manual.md#png-output).
217
229
  - A CSV with grouping marks in numbers, such as `1.234,5`, is refused. Export plain numbers.
218
230
 
219
231
  **Worked example:** [docs/examples/recurring-report](https://github.com/boardplot/boardplot/tree/main/docs/examples/recurring-report) is a weekly business review. `render.sh`, the CLI script for a scheduled job, draws three templates from three warehouse exports, including a table that computes the week-on-week, year-on-year and plan changes, and writes one page to send.
package/llms.txt CHANGED
@@ -1,13 +1,26 @@
1
1
  # Boardplot
2
2
 
3
- > Boardplot draws consulting-grade charts as deterministic SVG and as React components. An AI agent drives it through six MCP tools, a JSON-in JSON-out CLI or React code.
3
+ > Boardplot draws consulting-grade business charts, tables and maps as SVG or PNG, and provides responsive React components. Use its six MCP tools, CLI or React package. The local runtime needs Node.js 22.12 or newer. PowerPoint receives a chart image, with no editable chart data.
4
4
 
5
- Every chart is one spec, `{ "type", "data", "options", "annotations", "theme" }`, of which `type` and `data` are required. The MCP tools are `boardplot_list`, `boardplot_describe`, `boardplot_render`, `boardplot_measure`, `boardplot_fixtures` and `boardplot_feedback`; the CLI verbs of the same names take the same JSON. Render and measure read a query result from a local JSON or CSV file through `rowsFile` and `columns`, so its numbers never pass through the model; `boardplot_describe` with `path` answers one field.
5
+ ## MCP start
6
6
 
7
- ## Start here
7
+ A chart spec has required `type` and `data` fields and optional `name`, `options`, `annotations` and `theme` fields. Pass a valid spec directly to `boardplot_render`. Check `ok`, `warnings`, `reading` and the actual output format before using the result.
8
8
 
9
- - [Manual](docs/manual.md): the spec, the tools, the CLI, React, targets and sizing, errors and themes
10
- - [Use cases](docs/use-cases.md): example prompts and agent steps for a slide deck, an analysis page, a React dashboard, a Word or PDF report and a recurring report
9
+ - Known chart type: `boardplot_describe` returns its compact contract and a working example. Use `path` for any field that needs more detail. `detail: "full"` adds complete descriptions of the own fields of the type.
10
+ - Unknown chart type: `boardplot_list` lists the available types and use cases.
11
+ - Example needed: `boardplot_fixtures` with `type` and `id` returns one runnable spec. Listings are paginated; pass `nextCursor` as `cursor` with the same filters.
12
+ - Fixed container: `boardplot_measure` reports the size the spec needs at the requested width.
13
+ - Boardplot defect: `boardplot_feedback` drafts a report for the user to review and submit.
14
+
15
+ For supported row mappings, render and measure accept a local file through `rowsFile` and `columns`, or inline `rows`. The file route reads source numbers directly. The six MCP tools have corresponding CLI commands without the `boardplot_` prefix. CLI commands use positional arguments and flags.
16
+
17
+ ## Task guides
18
+
19
+ - [MCP example](docs/manual.md#getting-a-chart-with-mcp): a working call and output handling
20
+ - [Rows as data](docs/manual.md#rows-as-data): source files, column mapping and supported chart types
21
+ - [Sizing](docs/manual.md#sizing): targets, units and container dimensions
22
+ - [Use cases](docs/use-cases.md): slide decks, analysis pages, React dashboards, Word or PDF reports and recurring reports
23
+ - [CLI](docs/manual.md#getting-a-chart-with-the-cli): command arguments and file output
11
24
 
12
25
  ## Chart references
13
26
 
@@ -51,7 +64,7 @@ Every chart is one spec, `{ "type", "data", "options", "annotations", "theme" }`
51
64
 
52
65
  ## Optional
53
66
 
54
- - [Shared options](docs/reference/options.md): options every type accepts, the value cell and annotation anchors
67
+ - [Shared options](docs/reference/options.md): common options, type-specific exceptions, value cells and annotation anchors
55
68
  - [Theme](docs/reference/theme.md): presets, every token and the theme errors
56
69
  - [React](docs/reference/react.md): BoardplotChart and the per-type components, container sizing, server preparation, export
57
70
  - [Fixtures](docs/reference/fixtures.md): every runnable example by type
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "boardplot",
3
- "version": "0.56.0",
4
- "description": "Consulting-grade charts for AI agents and React: one JSON spec gives a deterministic SVG, PNG or React chart.",
3
+ "version": "0.58.0",
4
+ "description": "Consulting-grade waterfall, Mekko (Marimekko) and variance charts and management tables for slides, reports and dashboards. Use it through Claude Code, Codex or other MCP agents, or as responsive React components with tooltips. Open source, Apache-2.0.",
5
5
  "mcpName": "io.github.boardplot/boardplot",
6
6
  "type": "module",
7
7
  "license": "Apache-2.0",
@@ -21,8 +21,21 @@
21
21
  "typescript",
22
22
  "data-visualization",
23
23
  "business-charts",
24
+ "dashboard",
25
+ "powerpoint",
26
+ "presentation",
27
+ "slides",
28
+ "reporting",
29
+ "variance-chart",
24
30
  "waterfall",
31
+ "waterfall-chart",
32
+ "bridge-chart",
25
33
  "mekko",
34
+ "mekko-chart",
35
+ "marimekko",
36
+ "marimekko-chart",
37
+ "tooltips",
38
+ "responsive",
26
39
  "table",
27
40
  "mcp",
28
41
  "mcp-server",
@@ -366,6 +379,7 @@
366
379
  "prepack": "npm run build",
367
380
  "smoke:package": "node scripts/package-smoke.mjs",
368
381
  "check:scorecard": "tsx scripts/layout-scorecard.mjs",
382
+ "check:generated": "tsx scripts/generated-specs.mjs",
369
383
  "smoke:next": "node scripts/next-smoke.mjs",
370
384
  "generate:chart-entries": "node scripts/generate-chart-entries.mjs",
371
385
  "check:chart-entries": "node scripts/generate-chart-entries.mjs --check",
@@ -375,7 +389,8 @@
375
389
  "version": "node scripts/plugin-version.mjs --stage",
376
390
  "eval:tokens": "tsx evals/tokens.ts",
377
391
  "gallery": "node scripts/gallery.mjs",
378
- "check:ci": "node scripts/check-manual.mjs && node scripts/check-doc-anchors.mjs && npm run check:font-metrics && npm run check:chart-entries && npm run check:choropleth-fixtures && npm run check:plugin-version && npm run eval:tokens",
392
+ "check:warning-codes": "tsx scripts/warning-codes.mjs --check",
393
+ "check:ci": "node scripts/check-manual.mjs && node scripts/check-doc-anchors.mjs && npm run check:warning-codes && npm run check:font-metrics && npm run check:chart-entries && npm run check:choropleth-fixtures && npm run check:plugin-version && npm run eval:tokens",
379
394
  "explorer": "tsx scripts/explorer/build.mjs"
380
395
  },
381
396
  "peerDependencies": {
@@ -1,47 +0,0 @@
1
- import {
2
- SIZE_TOLERANCE,
3
- heightOmitted
4
- } from "./chunk-T2CYNDYU.js";
5
- import {
6
- zeroLifts
7
- } from "./chunk-MSYTF3DZ.js";
8
- import {
9
- TARGET_SIZE
10
- } from "./chunk-YOOHNQ3L.js";
11
-
12
- // src/core/charts/tableFit.ts
13
- function liftOrFallback(layoutAs, costs, lifted = !1, plainDraws = costs) {
14
- let before = zeroLifts.count, full = layoutAs("full");
15
- if (!lifted && zeroLifts.count === before) return full;
16
- let plain = layoutAs("none");
17
- if (!costs(full, plain)) return full;
18
- let compact = layoutAs("compact");
19
- return plainDraws(compact, plain) ? plain : compact;
20
- }
21
- function missesSize(geometry, options) {
22
- let open = options[TARGET_SIZE]?.fixed;
23
- return {
24
- width: open?.width !== !1 && geometry.size.width + SIZE_TOLERANCE < (geometry.sizing?.minWidth ?? 0),
25
- height: open?.height !== !1 && !heightOmitted(options.size) && geometry.size.height + SIZE_TOLERANCE < (geometry.sizing?.minHeight ?? 0)
26
- };
27
- }
28
- function tightSpacingWarning(misses, reduced, subject, spacing, geometry, options) {
29
- let value = {
30
- width: Math.ceil(Math.max(geometry.size.width, geometry.sizing.minWidth)),
31
- ...heightOmitted(options.size) ? {} : { height: Math.ceil(Math.max(geometry.size.height, geometry.sizing.minHeight)) }
32
- }, need = value.height === void 0 ? `${value.width} px of width` : `${value.width} \xD7 ${value.height} px`;
33
- return {
34
- code: "table-tight-spacing",
35
- severity: "warn",
36
- message: `${[misses.width ? reduced.width : "", misses.height ? reduced.height : ""].filter(Boolean).join(" and ").replace(/^./, (c) => c.toUpperCase())} were reduced to fit ${subject}; ${spacing} spacing needs ${need}.`,
37
- suggest: `Give the table ${need} for ${spacing} spacing.`,
38
- field: ["options", "size"],
39
- fix: [{ op: "replace", path: "/options/size", value }]
40
- };
41
- }
42
-
43
- export {
44
- liftOrFallback,
45
- missesSize,
46
- tightSpacingWarning
47
- };
@@ -1,26 +0,0 @@
1
- import {
2
- sharedKeys1,
3
- sharedKeys10,
4
- sharedKeys2,
5
- sharedKeys5,
6
- sharedKeys9
7
- } from "./chunk-O36WX56O.js";
8
- import {
9
- optionKeyCheck
10
- } from "./chunk-N5HN5QGH.js";
11
- import {
12
- createChartComponent
13
- } from "./chunk-SS4YGK3E.js";
14
- import {
15
- lineCore
16
- } from "./chunk-T2YDWT54.js";
17
- import {
18
- registeredType
19
- } from "./chunk-52WNCUIN.js";
20
-
21
- // src/react/charts/line.ts
22
- var checkOptionKeys = optionKeyCheck({ tree: { target: 0, textScale: 0, textSize: 0, a11y: { title: 0, description: 0, table: 0 }, mode: 0, belowMinimum: 0, size: { width: 0, height: 0, unit: 0 }, embed: { width: 0 }, margin: { top: 0, right: 0, bottom: 0, left: 0 }, canvas: { margin: { top: 0, right: 0, bottom: 0, left: 0 } }, title: 0, subtitle: { company: 0, measure: 0, period: 0, scenarios: 0 }, unit: 0, unitShown: 0, source: 0, footnotes: 0, notes: { maxListed: 0, placement: 0, maxLines: 0, show: 0, pointer: 0 }, theme: { preset: 0, overrides: 0 }, locale: { language: 0, decimal: 0, thousands: 0, minusGlyph: 0, weekStartsOn: 0 }, strings: sharedKeys10, format: 0, detailFields: { "[]": { key: 0, label: 0, format: 0, unit: 0 } }, smallValues: 0, palette: 0, labelDensity: 0, labels: 0, labelPlacements: 0, legend: { position: 0, order: 0 }, valueAxis: { show: 0, min: 0, max: 0, tickStep: 0, includeZero: 0, percent: 0, log: 0, reverse: 0, gridlines: 0 }, categoryAxis: { crossesBetween: 0, dateTicks: 0 }, scaleGroup: { y: 0, id: 0 }, highlight: 0, story: { steps: { "[]": { id: 0, title: 0, body: 0, highlight: 0 } }, step: 0 }, focus: sharedKeys5, hatchStrength: 0, colorblindSafe: 0, rounding: 0, interactive: 0, annotations: sharedKeys9, trend: { label: 0 }, window: { last: 0, decimate: 0, maxPoints: 0 }, viewDomain: { x: 0 }, xAxis: { type: 0, zone: 0, min: 0, max: 0, tickStep: { unit: 0, step: 0 }, ticks: { "[]": { value: 0, label: 0 } }, format: 0, title: 0, unit: 0, maxTicks: 0 }, anomaly: { method: 0, k: 0, baseline: 0, label: 0, low: 0, high: 0 }, events: sharedKeys1, axisTitles: { primary: 0 }, endLabelPlacement: 0, variant: 0, bump: { direction: 0, focus: 0 }, seriesLabels: { only: 0 }, valueLabels: 0, latestPoint: { series: 0, marker: 0 }, emphasis: 0, othersShade: 0, highlightMode: 0, scenarioStyle: { "*": { width: 0, ink: 0 } }, rebase100: { at: 0 }, ratioTier: sharedKeys2, interpolate: 0, phases: { "[]": { id: 0, label: 0, from: 0, to: 0, tone: 0, rank: 0 } }, gapFill: { between: 0, positiveTone: 0, negativeTone: 0 }, fan: { of: 0, bands: { "[]": { low: 0, high: 0, label: 0 } }, showBounds: 0 }, targets: { "[]": { at: 0, value: 0, label: 0, seriesId: 0 } }, methodNote: 0, referenceBands: { "[]": { id: 0, value: 0, low: 0, high: 0, label: 0, description: 0 } } }, labels: ["category", "series", "point", "restSeries", "percentIndicator", "axisTitle"] }), LineChart = createChartComponent(registeredType(lineCore), checkOptionKeys);
23
-
24
- export {
25
- LineChart
26
- };
@@ -1,24 +0,0 @@
1
- import {
2
- sharedKeys10,
3
- sharedKeys5,
4
- sharedKeys9
5
- } from "./chunk-O36WX56O.js";
6
- import {
7
- optionKeyCheck
8
- } from "./chunk-N5HN5QGH.js";
9
- import {
10
- createChartComponent
11
- } from "./chunk-SS4YGK3E.js";
12
- import {
13
- scatterCore
14
- } from "./chunk-KBJMLXNW.js";
15
- import {
16
- registeredType
17
- } from "./chunk-52WNCUIN.js";
18
-
19
- // src/react/charts/scatter.ts
20
- var checkOptionKeys = optionKeyCheck({ tree: { target: 0, textScale: 0, textSize: 0, a11y: { title: 0, description: 0, table: 0 }, mode: 0, belowMinimum: 0, size: { width: 0, height: 0, unit: 0 }, embed: { width: 0 }, margin: { top: 0, right: 0, bottom: 0, left: 0 }, canvas: { margin: { top: 0, right: 0, bottom: 0, left: 0 } }, title: 0, subtitle: { company: 0, measure: 0, period: 0, scenarios: 0 }, unit: 0, unitShown: 0, source: 0, footnotes: 0, notes: { maxListed: 0, placement: 0, maxLines: 0, show: 0, pointer: 0 }, theme: { preset: 0, overrides: 0 }, locale: { language: 0, decimal: 0, thousands: 0, minusGlyph: 0, weekStartsOn: 0 }, strings: sharedKeys10, format: 0, smallValues: 0, palette: 0, labelDensity: 0, labels: { value: 0, "*": 0 }, labelPlacements: 0, legend: { position: 0, order: 0 }, valueAxis: { show: 0, min: 0, max: 0, tickStep: 0, includeZero: 0, percent: 0, log: 0, reverse: 0, gridlines: 0, clamp: { min: 0, max: 0, x: { min: 0, max: 0 }, y: { min: 0, max: 0 } } }, scaleGroup: { y: 0, id: 0 }, highlight: 0, story: { steps: { "[]": { id: 0, title: 0, body: 0, highlight: 0 } }, step: 0 }, focus: sharedKeys5, colorblindSafe: 0, interactive: 0, annotations: sharedKeys9, viewDomain: { x: 0, y: 0 }, axisTitles: { x: 0, y: 0 }, axisFormat: { x: 0, y: 0 }, minCount: 0, sizeBy: 0, maxPointLabels: 0, quadrants: { x: { stat: 0 }, y: { stat: 0 }, labels: { tl: 0, tr: 0, bl: 0, br: 0 }, tint: 0, captionPlacement: 0, axisNames: { x: 0, y: 0 } }, zones: { grid: { x: 0, y: 0, cells: { "[]": { id: 0, column: 0, row: 0, label: 0, tone: 0, labelAt: 0, a11y: 0 } }, xLabels: 0, yLabels: 0 }, regions: { "[]": { id: 0, points: { "[]": { x: 0, y: 0 } }, smooth: 0, label: 0, tone: 0, labelAt: 0, a11y: 0 } } }, trend: { groups: 0, label: 0 }, frontier: { x: 0, y: 0, label: 0, extend: 0, groups: 0 }, sizeLegend: { values: 0, label: 0 }, qualitativeAxes: 0, methodNote: 0 }, labels: ["point", "value"] }), ScatterChart = createChartComponent(registeredType(scatterCore), checkOptionKeys);
21
-
22
- export {
23
- ScatterChart
24
- };
@@ -1,89 +0,0 @@
1
- import {
2
- chartTypeAliases,
3
- schemaLoaders
4
- } from "./chunk-MD6DCQMA.js";
5
- import {
6
- registeredType
7
- } from "./chunk-52WNCUIN.js";
8
- import {
9
- caseInsensitiveValue,
10
- getChart,
11
- getChartSchemas,
12
- registerChartSchemas
13
- } from "./chunk-T2CYNDYU.js";
14
- import {
15
- registerChartCoreLoader
16
- } from "./chunk-DRHQG44U.js";
17
-
18
- // src/react/coreLoaders.ts
19
- var coreLoaders = {
20
- bar: () => import("./core-7Y5BZZON.js").then((module) => module.barCore),
21
- bartable: () => import("./core-DFZMOO7E.js").then((module) => module.bartableCore),
22
- box: () => import("./core-BLHEJ5OK.js").then((module) => module.boxCore),
23
- bullet: () => import("./core-WJNK7F2J.js").then((module) => module.bulletCore),
24
- butterfly: () => import("./core-TKZZZ6UW.js").then((module) => module.butterflyCore),
25
- choropleth: () => import("./core-E2XOSHPR.js").then((module) => module.choroplethCore),
26
- cohort: () => import("./core-LGJZUP6H.js").then((module) => module.cohortCore),
27
- column: () => import("./core-AR2T32Y3.js").then((module) => module.columnCore),
28
- combo: () => import("./core-BBNY2BX4.js").then((module) => module.comboCore),
29
- creative: () => import("./core-ILPXXC2Z.js").then((module) => module.creativeCore),
30
- diagram: () => import("./core-JDFUZFRH.js").then((module) => module.diagramCore),
31
- dimswitch: () => import("./core-5UF44NDI.js").then((module) => module.dimswitchCore),
32
- dot: () => import("./core-MU4ALRR7.js").then((module) => module.dotCore),
33
- funnel: () => import("./core-3KLQSYWB.js").then((module) => module.funnelCore),
34
- gantt: () => import("./core-ZLSQHZ3I.js").then((module) => module.ganttCore),
35
- grid: () => import("./core-RR2CAZC5.js").then((module) => module.gridCore),
36
- heatmap: () => import("./core-HDNWVLJW.js").then((module) => module.heatmapCore),
37
- histogram: () => import("./core-GLOZY6Z7.js").then((module) => module.histogramCore),
38
- kpi: () => import("./core-HTD5RHE7.js").then((module) => module.kpiCore),
39
- likert: () => import("./core-J2JD5ODO.js").then((module) => module.likertCore),
40
- line: () => import("./core-7S3XMW5O.js").then((module) => module.lineCore),
41
- mekko: () => import("./core-DD62MWEW.js").then((module) => module.mekkoCore),
42
- pareto: () => import("./core-K3JX5WPM.js").then((module) => module.paretoCore),
43
- pie: () => import("./core-A5AKUB7H.js").then((module) => module.pieCore),
44
- pvm: () => import("./core-GSILPKUR.js").then((module) => module.pvmCore),
45
- pyramid: () => import("./core-XW7UJFJZ.js").then((module) => module.pyramidCore),
46
- sankey: () => import("./core-LB5M7XL4.js").then((module) => module.sankeyCore),
47
- scatter: () => import("./core-H5HO2CED.js").then((module) => module.scatterCore),
48
- slope: () => import("./core-QPSAYRFT.js").then((module) => module.slopeCore),
49
- sparkline: () => import("./core-WZ4CHVYL.js").then((module) => module.sparklineCore),
50
- status: () => import("./core-TCSW24N6.js").then((module) => module.statusCore),
51
- table: () => import("./core-YMXYUGF5.js").then((module) => module.tableCore),
52
- tilemap: () => import("./core-BOG33BFD.js").then((module) => module.tilemapCore),
53
- treemap: () => import("./core-4RR6VSXM.js").then((module) => module.treemapCore),
54
- variance: () => import("./core-VKZSQFRG.js").then((module) => module.varianceCore),
55
- waffle: () => import("./core-4HFVG4CP.js").then((module) => module.waffleCore),
56
- waterfall: () => import("./core-G3LXHW73.js").then((module) => module.waterfallCore)
57
- };
58
-
59
- // src/react/loadChartTypes.ts
60
- var aliasOwners = /* @__PURE__ */ new Map();
61
- for (let [type, aliases] of Object.entries(chartTypeAliases))
62
- for (let alias of aliases) aliasOwners.set(alias, type);
63
- function knownChartType(name) {
64
- return name = caseInsensitiveValue(name, [...Object.keys(coreLoaders), ...aliasOwners.keys()]) ?? name, Object.hasOwn(coreLoaders, name) ? name : aliasOwners.get(name);
65
- }
66
- async function loadChartTypes(names, parts) {
67
- let types = [...new Set(names.map(knownChartType).filter((type) => type !== void 0))];
68
- await Promise.all(types.flatMap((type) => [
69
- parts.schemas && getChartSchemas(type) === void 0 ? schemaLoaders[type]().then((schemas) => {
70
- registerChartSchemas(schemas, chartTypeAliases[type]);
71
- }) : void 0,
72
- parts.cores && getChart(type) === void 0 ? coreLoaders[type]().then((core) => {
73
- registeredType(core);
74
- }) : void 0
75
- ]));
76
- }
77
- registerChartCoreLoader({
78
- knows: (type) => knownChartType(type) !== void 0,
79
- load: (type) => loadChartTypes([type], { schemas: !1, cores: !0 })
80
- });
81
- function registeredTypeWithPanelCores(core) {
82
- return registeredType(core);
83
- }
84
-
85
- export {
86
- knownChartType,
87
- loadChartTypes,
88
- registeredTypeWithPanelCores
89
- };