boardplot 0.57.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 (494) hide show
  1. package/CHANGELOG.md +298 -0
  2. package/README.md +48 -14
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-VGSL4NJK.js} +1 -1
  4. package/dist/{ReaderBox-GCIITQCX.js → ReaderBox-MHMXIDAJ.js} +8 -7
  5. package/dist/{annotateEngine-JMZI6QEG.js → annotateEngine-753KQBNN.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-5WSIH4SR.js → chunk-2CQBBN7M.js} +4 -4
  8. package/dist/{chunk-Q7VPTN5X.js → chunk-2ETK5TSA.js} +4 -4
  9. package/dist/{chunk-NO7GRVUU.js → chunk-2ETSI2EL.js} +8 -8
  10. package/dist/{chunk-4RN4OM6I.js → chunk-2GRXHWRH.js} +3 -3
  11. package/dist/{chunk-QFIRPOXR.js → chunk-2HII2B6S.js} +3 -3
  12. package/dist/{chunk-K6Y4HBK7.js → chunk-2LC2H3ZM.js} +1000 -904
  13. package/dist/{chunk-KF3ZHLHQ.js → chunk-2NX7EO7H.js} +5 -5
  14. package/dist/{chunk-D5G67OER.js → chunk-2QI2PK2O.js} +1 -1
  15. package/dist/{chunk-AFA32LHN.js → chunk-2VKQQLP7.js} +62 -36
  16. package/dist/chunk-3DOVXJ6K.js +602 -0
  17. package/dist/{chunk-XJUZC53Y.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-D5RAVZ5C.js → chunk-3HA4IJTO.js} +9 -8
  19. package/dist/{chunk-OTGNVAI4.js → chunk-3HPPTQEW.js} +4 -4
  20. package/dist/{chunk-TGR6PRKG.js → chunk-3KT2647F.js} +4 -2
  21. package/dist/{chunk-UBXIGE2P.js → chunk-3MFVJMP6.js} +2 -2
  22. package/dist/{chunk-JKXJWCJ5.js → chunk-3P3FKPFN.js} +116 -54
  23. package/dist/{chunk-JMOBA5ES.js → chunk-3XAJSMYD.js} +2 -2
  24. package/dist/{chunk-I65OLJ2X.js → chunk-42QKUSHJ.js} +13 -3
  25. package/dist/{chunk-Y5IKCXQR.js → chunk-44JU3VOT.js} +5 -5
  26. package/dist/{chunk-YBYV56FS.js → chunk-44K75CYE.js} +3 -3
  27. package/dist/{chunk-WKWCNS6K.js → chunk-4FNM4D57.js} +5 -5
  28. package/dist/{chunk-UD6U4EF5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-LO3AGGE3.js → chunk-4VV3KUFT.js} +5 -5
  30. package/dist/{chunk-6ZN2XJFI.js → chunk-54YO56IK.js} +1 -1
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-SHAAMKN7.js → chunk-5JEU6MWC.js} +18 -18
  33. package/dist/{chunk-I7KDPCC7.js → chunk-5JIB4VJA.js} +18 -10
  34. package/dist/{chunk-C5SQEYTQ.js → chunk-5OP3E2ZD.js} +153 -65
  35. package/dist/{chunk-BDCKHLUB.js → chunk-5SLBD4BT.js} +72 -304
  36. package/dist/{chunk-2BHLRHF2.js → chunk-5SVGTQTW.js} +4 -4
  37. package/dist/chunk-5U567TYU.js +23 -0
  38. package/dist/{chunk-BFDPY7JM.js → chunk-5ZLF4S7X.js} +11 -6
  39. package/dist/{chunk-73O6AOAA.js → chunk-5ZMTQATF.js} +241 -140
  40. package/dist/{chunk-5JTRCSBN.js → chunk-62BDQTO6.js} +2 -2
  41. package/dist/chunk-64K3V4VN.js +25 -0
  42. package/dist/{chunk-BM2A3IGQ.js → chunk-67YJJJIB.js} +1 -1
  43. package/dist/{chunk-TDDSWNGD.js → chunk-6DJNFT2K.js} +30 -28
  44. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  45. package/dist/{chunk-W5SVS4B6.js → chunk-6JFQCVNN.js} +4 -4
  46. package/dist/{chunk-H2POQ4LB.js → chunk-6XPV6M3Q.js} +4 -4
  47. package/dist/{chunk-XFCBH3TI.js → chunk-6ZDSEITW.js} +3 -3
  48. package/dist/{chunk-LFX5BERN.js → chunk-72HVDLMT.js} +46 -32
  49. package/dist/chunk-75NU5RLX.js +24 -0
  50. package/dist/chunk-76GPN6AT.js +72 -0
  51. package/dist/{chunk-EFKFZNQC.js → chunk-7CAYRPJV.js} +34 -20
  52. package/dist/{chunk-EWR6WVOV.js → chunk-7GWWBHVQ.js} +6 -6
  53. package/dist/{chunk-H6EJ63QN.js → chunk-7NYUFMLJ.js} +143 -82
  54. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  55. package/dist/chunk-A65B23JK.js +113 -0
  56. package/dist/{chunk-XNV7VOIT.js → chunk-A7R6FUS6.js} +4 -4
  57. package/dist/{chunk-KIXNHDXS.js → chunk-AEVGUOPB.js} +5 -5
  58. package/dist/{chunk-IXM6BAM4.js → chunk-AHIK2N72.js} +1 -1
  59. package/dist/{chunk-I3DLERI7.js → chunk-AICO24HJ.js} +5 -2
  60. package/dist/{chunk-LSKCKGCF.js → chunk-AJGSCVVW.js} +2 -2
  61. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  62. package/dist/{chunk-CT4RFZO4.js → chunk-AN2V2LC4.js} +37 -22
  63. package/dist/{chunk-T5MBORBK.js → chunk-AOFUA5XP.js} +1 -1
  64. package/dist/{chunk-7FAO4ICF.js → chunk-BCMEGJRX.js} +2 -2
  65. package/dist/{chunk-H3EWFSWI.js → chunk-BDIKWR45.js} +43 -29
  66. package/dist/{chunk-DJBMA4FW.js → chunk-BG6AIWAK.js} +4 -6
  67. package/dist/{chunk-6XU5XGYV.js → chunk-BOT6W3VB.js} +5 -5
  68. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  69. package/dist/{chunk-6LQKU6YN.js → chunk-BZ67BJBH.js} +11 -10
  70. package/dist/{chunk-2AJWRVZ2.js → chunk-C47POAC5.js} +1 -1
  71. package/dist/{chunk-FJKFYQ5I.js → chunk-C5OBPO4Z.js} +36 -28
  72. package/dist/{chunk-Y7Q3VEYC.js → chunk-CCAAI56H.js} +30 -10
  73. package/dist/{chunk-T3WCDDIL.js → chunk-CDUR3KWV.js} +2 -2
  74. package/dist/{chunk-WE5WVQE4.js → chunk-CMPHT2LS.js} +3 -3
  75. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  76. package/dist/{chunk-JSA3ESEJ.js → chunk-CR5FP5SF.js} +1 -1
  77. package/dist/{chunk-JHWDTV4K.js → chunk-D2TQX7UJ.js} +2 -2
  78. package/dist/{chunk-5TUDYKNL.js → chunk-DEANHDXU.js} +42 -29
  79. package/dist/{chunk-GHFTKVJN.js → chunk-DHGE46UK.js} +1 -1
  80. package/dist/{chunk-ZSYU6LIH.js → chunk-DIHX6NUB.js} +5 -5
  81. package/dist/{chunk-W7Q6PLT4.js → chunk-DILQ34NW.js} +37 -37
  82. package/dist/{chunk-IZRTNCJQ.js → chunk-DJKRYJP7.js} +5 -5
  83. package/dist/{chunk-43PCSBVQ.js → chunk-DKLC6QLF.js} +634 -8
  84. package/dist/{chunk-I6QGYRY4.js → chunk-DNHTMCUP.js} +2 -2
  85. package/dist/{chunk-26WNBTWB.js → chunk-DORE2RHL.js} +5 -5
  86. package/dist/{chunk-WZB6R2ZX.js → chunk-DZYTXZNS.js} +11 -3
  87. package/dist/chunk-E262NRFP.js +39 -0
  88. package/dist/{chunk-O4D27FKH.js → chunk-E5YF236N.js} +4 -1
  89. package/dist/{chunk-5H4HFRDO.js → chunk-EBUK7HJP.js} +5 -5
  90. package/dist/{chunk-YGPLUENN.js → chunk-ECBHC272.js} +132 -83
  91. package/dist/{chunk-KLQKHA3T.js → chunk-EFW43JQJ.js} +5 -5
  92. package/dist/{chunk-VM5CQ7CG.js → chunk-EHRRHSPV.js} +2 -2
  93. package/dist/{chunk-PYGEIPPH.js → chunk-EILNJQMN.js} +32 -12
  94. package/dist/{chunk-KGS5Z7SL.js → chunk-ERDKMZ7O.js} +2 -2
  95. package/dist/{chunk-AFGQXMKT.js → chunk-ETRAPN5G.js} +143 -62
  96. package/dist/{chunk-USFIDSTO.js → chunk-ETUKDEGL.js} +18 -11
  97. package/dist/chunk-F2ET5ZTT.js +49 -0
  98. package/dist/{chunk-HVX2E26J.js → chunk-F3XOBFS4.js} +9 -8
  99. package/dist/{chunk-I4NUYVP5.js → chunk-FB6X7QHA.js} +1 -1
  100. package/dist/{chunk-LW4ZQGVL.js → chunk-FGW54I23.js} +7 -8
  101. package/dist/{chunk-UCIAHSJK.js → chunk-FP5B5XIL.js} +7 -3
  102. package/dist/{chunk-QRZESG66.js → chunk-FRHQGA5Q.js} +64 -239
  103. package/dist/{chunk-YTEJYLU7.js → chunk-FRR7BJ3B.js} +2 -2
  104. package/dist/{chunk-DPUCT567.js → chunk-FVWHEM2N.js} +7 -5
  105. package/dist/{chunk-54HEIM2A.js → chunk-FWSMENKH.js} +2 -2
  106. package/dist/{chunk-F4JAGDPD.js → chunk-FWTUGNSF.js} +8 -8
  107. package/dist/{chunk-HB3TH7GY.js → chunk-FZKDZQ6U.js} +10 -6
  108. package/dist/{chunk-6EE6XEMA.js → chunk-G4FF6G3I.js} +25 -16
  109. package/dist/{chunk-72OJBDRB.js → chunk-GB6BZSTL.js} +52 -41
  110. package/dist/{chunk-QLWUFEKR.js → chunk-GCIHRRDJ.js} +8 -8
  111. package/dist/{chunk-MTCDGSYW.js → chunk-GHCU6OSE.js} +2 -2
  112. package/dist/chunk-GO66OCN7.js +24 -0
  113. package/dist/chunk-GOFS336W.js +24 -0
  114. package/dist/{chunk-JMXNXLAC.js → chunk-GQYT7G4F.js} +2 -2
  115. package/dist/{chunk-TWRFVW3J.js → chunk-GUTLXO7Q.js} +138 -89
  116. package/dist/{chunk-RRPTQGRU.js → chunk-H3VICNTN.js} +1 -1
  117. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  118. package/dist/{chunk-7P7D6WXR.js → chunk-HBQHSZ6S.js} +3 -3
  119. package/dist/{chunk-ZV3SNRJI.js → chunk-HTQGJQZN.js} +4 -2
  120. package/dist/{chunk-VY67Q6CJ.js → chunk-HUQRO6VF.js} +36 -33
  121. package/dist/{chunk-WSKZZ2ZB.js → chunk-I5VDW2XZ.js} +538 -503
  122. package/dist/{chunk-TMXRTYGT.js → chunk-I5VNHDPR.js} +3 -2
  123. package/dist/{chunk-M74H7QYD.js → chunk-IDXYHDQY.js} +1 -1
  124. package/dist/{chunk-IPWUBZ4P.js → chunk-IIWZJ5ZM.js} +1 -1
  125. package/dist/{chunk-HC6WHTBX.js → chunk-IPBOREIY.js} +1 -1
  126. package/dist/chunk-IU335UO7.js +27 -0
  127. package/dist/{chunk-WDAZ2MT4.js → chunk-IVDTP6SV.js} +4 -4
  128. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  129. package/dist/{chunk-PSYPB22T.js → chunk-J4QRB6DQ.js} +5 -5
  130. package/dist/{chunk-CEMXGMQN.js → chunk-JCMGKQVS.js} +3 -3
  131. package/dist/{chunk-XR7VOF2V.js → chunk-JM7UTLF3.js} +25 -13
  132. package/dist/{chunk-VY2NPB2Q.js → chunk-JNDWRV34.js} +4 -4
  133. package/dist/{chunk-SHCW2TCA.js → chunk-JSRQTDZZ.js} +25 -23
  134. package/dist/{chunk-XYUXB5VK.js → chunk-JT3UTEWZ.js} +3 -3
  135. package/dist/{chunk-BO5EJBLH.js → chunk-JUYRDZSV.js} +63 -43
  136. package/dist/{chunk-I5ZADE2U.js → chunk-JVGL2SCN.js} +1 -1
  137. package/dist/{chunk-A6XCVOC5.js → chunk-JY4LTPOV.js} +1 -1
  138. package/dist/chunk-K7XPTQBJ.js +267 -0
  139. package/dist/{chunk-JIH52I36.js → chunk-KGBUXMFP.js} +119 -85
  140. package/dist/{chunk-2KCK63DD.js → chunk-KIE5V3DA.js} +2 -2
  141. package/dist/{chunk-A33MFWHW.js → chunk-KU4PCG4W.js} +2 -2
  142. package/dist/{chunk-MQ5EKWIG.js → chunk-KVBLTAO7.js} +5 -5
  143. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  144. package/dist/{chunk-BY5JGQFZ.js → chunk-KWIP5YRA.js} +4 -4
  145. package/dist/{chunk-JRRSKCGG.js → chunk-LG6M2JTH.js} +3 -3
  146. package/dist/{chunk-KUMJI5B6.js → chunk-LIE2WSB4.js} +17 -14
  147. package/dist/{chunk-KAAB2DIV.js → chunk-LJDATBPB.js} +6 -6
  148. package/dist/{chunk-EHNGPUTO.js → chunk-LMMS675D.js} +5 -5
  149. package/dist/{chunk-ANNQJWDX.js → chunk-LPKGZ664.js} +285 -34
  150. package/dist/{chunk-ZTSJ7NY6.js → chunk-LPMSGO7L.js} +3 -3
  151. package/dist/chunk-LQWINE7K.js +211 -0
  152. package/dist/{chunk-RHBQ2Q5H.js → chunk-MKMMQDIY.js} +60 -43
  153. package/dist/{chunk-RMVCKO6N.js → chunk-MQ4IEDM5.js} +458 -136
  154. package/dist/{chunk-J22ETKDJ.js → chunk-MRM4KJ2O.js} +2 -2
  155. package/dist/{chunk-Z2BDTZDT.js → chunk-MX2OZHIT.js} +97 -39
  156. package/dist/{chunk-IFURKTOL.js → chunk-MXUPMGRY.js} +2 -2
  157. package/dist/{chunk-IUVJVMKS.js → chunk-NHU26HQ7.js} +55 -32
  158. package/dist/{chunk-6KHRMK3I.js → chunk-NQVJ4FPY.js} +158 -75
  159. package/dist/chunk-NZ7FX3AE.js +65 -0
  160. package/dist/{chunk-L2XRUG4P.js → chunk-OALBVELJ.js} +5 -5
  161. package/dist/{chunk-3DUGZ7ML.js → chunk-OGZ4UPYK.js} +46 -31
  162. package/dist/{chunk-7MYJUJZV.js → chunk-OMNB27GM.js} +4 -4
  163. package/dist/{chunk-GS5UG6QD.js → chunk-OO63YP35.js} +1 -1
  164. package/dist/{chunk-RHVP62HI.js → chunk-OPYDTW5Q.js} +5 -5
  165. package/dist/{chunk-4U2WSW6F.js → chunk-OSJN7KDS.js} +65 -36
  166. package/dist/{chunk-EY4OA4OF.js → chunk-OSJXIW6I.js} +370 -785
  167. package/dist/{chunk-NRYERHEI.js → chunk-OVVE42P4.js} +5 -5
  168. package/dist/{chunk-Z257SH5U.js → chunk-OZA7HA6L.js} +1 -1
  169. package/dist/{chunk-WJQX7HBH.js → chunk-OZLKEBCD.js} +2 -2
  170. package/dist/{chunk-DYSEZVIJ.js → chunk-P6DEFCMQ.js} +2 -2
  171. package/dist/{chunk-CIDOL4FO.js → chunk-PDTIQL3B.js} +5 -5
  172. package/dist/{chunk-TQ5HHNM3.js → chunk-PJ5BYZPN.js} +2 -2
  173. package/dist/{chunk-EHQLLZCQ.js → chunk-PK7Z7WRJ.js} +59 -34
  174. package/dist/{chunk-KJLH5EHD.js → chunk-PL6NWB5U.js} +175 -110
  175. package/dist/chunk-PMT75APP.js +94 -0
  176. package/dist/{chunk-KQ2WZ6BY.js → chunk-PP6A4X55.js} +1 -1
  177. package/dist/{chunk-O7Y6RJ4D.js → chunk-PPCH3PLO.js} +11 -11
  178. package/dist/{chunk-IRXTNSZL.js → chunk-PPE6S7WU.js} +40 -22
  179. package/dist/{chunk-VT7PBGL2.js → chunk-PT7KSIEO.js} +23 -36
  180. package/dist/{chunk-GADI2DU7.js → chunk-QAUGRVRU.js} +121 -23
  181. package/dist/{chunk-2X6XY4K4.js → chunk-QMFWZG2P.js} +39 -19
  182. package/dist/{chunk-YB6QGOCO.js → chunk-QZGGCE45.js} +2 -2
  183. package/dist/{chunk-5P4MXWKP.js → chunk-R2RJQ3BM.js} +4 -4
  184. package/dist/{chunk-FAFUMSPR.js → chunk-R7HBIQ63.js} +83 -51
  185. package/dist/{chunk-76UL4CT4.js → chunk-RBNDZLYS.js} +27 -22
  186. package/dist/{chunk-XN7JDII2.js → chunk-RCSY4CT4.js} +230 -107
  187. package/dist/{chunk-OAT6FWKL.js → chunk-RHQRPJHS.js} +5 -5
  188. package/dist/chunk-RI6XQKWJ.js +26 -0
  189. package/dist/{chunk-FX5VZK5F.js → chunk-RJICOOB3.js} +14 -8
  190. package/dist/{chunk-NINK4G7U.js → chunk-RLAVNCQJ.js} +2 -2
  191. package/dist/{chunk-FERP4WS3.js → chunk-ROPPWJQB.js} +11 -10
  192. package/dist/{chunk-SSZB3VXG.js → chunk-SELOV32X.js} +102 -47
  193. package/dist/{chunk-EEBMK6T6.js → chunk-SQI4NWTQ.js} +8 -8
  194. package/dist/{chunk-2WTD3GCR.js → chunk-SRJ74CMG.js} +2 -2
  195. package/dist/{chunk-LSR3SBJ4.js → chunk-STWOURLG.js} +234 -136
  196. package/dist/{chunk-BQIADGJB.js → chunk-SWMFXSVW.js} +5 -5
  197. package/dist/{chunk-5HTGSB6Y.js → chunk-SZ5VGWDY.js} +3 -3
  198. package/dist/{chunk-EDBUVDRI.js → chunk-T26G23RS.js} +359 -86
  199. package/dist/chunk-T7GPIJ4L.js +89 -0
  200. package/dist/{chunk-LGMV7ZV4.js → chunk-TAEB3RU6.js} +5 -5
  201. package/dist/{chunk-YFI5PN5O.js → chunk-TBDIMTRD.js} +34 -11
  202. package/dist/{chunk-HDSHS2QZ.js → chunk-TFFPEWNP.js} +70 -47
  203. package/dist/{chunk-YO5UKKCQ.js → chunk-TMEUK2WS.js} +6 -2
  204. package/dist/{chunk-X5OVVMZX.js → chunk-TVOMGNFQ.js} +1 -1
  205. package/dist/{chunk-JARJP576.js → chunk-TX5FSNAU.js} +435 -29
  206. package/dist/{chunk-LUZ7HXBT.js → chunk-U52PNFPX.js} +1 -1
  207. package/dist/chunk-U74AWJ3X.js +24 -0
  208. package/dist/chunk-UC7LBW7N.js +26 -0
  209. package/dist/{chunk-V3UE3TB7.js → chunk-UCKUAKYQ.js} +2 -2
  210. package/dist/{chunk-62JZL6FW.js → chunk-UCYL3YA7.js} +56 -42
  211. package/dist/{chunk-AKJO6N4K.js → chunk-UD2GI3CS.js} +11 -4
  212. package/dist/{chunk-MOQFYJ3F.js → chunk-ULQIC76A.js} +5 -5
  213. package/dist/{chunk-HFFKN7PA.js → chunk-UY34DDUM.js} +3 -3
  214. package/dist/{chunk-2I76VFMZ.js → chunk-UYMFLWM6.js} +49 -37
  215. package/dist/{chunk-3LNVEE5Z.js → chunk-V7FV66KL.js} +1 -1
  216. package/dist/{chunk-UP4JSNDR.js → chunk-V7NUJEJE.js} +1 -1
  217. package/dist/{chunk-53OEKS4L.js → chunk-VESSIKBG.js} +6 -3
  218. package/dist/{chunk-HGPFEG2L.js → chunk-VRFJAF3R.js} +5 -5
  219. package/dist/chunk-VS2R3OGN.js +34 -0
  220. package/dist/{chunk-EEL2N4Y6.js → chunk-VS5B4J2D.js} +5 -5
  221. package/dist/{chunk-G5BUGYIL.js → chunk-W4R6SGU3.js} +192 -113
  222. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  223. package/dist/{chunk-IW3YUMPI.js → chunk-WFBN2HXR.js} +2 -2
  224. package/dist/{chunk-YCUNFAEE.js → chunk-WJS6SAWA.js} +238 -127
  225. package/dist/{chunk-VFLMBA2M.js → chunk-WQYNKF33.js} +19 -18
  226. package/dist/{chunk-QNLESRH6.js → chunk-WUP6C4ZD.js} +2 -2
  227. package/dist/{chunk-4JNHF6JW.js → chunk-X24WAHHV.js} +84 -40
  228. package/dist/{chunk-GKQLKUMF.js → chunk-X3UCQPVV.js} +41 -32
  229. package/dist/{chunk-TXMS7QUJ.js → chunk-X46PSAJ7.js} +6 -6
  230. package/dist/{chunk-M2OQK2FO.js → chunk-XD5XB22R.js} +2 -2
  231. package/dist/{chunk-AOIZJ7GR.js → chunk-XDIAQEYK.js} +6 -6
  232. package/dist/{chunk-7EQU2TUN.js → chunk-XFPNYHX3.js} +84 -53
  233. package/dist/{chunk-NCCDEUHD.js → chunk-XIBVAKCO.js} +1 -1
  234. package/dist/{chunk-SD6ENKTO.js → chunk-XMX4PCFL.js} +3 -3
  235. package/dist/{chunk-2HD5RY2U.js → chunk-XRRG4MBM.js} +3 -3
  236. package/dist/{chunk-Y5WHM2Q5.js → chunk-XTFO6D4L.js} +1 -1
  237. package/dist/chunk-XWRI3N5O.js +70 -0
  238. package/dist/{chunk-IVQT2E3Y.js → chunk-XXPLPSOE.js} +13 -13
  239. package/dist/{chunk-YNHPPZ7S.js → chunk-XZXZNI7A.js} +1 -1
  240. package/dist/{chunk-QZMLSK43.js → chunk-YEJZ2OYS.js} +294 -145
  241. package/dist/{chunk-GAFEN3H7.js → chunk-Z3WQXVFV.js} +2 -2
  242. package/dist/{chunk-D3PQAVFW.js → chunk-Z6DUNKFU.js} +152 -29
  243. package/dist/{chunk-FF7MV4D4.js → chunk-Z6H5ED2I.js} +1 -1
  244. package/dist/{chunk-CV3NC75L.js → chunk-ZBOOMLHD.js} +1 -1
  245. package/dist/{chunk-ZDD3MJ2H.js → chunk-ZDJ7C64T.js} +1 -1
  246. package/dist/{chunk-OKM5LYYP.js → chunk-ZGZLEUKM.js} +5 -5
  247. package/dist/{chunk-QHPJ5ZKS.js → chunk-ZHRGX225.js} +5 -5
  248. package/dist/{chunk-QYOZ46ZQ.js → chunk-ZIVCPXXL.js} +467 -650
  249. package/dist/{chunk-V62B23VC.js → chunk-ZNRSYS76.js} +8 -2
  250. package/dist/{chunk-UFZXZJJG.js → chunk-ZSLTSCTI.js} +5 -5
  251. package/dist/{chunk-NIDH22DI.js → chunk-ZSYFQSPF.js} +12 -2
  252. package/dist/cli/index.js +8 -3
  253. package/dist/{core-UNX4ZV4M.js → core-43GLGBOY.js} +5 -1
  254. package/dist/{core-T3OSZOVV.js → core-5GI3ERXO.js} +3 -1
  255. package/dist/{core-AMWCZTOT.js → core-5L7TMK7I.js} +5 -1
  256. package/dist/{core-5S5CJHBG.js → core-7TO4OVY5.js} +2 -1
  257. package/dist/{core-BJZEJ63L.js → core-BJVENHFQ.js} +3 -1
  258. package/dist/{core-A7HXVSKB.js → core-BX4MFWKC.js} +2 -1
  259. package/dist/{core-4PW4MXWR.js → core-C3KXTOIZ.js} +4 -1
  260. package/dist/{core-SKMHEA4Y.js → core-C5Y6BFLL.js} +3 -1
  261. package/dist/{core-FTQBESDS.js → core-CLUSJ2SK.js} +3 -1
  262. package/dist/{core-QM34237W.js → core-E3IN2VVH.js} +2 -1
  263. package/dist/{core-4M4RY7MX.js → core-FD67NQOV.js} +3 -1
  264. package/dist/{core-WXZJ7V7S.js → core-FDKMLRAK.js} +4 -1
  265. package/dist/{core-L3UR75IJ.js → core-FL6Z3VVX.js} +4 -1
  266. package/dist/{core-XKXDXALI.js → core-JC7JUFPY.js} +6 -1
  267. package/dist/{core-WP73P4CW.js → core-JF33TADA.js} +5 -1
  268. package/dist/{core-DMDAXVMY.js → core-JH32ZAKM.js} +2 -1
  269. package/dist/{core-GS4DXDDG.js → core-JYYZPPQV.js} +4 -1
  270. package/dist/{core-N2JEWJ7D.js → core-KJTKCV4U.js} +2 -1
  271. package/dist/{core-7XKNJM7Y.js → core-LCQPE5Y6.js} +5 -1
  272. package/dist/{core-ZACFV6XR.js → core-LHVGWE54.js} +5 -1
  273. package/dist/{core-VT35VDVS.js → core-OVSNBOCE.js} +6 -1
  274. package/dist/{core-AVA4XLQ2.js → core-PPEC236B.js} +2 -1
  275. package/dist/{core-QFAVWFI3.js → core-QTJZDK5H.js} +2 -1
  276. package/dist/{core-VWYXK2R3.js → core-R3YZCOUZ.js} +4 -1
  277. package/dist/{core-OFPPRHYY.js → core-RIBW5XU4.js} +3 -1
  278. package/dist/{core-MAW4S3KA.js → core-RJFILBWL.js} +5 -1
  279. package/dist/{core-FCSA74RT.js → core-RWSXEKTE.js} +3 -1
  280. package/dist/{core-WPEYRK6Y.js → core-SOPPZLEH.js} +4 -1
  281. package/dist/{core-EMSJRGSE.js → core-TBUZCXLX.js} +2 -1
  282. package/dist/{core-OBPTBKX6.js → core-TZ5QLTAX.js} +2 -1
  283. package/dist/{core-JDZDBTID.js → core-U7E5W4MY.js} +2 -1
  284. package/dist/{core-ZSERZGK6.js → core-UBNVSL44.js} +3 -1
  285. package/dist/{core-WNT6ZMRO.js → core-UDRD4WIU.js} +2 -1
  286. package/dist/{core-VRVL6LIM.js → core-UVJZ4HY2.js} +3 -1
  287. package/dist/{core-7TTM4KRP.js → core-X7WWYQH4.js} +3 -1
  288. package/dist/{core-D2OIGYC7.js → core-XP56X47I.js} +4 -1
  289. package/dist/{core-CCB3IXGD.js → core-XQG54CYG.js} +3 -1
  290. package/dist/{dataTable-7IO546LM.js → dataTable-U7W4I6IF.js} +7 -2
  291. package/dist/{engine-US3N6UCH.js → engine-O5V26MGR.js} +23 -18
  292. package/dist/fixtures.js +2 -1
  293. package/dist/flags-BVLSAXT3.js +10 -0
  294. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  295. package/dist/geo/dach.js +1 -1
  296. package/dist/geo/de-states.js +1 -1
  297. package/dist/geo/eu27.js +1 -1
  298. package/dist/geo/europe.js +1 -1
  299. package/dist/geo/index.js +2 -2
  300. package/dist/geo/us-states.js +1 -1
  301. package/dist/geo/world.js +1 -1
  302. package/dist/index.js +27 -20
  303. package/dist/{main-2UWKGUHR.js → main-35GS47XC.js} +50 -119
  304. package/dist/mcp/server.js +121 -118
  305. package/dist/react/bar.js +5 -1
  306. package/dist/react/bartable.js +3 -1
  307. package/dist/react/box.js +3 -1
  308. package/dist/react/bullet.js +4 -1
  309. package/dist/react/butterfly.js +5 -1
  310. package/dist/react/choropleth.js +3 -1
  311. package/dist/react/cohort.js +3 -1
  312. package/dist/react/column.js +5 -1
  313. package/dist/react/combo.js +5 -1
  314. package/dist/react/creative.js +4 -1
  315. package/dist/react/diagram.js +3 -1
  316. package/dist/react/dimswitch.js +6 -1
  317. package/dist/react/dot.js +4 -1
  318. package/dist/react/export.js +29 -18
  319. package/dist/react/funnel.js +4 -1
  320. package/dist/react/gantt.js +3 -1
  321. package/dist/react/grid.js +6 -1
  322. package/dist/react/heatmap.js +3 -1
  323. package/dist/react/histogram.js +6 -1
  324. package/dist/react/index.js +92 -85
  325. package/dist/react/kpi.js +4 -1
  326. package/dist/react/likert.js +6 -1
  327. package/dist/react/line.js +4 -1
  328. package/dist/react/mekko.js +5 -1
  329. package/dist/react/pareto.js +6 -1
  330. package/dist/react/pie.js +4 -1
  331. package/dist/react/prepare.js +35 -22
  332. package/dist/react/pvm.js +6 -1
  333. package/dist/react/pyramid.js +5 -1
  334. package/dist/react/sankey.js +3 -1
  335. package/dist/react/scatter.js +3 -1
  336. package/dist/react/slope.js +4 -1
  337. package/dist/react/sparkline.js +4 -1
  338. package/dist/react/spec.js +17 -13
  339. package/dist/react/status.js +3 -1
  340. package/dist/react/story.js +3 -2
  341. package/dist/react/table.js +4 -1
  342. package/dist/react/theme.js +5 -3
  343. package/dist/react/tilemap.js +3 -1
  344. package/dist/react/treemap.js +3 -1
  345. package/dist/react/variance.js +5 -1
  346. package/dist/react/waffle.js +3 -1
  347. package/dist/react/waterfall.js +5 -1
  348. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  349. package/dist/rows.js +2 -2
  350. package/dist/{rowsModule-DYDVHBAX.js → rowsModule-H2S6WW4D.js} +1 -1
  351. package/dist/{schema-YDZCGL56.js → schema-2R32F6AW.js} +1 -3
  352. package/dist/{schema-A2XUZUCV.js → schema-2TPGJGVR.js} +1 -3
  353. package/dist/{schema-MD22QYZU.js → schema-47BG2TZA.js} +1 -3
  354. package/dist/{schema-HEB6ZDI5.js → schema-56MOEOVR.js} +1 -3
  355. package/dist/{schema-K4V4PYBO.js → schema-5MSR4LNN.js} +1 -3
  356. package/dist/{schema-NOBNFD2F.js → schema-5RIYEWE6.js} +1 -3
  357. package/dist/{schema-PHIHMDVB.js → schema-A26ZNGTZ.js} +1 -3
  358. package/dist/{schema-OXO2XY4Y.js → schema-ALBF6V7Y.js} +1 -3
  359. package/dist/{schema-F2Q6MH7W.js → schema-BA6WP5YZ.js} +1 -3
  360. package/dist/{schema-G5KSSI5W.js → schema-CBL2SMVR.js} +1 -3
  361. package/dist/{schema-WFGDVBJK.js → schema-CWKGLDSR.js} +1 -3
  362. package/dist/{schema-DHMMGDTI.js → schema-DBIQFL56.js} +1 -3
  363. package/dist/{schema-626QXX4G.js → schema-DL7V6NN2.js} +1 -3
  364. package/dist/{schema-FC6J6KZC.js → schema-DUVJMFKQ.js} +1 -3
  365. package/dist/{schema-LGLQBRC4.js → schema-ECJERHKF.js} +1 -2
  366. package/dist/{schema-4JRNXEZF.js → schema-EDSEKZDJ.js} +1 -3
  367. package/dist/{schema-I44IDRGD.js → schema-ESR6ZIK4.js} +1 -3
  368. package/dist/{schema-FSYDLMGD.js → schema-F7TWGLRZ.js} +1 -3
  369. package/dist/{schema-JCU6LTYD.js → schema-FGB6IGZM.js} +1 -3
  370. package/dist/{schema-MGETMQYC.js → schema-FKGGTM4Z.js} +1 -2
  371. package/dist/{schema-6PL46VXZ.js → schema-FU2AFIEE.js} +1 -3
  372. package/dist/{schema-XIHAKX3B.js → schema-JNJFCYBM.js} +1 -1
  373. package/dist/{schema-6V5K3J2V.js → schema-JYZ4RF6S.js} +1 -3
  374. package/dist/{schema-GXOG4MXL.js → schema-K7F6TEDK.js} +1 -2
  375. package/dist/{schema-NMIYKGHE.js → schema-KAK6DZX4.js} +1 -3
  376. package/dist/{schema-XRSORYBI.js → schema-MOKWIGF7.js} +1 -3
  377. package/dist/{schema-3KMU5737.js → schema-MQT6BMNK.js} +1 -3
  378. package/dist/{schema-JJWORI7D.js → schema-MR3BPPQR.js} +1 -3
  379. package/dist/{schema-IFTIMTS3.js → schema-OPXZYIW7.js} +1 -3
  380. package/dist/{schema-UXWKA3PI.js → schema-PV7JGX5H.js} +1 -3
  381. package/dist/{schema-CNJ4Y6CT.js → schema-PWPQF5RC.js} +1 -3
  382. package/dist/{schema-WBOPCTPC.js → schema-PYQEUC5P.js} +1 -3
  383. package/dist/{schema-J4HCSD5C.js → schema-QPIC5MAG.js} +6 -2
  384. package/dist/{schema-IUY7VYHJ.js → schema-R42VXFIS.js} +1 -3
  385. package/dist/{schema-WX2RS4OU.js → schema-TVUJNEX7.js} +1 -3
  386. package/dist/{schema-FGE5YK3S.js → schema-Y4TI2T3T.js} +1 -3
  387. package/dist/{schema-MQB6CE5V.js → schema-ZU2EU2VP.js} +1 -3
  388. package/dist/{specValidation-XGELWQUU.js → specValidation-2NHJT7TQ.js} +3 -1
  389. package/dist/theme.js +4 -3
  390. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  391. package/dist/types/core/annotate.d.ts +27 -2
  392. package/dist/types/core/annotateArms.d.ts +3 -1
  393. package/dist/types/core/annotateTargets.d.ts +4 -0
  394. package/dist/types/core/annotationOrigin.d.ts +13 -0
  395. package/dist/types/core/axis.d.ts +2 -2
  396. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  397. package/dist/types/core/charts/column/model.d.ts +13 -0
  398. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  399. package/dist/types/core/charts/gantt/calendar.d.ts +4 -0
  400. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  401. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  402. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  403. package/dist/types/core/charts/pvm/types.d.ts +1 -0
  404. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  405. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  406. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  407. package/dist/types/core/charts/table/resolve.d.ts +8 -3
  408. package/dist/types/core/charts/table/view.d.ts +24 -1
  409. package/dist/types/core/claims/browser.d.ts +2 -0
  410. package/dist/types/core/claims/ids.d.ts +38 -0
  411. package/dist/types/core/deferred.d.ts +1 -0
  412. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  413. package/dist/types/core/formatSpec.d.ts +33 -14
  414. package/dist/types/core/frame.d.ts +25 -58
  415. package/dist/types/core/frameText.d.ts +203 -0
  416. package/dist/types/core/geometry.d.ts +2 -0
  417. package/dist/types/core/label/categoryRow.d.ts +19 -2
  418. package/dist/types/core/label/solver.d.ts +23 -2
  419. package/dist/types/core/normalize/shared.d.ts +12 -2
  420. package/dist/types/core/notes.d.ts +15 -2
  421. package/dist/types/core/reading.d.ts +12 -1
  422. package/dist/types/core/request.d.ts +1 -1
  423. package/dist/types/core/schema/capability.d.ts +12 -0
  424. package/dist/types/core/seriesIdentity.d.ts +4 -1
  425. package/dist/types/core/sizing.d.ts +32 -1
  426. package/dist/types/core/structureCounts.d.ts +3 -1
  427. package/dist/types/core/theme.d.ts +33 -4
  428. package/dist/types/core/themeRules.d.ts +2 -0
  429. package/dist/types/core/types/annotations.d.ts +74 -4
  430. package/dist/types/core/types/options.d.ts +35 -3
  431. package/dist/types/core/types/scene.d.ts +30 -2
  432. package/dist/types/core/types/table.d.ts +6 -0
  433. package/dist/types/core/types/theme.d.ts +23 -0
  434. package/dist/types/react/TableChart.d.ts +5 -0
  435. package/dist/validate.js +13 -6
  436. package/docs/TELEMETRY.md +2 -2
  437. package/docs/manual.md +252 -62
  438. package/docs/reference/bar.md +12 -4
  439. package/docs/reference/bartable.md +2 -2
  440. package/docs/reference/box.md +8 -4
  441. package/docs/reference/bullet.md +9 -5
  442. package/docs/reference/butterfly.md +10 -5
  443. package/docs/reference/choropleth.md +3 -5
  444. package/docs/reference/cohort.md +1 -1
  445. package/docs/reference/column.md +18 -4
  446. package/docs/reference/combo.md +10 -5
  447. package/docs/reference/creative.md +3 -7
  448. package/docs/reference/diagram.md +1 -1
  449. package/docs/reference/dimswitch.md +23 -88
  450. package/docs/reference/dot.md +9 -5
  451. package/docs/reference/fixtures.md +37 -1
  452. package/docs/reference/funnel.md +9 -5
  453. package/docs/reference/gantt.md +8 -15
  454. package/docs/reference/grid.md +5 -2
  455. package/docs/reference/heatmap.md +10 -6
  456. package/docs/reference/kpi.md +1 -1
  457. package/docs/reference/likert.md +9 -4
  458. package/docs/reference/line.md +18 -5
  459. package/docs/reference/mekko.md +10 -5
  460. package/docs/reference/options.md +17 -13
  461. package/docs/reference/pareto.md +8 -4
  462. package/docs/reference/pie.md +9 -5
  463. package/docs/reference/pvm.md +9 -5
  464. package/docs/reference/pyramid.md +8 -4
  465. package/docs/reference/react.md +5 -5
  466. package/docs/reference/sankey.md +2 -2
  467. package/docs/reference/scatter.md +8 -4
  468. package/docs/reference/slope.md +9 -5
  469. package/docs/reference/sparkline.md +1 -1
  470. package/docs/reference/status.md +1 -1
  471. package/docs/reference/table.md +33 -114
  472. package/docs/reference/theme.md +12 -4
  473. package/docs/reference/tilemap.md +2 -4
  474. package/docs/reference/treemap.md +1 -1
  475. package/docs/reference/variance.md +12 -6
  476. package/docs/reference/waffle.md +1 -1
  477. package/docs/reference/warnings.md +1077 -0
  478. package/docs/reference/waterfall.md +16 -4
  479. package/docs/use-cases.md +25 -13
  480. package/llms.txt +19 -6
  481. package/package.json +18 -3
  482. package/dist/chunk-5RHP7YTL.js +0 -24
  483. package/dist/chunk-6VU2XI3W.js +0 -89
  484. package/dist/chunk-6WJOHZPW.js +0 -26
  485. package/dist/chunk-FL3FQ2YA.js +0 -27
  486. package/dist/chunk-G5CELEUR.js +0 -26
  487. package/dist/chunk-M4SPKUZE.js +0 -7
  488. package/dist/chunk-OF7FMGH5.js +0 -24
  489. package/dist/chunk-S2TSXUYP.js +0 -24
  490. package/dist/chunk-TKERVBJ3.js +0 -23
  491. package/dist/chunk-VMGTNB6H.js +0 -25
  492. package/dist/chunk-WZL4EEBS.js +0 -11
  493. package/dist/chunk-YJGFT63R.js +0 -27
  494. package/dist/chunk-ZNX5J7D7.js +0 -47
@@ -144,13 +144,17 @@ An annotation anchor is a category or item id string, or an object with category
144
144
  |---|---|---|---|---|---|
145
145
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. attainment: boolean \| { seriesId, direction }. Shades each category between its actual and the line. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
146
146
  | indicator100 | Maps 100 through the chart's value scale and draws a side tick with a 100% label. | | | side: left \| right, default left. Side of the plot the 100% mark sits on. | No anchor is required. The chart needs a value scale that can represent 100. |
147
- | 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. |
147
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
148
148
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
149
- | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | Drawn reference series accept anchors. |
149
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | Drawn reference series accept anchors. |
150
150
  | 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. |
151
- | 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. |
151
+ | 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. |
152
152
  | 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). |
153
- | 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. |
153
+ | 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. |
154
+ | 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. |
155
+ | 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. |
156
+ | 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. |
157
+ | 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. |
154
158
 
155
159
  ## Dense value labels
156
160
 
@@ -196,6 +200,8 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
196
200
  | option-dashed-connectors | example | Product mix across quarters |
197
201
  | plan-corridor | example | Horizontal plan corridor on regional revenue |
198
202
  | grouped-cloud-cagr | example | Grouped bars with a series CAGR arrow and last-year difference |
203
+ | diff-on-arrow | example | Difference between two regions on its arrow |
204
+ | diff-beside-arrow | example | Difference with placement 'label': the arrow off the rows |
199
205
  | tolerance-band | example | Regional values against an authored tolerance band |
200
206
  | bar-compact-380 | example | Bar in a 380px dashboard column |
201
207
  | torture-long-labels | torture | Torture: long names at a generous size read whole, never cut |
@@ -226,3 +232,5 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
226
232
  | option-small-values-p-value | torture | Every rate prints as an APA p-value (smallValues p-value) |
227
233
  | key-left | example | Stacked bars with the key in a column left of the plot |
228
234
  | column-overrides | example | columnOverrides sets the width of the name column |
235
+ | centered-values | example | Bar values at the center |
236
+ | drawing-on-value-axis | example | A line at the top level and an arrow over the gap, on a horizontal value axis |
@@ -122,12 +122,12 @@ Table rows with number columns and stacked bars. One panel when the rows compare
122
122
  | cascade.share | boolean | | | Computed share column beside each panel; default true. rounding defaults to 'sum-consistent' here, so each adds up to 100%. |
123
123
  | cascade.growth | object | | | Growth column after the last panel. |
124
124
  | cascade.growth.measure | string | `'cagr'`, `'share-change'` | | 'cagr': each row's CAGR, first panel to last, in %. 'share-change': last share minus first, in pp. |
125
- | cascade.growth.years | number | | | Years from first to last panel for 'cagr'; default read from the panel labels (2019, FY24). |
125
+ | cascade.growth.years | number | | | Years from first to last panel for 'cagr'; default read from the panel labels (2019, FY24). 'share-change' reads no years and warns option-ignored. |
126
126
  | cascade.growth.label | string | | | Column head; default from the panel labels. |
127
127
  | sharedScale | boolean | | | false: each panel its own scale. true: one scale, panel width follows its longest bar; weights refused. Default false, true under cascade. |
128
128
  | heightFill | string | `'rows'`, `'none'` | `'rows'` | Spare canvas height. 'rows' (default): a pinned canvas stretches the rows up to 1.25 times their pitch and thickens the bars. 'none': natural pitch. |
129
129
 
130
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `hatchStrength`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
130
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis`, `hatchStrength`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines`, `highlight` with an `option-ignored` warning.
131
131
 
132
132
  ## Annotations
133
133
 
@@ -62,7 +62,7 @@ One form; its chart ID is `box`.
62
62
  | methodNote | boolean | | `false` | Default false. true adds the footnote stating the quartile definition and the Tukey whisker rule. A 'minmax' or 'p10p90' whisker rule changes what whiskers and dots mean, so its note prints regardless, as do the small-n dot note and the note on withheld observations. |
63
63
  | boxValues | string | `'median'`, `'all'` | `'median'` | Default 'median': each box prints its median. 'all' also prints Q1 and Q3 under the box edges and the whisker ends under the caps, so a quartile or percentile reads as a number. |
64
64
 
65
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.tickStep`, `valueAxis.includeZero`, `valueAxis.percent`, `valueAxis.log`, `valueAxis.reverse`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `legend` with an `option-ignored` warning.
65
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis.tickStep`, `valueAxis.includeZero`, `valueAxis.percent`, `valueAxis.log`, `valueAxis.reverse`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `legend` with an `option-ignored` warning.
66
66
 
67
67
  ## Annotations
68
68
 
@@ -70,9 +70,13 @@ An annotation anchor is a category or item id string, or an object with category
70
70
 
71
71
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
72
72
  |---|---|---|---|---|---|
73
- | 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. |
74
- | 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. |
75
- | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
73
+ | 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. |
74
+ | 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. |
75
+ | 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. | |
76
+ | 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. |
77
+ | 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. |
78
+ | 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. |
79
+ | 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. |
76
80
 
77
81
  ## Sizing
78
82
 
@@ -68,7 +68,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
68
68
  | targetColumns | boolean | | `true` | true: where the rows sit side by side and the plot keeps 45% of the width, a Target column and a Gap-to-target column print beside the rows, each under a head, with the gap's position (below, above or on target) under it and the row's direction (higher or lower is better) under its name. Where they do not fit, the target prints above its tick and the delta at the row end. false: always the second form. Default true. The percentOfTarget scale has its own columns. |
69
69
  | density | string | `'compact'`, `'regular'` | `'regular'` | 'compact' is the 120 x 28 text-free mark: bar, bands and target tick, no labels, axis or key. The percentOfTarget scale needs a key and a value column, so compact refuses it. 'regular' uses labelled stacked rows when side columns take too much plot width. Height depends on row count and text. Default 'regular'. |
70
70
 
71
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN` with an `option-ignored` warning.
71
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN` with an `option-ignored` warning.
72
72
 
73
73
  ## Annotations
74
74
 
@@ -76,14 +76,18 @@ An annotation anchor is a category or item id string, or an object with category
76
76
 
77
77
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
78
78
  |---|---|---|---|---|---|
79
- | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. A thin arrow from the text to the anchored point; the first line sits level with the point, right or left of it, where there is room. Not with icon or status. Example: "arrow": true. | |
79
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. 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. | |
80
80
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
81
- | 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 | | |
81
+ | 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. | |
82
82
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
83
- | 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. |
84
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. 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. |
83
+ | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
84
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
85
85
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. attainment: boolean \| { seriesId, direction }. Shades each category between its actual and the line. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
86
86
  | band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
87
+ | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
88
+ | 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. |
89
+ | 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. |
90
+ | 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. |
87
91
 
88
92
  ## Sizing
89
93
 
@@ -80,7 +80,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
80
80
  | sharedScale | boolean | | `true` | Use the same value scale on both sides by default. False gives independent scales and warns that lengths are not comparable. |
81
81
  | negatives | string | `'direction'`, `'magnitude'` | `'direction'` | A negative value: direction (default) runs its bar from the pane's zero line toward the category names, and positive bars run outward; magnitude draws the bar length of the absolute value outward in a lighter tint. |
82
82
 
83
- Plus the [shared options](options.md). This type does not accept `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
83
+ Plus the [shared options](options.md). This type does not accept `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `valueAxis.show`, `valueAxis.gridlines`, `topN.threshold` with an `option-ignored` warning.
84
84
 
85
85
  ## Annotations
86
86
 
@@ -88,12 +88,16 @@ An annotation anchor is a category or item id string, or an object with category
88
88
 
89
89
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
90
90
  |---|---|---|---|---|---|
91
- | 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. |
92
- | 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 | | |
93
- | 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. |
91
+ | 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. |
92
+ | 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. | |
93
+ | 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. |
94
94
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
95
- | 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. | |
95
+ | 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. | |
96
96
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
97
+ | 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. |
98
+ | 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. |
99
+ | 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. |
100
+ | 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. |
97
101
 
98
102
  ## Sizing
99
103
 
@@ -124,6 +128,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
124
128
  | blank-values | torture | A value the data lacks prints the not-applicable mark at the pane start |
125
129
  | own-scales-mixed | torture | Panes of very different size on their own scales each draw a value axis |
126
130
  | column-overrides | example | columnOverrides sets the name column and the difference column, beating centerColumnWidth |
131
+ | centered-values | example | Butterfly values at the center |
127
132
 
128
133
  ## Not for
129
134
 
@@ -57,15 +57,13 @@ One form; its chart ID is `choropleth`.
57
57
  | overlays[].glyph.shares[].tone (overlays[].glyph branch 1) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
58
58
  | overlays[].glyph.kind (overlays[].glyph branch 2) | string | yes | Draw a fractionally filled Harvey ball. One of `'harvey'`. |
59
59
  | overlays[].glyph.value (overlays[].glyph branch 2) | number | yes | Filled fraction from 0, empty, to 1, full. |
60
- | overlays[].glyph.tone (overlays[].glyph branch 2) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
60
+ | overlays[].glyph.tone (overlays[].glyph branch 2 \| overlays[].glyph branch 4 \| overlays[].glyph branch 5) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
61
61
  | overlays[].glyph.kind (overlays[].glyph branch 3) | string | yes | Draw a semantic status glyph. One of `'status'`. |
62
62
  | overlays[].glyph.status (overlays[].glyph branch 3) | string | yes | Status judgment shown by the glyph. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`. |
63
63
  | overlays[].glyph.kind (overlays[].glyph branch 4) | string | yes | Draw a named built-in icon. One of `'icon'`. |
64
64
  | overlays[].glyph.name (overlays[].glyph branch 4) | string | yes | Name from the built-in icon catalogue: alert calendar check conversation document flag gear lightbulb lock people star target workflow. |
65
- | overlays[].glyph.tone (overlays[].glyph branch 4) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
66
65
  | overlays[].glyph.kind (overlays[].glyph branch 5) | string | yes | Draw a geometric location marker. One of `'marker'`. |
67
66
  | overlays[].glyph.shape (overlays[].glyph branch 5) | string | | Marker outline; defaults to circle. One of `'circle'`, `'square'`, `'diamond'`. |
68
- | overlays[].glyph.tone (overlays[].glyph branch 5) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
69
67
  | overlays[].label | string | yes | Readable name for this overlay or pie share. |
70
68
  | overlays[].size | string | | Glyph size tier; defaults to md. One of `'sm'`, `'md'`, `'lg'`. |
71
69
  | overlays[].a11y | string | | Authored accessible description for the overlay. |
@@ -97,7 +95,7 @@ One form; its chart ID is `choropleth`.
97
95
  | overlayTones.info | string | | | What the info tone marks on this map. |
98
96
  | overlayMeasure | string | | | The measure the overlay glyphs show, e.g. 'Activation progress, %'. The overlay key prints it as a heading without a category swatch, apart from the colour key; Harvey-ball overlays without it warn geo-overlay-measure-unnamed. |
99
97
  | keyTitle | string | | | Title of the colour key, naming what the colours measure. Default 'Measure, unit' from subtitle.measure and unit, else the unit alone; set it when the subtitle is drawn elsewhere. |
100
- | valueTable | string \| false | `'auto'`, `'side'`, `'below'`, `false` | | The table of every region with its class swatch, code and value; the top values print bold and the map then prints codes only. 'auto' (default): beside the map when the map keeps most of the row, else under it; off above 20 regions, without numeric values, or when a pinned canvas is too short for it. 'side' or 'below' forces the place; false leaves it off. |
98
+ | valueTable | string \| false | `'auto'`, `'side'`, `'below'`, `false` | | The table of every region with its class swatch, code and value; the top values print bold and the map then prints codes only. 'auto' (default): beside the map when the map keeps most of the row, else under it; off above 20 regions, without numeric values, or when a pinned canvas is too short for it; an authored 'auto' that the region count turns off warns option-ignored. 'side' or 'below' forces the place; false leaves it off. |
101
99
  | valueTableEmphasis | string \| false | `'top'`, `false` | | 'top' (default) sets the top values bold in the value table and on the map, with a rule under them. The top group is ranked on all regions. false sets no row and no map label bold. |
102
100
  | columnVisibility | object | | | True shows a column and false leaves it out: the ids are data.columnToggles ids on table and column ids elsewhere. Ids: swatch, code, value. |
103
101
  | columnOverrides | object | | | Settings per generated column. Ids: swatch, code, value. Only value prints a head, so label and headAlign are refused on swatch and code. |
@@ -111,7 +109,7 @@ One form; its chart ID is `choropleth`.
111
109
  | rowOverrides.*.label | string | | | Row name. |
112
110
  | methodNote | boolean | | | Default false. true adds the method footnote on which regions the automatic label policy names. The world pack's endorsement disclaimer stays on the source line and prints once. The inset scale note is required for interpretation and prints regardless. |
113
111
 
114
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `highlight`, `story`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
112
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis`, `highlight`, `story`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
115
113
 
116
114
  ## Annotations
117
115
 
@@ -80,7 +80,7 @@ Cohorts by periods-since-start: counts in, every retention rate derived, weighte
80
80
  | exhibitLabel | string | | | Short exhibit heading above the assertion title. |
81
81
  | heightFill | string | `'rows'`, `'none'` | `'rows'` | Exhibit variants. 'rows' (default): rows take the spare height of a pinned canvas, up to 1.8 times, and stepped columns share the free width. 'none': natural row height, stepped columns at measured width. |
82
82
 
83
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
83
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
84
84
 
85
85
  ## Annotations
86
86
 
@@ -79,6 +79,8 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
79
79
  | grandTotalLabels | boolean | | | Show category stack-total labels in addition to segment labels; default on for the stacked variant and off for stacked100, where every bar would end on the same share. true keeps the absolute total on a 100% stack. |
80
80
  | sharesOfOneWhole | boolean | | | true declares every stacked series a share of the same whole, such as channel shares of all orders: the stack then has a total, and percent series warn non-additive-stack only where a category adds to more than 100. Stacked and stacked100 only; refused on other variants. |
81
81
  | referenceStyle | string | `'tick'`, `'line'`, `'marker'` | `'tick'` | Reference-series mark style; defaults to tick. |
82
+ | referenceTick | object | | | Where the reference tick draws, read under referenceStyle 'tick' only. A tick beside its column (the integrated PY tick of a stacked column) is unchanged. |
83
+ | referenceTick.position | string | `'behind'`, `'front'` | `'behind'` | Where a plan tick draws. 'behind' (default): behind its column, reaching up to 4 px past each side (2 px where a plan value beside it needs the room), so the column stays whole and the ends mark the plan; a column short of its plan prints its value inside its end. 'front': over the column on a page-colour band, 2 px past each side, the earlier look. |
82
84
  | netLine | boolean \| object | | | Per-category ticks at a cumulative boundary of stacked columns, connected by default. |
83
85
  | netLine.seriesId | string | | | Series whose cumulative boundary receives a tick; omitted uses the positive stack top, or the negative stack bottom when no value is positive. |
84
86
  | netLine.connectors | boolean | | | Connect adjacent category ticks as a stepped line; defaults to true for columns. |
@@ -142,16 +144,20 @@ An annotation anchor is a category or item id string, or an object with category
142
144
 
143
145
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
144
146
  |---|---|---|---|---|---|
145
- | 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. |
146
- | 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. |
147
- | 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. |
147
+ | 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. |
148
+ | 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. |
149
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | Drawn reference series accept anchors. |
148
150
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
149
- | 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. |
151
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | Drawn reference series accept anchors. |
150
152
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. side: left \| right, default right. Side of the plot the label sits on. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. attainment: boolean \| { seriesId, direction }. Shades each category between its actual and the line. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
151
153
  | indicator100 | Maps 100 through the chart's value scale and draws a side tick with a 100% label. | | | side: left \| right, default left. Side of the plot the 100% mark sits on. | No anchor is required. The chart needs a value scale that can represent 100. |
152
154
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | Drawn reference series accept anchors. |
153
155
  | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | label | at: categoryId (optional) | date: ISO date yyyy-mm-dd, in place of at: the event sits at the last category whose date is on or before it, and the block header and the key print it as d MMM. Every category needs an ISO date; a date outside the categories warns event-out-of-range. end: ISO date, with date: the event is a period, drawn as a thin bar to the end of that day. to: Category id, with at: the event is a period to the end of that category. group: Id of a group in options.events.groups, which gives the kind label, tone and glyph. detail: string \| string[]. Authored lines under the title, at most three in the lane; nothing is cut, a longer block moves to the key. items: { label, detail? }[]. More changes on the same date, after this event's own label and detail. The lane and the key draw a compact +N after the title; the hover card, the SVG title and description, and the interaction records list every item in full. placement: auto \| key, default options.events.placement. key numbers this event into the key below the plot. tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. | Exactly one of at (a category id) and date (an ISO date) places the event; end or to makes it a period. The event lane above the plot sets a block of group and date, title and detail with a thin pole to the data; an event that does not fit, a second event on one category and every event under options.events.placement 'key' get a numbered marker and an entry in the key below the plot, numbered in time order; under footnotes: false they are left off and listed in the footnotes-off lint. The full date, title and detail of every event stay in the SVG title and description, the interaction records and the hover card, whether or not the lane or the key prints the detail. In compact mode the lane is one row of numbered markers and the key packs "n date title" into as few lines as the width allows; where the plot would still fall under 80px the key keeps "n title" and the info lint event-lane-compact says so. options.events.rows sets the lane rows (default by canvas width: 1 under 1080px, 2 from 1080px); a row gives way while the plot band left under the lane would keep less than 40% of the canvas height. |
154
156
  | 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). |
157
+ | 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. |
158
+ | 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. |
159
+ | 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. |
160
+ | 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. |
155
161
 
156
162
  ## Dense value labels
157
163
 
@@ -192,6 +198,11 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
192
198
  | stacked100-shares-sum | torture | Torture: 100% stacked shares that add up to 100% in every column |
193
199
  | stacked100-energy-mix | example | Stacked 100% column with absolute totals and 100% indicator |
194
200
  | clustered-brand-gap | example | Clustered columns with value axis, gridlines, and diff arrow |
201
+ | plan-ticks-delta-callout | example | Actual columns with plan ticks, a delta and a callout stacked over the one year below plan |
202
+ | plan-ticks-front | example | Actual columns with plan ticks drawn over the columns |
203
+ | monthly-diff-bracket | example | Twelve monthly columns with a difference in value and percent from the first to the last month |
204
+ | monthly-diff-between | example | Twelve monthly columns with a difference whose arrow stands between the columns |
205
+ | monthly-delta-both | example | Highlighted first and last month with a delta in value and percent |
195
206
  | ranked-dense-staggered | example | Ranked dense columns: staggered values, tick step, dotted grid, muted labels, highlight emphasis |
196
207
  | ratio-tier-zero-denominator | torture | Torture: zero denominator stays visible as n/a in the ratio tier |
197
208
  | negative-stacks | torture | Torture: negatives mixed into stacks, one all-negative column |
@@ -281,3 +292,6 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
281
292
  | option-value-labels-all | example | Every quarter prints its value (valueLabels all) |
282
293
  | grouped-twelve-slide | torture | Two series over twelve units on a full slide print all 24 values |
283
294
  | key-right-slide | example | Clustered columns on a slide with the key in a column right of the plot |
295
+ | inside-base-values | example | Column values inside the base |
296
+ | stacked-inside-base-values | example | Stacked column values inside each base |
297
+ | drawing-kinds | example | A box around the launch months, the old level and an arrow from a note |
@@ -116,7 +116,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
116
116
  | axisTitles.primary | string | | | Visible title above the primary value axis. |
117
117
  | axisTitles.secondary | string | | | Visible title above the active secondary value axis. |
118
118
  | interpolate | string | `'linear'`, `'step-after'`, `'step-before'`, `'monotone'` | | Interpolation for line/area series; per-series smooth overrides it. |
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), 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. |
120
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. |
121
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. |
122
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. |
@@ -146,15 +146,19 @@ An annotation anchor is a category or item id string, or an object with category
146
146
 
147
147
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
148
148
  |---|---|---|---|---|---|
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 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. |
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, 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. |
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 | | 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. |
152
152
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
153
- | 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. |
154
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. |
155
155
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | Drawn reference series accept anchors. |
156
156
  | event | Places a dated event in the lane above the plot as a block with a pole to the data, or, when it does not fit, as a numbered marker with an entry in the event key below the plot; periods draw a thin bar. | label | at: categoryId (optional) | date: ISO date yyyy-mm-dd, in place of at: the event sits at the last category whose date is on or before it, and the block header and the key print it as d MMM. Every category needs an ISO date; a date outside the categories warns event-out-of-range. end: ISO date, with date: the event is a period, drawn as a thin bar to the end of that day. to: Category id, with at: the event is a period to the end of that category. group: Id of a group in options.events.groups, which gives the kind label, tone and glyph. detail: string \| string[]. Authored lines under the title, at most three in the lane; nothing is cut, a longer block moves to the key. items: { label, detail? }[]. More changes on the same date, after this event's own label and detail. The lane and the key draw a compact +N after the title; the hover card, the SVG title and description, and the interaction records list every item in full. placement: auto \| key, default options.events.placement. key numbers this event into the key below the plot. tone: neutral \| bad \| good, default the group tone, else neutral. Column, combo and line paint the glyph, the marker ring and the period bar in it; gantt paints a bad rule. | Exactly one of at (a category id) and date (an ISO date) places the event; end or to makes it a period. The event lane above the plot sets a block of group and date, title and detail with a thin pole to the data; an event that does not fit, a second event on one category and every event under options.events.placement 'key' get a numbered marker and an entry in the key below the plot, numbered in time order; under footnotes: false they are left off and listed in the footnotes-off lint. The full date, title and detail of every event stay in the SVG title and description, the interaction records and the hover card, whether or not the lane or the key prints the detail. In compact mode the lane is one row of numbered markers and the key packs "n date title" into as few lines as the width allows; where the plot would still fall under 80px the key keeps "n title" and the info lint event-lane-compact says so. options.events.rows sets the lane rows (default by canvas width: 1 under 1080px, 2 from 1080px); a row gives way while the plot band left under the lane would keep less than 40% of the canvas height. |
157
157
  | band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
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. |
158
162
 
159
163
  ## Overlay or dual axis
160
164
 
@@ -220,3 +224,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
220
224
  | ranked-campaigns-key-shown | torture | Campaign names too long for their columns read as ranks with the key printed (notes.show) |
221
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) |
222
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. |
@@ -137,7 +133,7 @@ One form; its chart ID is `creative`.
137
133
  | rowOverrides | object | | | Settings per generated row. Ids: ctr, cpa, roas, hookRate, holdRate, frequency. |
138
134
  | rowOverrides.*.label | string | | | Row name. |
139
135
 
140
- 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.
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.
141
137
 
142
138
  ## Annotations
143
139
 
@@ -215,7 +215,7 @@ Set protected only where the claim is true: the lock states that the zone is pro
215
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. |
216
216
  | highlight | string \| array | | | Architecture only: the node and edge ids that carry the message. They take the accent, and everything else recedes. |
217
217
 
218
- 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.
219
219
 
220
220
  ## Annotations
221
221