boardplot 0.59.0 → 0.61.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 (381) hide show
  1. package/CHANGELOG.md +64 -0
  2. package/README.md +2 -2
  3. package/dist/{ReaderBox-4PNFZO56.js → ReaderBox-75LYQMSA.js} +3 -3
  4. package/dist/{annotateEngine-DL4KRQ6B.js → annotateEngine-CL6ZSRGG.js} +1 -1
  5. package/dist/build-identity.json +3 -3
  6. package/dist/{chunk-7UZUXPFM.js → chunk-24O6BRKD.js} +1 -1
  7. package/dist/{chunk-HC4UW7MB.js → chunk-2BF6HZV7.js} +4 -4
  8. package/dist/chunk-2KGF6AIK.js +1483 -0
  9. package/dist/{chunk-RF6ZHX5F.js → chunk-2T22INLD.js} +1 -1
  10. package/dist/{chunk-3WFJDXZO.js → chunk-2X6672YL.js} +4 -4
  11. package/dist/{chunk-LC4KDLUE.js → chunk-32FGSRR3.js} +4 -4
  12. package/dist/{chunk-MOBRWYUQ.js → chunk-352V2W5P.js} +2 -2
  13. package/dist/{chunk-FWPPZB4G.js → chunk-3553PK6F.js} +2 -2
  14. package/dist/{chunk-XUEX5WTR.js → chunk-35RSAHLK.js} +1 -1
  15. package/dist/{chunk-E4KHHC46.js → chunk-36KGPRMX.js} +9 -9
  16. package/dist/{chunk-BOUZKVIY.js → chunk-3GL23VOF.js} +31 -3
  17. package/dist/{chunk-SNJ3FZXC.js → chunk-4ORV4RGE.js} +5 -5
  18. package/dist/chunk-4ZIFMZO4.js +63 -0
  19. package/dist/{chunk-FMVXXKSW.js → chunk-533SNVDD.js} +4 -4
  20. package/dist/{chunk-UZDQFUHO.js → chunk-55BVHNZQ.js} +4 -4
  21. package/dist/{chunk-JRM22ULA.js → chunk-56PPEORW.js} +52 -28
  22. package/dist/{chunk-DUDVHQD6.js → chunk-57XHIICM.js} +5 -5
  23. package/dist/{chunk-EJA5EANI.js → chunk-5DH5ACTO.js} +90 -83
  24. package/dist/{chunk-4EEK4AMC.js → chunk-5EU5DLA3.js} +2 -2
  25. package/dist/{chunk-XFDNAR4S.js → chunk-5JZQXMXU.js} +6 -6
  26. package/dist/{chunk-MTOBNHAU.js → chunk-5ZGCGIHG.js} +2 -2
  27. package/dist/{chunk-PHQGGR5O.js → chunk-64577PGJ.js} +4 -4
  28. package/dist/{chunk-GZYMHC44.js → chunk-6JOLPUTW.js} +2 -2
  29. package/dist/{chunk-MYBBZNYN.js → chunk-6QUQEN75.js} +2 -2
  30. package/dist/{chunk-OM5MAJST.js → chunk-6R6LM337.js} +12 -12
  31. package/dist/{chunk-UKEI7JDA.js → chunk-6U4J3T2G.js} +3 -2
  32. package/dist/{chunk-NZGQLR4X.js → chunk-6U7VIQLV.js} +6 -6
  33. package/dist/{chunk-ZNA4JHHG.js → chunk-757IKZZU.js} +2 -2
  34. package/dist/{chunk-V3XYFLOZ.js → chunk-7D65YEEY.js} +4 -4
  35. package/dist/{chunk-XWUHUTXX.js → chunk-7JM235F7.js} +8 -8
  36. package/dist/{chunk-4YZQY3AA.js → chunk-7SSN5ECA.js} +1 -1
  37. package/dist/{chunk-DZBT7AWJ.js → chunk-7WC2N4QZ.js} +2 -2
  38. package/dist/{chunk-ZOQRX5V7.js → chunk-7ZHM37LQ.js} +3 -3
  39. package/dist/{chunk-HW67YGJC.js → chunk-7ZPHJOG6.js} +1 -1
  40. package/dist/{chunk-MZCJ22O4.js → chunk-A4UL5GIM.js} +1 -1
  41. package/dist/{chunk-XUGEYHOQ.js → chunk-ASRICUAD.js} +2 -2
  42. package/dist/{chunk-XZBX6LIC.js → chunk-B62SEOJC.js} +6 -6
  43. package/dist/{chunk-WD5NJHZG.js → chunk-B76O5YXI.js} +1 -1
  44. package/dist/{chunk-RF2REMRV.js → chunk-BF6KECQD.js} +6 -6
  45. package/dist/{chunk-5HOIOQK3.js → chunk-BJ5GI5ZB.js} +1 -1
  46. package/dist/{chunk-XAH4EWJT.js → chunk-BKUTKQMT.js} +38 -2
  47. package/dist/chunk-BOQQARLT.js +89 -0
  48. package/dist/{chunk-VVWTD4XP.js → chunk-BVE5LPOA.js} +4 -4
  49. package/dist/{chunk-BJJYNTVJ.js → chunk-CVUHCNQO.js} +1 -1
  50. package/dist/{chunk-WTWM4RK6.js → chunk-CWP5ZYVQ.js} +1 -1
  51. package/dist/{chunk-W4ZLMK6Z.js → chunk-CYMSES53.js} +1 -1
  52. package/dist/{chunk-B5FT4YAX.js → chunk-DOVEWKJ6.js} +1 -1
  53. package/dist/{chunk-4DLIXTDH.js → chunk-E6IN6QDF.js} +5 -5
  54. package/dist/{chunk-6TZDPQDE.js → chunk-E7FWHKCI.js} +14 -7
  55. package/dist/{chunk-USATDW6O.js → chunk-EAMZDY55.js} +1 -1
  56. package/dist/{chunk-7UUSHA7H.js → chunk-EIQTUVJT.js} +1 -1
  57. package/dist/{chunk-56CDMSE5.js → chunk-EKYVRXTE.js} +1 -1
  58. package/dist/{chunk-GDE2JINW.js → chunk-EL5E6O3K.js} +7 -7
  59. package/dist/{chunk-QMQZC2KW.js → chunk-EM33NXGZ.js} +2 -2
  60. package/dist/{chunk-3V7Y7CHI.js → chunk-EOPDGMDS.js} +1 -1
  61. package/dist/{chunk-PSUSHJFV.js → chunk-EQDLZGZO.js} +1 -1
  62. package/dist/{chunk-5YULK4DY.js → chunk-ESZIJ5Z6.js} +3 -3
  63. package/dist/chunk-EU45YU5W.js +96 -0
  64. package/dist/{chunk-O32L5FK2.js → chunk-EV3GY7Y3.js} +4 -4
  65. package/dist/{chunk-TLKRYDH3.js → chunk-EV7AATQM.js} +2 -2
  66. package/dist/{chunk-XRPZJDAK.js → chunk-EWG3PCYJ.js} +72 -1188
  67. package/dist/{chunk-M2FF4IPF.js → chunk-F2IHSUPI.js} +2 -2
  68. package/dist/{chunk-RPS7G77V.js → chunk-F2WMTUWC.js} +2 -2
  69. package/dist/{chunk-7TZIPGFH.js → chunk-F37PADCM.js} +2 -2
  70. package/dist/{chunk-SE6LBMRJ.js → chunk-FBUAKQAI.js} +25 -23
  71. package/dist/{chunk-77L6QGIG.js → chunk-FKRL2ZB2.js} +1 -1
  72. package/dist/{chunk-MF6XGFHB.js → chunk-FNDDKZ4Z.js} +6 -2
  73. package/dist/{chunk-IX2SLULO.js → chunk-FTIQ6TI2.js} +2 -2
  74. package/dist/{chunk-YM4MVABU.js → chunk-FY3VV7TF.js} +5 -4
  75. package/dist/{chunk-VT6PDWUA.js → chunk-G3CVCW5K.js} +81 -79
  76. package/dist/{chunk-TEZWFQB7.js → chunk-GCZHZVNX.js} +6 -6
  77. package/dist/{chunk-GNK7RTO4.js → chunk-GEQSZ5RE.js} +4 -4
  78. package/dist/{chunk-QKDDGDRF.js → chunk-GNB4JQTB.js} +10 -10
  79. package/dist/{chunk-W6NEWQZU.js → chunk-GRMAYSIG.js} +8 -8
  80. package/dist/{chunk-PZZAVTLQ.js → chunk-GSR6UO7H.js} +2 -2
  81. package/dist/{chunk-AH2L44TR.js → chunk-GZ6MPJKY.js} +3 -3
  82. package/dist/{chunk-POHML4N4.js → chunk-H26UA4UM.js} +6 -6
  83. package/dist/{chunk-VZVPN7NT.js → chunk-H5YDEIY2.js} +4 -4
  84. package/dist/{chunk-EADD6NNQ.js → chunk-HS4DLZ6H.js} +17 -12
  85. package/dist/{chunk-XLX3TUFO.js → chunk-HTLEHU5D.js} +2 -2
  86. package/dist/{chunk-JYSS5ZZF.js → chunk-HUCUNGHB.js} +5 -5
  87. package/dist/{chunk-FP3ORYCG.js → chunk-I3GRAQHO.js} +9 -9
  88. package/dist/{chunk-2GVW5WDD.js → chunk-I4A4MY3S.js} +4 -4
  89. package/dist/{chunk-XGTSZ7NC.js → chunk-IIKM6NXU.js} +4 -4
  90. package/dist/{chunk-AVYRC2T3.js → chunk-IKH3DWS2.js} +11 -11
  91. package/dist/{chunk-U4WG46QP.js → chunk-IKTAVMF2.js} +31 -15
  92. package/dist/{chunk-7BQK2UDV.js → chunk-IXCDKCYE.js} +1 -1
  93. package/dist/{chunk-IXZI4SN4.js → chunk-JE54IO26.js} +15 -15
  94. package/dist/{chunk-TCWJQIVQ.js → chunk-JEAUVQTV.js} +65 -29
  95. package/dist/{chunk-RYYB7REV.js → chunk-JG35YUYX.js} +3 -3
  96. package/dist/{chunk-X3AMBFGF.js → chunk-JIVNJBXI.js} +4 -4
  97. package/dist/{chunk-7YJSSPQX.js → chunk-JLJ4QRAE.js} +12 -12
  98. package/dist/{chunk-6IIYLDSQ.js → chunk-JLZFXNUE.js} +4 -4
  99. package/dist/{chunk-B7UWG6XJ.js → chunk-JTCXK7AG.js} +1 -1
  100. package/dist/{chunk-NWUEA42V.js → chunk-JUTMQGKU.js} +4 -4
  101. package/dist/{chunk-5OV7VOGV.js → chunk-JXHTZVSV.js} +2 -2
  102. package/dist/{chunk-SDAVHADX.js → chunk-JZK6ZPUM.js} +2 -2
  103. package/dist/{chunk-VHZ4MXJO.js → chunk-K2RZKPQ2.js} +1 -1
  104. package/dist/{chunk-NUASZPS7.js → chunk-KJF7SLOA.js} +1 -1
  105. package/dist/{chunk-KRIYGX3N.js → chunk-KTFUYWN2.js} +5 -5
  106. package/dist/{chunk-O623CYPA.js → chunk-KY5MSTME.js} +4 -4
  107. package/dist/{chunk-5ACFYNA4.js → chunk-KZKWDFIS.js} +4 -0
  108. package/dist/{chunk-ID5PE4KM.js → chunk-L5RZFP5B.js} +3 -3
  109. package/dist/{chunk-U75MMLNQ.js → chunk-L6OMA45Q.js} +4 -4
  110. package/dist/{chunk-LLECS747.js → chunk-LEPXK7RN.js} +2 -2
  111. package/dist/{chunk-4YKS2JDE.js → chunk-LFL4KMKF.js} +1 -1
  112. package/dist/{chunk-5UXK5BAA.js → chunk-LH5URXDJ.js} +10 -10
  113. package/dist/{chunk-33SPSKTP.js → chunk-LHQFDRQV.js} +4 -4
  114. package/dist/{chunk-TMVERETB.js → chunk-LL7ZU6BT.js} +12 -12
  115. package/dist/{chunk-GEEHXLFQ.js → chunk-LLHCEZV2.js} +110 -86
  116. package/dist/{chunk-YJXIHVNK.js → chunk-LMDU5MNF.js} +2 -2
  117. package/dist/{chunk-GWDKUKOJ.js → chunk-LT7IY2L3.js} +7 -7
  118. package/dist/{chunk-RSDGBNXP.js → chunk-LTYDEWKW.js} +3 -3
  119. package/dist/{chunk-NIL6TYAN.js → chunk-M2LYZUQA.js} +10 -7
  120. package/dist/{chunk-IQRRT32Q.js → chunk-M4IIJ24E.js} +2 -2
  121. package/dist/{chunk-VMLVZW4F.js → chunk-MBRVSKFJ.js} +6 -6
  122. package/dist/{chunk-AGR4VJ2Y.js → chunk-MM2ADIPB.js} +1 -1
  123. package/dist/{chunk-LM4GVVPM.js → chunk-MNPNLXSI.js} +3 -3
  124. package/dist/{chunk-VLMKGQ33.js → chunk-MNVMTW7K.js} +11 -11
  125. package/dist/{chunk-P3N74SZ5.js → chunk-MYYDNK72.js} +4 -4
  126. package/dist/{chunk-AFQZBCME.js → chunk-NCKINI7K.js} +2 -2
  127. package/dist/{chunk-4WH2YGO6.js → chunk-NHQKHMIS.js} +4 -4
  128. package/dist/{chunk-E62SXDRT.js → chunk-NJKUODK3.js} +1 -1
  129. package/dist/{chunk-HBKZC5BH.js → chunk-NJVXE2DU.js} +2 -2
  130. package/dist/{chunk-MOPY5REE.js → chunk-NNOKYAFB.js} +3 -3
  131. package/dist/{chunk-JIB74SQS.js → chunk-NSQBT4CM.js} +4 -4
  132. package/dist/{chunk-HFDU2E7C.js → chunk-NWJ4DXAZ.js} +11 -11
  133. package/dist/{chunk-JOX252XQ.js → chunk-OGD23BIK.js} +3 -1
  134. package/dist/{chunk-WTH3KQDM.js → chunk-OIMT2SSN.js} +2 -2
  135. package/dist/{chunk-6CZGFTGK.js → chunk-OIPBVU7G.js} +11 -11
  136. package/dist/chunk-OLAPTOUH.js +69 -0
  137. package/dist/{chunk-I65BCUVH.js → chunk-OLEUVUH3.js} +4 -4
  138. package/dist/{chunk-XMII3G47.js → chunk-OP7K5NSS.js} +4 -4
  139. package/dist/{chunk-GGFT6IIM.js → chunk-OQKVFWAO.js} +4 -4
  140. package/dist/{chunk-F2N5BUBK.js → chunk-OR7KKODW.js} +9 -9
  141. package/dist/{chunk-YOUYJHW3.js → chunk-OUSYBIGE.js} +4 -4
  142. package/dist/{chunk-DEJ27Y2P.js → chunk-OYCEFOIW.js} +54 -26
  143. package/dist/{chunk-DANKUHCX.js → chunk-P2QIWGFU.js} +9 -9
  144. package/dist/{chunk-4LCQO46F.js → chunk-P3CZFAFA.js} +79 -75
  145. package/dist/{chunk-2HRDOBPS.js → chunk-P3TOPI3M.js} +1 -1
  146. package/dist/{chunk-DXLWMK24.js → chunk-PCHV6KYJ.js} +3 -3
  147. package/dist/{chunk-YRCIG4IO.js → chunk-PGKGK43I.js} +112 -24
  148. package/dist/{chunk-FBIMTKYK.js → chunk-PH274WAF.js} +3 -3
  149. package/dist/{chunk-266ENWFM.js → chunk-QER2YJHC.js} +4 -4
  150. package/dist/{chunk-XETSLYFD.js → chunk-QJPI55S5.js} +4 -4
  151. package/dist/{chunk-OL6HVC6K.js → chunk-QK2OFTEB.js} +1 -1
  152. package/dist/{chunk-5AXWSGS7.js → chunk-QSMKLDAO.js} +2 -2
  153. package/dist/{chunk-UFGJNSSL.js → chunk-R3IPQHWC.js} +1 -1
  154. package/dist/{chunk-IXOBDDMW.js → chunk-RD24ORGR.js} +2 -0
  155. package/dist/{chunk-QM6IW5BL.js → chunk-RMBWY5JE.js} +4 -4
  156. package/dist/{chunk-UGHJHJKY.js → chunk-RT4V47U6.js} +1 -1
  157. package/dist/{chunk-UI2MKLON.js → chunk-RTSSUQ25.js} +1 -1
  158. package/dist/{chunk-PP23D6QV.js → chunk-RV6JDD6S.js} +4 -4
  159. package/dist/{chunk-6TH5NVKS.js → chunk-RXC3XU62.js} +33 -8
  160. package/dist/{chunk-CV5KCQD3.js → chunk-RZQU5DHD.js} +10 -10
  161. package/dist/{chunk-Y4BJ7D5F.js → chunk-S7AHPU2N.js} +1 -1
  162. package/dist/{chunk-67744WKZ.js → chunk-SGTSTGIP.js} +1 -1
  163. package/dist/{chunk-FB36HSY2.js → chunk-SJORKHHL.js} +5 -5
  164. package/dist/{chunk-7IONS4Z7.js → chunk-SSVOJXFR.js} +3 -3
  165. package/dist/{chunk-XVFUJRRC.js → chunk-T2DGSOAH.js} +1 -1
  166. package/dist/{chunk-EWGFOEJB.js → chunk-T6XSXJDQ.js} +76 -48
  167. package/dist/{chunk-ZK22I3NF.js → chunk-TB734IYI.js} +4 -4
  168. package/dist/{chunk-GSHRYDJM.js → chunk-TFYVBPGR.js} +1 -1
  169. package/dist/{chunk-DYD7W3Y6.js → chunk-THKVAXTQ.js} +43 -26
  170. package/dist/{chunk-7SIZGM5S.js → chunk-TI5PPS3L.js} +89 -42
  171. package/dist/{chunk-VTUSC24F.js → chunk-TIVUSWGT.js} +2 -2
  172. package/dist/{chunk-ICJUN47O.js → chunk-TL5ICZT2.js} +2 -2
  173. package/dist/{chunk-YPELB4Q7.js → chunk-TS472T4D.js} +4 -4
  174. package/dist/{chunk-ISMFUWOP.js → chunk-TWMVAPG2.js} +4 -4
  175. package/dist/{chunk-QDFX2KAP.js → chunk-U2YWY6FH.js} +1 -1
  176. package/dist/{chunk-XXYV5UEM.js → chunk-UERGJOG4.js} +12 -12
  177. package/dist/{chunk-X725AGYP.js → chunk-UFKLGMYZ.js} +2 -2
  178. package/dist/{chunk-SXCFMPNM.js → chunk-UGH3CLTZ.js} +4 -4
  179. package/dist/{chunk-C26Z5AEW.js → chunk-ULXSTWJF.js} +3 -3
  180. package/dist/{chunk-IDJVUZAA.js → chunk-USK77VAZ.js} +4 -4
  181. package/dist/{chunk-ICERP2YF.js → chunk-UXAON5DO.js} +2 -2
  182. package/dist/{chunk-7ZXIHEZS.js → chunk-V3YQQDR4.js} +4 -4
  183. package/dist/{chunk-RLX6VODQ.js → chunk-V4XTBNZD.js} +2 -2
  184. package/dist/{chunk-YJN54OZS.js → chunk-VE6P436Y.js} +12 -12
  185. package/dist/{chunk-BXZNLMMH.js → chunk-VFXGAEUO.js} +2 -2
  186. package/dist/{chunk-XWGAANY4.js → chunk-VITZVVCD.js} +2 -2
  187. package/dist/{chunk-ADLKZEML.js → chunk-VJAZFGBY.js} +15 -15
  188. package/dist/{chunk-KWMQNKGX.js → chunk-VR3HLYAT.js} +6 -5
  189. package/dist/{chunk-UV77Y7QK.js → chunk-W2QJDTAR.js} +2 -2
  190. package/dist/{chunk-A3SOYL6F.js → chunk-WBIMWGV7.js} +4 -4
  191. package/dist/{chunk-OTOASFG4.js → chunk-WK6LQCUT.js} +6 -6
  192. package/dist/{chunk-SBYKLBDV.js → chunk-WOTRCVA5.js} +4 -4
  193. package/dist/{chunk-EWMPUCIG.js → chunk-WQPMBAG2.js} +37 -37
  194. package/dist/{chunk-WZNO3LUF.js → chunk-WSHSR3B2.js} +4 -4
  195. package/dist/{chunk-EH23CIC5.js → chunk-WVYC6MR6.js} +2 -2
  196. package/dist/{chunk-EZ5KUBYF.js → chunk-WY7FHINS.js} +3 -3
  197. package/dist/{chunk-4NIIQFDA.js → chunk-X4NDN6PQ.js} +10 -10
  198. package/dist/{chunk-3ZR7ZE64.js → chunk-XC53YNZG.js} +2 -2
  199. package/dist/{chunk-TQFBLSZJ.js → chunk-XGJZRPHC.js} +7 -7
  200. package/dist/{chunk-T4CFY4YT.js → chunk-XLP6U3FG.js} +2 -2
  201. package/dist/{chunk-2E2MK4XM.js → chunk-XMI7SCPX.js} +2 -2
  202. package/dist/{chunk-7QUWM5W6.js → chunk-XTECBM5K.js} +3 -3
  203. package/dist/{chunk-DO7MMF4C.js → chunk-Y7O3T4DF.js} +27 -26
  204. package/dist/{chunk-NPDF7HEH.js → chunk-YBMYW7LD.js} +1 -1
  205. package/dist/{chunk-5ZE7SHRM.js → chunk-YO7LCXKN.js} +2 -2
  206. package/dist/{chunk-AIPOSNVG.js → chunk-YRWJBS6C.js} +1 -1
  207. package/dist/{chunk-LADFOYH7.js → chunk-YSKLERPF.js} +6 -6
  208. package/dist/{chunk-OJR5GPCN.js → chunk-YUEJZBME.js} +4 -4
  209. package/dist/{chunk-3WC2TA6C.js → chunk-YUJK6ZYO.js} +2 -2
  210. package/dist/{chunk-ZIQR2CNM.js → chunk-YXHSM7QL.js} +5 -5
  211. package/dist/{chunk-SFRMBCVY.js → chunk-YZW4VLSO.js} +4 -4
  212. package/dist/{chunk-AUSZDYGE.js → chunk-Z2WGJH2P.js} +3 -3
  213. package/dist/{chunk-CX7WUNMO.js → chunk-ZMZNMVPR.js} +6 -6
  214. package/dist/{chunk-5QMM354E.js → chunk-ZT5Q6BRT.js} +1 -1
  215. package/dist/cli/index.js +1 -1
  216. package/dist/{core-A2MERE3C.js → core-2IWCOLCX.js} +1 -1
  217. package/dist/{core-BOU34T23.js → core-2SCAWP7F.js} +2 -1
  218. package/dist/{core-Y6DJHIYT.js → core-2ZRSLX2J.js} +2 -1
  219. package/dist/{core-BSEXRZD6.js → core-3H2PZVYN.js} +2 -1
  220. package/dist/{core-JJLIPTEW.js → core-4SX63YE4.js} +1 -1
  221. package/dist/{core-FXC4TB2K.js → core-76KPBWTL.js} +1 -1
  222. package/dist/{core-BOOD7ZUQ.js → core-7LODBY2T.js} +2 -1
  223. package/dist/{core-AVNB2Q3G.js → core-7PNZRGK7.js} +1 -1
  224. package/dist/{core-Q4IILTGO.js → core-7RSXZIVD.js} +1 -1
  225. package/dist/{core-W3UBWZR3.js → core-B7TS5HK6.js} +3 -1
  226. package/dist/{core-34YTH4KN.js → core-BEBRTX5W.js} +2 -1
  227. package/dist/{core-CXEEM26F.js → core-CTI37JP5.js} +1 -1
  228. package/dist/{core-HMS72VO6.js → core-DICZFWV4.js} +1 -1
  229. package/dist/{core-XYQRB5WF.js → core-DZVYQFBX.js} +2 -1
  230. package/dist/{core-IYEFTP6C.js → core-E6Q3H52Q.js} +1 -1
  231. package/dist/{core-MVIK7FAJ.js → core-EQP4ERQK.js} +1 -1
  232. package/dist/{core-6KO5AEUH.js → core-FZJOKAFE.js} +1 -1
  233. package/dist/{core-VGMMKEU4.js → core-GGKGWGHO.js} +2 -1
  234. package/dist/{core-2PT7IROA.js → core-J7ZHSASB.js} +1 -1
  235. package/dist/{core-YJXOVNIE.js → core-LCX7EK3Y.js} +2 -1
  236. package/dist/{core-QCPDOQEJ.js → core-LSN2YKO4.js} +1 -1
  237. package/dist/{core-VWISBHXE.js → core-NL6TMYOZ.js} +1 -1
  238. package/dist/{core-RVTF336C.js → core-NPCHUGTV.js} +1 -1
  239. package/dist/{core-MBNVENCZ.js → core-OO22DXBW.js} +1 -1
  240. package/dist/{core-J2QTOU4D.js → core-QACGDEDF.js} +7 -1
  241. package/dist/{core-VUVJOMUC.js → core-RZ5ZDSQL.js} +1 -1
  242. package/dist/{core-N4OKPNXQ.js → core-S56FGRAT.js} +1 -1
  243. package/dist/{core-YHWVJULU.js → core-SERUDXVA.js} +1 -1
  244. package/dist/{core-7WLD237S.js → core-UOATHRZG.js} +1 -1
  245. package/dist/{core-LCP44UYI.js → core-UPPUXBWO.js} +1 -1
  246. package/dist/{core-IQC6H4A7.js → core-UYTRLCZY.js} +1 -1
  247. package/dist/{core-I2GPMB2B.js → core-V55HGH7X.js} +1 -1
  248. package/dist/{core-B7KOBTRL.js → core-W5WF7FHA.js} +7 -1
  249. package/dist/{core-BQ2I77OF.js → core-XINQIYQ6.js} +1 -1
  250. package/dist/{core-EHMPBG6Q.js → core-Y3WI32MB.js} +4 -1
  251. package/dist/{core-4ZEVWU43.js → core-ZFXHFRWI.js} +3 -1
  252. package/dist/{core-64EHPUVV.js → core-ZYLCLTFQ.js} +1 -1
  253. package/dist/{dataTable-3ZK3ZEZP.js → dataTable-72HO6PCW.js} +2 -2
  254. package/dist/{engine-FSWLRWZR.js → engine-UCMXMWGA.js} +26 -13
  255. package/dist/fixtures.js +1 -1
  256. package/dist/index.js +12 -12
  257. package/dist/{main-NYMXWJGJ.js → main-NS5NPNQ7.js} +6 -6
  258. package/dist/mcp/server.js +11 -11
  259. package/dist/react/bar.js +3 -1
  260. package/dist/react/bartable.js +1 -1
  261. package/dist/react/box.js +1 -1
  262. package/dist/react/bullet.js +2 -1
  263. package/dist/react/butterfly.js +1 -1
  264. package/dist/react/choropleth.js +1 -1
  265. package/dist/react/cohort.js +1 -1
  266. package/dist/react/column.js +2 -1
  267. package/dist/react/combo.js +7 -1
  268. package/dist/react/creative.js +1 -1
  269. package/dist/react/diagram.js +1 -1
  270. package/dist/react/dimswitch.js +1 -1
  271. package/dist/react/dot.js +4 -1
  272. package/dist/react/export.js +15 -15
  273. package/dist/react/funnel.js +1 -1
  274. package/dist/react/gantt.js +1 -1
  275. package/dist/react/grid.js +1 -1
  276. package/dist/react/heatmap.js +1 -1
  277. package/dist/react/histogram.js +2 -1
  278. package/dist/react/index.js +83 -83
  279. package/dist/react/kpi.js +1 -1
  280. package/dist/react/likert.js +3 -1
  281. package/dist/react/line.js +1 -1
  282. package/dist/react/mekko.js +2 -1
  283. package/dist/react/pareto.js +5 -1
  284. package/dist/react/pie.js +1 -1
  285. package/dist/react/prepare.js +20 -20
  286. package/dist/react/pvm.js +2 -1
  287. package/dist/react/pyramid.js +1 -1
  288. package/dist/react/sankey.js +1 -1
  289. package/dist/react/scatter.js +1 -1
  290. package/dist/react/slope.js +2 -1
  291. package/dist/react/sparkline.js +1 -1
  292. package/dist/react/spec.js +8 -8
  293. package/dist/react/status.js +1 -1
  294. package/dist/react/story.js +1 -1
  295. package/dist/react/table.js +1 -1
  296. package/dist/react/theme.js +2 -2
  297. package/dist/react/tilemap.js +1 -1
  298. package/dist/react/treemap.js +1 -1
  299. package/dist/react/variance.js +2 -1
  300. package/dist/react/waffle.js +1 -1
  301. package/dist/react/waterfall.js +2 -1
  302. package/dist/{rowsModule-43LCK2Q7.js → rowsModule-QGCXTE6X.js} +1 -1
  303. package/dist/{schema-NNNG7CWG.js → schema-2BFNQ5GW.js} +1 -1
  304. package/dist/{schema-VH4AW62Z.js → schema-2XGHH7PU.js} +1 -1
  305. package/dist/{schema-KWCIIIGP.js → schema-3IXLM7X4.js} +1 -1
  306. package/dist/{schema-LDF6HORS.js → schema-4SRLAXUP.js} +1 -1
  307. package/dist/{schema-IYLRZNFB.js → schema-6PLNMFVY.js} +1 -1
  308. package/dist/{schema-FPDLOIA6.js → schema-6WNG4LCV.js} +1 -1
  309. package/dist/{schema-A4U4RDKJ.js → schema-7WNRP7FW.js} +1 -1
  310. package/dist/{schema-IYBZPCM4.js → schema-7XQMEJII.js} +1 -1
  311. package/dist/{schema-LGYHJPXU.js → schema-AGKSRVXN.js} +1 -1
  312. package/dist/{schema-FQWENOJY.js → schema-AMIFJ2JX.js} +1 -1
  313. package/dist/{schema-SQ2GYLMI.js → schema-BK2TU6XT.js} +1 -1
  314. package/dist/{schema-AM2KS6ZC.js → schema-C3PYINCY.js} +1 -1
  315. package/dist/{schema-D3ELHESU.js → schema-CWOPBOK4.js} +1 -1
  316. package/dist/{schema-FBIEOKO2.js → schema-E2WWDYU5.js} +1 -1
  317. package/dist/{schema-LX4EXDTI.js → schema-EAYC5DVH.js} +1 -1
  318. package/dist/{schema-GTLGAPCU.js → schema-ENLWEZOI.js} +1 -1
  319. package/dist/{schema-HAMPGUH3.js → schema-ETH6WXZU.js} +1 -1
  320. package/dist/{schema-CBLNGK2F.js → schema-FOBGNU5I.js} +1 -1
  321. package/dist/{schema-GYVYJEL3.js → schema-FSX7WR7M.js} +1 -1
  322. package/dist/{schema-5SVPR3EU.js → schema-G6KGEQRD.js} +1 -1
  323. package/dist/{schema-SUDJBIHX.js → schema-GAUZZRA4.js} +1 -1
  324. package/dist/{schema-2ACHQTR3.js → schema-GFRB4BJW.js} +1 -1
  325. package/dist/{schema-KBV2JB2A.js → schema-GQPXSWIR.js} +1 -1
  326. package/dist/{schema-WDKBCN3V.js → schema-JJIXQIBN.js} +1 -1
  327. package/dist/{schema-C25ECGJL.js → schema-JKZBRZSI.js} +1 -1
  328. package/dist/{schema-4YIYGGOJ.js → schema-MCA4J2BP.js} +1 -1
  329. package/dist/{schema-P2JYSV32.js → schema-MM7JPYI7.js} +1 -1
  330. package/dist/{schema-GUDG343K.js → schema-O5HGNE3W.js} +2 -2
  331. package/dist/{schema-YVBUY7NH.js → schema-OIY565PO.js} +1 -1
  332. package/dist/{schema-TRPPZCIR.js → schema-PVUWOLUB.js} +1 -1
  333. package/dist/{schema-PAKZIYQF.js → schema-RRZXOF5G.js} +1 -1
  334. package/dist/{schema-4HGZZNUL.js → schema-UEZQN4WK.js} +1 -1
  335. package/dist/{schema-GYTWCCNA.js → schema-WWWWEQAR.js} +1 -1
  336. package/dist/{schema-3LRC5TOZ.js → schema-XQSP5QAX.js} +1 -1
  337. package/dist/{schema-UNYDUIL5.js → schema-YUMFWHIE.js} +1 -1
  338. package/dist/{schema-5OLQ54J5.js → schema-ZBIIPJAI.js} +1 -1
  339. package/dist/{schema-YCKUQ3FF.js → schema-ZFUX3UIO.js} +1 -1
  340. package/dist/{specValidation-FKHSTMMR.js → specValidation-5AI56FM3.js} +1 -1
  341. package/dist/theme.js +3 -3
  342. package/dist/{themeShapeRules-G7UZX6GJ.js → themeShapeRules-GGBYWZY7.js} +1 -1
  343. package/dist/types/core/annotate.d.ts +12 -3
  344. package/dist/types/core/annotateFields.d.ts +36 -1
  345. package/dist/types/core/annotateTargets.d.ts +2 -0
  346. package/dist/types/core/types/data.d.ts +6 -0
  347. package/dist/types/core/types/options.d.ts +4 -0
  348. package/dist/types/core/types/theme.d.ts +17 -2
  349. package/dist/types/react/hover/engine.d.ts +5 -1
  350. package/dist/types/react/hover/labelCard.d.ts +33 -2
  351. package/dist/types/theme.d.ts +1 -1
  352. package/dist/validate.js +5 -5
  353. package/docs/manual.md +1 -1
  354. package/docs/reference/bar.md +2 -2
  355. package/docs/reference/bullet.md +6 -4
  356. package/docs/reference/butterfly.md +1 -1
  357. package/docs/reference/column.md +2 -2
  358. package/docs/reference/combo.md +2 -2
  359. package/docs/reference/dot.md +2 -2
  360. package/docs/reference/fixtures.md +2 -0
  361. package/docs/reference/grid.md +2 -2
  362. package/docs/reference/heatmap.md +1 -1
  363. package/docs/reference/line.md +2 -2
  364. package/docs/reference/mekko.md +2 -2
  365. package/docs/reference/options.md +3 -1
  366. package/docs/reference/pvm.md +1 -1
  367. package/docs/reference/react.md +7 -3
  368. package/docs/reference/scatter.md +1 -1
  369. package/docs/reference/slope.md +2 -2
  370. package/docs/reference/sparkline.md +1 -0
  371. package/docs/reference/table.md +1 -1
  372. package/docs/reference/theme.md +2 -0
  373. package/docs/reference/variance.md +1 -1
  374. package/docs/reference/warnings.md +3 -2
  375. package/docs/reference/waterfall.md +6 -4
  376. package/package.json +1 -1
  377. package/dist/chunk-CDZHNLO6.js +0 -42
  378. package/dist/chunk-GIJM4MP4.js +0 -272
  379. package/dist/chunk-J6LGZPKI.js +0 -89
  380. package/dist/chunk-QPWRHDLZ.js +0 -17
  381. package/dist/chunk-REIIGIJG.js +0 -123
@@ -22,9 +22,44 @@ export type CategoryBand = {
22
22
  };
23
23
  export declare function categoryBandFromCenters(ids: Id[], plot: Rect, centerOf: (index: number) => number, axis: 'x' | 'y'): (categoryId: Id) => CategoryBand | null;
24
24
  export declare function categoryTargetFields(ids: Id[], plot: Rect, centerOf: (index: number) => number, axis: 'x' | 'y'): Pick<TargetScaleInput, 'categoryIds' | 'resolveCategoryBand' | 'bandPlot'>;
25
- export declare function spliceAnnotationNodes(nodes: SceneNode[], annotationNodes: SceneNode[]): void;
25
+ /**
26
+ * Puts the band and attainment fills of the annotation pass behind the chart's marks, gridlines
27
+ * and lines, and the other annotation nodes on top. `owners`, when given, limits the fills that
28
+ * move behind to those annotations; the rest stay on top, as a chart that drew them there had them.
29
+ */
30
+ export declare function spliceAnnotationNodes(nodes: SceneNode[], annotationNodes: SceneNode[], owners?: ReadonlySet<Id>): void;
26
31
  export declare function isCategoryAlongY(band: CategoryBand): band is {
27
32
  y: number;
28
33
  h: number;
29
34
  };
30
35
  export declare function valueLineHasTargetExtras(ann: Annotation): boolean;
36
+ /**
37
+ * A valueLine that bar and dot leave to the shared annotate pass, as column
38
+ * draws it: one with a category span, a series scope, a tolerance or an
39
+ * attainment. The pass clips the band to the span, warns on a span it cannot
40
+ * resolve and omits a scoped line it cannot honour. Their own vertical
41
+ * drawing knows none of this, so it takes only the plain line.
42
+ */
43
+ export declare function valueLineNeedsSharedPass(ann: Annotation): boolean;
44
+ export declare function finitePair(low: unknown, high: unknown): {
45
+ low: number;
46
+ high: number;
47
+ } | null;
48
+ /**
49
+ * The bounds of a valueLine's tolerance band, or the reason it has none. A
50
+ * layout reads them to size its value axis before the annotation pass loads,
51
+ * so they stand here and not beside the pass that draws the band.
52
+ */
53
+ export declare function toleranceBounds(value: number, tolerance: NonNullable<Extract<Annotation, {
54
+ kind: 'valueLine';
55
+ }>['tolerance']>): {
56
+ low: number;
57
+ high: number;
58
+ } | string;
59
+ /** A bound as the chart prints its numbers: without a format a late value of the chart's levels, else a set of its own. The band's key prints the same text. */
60
+ export declare function bandBoundText(input: Pick<TargetScaleInput, 'format' | 'locale' | 'levelSpec'>, v: number): string;
61
+ /** The fill of a value line's tolerance band, and of its key. */
62
+ export declare const TOLERANCE_FILL: {
63
+ readonly token: 'others';
64
+ readonly tint: 0.45;
65
+ };
@@ -40,6 +40,8 @@ export interface TargetScaleInput {
40
40
  levelSpec?: NumberFormatSpec;
41
41
  /** Caller wording, so a band's range words match its hover card. */
42
42
  strings?: StringsSpec;
43
+ /** Value lines whose tolerance band the chart's key names with its bounds: such a band prints no bounds of its own. */
44
+ toleranceKeyed?: ReadonlySet<Id>;
43
45
  }
44
46
  export declare function isCeilingClaim(o: OccupiedRect, ceilingRects?: readonly Rect[]): boolean;
45
47
  export declare function valueMapper(input: Pick<TargetScaleInput, 'yScale' | 'xScale'>): {
@@ -139,6 +139,8 @@ export interface WaterfallItem {
139
139
  scenario?: Scenario;
140
140
  direction?: Direction;
141
141
  toBaseline?: boolean;
142
+ /** A step without segments: its bar's theme colour role, as a segment takes one. */
143
+ colorRole?: ColorRole;
142
144
  /** With `data.cases`: one value per case, in case order, in place of `value`. */
143
145
  values?: Cell[];
144
146
  }
@@ -184,6 +186,8 @@ export interface ScatterData {
184
186
  }
185
187
  export interface BulletBand {
186
188
  tone?: 'good' | 'warn' | 'bad' | 'neutral';
189
+ /** Where the band starts; without it, the previous band's `to`, or 0. Space no band covers is not shaded. */
190
+ from?: number;
187
191
  to: number;
188
192
  label?: string;
189
193
  }
@@ -246,6 +250,8 @@ export interface SparklineData {
246
250
  values: Cell[];
247
251
  /** One name per value, used for the end labels and the hover records. */
248
252
  labels?: string[];
253
+ /** The name of the metric the line shows. The hover card names each value with it ("Orders: 18"); nothing on the chart prints it. */
254
+ label?: string;
249
255
  }
250
256
  export interface GridPanel {
251
257
  id: Id;
@@ -166,6 +166,10 @@ export interface StringsSpec {
166
166
  average?: string;
167
167
  /** Tolerance-band bounds. Fields: {v1}, {v2}. */
168
168
  valueLineRange?: string;
169
+ /** Key of a tolerance band on a column, bar or dot chart. Fields: {name}, {range}. */
170
+ valueLineRangeKey?: string;
171
+ /** Key of a tolerance band whose line has no name. Fields: {range}. */
172
+ valueLineRangeKeyPlain?: string;
169
173
  /** Text after a running category name in its key or note. */
170
174
  toDate?: string;
171
175
  /** Key for the forecast pattern. */
@@ -280,6 +280,8 @@ export interface Theme {
280
280
  tierGap: number;
281
281
  facetGap: number;
282
282
  labelPad: number;
283
+ /** Vertical gap in px above the heading of a stacked tier. Absent: tierGap plus three labelPads. */
284
+ tierHeadingGap?: number;
283
285
  /**
284
286
  * Canvas margin tokens, keyed by width
285
287
  * class: `base` covers W-S/W-M, `wide` covers W-L (≥ 1080 px). Optional
@@ -729,6 +731,8 @@ export interface ThemeTable {
729
731
  };
730
732
  /** True: density changes row height and cell padding only, never a type size. */
731
733
  fixedType?: boolean;
734
+ /** Px of air the compact density takes off each side of a body or total row. Absent: half of the row's regular air, rounded down. */
735
+ compactStep?: number;
732
736
  /** What a change against a previous column prints where the group has none. */
733
737
  noPrevious?: 'na' | 'missing';
734
738
  /** Which group rows carry the group ground when the table option `groupGround` is absent: 'expanded' (default), 'always' or 'none'. */
@@ -868,8 +872,19 @@ export interface ThemeTablePad {
868
872
  */
869
873
  export type ThemeRef = string | {
870
874
  preset: string;
871
- overrides?: DeepPartial<Theme>;
875
+ overrides?: ThemeOverrides;
872
876
  } | {
873
877
  preset?: never;
874
- overrides: DeepPartial<Theme>;
878
+ overrides: ThemeOverrides;
879
+ };
880
+ /**
881
+ * Theme overrides: every token is optional. A text role that a theme may
882
+ * leave out (secondary, micro) takes any subset of its fields; the fields an
883
+ * override leaves out keep the values the theme draws for that text.
884
+ */
885
+ export type ThemeOverrides = Omit<DeepPartial<Theme>, 'type'> & {
886
+ type?: Omit<DeepPartial<Theme['type']>, 'secondary' | 'micro'> & {
887
+ secondary?: Partial<FontSpec>;
888
+ micro?: Partial<FontSpec>;
889
+ };
875
890
  };
@@ -157,8 +157,12 @@ export declare function CustomCard({ input, theme, origin, label, contentId, loc
157
157
  * when the open record was picked, to the card `card`: the convex hull of the
158
158
  * point and the box. A pointer on its way to the card crosses other marks;
159
159
  * inside the corridor the open card stays. Client pixels.
160
+ *
161
+ * A pointer on the points' path (`path`, CSS pixels from the chart's
162
+ * `origin`) is on its way to another point, not to the card: there the
163
+ * pointer picks again, so the card never holds a point the pointer has left.
160
164
  */
161
- export declare function inCardCorridor(from: Point, card: Rect, point: Point): boolean;
165
+ export declare function inCardCorridor(from: Point, card: Rect, point: Point, path?: readonly Point[], origin?: Point): boolean;
162
166
  export interface TableCardAnchor {
163
167
  x: number;
164
168
  y: number;
@@ -90,6 +90,14 @@ export interface LabelCardInput {
90
90
  pointer?: Point;
91
91
  previousSide?: CardSide;
92
92
  band?: 'x' | 'y';
93
+ /**
94
+ * On a chart that picks its record by the pointer's position along an axis,
95
+ * the convex hull of its points: the area the pointer crosses on its way
96
+ * from one point to another. A seat keeps `PATH_PAD` clear of it.
97
+ */
98
+ path?: readonly Point[];
99
+ /** The pointed record's own mark, where `target` spans its whole category: a seat off `path` stays within `CLEAR_REACH` of it. */
100
+ mark?: Rect;
93
101
  /** Prefer clear table space; reading order breaks equal costs. */
94
102
  slots?: 'table';
95
103
  direction?: 'ltr' | 'rtl';
@@ -108,10 +116,20 @@ export interface LabelCardLayout extends LabelCardContent {
108
116
  scene: SceneNode[];
109
117
  decisions: PlaceDecision[];
110
118
  side?: CardSide;
119
+ /** The seat meets the points' path (`LabelCardInput.path`): the card lets the pointer through to the points under it. */
120
+ overPath?: boolean;
111
121
  }
112
122
  export type LabelCardGeometry = Pick<Geometry, 'type' | 'size' | 'scene' | 'legend' | 'a11y' | 'sizing' | 'mode'>;
113
123
  /** Crop an already measured card scene to its own rectangle for standalone rendering. */
114
124
  export declare function labelCardGeometry(layout: LabelCardLayout): LabelCardGeometry;
125
+ /**
126
+ * A unit that is a phrase in words ("cases per month", "% of started cases",
127
+ * "orders") names the number on the hover card. A sign, a code or a scale
128
+ * stays with the number: "$", "%", "pp", "kg", "ms", "USD", "EUR k", "$bn",
129
+ * "k orders" and "thousand per month" (the scale belongs to the number),
130
+ * "$ per share" (the sign goes in front of the number).
131
+ */
132
+ export declare function unitPhrase(unit: string | undefined): boolean;
115
133
  /**
116
134
  * Format only the existing record facts; never infer comparisons from rounded
117
135
  * strings. The value row, the field rows, the change and the share print the
@@ -135,6 +153,12 @@ export declare function sharedLabelCardContent(records: readonly InteractionReco
135
153
  export declare function describedWithCard(description: string, reading: string): string;
136
154
  /** Show a table card only when it contains facts beyond the cell's printed value. */
137
155
  export declare function shouldShowTableLabelCard(record: InteractionRecord, displayed: string | undefined, locale?: string): boolean;
156
+ /** Space a card keeps from the points' path, and the pointer's reach beside it that still reads as on the path. */
157
+ export declare const PATH_PAD = 8;
158
+ /** The convex hull of `points`, in order around it; one or two points stay as they are. */
159
+ export declare function pointsHull(points: readonly Point[]): Point[];
160
+ /** Whether `point` lies within `pad` of the hull `path`. */
161
+ export declare function nearPath(path: readonly Point[], point: Point, pad?: number): boolean;
138
162
  interface CardSlot extends SlotCandidate {
139
163
  side?: CardSide;
140
164
  fits?: boolean;
@@ -160,8 +184,9 @@ export declare function tableCardSlots(target: Rect, boundary: Rect, width: numb
160
184
  * A safe seat that covers fewer texts (`hidden`) wins over one that covers
161
185
  * more, whatever its phase: a covered number is lost to the reader. Only a
162
186
  * clear seat beyond its reach loses to any safe seat, whatever that seat hides.
187
+ * A seat `inWay` of the pointer's path is never safe, in any phase.
163
188
  */
164
- export declare function selectCardSlot(candidates: CardSlots, forbidden: readonly Rect[], cost: (slot: CardSlot) => number, pointer?: Point, clear?: (slot: CardSlot) => boolean, hidden?: (slot: CardSlot) => number): CardSlot;
189
+ export declare function selectCardSlot(candidates: CardSlots, forbidden: readonly Rect[], cost: (slot: CardSlot) => number, pointer?: Point, clear?: (slot: CardSlot) => boolean, hidden?: (slot: CardSlot) => number, inWay?: (slot: CardSlot) => boolean): CardSlot;
165
190
  export declare function activeCoverCost(rect: Rect, active?: readonly Rect[]): number;
166
191
  export declare function cardCoverCost(rect: Rect, occupied: LabelCardInput['occupied'], table?: boolean): number;
167
192
  /**
@@ -193,6 +218,12 @@ export declare function layoutLabelCardContent(input: LabelCardInput, content: L
193
218
  * Both searches stay near the mark. A card far from its mark reads as no card of
194
219
  * that mark, which is worse than a hidden label, so a clear seat beyond
195
220
  * `CLEAR_REACH` is taken only when no nearer seat is safe.
221
+ *
222
+ * With a points path, a seat off the path wins when it stands within
223
+ * `CLEAR_REACH` of the mark and hides no text; else the card takes the seat it
224
+ * would take without the path, and `overPath` says whether that seat meets the
225
+ * path. A host's own card (`strict`) always keeps off the path, as it takes
226
+ * the pointer.
196
227
  */
197
- export declare function placeLabelCard(input: LabelCardInput, width: number, height: number): Pick<LabelCardLayout, 'placement' | 'rect' | 'side' | 'decisions'>;
228
+ export declare function placeLabelCard(input: LabelCardInput, width: number, height: number, strict?: boolean): Pick<LabelCardLayout, 'placement' | 'rect' | 'side' | 'decisions' | 'overPath'>;
198
229
  export {};
@@ -1,5 +1,5 @@
1
1
  export { registerTheme, resolveTheme, typeForTarget } from './core/theme.js';
2
2
  /** @internal A host sizes a table with it, with no scene and no hidden render. */
3
3
  export { themeGeometryTokens } from './core/themeGeometry.js';
4
- export type { Theme, ThemeRef } from './core/types/theme.js';
4
+ export type { Theme, ThemeOverrides, ThemeRef } from './core/types/theme.js';
5
5
  export type { RenderTarget } from './core/types/options.js';
package/dist/validate.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  parseThemeJson
3
- } from "./chunk-YJXIHVNK.js";
3
+ } from "./chunk-LMDU5MNF.js";
4
4
  import {
5
5
  registerCatalogue
6
- } from "./chunk-VT6PDWUA.js";
6
+ } from "./chunk-G3CVCW5K.js";
7
7
 
8
8
 
9
9
 
@@ -151,7 +151,7 @@ import {
151
151
 
152
152
  import {
153
153
  linkAnnotateEngine
154
- } from "./chunk-4LCQO46F.js";
154
+ } from "./chunk-P3CZFAFA.js";
155
155
 
156
156
 
157
157
 
@@ -191,7 +191,7 @@ import {
191
191
 
192
192
  import {
193
193
  linkThemeShapeRules
194
- } from "./chunk-IXOBDDMW.js";
194
+ } from "./chunk-RD24ORGR.js";
195
195
 
196
196
 
197
197
 
@@ -205,7 +205,7 @@ import {
205
205
  import {
206
206
  getChartDefinition,
207
207
  listCharts
208
- } from "./chunk-YM4MVABU.js";
208
+ } from "./chunk-FY3VV7TF.js";
209
209
 
210
210
 
211
211
 
package/docs/manual.md CHANGED
@@ -906,7 +906,7 @@ On a column with a reference series (`role: "reference"`, drawn as a tick), the
906
906
  | Stacked and stacked100 column and bar; stacked and stacked100 Mekko; Likert | All except `'outsideEnd'` |
907
907
  | Combo with two or more column series; integrated variance | All except `'outsideEnd'` |
908
908
 
909
- A total above two or more stack parts stays above the stack. A stacked column or bar with one drawn part moves its total with the option, except in stacked100. A combo column with one drawn part moves its total too. Waterfall segment values and the sums or totals of segmented bridge bars keep their existing seats. PVM's net change takes the space directly past the closing bar when its total moves inside.
909
+ A total above two or more stack parts stays above the stack. A stacked column or bar with one drawn part moves its total with the option, except in stacked100. A combo column with one drawn part moves its total too. Waterfall segment values and the sums or totals of bridge bars with two or more segments keep their existing seats. A bridge bar with one segment moves its value with the option, as a plain step does. A plain step's `colorRole` (such as `neutralLight` for a grey step) keeps that seat on its own fill. PVM's net change takes the space directly past the closing bar when its total moves inside.
910
910
 
911
911
  `labelPlacements` pins take precedence and keep their existing slot meanings. `labelDensity`, `valueLabels`, `labels` and authored cell labels still decide which values print. `labelPosition` takes precedence over the theme's `marks.barLabels` setting. The chart keeps the plot room reserved by its normal placement. A grid panel accepts the option through that panel's own options.
912
912
 
@@ -84,7 +84,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
84
84
  | series | array | yes | Series supplying values for each category, with optional reference series for comparisons. |
85
85
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
86
86
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
87
- | series[].label | string | | Displayed series name; defaults to the series id. |
87
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
88
88
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. In a football field, null cells and cells without a range are left out with a warning and a note, provided at least one method has a range. |
89
89
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
90
90
  | series[].direction | string | | Whether increases are favorable; defaults to higherIsBetter for directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
@@ -142,7 +142,7 @@ An annotation anchor is a category or item id string, or an object with category
142
142
 
143
143
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
144
144
  |---|---|---|---|---|---|
145
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. 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. |
145
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. 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. |
146
146
  | 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. |
147
147
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
148
148
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
@@ -42,8 +42,9 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
42
42
  | rows[].date | string | | ISO period date for CAGR between same-measure rows on a shared scale. |
43
43
  | rows[].value | cell | yes | Actual measure drawn as the row bar. |
44
44
  | rows[].target | cell | | Reference measure drawn as the target tick and used for target deltas. It uses the row value's format or options.format; a different target.format warns because it is ignored. options.strings.target renames the comparison mark in labels (e.g. 'peer median'). |
45
- | rows[].bands | array | | Ordered qualitative band thresholds, as numbers or labeled threshold objects. |
45
+ | rows[].bands | array | | Ordered qualitative band thresholds, as numbers or labeled threshold objects. A band object's from starts it above the previous band, so a tolerance range such as {from: 94, to: 104} needs no band below it. |
46
46
  | rows[].bands[].tone | string | | Semantic band tone. Toned bands define a two-sided corridor and set the delta tone for values inside them. A toned band paints its tone's fill washed toward the page (theme marks.bulletBandFill). One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
47
+ | rows[].bands[].from | number | | Value where this band starts, in the row value units. Without it the band starts at the previous band's to, or at 0. Space that no band covers is not shaded and lies in no band, so a value there takes no band tone. A from below 0, not below the band's own to, or below the previous band's to is ignored with the warning band-from-ignored. |
47
48
  | rows[].bands[].to | number | yes | Upper endpoint of this qualitative band in the row value units. |
48
49
  | rows[].bands[].label | string | | Visible name of this qualitative band. |
49
50
  | rows[].direction | string | | Whether a higher measure is favorable when interpreting the target difference. Neutral uses plain ink without a judgment, including when bands have tones. One of `'higherIsBetter'`, `'lowerIsBetter'`, `'neutral'`. |
@@ -52,7 +53,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
52
53
 
53
54
  | Path | Type | Values | Default | Meaning |
54
55
  |---|---|---|---|---|
55
- | labels | false \| object | `false` (or another value of its type) | | False hides value, target-value and delta labels. Row names, band names and band-edge numbers remain. category: false hides row names. position: false drops the line under each gap (below, above or on target) and direction: false the line under each name (higher or lower is better); annotation: false still drops all of them. strings.lowerBetter '' equals direction: false on lower-is-better rows. density: compact draws no labels. |
56
+ | labels | false \| object | `false` (or another value of its type) | | False hides value, target-value and delta labels. Row names, band names and band-edge numbers remain. category: false hides row names. Beside the target columns, position: true adds the line under each gap (below, above or on target), and direction: true the line under each name (higher or lower is better) on rows with a target. Both are off by default. A row without a target or with toned bands prints no direction line. annotation: false still drops all of them. strings.lowerBetter '' drops the direction line on lower-is-better rows. density: compact draws no labels. |
56
57
  | sort | object \| string \| true | `'sheet'`, `'asc'`, `'desc'`, `'reverse'`, `true` (or another value of its type) | | Category ranking value: value divided by target when every row has a positive target, otherwise raw value. desc puts the highest ranking value first even on lower-is-better rows. Ties keep authored order and null values sort last. sheet keeps authored order and reverse reverses it. Dated rows keep authored order when a growth or difference annotation spans periods. |
57
58
  | columnOverrides | object | | | Settings per generated column. Ids: label, actual, share, delta, target, gap. |
58
59
  | columnOverrides.*.width | number | | | Track width in px. It beats the width the type would pick. |
@@ -65,7 +66,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
65
66
  | axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
66
67
  | sharedScale | boolean \| string | `'percentOfTarget'` (or another value of its type) | | true: one absolute scale across all rows (same-unit rows, comparable magnitudes; supports valueAxis). false: each row normalized to its own zero-based extent — band maximum extended by value/target overshoot; a bandless row uses its value/target extent (the bullet-graph percent-of-scale — mixed-unit KPI rows stay legible; valueAxis is ignored with a warning). 'percentOfTarget': every row in percent of its own target (actual ÷ target) on one 0–120% scale, three shared bands named once in a key (below 80%, 80–100%, at or above target), mirrored at 100% on a lower-is-better row (the key then reads more than 20% off, up to 20% off, on target or better), one target line at 100%, value, share of target and delta beside each row; the rows' bands, valueAxis and annotations are not drawn. Default: false when every row declares bands and the rows differ in unit or band thresholds (warns bullet-row-scales), true otherwise. |
67
68
  | bandKey | string | `'auto'`, `'labels'`, `'ramp'`, `'row'` | `'auto'` | How the bands are named. 'labels': one key entry for each band label and shade. 'ramp': one worse-to-better key with one entry for each band (Worse ... Better); it needs the same 2 to 5 bands on every banded row, no band tone and no neutral row, and otherwise keeps labels with a warning. 'row': each band's name prints above its band on every row, as authored; on per-row scales the band edges are ticked and numbered under each row; a key at the bottom names the bar (Actual), the target tick and, when strings.bandKey is set, the ramp in those words. It needs a name on every band, rows side by side with the target column, and room for each name above its band; otherwise the key names the bands with a warning. 'auto': 'row' for at most 4 rows that name every band wherever it can show; else the ramp when rows run both directions, a label sits on more than one shade and the ramp can apply; otherwise labels. Default 'auto'. The percentOfTarget scale has its own key. |
68
- | targetColumns | boolean | | `true` | true: where the rows sit side by side and the plot keeps 45% of the width, a Target column and a Gap-to-target column print beside the rows, each under a head, with the gap's position (below, above or on target) under it and the row's direction (higher or lower is better) under its name. Where they do not fit, the target prints above its tick and the delta at the row end. false: always the second form. Default true. The percentOfTarget scale has its own columns. |
69
+ | targetColumns | boolean | | `true` | true: where the rows sit side by side and the plot keeps 45% of the width, a Target column and a Gap-to-target column print beside the rows, each under a head. The name and every number of a row are centred on its bar, and a line under one (labels.position, labels.direction) hangs below it. A row without a target prints the not-applicable glyph (strings.notApplicable, default n/a) in both cells. Where they do not fit, the target prints above its tick and the delta at the row end. false: always the second form. Default true. The percentOfTarget scale has its own columns. |
69
70
  | density | string | `'compact'`, `'regular'` | `'regular'` | 'compact' is the 120 x 28 text-free mark: bar, bands and target tick, no labels, axis or key. The percentOfTarget scale needs a key and a value column, so compact refuses it. 'regular' uses labelled stacked rows when side columns take too much plot width. Height depends on row count and text. Default 'regular'. |
70
71
 
71
72
  Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN` with an `option-ignored` warning.
@@ -82,7 +83,7 @@ An annotation anchor is a category or item id string, or an object with category
82
83
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
83
84
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
84
85
  | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
85
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. 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. |
86
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. 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. |
86
87
  | 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). |
87
88
  | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
88
89
  | line | Draws a straight line between two points or from a text annotation, in the ink and rule width of a bracket; a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the line in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the line starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
@@ -133,3 +134,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
133
134
  | columns-hidden | example | columnVisibility leaves the share column out of the percent-of-target rows |
134
135
  | plot-first | example | columnOrder puts the marks first and reverses the columns behind them |
135
136
  | no-direction-line | example | labels.direction and labels.position drop the second lines beside the target columns |
137
+ | tolerance-range | example | from shades only the tolerance range around each target and leaves the space below it blank |
@@ -54,7 +54,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
54
54
  | series | array | yes | Series containing the two pane values selected by options.a and options.b. |
55
55
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
56
56
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
57
- | series[].label | string | | Displayed series name; defaults to the series id. |
57
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
58
58
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
59
59
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
60
60
  | series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
@@ -54,7 +54,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
54
54
  | series[].axis | string | | Accepted for combo-shaped data. Ignored here. A kind that differs from the chart type is refused. One of `'primary'`, `'secondary'`. |
55
55
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
56
56
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
57
- | series[].label | string | | Displayed series name; defaults to the series id. |
57
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
58
58
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
59
59
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
60
60
  | series[].direction | string | | Whether increases are favorable; defaults to higherIsBetter for directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
@@ -149,7 +149,7 @@ An annotation anchor is a category or item id string, or an object with category
149
149
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | Drawn reference series accept anchors. |
150
150
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
151
151
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
152
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. 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. |
152
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. 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. |
153
153
  | 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. |
154
154
  | 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. |
155
155
  | 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. | 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. |
@@ -67,7 +67,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
67
67
  | series | array | yes | Series supplying values for each category, with optional reference series for comparisons. |
68
68
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
69
69
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
70
- | series[].label | string | | Displayed series name; defaults to the series id. |
70
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
71
71
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
72
72
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
73
73
  | series[].role | string | | Data series or comparison-only reference series; references are excluded from the main plotted data. One of `'data'`, `'reference'`. |
@@ -151,7 +151,7 @@ An annotation anchor is a category or item id string, or an object with category
151
151
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | Drawn reference series accept anchors. |
152
152
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
153
153
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
154
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. axis: primary \| secondary, default primary. Scale of value; secondary needs an acknowledged secondary axis. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
154
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. axis: primary \| secondary, default primary. Scale of value; secondary needs an acknowledged secondary axis. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. | 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. |
155
155
  | 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. |
156
156
  | 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. | 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. |
157
157
  | 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). |
@@ -46,7 +46,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
46
46
  | series | array | yes | Values and optional ranges to compare across each category row. |
47
47
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
48
48
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
49
- | series[].label | string | | Displayed series name; defaults to the series id. |
49
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
50
50
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
51
51
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
52
52
  | series[].direction | string | | Declared preference for higher or lower values in directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
@@ -88,7 +88,7 @@ An annotation anchor is a category or item id string, or an object with category
88
88
 
89
89
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
90
90
  |---|---|---|---|---|---|
91
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. | 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. |
91
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. 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. |
92
92
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | |
93
93
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
94
94
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | |
@@ -485,6 +485,7 @@ The CLI prints every match in one response through `boardplot fixtures --type <t
485
485
  | centered-values | waterfall.vertical | example | Centered bridge values with a thin falling step |
486
486
  | horizontal-centered-values | waterfall.horizontal | example | Centered horizontal bridge values |
487
487
  | sign-inside-values | waterfall.vertical | example | Inside values on signed bridge fills |
488
+ | grey-steps | waterfall.vertical | example | Grey steps with their values inside |
488
489
 
489
490
  ## kpi
490
491
 
@@ -631,6 +632,7 @@ The CLI prints every match in one response through `boardplot fixtures --type <t
631
632
  | columns-hidden | bullet | example | columnVisibility leaves the share column out of the percent-of-target rows |
632
633
  | plot-first | bullet | example | columnOrder puts the marks first and reverses the columns behind them |
633
634
  | no-direction-line | bullet | example | labels.direction and labels.position drop the second lines beside the target columns |
635
+ | tolerance-range | bullet | example | from shades only the tolerance range around each target and leaves the space below it blank |
634
636
 
635
637
  ## bartable
636
638
 
@@ -101,8 +101,8 @@ Facets, variance tiers and metric stacks with shared categories and computed rea
101
101
  | panels ( branch 3) | array | yes | Two to five panels in top-down reading order. |
102
102
  | panels[].id ( branch 3) | string | yes | Unique panel id; state scopes use this id. |
103
103
  | panels[].type ( branch 3) | string | yes | Columns, stacked columns for a multi-measure sum, or a line with points. One of `'column'`, `'line'`. |
104
- | panels[].title ( branch 3) | string | yes | Measure name in the shared readout gutter. |
105
- | panels[].unit ( branch 3) | string | yes | Measure unit in the readout gutter. |
104
+ | panels[].title ( branch 3) | string | yes | Measure name in the shared readout gutter. The hover card names each value with it when the unit is a sign or code. |
105
+ | panels[].unit ( branch 3) | string | yes | Measure unit in the readout gutter. A unit in words names each value on the hover card ('Cases per month: 800'); a sign or code such as '$' or 'EUR k' stays on the number. |
106
106
  | panels[].measure ( branch 3) | object | yes | Engine-computed panel measure. |
107
107
  | panels[].measure.sum ( branch 3; panels[].measure branch 1) | array | yes | Measures added for each category. Columns stack the inputs in order. |
108
108
  | panels[].measure.numerator ( branch 3; panels[].measure branch 2) | array | yes | Measures summed for the rate numerator. |
@@ -53,7 +53,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
53
53
  | series | array | yes | Matrix rows, each supplying one cell value per category. |
54
54
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
55
55
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
56
- | series[].label | string | | Displayed series name; defaults to the series id. |
56
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
57
57
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
58
58
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
59
59
  | series[].direction | string | | Declares this row's judgment for the continuous scale and PINS the whole matrix on the good/bad valence ramp (like table heat's signed flag) — declaring 'higherIsBetter' is therefore not a paint no-op on an all-positive matrix. 'lowerIsBetter' inverts the row's poles. Breaks bins go bad to good; under a breaks key every row needs the same direction (else refused). Ignored by the plain discrete ladder and harvey glyphs (warned). One of `'higherIsBetter'`, `'lowerIsBetter'`. |
@@ -96,7 +96,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
96
96
  | series[].axis | string | | Accepted for combo-shaped data. Ignored here. A kind that differs from the chart type is refused. One of `'primary'`, `'secondary'`. |
97
97
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
98
98
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
99
- | series[].label | string | | Displayed series name; defaults to the series id. |
99
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
100
100
  | series[].shortLabel | string | | Short end-label name. End labels get 18% of the effective width: Boardplot tries the full label on one line, then on two, then shortLabel with a full-name legend key, then a legend with value-only end labels. legend 'none' removes the shortLabel and legend steps, a labelPlacements pin the legend step. Boardplot adds no abbreviation or ellipsis. |
101
101
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
102
102
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
@@ -237,7 +237,7 @@ An annotation anchor is a category or item id string, or an object with category
237
237
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. placement: auto \| label \| bracket, default auto. With both ends on two different series at the last category, bracket draws the gap bracket in the right margin: an open ring on each end point, a dashed guide from each ring to the margin, a bracket with an arrowhead toward the measured end, and the gap as a large number beside it; the end values sit just over and under their guides. auto draws the bracket where gapFill washes the same two series and the label elsewhere. label keeps the label at the anchor. On a bar chart a diff between two categories of one series rides in the shorter bar's row under auto: an arrow from the longer bar's end to the to end, with the number in a break of the shaft; label keeps the arrow off the rows with the number beside it. bracket on other anchors, or on stacked variants (stacked-area, stacked100-area), warns gap-bracket-unavailable and keeps the label. caption: string. A short line under the bracket number that says what it measures, right-aligned in muted ink. Only a gap bracket prints it; elsewhere it warns gap-caption-ignored. | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
238
238
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
239
239
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
240
- | 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. |
240
+ | 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. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. 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. |
241
241
  | 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. |
242
242
  | 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. |
243
243
  | 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. |
@@ -54,7 +54,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
54
54
  | series | array | yes | Stack components and optional reference series supplying widths. |
55
55
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
56
56
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
57
- | series[].label | string | | Displayed series name; defaults to the series id. |
57
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
58
58
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
59
59
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
60
60
  | series[].direction | string | | Declared preference for higher or lower values in directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
@@ -87,7 +87,7 @@ An annotation anchor is a category or item id string, or an object with category
87
87
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | |
88
88
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
89
89
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | |
90
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
90
+ | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. On column, bar and dot the key names the band with its bounds, "Target range: 95 to 105"; without a key the band prints its bounds itself. | 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. |
91
91
  | 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. |
92
92
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
93
93
  | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |