boardplot 0.58.1 → 0.59.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (415) hide show
  1. package/CHANGELOG.md +67 -0
  2. package/dist/{ReaderBox-WVOT7VVJ.js → ReaderBox-4PNFZO56.js} +4 -4
  3. package/dist/{annotateEngine-57L26X77.js → annotateEngine-DL4KRQ6B.js} +1 -1
  4. package/dist/build-identity.json +3 -3
  5. package/dist/{chunk-54YO56IK.js → chunk-25JXYOSX.js} +1 -1
  6. package/dist/{chunk-HF4BCPIV.js → chunk-266ENWFM.js} +3 -3
  7. package/dist/{chunk-FRR7BJ3B.js → chunk-2E2MK4XM.js} +2 -2
  8. package/dist/{chunk-2DS4MT7T.js → chunk-2GVW5WDD.js} +3 -3
  9. package/dist/{chunk-4ROZ4TFL.js → chunk-2HRDOBPS.js} +1 -1
  10. package/dist/chunk-2Q7IAWON.js +18 -0
  11. package/dist/{chunk-PVGJM2HP.js → chunk-33SPSKTP.js} +4 -4
  12. package/dist/{chunk-Z6DUNKFU.js → chunk-3JG764MI.js} +688 -140
  13. package/dist/{chunk-OZLKEBCD.js → chunk-3V7Y7CHI.js} +1 -1
  14. package/dist/{chunk-3BMPYY26.js → chunk-3WC2TA6C.js} +4 -4
  15. package/dist/{chunk-T7PRG6AO.js → chunk-3WFJDXZO.js} +3 -3
  16. package/dist/{chunk-5KAYLRRP.js → chunk-3ZR7ZE64.js} +2 -2
  17. package/dist/{chunk-WW4KLAVO.js → chunk-4DLIXTDH.js} +5 -5
  18. package/dist/{chunk-OQUH7I5T.js → chunk-4EEK4AMC.js} +2 -2
  19. package/dist/{chunk-RLH2CQCD.js → chunk-4LCQO46F.js} +144 -55
  20. package/dist/{chunk-SHYS52VO.js → chunk-4NIIQFDA.js} +147 -104
  21. package/dist/{chunk-ED7GLWTF.js → chunk-4PKUS5MG.js} +2 -1
  22. package/dist/{chunk-645BGVPP.js → chunk-4WH2YGO6.js} +3 -3
  23. package/dist/{chunk-MXUPMGRY.js → chunk-4YKS2JDE.js} +3 -3
  24. package/dist/{chunk-LYAT62UT.js → chunk-4YZQY3AA.js} +1 -1
  25. package/dist/{chunk-VJULLJLN.js → chunk-56CDMSE5.js} +2 -2
  26. package/dist/{chunk-SBKM6XFS.js → chunk-5AXWSGS7.js} +3 -3
  27. package/dist/{chunk-XZXZNI7A.js → chunk-5HOIOQK3.js} +1 -1
  28. package/dist/{chunk-ERDKMZ7O.js → chunk-5OV7VOGV.js} +2 -2
  29. package/dist/{chunk-AICO24HJ.js → chunk-5QMM354E.js} +6 -5
  30. package/dist/{chunk-USMKNNOU.js → chunk-5UXK5BAA.js} +37 -38
  31. package/dist/{chunk-ZB3JIL3L.js → chunk-5YULK4DY.js} +6 -10
  32. package/dist/{chunk-63JUV7NR.js → chunk-5ZE7SHRM.js} +3 -3
  33. package/dist/{chunk-SCAYWQZK.js → chunk-67744WKZ.js} +1 -1
  34. package/dist/{chunk-IFUAPFL5.js → chunk-6CZGFTGK.js} +51 -47
  35. package/dist/{chunk-7YZZCQT3.js → chunk-6IIYLDSQ.js} +3 -3
  36. package/dist/{chunk-JBAVMO56.js → chunk-6TH5NVKS.js} +19 -14
  37. package/dist/{chunk-I5VNHDPR.js → chunk-6TZDPQDE.js} +2 -2
  38. package/dist/{chunk-TMEUK2WS.js → chunk-77L6QGIG.js} +1 -1
  39. package/dist/{chunk-OS7C2KMQ.js → chunk-7IONS4Z7.js} +3 -3
  40. package/dist/{chunk-ETUKDEGL.js → chunk-7QUWM5W6.js} +6 -6
  41. package/dist/{chunk-KI7VCHNZ.js → chunk-7SIZGM5S.js} +78 -53
  42. package/dist/{chunk-G7BCLYL4.js → chunk-7TZIPGFH.js} +8 -6
  43. package/dist/{chunk-76GPN6AT.js → chunk-7UUSHA7H.js} +1 -1
  44. package/dist/{chunk-OZA7HA6L.js → chunk-7UZUXPFM.js} +1 -1
  45. package/dist/{chunk-4DK67I3B.js → chunk-7YJSSPQX.js} +31 -28
  46. package/dist/{chunk-TBZT5WUT.js → chunk-7ZXIHEZS.js} +4 -4
  47. package/dist/{chunk-IMUMPKXF.js → chunk-A3SOYL6F.js} +3 -3
  48. package/dist/{chunk-P3NMDPDP.js → chunk-ADLKZEML.js} +31 -64
  49. package/dist/{chunk-SKPOXLG5.js → chunk-AFQZBCME.js} +4 -4
  50. package/dist/{chunk-TVOMGNFQ.js → chunk-AGR4VJ2Y.js} +1 -1
  51. package/dist/{chunk-2HII2B6S.js → chunk-AH2L44TR.js} +3 -3
  52. package/dist/{chunk-WFBN2HXR.js → chunk-AIPOSNVG.js} +1 -1
  53. package/dist/{chunk-4OJF6DXL.js → chunk-AUSZDYGE.js} +9 -7
  54. package/dist/{chunk-2SWSUNA4.js → chunk-AVYRC2T3.js} +50 -28
  55. package/dist/{chunk-NSMYIUBZ.js → chunk-B5FT4YAX.js} +1 -1
  56. package/dist/{chunk-H3VICNTN.js → chunk-B7UWG6XJ.js} +1 -1
  57. package/dist/{chunk-X3QUASBR.js → chunk-BJJYNTVJ.js} +1 -1
  58. package/dist/{chunk-WKXLJNHW.js → chunk-BOUZKVIY.js} +17 -19
  59. package/dist/{chunk-WUP6C4ZD.js → chunk-BXZNLMMH.js} +1 -1
  60. package/dist/{chunk-OMNB27GM.js → chunk-C26Z5AEW.js} +3 -3
  61. package/dist/{chunk-VC62V7CX.js → chunk-CV5KCQD3.js} +72 -79
  62. package/dist/{chunk-RPGEB3Z5.js → chunk-CX7WUNMO.js} +22 -18
  63. package/dist/{chunk-YJUBX3QF.js → chunk-DANKUHCX.js} +41 -40
  64. package/dist/{chunk-IDXYHDQY.js → chunk-DBKMJWPO.js} +1 -1
  65. package/dist/{chunk-6ALORYH7.js → chunk-DEJ27Y2P.js} +138 -91
  66. package/dist/{chunk-HTQGJQZN.js → chunk-DITI57ZB.js} +1 -1
  67. package/dist/{chunk-IXU5C3YY.js → chunk-DO7MMF4C.js} +86 -43
  68. package/dist/{chunk-I52OMC5B.js → chunk-DUDVHQD6.js} +7 -7
  69. package/dist/{chunk-4TUU3UGY.js → chunk-DXLWMK24.js} +3 -3
  70. package/dist/{chunk-MALSSEXO.js → chunk-DYD7W3Y6.js} +20 -21
  71. package/dist/{chunk-P5RCP4NK.js → chunk-DZBT7AWJ.js} +2 -2
  72. package/dist/{chunk-YLRAAJYV.js → chunk-E4KHHC46.js} +16 -16
  73. package/dist/{chunk-KUWIRCYJ.js → chunk-E62SXDRT.js} +2 -2
  74. package/dist/{chunk-WOICFLOJ.js → chunk-EADD6NNQ.js} +73 -79
  75. package/dist/{chunk-CMPHT2LS.js → chunk-EH23CIC5.js} +4 -4
  76. package/dist/{chunk-HM4AJ5U4.js → chunk-EJA5EANI.js} +47 -26
  77. package/dist/{chunk-NFGV5OAR.js → chunk-EWGFOEJB.js} +126 -65
  78. package/dist/{chunk-Y6E4JU3U.js → chunk-EWMPUCIG.js} +37 -37
  79. package/dist/{chunk-GB3RZYTK.js → chunk-EZ5KUBYF.js} +38 -27
  80. package/dist/{chunk-M5LPP2GQ.js → chunk-F2N5BUBK.js} +12 -13
  81. package/dist/{chunk-VJ7VBB6S.js → chunk-F7QCIJAY.js} +1 -1
  82. package/dist/{chunk-C4SQU2PB.js → chunk-FB36HSY2.js} +4 -4
  83. package/dist/{chunk-F3XOBFS4.js → chunk-FBIMTKYK.js} +3 -10
  84. package/dist/{chunk-XSC4IXXC.js → chunk-FMVXXKSW.js} +3 -3
  85. package/dist/{chunk-3ESWPMDW.js → chunk-FP3ORYCG.js} +22 -21
  86. package/dist/{chunk-P6DEFCMQ.js → chunk-FWPPZB4G.js} +2 -2
  87. package/dist/{chunk-MSYTF3DZ.js → chunk-FYFXOLWI.js} +116 -89
  88. package/dist/{chunk-SH4UGK5U.js → chunk-GDE2JINW.js} +11 -11
  89. package/dist/{chunk-WDJSDJLV.js → chunk-GEEHXLFQ.js} +7 -6
  90. package/dist/{chunk-EDW5HQND.js → chunk-GGFT6IIM.js} +3 -3
  91. package/dist/{chunk-UBYDY4B7.js → chunk-GIJM4MP4.js} +5 -5
  92. package/dist/{chunk-UY34DDUM.js → chunk-GNK7RTO4.js} +3 -3
  93. package/dist/{chunk-CFESVCZR.js → chunk-GSHRYDJM.js} +1 -1
  94. package/dist/{chunk-3M2F7KSS.js → chunk-GWDKUKOJ.js} +96 -321
  95. package/dist/{chunk-XMX4PCFL.js → chunk-GZYMHC44.js} +2 -2
  96. package/dist/{chunk-OUR5ZHCB.js → chunk-HBKZC5BH.js} +2 -2
  97. package/dist/{chunk-23FT7RLN.js → chunk-HC4UW7MB.js} +4 -4
  98. package/dist/{chunk-AMBQ6SWU.js → chunk-HFDU2E7C.js} +27 -21
  99. package/dist/{chunk-ZG4BMJRL.js → chunk-HW67YGJC.js} +1 -1
  100. package/dist/{chunk-FJNZ7NWD.js → chunk-I65BCUVH.js} +3 -3
  101. package/dist/{chunk-VTY6YHQZ.js → chunk-ICERP2YF.js} +3 -3
  102. package/dist/{chunk-G7CXJPEN.js → chunk-ICJUN47O.js} +2 -2
  103. package/dist/{chunk-H4EDDGGX.js → chunk-ID5PE4KM.js} +3 -3
  104. package/dist/{chunk-BQ7SN7AW.js → chunk-IDJVUZAA.js} +3 -3
  105. package/dist/{chunk-O3LT4TAI.js → chunk-IQRRT32Q.js} +2 -2
  106. package/dist/{chunk-WGJIYFVQ.js → chunk-ISMFUWOP.js} +3 -3
  107. package/dist/{chunk-6AVUTZ6W.js → chunk-IX2SLULO.js} +3 -3
  108. package/dist/{chunk-Q2I3QLE3.js → chunk-IXZI4SN4.js} +116 -46
  109. package/dist/chunk-J6LGZPKI.js +89 -0
  110. package/dist/{chunk-CCAAI56H.js → chunk-JF743NNC.js} +7 -0
  111. package/dist/{chunk-YGWPOYDE.js → chunk-JIB74SQS.js} +6 -6
  112. package/dist/{chunk-ZIVCPXXL.js → chunk-JOX252XQ.js} +5 -5
  113. package/dist/{chunk-V7JFT7NQ.js → chunk-JRM22ULA.js} +54 -45
  114. package/dist/{chunk-XSEETONJ.js → chunk-JYSS5ZZF.js} +5 -5
  115. package/dist/{chunk-WLH5IBFY.js → chunk-KRIYGX3N.js} +3 -3
  116. package/dist/{chunk-XRRG4MBM.js → chunk-KWMQNKGX.js} +2 -2
  117. package/dist/{chunk-6YBNVI5I.js → chunk-LADFOYH7.js} +40 -27
  118. package/dist/{chunk-VKNQOSGW.js → chunk-LC4KDLUE.js} +3 -3
  119. package/dist/{chunk-ITEJQHXE.js → chunk-LLECS747.js} +4 -4
  120. package/dist/{chunk-JYSFAH7C.js → chunk-LM4GVVPM.js} +16 -10
  121. package/dist/{chunk-EHRRHSPV.js → chunk-LPLRXEOT.js} +55 -19
  122. package/dist/{chunk-ZBCCJPGW.js → chunk-M2FF4IPF.js} +16 -7
  123. package/dist/{chunk-4JGBCBDZ.js → chunk-MF6XGFHB.js} +1 -1
  124. package/dist/{chunk-BHLNSJG7.js → chunk-MOBRWYUQ.js} +2 -2
  125. package/dist/{chunk-CDUR3KWV.js → chunk-MOPY5REE.js} +2 -2
  126. package/dist/{chunk-MGXHFRQK.js → chunk-MTOBNHAU.js} +2 -2
  127. package/dist/{chunk-DORE2RHL.js → chunk-MYBBZNYN.js} +2 -2
  128. package/dist/{chunk-V7NUJEJE.js → chunk-MZCJ22O4.js} +1 -1
  129. package/dist/{chunk-W2QILXAL.js → chunk-NIL6TYAN.js} +4 -4
  130. package/dist/{chunk-YW35KSXR.js → chunk-NPDF7HEH.js} +2 -2
  131. package/dist/{chunk-SH4FLUAD.js → chunk-NUASZPS7.js} +1 -1
  132. package/dist/{chunk-Z62TJQO5.js → chunk-NWUEA42V.js} +3 -3
  133. package/dist/{chunk-UOOXWGBU.js → chunk-NZGQLR4X.js} +8 -8
  134. package/dist/{chunk-RQKDEJFQ.js → chunk-O32L5FK2.js} +3 -3
  135. package/dist/{chunk-OUNYHYJL.js → chunk-O623CYPA.js} +3 -3
  136. package/dist/{chunk-OELB7MTE.js → chunk-OJR5GPCN.js} +3 -3
  137. package/dist/{chunk-C47POAC5.js → chunk-OL6HVC6K.js} +1 -1
  138. package/dist/{chunk-6NGKQNTB.js → chunk-OM5MAJST.js} +68 -57
  139. package/dist/{chunk-AAQWFTDM.js → chunk-OTOASFG4.js} +92 -35
  140. package/dist/{chunk-6JTCFPAD.js → chunk-P3N74SZ5.js} +3 -3
  141. package/dist/{chunk-CKEFAD4R.js → chunk-PHQGGR5O.js} +3 -3
  142. package/dist/{chunk-DUOGEFLG.js → chunk-POHML4N4.js} +107 -50
  143. package/dist/{chunk-KVBLTAO7.js → chunk-PP23D6QV.js} +4 -5
  144. package/dist/{chunk-F2ET5ZTT.js → chunk-PPOUKS24.js} +0 -1
  145. package/dist/{chunk-V7FV66KL.js → chunk-PRVX4PAO.js} +1 -1
  146. package/dist/{chunk-JY4LTPOV.js → chunk-PSUSHJFV.js} +1 -1
  147. package/dist/{chunk-AJGSCVVW.js → chunk-PZZAVTLQ.js} +2 -2
  148. package/dist/{chunk-R5SGE2NS.js → chunk-QDFX2KAP.js} +2 -2
  149. package/dist/{chunk-XC32OSCD.js → chunk-QKDDGDRF.js} +10 -10
  150. package/dist/{chunk-U6QZOMYC.js → chunk-QM6IW5BL.js} +3 -3
  151. package/dist/chunk-QMQZC2KW.js +408 -0
  152. package/dist/{chunk-42QKUSHJ.js → chunk-QXHFELIA.js} +1 -1
  153. package/dist/{chunk-JNDWRV34.js → chunk-R2RLERPT.js} +1 -1
  154. package/dist/{chunk-E5YF236N.js → chunk-R4MVXUAG.js} +1 -1
  155. package/dist/{chunk-XZOFKLTD.js → chunk-REIIGIJG.js} +3 -3
  156. package/dist/{chunk-4M3UADCM.js → chunk-RF2REMRV.js} +6 -6
  157. package/dist/{chunk-3MFVJMP6.js → chunk-RF6ZHX5F.js} +1 -1
  158. package/dist/{chunk-TKH655ON.js → chunk-RLX6VODQ.js} +9 -2
  159. package/dist/{chunk-KWIP5YRA.js → chunk-RPS7G77V.js} +3 -3
  160. package/dist/{chunk-MVR7YKBF.js → chunk-RSDGBNXP.js} +5 -5
  161. package/dist/{chunk-QFNWGSCT.js → chunk-RYYB7REV.js} +3 -3
  162. package/dist/{chunk-LPMSGO7L.js → chunk-SBYKLBDV.js} +3 -3
  163. package/dist/{chunk-JT3UTEWZ.js → chunk-SDAVHADX.js} +2 -2
  164. package/dist/{chunk-AQ2PQ7FK.js → chunk-SE6LBMRJ.js} +137 -62
  165. package/dist/{chunk-3OSQ32GN.js → chunk-SFRMBCVY.js} +3 -3
  166. package/dist/{chunk-AGJ2QL4A.js → chunk-SNJ3FZXC.js} +14 -12
  167. package/dist/{chunk-USSG6TJV.js → chunk-SXCFMPNM.js} +3 -3
  168. package/dist/{chunk-SGDWLXUC.js → chunk-SY7JC3PH.js} +1 -1
  169. package/dist/{chunk-QATOOZMH.js → chunk-T4CFY4YT.js} +4 -4
  170. package/dist/{chunk-5SVGTQTW.js → chunk-TASEX7VA.js} +1 -1
  171. package/dist/{chunk-BVIJCUWW.js → chunk-TCWJQIVQ.js} +123 -71
  172. package/dist/{chunk-VACZGW5R.js → chunk-TEZWFQB7.js} +7 -7
  173. package/dist/{chunk-GHCU6OSE.js → chunk-TLKRYDH3.js} +2 -2
  174. package/dist/{chunk-MB5EX2YG.js → chunk-TMVERETB.js} +23 -332
  175. package/dist/{chunk-LOXZSTIM.js → chunk-TQFBLSZJ.js} +44 -27
  176. package/dist/{chunk-NT3HCXQC.js → chunk-U4WG46QP.js} +117 -43
  177. package/dist/{chunk-LJDATBPB.js → chunk-U75MMLNQ.js} +3 -6
  178. package/dist/{chunk-R3VSWOTI.js → chunk-UFGJNSSL.js} +1 -1
  179. package/dist/{chunk-FB6X7QHA.js → chunk-UGHJHJKY.js} +1 -1
  180. package/dist/{chunk-LXH4RPY4.js → chunk-UI2MKLON.js} +1 -1
  181. package/dist/{chunk-3E6NLODZ.js → chunk-UKEI7JDA.js} +1 -1
  182. package/dist/{chunk-6JFQCVNN.js → chunk-USATDW6O.js} +1 -1
  183. package/dist/{chunk-CQBPNE7Z.js → chunk-UTWLJ6AZ.js} +6 -5
  184. package/dist/{chunk-NQPJWQTW.js → chunk-UV77Y7QK.js} +11 -5
  185. package/dist/{chunk-PMT75APP.js → chunk-UXJXA4NP.js} +1 -1
  186. package/dist/{chunk-3RXUA6VY.js → chunk-UZDQFUHO.js} +3 -3
  187. package/dist/{chunk-AKZOQGF3.js → chunk-V3XYFLOZ.js} +3 -3
  188. package/dist/{chunk-OQQMDSCC.js → chunk-VGOZOBNB.js} +1 -1
  189. package/dist/{chunk-K7XPTQBJ.js → chunk-VHZ4MXJO.js} +1 -1
  190. package/dist/{chunk-EBWMTQ4U.js → chunk-VLMKGQ33.js} +13 -13
  191. package/dist/{chunk-34PKJZRY.js → chunk-VMLVZW4F.js} +39 -36
  192. package/dist/{chunk-65U6ZBZZ.js → chunk-VT6PDWUA.js} +78 -78
  193. package/dist/{chunk-GQYT7G4F.js → chunk-VTUSC24F.js} +2 -2
  194. package/dist/{chunk-33EBLJVZ.js → chunk-VVWTD4XP.js} +9 -9
  195. package/dist/{chunk-5CYLT6FJ.js → chunk-VZVPN7NT.js} +3 -3
  196. package/dist/{chunk-Z3WQXVFV.js → chunk-W4ZLMK6Z.js} +1 -1
  197. package/dist/{chunk-35ZJUZUO.js → chunk-W6NEWQZU.js} +20 -18
  198. package/dist/{chunk-DZYTXZNS.js → chunk-WD5NJHZG.js} +2 -2
  199. package/dist/{chunk-P7UOOMXE.js → chunk-WTH3KQDM.js} +2 -2
  200. package/dist/{chunk-CSMVKG2C.js → chunk-WTWM4RK6.js} +1 -1
  201. package/dist/{chunk-W6XSIBLR.js → chunk-WZNO3LUF.js} +3 -3
  202. package/dist/{chunk-QQMESIDA.js → chunk-X3AMBFGF.js} +3 -3
  203. package/dist/{chunk-DHGE46UK.js → chunk-X725AGYP.js} +1 -1
  204. package/dist/{chunk-TX5FSNAU.js → chunk-XAH4EWJT.js} +1 -1
  205. package/dist/{chunk-4DMRIL5K.js → chunk-XETSLYFD.js} +3 -3
  206. package/dist/{chunk-6V3A3MTG.js → chunk-XFDNAR4S.js} +16 -27
  207. package/dist/{chunk-WMQ57FOP.js → chunk-XGTSZ7NC.js} +3 -3
  208. package/dist/{chunk-HAG3K6PQ.js → chunk-XHEG2BG6.js} +1 -1
  209. package/dist/{chunk-D2TQX7UJ.js → chunk-XLX3TUFO.js} +2 -2
  210. package/dist/{chunk-XLLWIHN2.js → chunk-XMII3G47.js} +3 -3
  211. package/dist/{chunk-BSZOQJXB.js → chunk-XRPZJDAK.js} +101 -72
  212. package/dist/{chunk-IPBOREIY.js → chunk-XUEX5WTR.js} +1 -1
  213. package/dist/{chunk-HO4ILCW7.js → chunk-XUGEYHOQ.js} +2 -2
  214. package/dist/{chunk-OO63YP35.js → chunk-XVFUJRRC.js} +1 -1
  215. package/dist/{chunk-IVDTP6SV.js → chunk-XWGAANY4.js} +3 -3
  216. package/dist/{chunk-IPZJCBWD.js → chunk-XWUHUTXX.js} +24 -18
  217. package/dist/{chunk-WNTUBGBB.js → chunk-XXYV5UEM.js} +50 -49
  218. package/dist/{chunk-7GRR72MY.js → chunk-XZBX6LIC.js} +20 -12
  219. package/dist/{chunk-ZDJ7C64T.js → chunk-Y4BJ7D5F.js} +1 -1
  220. package/dist/{chunk-KW4JXWHO.js → chunk-YDYZWCUQ.js} +1 -1
  221. package/dist/{chunk-ZCHKIR7C.js → chunk-YJN54OZS.js} +52 -41
  222. package/dist/{chunk-X46PSAJ7.js → chunk-YJXIHVNK.js} +2 -2
  223. package/dist/{chunk-UCKUAKYQ.js → chunk-YKYK6C7F.js} +1 -1
  224. package/dist/{chunk-GNMB72V7.js → chunk-YM4MVABU.js} +56 -24
  225. package/dist/{chunk-GOFS336W.js → chunk-YM7MO7WI.js} +1 -1
  226. package/dist/{chunk-PNYWBY4K.js → chunk-YOUYJHW3.js} +3 -3
  227. package/dist/{chunk-OTWIW2L3.js → chunk-YPELB4Q7.js} +3 -3
  228. package/dist/{chunk-5I4RPBNE.js → chunk-YRCIG4IO.js} +8 -7
  229. package/dist/{chunk-FPFRLRQO.js → chunk-ZIQR2CNM.js} +7 -7
  230. package/dist/{chunk-H7BCNS5J.js → chunk-ZK22I3NF.js} +3 -3
  231. package/dist/{chunk-A6N24NGW.js → chunk-ZNA4JHHG.js} +2 -2
  232. package/dist/{chunk-VESSIKBG.js → chunk-ZOQRX5V7.js} +4 -4
  233. package/dist/{chunk-FVWHEM2N.js → chunk-ZPQ3VOAE.js} +1 -1
  234. package/dist/{chunk-NZ7FX3AE.js → chunk-ZQ5ILQ5A.js} +1 -1
  235. package/dist/cli/index.js +1 -1
  236. package/dist/{core-LSYX4UQQ.js → core-2PT7IROA.js} +2 -1
  237. package/dist/{core-YN2VVGUL.js → core-34YTH4KN.js} +1 -1
  238. package/dist/{core-7YDNMUU3.js → core-4ZEVWU43.js} +1 -1
  239. package/dist/{core-743ZXTWK.js → core-64EHPUVV.js} +1 -1
  240. package/dist/{core-ZETBHLSV.js → core-6KO5AEUH.js} +1 -1
  241. package/dist/{core-2GWH3ED7.js → core-7WLD237S.js} +1 -1
  242. package/dist/{core-AC5AKSCM.js → core-A2MERE3C.js} +1 -1
  243. package/dist/{core-O5S2NETE.js → core-AVNB2Q3G.js} +2 -1
  244. package/dist/{core-XUNZB6BM.js → core-B7KOBTRL.js} +1 -1
  245. package/dist/{core-HIONDJGC.js → core-BOOD7ZUQ.js} +1 -1
  246. package/dist/{core-3LCSHMKN.js → core-BOU34T23.js} +1 -1
  247. package/dist/{core-VYHQ5JY6.js → core-BQ2I77OF.js} +2 -1
  248. package/dist/{core-HMBMMF5Z.js → core-BSEXRZD6.js} +1 -1
  249. package/dist/{core-Q2Y3JEWL.js → core-CXEEM26F.js} +1 -1
  250. package/dist/{core-7OAGK7ZJ.js → core-EHMPBG6Q.js} +1 -1
  251. package/dist/{core-BEK6EPVF.js → core-FXC4TB2K.js} +1 -1
  252. package/dist/{core-MIERUUUT.js → core-HMS72VO6.js} +1 -1
  253. package/dist/{core-EGTJOQK7.js → core-I2GPMB2B.js} +1 -1
  254. package/dist/{core-XJZWD43V.js → core-IQC6H4A7.js} +1 -1
  255. package/dist/{core-RTBPKALG.js → core-IYEFTP6C.js} +1 -1
  256. package/dist/{core-3XGQBHJI.js → core-J2QTOU4D.js} +1 -1
  257. package/dist/{core-AEALAFRA.js → core-JJLIPTEW.js} +1 -1
  258. package/dist/{core-5CRTPVYA.js → core-LCP44UYI.js} +1 -2
  259. package/dist/{core-BRBJ3LPF.js → core-MBNVENCZ.js} +1 -1
  260. package/dist/{core-VBMWBPKM.js → core-MVIK7FAJ.js} +2 -1
  261. package/dist/{core-TIIPSEK3.js → core-N4OKPNXQ.js} +1 -1
  262. package/dist/{core-FE4THVV3.js → core-Q4IILTGO.js} +1 -1
  263. package/dist/{core-4N6WH3IF.js → core-QCPDOQEJ.js} +2 -1
  264. package/dist/{core-AAPPZSSZ.js → core-RVTF336C.js} +1 -1
  265. package/dist/{core-5K4HRIHX.js → core-VGMMKEU4.js} +1 -1
  266. package/dist/{core-3NQ5TXOJ.js → core-VUVJOMUC.js} +1 -1
  267. package/dist/{core-T7CKLMT2.js → core-VWISBHXE.js} +1 -1
  268. package/dist/{core-YKDDPMWW.js → core-W3UBWZR3.js} +1 -1
  269. package/dist/{core-FEBNVNVE.js → core-XYQRB5WF.js} +1 -1
  270. package/dist/{core-YP4MNIMV.js → core-Y6DJHIYT.js} +1 -1
  271. package/dist/{core-NTOOJZRA.js → core-YHWVJULU.js} +1 -1
  272. package/dist/{core-VLXOQ5CK.js → core-YJXOVNIE.js} +1 -1
  273. package/dist/{dataTable-FEQZSDUZ.js → dataTable-3ZK3ZEZP.js} +3 -2
  274. package/dist/{engine-SCQVNSAM.js → engine-FSWLRWZR.js} +19 -17
  275. package/dist/fixtures.js +1 -1
  276. package/dist/index.js +14 -13
  277. package/dist/{main-7UKLXCIL.js → main-NYMXWJGJ.js} +6 -5
  278. package/dist/mcp/server.js +11 -10
  279. package/dist/react/bar.js +1 -1
  280. package/dist/react/bartable.js +1 -1
  281. package/dist/react/box.js +1 -1
  282. package/dist/react/bullet.js +1 -1
  283. package/dist/react/butterfly.js +1 -1
  284. package/dist/react/choropleth.js +1 -1
  285. package/dist/react/cohort.js +2 -1
  286. package/dist/react/column.js +1 -1
  287. package/dist/react/combo.js +1 -1
  288. package/dist/react/creative.js +1 -1
  289. package/dist/react/diagram.js +1 -1
  290. package/dist/react/dimswitch.js +1 -1
  291. package/dist/react/dot.js +1 -1
  292. package/dist/react/export.js +24 -19
  293. package/dist/react/funnel.js +1 -1
  294. package/dist/react/gantt.js +1 -1
  295. package/dist/react/grid.js +1 -1
  296. package/dist/react/heatmap.js +2 -1
  297. package/dist/react/histogram.js +1 -1
  298. package/dist/react/index.js +84 -83
  299. package/dist/react/kpi.js +1 -1
  300. package/dist/react/likert.js +1 -1
  301. package/dist/react/line.js +2 -1
  302. package/dist/react/mekko.js +1 -1
  303. package/dist/react/pareto.js +1 -1
  304. package/dist/react/pie.js +1 -1
  305. package/dist/react/prepare.js +22 -20
  306. package/dist/react/pvm.js +1 -1
  307. package/dist/react/pyramid.js +1 -1
  308. package/dist/react/sankey.js +1 -1
  309. package/dist/react/scatter.js +2 -1
  310. package/dist/react/slope.js +1 -1
  311. package/dist/react/sparkline.js +1 -1
  312. package/dist/react/spec.js +10 -10
  313. package/dist/react/status.js +2 -1
  314. package/dist/react/story.js +3 -3
  315. package/dist/react/table.js +1 -1
  316. package/dist/react/theme.js +3 -3
  317. package/dist/react/tilemap.js +1 -1
  318. package/dist/react/treemap.js +1 -1
  319. package/dist/react/variance.js +1 -1
  320. package/dist/react/waffle.js +1 -1
  321. package/dist/react/waterfall.js +1 -1
  322. package/dist/{rowsModule-WJH4QNXZ.js → rowsModule-43LCK2Q7.js} +1 -1
  323. package/dist/{schema-MQT6BMNK.js → schema-2ACHQTR3.js} +1 -1
  324. package/dist/{schema-WZOSDDDJ.js → schema-3LRC5TOZ.js} +1 -1
  325. package/dist/{schema-F7TWGLRZ.js → schema-4HGZZNUL.js} +1 -1
  326. package/dist/{schema-PWPQF5RC.js → schema-4YIYGGOJ.js} +1 -1
  327. package/dist/{schema-ECJERHKF.js → schema-5OLQ54J5.js} +1 -1
  328. package/dist/{schema-CWKGLDSR.js → schema-5SVPR3EU.js} +1 -1
  329. package/dist/{schema-BA6WP5YZ.js → schema-A4U4RDKJ.js} +1 -1
  330. package/dist/{schema-JYZ4RF6S.js → schema-AM2KS6ZC.js} +1 -1
  331. package/dist/{schema-PYQEUC5P.js → schema-C25ECGJL.js} +1 -1
  332. package/dist/{schema-56MOEOVR.js → schema-CBLNGK2F.js} +1 -1
  333. package/dist/{schema-ESR6ZIK4.js → schema-D3ELHESU.js} +1 -1
  334. package/dist/{schema-5MSR4LNN.js → schema-FBIEOKO2.js} +1 -1
  335. package/dist/{schema-DUVJMFKQ.js → schema-FPDLOIA6.js} +1 -1
  336. package/dist/{schema-ALBF6V7Y.js → schema-FQWENOJY.js} +1 -1
  337. package/dist/{schema-DBIQFL56.js → schema-GTLGAPCU.js} +1 -1
  338. package/dist/{schema-Q5DACE4I.js → schema-GUDG343K.js} +2 -2
  339. package/dist/{schema-47BG2TZA.js → schema-GYTWCCNA.js} +1 -1
  340. package/dist/{schema-DL7V6NN2.js → schema-GYVYJEL3.js} +1 -1
  341. package/dist/{schema-ZU2EU2VP.js → schema-HAMPGUH3.js} +1 -1
  342. package/dist/{schema-TVUJNEX7.js → schema-IYBZPCM4.js} +1 -1
  343. package/dist/{schema-2TPGJGVR.js → schema-IYLRZNFB.js} +1 -1
  344. package/dist/{schema-KAK6DZX4.js → schema-KBV2JB2A.js} +1 -1
  345. package/dist/{schema-PV7JGX5H.js → schema-KWCIIIGP.js} +1 -1
  346. package/dist/{schema-Y4TI2T3T.js → schema-LDF6HORS.js} +1 -1
  347. package/dist/{schema-FKGGTM4Z.js → schema-LGYHJPXU.js} +1 -1
  348. package/dist/{schema-CBL2SMVR.js → schema-LX4EXDTI.js} +1 -1
  349. package/dist/{schema-2R32F6AW.js → schema-NNNG7CWG.js} +1 -1
  350. package/dist/{schema-OPXZYIW7.js → schema-P2JYSV32.js} +1 -1
  351. package/dist/{schema-FGB6IGZM.js → schema-PAKZIYQF.js} +1 -1
  352. package/dist/{schema-R42VXFIS.js → schema-SQ2GYLMI.js} +1 -1
  353. package/dist/{schema-KCJ6WTGV.js → schema-SUDJBIHX.js} +1 -1
  354. package/dist/{schema-MR3BPPQR.js → schema-TRPPZCIR.js} +1 -1
  355. package/dist/{schema-JIAQE7WO.js → schema-UNYDUIL5.js} +1 -1
  356. package/dist/{schema-5RIYEWE6.js → schema-VH4AW62Z.js} +1 -1
  357. package/dist/{schema-EDSEKZDJ.js → schema-WDKBCN3V.js} +1 -1
  358. package/dist/{schema-MOKWIGF7.js → schema-YCKUQ3FF.js} +1 -1
  359. package/dist/{schema-K7F6TEDK.js → schema-YVBUY7NH.js} +1 -1
  360. package/dist/{specValidation-DC4TVHWD.js → specValidation-FKHSTMMR.js} +1 -1
  361. package/dist/theme.js +2 -2
  362. package/dist/types/core/a11y/recordsShared.d.ts +15 -4
  363. package/dist/types/core/a11y/types.d.ts +0 -3
  364. package/dist/types/core/annotate.d.ts +17 -1
  365. package/dist/types/core/annotateTargets.d.ts +8 -0
  366. package/dist/types/core/charts/band/stacks.d.ts +4 -3
  367. package/dist/types/core/charts/bar/layout.d.ts +3 -1
  368. package/dist/types/core/charts/bartable/types.d.ts +3 -0
  369. package/dist/types/core/charts/box/types.d.ts +5 -0
  370. package/dist/types/core/charts/column/anomaly.d.ts +12 -5
  371. package/dist/types/core/charts/column/model.d.ts +4 -0
  372. package/dist/types/core/charts/combo/endpoints.d.ts +11 -1
  373. package/dist/types/core/charts/combo/layout.d.ts +7 -1
  374. package/dist/types/core/charts/dimswitch/compile.d.ts +20 -3
  375. package/dist/types/core/charts/grid/metricStack.d.ts +2 -4
  376. package/dist/types/core/charts/histogram/types.d.ts +3 -0
  377. package/dist/types/core/charts/likert/layout.d.ts +5 -2
  378. package/dist/types/core/charts/logAxis.d.ts +0 -5
  379. package/dist/types/core/charts/scatter/logAxis.d.ts +1 -1
  380. package/dist/types/core/charts/scatter/model.d.ts +10 -1
  381. package/dist/types/core/charts/scatter/trend.d.ts +19 -0
  382. package/dist/types/core/charts/table/view.d.ts +7 -0
  383. package/dist/types/core/charts/waffle/types.d.ts +8 -0
  384. package/dist/types/core/formatPrecision.d.ts +24 -0
  385. package/dist/types/core/formatSpec.d.ts +213 -61
  386. package/dist/types/core/label/solver.d.ts +3 -1
  387. package/dist/types/core/numberRule.d.ts +109 -0
  388. package/dist/types/core/numberSets.d.ts +43 -0
  389. package/dist/types/core/shownMarks.d.ts +16 -0
  390. package/dist/types/core/types/options.d.ts +8 -8
  391. package/dist/types/core/types/scene.d.ts +24 -0
  392. package/dist/types/core/types/table.d.ts +0 -13
  393. package/dist/types/react/TableChart.d.ts +9 -7
  394. package/dist/types/react/hover/engine.d.ts +6 -4
  395. package/dist/types/react/hover/labelCard.d.ts +4 -3
  396. package/dist/validate.js +5 -4
  397. package/docs/manual.md +15 -7
  398. package/docs/reference/bartable.md +2 -2
  399. package/docs/reference/cohort.md +1 -1
  400. package/docs/reference/column.md +1 -1
  401. package/docs/reference/dimswitch.md +2 -3
  402. package/docs/reference/fixtures.md +1 -1
  403. package/docs/reference/grid.md +13 -7
  404. package/docs/reference/heatmap.md +1 -1
  405. package/docs/reference/line.md +2 -2
  406. package/docs/reference/options.md +3 -3
  407. package/docs/reference/react.md +1 -1
  408. package/docs/reference/table.md +5 -8
  409. package/docs/reference/warnings.md +0 -1
  410. package/package.json +1 -1
  411. package/dist/chunk-2IRMGCYE.js +0 -125
  412. package/dist/chunk-WVCDISZP.js +0 -89
  413. package/dist/types/core/charts/table/fitFormats.d.ts +0 -67
  414. package/dist/types/core/charts/table/resolve.d.ts +0 -84
  415. package/dist/types/core/format.d.ts +0 -156
@@ -491,9 +491,31 @@ export interface SeparationRule {
491
491
  grounds?: readonly Paint[];
492
492
  }
493
493
  /** Already-formatted semantic truth carried by the layout for interactive folds. */
494
+ /**
495
+ * The texts of the record values a node prints, by slot: `value` (its owner's
496
+ * value), `field:<key>`, `share.percent`, `cmp<i>.delta` and `cmp<i>.percent`.
497
+ * The layout sets them where it formats the text, so a value reads the same in
498
+ * the hover card, the reading and the description as on the chart. On a mark
499
+ * node they are the texts its label would print where no label is drawn.
500
+ * Never rendered.
501
+ */
502
+ export type ShownTexts = Readonly<Record<string, string>>;
503
+ /**
504
+ * A value's texts where no node carries its owner (a line point with no
505
+ * marker, a change drawn on a node of another owner): a chart lists them in
506
+ * `geometry.marks.shown`. `drawn` marks a text the chart draws; without it the
507
+ * text is the value's would-be label text.
508
+ */
509
+ export interface ShownMark {
510
+ owner: OwnerRef;
511
+ shows: ShownTexts;
512
+ drawn?: true;
513
+ }
494
514
  export interface SceneDisplay {
495
515
  value?: string;
496
516
  state?: string;
517
+ /** The record values this node prints (ShownTexts). */
518
+ shows?: ShownTexts;
497
519
  /** Typed facts for an interaction layer; legacy formatted strings remain valid. */
498
520
  record?: InteractionRecord;
499
521
  }
@@ -748,6 +770,8 @@ export interface PlacedLabel extends TypographyMetadata {
748
770
  printsFor?: OwnerRef[];
749
771
  /** Calculations whose displayed text comes from this final label. */
750
772
  claimIds?: readonly Id[];
773
+ /** The record values this label prints (ShownTexts); kept on a hidden label. */
774
+ shows?: ShownTexts;
751
775
  /** Computed text before an authored label override. */
752
776
  claimText?: string;
753
777
  /** Full text behind cut lines; emitted as the text node's `<title>`. */
@@ -132,8 +132,6 @@ interface TableColumnBase {
132
132
  * where the row prints no line at all, the row grows by one inline line.
133
133
  */
134
134
  noteLine?: boolean;
135
- /** false: `options.fitFormats` leaves this column's format as authored, even where a figure is cut at its width. */
136
- fitFormat?: false;
137
135
  /** Typographic weight of the whole column: 'strong' sets the emphasis weight (700 by default), 'muted' paints it in inkMuted. */
138
136
  emphasis?: ColumnEmphasis;
139
137
  /**
@@ -244,8 +242,6 @@ export interface TableRow {
244
242
  calc?: Calc;
245
243
  /** Format-by-example; overrides the column format for calc rows and inline rows. */
246
244
  format?: string;
247
- /** false: `options.fitFormats` leaves this row's format as authored, even where a figure is cut at its width. */
248
- fitFormat?: false;
249
245
  polarity?: Direction;
250
246
  /**
251
247
  * Print this row as a line under its parent's value, inside the same cell,
@@ -634,15 +630,6 @@ export interface TableOptions extends BaseOptionsFor<'table'> {
634
630
  * scroll area starts at the first column. A heading wider than its columns starts at the first.
635
631
  */
636
632
  groupAlign?: 'left' | 'center' | 'right';
637
- /**
638
- * Shorten a number format until the widest figure fits its fixed track
639
- * (a column with an authored `width`): one decimal less at a time, then
640
- * the next unit up ($k to $M) at one decimal. A row format changes for the
641
- * whole row, a column format for the whole column, so one row or one
642
- * column reads in one format. Where the unit steps, a row's `unitAffix`
643
- * that named the old unit names the new one. Default false.
644
- */
645
- fitFormats?: boolean;
646
633
  /**
647
634
  * Value-track growth cap in SVG and React frame fill. Default 2.5.
648
635
  * false removes the cap. The label track takes the remaining width.
@@ -6,7 +6,6 @@ import { type PerTypeSizeOptions } from './RefusalBoundary.js';
6
6
  import { type RefusalProps } from './SizePlaceholder.js';
7
7
  import type { OptionKeyCheck } from '../core/schema/unknownKeys.js';
8
8
  import { type TableSort } from '../core/charts/table/view.js';
9
- import { type FormatFitChange } from '../core/charts/table/fitFormats.js';
10
9
  import type { LintWarning } from '../core/types/scene.js';
11
10
  import type { Id } from '../core/types/cell.js';
12
11
  import type { ResolvedRow, StickyLabels, TableData, TableOptions } from '../core/types/table.js';
@@ -53,6 +52,14 @@ export interface TableRowLabelLead {
53
52
  /** The glyph for one row; null or undefined draws none. */
54
53
  render: (row: ResolvedRow) => ReactNode;
55
54
  }
55
+ /** One format a table once shortened to fit a width: the type of the deprecated `onFormatsFit` callback. */
56
+ export interface FormatFitChange {
57
+ row?: Id;
58
+ column?: Id;
59
+ /** The example the figure printed through before; absent where it was derived and had no authored one. */
60
+ from?: string;
61
+ to: string;
62
+ }
56
63
  export type TableChartProps = OptionsInput<Omit<TableOptions, 'columnVisibility' | 'inlineVisibility' | 'size' | 'sort'>> & PerTypeSizeOptions & RefusalProps & RowsProps & {
57
64
  data: TableData;
58
65
  /** Applied to a wrapper around the table. */
@@ -185,12 +192,7 @@ export type TableChartProps = OptionsInput<Omit<TableOptions, 'columnVisibility'
185
192
  * their fold state and draw their fold marks as marks; hover stays.
186
193
  */
187
194
  interactions?: boolean;
188
- /**
189
- * Called with the formats `options.fitFormats` shortened to fit authored widths: each change names a row, a column or a
190
- * cell, the example it printed through before (`from`, absent where it was derived) and the example now (`to`). Called
191
- * when the list changes, and an empty list when a table that was fitted no longer is. The layout reports the same list
192
- * as the `table-formats-fitted` info warning.
193
- */
195
+ /** @deprecated Never called: a table no longer fits formats to a width. */
194
196
  onFormatsFit?: (changes: FormatFitChange[]) => void;
195
197
  /**
196
198
  * Called once when the table has no data row after filtering (no row but section headings and totals, or no row at all).
@@ -5,7 +5,7 @@
5
5
  * bundler that splits dynamic imports ships it as its own chunk.
6
6
  */
7
7
  import { type FocusEvent, type MouseEvent, type PointerEvent, type ReactElement, type ReactNode, type Dispatch, type SetStateAction } from 'react';
8
- import { type SmallValues } from '../../core/formatPrecision.js';
8
+ import type { SmallValues } from '../../core/formatPrecision.js';
9
9
  export { tableRecords } from './dataTable.js';
10
10
  export { labelCardGeometry } from './labelCard.js';
11
11
  export { keyboardOrder, keyboardReading, keyboardSelection, keyboardStep } from './keyboard.js';
@@ -171,7 +171,7 @@ export interface TableCardAnchor {
171
171
  * table. A cell whose card only repeats its printed value gets none.
172
172
  * The slot follows the reading direction; the card stays ltr.
173
173
  */
174
- export declare function TableCard({ record, width, theme, palette, locale, measure, direction, anchor, pointer, frame, occupied, forbidden, tableBounds, variant, table, columns, inlineVisibility, container, offset, styleNonce, smallValues }: {
174
+ export declare function TableCard({ record, width, theme, palette, locale, measure, direction, anchor, pointer, frame, occupied, forbidden, tableBounds, variant, table, columns, inlineVisibility, container, offset, styleNonce, formats }: {
175
175
  record: InteractionRecord;
176
176
  width: number;
177
177
  theme: Theme;
@@ -180,8 +180,10 @@ export declare function TableCard({ record, width, theme, palette, locale, measu
180
180
  direction: 'ltr' | 'rtl';
181
181
  /** The table's options.palette, for the tone text the card prints. */
182
182
  palette?: string;
183
- /** The table's options.smallValues: the card formats after layout. */
184
- smallValues?: SmallValues;
183
+ /** The table's options: the card formats after layout, in their smallValues mode and unit-only formats. */
184
+ formats?: {
185
+ smallValues?: SmallValues;
186
+ };
185
187
  anchor?: TableCardAnchor;
186
188
  frame?: {
187
189
  w: number;
@@ -114,9 +114,10 @@ export type LabelCardGeometry = Pick<Geometry, 'type' | 'size' | 'scene' | 'lege
114
114
  export declare function labelCardGeometry(layout: LabelCardLayout): LabelCardGeometry;
115
115
  /**
116
116
  * Format only the existing record facts; never infer comparisons from rounded
117
- * strings. The value row reads as the chart prints the value (the series
118
- * format and unit, `displayedValueText`), so a card beside a bar labelled
119
- * "213" says "$213k" and not "212.8"; `values` keeps the source number.
117
+ * strings. The value row, the field rows, the change and the share print the
118
+ * text the chart draws for each (their shown texts, `displayedValueText`), so
119
+ * a card beside a bar labelled "$213k" says "$213k" and not "212.8"; `values`
120
+ * keeps the source number.
120
121
  */
121
122
  export declare function labelCardContent(record: InteractionRecord, locale?: string, options?: LabelCardOptions): LabelCardContent;
122
123
  /**
package/dist/validate.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  parseThemeJson
3
- } from "./chunk-X46PSAJ7.js";
3
+ } from "./chunk-YJXIHVNK.js";
4
4
  import {
5
5
  registerCatalogue
6
- } from "./chunk-65U6ZBZZ.js";
6
+ } from "./chunk-VT6PDWUA.js";
7
7
 
8
8
 
9
9
 
@@ -151,7 +151,8 @@ import {
151
151
 
152
152
  import {
153
153
  linkAnnotateEngine
154
- } from "./chunk-RLH2CQCD.js";
154
+ } from "./chunk-4LCQO46F.js";
155
+
155
156
 
156
157
 
157
158
 
@@ -204,7 +205,7 @@ import {
204
205
  import {
205
206
  getChartDefinition,
206
207
  listCharts
207
- } from "./chunk-GNMB72V7.js";
208
+ } from "./chunk-YM4MVABU.js";
208
209
 
209
210
 
210
211
 
package/docs/manual.md CHANGED
@@ -294,11 +294,19 @@ Other data schemas refuse the field. For a combo rate, keep its separate percent
294
294
 
295
295
  ### Small values
296
296
 
297
- Without an authored format, each table column and each chart series gets one precision from its largest value. A table column also takes its magnitude from its largest value. Where that magnitude would print another nonzero value of the column as a bound (17,600 orders beside $3.8M revenue print `<0.1` in millions), each row of that column without a format of its own prints at its own scale: `3.6M`, `17,000`, `2.3`. Below 1, that value keeps two significant digits: 0.0341 gives three decimals, so 0.0123 and 0.0051 print 0.012 and 0.005. No automatic format prints more than four decimals. A nonzero value below the last shown digit prints its bound: `<0.001` at three decimals, `>−0.001` below zero, `<1` for whole numbers. A signed change label keeps its sign: `<+0.001` and `>−0.001`, so it reads as a change like its neighbours. Below 0.0001 it prints in scientific form, `1.2 × 10⁻⁹`. A true zero prints in the column's format, such as `0.0`. Set `options.smallValues: "zero"` for spreadsheet style (`0.000`) or `"scientific"` for a power of ten. `"p-value"` prints every value from 0 to 1 as APA 7 writes a p-value: three decimals without the leading zero (`.042`) and `<.001` below. An authored format prints as authored.
297
+ Without an authored format, Boardplot prints every number by one rule. Numbers that a reader compares form a set: the values of a chart, a series with its own unit, a table column, a table row with its own format, a measure of a DimSwitch table, a KPI figure. A sum joins its parts, and an absolute change joins its levels with a sign. A change in percent, a growth rate and a difference in percentage points form a signed change set, and each group of a change set prints two digits of its smallest value: `+9.1% · −4.0%`, `+6.9% p.a.`, `+36%`. The statistics of one kind form a set of their own: averages, quartiles, band bounds, the r² values of a chart, and its trend slopes, which take the scale words of the chart's values (`+11.7k per period`). Each set prints by these steps:
298
+
299
+ 1. Scale words (`k`, `M`, `B`, `T`) start at 10,000, in table cells and KPI figures at 100,000. A percent set and a set with a unit text (`$m`, `k visits`) print none. A currency sign or code and `%` are no unit text. A magnitude letter before a currency sign (`K$`, `M$`, `B€`) is a unit text. A German chart has no short word for thousand: with the default marks it prints `7.8 Mio. · 410,000 · 1,251`.
300
+ 2. Zero prints `0`.
301
+ 3. The largest value opens a group and prints three digits: 41,230 prints `41.2k`, and 413 prints `413`. A value of at least a tenth of the largest shares its scale word and decimals. Close values get more digits until they read apart.
302
+ 4. No value prints more decimals than the data carry: 62 and 57.5 print `62.0 · 57.5`, and 12 prints `12`.
303
+ 5. A smaller value joins the group when the group shows its two leading digits. Otherwise it opens a later group with two digits of its own: `$8.4M · $3.1M · $950k · $410k · $88k · $12k · $900`. A nonzero value never prints as 0 and never as a bound.
304
+
305
+ A table head names a scale word only when every nonzero cell of the column prints it. The ticks of a value axis keep one scale and one decimal count, and take the scale word that fits the largest tick. A value that joins no set when the chart prints it (a reference line) takes the group that shows its leading digits, or prints as a set of one value. No default reads the render target. Computed shares keep their own decimals. `options.smallValues` rounds a value that needs more than four decimals at the decimals of the set's first group, at most four, and prints its digits where it is nonzero there (`0.0003`), else a bound (`"bound"`: `<0.001`) or zero (`"zero"`: `0.000`), or prints it in scientific form (`"scientific"`: `1.2 × 10⁻⁶`). `"p-value"` prints every value from 0 to 1 as APA 7 writes a p-value: three decimals without the leading zero (`.042`) and `<.001` below. An authored format prints as authored.
298
306
 
299
307
  A `k`, `M` or `B` after the digits scales the value: `"$1.2M"` prints 2,456,000 as `$2.5M`. A spaced magnitude beside a currency (`"$1.2 k"`) also scales. A scale inside a currency affix (`"USDm 1.2"`, `"1.2 €m"`) holds its divisor. Without a currency, spaced letters remain units: `"12 m/s"` and `"50 B"` print the value as it is. The words `mn`, `bn`, `Mio.`, `Mrd.`, `thousand`, `million` and `billion` scale with or without a space.
300
308
 
301
- - A unit-only format (`"$M"`, `"€bn"`, `"%"`, `"x"`) picks precision from the field's data. A computed field whose values do not exist yet keeps the stand-in precision.
309
+ - A unit-only format (`"$M"`, `"€bn"`, `"%"`, `"x"`) states the prefix, the suffix and the scale word. The default rule fills the decimals from the field's data, and the scale words where the format names none: `"$M"` prints 15,060,000 and 14,800,000 as `$15.06M` and `$14.80M`. A computed field whose values do not exist yet keeps the stand-in precision.
302
310
  - Spreadsheet number codes translate to examples with warning `format-spreadsheet-code`. Percent values stay percent points: 12.5 prints `12.5%`.
303
311
  - Direction glyphs such as ▲/▼ and ↑/↓ at the start or end of the example print the sign by value and disappear on zero. A glyph inside the prefix or unit stays literal text. `±` means a plus on positives and a minus on negatives. A trailing minus (`"1,234-"`) prints only on negatives.
304
312
  - `"1st"` prints English ordinal suffixes, and `"1.2E+06"` prints scientific notation.
@@ -312,15 +320,15 @@ A plain example fixes decimals: `"$1.2M"` prints 4,270,000 as `$4.3M`. With no d
312
320
  | 4,270,000 | $4.27M | $4.3M |
313
321
  | 430,000 | $0.430M | $0.4M |
314
322
 
315
- Trailing zeros stay. The value rolls up at 1000: 999,600 prints `$1.00M`, and 999,960,000 prints `$1.00B`. A scale word holds the authored scale for a value far below it. Axis ticks keep the example's style and take their digits from their spacing: `$10M`, not `$10.0M`. Write every `@` in one run. A split run such as `"@@.@%"` is refused with the fix `"@@@%"`. More than 15 figures are refused. A digit anywhere makes an ordinary example, where `@` stays literal text.
323
+ Trailing zeros stay. The scale word stays as written for every value: 999,600 prints `$1.00M`, and 999,960,000 prints `$1,000M`. Totals, subtotals and calculated rows print in the example too. Where the example prints a nonzero value as its zero (4 under `"$1.2M"` prints `$0.0M`), or prints different values of one series, table row or table column as one text, the chart warns `format-hides-values`. The warning names the format and carries a finer example of the same style that shows every value, checked by drawing the chart with it. Axis ticks and statistics print as before. Ticks keep the example's style and take their digits from their spacing: `$10M`, not `$10.0M`. A mean, median, spread, band bound or rate takes up to one decimal more than the example where it needs one: a mean of 16/3 prints `5.333` under `"0.00"`. Write every `@` in one run. A split run such as `"@@.@%"` is refused with the fix `"@@@%"`. More than 15 figures are refused. A digit anywhere makes an ordinary example, where `@` stays literal text.
316
324
 
317
325
  An example with one dot before three digits, such as `"1.234"`, can be a thousands group or three decimals. The chart's numbers decide. Where every number is below 1000 and one has a fraction, it means three decimals: 0.512 prints `0.512`. Otherwise it is a group: 1,200 prints `1,200`, and where a small number loses its fraction beside large ones, the warning `format-reads-as-group` names it. `"0.000"` always means three decimals, and `"1,234"` always means a group.
318
326
 
319
327
  ### Shares that add up
320
328
 
321
- An authored `options.format` fixes its decimals, including trailing zeroes. A percent example such as `1.0%` also sets the decimals of the computed shares on a 100 % bar or column and on a pie. On a pie it formats the slice values only when they are percents (a `%` unit, percent cells, or values that add to 100). For counts or money it warns `percent-format-on-values` and the slice values print in the automatic format. Series formats and cell formats override it. A mekko column total takes more decimals only where the format would print a nonzero total as 0. Without an authored format, precision follows the data. On a percent mekko, a percent example formats shares; absolute column totals keep a number format. Their unit comes from `series[].unit` when every data series declares the same unit. `options.unit` names the shares and never labels those absolute totals.
329
+ An authored `options.format` fixes its decimals, including trailing zeroes. A percent example such as `1.0%` also sets the decimals of the computed shares on a 100 % bar or column and on a pie. On a pie it formats the slice values only when they are percents (a `%` unit, percent cells, or values that add to 100). For counts or money it warns `percent-format-on-values` and the slice values print in the automatic format. Series formats and cell formats override it. A mekko column total prints in the format's decimals, and a nonzero total that prints as 0 warns `format-hides-values`. Without an authored format, the values print by the default rule. On a percent mekko, a percent example formats shares; absolute column totals keep a number format. Their unit comes from `series[].unit` when every data series declares the same unit. `options.unit` names the shares and never labels those absolute totals.
322
330
 
323
- Rounded one by one, the shares of a whole can print a sum such as 100.6 %. `options.rounding` applies on bar, bartable, column, combo, line, mekko and pie. Bar, column and combo stacks, a bartable cascade and a stacked100 area default to `"sum-consistent"`. Mekko and pie default to `"nearest"`, and a pie warns `share-rounding-drift` when its printed shares miss 100 %. Under `"sum-consistent"` a chart prints every share of a whole at the finest precision one of them needs and moves the fewest shares one step, those that rounding moved furthest, until the printed shares add up to 100 %; no share moves a whole step from its value. The reading lists each moved share under `rounding` with its value, what it prints on its own and what it prints now. A bar, bartable, column, combo or line chart with a moved share also adds one method note to its notes list, which prints under the chart only where `notes.show` lists `"method"`. On a column or bar stack with `sharesOfOneWhole`, the same note says when the authored parts miss 100 and each share is taken of the stack total. The allocation uses the largest-remainder rule. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. Use `options.format: "1.0%"` for one decimal when whole-percent adjustments are too coarse. Other types refuse the option.
331
+ Rounded one by one, the shares of a whole can print a sum such as 100.6 %. `options.rounding` applies on bar, bartable, column, combo, line, mekko and pie. Every chart defaults to `"nearest"`: each share rounds on its own. A pie warns `share-rounding-drift` when its printed shares miss 100 %. Set `"sum-consistent"` for shares that add up to 100 %. Under `"sum-consistent"` a chart prints every share of a whole at the finest precision one of them needs and moves the fewest shares one step, those that rounding moved furthest, until the printed shares add up to 100 %; no share moves a whole step from its value. The reading lists each moved share under `rounding` with its value, what it prints on its own and what it prints now. A bar, bartable, column, combo or line chart with a moved share also adds one method note to its notes list, which prints under the chart only where `notes.show` lists `"method"`. On a column or bar stack with `sharesOfOneWhole`, the same note says when the authored parts miss 100 and each share is taken of the stack total. The allocation uses the largest-remainder rule. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. Use `options.format: "1.0%"` for one decimal when whole-percent adjustments are too coarse. Other types refuse the option.
324
332
 
325
333
  ### Category order and topN
326
334
 
@@ -354,13 +362,13 @@ SVG `id` attributes and their references use a hash of the drawing, locale and r
354
362
 
355
363
  ### Gantt and grid formats
356
364
 
357
- Gantt and ordinary grid compositions have no numeric value labels of their own. Metric stacks set mark precision with panel `decimals` and `divisor`. A chart-level `format` is accepted, ignored and warns. Set each numeric grid panel's `options.format` instead. Gantt uses calendar date options.
365
+ Gantt and ordinary grid compositions have no numeric value labels of their own. A metric stack panel prints by the default rule: a sum as one set with its parts, a rate as a percent set. A panel that sets `divisor` or `decimals` prints as in earlier versions: whole numbers for a sum and one decimal for a rate, or the panel's `decimals`, without scale words. A chart-level `format` is accepted, ignored and warns. Set each numeric grid panel's `options.format` instead. Gantt uses calendar date options.
358
366
 
359
367
  ### Metric stack
360
368
 
361
369
  Use `grid` with `options.stack: {}` for two to five measures over the same cohorts or periods. Panels follow the data array from top to bottom. Each panel starts at zero on its own scale. One category axis and an optional period row sit below all panels. See [the metric stack section in the grid reference](reference/grid.md#metric-stack).
362
370
 
363
- Store counts once in `data.measures`. Each panel names either a sum or a numerator and denominator. `readout: "change"` compares `data.windows.base` and `compare`: whole-percent change of average counts per category, or percentage-point change of weighted rates rounded to one decimal. `readout: { "base": "measure-id" }` gives a weighted mature step rate and the remaining-per-100 chain. The engine computes these figures from the same counts as the marks. `reading.metricStack.readouts[]` gives their inputs and category windows. Each readout has a `method` and `grain`. Count changes use `average-change`; rate changes use `rounded-rate-change`; step rates use `weighted-rate`. Grain is day, week, month, quarter, year or category. It comes from `data.windows.grain` or the category ids; unrecognised ids use category.
371
+ Store counts once in `data.measures`. Each panel names either a sum or a numerator and denominator. `readout: "change"` compares `data.windows.base` and `compare`: the percent change of average counts per category, or the percentage-point change of weighted rates. `readout: { "base": "measure-id" }` gives a weighted mature step rate and the remaining-per-100 chain. A panel that sets neither `divisor` nor `decimals` prints its readout by the default number rule, from the unrounded rates: a change prints two digits (`−2.7%`, `+1.4pp`), and the step rates and chain ends of all such panels in a stack form one percent set (`4.75%`, `100 → 4.75`). A panel that sets one of them prints a count change as a whole percent (`−3%`), a rate change as the difference of the rates rounded to one decimal (`+1.3pp`), and step rates and chain ends at one decimal (`4.7%`, `100 → 4.7`). The engine computes these figures from the same counts as the marks. `reading.metricStack.readouts[]` gives their inputs and category windows. Each readout has a `method` and `grain`. Count changes use `average-change`; rate changes use `rounded-rate-change`; step rates use `weighted-rate`. Grain is day, week, month, quarter, year or category. It comes from `data.windows.grain` or the category ids; unrecognised ids use category.
364
372
 
365
373
  Mark a running category `partial: true`. Declare unavailable outcome panels in `data.states.partial.panels`. Declare the maturing range and its affected panels in `data.states.maturing`. The grid draws one continuous band across those panels. Provisional bars use light fills and dashed outlines. Provisional lines use grey dashes and hollow points. Partial points never connect. Dashes denote projected or provisional data. One panel may set `emphasis: true`.
366
374
 
@@ -119,9 +119,9 @@ Table rows with number columns and stacked bars. One panel when the rows compare
119
119
  | 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. |
120
120
  | cascade | object | | | Settings of variant 'cascade'; refused with variant 'panels'. |
121
121
  | 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. |
122
- | cascade.share | boolean | | | Computed share column beside each panel; default true. rounding defaults to 'sum-consistent' here, so each adds up to 100%. |
122
+ | cascade.share | boolean | | | Computed share column beside each panel; default true. Each share rounds on its own; rounding 'sum-consistent' makes each column add up to 100%. |
123
123
  | cascade.growth | object | | | Growth column after the last panel. |
124
- | cascade.growth.measure | string | `'cagr'`, `'share-change'` | | 'cagr': each row's CAGR, first panel to last, in %. 'share-change': last share minus first, in pp. |
124
+ | cascade.growth.measure | string | `'cagr'`, `'share-change'` | | 'cagr': each row's CAGR, first panel to last, in %. 'share-change': last share minus first, in pp, from the received shares; the column prints two digits in every group of its changes (−7.8 · −0.43). |
125
125
  | cascade.growth.years | number | | | Years from first to last panel for 'cagr'; default read from the panel labels (2019, FY24). 'share-change' reads no years and warns option-ignored. |
126
126
  | cascade.growth.label | string | | | Column head; default from the panel labels. |
127
127
  | sharedScale | boolean | | | false: each panel its own scale. true: one scale, panel width follows its longest bar; weights refused. Default false, true under cascade. |
@@ -53,7 +53,7 @@ Cohorts by periods-since-start: counts in, every retention rate derived, weighte
53
53
 
54
54
  | Path | Type | Values | Default | Meaning |
55
55
  |---|---|---|---|---|
56
- | format | string | | | Rate format in percentage units, such as '1.0%' or '1.00' for two decimals without a sign on exhibit tables. Default: a decimal below 10%, whole percent otherwise on the heatmap. Exhibit tables share the needed decimal precision. The M0 anchor is neutral and the colour scale stays fixed at 0–100%. |
56
+ | format | string | | | Rate format in percentage units, such as '1.0%' or '1.00' for two decimals without a sign on exhibit tables. Without a format the rates of the chart are one percent set under the default rule, and the heatmap keeps the set's decimals. The M0 anchor is neutral and the colour scale stays fixed at 0–100%. |
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` | Heatmap only. 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. |
@@ -118,7 +118,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
118
118
  | 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%. |
119
119
  | seriesLabels.cagr.from | string | | | First category of the span; default the first category. |
120
120
  | seriesLabels.cagr.to | string | | | Last category of the span; default the last category. |
121
- | seriesLabels.cagr.format | string | | | Percent format-by-example for the rates, such as +0.00% for two decimals; default one decimal. |
121
+ | seriesLabels.cagr.format | string | | | Percent format-by-example for the rates, such as +0.00% for two decimals; default: the rates are one change set and print two digits. |
122
122
  | shareLabels | object | | | Where and how stacked segment labels print their share of the column: '30 (26.3%)' in the last year only. Adds the share to labels.segment in the columns named by only and drops it from the others. Stacked and stacked100 variants; a grouped chart has no shares and warns. |
123
123
  | shareLabels.only | array | | | Categories whose segment labels print value and share, such as the last year only; the other columns print the value alone. Default every column. |
124
124
  | shareLabels.format | string | | | Percent format-by-example for the shares, such as 26.3% for one decimal; default whole percent, one decimal under 1%. |
@@ -199,7 +199,6 @@ A KPI table: measures by one hierarchical dimension by period, switchable betwee
199
199
  | sortIndicator | string | `'all'`, `'sorted'` | | Sortable headers with a chevron. 'all' (the default) draws one on every sortable header; 'sorted' draws it on the sorted one alone and keeps the others' reserve, so no track moves. |
200
200
  | levelOffset | integer | | | Shift body rows down the ladder. Default 0. A board whose top rows are groups rather than KPI lines reads one rung too heavy: 1 steps them down in size, weight, air, ground, indent and label ink, -1 steps them up. The rungs stay floored at the top and at the deepest step. |
201
201
  | cellPadX | number | | | Horizontal cell padding in px. Default 12; only when it cannot fit, use 5 for 20–24 columns or 3 for 25 or more. |
202
- | fitFormats | boolean | | | Fit figures to authored widths. Remove decimals, then use the next unit up. |
203
202
  | maxGrowth | number \| false | `false` (or another value of its type) | `2.5` | Value-track growth cap; default 2.5, false removes the cap. Applies to SVG and React frame fill; the label track takes the remaining width. Also caps React container fit growth. |
204
203
  | labelIndent | object | | | Tree indent from row edge. Absent: cell air without marks; cell air plus 24 with outlineMarks: true or interactive fold buttons. Then 16 per rung. |
205
204
  | labelIndent.base | number | | | Level-0 start from row edge, padding included. |
@@ -358,7 +357,7 @@ Email no spend: no Paid media group
358
357
 
359
358
  `depth` opens the row tree level by level, like the outline buttons 1, 2 and 3 of a spreadsheet. Every row that can fold has an outline level, and depth d shows the rows of level d or less. Without a statement, the levels are the member levels, with the same meaning in both variants. Depth 1 shows the measures of the Total only; by-member also shows the top-level members as folded rows. Depth 2 also shows every measure of the top-level members. Depth 3 also shows every measure of their children. In general, depth d shows the measures of the Total and of d − 1 member levels; by-member also shows the next member level as folded rows. The maximum depth is the number of member levels plus one, so 3 for a dimension with two levels. A statement adds levels: see [Depth with a statement](#statements-subtotals-results-and-drivers). Section rows, group label rows, split rows and change lines take no level.
360
359
 
361
- On a fixed height, such as a slide or a print canvas, a table that misses the height at its `depth` draws one fold shallower, down to depth 1. By-member then also folds the Total. The table keeps the deepest fold that fits and warns with `dimswitch-depth-folded`, whose fix sets `options.depth` and, where the Total folded, adds its row to `expansion.collapsed`. An open height grows to its rows and never folds. A folded table sets the decimals of each change column from the rows it draws, so a hidden row with a small change does not keep a decimal on the figures of the rows that show. Where depth 1 still misses, the size refusal names the least height the folded table needs.
360
+ On a fixed height, such as a slide or a print canvas, a table that misses the height at its `depth` draws one fold shallower, down to depth 1. By-member then also folds the Total. The table keeps the deepest fold that fits and warns with `dimswitch-depth-folded`, whose fix sets `options.depth` and, where the Total folded, adds its row to `expansion.collapsed`. An open height grows to its rows and never folds. A folded table prints each figure with the text of the open table: its decimals come from every row, also the rows the fold hides. Where depth 1 still misses, the size refusal names the least height the folded table needs.
362
361
 
363
362
  These are the row counts of the worked example. They include section rows and group label rows, not change lines.
364
363
 
@@ -829,7 +828,7 @@ An optional period with `kind: "plan"` adds one `pl` comparison column: label, R
829
828
 
830
829
  `widths` fixes the track widths in px: `label` is the cap of the whole label column, indent and affix included (a longer label is cut; absent, the label text adds up to 320 px to the column, with the indent and the affix on top, and a column made wider by other content lets labels use the room), `range` the Range column (110), `change` each vs prior or vs plan column (92) and `period` each period column (94). Widen `range` and `change` when their `subLabel` holds dates. Render the table at the width the page shows it: at a narrow width a long unit can cut the KPI label.
831
830
 
832
- `dimswitch` takes the `table` options except `topN`. It always draws the steering table. It sets these defaults, and an option that you set wins: `stickyLabels: 3` (label, Range and vs prior pinned), or `4` when plan is present, `rowExtent: "frame"`, `mountCollapsed: false` (closed rows stay out of the DOM), `fitFormats: true` and `labelIndent: { "base": 25, "step": 17 }`. `options.format` has no effect and warns `format-unused`: set `measures[].format`.
831
+ `dimswitch` takes the `table` options except `topN`. It always draws the steering table. It sets these defaults, and an option that you set wins: `stickyLabels: 3` (label, Range and vs prior pinned), or `4` when plan is present, `rowExtent: "frame"`, `mountCollapsed: false` (closed rows stay out of the DOM) and `labelIndent: { "base": 25, "step": 17 }`. `options.format` has no effect and warns `format-unused`: set `measures[].format`.
833
832
 
834
833
  The report-sheet look comes from `theme.overrides.table`. `tones: "fill"` paints judged cells with `grounds` (`good`, `goodStrong`, `warn`, `bad`) and keeps the figures in the text ink. `rows: { "lineHeight": 1.44, "pad": 3 }` prints every rung at one size. `weights` sets the label weights of member rows and measure rows. `mark: "boxed"` draws a framed open and close mark. `headRule: "ink"` and `blockRule: "rule"` set the rules under the heads and around an open block. `head: { "case": "asis" }` keeps period heads as written (`14 Sep`) instead of capitals. `bar` sets the size bar colours, `ofWhich: "ink"` prints split rows in the text ink instead of the muted ink, and `endRule: "none"` drops the right edge rule inside a host card. The worked example uses this look; the fixture `sheet` and [Theme](theme.md) show the other tokens.
835
834
 
@@ -399,7 +399,7 @@ The CLI prints every match in one response through `boardplot fixtures --type <t
399
399
  | table-frame-open-end | table.steering | example | Rows that end on the card edge, with no end hairline and a light close |
400
400
  | steering-hover-history | table.steering | example | A year-to-date block whose hover card draws the fiscal years the table hides |
401
401
  | group-span-row-spacer | table.hierarchy | example | Block headings over their whole span and a gap before the new year |
402
- | fit-formats-narrow-tracks | table.steering | example | Weekly revenue drops a decimal to fit 44 px tracks, the other rows keep their units |
402
+ | narrow-tracks-widen | table.steering | example | Weekly revenue keeps its written format, and its 44 px tracks widen to hold it |
403
403
  | outline-marks-off | table.hierarchy | example | A region tree without outline marks, its head air from the theme |
404
404
  | max-growth-capped | table.hierarchy | torture | A channel table whose columns grow at most 1.4 times when it fills a card |
405
405
  | house-rule-colour | table.hierarchy | example | Head, total and close rules in the theme rule colour while the axis ink stays grey |
@@ -111,7 +111,7 @@ Facets, variance tiers and metric stacks with shared categories and computed rea
111
111
  | panels[].readout.base ( branch 3) | string | yes | Base measure for the remaining-per-100 chain. |
112
112
  | panels[].emphasis ( branch 3) | boolean | | Use the theme accent. At most one panel may be emphasised. |
113
113
  | panels[].divisor ( branch 3) | number | | Display divisor for sum marks and their change span, for example 1000. The headline percent is unitless. |
114
- | panels[].decimals ( branch 3) | integer | | Decimal places of the marks and the change span. Default 0 for counts and 1 for rates. |
114
+ | panels[].decimals ( branch 3) | integer | | Decimal places of the marks and the change span. A panel with divisor and without decimals prints 0 for counts and 1 for rates; a panel with neither prints by the default number rule. |
115
115
  | states ( branch 3) | object | | Category states declared once, with explicit panel scopes. |
116
116
  | states.maturing ( branch 3) | object | | Right-censored categories and their panel scope. One continuous band. |
117
117
  | states.maturing.from ( branch 3) | string | yes | First maturing category, inclusive. |
@@ -155,7 +155,7 @@ Facets, variance tiers and metric stacks with shared categories and computed rea
155
155
  | gutters.columns | number \| array | | | Horizontal spacing between column tracks in layout pixels. |
156
156
  | anchors | object | | | Opt-in shared plot edges, baselines, and category columns by row, column, or all panels. |
157
157
  | anchors.plotEdges | string | `'row'`, `'column'`, `'all'` | | Align panel plot left and right edges within column or all groups. row is accepted but ignored: side-by-side plots do not share x edges. |
158
- | anchors.baselines | string | `'row'`, `'column'`, `'all'` | | Scope for aligning panel numeric baselines vertically. |
158
+ | anchors.baselines | string | `'row'`, `'column'`, `'all'` | | Align numeric baselines between panels that cover the same rows. all aligns as row does. column is accepted and aligns nothing: stacked plots do not share a baseline. |
159
159
  | anchors.categories | string | `'row'`, `'column'`, `'all'` | | column and all align plot x edges and category ticks with authored column centers. row is accepted but ignored: side-by-side plots do not share x edges. |
160
160
  | alignmentRules | array | | | Authored hairline guides bound to a panel plot edge, baseline, or category tick. |
161
161
  | alignmentRules[].id | string | | | Unique guide identifier within this grid. |
@@ -190,15 +190,21 @@ Common combinations are recipes, not chart types. Stacked revenue over a ΔPY% v
190
190
 
191
191
  Set `stack: {}` to draw two to five panels in top-down order. Shared source counts produce both the marks and the left readouts. The optional period row, partial states, maturing scope and comparison windows belong to the grid. Each panel starts at zero on an independent scale.
192
192
 
193
- A sum uses one or more source measures; a multi-measure column is stacked. A rate divides the summed numerator by its denominator and multiplies by 100. `readout: "change"` gives whole-percent change of averages per category, or the difference of weighted rates after rounding each to one decimal. `readout: { base: "source-id" }` gives a weighted mature step rate and a remaining-per-100 chain. The table gives the formulas.
193
+ A sum uses one or more source measures; a multi-measure column is stacked. A rate divides the summed numerator by its denominator and multiplies by 100. `readout: "change"` gives the percent change of averages per category, or the percentage-point difference of two weighted rates. `readout: { base: "source-id" }` gives a weighted mature step rate and a remaining-per-100 chain. The first table gives the formulas. The second table gives how a panel prints them: a panel that sets neither `divisor` nor `decimals` prints by the default number rule, and a panel that sets one of them prints as the table says.
194
194
 
195
195
  | Readout | Headline | Span |
196
196
  |---|---|---|
197
- | `change`, sum measure | `(compare mean per category / base mean per category - 1) × 100`, rounded to whole percent | Base mean → compare mean, divided by the panel `divisor` and rounded to the panel `decimals` (whole counts by default), as the column labels print |
198
- | `change`, rate measure | Compare rate minus base rate, after each weighted rate is rounded to one decimal; rounded to one decimal pp | Base rate → compare rate, each rounded once from the unrounded weighted rate to the panel `decimals` (one by default) |
199
- | `{ "base": "measure-id" }`, rate measure | `100 × sum(numerator) / sum(denominator)` over mature categories, rounded to one decimal percent | `100 × sum(denominator) / sum(base)` → `100 × sum(numerator) / sum(base)` over the same categories |
197
+ | `change`, sum measure | `(compare mean per category / base mean per category - 1) × 100` | Base mean → compare mean, divided by the panel `divisor` |
198
+ | `change`, rate measure | Compare rate minus base rate, in percentage points | Base rate → compare rate |
199
+ | `{ "base": "measure-id" }`, rate measure | `100 × sum(numerator) / sum(denominator)` over mature categories | `100 × sum(denominator) / sum(base)` → `100 × sum(numerator) / sum(base)` over the same categories |
200
200
 
201
- All sums use the source counts that draw the marks. Rates are weighted by volume, never the mean of the displayed category rates. The remaining-per-100 span uses one decimal, and a starting 100 prints as 100. A zero denominator or a missing input gives `n/a`, not zero.
201
+ | Readout | Panel without `divisor` and `decimals` | Panel with `divisor` or `decimals` |
202
+ |---|---|---|
203
+ | `change`, sum measure | The headline is a change in percent with two digits (`−2.7%`). The span prints the two means as a set of their own, with scale words where the column labels print them (`34.51k → 33.59k`). | The headline is rounded to a whole percent (`−3%`). The span is rounded to the panel `decimals`, whole counts by default, as the column labels print (`35 → 34` under `divisor: 1000`). |
204
+ | `change`, rate measure | The headline is the difference of the unrounded weighted rates, in percentage points with two digits (`+1.4pp`). The span prints the two unrounded rates by the default number rule (`2.27% → 3.62%`). | Each weighted rate is rounded to one decimal, and the headline is their difference at one decimal (`+1.3pp`). The span rounds each unrounded rate once to the panel `decimals`, one by default (`2.3% → 3.6%`). |
205
+ | `{ "base": "measure-id" }`, rate measure | The headline rates and the chain ends of every such panel in the stack form one percent set and print the unrounded rates (`4.75%`, `100 → 4.75`, `4.75 → 0.23`). | The headline and the chain ends are rounded to one decimal, whatever the panel `decimals` (`4.7%`, `100 → 4.7`, `4.7 → 0.2`). |
206
+
207
+ All sums use the source counts that draw the marks. Rates are weighted by volume, never the mean of the displayed category rates. The chain starts at 100, and 100 prints as `100`. A zero denominator or a missing input gives `n/a`, not zero.
202
208
 
203
209
  The stack is refused when a comparison window holds a partial or maturing category, when a partial category is in the maturing band, when the periods do not cover the categories once in order, or when a state scope skips a panel. A step chain is refused when its panels do not share one base measure and one state scope, or when a numerator exceeds its denominator.
204
210
 
@@ -69,7 +69,7 @@ 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
  | scale | string | `'continuous'`, `'discrete'` | `'continuous'` | Continuous color interpolation by default, or a discrete color ladder. |
72
- | variant | string | `'value'`, `'harvey'`, `'bubble'` | `'value'` | Value labels fit as a whole row, and an automatic number text loses a % sign the unit names, then takes fewer decimals, before a value is hidden; authored labels and valid pins retain precedence. Harvey glyphs suppress values and take ratings 0 to 4 only; any other value is refused. 'bubble': one circle per cell, colour = value, area = series sizes; values print where they fit. |
72
+ | variant | string | `'value'`, `'harvey'`, `'bubble'` | `'value'` | Value labels fit as a whole row and print the same text at every size: a value with no room is hidden, never shortened; authored labels and valid pins retain precedence. Harvey glyphs suppress values and take ratings 0 to 4 only; any other value is refused. 'bubble': one circle per cell, colour = value, area = series sizes; values print where they fit. |
73
73
  | cap | object | | | Where the continuous scale saturates, as table heat's cap: a value at or past it paints full strength, measured from zero. Without it the good/bad scale is symmetric, full at the largest \|value\|, and the magnitude ramp spans the data. The discrete ladder ignores it (cap-ignored), and harvey glyphs ignore it (option-ignored). |
74
74
  | cap.pct | number | | | Cap in points when every cell is a percent. Example: 20 saturates at ±20%. |
75
75
  | cap.abs | number | | | Cap in source units for other values. |
@@ -119,7 +119,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
119
119
  | Path | Type | Values | Default | Meaning |
120
120
  |---|---|---|---|---|
121
121
  | highlight | string \| array | | | Select drawn data series by ID. On one plain data line without a fan, category IDs instead emphasize those points: larger markers and values in focus ink while the line keeps its paint. Series IDs take precedence. References do not count as data series. Several data series, area, stacked and bump forms keep series-only highlighting. Unsupported IDs warn highlight-unknown-id and leave the chart unchanged. Explicit value-label suppression and authored marker shapes remain effective. |
122
- | rounding | string | `'nearest'`, `'sum-consistent'` | | stacked100-area defaults to sum-consistent rounding of complete computed wholes. Authored percentages and incomplete total100 bases keep their values. nearest rounds each computed share separately. Other line variants do not use this setting. |
122
+ | rounding | string | `'nearest'`, `'sum-consistent'` | | stacked100-area rounds each computed share separately by default. sum-consistent makes the shares of each complete computed whole total 100%. Authored percentages and incomplete total100 bases keep their values. Other line variants do not use this setting. |
123
123
  | trend | boolean \| object | | | One least-squares line per shown data series, using the shared scatter fit. Fits every non-null source value in the shown range, with at least 3 points; min-max sampling changes the drawn points, not the fit. Regular month, quarter and year dates fit on the calendar period index and keep their spacing; exact 7-day steps fit per week; other dates use elapsed UTC days and exact date spacing; other categories use their original positions. The dashed series-colour line covers only its fitted range and is clipped to the value axis. The legend prints the series name, signed slope per month, quarter, year, week, day or period, and r². The layout derived.trends receipt carries slope, intercept, r² and the fit moments. Plain line and area only; stacks and bump refuse trend-unsupported. Too few points warn trend-undefined. A window or zoom changes the fitted range. Default false. |
124
124
  | trend.label | string | | | Name of the fitted lines in the legend; default Linear trend. |
125
125
  | window | object | | | Display the last n periods and optionally sample extrema while preserving source calculations, ranks, uncertainty intervals and phase boundaries. A mean's Ø label names the periods it covers where the plot draws fewer, 'Ø 54.3 (Day 1–Day 20)'. |
@@ -171,7 +171,7 @@ A `cell` is a number, null or a value object; see [Value cell](options.md#value-
171
171
  | seriesLabels | string \| object | `'end'`, `'inline'`, `'key'`, `'none'` (or another value of its type) | | Where series names print; a name carries no value, except where two or more lines end within a line of each other at the last category: there each name takes its last value. On report, dashboard, slide and print, plain-line names use medium weight at the label role size, in a contrast-safe series colour. Values use regular weight. Crowded blocks use one line if two lines would move more than three label line heights from the endpoint. If one line cannot fit within that bound, a right-hand key lists names and end values from highest to lowest, with a reading disclosure. 'end' (default): a column just past the line ends, names only, short leaders; too wide for 18% of the width, shortLabel, then the key row. 'inline': on a clear stretch of each line; the last values still print. An authored 'end' or 'inline' that ends in the key row warns line-end-label-key. 'key': a key row above the plot. 'none': no names; two or more drawn series still get the key row (info series-labels-key) unless legend is set. A lone 'line' defaults to 'none'. { only } names the listed series and gives the rest no name and no value. |
172
172
  | seriesLabels.only | array | | | The series named at their line ends; the others get neither a name nor a value, so twelve cohort curves read under four names. |
173
173
  | pointLabelSide | string | `'shape'`, `'auto'` | | Preferred side for point values. 'shape' prefers left of the first finite point, above a strict local peak, below a strict local trough and right of the last finite point. Flat plateaus keep the existing preference. Default shape on one plain data line without a fan; reference series do not count. Other variants and several data series keep auto. The label solver can use a fallback to avoid collisions, and labelPlacements pins take precedence. 'auto' restores the previous candidate order and endpoint reserves. |
174
- | valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Point values: default last, inline and bump none, stacked100-area ends. Distinct end values that round to the same text gain up to two decimals as one label set; the reading uses that precision. Bump keeps the precision used to rank its values. Choices: 'none' (default under seriesLabels 'inline'), 'last' (default), 'ends' (first and last; stacked100-area default), 'extremes' (ends plus each series' low and high) or 'all'. A value sits on the side of its point away from other lines and never nearer another line than its own; one with no free seat goes to the note line, and missing labels warn label-hidden once per chart; reading.omissions names each label and its destination. Stacked values sit in their band. labels.point sets the content. When the author sets valueLabels and every non-null value in a series has a string label (ignoring label:false cells), valueLabels selects the values and each selected value uses its cell text. Otherwise a string cell label also selects its point, outside the valueLabels selection, even when labels.point is false. label:false removes a value label. bump defaults to 'none'; its values are the measure behind the ranks, so each carries the unit, and without a unit or format it warns bump-values-unnamed. A plain line on a linear scale that does not start at zero draws a break glyph at its lowest value, so the cut baseline stays visible. A tick prints there under 'all' and valueAxis.show false, and on a shown value axis only where that value falls on the tick grid or valueAxis.min sets it. valueAxis.includeZero true or valueAxis.min 0 starts at zero and removes the break glyph and its tick. Where the last value carries options.unit because no subtitle prints it, a shown value axis prints a sign or magnitude unit ($, k, m) on its ticks too; a word unit stays on the value. |
174
+ | valueLabels | string | `'none'`, `'last'`, `'ends'`, `'extremes'`, `'all'` | | Point values: default last, inline and bump none, stacked100-area ends. A value without a format prints its set's text; distinct end shares or values under a unit-only format that round to the same text gain up to two decimals as one label set; the reading uses that precision. Bump keeps the precision used to rank its values. Choices: 'none' (default under seriesLabels 'inline'), 'last' (default), 'ends' (first and last; stacked100-area default), 'extremes' (ends plus each series' low and high) or 'all'. A value sits on the side of its point away from other lines and never nearer another line than its own; one with no free seat goes to the note line, and missing labels warn label-hidden once per chart; reading.omissions names each label and its destination. Stacked values sit in their band. labels.point sets the content. When the author sets valueLabels and every non-null value in a series has a string label (ignoring label:false cells), valueLabels selects the values and each selected value uses its cell text. Otherwise a string cell label also selects its point, outside the valueLabels selection, even when labels.point is false. label:false removes a value label. bump defaults to 'none'; its values are the measure behind the ranks, so each carries the unit, and without a unit or format it warns bump-values-unnamed. A plain line on a linear scale that does not start at zero draws a break glyph at its lowest value, so the cut baseline stays visible. A tick prints there under 'all' and valueAxis.show false, and on a shown value axis only where that value falls on the tick grid or valueAxis.min sets it. valueAxis.includeZero true or valueAxis.min 0 starts at zero and removes the break glyph and its tick. Where the last value carries options.unit because no subtitle prints it, a shown value axis prints a sign or magnitude unit ($, k, m) on its ticks too; a word unit stays on the value. |
175
175
  | latestPoint | string \| object | `'ring'`, `'none'` (or another value of its type) | `'none'` | Ring the last observed point in the highlight colour, r 4.5 with a dot inside it: the newest cohort of a curves chart, the current period of a trend. 'ring' picks the primary series, the hero where emphasis names one and otherwise the first data series that is not a prior year, plan or forecast; { series } names one outright. Default 'none'. Line and area variants only: a stacked band's last point is the top of the stack, so stacked-area and stacked100-area refuse it. |
176
176
  | latestPoint.series | string | | | The series whose last observed point is ringed. |
177
177
  | latestPoint.marker | string | `'ring'` | `'ring'` | Marker shape; 'ring' is the only one and the default. |
@@ -174,13 +174,13 @@ These options are shared across chart types. Each type page names its exceptions
174
174
  | strings.knownPartsShares | string | | | Incomplete 100% stack note without total100; {categories} is replaced. |
175
175
  | strings.rebaseZero | string | | | Line or stacked-area series left out by rebase100 for a zero or negative base; {series} and {period} are replaced. |
176
176
  | strings.rebaseMissing | string | | | Line or stacked-area series left out by rebase100 for a missing base; {series} and {period} are replaced. |
177
- | format | string | | | Chart-level format-by-example, such as 1,234.5 or 1.2pp. A currency sign comes from here: '$1,234' prints $2,456. Its decimals are preserved; series and cell formats can override it. Without a format, precision follows the data. A magnitude after the number divides the raw value: k, thousand, Tsd., Tausend (10³); m, M, mn, mm, million(s), Mio., Million(en) (10⁶); b, B, bn, billion(s), Mrd., Milliarde(n), milliard(s) (10⁹); tn, trillion(s), Bio., Billionen (10¹²). The letters k, m, M, mm, b, B and T scale when glued to the number or spaced beside a currency ('$1.2 k'); '12 m/s' and '50 B' keep their unit. A scale inside a currency affix ('USDm 1.2', '1.2 €m') holds that divisor. A value of 1000 or more in a free scale rolls up and one that would print as 0 rolls down, in the example's spelling; a German or French chart prints its own words (Mrd., Bio.; Md, Bn). A unit alone ('$M', '€bn', '%', 'x') picks precision from the data. Spreadsheet number codes translate to examples with warning format-spreadsheet-code; percent values stay percent points. Direction glyphs (▲/▼, ↑/↓) at the start or end of the example carry a sign. A glyph inside the prefix or unit stays literal text. ± carries a sign. A trailing minus marks negatives, '1st' prints English ordinals, and '1.2E+06' prints scientific notation. With no digit, one run of 1–15 @ fixes significant figures: '$@@@M' prints 4,270,000 as $4.27M. A % example expects values in percent units: 3.53 prints 3.53%, a fraction 0.0353 prints 0.04%. A separator followed by exactly three digits after a nonzero integer part is a thousands mark: 1.000 groups thousands with a dot and prints decimals with a comma; write 0.000 for three decimals. |
177
+ | format | string | | | Chart-level format-by-example, such as 1,234.5 or 1.2pp. A currency sign comes from here: '$1,234' prints $2,456. Its decimals are preserved; series and cell formats can override it. Without a format, every number prints by the default rule: scale words from 10,000 (cells from 100,000), three digits of the largest value, no more decimals than the data carry. A magnitude after the number divides the raw value: k, thousand, Tsd., Tausend (10³); m, M, mn, mm, million(s), Mio., Million(en) (10⁶); b, B, bn, billion(s), Mrd., Milliarde(n), milliard(s) (10⁹); tn, trillion(s), Bio., Billionen (10¹²). The letters k, m, M, mm, b, B and T scale when glued to the number or spaced beside a currency ('$1.2 k'); '12 m/s' and '50 B' keep their unit. A scale inside a currency affix ('USDm 1.2', '1.2 €m') holds that divisor. The example's scale word and decimals hold for every value, totals included: '$1.2M' prints 4 as $0.0M and warns format-hides-values with a finer example. A German or French chart prints the scale in its own words (Mrd., Bio.; Md, Bn). Axis ticks take their digits from their spacing, and a statistic such as a mean takes up to one decimal more. A unit alone ('$M', '€bn', '%', 'x') states the prefix, the suffix and any scale word: the default number rule fills the decimals, and the scale words where the unit names none ('$M' prints 15,060,000 and 14,800,000 as $15.06M and $14.80M). A table column moves the unit into its head and picks the cell precision from the data. Spreadsheet number codes translate to examples with warning format-spreadsheet-code; percent values stay percent points. Direction glyphs (▲/▼, ↑/↓) at the start or end of the example carry a sign. A glyph inside the prefix or unit stays literal text. ± carries a sign. A trailing minus marks negatives, '1st' prints English ordinals, and '1.2E+06' prints scientific notation. With no digit, one run of 1–15 @ fixes significant figures: '$@@@M' prints 4,270,000 as $4.27M. A % example expects values in percent units: 3.53 prints 3.53%, a fraction 0.0353 prints 0.04%. A separator followed by exactly three digits after a nonzero integer part is a thousands mark: 1.000 groups thousands with a dot and prints decimals with a comma; write 0.000 for three decimals. |
178
178
  | detailFields | array | | | Label, format, unit and order of the cell details keys, the extra facts a value's hover card lists after it: [{ key: 'deals', label: 'Deals', format: '1,234' }]. Declared keys print first, in this order; a details key it does not declare prints after them, labelled with its key. Default: every key, labelled with itself. |
179
179
  | detailFields[].key | string | | | The details key in the cells. |
180
180
  | detailFields[].label | string | | | Label on the hover card; default the key. |
181
181
  | detailFields[].format | string | | | Format-by-example for number details of this key, such as 1,234 or 0.0%. |
182
182
  | detailFields[].unit | string | | | Unit joined to number details of this key as the marks join it, such as EUR. |
183
- | smallValues | string | `'bound'`, `'zero'`, `'scientific'`, `'p-value'` | | How an automatic number format prints a nonzero value below its last shown digit. Without a format, each table column and chart series takes one precision from its largest value: two significant digits below 1, at most 4 decimals. bound (default): the bound, <0.01 at two decimals, >−0.01 below zero, <1 for whole numbers; a signed change label keeps its sign, <+0.01; below 0.0001 a value prints in scientific form instead. zero: spreadsheet style, the format's own 0.00. scientific: two significant digits and a power of ten, 1.2 × 10⁻⁹. p-value: every value from 0 to 1 prints as APA 7 writes a p-value, three decimals without the leading zero, .042, and <.001 below; larger values keep the rule above. A format the author sets prints as set. |
183
+ | smallValues | string | `'bound'`, `'zero'`, `'scientific'`, `'p-value'` | | How the default rule prints a nonzero value that needs more than four decimals. Without the option the rule prints its own digits, never a bound. bound and zero round such a value at the decimals of the set's first group, at most four, and print its digits where it is nonzero there (0.0003), else the bound (bound: <0.001, >−0.001 below zero) or the set's zero (zero: 0.000). scientific: two significant digits and a power of ten, 1.2 × 10⁻⁶. p-value: every value from 0 to 1 prints as APA 7 writes a p-value, three decimals without the leading zero, .042, and <.001 below; larger values keep the rule. A format the author sets prints as set. |
184
184
  | palette | string | | | Named identity ramp from theme color.palettes; every chart family takes its data ink from it, while good, bad and highlight stay the theme colours. |
185
185
  | labelDensity | string | `'full'`, `'smart'`, `'minimal'` | | Label selection policy, default smart. full: every value label competes for a slot, and a segment value that does not fit its segment moves outside on a leader. smart: as full, but a stacked column or combo segment value prints inside its segment or not at all (where one is wider than its column, the stacked column values step down a size, to the floor; still too wide, none prints), and a segment value drops when the segment is shorter than the label height plus 4 px padding (the label width on a horizontal bar); mekko also drops segment values in columns narrower than 24 px. A labelPlacements pin keeps its label. minimal: keeps only the chart's essential labels (totals, endpoints, highlights). Collision suppression applies at every level. |
186
186
  | labels | false \| object | `false` (or another value of its type) | | Label visibility and content overrides; omission uses the selected chart policy. Unsupported chart types refuse this shared option. false turns optional labels off. An object maps a label kind (category, series, segment, point, total, grandTotal, insidePie, outsidePie, percentIndicator, restSeries, tick, axisTitle, valueLine, annotation, growth, activity, item; each chart reads its own, and a kind it does not read is refused) to true, false or content parts from absolute, percent, category and series. Another part is dropped with a warning; value draws as absolute. On a stacked column with one PY reference series, { growth: false } drops the growth arrows over the totals (↑ 6.1%) and keeps the PY ticks and their labels; { percentIndicator: false } drops the 100% marker of a 100% chart. On bar, box, column, combo, dot, line, Mekko, slope and variance, false keeps category names; { category: false } hides them. On bullet, butterfly, funnel, heatmap, pyramid and status, false keeps the row, column and stage names; on kpi it keeps the main number and the card name. Grid panels can leave category names to the grid. On a line, series false turns the series names off and point sets what each printed value shows, so { point: ['category', 'absolute'] } prints 08-16 44.7 at the point. On a stacked column or combo, { segment: ['absolute', 'percent'] } prints each segment value over its share of the stack; a stack with a negative or missing part prints the value alone and warns. restSeries sets the values of a stacked column, bar or area series whose colorRole is others: absent, they print everywhere except the dashboard target, where the hover card and the note line carry them; true prints them, false hides and notes them on every target. |
@@ -247,7 +247,7 @@ These options are shared across chart types. Each type page names its exceptions
247
247
  | focus.owner.colId | string | | | Source table column identity. |
248
248
  | hatchStrength | number | | | How strongly forecast, partial-period and no-data hatches draw, 0 to 100; 100 is the theme's recipe. Lower values fade the stripes toward their ground and, on a line or area forecast, spread them up to 2.5 times the theme's gap. The fade stops at a floor: where the hatch is the only cue (a forecast column or bar, a partial period, a no-data cell) the stripes keep 3:1 on their ground and their spacing; on a line or area forecast, where the dashed line, the divider and the key already mark the forecast, they keep 2:1. A status cell lays its stripes on its own tone: there 60 is the theme's recipe at 3:1, 100 deepens the stripes to 4.5:1 on the same ground, and lower values fade them only as far as the cell stays apart from a cell with no status. Default 60 on a line or area forecast and a status cell, 100 elsewhere. The key swatch draws the same hatch. |
249
249
  | colorblindSafe | boolean | | | Paint the semantic good/bad pair from theme.color.colorblind: signed bars and columns, variance bars, KPI deltas, chips and bands, waterfall and pvm steps, legend keys and signed labels, status cells, heatmap valence cells, table tones, grounds, bars and badges, and diverging choropleth or tilemap poles. A type without a good/bad pair draws the same with or without this option. Use palette for categorical colours. |
250
- | rounding | string | `'nearest'`, `'sum-consistent'` | | How computed shares print. nearest rounds each share separately. sum-consistent uses largest remainders to total 100%. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. reading.rounding lists changes. Use format: 1.0% for one decimal. Mekko cell, series and chart share formats set the precision. Bar, column and combo stacks default to sum-consistent for each complete stack; a column's shares keep the chart's one share precision or shareLabels.format. Incompatible precisions or more than 13 decimals warn and keep the requested formats without sum-consistent rounding. |
250
+ | rounding | string | `'nearest'`, `'sum-consistent'` | | How computed shares print. nearest rounds each share separately. sum-consistent uses largest remainders to total 100%. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. reading.rounding lists changes. Use format: 1.0% for one decimal. Mekko cell, series and chart share formats set the precision. By default every chart rounds each share on its own; under sum-consistent a column's shares keep the chart's one share precision or shareLabels.format. Incompatible precisions or more than 13 decimals warn and keep the requested formats without sum-consistent rounding. |
251
251
  | animate | boolean | | | Motion flag ignored with an option-ignored warning because charts emit static geometry. |
252
252
  | interactive | boolean | | | Emit data-bp-* semantics for dependency-free web interactivity; static output is unchanged by default. |
253
253
  | debug | boolean | | | Layout debug flag ignored with an option-ignored warning. |
@@ -207,7 +207,7 @@ Its reader state is available as a controlled prop, each with a `default…` and
207
207
 
208
208
  A table under `size="container"` with `fit="fill"` fills the width it is given: the row-label column keeps its natural width and the value columns share what is left, in proportion to their own, each up to 2.5 times its natural width. `maxGrowth` names another cap, and `maxGrowth={false}` lets the columns share the whole frame. An authored `columns[].width` never grows or shrinks under the container's fill: the spec's widths win over the container's. On a value or computed column the width is a floor: it widens to the widest figure the column prints, so no number is cut, and the SVG layout reports `table-column-widened`. Every other column keeps exactly the width you set, and a cut text cell is reported as `table-column-clipped`. The room a cap leaves stays to the right of the table, or goes to an unauthored last track under `lastTrackFlex`; under `rowExtent: 'frame'` the value tracks grow to the frame edge by `frameFill` (default `'values'`), and `frameFill: 'none'` leaves the room to an empty track, so the rows still reach the frame edge. The grid element is exactly as wide as the tracks it draws. A table wider than its frame is never squeezed into it; it scrolls. Unlike a chart, a table takes the width alone and reads its height from its own rows, so a card with no height of its own still fills.
209
209
 
210
- The scroller is the table's own, because the pinned columns are measured against it, and a host reaches it through props rather than the markup. `onScrollChange` receives `{ scrollLeft, scrollWidth, clientWidth, scrollTop, scrollHeight, clientHeight, gutterRight, gutterBottom }` on mount, on every scroll and when the container or the tracks change width, which is what a minimap of the column axis draws. `gutterRight` and `gutterBottom` are the px a vertical and a horizontal scrollbar take from the scroller's box (offset size minus client size, 0 for an overlay scrollbar), so an edge fade drawn by the host stays inside them. `handleRef` receives a `TableHandle`: `scrollState()` returns the same record, `scrollToColumn(columnId, behavior?)` scrolls so that column starts where the pinned columns end (jump chips for fiscal years or cohort years), and `scrollTo(left, behavior?)` scrolls to an offset. `onContentWidth` receives the width the figure needs to show every column without scrolling, its tracks, spacer tracks and margins, so a card that sizes itself to its table reads that number. `fillHeight` makes the figure a column as tall as its parent, with the scroller taking the height left and scrolling both ways; the host gives the parent a height, and `stickyLabels` keeps the head and the label column in place, which is what an expand dialog needs. `onRowSelect(rowId, { row, event, columnId })` is called when the reader picks a row: a click anywhere in it outside a link or a button, or Enter or Space on its focused cell. The keyboard reaches every cell: Tab enters the grid on one cell, the arrow keys, Home and End move between cells, and Enter or Space on a cell picks its row. `columnId` is the column of the clicked cell, or of the focused cell the key was pressed on, so a host can run one cell's action, a Remove in its own column, from that cell alone; it is undefined on the empty track `rowExtent: 'frame'` adds. A section heading takes none; a parent row the reader may fold folds on the same click when the host has not made it selectable; a selectable parent only selects on a click, and its fold mark folds it. `foldOn: 'row' | 'toggle'` overrides that default: `'row'` folds and selects on the row, by click and by Enter or Space alike, and `'toggle'` lets only the mark fold. `onFormatsFit(changes)` receives the formats `fitFormats` shortened, each as `{ row?, column?, from?, to }`. `isRowSelectable(row, { collapsed })` narrows the pick to the rows it answers true for; `collapsed` is true while the row is folded shut, so a host can tell an open parent from a folded one: the others take no click and no key for it, show no pointer and carry no `data-bp-selectable`, and a parent among them still folds. Absent, every row but a section heading is selectable, and each selectable body row shows a pointer. `rowLabelLead={{ width, render }}` draws a glyph before each row label, a channel mark for one: `render(row)` returns the glyph or nothing, and a measured label track grows by `width`. With `stickyLabels`, the hairline to the right of the last pinned column shows only while the grid is scrolled sideways. Every body row carries `data-row-id`, the row id from the data (in `dimswitch`, the id that `dimswitchRowId(structure, memberId, measureId)` builds; it names the structure, so the same line has a different id by KPI and by member). It is public API: it stays the same across data refreshes, re-sorts, folds and depth changes, so a host can anchor a comment, a test or an analytics event on it. `interactions={false}` stops clicks and keys from selecting, sorting and folding, for a host mode such as annotation where the host handles the click; the rows keep their fold state and draw their fold marks as marks, and hover stays.
210
+ The scroller is the table's own, because the pinned columns are measured against it, and a host reaches it through props rather than the markup. `onScrollChange` receives `{ scrollLeft, scrollWidth, clientWidth, scrollTop, scrollHeight, clientHeight, gutterRight, gutterBottom }` on mount, on every scroll and when the container or the tracks change width, which is what a minimap of the column axis draws. `gutterRight` and `gutterBottom` are the px a vertical and a horizontal scrollbar take from the scroller's box (offset size minus client size, 0 for an overlay scrollbar), so an edge fade drawn by the host stays inside them. `handleRef` receives a `TableHandle`: `scrollState()` returns the same record, `scrollToColumn(columnId, behavior?)` scrolls so that column starts where the pinned columns end (jump chips for fiscal years or cohort years), and `scrollTo(left, behavior?)` scrolls to an offset. `onContentWidth` receives the width the figure needs to show every column without scrolling, its tracks, spacer tracks and margins, so a card that sizes itself to its table reads that number. `fillHeight` makes the figure a column as tall as its parent, with the scroller taking the height left and scrolling both ways; the host gives the parent a height, and `stickyLabels` keeps the head and the label column in place, which is what an expand dialog needs. `onRowSelect(rowId, { row, event, columnId })` is called when the reader picks a row: a click anywhere in it outside a link or a button, or Enter or Space on its focused cell. The keyboard reaches every cell: Tab enters the grid on one cell, the arrow keys, Home and End move between cells, and Enter or Space on a cell picks its row. `columnId` is the column of the clicked cell, or of the focused cell the key was pressed on, so a host can run one cell's action, a Remove in its own column, from that cell alone; it is undefined on the empty track `rowExtent: 'frame'` adds. A section heading takes none; a parent row the reader may fold folds on the same click when the host has not made it selectable; a selectable parent only selects on a click, and its fold mark folds it. `foldOn: 'row' | 'toggle'` overrides that default: `'row'` folds and selects on the row, by click and by Enter or Space alike, and `'toggle'` lets only the mark fold. `onFormatsFit` is deprecated and never called, because a table no longer fits formats to a width. `isRowSelectable(row, { collapsed })` narrows the pick to the rows it answers true for; `collapsed` is true while the row is folded shut, so a host can tell an open parent from a folded one: the others take no click and no key for it, show no pointer and carry no `data-bp-selectable`, and a parent among them still folds. Absent, every row but a section heading is selectable, and each selectable body row shows a pointer. `rowLabelLead={{ width, render }}` draws a glyph before each row label, a channel mark for one: `render(row)` returns the glyph or nothing, and a measured label track grows by `width`. With `stickyLabels`, the hairline to the right of the last pinned column shows only while the grid is scrolled sideways. Every body row carries `data-row-id`, the row id from the data (in `dimswitch`, the id that `dimswitchRowId(structure, memberId, measureId)` builds; it names the structure, so the same line has a different id by KPI and by member). It is public API: it stays the same across data refreshes, re-sorts, folds and depth changes, so a host can anchor a comment, a test or an analytics event on it. `interactions={false}` stops clicks and keys from selecting, sorting and folding, for a host mode such as annotation where the host handles the click; the rows keep their fold state and draw their fold marks as marks, and hover stays.
211
211
 
212
212
  The table's hover card is its one floating layer, and it renders through a portal at the end of `document.body`, positioned beside its cell in page coordinates, so a glass (`backdrop-filter`), `transform` or `overflow: hidden` ancestor of the table neither traps nor cuts it. `portalContainer` names another element, such as an open dialog's panel: the card then renders there and shares its stacking context, which is what a table inside a dialog needs, since the card's `z-index: 8` counts in the context it renders in. `portalContainer={false}` keeps the card inside the table's frame. Escape closes the card. A server pass draws no card, so server rendering and hydration are unchanged.
213
213