boardplot 0.52.5 → 0.53.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 (377) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +2 -2
  3. package/dist/{ReaderBox-VUNSFKZY.js → ReaderBox-VOJSJ66R.js} +5 -5
  4. package/dist/{annotateEngine-H7OW4H3W.js → annotateEngine-DLMFJZ67.js} +1 -1
  5. package/dist/build-identity.json +3 -3
  6. package/dist/{chunk-HAAUJDGB.js → chunk-24BHMKDD.js} +2 -2
  7. package/dist/{chunk-HJXXFPOL.js → chunk-27QADBDV.js} +2 -2
  8. package/dist/{chunk-V4VC25UL.js → chunk-2CVH5E57.js} +4 -4
  9. package/dist/{chunk-CCQNL33L.js → chunk-2DOR5SS6.js} +9 -9
  10. package/dist/{chunk-WRHFBCVY.js → chunk-2FNNAPCI.js} +3 -3
  11. package/dist/{chunk-OH7FA4TF.js → chunk-2L2Q53EP.js} +1 -1
  12. package/dist/{chunk-JRPI64AQ.js → chunk-2ND7ZITT.js} +17 -14
  13. package/dist/{chunk-QG6MOQLI.js → chunk-2QT5ZUHO.js} +17 -14
  14. package/dist/{chunk-YKO3VCTF.js → chunk-2RSG7JYI.js} +3 -3
  15. package/dist/{chunk-ERAIVAK5.js → chunk-2V6CLH33.js} +36 -3
  16. package/dist/{chunk-FGAGGPFF.js → chunk-2VWJ5BGO.js} +8 -8
  17. package/dist/{chunk-KPMGGE4W.js → chunk-2WNYRWHG.js} +1 -1
  18. package/dist/{chunk-R3WI7ZLE.js → chunk-323YZWYJ.js} +12 -9
  19. package/dist/{chunk-JA755JHN.js → chunk-33PB4V6K.js} +10 -7
  20. package/dist/{chunk-JLCAWQ3H.js → chunk-3A2IEBCN.js} +3 -3
  21. package/dist/{chunk-EKQMYG2B.js → chunk-3H2W76TB.js} +17 -17
  22. package/dist/{chunk-KFFNCDX6.js → chunk-3JEQGGVD.js} +3 -3
  23. package/dist/{chunk-SXGTRZFN.js → chunk-3QWZAEW5.js} +1 -1
  24. package/dist/{chunk-CYDZP5W6.js → chunk-3SQCCESO.js} +26 -23
  25. package/dist/{chunk-XW5J5JAX.js → chunk-3XHJHQWU.js} +2 -2
  26. package/dist/{chunk-JY4R3GML.js → chunk-4G2O2ZPJ.js} +1 -1
  27. package/dist/{chunk-COKHNEJP.js → chunk-4JLBVIGW.js} +3 -3
  28. package/dist/{chunk-M6KTNAND.js → chunk-4RRNJLCM.js} +8 -8
  29. package/dist/{chunk-A3ULWR5N.js → chunk-4UVW5WU6.js} +1 -1
  30. package/dist/{chunk-JSX3C6LL.js → chunk-4X66BTP5.js} +5 -5
  31. package/dist/{chunk-YQ2B3YVF.js → chunk-53OYF4ZT.js} +1 -1
  32. package/dist/{chunk-JL5BRMDT.js → chunk-57ZGVAU3.js} +1 -1
  33. package/dist/{chunk-S7VDRUED.js → chunk-5HECRVXJ.js} +1 -1
  34. package/dist/{chunk-7QDAHY5M.js → chunk-5LGSRWFC.js} +2 -2
  35. package/dist/{chunk-W7UZXD5D.js → chunk-5LYXD6ME.js} +18 -15
  36. package/dist/{chunk-QXILAMAU.js → chunk-66RFKRGO.js} +1 -1
  37. package/dist/{chunk-H57TJD3B.js → chunk-6OCR6ITN.js} +1 -1
  38. package/dist/{chunk-3GZECHOK.js → chunk-6RBTTCQD.js} +12 -12
  39. package/dist/{chunk-GH3ZMBFX.js → chunk-6Y7EXYLR.js} +11 -11
  40. package/dist/{chunk-RNOD2UWF.js → chunk-7CTKTIPF.js} +12 -12
  41. package/dist/{chunk-3W23F7EY.js → chunk-7EVIIADO.js} +1 -1
  42. package/dist/{chunk-ZSLGN6CO.js → chunk-7X2ZYVAX.js} +1 -1
  43. package/dist/{chunk-PEN2DK7T.js → chunk-A6CQPJWR.js} +2 -2
  44. package/dist/{chunk-ELYU6TRQ.js → chunk-ADKCLH3Z.js} +1 -1
  45. package/dist/{chunk-62FR4FYJ.js → chunk-ADWSGPH5.js} +2 -2
  46. package/dist/{chunk-TXINIAFL.js → chunk-AG2CJ4JY.js} +10 -5
  47. package/dist/{chunk-R5SWC3EW.js → chunk-AHQ4L3BE.js} +1 -1
  48. package/dist/{chunk-NLOMCLKI.js → chunk-AQROQDLR.js} +8 -8
  49. package/dist/{chunk-LC6DYCTG.js → chunk-AWTG3RFF.js} +1 -1
  50. package/dist/{chunk-E2HEVF23.js → chunk-B54RN2FD.js} +10 -10
  51. package/dist/{chunk-JFG4DHKQ.js → chunk-B67K6OWJ.js} +1 -1
  52. package/dist/{chunk-SGSPYHFE.js → chunk-B6GFKYBZ.js} +2 -2
  53. package/dist/{chunk-IZCOG3FS.js → chunk-BBRBCMNR.js} +4 -4
  54. package/dist/{chunk-KSYVTEKR.js → chunk-BMRD6MAH.js} +3 -3
  55. package/dist/{chunk-YTSSXSZR.js → chunk-BPKXEMRE.js} +3 -3
  56. package/dist/{chunk-CAE2HK2G.js → chunk-BWGRWGVA.js} +1 -1
  57. package/dist/{chunk-W2RGSGRR.js → chunk-BWLOXQDV.js} +6 -6
  58. package/dist/{chunk-EQT3EPTB.js → chunk-BWTX7LUG.js} +1 -1
  59. package/dist/{chunk-BKYMLFUG.js → chunk-C54QLNE4.js} +1 -1
  60. package/dist/{chunk-HFG76JTS.js → chunk-CAQ5P4VN.js} +3 -3
  61. package/dist/{chunk-HZQEQ34U.js → chunk-CCCEBIUZ.js} +3 -3
  62. package/dist/{chunk-DGDOGOTQ.js → chunk-CJGSJKPO.js} +3 -3
  63. package/dist/{chunk-AFK47A6O.js → chunk-CN7JRHST.js} +3 -3
  64. package/dist/{chunk-XDLQRSSH.js → chunk-CNX7EGSU.js} +2 -2
  65. package/dist/{chunk-DFKTS6XJ.js → chunk-COYOTQC2.js} +1 -1
  66. package/dist/{chunk-YFG4E3N2.js → chunk-CRNMNZJD.js} +14 -14
  67. package/dist/{chunk-3HHNQPAH.js → chunk-CUVUDK4O.js} +1 -1
  68. package/dist/{chunk-II7652VA.js → chunk-CWDHCSL2.js} +5 -4
  69. package/dist/{chunk-24WB3HMB.js → chunk-CYOJZ3GQ.js} +16 -6
  70. package/dist/{chunk-CRZKGHZ6.js → chunk-D7SHZDA3.js} +17 -19
  71. package/dist/chunk-DAVHGK27.js +657 -0
  72. package/dist/{chunk-NT3HAZYT.js → chunk-DCTCUZ5L.js} +1 -1
  73. package/dist/{chunk-S5ADHIZK.js → chunk-DDCB7ZA5.js} +28 -25
  74. package/dist/{chunk-7VXZDB45.js → chunk-DDI2W4TR.js} +1 -1
  75. package/dist/{chunk-KU4YS6HN.js → chunk-DIHUGBZO.js} +1 -1
  76. package/dist/{chunk-6UBEGKIQ.js → chunk-DJHIQWSG.js} +3 -3
  77. package/dist/{chunk-LO2DANS6.js → chunk-DO5OZJAO.js} +5 -5
  78. package/dist/{chunk-4SM2ONUC.js → chunk-DOFYKPTC.js} +1 -1
  79. package/dist/{chunk-3I6RANBJ.js → chunk-DRW6KGBK.js} +36 -32
  80. package/dist/{chunk-2UVTHU7A.js → chunk-DU4A5AOY.js} +37 -27
  81. package/dist/{chunk-5KWXRYAT.js → chunk-DYS7EIXY.js} +6 -6
  82. package/dist/{chunk-YP3I6W7T.js → chunk-E4IQ6M4S.js} +3 -3
  83. package/dist/{chunk-2AKWCMS4.js → chunk-EFUWFB64.js} +3 -3
  84. package/dist/{chunk-C64FBRJO.js → chunk-EHBB2Z4D.js} +5 -5
  85. package/dist/{chunk-FT3F72C3.js → chunk-EHVESNLV.js} +1 -1
  86. package/dist/{chunk-6JUJ2DU3.js → chunk-EJPVVGD7.js} +37 -37
  87. package/dist/{chunk-XEGRWWNO.js → chunk-EUADDXAV.js} +2 -2
  88. package/dist/{chunk-WVSNSWBJ.js → chunk-F6CNPC4L.js} +1 -1
  89. package/dist/{chunk-33CBPK5Q.js → chunk-FBAYZSFC.js} +51 -45
  90. package/dist/{chunk-QETGGFH2.js → chunk-FBB4BWKN.js} +3 -3
  91. package/dist/{chunk-TSR5YDPS.js → chunk-FF23FYQD.js} +23 -20
  92. package/dist/{chunk-DLC23CKC.js → chunk-FG6EDGMI.js} +1 -1
  93. package/dist/{chunk-PTVOXB5T.js → chunk-FHA3KMFC.js} +6 -2
  94. package/dist/{chunk-WDUNR2VI.js → chunk-FV3VF36K.js} +21 -18
  95. package/dist/{chunk-S4F27M7N.js → chunk-G5FMTRG5.js} +2 -2
  96. package/dist/{chunk-WHSTEAVP.js → chunk-GCBOHVDZ.js} +1 -1
  97. package/dist/{chunk-YHTO46W2.js → chunk-GTG3IGLF.js} +35 -31
  98. package/dist/{chunk-COYPDRJK.js → chunk-GZTNTHSW.js} +2 -2
  99. package/dist/{chunk-3XQ635KD.js → chunk-H5G7T35P.js} +3 -3
  100. package/dist/{chunk-UZF3G2FN.js → chunk-H63XQ3OO.js} +5 -5
  101. package/dist/{chunk-F77BNDAT.js → chunk-H67RTX46.js} +2 -2
  102. package/dist/{chunk-2MTWKMEG.js → chunk-HA4IPWMM.js} +1 -1
  103. package/dist/{chunk-XY5O74BH.js → chunk-HKYTOJLV.js} +3 -3
  104. package/dist/{chunk-ZVTFZF4V.js → chunk-HOAH5XBR.js} +8 -8
  105. package/dist/{chunk-S62M63LU.js → chunk-HYY5V2KL.js} +3 -3
  106. package/dist/{chunk-5C7TWNYZ.js → chunk-HZI56ASJ.js} +1 -1
  107. package/dist/{chunk-2DHJJ2EN.js → chunk-I6VAWNNU.js} +3 -3
  108. package/dist/{chunk-QVABTUDS.js → chunk-IBXXZVG7.js} +7 -7
  109. package/dist/{chunk-JETXFF3M.js → chunk-IK4BHOPZ.js} +1 -1
  110. package/dist/{chunk-Z256ACGC.js → chunk-IL5T7I2A.js} +2 -2
  111. package/dist/{chunk-A7A4PDG5.js → chunk-ILSXT6KT.js} +3 -3
  112. package/dist/{chunk-Y4PXIJMD.js → chunk-IYMI7YI4.js} +14 -14
  113. package/dist/{chunk-5DJXJXDE.js → chunk-J6I2YFJH.js} +1 -1
  114. package/dist/{chunk-KS7DXCXH.js → chunk-JR7Y5ONB.js} +3 -3
  115. package/dist/{chunk-GZ4RHGIW.js → chunk-JSEYUJUQ.js} +19 -19
  116. package/dist/{chunk-3ZCKEANJ.js → chunk-K3HSQPSM.js} +3 -3
  117. package/dist/{chunk-VB2MJLET.js → chunk-KPKXJYQH.js} +1 -1
  118. package/dist/{chunk-XDS4UZGR.js → chunk-KSJVENRU.js} +3 -3
  119. package/dist/{chunk-2SGIHKKU.js → chunk-KZJOV4QW.js} +1 -1
  120. package/dist/{chunk-GQS46LC3.js → chunk-KZS46KDY.js} +11 -3
  121. package/dist/{chunk-XTNV2YMB.js → chunk-L3JWM7FR.js} +1 -1
  122. package/dist/{chunk-HX3MQ3H4.js → chunk-L4S6UFTL.js} +3 -3
  123. package/dist/{chunk-K2HNV4LE.js → chunk-L6DJ4ZY5.js} +12 -12
  124. package/dist/{chunk-Z5VSLLNY.js → chunk-L7RHB734.js} +1 -1
  125. package/dist/{chunk-YI2ZVTCB.js → chunk-LCWJS34U.js} +1 -1
  126. package/dist/{chunk-MEISCROL.js → chunk-LFTAMH7I.js} +3 -3
  127. package/dist/{chunk-B2EBEXIS.js → chunk-LFX7W4B7.js} +1 -1
  128. package/dist/chunk-LINZPU5D.js +8 -0
  129. package/dist/{chunk-ORUJI3VB.js → chunk-LIWLBLCT.js} +1 -1
  130. package/dist/{chunk-HUF6TQ2J.js → chunk-LS7HVBI7.js} +3 -3
  131. package/dist/{chunk-TTR7EWNH.js → chunk-M4EUXOLU.js} +4 -4
  132. package/dist/{chunk-A2FHZH7E.js → chunk-MBKZYJRC.js} +35 -21
  133. package/dist/{chunk-76ANFJOI.js → chunk-MCYM3RNF.js} +1 -1
  134. package/dist/{chunk-MDYLOIS2.js → chunk-MF6IVSBJ.js} +1 -1
  135. package/dist/{chunk-FOKEGVPB.js → chunk-MIAPBQCA.js} +3 -3
  136. package/dist/{chunk-D4BIV6WG.js → chunk-MJZHFH5R.js} +19 -16
  137. package/dist/{chunk-A5JWFZVU.js → chunk-MQFCG4KS.js} +79 -79
  138. package/dist/{chunk-CS4DHFNG.js → chunk-MVV6RQMG.js} +2 -2
  139. package/dist/{chunk-NG5IGZXC.js → chunk-MYMT5KJL.js} +23 -20
  140. package/dist/{chunk-GULJ6KVT.js → chunk-MZL6LGKO.js} +14 -14
  141. package/dist/{chunk-5T5YW52S.js → chunk-N23YFPPI.js} +1 -1
  142. package/dist/{chunk-UEU46Q3D.js → chunk-N3G2FYDL.js} +6 -6
  143. package/dist/{chunk-7IFLQMJL.js → chunk-N3TPMXS3.js} +5 -4
  144. package/dist/{chunk-B67K5X4M.js → chunk-N73IBH55.js} +1 -1
  145. package/dist/{chunk-QHFQHQDC.js → chunk-N7J7CZS6.js} +2 -2
  146. package/dist/{chunk-7JVAQX6C.js → chunk-NCB3YLHF.js} +4 -4
  147. package/dist/{chunk-NEVSQGOI.js → chunk-NHQGRKEA.js} +2 -2
  148. package/dist/{chunk-GWQIXU37.js → chunk-NKIYLFXZ.js} +12 -12
  149. package/dist/{chunk-4DNOEV3Q.js → chunk-NOSDEJ3K.js} +79 -2
  150. package/dist/{chunk-V4DYVLOO.js → chunk-NQDVMUHX.js} +5 -5
  151. package/dist/{chunk-TXZBBZOG.js → chunk-NSSNYY6Y.js} +2 -2
  152. package/dist/{chunk-6XE3GVGU.js → chunk-NY5NUFDZ.js} +3 -2
  153. package/dist/{chunk-TPZB2YWR.js → chunk-O3S2KNIW.js} +2 -2
  154. package/dist/{chunk-OAPCJO6W.js → chunk-O3VN6BTL.js} +1 -0
  155. package/dist/chunk-ONZLC47B.js +88 -0
  156. package/dist/{chunk-RSWVH7DB.js → chunk-OUEGGWH7.js} +3 -3
  157. package/dist/{chunk-AZOUSKZD.js → chunk-OURX73UJ.js} +1 -1
  158. package/dist/{chunk-XPWRD424.js → chunk-P25VEGGX.js} +3 -3
  159. package/dist/{chunk-NMCOUVN5.js → chunk-P26Z62UV.js} +3 -3
  160. package/dist/{chunk-WMJPFLF3.js → chunk-P5RNWMZC.js} +29 -25
  161. package/dist/{chunk-XYONCO5Q.js → chunk-P6KZIZDV.js} +19 -16
  162. package/dist/{chunk-S53OGZL6.js → chunk-PEUSKIFV.js} +1 -1
  163. package/dist/{chunk-GZ2VNM4L.js → chunk-PFVTYFSL.js} +3 -3
  164. package/dist/{chunk-ALKTNXMR.js → chunk-Q3CV2JJ2.js} +31 -31
  165. package/dist/{chunk-X7TXGKRX.js → chunk-QO6HEXIZ.js} +6 -6
  166. package/dist/{chunk-EC2NAYPQ.js → chunk-QOIVXZUF.js} +3 -3
  167. package/dist/{chunk-JMH5MD5A.js → chunk-QSXK6PJL.js} +1 -1
  168. package/dist/{chunk-MCOIEWW6.js → chunk-QTZVVZ2A.js} +1 -1
  169. package/dist/{chunk-27QQEWNV.js → chunk-QWXWVPNE.js} +2 -2
  170. package/dist/{chunk-LC3PSQJJ.js → chunk-QY5ZKUWY.js} +1 -1
  171. package/dist/{chunk-PUVGWJQ5.js → chunk-RA66JA3D.js} +4 -4
  172. package/dist/{chunk-SLTMRTXV.js → chunk-REOPXBUR.js} +15 -12
  173. package/dist/{chunk-ASAON7G4.js → chunk-RGZGLKFB.js} +4 -4
  174. package/dist/{chunk-GQPESFAF.js → chunk-RL3NUWMY.js} +7 -7
  175. package/dist/{chunk-ETHWK2RZ.js → chunk-RNOJSEES.js} +1 -1
  176. package/dist/{chunk-KYELSLDJ.js → chunk-RPIW5T55.js} +1 -1
  177. package/dist/{chunk-XO5ONLVM.js → chunk-S32YYDIB.js} +1 -1
  178. package/dist/{chunk-QN6JHMGU.js → chunk-S4QSJAGY.js} +1 -1
  179. package/dist/{chunk-UQSVWO7Z.js → chunk-S6UX7KB6.js} +8 -7
  180. package/dist/{chunk-IZ35GMGB.js → chunk-SDSONLMZ.js} +13 -10
  181. package/dist/{chunk-S4ONWRJE.js → chunk-SKRSCTT5.js} +2 -2
  182. package/dist/{chunk-TVHLKVUO.js → chunk-SMCDXUIO.js} +3 -3
  183. package/dist/{chunk-JLZM7XMZ.js → chunk-SPTPFY4S.js} +14 -11
  184. package/dist/{chunk-A6XCAQ52.js → chunk-SREWFAAJ.js} +7 -6
  185. package/dist/{chunk-2JAWQ7VV.js → chunk-SS42FJVN.js} +11 -10
  186. package/dist/{chunk-I322G5UG.js → chunk-SVZDXFPX.js} +17 -14
  187. package/dist/{chunk-627P6T25.js → chunk-TBGUEF3M.js} +21 -18
  188. package/dist/{chunk-OLNORNCT.js → chunk-TGK6KUGN.js} +4 -4
  189. package/dist/{chunk-PGIQMQRU.js → chunk-TJSND556.js} +227 -94
  190. package/dist/{chunk-V422EKLW.js → chunk-TKOJZQAJ.js} +3 -3
  191. package/dist/{chunk-DVKBU23L.js → chunk-TM4OC53S.js} +1 -1
  192. package/dist/{chunk-ZJKOLOVF.js → chunk-TWOREVKJ.js} +26 -20
  193. package/dist/{chunk-IDTLHPTK.js → chunk-TXS3U77A.js} +2 -2
  194. package/dist/{chunk-VYMGZ27S.js → chunk-UB6ODJHO.js} +3 -2
  195. package/dist/{chunk-RNXITK5M.js → chunk-UBZXQIDR.js} +3 -3
  196. package/dist/{chunk-IN4QT33I.js → chunk-ULTSSIOU.js} +1 -1
  197. package/dist/{chunk-QNHZXFRA.js → chunk-V6O6KVOA.js} +3 -3
  198. package/dist/{chunk-TPYV2FTV.js → chunk-VERLFNWR.js} +3 -3
  199. package/dist/{chunk-ATTE3FYC.js → chunk-VH2UUU7K.js} +3 -3
  200. package/dist/{chunk-V667FCIJ.js → chunk-VJ3FCGQF.js} +1 -1
  201. package/dist/{chunk-FT47HQ5U.js → chunk-VK5ZDV67.js} +4 -4
  202. package/dist/{chunk-RJQ5YS3Q.js → chunk-VKQNDOAI.js} +4 -4
  203. package/dist/{chunk-5ENRZX6I.js → chunk-VTEV3WVF.js} +19 -16
  204. package/dist/{chunk-35DZP2R2.js → chunk-WI5ITCOH.js} +2 -2
  205. package/dist/{chunk-A372DLQX.js → chunk-X4YNDLVA.js} +3 -3
  206. package/dist/{chunk-GDQ3NGDZ.js → chunk-X6SUFTD7.js} +2 -2
  207. package/dist/{chunk-NYEY6W5R.js → chunk-XJI6SWFS.js} +8 -8
  208. package/dist/{chunk-Q6XJOJTY.js → chunk-XJP5DKIL.js} +2 -2
  209. package/dist/{chunk-BVWU6GOB.js → chunk-XN4ARQ2W.js} +2 -2
  210. package/dist/{chunk-MJMJEURO.js → chunk-XN7MQO45.js} +10 -10
  211. package/dist/{chunk-HUFCSX2Y.js → chunk-XQCQZBGX.js} +17 -6
  212. package/dist/{chunk-MFLH5ZDQ.js → chunk-XXOHXA3A.js} +2 -2
  213. package/dist/{chunk-WJMUMN3I.js → chunk-XZOHR765.js} +2 -2
  214. package/dist/{chunk-IXSZ7OKR.js → chunk-YCNLQYTC.js} +1 -1
  215. package/dist/{chunk-MNJ2DHU6.js → chunk-YCRGWQBS.js} +8 -8
  216. package/dist/{chunk-YEDYBMCW.js → chunk-YF2PYLC4.js} +1 -1
  217. package/dist/{chunk-MIXKQJ64.js → chunk-YG5GUELW.js} +17 -17
  218. package/dist/{chunk-RTJXOIIQ.js → chunk-YWP7XFKD.js} +1 -1
  219. package/dist/{chunk-WYJMV62X.js → chunk-Z6CL7AR6.js} +3 -3
  220. package/dist/{chunk-A5LZUYK4.js → chunk-ZMF7WEGG.js} +3 -2
  221. package/dist/{chunk-NXNQQ3DS.js → chunk-ZNHFLJSY.js} +7 -14
  222. package/dist/{chunk-EWVKBRLV.js → chunk-ZQF34VPS.js} +2 -2
  223. package/dist/{chunk-H7UZZ7KP.js → chunk-ZU425HNM.js} +3 -3
  224. package/dist/{chunk-YAYRRKC7.js → chunk-ZZU5R5UU.js} +3 -3
  225. package/dist/cli/index.js +2 -2
  226. package/dist/{core-KBH3EJZV.js → core-3VCCUFVX.js} +1 -1
  227. package/dist/{core-E6YD7VU4.js → core-4BZQQSHS.js} +2 -1
  228. package/dist/{core-6LLJNZ4O.js → core-4VT4MHNB.js} +2 -1
  229. package/dist/{core-ZH7XTJTD.js → core-5535KXRD.js} +2 -1
  230. package/dist/{core-JQV7STNF.js → core-5HQBPCHL.js} +2 -1
  231. package/dist/{core-QUYSNTC7.js → core-6RYHWUJO.js} +2 -1
  232. package/dist/{core-SCWEVNUY.js → core-7BZJCIXN.js} +2 -1
  233. package/dist/{core-KFBW5PRT.js → core-AJTVU6X7.js} +2 -1
  234. package/dist/{core-EE55P6XK.js → core-C6YUSTZI.js} +2 -1
  235. package/dist/{core-IV26EL5C.js → core-EEB7HTCL.js} +2 -1
  236. package/dist/{core-DBRILYNB.js → core-EFMVDWNH.js} +1 -1
  237. package/dist/{core-IZVZ2B7Y.js → core-ETAGQBZO.js} +1 -1
  238. package/dist/{core-RY6IFRKM.js → core-FVR3WZEC.js} +2 -1
  239. package/dist/{core-RE3L6YCM.js → core-GCTFVYMH.js} +1 -1
  240. package/dist/{core-CPN2HF75.js → core-GES44OTS.js} +1 -1
  241. package/dist/{core-WLVU2HWX.js → core-GGQREDSI.js} +2 -1
  242. package/dist/{core-ZJYLJWZQ.js → core-HRYOV6QD.js} +1 -1
  243. package/dist/{core-KWGXHBJE.js → core-IKD3EE3S.js} +2 -1
  244. package/dist/{core-MZMR2DF4.js → core-JM4R426L.js} +1 -1
  245. package/dist/{core-RUA3EWW3.js → core-KKQS3WI2.js} +2 -1
  246. package/dist/{core-6ANZ2OWO.js → core-LA6XDYG7.js} +1 -1
  247. package/dist/{core-CS7AKNME.js → core-MJ7JWQT5.js} +1 -1
  248. package/dist/{core-XXIOJY2X.js → core-MLROKJ2M.js} +2 -1
  249. package/dist/{core-5Z6UW5DS.js → core-MR52YBRX.js} +1 -1
  250. package/dist/{core-OK2ZY5OJ.js → core-NP4VHWXL.js} +1 -1
  251. package/dist/{core-OW5V74Q4.js → core-NQLNZDX5.js} +2 -1
  252. package/dist/{core-OV5MPTZP.js → core-NSIJEKLI.js} +2 -1
  253. package/dist/{core-DU77ZYPR.js → core-OJUQLIQ5.js} +2 -1
  254. package/dist/{core-T5Q4DSH2.js → core-PB3VUQSS.js} +1 -1
  255. package/dist/{core-SE67HHFG.js → core-Q6VLFFYC.js} +2 -1
  256. package/dist/{core-ZHE7N4NS.js → core-QY7AVIKZ.js} +2 -1
  257. package/dist/{core-WQPHNVNY.js → core-SBQMHWTA.js} +2 -1
  258. package/dist/{core-TJX3I7KH.js → core-UHECQHJ2.js} +2 -1
  259. package/dist/{core-ULUA5ZB2.js → core-V5FV4NWL.js} +2 -1
  260. package/dist/{core-PL64QPOH.js → core-WGM4XUN3.js} +2 -1
  261. package/dist/{core-PVINU5JJ.js → core-WUQVFARS.js} +2 -1
  262. package/dist/{core-FFLPH5XK.js → core-Z2F3IGSR.js} +2 -1
  263. package/dist/{dataTable-IL7HVDHL.js → dataTable-3CPPIHB3.js} +2 -2
  264. package/dist/{engine-MYLZI5VH.js → engine-FXFBCWHB.js} +11 -11
  265. package/dist/fixtures.js +2 -1
  266. package/dist/{fontTables-ZYBUCJ5N.js → fontTables-WYCZNRE7.js} +1 -1
  267. package/dist/fonts.js +1 -1
  268. package/dist/index.js +19 -18
  269. package/dist/{main-ISJ53IS5.js → main-YLKBTHJP.js} +11 -10
  270. package/dist/mcp/server.js +16 -14
  271. package/dist/react/bar.js +2 -1
  272. package/dist/react/bartable.js +1 -1
  273. package/dist/react/box.js +2 -1
  274. package/dist/react/bullet.js +2 -1
  275. package/dist/react/butterfly.js +2 -1
  276. package/dist/react/choropleth.js +1 -1
  277. package/dist/react/cohort.js +2 -1
  278. package/dist/react/column.js +2 -1
  279. package/dist/react/combo.js +2 -1
  280. package/dist/react/creative.js +1 -1
  281. package/dist/react/diagram.js +1 -1
  282. package/dist/react/dimswitch.js +2 -1
  283. package/dist/react/dot.js +2 -1
  284. package/dist/react/export.js +18 -17
  285. package/dist/react/funnel.js +2 -1
  286. package/dist/react/gantt.js +1 -1
  287. package/dist/react/grid.js +2 -1
  288. package/dist/react/heatmap.js +2 -1
  289. package/dist/react/histogram.js +2 -1
  290. package/dist/react/index.js +85 -84
  291. package/dist/react/kpi.js +1 -1
  292. package/dist/react/likert.js +2 -1
  293. package/dist/react/line.js +2 -1
  294. package/dist/react/mekko.js +2 -1
  295. package/dist/react/pareto.js +2 -1
  296. package/dist/react/pie.js +2 -1
  297. package/dist/react/prepare.js +19 -18
  298. package/dist/react/pvm.js +2 -1
  299. package/dist/react/pyramid.js +2 -1
  300. package/dist/react/sankey.js +1 -1
  301. package/dist/react/scatter.js +2 -1
  302. package/dist/react/slope.js +2 -1
  303. package/dist/react/sparkline.js +1 -1
  304. package/dist/react/spec.js +35 -26
  305. package/dist/react/status.js +1 -1
  306. package/dist/react/story.js +3 -3
  307. package/dist/react/table.js +2 -1
  308. package/dist/react/theme.js +3 -3
  309. package/dist/react/tilemap.js +1 -1
  310. package/dist/react/treemap.js +1 -1
  311. package/dist/react/variance.js +2 -1
  312. package/dist/react/waffle.js +1 -1
  313. package/dist/react/waterfall.js +2 -1
  314. package/dist/rows.js +2 -2
  315. package/dist/{rowsModule-3Y4I3M3E.js → rowsModule-YVLAROIP.js} +1 -1
  316. package/dist/{schema-QJJPRRE7.js → schema-2K6C3U24.js} +2 -1
  317. package/dist/{schema-STGL44TL.js → schema-2KIHLTYI.js} +2 -1
  318. package/dist/{schema-4735XAZX.js → schema-4HY2MWZC.js} +2 -1
  319. package/dist/{schema-PDZ6256H.js → schema-4S5CXHAO.js} +2 -1
  320. package/dist/{schema-XYYDUUHS.js → schema-5BKQV56C.js} +2 -1
  321. package/dist/{schema-JJYJOQTT.js → schema-5HA5DSYN.js} +2 -1
  322. package/dist/{schema-W376PAJG.js → schema-5NKJPSBD.js} +2 -1
  323. package/dist/{schema-IF5N3J56.js → schema-65FOKNHK.js} +2 -1
  324. package/dist/{schema-TQYTESG3.js → schema-6OHZWHUI.js} +2 -1
  325. package/dist/{schema-IG7JIR4H.js → schema-6RYJS2GM.js} +2 -1
  326. package/dist/{schema-P7LJFJAJ.js → schema-6W4M3WJ4.js} +2 -1
  327. package/dist/{schema-GH7IKSOU.js → schema-7TLSFG6M.js} +2 -1
  328. package/dist/{schema-2GUBWOBC.js → schema-AMFRKUFS.js} +2 -1
  329. package/dist/{schema-7J3NAIN2.js → schema-B7CZPPB4.js} +2 -1
  330. package/dist/{schema-34ZELWRQ.js → schema-BNRNHGHQ.js} +2 -1
  331. package/dist/{schema-PA2MXYY4.js → schema-E4MRCGPZ.js} +2 -1
  332. package/dist/{schema-L7263JMT.js → schema-F3WYTR65.js} +2 -1
  333. package/dist/{schema-3BHL2B76.js → schema-FA6XIHTW.js} +2 -1
  334. package/dist/{schema-5YTNQ6JY.js → schema-GZNOW4LX.js} +2 -1
  335. package/dist/{schema-QEVSIMGO.js → schema-HEIDGCSL.js} +2 -1
  336. package/dist/{schema-EQQB43AY.js → schema-JB2H6KPA.js} +2 -1
  337. package/dist/{schema-2BMZOHXI.js → schema-MPXZNWV3.js} +2 -1
  338. package/dist/{schema-G4KFMQBL.js → schema-NHNQK6XO.js} +2 -1
  339. package/dist/{schema-CVMV4LRA.js → schema-NN6UPDPW.js} +2 -1
  340. package/dist/{schema-AOJJ7JZB.js → schema-O4YNAGIY.js} +2 -1
  341. package/dist/{schema-E6YOSOWB.js → schema-O7AKK232.js} +2 -1
  342. package/dist/{schema-E2ISJ65D.js → schema-OJCML6LV.js} +2 -1
  343. package/dist/{schema-P63S63GE.js → schema-ORTRMYI6.js} +2 -1
  344. package/dist/{schema-EYZVD73N.js → schema-PJ6P52BC.js} +2 -1
  345. package/dist/{schema-S3EQKVOT.js → schema-RTWES6NR.js} +2 -1
  346. package/dist/{schema-EYQ5IBLF.js → schema-S36SRYGO.js} +2 -1
  347. package/dist/{schema-D3RCMN3T.js → schema-S3TCLTYD.js} +2 -1
  348. package/dist/{schema-MEAFRXVH.js → schema-SWWMOLOR.js} +3 -2
  349. package/dist/{schema-PNC3Z7AH.js → schema-WOSEZNKG.js} +2 -1
  350. package/dist/{schema-T4NE2EAO.js → schema-Y6KBWUUR.js} +2 -1
  351. package/dist/{schema-EVLLL5UF.js → schema-YQYTLKSW.js} +2 -1
  352. package/dist/{schema-KFC4WYH4.js → schema-ZUUUY3QS.js} +2 -1
  353. package/dist/{specValidation-NVBIZMEE.js → specValidation-VNWIKLHH.js} +2 -1
  354. package/dist/theme.js +2 -2
  355. package/dist/{themeShapeRules-5C2463YH.js → themeShapeRules-2D3KWSPQ.js} +1 -1
  356. package/dist/types/core/charts/gantt/layout.d.ts +7 -0
  357. package/dist/types/core/charts/grid/schema.d.ts +1 -1
  358. package/dist/types/core/formatSpec.d.ts +2 -0
  359. package/dist/types/core/label/solver.d.ts +5 -1
  360. package/dist/types/core/rows.d.ts +2 -0
  361. package/dist/types/core/types/annotations.d.ts +6 -2
  362. package/dist/types/core/types/data.d.ts +8 -3
  363. package/dist/types/react/spec.d.ts +17 -0
  364. package/dist/types/rows.d.ts +6 -1
  365. package/dist/validate.js +7 -6
  366. package/docs/manual.md +14 -2
  367. package/docs/reference/box.md +1 -1
  368. package/docs/reference/fixtures.md +1 -0
  369. package/docs/reference/gantt.md +11 -5
  370. package/docs/reference/histogram.md +1 -1
  371. package/docs/reference/line.md +1 -1
  372. package/docs/reference/react.md +3 -0
  373. package/docs/reference/table.md +1 -1
  374. package/llms.txt +3 -3
  375. package/package.json +1 -1
  376. package/dist/chunk-2GELJH37.js +0 -88
  377. package/dist/chunk-4GB7TBY7.js +0 -373
@@ -6,7 +6,7 @@ import {
6
6
  legendPanelDataSchema,
7
7
  metricStackDataSchema,
8
8
  textPanelDataSchema
9
- } from "./chunk-NXNQQ3DS.js";
9
+ } from "./chunk-ZNHFLJSY.js";
10
10
 
11
11
 
12
12
 
@@ -14,7 +14,8 @@ import {
14
14
  normalizeGridData,
15
15
  parseGridLegendPanelData,
16
16
  parseGridTextPanelData
17
- } from "./chunk-JL5BRMDT.js";
17
+ } from "./chunk-57ZGVAU3.js";
18
+
18
19
 
19
20
 
20
21
 
@@ -1,7 +1,8 @@
1
1
  import {
2
2
  tilemapDataSchema,
3
3
  tilemapOptionsSchema
4
- } from "./chunk-PEN2DK7T.js";
4
+ } from "./chunk-A6CQPJWR.js";
5
+
5
6
 
6
7
 
7
8
 
@@ -1,7 +1,8 @@
1
1
  import {
2
2
  bartableDataSchema,
3
3
  bartableOptionsSchema
4
- } from "./chunk-VYMGZ27S.js";
4
+ } from "./chunk-UB6ODJHO.js";
5
+
5
6
 
6
7
 
7
8
 
@@ -1,7 +1,8 @@
1
1
  import {
2
2
  likertDataSchema,
3
3
  likertOptionsSchema
4
- } from "./chunk-JY4R3GML.js";
4
+ } from "./chunk-4G2O2ZPJ.js";
5
+
5
6
 
6
7
 
7
8
 
@@ -2,7 +2,7 @@ import {
2
2
  tableDataSchema,
3
3
  tableOptionsObject,
4
4
  tableOptionsSchema
5
- } from "./chunk-UQSVWO7Z.js";
5
+ } from "./chunk-S6UX7KB6.js";
6
6
 
7
7
 
8
8
 
@@ -24,6 +24,7 @@ import {
24
24
 
25
25
 
26
26
 
27
+
27
28
  export {
28
29
  STATUS_VALUES,
29
30
  tableDataSchema,
@@ -2,7 +2,8 @@ import {
2
2
  BoardplotSpecError,
3
3
  beginSpecParse,
4
4
  specSettings
5
- } from "./chunk-C64FBRJO.js";
5
+ } from "./chunk-EHBB2Z4D.js";
6
+
6
7
 
7
8
 
8
9
 
package/dist/theme.js CHANGED
@@ -1,11 +1,11 @@
1
1
  import {
2
2
  linkThemeShapeRules
3
- } from "./chunk-CAE2HK2G.js";
3
+ } from "./chunk-BWGRWGVA.js";
4
4
  import {
5
5
  registerTheme,
6
6
  resolveTheme,
7
7
  typeForTarget
8
- } from "./chunk-II7652VA.js";
8
+ } from "./chunk-CWDHCSL2.js";
9
9
 
10
10
 
11
11
 
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  linkThemeShapeRules
3
- } from "./chunk-CAE2HK2G.js";
3
+ } from "./chunk-BWGRWGVA.js";
4
4
 
5
5
 
6
6
 
@@ -19,6 +19,13 @@ export interface GanttOptions extends Omit<BaseOptionsFor<'gantt'>, 'labels'> {
19
19
  rowTint?: boolean;
20
20
  /** Headers for the existing cols positions, up to three. Extra headers without a column are ignored. */
21
21
  colHeaders?: string[];
22
+ /** Calendar head and span. */
23
+ calendar?: {
24
+ /** 'isoWeek' (default): week cells read "W11". 'startDay': the day of the month each week cell starts on. Week granularity only. */
25
+ weeks?: 'isoWeek' | 'startDay';
26
+ /** 'periods' (default): whole calendar periods. 'data': from the first item to the later of the last item end and today. */
27
+ span?: 'periods' | 'data';
28
+ };
22
29
  }
23
30
  /** Minor calendar unit of the header (major is derived from it). */
24
31
  export type GanttGranularity = 'weeks' | 'months' | 'quarters';
@@ -67,7 +67,7 @@ export declare const gridDataSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly
67
67
  title: z.ZodOptional<z.ZodString>;
68
68
  caption: z.ZodOptional<z.ZodString>;
69
69
  data: z.ZodUnion<readonly [z.ZodObject<{
70
- bySlice: z.ZodRecord<z.ZodString, z.ZodUnknown>;
70
+ bySlice: z.ZodNonOptional<z.ZodPipe<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodUnknown>, unknown>, z.ZodTransform<Record<string, unknown>, Record<string, unknown>>>>;
71
71
  }, z.core.$strict>, z.ZodObject<{
72
72
  categories: z.ZodArray<z.ZodUnknown>;
73
73
  series: z.ZodArray<z.ZodUnknown>;
@@ -282,6 +282,8 @@ export declare function seriesRasterFormatter(example: string | undefined, value
282
282
  fmtSigned: (value: number) => string;
283
283
  /** An authored percent cell ({ pct }): the exhibit raster with '%', unless an example sets the style. */
284
284
  fmtPercent: (value: number) => string;
285
+ /** The spec fmtPercent prints with, for a value axis whose ticks print what the percent cells print. */
286
+ percentSpec: NumberFormatSpec;
285
287
  /** `values` gives the series' numbers where it is not a normalized series (`vals` or `cells`). */
286
288
  forSeries: (series: {
287
289
  format?: string;
@@ -76,7 +76,9 @@ export interface SlotCandidate {
76
76
  * not block this slot; a label placed across one gets a halo. For the one
77
77
  * seat that keeps a row of values on one reading line: a value floated
78
78
  * above the line, or into its bar, breaks that line for the one bar that
79
- * reaches it.
79
+ * reaches it. A claim of part CROSSABLE_RULE_PART (a gantt event or
80
+ * today rule, which breaks around the label) does not block it either,
81
+ * and gives no halo.
80
82
  */
81
83
  overRules?: boolean;
82
84
  /** The seat lies on the key line, right of its entries: the legend's whole-row claim does not block it (the chart checked the entries). */
@@ -336,6 +338,8 @@ export declare function leaderPieces(d: string, steps?: number): [Point, Point][
336
338
  * Penalty of a seat a chart offers only after every other (a line end past the plot's edge):
337
339
  * ownership keeps it behind the led seats too.
338
340
  */
341
+ /** A rule claim an overRules seat may cross; the rule breaks around the label, so the label needs no halo. */
342
+ export declare const CROSSABLE_RULE_PART = "crossableRule";
339
343
  export declare const LAST_RESORT_PENALTY = 200;
340
344
  export declare function sameOwner(a: OwnerRef, b: OwnerRef): boolean;
341
345
  /**
@@ -15,6 +15,7 @@ export interface RowsSource {
15
15
  */
16
16
  tilePack?: (id: TilePackId) => TilePack;
17
17
  }
18
+ /** Generated data pointer, or a table cell rows[<row id>].cells[<column id>] (engine display path or finding owner) -> the row field it came from. */
18
19
  export type RowsPathMap = Map<string, {
19
20
  path: string;
20
21
  displayPath: string;
@@ -42,4 +43,5 @@ export declare function rewriteRowsDiagnostics<T extends {
42
43
  fix?: {
43
44
  path: string;
44
45
  }[];
46
+ owner?: unknown;
45
47
  }>(findings: T[], pathMap?: RowsPathMap): T[];
@@ -157,8 +157,12 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
157
157
  tone?: EventTone;
158
158
  /** 'key' sends this event to the numbered key; 'auto' (default) lets the lane decide. */
159
159
  placement?: 'auto' | 'key';
160
- /** Line charts: 'inline' sets the block beside the rule inside the plot. */
161
- labelPlacement?: 'top' | 'inline';
160
+ /**
161
+ * Line charts: 'inline' sets the block beside the rule inside the plot.
162
+ * Gantt: 'badge' draws the label, at most 3 characters, in a filled
163
+ * circle at the top of the rule, with no footnote key.
164
+ */
165
+ labelPlacement?: 'top' | 'inline' | 'badge';
162
166
  });
163
167
  /**
164
168
  * Where a delta or diff between two series at the last category stands
@@ -258,7 +258,8 @@ export interface GridData {
258
258
  }
259
259
  export interface GanttItem {
260
260
  id: Id;
261
- kind: 'bar' | 'milestone' | 'chevron' | 'bracket' | 'shade';
261
+ /** 'rule': a quiet neutral line with a muted label, for the state before a change; it takes no colour and no key entry. */
262
+ kind: 'bar' | 'milestone' | 'chevron' | 'bracket' | 'shade' | 'rule';
262
263
  start: string;
263
264
  end?: string;
264
265
  label?: string;
@@ -273,14 +274,16 @@ export interface GanttItem {
273
274
  offsetDays?: number;
274
275
  };
275
276
  }
276
- /** A metadata cell with a tone: a filled marker in the tone's colour before its text. */
277
+ /** A metadata cell: text, with an optional tone drawn as a filled marker in the tone's colour before it. */
277
278
  export interface GanttCell {
278
279
  text: string;
279
- tone: 'good' | 'warn' | 'bad' | 'neutral';
280
+ tone?: 'good' | 'warn' | 'bad' | 'neutral';
280
281
  }
281
282
  export interface GanttTaskRow {
282
283
  id: Id;
283
284
  label: string;
285
+ /** Second, muted line under the row name, such as what the row measures. */
286
+ sublabel?: string;
284
287
  kind?: 'task';
285
288
  indent?: number;
286
289
  cols?: (string | GanttCell)[];
@@ -289,6 +292,8 @@ export interface GanttTaskRow {
289
292
  export interface GanttCadenceRow {
290
293
  id: Id;
291
294
  label: string;
295
+ /** Second, muted line under the row name. */
296
+ sublabel?: string;
292
297
  kind: 'cadence';
293
298
  indent?: number;
294
299
  cols?: (string | GanttCell)[];
@@ -2,6 +2,7 @@ import { type KeyboardEvent, type MouseEvent, type ReactElement } from 'react';
2
2
  import type { InteractionRecord } from '../core/a11y/types.js';
3
3
  import type { ZoomOption } from './useZoom.js';
4
4
  import type { Id } from '../core/types/cell.js';
5
+ import type { DocumentFinding } from '../core/doc/diagnostics.js';
5
6
  import type { Geometry, LintWarning } from '../core/types/scene.js';
6
7
  import type { RenderTarget } from '../core/types/options.js';
7
8
  import type { ThemeRef } from '../core/types/theme.js';
@@ -24,12 +25,28 @@ export interface BoardplotChartProps extends ContainerSizeOptions, RefusalProps,
24
25
  target?: RenderTarget;
25
26
  /** Canonical and observed display findings. */
26
27
  onWarnings?: (warnings: LintWarning[]) => void;
28
+ /**
29
+ * Called after commit with the findings `SpecErrorCard` shows: an invalid spec or setting, or a chunk
30
+ * that did not load. Once per distinct set. It is called once with `[]` when a later valid spec
31
+ * replaces the error card (its chart engine is ready, or its data is empty), without waiting for the
32
+ * chart to draw, because a valid spec can still wait for its container or refuse its size.
33
+ * Empty data stays on `onEmpty`, a layout refusal on `onRefused`.
34
+ */
35
+ onSpecError?: (errors: readonly DocumentFinding[]) => void;
27
36
  /** Label card and series highlight on pointer hover. Off by default. */
28
37
  hover?: HoverOption;
29
38
  /** Called with the series id when the reader clicks a series' line or area, its name label or its legend entry. SVG charts only. */
30
39
  onSeriesClick?: (seriesId: Id) => void;
31
40
  /** Called with the record the reader clicks, the one the hover card names, or presses Enter or Space on; a click on a mark then fires no `onSeriesClick`. SVG charts only. */
32
41
  onRecordClick?: (record: InteractionRecord, event: MouseEvent<Element> | KeyboardEvent<Element>) => void;
42
+ /**
43
+ * Called with the row id and `{ row, event, columnId }` when the reader picks a table row: a click in
44
+ * it outside a link or a button, or Enter or Space on its focused cell. Table only (`table`, alias
45
+ * `tbl`); no other chart type receives it.
46
+ */
47
+ onRowSelect?: TableChartProps['onRowSelect'];
48
+ /** Which table rows `onRowSelect` covers; absent, every row but a section heading. Table only. */
49
+ isRowSelectable?: TableChartProps['isRowSelectable'];
33
50
  /** Line and area on a time, date or number x: Ctrl or Cmd with the wheel, a pinch, or + and - on the focused chart zoom; see the chart components. */
34
51
  zoom?: ZoomOption;
35
52
  /** Your own hover card content: `(record, { records, defaultContent, source })`; return `defaultContent`, wrap it, replace it or return null. Turns on `hover` when it is absent. SVG charts only. */
@@ -3,7 +3,10 @@ export { InputError } from './core/inputError.js';
3
3
  /**
4
4
  * Which source column holds each role. Category charts name category, series
5
5
  * and value; choropleth and tilemap name category and value; waterfall names
6
- * label and value; scatter names x and y; sankey names source, target and value.
6
+ * label and value; scatter names x and y; sankey names source, target and value. A table may name label and id; its
7
+ * spec's data.columns declares the columns, each input column reading the
8
+ * source field named like its id. Histogram names value; box names category
9
+ * (the group id) and value.
7
10
  */
8
11
  export interface RowsColumns {
9
12
  category?: string;
@@ -28,6 +31,8 @@ export interface RowsColumns {
28
31
  /** Sankey: the stages of the two nodes, for flows between segments month to month. */
29
32
  sourceStage?: string;
30
33
  targetStage?: string;
34
+ /** Table row id. Without it the rows are row-1, row-2, ... */
35
+ id?: string;
31
36
  /** fraction when a share of one half arrives as 0.5, percent when it arrives as 50, number otherwise. */
32
37
  valueKind?: 'number' | 'percent' | 'fraction';
33
38
  }
package/dist/validate.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  parseThemeJson
3
- } from "./chunk-RJQ5YS3Q.js";
3
+ } from "./chunk-VKQNDOAI.js";
4
4
  import {
5
5
  registerCatalogue
6
- } from "./chunk-A5JWFZVU.js";
6
+ } from "./chunk-MQFCG4KS.js";
7
7
 
8
8
 
9
9
 
@@ -144,7 +144,7 @@ import {
144
144
 
145
145
  import {
146
146
  linkAnnotateEngine
147
- } from "./chunk-GWQIXU37.js";
147
+ } from "./chunk-NKIYLFXZ.js";
148
148
 
149
149
 
150
150
 
@@ -177,7 +177,8 @@ import {
177
177
 
178
178
  import {
179
179
  linkThemeShapeRules
180
- } from "./chunk-CAE2HK2G.js";
180
+ } from "./chunk-BWGRWGVA.js";
181
+
181
182
 
182
183
 
183
184
 
@@ -187,7 +188,7 @@ import {
187
188
  import {
188
189
  getChartDefinition,
189
190
  listCharts
190
- } from "./chunk-GQPESFAF.js";
191
+ } from "./chunk-RL3NUWMY.js";
191
192
 
192
193
 
193
194
 
@@ -200,7 +201,7 @@ import {
200
201
 
201
202
  import {
202
203
  validateTheme
203
- } from "./chunk-2MTWKMEG.js";
204
+ } from "./chunk-HA4IPWMM.js";
204
205
 
205
206
 
206
207
 
package/docs/manual.md CHANGED
@@ -170,7 +170,7 @@ The MCP server reads a `rowsFile` only from an allowed folder. The allowed folde
170
170
 
171
171
  The rows here are inline; `"rowsFile": "/data/exports/channel-share.csv"` in their place reads the same columns from a file. An absent category/series pair becomes `null`, which means unknown. A composition with a missing component withholds its share labels. When the source proves that a pair has no value, supply an explicit zero row. For example, `{ "category": "A", "series": "S1", "value": 12 }` and `{ "category": "A", "series": "S2", "value": 0 }` form a complete composition under `columns: { category: "category", series: "series", value: "value" }`. Keep unknown pairs as null.
172
172
 
173
- For category charts, the rows become the spec's `data.categories` and `data.series`, in the order they first appear. A category or series the spec already names keeps its other fields, such as a label or a `colorRole`, so a spec works as a template the rows refill; a column the map names wins. Rows fill one bare spec of a type whose data is categories and series (bar, bartable, butterfly, column, combo, dot, funnel, heatmap, line, mekko, pie, slope, variance). A pair that appears twice, a text value, a state beside a value and a named column no row has are refused with the row that holds them, and rows with no data row (a CSV with only its header, an empty array) are refused as `rows-empty`. The reading gains `data`: the row count, the `sha256` of the file bytes (of the canonical JSON for inline rows), the source, the columns nothing read and the cells a state suppressed. `boardplot_measure` returns the same `data`.
173
+ For category charts, the rows become the spec's `data.categories` and `data.series`, in the order they first appear. A category or series the spec already names keeps its other fields, such as a label or a `colorRole`, so a spec works as a template the rows refill; a column the map names wins. Rows fill one bare spec of a type whose data is categories and series (bar, bartable, butterfly, column, combo, dot, funnel, heatmap, line, mekko, pie, slope, variance). A `bartable` takes the categories as its table rows and the series as its bar segments, and the value column fills one panel. The spec's first panel is the template for that panel: the panel keeps its id, label, unit, weight, format and aggregate. Without a template, the panel's id is the value column's name. The rows drop the template's `ends`, any other panel and the number `columns`, because these lists hold one value per authored row. Percent values fill the panel as plain numbers, and the panel unit becomes `%` when neither the rows nor the template name a unit. The panel adds its segments, so rows with two different units, percent values beside plain numbers, or a value cell with more than its number (such as a `format`) are refused at their row. A pair that appears twice, a text value, a state beside a value and a named column no row has are refused with the row that holds them, and rows with no data row (a CSV with only its header, an empty array) are refused as `rows-empty`. The reading gains `data`: the row count, the `sha256` of the file bytes (of the canonical JSON for inline rows), the source, the columns nothing read and the cells a state suppressed. `boardplot_measure` returns the same `data`.
174
174
 
175
175
  ### Waterfall and scatter rows
176
176
 
@@ -182,6 +182,18 @@ Sankey takes one row per link, the shape of a `GROUP BY source, target` result.
182
182
 
183
183
  Both mappings generate ids `row-1`, `row-2`, and so on. Labels can repeat. Rows replace `data.items` or `data.points`; other authored data stays in the spec. Named columns must exist in the source. Invalid cells report their source row and column. The reading and measure report the row count, SHA-256 and ignored columns, as for category rows. `valueKind` applies to the waterfall value or both scatter coordinates; bubble size stays a number. For different coordinate kinds, pass numeric cells in JSON rows and set each axis format in the spec. These mappings work with CLI render/measure and MCP `boardplot_render`/`boardplot_measure`, for inline rows and JSON or CSV files.
184
184
 
185
+ ### Table rows
186
+
187
+ Table (alias `tbl`) takes one row per table row. The spec's `data.columns` declares the columns; the engine infers no column from the rows. Each `value`, `text`, `status` or `date` column reads its cells from the source field with the same name as the column id. The `rowLabel` column shows the row label, which comes from the `label` role. `computed` and `encoding` columns keep their definitions and read no source field. Use `--columns label=region,id=code`, or the MCP object `columns: { "label": "region", "id": "code" }`. Both roles are optional; without `id`, the rows get the ids `row-1`, `row-2`, and so on. A table takes no `valueKind` other than `number`: write a percent column in points and give it a percent format.
188
+
189
+ Numbers, text, null and table cell objects pass through as cells, and a field that a row lacks becomes null. Only a `value` column reads CSV text as a number, with the decimal comma of a semicolon CSV. A column whose field no row has, text that a `value` column cannot read as a number, a boolean or other invalid cell, and an empty or repeated row id are refused with the source row and field; a table warning about a source cell names that row and field too. Rows keep their source order and columns keep the spec's order. A spec row with the same id keeps its authored fields, such as `role`, `parentId`, `calc` or `format`, so totals, hierarchy and formulas stay in the spec; spec rows that no source row names are not drawn, and a drawn row whose `parentId` or `calc` names such a row is refused at that spec field. The reading reports the source fields that no column and no role reads in `ignoredColumns`.
190
+
191
+ ### Histogram and box rows
192
+
193
+ Histogram (aliases `distribution`, `frequency`) takes one row per observation: `--columns value=days`, or `columns: { "value": "days" }`. Box (aliases `boxplot`, `box-and-whisker`) takes one row per observation and groups the rows by the `category` column: `--columns category=team,value=days`. `category` and `value` are required; the optional `categoryLabel` and `date` give each group its label and observation date, and `date` may name the category column. Groups keep the order in which they first appear. A group the spec already names keeps its other fields. A group with two different labels or two different dates, a label or date that is not text, and a repeated group id in the spec are refused.
194
+
195
+ Every row is an observation, so nothing is dropped without a word. A null, blank, non-numeric or non-finite observation is refused with `missing-value` or `invalid-value` and its source row and field; remove or fix those rows before the call. A histogram still needs at least four observations. These shapes take no `valueKind` other than `number`; set the number format in the spec options.
196
+
185
197
  ### Map rows and classes
186
198
 
187
199
  Choropleth and tilemap accept the same `rows` and `rowsFile` inputs. Set `columns: { "category": "area", "value": "score" }`. Each row supplies one region. Keep `data.pack` and any `data.overlays` in the spec. Maps accept `state` and `valueKind`; region names come from the pack, so other column roles are refused. Duplicate regions and invalid values are refused. The reading includes the row count and SHA-256, as for category charts.
@@ -352,7 +364,7 @@ export function WeeklyRevenue() {
352
364
 
353
365
  ### Small bundles
354
366
 
355
- With esbuild 0.28.2, code splitting, minification and React external, a column's first load through `boardplot/react/spec` is about 351 kB gzip. The initial entry is about 199 kB; validation adds about 83 kB, then the column schema and engine load. The validation chunk is shared across chart types. Importing `ColumnChart` from `boardplot/react/column` starts at about 203 kB gzip. These are package measurements with gzip level 9; the host build can produce different chunk sizes.
367
+ With esbuild 0.28.2, code splitting, minification and React external, a column's first load through `boardplot/react/spec` is about 408 kB gzip. The initial entry is about 243 kB; validation adds about 88 kB, of which about 32 kB is zod, then the column schema and engine load. The validation chunk is shared across chart types. Importing `ColumnChart` from `boardplot/react/column` starts at about 237 kB gzip and links no zod. These sizes assume code splitting, the default in the production builds of Vite, webpack and Next.js; a bundle without splitting inlines the chunks a chart loads on demand and is about 57 to 87 kB larger per chart type. These are package measurements with gzip level 9; the host build can produce different chunk sizes.
356
368
 
357
369
  `boardplot/react` registers every chart core when it loads, so a page that imports it links the whole catalogue, whatever it draws. For a small page, import each chart from its own entry, or draw through `BoardplotChart` from `boardplot/react/spec`. Take the theme provider and the other shared pieces from `boardplot/react/theme`: `BoardplotTheme`, `useBoardplotTheme`, `ScaleGroup`, `useScaleGroupPlan` and `SceneRenderer`. That entry registers no chart core, so the page links only the cores it draws. Bundle with code splitting, as the production builds of Vite, webpack and Next.js do. A per-type entry loads the annotation engine, the checks a patched theme goes through and the hover and data-table records on demand; a single-file bundle inlines them into the page for every chart type, and `BoardplotChart` then inlines every engine. `useChartLayout` lays out any type by name and registers every core; it stays in `boardplot/react`.
358
370
 
@@ -37,7 +37,7 @@ One form; its chart ID is `box`.
37
37
 
38
38
  | Path | Type | Required | Meaning |
39
39
  |---|---|---|---|
40
- | groups | array | yes | Observation groups whose quartiles and whiskers are computed by the engine. |
40
+ | groups | array | yes | Observation groups whose quartiles and whiskers are computed by the engine. Rows: category,value; optional categoryLabel,date. |
41
41
  | groups[].id | string | yes | Nonempty stable identifier used to match data, labels and annotation anchors. |
42
42
  | groups[].label | string | | Visible group name; defaults to the group id. |
43
43
  | groups[].date | string | | ISO observation date for CAGR between group snapshots; requires a positive date interval. |
@@ -667,6 +667,7 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
667
667
  | right-edge-milestone-row | gantt | torture | Regression: last row with only a right-edge milestone keeps its activity label centered |
668
668
  | workstream-status-plan | gantt | example | Workstream status plan (weekly view, owners, due dates, and semantic status) |
669
669
  | metadata-column-headers | gantt | example | Three delivery rows with owner and due-date headers |
670
+ | status-timeline | gantt | example | Status timeline (row sublabels, status-coloured spans, change events) |
670
671
  | torture-long-labels | gantt | torture | Torture: long names at a generous size read whole, never cut |
671
672
  | item-labels-off | gantt | torture | Rows and status remain when item labels are off |
672
673
  | five-nearby-milestones | gantt | torture | Five nearby milestones retain their names |
@@ -46,14 +46,15 @@ One form; its chart ID is `gantt`.
46
46
  | rows | array | yes | Task and cadence rows displayed in the supplied order. |
47
47
  | rows[].id (rows[] branch 1) | string | yes | Unique timeline row identity. |
48
48
  | rows[].label (rows[] branch 1) | string | yes | Visible timeline row name. |
49
+ | rows[].sublabel (rows[] branch 1) | string | | Second line under the row name, such as what the row measures. Printed in the label font and muted ink, on one line and never cut; the name band takes the wider of name and sublabel. On narrow canvases it follows the name on the row's name line. labels.activity: false hides it with the name. |
49
50
  | rows[].indent (rows[] branch 1) | integer | | Nonnegative indentation level for the row label. |
50
51
  | rows[].cols (rows[] branch 1) | array | | Metadata columns beside the row label, such as owner and status; up to three are displayed. A cell is text, or text with a tone. |
51
52
  | rows[].cols[].text (rows[] branch 1) | string | yes | Cell text, such as a status word. |
52
- | rows[].cols[].tone (rows[] branch 1) | string | yes | Status tone, drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
53
+ | rows[].cols[].tone (rows[] branch 1) | string | | Status tone; omitted, the cell is plain text. A tone is drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
53
54
  | rows[].kind (rows[] branch 1) | string | | Task row containing individual timeline items; task is the default row kind. One of `'task'`. |
54
55
  | rows[].items (rows[] branch 1) | array | yes | Timeline items placed in this task row. |
55
56
  | rows[].items[].id (rows[] branch 1) | string | yes | Unique item identity used by annotations and scene elements. |
56
- | rows[].items[].kind (rows[] branch 1) | string | yes | Timeline mark. Milestone labels try their row bands before the lane; unsafe leaders use a numbered key. One of `'bar'`, `'milestone'`, `'chevron'`, `'bracket'`, `'shade'`. |
57
+ | rows[].items[].kind (rows[] branch 1) | string | yes | Timeline mark. Milestone labels try their row bands before the lane; unsafe leaders use a numbered key. 'rule' is a quiet span for the state before a change: a 2 px neutral line at the bottom of the bar box with its label above it in muted ink, flush left; it never takes a colour or a colour-key entry. One of `'bar'`, `'milestone'`, `'chevron'`, `'bracket'`, `'shade'`, `'rule'`. |
57
58
  | rows[].items[].start (rows[] branch 1) | string | yes | ISO 8601 start date; an anchor can move it while preserving duration. |
58
59
  | rows[].items[].end (rows[] branch 1) | string | | Inclusive ISO 8601 end date for an interval; omission uses the start date. |
59
60
  | rows[].items[].label (rows[] branch 1) | string | | Displayed item name. An omitted name leaves category content empty. |
@@ -66,10 +67,11 @@ One form; its chart ID is `gantt`.
66
67
  | rows[].items[].anchor.offsetDays (rows[] branch 1) | integer | | Signed number of days added to the target edge; defaults to zero. |
67
68
  | rows[].id (rows[] branch 2) | string | yes | Unique timeline row identity. |
68
69
  | rows[].label (rows[] branch 2) | string | yes | Visible timeline row name. |
70
+ | rows[].sublabel (rows[] branch 2) | string | | Second line under the row name, such as what the row measures. Printed in the label font and muted ink, on one line and never cut; the name band takes the wider of name and sublabel. On narrow canvases it follows the name on the row's name line. labels.activity: false hides it with the name. |
69
71
  | rows[].indent (rows[] branch 2) | integer | | Nonnegative indentation level for the row label. |
70
72
  | rows[].cols (rows[] branch 2) | array | | Metadata columns beside the row label, such as owner and status; up to three are displayed. A cell is text, or text with a tone. |
71
73
  | rows[].cols[].text (rows[] branch 2) | string | yes | Cell text, such as a status word. |
72
- | rows[].cols[].tone (rows[] branch 2) | string | yes | Status tone, drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
74
+ | rows[].cols[].tone (rows[] branch 2) | string | | Status tone; omitted, the cell is plain text. A tone is drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
73
75
  | rows[].kind (rows[] branch 2) | string | yes | Cadence row showing repeated dated event markers. One of `'cadence'`. |
74
76
  | rows[].events (rows[] branch 2) | array | yes | Dated events placed along this cadence row. |
75
77
  | rows[].events[].id (rows[] branch 2) | string | yes | Unique event identity shared with the timeline mark id namespace. |
@@ -82,10 +84,13 @@ One form; its chart ID is `gantt`.
82
84
  | Path | Type | Values | Default | Meaning |
83
85
  |---|---|---|---|---|
84
86
  | labels | false \| object | `false` (or another value of its type) | | False hides timeline item labels. Row names, metadata cells and column headers remain. Use labels.activity: false to hide those, or labels.item: false to hide only item labels. For milestones, labels.item: ['category'] prints the item name without its date; ['absolute'] or the legacy ['value'] prints only the date. Span items print the inclusive date range. Parts follow the supplied order. An empty requested part is named in a note. |
85
- | today | string | | | Authored ISO 8601 date for the dashed today marker; the system clock is not read. The marker, like an event rule, passes the period names of the calendar head with a gap. |
87
+ | today | string | | | Authored ISO 8601 date for the dashed today marker; the system clock is not read. The marker, like an event rule, passes the period names of the calendar head with a gap. A bar, arrow or shade name with no seat clear of the marker and the event rules sits inside its mark across them, and the rules break over that mark. |
86
88
  | elapsed | boolean | | | Tint the visible time before today; defaults to true when the today marker is displayed. |
87
89
  | weekends | boolean | | | Shade Saturday and Sunday at week granularity; defaults to false. |
88
90
  | rowTint | boolean | | | Apply alternating faint row backgrounds; defaults to false. |
91
+ | calendar | object | | | Calendar head and span. The defaults keep the ISO week head over whole periods. |
92
+ | calendar.weeks | string | `'isoWeek'`, `'startDay'` | | Week cell names. 'isoWeek' (default): ISO week numbers such as 'W11'. 'startDay': the day of the month each week cell starts on ('9'), flush left in its cell under the month tier, so the number reads as the day the week starts; a clipped first or last cell names the day it starts on. Week granularity only; elsewhere it is ignored with the info lint calendar-weeks-ignored. |
93
+ | calendar.span | string | `'periods'`, `'data'` | | Timeline span. 'periods' (default): whole calendar periods of the head's finer tier. 'data': from the first item or cadence day to the later of the last item end and options.today, so the arrows end at the edge. A milestone or cadence marker on the first or last day keeps room for its radius inside the edge. Event annotations and a today before the first item do not extend the span; they are left out with event-out-of-range or today-out-of-range. |
89
94
  | colHeaders | array | | | Positional headers for up to three existing metadata columns. Omitted or empty entries have no header; entries without a displayed column are ignored. |
90
95
 
91
96
  Plus the [shared options](options.md). This type does not accept `detailFields`, `categoryLabels`, `valueAxis`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `sort`, `topN`, `hatchStrength`, `colorblindSafe`, `rounding`.
@@ -96,7 +101,7 @@ An annotation anchor is a category or item id string, or an object with category
96
101
 
97
102
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
98
103
  |---|---|---|---|---|---|
99
- | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | at, label | at: AnchorRef | tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. | An ISO date or a schedule item id positions the rule. Above three events the labels move to numbered footnotes. |
104
+ | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | at, label | at: AnchorRef | tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. labelPlacement: top \| inline \| badge, default top. inline (line) sets the block beside its rule inside the plot. badge (gantt) draws the label, at most 3 characters, in a filled circle at the top of its rule; badge events never go to the numbered key. | An ISO date or a schedule item id positions the rule. Above three events the labels move to numbered footnotes. |
100
105
 
101
106
  ## Sizing
102
107
 
@@ -119,6 +124,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
119
124
  | right-edge-milestone-row | torture | Regression: last row with only a right-edge milestone keeps its activity label centered |
120
125
  | workstream-status-plan | example | Workstream status plan (weekly view, owners, due dates, and semantic status) |
121
126
  | metadata-column-headers | example | Three delivery rows with owner and due-date headers |
127
+ | status-timeline | example | Status timeline (row sublabels, status-coloured spans, change events) |
122
128
  | torture-long-labels | torture | Torture: long names at a generous size read whole, never cut |
123
129
  | item-labels-off | torture | Rows and status remain when item labels are off |
124
130
  | five-nearby-milestones | torture | Five nearby milestones retain their names |
@@ -33,7 +33,7 @@ One form; its chart ID is `histogram`.
33
33
 
34
34
  | Path | Type | Required | Meaning |
35
35
  |---|---|---|---|
36
- | observations | array | yes | Raw observations, at least four. Pre-binned counts and edges are rejected: bins the engine cannot recompute cannot be checked. |
36
+ | observations | array | yes | Raw observations, at least four. Pre-binned counts and edges are rejected: bins the engine cannot recompute cannot be checked. Rows: value. |
37
37
 
38
38
  ## Options
39
39
 
@@ -238,7 +238,7 @@ An annotation anchor is a category or item id string, or an object with category
238
238
  | 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. seriesId: string. Series whose mean is measured. 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. attainment: boolean \| { seriesId, direction }. Shades each category between its actual and the line. | 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. |
239
239
  | indicator100 | Maps 100 through the chart's value scale and draws a side tick with a 100% label. | | | side: left \| right, default left. Side of the plot the 100% mark sits on. | No anchor is required. The chart needs a value scale that can represent 100. |
240
240
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
241
- | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | label | at: categoryId (optional) | date: ISO date yyyy-mm-dd, in place of at: the event sits at the last category whose date is on or before it, and the block header and the key print it as d MMM. Every category needs an ISO date; a date outside the categories warns event-out-of-range. end: ISO date, with date: the event is a period, drawn as a thin bar to the end of that day. to: Category id, with at: the event is a period to the end of that category. group: Id of a group in options.events.groups, which gives the kind label, tone and glyph. detail: string \| string[]. Authored lines under the title, at most three in the lane; nothing is cut, a longer block moves to the key. items: { label, detail? }[]. More changes on the same date, after this event's own label and detail. The lane and the key draw a compact +N after the title; the hover card, the SVG title and description, and the interaction records list every item in full. placement: auto \| key, default options.events.placement. key numbers this event into the key below the plot. tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. labelPlacement: top \| inline, default top. inline sets the block beside its rule inside the plot. | Exactly one of at (a category id) and date (an ISO date) places the event; end or to makes it a period. The event lane above the plot sets a block of group and date, title and detail with a thin pole to the data; an event that does not fit, a second event on one category and every event under options.events.placement 'key' get a numbered marker and an entry in the key below the plot, numbered in time order; under footnotes: false they are left off and listed in the footnotes-off lint. The full date, title and detail of every event stay in the SVG title and description, the interaction records and the hover card, whether or not the lane or the key prints the detail. In compact mode the lane is one row of numbered markers and the key packs "n date title" into as few lines as the width allows; where the plot would still fall under 80px the key keeps "n title" and the info lint event-lane-compact says so. options.events.rows sets the lane rows (default by canvas width: 1 under 1080px, 2 from 1080px); a row gives way while the plot band left under the lane would keep less than 40% of the canvas height. |
241
+ | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | label | at: categoryId (optional) | date: ISO date yyyy-mm-dd, in place of at: the event sits at the last category whose date is on or before it, and the block header and the key print it as d MMM. Every category needs an ISO date; a date outside the categories warns event-out-of-range. end: ISO date, with date: the event is a period, drawn as a thin bar to the end of that day. to: Category id, with at: the event is a period to the end of that category. group: Id of a group in options.events.groups, which gives the kind label, tone and glyph. detail: string \| string[]. Authored lines under the title, at most three in the lane; nothing is cut, a longer block moves to the key. items: { label, detail? }[]. More changes on the same date, after this event's own label and detail. The lane and the key draw a compact +N after the title; the hover card, the SVG title and description, and the interaction records list every item in full. placement: auto \| key, default options.events.placement. key numbers this event into the key below the plot. tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. labelPlacement: top \| inline \| badge, default top. inline (line) sets the block beside its rule inside the plot. badge (gantt) draws the label, at most 3 characters, in a filled circle at the top of its rule; badge events never go to the numbered key. | Exactly one of at (a category id) and date (an ISO date) places the event; end or to makes it a period. The event lane above the plot sets a block of group and date, title and detail with a thin pole to the data; an event that does not fit, a second event on one category and every event under options.events.placement 'key' get a numbered marker and an entry in the key below the plot, numbered in time order; under footnotes: false they are left off and listed in the footnotes-off lint. The full date, title and detail of every event stay in the SVG title and description, the interaction records and the hover card, whether or not the lane or the key prints the detail. In compact mode the lane is one row of numbered markers and the key packs "n date title" into as few lines as the width allows; where the plot would still fall under 80px the key keeps "n title" and the info lint event-lane-compact says so. options.events.rows sets the lane rows (default by canvas width: 1 under 1080px, 2 from 1080px); a row gives way while the plot band left under the lane would keep less than 40% of the canvas height. |
242
242
  | band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
243
243
 
244
244
  ## Trend lines
@@ -35,8 +35,11 @@ export function RevenueMix() {
35
35
  | `target` | The medium the chart is read in: `report` (the default), `dashboard`, `slide` or `print`. It overrides `spec.options.target` and the provider's `target`; see [Targets](#targets). |
36
36
  | `onWarnings` | Called with the warnings of the layout and with a finding when the chart shows narrower than its safe minimum; see [Targets](#targets). |
37
37
  | `hover` | Label card and series highlight on pointer hover; see [Hover](#hover). |
38
+ | `onSpecError` | Called after commit with the findings `SpecErrorCard` shows: an invalid spec or setting, or a chunk that did not load (code `chunk-load-failed`). It is called once per distinct set of findings, so a host may set state from it; a rerender with the same findings, or StrictMode's repeated effects, call it no second time. It is called once with `[]` when a later valid spec replaces the error card (its chart engine is ready, or its data is empty), without waiting for the chart to draw, because a valid spec can still wait for its container or refuse its size. A first spec that draws calls nothing, and a set the host had no `onSpecError` for is reported when the prop arrives. Empty data stays on `onEmpty`, and a layout refusal on `onRefused`. |
38
39
  | `onSeriesClick` | Called with the series id when the reader clicks a series: its line or area, its name label or its legend entry. The name label and the legend label are keyboard buttons (Enter or Space); the line, area and swatches take the pointer only. SVG charts only. |
39
40
  | `onRecordClick` | Called with `(record, event)` when the reader clicks a mark: the record the hover card names there, a bar, a point, a slice or a category band, with its category and series ids in `record.target.owner`, its source value in `record.value.raw` and its labels. Use it for a drill-down. A mark that prints everything it carries, such as a plain diagram node, opens no hover card but is still clicked and focused. An annotation (a value line, an event) is read but never calls it, from the pointer or the keyboard. It works with `hover` off. A click on a mark then fires no `onSeriesClick`; the name label and the legend entry keep their series click. Enter or Space on the record the keyboard has focused calls it too, with the keyboard event; see [Keyboard](#keyboard). SVG charts only. |
41
+ | `onRowSelect` | Called with `(rowId, { row, event, columnId })` when the reader picks a table row: a click in it outside a link or a button, or Enter or Space on its focused cell; see [The table component](#the-table-component). Table only (`table`, alias `tbl`); BoardplotChart passes it to no other type. A `dimswitch` spec draws as SVG here and takes no row pick; use `DimSwitchChart` for that. |
42
+ | `isRowSelectable` | Called with `(row, { collapsed })`; the rows it answers false for take no pick. Absent, every row but a section heading is selectable. Table only. |
40
43
  | `zoom` | Line and area on a time, date or number x: `true` or `{ aggregate, grains, range, onZoom }`. Ctrl or Cmd with the wheel, or a trackpad pinch, zooms around the pointer; the plain wheel scrolls the page. See [Zoom](#zoom). SVG charts only. |
41
44
  | `renderHoverContent` | Your own hover card content, for a link or a free layout: `(record, { records, defaultContent, source })` returns what the card shows. `record` is the record `onRecordClick` receives for the same mark. Return `defaultContent` to keep the default card, wrap it to add to it, return your own content to replace it, or `null` for no card on that record. Turns on `hover` when it is absent; see [Your own card content](#your-own-card-content). SVG charts only. |
42
45
  | `prepared` | The server result of `prepareChart` for the same spec and settings; see [Server preparation](#server-preparation). |
@@ -186,7 +186,7 @@ Consulting-grade table: hierarchy with honest totals (derive/validate/source), t
186
186
  | columns[].encoding.type (columns[] branch 7) | string | yes | Per-row mini line or column over sourceColumns; null values leave gaps in source order. One of `'sparkline'`. |
187
187
  | columns[].encoding.kind (columns[] branch 7) | string | | Shape. Default 'line'. 'column' is zero-anchored. One y-domain is shared across visible rows of this column. One of `'line'`, `'column'`. |
188
188
  | columns[].encoding.sourceColumns (columns[] branch 7) | array | yes | Ordered numeric source columns; they remain visible. The last observed source value is labelled from that cell's formatted text. Without a column width the track is 88 px or wider, so that label prints whole; a width fixes the track and cuts a longer label. |
189
- | rows | array | yes | Row hierarchy; totalPosition determines resolved display order. |
189
+ | rows | array | yes | Row hierarchy; totalPosition determines resolved display order. Rows: optional label,id; each value, text, status or date column reads the source field named like its id. |
190
190
  | rows[].id | string | yes | Nonempty reference id. |
191
191
  | rows[].label | string | | Visible name; defaults to id. |
192
192
  | rows[].parentId | string | | Flat canonical hierarchy. Alternative: nested `children` sugar. |
package/llms.txt CHANGED
@@ -14,7 +14,7 @@ Every chart is one spec, `{ "type", "data", "options", "annotations", "theme" }`
14
14
  - [bar](docs/reference/bar.md): Horizontal bars per item
15
15
  - [line](docs/reference/line.md): Lines and areas over time
16
16
  - [dimswitch](docs/reference/dimswitch.md): KPIs by one dimension and period, from sums
17
- - [table](docs/reference/table.md): Management table with totals
17
+ - [table](docs/reference/table.md): Management table with totals; rows [label,id]
18
18
  - [waterfall](docs/reference/waterfall.md): Bridge; rows label,value[,type]
19
19
  - [kpi](docs/reference/kpi.md): Single-metric card
20
20
  - [combo](docs/reference/combo.md): Columns with line or area overlays
@@ -40,8 +40,8 @@ Every chart is one spec, `{ "type", "data", "options", "annotations", "theme" }`
40
40
  - [choropleth](docs/reference/choropleth.md): Region map coloured by value
41
41
  - [butterfly](docs/reference/butterfly.md): Two mirrored bar panes
42
42
  - [likert](docs/reference/likert.md): Diverging bars for survey scales
43
- - [histogram](docs/reference/histogram.md): Equal-width bins of raw values
44
- - [box](docs/reference/box.md): Box plots of raw observations
43
+ - [histogram](docs/reference/histogram.md): Equal-width bins of raw values; rows value
44
+ - [box](docs/reference/box.md): Box plots of raw observations; rows category,value[,categoryLabel,date]
45
45
  - [waffle](docs/reference/waffle.md): Share of a whole as a grid of cells
46
46
  - [pyramid](docs/reference/pyramid.md): Mirrored bands on one scale
47
47
  - [diagram](docs/reference/diagram.md): Node and edge diagrams
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "boardplot",
3
- "version": "0.52.5",
3
+ "version": "0.53.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",