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
@@ -42,7 +42,7 @@ These options are shared across chart types. Each type page names its exceptions
42
42
  | subtitle.measure | string | | | Measure named by the subtitle; options.unit supplies its unit. |
43
43
  | subtitle.period | string | | | Reporting period text after the measure. |
44
44
  | subtitle.scenarios | array | | | Scenario captions in authored order, printed as their own segment joined with "vs": "… · 6 Jul to 4 Oct · AC vs PL". |
45
- | unit | string | | | Chart unit, composed into the subtitle where supported; individual series may declare their own units. A unit prints as text after the number, so unit 'USD' reads 2,456 USD. For a currency sign, set format instead, such as '$1,234'; a unit the format already prints warns unit-in-format, and a unit that names another currency than the format's sign warns unit-format-conflict. |
45
+ | unit | string | | | Chart unit, composed into the subtitle where supported; individual series may declare their own units. A unit prints as text after the number, so unit 'USD' reads 2,456 USD. For a currency sign, set format instead, such as '$1,234'; a unit the format already prints warns unit-in-format, and a unit that names another currency than the format's sign warns unit-format-conflict. A unit in words, such as 'orders', names the number on the hover card ('Orders: 76'); a sign, code or scale such as '%', 'kg' or 'k orders' stays on the number. |
46
46
  | unitShown | boolean | | | True when the host prints the unit beside the chart: no unit line, no unit beside a kpi value; line end labels, a table head and the legend check treat the unit as shown. Number formatting does not change. Default false. |
47
47
  | source | string \| array | | | Source credit rendered in the chart frame. An array of strings joins with '; ' in one source line. An empty array prints no source. `**text**` draws bold and a single `*` stays literal. |
48
48
  | footnotes | array \| false \| string | `false` (or another value of its type) | | A string is one footnote. Footnotes in authored order. `**text**` draws bold and a single `*` stays literal. The frame prints them within notes.maxLines and the rest go to the notes list. false leaves notes and the pointer off the frame; disclosures that notes.show prints, the source line and a required map credit stay. |
@@ -113,6 +113,8 @@ These options are shared across chart types. Each type page names its exceptions
113
113
  | strings.belowSeries | string | | | Negative line gap key. |
114
114
  | strings.average | string | | | Name before a computed mean; English Average, German Ø. |
115
115
  | strings.valueLineRange | string | | | Tolerance-band bounds; {v1} and {v2} are the formatted bounds. |
116
+ | strings.valueLineRangeKey | string | | | Key of a tolerance band on a column, bar or dot chart; {name} is the line's name and {range} the bounds. |
117
+ | strings.valueLineRangeKeyPlain | string | | | Key of a tolerance band whose line has no name; {range} is the bounds. |
116
118
  | strings.toDate | string | | | Text after a running category name in its key or note. |
117
119
  | strings.forecast | string | | | Key for the forecast pattern. |
118
120
  | strings.plan | string | | | Key for the plan outline. |
@@ -91,7 +91,7 @@ An annotation anchor is a category or item id string, or an object with category
91
91
  | 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. | |
92
92
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
93
93
  | 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. | |
94
- | 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. |
94
+ | 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. |
95
95
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
96
96
  | 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. |
97
97
  | 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. |
@@ -424,7 +424,9 @@ A chart that does not use `size="container"` does not grow past its natural widt
424
424
 
425
425
  ## Refusals
426
426
 
427
- A chart below its size floor renders a status placeholder instead of marks. Its text is `strings.refusalMessage` of the provider, by default "This chart needs at least {width} × {height} px.", where `{width}` and `{height}` become the minimum the refusal names; wording without these tokens prints as written. The placeholder title carries the engine message. `onRefused` receives the refusal result, and `renderRefused` returns the content to show in its place. `onGeometry` runs only for an accepted layout.
427
+ A chart below its size floor draws no marks. It shows a status card in its frame instead, with the title and source of the chart and the provider strings `refusalMessage` (default "This chart needs more room.") and `refusalHint` (default "Widen the panel or turn your device."). A `refusalMessage` with `{width}` and `{height}` prints the minimum only in full diagnostics. The card never shows part of the chart. `onRefused` receives the refusal result, with the size the chart needs in `sizing.minWidth` and `sizing.minHeight`. A host that passes `onRefused` takes the refusal over, and the card logs nothing to the console. `renderRefused` returns the content the card shows in place of the hint, at most three lines. `onGeometry` runs only for an accepted layout.
428
+
429
+ A host that gives the chart more room after a refusal decides what the reader sees. A frame grown to `sizing.minWidth` inside a slot that is narrower draws the whole chart, and the slot cuts it off unless the frame scrolls sideways and shows that it scrolls. To keep the chart whole, keep the card, or hide the chart with `canDraw(request)`, or make the slot as wide as the minimum.
428
430
 
429
431
  ## Content security policy
430
432
 
@@ -474,6 +476,8 @@ Call the theme checks and the annotation publisher by value. `boardplot`, `board
474
476
 
475
477
  The package is ES modules. Every entry names a `default` condition beside `import`, so CommonJS loads it with `require()` on Node 22.12 or later, the version `engines` asks for.
476
478
 
479
+ Every chart component fails with `Cannot read properties of null (reading 'useContext')` when the page loads two copies of React: the host's copy and one beside Boardplot. `react` and `react-dom` are peer dependencies, so Boardplot uses the host's copy. Check that `npm ls react` lists one version. A linked or local copy of Boardplot with its own `node_modules/react` brings the second one: remove that folder, or make the bundler resolve `react` and `react-dom` to the host's copy (`resolve.dedupe` in Vite, `resolve.alias` in webpack, `alias` in esbuild).
480
+
477
481
  ## Maps
478
482
 
479
483
  `ChoroplethChart` ships the layout without the map geometry. Import the pack you draw once in your entry graph; `import 'boardplot/geo';` registers every pack, which costs more bundle than one pack.
@@ -530,9 +534,9 @@ export function RegionRevenue() {
530
534
  }
531
535
  ```
532
536
 
533
- `records` lists every record the card covers, the pointed one first (a category band brings its other series). `source` is `'pointer'` or `'keyboard'`. The card keeps the theme's surface, radius, shadow, font and ink, with no padding of its own, because `defaultContent` brings its own; CSS custom properties give your content the theme values: `--bp-card-pad-x`, `--bp-card-pad-y`, `--bp-card-ink`, `--bp-card-muted` and `--bp-card-rule`. The card is measured after it renders and takes the seat the default card would take for a box of its size, inside the viewport; a taller card scrolls inside itself.
537
+ `records` lists every record the card covers, the pointed one first (a category band brings its other series). `source` is `'pointer'` or `'keyboard'`. The card keeps the theme's surface, radius, shadow, font and ink, with no padding of its own, because `defaultContent` brings its own; CSS custom properties give your content the theme values: `--bp-card-pad-x`, `--bp-card-pad-y`, `--bp-card-ink`, `--bp-card-muted` and `--bp-card-rule`. The card is measured after it renders and takes the seat the default card would take for a box of its size, inside the viewport. On a line, area, combo or sparkline chart it always keeps off the area between the points, so it never stands in the way of a pointer that moves from point to point. A taller card scrolls inside itself.
534
538
 
535
- Unlike the default card, your card takes the pointer: moving the pointer from the mark to the card keeps it open while the pointer heads for it, even across other marks, and a pointer that rests on the way for 250 ms picks the mark under it. Leaving the chart closes the card after 150 ms unless the pointer reaches it, and a card that holds the focus stays open. A click or tap inside the card is yours: it fires no `onRecordClick` and does not move the card. A tap outside the chart and the card closes it.
539
+ Your card always takes the pointer, also where the default card lets it through to the points under it: moving the pointer from the mark to the card keeps it open while the pointer heads for it, even across other marks, and a pointer that rests on the way for 250 ms picks the mark under it. Leaving the chart closes the card after 150 ms unless the pointer reaches it, and a card that holds the focus stays open. A click or tap inside the card is yours: it fires no `onRecordClick` and does not move the card. A tap outside the chart and the card closes it.
536
540
 
537
541
  Keyboard: focus on the chart's tab stop opens your card for the focused record, as for the default card. When the card holds a link, a button or another focusable element, Tab moves into it, Shift+Tab returns to the record, and Tab past its last element leaves the chart and closes the card. Escape in the card closes it and returns the focus to what opened it, the record stop or an event marker. Keys inside the card are yours. In a browser without popover support the card sits in the chart's own box, so the same Tab order holds; an `overflow: hidden` ancestor can clip it there.
538
542
 
@@ -157,7 +157,7 @@ An annotation anchor is a category or item id string, or an object with category
157
157
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
158
158
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
159
159
  | 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. | |
160
- | 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. |
160
+ | 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. |
161
161
  | 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. |
162
162
  | 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. |
163
163
  | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
@@ -49,7 +49,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
49
49
  | series | array | yes | Series whose first and last category values are joined by a slope. |
50
50
  | series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
51
51
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
52
- | series[].label | string | | Displayed series name; defaults to the series id. |
52
+ | series[].label | string | | Displayed series name; defaults to the series id. The hover card names each value with it ("North: 65.8"). |
53
53
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
54
54
  | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
55
55
  | series[].role | string | | Declares a plotted data series or a comparison reference series. One of `'data'`, `'reference'`. |
@@ -97,7 +97,7 @@ An annotation anchor is a category or item id string, or an object with category
97
97
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
98
98
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
99
99
  | 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. | |
100
- | 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. | 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. |
100
+ | 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. | 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. |
101
101
  | 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. |
102
102
  | 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. |
103
103
  | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
@@ -33,6 +33,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
33
33
  | valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
34
34
  | values | cell[] | yes | The series in order, at least two points. A null is bridged by a dotted segment with a ring on the missing point. |
35
35
  | labels | array | | One name per value, in the same order. The end labels and the hover records read them; without them a point is named by its position. |
36
+ | label | string | | Name of the metric the line shows, such as "Orders", as `label` names a KPI. The hover card names each value with it ("Orders: 18"); nothing on the chart prints it. |
36
37
 
37
38
  ## Options
38
39
 
@@ -217,7 +217,7 @@ Consulting-grade table: hierarchy with honest totals (derive/validate/source), t
217
217
  | encodings.*.tolerance.abs (encodings.* branch 6) | number | | | Column units. 2 reads 63 to 67 as warn around 65. |
218
218
  | encodings.*.columns (encodings.* branch 6) | array | | | Further columns this rule paints. A sixty-column cohort grid names its lane once instead of sixty times, and a column that carries its own entry keeps it. Leave a column out to keep it unshaded. |
219
219
  | totalPosition | string | `'top'`, `'bottom'` | | Total-row position; variant supplies the default. |
220
- | density | string | `'compact'`, `'regular'`, `'relaxed'`, `'cohort'`, `'cohort-small'` | `'regular'` | Cell spacing. Before a size refusal, the static table retries with compact spacing, tight margins and automatic height unless belowMinimum is 'refuse'. Where a fixed width or height still misses, cell air, column gaps and margins shrink to 2 px air and 4 px gaps, and row air to 1 px where the height misses; a 'table-tight-spacing' warning names the size for compact spacing. 'cohort' and 'cohort-small' are the fixed matrix grids of a cohort table: rows of 26 px (20 px) whatever the level, cells one (two) steps under the label, heads on the axis step, and value columns centred unless the column names its own alignment. |
220
+ | density | string | `'compact'`, `'regular'`, `'relaxed'`, `'cohort'`, `'cohort-small'` | `'regular'` | Cell spacing. 'compact' keeps half of each row's regular air, rounded down (theme table.compactStep sets a fixed step instead), and 'relaxed' adds 2 px above and below; type, heads and cell air keep their size. Before a size refusal, the static table retries with compact spacing, tight margins and automatic height unless belowMinimum is 'refuse'. Where a fixed width or height still misses, cell air, column gaps and margins shrink to 2 px air and 4 px gaps, and row air to 1 px where the height misses; a 'table-tight-spacing' warning names the size for compact spacing. 'cohort' and 'cohort-small' are the fixed matrix grids of a cohort table: rows of 26 px (20 px) whatever the level, cells one (two) steps under the label, heads on the axis step, and value columns centred unless the column names its own alignment. |
221
221
  | nulls | string | `'blank'`, `'dash'` | | What a MISSING cell prints. 'dash' (the default) keeps the em dash; 'blank' leaves it empty, which is what a cohort staircase needs — a cohort acquired in May has not been observed at M8, and a triangle of dashes is noise. The explicit states na, nm and suppressed keep their glyphs. |
222
222
  | figures | boolean | | | Print the cell figures; default true. false draws the heat grounds alone in 22 px cells, over any width authored for the figures, on 14 px rows or the line box of the text a row still prints where that is taller, so a sixty-column triangle fits one screen. The heads keep their labels and the numbers stay in the markup for a reader who cannot see the grounds. Refused on a table without a heat lane in encodings. |
223
223
  | expansion | object | | | Expansion order: depth, collapsed, expanded. |
@@ -157,6 +157,7 @@ Defaults are the `bridge` preset.
157
157
  | space.tierGap | number | yes | | `5` | Vertical gap in px between stacked tiers. |
158
158
  | space.facetGap | number | yes | | `28` | Gap in px between facets of a small-multiple layout. |
159
159
  | space.labelPad | number | yes | | `5` | Padding in px between a mark and its label. |
160
+ | space.tierHeadingGap | number | | | | Vertical gap in px between a stacked tier and the title or caption of the tier under it. Absent means tierGap plus three times labelPad (20 px in most presets), so the heading stands at least twice as far from the tier above as from its own panel. A short canvas gives up this extra room first and keeps tierGap. |
160
161
  | space.canvas | object | | | | Canvas margin tokens by width class: `base` covers the small and middle widths, `wide` covers 1080 px and up. Each class and side is optional. Missing values keep the preset or built-in margin. A class takes a side object, not a bare number. |
161
162
  | space.canvas.base | object | | | | Canvas margins for the small and middle width classes, in px. Each side is optional and stays within 0 to 96. |
162
163
  | space.canvas.base.top | number | | | | One canvas margin side in px (top, right, bottom, left). |
@@ -277,6 +278,7 @@ Defaults are the `bridge` preset.
277
278
  | table.section.spaceBefore | number | | | | Air in px above the label of a section row that follows other rows, inside the row, on the SVG and in the grid, so a new block reads at once. Default one body line box; 0 for none. A section that is the first row under the head takes a quarter line box, never more than this value. The label sits at the bottom of its row. |
278
279
  | table.section.rule | string | | `'heavy'`, `'hair'` | | The line under a section heading, across the full table width, on the SVG and in the grid: 'heavy' (default) twice the rule stroke in the text ink; 'hair' the row rule (table.ruleInk at table.ruleWidths.row), or the text ink under table.headRule 'ink'. |
279
280
  | table.fixedType | boolean | | | `true` | True makes a density change row height and cell padding only: compact heads, body and total keep their size, and the label of a cohort grid's closing row keeps the total face while the matrix cells keep their own step. Absent or false steps compact type 0.5 px down as before. |
281
+ | table.compactStep | number | | | | Px of air the compact density takes off each side of a body row and of the total row (0 to 8). Absent means compact keeps half of each row's regular air, rounded down: 3 px above and below a top-level or group row instead of 7, 2 px for a sub row instead of 4, and 4 px for the total instead of 8. 1 brings back the compact rows of 0.60 and earlier. |
280
282
  | table.noPrevious | string | | `'na'`, `'missing'` | `'missing'` | What a change against the previous column prints where its group has no previous column, such as the first month's month-on-month: 'na' (default) prints n/a, 'missing' prints the missing glyph under the row's missing and the table's nulls policy. |
281
283
  | table.ofWhich | string | | `'muted'`, `'ink'` | `'ink'` | 'muted' (default) draws ofWhich rows in the muted ink. 'ink' draws their labels and values in the text colour: the relation stays arithmetic only, and a muted column or an inline share line stays muted. |
282
284
  | table.groupGround | string | | `'expanded'`, `'always'`, `'none'` | `'none'` | Which group rows carry the group ground when options.groupGround is absent. 'expanded': only the header row of an open group. 'always': folded or open, as before 0.28. 'none': none. Every preset sets 'none'; absent in a custom theme, 'expanded'. The Total keeps its own ground (table.grounds.total). |
@@ -95,7 +95,7 @@ An annotation anchor is a category or item id string, or an object with category
95
95
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
96
96
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
97
97
  | 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. | |
98
- | 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. |
98
+ | 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. |
99
99
  | 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. |
100
100
  | 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. |
101
101
  | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
@@ -51,6 +51,7 @@ Every code a render, a measure or a React chart can return, read from the source
51
51
  | `band-bounds-offscale` | warn | | core/annotateTargets.ts |
52
52
  | `band-combination-unsupported` | warn | | core/annotateTargets.ts |
53
53
  | `band-fraction-row-ignored` | warn | | bullet |
54
+ | `band-from-ignored` | warn | | bullet |
54
55
  | `band-key-ramp-unavailable` | warn | | bullet |
55
56
  | `band-key-row-unavailable` | warn | | bullet |
56
57
  | `band-lightness-insufficient` | warn | | core/colorRecipes.ts |
@@ -346,7 +347,7 @@ Every code a render, a measure or a React chart can return, read from the source
346
347
  | `footnote-unreferenced` | info | | core/frameText.ts |
347
348
  | `footnotes-off` | info | | core/eventLane.ts, core/frameText.ts, core/request.ts |
348
349
  | `format-hides-values` | warn | yes | core/formatSpec.ts |
349
- | `format-ignored` | warn | | band, variance, waterfall |
350
+ | `format-ignored` | warn | | band, variance |
350
351
  | `format-reads-as-group` | warn | | core/formatSpec.ts |
351
352
  | `format-spreadsheet-code` | warn | | core/formatSpec.ts |
352
353
  | `format-unscaled` | warn | yes | core/formatSpec.ts |
@@ -459,7 +460,7 @@ Every code a render, a measure or a React chart can return, read from the source
459
460
  | `internal-error` | not stated at the site | | cli/result.ts |
460
461
  | `invalid` | not stated at the site | | react/export/frame.ts, react/export/png.ts, react/export/useExport.ts |
461
462
  | `invalid-annotation` | error | | core/doc/chartValidation.ts, core/normalize/fraction.ts |
462
- | `invalid-argument` | error | yes | cli/describe.ts, cli/fixtures.ts, cli/main.ts, cli/render.ts, cli/rows.ts, cli/size.ts, cli/telemetry.ts, core/rows.ts, mcp/server.ts, telemetry/feedback.ts |
463
+ | `invalid-argument` | error | yes | cli/describe.ts, cli/fixtures.ts, cli/main.ts, cli/render.ts, cli/rows.ts, cli/size.ts, cli/telemetry.ts, core/request.ts, core/rows.ts, mcp/server.ts, telemetry/feedback.ts |
463
464
  | `invalid-cell` | error | | core/normalize/shared.ts |
464
465
  | `invalid-contract` | error | | core/rows.ts, core/schema/namedColumns.ts |
465
466
  | `invalid-count` | error | | dimswitch, kpi, sparkline |
@@ -80,9 +80,9 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
80
80
  | items[].id | string | yes | Unique bridge-item identity used by connectors and annotations. |
81
81
  | items[].label | string | | Displayed bridge-item name; defaults to its id. |
82
82
  | items[].type | string | | Delta contribution by default; subtotal and total show accumulated levels. One of `'delta'`, `'subtotal'`, `'total'`. |
83
- | items[].value | cell | | Signed delta contribution, or an optional check value for a subtotal or total. A check value off the running sum by more than its inputs' rounding warns derived-mismatch, and the sum is drawn. A check value off by less is disclosed: the sum is drawn, the info check-value-rounded names both numbers, and a disclosure note names them where notes.show lists 'disclosure'. An opening total without a value is derived backward from the next total that has one across plain deltas, and refused otherwise. |
84
- | items[].segments | array | | Named signed contributions composing this item instead of a single value. |
85
- | items[].segments[].id | string | yes | Segment identity within its waterfall item; also names connector anchors. |
83
+ | items[].value | cell | | Signed delta contribution, or an optional check value for a subtotal or total. A check value off the running sum by more than its inputs' rounding warns derived-mismatch, and the sum is drawn. A check value off by less is disclosed: the sum is drawn, the info check-value-rounded names both numbers, and a disclosure note names them where notes.show lists 'disclosure'. An opening total with segments opens at their sum, and its value is a check value against that sum. An opening total without a value or segments is derived backward from the next total that has one across plain deltas, and refused otherwise. |
84
+ | items[].segments | array | | Named signed contributions composing this item instead of a single value. On a total or subtotal they stack as its breakdown, with their values and in the key: a later total draws them when they add up to its level, and otherwise draws its level as one bar and warns derived-mismatch. Authored segments win over the ones a closing total derives from segmented steps. |
85
+ | items[].segments[].id | string | yes | Segment identity within its waterfall item; also names connector anchors. One id is one segment across the bridge: its first authored label, colorRole and value fill paint all its bars, its key entry and its part of a derived total, and a later item that sets another one warns segment-identity-mismatch. |
86
86
  | items[].segments[].label | string | | Displayed segment name; defaults to its id. |
87
87
  | items[].segments[].value | cell | yes | Signed contribution of this segment to its item. |
88
88
  | items[].segments[].colorRole | string | | Theme color role for this segment. 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. |
@@ -90,6 +90,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
90
90
  | items[].date | string | | ISO 8601 date associated with this bridge item. |
91
91
  | items[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Scenario for this bridge item and its default segment styling. |
92
92
  | items[].direction | string | | Under 'lowerIsBetter' a rise paints bad and a fall good (options.signColor). One of `'higherIsBetter'`, `'lowerIsBetter'`. |
93
+ | items[].colorRole | string | | A step without segments: the theme colour role its bar paints in, in place of the step or sign colour, as a segment takes one; neutralLight gives a grey step. Its value keeps labelPosition. A total, a step with segments and a bridge with cases take no colorRole. 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. |
93
94
  | items[].toBaseline | boolean | | Start this delta at zero and reset the accumulated contribution list. A subtotal draws the sum of the deltas since the last total or baseline subtotal, from zero; the running level carries on. |
94
95
  | items[].values | cell[] | | With data.cases: one value per case, in case order, in place of value — the signed delta of each case, or a total's opening or check value. |
95
96
  | connectors | array | | Authored connections between item levels; omission uses the default sequence. |
@@ -128,7 +129,7 @@ An annotation anchor is a category or item id string, or an object with category
128
129
  | 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. | |
129
130
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
130
131
  | 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. | |
131
- | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
132
+ | 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. |
132
133
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
133
134
  | bracket | Draws a bracket over an inclusive span of steps and prints the sum of their values, after an optional label. | from, to | from: categoryId; to: categoryId | label: string. Name printed before the sum, "Commercial +81". Without it the bracket prints the sum alone. | from and to are step ids, inclusive. The engine adds the steps up and prints the signed sum; every step in the span must be a delta, so a span that holds a total is refused with bracket-span-total. A step the bridge cannot add (an open start) refuses it with bracket-span-no-value. Brackets stand in one row above the steps. Vertical bridges only. |
134
135
  | 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. |
@@ -180,3 +181,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
180
181
  | centered-values | example | Centered bridge values with a thin falling step |
181
182
  | horizontal-centered-values | example | Centered horizontal bridge values |
182
183
  | sign-inside-values | example | Inside values on signed bridge fills |
184
+ | grey-steps | example | Grey steps with their values inside |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "boardplot",
3
- "version": "0.59.0",
3
+ "version": "0.61.0",
4
4
  "description": "Consulting-grade waterfall, Mekko (Marimekko) and variance charts and management tables for slides, reports and dashboards. Use it through Claude Code, Codex or other MCP agents, or as responsive React components with tooltips. Open source, Apache-2.0.",
5
5
  "mcpName": "io.github.boardplot/boardplot",
6
6
  "type": "module",
@@ -1,42 +0,0 @@
1
- import {
2
- pushAll
3
- } from "./chunk-WYJEOMNY.js";
4
-
5
- // src/core/annotateFields.ts
6
- function categoryBandFromCenters(ids, plot, centerOf, axis) {
7
- return (categoryId) => {
8
- let ci = ids.indexOf(categoryId);
9
- if (ci < 0) return null;
10
- if (axis === "x") {
11
- let left = ci === 0 ? plot.x : (centerOf(ci - 1) + centerOf(ci)) / 2, right = ci === ids.length - 1 ? plot.x + plot.w : (centerOf(ci) + centerOf(ci + 1)) / 2;
12
- return { x: left, w: right - left };
13
- }
14
- let top = ci === 0 ? plot.y : (centerOf(ci - 1) + centerOf(ci)) / 2, bottom = ci === ids.length - 1 ? plot.y + plot.h : (centerOf(ci) + centerOf(ci + 1)) / 2;
15
- return { y: top, h: bottom - top };
16
- };
17
- }
18
- function categoryTargetFields(ids, plot, centerOf, axis) {
19
- return {
20
- categoryIds: ids,
21
- resolveCategoryBand: categoryBandFromCenters(ids, plot, centerOf, axis),
22
- bandPlot: plot
23
- };
24
- }
25
- function spliceAnnotationNodes(nodes, annotationNodes) {
26
- let behind = (part) => part === "band" || part === "attainment", front = annotationNodes.filter((node) => behind(node.part)), rest = nodes.splice(0);
27
- pushAll(nodes, front), pushAll(nodes, rest), pushAll(nodes, annotationNodes.filter((node) => !behind(node.part)));
28
- }
29
- function isCategoryAlongY(band) {
30
- return !("x" in band);
31
- }
32
- function valueLineHasTargetExtras(ann) {
33
- return ann.kind !== "valueLine" ? !1 : ann.tolerance !== void 0 || ann.attainment !== void 0;
34
- }
35
-
36
- export {
37
- categoryBandFromCenters,
38
- categoryTargetFields,
39
- spliceAnnotationNodes,
40
- isCategoryAlongY,
41
- valueLineHasTargetExtras
42
- };
@@ -1,272 +0,0 @@
1
- import {
2
- calendarLike,
3
- numberedSequence
4
- } from "./chunk-YM4MVABU.js";
5
- import {
6
- PRIORITY
7
- } from "./chunk-AUSZDYGE.js";
8
- import {
9
- rankKeyNote
10
- } from "./chunk-WD5NJHZG.js";
11
- import {
12
- chartStrings
13
- } from "./chunk-FYFXOLWI.js";
14
- import {
15
- strokeToken
16
- } from "./chunk-XAH4EWJT.js";
17
- import {
18
- twoLineWidth,
19
- wrapText
20
- } from "./chunk-UIHGGWES.js";
21
- import {
22
- maxOf,
23
- minOf,
24
- pushAll
25
- } from "./chunk-WYJEOMNY.js";
26
-
27
- // src/core/strings/combo.ts
28
- var EN = {
29
- // reader-facing wording linked only by its consumers.
30
- referenceSeriesCount: "{v1} reference series",
31
- stackedColumnSeriesDesc: "{v1} stacked column series ({v2})",
32
- lineAreaSeriesDesc: "{v1} line/area series ({v2})",
33
- plusClause: " plus ",
34
- comboDescStart: "Combo chart, {v1} categories: {v2}",
35
- secondaryAxisDesc: ". Line series on an acknowledged secondary axis",
36
- columnTotalsSentence: ". Column totals: {v1}.",
37
- comboTitle: "Combo chart: {v1} by {v2} categories",
38
- stackedColumnSeriesCount: "{v1} stacked column series",
39
- lineAreaSeriesCount: "{v1} line/area series",
40
- columnsRankNote: "Columns by rank ({v1}): {v2}.",
41
- // the note under a dual-scale combo that prints no tick columns.
42
- comboOwnScale: "Each series on its own scale."
43
- }, DE = {
44
- // reader-facing wording linked only by its consumers.
45
- referenceSeriesCount: "{v1} {v1|Referenzreihe|Referenzreihen}",
46
- stackedColumnSeriesDesc: "{v1} {v1|gestapelte S\xE4ulenreihe|gestapelte S\xE4ulenreihen} ({v2})",
47
- lineAreaSeriesDesc: "{v1} {v1|Linien-/Fl\xE4chenreihe|Linien-/Fl\xE4chenreihen} ({v2})",
48
- plusClause: " plus ",
49
- comboDescStart: "Kombinationsdiagramm, {v1} {v1|Kategorie|Kategorien}: {v2}",
50
- secondaryAxisDesc: ". Linienreihen auf einer best\xE4tigten zweiten Achse",
51
- columnTotalsSentence: ". S\xE4ulensummen: {v1}.",
52
- comboTitle: "Kombinationsdiagramm: {v1} nach {v2} {v2|Kategorie|Kategorien}",
53
- stackedColumnSeriesCount: "{v1} {v1|gestapelte S\xE4ulenreihe|gestapelte S\xE4ulenreihen}",
54
- lineAreaSeriesCount: "{v1} {v1|Linien-/Fl\xE4chenreihe|Linien-/Fl\xE4chenreihen}",
55
- columnsRankNote: "S\xE4ulen nach Rang ({v1}): {v2}.",
56
- // the note under a dual-scale combo that prints no tick columns.
57
- comboOwnScale: "Jede Reihe hat ihre eigene Skala."
58
- }, { chartString } = chartStrings(EN, DE);
59
-
60
- // src/core/charts/combo/categoryRanks.ts
61
- var FORCE_CATEGORY_RANKS = /* @__PURE__ */ Symbol("forceCategoryRanks");
62
- function categoryNotesDiffer(a, b) {
63
- return a.length !== b.length || a.some((note, i) => note !== b[i]);
64
- }
65
- function rankMapping(labels) {
66
- return labels.map((label, i) => `${i + 1}. ${label}`);
67
- }
68
- var RANK_NOTE_CHUNK = 6;
69
- function rankNotes(labels, options = {}) {
70
- let entries = rankMapping(labels).map((entry) => entry.replace(/ /g, "\xA0")), notes = [];
71
- for (let i = 0; i < entries.length; i += RANK_NOTE_CHUNK) {
72
- let chunk = entries.slice(i, i + RANK_NOTE_CHUNK);
73
- notes.push(rankKeyNote(i === 0 ? chartString(options, "columnsRankNote", { v1: entries.length === 1 ? "1" : `1-${entries.length}`, v2: chunk.join("; ") }) : `${chunk.join("; ")}.`));
74
- }
75
- return notes;
76
- }
77
- function categoryRanksLint(labels, step) {
78
- let mapping = rankMapping(labels);
79
- return {
80
- code: "labels-as-ranks",
81
- severity: "info",
82
- message: `category labels are drawn as ranks 1-${labels.length}: at ${Math.round(step)}px per category the names fit neither horizontally nor rotated. The mapping is ${mapping.join("; ")}.`,
83
- suggest: "widen the canvas, shorten the names, or use a bar chart to keep the names upright",
84
- detail: { mapping }
85
- };
86
- }
87
- function namesAreLost(plan, labels) {
88
- if (plan.step === "ellipsis") return !0;
89
- let byFit = plan.warnings.some((w) => w.code === "category-stride" && w.severity === "warn");
90
- return plan.step === "stride" && !plan.dateNumeric && byFit && !calendarLike(labels) && !numberedSequence(labels) ? labels.some((label, i) => !plan.keep[i] && label.trim() !== "") : plan.step !== "rotate" ? !1 : plan.infos.filter((info) => info.truncated).length >= 2;
91
- }
92
- function withCategoryRanks(plan, measure, labels, force = !1, keyed = !0) {
93
- if (!keyed || !force && !namesAreLost(plan, labels)) return plan;
94
- let font = plan.font, lineHeight = font.size * (font.lineHeight ?? 1.2), infos = plan.infos.map((_, i) => {
95
- let text = String(i + 1);
96
- return { lines: [text], w: Math.max(measure(text, font).width, 1), h: lineHeight, truncated: !1 };
97
- });
98
- return !force && plan.step === "stride" && infos.some((info, i) => i > 0 && plan.anchor(i - 1, infos[i - 1].w) + infos[i - 1].w + 4 > plan.anchor(i, info.w)) ? plan : {
99
- ...plan,
100
- infos,
101
- // Every column gets its rank, also where the names row drew only some.
102
- keep: plan.keep.map(() => !0),
103
- rotation: 0,
104
- maxLines: 1,
105
- rowHeight: lineHeight,
106
- step: "ranks",
107
- // The cascade's own lint and cut notes describe a row the ranks replace.
108
- warnings: [],
109
- cutNotes: [],
110
- x: (index) => plan.anchor(index, infos[index].w)
111
- };
112
- }
113
-
114
- // src/core/label/staircase.ts
115
- var STAIRCASE = /* @__PURE__ */ Symbol("staircase"), MARK = 3.5, TEXT_X = MARK + 5, STEP_GAP = 4, LEADER_GAP = 3, MAX_LINES = 2, STAIRCASE_MAX_PAD = 0.4, HEIGHT_FAILED = "the names need more height over the columns than the chart can give";
116
- function staircaseState(options) {
117
- return options[STAIRCASE] ?? { pad: 0 };
118
- }
119
- function staircaseOn(placement, options) {
120
- return placement === "staircase" && staircaseState(options).off === void 0;
121
- }
122
- function staircaseDirection(tops) {
123
- return tops.length > 1 && tops[tops.length - 1] > tops[0] ? "left" : "right";
124
- }
125
- function staircaseRoom(input) {
126
- let need = input.names.map((name) => Math.floor(twoLineWidth(name, input.font, input.measure)) + 1 + TEXT_X), room = 0;
127
- for (let round = 0; round < 3; round++) {
128
- let centers = input.centers(room), over = Math.max(0, maxOf(centers.map((cx, i) => input.direction === "right" ? cx + need[i] - input.edge : input.edge - (cx - need[i]))));
129
- if (over < 0.5) break;
130
- room = Math.min(input.width * 0.4, room + Math.ceil(over));
131
- }
132
- return room;
133
- }
134
- function bandObstacles(claims, centers, half, floor, above) {
135
- return centers.map((cx) => {
136
- let span = { x: cx - half, y: -1e5, w: 2 * half, h: floor + 1e5 }, tops = claims.hitsWhich(span, 0, (claim) => claim.kind === "frame" || claim.kind === "legend" || claim.kind === "reserved").map((claim) => claim.rect.y);
137
- return { x0: cx - half, x1: cx + half, top: Math.min(floor, minOf(tops)) - above };
138
- });
139
- }
140
- function planStaircase(input) {
141
- let { left, right, font, measure } = input, n = input.names.length, flip = input.direction === "left", m = (x) => flip ? left + right - x : x, order = Array.from({ length: n }, (_, k) => flip ? n - 1 - k : k), lineH = font.size * (font.lineHeight ?? 1.2), names = [], next = 1 / 0, highest = 1 / 0;
142
- for (let k = n - 1; k >= 0; k--) {
143
- let i = order[k], cx = m(input.centers[i]), textX = cx + TEXT_X, wrapped = wrapText(input.names[i], font, right - textX, MAX_LINES, measure);
144
- if (wrapped.truncated || right - textX < 1)
145
- return { failed: `the name '${input.names[i]}' needs more than ${MAX_LINES} lines in the room beside its column` };
146
- let w = Math.max(...wrapped.lines.map((line) => measure(line, font).width)), h = wrapped.lines.length * lineH, x0 = cx - MARK - 1, x1 = textX + w, bottom = next - STEP_GAP;
147
- for (let o of input.obstacles) {
148
- let ox0 = Math.min(m(o.x0), m(o.x1));
149
- Math.max(m(o.x0), m(o.x1)) > x0 && ox0 < x1 && (bottom = Math.min(bottom, o.top - LEADER_GAP - 1));
150
- }
151
- let y = bottom - h;
152
- next = y, highest = Math.min(highest, y), names.push({
153
- categoryId: input.ids[i],
154
- text: input.names[i],
155
- lines: wrapped.lines,
156
- rect: { x: flip ? m(textX + w) : textX, y, w, h },
157
- mark: { x: input.centers[i], y: y + lineH / 2 },
158
- leaderEnd: input.obstacles[i].top - LEADER_GAP
159
- });
160
- }
161
- return names.reverse(), flip && names.reverse(), { names, deficit: Math.max(0, input.top - highest) };
162
- }
163
- var leaderOwner = (categoryId) => ({ annotationId: `staircase:${categoryId}` });
164
- function claimStaircase(names, occupied) {
165
- for (let name of names)
166
- occupied.claim(
167
- { x: name.mark.x - MARK, y: name.mark.y - MARK, w: 2 * MARK, h: Math.max(2 * MARK, name.leaderEnd - name.mark.y + MARK) },
168
- "annotation",
169
- leaderOwner(name.categoryId),
170
- "staircaseLeader"
171
- );
172
- }
173
- function staircaseRequests(names, font) {
174
- return names.map((name) => ({
175
- id: `category:${name.categoryId}`,
176
- kind: "category",
177
- owner: { categoryId: name.categoryId },
178
- text: name.text,
179
- lines: name.lines,
180
- typeRole: "axis",
181
- font,
182
- markAnchored: !1,
183
- // A mirrored name stands left of its diamond: its lines hug the leader side.
184
- ...name.rect.x < name.mark.x ? { align: "end" } : {},
185
- priority: PRIORITY.endpoint,
186
- candidates: [{ slot: "staircase", rect: name.rect, penalty: 0, outsidePlot: !0 }]
187
- }));
188
- }
189
- function staircaseNodes(theme, names) {
190
- return names.flatMap((name) => {
191
- let { x, y } = name.mark, owner = leaderOwner(name.categoryId);
192
- return [
193
- { t: "line", id: `staircase:${name.categoryId}:leader`, x1: x, y1: y, x2: x, y2: name.leaderEnd, stroke: { token: "leader" }, width: strokeToken(theme, "rule"), owner, part: "leader" },
194
- { t: "path", id: `staircase:${name.categoryId}:mark`, d: `M${x} ${y - MARK}L${x + MARK} ${y}L${x} ${y + MARK}L${x - MARK} ${y}Z`, fill: { token: "ink" }, owner, part: "staircaseMark" }
195
- ];
196
- });
197
- }
198
- function staircaseFallbackWarning(reason) {
199
- return {
200
- code: "staircase-labels-fallback",
201
- severity: "warn",
202
- message: `categoryLabels 'staircase' could not seat every name (${reason}); the category names print under the axis instead`,
203
- suggest: "sort the columns by height (sort: { categories: 'desc' }), give the chart more height or width, shorten the names, drop a line that crosses the free space (pareto: cumulative: false), or drop categoryLabels"
204
- };
205
- }
206
- function seatStaircase(input) {
207
- let { categories, band, font } = input, centers = categories.map((_, i) => band.center(i)), plan = planStaircase({
208
- ids: categories.map((c) => c.id),
209
- names: categories.map((c) => c.label ?? c.id),
210
- centers,
211
- obstacles: bandObstacles(input.occupied, centers, band.step / 2, input.floor, input.above),
212
- left: input.left,
213
- right: input.right,
214
- top: input.top,
215
- font,
216
- measure: input.measure,
217
- direction: staircaseDirection(input.tops)
218
- });
219
- return "failed" in plan ? plan : staircaseState(input.options).pad + plan.deficit > input.cap ? { failed: HEIGHT_FAILED } : (plan.deficit <= 0.5 && (claimStaircase(plan.names, input.occupied), pushAll(input.requests, staircaseRequests(plan.names, font))), plan);
220
- }
221
- function runStaircase(theme, placement, options, plan, placed, occupied, nodes, warnings) {
222
- if (placement !== "staircase") return;
223
- let off = staircaseState(options).off;
224
- if (off !== void 0) {
225
- warnings.push(staircaseFallbackWarning(off));
226
- return;
227
- }
228
- if (!plan) return;
229
- if ("failed" in plan) return { deficit: 0, failed: plan.failed };
230
- if (plan.deficit > 0.5) return { deficit: plan.deficit };
231
- let lost = plan.names.find((name) => placed.find((label) => label.id === `category:${name.categoryId}`)?.hidden !== void 0);
232
- if (lost) return { deficit: 0, failed: `the name '${lost.text}' meets another label or mark` };
233
- for (let name of plan.names) {
234
- let under = occupied.hitsWhich(
235
- { x: name.mark.x - 0.5, y: name.leaderEnd, w: 1, h: 1e5 },
236
- 0,
237
- (claim) => claim.owner.annotationId?.startsWith("staircase:") === !0 || claim.kind === "frame" || claim.kind === "legend" || claim.kind === "reserved"
238
- );
239
- under.length > 0 && (name.leaderEnd = Math.max(name.leaderEnd, minOf(under.map((claim) => claim.rect.y)) - LEADER_GAP));
240
- }
241
- return pushAll(nodes, staircaseNodes(theme, plan.names)), { deficit: 0 };
242
- }
243
- function nextStaircase(options, outcome) {
244
- if (!outcome || outcome.failed === void 0 && outcome.deficit <= 0.5) return;
245
- let state = staircaseState(options), rounds = state.rounds ?? 0;
246
- return outcome.failed === void 0 && rounds < 4 ? { pad: state.pad + Math.ceil(outcome.deficit) + 1, rounds: rounds + 1 } : { pad: 0, off: outcome.failed ?? HEIGHT_FAILED };
247
- }
248
- function settleStaircase(options, rerun, first) {
249
- let outcome = first;
250
- for (let next = nextStaircase(options, outcome); next; next = nextStaircase(options, outcome))
251
- options = { ...options, [STAIRCASE]: next }, outcome = rerun(options);
252
- return options;
253
- }
254
-
255
- export {
256
- chartString,
257
- FORCE_CATEGORY_RANKS,
258
- categoryNotesDiffer,
259
- rankNotes,
260
- categoryRanksLint,
261
- withCategoryRanks,
262
- STAIRCASE,
263
- STAIRCASE_MAX_PAD,
264
- staircaseState,
265
- staircaseOn,
266
- staircaseDirection,
267
- staircaseRoom,
268
- seatStaircase,
269
- runStaircase,
270
- nextStaircase,
271
- settleStaircase
272
- };