boardplot 0.53.0 → 0.55.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 (626) hide show
  1. package/CHANGELOG.md +475 -0
  2. package/README.md +15 -14
  3. package/dist/{ReaderBox-VOJSJ66R.js → ReaderBox-3FFPHWSI.js} +15 -10
  4. package/dist/{annotateEngine-DLMFJZ67.js → annotateEngine-ET4DM2OK.js} +5 -1
  5. package/dist/build-identity.json +3 -3
  6. package/dist/{chunk-SS42FJVN.js → chunk-2ALFFOKB.js} +460 -148
  7. package/dist/chunk-2BP6X5GX.js +125 -0
  8. package/dist/chunk-2C4SYWZ3.js +25 -0
  9. package/dist/{chunk-7X2ZYVAX.js → chunk-2TAK2ELB.js} +3 -3
  10. package/dist/{chunk-XZOHR765.js → chunk-2YNF6AHH.js} +5 -5
  11. package/dist/{chunk-DDI2W4TR.js → chunk-32IKJMUF.js} +3 -3
  12. package/dist/{chunk-ADKCLH3Z.js → chunk-33FCWTGT.js} +1 -1
  13. package/dist/{chunk-AQROQDLR.js → chunk-37A6CLR5.js} +1729 -196
  14. package/dist/{chunk-DCTCUZ5L.js → chunk-3AJY353W.js} +3 -3
  15. package/dist/chunk-3B3CFJ2H.js +48 -0
  16. package/dist/{chunk-M4EUXOLU.js → chunk-3B3K7TD5.js} +83 -9
  17. package/dist/{chunk-QSXK6PJL.js → chunk-3C24WWUQ.js} +1 -1
  18. package/dist/{chunk-BWTX7LUG.js → chunk-3L2VXXM4.js} +9 -4
  19. package/dist/{chunk-DO5OZJAO.js → chunk-3OZRODC4.js} +39 -21
  20. package/dist/{chunk-A6CQPJWR.js → chunk-3XOWXLLQ.js} +6 -7
  21. package/dist/{chunk-TBGUEF3M.js → chunk-3ZAH24P6.js} +164 -51
  22. package/dist/{chunk-TGK6KUGN.js → chunk-4CJ6UCX4.js} +33 -16
  23. package/dist/{chunk-VDAZPGR2.js → chunk-4DZFR52I.js} +2 -2
  24. package/dist/{chunk-323YZWYJ.js → chunk-4WT3T5SH.js} +124 -54
  25. package/dist/{chunk-O3S2KNIW.js → chunk-4X3HNETE.js} +3 -3
  26. package/dist/{chunk-FBB4BWKN.js → chunk-4Y7BA2NW.js} +4 -4
  27. package/dist/{chunk-AWTG3RFF.js → chunk-4YHZSPAJ.js} +6 -7
  28. package/dist/{chunk-CNX7EGSU.js → chunk-5DMHMQFP.js} +7 -7
  29. package/dist/{chunk-BPKXEMRE.js → chunk-5SHI57XD.js} +45 -14
  30. package/dist/{chunk-H63XQ3OO.js → chunk-5SLJGRUO.js} +139 -47
  31. package/dist/{chunk-5LYXD6ME.js → chunk-5UVJKB7L.js} +137 -70
  32. package/dist/{chunk-ZNHFLJSY.js → chunk-63L35UCI.js} +6 -6
  33. package/dist/{chunk-YCNLQYTC.js → chunk-6C64IBOG.js} +5 -5
  34. package/dist/{chunk-N3TPMXS3.js → chunk-6D4EO3S7.js} +5 -5
  35. package/dist/chunk-6H3OSHEY.js +25 -0
  36. package/dist/chunk-6WZZADRL.js +25 -0
  37. package/dist/{chunk-6RBTTCQD.js → chunk-75TWO5B2.js} +89 -57
  38. package/dist/chunk-7ADUVRG5.js +14 -0
  39. package/dist/{chunk-3QWZAEW5.js → chunk-7DAH2E4T.js} +4 -3
  40. package/dist/{chunk-VKQNDOAI.js → chunk-7FKY6YWU.js} +11 -7
  41. package/dist/{chunk-NSSNYY6Y.js → chunk-7GVYMGLK.js} +6 -3
  42. package/dist/{chunk-KZS46KDY.js → chunk-7Q2WV6D2.js} +3 -3
  43. package/dist/{chunk-JFBEAUJ6.js → chunk-7Q37C6GZ.js} +1 -1
  44. package/dist/{chunk-SPTPFY4S.js → chunk-7UPZPFHQ.js} +41 -34
  45. package/dist/{chunk-V6O6KVOA.js → chunk-7Z73MM35.js} +14 -6
  46. package/dist/{chunk-MJZHFH5R.js → chunk-AB35GVPG.js} +80 -31
  47. package/dist/{chunk-MYMT5KJL.js → chunk-AF7EB6N6.js} +151 -84
  48. package/dist/chunk-AIU4GZV5.js +24 -0
  49. package/dist/{chunk-KSJVENRU.js → chunk-AM2CG7VX.js} +13 -3
  50. package/dist/{chunk-XN4ARQ2W.js → chunk-APQPYM2Z.js} +3 -3
  51. package/dist/{chunk-AHQ4L3BE.js → chunk-AZM4YNRE.js} +2 -2
  52. package/dist/{chunk-XXOHXA3A.js → chunk-B3AXM3MT.js} +2 -2
  53. package/dist/{chunk-BWGRWGVA.js → chunk-BDGLMWPO.js} +14 -14
  54. package/dist/{chunk-EHBB2Z4D.js → chunk-BFFPYT3Y.js} +13 -7
  55. package/dist/{chunk-2QT5ZUHO.js → chunk-BGJRCG7N.js} +135 -114
  56. package/dist/{chunk-RNOJSEES.js → chunk-BK6P6KMW.js} +1 -1
  57. package/dist/{chunk-XB4KZ6WO.js → chunk-BSATR6ZO.js} +40 -13
  58. package/dist/{chunk-4UVW5WU6.js → chunk-BVYIKLQ5.js} +1 -1
  59. package/dist/chunk-BWVNCLUS.js +19 -0
  60. package/dist/{chunk-LCWJS34U.js → chunk-CKNOLGRR.js} +1 -1
  61. package/dist/chunk-CLGUFVHM.js +24 -0
  62. package/dist/{chunk-NY5NUFDZ.js → chunk-COQEHO7B.js} +3 -3
  63. package/dist/{chunk-3EZRM4YM.js → chunk-CPGASWNN.js} +25 -1
  64. package/dist/{chunk-GTG3IGLF.js → chunk-CVIW2MV4.js} +284 -150
  65. package/dist/chunk-CYKIX3IQ.js +24 -0
  66. package/dist/{chunk-DIHUGBZO.js → chunk-CZ3WCG55.js} +5 -4
  67. package/dist/{chunk-DRTA6JG5.js → chunk-D2B3KP35.js} +26 -15
  68. package/dist/{chunk-6OCR6ITN.js → chunk-D2QMNHCC.js} +4 -5
  69. package/dist/{chunk-EUADDXAV.js → chunk-D7G27EYZ.js} +4 -4
  70. package/dist/{chunk-NOSDEJ3K.js → chunk-DB2JKPOX.js} +806 -69
  71. package/dist/{chunk-2CVH5E57.js → chunk-DEYAI662.js} +60 -13
  72. package/dist/{chunk-HA4IPWMM.js → chunk-DRHQG44U.js} +23 -5
  73. package/dist/{chunk-WZGJSQKN.js → chunk-DZ3S4RPI.js} +15 -1
  74. package/dist/{chunk-B6GFKYBZ.js → chunk-E44W4EEG.js} +8 -5
  75. package/dist/{chunk-YCRGWQBS.js → chunk-E5OEWMNX.js} +66 -12
  76. package/dist/chunk-E6HDUEGK.js +26 -0
  77. package/dist/{chunk-A7IEVBYI.js → chunk-E76U5H52.js} +1 -5
  78. package/dist/{chunk-NKIYLFXZ.js → chunk-EAR43REB.js} +213 -73
  79. package/dist/{chunk-NQDVMUHX.js → chunk-EBC5TMI2.js} +29 -8
  80. package/dist/chunk-EBVJCVXL.js +25 -0
  81. package/dist/chunk-EC2PGJ64.js +24 -0
  82. package/dist/chunk-EGPXEY2K.js +24 -0
  83. package/dist/{chunk-CUVUDK4O.js → chunk-EQRFSVDD.js} +2 -1
  84. package/dist/{chunk-CYOJZ3GQ.js → chunk-EW47LNWH.js} +228 -58
  85. package/dist/{chunk-7EVIIADO.js → chunk-EXDMYV5W.js} +3 -1
  86. package/dist/{chunk-VJ3FCGQF.js → chunk-EZZ533MH.js} +1 -1
  87. package/dist/{chunk-IBXXZVG7.js → chunk-F5V7YFKS.js} +11 -8
  88. package/dist/{chunk-COYOTQC2.js → chunk-F6CVYNDY.js} +5 -4
  89. package/dist/{chunk-66RFKRGO.js → chunk-F6OLHND5.js} +2 -2
  90. package/dist/chunk-FI5EXISD.js +27 -0
  91. package/dist/{chunk-CAQ5P4VN.js → chunk-FQF7GSJK.js} +46 -27
  92. package/dist/{chunk-XJP5DKIL.js → chunk-FS6ZE5TG.js} +2 -2
  93. package/dist/{chunk-7CTKTIPF.js → chunk-G63WXSQP.js} +75 -34
  94. package/dist/{chunk-3A2IEBCN.js → chunk-GCSCHK5Y.js} +4 -18
  95. package/dist/{chunk-REOPXBUR.js → chunk-GD5TYS5R.js} +32 -21
  96. package/dist/{chunk-RGZGLKFB.js → chunk-GDVR3XHT.js} +418 -62
  97. package/dist/{chunk-XQCQZBGX.js → chunk-GDZI5ZJ7.js} +1 -1
  98. package/dist/{chunk-P5RNWMZC.js → chunk-GFIT3FRE.js} +277 -291
  99. package/dist/chunk-GM2HIU6C.js +24 -0
  100. package/dist/{chunk-DOFYKPTC.js → chunk-GMJFCBR6.js} +1 -1
  101. package/dist/{chunk-CRNMNZJD.js → chunk-H3AEYPRP.js} +66 -43
  102. package/dist/{chunk-BUPLB3EX.js → chunk-H3IBJQ5A.js} +6 -2
  103. package/dist/chunk-H4VDQ7OE.js +24 -0
  104. package/dist/{chunk-J6I2YFJH.js → chunk-H5L2P2GO.js} +6 -4
  105. package/dist/{chunk-X4YNDLVA.js → chunk-HFRQLMKK.js} +12 -7
  106. package/dist/{chunk-YG5GUELW.js → chunk-HGT3UKDW.js} +91 -48
  107. package/dist/{chunk-CWDHCSL2.js → chunk-HJRNBKIT.js} +801 -76
  108. package/dist/{chunk-FV3VF36K.js → chunk-HLOXWM2O.js} +119 -63
  109. package/dist/{chunk-3SQCCESO.js → chunk-HR2BKLS3.js} +113 -128
  110. package/dist/{chunk-S4QSJAGY.js → chunk-HZUAEMN5.js} +1 -1
  111. package/dist/{chunk-QWXWVPNE.js → chunk-IF2ZABAM.js} +2 -2
  112. package/dist/chunk-IF76JRXT.js +24 -0
  113. package/dist/chunk-IGNBQT23.js +248 -0
  114. package/dist/{chunk-DCCJRLAJ.js → chunk-IGVAWAOK.js} +31 -96
  115. package/dist/{chunk-DDCB7ZA5.js → chunk-ILFQ75N4.js} +253 -141
  116. package/dist/chunk-INHDHZNP.js +8 -0
  117. package/dist/chunk-IOKWBUQP.js +25 -0
  118. package/dist/{chunk-33PB4V6K.js → chunk-IQDMZ33D.js} +20 -9
  119. package/dist/{chunk-IDDA5INB.js → chunk-IVRYF7QA.js} +7 -4
  120. package/dist/{chunk-L7RHB734.js → chunk-J5PL6JLL.js} +1 -1
  121. package/dist/chunk-JBMWRXDS.js +24 -0
  122. package/dist/{chunk-RPIW5T55.js → chunk-JKOEHRGV.js} +1 -1
  123. package/dist/chunk-JMGB444D.js +26 -0
  124. package/dist/chunk-JU7S52HI.js +26 -0
  125. package/dist/{chunk-BBL3R5YZ.js → chunk-JXBZIJCG.js} +1 -1
  126. package/dist/{chunk-WLZ54FWG.js → chunk-JYAZPMSA.js} +70 -1
  127. package/dist/chunk-K5S3K6QK.js +24 -0
  128. package/dist/{chunk-5LGSRWFC.js → chunk-KAYBRD4F.js} +3 -3
  129. package/dist/{chunk-N3G2FYDL.js → chunk-KC52E5G4.js} +31 -20
  130. package/dist/{chunk-LNKY5Z2X.js → chunk-KDSYZLF6.js} +2 -3
  131. package/dist/{chunk-B67K6OWJ.js → chunk-KEDNHCGB.js} +4 -4
  132. package/dist/chunk-KFGZMHIB.js +28 -0
  133. package/dist/{chunk-KPKXJYQH.js → chunk-KHRAJDBM.js} +1 -1
  134. package/dist/{chunk-2V6CLH33.js → chunk-KND4OM4B.js} +117 -102
  135. package/dist/{chunk-X6SUFTD7.js → chunk-KZH2QI6S.js} +2 -2
  136. package/dist/{chunk-IYEFEBRN.js → chunk-KZJ5VM6E.js} +14 -3
  137. package/dist/{chunk-JSEYUJUQ.js → chunk-LA5OYJ5P.js} +146 -69
  138. package/dist/{chunk-MVV6RQMG.js → chunk-LAVVML3X.js} +33 -9
  139. package/dist/{chunk-4G2O2ZPJ.js → chunk-LD4LML5P.js} +10 -8
  140. package/dist/{chunk-OURX73UJ.js → chunk-LF6RTFNK.js} +13 -11
  141. package/dist/{chunk-SVZDXFPX.js → chunk-LFUJTEJO.js} +100 -36
  142. package/dist/{chunk-53OYF4ZT.js → chunk-LHKDZAWN.js} +16 -8
  143. package/dist/{chunk-GCBOHVDZ.js → chunk-LLDKKEUD.js} +1 -1
  144. package/dist/{chunk-VTEV3WVF.js → chunk-LRCO4G7C.js} +314 -92
  145. package/dist/{chunk-5HECRVXJ.js → chunk-LSF76AS3.js} +7 -3
  146. package/dist/chunk-M427S3G7.js +25 -0
  147. package/dist/{chunk-ZMF7WEGG.js → chunk-MEMPP7VZ.js} +3 -3
  148. package/dist/{chunk-D7SHZDA3.js → chunk-MJMOKPTF.js} +186 -167
  149. package/dist/chunk-MLGEBFEX.js +47 -0
  150. package/dist/chunk-MLW72KWN.js +24 -0
  151. package/dist/chunk-MQYIBGZE.js +19 -0
  152. package/dist/{chunk-SDSONLMZ.js → chunk-MTRV3BJL.js} +301 -130
  153. package/dist/{chunk-H4H4O62O.js → chunk-N5HN5QGH.js} +1 -1
  154. package/dist/chunk-N5TZL74Y.js +53 -0
  155. package/dist/chunk-N7N5NIAU.js +211 -0
  156. package/dist/{chunk-XN7MQO45.js → chunk-NA6WLZ66.js} +66 -26
  157. package/dist/{chunk-B54RN2FD.js → chunk-NB7M4KX4.js} +99 -56
  158. package/dist/{chunk-ADWSGPH5.js → chunk-NCZWLV7T.js} +4 -4
  159. package/dist/{chunk-C54QLNE4.js → chunk-NGA7ICG4.js} +1 -1
  160. package/dist/{chunk-TJSND556.js → chunk-NHYKSPL4.js} +155 -100
  161. package/dist/chunk-NMTWUYUF.js +30 -0
  162. package/dist/{chunk-Q3CV2JJ2.js → chunk-NOCIN2EM.js} +425 -251
  163. package/dist/{chunk-SKRSCTT5.js → chunk-NUCYUKVH.js} +3 -3
  164. package/dist/{chunk-S32YYDIB.js → chunk-NVGAEQ6M.js} +4 -3
  165. package/dist/{chunk-N23YFPPI.js → chunk-O2KKQNGW.js} +4 -1
  166. package/dist/chunk-O36WX56O.js +13 -0
  167. package/dist/{chunk-FF23FYQD.js → chunk-O4WJWHCH.js} +187 -85
  168. package/dist/{chunk-H67RTX46.js → chunk-O6NJDRXE.js} +2 -2
  169. package/dist/{chunk-2DOR5SS6.js → chunk-O7DVW3IE.js} +141 -68
  170. package/dist/{chunk-2VWJ5BGO.js → chunk-O7W35PT3.js} +13 -12
  171. package/dist/{chunk-MF6IVSBJ.js → chunk-ODZJ4LW7.js} +6 -3
  172. package/dist/{chunk-FG6EDGMI.js → chunk-OHGEDG46.js} +1 -1
  173. package/dist/{chunk-HZI56ASJ.js → chunk-OJ2BPQGQ.js} +11 -5
  174. package/dist/chunk-ONKSGT2M.js +28 -0
  175. package/dist/{chunk-2WNYRWHG.js → chunk-OOFSQ5AS.js} +1 -1
  176. package/dist/{chunk-IYMI7YI4.js → chunk-OY2UJ4XK.js} +64 -42
  177. package/dist/{chunk-6Y7EXYLR.js → chunk-P6TA7M3G.js} +102 -32
  178. package/dist/{chunk-MQFCG4KS.js → chunk-PQYJZMCR.js} +99 -92
  179. package/dist/{chunk-BWLOXQDV.js → chunk-PYV6ZIR6.js} +41 -14
  180. package/dist/chunk-PZ46S2SY.js +69 -0
  181. package/dist/{chunk-IL5T7I2A.js → chunk-Q3E74U2W.js} +4 -4
  182. package/dist/{chunk-TXS3U77A.js → chunk-QBJDHFJJ.js} +4 -2
  183. package/dist/chunk-QBRRJ5OR.js +24 -0
  184. package/dist/{chunk-P6KZIZDV.js → chunk-QEP3X3OV.js} +141 -79
  185. package/dist/{chunk-CCCEBIUZ.js → chunk-QKWBDH2L.js} +2 -2
  186. package/dist/{chunk-QY5ZKUWY.js → chunk-QOWE55RR.js} +9 -3
  187. package/dist/{chunk-SREWFAAJ.js → chunk-QRVIS2QB.js} +6 -5
  188. package/dist/chunk-R27IDIJI.js +24 -0
  189. package/dist/{chunk-G5FMTRG5.js → chunk-RNIYG6PI.js} +2 -2
  190. package/dist/{chunk-PEUSKIFV.js → chunk-RO2PSSAI.js} +13 -23
  191. package/dist/{chunk-ZQF34VPS.js → chunk-ROLR7HRB.js} +12 -6
  192. package/dist/{chunk-YF2PYLC4.js → chunk-RSCRIWAH.js} +1 -1
  193. package/dist/{chunk-L6DJ4ZY5.js → chunk-RTXRIZYU.js} +370 -134
  194. package/dist/{chunk-VK5ZDV67.js → chunk-RUWNG2JC.js} +6 -5
  195. package/dist/chunk-RYPJB3RO.js +132 -0
  196. package/dist/{chunk-DAVHGK27.js → chunk-S7NRL66K.js} +46 -23
  197. package/dist/{chunk-VABRPZVC.js → chunk-SA46CNMS.js} +5 -1
  198. package/dist/{chunk-3H2W76TB.js → chunk-SBR2RLEQ.js} +72 -38
  199. package/dist/chunk-SC42DPNV.js +24 -0
  200. package/dist/{chunk-27QADBDV.js → chunk-SFG7NG23.js} +20 -3
  201. package/dist/{chunk-AG2CJ4JY.js → chunk-SNQ7D5R7.js} +18 -1
  202. package/dist/{chunk-QTZVVZ2A.js → chunk-SPSGUFTI.js} +11 -3
  203. package/dist/chunk-SRUV7AT6.js +51 -0
  204. package/dist/{chunk-F6CNPC4L.js → chunk-SZXKV3BX.js} +1 -1
  205. package/dist/{chunk-UB6ODJHO.js → chunk-T5Y4HXYO.js} +7 -4
  206. package/dist/{chunk-EJPVVGD7.js → chunk-U7W7GYXP.js} +37 -37
  207. package/dist/{chunk-LFX7W4B7.js → chunk-UDKYY27B.js} +1 -1
  208. package/dist/{chunk-24BHMKDD.js → chunk-UF3HSFAE.js} +25 -2
  209. package/dist/chunk-UIYXMPDW.js +24 -0
  210. package/dist/{chunk-N7J7CZS6.js → chunk-UNMIUILK.js} +1 -1
  211. package/dist/chunk-V3MSLNSD.js +24 -0
  212. package/dist/chunk-V634AXDM.js +31 -0
  213. package/dist/{chunk-57ZGVAU3.js → chunk-V7F4F6JA.js} +39 -6
  214. package/dist/{chunk-4X66BTP5.js → chunk-VBVG6NEL.js} +6 -6
  215. package/dist/chunk-VL7WLE4H.js +24 -0
  216. package/dist/chunk-W45AR6EW.js +94 -0
  217. package/dist/{chunk-RL3NUWMY.js → chunk-WALYNKBN.js} +444 -101
  218. package/dist/{chunk-DYS7EIXY.js → chunk-WAPCCJUB.js} +70 -26
  219. package/dist/{chunk-FBAYZSFC.js → chunk-WDIVAU5U.js} +241 -118
  220. package/dist/{chunk-EHVESNLV.js → chunk-WEMUCDPK.js} +1 -1
  221. package/dist/{chunk-N73IBH55.js → chunk-WFSOKGGA.js} +2 -2
  222. package/dist/{chunk-WI5ITCOH.js → chunk-WG5CJGLU.js} +2 -2
  223. package/dist/{chunk-S6UX7KB6.js → chunk-WQT6HIIY.js} +18 -17
  224. package/dist/{chunk-MZL6LGKO.js → chunk-WSJDLZSZ.js} +78 -47
  225. package/dist/{chunk-XJI6SWFS.js → chunk-WWIY6BBY.js} +77 -38
  226. package/dist/{chunk-33PLBIMA.js → chunk-WXJ5MHLH.js} +3 -2
  227. package/dist/chunk-X3YP4DUV.js +76 -0
  228. package/dist/{chunk-MBKZYJRC.js → chunk-X7XTIM6U.js} +50 -36
  229. package/dist/chunk-XJQXFVXY.js +24 -0
  230. package/dist/{chunk-KZJOV4QW.js → chunk-XMN3Z43K.js} +5 -5
  231. package/dist/{chunk-2ND7ZITT.js → chunk-XPOMQWXY.js} +90 -70
  232. package/dist/chunk-XVUQMZWV.js +24 -0
  233. package/dist/chunk-XYYRHGQI.js +24 -0
  234. package/dist/{chunk-NHQGRKEA.js → chunk-XZLU3G23.js} +7 -7
  235. package/dist/chunk-Y2CAIAUI.js +24 -0
  236. package/dist/{chunk-QO6HEXIZ.js → chunk-Y3L655X6.js} +6 -6
  237. package/dist/{chunk-QKL7IY42.js → chunk-Y54LU4CU.js} +1 -1
  238. package/dist/chunk-YGTNVZJE.js +89 -0
  239. package/dist/{chunk-LIWLBLCT.js → chunk-YLC42C3M.js} +1 -1
  240. package/dist/{chunk-SGD3ZHID.js → chunk-YOOHNQ3L.js} +15 -4
  241. package/dist/{chunk-DRW6KGBK.js → chunk-YTCIGJUU.js} +116 -42
  242. package/dist/{chunk-ULTSSIOU.js → chunk-YV5KYGE5.js} +1 -1
  243. package/dist/{chunk-4RRNJLCM.js → chunk-YXM4W3TN.js} +146 -67
  244. package/dist/{chunk-2L2Q53EP.js → chunk-Z2X4JQNY.js} +81 -21
  245. package/dist/{chunk-LS7HVBI7.js → chunk-Z5V6ZM76.js} +3 -3
  246. package/dist/{chunk-DU4A5AOY.js → chunk-Z7NHFNH3.js} +165 -79
  247. package/dist/{chunk-HOAH5XBR.js → chunk-ZBSNF5F7.js} +208 -62
  248. package/dist/chunk-ZGHBDMYF.js +24 -0
  249. package/dist/{chunk-TM4OC53S.js → chunk-ZHFUMVW7.js} +2 -1
  250. package/dist/{chunk-TWOREVKJ.js → chunk-ZLYQWUNR.js} +84 -50
  251. package/dist/chunk-ZTMZOKVC.js +61 -0
  252. package/dist/cli/index.js +3 -3
  253. package/dist/{core-LA6XDYG7.js → core-2SICIP63.js} +6 -1
  254. package/dist/{core-5HQBPCHL.js → core-2YTKFBNZ.js} +6 -1
  255. package/dist/{core-FVR3WZEC.js → core-3647Z25D.js} +5 -1
  256. package/dist/{core-GES44OTS.js → core-3IJPBNGC.js} +3 -1
  257. package/dist/{core-KKQS3WI2.js → core-6HMJHFRR.js} +9 -1
  258. package/dist/{core-QY7AVIKZ.js → core-7JKE7H32.js} +6 -1
  259. package/dist/{core-WUQVFARS.js → core-BMY7OL76.js} +6 -1
  260. package/dist/{core-4BZQQSHS.js → core-CAL7YNFC.js} +4 -1
  261. package/dist/{core-NP4VHWXL.js → core-CBEGB2NO.js} +4 -1
  262. package/dist/{core-C6YUSTZI.js → core-CLLIG7ZU.js} +3 -1
  263. package/dist/{core-MJ7JWQT5.js → core-CTZLHGXE.js} +2 -1
  264. package/dist/{core-UHECQHJ2.js → core-EYJ3WJK4.js} +4 -1
  265. package/dist/{core-ETAGQBZO.js → core-FX7HRKTF.js} +3 -1
  266. package/dist/{core-Z2F3IGSR.js → core-GQC6VDW5.js} +4 -1
  267. package/dist/{core-IKD3EE3S.js → core-GRWI22NS.js} +4 -1
  268. package/dist/{core-OJUQLIQ5.js → core-H7KMWYP5.js} +5 -1
  269. package/dist/{core-WGM4XUN3.js → core-HJUGHAX7.js} +3 -1
  270. package/dist/{core-V5FV4NWL.js → core-JMYMIH6Z.js} +9 -1
  271. package/dist/{core-GGQREDSI.js → core-KEB5PBCO.js} +6 -1
  272. package/dist/{core-6RYHWUJO.js → core-MEC6A5DD.js} +5 -1
  273. package/dist/{core-GCTFVYMH.js → core-MV6KGAUV.js} +4 -1
  274. package/dist/{core-MR52YBRX.js → core-NTWHFDM4.js} +3 -1
  275. package/dist/{core-SBQMHWTA.js → core-OIC5KJSD.js} +7 -1
  276. package/dist/{core-Q6VLFFYC.js → core-OWCTIPHD.js} +6 -1
  277. package/dist/{core-NSIJEKLI.js → core-PMYCLXT7.js} +6 -1
  278. package/dist/{core-EEB7HTCL.js → core-PTRQPQTO.js} +4 -1
  279. package/dist/{core-3VCCUFVX.js → core-QABTVASG.js} +3 -1
  280. package/dist/{core-AJTVU6X7.js → core-RPQBIOU4.js} +5 -1
  281. package/dist/{core-4VT4MHNB.js → core-SKRADU7T.js} +4 -1
  282. package/dist/{core-EFMVDWNH.js → core-T2KHX5LG.js} +4 -1
  283. package/dist/{core-PB3VUQSS.js → core-T4ZH3FAU.js} +3 -1
  284. package/dist/{core-JM4R426L.js → core-UAY2G7LN.js} +2 -1
  285. package/dist/{core-NQLNZDX5.js → core-ULZ7XUQP.js} +5 -1
  286. package/dist/{core-MLROKJ2M.js → core-VBR253SM.js} +4 -1
  287. package/dist/{core-7BZJCIXN.js → core-VMIBBHXI.js} +4 -1
  288. package/dist/{core-5535KXRD.js → core-XMTKUXLO.js} +4 -1
  289. package/dist/{core-HRYOV6QD.js → core-YEFGEW3Z.js} +4 -1
  290. package/dist/{dataTable-3CPPIHB3.js → dataTable-2ZXK54TP.js} +4 -2
  291. package/dist/{engine-FXFBCWHB.js → engine-HGXSWGOI.js} +27 -27
  292. package/dist/fixtures.js +7 -1
  293. package/dist/{fontTables-WYCZNRE7.js → fontTables-ZPZQ6IR3.js} +1 -1
  294. package/dist/fonts.js +2 -1
  295. package/dist/geo/dach.js +3 -1
  296. package/dist/geo/de-states.js +3 -1
  297. package/dist/geo/eu27.js +3 -1
  298. package/dist/geo/europe.js +3 -1
  299. package/dist/geo/index.js +4 -2
  300. package/dist/geo/us-states.js +3 -1
  301. package/dist/geo/world.js +3 -1
  302. package/dist/index.js +31 -26
  303. package/dist/{main-YLKBTHJP.js → main-PVT6FMGC.js} +55 -24
  304. package/dist/mcp/server.js +51 -23
  305. package/dist/{module-SVEW5ZUE.js → module-ZSR7KTAS.js} +1 -1
  306. package/dist/react/bar.js +7 -1
  307. package/dist/react/bartable.js +7 -1
  308. package/dist/react/box.js +7 -1
  309. package/dist/react/bullet.js +5 -1
  310. package/dist/react/butterfly.js +6 -1
  311. package/dist/react/choropleth.js +5 -1
  312. package/dist/react/cohort.js +5 -1
  313. package/dist/react/column.js +10 -1
  314. package/dist/react/combo.js +4 -1
  315. package/dist/react/creative.js +3 -1
  316. package/dist/react/diagram.js +4 -1
  317. package/dist/react/dimswitch.js +5 -1
  318. package/dist/react/dot.js +10 -1
  319. package/dist/react/export.js +34 -31
  320. package/dist/react/funnel.js +5 -1
  321. package/dist/react/gantt.js +4 -1
  322. package/dist/react/grid.js +5 -1
  323. package/dist/react/heatmap.js +5 -1
  324. package/dist/react/histogram.js +7 -1
  325. package/dist/react/index.js +95 -90
  326. package/dist/react/kpi.js +3 -1
  327. package/dist/react/likert.js +8 -1
  328. package/dist/react/line.js +5 -1
  329. package/dist/react/mekko.js +6 -1
  330. package/dist/react/pareto.js +4 -1
  331. package/dist/react/pie.js +6 -1
  332. package/dist/react/prepare.js +34 -28
  333. package/dist/react/pvm.js +5 -1
  334. package/dist/react/pyramid.js +6 -1
  335. package/dist/react/sankey.js +5 -1
  336. package/dist/react/scatter.js +5 -1
  337. package/dist/react/slope.js +7 -1
  338. package/dist/react/sparkline.js +5 -1
  339. package/dist/react/spec.js +25 -31
  340. package/dist/react/status.js +4 -1
  341. package/dist/react/story.js +7 -4
  342. package/dist/react/table.js +5 -1
  343. package/dist/react/theme.js +7 -3
  344. package/dist/react/tilemap.js +5 -1
  345. package/dist/react/treemap.js +4 -1
  346. package/dist/react/variance.js +6 -1
  347. package/dist/react/waffle.js +4 -1
  348. package/dist/react/waterfall.js +5 -1
  349. package/dist/{resvg-ZOVDIZTV.js → resvg-VB7S5HRF.js} +1 -1
  350. package/dist/rows.js +2 -3
  351. package/dist/{rowsModule-YVLAROIP.js → rowsModule-JTDPTWXG.js} +3 -1
  352. package/dist/{schema-BNRNHGHQ.js → schema-2M3LXR35.js} +3 -1
  353. package/dist/{schema-5HA5DSYN.js → schema-2Q7IJ22V.js} +3 -1
  354. package/dist/{schema-FA6XIHTW.js → schema-3OLBUVMZ.js} +3 -1
  355. package/dist/{schema-F3WYTR65.js → schema-3XLO43SX.js} +3 -1
  356. package/dist/{schema-RTWES6NR.js → schema-5753NOAL.js} +3 -1
  357. package/dist/{schema-S3TCLTYD.js → schema-5KHDHTIX.js} +3 -1
  358. package/dist/{schema-WOSEZNKG.js → schema-76XRTBCJ.js} +3 -1
  359. package/dist/{schema-MPXZNWV3.js → schema-7CPGNCOL.js} +3 -1
  360. package/dist/{schema-2KIHLTYI.js → schema-BKHQ3ZUH.js} +3 -1
  361. package/dist/{schema-JB2H6KPA.js → schema-BMD5JR3Y.js} +3 -1
  362. package/dist/{schema-5BKQV56C.js → schema-BOGTPL7F.js} +3 -1
  363. package/dist/{schema-ORTRMYI6.js → schema-BUTNGYTT.js} +3 -1
  364. package/dist/{schema-SWWMOLOR.js → schema-C7NVOQNV.js} +6 -3
  365. package/dist/{schema-O4YNAGIY.js → schema-FNTAAXQ3.js} +3 -1
  366. package/dist/{schema-7TLSFG6M.js → schema-FYULDJFB.js} +3 -1
  367. package/dist/{schema-NHNQK6XO.js → schema-FZKNIAIH.js} +3 -1
  368. package/dist/{schema-B7CZPPB4.js → schema-G2PLJCYL.js} +3 -1
  369. package/dist/{schema-ZUUUY3QS.js → schema-GGG2VOY7.js} +3 -2
  370. package/dist/{schema-6RYJS2GM.js → schema-GLN7IHSH.js} +3 -1
  371. package/dist/{schema-OJCML6LV.js → schema-HIDW4BA4.js} +3 -1
  372. package/dist/{schema-S36SRYGO.js → schema-J53LCIY3.js} +3 -1
  373. package/dist/{schema-2K6C3U24.js → schema-KIJA53MB.js} +4 -1
  374. package/dist/{schema-O7AKK232.js → schema-LEQNLBNG.js} +2 -1
  375. package/dist/{schema-AMFRKUFS.js → schema-LHMEXFLY.js} +3 -1
  376. package/dist/{schema-65FOKNHK.js → schema-MT6NA5AL.js} +3 -3
  377. package/dist/{schema-4S5CXHAO.js → schema-MUTAVQMI.js} +3 -1
  378. package/dist/{schema-Y6KBWUUR.js → schema-NVMEOHAW.js} +3 -1
  379. package/dist/{schema-6OHZWHUI.js → schema-TA3MSAPQ.js} +3 -1
  380. package/dist/{schema-YQYTLKSW.js → schema-U26KG42U.js} +3 -1
  381. package/dist/{schema-E4MRCGPZ.js → schema-UHHFTVGS.js} +3 -1
  382. package/dist/{schema-4HY2MWZC.js → schema-V3BPW4LA.js} +3 -1
  383. package/dist/{schema-PJ6P52BC.js → schema-WIZ2TZAT.js} +3 -1
  384. package/dist/{schema-NN6UPDPW.js → schema-WZLWHOMY.js} +3 -1
  385. package/dist/{schema-6W4M3WJ4.js → schema-XATDKZPW.js} +3 -1
  386. package/dist/{schema-5NKJPSBD.js → schema-XHKSGMUH.js} +3 -1
  387. package/dist/{schema-GZNOW4LX.js → schema-XKY2EQFH.js} +3 -1
  388. package/dist/{schema-HEIDGCSL.js → schema-ZE7WUNFS.js} +3 -1
  389. package/dist/{specValidation-VNWIKLHH.js → specValidation-X5XJBPTP.js} +4 -1
  390. package/dist/theme.js +5 -2
  391. package/dist/{themeShapeRules-2D3KWSPQ.js → themeShapeRules-PW4BQHKL.js} +1 -1
  392. package/dist/types/core/a11y/recordsShared.d.ts +4 -0
  393. package/dist/types/core/annotate.d.ts +39 -0
  394. package/dist/types/core/annotateArms.d.ts +1 -1
  395. package/dist/types/core/annotateEngine.d.ts +14 -0
  396. package/dist/types/core/axis.d.ts +2 -0
  397. package/dist/types/core/calendarLabels.d.ts +15 -0
  398. package/dist/types/core/charts/band/stacks.d.ts +71 -2
  399. package/dist/types/core/charts/bartable/types.d.ts +10 -0
  400. package/dist/types/core/charts/choropleth/index.d.ts +7 -0
  401. package/dist/types/core/charts/choropleth/layout.d.ts +7 -0
  402. package/dist/types/core/charts/choropleth/schema.d.ts +36 -0
  403. package/dist/types/core/charts/cohort/types.d.ts +8 -1
  404. package/dist/types/core/charts/column/layout.d.ts +1 -1
  405. package/dist/types/core/charts/column/model.d.ts +4 -0
  406. package/dist/types/core/charts/combo/endpoints.d.ts +1 -1
  407. package/dist/types/core/charts/creative/types.d.ts +1 -1
  408. package/dist/types/core/charts/dimswitch/compile.d.ts +2 -0
  409. package/dist/types/core/charts/dimswitch/types.d.ts +8 -0
  410. package/dist/types/core/charts/grid/normalize.d.ts +18 -1
  411. package/dist/types/core/charts/heatmap/fixtures.d.ts +2 -2
  412. package/dist/types/core/charts/histogram/types.d.ts +14 -2
  413. package/dist/types/core/charts/likert/layout.d.ts +14 -9
  414. package/dist/types/core/charts/logAxis.d.ts +55 -0
  415. package/dist/types/core/charts/pvm/types.d.ts +6 -0
  416. package/dist/types/core/charts/pyramid/types.d.ts +7 -4
  417. package/dist/types/core/charts/sankey/types.d.ts +3 -1
  418. package/dist/types/core/charts/scatter/clamp.d.ts +155 -0
  419. package/dist/types/core/charts/scatter/frontier.d.ts +21 -0
  420. package/dist/types/core/charts/scatter/index.d.ts +9 -0
  421. package/dist/types/core/charts/scatter/layout.d.ts +26 -0
  422. package/dist/types/core/charts/scatter/logAxis.d.ts +14 -0
  423. package/dist/types/core/charts/scatter/model.d.ts +258 -0
  424. package/dist/types/core/charts/scatter/schema.d.ts +57 -0
  425. package/dist/types/core/charts/scatter/trend.d.ts +54 -0
  426. package/dist/types/core/charts/scatter/valueLines.d.ts +47 -0
  427. package/dist/types/core/charts/sparkline/fixtures.d.ts +1 -1
  428. package/dist/types/core/charts/status/layout.d.ts +5 -3
  429. package/dist/types/core/charts/table/resolve.d.ts +0 -7
  430. package/dist/types/core/charts/tilemap/index.d.ts +6 -0
  431. package/dist/types/core/charts/tilemap/layout.d.ts +5 -0
  432. package/dist/types/core/charts/tilemap/schema.d.ts +4 -0
  433. package/dist/types/core/charts/treemap/types.d.ts +2 -2
  434. package/dist/types/core/charts/variance/fixtures.d.ts +2 -1
  435. package/dist/types/core/charts/waffle/types.d.ts +2 -0
  436. package/dist/types/core/dateFormat.d.ts +1 -1
  437. package/dist/types/core/deferred.d.ts +6 -1
  438. package/dist/types/core/doc/diagnostics.d.ts +8 -0
  439. package/dist/types/core/doc/document.d.ts +9 -1
  440. package/dist/types/core/doc/ownedDocumentCopy.d.ts +2 -1
  441. package/dist/types/core/fontMetrics/index.d.ts +1 -1
  442. package/dist/types/core/footer.d.ts +9 -1
  443. package/dist/types/core/format.d.ts +4 -1
  444. package/dist/types/core/formatSpec.d.ts +84 -6
  445. package/dist/types/core/frame.d.ts +41 -8
  446. package/dist/types/core/geo/packs/registry.d.ts +3 -2
  447. package/dist/types/core/geometry.d.ts +19 -0
  448. package/dist/types/core/icons.d.ts +11 -0
  449. package/dist/types/core/inputError.d.ts +3 -0
  450. package/dist/types/core/isoDate.d.ts +2 -0
  451. package/dist/types/core/label/categoryRow.d.ts +8 -0
  452. package/dist/types/core/label/occupied.d.ts +5 -0
  453. package/dist/types/core/label/solver.d.ts +31 -2
  454. package/dist/types/core/notes.d.ts +13 -1
  455. package/dist/types/core/ols.d.ts +38 -0
  456. package/dist/types/core/periodYears.d.ts +5 -1
  457. package/dist/types/core/registry.d.ts +12 -0
  458. package/dist/types/core/request.d.ts +3 -2
  459. package/dist/types/core/scale.d.ts +7 -0
  460. package/dist/types/core/schema/capability.d.ts +17 -20
  461. package/dist/types/core/schema/namedColumns.d.ts +6 -0
  462. package/dist/types/core/schema/refusals.d.ts +1 -4
  463. package/dist/types/core/shareRounding.d.ts +8 -0
  464. package/dist/types/core/sizing.d.ts +17 -12
  465. package/dist/types/core/story.d.ts +3 -0
  466. package/dist/types/core/target.d.ts +6 -0
  467. package/dist/types/core/text.d.ts +8 -0
  468. package/dist/types/core/theme.d.ts +55 -2
  469. package/dist/types/core/themeShape.d.ts +3 -3
  470. package/dist/types/core/themeValidate.d.ts +3 -3
  471. package/dist/types/core/types/annotations.d.ts +15 -3
  472. package/dist/types/core/types/data.d.ts +4 -1
  473. package/dist/types/core/types/diagram.d.ts +81 -2
  474. package/dist/types/core/types/optionInput.d.ts +13 -0
  475. package/dist/types/core/types/options.d.ts +65 -24
  476. package/dist/types/core/types/scene.d.ts +79 -2
  477. package/dist/types/core/types/table.d.ts +9 -0
  478. package/dist/types/core/types/theme.d.ts +50 -4
  479. package/dist/types/index.d.ts +28 -27
  480. package/dist/types/optionTypes.d.ts +44 -0
  481. package/dist/types/react/DimSwitchChart.d.ts +2 -1
  482. package/dist/types/react/RefusalBoundary.d.ts +25 -0
  483. package/dist/types/react/SceneRenderer.d.ts +3 -1
  484. package/dist/types/react/SizePlaceholder.d.ts +2 -1
  485. package/dist/types/react/TableChart.d.ts +8 -4
  486. package/dist/types/react/barrelCharts.d.ts +1521 -1012
  487. package/dist/types/react/charts/bar.d.ts +36 -25
  488. package/dist/types/react/charts/bartable.d.ts +36 -25
  489. package/dist/types/react/charts/box.d.ts +36 -25
  490. package/dist/types/react/charts/bullet.d.ts +36 -25
  491. package/dist/types/react/charts/butterfly.d.ts +36 -25
  492. package/dist/types/react/charts/choropleth.d.ts +36 -25
  493. package/dist/types/react/charts/cohort.d.ts +76 -50
  494. package/dist/types/react/charts/column.d.ts +36 -25
  495. package/dist/types/react/charts/combo.d.ts +2 -1
  496. package/dist/types/react/charts/creative.d.ts +31 -25
  497. package/dist/types/react/charts/diagram.d.ts +302 -160
  498. package/dist/types/react/charts/dot.d.ts +36 -25
  499. package/dist/types/react/charts/funnel.d.ts +36 -25
  500. package/dist/types/react/charts/gantt.d.ts +36 -25
  501. package/dist/types/react/charts/grid.d.ts +38 -27
  502. package/dist/types/react/charts/heatmap.d.ts +36 -25
  503. package/dist/types/react/charts/histogram.d.ts +36 -25
  504. package/dist/types/react/charts/kpi.d.ts +36 -25
  505. package/dist/types/react/charts/likert.d.ts +36 -25
  506. package/dist/types/react/charts/line.d.ts +36 -25
  507. package/dist/types/react/charts/mekko.d.ts +36 -25
  508. package/dist/types/react/charts/pareto.d.ts +33 -25
  509. package/dist/types/react/charts/pie.d.ts +36 -25
  510. package/dist/types/react/charts/pvm.d.ts +36 -25
  511. package/dist/types/react/charts/pyramid.d.ts +33 -25
  512. package/dist/types/react/charts/sankey.d.ts +36 -25
  513. package/dist/types/react/charts/scatter.d.ts +36 -25
  514. package/dist/types/react/charts/slope.d.ts +36 -25
  515. package/dist/types/react/charts/sparkline.d.ts +36 -25
  516. package/dist/types/react/charts/status.d.ts +36 -25
  517. package/dist/types/react/charts/tilemap.d.ts +36 -25
  518. package/dist/types/react/charts/treemap.d.ts +36 -25
  519. package/dist/types/react/charts/variance.d.ts +36 -25
  520. package/dist/types/react/charts/waffle.d.ts +36 -25
  521. package/dist/types/react/charts/waterfall.d.ts +36 -25
  522. package/dist/types/react/createChartComponent.d.ts +11 -9
  523. package/dist/types/react/footerFrame.d.ts +1 -1
  524. package/dist/types/react/hover/engine.d.ts +2 -1
  525. package/dist/types/react/hover/labelCard.d.ts +14 -2
  526. package/dist/types/react/prepare.d.ts +2 -2
  527. package/dist/types/react/prepared.d.ts +5 -1
  528. package/dist/types/react/rowsStore.d.ts +5 -0
  529. package/dist/types/react/useContainerSize.d.ts +2 -0
  530. package/dist/types/rows.d.ts +1 -1
  531. package/dist/validate.js +13 -8
  532. package/docs/manual.md +143 -37
  533. package/docs/reference/bar.md +10 -7
  534. package/docs/reference/bartable.md +7 -3
  535. package/docs/reference/box.md +5 -2
  536. package/docs/reference/bullet.md +7 -5
  537. package/docs/reference/butterfly.md +12 -5
  538. package/docs/reference/choropleth.md +9 -7
  539. package/docs/reference/cohort.md +3 -2
  540. package/docs/reference/column.md +14 -7
  541. package/docs/reference/combo.md +8 -6
  542. package/docs/reference/creative.md +1 -1
  543. package/docs/reference/diagram.md +94 -18
  544. package/docs/reference/dimswitch.md +16 -13
  545. package/docs/reference/dot.md +7 -4
  546. package/docs/reference/fixtures.md +49 -5
  547. package/docs/reference/funnel.md +4 -3
  548. package/docs/reference/gantt.md +1 -1
  549. package/docs/reference/grid.md +1 -1
  550. package/docs/reference/heatmap.md +6 -4
  551. package/docs/reference/histogram.md +7 -4
  552. package/docs/reference/kpi.md +11 -8
  553. package/docs/reference/likert.md +7 -3
  554. package/docs/reference/line.md +9 -8
  555. package/docs/reference/mekko.md +4 -4
  556. package/docs/reference/options.md +34 -32
  557. package/docs/reference/pareto.md +4 -4
  558. package/docs/reference/pie.md +8 -7
  559. package/docs/reference/pvm.md +4 -2
  560. package/docs/reference/pyramid.md +4 -4
  561. package/docs/reference/react.md +20 -11
  562. package/docs/reference/sankey.md +5 -3
  563. package/docs/reference/scatter.md +3 -3
  564. package/docs/reference/slope.md +7 -6
  565. package/docs/reference/sparkline.md +6 -5
  566. package/docs/reference/status.md +6 -4
  567. package/docs/reference/table.md +28 -26
  568. package/docs/reference/theme.md +94 -87
  569. package/docs/reference/tilemap.md +7 -6
  570. package/docs/reference/treemap.md +6 -5
  571. package/docs/reference/variance.md +8 -5
  572. package/docs/reference/waffle.md +2 -1
  573. package/docs/reference/waterfall.md +12 -9
  574. package/docs/use-cases.md +221 -0
  575. package/llms.txt +2 -1
  576. package/package.json +2 -1
  577. package/dist/chunk-2FNNAPCI.js +0 -24
  578. package/dist/chunk-2RSG7JYI.js +0 -24
  579. package/dist/chunk-3JEQGGVD.js +0 -19
  580. package/dist/chunk-3XHJHQWU.js +0 -42
  581. package/dist/chunk-4JLBVIGW.js +0 -24
  582. package/dist/chunk-6KWIQ5KF.js +0 -18
  583. package/dist/chunk-7X65ZQN4.js +0 -38
  584. package/dist/chunk-BBRBCMNR.js +0 -28
  585. package/dist/chunk-BMRD6MAH.js +0 -24
  586. package/dist/chunk-BW5VLBSZ.js +0 -15
  587. package/dist/chunk-CJGSJKPO.js +0 -25
  588. package/dist/chunk-CN7JRHST.js +0 -25
  589. package/dist/chunk-DJHIQWSG.js +0 -25
  590. package/dist/chunk-E4IQ6M4S.js +0 -24
  591. package/dist/chunk-EFUWFB64.js +0 -24
  592. package/dist/chunk-FIANWJXX.js +0 -19
  593. package/dist/chunk-GZTNTHSW.js +0 -21
  594. package/dist/chunk-H5G7T35P.js +0 -24
  595. package/dist/chunk-HKYTOJLV.js +0 -33
  596. package/dist/chunk-HYY5V2KL.js +0 -19
  597. package/dist/chunk-I6VAWNNU.js +0 -24
  598. package/dist/chunk-IK4BHOPZ.js +0 -33
  599. package/dist/chunk-ILSXT6KT.js +0 -24
  600. package/dist/chunk-JR7Y5ONB.js +0 -27
  601. package/dist/chunk-K3HSQPSM.js +0 -24
  602. package/dist/chunk-KDMKHR5A.js +0 -32
  603. package/dist/chunk-KOJ5QETJ.js +0 -8
  604. package/dist/chunk-L3JWM7FR.js +0 -50
  605. package/dist/chunk-L4S6UFTL.js +0 -26
  606. package/dist/chunk-LFTAMH7I.js +0 -24
  607. package/dist/chunk-MIAPBQCA.js +0 -24
  608. package/dist/chunk-NCB3YLHF.js +0 -28
  609. package/dist/chunk-ONZLC47B.js +0 -88
  610. package/dist/chunk-OUEGGWH7.js +0 -24
  611. package/dist/chunk-P25VEGGX.js +0 -24
  612. package/dist/chunk-P26Z62UV.js +0 -24
  613. package/dist/chunk-PFVTYFSL.js +0 -24
  614. package/dist/chunk-QGCEHR6S.js +0 -13
  615. package/dist/chunk-QOIVXZUF.js +0 -24
  616. package/dist/chunk-RA66JA3D.js +0 -24
  617. package/dist/chunk-SMCDXUIO.js +0 -24
  618. package/dist/chunk-T3IGJARD.js +0 -22
  619. package/dist/chunk-TKOJZQAJ.js +0 -24
  620. package/dist/chunk-UBZXQIDR.js +0 -24
  621. package/dist/chunk-VERLFNWR.js +0 -25
  622. package/dist/chunk-VH2UUU7K.js +0 -24
  623. package/dist/chunk-Z6CL7AR6.js +0 -24
  624. package/dist/chunk-ZU425HNM.js +0 -24
  625. package/dist/chunk-ZZU5R5UU.js +0 -24
  626. /package/dist/{DiagnosticDetails-UNYNYCAH.js → DiagnosticDetails-JFBBXOT2.js} +0 -0
@@ -99,7 +99,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
99
99
  | series[].label | string | | Displayed series name; defaults to the series id. |
100
100
  | series[].shortLabel | string | | Short end-label name. End labels get 18% of the effective width: Boardplot tries the full label on one line, then on two, then shortLabel with a full-name legend key, then a legend with value-only end labels. legend 'none' removes the shortLabel and legend steps, a labelPlacements pin the legend step. Boardplot adds no abbreviation or ellipsis. |
101
101
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
102
- | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). Controls scenario labels and paint conventions. |
102
+ | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
103
103
  | series[].role | string | | Data series or comparison-only reference series; references are excluded from the main plotted data. One of `'data'`, `'reference'`. |
104
104
  | series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
105
105
  | series[].fill | string | | Explicit CSS fill color for this series; remains authored across theme changes. |
@@ -138,7 +138,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
138
138
  | xAxis.ticks | array | | | Explicit ticks: x values, or { value, label } pairs. Ticks outside the axis range are dropped; labels that would overlap thin and warn x-ticks-thinned. Not with tickStep. |
139
139
  | xAxis.ticks[].value | string \| number | | | The x value of the tick. |
140
140
  | xAxis.ticks[].label | string | | | Text printed at the tick instead of the formatted value. |
141
- | xAxis.format | string | | | Tick label format. Time: a pattern of yyyy, yy, MMMM, MMM, MM, M, dddd, ddd, dd, d, HH, H, hh, h, mm, ss, a and 'quoted literals', such as 'HH:mm' or 'd MMM'; default by step: 'HH:mm' (24-hour clock in every language), '24 Oct' (en-US 'Oct 24'), 'Oct', 'Q4', '2026'. Number: a format-by-example such as 1,234.5 or 0.0%, through the shared number formatting. |
141
+ | xAxis.format | string | | | Tick label format. Time takes a pattern or an example such as 'Jan 2026', 'Q1 2026', 'September 2026' or '2026'. Tokens: yyyy, yy, MMMM, MMM, MM, M, dddd, ddd, dd, d, Q (1), QQ (Q1), QQQ (Quarter 1), HH, H, hh, h, mm, ss, SSS, a and 'quoted literals'. Excel mmm and mmmm name months. Lowercase m/mm in 'dd/mm/yyyy' means month when no hour or seconds token is present. YYYY/YY mean year and D/DD mean day. Numeric dates use a day above 12 to choose the order. Otherwise they read day first and warn date-format-ambiguous. A year in front keeps year/month/day. 'FY26' reads the calendar year and gives date-format-fiscal-year (info). Unreadable text warns date-format-unknown and uses default ticks by step: 'HH:mm' (24-hour clock in every language), '24 Oct' (en-US 'Oct 24'), 'Oct', 'Q4', '2026'. Number: a format-by-example such as 1,234.5 or 0.0%, through the shared number formatting. |
142
142
  | xAxis.title | string | | | Axis title printed under the tick row at the right end, such as 'Distance, km'. |
143
143
  | xAxis.unit | string | | | Number axes: the unit of x, which names the trend slope ('+0.42 per km'). Without it the slope reads 'per unit of x'. |
144
144
  | xAxis.maxTicks | integer | | `10` | Most ticks the automatic ladder draws; default 10. The ladder takes the finest step whose labels fit with that count. |
@@ -169,18 +169,18 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
169
169
  | bump.focus | array | | | The entities to draw, at most 12. Every series is still ranked; the others are named in a note with their last rank and keep their values in the data table. A bump of more than 12 entities without focus is refused (bump-series-limit). |
170
170
  | seriesLabels | string \| object | `'end'`, `'inline'`, `'key'`, `'none'` (or another value of its type) | | Where series names print; a name carries no value, except where two or more lines end within a line of each other at the last category: there each name takes its last value. On report, dashboard, slide and print, plain-line names use medium weight at the label role size, in a contrast-safe series colour. Values use regular weight. Crowded blocks use one line if two lines would move more than three label line heights from the endpoint. If one line cannot fit within that bound, a right-hand key lists names and end values from highest to lowest, with a reading disclosure. 'end' (default): a column just past the line ends, names only, short leaders; too wide for 18% of the width, shortLabel, then the key row. 'inline': on a clear stretch of each line; the last values still print. An authored 'end' or 'inline' that ends in the key row warns line-end-label-key. 'key': a key row above the plot. 'none': no names; two or more drawn series still get the key row (info series-labels-key) unless legend is set. A lone 'line' defaults to 'none'. { only } names the listed series and gives the rest no name and no value. |
171
171
  | seriesLabels.only | array | | | The series named at their line ends; the others get neither a name nor a value, so twelve cohort curves read under four names. |
172
- | valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Point values: default last, inline and bump none, stacked100-area ends. Distinct end values that round to the same text gain up to two decimals as one label set; the reading uses that precision. Bump keeps the precision used to rank its values. Choices: 'none' (default under seriesLabels 'inline'), 'last' (default), 'ends' (first and last; stacked100-area default), 'extremes' (ends plus each series' low and high) or 'all'. A value sits on the side of its point away from other lines and never nearer another line than its own; one with no free seat goes to the note line, and missing labels warn label-hidden once per chart; reading.omissions names each label and its destination. Stacked values sit in their band. labels.point sets the content. When the author sets valueLabels and every non-null value in a series has a string label (ignoring label:false cells), valueLabels selects the values and each selected value uses its cell text. Otherwise a string cell label also selects its point, outside the valueLabels selection, even when labels.point is false. label:false removes a value label. bump defaults to 'none'; its values are the measure behind the ranks, so each carries the unit, and without a unit or format it warns bump-values-unnamed. |
172
+ | valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Point values: default last, inline and bump none, stacked100-area ends. Distinct end values that round to the same text gain up to two decimals as one label set; the reading uses that precision. Bump keeps the precision used to rank its values. Choices: 'none' (default under seriesLabels 'inline'), 'last' (default), 'ends' (first and last; stacked100-area default), 'extremes' (ends plus each series' low and high) or 'all'. A value sits on the side of its point away from other lines and never nearer another line than its own; one with no free seat goes to the note line, and missing labels warn label-hidden once per chart; reading.omissions names each label and its destination. Stacked values sit in their band. labels.point sets the content. When the author sets valueLabels and every non-null value in a series has a string label (ignoring label:false cells), valueLabels selects the values and each selected value uses its cell text. Otherwise a string cell label also selects its point, outside the valueLabels selection, even when labels.point is false. label:false removes a value label. bump defaults to 'none'; its values are the measure behind the ranks, so each carries the unit, and without a unit or format it warns bump-values-unnamed. A plain line on a linear scale that does not start at zero keeps a tick at its lowest value with a break glyph, also under 'all' and valueAxis.show false, so the cut baseline stays visible; valueAxis.includeZero true or valueAxis.min 0 starts at zero and removes it. |
173
173
  | latestPoint | string \| object | `'ring'`, `'none'` (or another value of its type) | `'none'` | Ring the last observed point in the highlight colour, r 4.5 with a dot inside it: the newest cohort of a curves chart, the current period of a trend. 'ring' picks the primary series, the hero where emphasis names one and otherwise the first data series that is not a prior year, plan or forecast; { series } names one outright. Default 'none'. Line and area variants only: a stacked band's last point is the top of the stack, so stacked-area and stacked100-area refuse it. |
174
174
  | latestPoint.series | string | | | The series whose last observed point is ringed. |
175
175
  | latestPoint.marker | string | `'ring'` | `'ring'` | Marker shape; 'ring' is the only one and the default. |
176
- | emphasis | string | `'first'`, `'ordered'`, `'none'` | | Multi-series line colouring. 'none': every series takes its theme ramp colour, color.series[i], in data order. 'first': the first series takes ink at 2.4px and the others step back to muted context tints, for one line read against context. 'ordered': the series take the theme's ordered ramp in data order, the first the lightest (still 3:1 on the page) and the last the full ink, for series whose order is the encoding, such as cohorts; a highlighted series keeps the focus and a series fill or colorRole its own colour. Unset means 'none', except on a drawn fan, whose centre is the subject and takes the ink ('first'). Plain line variant only; highlight, palette, series fill, colorRole and series-level scenario keep their own colours (cell-level FC and PL keep their dash notation), and an explicit 'first' that cannot apply, including on a single drawn series, warns line-emphasis-ignored. |
176
+ | emphasis | string | `'first'`, `'ordered'`, `'none'` | | Multi-series line colouring. 'none': every series takes its theme ramp colour, color.series[i], in data order. 'first': the first series takes ink at 2.4px and the others step back to muted context tints, for one line read against context. 'ordered': the series take the theme's ordered ramp in data order, the first the lightest (still 3:1 on the page) and the last the full ink, for series whose order is the encoding, such as cohorts; a highlighted series keeps the focus and a series fill or colorRole its own colour. Unset means 'none', except on a drawn fan, whose centre is the subject and takes the ink ('first'), and on stacked-area and stacked100-area without a highlight, palette or series fill, whose bands are parts of one total and take 'ordered'; set 'none' there for the theme hues. 'first' applies to the plain line variant only and 'ordered' to plain lines and stacked bands; highlight, palette, series fill, colorRole and series-level scenario keep their own colours (cell-level FC and PL keep their dash notation), and an explicit 'first' that cannot apply, including on a single drawn series, warns line-emphasis-ignored. |
177
177
  | othersShade | string | `'quietest'`, `'apart'` | | With emphasis 'ordered' and a Rest series (colorRole 'others'): how the ramp sits beside Rest. Default 'quietest'. 'quietest': Others is the quietest part, so every named step has more contrast against the background than Others and none matches it. 'apart': named steps only differ from Others, and some may be quieter. If Others is stronger than the first named step, the ramp falls back to 'apart' and the chart warns others-shade-unavailable. |
178
178
  | highlightMode | string | `'grey'`, `'fade'` | `'grey'` | How options.highlight treats the other series. 'grey': one grey ladder, today's look. 'fade': they keep their own colour, washed toward the page, and the highlighted series keeps its colour at 2.6px. |
179
179
  | scenarioStyle | object | | | Weight and ink per scenario, opt-in. A board that draws an actual against its prior year authors { AC: { width: 1.5, ink: 'ink' }, PY: { width: 1, ink: 'inkMuted' } }; without it every line keeps the default 2px and its ramp colour. An authored series fill or colorRole, a highlight and emphasis: 'first' all still win, and a series with no scenario is untouched. |
180
180
  | scenarioStyle.*.width | number | | | Stroke width in px for the lines of this scenario. |
181
181
  | scenarioStyle.*.ink | string | `'ink'`, `'inkMuted'` | | Which neutral ink the lines of this scenario take. |
182
- | rebase100 | boolean \| object | | | Index each series to 100 at the first category, or at the supplied category id. A series with a missing or zero base is not drawn, and the key names it. Ignored for stacked100-area. |
183
- | rebase100.at | string | | | Category whose nonzero value becomes 100 in each series. |
182
+ | rebase100 | boolean \| object | | | Index each series to 100 at the first category, or at the supplied category id. A series with a missing, zero or negative base is not drawn, and the key names it. Ignored for stacked100-area. |
183
+ | rebase100.at | string | | | Category whose positive value becomes 100 in each series. |
184
184
  | ratioTier | object | | | Below-axis ratio tier computed from normalized chart series cells; authored ratio values are not accepted. |
185
185
  | ratioTier.id | string | | | Stable id for the derived ratio tier. |
186
186
  | ratioTier.label | string | | | Quiet caption explaining what the ratio badges measure. |
@@ -222,7 +222,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
222
222
  | referenceBands[].label | string | | | REQUIRED. The band's name, printed bold at the start of its entry in the column right of the plot: the level or range as the reader should say it. Example: '60+'. |
223
223
  | referenceBands[].description | string | | | What the level means, in plain type after the name; it wraps under it when the column is narrow. Example: 'very strong cycle'. |
224
224
 
225
- Plus the [shared options](options.md). This type does not accept `categoryLabels`, `valueAxis.log`, `valueAxis.break`, `secondaryAxis`, `rowLabels`, `sort`, `topN`, `bandFraction`, `colorblindSafe`.
225
+ Plus the [shared options](options.md). This type does not accept `valueAxis.break`. This type ignores `animate`, `debug`, `rowLabels`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction` with an `option-ignored` warning.
226
226
 
227
227
  ## Annotations
228
228
 
@@ -230,7 +230,7 @@ An annotation anchor is a category or item id string, or an object with category
230
230
 
231
231
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
232
232
  |---|---|---|---|---|---|
233
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
233
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
234
234
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. placement: auto \| label \| bracket, default auto. With both ends on two different series at the last category, bracket draws the gap bracket in the right margin: an open ring on each end point, a dashed guide from each ring to the margin, a bracket with an arrowhead toward the measured end, and the gap as a large number beside it; the end values sit just over and under their guides. auto draws the bracket where gapFill washes the same two series and the label elsewhere. label keeps the label at the anchor. bracket on other anchors, or on stacked variants (stacked-area, stacked100-area), warns gap-bracket-unavailable and keeps the label. caption: string. A short line under the bracket number that says what it measures, right-aligned in muted ink. Only a gap bracket prints it; elsewhere it warns gap-caption-ignored. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. Diff labels precede point and end labels. Same-category arms attach there; anchored strokes do not displace them. Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
235
235
  | 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 | placement: auto \| label \| bracket, default auto. With both ends on two different series at the last category, bracket draws the gap bracket in the right margin: an open ring on each end point, a dashed guide from each ring to the margin, a bracket with an arrowhead toward the measured end, and the gap as a large number beside it; the end values sit just over and under their guides. auto draws the bracket where gapFill washes the same two series and the label elsewhere. label keeps the label at the anchor. bracket on other anchors, or on stacked variants (stacked-area, stacked100-area), warns gap-bracket-unavailable and keeps the label. caption: string. A short line under the bracket number that says what it measures, right-aligned in muted ink. Only a gap bracket prints it; elsewhere it warns gap-caption-ignored. | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
236
236
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. Bad anchors report the cause and valid ids. |
@@ -434,3 +434,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
434
434
  | x-number-trail | example | Elevation by distance on a plain-number x (continuous number axis) |
435
435
  | x-time-partial-week | example | Weekly orders with the running week marked by data.partial (continuous time axis) |
436
436
  | x-time-range-edges | example | A daily line continues to both range edges between readings |
437
+ | log-axis-users | example | Users grow across orders of magnitude |
@@ -56,7 +56,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
56
56
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
57
57
  | series[].label | string | | Displayed series name; defaults to the series id. |
58
58
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
59
- | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). |
59
+ | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
60
60
  | series[].direction | string | | Declared preference for higher or lower values in directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
61
61
  | series[].role | string | | Declares a plotted data series or a comparison reference series. One of `'data'`, `'reference'`. |
62
62
  | series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
@@ -70,11 +70,11 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
70
70
  |---|---|---|---|---|
71
71
  | axisTitles | object | | | Title of the value axis when it is drawn: over the value axis, in the top row left of the plot. Drawn only when authored. |
72
72
  | axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
73
- | variant | string | `'stacked100'`, `'stacked'`, `'bar'` | `'stacked100'` | stacked100 by default gives 100% stacks with widths proportional to category totals. stacked uses absolute stack heights; bar uses one value-height rectangle per category. |
73
+ | variant | string | `'stacked100'`, `'stacked'`, `'bar'` | `'stacked100'` | stacked100 by default gives 100% stacks with widths proportional to category totals. stacked uses absolute stack heights; bar uses one value-height rectangle per category; with several data series it draws them as stacked columns and warns. |
74
74
  | widthSeriesId | string | | | Series supplying category widths; omitted uses category totals, or equal widths in bar mode. |
75
75
  | ridge | string | | | Data-series id whose top boundary is emphasized across the variable-width columns. |
76
76
 
77
- Plus the [shared options](options.md). This type does not accept `mode`, `categoryLabels`, `valueAxis.tickStep`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `bandFraction`, `colorblindSafe`.
77
+ Plus the [shared options](options.md). This type does not accept `mode`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `bandFraction` with an `option-ignored` warning.
78
78
 
79
79
  ## Annotations
80
80
 
@@ -82,7 +82,7 @@ An annotation anchor is a category or item id string, or an object with category
82
82
 
83
83
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
84
84
  |---|---|---|---|---|---|
85
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
85
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
86
86
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
87
87
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
88
88
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
@@ -15,6 +15,7 @@ Every chart type accepts these options unless its own page names them as not acc
15
15
  | textSize | number | | | Primary label size in layout px, 6 to 32, the same at every width; other text keeps its ratio. Not with textScale. |
16
16
  | a11y | object | | | Accessible presentation options; visible chart title is controlled separately by title. |
17
17
  | a11y.title | boolean | | | Emit an SVG title element for hover text; default false. Accessible naming remains available. |
18
+ | a11y.description | string | | | Accessible description of the chart, in place of the generated one, in the SVG desc element and the React chart. Omitted: the description comes from the chart. |
18
19
  | a11y.table | string | `'hidden'`, `'toggle'`, `'below'` | | Record-derived accessible data table rendered by the React chart components: 'hidden' keeps it available to assistive technology only, 'toggle' adds a disclosure control, 'below' renders it visibly under the chart. BoardplotChart includes it in the server output; a per-type component adds it after mount. Omitted: no table. The SVG is unchanged. |
19
20
  | mode | string | `'full'`, `'compact'` | | Presentation framing. Omitted: full at or above the chart minimum width, compact below it where the type draws there. Compact keeps the title at the theme smallest title size. Some chart-specific schemas use a different mode vocabulary. |
20
21
  | belowMinimum | string | `'compact'`, `'refuse'` | `'compact'` | What a canvas below the chart minimum gets, on either axis, for the types with a compact floor: `measure` and `boardplot_describe` list it as `compactFloor`. 'compact' (default) draws the tight chart down to the floor: minimal labels, tight spacing, a smaller key, the whole title wrapped, and the subtitle dropped when the plot would be under 80 px. 'refuse' refuses below the minimum. On a canvas with a pinned size, a full-mode refusal for lack of room also falls back to compact under 'compact', and the chart is refused only when compact does not fit either. Types without a compact floor always refuse below their minimum, and every refusal names the minimum it needs. |
@@ -35,29 +36,29 @@ Every chart type accepts these options unless its own page names them as not acc
35
36
  | canvas.margin.right | number | | | Right outer margin in pixels; omission uses chart or theme defaults. |
36
37
  | canvas.margin.bottom | number | | | Bottom outer margin in pixels; omission uses chart or theme defaults. |
37
38
  | canvas.margin.left | number | | | Left outer margin in pixels; omission uses chart or theme defaults. |
38
- | title | string \| false | `false` (or another value of its type) | | Visible title override; omission retains the chart-specific title behaviour. |
39
- | subtitle | string \| object | | | Measure subtitle below the title; strings expand to the measure field. |
39
+ | title | string \| false | `false` (or another value of its type) | | Visible title override. `**text**` draws bold and a single `*` stays literal. Omission retains the chart-specific title behaviour. |
40
+ | subtitle | string \| object | | | Measure subtitle below the title. Strings expand to the measure field. `**text**` draws bold in company, measure and period. A single `*` stays literal. |
40
41
  | subtitle.company | string | | | Company or scope text before the measure. |
41
42
  | subtitle.measure | string | | | Measure named by the subtitle; options.unit supplies its unit. |
42
43
  | subtitle.period | string | | | Reporting period text after the measure. |
43
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". |
44
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
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. |
46
- | source | string | | | Source credit rendered in the chart frame. |
47
- | footnotes | array \| false | `false` (or another value of its type) | | Footnotes in authored order; 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. |
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
+ | 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. |
48
49
  | notes | object | | | Notes; the footer rule: where the notes under the chart go, how many lines they take, and the note lines for what the drawing leaves out. |
49
50
  | notes.maxListed | integer \| string | `'all'` (or another value of its type) | `8` | Items a note line names before it counts the rest, such as "Not labelled on the chart: ... and 236 more". Default: every note line names as many items as fit two footer lines, at most 8, reference lines and line end values first, then the rest in data order, and ends with "and N more"; when no name fits, it counts. 'all' names every item. 0 names none and only counts them, "18 of 36 values". All items stay in the reading and the hover records. |
50
51
  | notes.placement | string | `'frame'`, `'info'`, `'list'` | | Where the notes go. 'frame' prints notes in the frame within maxLines and the rest in the notes list; 'list' prints only the source line, a required map credit and the pointer; 'info' is the React "Notes and sources" button with one visible line of source and required credit (an SVG or PNG draws it as 'frame'). Default by target: dashboard 'info', slide 'list', report and print 'frame'. |
51
52
  | notes.maxLines | integer | | | Visible lines of notes and source line in the frame; a required map credit and a disclosure do not count. Notes that do not fit go to the notes list and the pointer counts them. Default report and dashboard 3 (2 under 720 px wide), slide 2, print 3. |
52
53
  | notes.show | string[] | `'note'`, `'method'`, `'disclosure'`, `'ranks'` | | The kinds of note the frame prints. Default ['note'], the authored footnotes, within maxLines; an authored note a mark points at always prints. 'method' adds the one-line short form of the method notes the engine writes (likert net, pvm split). 'disclosure' adds the engine's notes on how to read the chart (a key, a data change, 'Not labelled on the chart: ...'), outside maxLines; then a chart may also key its marks to them, such as rank numbers under the columns. 'ranks' prints only the rank key: rank numbers under the columns where the names fit neither upright nor rotated, with the note that names them, and no other disclosure. Engine notes print nowhere under the chart by default; every note stays in the notes list of the render result and in its warnings. |
53
54
  | notes.pointer | boolean | | `true` | Default true: when the notes list holds notes of the kinds notes.show prints that the frame does not print, the source line ends with "+N notes". |
54
- | theme | string \| object | | | Theme preset or preset with overrides; request context may supply it, otherwise resolution uses boardroom. |
55
+ | theme | string \| object \| object | | | Theme preset or preset with overrides. An object with only overrides uses the default preset. Request context may supply a theme, otherwise resolution uses bridge. |
55
56
  | theme.preset | string | | | Registered base theme whose tokens are overridden. |
56
- | theme.overrides | object | | | Partial theme token tree merged with the named preset. |
57
- | locale | object | | | Language and number marks. decimal and thousands set the marks of every number, as in a spreadsheet (default 1,234.5); a format example gives only the shape. language changes words only, never the marks. |
57
+ | theme.overrides | object | | | Partial theme token tree merged with the named preset. Partial token tree applied to the default preset. |
58
+ | locale | object \| string | | | A string sets language only. Language and number marks. decimal and thousands set the marks of every number, as in a spreadsheet (default 1,234.5); a format example gives only the shape. language changes words only, never the marks. |
58
59
  | locale.language | string | | | BCP 47 language tag. Changes words only, such as notes and month names. It never changes the decimal or grouping marks; they come only from locale.decimal and locale.thousands. E.g. "de"; "de_DE" is read as "de-DE"; "en-US" puts the month first (Sep 4). |
59
60
  | locale.decimal | string | `'.'`, `','` | | Decimal mark of every number the chart prints. Default '.'. The language does not change it. |
60
- | locale.thousands | string | `','`, `'.'`, `'’'`, `' '` | | Grouping mark of every number the chart prints. Default ',', or '.' with decimal ','. The language does not change it. A value equal to the decimal mark uses that fallback. |
61
+ | locale.thousands | string | `','`, `'.'`, `'’'`, `'\\''`, `' '`, `' '` | | Grouping mark of every number the chart prints. The apostrophe ' is the same as ’, and the narrow no-break space is the same as the space. Default ',', or '.' with decimal ','. The language does not change it. A value equal to the decimal mark uses that fallback. |
61
62
  | locale.minusGlyph | string | `'−'`, `'-'` | | Minus glyph for locale-derived table formats; default Unicode minus. |
62
63
  | locale.weekStartsOn | number | `0`, `1` | | First weekday for week-granularity date ticks; default Monday. Line date ticks read this field, other layouts ignore it and report it. |
63
64
  | strings | object | | | Wording of built-in labels. These are the labels the renderer composes itself: author chart text stays unchanged and an explicit option still wins per label; host-level wording comes from the theme provider. |
@@ -67,7 +68,7 @@ Every chart type accepts these options unless its own page names them as not acc
67
68
  | strings.cohortFormula | string | | | Complete cohort formula sentence for method notes and accessible descriptions. Wording only: rates still use the count and denominator selected by basis. |
68
69
  | strings.others | string | | | Name of the aggregated rest bucket; default Others, and an explicit topN.restLabel still wins. |
69
70
  | strings.total | string | | | Label of a computed total row; default Total. |
70
- | strings.source | string | | | Word introducing the authored source credit; default Source. |
71
+ | strings.source | string | | | Word introducing the authored source credit; default Source. An empty string prints the source without a prefix or colon. |
71
72
  | strings.notApplicable | string | | | Not applicable text; n/a, German k. A. |
72
73
  | strings.legendCount | string | | | Legend disclosure wording; '{count}' becomes "2 of 4". Default depends on the legend subject. |
73
74
  | strings.partial | string | | | Word after the labels of partial categories in the column, bar, line and combo footnote, also the hatch key label; default Partial; a named key uses toDate. |
@@ -140,7 +141,7 @@ Every chart type accepts these options unless its own page names them as not acc
140
141
  | strings.heatAround | string | | | Key label of the warn band of a table's traffic-light heat lane; default Around average, or Around total. |
141
142
  | strings.heatAbove | string | | | Key label of the good side of a table's traffic-light heat lane; default Above average, or Above total. |
142
143
  | strings.bandKey | array | | | Words of the bullet worse-to-better band key, worst first, one for each band (2 to 5). A list of another length than the bands keeps the built-in words (Worse ... Better; German with locale.language de). |
143
- | strings.moreListed | string | | | Last item of a capped note line; '{count}' is the number left out. Default 'and {count} more'; a React chart with hover on reads 'and {count} more (hover shows each value)' unless this is set. |
144
+ | strings.moreListed | string | | | Last item of a capped note line; '{count}' is the number left out. Default 'and {count} more'; a React chart with hover on reads 'and {count} more (tap or hover shows each value)' unless this is set. |
144
145
  | strings.cellNote | string | | | Waffle note that names the share of one cell; '{value}' becomes the percent, such as 5%. Default 'One cell = {value}'. |
145
146
  | strings.storyBack | string | | | Story Back button; default '‹ Back'. |
146
147
  | strings.storyNext | string | | | Story Next button; default 'Next ›'. |
@@ -172,9 +173,9 @@ Every chart type accepts these options unless its own page names them as not acc
172
173
  | strings.missingStack | string | | | StackedArea source-null note; {categories} is replaced. |
173
174
  | strings.incompleteStacks | string | | | Incomplete bar stack note (bar only; column and combo use knownPartsTotals); {categories} is replaced. |
174
175
  | strings.knownPartsShares | string | | | Incomplete 100% stack note without total100; {categories} is replaced. |
175
- | strings.rebaseZero | string | | | Line or stacked-area series left out by rebase100 for a zero base; {series} and {period} are replaced. |
176
+ | strings.rebaseZero | string | | | Line or stacked-area series left out by rebase100 for a zero or negative base; {series} and {period} are replaced. |
176
177
  | strings.rebaseMissing | string | | | Line or stacked-area series left out by rebase100 for a missing base; {series} and {period} are replaced. |
177
- | format | string | | | Chart-level format-by-example, such as 1,234.5 or 1.2pp. A currency sign comes from here: '$1,234' prints $2,456. Its decimals are preserved; series and cell formats can override it. Without a format, precision follows the data. A magnitude after the number divides the raw value: k, thousand, Tsd., Tausend (10³); m, M, mn, mm, million(s), Mio., Million(en) (10⁶); b, B, bn, billion(s), Mrd., Milliarde(n), milliard(s) (10⁹); T glued to the number, tn, trillion(s), Bio., Billionen (10¹²). A value of 1000 or more in a scale rolls up and one that would print as 0 rolls down, in the example's spelling; a German or French chart prints its own words (Mrd., Bio.; Md, Bn). A % example expects values in percent units: 3.53 prints 3.53%, a fraction 0.0353 prints 0.04%. A separator followed by exactly three digits after a nonzero integer part is a thousands mark: 1.000 groups thousands with a dot and prints decimals with a comma; write 0.000 for three decimals. |
178
+ | format | string | | | Chart-level format-by-example, such as 1,234.5 or 1.2pp. A currency sign comes from here: '$1,234' prints $2,456. Its decimals are preserved; series and cell formats can override it. Without a format, precision follows the data. A magnitude after the number divides the raw value: k, thousand, Tsd., Tausend (10³); m, M, mn, mm, million(s), Mio., Million(en) (10⁶); b, B, bn, billion(s), Mrd., Milliarde(n), milliard(s) (10⁹); tn, trillion(s), Bio., Billionen (10¹²). The letters k, m, M, mm, b, B and T scale when glued to the number or spaced beside a currency ('$1.2 k'); '12 m/s' and '50 B' keep their unit. A scale inside a currency affix ('USDm 1.2', '1.2 €m') holds that divisor. A value of 1000 or more in a free scale rolls up and one that would print as 0 rolls down, in the example's spelling; a German or French chart prints its own words (Mrd., Bio.; Md, Bn). A unit alone ('$M', '€bn', '%', 'x') picks precision from the data. Spreadsheet number codes translate to examples with warning format-spreadsheet-code; percent values stay percent points. Direction glyphs (▲/▼, ↑/↓) at the start or end of the example carry a sign. A glyph inside the prefix or unit stays literal text. ± carries a sign. A trailing minus marks negatives, '1st' prints English ordinals, and '1.2E+06' prints scientific notation. With no digit, one run of 1–15 @ fixes significant figures: '$@@@M' prints 4,270,000 as $4.27M. A % example expects values in percent units: 3.53 prints 3.53%, a fraction 0.0353 prints 0.04%. A separator followed by exactly three digits after a nonzero integer part is a thousands mark: 1.000 groups thousands with a dot and prints decimals with a comma; write 0.000 for three decimals. |
178
179
  | detailFields | array | | | Label, format, unit and order of the cell details keys, the extra facts a value's hover card lists after it: [{ key: 'deals', label: 'Deals', format: '1,234' }]. Declared keys print first, in this order; a details key it does not declare prints after them, labelled with its key. Default: every key, labelled with itself. |
179
180
  | detailFields[].key | string | | | The details key in the cells. |
180
181
  | detailFields[].label | string | | | Label on the hover card; default the key. |
@@ -183,29 +184,29 @@ Every chart type accepts these options unless its own page names them as not acc
183
184
  | smallValues | string | `'bound'`, `'zero'`, `'scientific'`, `'p-value'` | | How an automatic number format prints a nonzero value below its last shown digit. Without a format, each table column and chart series takes one precision from its largest value: two significant digits below 1, at most 4 decimals. bound (default): the bound, <0.01 at two decimals, >−0.01 below zero, <1 for whole numbers; a signed change label keeps its sign, <+0.01; below 0.0001 a value prints in scientific form instead. zero: spreadsheet style, the format's own 0.00. scientific: two significant digits and a power of ten, 1.2 × 10⁻⁹. p-value: every value from 0 to 1 prints as APA 7 writes a p-value, three decimals without the leading zero, .042, and <.001 below; larger values keep the rule above. A format the author sets prints as set. |
184
185
  | palette | string | | | Named identity ramp from theme color.palettes; every chart family takes its data ink from it, while good, bad and highlight stay the theme colours. |
185
186
  | labelDensity | string | `'full'`, `'smart'`, `'minimal'` | | Label selection policy, default smart. full: every value label competes for a slot, and a segment value that does not fit its segment moves outside on a leader. smart: as full, but a stacked column or combo segment value prints inside its segment or not at all (where one is wider than its column, the stacked column values step down a size, to the floor; still too wide, none prints), and a segment value drops when the segment is shorter than the label height plus 4 px padding (the label width on a horizontal bar); mekko also drops segment values in columns narrower than 24 px. A labelPlacements pin keeps its label. minimal: keeps only the chart's essential labels (totals, endpoints, highlights). Collision suppression applies at every level. |
186
- | labels | false \| object | `false` (or another value of its type) | | Label visibility and content overrides; omission uses the selected chart policy. Unsupported chart types refuse this shared option. false turns optional labels off. An object maps a label kind (category, series, segment, point, total, grandTotal, insidePie, outsidePie, percentIndicator, restSeries, tick, axisTitle, valueLine, annotation, growth, activity, item; each chart reads its own, and a kind it does not read is refused) to true, false or content parts from absolute, percent, category and series. On a stacked column with one PY reference series, { growth: false } drops the growth arrows over the totals (↑ 6.1%) and keeps the PY ticks and their labels; { percentIndicator: false } drops the 100% marker of a 100% chart. On bar, box, column, combo, dot, line, Mekko, slope and variance, false keeps category names; { category: false } hides them. On bullet, butterfly, funnel, heatmap, pyramid and status, false keeps the row, column and stage names; on kpi it keeps the main number and the card name. Grid panels can leave category names to the grid. On a line, series false turns the series names off and point sets what each printed value shows, so { point: ['category', 'absolute'] } prints 08-16 44.7 at the point. On a stacked column or combo, { segment: ['absolute', 'percent'] } prints each segment value over its share of the stack; a stack with a negative or missing part prints the value alone and warns. restSeries sets the values of a stacked column, bar or area series whose colorRole is others: absent, they print everywhere except the dashboard target, where the hover card and the note line carry them; true prints them, false hides and notes them on every target. |
187
+ | labels | false \| object | `false` (or another value of its type) | | Label visibility and content overrides; omission uses the selected chart policy. Unsupported chart types refuse this shared option. false turns optional labels off. An object maps a label kind (category, series, segment, point, total, grandTotal, insidePie, outsidePie, percentIndicator, restSeries, tick, axisTitle, valueLine, annotation, growth, activity, item; each chart reads its own, and a kind it does not read is refused) to true, false or content parts from absolute, percent, category and series. Another part is dropped with a warning; value draws as absolute. On a stacked column with one PY reference series, { growth: false } drops the growth arrows over the totals (↑ 6.1%) and keeps the PY ticks and their labels; { percentIndicator: false } drops the 100% marker of a 100% chart. On bar, box, column, combo, dot, line, Mekko, slope and variance, false keeps category names; { category: false } hides them. On bullet, butterfly, funnel, heatmap, pyramid and status, false keeps the row, column and stage names; on kpi it keeps the main number and the card name. Grid panels can leave category names to the grid. On a line, series false turns the series names off and point sets what each printed value shows, so { point: ['category', 'absolute'] } prints 08-16 44.7 at the point. On a stacked column or combo, { segment: ['absolute', 'percent'] } prints each segment value over its share of the stack; a stack with a negative or missing part prints the value alone and warns. restSeries sets the values of a stacked column, bar or area series whose colorRole is others: absent, they print everywhere except the dashboard target, where the hover card and the note line carry them; true prints them, false hides and notes them on every target. |
187
188
  | categoryLabels | string | `'axis'`, `'staircase'` | | Where category names go: 'axis' (default), the row under the axis; 'staircase', each name over the lower columns beside its own, one step lower than the last, with a vertical leader to its column (column, combo, pareto). Without a seat for every name the row returns and staircase-labels-fallback warns. |
188
189
  | labelPlacements | object | | | Authored placement pins keyed by label id; the solver checks each requested slot. On a line, a pinned end label removes the legend step of the end-label ladder. The slots a label can take depend on the chart and its data; a wrong slot warns unknown-slot and lists the valid and free slots of that render. |
189
- | legend | string \| object | `'top'`, `'bottom'`, `'none'`, `'auto'` (or another value of its type) | | A key without a named position sits in one row above the plot, flush with it, under the subtitle; more items wrap to further rows and move the plot down. 'bottom' puts the row under the plot. 'right' is refused: a key beside the plot takes the plot's width. 'auto' adds keys when visible labels do not name every drawn series. A displayed subtitle measure or unit can name one primary series, matching the complete phrase without case sensitivity. Required explanatory keys remain, except the keys of a table, heatmap, cohort and variance, which 'none' drops for a host that draws its own. Automatic keys use footnote type in the top row. Explicit settings override theme.legend.auto, which defaults to false. Multi-series column, bar, combo, dot and scatter charts add a key when direct names are missing. A series key explains its scenario styling. Grids keep a required key under 'none' when direct names are incomplete. |
190
- | legend.position | string | `'top'`, `'bottom'` | | Key position: 'top', one row above the plot, or 'bottom'. A key beside the plot ('right') is refused. |
190
+ | legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | A key without a named position sits in one row above the plot, flush with it, under the subtitle; more items wrap to further rows and move the plot down. 'bottom' puts the row under the plot. 'right' and 'left' put the key in a column beside the plot where the plot block keeps at least 68% of the chart width and the column fits the height; otherwise the key stays in the row above the plot and a legend-side-fallback warning says so. 'auto' adds keys when visible labels do not name every drawn series. A displayed subtitle measure or unit can name one primary series, matching the complete phrase without case sensitivity. Required explanatory keys remain, except the keys of a table, heatmap, cohort and variance, which 'none' drops for a host that draws its own. Automatic keys use footnote type in the top row. Explicit settings override theme.legend.auto, which defaults to false. Multi-series column, bar, combo, dot and scatter charts add a key when direct names are missing. A series key explains its scenario styling. Grids keep a required key under 'none' when direct names are incomplete. |
191
+ | legend.position | string | `'top'`, `'bottom'`, `'right'`, `'left'` | | Key position: 'top', one row above the plot, 'bottom', one row under it, or 'right' or 'left', a column beside the plot. A column beside the plot takes the plot's width: where the plot block would keep under 68% of the chart width, or the column does not fit the height, the key goes to the row above the plot with a legend-side-fallback warning. |
191
192
  | legend.order | array | | | Legend item ids in the requested order; unspecified items follow. |
192
193
  | valueAxis | object | | | Value-axis display and domain settings; each chart schema narrows the supported fields. |
193
194
  | valueAxis.show | boolean | | | Draw the value axis with its ticks. Default: shown unless every value is labelled; true keeps it beside the labels, false hides it. |
194
195
  | valueAxis.min | number | | | Requested lower domain bound; chart data can widen it to avoid clipping values. |
195
196
  | valueAxis.max | number | | | Requested upper domain bound; chart data can widen it to avoid clipping values. |
196
- | valueAxis.tickStep | number | | | Requested positive tick step. Line and column draw their ticks at the step and snap the domain out to it, never cutting data; box ignores it with a warning, and every other type refuses it because it picks a readable step from the data. |
197
+ | valueAxis.tickStep | number | | | Positive linear value-axis tick step. Ticks stand at multiples of the step and the domain extends to the next multiples without cutting data. Dot keeps its domain ends when at least two multiples fit inside. Steps giving fewer than 1 or more than 20 intervals use nice ticks and warn tick-step-ignored. Scatter applies it to Y only and warns on a log Y axis. Box ignores it with a warning; pareto and types without independent value-axis ticks refuse it. |
197
198
  | valueAxis.includeZero | boolean | | | Include zero in the value domain; zero-based marks can require it even when false. |
198
199
  | valueAxis.percent | boolean | | | Request the chart percent-axis or percentage presentation where supported; meanings and support follow the chart-specific schema. |
199
- | valueAxis.log | boolean \| string | `'x'`, `'y'`, `'both'` (or another value of its type) | | Scatter only: a log10 scale on the horizontal axis ('x'), the vertical axis ('y', also true) or both. Ticks print plain numbers in the chart format at both ends and at 1, 2 and 5 of each decade (3, 4, 6 and 8 too under one decade), down to the decades alone where labels would touch, and the domain ends on the nearest round number past the data, never on a decade the data does not reach. Every value on a log axis must be above zero: a point, cut point, zone, value line, clamp or view bound at or below zero is refused with its path. Every other type refuses the key. |
200
+ | valueAxis.log | boolean \| string | `'x'`, `'y'`, `'both'` (or another value of its type) | | A log10 scale on scatter and line. Scatter takes 'x', 'y', 'both' or true; line takes 'y' or true on its vertical axis. Ticks print numbers in the chart format at 1, 2 and 5 of each decade (3, 4, 6 and 8 too under one decade), down to the decades alone where labels would touch. Without authored bounds the domain normally ends on the nearest round number past the data. Every value on a log axis must be above zero. Line area and bump variants, percent, trend and phases cannot use a log axis. |
200
201
  | valueAxis.reverse | boolean | | | Reverse the value-axis direction on line and scatter; box ignores it with a warning, and every other type refuses it. |
201
202
  | valueAxis.gridlines | boolean | | | Show value-axis gridlines where supported; default false. |
202
- | valueAxis.break | string \| false \| object | `'auto'`, `false` (or another value of its type) | | No break by default or with false. Waterfall and pvm alone accept 'auto' to choose a safe break; { from, to, style? } sets the omitted span. A valid straight break uses a fixed 12px gap and discloses the omitted range. Totals and levels stay visibly longer than smaller steps or segments and no shorter than equal ones. Unsafe automatic breaks move down when valid; unsafe authored breaks are ignored with a warning. An unbroken positive bridge gets an info hint when its smallest total divided by its largest step exceeds 10. |
203
+ | valueAxis.break | string \| false \| object | `'auto'`, `false` (or another value of its type) | | No break by default or with false. Waterfall and pvm alone accept 'auto' to choose a safe break; pvm defaults to 'auto' when its smaller total exceeds 10 times its largest step or its running levels span under 20% of the larger total; { from, to, style? } sets the omitted span. A valid straight break uses a fixed 12px gap and discloses the omitted range. Totals and levels stay visibly longer than smaller steps or segments and no shorter than equal ones. Unsafe automatic breaks move down when valid; unsafe authored breaks are ignored with a warning. An unbroken positive bridge gets an info hint when its smallest total divided by its largest step exceeds 10. |
203
204
  | valueAxis.break.from | number | | | Lower value bounding the omitted domain span. |
204
205
  | valueAxis.break.to | number | | | Upper value bounding the omitted domain span. |
205
206
  | valueAxis.break.style | string | `'straight'` | | Break glyph style: 'straight'. |
206
- | categoryAxis | object | | | Category-axis settings implemented by line charts; other shared-base charts refuse this option. |
207
- | categoryAxis.crossesBetween | boolean | | | Line-chart category placement: default true centres categories in bands; false places the end categories at the plot edges. |
208
- | categoryAxis.dateTicks | string | `'years'`, `'quarters'`, `'months'`, `'weeks'`, `'days'` | | Line-chart date tick interval. A short tick under the plot marks the first category of each calendar interval. 'years', 'quarters' and 'months' name those ticks on the calendar: quarters read Jan, Apr, Jul, Oct. A row too narrow for every name keeps a larger round step counted from January (years 2, 5, 10, 20, 25, 50 or 100, so every tenth year from 1980; quarters 2, 4, 8, 20 or 40; months 2, 3, 6, 12, 24, 60 or 120), at most eight names. The latest period is always named; if it collides with the tick before it, that tick drops. 'weeks' and 'days' count equal steps back from the latest period (weeks 2, 4, 13, 26 or 52; days 2, 7, 14 or 28) and name it too. 'years' names the year alone ('Jan 1980' reads 1980) where the label carries it. 'months' over day dates the engine labels names the month ('1 Apr 2025' reads Apr 2025, then May, Jun). A monthly series through July 2026 with 'years' reads 1980, 1990, 2000, 2010, 2020, Jul 2026. Without dateTicks, column, stacked column, line, area and combo pick tick months by the same calendar rule for rows of months and quarters (step 3: Jan, Apr, Jul, Oct; step 6: Jan, Jul; step 12: Jan; plus the latest period) and count back from the latest period for days and weeks, so side-by-side panels with the same categories show the same months. A line or area day row that would step past 28 days names months as 'months' does. Categories without an ISO date leave the option unused and report date-ticks-unsupported. |
207
+ | categoryAxis | object | | | Category-axis settings: dateTicks on line, column and combo, crossesBetween on line; other shared-base charts ignore this option with an option-ignored warning. |
208
+ | categoryAxis.crossesBetween | boolean | | | Line-chart category placement: default true centres categories in bands; false places the end categories at the plot edges. Column and combo always centre their categories in bands: false is ignored there and reports cross-between-ignored. |
209
+ | categoryAxis.dateTicks | string | `'years'`, `'quarters'`, `'months'`, `'weeks'`, `'days'` | | Date tick interval on line, column and combo. A short tick under the plot marks the first category of each calendar interval; on column and combo it stands at the middle of the band, and every column keeps its place. 'years', 'quarters' and 'months' name those ticks on the calendar: quarters read Jan, Apr, Jul, Oct. A row too narrow for every name keeps a larger round step counted from January (years 2, 5, 10, 20, 25, 50 or 100, so every tenth year from 1980; quarters 2, 4, 8, 20 or 40; months 2, 3, 6, 12, 24, 60 or 120), at most eight names. The latest period is always named; if it collides with the tick before it, that tick drops. 'weeks' and 'days' count equal steps back from the latest period (weeks 2, 4, 13, 26 or 52; days 2, 7, 14 or 28) and name it too. 'years' names the year alone ('Jan 1980' reads 1980) where the label carries it. 'months' over day dates the engine labels names the month ('1 Apr 2025' reads Apr 2025, then May, Jun). A monthly series through July 2026 with 'years' reads 1980, 1990, 2000, 2010, 2020, Jul 2026. Without dateTicks, column, stacked column, line, area and combo pick tick months by the same calendar rule for rows of months and quarters (step 3: Jan, Apr, Jul, Oct; step 6: Jan, Jul; step 12: Jan; plus the latest period) and count back from the latest period for days and weeks, so side-by-side panels with the same categories show the same months. A line or area day row that would step past 28 days names months as 'months' does. Categories without an ISO date, or not in date order (sorted by value), leave the option unused and report date-ticks-unsupported. |
209
210
  | secondaryAxis | object | | | Opt in to a second value scale on supported charts; combo adds chart-specific secondary-axis options. |
210
211
  | secondaryAxis.acknowledge | true | `true` | | Explicitly acknowledge that the chart uses an independent second value scale. |
211
212
  | scaleGroup | object | | | Scale-group identities for panel composition. Charts of one envelope that name the same y group draw on one domain, and a chart that cannot join (another unit, no numeric y scale) refuses the request. A chart alone in its group, or a single chart, keeps its own scale for the host to share. x is refused: no chart type shares an x scale. |
@@ -213,12 +214,12 @@ Every chart type accepts these options unless its own page names them as not acc
213
214
  | scaleGroup.id | string | | | Stable member id inside the scale group declared on the host ScaleGroup; reordering or removing cards does not change which member this chart is. |
214
215
  | rowLabels | object | | | Row-label alignment for the horizontal families (bar, bullet, box, dot, likert). |
215
216
  | rowLabels.align | string | `'left'`, `'right'` | | Row-label alignment on a horizontal category axis; defaults to 'left' (one shared left edge), and to 'right' on a dot chart. 'right' pushes each label block against the plot. |
216
- | sort | object | | | Sorting requests for charts that support them; omitted settings preserve the chart default ordering. |
217
+ | sort | object \| string \| true | `'sheet'`, `'asc'`, `'desc'`, `'reverse'`, `true` (or another value of its type) | | A string sets categories to sheet, asc, desc or reverse. true means categories: 'desc'. Sorting requests for charts that support them; omitted settings preserve the chart default ordering. |
217
218
  | sort.categories | string | `'sheet'`, `'asc'`, `'desc'`, `'reverse'` | | Category order: sheet preserves authored order, reverse reverses it, asc and desc use the chart category ranking value. |
218
219
  | sort.segments | string | `'sheet'`, `'asc'`, `'desc'`, `'reverse'` | | Segment order: sheet preserves authored order, reverse reverses it, asc and desc use the chart segment ranking value. |
219
- | topN | object | | | Chart-specific Top-N selection and rest aggregation; omission retains all categories. On a choropleth world map, topN.n picks the n regions it labels, largest absolute value first; other maps label every region. |
220
+ | topN | object \| integer | | | A positive integer n means { n }. Chart-specific Top-N selection and rest aggregation; omission retains all categories. On a choropleth world map, topN.n picks the n regions it labels, largest absolute value first; other maps label every region. |
220
221
  | topN.n | integer | | | Maximum number of individually retained categories after chart-specific ranking. |
221
- | topN.rest | boolean | | | Aggregate remaining categories into a rest bucket by default; false omits them where supported. Pareto retains the bucket to preserve its population. |
222
+ | topN.rest | boolean | | | Aggregate remaining categories into a rest bucket by default; false omits them where supported. On a bar mekko the rest bucket is the width-weighted mean of its rates. Pareto retains the bucket to preserve its population. |
222
223
  | topN.restLabel | string | | | Authored rest-bucket name; ordinary charts default to Others and Pareto to Rest. |
223
224
  | topN.showRestCount | boolean | | | Append the number of aggregated categories; ordinary charts default to false, while Pareto always discloses the count. |
224
225
  | topN.threshold | number | | | Bar-chart minimum absolute category total after the rank cut; not a universal Top-N threshold. Pareto warns that it ignores this field. |
@@ -242,19 +243,20 @@ Every chart type accepts these options unless its own page names them as not acc
242
243
  | focus.owner.rowId | string | | | Source table row identity. |
243
244
  | focus.owner.colId | string | | | Source table column identity. |
244
245
  | hatchStrength | number | | | How strongly forecast, partial-period and no-data hatches draw, 0 to 100; 100 is the theme's recipe. Lower values fade the stripes toward their ground and, on a line or area forecast, spread them up to 2.5 times the theme's gap. The fade stops at a floor: where the hatch is the only cue (a forecast column or bar, a partial period, a no-data cell) the stripes keep 3:1 on their ground and their spacing; on a line or area forecast, where the dashed line, the divider and the key already mark the forecast, they keep 2:1. A status cell lays its stripes on its own tone: there 60 is the theme's recipe at 3:1, 100 deepens the stripes to 4.5:1 on the same ground, and lower values fade them only as far as the cell stays apart from a cell with no status. Default 60 on a line or area forecast and a status cell, 100 elsewhere. The key swatch draws the same hatch. |
245
- | colorblindSafe | boolean | | | Paint the semantic good/bad pair from theme.color.colorblind, a pair told apart without red and green: signed bars and columns, variance bars, status cells, heatmap valence cells, table tones, heat grounds, in-cell bars and badges, and the poles of a diverging choropleth or tilemap scale. Other types refuse this option. Use palette for categorical colours. |
246
+ | colorblindSafe | boolean | | | Paint the semantic good/bad pair from theme.color.colorblind: signed bars and columns, variance bars, KPI deltas, chips and bands, waterfall and pvm steps, legend keys and signed labels, status cells, heatmap valence cells, table tones, grounds, bars and badges, and diverging choropleth or tilemap poles. A type without a good/bad pair draws the same with or without this option. Use palette for categorical colours. |
246
247
  | rounding | string | `'nearest'`, `'sum-consistent'` | | How computed shares print. nearest rounds each share separately. sum-consistent uses largest remainders to total 100%. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. reading.rounding lists changes. Use format: 1.0% for one decimal. Mekko cell, series and chart share formats set the precision. Bar, column and combo stacks default to sum-consistent for each complete stack; a column's shares keep the chart's one share precision or shareLabels.format. Incompatible precisions or more than 13 decimals warn and keep the requested formats without sum-consistent rounding. |
247
- | animate | boolean | | | Reserved motion flag; registered charts currently refuse it because the engine emits static geometry. |
248
+ | animate | boolean | | | Motion flag ignored with an option-ignored warning because charts emit static geometry. |
248
249
  | interactive | boolean | | | Emit data-bp-* semantics for dependency-free web interactivity; static output is unchanged by default. |
249
- | debug | boolean | | | Reserved layout debug flag; registered charts refuse it. |
250
+ | debug | boolean | | | Layout debug flag ignored with an option-ignored warning. |
250
251
  | annotations | array | | | Data-bound annotations in authored order; explicit ids must be unique and each chart advertises its supported kinds. |
251
- | annotations[].kind (annotations[] branch 1) | string | `'diff'`, `'cagr'`, `'delta'`, `'abs'`, `'note'`, `'callout'`, `'valueLine'`, `'indicator100'`, `'event'` | | Annotation operation; its anchors and additional fields are checked by the chart annotation pass. |
252
+ | annotations[].kind (annotations[] branch 1) | string | `'diff'`, `'cagr'`, `'delta'`, `'bracket'`, `'abs'`, `'note'`, `'callout'`, `'valueLine'`, `'indicator100'`, `'event'` | | Annotation operation; its anchors and additional fields are checked by the chart annotation pass. |
252
253
  | annotations[].id (annotations[] branch 1) | string | | | Stable annotation identity; omission generates an id from kind and authored order. |
253
- | annotations[].text (annotations[] branch 1) | string | | | Authored annotation text; refused on valueLine, which prints label, and on indicator100. ${value} prints the computed number in it: a cagr's rate with its suffix, a diff's change, a delta's difference, the anchored value of an abs, note or callout. Without ${value}, text on a cagr, diff, delta or abs replaces the number, warns annotation-authored-override and the claim record marks the override. |
254
+ | annotations[].text (annotations[] branch 1) | string | | | Authored annotation text; on valueLine, text is read as label with an info warning when label is absent or equal. Refused on indicator100. ${value} prints the computed number in it: a cagr's rate with its suffix, a diff's change, a delta's difference, the anchored value of an abs, note or callout; a note or callout on a mark that prints the same number leaves it to the mark and reports annotation-value-on-mark. Without ${value}, text on a cagr, diff, delta or abs replaces the number, warns annotation-authored-override and the claim record marks the override. |
254
255
  | annotations[].format (annotations[] branch 1) | string | | | Number format: annotation > anchored series > chart. Diff uses to, then from. CAGR and relative/reversed diff need a percent example; value differences use pp for percent levels. Refused on event and indicator100. |
255
256
  | annotations[].priority (annotations[] branch 1) | number | | | Annotation label priority during collision resolution. |
256
- | annotations[].icon (annotations[] branch 1) | string | `'alert'`, `'calendar'`, `'check'`, `'conversation'`, `'document'`, `'flag'`, `'gear'`, `'lightbulb'`, `'people'`, `'star'`, `'target'`, `'workflow'` | | Registered icon for note or callout annotations; cannot be combined with status. |
257
+ | annotations[].icon (annotations[] branch 1) | string | `'alert'`, `'calendar'`, `'check'`, `'conversation'`, `'document'`, `'flag'`, `'gear'`, `'lightbulb'`, `'lock'`, `'people'`, `'star'`, `'target'`, `'workflow'` | | Registered icon for note or callout annotations; cannot be combined with status. |
257
258
  | annotations[].status (annotations[] branch 1) | string | `'good'`, `'bad'`, `'warn'`, `'info'` | | Semantic status glyph for a note or callout; cannot be combined with icon. |
259
+ | annotations[].shape (annotations[] branch 1) | string | `'bracket'`, `'arrow'` | | A cagr's form: 'bracket', the default, runs over the marks, and 'arrow' is one straight arrow with the rate in an oval on it. |
258
260
  | annotations[].kind (annotations[] branch 2) | string | `'band'` | | Era band spanning inclusive category ids, or a value-axis plan corridor, tolerance band or attainment fill. |
259
261
  | annotations[].id (annotations[] branch 2) | string | | | Stable band annotation identity; omission generates an id from kind and authored order. |
260
262
  | annotations[].text (annotations[] branch 2) | string | | | Shared annotation text override; band captions use label. |
@@ -270,7 +272,7 @@ Every chart type accepts these options unless its own page names them as not acc
270
272
  | annotations[].high (annotations[] branch 2) | number | | | Upper value-axis bound for corridor and tolerance bands. |
271
273
  | annotations[].value (annotations[] branch 2) | number | | | Plan value for attainment shading; actuals are resolved per category. |
272
274
  | annotations[].seriesId (annotations[] branch 2) | string | | | Series whose actuals are shaded for attainment; omission uses the category total. |
273
- | annotations[].scenario (annotations[] branch 2) | string | `'AC'`, `'PY'`, `'PL'`, `'FC'` | | Scenario notation for a plan corridor; default PL. |
275
+ | annotations[].scenario (annotations[] branch 2) | string | `'AC'`, `'PY'`, `'PL'`, `'FC'` | | Scenario notation for a plan corridor; default PL. LY means PY (last year); codes accept any case. |
274
276
  | annotations[].direction (annotations[] branch 2) | string | `'higherIsBetter'`, `'lowerIsBetter'` | | Whether exceeding the plan is favorable for attainment shading; default higherIsBetter. |
275
277
 
276
278
  Set `locale.decimal` (and optionally `locale.thousands`) to choose the marks of every number in the chart, as in a spreadsheet. The default is `1,234.5` in every language; `locale.language` changes words only, never the marks. Format examples give only the shape; `1.2%` and `1,2 %` both mean one decimal; `1,2 %` keeps its space and prints `1.2 %` by default.
@@ -299,7 +301,7 @@ The keys of `labels` each type reads. A type refuses a key it does not read as `
299
301
  | `restSeries` | [bar](bar.md), [column](column.md), [line](line.md) |
300
302
  | `segment` | [bar](bar.md), [column](column.md), [combo](combo.md), [funnel](funnel.md), [likert](likert.md), [mekko](mekko.md) |
301
303
  | `series` | [butterfly](butterfly.md), [cohort](cohort.md), [heatmap](heatmap.md), [line](line.md), [pyramid](pyramid.md), [slope](slope.md), [status](status.md) |
302
- | `tick` | [bar](bar.md), [column](column.md), [combo](combo.md) |
304
+ | `tick` | [bar](bar.md), [butterfly](butterfly.md), [column](column.md), [combo](combo.md) |
303
305
  | `total` | [funnel](funnel.md), [kpi](kpi.md), [mekko](mekko.md), [pie](pie.md), [variance](variance.md) |
304
306
  | `value` | [scatter](scatter.md) |
305
307
  | `valueLine` | [bar](bar.md), [column](column.md), [gantt](gantt.md) |
@@ -49,15 +49,15 @@ One form; its chart ID is `pareto`.
49
49
  | Path | Type | Values | Default | Meaning |
50
50
  |---|---|---|---|---|
51
51
  | categoryLabels | string | `'axis'`, `'staircase'` | | 'staircase' names each cause over the lower columns; it needs cumulative: false, as the curve climbs through that space. Default 'axis'. |
52
- | topN | object | | | Keep the n largest causes. rest: false hides only the remainder column (the folded tail, or the authored rest that holds it); its labelled curve point and the full-population total remain. |
52
+ | topN | object \| integer | | | Keep the n largest causes. rest: false hides only the remainder column (the folded tail, or the authored rest that holds it); its labelled curve point and the full-population total remain. A positive integer n means { n }. |
53
53
  | threshold | number \| false | `false` (or another value of its type) | `80` | Cumulative-share reference, default 80. A convention to choose, not a property of the data: 80 is the classic Pareto rule, 90 or 95 asks which causes carry nearly all of the total. The dashed rule is drawn at the value, and the highlighted vital few and their key follow it. false draws the curve with no reference and no vital-few split: every column in one colour, no key. |
54
54
  | cumulative | boolean | | `true` | Draw the derived cumulative curve. Default true; false also withholds the threshold rule. |
55
55
  | axisTitles | object | | | Title over the left value axis, which is drawn by default. Drawn when authored, or as 'Measure, unit' under a theme that derives value-axis titles. |
56
56
  | axisTitles.primary | string | | | Title over the left value axis. |
57
- | totalScale | boolean | | | Scale the left axis to the total: 100% on the right sits level with the total on the left, so the curve starts at the top of the first column and each column reads against the curve. Default false: the column axis is capped on the columns alone and the curve rides its own 0-100% scale. |
57
+ | totalScale | boolean | | | Scale the left axis to the total: 100% on the right sits level with the total on the left, so the curve starts at the top of the first column and each column reads against the curve. Default: on when a vital few reaches the threshold and no valueAxis.min or max is set; off for a flat distribution, whose columns would shrink to a sliver. false caps the column axis on the columns alone and the curve rides its own 0-100% scale. |
58
58
  | methodNote | boolean | | `false` | Footnotes stating the derivation and the vital-few set. Default false: the reader gets the exhibit, not a method statement. |
59
59
 
60
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.tickStep`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `sort`, `hatchStrength`, `colorblindSafe`, `rounding`.
60
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.tickStep`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `secondaryAxis`, `sort` with an `option-ignored` warning.
61
61
 
62
62
  ## Annotations
63
63
 
@@ -67,7 +67,7 @@ An annotation anchor is a category or item id string, or an object with category
67
67
  |---|---|---|---|---|---|
68
68
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
69
69
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. A thin arrow from the text to the anchored point; the first line sits level with the point, right or left of it, where there is room. Not with icon or status. Example: "arrow": true. | |
70
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
70
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
71
71
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
72
72
  | 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 | | |
73
73
 
@@ -47,7 +47,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
47
47
  | series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
48
48
  | series[].label | string | | Displayed series name; defaults to the series id. |
49
49
  | series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
50
- | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). Controls scenario labels and paint conventions. |
50
+ | series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
51
51
  | series[].role | string | | Data series or comparison-only reference series; references are excluded from the main plotted data. One of `'data'`, `'reference'`. |
52
52
  | series[].colorRole | string | | Theme color role used for a single displayed slice; multi-slice charts use the selected slice ramp. 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. |
53
53
  | series[].unit | string | | Unit shown with this series values and used to check shared-scale compatibility. |
@@ -58,14 +58,14 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
58
58
  | Path | Type | Values | Default | Meaning |
59
59
  |---|---|---|---|---|
60
60
  | labels | false \| object | `false` (or another value of its type) | | Up to four displayed slices (eight without a legend) default to named outside labels with leaders in two columns; without a legend every label names its slice at any count. Explicit inside/outside settings take priority. |
61
- | topN | object | | | Defaults to the seven largest slices plus Others, merged only when Others would hold three slices or more; an authored topN overrides the default. |
61
+ | topN | object \| integer | | | Defaults to the seven largest slices plus Others, merged only when Others would hold three slices or more; an authored topN overrides the default. A positive integer n means { n }. |
62
62
  | doughnut | number | | | Hole radius as a fraction of outer radius. Inside labels cap the hole at 0.72; centre totals include the declared unit. |
63
63
  | rotate | number | `0`, `90`, `180`, `270` | | Starting angle clockwise from 12 o'clock, in quarter turns. Defaults to 0 degrees. |
64
64
  | explode | object | | | Slice category ids mapped to outward offsets as fractions of the outer radius. |
65
- | colors | string | `'categorical'`, `'sequential'` | | Slice colour strategy. Defaults to 'categorical' for up to four nominal slices without topN/palette; otherwise 'sequential'. |
65
+ | colors | string | `'categorical'`, `'sequential'` | | Slice colour strategy. Default 'sequential': one ramp of the first series colour in slice order, the first slice strongest, at every slice count. 'categorical' gives each slice its own theme hue. A highlight keeps its accent and steps the other slices into grey. |
66
66
  | othersShade | string | `'quietest'`, `'apart'` | | Sequential ramp beside an Others slice. Without an Others slice the ramp does not change. Default 'quietest'. 'quietest': Others is the quietest part, so every named step has more contrast against the background than Others and none matches it. 'apart': named steps only differ from Others, and some may be quieter. If Others is stronger than the first named step, the ramp falls back to 'apart' and the chart warns others-shade-unavailable. |
67
67
 
68
- Plus the [shared options](options.md). This type does not accept `categoryLabels`, `valueAxis`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `bandFraction`, `hatchStrength`, `colorblindSafe`.
68
+ Plus the [shared options](options.md). This type does not accept `valueAxis`, `hatchStrength`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
69
69
 
70
70
  ## Annotations
71
71
 
@@ -73,7 +73,7 @@ An annotation anchor is a category or item id string, or an object with category
73
73
 
74
74
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
75
75
  |---|---|---|---|---|---|
76
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
76
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
77
77
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
78
78
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
79
79
  | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. A thin arrow from the text to the anchored point; the first line sits level with the point, right or left of it, where there is room. Not with icon or status. Example: "arrow": true. | |
@@ -82,8 +82,9 @@ An annotation anchor is a category or item id string, or an object with category
82
82
 
83
83
  ## Sizing
84
84
 
85
- Floor 280 × 320 px; fit `content`.
85
+ Floor 120 × 320 px; fit `content`.
86
86
  Below 320 px high, down to the compact floor of 280 × 160 px, the chart draws in compact mode; `belowMinimum: 'refuse'` refuses there instead.
87
+ Narrower than the compact floor, a pie draws while its circle keeps a radius of at least 36 px beside its labels.
87
88
 
88
89
  Below the floor a render is refused with `size-below-floor` and the pixels it needs. `measure` returns the natural and comfortable size for a given spec; see [Sizing in the manual](../manual.md#sizing).
89
90
 
@@ -111,4 +112,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
111
112
 
112
113
  ## Not for
113
114
 
114
- Negative parts; pie divides a nonnegative whole.
115
+ Negative parts; pie divides a nonnegative whole. A negative slice is not drawn and the centre total is left out.
@@ -72,8 +72,9 @@ One form; its chart ID is `pvm`.
72
72
  | interaction | string | `'in-price'`, `'separate'` | `'in-price'` | Where the price x volume interaction is booked: 'in-price' reads price at current volumes and absorbs it; 'separate' splits it into a Laspeyres price bar plus an explicit joint bar. |
73
73
  | volumeMix | string | `'split'`, `'combined'` | `'split'` | 'split' (default) draws Volume and Mix separately; the boundary between them depends on the counting unit, which methodNote: true states on the exhibit. 'combined' draws one 'Volume & mix' bar and the decomposition is then unit-invariant. |
74
74
  | methodNote | boolean | | | Default false. true adds the short convention ("volume and mix at prior prices") to the one footer line, which joins the coverage note ("Covers the 4 items in both periods") while items enter or leave the book; the coverage part prints regardless. Where Volume and Mix nearly cancel (their sum under a tenth of the larger) the convention and the counting unit print without it, since the split between them then carries the story. The long method notes are in derived, and join the notes list when notes is set. |
75
+ | netChange | boolean | | `true` | Default true. Prints the net change from the opening to the closing total, absolute and in percent, in its sign colour above the closing column. false leaves the closing column with its value only. |
75
76
 
76
- Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `categoryLabels`, `valueAxis.show`, `valueAxis.min`, `valueAxis.max`, `valueAxis.tickStep`, `valueAxis.includeZero`, `valueAxis.percent`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.gridlines`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `sort`, `topN`, `hatchStrength`, `colorblindSafe`, `rounding`.
77
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `valueAxis.min`, `valueAxis.max`, `valueAxis.tickStep`, `valueAxis.includeZero`, `valueAxis.percent`, `valueAxis.log`, `valueAxis.reverse`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
77
78
 
78
79
  ## Annotations
79
80
 
@@ -81,7 +82,7 @@ An annotation anchor is a category or item id string, or an object with category
81
82
 
82
83
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
83
84
  |---|---|---|---|---|---|
84
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
85
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
85
86
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
86
87
  | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
87
88
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
@@ -108,6 +109,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
108
109
  | revenue-bridge-method-note | example | The revenue bridge with the method notes printed |
109
110
  | revenue-bridge-notes-listed | example | The revenue bridge on a slide with its method notes in the notes list |
110
111
  | named-periods-and-ranges | torture | PVM names each period and entry or exit range |
112
+ | revenue-bridge-no-net-change | example | The revenue bridge without the net change over the closing column |
111
113
 
112
114
  ## Not for
113
115
 
@@ -60,10 +60,10 @@ One form; its chart ID is `pyramid`.
60
60
 
61
61
  | Path | Type | Values | Default | Meaning |
62
62
  |---|---|---|---|---|
63
- | basis | string | `'count'`, `'shareOfTotal'` | `'count'` | Default 'count'. 'shareOfTotal' divides by the grand total across BOTH groups and all bands — never per group, which would hide the group-size imbalance a pyramid is read for. |
63
+ | basis | string | `'count'`, `'shareOfTotal'`, `'shareOfGroup'` | `'count'` | Default 'count'. 'shareOfTotal' divides by the grand total across BOTH groups and all bands — never per group, which would hide the group-size imbalance a pyramid is read for. 'shareOfGroup' divides each side by its own total, so each side sums to 100%; 'shareOfTotal' on two groups that both carry a date draws 'shareOfGroup', because two snapshots have no common whole. |
64
64
  | methodNote | boolean | | | Default false. true adds the method footnote stating the band convention: [from, to), youngest at the bottom, equal widths. An open-ended top band and the share base are required for interpretation and print regardless. |
65
65
 
66
- Plus the [shared options](options.md). This type does not accept `detailFields`, `categoryLabels`, `valueAxis`, `categoryAxis`, `secondaryAxis`, `rowLabels`, `sort`, `topN`, `hatchStrength`, `colorblindSafe`, `rounding`.
66
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
67
67
 
68
68
  ## Annotations
69
69
 
@@ -71,7 +71,7 @@ An annotation anchor is a category or item id string, or an object with category
71
71
 
72
72
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
73
73
  |---|---|---|---|---|---|
74
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
74
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
75
75
  | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
76
76
  | 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 | | |
77
77
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
@@ -92,7 +92,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
92
92
  | workforce-tenure-gender | example | Women outnumber men below four years of tenure and are outnumbered above ten |
93
93
  | torture-pyramid-degenerate | torture | 22 bands, one empty in both groups, a 10:1 group imbalance and an open top band |
94
94
  | dated-population-comparison | example | Growth within the same age band across two observation dates |
95
- | dated-share-difference | example | An absolute difference between shares is measured in percentage points |
95
+ | dated-share-difference | example | Each snapshot is its own 100%, and a difference between shares is measured in percentage points |
96
96
 
97
97
  ## Not for
98
98