boardplot 0.53.0 → 0.55.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +475 -0
- package/README.md +15 -14
- package/dist/{ReaderBox-VOJSJ66R.js → ReaderBox-3FFPHWSI.js} +15 -10
- package/dist/{annotateEngine-DLMFJZ67.js → annotateEngine-ET4DM2OK.js} +5 -1
- package/dist/build-identity.json +3 -3
- package/dist/{chunk-SS42FJVN.js → chunk-2ALFFOKB.js} +460 -148
- package/dist/chunk-2BP6X5GX.js +125 -0
- package/dist/chunk-2C4SYWZ3.js +25 -0
- package/dist/{chunk-7X2ZYVAX.js → chunk-2TAK2ELB.js} +3 -3
- package/dist/{chunk-XZOHR765.js → chunk-2YNF6AHH.js} +5 -5
- package/dist/{chunk-DDI2W4TR.js → chunk-32IKJMUF.js} +3 -3
- package/dist/{chunk-ADKCLH3Z.js → chunk-33FCWTGT.js} +1 -1
- package/dist/{chunk-AQROQDLR.js → chunk-37A6CLR5.js} +1729 -196
- package/dist/{chunk-DCTCUZ5L.js → chunk-3AJY353W.js} +3 -3
- package/dist/chunk-3B3CFJ2H.js +48 -0
- package/dist/{chunk-M4EUXOLU.js → chunk-3B3K7TD5.js} +83 -9
- package/dist/{chunk-QSXK6PJL.js → chunk-3C24WWUQ.js} +1 -1
- package/dist/{chunk-BWTX7LUG.js → chunk-3L2VXXM4.js} +9 -4
- package/dist/{chunk-DO5OZJAO.js → chunk-3OZRODC4.js} +39 -21
- package/dist/{chunk-A6CQPJWR.js → chunk-3XOWXLLQ.js} +6 -7
- package/dist/{chunk-TBGUEF3M.js → chunk-3ZAH24P6.js} +164 -51
- package/dist/{chunk-TGK6KUGN.js → chunk-4CJ6UCX4.js} +33 -16
- package/dist/{chunk-VDAZPGR2.js → chunk-4DZFR52I.js} +2 -2
- package/dist/{chunk-323YZWYJ.js → chunk-4WT3T5SH.js} +124 -54
- package/dist/{chunk-O3S2KNIW.js → chunk-4X3HNETE.js} +3 -3
- package/dist/{chunk-FBB4BWKN.js → chunk-4Y7BA2NW.js} +4 -4
- package/dist/{chunk-AWTG3RFF.js → chunk-4YHZSPAJ.js} +6 -7
- package/dist/{chunk-CNX7EGSU.js → chunk-5DMHMQFP.js} +7 -7
- package/dist/{chunk-BPKXEMRE.js → chunk-5SHI57XD.js} +45 -14
- package/dist/{chunk-H63XQ3OO.js → chunk-5SLJGRUO.js} +139 -47
- package/dist/{chunk-5LYXD6ME.js → chunk-5UVJKB7L.js} +137 -70
- package/dist/{chunk-ZNHFLJSY.js → chunk-63L35UCI.js} +6 -6
- package/dist/{chunk-YCNLQYTC.js → chunk-6C64IBOG.js} +5 -5
- package/dist/{chunk-N3TPMXS3.js → chunk-6D4EO3S7.js} +5 -5
- package/dist/chunk-6H3OSHEY.js +25 -0
- package/dist/chunk-6WZZADRL.js +25 -0
- package/dist/{chunk-6RBTTCQD.js → chunk-75TWO5B2.js} +89 -57
- package/dist/chunk-7ADUVRG5.js +14 -0
- package/dist/{chunk-3QWZAEW5.js → chunk-7DAH2E4T.js} +4 -3
- package/dist/{chunk-VKQNDOAI.js → chunk-7FKY6YWU.js} +11 -7
- package/dist/{chunk-NSSNYY6Y.js → chunk-7GVYMGLK.js} +6 -3
- package/dist/{chunk-KZS46KDY.js → chunk-7Q2WV6D2.js} +3 -3
- package/dist/{chunk-JFBEAUJ6.js → chunk-7Q37C6GZ.js} +1 -1
- package/dist/{chunk-SPTPFY4S.js → chunk-7UPZPFHQ.js} +41 -34
- package/dist/{chunk-V6O6KVOA.js → chunk-7Z73MM35.js} +14 -6
- package/dist/{chunk-MJZHFH5R.js → chunk-AB35GVPG.js} +80 -31
- package/dist/{chunk-MYMT5KJL.js → chunk-AF7EB6N6.js} +151 -84
- package/dist/chunk-AIU4GZV5.js +24 -0
- package/dist/{chunk-KSJVENRU.js → chunk-AM2CG7VX.js} +13 -3
- package/dist/{chunk-XN4ARQ2W.js → chunk-APQPYM2Z.js} +3 -3
- package/dist/{chunk-AHQ4L3BE.js → chunk-AZM4YNRE.js} +2 -2
- package/dist/{chunk-XXOHXA3A.js → chunk-B3AXM3MT.js} +2 -2
- package/dist/{chunk-BWGRWGVA.js → chunk-BDGLMWPO.js} +14 -14
- package/dist/{chunk-EHBB2Z4D.js → chunk-BFFPYT3Y.js} +13 -7
- package/dist/{chunk-2QT5ZUHO.js → chunk-BGJRCG7N.js} +135 -114
- package/dist/{chunk-RNOJSEES.js → chunk-BK6P6KMW.js} +1 -1
- package/dist/{chunk-XB4KZ6WO.js → chunk-BSATR6ZO.js} +40 -13
- package/dist/{chunk-4UVW5WU6.js → chunk-BVYIKLQ5.js} +1 -1
- package/dist/chunk-BWVNCLUS.js +19 -0
- package/dist/{chunk-LCWJS34U.js → chunk-CKNOLGRR.js} +1 -1
- package/dist/chunk-CLGUFVHM.js +24 -0
- package/dist/{chunk-NY5NUFDZ.js → chunk-COQEHO7B.js} +3 -3
- package/dist/{chunk-3EZRM4YM.js → chunk-CPGASWNN.js} +25 -1
- package/dist/{chunk-GTG3IGLF.js → chunk-CVIW2MV4.js} +284 -150
- package/dist/chunk-CYKIX3IQ.js +24 -0
- package/dist/{chunk-DIHUGBZO.js → chunk-CZ3WCG55.js} +5 -4
- package/dist/{chunk-DRTA6JG5.js → chunk-D2B3KP35.js} +26 -15
- package/dist/{chunk-6OCR6ITN.js → chunk-D2QMNHCC.js} +4 -5
- package/dist/{chunk-EUADDXAV.js → chunk-D7G27EYZ.js} +4 -4
- package/dist/{chunk-NOSDEJ3K.js → chunk-DB2JKPOX.js} +806 -69
- package/dist/{chunk-2CVH5E57.js → chunk-DEYAI662.js} +60 -13
- package/dist/{chunk-HA4IPWMM.js → chunk-DRHQG44U.js} +23 -5
- package/dist/{chunk-WZGJSQKN.js → chunk-DZ3S4RPI.js} +15 -1
- package/dist/{chunk-B6GFKYBZ.js → chunk-E44W4EEG.js} +8 -5
- package/dist/{chunk-YCRGWQBS.js → chunk-E5OEWMNX.js} +66 -12
- package/dist/chunk-E6HDUEGK.js +26 -0
- package/dist/{chunk-A7IEVBYI.js → chunk-E76U5H52.js} +1 -5
- package/dist/{chunk-NKIYLFXZ.js → chunk-EAR43REB.js} +213 -73
- package/dist/{chunk-NQDVMUHX.js → chunk-EBC5TMI2.js} +29 -8
- package/dist/chunk-EBVJCVXL.js +25 -0
- package/dist/chunk-EC2PGJ64.js +24 -0
- package/dist/chunk-EGPXEY2K.js +24 -0
- package/dist/{chunk-CUVUDK4O.js → chunk-EQRFSVDD.js} +2 -1
- package/dist/{chunk-CYOJZ3GQ.js → chunk-EW47LNWH.js} +228 -58
- package/dist/{chunk-7EVIIADO.js → chunk-EXDMYV5W.js} +3 -1
- package/dist/{chunk-VJ3FCGQF.js → chunk-EZZ533MH.js} +1 -1
- package/dist/{chunk-IBXXZVG7.js → chunk-F5V7YFKS.js} +11 -8
- package/dist/{chunk-COYOTQC2.js → chunk-F6CVYNDY.js} +5 -4
- package/dist/{chunk-66RFKRGO.js → chunk-F6OLHND5.js} +2 -2
- package/dist/chunk-FI5EXISD.js +27 -0
- package/dist/{chunk-CAQ5P4VN.js → chunk-FQF7GSJK.js} +46 -27
- package/dist/{chunk-XJP5DKIL.js → chunk-FS6ZE5TG.js} +2 -2
- package/dist/{chunk-7CTKTIPF.js → chunk-G63WXSQP.js} +75 -34
- package/dist/{chunk-3A2IEBCN.js → chunk-GCSCHK5Y.js} +4 -18
- package/dist/{chunk-REOPXBUR.js → chunk-GD5TYS5R.js} +32 -21
- package/dist/{chunk-RGZGLKFB.js → chunk-GDVR3XHT.js} +418 -62
- package/dist/{chunk-XQCQZBGX.js → chunk-GDZI5ZJ7.js} +1 -1
- package/dist/{chunk-P5RNWMZC.js → chunk-GFIT3FRE.js} +277 -291
- package/dist/chunk-GM2HIU6C.js +24 -0
- package/dist/{chunk-DOFYKPTC.js → chunk-GMJFCBR6.js} +1 -1
- package/dist/{chunk-CRNMNZJD.js → chunk-H3AEYPRP.js} +66 -43
- package/dist/{chunk-BUPLB3EX.js → chunk-H3IBJQ5A.js} +6 -2
- package/dist/chunk-H4VDQ7OE.js +24 -0
- package/dist/{chunk-J6I2YFJH.js → chunk-H5L2P2GO.js} +6 -4
- package/dist/{chunk-X4YNDLVA.js → chunk-HFRQLMKK.js} +12 -7
- package/dist/{chunk-YG5GUELW.js → chunk-HGT3UKDW.js} +91 -48
- package/dist/{chunk-CWDHCSL2.js → chunk-HJRNBKIT.js} +801 -76
- package/dist/{chunk-FV3VF36K.js → chunk-HLOXWM2O.js} +119 -63
- package/dist/{chunk-3SQCCESO.js → chunk-HR2BKLS3.js} +113 -128
- package/dist/{chunk-S4QSJAGY.js → chunk-HZUAEMN5.js} +1 -1
- package/dist/{chunk-QWXWVPNE.js → chunk-IF2ZABAM.js} +2 -2
- package/dist/chunk-IF76JRXT.js +24 -0
- package/dist/chunk-IGNBQT23.js +248 -0
- package/dist/{chunk-DCCJRLAJ.js → chunk-IGVAWAOK.js} +31 -96
- package/dist/{chunk-DDCB7ZA5.js → chunk-ILFQ75N4.js} +253 -141
- package/dist/chunk-INHDHZNP.js +8 -0
- package/dist/chunk-IOKWBUQP.js +25 -0
- package/dist/{chunk-33PB4V6K.js → chunk-IQDMZ33D.js} +20 -9
- package/dist/{chunk-IDDA5INB.js → chunk-IVRYF7QA.js} +7 -4
- package/dist/{chunk-L7RHB734.js → chunk-J5PL6JLL.js} +1 -1
- package/dist/chunk-JBMWRXDS.js +24 -0
- package/dist/{chunk-RPIW5T55.js → chunk-JKOEHRGV.js} +1 -1
- package/dist/chunk-JMGB444D.js +26 -0
- package/dist/chunk-JU7S52HI.js +26 -0
- package/dist/{chunk-BBL3R5YZ.js → chunk-JXBZIJCG.js} +1 -1
- package/dist/{chunk-WLZ54FWG.js → chunk-JYAZPMSA.js} +70 -1
- package/dist/chunk-K5S3K6QK.js +24 -0
- package/dist/{chunk-5LGSRWFC.js → chunk-KAYBRD4F.js} +3 -3
- package/dist/{chunk-N3G2FYDL.js → chunk-KC52E5G4.js} +31 -20
- package/dist/{chunk-LNKY5Z2X.js → chunk-KDSYZLF6.js} +2 -3
- package/dist/{chunk-B67K6OWJ.js → chunk-KEDNHCGB.js} +4 -4
- package/dist/chunk-KFGZMHIB.js +28 -0
- package/dist/{chunk-KPKXJYQH.js → chunk-KHRAJDBM.js} +1 -1
- package/dist/{chunk-2V6CLH33.js → chunk-KND4OM4B.js} +117 -102
- package/dist/{chunk-X6SUFTD7.js → chunk-KZH2QI6S.js} +2 -2
- package/dist/{chunk-IYEFEBRN.js → chunk-KZJ5VM6E.js} +14 -3
- package/dist/{chunk-JSEYUJUQ.js → chunk-LA5OYJ5P.js} +146 -69
- package/dist/{chunk-MVV6RQMG.js → chunk-LAVVML3X.js} +33 -9
- package/dist/{chunk-4G2O2ZPJ.js → chunk-LD4LML5P.js} +10 -8
- package/dist/{chunk-OURX73UJ.js → chunk-LF6RTFNK.js} +13 -11
- package/dist/{chunk-SVZDXFPX.js → chunk-LFUJTEJO.js} +100 -36
- package/dist/{chunk-53OYF4ZT.js → chunk-LHKDZAWN.js} +16 -8
- package/dist/{chunk-GCBOHVDZ.js → chunk-LLDKKEUD.js} +1 -1
- package/dist/{chunk-VTEV3WVF.js → chunk-LRCO4G7C.js} +314 -92
- package/dist/{chunk-5HECRVXJ.js → chunk-LSF76AS3.js} +7 -3
- package/dist/chunk-M427S3G7.js +25 -0
- package/dist/{chunk-ZMF7WEGG.js → chunk-MEMPP7VZ.js} +3 -3
- package/dist/{chunk-D7SHZDA3.js → chunk-MJMOKPTF.js} +186 -167
- package/dist/chunk-MLGEBFEX.js +47 -0
- package/dist/chunk-MLW72KWN.js +24 -0
- package/dist/chunk-MQYIBGZE.js +19 -0
- package/dist/{chunk-SDSONLMZ.js → chunk-MTRV3BJL.js} +301 -130
- package/dist/{chunk-H4H4O62O.js → chunk-N5HN5QGH.js} +1 -1
- package/dist/chunk-N5TZL74Y.js +53 -0
- package/dist/chunk-N7N5NIAU.js +211 -0
- package/dist/{chunk-XN7MQO45.js → chunk-NA6WLZ66.js} +66 -26
- package/dist/{chunk-B54RN2FD.js → chunk-NB7M4KX4.js} +99 -56
- package/dist/{chunk-ADWSGPH5.js → chunk-NCZWLV7T.js} +4 -4
- package/dist/{chunk-C54QLNE4.js → chunk-NGA7ICG4.js} +1 -1
- package/dist/{chunk-TJSND556.js → chunk-NHYKSPL4.js} +155 -100
- package/dist/chunk-NMTWUYUF.js +30 -0
- package/dist/{chunk-Q3CV2JJ2.js → chunk-NOCIN2EM.js} +425 -251
- package/dist/{chunk-SKRSCTT5.js → chunk-NUCYUKVH.js} +3 -3
- package/dist/{chunk-S32YYDIB.js → chunk-NVGAEQ6M.js} +4 -3
- package/dist/{chunk-N23YFPPI.js → chunk-O2KKQNGW.js} +4 -1
- package/dist/chunk-O36WX56O.js +13 -0
- package/dist/{chunk-FF23FYQD.js → chunk-O4WJWHCH.js} +187 -85
- package/dist/{chunk-H67RTX46.js → chunk-O6NJDRXE.js} +2 -2
- package/dist/{chunk-2DOR5SS6.js → chunk-O7DVW3IE.js} +141 -68
- package/dist/{chunk-2VWJ5BGO.js → chunk-O7W35PT3.js} +13 -12
- package/dist/{chunk-MF6IVSBJ.js → chunk-ODZJ4LW7.js} +6 -3
- package/dist/{chunk-FG6EDGMI.js → chunk-OHGEDG46.js} +1 -1
- package/dist/{chunk-HZI56ASJ.js → chunk-OJ2BPQGQ.js} +11 -5
- package/dist/chunk-ONKSGT2M.js +28 -0
- package/dist/{chunk-2WNYRWHG.js → chunk-OOFSQ5AS.js} +1 -1
- package/dist/{chunk-IYMI7YI4.js → chunk-OY2UJ4XK.js} +64 -42
- package/dist/{chunk-6Y7EXYLR.js → chunk-P6TA7M3G.js} +102 -32
- package/dist/{chunk-MQFCG4KS.js → chunk-PQYJZMCR.js} +99 -92
- package/dist/{chunk-BWLOXQDV.js → chunk-PYV6ZIR6.js} +41 -14
- package/dist/chunk-PZ46S2SY.js +69 -0
- package/dist/{chunk-IL5T7I2A.js → chunk-Q3E74U2W.js} +4 -4
- package/dist/{chunk-TXS3U77A.js → chunk-QBJDHFJJ.js} +4 -2
- package/dist/chunk-QBRRJ5OR.js +24 -0
- package/dist/{chunk-P6KZIZDV.js → chunk-QEP3X3OV.js} +141 -79
- package/dist/{chunk-CCCEBIUZ.js → chunk-QKWBDH2L.js} +2 -2
- package/dist/{chunk-QY5ZKUWY.js → chunk-QOWE55RR.js} +9 -3
- package/dist/{chunk-SREWFAAJ.js → chunk-QRVIS2QB.js} +6 -5
- package/dist/chunk-R27IDIJI.js +24 -0
- package/dist/{chunk-G5FMTRG5.js → chunk-RNIYG6PI.js} +2 -2
- package/dist/{chunk-PEUSKIFV.js → chunk-RO2PSSAI.js} +13 -23
- package/dist/{chunk-ZQF34VPS.js → chunk-ROLR7HRB.js} +12 -6
- package/dist/{chunk-YF2PYLC4.js → chunk-RSCRIWAH.js} +1 -1
- package/dist/{chunk-L6DJ4ZY5.js → chunk-RTXRIZYU.js} +370 -134
- package/dist/{chunk-VK5ZDV67.js → chunk-RUWNG2JC.js} +6 -5
- package/dist/chunk-RYPJB3RO.js +132 -0
- package/dist/{chunk-DAVHGK27.js → chunk-S7NRL66K.js} +46 -23
- package/dist/{chunk-VABRPZVC.js → chunk-SA46CNMS.js} +5 -1
- package/dist/{chunk-3H2W76TB.js → chunk-SBR2RLEQ.js} +72 -38
- package/dist/chunk-SC42DPNV.js +24 -0
- package/dist/{chunk-27QADBDV.js → chunk-SFG7NG23.js} +20 -3
- package/dist/{chunk-AG2CJ4JY.js → chunk-SNQ7D5R7.js} +18 -1
- package/dist/{chunk-QTZVVZ2A.js → chunk-SPSGUFTI.js} +11 -3
- package/dist/chunk-SRUV7AT6.js +51 -0
- package/dist/{chunk-F6CNPC4L.js → chunk-SZXKV3BX.js} +1 -1
- package/dist/{chunk-UB6ODJHO.js → chunk-T5Y4HXYO.js} +7 -4
- package/dist/{chunk-EJPVVGD7.js → chunk-U7W7GYXP.js} +37 -37
- package/dist/{chunk-LFX7W4B7.js → chunk-UDKYY27B.js} +1 -1
- package/dist/{chunk-24BHMKDD.js → chunk-UF3HSFAE.js} +25 -2
- package/dist/chunk-UIYXMPDW.js +24 -0
- package/dist/{chunk-N7J7CZS6.js → chunk-UNMIUILK.js} +1 -1
- package/dist/chunk-V3MSLNSD.js +24 -0
- package/dist/chunk-V634AXDM.js +31 -0
- package/dist/{chunk-57ZGVAU3.js → chunk-V7F4F6JA.js} +39 -6
- package/dist/{chunk-4X66BTP5.js → chunk-VBVG6NEL.js} +6 -6
- package/dist/chunk-VL7WLE4H.js +24 -0
- package/dist/chunk-W45AR6EW.js +94 -0
- package/dist/{chunk-RL3NUWMY.js → chunk-WALYNKBN.js} +444 -101
- package/dist/{chunk-DYS7EIXY.js → chunk-WAPCCJUB.js} +70 -26
- package/dist/{chunk-FBAYZSFC.js → chunk-WDIVAU5U.js} +241 -118
- package/dist/{chunk-EHVESNLV.js → chunk-WEMUCDPK.js} +1 -1
- package/dist/{chunk-N73IBH55.js → chunk-WFSOKGGA.js} +2 -2
- package/dist/{chunk-WI5ITCOH.js → chunk-WG5CJGLU.js} +2 -2
- package/dist/{chunk-S6UX7KB6.js → chunk-WQT6HIIY.js} +18 -17
- package/dist/{chunk-MZL6LGKO.js → chunk-WSJDLZSZ.js} +78 -47
- package/dist/{chunk-XJI6SWFS.js → chunk-WWIY6BBY.js} +77 -38
- package/dist/{chunk-33PLBIMA.js → chunk-WXJ5MHLH.js} +3 -2
- package/dist/chunk-X3YP4DUV.js +76 -0
- package/dist/{chunk-MBKZYJRC.js → chunk-X7XTIM6U.js} +50 -36
- package/dist/chunk-XJQXFVXY.js +24 -0
- package/dist/{chunk-KZJOV4QW.js → chunk-XMN3Z43K.js} +5 -5
- package/dist/{chunk-2ND7ZITT.js → chunk-XPOMQWXY.js} +90 -70
- package/dist/chunk-XVUQMZWV.js +24 -0
- package/dist/chunk-XYYRHGQI.js +24 -0
- package/dist/{chunk-NHQGRKEA.js → chunk-XZLU3G23.js} +7 -7
- package/dist/chunk-Y2CAIAUI.js +24 -0
- package/dist/{chunk-QO6HEXIZ.js → chunk-Y3L655X6.js} +6 -6
- package/dist/{chunk-QKL7IY42.js → chunk-Y54LU4CU.js} +1 -1
- package/dist/chunk-YGTNVZJE.js +89 -0
- package/dist/{chunk-LIWLBLCT.js → chunk-YLC42C3M.js} +1 -1
- package/dist/{chunk-SGD3ZHID.js → chunk-YOOHNQ3L.js} +15 -4
- package/dist/{chunk-DRW6KGBK.js → chunk-YTCIGJUU.js} +116 -42
- package/dist/{chunk-ULTSSIOU.js → chunk-YV5KYGE5.js} +1 -1
- package/dist/{chunk-4RRNJLCM.js → chunk-YXM4W3TN.js} +146 -67
- package/dist/{chunk-2L2Q53EP.js → chunk-Z2X4JQNY.js} +81 -21
- package/dist/{chunk-LS7HVBI7.js → chunk-Z5V6ZM76.js} +3 -3
- package/dist/{chunk-DU4A5AOY.js → chunk-Z7NHFNH3.js} +165 -79
- package/dist/{chunk-HOAH5XBR.js → chunk-ZBSNF5F7.js} +208 -62
- package/dist/chunk-ZGHBDMYF.js +24 -0
- package/dist/{chunk-TM4OC53S.js → chunk-ZHFUMVW7.js} +2 -1
- package/dist/{chunk-TWOREVKJ.js → chunk-ZLYQWUNR.js} +84 -50
- package/dist/chunk-ZTMZOKVC.js +61 -0
- package/dist/cli/index.js +3 -3
- package/dist/{core-LA6XDYG7.js → core-2SICIP63.js} +6 -1
- package/dist/{core-5HQBPCHL.js → core-2YTKFBNZ.js} +6 -1
- package/dist/{core-FVR3WZEC.js → core-3647Z25D.js} +5 -1
- package/dist/{core-GES44OTS.js → core-3IJPBNGC.js} +3 -1
- package/dist/{core-KKQS3WI2.js → core-6HMJHFRR.js} +9 -1
- package/dist/{core-QY7AVIKZ.js → core-7JKE7H32.js} +6 -1
- package/dist/{core-WUQVFARS.js → core-BMY7OL76.js} +6 -1
- package/dist/{core-4BZQQSHS.js → core-CAL7YNFC.js} +4 -1
- package/dist/{core-NP4VHWXL.js → core-CBEGB2NO.js} +4 -1
- package/dist/{core-C6YUSTZI.js → core-CLLIG7ZU.js} +3 -1
- package/dist/{core-MJ7JWQT5.js → core-CTZLHGXE.js} +2 -1
- package/dist/{core-UHECQHJ2.js → core-EYJ3WJK4.js} +4 -1
- package/dist/{core-ETAGQBZO.js → core-FX7HRKTF.js} +3 -1
- package/dist/{core-Z2F3IGSR.js → core-GQC6VDW5.js} +4 -1
- package/dist/{core-IKD3EE3S.js → core-GRWI22NS.js} +4 -1
- package/dist/{core-OJUQLIQ5.js → core-H7KMWYP5.js} +5 -1
- package/dist/{core-WGM4XUN3.js → core-HJUGHAX7.js} +3 -1
- package/dist/{core-V5FV4NWL.js → core-JMYMIH6Z.js} +9 -1
- package/dist/{core-GGQREDSI.js → core-KEB5PBCO.js} +6 -1
- package/dist/{core-6RYHWUJO.js → core-MEC6A5DD.js} +5 -1
- package/dist/{core-GCTFVYMH.js → core-MV6KGAUV.js} +4 -1
- package/dist/{core-MR52YBRX.js → core-NTWHFDM4.js} +3 -1
- package/dist/{core-SBQMHWTA.js → core-OIC5KJSD.js} +7 -1
- package/dist/{core-Q6VLFFYC.js → core-OWCTIPHD.js} +6 -1
- package/dist/{core-NSIJEKLI.js → core-PMYCLXT7.js} +6 -1
- package/dist/{core-EEB7HTCL.js → core-PTRQPQTO.js} +4 -1
- package/dist/{core-3VCCUFVX.js → core-QABTVASG.js} +3 -1
- package/dist/{core-AJTVU6X7.js → core-RPQBIOU4.js} +5 -1
- package/dist/{core-4VT4MHNB.js → core-SKRADU7T.js} +4 -1
- package/dist/{core-EFMVDWNH.js → core-T2KHX5LG.js} +4 -1
- package/dist/{core-PB3VUQSS.js → core-T4ZH3FAU.js} +3 -1
- package/dist/{core-JM4R426L.js → core-UAY2G7LN.js} +2 -1
- package/dist/{core-NQLNZDX5.js → core-ULZ7XUQP.js} +5 -1
- package/dist/{core-MLROKJ2M.js → core-VBR253SM.js} +4 -1
- package/dist/{core-7BZJCIXN.js → core-VMIBBHXI.js} +4 -1
- package/dist/{core-5535KXRD.js → core-XMTKUXLO.js} +4 -1
- package/dist/{core-HRYOV6QD.js → core-YEFGEW3Z.js} +4 -1
- package/dist/{dataTable-3CPPIHB3.js → dataTable-2ZXK54TP.js} +4 -2
- package/dist/{engine-FXFBCWHB.js → engine-HGXSWGOI.js} +27 -27
- package/dist/fixtures.js +7 -1
- package/dist/{fontTables-WYCZNRE7.js → fontTables-ZPZQ6IR3.js} +1 -1
- package/dist/fonts.js +2 -1
- package/dist/geo/dach.js +3 -1
- package/dist/geo/de-states.js +3 -1
- package/dist/geo/eu27.js +3 -1
- package/dist/geo/europe.js +3 -1
- package/dist/geo/index.js +4 -2
- package/dist/geo/us-states.js +3 -1
- package/dist/geo/world.js +3 -1
- package/dist/index.js +31 -26
- package/dist/{main-YLKBTHJP.js → main-PVT6FMGC.js} +55 -24
- package/dist/mcp/server.js +51 -23
- package/dist/{module-SVEW5ZUE.js → module-ZSR7KTAS.js} +1 -1
- package/dist/react/bar.js +7 -1
- package/dist/react/bartable.js +7 -1
- package/dist/react/box.js +7 -1
- package/dist/react/bullet.js +5 -1
- package/dist/react/butterfly.js +6 -1
- package/dist/react/choropleth.js +5 -1
- package/dist/react/cohort.js +5 -1
- package/dist/react/column.js +10 -1
- package/dist/react/combo.js +4 -1
- package/dist/react/creative.js +3 -1
- package/dist/react/diagram.js +4 -1
- package/dist/react/dimswitch.js +5 -1
- package/dist/react/dot.js +10 -1
- package/dist/react/export.js +34 -31
- package/dist/react/funnel.js +5 -1
- package/dist/react/gantt.js +4 -1
- package/dist/react/grid.js +5 -1
- package/dist/react/heatmap.js +5 -1
- package/dist/react/histogram.js +7 -1
- package/dist/react/index.js +95 -90
- package/dist/react/kpi.js +3 -1
- package/dist/react/likert.js +8 -1
- package/dist/react/line.js +5 -1
- package/dist/react/mekko.js +6 -1
- package/dist/react/pareto.js +4 -1
- package/dist/react/pie.js +6 -1
- package/dist/react/prepare.js +34 -28
- package/dist/react/pvm.js +5 -1
- package/dist/react/pyramid.js +6 -1
- package/dist/react/sankey.js +5 -1
- package/dist/react/scatter.js +5 -1
- package/dist/react/slope.js +7 -1
- package/dist/react/sparkline.js +5 -1
- package/dist/react/spec.js +25 -31
- package/dist/react/status.js +4 -1
- package/dist/react/story.js +7 -4
- package/dist/react/table.js +5 -1
- package/dist/react/theme.js +7 -3
- package/dist/react/tilemap.js +5 -1
- package/dist/react/treemap.js +4 -1
- package/dist/react/variance.js +6 -1
- package/dist/react/waffle.js +4 -1
- package/dist/react/waterfall.js +5 -1
- package/dist/{resvg-ZOVDIZTV.js → resvg-VB7S5HRF.js} +1 -1
- package/dist/rows.js +2 -3
- package/dist/{rowsModule-YVLAROIP.js → rowsModule-JTDPTWXG.js} +3 -1
- package/dist/{schema-BNRNHGHQ.js → schema-2M3LXR35.js} +3 -1
- package/dist/{schema-5HA5DSYN.js → schema-2Q7IJ22V.js} +3 -1
- package/dist/{schema-FA6XIHTW.js → schema-3OLBUVMZ.js} +3 -1
- package/dist/{schema-F3WYTR65.js → schema-3XLO43SX.js} +3 -1
- package/dist/{schema-RTWES6NR.js → schema-5753NOAL.js} +3 -1
- package/dist/{schema-S3TCLTYD.js → schema-5KHDHTIX.js} +3 -1
- package/dist/{schema-WOSEZNKG.js → schema-76XRTBCJ.js} +3 -1
- package/dist/{schema-MPXZNWV3.js → schema-7CPGNCOL.js} +3 -1
- package/dist/{schema-2KIHLTYI.js → schema-BKHQ3ZUH.js} +3 -1
- package/dist/{schema-JB2H6KPA.js → schema-BMD5JR3Y.js} +3 -1
- package/dist/{schema-5BKQV56C.js → schema-BOGTPL7F.js} +3 -1
- package/dist/{schema-ORTRMYI6.js → schema-BUTNGYTT.js} +3 -1
- package/dist/{schema-SWWMOLOR.js → schema-C7NVOQNV.js} +6 -3
- package/dist/{schema-O4YNAGIY.js → schema-FNTAAXQ3.js} +3 -1
- package/dist/{schema-7TLSFG6M.js → schema-FYULDJFB.js} +3 -1
- package/dist/{schema-NHNQK6XO.js → schema-FZKNIAIH.js} +3 -1
- package/dist/{schema-B7CZPPB4.js → schema-G2PLJCYL.js} +3 -1
- package/dist/{schema-ZUUUY3QS.js → schema-GGG2VOY7.js} +3 -2
- package/dist/{schema-6RYJS2GM.js → schema-GLN7IHSH.js} +3 -1
- package/dist/{schema-OJCML6LV.js → schema-HIDW4BA4.js} +3 -1
- package/dist/{schema-S36SRYGO.js → schema-J53LCIY3.js} +3 -1
- package/dist/{schema-2K6C3U24.js → schema-KIJA53MB.js} +4 -1
- package/dist/{schema-O7AKK232.js → schema-LEQNLBNG.js} +2 -1
- package/dist/{schema-AMFRKUFS.js → schema-LHMEXFLY.js} +3 -1
- package/dist/{schema-65FOKNHK.js → schema-MT6NA5AL.js} +3 -3
- package/dist/{schema-4S5CXHAO.js → schema-MUTAVQMI.js} +3 -1
- package/dist/{schema-Y6KBWUUR.js → schema-NVMEOHAW.js} +3 -1
- package/dist/{schema-6OHZWHUI.js → schema-TA3MSAPQ.js} +3 -1
- package/dist/{schema-YQYTLKSW.js → schema-U26KG42U.js} +3 -1
- package/dist/{schema-E4MRCGPZ.js → schema-UHHFTVGS.js} +3 -1
- package/dist/{schema-4HY2MWZC.js → schema-V3BPW4LA.js} +3 -1
- package/dist/{schema-PJ6P52BC.js → schema-WIZ2TZAT.js} +3 -1
- package/dist/{schema-NN6UPDPW.js → schema-WZLWHOMY.js} +3 -1
- package/dist/{schema-6W4M3WJ4.js → schema-XATDKZPW.js} +3 -1
- package/dist/{schema-5NKJPSBD.js → schema-XHKSGMUH.js} +3 -1
- package/dist/{schema-GZNOW4LX.js → schema-XKY2EQFH.js} +3 -1
- package/dist/{schema-HEIDGCSL.js → schema-ZE7WUNFS.js} +3 -1
- package/dist/{specValidation-VNWIKLHH.js → specValidation-X5XJBPTP.js} +4 -1
- package/dist/theme.js +5 -2
- package/dist/{themeShapeRules-2D3KWSPQ.js → themeShapeRules-PW4BQHKL.js} +1 -1
- package/dist/types/core/a11y/recordsShared.d.ts +4 -0
- package/dist/types/core/annotate.d.ts +39 -0
- package/dist/types/core/annotateArms.d.ts +1 -1
- package/dist/types/core/annotateEngine.d.ts +14 -0
- package/dist/types/core/axis.d.ts +2 -0
- package/dist/types/core/calendarLabels.d.ts +15 -0
- package/dist/types/core/charts/band/stacks.d.ts +71 -2
- package/dist/types/core/charts/bartable/types.d.ts +10 -0
- package/dist/types/core/charts/choropleth/index.d.ts +7 -0
- package/dist/types/core/charts/choropleth/layout.d.ts +7 -0
- package/dist/types/core/charts/choropleth/schema.d.ts +36 -0
- package/dist/types/core/charts/cohort/types.d.ts +8 -1
- package/dist/types/core/charts/column/layout.d.ts +1 -1
- package/dist/types/core/charts/column/model.d.ts +4 -0
- package/dist/types/core/charts/combo/endpoints.d.ts +1 -1
- package/dist/types/core/charts/creative/types.d.ts +1 -1
- package/dist/types/core/charts/dimswitch/compile.d.ts +2 -0
- package/dist/types/core/charts/dimswitch/types.d.ts +8 -0
- package/dist/types/core/charts/grid/normalize.d.ts +18 -1
- package/dist/types/core/charts/heatmap/fixtures.d.ts +2 -2
- package/dist/types/core/charts/histogram/types.d.ts +14 -2
- package/dist/types/core/charts/likert/layout.d.ts +14 -9
- package/dist/types/core/charts/logAxis.d.ts +55 -0
- package/dist/types/core/charts/pvm/types.d.ts +6 -0
- package/dist/types/core/charts/pyramid/types.d.ts +7 -4
- package/dist/types/core/charts/sankey/types.d.ts +3 -1
- package/dist/types/core/charts/scatter/clamp.d.ts +155 -0
- package/dist/types/core/charts/scatter/frontier.d.ts +21 -0
- package/dist/types/core/charts/scatter/index.d.ts +9 -0
- package/dist/types/core/charts/scatter/layout.d.ts +26 -0
- package/dist/types/core/charts/scatter/logAxis.d.ts +14 -0
- package/dist/types/core/charts/scatter/model.d.ts +258 -0
- package/dist/types/core/charts/scatter/schema.d.ts +57 -0
- package/dist/types/core/charts/scatter/trend.d.ts +54 -0
- package/dist/types/core/charts/scatter/valueLines.d.ts +47 -0
- package/dist/types/core/charts/sparkline/fixtures.d.ts +1 -1
- package/dist/types/core/charts/status/layout.d.ts +5 -3
- package/dist/types/core/charts/table/resolve.d.ts +0 -7
- package/dist/types/core/charts/tilemap/index.d.ts +6 -0
- package/dist/types/core/charts/tilemap/layout.d.ts +5 -0
- package/dist/types/core/charts/tilemap/schema.d.ts +4 -0
- package/dist/types/core/charts/treemap/types.d.ts +2 -2
- package/dist/types/core/charts/variance/fixtures.d.ts +2 -1
- package/dist/types/core/charts/waffle/types.d.ts +2 -0
- package/dist/types/core/dateFormat.d.ts +1 -1
- package/dist/types/core/deferred.d.ts +6 -1
- package/dist/types/core/doc/diagnostics.d.ts +8 -0
- package/dist/types/core/doc/document.d.ts +9 -1
- package/dist/types/core/doc/ownedDocumentCopy.d.ts +2 -1
- package/dist/types/core/fontMetrics/index.d.ts +1 -1
- package/dist/types/core/footer.d.ts +9 -1
- package/dist/types/core/format.d.ts +4 -1
- package/dist/types/core/formatSpec.d.ts +84 -6
- package/dist/types/core/frame.d.ts +41 -8
- package/dist/types/core/geo/packs/registry.d.ts +3 -2
- package/dist/types/core/geometry.d.ts +19 -0
- package/dist/types/core/icons.d.ts +11 -0
- package/dist/types/core/inputError.d.ts +3 -0
- package/dist/types/core/isoDate.d.ts +2 -0
- package/dist/types/core/label/categoryRow.d.ts +8 -0
- package/dist/types/core/label/occupied.d.ts +5 -0
- package/dist/types/core/label/solver.d.ts +31 -2
- package/dist/types/core/notes.d.ts +13 -1
- package/dist/types/core/ols.d.ts +38 -0
- package/dist/types/core/periodYears.d.ts +5 -1
- package/dist/types/core/registry.d.ts +12 -0
- package/dist/types/core/request.d.ts +3 -2
- package/dist/types/core/scale.d.ts +7 -0
- package/dist/types/core/schema/capability.d.ts +17 -20
- package/dist/types/core/schema/namedColumns.d.ts +6 -0
- package/dist/types/core/schema/refusals.d.ts +1 -4
- package/dist/types/core/shareRounding.d.ts +8 -0
- package/dist/types/core/sizing.d.ts +17 -12
- package/dist/types/core/story.d.ts +3 -0
- package/dist/types/core/target.d.ts +6 -0
- package/dist/types/core/text.d.ts +8 -0
- package/dist/types/core/theme.d.ts +55 -2
- package/dist/types/core/themeShape.d.ts +3 -3
- package/dist/types/core/themeValidate.d.ts +3 -3
- package/dist/types/core/types/annotations.d.ts +15 -3
- package/dist/types/core/types/data.d.ts +4 -1
- package/dist/types/core/types/diagram.d.ts +81 -2
- package/dist/types/core/types/optionInput.d.ts +13 -0
- package/dist/types/core/types/options.d.ts +65 -24
- package/dist/types/core/types/scene.d.ts +79 -2
- package/dist/types/core/types/table.d.ts +9 -0
- package/dist/types/core/types/theme.d.ts +50 -4
- package/dist/types/index.d.ts +28 -27
- package/dist/types/optionTypes.d.ts +44 -0
- package/dist/types/react/DimSwitchChart.d.ts +2 -1
- package/dist/types/react/RefusalBoundary.d.ts +25 -0
- package/dist/types/react/SceneRenderer.d.ts +3 -1
- package/dist/types/react/SizePlaceholder.d.ts +2 -1
- package/dist/types/react/TableChart.d.ts +8 -4
- package/dist/types/react/barrelCharts.d.ts +1521 -1012
- package/dist/types/react/charts/bar.d.ts +36 -25
- package/dist/types/react/charts/bartable.d.ts +36 -25
- package/dist/types/react/charts/box.d.ts +36 -25
- package/dist/types/react/charts/bullet.d.ts +36 -25
- package/dist/types/react/charts/butterfly.d.ts +36 -25
- package/dist/types/react/charts/choropleth.d.ts +36 -25
- package/dist/types/react/charts/cohort.d.ts +76 -50
- package/dist/types/react/charts/column.d.ts +36 -25
- package/dist/types/react/charts/combo.d.ts +2 -1
- package/dist/types/react/charts/creative.d.ts +31 -25
- package/dist/types/react/charts/diagram.d.ts +302 -160
- package/dist/types/react/charts/dot.d.ts +36 -25
- package/dist/types/react/charts/funnel.d.ts +36 -25
- package/dist/types/react/charts/gantt.d.ts +36 -25
- package/dist/types/react/charts/grid.d.ts +38 -27
- package/dist/types/react/charts/heatmap.d.ts +36 -25
- package/dist/types/react/charts/histogram.d.ts +36 -25
- package/dist/types/react/charts/kpi.d.ts +36 -25
- package/dist/types/react/charts/likert.d.ts +36 -25
- package/dist/types/react/charts/line.d.ts +36 -25
- package/dist/types/react/charts/mekko.d.ts +36 -25
- package/dist/types/react/charts/pareto.d.ts +33 -25
- package/dist/types/react/charts/pie.d.ts +36 -25
- package/dist/types/react/charts/pvm.d.ts +36 -25
- package/dist/types/react/charts/pyramid.d.ts +33 -25
- package/dist/types/react/charts/sankey.d.ts +36 -25
- package/dist/types/react/charts/scatter.d.ts +36 -25
- package/dist/types/react/charts/slope.d.ts +36 -25
- package/dist/types/react/charts/sparkline.d.ts +36 -25
- package/dist/types/react/charts/status.d.ts +36 -25
- package/dist/types/react/charts/tilemap.d.ts +36 -25
- package/dist/types/react/charts/treemap.d.ts +36 -25
- package/dist/types/react/charts/variance.d.ts +36 -25
- package/dist/types/react/charts/waffle.d.ts +36 -25
- package/dist/types/react/charts/waterfall.d.ts +36 -25
- package/dist/types/react/createChartComponent.d.ts +11 -9
- package/dist/types/react/footerFrame.d.ts +1 -1
- package/dist/types/react/hover/engine.d.ts +2 -1
- package/dist/types/react/hover/labelCard.d.ts +14 -2
- package/dist/types/react/prepare.d.ts +2 -2
- package/dist/types/react/prepared.d.ts +5 -1
- package/dist/types/react/rowsStore.d.ts +5 -0
- package/dist/types/react/useContainerSize.d.ts +2 -0
- package/dist/types/rows.d.ts +1 -1
- package/dist/validate.js +13 -8
- package/docs/manual.md +143 -37
- package/docs/reference/bar.md +10 -7
- package/docs/reference/bartable.md +7 -3
- package/docs/reference/box.md +5 -2
- package/docs/reference/bullet.md +7 -5
- package/docs/reference/butterfly.md +12 -5
- package/docs/reference/choropleth.md +9 -7
- package/docs/reference/cohort.md +3 -2
- package/docs/reference/column.md +14 -7
- package/docs/reference/combo.md +8 -6
- package/docs/reference/creative.md +1 -1
- package/docs/reference/diagram.md +94 -18
- package/docs/reference/dimswitch.md +16 -13
- package/docs/reference/dot.md +7 -4
- package/docs/reference/fixtures.md +49 -5
- package/docs/reference/funnel.md +4 -3
- package/docs/reference/gantt.md +1 -1
- package/docs/reference/grid.md +1 -1
- package/docs/reference/heatmap.md +6 -4
- package/docs/reference/histogram.md +7 -4
- package/docs/reference/kpi.md +11 -8
- package/docs/reference/likert.md +7 -3
- package/docs/reference/line.md +9 -8
- package/docs/reference/mekko.md +4 -4
- package/docs/reference/options.md +34 -32
- package/docs/reference/pareto.md +4 -4
- package/docs/reference/pie.md +8 -7
- package/docs/reference/pvm.md +4 -2
- package/docs/reference/pyramid.md +4 -4
- package/docs/reference/react.md +20 -11
- package/docs/reference/sankey.md +5 -3
- package/docs/reference/scatter.md +3 -3
- package/docs/reference/slope.md +7 -6
- package/docs/reference/sparkline.md +6 -5
- package/docs/reference/status.md +6 -4
- package/docs/reference/table.md +28 -26
- package/docs/reference/theme.md +94 -87
- package/docs/reference/tilemap.md +7 -6
- package/docs/reference/treemap.md +6 -5
- package/docs/reference/variance.md +8 -5
- package/docs/reference/waffle.md +2 -1
- package/docs/reference/waterfall.md +12 -9
- package/docs/use-cases.md +221 -0
- package/llms.txt +2 -1
- package/package.json +2 -1
- package/dist/chunk-2FNNAPCI.js +0 -24
- package/dist/chunk-2RSG7JYI.js +0 -24
- package/dist/chunk-3JEQGGVD.js +0 -19
- package/dist/chunk-3XHJHQWU.js +0 -42
- package/dist/chunk-4JLBVIGW.js +0 -24
- package/dist/chunk-6KWIQ5KF.js +0 -18
- package/dist/chunk-7X65ZQN4.js +0 -38
- package/dist/chunk-BBRBCMNR.js +0 -28
- package/dist/chunk-BMRD6MAH.js +0 -24
- package/dist/chunk-BW5VLBSZ.js +0 -15
- package/dist/chunk-CJGSJKPO.js +0 -25
- package/dist/chunk-CN7JRHST.js +0 -25
- package/dist/chunk-DJHIQWSG.js +0 -25
- package/dist/chunk-E4IQ6M4S.js +0 -24
- package/dist/chunk-EFUWFB64.js +0 -24
- package/dist/chunk-FIANWJXX.js +0 -19
- package/dist/chunk-GZTNTHSW.js +0 -21
- package/dist/chunk-H5G7T35P.js +0 -24
- package/dist/chunk-HKYTOJLV.js +0 -33
- package/dist/chunk-HYY5V2KL.js +0 -19
- package/dist/chunk-I6VAWNNU.js +0 -24
- package/dist/chunk-IK4BHOPZ.js +0 -33
- package/dist/chunk-ILSXT6KT.js +0 -24
- package/dist/chunk-JR7Y5ONB.js +0 -27
- package/dist/chunk-K3HSQPSM.js +0 -24
- package/dist/chunk-KDMKHR5A.js +0 -32
- package/dist/chunk-KOJ5QETJ.js +0 -8
- package/dist/chunk-L3JWM7FR.js +0 -50
- package/dist/chunk-L4S6UFTL.js +0 -26
- package/dist/chunk-LFTAMH7I.js +0 -24
- package/dist/chunk-MIAPBQCA.js +0 -24
- package/dist/chunk-NCB3YLHF.js +0 -28
- package/dist/chunk-ONZLC47B.js +0 -88
- package/dist/chunk-OUEGGWH7.js +0 -24
- package/dist/chunk-P25VEGGX.js +0 -24
- package/dist/chunk-P26Z62UV.js +0 -24
- package/dist/chunk-PFVTYFSL.js +0 -24
- package/dist/chunk-QGCEHR6S.js +0 -13
- package/dist/chunk-QOIVXZUF.js +0 -24
- package/dist/chunk-RA66JA3D.js +0 -24
- package/dist/chunk-SMCDXUIO.js +0 -24
- package/dist/chunk-T3IGJARD.js +0 -22
- package/dist/chunk-TKOJZQAJ.js +0 -24
- package/dist/chunk-UBZXQIDR.js +0 -24
- package/dist/chunk-VERLFNWR.js +0 -25
- package/dist/chunk-VH2UUU7K.js +0 -24
- package/dist/chunk-Z6CL7AR6.js +0 -24
- package/dist/chunk-ZU425HNM.js +0 -24
- package/dist/chunk-ZZU5R5UU.js +0 -24
- /package/dist/{DiagnosticDetails-UNYNYCAH.js → DiagnosticDetails-JFBBXOT2.js} +0 -0
package/docs/reference/bar.md
CHANGED
|
@@ -85,8 +85,8 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
85
85
|
| series[].valueKind | string | | Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units. One of `'fraction'`. |
|
|
86
86
|
| series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
|
|
87
87
|
| series[].label | string | | Displayed series name; defaults to the series id. |
|
|
88
|
-
| series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
|
|
89
|
-
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). Controls scenario labels and paint conventions. |
|
|
88
|
+
| series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. In a football field, null cells and cells without a range are left out with a warning and a note, provided at least one method has a range. |
|
|
89
|
+
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
|
|
90
90
|
| series[].direction | string | | Whether increases are favorable; defaults to higherIsBetter for directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
|
|
91
91
|
| series[].role | string | | Data series or comparison-only reference series; references are excluded from the main plotted data. One of `'data'`, `'reference'`. |
|
|
92
92
|
| series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
|
|
@@ -99,12 +99,12 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
99
99
|
| Path | Type | Values | Default | Meaning |
|
|
100
100
|
|---|---|---|---|---|
|
|
101
101
|
| labelDensity | string | `'full'`, `'smart'`, `'minimal'` | | Value-label density. Default 'smart': every value stays eligible. A chart with more than 12 categories, or with most labels wider than the band, ranks the first, last, highest and lowest value (ties: the first) first. The other values then use only their natural seat beside the mark; with none free they are drawn nowhere and left out of the note. Those four may take one step, and the note names any that finds no seat. A smaller chart keeps every value on the bounded one-step rule and names any that finds no seat. 'full' treats all values alike and names every one that finds no seat. 'minimal' also applies the shared priority gate. Seats stay inside the plot band and one step from the natural seat. All values remain in reading records. When valueLabels is set, it wins: labelDensity is not read for the value labels. |
|
|
102
|
-
| legend | string \| object | `'top'`, `'bottom'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key by default unless visible direct labels name them all. 'none' hides the key and warns if names are missing. Subtitle and footnote mentions do not replace the key. |
|
|
102
|
+
| legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key by default unless visible direct labels name them all. 'none' hides the key and warns if names are missing. Subtitle and footnote mentions do not replace the key. |
|
|
103
103
|
| valueAxis.break | false \| object | `false` (or another value of its type) | | No break by default or with false. Set { from, to, style? } for a straight value-axis break; the omitted span collapses to a fixed 12px gap when valid. Automatic placement is supported only by waterfall and pvm. |
|
|
104
104
|
| axisTitles | object | | | Title of the value axis when valueAxis.show draws it: in the tick-label row, ending at the right end of the axis past the last tick label or short of the first tick label, and in a row of its own under the ticks only when neither side has room. A theme with valueAxis.titles derives 'Measure, unit' from subtitle.measure and a unit the drawn subtitle does not print, when none is authored. |
|
|
105
105
|
| axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
|
|
106
|
-
| valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Which values print, with line's choices: 'none', 'last', 'ends' (first and last), 'extremes' (first, last, highest and lowest; a tie takes the first) or 'all', chosen per series over the categories in their drawn order. Unset (default): every value is eligible and labelDensity decides. When set, valueLabels wins over labelDensity: each chosen value takes the one-step rule of 'full', and one with no seat is named in the note. A value not chosen is unlabelled by choice: the note does not name it, and the value axis is drawn so it stays readable (all modes but 'all'; valueAxis.show false turns it off). Authored cell labels print in every mode. Grouped only: a stack has no single value per category, so stacked, stacked100, football-field and tornado
|
|
107
|
-
| variant | string | `'grouped'`, `'stacked'`, `'stacked100'`, `'football-field'`, `'tornado'` | `'grouped'` | Horizontal arrangement; grouped by default. Stacked100 normalizes category totals; football-field shows ranges and tornado compares low/high driver cases. |
|
|
106
|
+
| valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Which values print, with line's choices: 'none', 'last', 'ends' (first and last), 'extremes' (first, last, highest and lowest; a tie takes the first) or 'all', chosen per series over the categories in their drawn order. Unset (default): every value is eligible and labelDensity decides. When set, valueLabels wins over labelDensity: each chosen value takes the one-step rule of 'full', and one with no seat is named in the note. A value not chosen is unlabelled by choice: the note does not name it, and the value axis is drawn so it stays readable (all modes but 'all'; valueAxis.show false turns it off). Authored cell labels print in every mode. Grouped only: a stack has no single value per category, so stacked, stacked100, football-field and tornado ignore every mode but 'all' with an option-ignored warning and keep their normal labels and value axis. Example: a ranking of 12 bars with 'extremes' prints the top, bottom, highest and lowest value. |
|
|
107
|
+
| variant | string | `'grouped'`, `'stacked'`, `'stacked100'`, `'football-field'`, `'tornado'` | `'grouped'` | Horizontal arrangement; grouped by default. Stacked100 normalizes category totals; football-field shows ranges and tornado compares low/high driver cases. A football-field method without a range is left out with football-field-method-without-range and a note. At least one method must have a range; otherwise the chart refuses with football-field-range-required. |
|
|
108
108
|
| sharesOfOneWhole | boolean | | | true declares every stacked series a share of the same whole, such as channel shares of all orders: the stack then has a total, and percent series warn non-additive-stack only where a category adds to more than 100. Stacked and stacked100 only; refused on other variants. |
|
|
109
109
|
| baseValue | number \| object | | | Tornado base-case output metric; the vertical spine every swing is measured against. Required for variant 'tornado'. |
|
|
110
110
|
| baseValue.value | number | | | Base-case output value used as the tornado comparison spine. |
|
|
@@ -127,11 +127,12 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
127
127
|
| netLine.connectors | boolean | | | Must remain false for bars because structural category axes carry no sequence. |
|
|
128
128
|
| averageMarker | boolean \| object | | | Computed dashed average rule with a solver-placed Ø label. |
|
|
129
129
|
| averageMarker.scope | string \| array | `'all'` (or another value of its type) | | Series included in the computed average; defaults to 'all'. |
|
|
130
|
+
| averageMarker.includePartial | boolean | | | true averages the categories marked partial too. By default they are left out, and the label names the periods the average covers. Column, bar and combo. |
|
|
130
131
|
| connectors | boolean \| object | | | Connect matching series boundaries between adjacent stacked bars. |
|
|
131
132
|
| connectors.style | string | `'line'`, `'dashed'` | | Connector stroke: solid 'line' (default) or 'dashed', matching the waterfall bridge's dash. |
|
|
132
133
|
| connectors.scope | string \| array | `'all'` (or another value of its type) | | Series boundaries to connect; defaults to 'all'. |
|
|
133
134
|
|
|
134
|
-
Plus the [shared options](options.md). This type does not accept `
|
|
135
|
+
Plus the [shared options](options.md). This type does not accept `valueAxis.log`, `valueAxis.reverse`, `ribbons`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis` with an `option-ignored` warning.
|
|
135
136
|
|
|
136
137
|
## Annotations
|
|
137
138
|
|
|
@@ -147,7 +148,7 @@ An annotation anchor is a category or item id string, or an object with category
|
|
|
147
148
|
| abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | Drawn reference series accept anchors. |
|
|
148
149
|
| diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. Drawn reference series accept anchors. |
|
|
149
150
|
| band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
|
|
150
|
-
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. |
|
|
151
|
+
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. |
|
|
151
152
|
|
|
152
153
|
## Dense value labels
|
|
153
154
|
|
|
@@ -186,6 +187,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
186
187
|
| tornado-degenerate | torture | Torture: 14 drivers, a base the model does not reproduce, a dead driver and a gap |
|
|
187
188
|
| tornado-two-drivers | example | Sensitivity tornado: the two-driver case, direct labels only |
|
|
188
189
|
| tornado-theme-cases | example | Sensitivity cases using an authored theme pair |
|
|
190
|
+
| tick-step | example | Horizontal value axis with ticks every five units |
|
|
189
191
|
| usd-k-precision | example | Unit-aware precision: $k values from 100 up print whole, smaller values keep one decimal |
|
|
190
192
|
| option-reference-line | example | Actual orders against plan with line references |
|
|
191
193
|
| option-reference-marker | example | Actual orders against plan with marker references |
|
|
@@ -220,3 +222,4 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
220
222
|
| option-small-values-zero | torture | Turku prints the series format (smallValues zero) |
|
|
221
223
|
| option-small-values-scientific | torture | Turku prints a power of ten (smallValues scientific) |
|
|
222
224
|
| option-small-values-p-value | torture | Every rate prints as an APA p-value (smallValues p-value) |
|
|
225
|
+
| key-left | example | Stacked bars with the key in a column left of the plot |
|
|
@@ -76,7 +76,7 @@ Table rows with number columns and stacked bars. One panel when the rows compare
|
|
|
76
76
|
| columns[].values | array | yes | One number per row, in row order; null prints the missing glyph, { state } n/a or n.m. |
|
|
77
77
|
| columns[].values[].state | string | yes | 'na' prints n/a, 'nm' prints n.m. One of `'na'`, `'nm'`. |
|
|
78
78
|
| columns[].format | string | | Format by example, such as 1,234 or 12.5%. |
|
|
79
|
-
| columns[].aggregate | string | | What the Total row prints: 'sum' (default) adds the column, 'none' leaves the cell empty for numbers that do not add up, such as averages or rates. One of `'sum'`, `'none'`. |
|
|
79
|
+
| columns[].aggregate | string | | What the Total row prints: 'sum' (default) adds the column, 'none' leaves the cell empty for numbers that do not add up, such as averages or rates. The default is 'none' where the column format is a percentage, percentage points or a multiple; an explicit 'sum' there warns aggregate-non-additive. One of `'sum'`, `'none'`. |
|
|
80
80
|
| panels | array | yes | One stacked-bar panel per measure, each with its own unit and scale. Use one panel when the rows compare one measure: EBITDA impact in $bn, split into Run and Grow. Use several when the same split reads in different units side by side: the impact in $bn and the same impact as % of EBITDA. Bars in different panels compare by length only under sharedScale true. Under variant 'cascade' the panels are periods of one total. |
|
|
81
81
|
| panels[].id | string | yes | Panel identity; distinct from every column id. |
|
|
82
82
|
| panels[].label | string | | The measure, printed in the head as "label, unit". |
|
|
@@ -88,7 +88,7 @@ Table rows with number columns and stacked bars. One panel when the rows compare
|
|
|
88
88
|
| panels[].ends[].low | number | yes | Lower end of the row total, where the segments end; zero or more. |
|
|
89
89
|
| panels[].ends[].high | number | yes | Upper end of the row total, where the light extension ends; at least low. |
|
|
90
90
|
| panels[].format | string | | Format by example for the end labels and the total; falls back to options.format. |
|
|
91
|
-
| panels[].aggregate | string | | What the Total row prints for this panel: 'sum' (default) adds the rows, or their ranges when a row has one; 'none' leaves it empty. Use 'none' for shares, rates or averages, such as a % of each row's own base, whose sum means nothing. One of `'sum'`, `'none'`. |
|
|
91
|
+
| panels[].aggregate | string | | What the Total row prints for this panel: 'sum' (default) adds the rows, or their ranges when a row has one; 'none' leaves it empty. The default is 'none' where the panel format (or options.format) is a percentage, percentage points or a multiple, or the unit is '%', except under variant 'cascade'; an explicit 'sum' there warns aggregate-non-additive. Use 'none' for shares, rates or averages, such as a % of each row's own base, whose sum means nothing. One of `'sum'`, `'none'`. |
|
|
92
92
|
| rowGroups | object | | Colour bars by a row attribute, keyed under a title. Needs one segment. |
|
|
93
93
|
| rowGroups.title | string | | Key title with the unit ("Margin of market, %"). |
|
|
94
94
|
| rowGroups.groups | array | yes | In key order. |
|
|
@@ -105,16 +105,19 @@ Table rows with number columns and stacked bars. One panel when the rows compare
|
|
|
105
105
|
| combinedShare | object | | | A note with the combined share of these rows in each summed panel: their sum over the panel's, at the low and the high end where rows carry ranges ('Core segments: 120 of 300 $bn at the low end, 40%; 210 of 500 at the high end, 42%'). A row id that names no row is refused. |
|
|
106
106
|
| combinedShare.rows | array | | | Row ids whose combined share prints; at least two, each once. |
|
|
107
107
|
| combinedShare.label | string | | | What the rows are called together in the note; default their labels joined with 'and'. |
|
|
108
|
+
| segmentValues | boolean | | | Default true: variant 'panels' prints each part's value inside its segment, in the ink that reads on the fill, where the text and 3 px of padding on each side fit. A panel whose format has more than one decimal prints end labels only, and so does a row with a range. false prints end labels only everywhere. Rounded parts can miss the printed row sum by one step; the notes list says so. Refused with variant 'cascade'. |
|
|
108
109
|
| variant | string | `'panels'`, `'cascade'` | | 'panels' (default): one stacked-bar panel per measure. 'cascade': share cascade, each panel splits its total; a row starts where the row above ended, on a light track over the total. The Total row is a dark bar. combinedShare draws a bracket over its rows, which must follow one another. Needs one segment, no ends, no nulls. |
|
|
109
110
|
| cascade | object | | | Settings of variant 'cascade'; refused with variant 'panels'. |
|
|
111
|
+
| cascade.totalApart | boolean | | | Row groups only. true (default): the Total bar deepens away from the group colours and the rest grey where the theme total colour reads as one of them. false: the Total bar keeps the theme total colour (color.total) as it is. |
|
|
110
112
|
| cascade.share | boolean | | | Computed share column beside each panel; default true. rounding defaults to 'sum-consistent' here, so each adds up to 100%. |
|
|
111
113
|
| cascade.growth | object | | | Growth column after the last panel. |
|
|
112
114
|
| cascade.growth.measure | string | `'cagr'`, `'share-change'` | | 'cagr': each row's CAGR, first panel to last, in %. 'share-change': last share minus first, in pp. |
|
|
113
115
|
| cascade.growth.years | number | | | Years from first to last panel for 'cagr'; default read from the panel labels (2019, FY24). |
|
|
114
116
|
| cascade.growth.label | string | | | Column head; default from the panel labels. |
|
|
115
117
|
| sharedScale | boolean | | | false: each panel its own scale. true: one scale, panel width follows its longest bar; weights refused. Default false, true under cascade. |
|
|
118
|
+
| heightFill | string | `'rows'`, `'none'` | `'rows'` | Spare canvas height. 'rows' (default): a pinned canvas stretches the rows up to 1.25 times their pitch and thickens the bars. 'none': natural pitch. |
|
|
116
119
|
|
|
117
|
-
Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `
|
|
120
|
+
Plus the [shared options](options.md). This type does not accept `detailFields`, `labels`, `valueAxis`, `hatchStrength`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
|
|
118
121
|
|
|
119
122
|
## Annotations
|
|
120
123
|
|
|
@@ -136,6 +139,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
136
139
|
| one-series-missing-and-states | torture | One segment with a missing value, a not-applicable cell and a not-meaningful cell, in a bar panel and a number column: each prints its own glyph |
|
|
137
140
|
| impact-two-panels-named-share | example | Two panels, one split: the impact in $bn and as a share of EBITDA, with the combined-share note naming the two rows the two largest sectors |
|
|
138
141
|
| cascade-two-periods | example | Share cascade over two periods: rows coloured by a row group, two residual rows pinned last, share columns, a bracket and a CAGR column |
|
|
142
|
+
| cascade-two-periods-theme-total | example | Share cascade over two periods with the Total bar in the theme total colour, even where it equals a group colour |
|
|
139
143
|
| cascade-four-years | example | Share cascade over four years: product-category revenue share with the share change in pp |
|
|
140
144
|
|
|
141
145
|
## Not for
|
package/docs/reference/box.md
CHANGED
|
@@ -47,6 +47,7 @@ One form; its chart ID is `box`.
|
|
|
47
47
|
|
|
48
48
|
| Path | Type | Values | Default | Meaning |
|
|
49
49
|
|---|---|---|---|---|
|
|
50
|
+
| valueAxis.break | false \| object | `false` (or another value of its type) | | No break by default or with false. Set { from, to, style? } for a straight value-axis break; the omitted span collapses to a fixed 12px gap when valid. Automatic placement is supported only by waterfall and pvm. |
|
|
50
51
|
| axisTitles | object | | | Title of the value axis when it is drawn: under the tick row, ending at the right end of the axis. Drawn only when authored. |
|
|
51
52
|
| axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
|
|
52
53
|
| whiskers | string | `'tukey'`, `'minmax'`, `'p10p90'` | `'tukey'` | Whisker rule. 'tukey' (default): most extreme observations within 1.5xIQR of the quartiles. 'minmax': whiskers reach every observation. 'p10p90': whiskers at the 10th/90th type-7 percentile. |
|
|
@@ -55,7 +56,7 @@ One form; its chart ID is `box`.
|
|
|
55
56
|
| methodNote | boolean | | `false` | Default false. true adds the footnote stating the quartile definition and the Tukey whisker rule. A 'minmax' or 'p10p90' whisker rule changes what whiskers and dots mean, so its note prints regardless, as do the small-n dot note and the note on withheld observations. |
|
|
56
57
|
| boxValues | string | `'median'`, `'all'` | `'median'` | Default 'median': each box prints its median. 'all' also prints Q1 and Q3 under the box edges and the whisker ends under the caps, so a quartile or percentile reads as a number. |
|
|
57
58
|
|
|
58
|
-
Plus the [shared options](options.md). This type does not accept `detailFields`, `
|
|
59
|
+
Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.log`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `topN`, `bandFraction`, `legend` with an `option-ignored` warning.
|
|
59
60
|
|
|
60
61
|
## Annotations
|
|
61
62
|
|
|
@@ -63,7 +64,7 @@ An annotation anchor is a category or item id string, or an object with category
|
|
|
63
64
|
|
|
64
65
|
| Kind | Purpose | Required | Anchors | Optional fields | Notes |
|
|
65
66
|
|---|---|---|---|---|---|
|
|
66
|
-
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
|
|
67
|
+
| 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. |
|
|
67
68
|
| 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. |
|
|
68
69
|
| 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 | | |
|
|
69
70
|
|
|
@@ -87,6 +88,8 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
87
88
|
| torture-long-labels | torture | Torture: long names at a generous size read whole, never cut |
|
|
88
89
|
| outliers-withheld-method-note | example | Outliers withheld from the ink and the axis, with the quartile and whisker rule stated |
|
|
89
90
|
| salary-bands-pinned-median | example | The IC5 median label pinned above its box through labelPlacements |
|
|
91
|
+
| twelve-teams-median-column | example | Twelve dense rows print their medians in one column beside n |
|
|
92
|
+
| outliers-axis-break | example | A value-axis break across the empty range keeps two far outliers visible |
|
|
90
93
|
|
|
91
94
|
## Not for
|
|
92
95
|
|
package/docs/reference/bullet.md
CHANGED
|
@@ -43,7 +43,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
43
43
|
| rows[].value | cell | yes | Actual measure drawn as the row bar. |
|
|
44
44
|
| rows[].target | cell | | Reference measure drawn as the target tick and used for target deltas. It uses the row value's format or options.format; a different target.format warns because it is ignored. options.strings.target renames the comparison mark in labels (e.g. 'peer median'). |
|
|
45
45
|
| rows[].bands | array | | Ordered qualitative band thresholds, as numbers or labeled threshold objects. |
|
|
46
|
-
| rows[].bands[].tone | string | | Semantic band tone. Toned bands define a two-sided corridor and set the delta tone for values inside them. One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
|
|
46
|
+
| rows[].bands[].tone | string | | Semantic band tone. Toned bands define a two-sided corridor and set the delta tone for values inside them. A toned band paints its tone's fill washed toward the page (theme marks.bulletBandFill). One of `'good'`, `'warn'`, `'bad'`, `'neutral'`. |
|
|
47
47
|
| rows[].bands[].to | number | yes | Upper endpoint of this qualitative band in the row value units. |
|
|
48
48
|
| rows[].bands[].label | string | | Visible name of this qualitative band. |
|
|
49
49
|
| rows[].direction | string | | Whether a higher measure is favorable when interpreting the target difference. Neutral uses plain ink without a judgment, including when bands have tones. One of `'higherIsBetter'`, `'lowerIsBetter'`, `'neutral'`. |
|
|
@@ -52,15 +52,16 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
52
52
|
|
|
53
53
|
| Path | Type | Values | Default | Meaning |
|
|
54
54
|
|---|---|---|---|---|
|
|
55
|
-
| labels | false \| object | `false` (or another value of its type) | | False hides value, target-value and delta labels. Row names remain. category: false hides row names. density: compact draws no labels. |
|
|
55
|
+
| labels | false \| object | `false` (or another value of its type) | | False hides value, target-value and delta labels. Row names, band names and band-edge numbers remain. category: false hides row names. density: compact draws no labels. |
|
|
56
|
+
| sort | object \| string \| true | `'sheet'`, `'asc'`, `'desc'`, `'reverse'`, `true` (or another value of its type) | | Category ranking value: value divided by target when every row has a positive target, otherwise raw value. desc puts the highest ranking value first even on lower-is-better rows. Ties keep authored order and null values sort last. sheet keeps authored order and reverse reverses it. Dated rows keep authored order when a growth or difference annotation spans periods. |
|
|
56
57
|
| axisTitles | object | | | Title of the value axis when it is drawn: under the tick row of the shared-scale axis valueAxis.show draws, ending at its right end. Drawn only when authored. |
|
|
57
58
|
| axisTitles.primary | string | | | 'Measure, unit' title of the value axis, e.g. 'Margin, %'. |
|
|
58
59
|
| sharedScale | boolean \| string | `'percentOfTarget'` (or another value of its type) | | true: one absolute scale across all rows (same-unit rows, comparable magnitudes; supports valueAxis). false: each row normalized to its own zero-based extent — band maximum extended by value/target overshoot; a bandless row uses its value/target extent (the bullet-graph percent-of-scale — mixed-unit KPI rows stay legible; valueAxis is ignored with a warning). 'percentOfTarget': every row in percent of its own target (actual ÷ target) on one 0–120% scale, three shared bands named once in a key (below 80%, 80–100%, at or above target), mirrored at 100% on a lower-is-better row (the key then reads more than 20% off, up to 20% off, on target or better), one target line at 100%, value, share of target and delta beside each row; the rows' bands, valueAxis and annotations are not drawn. Default: false when every row declares bands and the rows differ in unit or band thresholds (warns bullet-row-scales), true otherwise. |
|
|
59
|
-
| bandKey | string | `'auto'`, `'labels'`, `'ramp'`, `'row'` | `'auto'` | How the bands are named. 'labels': one key entry for each band label and shade. 'ramp': one worse-to-better key with one entry for each band (Worse ... Better); it needs the same 2 to 5 bands on every banded row, no band tone and no neutral row, and otherwise keeps labels with a warning. 'row': each band's name prints above its band on every row, as authored
|
|
60
|
+
| bandKey | string | `'auto'`, `'labels'`, `'ramp'`, `'row'` | `'auto'` | How the bands are named. 'labels': one key entry for each band label and shade. 'ramp': one worse-to-better key with one entry for each band (Worse ... Better); it needs the same 2 to 5 bands on every banded row, no band tone and no neutral row, and otherwise keeps labels with a warning. 'row': each band's name prints above its band on every row, as authored; on per-row scales the band edges are ticked and numbered under each row; a key at the bottom names the bar (Actual), the target tick and, when strings.bandKey is set, the ramp in those words. It needs a name on every band, rows side by side with the target column, and room for each name above its band; otherwise the key names the bands with a warning. 'auto': 'row' for at most 4 rows that name every band wherever it can show; else the ramp when rows run both directions, a label sits on more than one shade and the ramp can apply; otherwise labels. Default 'auto'. The percentOfTarget scale has its own key. |
|
|
60
61
|
| targetColumns | boolean | | `true` | true: where the rows sit side by side and the plot keeps 45% of the width, a Target column and a Gap-to-target column print beside the rows, each under a head, with the gap's position (below, above or on target) under it and the row's direction (higher or lower is better) under its name. Where they do not fit, the target prints above its tick and the delta at the row end. false: always the second form. Default true. The percentOfTarget scale has its own columns. |
|
|
61
62
|
| density | string | `'compact'`, `'regular'` | `'regular'` | 'compact' is the 120 x 28 text-free mark: bar, bands and target tick, no labels, axis or key. The percentOfTarget scale needs a key and a value column, so compact refuses it. 'regular' uses labelled stacked rows when side columns take too much plot width. Height depends on row count and text. Default 'regular'. |
|
|
62
63
|
|
|
63
|
-
Plus the [shared options](options.md). This type does not accept `detailFields`, `
|
|
64
|
+
Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis.log`, `valueAxis.reverse`, `valueAxis.break`, `hatchStrength`, `rounding`. This type ignores `animate`, `debug`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN` with an `option-ignored` warning.
|
|
64
65
|
|
|
65
66
|
## Annotations
|
|
66
67
|
|
|
@@ -73,7 +74,7 @@ An annotation anchor is a category or item id string, or an object with category
|
|
|
73
74
|
| 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 | | |
|
|
74
75
|
| abs | Reads the anchored data value and places its formatted absolute value in a collision-managed label. | at | at: AnchorRef | | |
|
|
75
76
|
| diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
|
|
76
|
-
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
|
|
77
|
+
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
|
|
77
78
|
| valueLine | Draws a reference line at an authored value or an engine-computed mean, with optional tolerance shading and attainment fill between the line and resolved actuals. | | from: categoryId (optional); to: categoryId (optional) | value: number \| 'mean', default mean. A number draws the line there; mean has the engine compute it. valueKind: 'fraction'. Multiply a numeric value and its tolerance by 100 before layout: 0.35 draws at 35%. Independent of data.valueKind. Omit it for values already in percent points; not valid with mean. label: string \| false. Name plus value; ${value} sets its position. A number already in the name is kept once. false hides it. tolerance: number \| { low, high }. A number shades that distance on both sides of the line; low and high shade an authored corridor. attainment: boolean \| { seriesId, direction }. Shades each category between its actual and the line. | No anchor is required. Value defaults to mean. Scoped means are line-only: seriesId and paired from/to compute a primary-axis mean and limit its stroke to those bands; other types refuse scope fields for a mean. Numeric values cannot use scope fields except as a category clip with tolerance or attainment. A secondary-axis line needs an acknowledged secondary scale and an explicit numeric value. Optional tolerance shades a value-axis band; optional attainment fills between the line and resolved actuals. |
|
|
78
79
|
| band | Draws an inclusive category span as a shaded band or bracket, or a value-axis plan corridor, tolerance band or attainment fill, with a collision-managed label. | | from: categoryId (optional); to: categoryId (optional) | | Era shade/bracket needs inclusive category IDs. Corridor and tolerance use finite low/high on the value scale, with optional from/to as a category clip. Attainment needs a plan value and shades each resolved actual; missing cells are skipped. Divider applies only to bracket bands. Scenario AC/PY/PL/FC paints a plan corridor (default PL). |
|
|
79
80
|
|
|
@@ -107,6 +108,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
107
108
|
| band-key-labels | torture | bandKey labels keeps every label and shade |
|
|
108
109
|
| band-key-ramp | example | bandKey ramp forces the worse-to-better key |
|
|
109
110
|
| two-sided-spend | example | Both low and high spend are off plan |
|
|
111
|
+
| two-sided-spend-full-fill | torture | Toned bands in their full fills |
|
|
110
112
|
| tone-spectrum | torture | Band tones carry the range judgment |
|
|
111
113
|
| neutral-change | example | A neutral comparison with a target |
|
|
112
114
|
| plan-wording | example | strings.target words the comparison as plan |
|
|
@@ -56,7 +56,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
56
56
|
| series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
|
|
57
57
|
| series[].label | string | | Displayed series name; defaults to the series id. |
|
|
58
58
|
| series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
|
|
59
|
-
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). |
|
|
59
|
+
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. |
|
|
60
60
|
| series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
|
|
61
61
|
| series[].fill | string | | Explicit CSS fill color for this series; remains authored across theme changes. |
|
|
62
62
|
| series[].unit | string | | Unit associated with the series values. |
|
|
@@ -66,13 +66,16 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
66
66
|
|
|
67
67
|
| Path | Type | Values | Default | Meaning |
|
|
68
68
|
|---|---|---|---|---|
|
|
69
|
+
| sort | object \| string \| true | `'sheet'`, `'asc'`, `'desc'`, `'reverse'`, `true` (or another value of its type) | | Category ranking value: the sortBy measure (a, b, sum or diff), default sum. categories sets sheet, reverse, asc or desc with stable ties and missing values last. A rest row stays last. Dated rows keep authored order when a growth or difference annotation spans periods. sort.segments is ignored with an info warning unless sheet. |
|
|
69
70
|
| a | string | | | Series id displayed in the left pane. |
|
|
70
71
|
| b | string | | | Series id displayed in the right pane. |
|
|
71
72
|
| centerColumnWidth | number | | | Width in pixels reserved between the panes for category labels; omission uses their measured width. |
|
|
72
|
-
| sortBy | string | `'sheet'`, `'a'`, `'b'`, `'sum'`, `'diff'` | `'sheet'` | Row
|
|
73
|
+
| sortBy | string | `'sheet'`, `'a'`, `'b'`, `'sum'`, `'diff'` | `'sheet'` | Row ranking measure: a, b, sum a+b, or difference b-a. Default sheet keeps authored order. A measure sorts descending unless sort.categories supplies the direction or mode. |
|
|
74
|
+
| diffColumn | boolean | | | A right-aligned column of each row's difference, second series minus first, signed, under a bold delta head. Default true with sortBy 'diff', else false. A highlighted row prints bold. The panes give the column its width at one scale; it stays off below 576 px canvas width. |
|
|
73
75
|
| sharedScale | boolean | | `true` | Use the same value scale on both sides by default. False gives independent scales and warns that lengths are not comparable. |
|
|
76
|
+
| negatives | string | `'direction'`, `'magnitude'` | `'direction'` | A negative value: direction (default) runs its bar from the pane's zero line toward the category names, and positive bars run outward; magnitude draws the bar length of the absolute value outward in a lighter tint. |
|
|
74
77
|
|
|
75
|
-
Plus the [shared options](options.md). This type does not accept `
|
|
78
|
+
Plus the [shared options](options.md). This type does not accept `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
|
|
76
79
|
|
|
77
80
|
## Annotations
|
|
78
81
|
|
|
@@ -80,7 +83,7 @@ An annotation anchor is a category or item id string, or an object with category
|
|
|
80
83
|
|
|
81
84
|
| Kind | Purpose | Required | Anchors | Optional fields | Notes |
|
|
82
85
|
|---|---|---|---|---|---|
|
|
83
|
-
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. |
|
|
86
|
+
| 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. |
|
|
84
87
|
| delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | |
|
|
85
88
|
| diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. |
|
|
86
89
|
| note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | |
|
|
@@ -102,7 +105,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
102
105
|
| single-row | torture | Torture: one category only |
|
|
103
106
|
| tiny-side | torture | Torture: one side all slivers under shared scale |
|
|
104
107
|
| long-labels | torture | Torture: very long category labels ellipsize in the center column |
|
|
105
|
-
| negatives-own-scale | torture | Torture: negatives
|
|
108
|
+
| negatives-own-scale | torture | Torture: negatives run toward the names, independent pane scales with a value axis each |
|
|
106
109
|
| customer-spend-sort-sheet | torture | Customer spend ordered by authored account order |
|
|
107
110
|
| customer-spend-sort-b | torture | Customer spend ordered by Product B |
|
|
108
111
|
| customer-spend-sort-diff | example | Customer spend ordered by the B-minus-A difference |
|
|
@@ -111,6 +114,10 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
111
114
|
| license-vs-services-neutral-mark | torture | License vs Services on a dark theme whose neutral is a band tint |
|
|
112
115
|
| fixed-label-column | torture | A 160 px label column between the panes instead of the measured width |
|
|
113
116
|
| customer-spend-top-five | torture | The five largest customers, a key above the panes and explicit label kinds |
|
|
117
|
+
| negatives-shared-scale | torture | Negative values run from each pane's zero line toward the names on one shared scale |
|
|
118
|
+
| negatives-magnitude | torture | The lighter bar of \|value\| for negative values, from negatives: magnitude |
|
|
119
|
+
| blank-values | torture | A value the data lacks prints the not-applicable mark at the pane start |
|
|
120
|
+
| own-scales-mixed | torture | Panes of very different size on their own scales each draw a value axis |
|
|
114
121
|
|
|
115
122
|
## Not for
|
|
116
123
|
|
|
@@ -40,13 +40,13 @@ One form; its chart ID is `choropleth`.
|
|
|
40
40
|
|---|---|---|---|
|
|
41
41
|
| pack | string | yes | Built-in boundary pack that supplies region shapes and identifiers. 'europe' holds the EU27, CH, NO, IS, GB, the Balkan states, UA, BY, MD and the small states, without RU and TR; it follows the EU view, shows Crimea as part of Ukraine and shows Cyprus whole. 'world' also shows Crimea as part of Ukraine and keeps Natural Earth's de facto view elsewhere; it also holds small places such as HK, MO, GI, AD, LI, MC, SM and VA as markers. One of `'de-states'`, `'eu27'`, `'dach'`, `'europe'`, `'world'`, `'us-states'`. |
|
|
42
42
|
| regions | array | yes | Observed regions keyed by pack id; omitted pack members are not in the data and draw plain background. |
|
|
43
|
-
| regions[].id | string | yes | Region identifier from the selected geographic pack. |
|
|
43
|
+
| regions[].id | string | yes | Region identifier from the selected geographic pack. Exact spellings win, then ids and aliases match without regard to case. Unknown data ids are left out with a warning and a note; all-unknown data is refused. |
|
|
44
44
|
| regions[].value | number \| null | yes | Region measure; null without a state means missing data. |
|
|
45
45
|
| regions[].state | string | | Named null state: suppressed, not meaningful (nm), or not applicable (na). Each has a distinct pattern and key. Requires value null. One of `'na'`, `'nm'`, `'suppressed'`. |
|
|
46
46
|
| overlays | array | | Named glyphs and labels placed at geographic anchors. |
|
|
47
47
|
| overlays[].id | string | yes | Stable overlay identifier, unique within the exhibit. |
|
|
48
48
|
| overlays[].at | object | yes | Region or longitude/latitude anchor for the overlay. |
|
|
49
|
-
| overlays[].at.region (overlays[].at branch 1) | string | yes | Region id whose pack anchor positions the overlay. |
|
|
49
|
+
| overlays[].at.region (overlays[].at branch 1) | string | yes | Region id whose pack anchor positions the overlay. Exact spellings win, then ids and aliases match without regard to case. |
|
|
50
50
|
| overlays[].at.lon (overlays[].at branch 2) | number | yes | Longitude in degrees, west negative and east positive. |
|
|
51
51
|
| overlays[].at.lat (overlays[].at branch 2) | number | yes | Latitude in degrees, south negative and north positive. |
|
|
52
52
|
| overlays[].glyph | object | yes | Overlay mark and its semantic data. |
|
|
@@ -61,7 +61,7 @@ One form; its chart ID is `choropleth`.
|
|
|
61
61
|
| overlays[].glyph.kind (overlays[].glyph branch 3) | string | yes | Draw a semantic status glyph. One of `'status'`. |
|
|
62
62
|
| overlays[].glyph.status (overlays[].glyph branch 3) | string | yes | Status judgment shown by the glyph. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`. |
|
|
63
63
|
| overlays[].glyph.kind (overlays[].glyph branch 4) | string | yes | Draw a named built-in icon. One of `'icon'`. |
|
|
64
|
-
| overlays[].glyph.name (overlays[].glyph branch 4) | string | yes | Name from the built-in icon catalogue: alert calendar check conversation document flag gear lightbulb people star target workflow. |
|
|
64
|
+
| overlays[].glyph.name (overlays[].glyph branch 4) | string | yes | Name from the built-in icon catalogue: alert calendar check conversation document flag gear lightbulb lock people star target workflow. |
|
|
65
65
|
| overlays[].glyph.tone (overlays[].glyph branch 4) | string | | Semantic glyph tone resolved through the theme. One of `'good'`, `'bad'`, `'warn'`, `'neutral'`, `'info'`. |
|
|
66
66
|
| overlays[].glyph.kind (overlays[].glyph branch 5) | string | yes | Draw a geometric location marker. One of `'marker'`. |
|
|
67
67
|
| overlays[].glyph.shape (overlays[].glyph branch 5) | string | | Marker outline; defaults to circle. One of `'circle'`, `'square'`, `'diamond'`. |
|
|
@@ -75,7 +75,7 @@ One form; its chart ID is `choropleth`.
|
|
|
75
75
|
| Path | Type | Values | Default | Meaning |
|
|
76
76
|
|---|---|---|---|---|
|
|
77
77
|
| labels | string \| false | `'auto'`, `'all'`, `'none'`, `false` | `'auto'` | Region-label selection policy; placement still respects available space. false is the same as 'none'. |
|
|
78
|
-
| topN | object | | | On the world pack, the automatic labels name the n regions with the largest absolute values, plus the large countries (default 12). The other packs label every region, and labels 'all' or 'none' decide for themselves, so there topN changes nothing. |
|
|
78
|
+
| topN | object \| integer | | | On the world pack, the automatic labels name the n regions with the largest absolute values, plus the large countries (default 12). The other packs label every region, and labels 'all' or 'none' decide for themselves, so there topN changes nothing. A positive integer n means { n }. |
|
|
79
79
|
| topN.n | integer | | | How many regions with the largest absolute values the automatic labels name. |
|
|
80
80
|
| scale | object | | `{"kind":"sequential"}` | Sequential magnitude or diverging midpoint color scale. |
|
|
81
81
|
| scale.kind (scale branch 1) | string | `'sequential'` | `'sequential'` | Encode ordered magnitudes with one color ramp. |
|
|
@@ -85,7 +85,7 @@ One form; its chart ID is `choropleth`.
|
|
|
85
85
|
| scale.polarity (scale branch 2) | string | `'higherIsBetter'`, `'lowerIsBetter'` | | Which side of the midpoint is favorable; the diverging poles paint good/bad accordingly. Default higherIsBetter. |
|
|
86
86
|
| classes | integer | | | Number of equal-interval color classes, from 3 through 7. Explicit steps define five classes instead. |
|
|
87
87
|
| steps | array | | | Four ascending thresholds in source units, as on cohort, defining five colour classes. A value on a threshold enters the higher class. The first and last classes are open-ended. Omit to keep the continuous ramp or equal-interval classes. Use a format that prints each threshold exactly. |
|
|
88
|
-
| regionValues | boolean | | | Print each labelled region's value after its code, e.g. 'DE 2.2%', through the same placement and fit tiers as the code. Default true when the map labels at most 10 regions, else false. Needs region labels, so labels 'none' or false refuse it. |
|
|
88
|
+
| regionValues | boolean | | | Print each labelled region's value after its code, e.g. 'DE 2.2%', through the same placement and fit tiers as the code. Default true when no value table is drawn and the map labels at most 10 regions, or, off the world map, when the canvas is at least 560 px wide and gives each label at least 8000 square pixels; else false. A region whose label no longer fits is listed with its value. Needs region labels, so labels 'none' or false refuse it. |
|
|
89
89
|
| labelRegions | array | | | Explicit region ids to label, retained by the small-region filter. |
|
|
90
90
|
| microStateMarkers | boolean | | | Draw a dot for a micro-state the data lists without a value (null); one with a value is always drawn. Default off on the world pack, the only pack whose micro-states have no outline; on the other packs it would change nothing and is refused. |
|
|
91
91
|
| smallRegionArea | number | | | Area fraction below which automatic labels move to Small members. Default 0.001; 0 disables. Explicit label requests are retained. |
|
|
@@ -100,7 +100,7 @@ One form; its chart ID is `choropleth`.
|
|
|
100
100
|
| valueTable | string \| false | `'auto'`, `'side'`, `'below'`, `false` | | The table of every region with its class swatch, code and value; the top values print bold and the map then prints codes only. 'auto' (default): beside the map when the map keeps most of the row, else under it; off above 20 regions, without numeric values, or when a pinned canvas is too short for it. 'side' or 'below' forces the place; false leaves it off. |
|
|
101
101
|
| methodNote | boolean | | | Default false. true adds the method footnote on which regions the automatic label policy names. The world pack's endorsement disclaimer stays on the source line and prints once. The inset scale note is required for interpretation and prints regardless. |
|
|
102
102
|
|
|
103
|
-
Plus the [shared options](options.md). This type does not accept `detailFields`, `
|
|
103
|
+
Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `highlight`, `story`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `sort`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
|
|
104
104
|
|
|
105
105
|
## Annotations
|
|
106
106
|
|
|
@@ -108,7 +108,8 @@ This type takes no annotations.
|
|
|
108
108
|
|
|
109
109
|
## Sizing
|
|
110
110
|
|
|
111
|
-
Floor
|
|
111
|
+
Floor 160 × 270 px; fit `content`.
|
|
112
|
+
Narrower than 280 px a map draws while its key and small members fit.
|
|
112
113
|
|
|
113
114
|
Below the floor a render is refused with `size-below-floor` and the pixels it needs. `measure` returns the natural and comfortable size for a given spec; see [Sizing in the manual](../manual.md#sizing).
|
|
114
115
|
|
|
@@ -133,6 +134,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
133
134
|
| eu-inflation-values | example | EU inflation with each region value printed after its code |
|
|
134
135
|
| eu-inflation-colorblind | example | EU inflation around 2% in the colorblind-safe good/bad pair |
|
|
135
136
|
| us-margin-versus-target | example | State margins above the target are favorable |
|
|
137
|
+
| us-margin-wide-slot | example | State margins on a wide slot: the key and the unlabelled states stand beside the map |
|
|
136
138
|
| dach-all-region-labels | example | All three DACH markets carry their region labels |
|
|
137
139
|
| german-states-bremen-on-map | torture | Bremen keeps its label on the map through labelRegions, under an authored key title |
|
|
138
140
|
| german-states-table-below | example | The value table stands under the map |
|
package/docs/reference/cohort.md
CHANGED
|
@@ -57,7 +57,7 @@ Cohorts by periods-since-start: counts in, every retention rate derived, weighte
|
|
|
57
57
|
| basis | string | `'cohort'`, `'previous'` | `'cohort'` | 'cohort' = active / cohort base (comparable down a column); 'previous' = active / the previous period's active. |
|
|
58
58
|
| averages | false \| string | `false`, `'weighted'` | `false` | Weighted column average = total active / total base of the observed cohorts. |
|
|
59
59
|
| methodNote | boolean | | | Default false. true adds the measure formula and explains the visible anchor column and blank cells. strings.cohortMeasure and strings.cohortFormula name another count-based measure, such as cumulative conversion. Required interpretation notes still print: the formula under basis 'previous', not-meaningful cells, weighted averages and rates too narrow to print. |
|
|
60
|
-
| variant | string | `'heatmap'`, `'pure'`, `'stepped'` | `'heatmap'` | Form. 'heatmap' (the default) draws the heatmap surface, which honours 'labels'. 'pure' and 'stepped' draw the exhibit. Stepped columns
|
|
60
|
+
| variant | string | `'heatmap'`, `'pure'`, `'stepped'` | `'heatmap'` | Form. 'heatmap' (the default) draws the heatmap surface, which honours 'labels'. 'pure' and 'stepped' draw the exhibit. Stepped columns share the width the label and size columns leave, as pure columns do, and preserve weighted-average and missing-cell notes. The exhibit variants draw a fixed label set, so authoring 'labels' together with variant is refused (the legacy surface honours it). |
|
|
61
61
|
| formatScope | string | `'classic'`, `'column'` | | Stepped fills use absolute bins ('classic') or normalize within each period ('column'). |
|
|
62
62
|
| steps | array | | | Four ascending thresholds in percentage points that split the absolute ('classic') stepped fills into five classes the key names, such as [70, 80, 85, 90] for period-to-period retention. Default [30, 40, 50, 60]. |
|
|
63
63
|
| visiblePeriods | array | | | Original zero-based period indices displayed in chronological order by exhibit presets. |
|
|
@@ -68,8 +68,9 @@ Cohorts by periods-since-start: counts in, every retention rate derived, weighte
|
|
|
68
68
|
| total | false \| string | `false`, `'weighted'` | | Exhibit summary row: weighted retention by default, or false to hide it. Never averages cohort percentages equally. |
|
|
69
69
|
| excludeCurrentPeriod | boolean | | | Remove the newest cohort and longest period before exhibit derivation. |
|
|
70
70
|
| exhibitLabel | string | | | Short exhibit heading above the assertion title. |
|
|
71
|
+
| heightFill | string | `'rows'`, `'none'` | `'rows'` | Exhibit variants. 'rows' (default): rows take the spare height of a pinned canvas, up to 1.8 times, and stepped columns share the free width. 'none': natural row height, stepped columns at measured width. |
|
|
71
72
|
|
|
72
|
-
Plus the [shared options](options.md). This type does not accept `detailFields`, `
|
|
73
|
+
Plus the [shared options](options.md). This type does not accept `detailFields`, `valueAxis`, `rounding`. This type ignores `animate`, `debug`, `rowLabels`, `categoryAxis`, `categoryLabels`, `secondaryAxis`, `topN`, `bandFraction`, `valueAxis.show`, `valueAxis.gridlines` with an `option-ignored` warning.
|
|
73
74
|
|
|
74
75
|
## Annotations
|
|
75
76
|
|
package/docs/reference/column.md
CHANGED
|
@@ -56,7 +56,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
56
56
|
| series[].id | string | yes | Series identity used by keyed options, annotations and legend entries. |
|
|
57
57
|
| series[].label | string | | Displayed series name; defaults to the series id. |
|
|
58
58
|
| series[].values | (cell \| { categoryId, value: cell })[] | yes | Values in category order, or keyed entries pairing a categoryId with its value. |
|
|
59
|
-
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST). Controls scenario labels and paint conventions. |
|
|
59
|
+
| series[].scenario | string | | AC, PY, PL, FC (or ACT, BUD, FCST, LY for last year). Codes and aliases accept any case. Controls scenario labels and paint conventions. |
|
|
60
60
|
| series[].direction | string | | Whether increases are favorable; defaults to higherIsBetter for directional comparisons. One of `'higherIsBetter'`, `'lowerIsBetter'`. |
|
|
61
61
|
| series[].role | string | | Data series or comparison-only reference series; references are excluded from the main plotted data. One of `'data'`, `'reference'`. |
|
|
62
62
|
| series[].colorRole | string | | Theme color role used for this series when no explicit fill takes precedence. One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill. |
|
|
@@ -69,11 +69,11 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
69
69
|
| Path | Type | Values | Default | Meaning |
|
|
70
70
|
|---|---|---|---|---|
|
|
71
71
|
| labelDensity | string | `'full'`, `'smart'`, `'minimal'` | | Value-label density. Default 'smart': every value stays eligible. A chart with more than 12 categories, or with most labels wider than the band, ranks the first, last, highest and lowest value (ties: the first) first. The other values then use only their natural seat beside the mark; with none free they are drawn nowhere and left out of the note. Those four may take one step, and the note names any that finds no seat. A smaller chart keeps every value on the bounded one-step rule and names any that finds no seat. 'full' treats all values alike and names every one that finds no seat. 'minimal' also applies the shared priority gate. Seats stay inside the plot band and one step from the natural seat. All values remain in reading records. When valueLabels is set, it wins: labelDensity is not read for the value labels. |
|
|
72
|
-
| legend | string \| object | `'top'`, `'bottom'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key by default unless visible direct labels name them all. 'none' hides the key and warns if names are missing. Subtitle and footnote mentions do not replace the key. |
|
|
72
|
+
| legend | string \| object | `'top'`, `'bottom'`, `'right'`, `'left'`, `'none'`, `'auto'` (or another value of its type) | | Key position. Multiple series get a key by default unless visible direct labels name them all. 'none' hides the key and warns if names are missing. Subtitle and footnote mentions do not replace the key. |
|
|
73
73
|
| valueAxis.break | false \| object | `false` (or another value of its type) | | No break by default or with false. Set { from, to, style? } for a straight value-axis break; the omitted span collapses to a fixed 12px gap when valid. Automatic placement is supported only by waterfall and pvm. |
|
|
74
74
|
| axisTitles | object | | | Title over the value axis when valueAxis.show draws it, in the top row left of the plot. A theme with valueAxis.titles derives 'Measure, unit' from subtitle.measure and a unit the drawn subtitle does not print, when none is authored. |
|
|
75
75
|
| axisTitles.primary | string | | | 'Measure, unit' title over the value axis, e.g. 'Revenue, €m'. |
|
|
76
|
-
| valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Which values print, with line's choices: 'none', 'last', 'ends' (first and last), 'extremes' (first, last, highest and lowest; a tie takes the first) or 'all', chosen per series over the categories in their drawn order. Unset (default): every value is eligible and labelDensity decides. When set, valueLabels wins over labelDensity: each chosen value takes the one-step rule of 'full', and one with no seat is named in the note. A value not chosen is unlabelled by choice: the note does not name it, and the value axis is drawn so it stays readable (all modes but 'all'; valueAxis.show false turns it off). Authored cell labels and flagged anomaly periods print in every mode. Grouped only: a stack has no single value per category, so stacked and stacked100
|
|
76
|
+
| valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Which values print, with line's choices: 'none', 'last', 'ends' (first and last), 'extremes' (first, last, highest and lowest; a tie takes the first) or 'all', chosen per series over the categories in their drawn order. Unset (default): every value is eligible and labelDensity decides. When set, valueLabels wins over labelDensity: each chosen value takes the one-step rule of 'full', and one with no seat is named in the note. A value not chosen is unlabelled by choice: the note does not name it, and the value axis is drawn so it stays readable (all modes but 'all'; valueAxis.show false turns it off). Authored cell labels and flagged anomaly periods print in every mode. Grouped only: a stack has no single value per category, so stacked and stacked100 ignore every mode but 'all' with an option-ignored warning and keep their normal labels and value axis. Example: 24 monthly columns with 'extremes' print the first, peak, low and last value. |
|
|
77
77
|
| variant | string | `'grouped'`, `'stacked'`, `'stacked100'` | `'grouped'` | Vertical arrangement: grouped by default, stacked in raw units, or stacked100 as category percentages. Plain stacked series use theme.overrides.color.stack, not color.series. Set options.palette or series fill for categorical colours. |
|
|
78
78
|
| grandTotalLabels | boolean | | | Show category stack-total labels in addition to segment labels; default on for the stacked variant and off for stacked100, where every bar would end on the same share. true keeps the absolute total on a 100% stack. |
|
|
79
79
|
| sharesOfOneWhole | boolean | | | true declares every stacked series a share of the same whole, such as channel shares of all orders: the stack then has a total, and percent series warn non-additive-stack only where a category adds to more than 100. Stacked and stacked100 only; refused on other variants. |
|
|
@@ -83,6 +83,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
83
83
|
| netLine.connectors | boolean | | | Connect adjacent category ticks as a stepped line; defaults to true for columns. |
|
|
84
84
|
| averageMarker | boolean \| object | | | Computed dashed average rule with a solver-placed Ø label. |
|
|
85
85
|
| averageMarker.scope | string \| array | `'all'` (or another value of its type) | | Series included in the computed average; defaults to 'all'. |
|
|
86
|
+
| averageMarker.includePartial | boolean | | | true averages the categories marked partial too. By default they are left out, and the label names the periods the average covers. Column, bar and combo. |
|
|
86
87
|
| connectors | boolean \| object | | | Connect matching series boundaries between adjacent stacked columns. |
|
|
87
88
|
| connectors.style | string | `'line'`, `'dashed'` | | Connector stroke: solid 'line' (default) or 'dashed', matching the waterfall bridge's dash. |
|
|
88
89
|
| connectors.scope | string \| array | `'all'` (or another value of its type) | | Series boundaries to connect; defaults to 'all'. |
|
|
@@ -111,7 +112,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
111
112
|
| seriesLabels | object | | | Name the stacked series once, at the right edge of the LAST column or the left edge of the FIRST, instead of in a legend: the layers of a cohort chart are read off their own bars. Stacked variants only; a grouped chart keeps its legend. |
|
|
112
113
|
| seriesLabels.at | string | `'right-edge'`, `'left-edge'` | | Where the names sit, on the middle of each named layer: 'right-edge' beside the last column, 'left-edge' before the first, right-aligned. |
|
|
113
114
|
| seriesLabels.only | array | | | The series that carry a name; without it every stacked series gets one, and the solver hides the ones that do not fit. |
|
|
114
|
-
| seriesLabels.cagr | true \| object | `true` (or another value of its type) | | Series CAGR: each name carries its series' compound annual growth rate over the span, 'Product B +10.1% p.a.', with a claim record per series. The years come from the categories' ISO dates or year-bearing labels; a series with a missing value, a start at or below zero or a negative end prints its name alone and warns; an end of zero reads -100%. |
|
|
115
|
+
| seriesLabels.cagr | true \| object | `true` (or another value of its type) | | Series CAGR: each name carries its series' compound annual growth rate over the span, 'Product B +10.1% p.a.', with a claim record per series. A key that names the series in place of the edge carries the rate. The years come from the categories' ISO dates or year-bearing labels; a series with a missing value, a start at or below zero or a negative end prints its name alone and warns; an end of zero reads -100%. |
|
|
115
116
|
| seriesLabels.cagr.from | string | | | First category of the span; default the first category. |
|
|
116
117
|
| seriesLabels.cagr.to | string | | | Last category of the span; default the last category. |
|
|
117
118
|
| seriesLabels.cagr.format | string | | | Percent format-by-example for the rates, such as +0.00% for two decimals; default one decimal. |
|
|
@@ -132,7 +133,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
|
|
|
132
133
|
| viewDomain | object | | | Zoom the visible categories. Means, the average marker and anomaly rules keep every source period. A mean's Ø label names the periods it covers where the plot draws fewer, 'Ø 40.4 (Jan 25–Dec 26)'. Refused with a category sort or topN, which break the period order. |
|
|
133
134
|
| viewDomain.x | array | | | Inclusive category ids bounding the visible x axis. |
|
|
134
135
|
|
|
135
|
-
Plus the [shared options](options.md). This type does not accept `valueAxis.log`, `valueAxis.reverse`, `
|
|
136
|
+
Plus the [shared options](options.md). This type does not accept `valueAxis.log`, `valueAxis.reverse`. This type ignores `animate`, `debug`, `rowLabels`, `secondaryAxis` with an `option-ignored` warning.
|
|
136
137
|
|
|
137
138
|
## Annotations
|
|
138
139
|
|
|
@@ -140,7 +141,7 @@ An annotation anchor is a category or item id string, or an object with category
|
|
|
140
141
|
|
|
141
142
|
| Kind | Purpose | Required | Anchors | Optional fields | Notes |
|
|
142
143
|
|---|---|---|---|---|---|
|
|
143
|
-
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. |
|
|
144
|
+
| cagr | Draws a growth arrow between two anchored points and computes the compound annual growth rate from their values and ISO-date span. | | from: AnchorRef (optional); to: AnchorRef (optional) | suffix: string, default 'p.a.'. Text after the rate. period: boolean. Print the period before the rate from the anchors' category labels, '2014–2019: +5.8% p.a.'. Default true when the chart carries two or more CAGRs, so nested brackets are told apart by their text, false otherwise. An arrow's ends show its span, so an arrow prints the rate alone unless period is true. shape: bracket \| arrow, default bracket. arrow draws one straight arrow over the marks with the rate in an oval on it, lifted until it clears them. Where no straight line clears the chart, the span is too short for the oval, a stack's inner layer is the anchor or the chart lays comparisons out itself, it draws the bracket and warns cagr-arrow-no-room. | Omitted endpoints span the first to the last category, or the first to the last total on a waterfall. Resolved endpoints need a positive date interval from ISO dates or year-bearing labels and a positive start value; an end of zero reads -100%, and a start at or below zero or a negative end omits the rate and warns cagr-undefined. On a continuous time axis the years are the exact span between the two readings. An anchor on one series of several (seriesId, or a line category, which reads the first drawn series) names that series in the label, "Product B +10.1% p.a.", and the arm runs from that series' segment or point. In text, ${value} prints the rate with its suffix, so "CAGR 2014–2019: ${value}" keeps the computed number. Drawn reference series accept anchors. |
|
|
144
145
|
| diff | Draws a level-difference arrow between two anchors and computes either percent change or their signed value difference. | from, to | from: AnchorRef; to: AnchorRef | mode: relative \| absolute \| reversed, default relative. relative prints the percent change from 'from' to 'to', reversed the change from 'to' to 'from', absolute the value difference. | Mode defaults to relative. Relative and reversed changes need a nonzero base; negative bases use its absolute magnitude and emit a warning. Absolute mode reports the raw value difference. A hidden label removes its arm. Drawn reference series accept anchors. |
|
|
145
146
|
| delta | Computes the signed difference between an anchored value and another anchor or literal, then places a collision-managed label at the first anchor. | at, vs | at: AnchorRef; vs: AnchorRef \| number | | Drawn reference series accept anchors. |
|
|
146
147
|
| note | Places authored text at an anchored data element through collision avoidance, with an optional icon or status chip. | at, text | at: AnchorRef | | Drawn reference series accept anchors. |
|
|
@@ -159,6 +160,7 @@ The default `labelDensity: 'smart'` keeps every value eligible. In a chart with
|
|
|
159
160
|
|
|
160
161
|
Floor 480 × 270 px; fit `fill`.
|
|
161
162
|
Below 480 px wide or 270 px high, down to the compact floor of 280 × 180 px, the chart draws in compact mode; `belowMinimum: 'refuse'` refuses there instead.
|
|
163
|
+
Narrower than the compact floor, down to 120 px wide, a column draws while its bars stay at least 3 px wide.
|
|
162
164
|
|
|
163
165
|
Below the floor a render is refused with `size-below-floor` and the pixels it needs. `measure` returns the natural and comfortable size for a given spec; see [Sizing in the manual](../manual.md#sizing).
|
|
164
166
|
|
|
@@ -185,6 +187,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
185
187
|
| stacked-dashed-connectors | example | Stacked columns with dashed series connectors |
|
|
186
188
|
| stacked100-share-shift-connectors | example | Stacked 100% columns with share-boundary connectors |
|
|
187
189
|
| stacked-revenue-cagr | example | Stacked column time series with CAGR arrow and grand totals |
|
|
190
|
+
| stacked-revenue-cagr-arrow | example | Stacked column time series with a straight CAGR arrow |
|
|
188
191
|
| stacked100-shares-sum | torture | Torture: 100% stacked shares that add up to 100% in every column |
|
|
189
192
|
| stacked100-energy-mix | example | Stacked 100% column with absolute totals and 100% indicator |
|
|
190
193
|
| clustered-brand-gap | example | Clustered columns with value axis, gridlines, and diff arrow |
|
|
@@ -201,7 +204,7 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
201
204
|
| consensus-surprise-threshold | example | Authored surprise corridor: no statistics at all |
|
|
202
205
|
| anomaly-small-sample | torture | Torture: five periods refuse to produce an outlier verdict |
|
|
203
206
|
| anomaly-torture | torture | Torture: 60 periods, MAD = 0, an all-negative series and a 40× tail |
|
|
204
|
-
| accessible-title-opt-in | example | Optional SVG hover title |
|
|
207
|
+
| accessible-title-opt-in | example | Optional SVG hover title and authored accessible description |
|
|
205
208
|
| minimum-frame | example | Column at the standalone size floor |
|
|
206
209
|
| compact-frame | example | Compact column with source and note marker |
|
|
207
210
|
| hatched-stack-labels | example | Forecast stack with protected inside values |
|
|
@@ -234,6 +237,8 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
234
237
|
| column-compact-380 | example | Column in a 380px dashboard column |
|
|
235
238
|
| column-card-320-frame-rules | example | Grouped column in a 320px card with an automatic height |
|
|
236
239
|
| column-partial-week | example | Stacked weekly orders with the running week marked partial |
|
|
240
|
+
| column-partial-week-average | example | Stacked weekly orders with an average rule that leaves the running week out |
|
|
241
|
+
| column-partial-week-average-included | example | Stacked weekly orders with an average rule that includes the running week |
|
|
237
242
|
| torture-long-labels | torture | Torture: long names at a generous size read whole, never cut |
|
|
238
243
|
| revenue-axis-title | example | Grouped columns with a titled value axis |
|
|
239
244
|
| weekly-events-lane | example | Event lane: stock-outs and launches over weekly revenue, the rest numbered in the key |
|
|
@@ -273,3 +278,5 @@ Below the floor a render is refused with `size-below-floor` and the pixels it ne
|
|
|
273
278
|
| option-value-labels-ends | example | The first and latest quarter print their values (valueLabels ends) |
|
|
274
279
|
| option-value-labels-none | example | No value prints; the axis reads every column (valueLabels none) |
|
|
275
280
|
| option-value-labels-all | example | Every quarter prints its value (valueLabels all) |
|
|
281
|
+
| grouped-twelve-slide | torture | Two series over twelve units on a full slide print all 24 values |
|
|
282
|
+
| key-right-slide | example | Clustered columns on a slide with the key in a column right of the plot |
|