boardplot 0.56.0 → 0.58.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 (552) hide show
  1. package/CHANGELOG.md +408 -0
  2. package/README.md +49 -15
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-VGSL4NJK.js} +1 -1
  4. package/dist/{ReaderBox-GLCKYXBU.js → ReaderBox-MHMXIDAJ.js} +8 -7
  5. package/dist/{annotateEngine-QVNAE3EH.js → annotateEngine-753KQBNN.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-HZUAEMN5.js → chunk-2CQBBN7M.js} +4 -4
  8. package/dist/{chunk-K3VZ5QJK.js → chunk-2ETK5TSA.js} +4 -4
  9. package/dist/{chunk-HHXIVFAU.js → chunk-2ETSI2EL.js} +11 -9
  10. package/dist/{chunk-ECBUFKCP.js → chunk-2GRXHWRH.js} +3 -3
  11. package/dist/{chunk-ZVM5TFGR.js → chunk-2HII2B6S.js} +6 -2
  12. package/dist/{chunk-WBETBGSC.js → chunk-2LC2H3ZM.js} +1003 -907
  13. package/dist/chunk-2NX7EO7H.js +23 -0
  14. package/dist/{chunk-52WNCUIN.js → chunk-2QI2PK2O.js} +1 -1
  15. package/dist/{chunk-QWCLWFKC.js → chunk-2VKQQLP7.js} +180 -58
  16. package/dist/chunk-3DOVXJ6K.js +602 -0
  17. package/dist/{chunk-CAJ54IEP.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-MOS6WFWM.js → chunk-3HA4IJTO.js} +9 -9
  19. package/dist/{chunk-JCIXYOND.js → chunk-3HPPTQEW.js} +4 -4
  20. package/dist/{chunk-7VVHTOE7.js → chunk-3KT2647F.js} +4 -2
  21. package/dist/{chunk-O6ZTIDWB.js → chunk-3MFVJMP6.js} +3 -2
  22. package/dist/{chunk-KQCKK3LD.js → chunk-3P3FKPFN.js} +170 -73
  23. package/dist/{chunk-WI5VOSQX.js → chunk-3XAJSMYD.js} +2 -2
  24. package/dist/{chunk-CPGASWNN.js → chunk-42QKUSHJ.js} +13 -3
  25. package/dist/{chunk-QB5HV4IY.js → chunk-44JU3VOT.js} +7 -8
  26. package/dist/{chunk-BYCJ6TKI.js → chunk-44K75CYE.js} +3 -3
  27. package/dist/{chunk-MS7O3KDJ.js → chunk-4FNM4D57.js} +6 -6
  28. package/dist/{chunk-BVYIKLQ5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-3V62N3Z7.js → chunk-4VV3KUFT.js} +7 -8
  30. package/dist/{chunk-MAFPVR4G.js → chunk-54YO56IK.js} +10 -5
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-6AMN7IKJ.js → chunk-5JEU6MWC.js} +49 -28
  33. package/dist/{chunk-NCLRZQR6.js → chunk-5JIB4VJA.js} +18 -10
  34. package/dist/{chunk-SXD3OYAR.js → chunk-5OP3E2ZD.js} +205 -96
  35. package/dist/{chunk-SS4YGK3E.js → chunk-5SLBD4BT.js} +72 -304
  36. package/dist/{chunk-XMP2DNLI.js → chunk-5SVGTQTW.js} +4 -4
  37. package/dist/chunk-5U567TYU.js +23 -0
  38. package/dist/chunk-5ZLF4S7X.js +40 -0
  39. package/dist/{chunk-T2YDWT54.js → chunk-5ZMTQATF.js} +261 -147
  40. package/dist/{chunk-WXJ5MHLH.js → chunk-62BDQTO6.js} +2 -2
  41. package/dist/chunk-64K3V4VN.js +25 -0
  42. package/dist/{chunk-BK6P6KMW.js → chunk-67YJJJIB.js} +1 -1
  43. package/dist/{chunk-32LLDRPI.js → chunk-6DJNFT2K.js} +42 -32
  44. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  45. package/dist/{chunk-7STMIK2X.js → chunk-6JFQCVNN.js} +4 -4
  46. package/dist/chunk-6JXBLQJ2.js +32 -0
  47. package/dist/{chunk-5TWY3ZIC.js → chunk-6XPV6M3Q.js} +5 -5
  48. package/dist/{chunk-MPO5TVGF.js → chunk-6ZDSEITW.js} +3 -3
  49. package/dist/{chunk-75WIUG2W.js → chunk-72HVDLMT.js} +172 -78
  50. package/dist/chunk-75NU5RLX.js +24 -0
  51. package/dist/chunk-76GPN6AT.js +72 -0
  52. package/dist/chunk-7BQK2UDV.js +13 -0
  53. package/dist/{chunk-CF4NMRN7.js → chunk-7CAYRPJV.js} +45 -25
  54. package/dist/{chunk-U3A6FMSI.js → chunk-7GWWBHVQ.js} +7 -7
  55. package/dist/{chunk-CHAS5A5B.js → chunk-7NYUFMLJ.js} +149 -86
  56. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  57. package/dist/chunk-A65B23JK.js +113 -0
  58. package/dist/{chunk-4KMZAK6J.js → chunk-A7R6FUS6.js} +4 -4
  59. package/dist/{chunk-E2ZUBP4Q.js → chunk-AEVGUOPB.js} +7 -8
  60. package/dist/chunk-AHIK2N72.js +53 -0
  61. package/dist/{chunk-KLB2QC24.js → chunk-AICO24HJ.js} +5 -2
  62. package/dist/{chunk-7KSUMFBK.js → chunk-AJGSCVVW.js} +5 -1
  63. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  64. package/dist/{chunk-E7V3OHQQ.js → chunk-AN2V2LC4.js} +37 -22
  65. package/dist/{chunk-JIEVDGAF.js → chunk-AOFUA5XP.js} +1 -1
  66. package/dist/chunk-B5A7X2BA.js +44 -0
  67. package/dist/{chunk-2HTYGMMG.js → chunk-BCMEGJRX.js} +2 -2
  68. package/dist/{chunk-KD5GOR2K.js → chunk-BDIKWR45.js} +124 -69
  69. package/dist/{chunk-FNRPQIQE.js → chunk-BG6AIWAK.js} +4 -6
  70. package/dist/{chunk-ZMPH2OC4.js → chunk-BOT6W3VB.js} +7 -8
  71. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  72. package/dist/{chunk-2DOEZ5QY.js → chunk-BZ67BJBH.js} +11 -10
  73. package/dist/{chunk-UBCVBBJJ.js → chunk-C47POAC5.js} +4 -3
  74. package/dist/{chunk-O7REHICC.js → chunk-C5OBPO4Z.js} +36 -28
  75. package/dist/{chunk-IGNBQT23.js → chunk-CCAAI56H.js} +121 -10
  76. package/dist/{chunk-RPIKNMZA.js → chunk-CDUR3KWV.js} +7 -2
  77. package/dist/{chunk-MZACASZY.js → chunk-CMPHT2LS.js} +14 -2
  78. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  79. package/dist/{chunk-IVRYF7QA.js → chunk-CR5FP5SF.js} +1 -1
  80. package/dist/{chunk-DD6RVD3S.js → chunk-D2TQX7UJ.js} +5 -1
  81. package/dist/{chunk-VVXKFU72.js → chunk-DEANHDXU.js} +62 -41
  82. package/dist/{chunk-GM3EGUYW.js → chunk-DHGE46UK.js} +1 -1
  83. package/dist/{chunk-UZTQUPTB.js → chunk-DIHX6NUB.js} +5 -5
  84. package/dist/{chunk-MD6DCQMA.js → chunk-DILQ34NW.js} +37 -37
  85. package/dist/{chunk-YMTXTQCN.js → chunk-DJKRYJP7.js} +6 -6
  86. package/dist/{chunk-JCAGVAB3.js → chunk-DKLC6QLF.js} +1200 -21
  87. package/dist/{chunk-SRAV6FPB.js → chunk-DNHTMCUP.js} +3 -3
  88. package/dist/{chunk-CKGSGRP7.js → chunk-DORE2RHL.js} +21 -5
  89. package/dist/{chunk-SMHZXHHD.js → chunk-DZYTXZNS.js} +15 -5
  90. package/dist/chunk-E262NRFP.js +39 -0
  91. package/dist/{chunk-V5JQQMFQ.js → chunk-E5YF236N.js} +4 -1
  92. package/dist/{chunk-IGJ2G5C6.js → chunk-EBUK7HJP.js} +6 -6
  93. package/dist/{chunk-ZL6IHMOW.js → chunk-ECBHC272.js} +198 -119
  94. package/dist/{chunk-SA46CNMS.js → chunk-ED7GLWTF.js} +4 -1
  95. package/dist/chunk-EFW43JQJ.js +24 -0
  96. package/dist/{chunk-5P2TTHBZ.js → chunk-EHRRHSPV.js} +2 -2
  97. package/dist/{chunk-JXBZIJCG.js → chunk-EILNJQMN.js} +32 -12
  98. package/dist/{chunk-GELSK76Y.js → chunk-ERDKMZ7O.js} +3 -3
  99. package/dist/{chunk-T2CYNDYU.js → chunk-ETRAPN5G.js} +366 -130
  100. package/dist/{chunk-JEUL777U.js → chunk-ETUKDEGL.js} +21 -12
  101. package/dist/chunk-F2ET5ZTT.js +49 -0
  102. package/dist/{chunk-2YO4WRJN.js → chunk-F3XOBFS4.js} +40 -29
  103. package/dist/{chunk-SPSGUFTI.js → chunk-FB6X7QHA.js} +1 -1
  104. package/dist/{chunk-5PPQIF4D.js → chunk-FGW54I23.js} +7 -8
  105. package/dist/{chunk-JTC5SEAQ.js → chunk-FP5B5XIL.js} +7 -3
  106. package/dist/{chunk-RJGCYGC3.js → chunk-FRHQGA5Q.js} +86 -250
  107. package/dist/{chunk-YZZLIYPA.js → chunk-FRR7BJ3B.js} +5 -1
  108. package/dist/{chunk-4DZFR52I.js → chunk-FVWHEM2N.js} +7 -5
  109. package/dist/{chunk-YPYD6OJ3.js → chunk-FWSMENKH.js} +2 -2
  110. package/dist/{chunk-YYJORENB.js → chunk-FWTUGNSF.js} +8 -8
  111. package/dist/{chunk-GIHH6VC2.js → chunk-FZKDZQ6U.js} +10 -6
  112. package/dist/{chunk-S7NRL66K.js → chunk-G4FF6G3I.js} +26 -17
  113. package/dist/{chunk-PQLAZEQV.js → chunk-GB6BZSTL.js} +248 -92
  114. package/dist/chunk-GCIHRRDJ.js +24 -0
  115. package/dist/{chunk-X3KCQEYZ.js → chunk-GHCU6OSE.js} +9 -1
  116. package/dist/chunk-GKDUIDU6.js +138 -0
  117. package/dist/chunk-GO66OCN7.js +24 -0
  118. package/dist/chunk-GOFS336W.js +24 -0
  119. package/dist/{chunk-AGDDH6XY.js → chunk-GQYT7G4F.js} +5 -1
  120. package/dist/{chunk-WN3HEU3P.js → chunk-GUTLXO7Q.js} +140 -89
  121. package/dist/chunk-H3VICNTN.js +47 -0
  122. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  123. package/dist/{chunk-CB4CERXZ.js → chunk-HBQHSZ6S.js} +11 -2
  124. package/dist/chunk-HTQGJQZN.js +124 -0
  125. package/dist/{chunk-F77TMAUY.js → chunk-HUQRO6VF.js} +39 -36
  126. package/dist/{chunk-4KQHKPB3.js → chunk-I5VDW2XZ.js} +543 -509
  127. package/dist/{chunk-43GGVT7W.js → chunk-I5VNHDPR.js} +11 -4
  128. package/dist/{chunk-4LTN7SND.js → chunk-IDXYHDQY.js} +1 -1
  129. package/dist/{chunk-Y54LU4CU.js → chunk-IIWZJ5ZM.js} +1 -1
  130. package/dist/{chunk-FMDNJ6PC.js → chunk-IPBOREIY.js} +2 -2
  131. package/dist/chunk-IU335UO7.js +27 -0
  132. package/dist/{chunk-JVZTKQFS.js → chunk-IVDTP6SV.js} +9 -5
  133. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  134. package/dist/{chunk-EIL3KHAL.js → chunk-J4QRB6DQ.js} +5 -5
  135. package/dist/{chunk-3465633G.js → chunk-JCMGKQVS.js} +3 -3
  136. package/dist/{chunk-YK2KWNTU.js → chunk-JM7UTLF3.js} +28 -14
  137. package/dist/{chunk-CXETOLPX.js → chunk-JNDWRV34.js} +4 -4
  138. package/dist/{chunk-DLUNQHFO.js → chunk-JSRQTDZZ.js} +26 -24
  139. package/dist/{chunk-WTQAG2OT.js → chunk-JT3UTEWZ.js} +8 -3
  140. package/dist/{chunk-GQT2SY2S.js → chunk-JUYRDZSV.js} +291 -151
  141. package/dist/{chunk-LKMFMNQX.js → chunk-JVGL2SCN.js} +1 -1
  142. package/dist/{chunk-4JC3SE4G.js → chunk-JY4LTPOV.js} +1 -1
  143. package/dist/chunk-K7XPTQBJ.js +267 -0
  144. package/dist/{chunk-P4SMC4BY.js → chunk-KGBUXMFP.js} +120 -86
  145. package/dist/{chunk-XC5IRUEL.js → chunk-KIE5V3DA.js} +2 -2
  146. package/dist/{chunk-RT66UTLJ.js → chunk-KU4PCG4W.js} +2 -2
  147. package/dist/{chunk-VPL3JYC6.js → chunk-KVBLTAO7.js} +52 -10
  148. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  149. package/dist/{chunk-PJBEJR2U.js → chunk-KWIP5YRA.js} +24 -7
  150. package/dist/{chunk-JYBT2JNY.js → chunk-LE3LSEUL.js} +27 -2
  151. package/dist/{chunk-R2IKOLBK.js → chunk-LG6M2JTH.js} +3 -3
  152. package/dist/{chunk-DF3XEFQ7.js → chunk-LIE2WSB4.js} +21 -18
  153. package/dist/{chunk-Z55DXFWS.js → chunk-LJDATBPB.js} +26 -16
  154. package/dist/{chunk-KLIZXSBK.js → chunk-LMMS675D.js} +10 -9
  155. package/dist/{chunk-MRAP2UVV.js → chunk-LPKGZ664.js} +286 -35
  156. package/dist/{chunk-JFFREZGT.js → chunk-LPMSGO7L.js} +6 -2
  157. package/dist/chunk-LQWINE7K.js +211 -0
  158. package/dist/{chunk-6MJUW5R5.js → chunk-MKMMQDIY.js} +139 -71
  159. package/dist/{chunk-F5BYLT3M.js → chunk-MQ4IEDM5.js} +462 -138
  160. package/dist/{chunk-QGFKSDQO.js → chunk-MRM4KJ2O.js} +2 -2
  161. package/dist/{chunk-ETMHDCEH.js → chunk-MX2OZHIT.js} +102 -42
  162. package/dist/{chunk-6EYTD777.js → chunk-MXUPMGRY.js} +2 -2
  163. package/dist/{chunk-2FKEF2AC.js → chunk-NHU26HQ7.js} +58 -35
  164. package/dist/{chunk-KBJMLXNW.js → chunk-NQVJ4FPY.js} +161 -78
  165. package/dist/chunk-NZ7FX3AE.js +65 -0
  166. package/dist/chunk-OALBVELJ.js +23 -0
  167. package/dist/{chunk-5S3JQ5AT.js → chunk-OGZ4UPYK.js} +183 -137
  168. package/dist/{chunk-6WHWXCHJ.js → chunk-OMNB27GM.js} +7 -3
  169. package/dist/{chunk-EGGDPDYJ.js → chunk-OO63YP35.js} +1 -1
  170. package/dist/{chunk-ZYQYX66L.js → chunk-OPYDTW5Q.js} +6 -6
  171. package/dist/{chunk-A2GAWGVJ.js → chunk-OSJN7KDS.js} +68 -39
  172. package/dist/{chunk-RMC4OONA.js → chunk-OSJXIW6I.js} +1030 -1123
  173. package/dist/{chunk-X23SZHV5.js → chunk-OVVE42P4.js} +6 -6
  174. package/dist/{chunk-CCJP6QZO.js → chunk-OZA7HA6L.js} +1 -1
  175. package/dist/chunk-OZLKEBCD.js +54 -0
  176. package/dist/{chunk-TE4M52AA.js → chunk-P6DEFCMQ.js} +18 -2
  177. package/dist/{chunk-AMR4SUAN.js → chunk-PDTIQL3B.js} +6 -6
  178. package/dist/{chunk-BIVL764T.js → chunk-PJ5BYZPN.js} +2 -2
  179. package/dist/{chunk-BISJK67O.js → chunk-PK7Z7WRJ.js} +98 -46
  180. package/dist/{chunk-7VMEM3LN.js → chunk-PL6NWB5U.js} +178 -113
  181. package/dist/chunk-PMT75APP.js +94 -0
  182. package/dist/chunk-PP6A4X55.js +11 -0
  183. package/dist/{chunk-I7H5DU34.js → chunk-PPCH3PLO.js} +25 -13
  184. package/dist/{chunk-BIGQKCU7.js → chunk-PPE6S7WU.js} +42 -24
  185. package/dist/{chunk-2NSQIPAA.js → chunk-PT7KSIEO.js} +23 -36
  186. package/dist/{chunk-KZJ5VM6E.js → chunk-PZ3TQFSY.js} +15 -1
  187. package/dist/{chunk-ZJFJ2IKQ.js → chunk-QAUGRVRU.js} +122 -23
  188. package/dist/{chunk-BTDGWHGJ.js → chunk-QMFWZG2P.js} +39 -19
  189. package/dist/{chunk-L6YVK6VC.js → chunk-QZGGCE45.js} +2 -2
  190. package/dist/{chunk-67QSW5RW.js → chunk-R2RJQ3BM.js} +4 -4
  191. package/dist/{chunk-ZY72LSQK.js → chunk-R7HBIQ63.js} +102 -61
  192. package/dist/{chunk-4JHMCXOB.js → chunk-RBNDZLYS.js} +77 -36
  193. package/dist/chunk-RCSY4CT4.js +2170 -0
  194. package/dist/{chunk-NGA7ICG4.js → chunk-RDJ3ZU6O.js} +16 -13
  195. package/dist/{chunk-2NN676RI.js → chunk-RHQRPJHS.js} +7 -8
  196. package/dist/chunk-RI6XQKWJ.js +26 -0
  197. package/dist/{chunk-YOOHNQ3L.js → chunk-RJICOOB3.js} +18 -8
  198. package/dist/{chunk-5DTCOOLU.js → chunk-RLAVNCQJ.js} +2 -2
  199. package/dist/{chunk-CYKXROFG.js → chunk-ROPPWJQB.js} +23 -12
  200. package/dist/{chunk-54ROMBU7.js → chunk-SELOV32X.js} +105 -50
  201. package/dist/{chunk-TUW5IYGA.js → chunk-SQI4NWTQ.js} +9 -9
  202. package/dist/{chunk-ZEYBI47P.js → chunk-SRJ74CMG.js} +11 -3
  203. package/dist/{chunk-NHC2ADGI.js → chunk-STWOURLG.js} +253 -144
  204. package/dist/chunk-SWMFXSVW.js +23 -0
  205. package/dist/chunk-SXAZDIGM.js +84 -0
  206. package/dist/{chunk-EMFUZKYK.js → chunk-SZ5VGWDY.js} +3 -3
  207. package/dist/{chunk-R5MEBBAA.js → chunk-T26G23RS.js} +442 -119
  208. package/dist/{chunk-QHRE2M6V.js → chunk-T2L5H2WW.js} +4 -3
  209. package/dist/chunk-T7GPIJ4L.js +89 -0
  210. package/dist/{chunk-MJPXHCBW.js → chunk-TAEB3RU6.js} +5 -5
  211. package/dist/{chunk-V7F4F6JA.js → chunk-TBDIMTRD.js} +37 -16
  212. package/dist/{chunk-63Y3ROZ7.js → chunk-TFFPEWNP.js} +102 -64
  213. package/dist/{chunk-EZZ533MH.js → chunk-TMEUK2WS.js} +6 -2
  214. package/dist/{chunk-37PKNVLS.js → chunk-TVOMGNFQ.js} +1 -1
  215. package/dist/{chunk-HJRNBKIT.js → chunk-TX5FSNAU.js} +436 -30
  216. package/dist/{chunk-V634AXDM.js → chunk-U52PNFPX.js} +1 -1
  217. package/dist/{chunk-QLANK3VN.js → chunk-U74AWJ3X.js} +6 -6
  218. package/dist/chunk-UC7LBW7N.js +26 -0
  219. package/dist/{chunk-PZ46S2SY.js → chunk-UCKUAKYQ.js} +2 -2
  220. package/dist/{chunk-KF7HD3EH.js → chunk-UCYL3YA7.js} +77 -55
  221. package/dist/{chunk-HOU2MZHC.js → chunk-UD2GI3CS.js} +11 -4
  222. package/dist/{chunk-SNQ7D5R7.js → chunk-UIHGGWES.js} +51 -11
  223. package/dist/{chunk-LGNJCPFP.js → chunk-ULQIC76A.js} +10 -13
  224. package/dist/{chunk-KTHFHD6C.js → chunk-UY34DDUM.js} +11 -6
  225. package/dist/{chunk-6QDMRPXI.js → chunk-UYMFLWM6.js} +215 -258
  226. package/dist/{chunk-KDSYZLF6.js → chunk-V5IFI3FV.js} +8 -1
  227. package/dist/{chunk-JTFKRDDA.js → chunk-V7FV66KL.js} +1 -1
  228. package/dist/{chunk-27OIGDRK.js → chunk-V7NUJEJE.js} +1 -1
  229. package/dist/{chunk-CCDXK5NA.js → chunk-VESSIKBG.js} +8 -3
  230. package/dist/{chunk-QSMGZOT5.js → chunk-VRFJAF3R.js} +7 -8
  231. package/dist/chunk-VS2R3OGN.js +34 -0
  232. package/dist/{chunk-RLMC5CUP.js → chunk-VS5B4J2D.js} +7 -8
  233. package/dist/{chunk-7M2GK7XQ.js → chunk-W4R6SGU3.js} +252 -121
  234. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  235. package/dist/{chunk-7DAH2E4T.js → chunk-WFBN2HXR.js} +2 -2
  236. package/dist/{chunk-DLDDRXAI.js → chunk-WJS6SAWA.js} +296 -145
  237. package/dist/{chunk-WWGPTEQB.js → chunk-WQYNKF33.js} +73 -22
  238. package/dist/{chunk-64LJDGJH.js → chunk-WUP6C4ZD.js} +4 -2
  239. package/dist/{chunk-F2EVCJ4U.js → chunk-X24WAHHV.js} +87 -43
  240. package/dist/{chunk-OJ5CQV7H.js → chunk-X3UCQPVV.js} +209 -96
  241. package/dist/{chunk-7FKY6YWU.js → chunk-X46PSAJ7.js} +6 -6
  242. package/dist/{chunk-H3IBJQ5A.js → chunk-XD5XB22R.js} +2 -2
  243. package/dist/chunk-XDIAQEYK.js +28 -0
  244. package/dist/{chunk-7PPMT5EJ.js → chunk-XFPNYHX3.js} +372 -105
  245. package/dist/{chunk-FCECYJVA.js → chunk-XIBVAKCO.js} +1 -1
  246. package/dist/{chunk-OG2YUVBW.js → chunk-XMX4PCFL.js} +8 -3
  247. package/dist/{chunk-2NRHD2G7.js → chunk-XRRG4MBM.js} +12 -4
  248. package/dist/{chunk-FNMH5WEY.js → chunk-XTFO6D4L.js} +1 -1
  249. package/dist/chunk-XWRI3N5O.js +70 -0
  250. package/dist/{chunk-ZKJ5L35C.js → chunk-XXPLPSOE.js} +36 -25
  251. package/dist/{chunk-XQMYQ4TN.js → chunk-XZXZNI7A.js} +1 -1
  252. package/dist/{chunk-E555EDOQ.js → chunk-YEJZ2OYS.js} +490 -182
  253. package/dist/chunk-YGZEG3JV.js +123 -0
  254. package/dist/{chunk-F6OLHND5.js → chunk-Z3WQXVFV.js} +2 -2
  255. package/dist/{chunk-FFJGC2DX.js → chunk-Z6DUNKFU.js} +173 -40
  256. package/dist/{chunk-N5HN5QGH.js → chunk-Z6H5ED2I.js} +1 -1
  257. package/dist/{chunk-7Q37C6GZ.js → chunk-ZBOOMLHD.js} +1 -1
  258. package/dist/{chunk-MOK3ZS6P.js → chunk-ZDJ7C64T.js} +1 -1
  259. package/dist/{chunk-GLQ3KCTY.js → chunk-ZGZLEUKM.js} +7 -8
  260. package/dist/{chunk-YHD2FZFP.js → chunk-ZHRGX225.js} +6 -6
  261. package/dist/{chunk-76Q7E3TM.js → chunk-ZIVCPXXL.js} +510 -646
  262. package/dist/{chunk-BSATR6ZO.js → chunk-ZNRSYS76.js} +21 -3
  263. package/dist/{chunk-DMAMWUYY.js → chunk-ZSLTSCTI.js} +5 -5
  264. package/dist/{chunk-IGVAWAOK.js → chunk-ZSYFQSPF.js} +43 -9
  265. package/dist/cli/index.js +8 -3
  266. package/dist/{core-7Y5BZZON.js → core-43GLGBOY.js} +8 -1
  267. package/dist/{core-7S3XMW5O.js → core-5GI3ERXO.js} +4 -1
  268. package/dist/{core-K3JX5WPM.js → core-5L7TMK7I.js} +6 -1
  269. package/dist/{core-LB5M7XL4.js → core-7TO4OVY5.js} +6 -1
  270. package/dist/{core-ILPXXC2Z.js → core-BJVENHFQ.js} +7 -1
  271. package/dist/{core-JDFUZFRH.js → core-BX4MFWKC.js} +6 -1
  272. package/dist/{core-XW7UJFJZ.js → core-C3KXTOIZ.js} +7 -1
  273. package/dist/{core-WJNK7F2J.js → core-C5Y6BFLL.js} +7 -1
  274. package/dist/{core-WZ4CHVYL.js → core-CLUSJ2SK.js} +5 -1
  275. package/dist/{core-TCSW24N6.js → core-E3IN2VVH.js} +5 -1
  276. package/dist/{core-MU4ALRR7.js → core-FD67NQOV.js} +6 -1
  277. package/dist/{core-YMXYUGF5.js → core-FDKMLRAK.js} +5 -1
  278. package/dist/{core-VKZSQFRG.js → core-FL6Z3VVX.js} +5 -1
  279. package/dist/{core-5UF44NDI.js → core-JC7JUFPY.js} +8 -1
  280. package/dist/{core-RR2CAZC5.js → core-JF33TADA.js} +8 -1
  281. package/dist/{core-4RR6VSXM.js → core-JH32ZAKM.js} +4 -1
  282. package/dist/{core-G3LXHW73.js → core-JYYZPPQV.js} +7 -1
  283. package/dist/{core-4HFVG4CP.js → core-KJTKCV4U.js} +4 -1
  284. package/dist/{core-GSILPKUR.js → core-LCQPE5Y6.js} +8 -1
  285. package/dist/{core-GLOZY6Z7.js → core-LHVGWE54.js} +6 -1
  286. package/dist/{core-J2JD5ODO.js → core-OVSNBOCE.js} +9 -1
  287. package/dist/{core-BLHEJ5OK.js → core-PPEC236B.js} +5 -1
  288. package/dist/{core-ZLSQHZ3I.js → core-QTJZDK5H.js} +5 -1
  289. package/dist/{core-TKZZZ6UW.js → core-R3YZCOUZ.js} +7 -1
  290. package/dist/{core-HTD5RHE7.js → core-RIBW5XU4.js} +7 -1
  291. package/dist/{core-AR2T32Y3.js → core-RJFILBWL.js} +8 -1
  292. package/dist/{core-A5AKUB7H.js → core-RWSXEKTE.js} +4 -1
  293. package/dist/{core-DD62MWEW.js → core-SOPPZLEH.js} +5 -1
  294. package/dist/{core-HDNWVLJW.js → core-TBUZCXLX.js} +5 -1
  295. package/dist/{core-BOG33BFD.js → core-TZ5QLTAX.js} +5 -1
  296. package/dist/{core-H5HO2CED.js → core-U7E5W4MY.js} +3 -1
  297. package/dist/{core-QPSAYRFT.js → core-UBNVSL44.js} +7 -1
  298. package/dist/{core-E2XOSHPR.js → core-UDRD4WIU.js} +6 -1
  299. package/dist/{core-DFZMOO7E.js → core-UVJZ4HY2.js} +7 -1
  300. package/dist/{core-LGJZUP6H.js → core-X7WWYQH4.js} +8 -1
  301. package/dist/{core-BBNY2BX4.js → core-XP56X47I.js} +5 -1
  302. package/dist/{core-3KLQSYWB.js → core-XQG54CYG.js} +6 -1
  303. package/dist/{dataTable-CNDRVGA5.js → dataTable-U7W4I6IF.js} +15 -2
  304. package/dist/{engine-FVEIM3WV.js → engine-O5V26MGR.js} +32 -19
  305. package/dist/fixtures.js +4 -1
  306. package/dist/flags-BVLSAXT3.js +10 -0
  307. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  308. package/dist/fonts.js +1 -1
  309. package/dist/geo/dach.js +1 -1
  310. package/dist/geo/de-states.js +1 -1
  311. package/dist/geo/eu27.js +1 -1
  312. package/dist/geo/europe.js +1 -1
  313. package/dist/geo/index.js +2 -2
  314. package/dist/geo/us-states.js +1 -1
  315. package/dist/geo/world.js +1 -1
  316. package/dist/index.js +41 -22
  317. package/dist/{main-THU6VIVU.js → main-35GS47XC.js} +68 -123
  318. package/dist/mcp/server.js +131 -118
  319. package/dist/react/bar.js +10 -1
  320. package/dist/react/bartable.js +10 -1
  321. package/dist/react/box.js +8 -1
  322. package/dist/react/bullet.js +10 -1
  323. package/dist/react/butterfly.js +10 -1
  324. package/dist/react/choropleth.js +10 -1
  325. package/dist/react/cohort.js +11 -1
  326. package/dist/react/column.js +10 -1
  327. package/dist/react/combo.js +10 -1
  328. package/dist/react/creative.js +11 -1
  329. package/dist/react/diagram.js +10 -1
  330. package/dist/react/dimswitch.js +11 -1
  331. package/dist/react/dot.js +9 -1
  332. package/dist/react/export.js +36 -18
  333. package/dist/react/funnel.js +9 -1
  334. package/dist/react/gantt.js +9 -1
  335. package/dist/react/grid.js +10 -1
  336. package/dist/react/heatmap.js +9 -1
  337. package/dist/react/histogram.js +11 -1
  338. package/dist/react/index.js +101 -85
  339. package/dist/react/kpi.js +10 -1
  340. package/dist/react/likert.js +11 -1
  341. package/dist/react/line.js +9 -1
  342. package/dist/react/mekko.js +10 -1
  343. package/dist/react/pareto.js +11 -1
  344. package/dist/react/pie.js +9 -1
  345. package/dist/react/prepare.js +49 -21
  346. package/dist/react/pvm.js +12 -1
  347. package/dist/react/pyramid.js +10 -1
  348. package/dist/react/sankey.js +10 -1
  349. package/dist/react/scatter.js +8 -1
  350. package/dist/react/slope.js +10 -1
  351. package/dist/react/sparkline.js +10 -1
  352. package/dist/react/spec.js +24 -14
  353. package/dist/react/status.js +9 -1
  354. package/dist/react/story.js +5 -2
  355. package/dist/react/table.js +9 -1
  356. package/dist/react/theme.js +10 -3
  357. package/dist/react/tilemap.js +9 -1
  358. package/dist/react/treemap.js +9 -1
  359. package/dist/react/variance.js +10 -1
  360. package/dist/react/waffle.js +9 -1
  361. package/dist/react/waterfall.js +11 -1
  362. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  363. package/dist/rows.js +3 -2
  364. package/dist/{rowsModule-LI6KOS46.js → rowsModule-H2S6WW4D.js} +2 -1
  365. package/dist/{schema-CGQID64D.js → schema-2R32F6AW.js} +1 -1
  366. package/dist/{schema-H2EC4GAQ.js → schema-2TPGJGVR.js} +1 -1
  367. package/dist/{schema-THXXFY6I.js → schema-47BG2TZA.js} +1 -3
  368. package/dist/{schema-AMT7P7KB.js → schema-56MOEOVR.js} +1 -1
  369. package/dist/{schema-GNTKL5DN.js → schema-5MSR4LNN.js} +1 -1
  370. package/dist/{schema-5ZTGVQAJ.js → schema-5RIYEWE6.js} +1 -1
  371. package/dist/{schema-LOQ3AFC7.js → schema-A26ZNGTZ.js} +1 -3
  372. package/dist/{schema-MMVPMJEF.js → schema-ALBF6V7Y.js} +1 -3
  373. package/dist/{schema-BKUFZLLI.js → schema-BA6WP5YZ.js} +1 -1
  374. package/dist/{schema-PQZWO3BP.js → schema-CBL2SMVR.js} +1 -3
  375. package/dist/{schema-BBTXTWYI.js → schema-CWKGLDSR.js} +1 -3
  376. package/dist/{schema-5KDEQBBT.js → schema-DBIQFL56.js} +1 -1
  377. package/dist/{schema-KPEPBGAX.js → schema-DL7V6NN2.js} +1 -1
  378. package/dist/{schema-PL3EU6EQ.js → schema-DUVJMFKQ.js} +4 -2
  379. package/dist/{schema-L5U4OROI.js → schema-ECJERHKF.js} +2 -1
  380. package/dist/{schema-YLE4XXQQ.js → schema-EDSEKZDJ.js} +1 -1
  381. package/dist/{schema-HH5HOORE.js → schema-ESR6ZIK4.js} +1 -3
  382. package/dist/{schema-5DUTAVO7.js → schema-F7TWGLRZ.js} +1 -3
  383. package/dist/{schema-B2GCEYXD.js → schema-FGB6IGZM.js} +1 -3
  384. package/dist/{schema-7NSV542V.js → schema-FKGGTM4Z.js} +2 -1
  385. package/dist/{schema-72EEMYS3.js → schema-FU2AFIEE.js} +1 -1
  386. package/dist/{schema-QORUB6EK.js → schema-JNJFCYBM.js} +18 -1
  387. package/dist/{schema-JH57NFXJ.js → schema-JYZ4RF6S.js} +2 -1
  388. package/dist/{schema-25INXAMY.js → schema-K7F6TEDK.js} +1 -2
  389. package/dist/{schema-OU35XA3Z.js → schema-KAK6DZX4.js} +1 -1
  390. package/dist/{schema-R5Y6NVBH.js → schema-MOKWIGF7.js} +1 -1
  391. package/dist/{schema-ZQSIR5UC.js → schema-MQT6BMNK.js} +1 -3
  392. package/dist/{schema-FDFQKIO5.js → schema-MR3BPPQR.js} +1 -1
  393. package/dist/{schema-VYECMPON.js → schema-OPXZYIW7.js} +1 -3
  394. package/dist/{schema-ZEVJMFLV.js → schema-PV7JGX5H.js} +1 -1
  395. package/dist/{schema-QPOBZUAR.js → schema-PWPQF5RC.js} +1 -1
  396. package/dist/{schema-GN6GAIU5.js → schema-PYQEUC5P.js} +1 -3
  397. package/dist/{schema-M5JBHQIV.js → schema-QPIC5MAG.js} +9 -2
  398. package/dist/{schema-QCIE6M2P.js → schema-R42VXFIS.js} +1 -1
  399. package/dist/{schema-J7TNCZIP.js → schema-TVUJNEX7.js} +1 -1
  400. package/dist/{schema-AXRDF6ND.js → schema-Y4TI2T3T.js} +1 -1
  401. package/dist/{schema-ZG6ZKFRZ.js → schema-ZU2EU2VP.js} +1 -1
  402. package/dist/{specValidation-VHLGDEME.js → specValidation-2NHJT7TQ.js} +4 -1
  403. package/dist/theme.js +7 -2
  404. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  405. package/dist/types/core/annotate.d.ts +27 -2
  406. package/dist/types/core/annotateArms.d.ts +3 -1
  407. package/dist/types/core/annotateTargets.d.ts +4 -0
  408. package/dist/types/core/annotationOrigin.d.ts +13 -0
  409. package/dist/types/core/axis.d.ts +2 -2
  410. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  411. package/dist/types/core/charts/bartable/types.d.ts +14 -1
  412. package/dist/types/core/charts/box/types.d.ts +3 -1
  413. package/dist/types/core/charts/choropleth/layout.d.ts +1 -5
  414. package/dist/types/core/charts/choropleth/types.d.ts +19 -0
  415. package/dist/types/core/charts/cohort/types.d.ts +16 -3
  416. package/dist/types/core/charts/column/model.d.ts +13 -0
  417. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  418. package/dist/types/core/charts/creative/types.d.ts +21 -0
  419. package/dist/types/core/charts/dimswitch/compile.d.ts +15 -2
  420. package/dist/types/core/charts/dimswitch/types.d.ts +24 -1
  421. package/dist/types/core/charts/gantt/calendar.d.ts +24 -0
  422. package/dist/types/core/charts/gantt/columns.d.ts +56 -0
  423. package/dist/types/core/charts/gantt/layout.d.ts +8 -2
  424. package/dist/types/core/charts/gantt/model.d.ts +296 -0
  425. package/dist/types/core/charts/grid/metricStack.d.ts +9 -0
  426. package/dist/types/core/charts/grid/metricStackSchema.d.ts +13 -0
  427. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  428. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  429. package/dist/types/core/charts/histogram/types.d.ts +8 -0
  430. package/dist/types/core/charts/likert/layout.d.ts +10 -8
  431. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  432. package/dist/types/core/charts/pvm/types.d.ts +10 -1
  433. package/dist/types/core/charts/pyramid/types.d.ts +3 -1
  434. package/dist/types/core/charts/sankey/types.d.ts +5 -1
  435. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  436. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  437. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  438. package/dist/types/core/charts/status/layout.d.ts +3 -0
  439. package/dist/types/core/charts/table/resolve.d.ts +22 -3
  440. package/dist/types/core/charts/table/view.d.ts +24 -1
  441. package/dist/types/core/claims/browser.d.ts +2 -0
  442. package/dist/types/core/claims/ids.d.ts +38 -0
  443. package/dist/types/core/deferred.d.ts +1 -0
  444. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  445. package/dist/types/core/footer.d.ts +2 -0
  446. package/dist/types/core/formatSpec.d.ts +43 -14
  447. package/dist/types/core/frame.d.ts +26 -59
  448. package/dist/types/core/frameText.d.ts +203 -0
  449. package/dist/types/core/geo/types.d.ts +2 -0
  450. package/dist/types/core/geometry.d.ts +3 -1
  451. package/dist/types/core/label/categoryRow.d.ts +19 -2
  452. package/dist/types/core/label/solver.d.ts +23 -2
  453. package/dist/types/core/normalize/shared.d.ts +14 -2
  454. package/dist/types/core/notes.d.ts +15 -2
  455. package/dist/types/core/reading.d.ts +12 -1
  456. package/dist/types/core/registry.d.ts +4 -5
  457. package/dist/types/core/request.d.ts +7 -1
  458. package/dist/types/core/schema/capability.d.ts +32 -7
  459. package/dist/types/core/schema/generatedColumns.d.ts +168 -0
  460. package/dist/types/core/seriesIdentity.d.ts +4 -1
  461. package/dist/types/core/sizing.d.ts +32 -1
  462. package/dist/types/core/structureCounts.d.ts +3 -1
  463. package/dist/types/core/text.d.ts +16 -0
  464. package/dist/types/core/theme.d.ts +33 -4
  465. package/dist/types/core/themeGeometry.d.ts +9 -0
  466. package/dist/types/core/themeRules.d.ts +2 -0
  467. package/dist/types/core/timeAxis.d.ts +6 -1
  468. package/dist/types/core/types/annotations.d.ts +74 -4
  469. package/dist/types/core/types/diagram.d.ts +7 -0
  470. package/dist/types/core/types/options.d.ts +118 -15
  471. package/dist/types/core/types/scene.d.ts +30 -2
  472. package/dist/types/core/types/table.d.ts +27 -3
  473. package/dist/types/core/types/theme.d.ts +23 -0
  474. package/dist/types/index.d.ts +2 -0
  475. package/dist/types/react/TableChart.d.ts +5 -0
  476. package/dist/types/react/barrelCharts.d.ts +16 -5
  477. package/dist/types/react/charts/butterfly.d.ts +2 -2
  478. package/dist/types/react/charts/dot.d.ts +7 -1
  479. package/dist/types/react/charts/pareto.d.ts +4 -1
  480. package/dist/types/react/charts/variance.d.ts +3 -1
  481. package/dist/types/react/hover/labelCard.d.ts +11 -2
  482. package/dist/types/react/prepare.d.ts +7 -1
  483. package/dist/types/theme.d.ts +2 -0
  484. package/dist/validate.js +23 -6
  485. package/docs/TELEMETRY.md +2 -2
  486. package/docs/manual.md +283 -65
  487. package/docs/reference/bar.md +15 -4
  488. package/docs/reference/bartable.md +17 -2
  489. package/docs/reference/box.md +15 -4
  490. package/docs/reference/bullet.md +21 -6
  491. package/docs/reference/butterfly.md +17 -6
  492. package/docs/reference/choropleth.md +16 -5
  493. package/docs/reference/cohort.md +25 -5
  494. package/docs/reference/column.md +19 -4
  495. package/docs/reference/combo.md +11 -5
  496. package/docs/reference/creative.md +17 -8
  497. package/docs/reference/diagram.md +6 -1
  498. package/docs/reference/dimswitch.md +71 -118
  499. package/docs/reference/dot.md +16 -7
  500. package/docs/reference/fixtures.md +94 -1
  501. package/docs/reference/funnel.md +14 -5
  502. package/docs/reference/gantt.md +17 -16
  503. package/docs/reference/grid.md +13 -3
  504. package/docs/reference/heatmap.md +16 -6
  505. package/docs/reference/histogram.md +2 -2
  506. package/docs/reference/kpi.md +5 -1
  507. package/docs/reference/likert.md +17 -4
  508. package/docs/reference/line.md +18 -5
  509. package/docs/reference/mekko.md +10 -5
  510. package/docs/reference/options.md +20 -15
  511. package/docs/reference/pareto.md +9 -5
  512. package/docs/reference/pie.md +9 -5
  513. package/docs/reference/pvm.md +16 -6
  514. package/docs/reference/pyramid.md +14 -4
  515. package/docs/reference/react.md +6 -7
  516. package/docs/reference/sankey.md +7 -3
  517. package/docs/reference/scatter.md +8 -4
  518. package/docs/reference/slope.md +15 -5
  519. package/docs/reference/sparkline.md +1 -1
  520. package/docs/reference/status.md +7 -1
  521. package/docs/reference/table.md +41 -110
  522. package/docs/reference/theme.md +12 -4
  523. package/docs/reference/tilemap.md +2 -4
  524. package/docs/reference/treemap.md +1 -1
  525. package/docs/reference/variance.md +12 -6
  526. package/docs/reference/waffle.md +1 -1
  527. package/docs/reference/warnings.md +1077 -0
  528. package/docs/reference/waterfall.md +20 -5
  529. package/docs/use-cases.md +25 -13
  530. package/llms.txt +19 -6
  531. package/package.json +18 -3
  532. package/dist/chunk-6364WO5D.js +0 -47
  533. package/dist/chunk-DQ7YMQVX.js +0 -26
  534. package/dist/chunk-EBB4PYBN.js +0 -24
  535. package/dist/chunk-FG5L2LUK.js +0 -89
  536. package/dist/chunk-IFQN4GKK.js +0 -1852
  537. package/dist/chunk-IRXVV65V.js +0 -24
  538. package/dist/chunk-JGFHNAHS.js +0 -22
  539. package/dist/chunk-JHWYG7V5.js +0 -24
  540. package/dist/chunk-M4SPKUZE.js +0 -7
  541. package/dist/chunk-O36WX56O.js +0 -13
  542. package/dist/chunk-QJWLNP64.js +0 -24
  543. package/dist/chunk-QZIHKQRH.js +0 -26
  544. package/dist/chunk-SE7MJ2LQ.js +0 -24
  545. package/dist/chunk-TXBO2LWM.js +0 -25
  546. package/dist/chunk-UPTXFTKH.js +0 -25
  547. package/dist/chunk-UREXN6WG.js +0 -25
  548. package/dist/chunk-UZLR25BW.js +0 -24
  549. package/dist/chunk-WIVFIVFZ.js +0 -27
  550. package/dist/chunk-WZL4EEBS.js +0 -11
  551. package/dist/chunk-XHRUXZD7.js +0 -28
  552. package/dist/chunk-ZWNRLIFT.js +0 -24
@@ -89,6 +89,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
89
89
  | labelDensity | string | `'full'`, `'smart'`, `'minimal'` | | Default 'smart': every column total stays eligible. A chart with more than 12 categories, or with most totals wider than the band, ranks the first, last, highest and lowest (ties: the first) first. The other totals then use only their natural seat above the column; with none free they are drawn nowhere and left out of the note. Those four may take one step, and the note names any that finds no seat. A smaller chart keeps every total on the bounded one-step rule and names any that finds no seat. 'full' treats all totals alike and names every one that finds no seat. Seats stay inside the plot band and one step from the natural seat. Reading records keep every value. |
90
90
  | labels | false \| object | `false` (or another value of its type) | | Line end labels default to the value alone at both ends; point: ['series', 'absolute'] adds the series name. Authored point content applies to both ends. On stacked columns, segment: ['absolute', 'percent'] prints value and share in each segment, and a value its segment cannot hold is named in the note line; grandTotal: false hides stack totals. A single column series prints its values as grandTotal labels, so grandTotal: false hides them and keeps the line values; point governs line values only. Combo has no labels.growth: the growth statements of the dual-axis anatomy are dualAxis.growth. |
91
91
  | legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key unless direct labels name them. 'none' hides the key; render warns when names are missing. A series key also explains its scenario styling. |
92
+ | categoryAxis | object | | | Category-axis settings: dateTicks. |
92
93
  | secondaryAxis | object | | | Independent acknowledged secondary scale, or a percentage relabeling of the primary scale. An independent secondary scale returns the warning dual-axis. |
93
94
  | secondaryAxis.acknowledge (secondaryAxis branch 1) | true | `true` | | Explicit acknowledgement that the right axis uses an independent scale. |
94
95
  | secondaryAxis.domain (secondaryAxis branch 1) | array | | | Pin the secondary domain (data may only widen it, never be clipped). |
@@ -115,7 +116,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
115
116
  | axisTitles.primary | string | | | Visible title above the primary value axis. |
116
117
  | axisTitles.secondary | string | | | Visible title above the active secondary value axis. |
117
118
  | interpolate | string | `'linear'`, `'step-after'`, `'step-before'`, `'monotone'` | | Interpolation for line/area series; per-series smooth overrides it. |
118
- | dualAxis | object | | | Dual-axis anatomy: both scales from zero with one interval count and shared gridlines, maxima chosen so the line runs above the columns (the columns shrink to a quarter of the plot when that is the only way; when no pair keeps the line above, the columns keep the lower 55% of the plot with the left ticks stopping at the column top, and the line floats in the band above on its own scale from its low to its high, with no right ticks and its ends, low and high printed, every point up to 8 categories, and the unit title over the top left tick; info lint dual-axis-line-floated), axis titles with a swatch of their series, column values inside the column top, the line's values above their points on a halo (every point up to 8 categories, else the first and last). Column values the line still covers are dropped; when one value is wider than its column, every column value sits above its column instead (labels.grandTotal: false hides them). With valueLabels 'all' (the anatomy's default up to 8 categories) every value is labelled, so neither tick column is drawn and the axis titles key both series in one row from the left; valueAxis.show or secondaryAxis.show brings the ticks back, and so does a value that finds no seat. Authored valueAxis.min or max, or a negative value, keep the plain dual axis and report the info lint dual-axis-anatomy-off. |
119
+ | dualAxis | object | | | Dual-axis anatomy: both scales from zero with one interval count and shared gridlines, maxima chosen so the line runs above the columns (the columns shrink to a quarter of the plot when that is the only way; when no pair keeps the line above, the columns keep the lower 55% of the plot with the left ticks stopping at the column top, and the line floats in the band above on its own scale from its low to its high, with no right ticks and its ends, low and high printed, every point up to 8 categories, and the unit title over the top left tick; info lint dual-axis-line-floated. The line floats only when those values print or an anomaly on it prints its flagged values: valueLabels 'none', 'last' or 'ends', or line point labels off, keep the plain dual axis with its right ticks), axis titles with a swatch of their series, column values inside the column top, the line's values above their points on a halo (every point up to 8 categories, else the first and last). Column values the line still covers are dropped; when one value is wider than its column, every column value sits above its column instead (labels.grandTotal: false hides them). With valueLabels 'all' (the anatomy's default up to 8 categories) every value is labelled, so neither tick column is drawn and the axis titles key both series in one row from the left; valueAxis.show or secondaryAxis.show brings the ticks back, and so does a value that finds no seat. Authored valueAxis.min or max, or a negative value, keep the plain dual axis and report the info lint dual-axis-anatomy-off. |
119
120
  | dualAxis.anatomy | boolean | | | true draws the dual-axis anatomy on an acknowledged secondary scale the author did not pin. Default: the theme's valueAxis.dualAxis, else false. |
120
121
  | dualAxis.growth | boolean | | `false` | With the anatomy, states each series' growth from its first to its last complete value beyond the right ticks, bold in the series' text ink, on one line with the series name up to its first comma ('+128% Units sold'); the name goes under the figure when one line would take more than a fifth of the canvas width. A partial category is no end, and the name then says the span. On a canvas narrower than 600 px the statements move to one note line ('Units sold +128%, Revenue +33%, 2019–2024.') and the plot keeps the width. Default false. |
121
122
  | valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Which line values print, each at its point; the key row names the series. 'none', 'last' (default; the dual-axis anatomy defaults to 'all' up to 8 categories, else 'ends', and a line floated over the columns to 'all' up to 8 categories, else 'extremes'), 'ends' (first and last), 'extremes' (ends plus low and high) or 'all'. Interior values sit on the side away from other lines, never nearer another line, or on the column with a backing; authored cell labels always print. |
@@ -145,15 +146,19 @@ An annotation anchor is a category or item id string, or an object with category
145
146
 
146
147
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
147
148
  |---|---|---|---|---|---|
148
- | 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. |
149
- | 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. Drawn reference series accept anchors. |
150
- | 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 | | Drawn reference series accept anchors. |
149
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. |
150
+ | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. Drawn reference series accept anchors. |
151
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | Drawn reference series accept anchors. |
151
152
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
152
- | 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. | Drawn reference series accept anchors. |
153
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
153
154
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. axis: primary \| secondary, default primary. Scale of value; secondary needs an acknowledged secondary axis. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
154
155
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | Drawn reference series accept anchors. |
155
156
  | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | label | at: categoryId (optional) | date: ISO date yyyy-mm-dd, in place of at: the event sits at the last category whose date is on or before it, and the block header and the key print it as d MMM. Every category needs an ISO date; a date outside the categories warns event-out-of-range. end: ISO date, with date: the event is a period, drawn as a thin bar to the end of that day. to: Category id, with at: the event is a period to the end of that category. group: Id of a group in options.events.groups, which gives the kind label, tone and glyph. detail: string \| string[]. Authored lines under the title, at most three in the lane; nothing is cut, a longer block moves to the key. items: { label, detail? }[]. More changes on the same date, after this event's own label and detail. The lane and the key draw a compact +N after the title; the hover card, the SVG title and description, and the interaction records list every item in full. placement: auto \| key, default options.events.placement. key numbers this event into the key below the plot. tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. | Exactly one of at (a category id) and date (an ISO date) places the event; end or to makes it a period. The event lane above the plot sets a block of group and date, title and detail with a thin pole to the data; an event that does not fit, a second event on one category and every event under options.events.placement 'key' get a numbered marker and an entry in the key below the plot, numbered in time order; under footnotes: false they are left off and listed in the footnotes-off lint. The full date, title and detail of every event stay in the SVG title and description, the interaction records and the hover card, whether or not the lane or the key prints the detail. In compact mode the lane is one row of numbered markers and the key packs "n date title" into as few lines as the width allows; where the plot would still fall under 80px the key keeps "n title" and the info lint event-lane-compact says so. options.events.rows sets the lane rows (default by canvas width: 1 under 1080px, 2 from 1080px); a row gives way while the plot band left under the lane would keep less than 40% of the canvas height. |
156
157
  | band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
158
+ | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
159
+ | line | Draws a straight line between two points or from a text annotation, in the ink and rule width of a bracket; a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the line in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the line starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
160
+ | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
161
+ | box | Draws an unfilled box with two points as opposite corners, wrapping whole category bands, in the ink and rule width of a bracket; text inside the box stays free. | from, to | from: AnchorRef \| { categoryId, value }; to: AnchorRef \| { categoryId, value } | dashed: boolean, default false. Draws the edges in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. from and to are opposite corners, the box has no fill, and text inside it stays free. A { categoryId, value } corner spans that category's whole band, so the box wraps whole bars, values and markers; from and to on one category wrap that category. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
157
162
 
158
163
  ## Overlay or dual axis
159
164
 
@@ -219,3 +224,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
219
224
  | ranked-campaigns-key-shown | torture | Campaign names too long for their columns read as ranks with the key printed (notes.show) |
220
225
  | ranked-campaigns-rank-key-only | torture | Campaign names too long for their columns read as ranks; only the rank key prints (notes.show ranks) |
221
226
  | area-capacity-behind-columns | example | Order columns in front of a capacity area, with a plan corridor and a launch period |
227
+ | inside-base-values | example | Combo column values inside the base |
@@ -58,15 +58,11 @@ One form; its chart ID is `creative`.
58
58
  |---|---|---|---|
59
59
  | id | string | yes | Stable identifier for the creative. |
60
60
  | media | object | yes | Embedded raster media or an explicit placeholder. |
61
- | media.aspect (media branch 1) | string | yes | Authored media width-to-height ratio. One of `'1:1'`, `'4:5'`, `'9:16'`. |
62
- | media.alt (media branch 1) | string | yes | Accessible description of the creative media. |
61
+ | media.aspect (media branch 1 \| media branch 2 \| media branch 3) | string | yes | Authored media width-to-height ratio. One of `'1:1'`, `'4:5'`, `'9:16'`. |
62
+ | media.alt (media branch 1 \| media branch 2 \| media branch 3) | string | yes | Accessible description of the creative media. |
63
63
  | media.kind (media branch 1) | string | yes | Media has not been supplied. One of `'placeholder'`. |
64
- | media.aspect (media branch 2) | string | yes | Authored media width-to-height ratio. One of `'1:1'`, `'4:5'`, `'9:16'`. |
65
- | media.alt (media branch 2) | string | yes | Accessible description of the creative media. |
66
64
  | media.kind (media branch 2) | string | yes | Authored image media. One of `'image'`. |
67
65
  | media.src (media branch 2) | string | yes | Authored image source reference; this contract does not fetch media. |
68
- | media.aspect (media branch 3) | string | yes | Authored media width-to-height ratio. One of `'1:1'`, `'4:5'`, `'9:16'`. |
69
- | media.alt (media branch 3) | string | yes | Accessible description of the creative media. |
70
66
  | media.kind (media branch 3) | string | yes | Authored video represented by its poster. One of `'video'`. |
71
67
  | media.poster (media branch 3) | string | yes | Authored poster-image reference; this contract does not fetch or play video. |
72
68
  | facts | object | yes | Creative identity, currency and reported runtime. |
@@ -124,8 +120,20 @@ One form; its chart ID is `creative`.
124
120
  | Path | Type | Values | Default | Meaning |
125
121
  |---|---|---|---|---|
126
122
  | footnotes | false | `false` | | false leaves the source line and the method lines (the account-median basis and the fatigue rule) off the card, for a host that shows them in its own frame; the texts stay in frame.source and frame.notes, and the fatigue status line stays on the card. No list of notes is taken. |
127
-
128
- Plus the [shared options](options.md). This type does not accept `a11y`, `belowMinimum`, `margin`, `canvas`, `unit`, `unitShown`, `strings`, `format`, `detailFields`, `smallValues`, `labelDensity`, `labels`, `labelPlacements`, `legend`, `valueAxis`, `scaleGroup`, `highlight`, `story`, `focus`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
123
+ | columnVisibility | object | | | True shows a column and false leaves it out: the ids are data.columnToggles ids on table and column ids elsewhere. Ids: label, value, median, delta. |
124
+ | columnOverrides | object | | | Settings per generated column. Ids: label, value, median, delta. |
125
+ | columnOverrides.*.width | number | | | Track width in px. It beats the width the type would pick. |
126
+ | columnOverrides.*.align | string | `'left'`, `'right'`, `'center'` | | Alignment of the column: its cell text and, unless headAlign is set, its head. Bars keep starting at the panel origin. |
127
+ | columnOverrides.*.headAlign | string | `'left'`, `'right'`, `'center'` | | Head alignment; defaults to align. |
128
+ | columnOverrides.*.label | string | | | Head text. |
129
+ | columnOrder | array | | | Order of whole blocks; blocks left out follow in default order. Ids: label, value, median, delta. |
130
+ | columnHeads | false | `false` | | false: no visible head row and no group heads, with their height and rule. Assistive technology still reads the head in React, and sortable warns there. |
131
+ | rowVisibility | object | | | False leaves a generated row out. Ids: ctr, cpa, roas, hookRate, holdRate, frequency. |
132
+ | rowOrder | array | | | Order of the generated rows; rows left out follow in default order. Ids: ctr, cpa, roas, hookRate, holdRate, frequency. |
133
+ | rowOverrides | object | | | Settings per generated row. Ids: ctr, cpa, roas, hookRate, holdRate, frequency. |
134
+ | rowOverrides.*.label | string | | | Row name. |
135
+
136
+ Plus the [shared options](options.md). This type does not accept `a11y`, `belowMinimum`, `margin`, `canvas`, `unit`, `unitShown`, `strings`, `format`, `detailFields`, `smallValues`, `labelDensity`, `labels`, `labelPosition`, `labelPlacements`, `labelOffsets`, `legend`, `valueAxis`, `scaleGroup`, `highlight`, `story`, `focus`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
129
137
 
130
138
  ## Annotations
131
139
 
@@ -145,3 +153,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
145
153
  | creative-image-fatigue | example | Creative image with an explicit CTR screening rule |
146
154
  | creative-host-card | example | Creative card in a host frame: no method lines, trends ending in a ring |
147
155
  | creative-video-poster | torture | Square video creative drawn from its poster |
156
+ | columns-rows | example | A creative table with the median column and two metrics left out |
@@ -201,6 +201,10 @@ Set protected only where the claim is true: the lock states that the zone is pro
201
201
  | inset.rows | array | | Up to 12 short rows. |
202
202
  | inset.rows[].label | string | yes | Row name, at most 60 Unicode code points. |
203
203
  | inset.rows[].value | string | yes | Row value as text, at most 24 Unicode code points. |
204
+ | inset.heading | false | | false draws no panel title, with its height and gap gone. The title stays the accessible name. One of `false`. |
205
+ | inset.columnOverrides | object | | Settings of the rows' two columns: label, value. |
206
+ | inset.columnOverrides.*.width | number | | Track width in px. It beats the width the type would pick. |
207
+ | inset.columnOverrides.*.align | string | | Alignment of the column: its cell text and, unless headAlign is set, its head. Bars keep starting at the panel origin. One of `'left'`, `'right'`, `'center'`. |
204
208
 
205
209
  ## Options
206
210
 
@@ -211,7 +215,7 @@ Set protected only where the claim is true: the lock states that the zone is pro
211
215
  | heightFill | string | `'rows'`, `'none'` | `'rows'` | Spare canvas height, read by hierarchy (org chart) and customer-journey. 'rows' (default): a canvas with a set height grows the gaps between the levels up to 2.6 times. 'none': natural gaps, the block centred. |
212
216
  | highlight | string \| array | | | Architecture only: the node and edge ids that carry the message. They take the accent, and everything else recedes. |
213
217
 
214
- Plus the [shared options](options.md). This type does not accept `belowMinimum`, `unit`, `unitShown`, `strings`, `format`, `detailFields`, `smallValues`, `labelDensity`, `labels`, `labelPlacements`, `legend`, `valueAxis`, `scaleGroup`, `story`, `focus`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
218
+ Plus the [shared options](options.md). This type does not accept `belowMinimum`, `unit`, `unitShown`, `strings`, `format`, `detailFields`, `smallValues`, `labelDensity`, `labels`, `labelPosition`, `labelPlacements`, `labelOffsets`, `legend`, `valueAxis`, `scaleGroup`, `story`, `focus`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
215
219
 
216
220
  ## Annotations
217
221
 
@@ -261,6 +265,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
261
265
  | pipeline-health | example | A data pipeline with its service levels beside it |
262
266
  | long-names | torture | Long names keep every word at every width |
263
267
  | twenty-node-platform | torture | Twenty nodes and thirty edges across four zones |
268
+ | inset-no-heading | example | An inset without its title, with authored column widths and alignment |
264
269
 
265
270
  ## Not for
266
271
 
@@ -26,52 +26,28 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
26
26
  "dimension": {
27
27
  "label": "Channel",
28
28
  "total": { "id": "total", "label": "Total" },
29
- "members": [{ "id": "paid", "label": "Paid Search" }, { "id": "organic", "label": "Organic" }],
30
- "headline": ["spend", "revenue"]
29
+ "headline": ["orders", "cac"],
30
+ "members": [{ "id": "paid", "label": "Paid Search" }, { "id": "organic", "label": "Organic" }]
31
31
  },
32
32
  "measures": [
33
33
  {
34
34
  "id": "orders",
35
- "scale": "count",
36
35
  "label": "Orders",
37
- "change": "relative",
36
+ "scale": "count",
38
37
  "value": { "field": "orders" },
39
38
  "judge": { "family": "volume", "base": "orders" }
40
39
  },
41
40
  {
42
41
  "id": "new",
43
- "scale": "count",
44
42
  "label": "New customers",
45
- "parentId": "orders",
46
- "value": { "field": "nc" }
47
- },
48
- {
49
- "id": "existing",
50
43
  "scale": "count",
51
- "label": "Existing customers",
52
44
  "parentId": "orders",
53
- "value": { "op": "sub", "a": { "field": "orders" }, "b": { "field": "nc" } }
54
- },
55
- {
56
- "id": "revenue",
57
- "scale": "money",
58
- "label": "Net revenue",
59
- "value": { "field": "rev" },
60
- "format": "$1.2",
61
- "unit": "$"
62
- },
63
- {
64
- "id": "spend",
65
- "scale": "money",
66
- "label": "Marketing spend",
67
- "value": { "field": "spend" },
68
- "format": "$1.2",
69
- "unit": "$"
45
+ "value": { "field": "nc" }
70
46
  },
71
47
  {
72
48
  "id": "cac",
73
- "scale": "perUnit",
74
49
  "label": "CAC",
50
+ "scale": "perUnit",
75
51
  "value": { "op": "div", "a": { "field": "spend" }, "b": { "field": "nc" } },
76
52
  "format": "$1.2",
77
53
  "unit": "$",
@@ -79,87 +55,46 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
79
55
  }
80
56
  ],
81
57
  "periods": [
82
- { "id": "range", "label": "Range", "kind": "range" },
83
- { "id": "prior", "label": "Prior", "kind": "prior" },
84
- { "id": "w1", "label": "Week 1" },
85
- { "id": "w2", "label": "Week 2", "partial": true }
58
+ { "id": "range", "label": "Current period", "kind": "range" },
59
+ { "id": "prior", "label": "Prior period", "kind": "prior" },
60
+ { "id": "w1", "label": "Week 1" }
86
61
  ],
87
62
  "facts": [
88
63
  {
89
64
  "memberId": "total",
90
65
  "periodId": "range",
91
- "sums": { "orders": 120, "nc": 60, "rev": 12000, "spend": 1800 },
92
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
66
+ "sums": { "orders": 120, "nc": 60, "spend": 1800 }
93
67
  },
94
68
  {
95
69
  "memberId": "total",
96
70
  "periodId": "prior",
97
- "sums": { "orders": 128, "nc": 62, "rev": 12500, "spend": 1830 },
98
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
71
+ "sums": { "orders": 100, "nc": 50, "spend": 1700 }
99
72
  },
100
73
  {
101
74
  "memberId": "total",
102
75
  "periodId": "w1",
103
- "sums": { "orders": 136, "nc": 64, "rev": 13000, "spend": 1860 },
104
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
105
- },
106
- {
107
- "memberId": "total",
108
- "periodId": "w2",
109
- "sums": { "orders": 144, "nc": 66, "rev": 13500, "spend": 1890 },
110
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
111
- },
112
- {
113
- "memberId": "paid",
114
- "periodId": "range",
115
- "sums": { "orders": 105, "nc": 53, "rev": 10500, "spend": 1600 },
116
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
117
- },
118
- {
119
- "memberId": "paid",
120
- "periodId": "prior",
121
- "sums": { "orders": 113, "nc": 55, "rev": 11000, "spend": 1630 },
122
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
76
+ "sums": { "orders": 60, "nc": 30, "spend": 900 },
77
+ "ref": { "orders": 50 }
123
78
  },
79
+ { "memberId": "paid", "periodId": "range", "sums": { "orders": 80, "nc": 45, "spend": 1800 } },
80
+ { "memberId": "paid", "periodId": "prior", "sums": { "orders": 70, "nc": 38, "spend": 1700 } },
124
81
  {
125
82
  "memberId": "paid",
126
83
  "periodId": "w1",
127
- "sums": { "orders": 121, "nc": 57, "rev": 11500, "spend": 1660 },
128
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
129
- },
130
- {
131
- "memberId": "paid",
132
- "periodId": "w2",
133
- "sums": { "orders": 129, "nc": 59, "rev": 12000, "spend": 1690 },
134
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
135
- },
136
- {
137
- "memberId": "organic",
138
- "periodId": "range",
139
- "sums": { "orders": 60, "nc": 32, "rev": 6000 },
140
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
141
- },
142
- {
143
- "memberId": "organic",
144
- "periodId": "prior",
145
- "sums": { "orders": 68, "nc": 34, "rev": 6500 },
146
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
84
+ "sums": { "orders": 40, "nc": 22, "spend": 900 },
85
+ "ref": { "orders": 35 }
147
86
  },
87
+ { "memberId": "organic", "periodId": "range", "sums": { "orders": 40, "nc": 15 } },
88
+ { "memberId": "organic", "periodId": "prior", "sums": { "orders": 30, "nc": 12 } },
148
89
  {
149
90
  "memberId": "organic",
150
91
  "periodId": "w1",
151
- "sums": { "orders": 76, "nc": 36, "rev": 7000 },
152
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
153
- },
154
- {
155
- "memberId": "organic",
156
- "periodId": "w2",
157
- "sums": { "orders": 84, "nc": 38, "rev": 7500 },
158
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
92
+ "sums": { "orders": 20, "nc": 8 },
93
+ "ref": { "orders": 15 }
159
94
  }
160
95
  ]
161
96
  },
162
- "options": { "variant": "by-measure", "depth": 1, "title": "Channel performance" }
97
+ "options": { "variant": "by-measure", "depth": 2, "title": "Channel performance" }
163
98
  }
164
99
  ```
165
100
 
@@ -239,38 +174,15 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
239
174
  | Path | Type | Values | Default | Meaning |
240
175
  |---|---|---|---|---|
241
176
  | mountCollapsed | boolean | | | Default true. false removes closed descendants from the React DOM and defers offscreen leaf paint. |
177
+ | paintOffscreenRows | boolean | | | React only. true paints every mounted row at once, so a capture of a long table has no blank rows, and a long table paints slower. Default false. Closed rows follow mountCollapsed. |
242
178
  | signs | string | `'signed'`, `'operators'`, `'plain'` | | How sign -1 rows print. signed (default) negates them; operators draws + − × =; plain draws neither. |
243
179
  | driverTones | string | `'grouped'`, `'always'`, `'never'` | | Driver tones. 'grouped' (default): drivers with a parentId whose parent is not a section heading do, as statement lines do. 'always': every driver. 'never': driver ink only, as before 0.28. Neutral figures and labels keep the driver ink. |
244
180
  | judgements | string | `'all'`, `'exceptions'` | | Which tones show. exceptions: strong good and bad only. |
245
- | variant | string | `'by-measure'`, `'by-member'` | `'by-measure'` | by-measure: KPI rows over members (by-member: members over KPIs, Total first). In by-member the Total block is always open. |
246
- | encodings | object | | | Per-column opt-in visual encodings. A key is a column id: range, pp (the vs prior column), pl (the vs plan column, with a plan) or the id of a displayed period. Any other key draws nothing and warns dimswitch-encoding-column. |
247
- | encodings.*.type (encodings.* branch 5) | string | `'arrow'` | | Select the arrow lane. |
248
- | encodings.*.scale (encodings.* branch 5) | string | `'absolute'`, `'relative'` | | 'absolute' cuts the change itself at 10 and 2 (points on a percent column); 'relative' cuts its share of the column's largest change at 10% and 2%. Default 'absolute' on a percent column, 'relative' elsewhere. |
249
- | encodings.*.type (encodings.* branch 6) | string | `'heat'` | | Select the heat lane. |
250
- | encodings.*.cap (encodings.* branch 6) | object | | | Where the lane saturates; without it the largest magnitude in the column does, on both sides of zero. One lane per table, on a variance column. |
251
- | encodings.*.cap.pct (encodings.* branch 6) | number | | | Percent-column tint cap in points. Example: 20 for a ±20% YoY lane. |
252
- | encodings.*.cap.abs (encodings.* branch 6) | number | | | Other numeric tint cap in source units. |
253
- | encodings.*.alpha (encodings.* branch 6) | number | | | Tint weight at the cap; default 0.18, and 0.26 on scale 'status', where every painted cell takes it. Text stays readable up to 0.18 on every shipped theme and up to 0.35 on a status ground; above that the figures take the contrast ink. |
254
- | encodings.*.excludeTotals (encodings.* branch 6) | boolean | | | Leave total rows untinted; default true. Heat reads a variance, and a total has none worth colouring. |
255
- | encodings.*.steps (encodings.* branch 6) | integer | | | Band count. 5 gives the cohort ladder: 6 / 14 / 26 / 42 % of the ink over the background, then the full ink with inverse text, from the theme token surface.heatSteps. A stepped lane measures the data rows only, so a closing row does not set the scale. |
256
- | encodings.*.scale (encodings.* branch 6) | string | `'column'`, `'absolute'`, `'diverging'`, `'status'` | | Where a band comes from. 'column' (default) normalises over this column's own min and max; with two or more such columns the table adds the note that shading compares values within each column. 'absolute' cuts at bins, so every column of a grid reads on one scale. 'diverging' measures the distance from the column average and paints good above and bad below; under polarity 'lowerIsBetter' the sides swap. 'status' is a traffic light against the same centre: a value within tolerance of it paints warn, farther above good and farther below bad, the other way round on a column with polarity lowerIsBetter; it reads no steps, bins, span or cap. |
257
- | encodings.*.bins (encodings.* branch 6) | array | | | Ascending band edges. On scale 'absolute' a value takes the band of the last edge it reaches (e.g. [30, 40, 50, 60] gives five bands); on 'diverging' they are the \|distance\| edges, default [1, 4]. Given without steps, they set the band count themselves. |
258
- | encodings.*.span (encodings.* branch 6) | number | | | Spread that fills a column ramp. Measured in column units; a smaller spread takes bands from the lightest up, so a spread of 1 point is not painted like one of 30. Omitted, every column's own min and max fill the ramp. |
259
- | encodings.*.center (encodings.* branch 6) | string | `'total'` | | Centre: column total. On scales 'diverging' and 'status' a reader can check every band against that printed figure. Omitted, or in a column without a total row value, the centre is the average of the column's data rows. |
260
- | encodings.*.tolerance (encodings.* branch 6) | object | | | Warn band of scale 'status'. A value at most this far from the centre paints warn, the boundary included; default { pct: 5 }. Give exactly one of pct and abs. |
261
- | encodings.*.tolerance.pct (encodings.* branch 6) | number | | | Percent of the centre. 5 reads 62 to 68 as warn around 65. |
262
- | encodings.*.tolerance.abs (encodings.* branch 6) | number | | | Column units. 2 reads 63 to 67 as warn around 65. |
263
- | encodings.*.columns (encodings.* branch 6) | array | | | Further columns this rule paints. A sixty-column cohort grid names its lane once instead of sixty times, and a column that carries its own entry keeps it. Leave a column out to keep it unshaded. |
264
- | totalPosition | string | `'top'`, `'bottom'` | | Total-row position; variant supplies the default. |
265
- | density | string | `'compact'`, `'regular'`, `'relaxed'` | | Cell spacing: 'compact', 'regular' or 'relaxed'. The cohort densities do not apply: every cell holds a value and a change line, and cohort rows are fixed one-liners. |
266
- | nulls | string | `'blank'`, `'dash'` | | What a MISSING cell prints. 'dash' (the default) keeps the em dash; 'blank' leaves it empty, which is what a cohort staircase needs — a cohort acquired in May has not been observed at M8, and a triangle of dashes is noise. The explicit states na, nm and suppressed keep their glyphs. |
267
181
  | figures | boolean | | | Print the cell figures; default true. false draws the heat grounds alone in 22 px cells, over any width authored for the figures, on 14 px rows or the line box of the text a row still prints where that is taller, so a sixty-column triangle fits one screen. The heads keep their labels and the numbers stay in the markup for a reader who cannot see the grounds. Refused on a table without a heat lane in encodings. |
268
- | expansion | object | | | Row-id exceptions over depth (id: JSON.stringify([variant, memberId, measureId])). |
269
- | expansion.expanded | array | | | Row ids to open. |
270
- | expansion.collapsed | array | | | Row ids to fold. |
271
- | columnVisibility | object | | | Visibility by column-toggle id. |
182
+ | columnHeads | false | `false` | | false: no visible head row and no group heads, with their height and rule. Assistive technology still reads the head in React, and sortable warns there. |
272
183
  | inlineVisibility | object | | | Visibility by inlineGroup. An absent group is visible, so a Changes control hides every MoM line of a table with one entry. |
273
184
  | magnitude | string | `'auto'`, `'thousand'`, `'million'` | | Money scale for all rows and columns. 'thousand' prints whole thousands, 'million' keeps the example's decimals, and no column rolls up on its own. The scale letter leaves the cells and hoists to the frame, the column header or, where the format sits on the row, the row label. 'auto' (the default) lets each column and money row pick from its own largest value. |
185
+ | nulls | string | `'blank'`, `'dash'` | | What a MISSING cell prints. 'dash' (the default) keeps the em dash; 'blank' leaves it empty, which is what a cohort staircase needs — a cohort acquired in May has not been observed at M8, and a triangle of dashes is noise. The explicit states na, nm and suppressed keep their glyphs. |
274
186
  | foldOn | string | `'row'`, `'toggle'` | | React only. What folds a parent row. 'row': a click on the row folds it, and selects it too where the host made it selectable. 'toggle': only the fold mark folds; a row click only selects. Default: 'toggle' for a selectable row, else 'row'. Enter and Space follow the click. |
275
187
  | groupGround | string | `'expanded'`, `'always'`, `'none'` | | Group row ground. 'expanded' (default): only an open group's header row. 'always': folded or open, as before 0.28. 'none': no group ground. The Total keeps its ground. Absent: theme table.groupGround. |
276
188
  | anchorWash | boolean | | | Wash expanded level-0 anchors; no control. |
@@ -281,22 +193,53 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
281
193
  | stickyLabels.sections | boolean | | | Section label. Default false. true keeps the active section label under the head until the next section starts. |
282
194
  | frameFill | string | `'values'`, `'none'` | `'values'` | Under rowExtent 'frame'. 'values' (default): automatic value tracks grow in whole pixels, up to maxGrowth (default 2.5). An unauthored label track takes the rest. 'none': columns keep their widths; an empty track carries the row ground and rules to the edge. |
283
195
  | heightFill | string | `'rows'`, `'none'` | `'rows'` | Spare canvas height. 'rows' (default) spreads it over leaf rows as air, up to 16 px a side. 'none' leaves it empty. |
284
- | rowLabelLines | number | `1`, `2` | `2` | Lines a row label may take before a cut (default 2). A label breaks at a space or after _ - / or a dot, so a long campaign name wraps instead of ending in '…'. 1 keeps every label on one line. The hover card always prints the full name. |
196
+ | rowLabelLines | integer | | `2` | Lines a row label may take before a cut (default 2). A label breaks at a space or after _ - / or a dot, so a long campaign name wraps instead of ending in '…'. 1 keeps every label on one line; a higher count lets a row grow to its lines. A cut label keeps its full name in its title. |
285
197
  | lastTrackFlex | boolean | | | Last unauthored track takes the spare frame width when rowExtent is tracks. Default false. |
286
198
  | rowExtent | string | `'tracks'`, `'frame'` | `'frame'` | Where rows end. 'frame' (default) fills the width inside the frame margins. An explicit 'frame' also carries row grounds and rules through authored side margins. frameFill controls track growth. 'tracks' stops rows at the last column. Column bands stop at their columns. Tables use horizontal rules and explicit column separators; there is no single vertical end rule. |
287
199
  | sortIndicator | string | `'all'`, `'sorted'` | | Sortable headers with a chevron. 'all' (the default) draws one on every sortable header; 'sorted' draws it on the sorted one alone and keeps the others' reserve, so no track moves. |
288
200
  | levelOffset | integer | | | Shift body rows down the ladder. Default 0. A board whose top rows are groups rather than KPI lines reads one rung too heavy: 1 steps them down in size, weight, air, ground, indent and label ink, -1 steps them up. The rungs stay floored at the top and at the deepest step. |
289
201
  | cellPadX | number | | | Horizontal cell padding in px. Default 12; only when it cannot fit, use 5 for 20–24 columns or 3 for 25 or more. |
290
- | groupRule | string | `'label'`, `'span'` | `'span'` | Heading rule. 'span' (default) rules every column of the group, so it shows which columns the heading covers; 'label' underlines the heading text alone. |
291
- | groupAlign | string | `'left'`, `'center'`, `'right'` | `'center'` | Heading position. 'center' (default) centres the heading over its columns; in the React grid a group wider than the visible scroll area starts its heading at the first column, and the heading stays in view while the group scrolls. 'left' always starts it at the first column, 'right' ends it at the last. A heading wider than its columns starts at the first column. |
292
202
  | fitFormats | boolean | | | Fit figures to authored widths. Remove decimals, then use the next unit up. |
293
203
  | maxGrowth | number \| false | `false` (or another value of its type) | `2.5` | Value-track growth cap; default 2.5, false removes the cap. Applies to SVG and React frame fill; the label track takes the remaining width. Also caps React container fit growth. |
294
204
  | labelIndent | object | | | Tree indent from row edge. Absent: cell air without marks; cell air plus 24 with outlineMarks: true or interactive fold buttons. Then 16 per rung. |
295
205
  | labelIndent.base | number | | | Level-0 start from row edge, padding included. |
296
206
  | labelIndent.step | number | | | px per rung; default 16. |
297
207
  | outlineMarks | boolean | | `false` | Fold marks beside parent rows. Drawn in static SVG/PNG and read-only grids. Default false: no marks or gutter. true draws the marks and reserves their gutter. Interactive grids keep their fold buttons either way. |
208
+ | encodings | object | | | Per-column opt-in visual encodings. A key is a column id: range, pp (the vs prior column), pl (the vs plan column, with a plan) or the id of a displayed period. Any other key draws nothing and warns dimswitch-encoding-column. |
209
+ | encodings.*.type (encodings.* branch 5) | string | `'arrow'` | | Select the arrow lane. |
210
+ | encodings.*.scale (encodings.* branch 5) | string | `'absolute'`, `'relative'` | | 'absolute' cuts the change itself at 10 and 2 (points on a percent column); 'relative' cuts its share of the column's largest change at 10% and 2%. Default 'absolute' on a percent column, 'relative' elsewhere. |
211
+ | encodings.*.type (encodings.* branch 6) | string | `'heat'` | | Select the heat lane. |
212
+ | encodings.*.cap (encodings.* branch 6) | object | | | Where the lane saturates; without it the largest magnitude in the column does, on both sides of zero. Lanes with different caps add the note that shading compares values within each column. |
213
+ | encodings.*.cap.pct (encodings.* branch 6) | number | | | Percent-column tint cap in points. Example: 20 for a ±20% YoY lane. |
214
+ | encodings.*.cap.abs (encodings.* branch 6) | number | | | Other numeric tint cap in source units. |
215
+ | encodings.*.alpha (encodings.* branch 6) | number | | | Tint weight at the cap; default 0.18, and 0.26 on scale 'status', where every painted cell takes it. Text stays readable up to 0.18 on every shipped theme and up to 0.35 on a status ground; above that the figures take the contrast ink. |
216
+ | encodings.*.excludeTotals (encodings.* branch 6) | boolean | | | Leave total rows untinted; default true. Heat reads a variance, and a total has none worth colouring. |
217
+ | encodings.*.steps (encodings.* branch 6) | integer | | | Band count. 5 gives the cohort ladder: 6 / 14 / 26 / 42 % of the ink over the background, then the full ink with inverse text, from the theme token surface.heatSteps. A stepped lane measures the data rows only, so a closing row does not set the scale. |
218
+ | encodings.*.scale (encodings.* branch 6) | string | `'column'`, `'absolute'`, `'diverging'`, `'status'` | | Where a band comes from. 'column' (default) normalises over this column's own min and max; with two or more such columns the table adds the note that shading compares values within each column. 'absolute' cuts at bins, so every column of a grid reads on one scale. 'diverging' measures the distance from the column average and paints good above and bad below; under polarity 'lowerIsBetter' the sides swap. 'status' is a traffic light against the same centre: a value within tolerance of it paints warn, farther above good and farther below bad, the other way round on a column with polarity lowerIsBetter; it reads no steps, bins, span or cap. |
219
+ | encodings.*.bins (encodings.* branch 6) | array | | | Ascending band edges. On scale 'absolute' a value takes the band of the last edge it reaches (e.g. [30, 40, 50, 60] gives five bands); on 'diverging' they are the \|distance\| edges, default [1, 4]. Given without steps, they set the band count themselves. |
220
+ | encodings.*.span (encodings.* branch 6) | number | | | Spread that fills a column ramp. Measured in column units; a smaller spread takes bands from the lightest up, so a spread of 1 point is not painted like one of 30. Omitted, every column's own min and max fill the ramp. |
221
+ | encodings.*.center (encodings.* branch 6) | string | `'total'` | | Centre: column total. On scales 'diverging' and 'status' a reader can check every band against that printed figure. Omitted, or in a column without a total row value, the centre is the average of the column's data rows. |
222
+ | encodings.*.tolerance (encodings.* branch 6) | object | | | Warn band of scale 'status'. A value at most this far from the centre paints warn, the boundary included; default { pct: 5 }. Give exactly one of pct and abs. |
223
+ | encodings.*.tolerance.pct (encodings.* branch 6) | number | | | Percent of the centre. 5 reads 62 to 68 as warn around 65. |
224
+ | encodings.*.tolerance.abs (encodings.* branch 6) | number | | | Column units. 2 reads 63 to 67 as warn around 65. |
225
+ | encodings.*.columns (encodings.* branch 6) | array | | | Further columns this rule paints. A sixty-column cohort grid names its lane once instead of sixty times, and a column that carries its own entry keeps it. Leave a column out to keep it unshaded. |
226
+ | columnVisibility | object | | | True shows a column and false leaves it out: the ids are data.columnToggles ids on table and column ids elsewhere. Ids: label, range, pp, pl, each displayed period id. The label column stays, so hiding every value column draws labels only and warns. The data still needs its range and prior periods, and order and show still read Range. |
227
+ | columnOverrides | object | | | Settings per generated column. Ids: label, range, pp, pl, each displayed period id. width beats widths. The automatic card form sizes tracks by content and ignores width, except a smaller label width. |
228
+ | columnOverrides.*.width | number | | | Track width in px. It beats the width the type would pick. |
229
+ | columnOverrides.*.align | string | `'left'`, `'right'`, `'center'` | | Alignment of the column: its cell text and, unless headAlign is set, its head. Bars keep starting at the panel origin. |
230
+ | columnOverrides.*.headAlign | string | `'left'`, `'right'`, `'center'` | | Head alignment; defaults to align. |
231
+ | columnOverrides.*.label | string | | | Head text. |
232
+ | columnOrder | array | | | Order of whole blocks; blocks left out follow in default order. Ids: block, periods. block is Range and its comparisons. The label stays first, and only the label and leading block columns pin. |
233
+ | bars | boolean | | | false turns the automatic size bars off. Scale, precision, data and judgement stay. Default true. A table that draws no bars warns option-ignored. |
234
+ | rowVisibility | object | | | False leaves a generated row out. Ids: dimension.total.id, group:<measures[].group as authored>, and group: for the ungrouped section. A key equal to dimension.total.id means the Total. by-member: the whole Total block goes. by-measure: each Total line keeps its label and folds with blank cells, because it carries the KPI name and owns its members, and Total splits go. Facts stay for ratios and judgement. A hidden Total keeps the magnitude and decimals that members print with it, but where widths make a track narrow, format fitting follows the table as drawn, so a member can print 17.5% where the chart with the Total prints 18%. A group id removes its heads. These ids differ from expansion ids: expansion names one row of one variant, and rowVisibility names a block. |
235
+ | totalPosition | string | `'top'`, `'bottom'` | | by-member: where the Total block sits, top (default) or bottom. In by-measure each Total row owns its members, so the key warns option-ignored. It also warns where rowVisibility hides the by-member Total block. |
236
+ | density | string | `'compact'`, `'regular'`, `'relaxed'` | | Cell spacing: 'compact', 'regular' or 'relaxed'. The cohort densities do not apply: every cell holds a value and a change line, and cohort rows are fixed one-liners. |
237
+ | variant | string | `'by-measure'`, `'by-member'` | `'by-measure'` | by-measure: KPI rows over members. by-member: members over KPIs, with the Total block at totalPosition. A fixed height may fold it. |
298
238
  | depth | integer | | `1` | Open rungs: 1 roots folded, 2 one member level open, 3 two levels; the same in both variants. Maximum member levels plus one. Splits add no rung. |
299
239
  | splits | boolean | | `false` | Show split measures under their root measure. |
240
+ | expansion | object | | | Row-id exceptions over depth (id: JSON.stringify([variant, memberId, measureId])). |
241
+ | expansion.expanded | array | | | Row ids to open. |
242
+ | expansion.collapsed | array | | | Row ids to fold. |
300
243
  | order | string \| object | `'sheet'` (or another value of its type) | | Sibling order: sheet, or {by: measure id} on Range values, descending. Ties by id, missing values last. |
301
244
  | order.by | string | | | Stable id or display label. |
302
245
  | order.desc | boolean | | | Descending order; default true. |
@@ -328,7 +271,7 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
328
271
  | widths.period | number | | | Track of each period in px; default 94. |
329
272
  | minimumSample | object | | | Minimum judge base per sum field in BOTH windows (below it: neutral). Default none. |
330
273
 
331
- Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `valueAxis`, `story`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
274
+ Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labels`, `labelPosition`, `valueAxis`, `story`, `hatchStrength`, `rounding`, `annotations`, `groupRule`, `groupAlign`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `legend`, `valueAxis.show`, `valueAxis.gridlines`, `focus`, `labelDensity` with an `option-ignored` warning.
332
275
 
333
276
  ## Annotations
334
277
 
@@ -1236,7 +1179,7 @@ The component draws no switches. The host draws the Variant, Depth, Splits and C
1236
1179
 
1237
1180
  A change of `variant` or `depth` resets the manual folds to the depth defaults, with `expansion` on top. A change of `splits` or of the Changes switch keeps the manual folds. Control `collapsed` only to restore a saved view, and then store `next.collapsed` from every `onViewChange` call. Do not start it with `[]`: an empty list opens every row. Leave it undefined, or pass the saved list.
1238
1181
 
1239
- The `TableChart` host props pass through: `size="container"` with `fallbackSize`, `fit`, `fillHeight`, `stickyLabels`, `rowExtent`, `cellPadX`, `fontMetrics`, `measureWidths`, `hover`, `onRowSelect`, `handleRef` and `onScrollChange`. `toolbar` is false by default. `isRowSelectable(row, { collapsed })` also passes through; `collapsed` is true while the row is folded shut. `mountCollapsed` is false by default here, so the browser paints a leaf row only near the viewport; to capture a whole long table, add the host CSS `.bp-table-grid [data-bp-defer-row]{content-visibility:visible!important}` first. See [React](react.md).
1182
+ The `TableChart` host props pass through: `size="container"` with `fallbackSize`, `fit`, `fillHeight`, `stickyLabels`, `rowExtent`, `cellPadX`, `fontMetrics`, `measureWidths`, `hover`, `onRowSelect`, `handleRef` and `onScrollChange`. `toolbar` is false by default. `isRowSelectable(row, { collapsed })` also passes through; `collapsed` is true while the row is folded shut. `mountCollapsed` is false by default here, so the browser paints a leaf row only near the viewport; to capture a whole long table, set `paintOffscreenRows: true`. See [React](react.md).
1240
1183
 
1241
1184
  Speed: the component compiles the cube again only when `data`, `variant`, `splits` or another option changes. `depth`, `collapsed` and the Changes switch change only the folds or the CSS, so they are fast. The component compares `data` by content: keep it the same object while it does not change (`useMemo`), because a deep compare of a large cube also takes time. Closed rows are not mounted, so the cost grows with the open rows times the period columns. Rows that open fade and slide in over the theme duration `motion.layout` (160 ms by default), and rows that close go at once; `motion: "reduce"` on `BoardplotTheme`, or the reader setting for reduced motion, turns this off. In one development measurement, opening 350 rows with 60 period columns took about 0.6 s. A Day grain over a long range gives one column for each day: offer Day only for short ranges, and use Week or Month for longer ones.
1242
1185
 
@@ -1355,7 +1298,7 @@ Each item names the mistake, the symptom and the fix.
1355
1298
  - **Depth 4.** Symptom: the error `dimswitch depth must be between 1 and 3 (member levels + 1); got 4`. Fix: the maximum depth is the number of member levels plus one; offer depth controls up to that number.
1356
1299
  - **No range or prior block.** Symptom: `invalid-data` with `Exactly one range period is required.` or `Exactly one prior period is required.` Fix: add one period with `kind: "range"` and one with `kind: "prior"`, with facts for the Total and every member.
1357
1300
  - **A format for a money row.** Symptom: `format: "$1.2"` with `scale: "money"` prints no `$` in the cells and no decimals below 1,000. Fix: put the currency in `unit`. `money` sets its own precision. `perUnit` keeps authored precision for fractional values; `count`, `percent` and measures without a scale keep the format.
1358
- - **A format in `options`.** Symptom: the warning `format-unused`. Fix: set `measures[].format`.
1301
+ - **A format in `options`.** Symptom: the warning `option-deprecated`. Fix: set `measures[].format`.
1359
1302
  - **A percent without factor.** Symptom: a share prints 0.4% instead of 38.8%, and the warning `percent-scale-suspect` names the row. Fix: add `factor: 100` to the `div`.
1360
1303
  - **Unknown ids in facts.** Symptom: `invalid-data` with `Unknown member '<id>'; use the total id or a dimension.members id.` or `Unknown period '<id>'; use a periods id.` at `/data/facts/<index>`. Fix: use only the Total id, member ids from `dimension.members` and ids from `periods`.
1361
1304
  - **A narrow render.** Symptom: a KPI label is cut while its unit stays ("… USD"), or a wrapped label overlaps the change tag. Boardplot gives no warning for this yet. Cause: Range, vs prior and every period column keep their widths, and the label column takes the rest of the frame, up to `widths.label` (320 px). A render without `size` is about 780 px wide. Fix: give the table the width the page shows it at, at least the label width plus Range, vs prior and the period columns (about 1,050 px for 4 to 8 weeks), or shorten `unit`.
@@ -1380,6 +1323,10 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
1380
1323
  |---|---|---|
1381
1324
  | by-measure | example | KPIs and their channel members |
1382
1325
  | by-member | example | Channels and their KPIs |
1326
+ | periods-only | example | KPIs by period without the Range and vs prior columns |
1327
+ | range-only | example | KPIs with the Range column alone |
1328
+ | column-overrides | example | KPIs with authored head text, track widths and alignment |
1329
+ | periods-first | example | KPIs with the periods before the Range block |
1383
1330
  | sheet | example | KPIs on the report sheet |
1384
1331
  | statement | example | A contribution-margin statement per order |
1385
1332
  | statement-channels | example | The statement with the channels folded under the Total |
@@ -1391,6 +1338,12 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
1391
1338
  | bands-and-plan | example | Value bands with separate prior and plan changes |
1392
1339
  | thresholds-by-kind | example | Separate thresholds for each change kind |
1393
1340
  | multiple-sample-bases | example | Judge only when both sample fields pass |
1341
+ | no-bars | example | KPIs without the automatic size bars |
1342
+ | no-total-block | example | Channels and their KPIs without the Total block |
1343
+ | total-row-blank | example | KPIs over their members with blank Total cells |
1344
+ | total-bottom | example | Channels and their KPIs with the Total block last |
1345
+ | no-group-heads | example | KPIs without their section heads |
1346
+ | no-group-heads-by-member | example | Channels with grouped KPIs and no group label rows |
1394
1347
  | card-notes-de | torture | German engine notes on a phone card |
1395
1348
 
1396
1349
  ## Not for
@@ -62,13 +62,17 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
62
62
  |---|---|---|---|---|
63
63
  | legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key by default unless visible direct labels name them. 'none' hides the key; unnamed series warn. |
64
64
  | topN | object \| integer | | | Keep the n largest categories by absolute first-series value, or absolute gap for dumbbell, before sorting. Kept categories retain authored order unless sort.categories reorders them. No Others row is drawn; omitted category names are disclosed. Authored rest: true, restLabel, showRestCount or threshold warns that it is ignored when categories are omitted. |
65
+ | columnOverrides | object | | | Settings per generated column. Ids: label, gap. |
66
+ | columnOverrides.*.width | number | | | Track width in px. It beats the width the type would pick. |
67
+ | columnOverrides.*.align | string | `'left'`, `'right'`, `'center'` | | Alignment of the column: its cell text and, unless headAlign is set, its head. Bars keep starting at the panel origin. |
68
+ | columnOverrides.*.headAlign | string | `'left'`, `'right'`, `'center'` | | Head alignment; defaults to align. |
69
+ | columnOverrides.*.label | string | | | Head text. |
65
70
  | axisTitles | object | | | Title of the value axis when it is drawn: under the value-axis tick row, ending at the right edge of the plot. Drawn only when authored. |
66
71
  | axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
67
72
  | variant | string | `'dot'`, `'dumbbell'`, `'lollipop'` | `'dot'` | Dot by default; dumbbell joins paired values and lollipop joins values to the baseline. |
68
73
  | averageMarker | boolean \| object | | | Computed dashed average rule with a solver-placed Ø label, as on bar and column: the mean of every dot of the series in scope ('all' by default, or the listed series). |
69
74
  | averageMarker.scope | string \| array | `'all'` (or another value of its type) | | Series included in the computed average; defaults to 'all'. |
70
- | averageMarker.includePartial | boolean | | | true averages the categories marked partial too. By default they are left out, and the label names the periods the average covers. Column, bar and combo. |
71
- | arrow | boolean | | | Dumbbell only (warning arrow-dumbbell-only otherwise): an arrowhead at the second series' dot shows the direction of change. The connector is painted good or bad by the sign of the change when the second series declares direction, neutral otherwise; a pair whose dots nearly touch keeps a plain connector. |
75
+ | arrow | boolean | | | Dumbbell only: an arrowhead at the second series' dot shows the direction of change. The connector is painted good or bad by the sign of the change when the second series declares direction, neutral otherwise; a pair whose dots nearly touch keeps a plain connector. |
72
76
  | gapColumn | boolean | | | Dumbbell only: prints the gap, second series minus first, signed in a column right of the plot under a head such as 'Gap, pp' (pp for percent values). A highlighted row prints bold. Default false. The column stays off below 576 px canvas width. |
73
77
  | methodNote | boolean | | | Default false. true adds the method footnote that names the marker inside a range as its supplied mid-point. A supplied range.mid is drawn and keyed either way. |
74
78
  | range | object | | | What the drawn ranges are: their key entry and, on request, their bounds as numbers. |
@@ -76,7 +80,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
76
80
  | range.values | boolean | | | Default false. true prints each range's low and high value beside its caps. |
77
81
  | range.midLabel | string | | | The key entry for the open marker that draws each supplied range.mid, for example 'Peer midpoint'. Default 'Midpoint'. When only some rows carry a mid, a note names the others. |
78
82
 
79
- Plus the [shared options](options.md). This type does not accept `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis` with an `option-ignored` warning.
83
+ Plus the [shared options](options.md). This type does not accept `labelPosition`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis` with an `option-ignored` warning.
80
84
 
81
85
  ## Annotations
82
86
 
@@ -85,12 +89,16 @@ An annotation anchor is a category or item id string, or an object with category
85
89
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
86
90
  |---|---|---|---|---|---|
87
91
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
88
- | 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. | |
92
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | |
89
93
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
90
- | 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 | | |
94
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | |
91
95
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
92
- | 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. The arm follows the horizontal value axis and clears the connector. |
93
- | 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. |
96
+ | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. The arm follows the horizontal value axis and clears the connector. |
97
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
98
+ | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
99
+ | line | Draws a straight line between two points or from a text annotation, in the ink and rule width of a bracket; a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the line in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the line starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
100
+ | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
101
+ | box | Draws an unfilled box with two points as opposite corners, wrapping whole category bands, in the ink and rule width of a bracket; text inside the box stays free. | from, to | from: AnchorRef \| { categoryId, value }; to: AnchorRef \| { categoryId, value } | dashed: boolean, default false. Draws the edges in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. from and to are opposite corners, the box has no fill, and text inside it stays free. A { categoryId, value } corner spans that category's whole band, so the box wraps whole bars, values and markers; from and to on one category wrap that category. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
94
102
 
95
103
  ## Sizing
96
104
 
@@ -118,3 +126,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
118
126
  | nps-rows-left | example | The NPS ranking with its row labels aligned left |
119
127
  | highlighted-dumbbell-key | torture | Actual and plan remain distinct |
120
128
  | fraction-reference-line | torture | A fraction target shares the percentage scale |
129
+ | column-overrides | example | columnOverrides sets the widths, alignment and head word of the name and gap columns |