boardplot 0.57.0 → 0.58.1

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 (496) hide show
  1. package/CHANGELOG.md +311 -0
  2. package/README.md +48 -14
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-FXNTFSA4.js} +2 -2
  4. package/dist/{ReaderBox-GCIITQCX.js → ReaderBox-WVOT7VVJ.js} +8 -7
  5. package/dist/{annotateEngine-JMZI6QEG.js → annotateEngine-57L26X77.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-6LQKU6YN.js → chunk-23FT7RLN.js} +11 -10
  8. package/dist/{chunk-5WSIH4SR.js → chunk-2CQBBN7M.js} +4 -4
  9. package/dist/chunk-2DS4MT7T.js +25 -0
  10. package/dist/{chunk-QFIRPOXR.js → chunk-2HII2B6S.js} +3 -3
  11. package/dist/{chunk-JMOBA5ES.js → chunk-2IRMGCYE.js} +2 -2
  12. package/dist/{chunk-JKXJWCJ5.js → chunk-2SWSUNA4.js} +116 -54
  13. package/dist/{chunk-O7Y6RJ4D.js → chunk-33EBLJVZ.js} +11 -11
  14. package/dist/{chunk-EHQLLZCQ.js → chunk-34PKJZRY.js} +59 -34
  15. package/dist/{chunk-SHAAMKN7.js → chunk-35ZJUZUO.js} +18 -18
  16. package/dist/{chunk-TGR6PRKG.js → chunk-3BMPYY26.js} +6 -3
  17. package/dist/{chunk-XJUZC53Y.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-H3EWFSWI.js → chunk-3ESWPMDW.js} +43 -29
  19. package/dist/{chunk-6KHRMK3I.js → chunk-3M2F7KSS.js} +158 -75
  20. package/dist/{chunk-UBXIGE2P.js → chunk-3MFVJMP6.js} +2 -2
  21. package/dist/{chunk-MOQFYJ3F.js → chunk-3OSQ32GN.js} +5 -5
  22. package/dist/{chunk-HGPFEG2L.js → chunk-3RXUA6VY.js} +5 -5
  23. package/dist/{chunk-I65OLJ2X.js → chunk-42QKUSHJ.js} +13 -3
  24. package/dist/{chunk-FAFUMSPR.js → chunk-4DK67I3B.js} +83 -51
  25. package/dist/{chunk-EEBMK6T6.js → chunk-4DMRIL5K.js} +8 -8
  26. package/dist/chunk-4M3UADCM.js +602 -0
  27. package/dist/{chunk-WSKZZ2ZB.js → chunk-4OJF6DXL.js} +538 -503
  28. package/dist/{chunk-UD6U4EF5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-I7KDPCC7.js → chunk-4TUU3UGY.js} +18 -10
  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-BQIADGJB.js → chunk-5CYLT6FJ.js} +5 -5
  33. package/dist/{chunk-IVQT2E3Y.js → chunk-5I4RPBNE.js} +13 -13
  34. package/dist/{chunk-LW4ZQGVL.js → chunk-5KAYLRRP.js} +7 -8
  35. package/dist/{chunk-2BHLRHF2.js → chunk-5SVGTQTW.js} +4 -4
  36. package/dist/{chunk-5JTRCSBN.js → chunk-62BDQTO6.js} +2 -2
  37. package/dist/{chunk-4RN4OM6I.js → chunk-63JUV7NR.js} +3 -3
  38. package/dist/chunk-645BGVPP.js +26 -0
  39. package/dist/{chunk-JIH52I36.js → chunk-65U6ZBZZ.js} +119 -85
  40. package/dist/{chunk-3DUGZ7ML.js → chunk-6ALORYH7.js} +46 -31
  41. package/dist/{chunk-HB3TH7GY.js → chunk-6AVUTZ6W.js} +10 -6
  42. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  43. package/dist/{chunk-W5SVS4B6.js → chunk-6JFQCVNN.js} +4 -4
  44. package/dist/{chunk-IZRTNCJQ.js → chunk-6JTCFPAD.js} +5 -5
  45. package/dist/{chunk-5TUDYKNL.js → chunk-6NGKQNTB.js} +42 -29
  46. package/dist/{chunk-IUVJVMKS.js → chunk-6V3A3MTG.js} +55 -32
  47. package/dist/{chunk-FJKFYQ5I.js → chunk-6YBNVI5I.js} +36 -28
  48. package/dist/chunk-76GPN6AT.js +72 -0
  49. package/dist/{chunk-SHCW2TCA.js → chunk-7GRR72MY.js} +25 -23
  50. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  51. package/dist/{chunk-Y5IKCXQR.js → chunk-7YZZCQT3.js} +5 -5
  52. package/dist/chunk-A65B23JK.js +113 -0
  53. package/dist/{chunk-2WTD3GCR.js → chunk-A6N24NGW.js} +3 -3
  54. package/dist/{chunk-72OJBDRB.js → chunk-AAQWFTDM.js} +52 -41
  55. package/dist/{chunk-4JNHF6JW.js → chunk-AGJ2QL4A.js} +84 -40
  56. package/dist/{chunk-I3DLERI7.js → chunk-AICO24HJ.js} +5 -2
  57. package/dist/{chunk-LSKCKGCF.js → chunk-AJGSCVVW.js} +2 -2
  58. package/dist/{chunk-7P7D6WXR.js → chunk-AKZOQGF3.js} +3 -3
  59. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  60. package/dist/{chunk-VY67Q6CJ.js → chunk-AMBQ6SWU.js} +36 -33
  61. package/dist/{chunk-73O6AOAA.js → chunk-AQ2PQ7FK.js} +241 -140
  62. package/dist/{chunk-XFCBH3TI.js → chunk-BHLNSJG7.js} +3 -3
  63. package/dist/{chunk-6XU5XGYV.js → chunk-BQ7SN7AW.js} +5 -5
  64. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  65. package/dist/{chunk-LSR3SBJ4.js → chunk-BSZOQJXB.js} +234 -136
  66. package/dist/{chunk-KJLH5EHD.js → chunk-BVIJCUWW.js} +175 -110
  67. package/dist/{chunk-2AJWRVZ2.js → chunk-C47POAC5.js} +1 -1
  68. package/dist/{chunk-AOIZJ7GR.js → chunk-C4SQU2PB.js} +6 -6
  69. package/dist/{chunk-Y7Q3VEYC.js → chunk-CCAAI56H.js} +30 -10
  70. package/dist/{chunk-T3WCDDIL.js → chunk-CDUR3KWV.js} +2 -2
  71. package/dist/{chunk-T5MBORBK.js → chunk-CFESVCZR.js} +1 -1
  72. package/dist/{chunk-EEL2N4Y6.js → chunk-CKEFAD4R.js} +5 -5
  73. package/dist/{chunk-WE5WVQE4.js → chunk-CMPHT2LS.js} +3 -3
  74. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  75. package/dist/{chunk-JSA3ESEJ.js → chunk-CR5FP5SF.js} +1 -1
  76. package/dist/{chunk-NCCDEUHD.js → chunk-CSMVKG2C.js} +1 -1
  77. package/dist/{chunk-JHWDTV4K.js → chunk-D2TQX7UJ.js} +2 -2
  78. package/dist/{chunk-GHFTKVJN.js → chunk-DHGE46UK.js} +1 -1
  79. package/dist/{chunk-26WNBTWB.js → chunk-DORE2RHL.js} +5 -5
  80. package/dist/{chunk-AFA32LHN.js → chunk-DUOGEFLG.js} +62 -36
  81. package/dist/{chunk-WZB6R2ZX.js → chunk-DZYTXZNS.js} +11 -3
  82. package/dist/{chunk-O4D27FKH.js → chunk-E5YF236N.js} +4 -1
  83. package/dist/{chunk-6EE6XEMA.js → chunk-EB4PQEI3.js} +26 -17
  84. package/dist/{chunk-ANNQJWDX.js → chunk-EBWMTQ4U.js} +285 -34
  85. package/dist/{chunk-EHNGPUTO.js → chunk-EDW5HQND.js} +5 -5
  86. package/dist/{chunk-VM5CQ7CG.js → chunk-EHRRHSPV.js} +2 -2
  87. package/dist/{chunk-PYGEIPPH.js → chunk-EILNJQMN.js} +32 -12
  88. package/dist/{chunk-KGS5Z7SL.js → chunk-ERDKMZ7O.js} +2 -2
  89. package/dist/{chunk-USFIDSTO.js → chunk-ETUKDEGL.js} +18 -11
  90. package/dist/chunk-F2ET5ZTT.js +49 -0
  91. package/dist/{chunk-HVX2E26J.js → chunk-F3XOBFS4.js} +9 -8
  92. package/dist/{chunk-I4NUYVP5.js → chunk-FB6X7QHA.js} +1 -1
  93. package/dist/{chunk-LO3AGGE3.js → chunk-FJNZ7NWD.js} +5 -5
  94. package/dist/{chunk-IRXTNSZL.js → chunk-FPFRLRQO.js} +40 -22
  95. package/dist/{chunk-YTEJYLU7.js → chunk-FRR7BJ3B.js} +2 -2
  96. package/dist/{chunk-DPUCT567.js → chunk-FVWHEM2N.js} +7 -5
  97. package/dist/{chunk-A33MFWHW.js → chunk-G7BCLYL4.js} +2 -2
  98. package/dist/{chunk-2KCK63DD.js → chunk-G7CXJPEN.js} +2 -2
  99. package/dist/{chunk-2X6XY4K4.js → chunk-GB3RZYTK.js} +39 -19
  100. package/dist/{chunk-MTCDGSYW.js → chunk-GHCU6OSE.js} +2 -2
  101. package/dist/{chunk-AFGQXMKT.js → chunk-GNMB72V7.js} +161 -67
  102. package/dist/chunk-GOFS336W.js +24 -0
  103. package/dist/{chunk-JMXNXLAC.js → chunk-GQYT7G4F.js} +2 -2
  104. package/dist/{chunk-RRPTQGRU.js → chunk-H3VICNTN.js} +1 -1
  105. package/dist/{chunk-JRRSKCGG.js → chunk-H4EDDGGX.js} +3 -3
  106. package/dist/{chunk-5H4HFRDO.js → chunk-H7BCNS5J.js} +5 -5
  107. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  108. package/dist/chunk-HF4BCPIV.js +26 -0
  109. package/dist/{chunk-YCUNFAEE.js → chunk-HM4AJ5U4.js} +238 -127
  110. package/dist/{chunk-7FAO4ICF.js → chunk-HO4ILCW7.js} +2 -2
  111. package/dist/{chunk-ZV3SNRJI.js → chunk-HTQGJQZN.js} +4 -2
  112. package/dist/{chunk-G5BUGYIL.js → chunk-I52OMC5B.js} +192 -113
  113. package/dist/{chunk-TMXRTYGT.js → chunk-I5VNHDPR.js} +3 -2
  114. package/dist/{chunk-M74H7QYD.js → chunk-IDXYHDQY.js} +1 -1
  115. package/dist/{chunk-SSZB3VXG.js → chunk-IFUAPFL5.js} +102 -47
  116. package/dist/{chunk-IPWUBZ4P.js → chunk-IIWZJ5ZM.js} +1 -1
  117. package/dist/{chunk-KF3ZHLHQ.js → chunk-IMUMPKXF.js} +5 -5
  118. package/dist/{chunk-HC6WHTBX.js → chunk-IPBOREIY.js} +1 -1
  119. package/dist/{chunk-76UL4CT4.js → chunk-IPZJCBWD.js} +27 -22
  120. package/dist/{chunk-5P4MXWKP.js → chunk-ITEJQHXE.js} +4 -4
  121. package/dist/{chunk-WDAZ2MT4.js → chunk-IVDTP6SV.js} +4 -4
  122. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  123. package/dist/{chunk-K6Y4HBK7.js → chunk-IXU5C3YY.js} +1000 -904
  124. package/dist/{chunk-EDBUVDRI.js → chunk-JBAVMO56.js} +372 -93
  125. package/dist/{chunk-VY2NPB2Q.js → chunk-JNDWRV34.js} +4 -4
  126. package/dist/{chunk-XYUXB5VK.js → chunk-JT3UTEWZ.js} +3 -3
  127. package/dist/{chunk-A6XCVOC5.js → chunk-JY4LTPOV.js} +1 -1
  128. package/dist/{chunk-VT7PBGL2.js → chunk-JYSFAH7C.js} +23 -36
  129. package/dist/chunk-K7XPTQBJ.js +267 -0
  130. package/dist/{chunk-2I76VFMZ.js → chunk-KI7VCHNZ.js} +49 -37
  131. package/dist/{chunk-YB6QGOCO.js → chunk-KUWIRCYJ.js} +2 -2
  132. package/dist/{chunk-MQ5EKWIG.js → chunk-KVBLTAO7.js} +5 -5
  133. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  134. package/dist/{chunk-BY5JGQFZ.js → chunk-KWIP5YRA.js} +4 -4
  135. package/dist/{chunk-KAAB2DIV.js → chunk-LJDATBPB.js} +6 -6
  136. package/dist/{chunk-TDDSWNGD.js → chunk-LOXZSTIM.js} +30 -28
  137. package/dist/{chunk-ZTSJ7NY6.js → chunk-LPMSGO7L.js} +3 -3
  138. package/dist/{chunk-IXM6BAM4.js → chunk-LXH4RPY4.js} +1 -1
  139. package/dist/{chunk-D5G67OER.js → chunk-LYAT62UT.js} +1 -1
  140. package/dist/{chunk-EFKFZNQC.js → chunk-M5LPP2GQ.js} +34 -20
  141. package/dist/{chunk-QZMLSK43.js → chunk-MALSSEXO.js} +294 -145
  142. package/dist/{chunk-XN7JDII2.js → chunk-MB5EX2YG.js} +230 -107
  143. package/dist/{chunk-PSYPB22T.js → chunk-MGXHFRQK.js} +5 -5
  144. package/dist/{chunk-GADI2DU7.js → chunk-MVR7YKBF.js} +152 -27
  145. package/dist/{chunk-IFURKTOL.js → chunk-MXUPMGRY.js} +2 -2
  146. package/dist/{chunk-C5SQEYTQ.js → chunk-NFGV5OAR.js} +153 -65
  147. package/dist/{chunk-RZNYW7UP.js → chunk-NNIZG3TH.js} +8 -0
  148. package/dist/{chunk-AKJO6N4K.js → chunk-NQPJWQTW.js} +11 -4
  149. package/dist/{chunk-YFI5PN5O.js → chunk-NSMYIUBZ.js} +34 -11
  150. package/dist/{chunk-H6EJ63QN.js → chunk-NT3HCXQC.js} +144 -83
  151. package/dist/chunk-NZ7FX3AE.js +65 -0
  152. package/dist/chunk-O3LT4TAI.js +34 -0
  153. package/dist/{chunk-L2XRUG4P.js → chunk-OELB7MTE.js} +5 -5
  154. package/dist/{chunk-7MYJUJZV.js → chunk-OMNB27GM.js} +4 -4
  155. package/dist/{chunk-GS5UG6QD.js → chunk-OO63YP35.js} +1 -1
  156. package/dist/{chunk-CEMXGMQN.js → chunk-OQUH7I5T.js} +3 -3
  157. package/dist/{chunk-Q7VPTN5X.js → chunk-OS7C2KMQ.js} +4 -4
  158. package/dist/{chunk-NRYERHEI.js → chunk-OTWIW2L3.js} +5 -5
  159. package/dist/chunk-OUNYHYJL.js +27 -0
  160. package/dist/{chunk-54HEIM2A.js → chunk-OUR5ZHCB.js} +2 -2
  161. package/dist/{chunk-Z257SH5U.js → chunk-OZA7HA6L.js} +1 -1
  162. package/dist/{chunk-WJQX7HBH.js → chunk-OZLKEBCD.js} +2 -2
  163. package/dist/{chunk-YGPLUENN.js → chunk-P3NMDPDP.js} +132 -83
  164. package/dist/{chunk-NINK4G7U.js → chunk-P5RCP4NK.js} +2 -2
  165. package/dist/{chunk-DYSEZVIJ.js → chunk-P6DEFCMQ.js} +2 -2
  166. package/dist/{chunk-J22ETKDJ.js → chunk-P7UOOMXE.js} +2 -2
  167. package/dist/chunk-PMT75APP.js +94 -0
  168. package/dist/{chunk-KLQKHA3T.js → chunk-PNYWBY4K.js} +5 -5
  169. package/dist/{chunk-XNV7VOIT.js → chunk-PVGJM2HP.js} +4 -4
  170. package/dist/{chunk-4U2WSW6F.js → chunk-Q2I3QLE3.js} +65 -36
  171. package/dist/{chunk-LGMV7ZV4.js → chunk-QATOOZMH.js} +5 -5
  172. package/dist/{chunk-H2POQ4LB.js → chunk-QFNWGSCT.js} +4 -4
  173. package/dist/{chunk-CIDOL4FO.js → chunk-QQMESIDA.js} +5 -5
  174. package/dist/{chunk-OTGNVAI4.js → chunk-R3VSWOTI.js} +4 -4
  175. package/dist/{chunk-UCIAHSJK.js → chunk-R5SGE2NS.js} +7 -3
  176. package/dist/{chunk-FX5VZK5F.js → chunk-RJICOOB3.js} +14 -8
  177. package/dist/{chunk-RMVCKO6N.js → chunk-RLH2CQCD.js} +458 -136
  178. package/dist/{chunk-VFLMBA2M.js → chunk-RPGEB3Z5.js} +19 -18
  179. package/dist/{chunk-KIXNHDXS.js → chunk-RQKDEJFQ.js} +5 -5
  180. package/dist/chunk-SBKM6XFS.js +211 -0
  181. package/dist/{chunk-TQ5HHNM3.js → chunk-SCAYWQZK.js} +2 -2
  182. package/dist/{chunk-Y5WHM2Q5.js → chunk-SH4FLUAD.js} +1 -1
  183. package/dist/{chunk-7EQU2TUN.js → chunk-SH4UGK5U.js} +84 -53
  184. package/dist/{chunk-EY4OA4OF.js → chunk-SHYS52VO.js} +370 -785
  185. package/dist/{chunk-ZSYU6LIH.js → chunk-SKPOXLG5.js} +5 -5
  186. package/dist/{chunk-OAT6FWKL.js → chunk-T7PRG6AO.js} +5 -5
  187. package/dist/chunk-TBZT5WUT.js +39 -0
  188. package/dist/{chunk-5HTGSB6Y.js → chunk-TKH655ON.js} +3 -3
  189. package/dist/{chunk-YO5UKKCQ.js → chunk-TMEUK2WS.js} +6 -2
  190. package/dist/{chunk-X5OVVMZX.js → chunk-TVOMGNFQ.js} +1 -1
  191. package/dist/{chunk-JARJP576.js → chunk-TX5FSNAU.js} +435 -29
  192. package/dist/{chunk-LUZ7HXBT.js → chunk-U52PNFPX.js} +1 -1
  193. package/dist/{chunk-OKM5LYYP.js → chunk-U6QZOMYC.js} +5 -5
  194. package/dist/{chunk-F4JAGDPD.js → chunk-UBYDY4B7.js} +8 -8
  195. package/dist/{chunk-V3UE3TB7.js → chunk-UCKUAKYQ.js} +2 -2
  196. package/dist/{chunk-NO7GRVUU.js → chunk-UOOXWGBU.js} +8 -8
  197. package/dist/{chunk-LFX5BERN.js → chunk-USMKNNOU.js} +47 -33
  198. package/dist/chunk-USSG6TJV.js +23 -0
  199. package/dist/{chunk-HFFKN7PA.js → chunk-UY34DDUM.js} +3 -3
  200. package/dist/{chunk-3LNVEE5Z.js → chunk-V7FV66KL.js} +1 -1
  201. package/dist/{chunk-62JZL6FW.js → chunk-V7JFT7NQ.js} +56 -42
  202. package/dist/{chunk-UP4JSNDR.js → chunk-V7NUJEJE.js} +1 -1
  203. package/dist/{chunk-FERP4WS3.js → chunk-VACZGW5R.js} +16 -18
  204. package/dist/{chunk-BO5EJBLH.js → chunk-VC62V7CX.js} +82 -47
  205. package/dist/{chunk-53OEKS4L.js → chunk-VESSIKBG.js} +6 -3
  206. package/dist/chunk-VJULLJLN.js +70 -0
  207. package/dist/{chunk-QLWUFEKR.js → chunk-VKNQOSGW.js} +8 -8
  208. package/dist/{chunk-BFDPY7JM.js → chunk-VTY6YHQZ.js} +11 -6
  209. package/dist/{chunk-UFZXZJJG.js → chunk-W2QILXAL.js} +5 -5
  210. package/dist/{chunk-QHPJ5ZKS.js → chunk-W6XSIBLR.js} +5 -5
  211. package/dist/{chunk-DJBMA4FW.js → chunk-WDJSDJLV.js} +4 -6
  212. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  213. package/dist/{chunk-IW3YUMPI.js → chunk-WFBN2HXR.js} +2 -2
  214. package/dist/chunk-WGJIYFVQ.js +24 -0
  215. package/dist/{chunk-43PCSBVQ.js → chunk-WKXLJNHW.js} +634 -8
  216. package/dist/{chunk-EWR6WVOV.js → chunk-WLH5IBFY.js} +6 -6
  217. package/dist/{chunk-RHVP62HI.js → chunk-WMQ57FOP.js} +5 -5
  218. package/dist/{chunk-GKQLKUMF.js → chunk-WNTUBGBB.js} +41 -32
  219. package/dist/{chunk-RHBQ2Q5H.js → chunk-WOICFLOJ.js} +60 -43
  220. package/dist/{chunk-QNLESRH6.js → chunk-WUP6C4ZD.js} +2 -2
  221. package/dist/chunk-WVCDISZP.js +89 -0
  222. package/dist/{chunk-CT4RFZO4.js → chunk-WW4KLAVO.js} +38 -23
  223. package/dist/{chunk-I5ZADE2U.js → chunk-X3QUASBR.js} +1 -1
  224. package/dist/{chunk-TXMS7QUJ.js → chunk-X46PSAJ7.js} +6 -6
  225. package/dist/{chunk-Z2BDTZDT.js → chunk-XC32OSCD.js} +97 -39
  226. package/dist/{chunk-M2OQK2FO.js → chunk-XD5XB22R.js} +2 -2
  227. package/dist/chunk-XLLWIHN2.js +24 -0
  228. package/dist/{chunk-SD6ENKTO.js → chunk-XMX4PCFL.js} +3 -3
  229. package/dist/{chunk-BM2A3IGQ.js → chunk-XO44IJGZ.js} +1 -1
  230. package/dist/{chunk-2HD5RY2U.js → chunk-XRRG4MBM.js} +3 -3
  231. package/dist/chunk-XSC4IXXC.js +24 -0
  232. package/dist/{chunk-D5RAVZ5C.js → chunk-XSEETONJ.js} +10 -9
  233. package/dist/{chunk-YBYV56FS.js → chunk-XZOFKLTD.js} +3 -3
  234. package/dist/{chunk-YNHPPZ7S.js → chunk-XZXZNI7A.js} +1 -1
  235. package/dist/{chunk-W7Q6PLT4.js → chunk-Y6E4JU3U.js} +37 -37
  236. package/dist/{chunk-XR7VOF2V.js → chunk-YGWPOYDE.js} +25 -13
  237. package/dist/{chunk-HDSHS2QZ.js → chunk-YJUBX3QF.js} +70 -47
  238. package/dist/{chunk-BDCKHLUB.js → chunk-YLRAAJYV.js} +72 -304
  239. package/dist/{chunk-I6QGYRY4.js → chunk-YW35KSXR.js} +2 -2
  240. package/dist/{chunk-GAFEN3H7.js → chunk-Z3WQXVFV.js} +2 -2
  241. package/dist/{chunk-WKWCNS6K.js → chunk-Z62TJQO5.js} +5 -5
  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-TWRFVW3J.js → chunk-ZB3JIL3L.js} +138 -89
  245. package/dist/{chunk-KUMJI5B6.js → chunk-ZBCCJPGW.js} +17 -14
  246. package/dist/{chunk-CV3NC75L.js → chunk-ZBOOMLHD.js} +1 -1
  247. package/dist/{chunk-QRZESG66.js → chunk-ZCHKIR7C.js} +64 -239
  248. package/dist/{chunk-ZDD3MJ2H.js → chunk-ZDJ7C64T.js} +1 -1
  249. package/dist/{chunk-KQ2WZ6BY.js → chunk-ZG4BMJRL.js} +1 -1
  250. package/dist/{chunk-QYOZ46ZQ.js → chunk-ZIVCPXXL.js} +467 -650
  251. package/dist/{chunk-V62B23VC.js → chunk-ZNRSYS76.js} +8 -2
  252. package/dist/{chunk-NIDH22DI.js → chunk-ZSYFQSPF.js} +12 -2
  253. package/dist/cli/index.js +8 -3
  254. package/dist/{core-5S5CJHBG.js → core-2GWH3ED7.js} +2 -1
  255. package/dist/{core-ZSERZGK6.js → core-3LCSHMKN.js} +3 -1
  256. package/dist/{core-FTQBESDS.js → core-3NQ5TXOJ.js} +3 -1
  257. package/dist/{core-D2OIGYC7.js → core-3XGQBHJI.js} +4 -1
  258. package/dist/{core-T3OSZOVV.js → core-4N6WH3IF.js} +3 -1
  259. package/dist/{core-VRVL6LIM.js → core-5CRTPVYA.js} +3 -1
  260. package/dist/{core-7XKNJM7Y.js → core-5K4HRIHX.js} +5 -1
  261. package/dist/{core-CCB3IXGD.js → core-743ZXTWK.js} +3 -1
  262. package/dist/{core-4M4RY7MX.js → core-7OAGK7ZJ.js} +3 -1
  263. package/dist/{core-VT35VDVS.js → core-7YDNMUU3.js} +6 -1
  264. package/dist/{core-4PW4MXWR.js → core-AAPPZSSZ.js} +4 -1
  265. package/dist/{core-OBPTBKX6.js → core-AC5AKSCM.js} +2 -1
  266. package/dist/{core-QFAVWFI3.js → core-AEALAFRA.js} +2 -1
  267. package/dist/{core-WXZJ7V7S.js → core-BEK6EPVF.js} +4 -1
  268. package/dist/{core-WP73P4CW.js → core-BRBJ3LPF.js} +5 -1
  269. package/dist/{core-AVA4XLQ2.js → core-EGTJOQK7.js} +2 -1
  270. package/dist/{core-XKXDXALI.js → core-FE4THVV3.js} +6 -1
  271. package/dist/{core-MAW4S3KA.js → core-FEBNVNVE.js} +5 -1
  272. package/dist/{core-L3UR75IJ.js → core-HIONDJGC.js} +4 -1
  273. package/dist/{core-GS4DXDDG.js → core-HMBMMF5Z.js} +4 -1
  274. package/dist/{core-QM34237W.js → core-LSYX4UQQ.js} +2 -1
  275. package/dist/{core-N2JEWJ7D.js → core-MIERUUUT.js} +2 -1
  276. package/dist/{core-A7HXVSKB.js → core-NTOOJZRA.js} +2 -1
  277. package/dist/{core-JDZDBTID.js → core-O5S2NETE.js} +2 -1
  278. package/dist/{core-OFPPRHYY.js → core-Q2Y3JEWL.js} +3 -1
  279. package/dist/{core-BJZEJ63L.js → core-RTBPKALG.js} +3 -1
  280. package/dist/{core-WNT6ZMRO.js → core-T7CKLMT2.js} +2 -1
  281. package/dist/{core-VWYXK2R3.js → core-TIIPSEK3.js} +4 -1
  282. package/dist/{core-EMSJRGSE.js → core-VBMWBPKM.js} +2 -1
  283. package/dist/{core-WPEYRK6Y.js → core-VLXOQ5CK.js} +4 -1
  284. package/dist/{core-7TTM4KRP.js → core-VYHQ5JY6.js} +3 -1
  285. package/dist/{core-DMDAXVMY.js → core-XJZWD43V.js} +2 -1
  286. package/dist/{core-AMWCZTOT.js → core-XUNZB6BM.js} +5 -1
  287. package/dist/{core-UNX4ZV4M.js → core-YKDDPMWW.js} +5 -1
  288. package/dist/{core-SKMHEA4Y.js → core-YN2VVGUL.js} +3 -1
  289. package/dist/{core-ZACFV6XR.js → core-YP4MNIMV.js} +5 -1
  290. package/dist/{core-FCSA74RT.js → core-ZETBHLSV.js} +3 -1
  291. package/dist/{dataTable-7IO546LM.js → dataTable-FEQZSDUZ.js} +7 -2
  292. package/dist/{engine-US3N6UCH.js → engine-SCQVNSAM.js} +23 -18
  293. package/dist/fixtures.js +2 -1
  294. package/dist/flags-BVLSAXT3.js +10 -0
  295. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  296. package/dist/geo/dach.js +1 -1
  297. package/dist/geo/de-states.js +1 -1
  298. package/dist/geo/eu27.js +1 -1
  299. package/dist/geo/europe.js +1 -1
  300. package/dist/geo/index.js +2 -2
  301. package/dist/geo/us-states.js +1 -1
  302. package/dist/geo/world.js +1 -1
  303. package/dist/index.js +27 -20
  304. package/dist/{main-2UWKGUHR.js → main-7UKLXCIL.js} +50 -119
  305. package/dist/mcp/server.js +121 -118
  306. package/dist/react/bar.js +5 -1
  307. package/dist/react/bartable.js +3 -1
  308. package/dist/react/box.js +3 -1
  309. package/dist/react/bullet.js +4 -1
  310. package/dist/react/butterfly.js +5 -1
  311. package/dist/react/choropleth.js +3 -1
  312. package/dist/react/cohort.js +3 -1
  313. package/dist/react/column.js +5 -1
  314. package/dist/react/combo.js +5 -1
  315. package/dist/react/creative.js +4 -1
  316. package/dist/react/diagram.js +3 -1
  317. package/dist/react/dimswitch.js +6 -1
  318. package/dist/react/dot.js +4 -1
  319. package/dist/react/export.js +29 -18
  320. package/dist/react/funnel.js +4 -1
  321. package/dist/react/gantt.js +3 -1
  322. package/dist/react/grid.js +6 -1
  323. package/dist/react/heatmap.js +3 -1
  324. package/dist/react/histogram.js +6 -1
  325. package/dist/react/index.js +92 -85
  326. package/dist/react/kpi.js +4 -1
  327. package/dist/react/likert.js +6 -1
  328. package/dist/react/line.js +4 -1
  329. package/dist/react/mekko.js +5 -1
  330. package/dist/react/pareto.js +6 -1
  331. package/dist/react/pie.js +4 -1
  332. package/dist/react/prepare.js +35 -22
  333. package/dist/react/pvm.js +6 -1
  334. package/dist/react/pyramid.js +5 -1
  335. package/dist/react/sankey.js +3 -1
  336. package/dist/react/scatter.js +3 -1
  337. package/dist/react/slope.js +4 -1
  338. package/dist/react/sparkline.js +4 -1
  339. package/dist/react/spec.js +17 -13
  340. package/dist/react/status.js +3 -1
  341. package/dist/react/story.js +3 -2
  342. package/dist/react/table.js +4 -1
  343. package/dist/react/theme.js +5 -3
  344. package/dist/react/tilemap.js +3 -1
  345. package/dist/react/treemap.js +3 -1
  346. package/dist/react/variance.js +5 -1
  347. package/dist/react/waffle.js +3 -1
  348. package/dist/react/waterfall.js +5 -1
  349. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  350. package/dist/rows.js +2 -2
  351. package/dist/{rowsModule-DYDVHBAX.js → rowsModule-WJH4QNXZ.js} +1 -1
  352. package/dist/{schema-YDZCGL56.js → schema-2R32F6AW.js} +1 -3
  353. package/dist/{schema-A2XUZUCV.js → schema-2TPGJGVR.js} +1 -3
  354. package/dist/{schema-MD22QYZU.js → schema-47BG2TZA.js} +1 -3
  355. package/dist/{schema-HEB6ZDI5.js → schema-56MOEOVR.js} +1 -3
  356. package/dist/{schema-K4V4PYBO.js → schema-5MSR4LNN.js} +1 -3
  357. package/dist/{schema-NOBNFD2F.js → schema-5RIYEWE6.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-XIHAKX3B.js → schema-JIAQE7WO.js} +1 -1
  372. package/dist/{schema-6V5K3J2V.js → schema-JYZ4RF6S.js} +1 -3
  373. package/dist/{schema-GXOG4MXL.js → schema-K7F6TEDK.js} +1 -2
  374. package/dist/{schema-NMIYKGHE.js → schema-KAK6DZX4.js} +1 -3
  375. package/dist/{schema-PHIHMDVB.js → schema-KCJ6WTGV.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-Q5DACE4I.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-6PL46VXZ.js → schema-WZOSDDDJ.js} +1 -3
  387. package/dist/{schema-FGE5YK3S.js → schema-Y4TI2T3T.js} +1 -3
  388. package/dist/{schema-MQB6CE5V.js → schema-ZU2EU2VP.js} +1 -3
  389. package/dist/{specValidation-XGELWQUU.js → specValidation-DC4TVHWD.js} +3 -1
  390. package/dist/theme.js +4 -3
  391. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  392. package/dist/types/core/annotate.d.ts +27 -2
  393. package/dist/types/core/annotateArms.d.ts +3 -1
  394. package/dist/types/core/annotateTargets.d.ts +4 -0
  395. package/dist/types/core/annotationOrigin.d.ts +13 -0
  396. package/dist/types/core/axis.d.ts +2 -2
  397. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  398. package/dist/types/core/charts/column/model.d.ts +13 -0
  399. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  400. package/dist/types/core/charts/gantt/calendar.d.ts +4 -0
  401. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  402. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  403. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  404. package/dist/types/core/charts/pvm/types.d.ts +1 -0
  405. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  406. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  407. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  408. package/dist/types/core/charts/table/resolve.d.ts +8 -3
  409. package/dist/types/core/charts/table/view.d.ts +24 -1
  410. package/dist/types/core/claims/browser.d.ts +2 -0
  411. package/dist/types/core/claims/ids.d.ts +38 -0
  412. package/dist/types/core/deferred.d.ts +1 -0
  413. package/dist/types/core/diagnostics/describe.d.ts +6 -1
  414. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  415. package/dist/types/core/formatSpec.d.ts +33 -14
  416. package/dist/types/core/frame.d.ts +25 -58
  417. package/dist/types/core/frameText.d.ts +203 -0
  418. package/dist/types/core/geometry.d.ts +2 -0
  419. package/dist/types/core/label/categoryRow.d.ts +19 -2
  420. package/dist/types/core/label/solver.d.ts +23 -2
  421. package/dist/types/core/normalize/shared.d.ts +12 -2
  422. package/dist/types/core/notes.d.ts +15 -2
  423. package/dist/types/core/reading.d.ts +12 -1
  424. package/dist/types/core/request.d.ts +1 -1
  425. package/dist/types/core/schema/capability.d.ts +12 -0
  426. package/dist/types/core/seriesIdentity.d.ts +4 -1
  427. package/dist/types/core/sizing.d.ts +37 -1
  428. package/dist/types/core/structureCounts.d.ts +3 -1
  429. package/dist/types/core/theme.d.ts +33 -4
  430. package/dist/types/core/themeRules.d.ts +2 -0
  431. package/dist/types/core/types/annotations.d.ts +74 -4
  432. package/dist/types/core/types/options.d.ts +35 -3
  433. package/dist/types/core/types/scene.d.ts +30 -2
  434. package/dist/types/core/types/table.d.ts +6 -0
  435. package/dist/types/core/types/theme.d.ts +23 -0
  436. package/dist/types/react/TableChart.d.ts +5 -0
  437. package/dist/validate.js +13 -6
  438. package/docs/TELEMETRY.md +2 -2
  439. package/docs/manual.md +252 -62
  440. package/docs/reference/bar.md +12 -4
  441. package/docs/reference/bartable.md +2 -2
  442. package/docs/reference/box.md +8 -4
  443. package/docs/reference/bullet.md +9 -5
  444. package/docs/reference/butterfly.md +10 -5
  445. package/docs/reference/choropleth.md +3 -5
  446. package/docs/reference/cohort.md +1 -1
  447. package/docs/reference/column.md +18 -4
  448. package/docs/reference/combo.md +10 -5
  449. package/docs/reference/creative.md +3 -7
  450. package/docs/reference/diagram.md +1 -1
  451. package/docs/reference/dimswitch.md +23 -88
  452. package/docs/reference/dot.md +9 -5
  453. package/docs/reference/fixtures.md +37 -1
  454. package/docs/reference/funnel.md +9 -5
  455. package/docs/reference/gantt.md +8 -15
  456. package/docs/reference/grid.md +5 -2
  457. package/docs/reference/heatmap.md +10 -6
  458. package/docs/reference/kpi.md +1 -1
  459. package/docs/reference/likert.md +9 -4
  460. package/docs/reference/line.md +18 -5
  461. package/docs/reference/mekko.md +10 -5
  462. package/docs/reference/options.md +17 -13
  463. package/docs/reference/pareto.md +8 -4
  464. package/docs/reference/pie.md +9 -5
  465. package/docs/reference/pvm.md +9 -5
  466. package/docs/reference/pyramid.md +8 -4
  467. package/docs/reference/react.md +5 -5
  468. package/docs/reference/sankey.md +2 -2
  469. package/docs/reference/scatter.md +8 -4
  470. package/docs/reference/slope.md +9 -5
  471. package/docs/reference/sparkline.md +1 -1
  472. package/docs/reference/status.md +1 -1
  473. package/docs/reference/table.md +33 -114
  474. package/docs/reference/theme.md +12 -4
  475. package/docs/reference/tilemap.md +2 -4
  476. package/docs/reference/treemap.md +1 -1
  477. package/docs/reference/variance.md +12 -6
  478. package/docs/reference/waffle.md +1 -1
  479. package/docs/reference/warnings.md +1077 -0
  480. package/docs/reference/waterfall.md +16 -4
  481. package/docs/use-cases.md +25 -13
  482. package/llms.txt +19 -6
  483. package/package.json +18 -3
  484. package/dist/chunk-5RHP7YTL.js +0 -24
  485. package/dist/chunk-6VU2XI3W.js +0 -89
  486. package/dist/chunk-6WJOHZPW.js +0 -26
  487. package/dist/chunk-FL3FQ2YA.js +0 -27
  488. package/dist/chunk-G5CELEUR.js +0 -26
  489. package/dist/chunk-M4SPKUZE.js +0 -7
  490. package/dist/chunk-OF7FMGH5.js +0 -24
  491. package/dist/chunk-S2TSXUYP.js +0 -24
  492. package/dist/chunk-TKERVBJ3.js +0 -23
  493. package/dist/chunk-VMGTNB6H.js +0 -25
  494. package/dist/chunk-WZL4EEBS.js +0 -11
  495. package/dist/chunk-YJGFT63R.js +0 -27
  496. package/dist/chunk-ZNX5J7D7.js +0 -47
@@ -26,52 +26,28 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
26
26
  "dimension": {
27
27
  "label": "Channel",
28
28
  "total": { "id": "total", "label": "Total" },
29
- "members": [{ "id": "paid", "label": "Paid Search" }, { "id": "organic", "label": "Organic" }],
30
- "headline": ["spend", "revenue"]
29
+ "headline": ["orders", "cac"],
30
+ "members": [{ "id": "paid", "label": "Paid Search" }, { "id": "organic", "label": "Organic" }]
31
31
  },
32
32
  "measures": [
33
33
  {
34
34
  "id": "orders",
35
- "scale": "count",
36
35
  "label": "Orders",
37
- "change": "relative",
36
+ "scale": "count",
38
37
  "value": { "field": "orders" },
39
38
  "judge": { "family": "volume", "base": "orders" }
40
39
  },
41
40
  {
42
41
  "id": "new",
43
- "scale": "count",
44
42
  "label": "New customers",
45
- "parentId": "orders",
46
- "value": { "field": "nc" }
47
- },
48
- {
49
- "id": "existing",
50
43
  "scale": "count",
51
- "label": "Existing customers",
52
44
  "parentId": "orders",
53
- "value": { "op": "sub", "a": { "field": "orders" }, "b": { "field": "nc" } }
54
- },
55
- {
56
- "id": "revenue",
57
- "scale": "money",
58
- "label": "Net revenue",
59
- "value": { "field": "rev" },
60
- "format": "$1.2",
61
- "unit": "$"
62
- },
63
- {
64
- "id": "spend",
65
- "scale": "money",
66
- "label": "Marketing spend",
67
- "value": { "field": "spend" },
68
- "format": "$1.2",
69
- "unit": "$"
45
+ "value": { "field": "nc" }
70
46
  },
71
47
  {
72
48
  "id": "cac",
73
- "scale": "perUnit",
74
49
  "label": "CAC",
50
+ "scale": "perUnit",
75
51
  "value": { "op": "div", "a": { "field": "spend" }, "b": { "field": "nc" } },
76
52
  "format": "$1.2",
77
53
  "unit": "$",
@@ -79,87 +55,46 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
79
55
  }
80
56
  ],
81
57
  "periods": [
82
- { "id": "range", "label": "Range", "kind": "range" },
83
- { "id": "prior", "label": "Prior", "kind": "prior" },
84
- { "id": "w1", "label": "Week 1" },
85
- { "id": "w2", "label": "Week 2", "partial": true }
58
+ { "id": "range", "label": "Current period", "kind": "range" },
59
+ { "id": "prior", "label": "Prior period", "kind": "prior" },
60
+ { "id": "w1", "label": "Week 1" }
86
61
  ],
87
62
  "facts": [
88
63
  {
89
64
  "memberId": "total",
90
65
  "periodId": "range",
91
- "sums": { "orders": 120, "nc": 60, "rev": 12000, "spend": 1800 },
92
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
66
+ "sums": { "orders": 120, "nc": 60, "spend": 1800 }
93
67
  },
94
68
  {
95
69
  "memberId": "total",
96
70
  "periodId": "prior",
97
- "sums": { "orders": 128, "nc": 62, "rev": 12500, "spend": 1830 },
98
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
71
+ "sums": { "orders": 100, "nc": 50, "spend": 1700 }
99
72
  },
100
73
  {
101
74
  "memberId": "total",
102
75
  "periodId": "w1",
103
- "sums": { "orders": 136, "nc": 64, "rev": 13000, "spend": 1860 },
104
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
105
- },
106
- {
107
- "memberId": "total",
108
- "periodId": "w2",
109
- "sums": { "orders": 144, "nc": 66, "rev": 13500, "spend": 1890 },
110
- "ref": { "orders": 110, "nc": 50, "rev": 11000, "spend": 1900 }
111
- },
112
- {
113
- "memberId": "paid",
114
- "periodId": "range",
115
- "sums": { "orders": 105, "nc": 53, "rev": 10500, "spend": 1600 },
116
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
117
- },
118
- {
119
- "memberId": "paid",
120
- "periodId": "prior",
121
- "sums": { "orders": 113, "nc": 55, "rev": 11000, "spend": 1630 },
122
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
76
+ "sums": { "orders": 60, "nc": 30, "spend": 900 },
77
+ "ref": { "orders": 50 }
123
78
  },
79
+ { "memberId": "paid", "periodId": "range", "sums": { "orders": 80, "nc": 45, "spend": 1800 } },
80
+ { "memberId": "paid", "periodId": "prior", "sums": { "orders": 70, "nc": 38, "spend": 1700 } },
124
81
  {
125
82
  "memberId": "paid",
126
83
  "periodId": "w1",
127
- "sums": { "orders": 121, "nc": 57, "rev": 11500, "spend": 1660 },
128
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
129
- },
130
- {
131
- "memberId": "paid",
132
- "periodId": "w2",
133
- "sums": { "orders": 129, "nc": 59, "rev": 12000, "spend": 1690 },
134
- "ref": { "orders": 95, "nc": 43, "rev": 9500, "spend": 1700 }
135
- },
136
- {
137
- "memberId": "organic",
138
- "periodId": "range",
139
- "sums": { "orders": 60, "nc": 32, "rev": 6000 },
140
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
141
- },
142
- {
143
- "memberId": "organic",
144
- "periodId": "prior",
145
- "sums": { "orders": 68, "nc": 34, "rev": 6500 },
146
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
84
+ "sums": { "orders": 40, "nc": 22, "spend": 900 },
85
+ "ref": { "orders": 35 }
147
86
  },
87
+ { "memberId": "organic", "periodId": "range", "sums": { "orders": 40, "nc": 15 } },
88
+ { "memberId": "organic", "periodId": "prior", "sums": { "orders": 30, "nc": 12 } },
148
89
  {
149
90
  "memberId": "organic",
150
91
  "periodId": "w1",
151
- "sums": { "orders": 76, "nc": 36, "rev": 7000 },
152
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
153
- },
154
- {
155
- "memberId": "organic",
156
- "periodId": "w2",
157
- "sums": { "orders": 84, "nc": 38, "rev": 7500 },
158
- "ref": { "orders": 50, "nc": 22, "rev": 5000 }
92
+ "sums": { "orders": 20, "nc": 8 },
93
+ "ref": { "orders": 15 }
159
94
  }
160
95
  ]
161
96
  },
162
- "options": { "variant": "by-measure", "depth": 1, "title": "Channel performance" }
97
+ "options": { "variant": "by-measure", "depth": 2, "title": "Channel performance" }
163
98
  }
164
99
  ```
165
100
 
@@ -274,7 +209,7 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
274
209
  | encodings.*.type (encodings.* branch 5) | string | `'arrow'` | | Select the arrow lane. |
275
210
  | encodings.*.scale (encodings.* branch 5) | string | `'absolute'`, `'relative'` | | 'absolute' cuts the change itself at 10 and 2 (points on a percent column); 'relative' cuts its share of the column's largest change at 10% and 2%. Default 'absolute' on a percent column, 'relative' elsewhere. |
276
211
  | encodings.*.type (encodings.* branch 6) | string | `'heat'` | | Select the heat lane. |
277
- | encodings.*.cap (encodings.* branch 6) | object | | | Where the lane saturates; without it the largest magnitude in the column does, on both sides of zero. One lane per table, on a variance column. |
212
+ | encodings.*.cap (encodings.* branch 6) | object | | | Where the lane saturates; without it the largest magnitude in the column does, on both sides of zero. Lanes with different caps add the note that shading compares values within each column. |
278
213
  | encodings.*.cap.pct (encodings.* branch 6) | number | | | Percent-column tint cap in points. Example: 20 for a ±20% YoY lane. |
279
214
  | encodings.*.cap.abs (encodings.* branch 6) | number | | | Other numeric tint cap in source units. |
280
215
  | encodings.*.alpha (encodings.* branch 6) | number | | | Tint weight at the cap; default 0.18, and 0.26 on scale 'status', where every painted cell takes it. Text stays readable up to 0.18 on every shipped theme and up to 0.35 on a status ground; above that the figures take the contrast ink. |
@@ -336,7 +271,7 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
336
271
  | widths.period | number | | | Track of each period in px; default 94. |
337
272
  | minimumSample | object | | | Minimum judge base per sum field in BOTH windows (below it: neutral). Default none. |
338
273
 
339
- Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labels`, `valueAxis`, `story`, `hatchStrength`, `rounding`, `annotations`, `groupRule`, `groupAlign`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `legend`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
274
+ Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labels`, `labelPosition`, `valueAxis`, `story`, `hatchStrength`, `rounding`, `annotations`, `groupRule`, `groupAlign`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `legend`, `valueAxis.show`, `valueAxis.gridlines`, `focus`, `labelDensity` with an `option-ignored` warning.
340
275
 
341
276
  ## Annotations
342
277
 
@@ -80,7 +80,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
80
80
  | range.values | boolean | | | Default false. true prints each range's low and high value beside its caps. |
81
81
  | range.midLabel | string | | | The key entry for the open marker that draws each supplied range.mid, for example 'Peer midpoint'. Default 'Midpoint'. When only some rows carry a mid, a note names the others. |
82
82
 
83
- Plus the [shared options](options.md). This type does not accept `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis` with an `option-ignored` warning.
83
+ Plus the [shared options](options.md). This type does not accept `labelPosition`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis` with an `option-ignored` warning.
84
84
 
85
85
  ## Annotations
86
86
 
@@ -89,12 +89,16 @@ An annotation anchor is a category or item id string, or an object with category
89
89
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
90
90
  |---|---|---|---|---|---|
91
91
  | valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
92
- | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. A thin arrow from the text to the anchored point; the first line sits level with the point, right or left of it, where there is room. Not with icon or status. Example: "arrow": true. | |
92
+ | callout | Places authored free text at an anchored data element, routing a leader when displaced and honoring the preferred side. | at, text | at: AnchorRef | preferSide: left \| right \| above \| below. Side the solver tries first; the label keeps a leader when it moves. headline: string. A bold first line over the text, which then prints in plain type; ${value} in it prints the anchored value from the data. Example: "headline": "${value}", "text": "Peak in handheld-loom demand" prints 153 in bold over the words. arrow: boolean, default false. An arrow from the text to the anchored point, in the arrow standard of theme marks.arrow: the text stands far enough out for a 24 px shaft, level with the point right or left of it, or over or under it, where there is room. With no such seat it draws without the arrow and warns callout-arrow-no-room. Not with icon or status. Example: "arrow": true. | |
93
93
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
94
- | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
94
+ | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | mode: absolute \| relative \| both, default absolute. absolute prints at minus vs, relative the percent change from vs to at, both the two as '+149 (+36%)'. relative and both need a nonzero vs. | |
95
95
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
96
- | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. The arm follows the horizontal value axis and clears the connector. |
97
- | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
96
+ | diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed \| both, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference, both the value difference with the percent change beside it. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. The arm follows the horizontal value axis and clears the connector. |
97
+ | cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a category of an unstacked line, which reads the first drawn series; on a stack a category reads the stack total) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
98
+ | text | Places authored text at a point through the label solver: on the point, or above, below, right or left of it. The text prints as written. | at, text | at: AnchorRef \| { categoryId, value } | | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. The text prints as written, ${value} included. It takes id and priority, and no other field. |
99
+ | line | Draws a straight line between two points or from a text annotation, in the ink and rule width of a bracket; a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the line in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the line starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
100
+ | arrow | Draws a straight arrow between two points or from a text annotation to a point, in the theme arrow look (`marks.arrow`); a stretch that would cross text is cut. | from, to | from: AnchorRef \| { categoryId, value } \| { annotationId }; to: AnchorRef \| { categoryId, value } \| { annotationId } | dashed: boolean, default false. Draws the shaft in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. An end { annotationId } names a text annotation: the arrow starts or ends at the nearest edge of that text, at every size, and is not drawn when the text is not. A { categoryId, value } end stands on the category's centre. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
101
+ | box | Draws an unfilled box with two points as opposite corners, wrapping whole category bands, in the ink and rule width of a bracket; text inside the box stays free. | from, to | from: AnchorRef \| { categoryId, value }; to: AnchorRef \| { categoryId, value } | dashed: boolean, default false. Draws the edges in the dash of a reference line. | A point is an anchor or { categoryId, value } with value in axis units. A value outside the plot, a chart with no value scale or an anchor that does not resolve warns bad-anchor and draws nothing; the axis does not grow. from and to are opposite corners, the box has no fill, and text inside it stays free. A { categoryId, value } corner spans that category's whole band, so the box wraps whole bars, values and markers; from and to on one category wrap that category. A stretch that would cross text is cut and warns draw-crosses-text. It takes dashed and id, and no other field. |
98
102
 
99
103
  ## Sizing
100
104
 
@@ -4,7 +4,9 @@ Contents: [column](#column), [bar](#bar), [line](#line), [dimswitch](#dimswitch)
4
4
 
5
5
  <!-- Generated by scripts/generate-reference.mjs from the boardplot describe, list and fixtures payloads. -->
6
6
 
7
- Every fixture is a complete spec that renders. `boardplot_fixtures` returns them (`type`, `chart`, `id`, `kind`), as does `boardplot fixtures --type <type>`; the package export `boardplot/fixtures` returns all of them in one array. Example fixtures show a use case with real-looking data; torture fixtures are stress cases for regression.
7
+ Each fixture contains a runnable `spec`, its chart `type`, chart variant `chart`, `id`, `kind` and `useCase`. Start with `boardplot_fixtures` scoped to a type. Retrieve one example with its `type` and `id`, or continue a listing with `nextCursor` as `cursor` and the same filters. Each page contains at most 25 fixtures. `kind` filters listings and defaults to `example`; an explicit `id` selects the fixture regardless of `kind`.
8
+
9
+ The CLI prints every match in one response through `boardplot fixtures --type <type>`, with optional `--id` and `--kind` flags. Pagination applies only to the MCP tool. The package export `boardplot/fixtures` provides `getFixtures(type)` and `allFixtures()`. Example fixtures show ordinary use cases. Torture fixtures exercise edge cases.
8
10
 
9
11
  ## column
10
12
 
@@ -33,6 +35,11 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
33
35
  | stacked100-shares-sum | column.stacked100 | torture | Torture: 100% stacked shares that add up to 100% in every column |
34
36
  | stacked100-energy-mix | column.stacked100 | example | Stacked 100% column with absolute totals and 100% indicator |
35
37
  | clustered-brand-gap | column.grouped | example | Clustered columns with value axis, gridlines, and diff arrow |
38
+ | plan-ticks-delta-callout | column.grouped | example | Actual columns with plan ticks, a delta and a callout stacked over the one year below plan |
39
+ | plan-ticks-front | column.grouped | example | Actual columns with plan ticks drawn over the columns |
40
+ | monthly-diff-bracket | column.grouped | example | Twelve monthly columns with a difference in value and percent from the first to the last month |
41
+ | monthly-diff-between | column.grouped | example | Twelve monthly columns with a difference whose arrow stands between the columns |
42
+ | monthly-delta-both | column.grouped | example | Highlighted first and last month with a delta in value and percent |
36
43
  | ranked-dense-staggered | column.grouped | example | Ranked dense columns: staggered values, tick step, dotted grid, muted labels, highlight emphasis |
37
44
  | ratio-tier-zero-denominator | column.grouped | torture | Torture: zero denominator stays visible as n/a in the ratio tier |
38
45
  | negative-stacks | column.stacked | torture | Torture: negatives mixed into stacks, one all-negative column |
@@ -122,6 +129,9 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
122
129
  | option-value-labels-all | column.grouped | example | Every quarter prints its value (valueLabels all) |
123
130
  | grouped-twelve-slide | column.grouped | torture | Two series over twelve units on a full slide print all 24 values |
124
131
  | key-right-slide | column.grouped | example | Clustered columns on a slide with the key in a column right of the plot |
132
+ | inside-base-values | column.grouped | example | Column values inside the base |
133
+ | stacked-inside-base-values | column.stacked | example | Stacked column values inside each base |
134
+ | drawing-kinds | column.grouped | example | A box around the launch months, the old level and an arrow from a note |
125
135
 
126
136
  ## bar
127
137
 
@@ -157,6 +167,8 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
157
167
  | option-dashed-connectors | bar.stacked | example | Product mix across quarters |
158
168
  | plan-corridor | bar.grouped | example | Horizontal plan corridor on regional revenue |
159
169
  | grouped-cloud-cagr | bar.grouped | example | Grouped bars with a series CAGR arrow and last-year difference |
170
+ | diff-on-arrow | bar.grouped | example | Difference between two regions on its arrow |
171
+ | diff-beside-arrow | bar.grouped | example | Difference with placement 'label': the arrow off the rows |
160
172
  | tolerance-band | bar.grouped | example | Regional values against an authored tolerance band |
161
173
  | bar-compact-380 | bar.grouped | example | Bar in a 380px dashboard column |
162
174
  | torture-long-labels | bar.grouped | torture | Torture: long names at a generous size read whole, never cut |
@@ -187,6 +199,8 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
187
199
  | option-small-values-p-value | bar.grouped | torture | Every rate prints as an APA p-value (smallValues p-value) |
188
200
  | key-left | bar.stacked | example | Stacked bars with the key in a column left of the plot |
189
201
  | column-overrides | bar.grouped | example | columnOverrides sets the width of the name column |
202
+ | centered-values | bar.grouped | example | Bar values at the center |
203
+ | drawing-on-value-axis | bar.grouped | example | A line at the top level and an arrow over the gap, on a horizontal value axis |
190
204
 
191
205
  ## line
192
206
 
@@ -252,6 +266,9 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
252
266
  | shared-recession-period-bands | line.line | example | Period annotations separate the starting quarter, recession and recovery |
253
267
  | tolerance-band | line.line | example | Tolerance band around a 90 indexed target |
254
268
  | two-series-level-diff | line.line | example | Multi-series line with last-period difference and series CAGR |
269
+ | callout-arrow | line.line | example | Callout arrow from a note to the point it names |
270
+ | callout-arrow-compact | line.line | example | Callout arrow in the compact arrow look |
271
+ | callout-arrow-heavy | line.line | example | Callout arrow with a heavy shaft |
255
272
  | line-compact-380 | line.line | example | Line in a 380px dashboard column |
256
273
  | torture-long-labels | line.line | torture | Torture: long names at a generous size read whole, never cut |
257
274
  | highlight-overlap | line.line | torture | Actual remains visible when plan overlaps |
@@ -262,6 +279,10 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
262
279
  | iso-months-year-row | line.line | example | ISO month ids across two years print months and a year row |
263
280
  | rates-as-fractions | line.line | torture | SQL fractions use percentage cells at input |
264
281
  | ordered-ramp-rest-apart | line.line | example | Rest only has to differ from the ordered ramp (othersShade 'apart') |
282
+ | drawing-kinds | line.line | example | A box over the maintenance weeks, the normal load and an arrow from a note |
283
+ | value-line-end-value | line.line | example | A named value line at the series end value prints its name beside that value |
284
+ | shade-band-inside-wrap | line.line | example | A narrow shaded band wraps its name inside |
285
+ | point-emphasis | line.line | example | A selected trough emphasizes its marker and value while the line keeps its ink |
265
286
  | small-drawer | line.line | example | A plain line chart in a 480 by 200 drawer |
266
287
  | weekly-orders-anomalies | line.line | example | Two weeks break out of the normal order range (anomaly on a line) |
267
288
  | weekly-events-lane | line.line | example | Event lane over a weekly line: dotted rules behind the data, the rest numbered in the key |
@@ -435,6 +456,10 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
435
456
  | interview-status-buildup | waterfall.vertical | example | Interview pipeline build-up by status |
436
457
  | revenue-build-up | waterfall.vertical | example | Revenue → EBIT build-up with diff arrow |
437
458
  | step-brackets | waterfall.vertical | example | Brackets over bridge steps print their sums |
459
+ | step-brackets-span | waterfall.vertical | example | bracketRow 'span' stands each bracket right above its own steps |
460
+ | total-change-bracket | waterfall.vertical | example | The total change runs as the growth bracket over the step brackets |
461
+ | callout-label-offset | waterfall.vertical | example | labelOffsets moves a callout up from its step |
462
+ | bracket-low-steps | waterfall.vertical | example | A bracket stands directly above low steps |
438
463
  | build-down | waterfall.vertical | example | Build-down: revenue to net income |
439
464
  | whole-axis-opt-out | waterfall.vertical | example | Whole value axis kept with an explicit false |
440
465
  | automatic-axis-break | waterfall.vertical | example | Explicit automatic break makes small steps on a large base easier to compare |
@@ -457,6 +482,9 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
457
482
  | single-segment-authored-format | waterfall.vertical | example | One segment prints one value at the authored precision |
458
483
  | repeated-segment-key | waterfall.vertical | torture | Equal segment names and colours share one key |
459
484
  | column-overrides | waterfall.horizontal | example | A horizontal bridge with authored name and value bands |
485
+ | centered-values | waterfall.vertical | example | Centered bridge values with a thin falling step |
486
+ | horizontal-centered-values | waterfall.horizontal | example | Centered horizontal bridge values |
487
+ | sign-inside-values | waterfall.vertical | example | Inside values on signed bridge fills |
460
488
 
461
489
  ## kpi
462
490
 
@@ -541,6 +569,7 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
541
569
  | ranked-campaigns-key-shown | combo.dual-axis | torture | Campaign names too long for their columns read as ranks with the key printed (notes.show) |
542
570
  | ranked-campaigns-rank-key-only | combo.dual-axis | torture | Campaign names too long for their columns read as ranks; only the rank key prints (notes.show ranks) |
543
571
  | area-capacity-behind-columns | combo.overlay | example | Order columns in front of a capacity area, with a plan corridor and a launch period |
572
+ | inside-base-values | combo.overlay | example | Combo column values inside the base |
544
573
 
545
574
  ## variance
546
575
 
@@ -561,6 +590,8 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
561
590
  | missing-prior-dash | variance.absolute | example | A market with no prior year prints an en dash, not an empty slot |
562
591
  | authored-relative-decimals | variance.relative | torture | Relative changes retain the authored precision |
563
592
  | partial-period | variance.integrated | example | A running month hatches both the actual and its variance cap |
593
+ | absolute-centered-values | variance.absolute | example | Absolute variance values at the center |
594
+ | integrated-centered-values | variance.integrated | example | Integrated totals on one paint |
564
595
 
565
596
  ## bullet
566
597
 
@@ -832,6 +863,7 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
832
863
  | torture-long-labels | mekko.stacked100 | torture | Torture: long names at a generous size read whole, never cut |
833
864
  | percent-format-on-shares | mekko.stacked100 | torture | Shares use the percent format and totals stay absolute |
834
865
  | rounding-smallest-tie | mekko.stacked100 | torture | Equal-remainder ties favor the smaller share |
866
+ | bar-inside-base-values | mekko.bar | example | Mekko bar values inside the base |
835
867
 
836
868
  ## sparkline
837
869
 
@@ -878,6 +910,8 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
878
910
  | stacked-plus-dpy-tiered | grid.tiers | example | Opt-in scaled ΔPY% tier above stacked revenue |
879
911
  | three-tier | grid.tiers | example | Three tiers: actuals, ΔPY absolute, ΔPY% |
880
912
  | weekly-actual-vs-plan | grid.tiers | example | Actual vs plan by week: AC columns with PL ticks over a ΔPL tier |
913
+ | actual-vs-plan-callout | grid.tiers | example | Actual vs plan by year with a callout on the year below plan, over a ΔPL tier |
914
+ | weekly-actual-vs-plan-variance-below | grid.tiers | example | Actual vs plan by week with the ΔPL tier below the columns |
881
915
  | compact-tier-slack | grid.tiers | torture | Torture: compact tiers distribute vertical slack |
882
916
  | facet-regions | grid.facets | example | Facets: four regions, 2×2 |
883
917
  | facet-regions-ranked | grid.facets | torture | Facets ordered by last value, largest first |
@@ -1045,6 +1079,7 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
1045
1079
  | blank-values | butterfly | torture | A value the data lacks prints the not-applicable mark at the pane start |
1046
1080
  | own-scales-mixed | butterfly | torture | Panes of very different size on their own scales each draw a value axis |
1047
1081
  | column-overrides | butterfly | example | columnOverrides sets the name column and the difference column, beating centerColumnWidth |
1082
+ | centered-values | butterfly | example | Butterfly values at the center |
1048
1083
 
1049
1084
  ## likert
1050
1085
 
@@ -1065,6 +1100,7 @@ Every fixture is a complete spec that renders. `boardplot_fixtures` returns them
1065
1100
  | twelve-statements-slide | likert | torture | Twelve statements on a full slide print their shares inside the bars |
1066
1101
  | column-overrides | likert | example | columnOverrides sets the widths, alignment and head words of the name, net and base columns |
1067
1102
  | columns-after-plot | likert | example | columnOrder moves the net and base columns to the other side of the marks |
1103
+ | inside-base-values | likert | example | Response shares inside each segment base |
1068
1104
 
1069
1105
  ## histogram
1070
1106
 
@@ -75,7 +75,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
75
75
  | stageShade | string | `'darken'`, `'lighten'` | | Centered single-series stage shading; default 'darken'. Authored paints and palettes take priority. |
76
76
  | worstDropCallout | boolean | | `false` | Rows only: draws the automatic 'Biggest drop' callout at the step with the largest loss. Default false: the step captions already print every rate. An authored note replaces it. |
77
77
 
78
- Plus the [shared options](options.md). This type does not accept `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
78
+ Plus the [shared options](options.md). This type does not accept `labelPosition`, `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
79
79
 
80
80
  ## Annotations
81
81
 
@@ -84,11 +84,15 @@ An annotation anchor is a category or item id string, or an object with category
84
84
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
85
85
  |---|---|---|---|---|---|
86
86
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
87
- | 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. | |
88
- | delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
87
+ | 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. | |
88
+ | 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. | |
89
89
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
90
- | 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 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. |
90
+ | 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. |
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
+ | 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. |
93
+ | 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. |
94
+ | 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. |
95
+ | 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. |
92
96
 
93
97
  ## Sizing
94
98
 
@@ -44,13 +44,13 @@ One form; its chart ID is `gantt`.
44
44
  | Path | Type | Required | Meaning |
45
45
  |---|---|---|---|
46
46
  | rows | array | yes | Task and cadence rows displayed in the supplied order. |
47
- | rows[].id (rows[] branch 1) | string | yes | Unique timeline row identity. |
48
- | rows[].label (rows[] branch 1) | string | yes | Visible timeline row name. |
49
- | rows[].sublabel (rows[] branch 1) | string | | Second line under the row name, such as what the row measures. Printed in the label font and muted ink, on one line and never cut; the name band takes the wider of name and sublabel. On narrow canvases it follows the name on the row's name line. labels.activity: false hides it with the name. |
50
- | rows[].indent (rows[] branch 1) | integer | | Nonnegative indentation level for the row label. |
51
- | rows[].cols (rows[] branch 1) | array | | Metadata columns beside the row label, such as owner and status; up to three are displayed. A cell is text, or text with a tone. |
52
- | rows[].cols[].text (rows[] branch 1) | string | yes | Cell text, such as a status word. |
53
- | rows[].cols[].tone (rows[] branch 1) | string | | Status tone; omitted, the cell is plain text. A tone is drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
47
+ | rows[].id (rows[] branch 1 \| rows[] branch 2) | string | yes | Unique timeline row identity. |
48
+ | rows[].label (rows[] branch 1 \| rows[] branch 2) | string | yes | Visible timeline row name. |
49
+ | rows[].sublabel (rows[] branch 1 \| rows[] branch 2) | string | | Second line under the row name, such as what the row measures. Printed in the label font and muted ink, on one line and never cut; the name band takes the wider of name and sublabel. On narrow canvases it follows the name on the row's name line. labels.activity: false hides it with the name. |
50
+ | rows[].indent (rows[] branch 1 \| rows[] branch 2) | integer | | Nonnegative indentation level for the row label. |
51
+ | rows[].cols (rows[] branch 1 \| rows[] branch 2) | array | | Metadata columns beside the row label, such as owner and status; up to three are displayed. A cell is text, or text with a tone. |
52
+ | rows[].cols[].text (rows[] branch 1 \| rows[] branch 2) | string | yes | Cell text, such as a status word. |
53
+ | rows[].cols[].tone (rows[] branch 1 \| rows[] branch 2) | string | | Status tone; omitted, the cell is plain text. A tone is drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
54
54
  | rows[].kind (rows[] branch 1) | string | | Task row containing individual timeline items; task is the default row kind. One of `'task'`. |
55
55
  | rows[].items (rows[] branch 1) | array | yes | Timeline items placed in this task row. |
56
56
  | rows[].items[].id (rows[] branch 1) | string | yes | Unique item identity used by annotations and scene elements. |
@@ -65,13 +65,6 @@ One form; its chart ID is `gantt`.
65
65
  | rows[].items[].anchor.toItemId (rows[] branch 1) | string | yes | Target item id whose start or end anchors this item. |
66
66
  | rows[].items[].anchor.edge (rows[] branch 1) | string | yes | Target edge used to resolve the anchored start date. One of `'start'`, `'end'`. |
67
67
  | rows[].items[].anchor.offsetDays (rows[] branch 1) | integer | | Signed number of days added to the target edge; defaults to zero. |
68
- | rows[].id (rows[] branch 2) | string | yes | Unique timeline row identity. |
69
- | rows[].label (rows[] branch 2) | string | yes | Visible timeline row name. |
70
- | rows[].sublabel (rows[] branch 2) | string | | Second line under the row name, such as what the row measures. Printed in the label font and muted ink, on one line and never cut; the name band takes the wider of name and sublabel. On narrow canvases it follows the name on the row's name line. labels.activity: false hides it with the name. |
71
- | rows[].indent (rows[] branch 2) | integer | | Nonnegative indentation level for the row label. |
72
- | rows[].cols (rows[] branch 2) | array | | Metadata columns beside the row label, such as owner and status; up to three are displayed. A cell is text, or text with a tone. |
73
- | rows[].cols[].text (rows[] branch 2) | string | yes | Cell text, such as a status word. |
74
- | rows[].cols[].tone (rows[] branch 2) | string | | Status tone; omitted, the cell is plain text. A tone is drawn as a small filled marker in the tone's colour before the text. The row's bars and chevrons without a colorRole take the same colour, as do those of rows indented under it without a status, so the status column keys them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
75
68
  | rows[].kind (rows[] branch 2) | string | yes | Cadence row showing repeated dated event markers. One of `'cadence'`. |
76
69
  | rows[].events (rows[] branch 2) | array | yes | Dated events placed along this cadence row. |
77
70
  | rows[].events[].id (rows[] branch 2) | string | yes | Unique event identity shared with the timeline mark id namespace. |
@@ -99,7 +92,7 @@ One form; its chart ID is `gantt`.
99
92
  | columnOverrides.*.label | string | | | Head text. |
100
93
  | columnOrder | array | | | Order of whole blocks; blocks left out follow in default order. Ids: meta, plot. |
101
94
 
102
- Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `valueAxis`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
95
+ Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labelPosition`, `valueAxis`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
103
96
 
104
97
  ## Annotations
105
98
 
@@ -166,12 +166,13 @@ Facets, variance tiers and metric stacks with shared categories and computed rea
166
166
  | alignmentRules[].at.categoryId | string | | | Existing x-axis category id; required for a category anchor. |
167
167
  | alignmentRules[].fromPanelId | string | | | Panel whose top or left slot edge starts the guide; omission uses the grid content edge. |
168
168
  | alignmentRules[].toPanelId | string | | | Panel whose bottom or right slot edge ends the guide; omission uses the grid content edge. |
169
- | sharedAxis | string | `'category'`, `'none'` | | Metric stacks imply category and use top-down order with independent scales. Otherwise default: category only for exactly one column panel plus one or more variance panels (no integrated variance); none otherwise. none honours columns and array order. category uses one column in bottom-up order with the category-axis owner at the bottom; it warns if columns or panelOrder are overridden. These column/variance tiers use 4:1 plot heights unless authored tracks or a shared y scale apply. |
169
+ | sharedAxis | string | `'category'`, `'none'` | | Metric stacks imply category and use top-down order with independent scales. Otherwise default: category only for exactly one column panel plus one or more variance panels (no integrated variance); none otherwise. none honours columns and array order. category uses one column in bottom-up order with the category-axis owner at the bottom (over variance tiers, the column panel wherever it is listed); it warns if columns or panelOrder are overridden. These column/variance tiers use 4:1 plot heights unless authored tracks or a shared y scale apply. |
170
+ | variancePosition | string | `'above'`, `'below'` | | Category tiers only: where the variance tiers stand. 'above' (default) puts them over the column panel, with the category labels at the bottom of the exhibit. 'below' puts them under it in authored order, with the category labels between the columns and the tiers. |
170
171
  | sharedScale | boolean | | | Default: panels share one y scale in every sharedAxis mode only with evidence that they show one measure: every numeric panel names the same non-empty unit and format, the grid names a unit, or the panels come from repeat or a scaleGroup. Without that evidence each panel keeps its own scale, also when all panels are the same chart type. Set true to share panels without a unit, false for independent panel domains. Metric stacks always use independent zero scales and refuse true. |
171
172
  | panelOrder | string | `'sheet'`, `'lastDesc'`, `'lastAsc'`, `'totalDesc'`, `'totalAsc'` | | Facet panel order: 'sheet' keeps the authored array (default), 'last*' ranks by each panel's final value, 'total*' by its sum. Panels with no measurable value stay last in both directions. |
172
173
  | reflow | boolean | | | Facets only: a grid of more panels than a numeric columns count, on a card under 480 px, takes columns as a maximum. Where a panel drops category names for room, it draws with fewer columns, down to two, at the largest count that prints every name and that an authored height seats. Default true; false keeps the authored count. |
173
174
 
174
- Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labels`, `valueAxis.tickStep`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `story`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction` with an `option-ignored` warning.
175
+ Plus the [shared options](options.md). This type does not accept `format`, `detailFields`, `labels`, `labelPosition`, `valueAxis.tickStep`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `story`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis` with an `option-ignored` warning.
175
176
 
176
177
  ## Annotations
177
178
 
@@ -274,6 +275,8 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
274
275
  | stacked-plus-dpy-tiered | example | Opt-in scaled ΔPY% tier above stacked revenue |
275
276
  | three-tier | example | Three tiers: actuals, ΔPY absolute, ΔPY% |
276
277
  | weekly-actual-vs-plan | example | Actual vs plan by week: AC columns with PL ticks over a ΔPL tier |
278
+ | actual-vs-plan-callout | example | Actual vs plan by year with a callout on the year below plan, over a ΔPL tier |
279
+ | weekly-actual-vs-plan-variance-below | example | Actual vs plan by week with the ΔPL tier below the columns |
277
280
  | compact-tier-slack | torture | Torture: compact tiers distribute vertical slack |
278
281
  | facet-regions | example | Facets: four regions, 2×2 |
279
282
  | facet-regions-ranked | torture | Facets ordered by last value, largest first |
@@ -70,7 +70,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
70
70
  |---|---|---|---|---|
71
71
  | scale | string | `'continuous'`, `'discrete'` | `'continuous'` | Continuous color interpolation by default, or a discrete color ladder. |
72
72
  | variant | string | `'value'`, `'harvey'`, `'bubble'` | `'value'` | Value labels fit as a whole row, and an automatic number text loses a % sign the unit names, then takes fewer decimals, before a value is hidden; authored labels and valid pins retain precedence. Harvey glyphs suppress values and take ratings 0 to 4 only; any other value is refused. 'bubble': one circle per cell, colour = value, area = series sizes; values print where they fit. |
73
- | cap | object | | | Where the continuous scale saturates, as table heat's cap: a value at or past it paints full strength, measured from zero. Without it the good/bad scale is symmetric, full at the largest \|value\|, and the magnitude ramp spans the data. The discrete ladder and harvey glyphs ignore it (cap-ignored). |
73
+ | cap | object | | | Where the continuous scale saturates, as table heat's cap: a value at or past it paints full strength, measured from zero. Without it the good/bad scale is symmetric, full at the largest \|value\|, and the magnitude ramp spans the data. The discrete ladder ignores it (cap-ignored), and harvey glyphs ignore it (option-ignored). |
74
74
  | cap.pct | number | | | Cap in points when every cell is a percent. Example: 20 saturates at ±20%. |
75
75
  | cap.abs | number | | | Cap in source units for other values. |
76
76
  | breaks | array | | | Bin edges. Ascending, for scale 'discrete', e.g. [0, 30, 50, 100]; an edge value takes the upper bin. A series direction paints bins bad to good. |
@@ -87,7 +87,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
87
87
  | minBase | number | | | Low-base threshold. Cells whose series bases entry is below it draw hatched, with a note. |
88
88
  | missing | string | `'hatch'`, `'blank'` | | How a cell with no value is drawn. 'hatch' (the default) stripes the cell and names it in the key. 'blank' draws no fill and no stripe; the same key entry or note still says that a blank cell is no data. A blank cell keeps its grid line and dash, so it does not read as the palest value. A low base (bases and minBase) stays hatched. |
89
89
 
90
- Plus the [shared options](options.md). This type does not accept `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
90
+ Plus the [shared options](options.md). This type does not accept `labelPosition`, `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
91
91
 
92
92
  ## Annotations
93
93
 
@@ -95,12 +95,16 @@ An annotation anchor is a category or item id string, or an object with category
95
95
 
96
96
  | Kind | Purpose | Required | Anchors | Optional fields | Notes |
97
97
  |---|---|---|---|---|---|
98
- | 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. |
99
- | 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. |
100
- | 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. | |
98
+ | 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. |
99
+ | 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. |
100
+ | 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. | |
101
101
  | note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
102
- | 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 | | |
102
+ | 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. | |
103
103
  | abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
104
+ | 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. |
105
+ | 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. |
106
+ | 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. |
107
+ | 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. |
104
108
 
105
109
  ## Sizing
106
110
 
@@ -70,7 +70,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
70
70
  | density | string | `'compact'`, `'regular'` | `'regular'` | Card density. 'compact' uses the smaller figure and spark share, and a 280 px default card width instead of 360. An unsized card takes its content height. 'regular' is the default. |
71
71
  | comparisons | string | `'chip'`, `'text'` | | How compare[] and attainment are drawn. Omitted, a standalone regular card without a spark draws the steering form: the comparisons as rows of toned text with their names in a column, the attainment as a progress bar with a 100% tick, in one band on a wide card; a grid panel, a compact card, a card with a spark and a card whose height cannot hold the form draw chips. 'chip' tints a chip behind each; 'text' draws each as delta is drawn: text in its tone, no fill, compare entries on one row. colorblindSafe paints good and bad deltas, chips, attainment and value bands with the theme's colour-blind pair. |
72
72
 
73
- Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `story`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `legend`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
73
+ Plus the [shared options](options.md). This type does not accept `detailFields`, `labelPosition`, `valueAxis`, `story`, `hatchStrength`, `rounding`, `annotations`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `legend`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
74
74
 
75
75
  ## Annotations
76
76