boardplot 0.53.0 → 0.54.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 (340) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +11 -10
  3. package/dist/{ReaderBox-VOJSJ66R.js → ReaderBox-YXC5XK7D.js} +4 -3
  4. package/dist/{annotateEngine-DLMFJZ67.js → annotateEngine-5O3IRSQL.js} +3 -1
  5. package/dist/build-identity.json +3 -3
  6. package/dist/{chunk-7X2ZYVAX.js → chunk-23RWLBZF.js} +1 -1
  7. package/dist/{chunk-MF6IVSBJ.js → chunk-26P4WRQC.js} +1 -1
  8. package/dist/{chunk-ZQF34VPS.js → chunk-2DR5MMDY.js} +2 -2
  9. package/dist/{chunk-K3HSQPSM.js → chunk-2HXKW6U6.js} +3 -3
  10. package/dist/{chunk-NKIYLFXZ.js → chunk-2IXDYW6O.js} +23 -21
  11. package/dist/{chunk-TGK6KUGN.js → chunk-2THWIKRB.js} +3 -3
  12. package/dist/{chunk-2ND7ZITT.js → chunk-32X7JGH3.js} +9 -9
  13. package/dist/{chunk-RA66JA3D.js → chunk-35ZTANEK.js} +3 -3
  14. package/dist/{chunk-MIAPBQCA.js → chunk-3CLLHMFF.js} +3 -3
  15. package/dist/{chunk-P6KZIZDV.js → chunk-3FNY7ZCG.js} +8 -8
  16. package/dist/{chunk-QO6HEXIZ.js → chunk-3P4PJJND.js} +4 -4
  17. package/dist/{chunk-NOSDEJ3K.js → chunk-3RMTPAEJ.js} +2 -2
  18. package/dist/{chunk-XJI6SWFS.js → chunk-3UBTO342.js} +3 -3
  19. package/dist/{chunk-QTZVVZ2A.js → chunk-3V7AA3IZ.js} +1 -1
  20. package/dist/{chunk-VKQNDOAI.js → chunk-43OQ26TL.js} +10 -6
  21. package/dist/{chunk-TKOJZQAJ.js → chunk-46ZPFJAM.js} +3 -3
  22. package/dist/{chunk-5LYXD6ME.js → chunk-47BO6MYI.js} +8 -8
  23. package/dist/{chunk-N23YFPPI.js → chunk-4FFCIQDG.js} +1 -1
  24. package/dist/{chunk-DIHUGBZO.js → chunk-4MREJWRM.js} +1 -1
  25. package/dist/{chunk-TXS3U77A.js → chunk-4TPHMIE5.js} +2 -2
  26. package/dist/{chunk-HA4IPWMM.js → chunk-4WK3CNW5.js} +12 -5
  27. package/dist/{chunk-LIWLBLCT.js → chunk-4WQ2MBE7.js} +1 -1
  28. package/dist/chunk-4ZGN4ZUN.js +164 -0
  29. package/dist/{chunk-UB6ODJHO.js → chunk-5A6MO4AR.js} +1 -1
  30. package/dist/{chunk-GCBOHVDZ.js → chunk-5PCCSSII.js} +1 -1
  31. package/dist/{chunk-IL5T7I2A.js → chunk-5SJQOPL7.js} +2 -2
  32. package/dist/{chunk-7CTKTIPF.js → chunk-6BJQULXR.js} +7 -7
  33. package/dist/{chunk-I6VAWNNU.js → chunk-6BWSF5PS.js} +3 -3
  34. package/dist/{chunk-BWGRWGVA.js → chunk-6I7YZTY7.js} +3 -11
  35. package/dist/{chunk-3XHJHQWU.js → chunk-6K2TMVPF.js} +1 -1
  36. package/dist/{chunk-SDSONLMZ.js → chunk-6NLH6TEP.js} +6 -6
  37. package/dist/{chunk-M4EUXOLU.js → chunk-6TJDWMZV.js} +1 -1
  38. package/dist/{chunk-BMRD6MAH.js → chunk-6ZXMA4TY.js} +3 -3
  39. package/dist/{chunk-2L2Q53EP.js → chunk-7EOLHBI6.js} +1 -1
  40. package/dist/{chunk-QOIVXZUF.js → chunk-7HFUG25L.js} +3 -3
  41. package/dist/{chunk-FG6EDGMI.js → chunk-7JQAUJOL.js} +1 -1
  42. package/dist/{chunk-DRW6KGBK.js → chunk-7NWFKHSG.js} +14 -14
  43. package/dist/{chunk-UBZXQIDR.js → chunk-7R5EV5MS.js} +3 -3
  44. package/dist/{chunk-ADKCLH3Z.js → chunk-7X3UZM7F.js} +1 -1
  45. package/dist/{chunk-H63XQ3OO.js → chunk-A5TY7H5T.js} +2 -2
  46. package/dist/{chunk-EUADDXAV.js → chunk-AA4U62G6.js} +2 -2
  47. package/dist/{chunk-WI5ITCOH.js → chunk-AJHYXD5U.js} +2 -2
  48. package/dist/{chunk-VERLFNWR.js → chunk-ATUZTGZI.js} +3 -3
  49. package/dist/{chunk-PEUSKIFV.js → chunk-AVMKRVNP.js} +1 -1
  50. package/dist/{chunk-323YZWYJ.js → chunk-AZIRTSVP.js} +6 -6
  51. package/dist/{chunk-CWDHCSL2.js → chunk-B3F4TS3V.js} +44 -18
  52. package/dist/{chunk-DCCJRLAJ.js → chunk-B6LHZLLK.js} +5 -0
  53. package/dist/{chunk-4RRNJLCM.js → chunk-BRPOSOK5.js} +14 -8
  54. package/dist/{chunk-XN4ARQ2W.js → chunk-BXEM2CVW.js} +1 -1
  55. package/dist/{chunk-ILSXT6KT.js → chunk-BYD7VLAI.js} +3 -3
  56. package/dist/{chunk-B67K6OWJ.js → chunk-C3O45JWU.js} +1 -1
  57. package/dist/{chunk-NCB3YLHF.js → chunk-CEY646NZ.js} +4 -4
  58. package/dist/{chunk-JSEYUJUQ.js → chunk-CICWSCLC.js} +12 -12
  59. package/dist/{chunk-N7J7CZS6.js → chunk-CPKHL7FK.js} +1 -1
  60. package/dist/{chunk-ZNHFLJSY.js → chunk-D3D7XHBI.js} +2 -2
  61. package/dist/{chunk-OUEGGWH7.js → chunk-D7GZPMHW.js} +3 -3
  62. package/dist/{chunk-3A2IEBCN.js → chunk-DHWCFQNO.js} +2 -2
  63. package/dist/{chunk-KZS46KDY.js → chunk-DSZUV3TM.js} +2 -2
  64. package/dist/{chunk-6OCR6ITN.js → chunk-E42JZ2DA.js} +1 -1
  65. package/dist/{chunk-BPKXEMRE.js → chunk-E64MTTBC.js} +1 -1
  66. package/dist/{chunk-DCTCUZ5L.js → chunk-EHDWWFNV.js} +1 -1
  67. package/dist/{chunk-BWLOXQDV.js → chunk-ELPQZIGR.js} +12 -9
  68. package/dist/{chunk-N3TPMXS3.js → chunk-ENOCOA3F.js} +2 -2
  69. package/dist/{chunk-2WNYRWHG.js → chunk-EP54VZI5.js} +1 -1
  70. package/dist/{chunk-2QT5ZUHO.js → chunk-EYLWVI26.js} +7 -7
  71. package/dist/{chunk-NHQGRKEA.js → chunk-EYZ6SLF3.js} +2 -2
  72. package/dist/{chunk-CAQ5P4VN.js → chunk-F35DA442.js} +3 -3
  73. package/dist/{chunk-X4YNDLVA.js → chunk-F7X53SZM.js} +2 -2
  74. package/dist/{chunk-G5FMTRG5.js → chunk-FILDYFT4.js} +1 -1
  75. package/dist/{chunk-P5RNWMZC.js → chunk-FMFCGYCE.js} +13 -13
  76. package/dist/{chunk-O3S2KNIW.js → chunk-FPPN5NAR.js} +2 -2
  77. package/dist/{chunk-J6I2YFJH.js → chunk-FV32N6AF.js} +1 -1
  78. package/dist/{chunk-XN7MQO45.js → chunk-G57ZO7DB.js} +5 -5
  79. package/dist/{chunk-FV3VF36K.js → chunk-G63ROSY5.js} +8 -8
  80. package/dist/{chunk-2CVH5E57.js → chunk-G6XCUX3I.js} +4 -4
  81. package/dist/{chunk-SPTPFY4S.js → chunk-GEBGBJBD.js} +5 -5
  82. package/dist/{chunk-VK5ZDV67.js → chunk-GGO43PHB.js} +4 -4
  83. package/dist/{chunk-CNX7EGSU.js → chunk-GSMWHKOW.js} +1 -1
  84. package/dist/{chunk-SS42FJVN.js → chunk-GVKFFJ23.js} +4 -4
  85. package/dist/{chunk-XJP5DKIL.js → chunk-GYNZ72GO.js} +2 -2
  86. package/dist/{chunk-2FNNAPCI.js → chunk-H4SYN3QA.js} +3 -3
  87. package/dist/{chunk-LFTAMH7I.js → chunk-HC4NDND6.js} +3 -3
  88. package/dist/{chunk-SVZDXFPX.js → chunk-HDZGZJKR.js} +9 -9
  89. package/dist/{chunk-6RBTTCQD.js → chunk-HGGLJYPZ.js} +8 -8
  90. package/dist/{chunk-N73IBH55.js → chunk-HHS6333D.js} +1 -1
  91. package/dist/{chunk-DJHIQWSG.js → chunk-HNVW3YDS.js} +3 -3
  92. package/dist/{chunk-PFVTYFSL.js → chunk-HW7BPJNQ.js} +3 -3
  93. package/dist/{chunk-MYMT5KJL.js → chunk-HZG5NB7Q.js} +12 -12
  94. package/dist/{chunk-5HECRVXJ.js → chunk-HZZH3MQI.js} +1 -1
  95. package/dist/{chunk-MVV6RQMG.js → chunk-I2E3YDNZ.js} +2 -2
  96. package/dist/{chunk-ZZU5R5UU.js → chunk-I5L3QTKQ.js} +3 -3
  97. package/dist/{chunk-RPIW5T55.js → chunk-IDT7DJ7F.js} +1 -1
  98. package/dist/{chunk-X6SUFTD7.js → chunk-IM4WUIR7.js} +2 -2
  99. package/dist/chunk-IMJXJHFW.js +88 -0
  100. package/dist/{chunk-HZI56ASJ.js → chunk-ISWU5YB3.js} +1 -1
  101. package/dist/{chunk-DYS7EIXY.js → chunk-J2ROMB7J.js} +15 -9
  102. package/dist/{chunk-XZOHR765.js → chunk-J33RA3YO.js} +2 -2
  103. package/dist/{chunk-TBGUEF3M.js → chunk-JAKRPSWP.js} +8 -8
  104. package/dist/{chunk-A6CQPJWR.js → chunk-JB4YPOMT.js} +2 -2
  105. package/dist/{chunk-E4IQ6M4S.js → chunk-JDEVGTSX.js} +3 -3
  106. package/dist/{chunk-4X66BTP5.js → chunk-JEL6665C.js} +3 -3
  107. package/dist/{chunk-COYOTQC2.js → chunk-JEYJRJ7M.js} +1 -1
  108. package/dist/{chunk-33PB4V6K.js → chunk-JJJ2KAHR.js} +5 -5
  109. package/dist/{chunk-B6GFKYBZ.js → chunk-JTJNQKPM.js} +8 -5
  110. package/dist/{chunk-CJGSJKPO.js → chunk-K2KU4HHT.js} +3 -3
  111. package/dist/{chunk-D7SHZDA3.js → chunk-K4K6KGEF.js} +5 -5
  112. package/dist/{chunk-IBXXZVG7.js → chunk-K4RCWNLC.js} +5 -5
  113. package/dist/{chunk-MZL6LGKO.js → chunk-KAQH75T6.js} +9 -9
  114. package/dist/{chunk-DU4A5AOY.js → chunk-KBFPMESI.js} +10 -10
  115. package/dist/{chunk-DDCB7ZA5.js → chunk-KFWEO4UA.js} +17 -17
  116. package/dist/{chunk-YG5GUELW.js → chunk-KJEZFOO6.js} +12 -12
  117. package/dist/{chunk-AQROQDLR.js → chunk-KL2XJQAA.js} +5 -5
  118. package/dist/{chunk-EFUWFB64.js → chunk-KNZD53L4.js} +3 -3
  119. package/dist/{chunk-TM4OC53S.js → chunk-KORHKDJW.js} +1 -1
  120. package/dist/{chunk-P26Z62UV.js → chunk-KSQEG6DX.js} +3 -3
  121. package/dist/{chunk-SMCDXUIO.js → chunk-KVSJ2O4Q.js} +3 -3
  122. package/dist/{chunk-BBRBCMNR.js → chunk-L7FSCT4M.js} +4 -4
  123. package/dist/{chunk-4JLBVIGW.js → chunk-LMPZKCDM.js} +3 -3
  124. package/dist/{chunk-HOAH5XBR.js → chunk-LTMF75MR.js} +5 -5
  125. package/dist/{chunk-SREWFAAJ.js → chunk-LVXOY5WL.js} +3 -3
  126. package/dist/{chunk-CUVUDK4O.js → chunk-LYVOL4TQ.js} +1 -1
  127. package/dist/{chunk-27QADBDV.js → chunk-MBVXROCI.js} +2 -2
  128. package/dist/{chunk-H67RTX46.js → chunk-MEG4NMSI.js} +1 -1
  129. package/dist/{chunk-EHBB2Z4D.js → chunk-MKVV7GVJ.js} +4 -4
  130. package/dist/{chunk-P25VEGGX.js → chunk-MONVTUHR.js} +3 -3
  131. package/dist/{chunk-LCWJS34U.js → chunk-MT4MP3UZ.js} +1 -1
  132. package/dist/{chunk-NQDVMUHX.js → chunk-MYCLO35J.js} +3 -3
  133. package/dist/{chunk-DOFYKPTC.js → chunk-MZJBPDIL.js} +1 -1
  134. package/dist/{chunk-3SQCCESO.js → chunk-NGRIT3CY.js} +13 -13
  135. package/dist/{chunk-KZJOV4QW.js → chunk-NQSDIDRO.js} +1 -1
  136. package/dist/{chunk-F6CNPC4L.js → chunk-NRF223FR.js} +1 -1
  137. package/dist/{chunk-66RFKRGO.js → chunk-NRHTC2SQ.js} +1 -1
  138. package/dist/{chunk-ZU425HNM.js → chunk-NWQTSZYC.js} +3 -3
  139. package/dist/{chunk-DO5OZJAO.js → chunk-OD3IH6FG.js} +5 -5
  140. package/dist/{chunk-HYY5V2KL.js → chunk-OM67S6S4.js} +3 -3
  141. package/dist/{chunk-N3G2FYDL.js → chunk-OMNQXHFF.js} +5 -5
  142. package/dist/{chunk-CCCEBIUZ.js → chunk-OMVYFSOM.js} +1 -1
  143. package/dist/{chunk-GZTNTHSW.js → chunk-OTW5SEFS.js} +2 -2
  144. package/dist/{chunk-6Y7EXYLR.js → chunk-OU5K2JPF.js} +7 -7
  145. package/dist/{chunk-QWXWVPNE.js → chunk-OZUTYDV4.js} +2 -2
  146. package/dist/{chunk-FF23FYQD.js → chunk-P52JHUUM.js} +11 -11
  147. package/dist/{chunk-CRNMNZJD.js → chunk-PBYUJSEY.js} +10 -10
  148. package/dist/{chunk-4UVW5WU6.js → chunk-PDG4IM3L.js} +1 -1
  149. package/dist/{chunk-CN7JRHST.js → chunk-PGV25HTX.js} +3 -3
  150. package/dist/{chunk-MQFCG4KS.js → chunk-PJWLKCFX.js} +80 -81
  151. package/dist/{chunk-YCRGWQBS.js → chunk-QJ4WGAC6.js} +4 -4
  152. package/dist/{chunk-KPKXJYQH.js → chunk-QQNPU27R.js} +1 -1
  153. package/dist/{chunk-EJPVVGD7.js → chunk-QR35TD2B.js} +37 -37
  154. package/dist/{chunk-SKRSCTT5.js → chunk-RK4S3VPS.js} +2 -2
  155. package/dist/{chunk-NSSNYY6Y.js → chunk-RKITD2UJ.js} +1 -1
  156. package/dist/{chunk-TJSND556.js → chunk-RZB4RPPD.js} +10 -10
  157. package/dist/{chunk-YCNLQYTC.js → chunk-S6CRZKPO.js} +1 -1
  158. package/dist/{chunk-GTG3IGLF.js → chunk-SFQ5ADIG.js} +17 -17
  159. package/dist/{chunk-IYMI7YI4.js → chunk-SHH2AHIU.js} +8 -8
  160. package/dist/{chunk-LS7HVBI7.js → chunk-SZCPKGYG.js} +3 -3
  161. package/dist/{chunk-L6DJ4ZY5.js → chunk-T3PNYRDM.js} +8 -8
  162. package/dist/{chunk-V6O6KVOA.js → chunk-T7ZCYYQZ.js} +2 -2
  163. package/dist/{chunk-4G2O2ZPJ.js → chunk-TKQKXBGC.js} +1 -1
  164. package/dist/{chunk-KSJVENRU.js → chunk-TNHD4UTC.js} +3 -3
  165. package/dist/{chunk-2VWJ5BGO.js → chunk-TNNK4IIY.js} +7 -7
  166. package/dist/{chunk-AWTG3RFF.js → chunk-TSPWXAAI.js} +1 -1
  167. package/dist/{chunk-L4S6UFTL.js → chunk-U2ES66IN.js} +3 -3
  168. package/dist/{chunk-XXOHXA3A.js → chunk-U2HQELXL.js} +2 -2
  169. package/dist/{chunk-3QWZAEW5.js → chunk-U4P6TQRW.js} +3 -2
  170. package/dist/{chunk-3JEQGGVD.js → chunk-U6CJPTOB.js} +3 -3
  171. package/dist/{chunk-RL3NUWMY.js → chunk-U7LLQ7XM.js} +8 -8
  172. package/dist/{chunk-XQCQZBGX.js → chunk-UTQGZF37.js} +1 -1
  173. package/dist/{chunk-2DOR5SS6.js → chunk-UYNAL3Y3.js} +5 -5
  174. package/dist/{chunk-5LGSRWFC.js → chunk-V7RAPZHX.js} +1 -1
  175. package/dist/{chunk-NY5NUFDZ.js → chunk-VAEC53B3.js} +1 -1
  176. package/dist/{chunk-2RSG7JYI.js → chunk-VDVXGAIP.js} +3 -3
  177. package/dist/{chunk-Z6CL7AR6.js → chunk-VGWWUCAB.js} +3 -3
  178. package/dist/{chunk-VTEV3WVF.js → chunk-VNLSTZES.js} +10 -10
  179. package/dist/{chunk-MJZHFH5R.js → chunk-VWYUUBBP.js} +11 -11
  180. package/dist/{chunk-QSXK6PJL.js → chunk-WDONXBQE.js} +1 -1
  181. package/dist/{chunk-ADWSGPH5.js → chunk-WEPAE4KG.js} +2 -2
  182. package/dist/{chunk-ZMF7WEGG.js → chunk-WGIO6AHP.js} +1 -1
  183. package/dist/{chunk-S6UX7KB6.js → chunk-WJKVNRCR.js} +2 -2
  184. package/dist/{chunk-CYOJZ3GQ.js → chunk-WKWMOZNE.js} +9 -4
  185. package/dist/{chunk-VJ3FCGQF.js → chunk-WMZCOGD6.js} +1 -1
  186. package/dist/{chunk-FBAYZSFC.js → chunk-WQ55QPEB.js} +17 -17
  187. package/dist/{chunk-REOPXBUR.js → chunk-WUKSZNHL.js} +6 -6
  188. package/dist/{chunk-FBB4BWKN.js → chunk-WZBMTZBM.js} +2 -2
  189. package/dist/{chunk-HKYTOJLV.js → chunk-X4U6PT3Z.js} +2 -2
  190. package/dist/{chunk-B54RN2FD.js → chunk-XNA6DATU.js} +5 -5
  191. package/dist/{chunk-Q3CV2JJ2.js → chunk-XTGWCYAR.js} +25 -25
  192. package/dist/{chunk-H5G7T35P.js → chunk-XXNLNZ7E.js} +3 -3
  193. package/dist/{chunk-TWOREVKJ.js → chunk-YS56RSTZ.js} +12 -12
  194. package/dist/{chunk-VH2UUU7K.js → chunk-ZBJNEJSL.js} +3 -3
  195. package/dist/{chunk-MBKZYJRC.js → chunk-ZNHF2XCP.js} +9 -9
  196. package/dist/{chunk-2V6CLH33.js → chunk-ZTH6YSVA.js} +1 -1
  197. package/dist/{chunk-JR7Y5ONB.js → chunk-ZWJTHFWB.js} +3 -3
  198. package/dist/{chunk-3H2W76TB.js → chunk-ZXOD37BE.js} +15 -15
  199. package/dist/cli/index.js +1 -1
  200. package/dist/{core-MR52YBRX.js → core-34KIMTK6.js} +2 -1
  201. package/dist/{core-MLROKJ2M.js → core-3CWPIFAL.js} +2 -1
  202. package/dist/{core-GGQREDSI.js → core-7R3ARYNI.js} +2 -1
  203. package/dist/{core-OJUQLIQ5.js → core-7YKLT7KY.js} +2 -1
  204. package/dist/{core-6RYHWUJO.js → core-AEYGGH7X.js} +2 -1
  205. package/dist/{core-GES44OTS.js → core-ASBJZZTP.js} +2 -1
  206. package/dist/{core-5HQBPCHL.js → core-CJ7FFPDU.js} +2 -1
  207. package/dist/{core-WGM4XUN3.js → core-CJZXX2V3.js} +2 -1
  208. package/dist/{core-PB3VUQSS.js → core-DAFZ7YJW.js} +2 -1
  209. package/dist/{core-KKQS3WI2.js → core-DJPGSTXB.js} +2 -1
  210. package/dist/{core-3VCCUFVX.js → core-DKJUX7Q4.js} +2 -1
  211. package/dist/{core-Z2F3IGSR.js → core-EAIFSTDE.js} +2 -1
  212. package/dist/{core-4BZQQSHS.js → core-GEUPUZUY.js} +2 -1
  213. package/dist/{core-NP4VHWXL.js → core-JLJTP7P6.js} +2 -1
  214. package/dist/{core-FVR3WZEC.js → core-JLXFDYHX.js} +2 -1
  215. package/dist/{core-5535KXRD.js → core-KCORN7F7.js} +2 -1
  216. package/dist/{core-ETAGQBZO.js → core-KF6GJOGW.js} +2 -1
  217. package/dist/{core-EFMVDWNH.js → core-KII4CH3W.js} +2 -1
  218. package/dist/{core-UHECQHJ2.js → core-KZK3WCUG.js} +2 -1
  219. package/dist/{core-GCTFVYMH.js → core-L5KTPXHC.js} +2 -1
  220. package/dist/{core-MJ7JWQT5.js → core-L7Y7YXWR.js} +2 -1
  221. package/dist/{core-EEB7HTCL.js → core-MN45UFF4.js} +2 -1
  222. package/dist/{core-WUQVFARS.js → core-MNUVP5IJ.js} +2 -1
  223. package/dist/{core-NQLNZDX5.js → core-O2K4BDYH.js} +2 -1
  224. package/dist/{core-QY7AVIKZ.js → core-ONNGSKWQ.js} +2 -1
  225. package/dist/{core-AJTVU6X7.js → core-PFXIBWLD.js} +2 -1
  226. package/dist/{core-HRYOV6QD.js → core-QXIAQFHM.js} +2 -1
  227. package/dist/{core-IKD3EE3S.js → core-R27R6J5M.js} +2 -1
  228. package/dist/{core-NSIJEKLI.js → core-RCFFJANI.js} +2 -1
  229. package/dist/{core-SBQMHWTA.js → core-RGLOYY73.js} +2 -1
  230. package/dist/{core-Q6VLFFYC.js → core-V7I4F6JW.js} +2 -1
  231. package/dist/{core-4VT4MHNB.js → core-W7AZNHOX.js} +2 -1
  232. package/dist/{core-JM4R426L.js → core-WHI4ABF2.js} +2 -1
  233. package/dist/{core-LA6XDYG7.js → core-WJSKT5XM.js} +2 -1
  234. package/dist/{core-C6YUSTZI.js → core-XKV7GMPG.js} +2 -1
  235. package/dist/{core-V5FV4NWL.js → core-YPH723Z7.js} +2 -1
  236. package/dist/{core-7BZJCIXN.js → core-YVNOHIQ4.js} +2 -1
  237. package/dist/{dataTable-3CPPIHB3.js → dataTable-VKEHFLJM.js} +3 -2
  238. package/dist/{engine-FXFBCWHB.js → engine-PPXKJJFI.js} +10 -9
  239. package/dist/fixtures.js +2 -1
  240. package/dist/index.js +15 -14
  241. package/dist/{main-YLKBTHJP.js → main-53MXACOU.js} +7 -6
  242. package/dist/mcp/server.js +12 -11
  243. package/dist/react/bar.js +2 -1
  244. package/dist/react/bartable.js +2 -1
  245. package/dist/react/box.js +2 -1
  246. package/dist/react/bullet.js +2 -1
  247. package/dist/react/butterfly.js +2 -1
  248. package/dist/react/choropleth.js +2 -1
  249. package/dist/react/cohort.js +2 -1
  250. package/dist/react/column.js +2 -1
  251. package/dist/react/combo.js +2 -1
  252. package/dist/react/creative.js +2 -1
  253. package/dist/react/diagram.js +2 -1
  254. package/dist/react/dimswitch.js +2 -1
  255. package/dist/react/dot.js +2 -1
  256. package/dist/react/export.js +16 -15
  257. package/dist/react/funnel.js +2 -1
  258. package/dist/react/gantt.js +2 -1
  259. package/dist/react/grid.js +2 -1
  260. package/dist/react/heatmap.js +2 -1
  261. package/dist/react/histogram.js +2 -1
  262. package/dist/react/index.js +83 -82
  263. package/dist/react/kpi.js +2 -1
  264. package/dist/react/likert.js +2 -1
  265. package/dist/react/line.js +2 -1
  266. package/dist/react/mekko.js +2 -1
  267. package/dist/react/pareto.js +2 -1
  268. package/dist/react/pie.js +2 -1
  269. package/dist/react/prepare.js +18 -17
  270. package/dist/react/pvm.js +2 -1
  271. package/dist/react/pyramid.js +2 -1
  272. package/dist/react/sankey.js +2 -1
  273. package/dist/react/scatter.js +2 -1
  274. package/dist/react/slope.js +2 -1
  275. package/dist/react/sparkline.js +2 -1
  276. package/dist/react/spec.js +9 -8
  277. package/dist/react/status.js +2 -1
  278. package/dist/react/story.js +2 -1
  279. package/dist/react/table.js +2 -1
  280. package/dist/react/theme.js +3 -2
  281. package/dist/react/tilemap.js +2 -1
  282. package/dist/react/treemap.js +2 -1
  283. package/dist/react/variance.js +2 -1
  284. package/dist/react/waffle.js +2 -1
  285. package/dist/react/waterfall.js +2 -1
  286. package/dist/{rowsModule-YVLAROIP.js → rowsModule-L3MBGPBH.js} +2 -1
  287. package/dist/{schema-2KIHLTYI.js → schema-26YUL3MG.js} +3 -1
  288. package/dist/{schema-GZNOW4LX.js → schema-33ZF6WKL.js} +3 -1
  289. package/dist/{schema-O7AKK232.js → schema-3W7IFXVN.js} +2 -1
  290. package/dist/{schema-NHNQK6XO.js → schema-4ZXJCRZR.js} +3 -1
  291. package/dist/{schema-2K6C3U24.js → schema-5E5J43CF.js} +3 -1
  292. package/dist/{schema-BNRNHGHQ.js → schema-6ZV532RM.js} +3 -1
  293. package/dist/{schema-ORTRMYI6.js → schema-733PO52K.js} +3 -1
  294. package/dist/{schema-HEIDGCSL.js → schema-AQD3H5VV.js} +3 -1
  295. package/dist/{schema-YQYTLKSW.js → schema-B4GFRYIP.js} +3 -1
  296. package/dist/{schema-JB2H6KPA.js → schema-CMXL5F5L.js} +3 -1
  297. package/dist/{schema-65FOKNHK.js → schema-FT37ZEYY.js} +3 -1
  298. package/dist/{schema-AMFRKUFS.js → schema-GK6MD4EG.js} +3 -1
  299. package/dist/{schema-SWWMOLOR.js → schema-GSE3QXUK.js} +2 -1
  300. package/dist/{schema-4HY2MWZC.js → schema-GVHM2HEF.js} +3 -1
  301. package/dist/{schema-OJCML6LV.js → schema-H7RKVTVO.js} +3 -1
  302. package/dist/{schema-5BKQV56C.js → schema-HGUBNXUY.js} +3 -1
  303. package/dist/{schema-ZUUUY3QS.js → schema-HRHNGOFC.js} +2 -1
  304. package/dist/{schema-WOSEZNKG.js → schema-HWU55RJL.js} +3 -1
  305. package/dist/{schema-FA6XIHTW.js → schema-IOKAZVL7.js} +3 -1
  306. package/dist/{schema-B7CZPPB4.js → schema-IOWE3RQO.js} +3 -1
  307. package/dist/{schema-MPXZNWV3.js → schema-KFXLS67Q.js} +3 -1
  308. package/dist/{schema-S36SRYGO.js → schema-KH62LDYK.js} +3 -1
  309. package/dist/{schema-RTWES6NR.js → schema-KHCLVE2V.js} +3 -1
  310. package/dist/{schema-E4MRCGPZ.js → schema-KORNUIC6.js} +3 -1
  311. package/dist/{schema-O4YNAGIY.js → schema-LYBOPAGQ.js} +3 -1
  312. package/dist/{schema-7TLSFG6M.js → schema-MNG24WU2.js} +3 -1
  313. package/dist/{schema-4S5CXHAO.js → schema-NOPOI5G2.js} +3 -1
  314. package/dist/{schema-Y6KBWUUR.js → schema-PNUC54GC.js} +3 -1
  315. package/dist/{schema-6W4M3WJ4.js → schema-Q4IPIR6W.js} +3 -1
  316. package/dist/{schema-6OHZWHUI.js → schema-QLH2DZFI.js} +3 -1
  317. package/dist/{schema-S3TCLTYD.js → schema-QNI6MNQ2.js} +3 -1
  318. package/dist/{schema-5NKJPSBD.js → schema-SLQPM32G.js} +3 -1
  319. package/dist/{schema-PJ6P52BC.js → schema-SY3MKF5S.js} +3 -1
  320. package/dist/{schema-5HA5DSYN.js → schema-WAKLKLBB.js} +3 -1
  321. package/dist/{schema-6RYJS2GM.js → schema-WCDYWS4K.js} +3 -1
  322. package/dist/{schema-NN6UPDPW.js → schema-ZCZCY34J.js} +3 -1
  323. package/dist/{schema-F3WYTR65.js → schema-ZSYX76MO.js} +3 -1
  324. package/dist/{specValidation-VNWIKLHH.js → specValidation-H5B4MQST.js} +2 -1
  325. package/dist/theme.js +3 -2
  326. package/dist/{themeShapeRules-2D3KWSPQ.js → themeShapeRules-54U5EIZR.js} +1 -1
  327. package/dist/types/core/annotateEngine.d.ts +14 -0
  328. package/dist/types/core/deferred.d.ts +6 -1
  329. package/dist/types/core/theme.d.ts +3 -1
  330. package/dist/types/core/themeShape.d.ts +3 -3
  331. package/dist/types/core/themeValidate.d.ts +3 -3
  332. package/dist/types/core/types/theme.d.ts +2 -1
  333. package/dist/types/react/rowsStore.d.ts +5 -0
  334. package/dist/validate.js +7 -6
  335. package/docs/manual.md +5 -3
  336. package/docs/reference/theme.md +2 -3
  337. package/docs/use-cases.md +198 -0
  338. package/llms.txt +1 -0
  339. package/package.json +2 -1
  340. package/dist/chunk-ONZLC47B.js +0 -88
package/dist/theme.js CHANGED
@@ -1,11 +1,12 @@
1
1
  import {
2
2
  linkThemeShapeRules
3
- } from "./chunk-BWGRWGVA.js";
3
+ } from "./chunk-6I7YZTY7.js";
4
4
  import {
5
5
  registerTheme,
6
6
  resolveTheme,
7
7
  typeForTarget
8
- } from "./chunk-CWDHCSL2.js";
8
+ } from "./chunk-B3F4TS3V.js";
9
+
9
10
 
10
11
 
11
12
 
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  linkThemeShapeRules
3
- } from "./chunk-BWGRWGVA.js";
3
+ } from "./chunk-6I7YZTY7.js";
4
4
 
5
5
 
6
6
 
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Publishes the annotation placement engine and the event lane (see
3
+ * `core/deferred` and `core/annotatePass`). Linking this module links `annotate.ts` and makes
4
+ * every layout's annotation pass synchronous.
5
+ *
6
+ * It is a module of its own rather than a call inside `annotate.ts`: several
7
+ * layouts import small helpers from there, and a top-level reference to
8
+ * `runAnnotatePass` would pin the whole engine into every bundle that
9
+ * reaches one of them.
10
+ *
11
+ * An entry links it by calling `linkAnnotateEngine()`, for the reason
12
+ * `core/themeShapeRules` gives. Importing the module still publishes.
13
+ */
14
+ export declare function linkAnnotateEngine(): void;
@@ -65,7 +65,12 @@ export declare class DeferredCoreError extends Error {
65
65
  /** `failure`: why a core this chart needs did not load ('chart-cores' only); the chart shows it instead of the busy box. */
66
66
  constructor(module: DeferredName, failure?: string | undefined);
67
67
  }
68
- /** Called at module scope by the accessor that knows which chunk carries the module. */
68
+ /**
69
+ * Called at module scope by the accessor that knows which chunk carries the
70
+ * module. `load` publishes through the chunk's export, such as
71
+ * `import('./annotateEngine.js').then((module) => module.linkAnnotateEngine())`:
72
+ * a host bundler may empty a chunk whose only effect is a module-scope call.
73
+ */
69
74
  export declare function registerDeferredLoader(name: keyof DeferredCoreModules, load: () => Promise<unknown>): void;
70
75
  /** Called at module scope by the publishing module. The first copy wins. */
71
76
  export declare function publishDeferred<K extends keyof DeferredCoreModules>(name: K, value: DeferredCoreModules[K]): void;
@@ -160,7 +160,7 @@ export declare function typeForTarget(base: Theme['type'], target: RenderTarget)
160
160
  export declare function resolveTargetTheme(ref: ThemeRef | undefined, target: RenderTarget, textScale?: number, textSize?: number): Theme;
161
161
  /** Carries the removal warnings of the authored request through the wrapped theme reference to the layout. */
162
162
  export declare const REMOVED_NAMES: unique symbol;
163
- /** The deprecation warning for `table.weights.change` in one chart's authored theme. */
163
+ /** The `option-deprecated` warnings for the retired preset name and theme keys of one chart's authored theme. */
164
164
  export declare function removedNameWarnings(options: {
165
165
  theme?: unknown;
166
166
  palette?: unknown;
@@ -406,6 +406,8 @@ export declare function paintColor(theme: Theme, paint: Paint): string;
406
406
  * `series` ramp and report a warning through `warn` so charts surface an
407
407
  * `unknown-palette` lint instead of silently recoloring.
408
408
  */
409
+ /** A palette warning; a retired palette name carries the patch that removes it. */
410
+ export declare function paletteWarning(code: string, message: string): LintWarning;
409
411
  export declare function resolvePalette(theme: Theme, name: string | undefined, warn?: (code: string, message: string) => void): string[] | undefined;
410
412
  export declare function resolveSemanticPaletteTheme(theme: Theme, name: string | undefined, warnings: LintWarning[]): Theme;
411
413
  /**
@@ -77,9 +77,9 @@ export declare function checkThemeShape(value: unknown): string[];
77
77
  /** Runtime override gate: check only the erasure rule that can reject a patch. */
78
78
  export declare function semanticErasureWarnings(theme: Theme): LintWarning[];
79
79
  /**
80
- * The way out of a shape refusal that names unknown keys, such as
81
- * space.barGap: the keys to remove, and a remove patch per key under
82
- * `root`. Undefined when the shape check named no unknown key.
80
+ * The way out of a shape refusal that names unknown keys: the keys to
81
+ * remove, and a remove patch per key under `root`. Undefined when the shape
82
+ * check named no unknown key. A retired key never gets here (retired.ts).
83
83
  */
84
84
  export declare function unknownThemeKeyRepair(issues: readonly string[], root: string): {
85
85
  suggest: string;
@@ -5,9 +5,9 @@ export * from './themeRules.js';
5
5
  export * from './themeFields.js';
6
6
  /**
7
7
  * Parse + register-ready: throws on schema errors, returns theme + lints. The
8
- * refusal is an `invalid-theme` NormalizeError; an unknown key, such as the
9
- * retired space.barGap, carries the suggest and remove patch the spec surfaces
10
- * give, rooted at the theme file.
8
+ * refusal is an `invalid-theme` NormalizeError; an unknown key carries the
9
+ * suggest and remove patch the spec surfaces give, rooted at the theme file.
10
+ * A retired key, such as space.barGap, is dropped and warns with that patch.
11
11
  */
12
12
  export declare function parseThemeJson(raw: unknown): {
13
13
  theme: Theme;
@@ -706,7 +706,7 @@ export interface ThemeTable {
706
706
  lineHeight?: number;
707
707
  pad?: number;
708
708
  };
709
- /** Weights by row kind. Member and measure rows default to regular weight on leaves and emphasis on parents. Subtotals and results default to emphasis. `emphasis` is that weight for totals, subtotals, results and parents (default the `type.emphasis` weight). `change` is accepted and ignored with a removal warning; the next release refuses it. */
709
+ /** Weights by row kind. Member and measure rows default to regular weight on leaves and emphasis on parents. Subtotals and results default to emphasis. `emphasis` is that weight for totals, subtotals, results and parents (default the `type.emphasis` weight). */
710
710
  weights?: {
711
711
  emphasis?: number;
712
712
  member?: number;
@@ -720,6 +720,7 @@ export interface ThemeTable {
720
720
  result?: number;
721
721
  };
722
722
  block?: number;
723
+ /** @deprecated Retired: ignored, and warns `option-deprecated` with a fix that removes it. */
723
724
  change?: number;
724
725
  };
725
726
  /**
@@ -34,6 +34,11 @@ export declare function publishRowsModule(module: RowsModule): void;
34
34
  * One load at a time. A rejected load is tried again on the next render, and
35
35
  * a failure redraws only when its message is new, so a chunk that is not
36
36
  * deployed settles on the failure card instead of retrying in a loop.
37
+ *
38
+ * It publishes the chunk's export rather than trusting the chunk's own
39
+ * module-scope call: a host bundler that reads the chunk as side-effect-free
40
+ * (Rolldown in a Vite 8 build) empties it, and an import that publishes
41
+ * nothing would leave the chart on the busy placeholder.
37
42
  */
38
43
  export declare function loadRowsModule(): void;
39
44
  export declare const loadedModule: () => {
package/dist/validate.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  parseThemeJson
3
- } from "./chunk-VKQNDOAI.js";
3
+ } from "./chunk-43OQ26TL.js";
4
4
  import {
5
5
  registerCatalogue
6
- } from "./chunk-MQFCG4KS.js";
6
+ } from "./chunk-PJWLKCFX.js";
7
7
 
8
8
 
9
9
 
@@ -144,7 +144,7 @@ import {
144
144
 
145
145
  import {
146
146
  linkAnnotateEngine
147
- } from "./chunk-NKIYLFXZ.js";
147
+ } from "./chunk-2IXDYW6O.js";
148
148
 
149
149
 
150
150
 
@@ -177,7 +177,7 @@ import {
177
177
 
178
178
  import {
179
179
  linkThemeShapeRules
180
- } from "./chunk-BWGRWGVA.js";
180
+ } from "./chunk-6I7YZTY7.js";
181
181
 
182
182
 
183
183
 
@@ -188,7 +188,7 @@ import {
188
188
  import {
189
189
  getChartDefinition,
190
190
  listCharts
191
- } from "./chunk-RL3NUWMY.js";
191
+ } from "./chunk-U7LLQ7XM.js";
192
192
 
193
193
 
194
194
 
@@ -201,7 +201,8 @@ import {
201
201
 
202
202
  import {
203
203
  validateTheme
204
- } from "./chunk-HA4IPWMM.js";
204
+ } from "./chunk-4WK3CNW5.js";
205
+
205
206
 
206
207
 
207
208
 
package/docs/manual.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # Boardplot manual
2
2
 
3
+ 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
+
3
5
  ## What Boardplot is
4
6
 
5
7
  Boardplot draws consulting-grade charts: 37 chart types, tables and maps among them, with every label placed by one collision solver. The output is deterministic SVG or a React component, so the same spec gives the same drawing byte for byte. Totals, differences, shares and growth rates are computed from the data, and each render reports the numbers the engine derived.
@@ -144,7 +146,7 @@ Each derived reading has `visible: true` when it has displayed text. A calculati
144
146
 
145
147
  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`.
146
148
 
147
- `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 label with characters the theme font has no width for, such as emoji or CJK, gets the warning `png-glyph-coverage`, because resvg draws them as boxes or leaves them out. A PNG records 96 dpi times `scale`, so PowerPoint, Keynote and Word place a scale-2 PNG at the chart's own size.
149
+ `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 label with characters the theme font has no width for, such as emoji or CJK, gets the warning `png-glyph-coverage`, because resvg draws them as boxes or leaves them out. 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.
148
150
 
149
151
  ### Rows as data
150
152
 
@@ -239,7 +241,7 @@ SVG `id` attributes and their references use a hash of the drawing, locale and r
239
241
 
240
242
  ### Gantt and grid formats
241
243
 
242
- Gantt and ordinary grid compositions have no numeric value labels of their own. Metric stacks set mark precision with panel `decimals` and `divisor`. A chart-level `format` is accepted and warns in this release. It will be refused in the next release. Set each numeric grid panel's `options.format` instead. Gantt uses calendar date options.
244
+ Gantt and ordinary grid compositions have no numeric value labels of their own. Metric stacks set mark precision with panel `decimals` and `divisor`. A chart-level `format` is accepted, ignored and warns. Set each numeric grid panel's `options.format` instead. Gantt uses calendar date options.
243
245
 
244
246
  ### Metric stack
245
247
 
@@ -784,7 +786,7 @@ The target replaces the type sizes of a preset; a size that `overrides` names st
784
786
 
785
787
  A theme key that Boardplot removed is refused with `invalid-theme-override` or `invalid-theme`, a suggest and a patch that removes it. `type.eyebrow.case` is removed: KPI eyebrows and waffle panel labels print names as written, so write capitals in the name to keep them. If the theme widened `type.eyebrow.tracking` for capitals, set `type.eyebrow.tracking` back or remove it. Absent means no letter-spacing, and a name in mixed case reads too wide with capital tracking.
786
788
 
787
- An override can give `color.series` one or two colours. These colours come first. The remaining slots come from the preset, with colours that repeat an authored colour skipped. An override with three or more colours keeps its own ramp and overflow policy. A full theme needs at least three colours.
789
+ An override can give `color.series` one or two colours. These colours come first. The remaining slots come from the preset, with colours that repeat an authored colour skipped. An override with three or more colours keeps its own ramp and overflow policy. A full theme needs at least one colour. It draws a two-series chart in exactly its two colours, and series past the end of its ramp follow `color.seriesOverflow`.
788
790
 
789
791
  ### Design system colours
790
792
 
@@ -62,7 +62,7 @@ Defaults are the `standard` preset.
62
62
  | color.reference | string | | | | The rails of a slope chart, the two verticals the values are read against. Absent means color.axis. Held to 3:1 on the background once set (contrast-reference). |
63
63
  | color.leader | string | yes | | `'#9AA6B1'` | Leader line ink for labels placed away from their mark. |
64
64
  | color.background | string | yes | | `'#FFFFFF'` | Chart canvas background. Tint stages mix toward this color, so it must be a real surface color. |
65
- | color.series | array | yes | | `["#075A8E","#55BEF7","#2AB1A9","#838CDA","#208668","#9259AC","#680000","#B85800"]` | Categorical ramp, index 0 first. A preset override with one or two colours fills the remaining slots from the preset, skipping colours already authored. A complete theme needs at least three entries. Index 0 also bases the sequential ramps (tints of series 1). |
65
+ | color.series | array | yes | | `["#075A8E","#55BEF7","#2AB1A9","#838CDA","#208668","#9259AC","#680000","#B85800"]` | Categorical ramp, index 0 first. A preset override with one or two colours fills the remaining slots from the preset, skipping colours already authored. A complete theme needs at least one entry; series past the end of the ramp follow color.seriesOverflow. Index 0 also bases the sequential ramps (tints of series 1). |
66
66
  | color.casePair | array | | | | Tornado low/high fills. Absent resolves to neutralLight/series 1. |
67
67
  | color.stack | array | | | `["#075A8E","#4C95C8","#A9C6DC"]` | Fills of the plain series of a stacked or 100% column or bar, strongest on the page first and the quietest last (2 or more). More series than steps share the ramp evenly between its ends; authored fills, colour roles, palettes and highlights win. Absent keeps the series order. |
68
68
  | color.seriesOverflow | string | | `'repeatLast'`, `'cycle'` | `'repeatLast'` | What a series index beyond the ramp does: 'repeatLast' reuses the last entry, 'cycle' restarts the ramp. Default 'repeatLast'. |
@@ -285,7 +285,6 @@ Defaults are the `standard` preset.
285
285
  | table.weights.subtotal | number | | | | Subtotal label weight. Default table.weights.emphasis. |
286
286
  | table.weights.result | number | | | | Result label weight. Default table.weights.emphasis. |
287
287
  | table.weights.block | number | | | | Strong block-column figure weight. Default table.weights.emphasis. |
288
- | table.weights.change | number | | | | Deprecated: accepted and ignored in this release; refused in the next. Remove this key. An authored key warns option-deprecated with removal guidance. |
289
288
  | table.weights.figures | object | | | | Figure weights per presentation kind. |
290
289
  | table.weights.figures.member | number | | | | Member figure weight. Default 400 on a leaf and table.weights.emphasis on a parent. |
291
290
  | table.weights.figures.measure | number | | | | Measure figure weight. Default 400 on a leaf and table.weights.emphasis on a parent. |
@@ -352,7 +351,7 @@ Defaults are the `standard` preset.
352
351
  | good-bad-similar | good and bad are nearly identical |
353
352
  | family-outside-metric-class | warning: the leading family of a type stack is not Inter, Geist, Helvetica, Helvetica Neue, Arial or a metric clone, so text can render wider than measured; pass tables built by `boardplot fonts build`, see docs/FONTS.md |
354
353
 
355
- An unknown key, such as the retired `space.barGap`, comes with a suggest that names it and a JSON Patch that removes it. The CLI, the MCP tools, React and `parseThemeJson` from `boardplot/validate` give the same suggest and patch; `parseThemeJson` throws it as an `invalid-theme` error whose patch paths start at the theme file.
354
+ A retired key, such as `space.barGap`, is accepted for good: the theme draws without it and warns `option-deprecated` with a JSON Patch that removes it. A retired preset name, such as `ibcs`, draws as its successor and warns with a patch that rewrites it. An unknown key that never existed is refused with a suggest that names it and a JSON Patch that removes it. The CLI, the MCP tools, React and `parseThemeJson` from `boardplot/validate` give the same warnings, suggests and patches; `parseThemeJson` throws a refusal as an `invalid-theme` error whose patch paths start at the theme file.
356
355
 
357
356
  A resolved theme is FROZEN, all the way down. `resolveTheme`, the `theme` on a resolved request and the one a React component reads are the same deeply frozen object, so a write to one throws where it is written instead of changing a theme the engine has already judged and cached. A variant is a new object: spread the resolved theme, or pass `overrides` and let the engine merge and check them.
358
357
 
@@ -0,0 +1,198 @@
1
+ # Use cases: Boardplot with an AI agent
2
+
3
+ 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
+
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. The [manual](manual.md) explains the spec, the tools and every option.
6
+
7
+ ## Install
8
+
9
+ - **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
+
13
+ To check the install, start a new session and ask:
14
+
15
+ ```text
16
+ Use Boardplot to draw a small column chart from sample data as PNG. Tell me the Boardplot version and the file path.
17
+ ```
18
+
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.
20
+
21
+ **Tips for every use case:**
22
+
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).
24
+ - **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
+ - **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
+ - **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
+
28
+ ## PowerPoint or Keynote deck
29
+
30
+ **You get:** a new deck with Boardplot charts, or your existing deck with its charts replaced by Boardplot charts.
31
+
32
+ **Example prompts:**
33
+
34
+ ```text
35
+ Build a 10-slide quarterly review deck from data/q3-sales.csv. Use Boardplot for every chart.
36
+ ```
37
+
38
+ ```text
39
+ Revise my presentation board-update.pptx and replace all charts with Boardplot charts. Keep the slide text and layout.
40
+ ```
41
+
42
+ ```text
43
+ Add a revenue bridge from FY24 to FY25 to slide 4 of strategy.pptx, drawn with Boardplot, in our colours #0B5CAD and #A9C1D9.
44
+ ```
45
+
46
+ **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
+
48
+ 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.
50
+ 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.
52
+
53
+ 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
+
55
+ **Tips:**
56
+
57
+ - Give the size of the picture box, or say "full slide". A box that is too small for the chart is refused, and the error's `suggest` names the size that fits, for example "Pass height 372pt.".
58
+ - Ask for SVG instead of PNG when the deck stays in PowerPoint. A `slide` SVG carries its size in pt and stays sharp at any zoom.
59
+ - For a dark slide background, ask for a dark preset such as `standard-dark`. A transparent background keeps the theme's background colour in the label halos.
60
+
61
+ **Limits:**
62
+
63
+ - The charts are pictures. Colleagues cannot edit their data in PowerPoint. To change a chart, ask the agent to draw it again.
64
+ - Keynote: the agent builds a `.pptx` file, and Keynote opens it.
65
+ - Google Slides does not insert SVG files. Use PNG there.
66
+ - A PNG draws with the fonts installed on the machine that renders. For a brand font, see [Custom fonts](FONTS.md).
67
+
68
+ ## Analysis page or Claude artifact
69
+
70
+ **You get:** an analysis written as an HTML page, such as a Claude artifact or a report page, with the charts in the page.
71
+
72
+ **Example prompts:**
73
+
74
+ ```text
75
+ Analyse data/churn.csv: which customer segments churn most, and since when? Write the result as an artifact and draw every chart with Boardplot.
76
+ ```
77
+
78
+ ```text
79
+ Write a one-page HTML report on last month's marketing spend from exports/spend.csv. Use Boardplot for the charts and our colours #0B5CAD and #A9C1D9.
80
+ ```
81
+
82
+ **What the agent does:**
83
+
84
+ 1. Analyses the data and decides which finding each chart shows.
85
+ 2. Calls `boardplot_render` with the data file as `rowsFile` and `return: ["reading", "svg"]`. The answer carries the chart's SVG markup in `svg`.
86
+ 3. Puts each SVG inline in the page. The page needs no script and loads nothing from the network to show the charts.
87
+ 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.
88
+
89
+ **Tips:**
90
+
91
+ - Ask the agent to state the finding in each chart title.
92
+ - Ask it to check the warnings of each render, such as `label-hidden`, before it writes the page.
93
+ - Say the column width of the page if it is not about 720 px. The agent renders at that width instead of shrinking a wider chart.
94
+
95
+ **Limits:**
96
+
97
+ - The SVG is a static image: no hover cards or filters. Those need the React components.
98
+ - The SVG names the theme's font stack and embeds no font. The preset themes use system fonts. A brand web font must be loaded by the page.
99
+
100
+ ## React dashboard
101
+
102
+ **You get:** a new React or Next.js dashboard with Boardplot charts, or an existing dashboard with its charts moved to Boardplot.
103
+
104
+ **Example prompts:**
105
+
106
+ ```text
107
+ Build the sales dashboard in Next.js from the API in src/api/sales.ts and use Boardplot for the chart work.
108
+ ```
109
+
110
+ ```text
111
+ Move the charts of this dashboard from our current chart library to Boardplot. Keep the data loading and the page layout as they are.
112
+ ```
113
+
114
+ **What the agent does:**
115
+
116
+ 1. Calls `boardplot_list` and `boardplot_describe` to choose the chart types and their options.
117
+ 2. Uses the per-type components, such as `ColumnChart` from `boardplot/react/column`, with `size="container"`, so each chart lays out in its card.
118
+ 3. Wraps the page in `BoardplotTheme` with `target="dashboard"` and your theme, so every chart shares one look.
119
+ 4. In Next.js, prepares the charts on the server with `prepareChart`, so the first paint shows the chart.
120
+
121
+ The [React reference](reference/react.md) has each part: [per-type components](reference/react.md#per-type-components), [container sizing](reference/react.md#container-sizing), [theme provider](reference/react.md#theme-provider), [server preparation](reference/react.md#server-preparation), [rows from a query](reference/react.md#rows-from-a-query) and [export](reference/react.md#export).
122
+
123
+ **Tips:**
124
+
125
+ - 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.
126
+ - Name the chart for each card if you know it, for example "a waterfall for the margin bridge".
127
+ - When you move a dashboard, ask the agent to list each old chart with the Boardplot type it chose.
128
+
129
+ **Limits:**
130
+
131
+ - React 18 or 19. The package has ES module entries only.
132
+ - `boardplot_list` names chart forms that Boardplot does not draw. The agent keeps those charts in the old library or proposes another type.
133
+ - A parent that takes its width from its content keeps the chart at its fallback width. See [container sizing](reference/react.md#container-sizing).
134
+ - A strict content security policy needs a style nonce. See [content security policy](reference/react.md#content-security-policy).
135
+
136
+ ## Word or PDF report
137
+
138
+ **You get:** a Word document or PDF with print-quality charts.
139
+
140
+ **Example prompts:**
141
+
142
+ ```text
143
+ Write the monthly finance report as a Word document from exports/finance.csv. Draw the charts with Boardplot for print.
144
+ ```
145
+
146
+ ```text
147
+ Turn this analysis into a PDF report on A4. Use Boardplot for all charts, 300 dpi.
148
+ ```
149
+
150
+ **What the agent does:** Boardplot draws the chart images, and the agent's own Word or PDF tool places them in the document. For each chart, the agent calls `boardplot_render` with `target: "print"`, the text column width in mm, for example `options.size: { "width": 160, "unit": "mm" }`, `format: "png"` and `scale: 3.125` for 300 dpi. Word places the PNG at 160 mm.
151
+
152
+ **Tips:**
153
+
154
+ - Give the page format and margins, or the text column width.
155
+ - Ask for the `print` target. A `report` chart in print keeps screen type sizes.
156
+
157
+ **Limits:**
158
+
159
+ - The charts are pictures. Colleagues cannot edit their data in Word.
160
+ - A PNG draws with the fonts installed on the machine that renders.
161
+
162
+ ## Recurring report
163
+
164
+ **You get:** the same report every week or month, such as a weekly business review, with charts from the latest query export.
165
+
166
+ **Example prompts:**
167
+
168
+ ```text
169
+ Every Monday, read exports/orders.csv and write the weekly business review with Boardplot charts. Reuse the chart specs in reports/specs/.
170
+ ```
171
+
172
+ ```text
173
+ 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.
174
+ ```
175
+
176
+ **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).
177
+
178
+ A scheduled job needs no agent. It runs the CLI on the same templates:
179
+
180
+ ```sh
181
+ boardplot render weekly-orders.json --rows exports/orders.csv \
182
+ --columns category=week,series=channel,value=orders \
183
+ --format png --out "out/$(date +%F)" --quiet
184
+ ```
185
+
186
+ It writes `out/<date>/weekly-orders.png` and prints `{"ok":true,"outputs":[...]}` with the file path. The CLI exits 1 when it refuses the input, for example a renamed column (`missing-column`), and 2 for an internal error. Let the job fail on a non-zero exit.
187
+
188
+ **Tips:**
189
+
190
+ - Keep the templates in the repository. Each run then draws the same charts with new data.
191
+ - Name every series with its label in the template. A series that only the rows name prints its raw id.
192
+ - Write each run to a dated folder, or pass `--overwrite`. A taken file name otherwise gets `-2`.
193
+
194
+ **Limits:**
195
+
196
+ - 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`.
197
+ - 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).
198
+ - A CSV with grouping marks in numbers, such as `1.234,5`, is refused. Export plain numbers.
package/llms.txt CHANGED
@@ -7,6 +7,7 @@ Every chart is one spec, `{ "type", "data", "options", "annotations", "theme" }`
7
7
  ## Start here
8
8
 
9
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
10
11
 
11
12
  ## Chart references
12
13
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "boardplot",
3
- "version": "0.53.0",
3
+ "version": "0.54.0",
4
4
  "description": "Consulting-grade charts for AI agents and React: one JSON spec gives a deterministic SVG, PNG or React chart.",
5
5
  "mcpName": "io.github.boardplot/boardplot",
6
6
  "type": "module",
@@ -346,6 +346,7 @@
346
346
  "docs/manual.md",
347
347
  "docs/reference",
348
348
  "docs/FONTS.md",
349
+ "docs/use-cases.md",
349
350
  "docs/TELEMETRY.md",
350
351
  "NOTICE.md",
351
352
  "THIRD_PARTY_NOTICES.md",
@@ -1,88 +0,0 @@
1
- import {
2
- chartTypeAliases,
3
- schemaLoaders
4
- } from "./chunk-EJPVVGD7.js";
5
- import {
6
- registeredType
7
- } from "./chunk-DOFYKPTC.js";
8
- import {
9
- getChart,
10
- getChartSchemas,
11
- registerChartSchemas
12
- } from "./chunk-RL3NUWMY.js";
13
- import {
14
- registerChartCoreLoader
15
- } from "./chunk-HA4IPWMM.js";
16
-
17
- // src/react/coreLoaders.ts
18
- var coreLoaders = {
19
- bar: () => import("./core-QY7AVIKZ.js").then((module) => module.barCore),
20
- bartable: () => import("./core-LA6XDYG7.js").then((module) => module.bartableCore),
21
- box: () => import("./core-5HQBPCHL.js").then((module) => module.boxCore),
22
- bullet: () => import("./core-Z2F3IGSR.js").then((module) => module.bulletCore),
23
- butterfly: () => import("./core-FVR3WZEC.js").then((module) => module.butterflyCore),
24
- choropleth: () => import("./core-HRYOV6QD.js").then((module) => module.choroplethCore),
25
- cohort: () => import("./core-5535KXRD.js").then((module) => module.cohortCore),
26
- column: () => import("./core-V5FV4NWL.js").then((module) => module.columnCore),
27
- combo: () => import("./core-WGM4XUN3.js").then((module) => module.comboCore),
28
- creative: () => import("./core-JM4R426L.js").then((module) => module.creativeCore),
29
- diagram: () => import("./core-GES44OTS.js").then((module) => module.diagramCore),
30
- dimswitch: () => import("./core-GGQREDSI.js").then((module) => module.dimswitchCore),
31
- dot: () => import("./core-KKQS3WI2.js").then((module) => module.dotCore),
32
- funnel: () => import("./core-EEB7HTCL.js").then((module) => module.funnelCore),
33
- gantt: () => import("./core-3VCCUFVX.js").then((module) => module.ganttCore),
34
- grid: () => import("./core-7BZJCIXN.js").then((module) => module.gridCore),
35
- heatmap: () => import("./core-4VT4MHNB.js").then((module) => module.heatmapCore),
36
- histogram: () => import("./core-Q6VLFFYC.js").then((module) => module.histogramCore),
37
- kpi: () => import("./core-MJ7JWQT5.js").then((module) => module.kpiCore),
38
- likert: () => import("./core-SBQMHWTA.js").then((module) => module.likertCore),
39
- line: () => import("./core-MLROKJ2M.js").then((module) => module.lineCore),
40
- mekko: () => import("./core-NQLNZDX5.js").then((module) => module.mekkoCore),
41
- pareto: () => import("./core-C6YUSTZI.js").then((module) => module.paretoCore),
42
- pie: () => import("./core-6RYHWUJO.js").then((module) => module.pieCore),
43
- pvm: () => import("./core-UHECQHJ2.js").then((module) => module.pvmCore),
44
- pyramid: () => import("./core-AJTVU6X7.js").then((module) => module.pyramidCore),
45
- sankey: () => import("./core-GCTFVYMH.js").then((module) => module.sankeyCore),
46
- scatter: () => import("./core-4BZQQSHS.js").then((module) => module.scatterCore),
47
- slope: () => import("./core-WUQVFARS.js").then((module) => module.slopeCore),
48
- sparkline: () => import("./core-NP4VHWXL.js").then((module) => module.sparklineCore),
49
- status: () => import("./core-ETAGQBZO.js").then((module) => module.statusCore),
50
- table: () => import("./core-NSIJEKLI.js").then((module) => module.tableCore),
51
- tilemap: () => import("./core-EFMVDWNH.js").then((module) => module.tilemapCore),
52
- treemap: () => import("./core-MR52YBRX.js").then((module) => module.treemapCore),
53
- variance: () => import("./core-OJUQLIQ5.js").then((module) => module.varianceCore),
54
- waffle: () => import("./core-PB3VUQSS.js").then((module) => module.waffleCore),
55
- waterfall: () => import("./core-IKD3EE3S.js").then((module) => module.waterfallCore)
56
- };
57
-
58
- // src/react/loadChartTypes.ts
59
- var aliasOwners = /* @__PURE__ */ new Map();
60
- for (let [type, aliases] of Object.entries(chartTypeAliases))
61
- for (let alias of aliases) aliasOwners.set(alias, type);
62
- function knownChartType(name) {
63
- return Object.hasOwn(coreLoaders, name) ? name : aliasOwners.get(name);
64
- }
65
- async function loadChartTypes(names, parts) {
66
- let types = [...new Set(names.map(knownChartType).filter((type) => type !== void 0))];
67
- await Promise.all(types.flatMap((type) => [
68
- parts.schemas && getChartSchemas(type) === void 0 ? schemaLoaders[type]().then((schemas) => {
69
- registerChartSchemas(schemas, chartTypeAliases[type]);
70
- }) : void 0,
71
- parts.cores && getChart(type) === void 0 ? coreLoaders[type]().then((core) => {
72
- registeredType(core);
73
- }) : void 0
74
- ]));
75
- }
76
- registerChartCoreLoader({
77
- knows: (type) => knownChartType(type) !== void 0,
78
- load: (type) => loadChartTypes([type], { schemas: !1, cores: !0 })
79
- });
80
- function registeredTypeWithPanelCores(core) {
81
- return registeredType(core);
82
- }
83
-
84
- export {
85
- knownChartType,
86
- loadChartTypes,
87
- registeredTypeWithPanelCores
88
- };