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
@@ -4,9 +4,13 @@
4
4
  * formatting spec from it. This avoids
5
5
  * printf-style format strings entirely.
6
6
  */
7
- import type { RenderTarget } from './types/options.js';
8
7
  import type { LintWarning, PlacedLabel, SceneNode } from './types/scene.js';
9
8
  import type { InteractionRecord } from './a11y/types.js';
9
+ import { type JsonPatchOperation } from './diagnostics/jsonPatch.js';
10
+ import { type SmallValues } from './formatPrecision.js';
11
+ export { AUTHORED_EXAMPLES, UNIT_STAND_INS, formatScopeKey, withUnitStandIns } from './formatPrecision.js';
12
+ import { type RuleSet } from './numberRule.js';
13
+ import { numberSetOf } from './numberSets.js';
10
14
  /** A composing chart's generated example is still an automatic format. */
11
15
  export declare const AUTOMATIC_FORMAT: unique symbol;
12
16
  export type AutomaticFormatSource = {
@@ -16,12 +20,37 @@ export type AutomaticFormatSource = {
16
20
  export declare const MAGNITUDE_GROUP: unique symbol;
17
21
  /** Figures of a group that print nowhere, by column: they still set the group's magnitude and precision. */
18
22
  export declare const MAGNITUDE_FIGURES: unique symbol;
23
+ /**
24
+ * The figures of every period of a line that a card leaves periods out of: plain numbers, one list per line, the
25
+ * same list for every card of a request. They set the magnitude and precision of the row or its group, so a card
26
+ * prints as the full table does. A list repeats the figures of the periods the card draws, which changes no largest
27
+ * value and no precision.
28
+ */
29
+ export declare const PERIOD_FIGURES: unique symbol;
19
30
  export type MagnitudeGroupSource = {
20
31
  [MAGNITUDE_GROUP]?: string;
21
32
  [MAGNITUDE_FIGURES]?: readonly (readonly [string, number])[];
33
+ [PERIOD_FIGURES]?: readonly (readonly number[])[];
34
+ };
35
+ /**
36
+ * The scale and decimals an authored example gave the chart's values before
37
+ * it printed exactly: one scale shared by the values (shareAuthoredScale), a
38
+ * roll at 1000 and down where a value would print as 0. A number the engine
39
+ * works out on its own (a statistic, a tick) keeps them (engineNumberSpec).
40
+ */
41
+ export declare const ENGINE_SCALE: unique symbol;
42
+ type EngineScale = Pick<NumberFormatSpec, 'magnitude' | 'decimals' | 'rollMagnitude'> & {
43
+ from: Pick<NumberFormatSpec, 'magnitude' | 'decimals'>;
22
44
  };
23
45
  /** A composing chart's row that prints a label and no value by design: its blank cells are no gap in the data, so it has no record. */
24
46
  export declare const LABEL_ONLY_ROW: unique symbol;
47
+ /**
48
+ * The default number rule of a spec no author wrote (numberRule.ts): every
49
+ * value prints at its group's scale and decimals, a late value in the group that
50
+ * shows its leading digits, else as a set of one value. A spread copies it, so a signed or suffixed copy prints by the same
51
+ * set; a printer reads it before any field of the spec.
52
+ */
53
+ export declare const RULE_SET: unique symbol;
25
54
  export type LabelOnlyRowSource = {
26
55
  [LABEL_ONLY_ROW]?: true;
27
56
  };
@@ -65,8 +94,6 @@ export interface NumberFormatSpec {
65
94
  signed: boolean;
66
95
  /** Unit rule: values that round to at least this print without decimals. */
67
96
  wholeFrom?: number;
68
- /** A whole count prints without decimals beside fractional values of its raster (funnel counts: '1' beside '0.6'). */
69
- wholeCounts?: boolean;
70
97
  /** Unformatted currency on a new target: unscaled magnitudes of at least 1,000 print whole. */
71
98
  currencyWhole?: boolean;
72
99
  /**
@@ -79,16 +106,6 @@ export interface NumberFormatSpec {
79
106
  lockMagnitude?: boolean;
80
107
  /** A row chose its own scale and decimals; do not roll individual cells up. */
81
108
  rollMagnitude?: false;
82
- /**
83
- * The engine chose `magnitude` from the largest value (no authored scale).
84
- * A value below that magnitude prints at its own (k, or none): "20", not
85
- * "0.00000002B" beside billions.
86
- */
87
- autoMagnitude?: true;
88
- /** The decimals every value under the engine scale shares at its own scale ("+0.50" beside "+0.04"). */
89
- stepDecimals?: number;
90
- /** A set's magnitude (setMagnitude): a value of 1,000 or more at it prints whole, "1,540M" beside "57.50M". */
91
- setScale?: true;
92
109
  /**
93
110
  * The magnitude word as the example wrote it, with the space before it
94
111
  * (" Mio.", "bn"): a value at that magnitude prints it. A value
@@ -100,19 +117,82 @@ export interface NumberFormatSpec {
100
117
  text: string;
101
118
  };
102
119
  /**
103
- * A chart value formatter (exampleSpec) never prints a nonzero value as 0:
104
- * a free scale rolls down its word family ("$1.0 billion", not "$0.0
105
- * trillion"), a held scale lifts its decimals ("0.004k", not "0k"). A
106
- * table names its scale in a head and lifts in fitFormats instead.
120
+ * The stand-in of a unit-only format (exampleSpec) never prints a nonzero
121
+ * value as 0: a free scale rolls down its word family ("$1.0 billion", not
122
+ * "$0.0 trillion"), a held scale lifts its decimals ("0.004k", not "0k").
107
123
  */
108
124
  nonzero?: true;
125
+ /**
126
+ * An authored example (exampleSpec): every value prints as the example
127
+ * reads, with its scale word, decimals or figures and affixes. No printer
128
+ * adds a decimal, steps the scale or prints a bound; a value that rounds to
129
+ * zero prints the example's zero, and format-hides-values says so.
130
+ */
131
+ exact?: true;
132
+ /** On an exact spec: the scale its example gave before (ENGINE_SCALE). */
133
+ [ENGINE_SCALE]?: EngineScale;
134
+ /** A default spec: the set the rule placed its values in (RULE_SET). */
135
+ [RULE_SET]?: RuleSet;
109
136
  }
137
+ /** A default spec for a set under the rule: its fields name the first group, for a caller that reads the set's main scale. */
138
+ export declare function ruleSpec(rule: RuleSet, locale?: string, prefix?: string, suffix?: string): NumberFormatSpec;
139
+ /** The default spec of the finite values of one set: the rule over them, under the chart's language tag. */
140
+ export declare function defaultSetSpec(values: Iterable<number | null | undefined>, locale?: string, unit?: string, declared?: Parameters<typeof numberSetOf>[1]): NumberFormatSpec;
141
+ /**
142
+ * The spec of a statistic set (means, weighted shares, band bounds) computed
143
+ * from the values of `of`: under the default rule a set of its own with the
144
+ * scale-word decision of those values.
145
+ * Under an authored format it is the statistic rule of formatStatWithSpec.
146
+ */
147
+ export declare function statisticFormatter(values: Iterable<number | null | undefined>, of: NumberFormatSpec): (value: number) => string;
148
+ /**
149
+ * The signed spec of absolute changes or differences under the default rule:
150
+ * they join the set of their levels,
151
+ * so the groups form over the levels and the changes together.
152
+ * Undefined for a spec without a rule set.
153
+ */
154
+ export declare function joinedChangeSpec(levels: NumberFormatSpec, changes: Iterable<number | null | undefined>): NumberFormatSpec | undefined;
155
+ /**
156
+ * Changes in percent, growth rates and differences in percentage points under
157
+ * the default rule: a signed change set of their own, whose every group prints
158
+ * two digits (`+9.1% · −4.0%`). `kind: 'number'` serves a change column whose
159
+ * head names the percent (a growth column of a bar table).
160
+ */
161
+ export declare function percentChangeSpec(values: Iterable<number | null | undefined>, locale?: string, suffix?: string, kind?: 'percent' | 'number'): NumberFormatSpec;
162
+ /**
163
+ * The statistics of a chart under the default rule: an authored value in no
164
+ * set prints in the level set as a late value (`level`). The statistics of one
165
+ * kind form one set (`set`). Undefined under an authored format.
166
+ */
167
+ export interface RuleStatistics {
168
+ level: (value: number) => string;
169
+ set: (values: readonly (number | null | undefined)[]) => (value: number) => string;
170
+ }
171
+ export declare function ruleStatistics(spec: NumberFormatSpec, level: (value: number) => string): RuleStatistics | undefined;
172
+ /** The spec without its rule set: for a printer of its own (the ticks) that keeps the style. */
173
+ export declare function withoutRuleSet(spec: NumberFormatSpec): NumberFormatSpec;
110
174
  export declare function parseFormatExample(example: string, keepWord?: boolean): NumberFormatSpec;
111
175
  /** Translate spreadsheet placeholders to an example without changing the numeric divisor. */
112
176
  export declare function spreadsheetExample(code: string): {
113
177
  example: string;
114
178
  notes: string[];
115
179
  } | undefined;
180
+ /** Run one chart's layout or text under its smallValues mode, its unit-only stand-ins and its authored examples. */
181
+ export declare function withChartFormats<T>(options: {
182
+ smallValues?: SmallValues;
183
+ } | undefined, run: () => T): T;
184
+ /**
185
+ * A format the author wrote as an example prints exactly. A unit alone
186
+ * ("$M", "%") states no precision: it and its stand-in keep the data-led
187
+ * precision of a unit. Inside a chart, an example the engine wrote (a
188
+ * table's default column example, a composing chart's generated format)
189
+ * keeps its own precision too: only the chart's authored examples are exact.
190
+ * The sets hold texts, not owners, so two cases stay as they are: an engine
191
+ * example with the same text as an authored one in the same chart prints
192
+ * exactly too, and an authored example equal to a stand-in keeps the data-led
193
+ * precision, because the stand-in rule wins.
194
+ */
195
+ export declare function isExactExample(example: string): boolean;
116
196
  /** The ordinary example every reader uses, including callers before request resolution. */
117
197
  export declare function formatExampleText(example: string): string;
118
198
  /**
@@ -124,6 +204,27 @@ export declare function formatExampleProblem(example: string): {
124
204
  message: string;
125
205
  replacement: string;
126
206
  } | undefined;
207
+ /**
208
+ * The examples written in a chart's data and options as they stand, with
209
+ * their differences: the record of authored formats for a chart that no
210
+ * request read (a definition's layout called directly). A generated owner
211
+ * (AUTOMATIC_FORMAT) is the engine's.
212
+ */
213
+ export declare function writtenExamples(data: unknown, options: unknown): Set<string>;
214
+ /** The unit-only formats of a chart's options, by path below options, with the stand-in that replaced each (readFormatExamples). */
215
+ export declare const UNIT_FORMATS: unique symbol;
216
+ export type UnitFormat = {
217
+ path: (string | number)[];
218
+ unit: string;
219
+ example: string;
220
+ };
221
+ /**
222
+ * The options as their author wrote them where a unit-only format stands:
223
+ * the export writes `$M`, not the stand-in the chart drew it with, so the
224
+ * document draws its chart's text again. A path that no longer holds the
225
+ * stand-in (reader state changed it) is kept.
226
+ */
227
+ export declare function withAuthoredUnits<O extends object>(options: O): O;
127
228
  /**
128
229
  * The chart's data and options with each format example read by that data
129
230
  * (`exampleReading`), and a warning where a group rounds a small number.
@@ -134,6 +235,9 @@ export declare function readFormatExamples<D, O>(data: D, options: O): {
134
235
  data: D;
135
236
  options: O;
136
237
  warnings: LintWarning[];
238
+ standIns: Set<string>;
239
+ authored: Set<string>;
240
+ unitFormats: UnitFormat[];
137
241
  };
138
242
  export declare const MAGNITUDE_DIVISOR: Record<NumberFormatSpec['magnitude'], number>;
139
243
  export declare const MAGNITUDE_LABEL: Record<NumberFormatSpec['magnitude'], string>;
@@ -165,15 +269,41 @@ export declare function specUnitKind(spec: NumberFormatSpec): 'percent' | 'pp' |
165
269
  /** A percentage, percentage points or a multiple ("1.0x"): a figure that does not add. */
166
270
  export declare function nonAdditiveSpec(spec: NumberFormatSpec): boolean;
167
271
  export declare function nonAdditiveFormat(format: string | undefined): boolean;
272
+ /**
273
+ * A pinned magnitude ROLLS OVER at 1000 instead of printing four digits of
274
+ * itself: "$1000k" is a notation no reader should meet — the honest spelling
275
+ * is "$1.0M". The decision runs on the ROUNDED value, so 999.6k at zero
276
+ * decimals rolls too rather than rounding into "1000k" after the check.
277
+ * Rolled values below 10 keep one decimal ("$1.0M", not "$1M") so the scale
278
+ * continuity stays visible. formatWithSpec and roundedNumber MUST share this
279
+ * — a reader-facing 1.0M whose reconciliation number stayed 1,049,000 would
280
+ * fabricate a phantom gap (see roundedNumber's contract below).
281
+ */
168
282
  export declare function effectiveScale(value: number, spec: NumberFormatSpec): {
169
283
  magnitude: NumberFormatSpec['magnitude'];
170
284
  decimals: number;
171
285
  };
172
286
  /** The scale a spec without an authored word prints: the letter, or the local short form for B and T (magnitudeSuffix). */
173
287
  export declare function magnitudeLabel(spec: NumberFormatSpec, magnitude: NumberFormatSpec['magnitude']): string;
288
+ /**
289
+ * Print every exact spec inside `print` as engineNumberSpec reads it: for a
290
+ * text of numbers the engine works out on its own (a legend tick, a row
291
+ * mean) that reaches the shared value printers.
292
+ */
293
+ export declare function asEngineNumbers<T>(print: () => T): T;
174
294
  export declare function formatWithSpec(value: number, spec: NumberFormatSpec): string;
175
295
  /** The table owns and finalizes this spec before compiling it. Public mutable specs use formatWithSpec. */
176
296
  export declare function compileNumberFormat(spec: NumberFormatSpec): (value: number) => string;
297
+ /**
298
+ * A text that prints a bound, not the number: the small-values bound
299
+ * ("<0.001", ">−0.1", the p-value "<.001") and the change cap (">999%").
300
+ * Each starts with its comparison sign, and no number text does. A layout
301
+ * that joins the unit before it states the text puts a currency sign first
302
+ * ("$<0.01", "€<+0.1m", unitJoin.ts), so one leading sign of that set is
303
+ * passed over. A shown text states the number, so a bound is none
304
+ * (recordsShared.ts, annotate.ts).
305
+ */
306
+ export declare function printsBound(text: string): boolean;
177
307
  /**
178
308
  * The numeric value a reader SEES for `value` under `spec` — the exact same
179
309
  * rounding path as formatWithSpec (toFixed on the magnitude-scaled abs,
@@ -197,13 +327,21 @@ export declare function withChartMarks(spec: NumberFormatSpec, locale: string |
197
327
  */
198
328
  export declare function localized(spec: NumberFormatSpec, locale: string | undefined): NumberFormatSpec;
199
329
  /**
200
- * An authored example as every value formatter prints it: the
201
- * authored magnitude word, the chart locale's separators, and the scale a
202
- * unit states held at the example's own decimals ("$0.4k" and "$1000.0k"
203
- * under "$k" for a "$1.2k" example, never "$1.0M"). `values` are the chart's
204
- * printed numbers, which share one scale and one decimal count (shareAuthoredScale).
330
+ * An authored example as every value formatter prints it: exactly as the
331
+ * example reads (`exact`), with the authored magnitude word held for every
332
+ * value ("$0.0M" for 4 under "$1.2M") and the chart locale's separators.
333
+ * The stand-in of a unit-only format ("$M", isExactExample) keeps a unit's
334
+ * data-led precision instead: the scale a unit states held at the example's
335
+ * own decimals, and `values`, the chart's printed numbers, sharing one scale
336
+ * and one decimal count (shareAuthoredScale).
205
337
  */
206
338
  export declare function exampleSpec(example: string, locale?: string, unit?: string, values?: Iterable<number | null | undefined>): NumberFormatSpec;
339
+ /**
340
+ * An authored example exactly as it reads, with only its own grouping: the
341
+ * spec of a card that prints one figure (kpi). Undefined for a unit-only
342
+ * format (isExactExample), which keeps a unit's data-led precision.
343
+ */
344
+ export declare function exactExampleSpec(example: string, locale?: string): NumberFormatSpec | undefined;
207
345
  /**
208
346
  * The example that sets how a chart prints its computed shares: `shareLabels.format`,
209
347
  * else the percent `series[].format` that every data series sets alike (a series format
@@ -221,6 +359,15 @@ export declare function shareFormatExample(options: {
221
359
  }[]): string | undefined;
222
360
  /** Parse an example and return a ready-to-use formatter. The chart locale is required (pass undefined for none), so no caller forgets it. */
223
361
  export declare function formatterFromExample(example: string, locale: string | undefined, unit?: string, values?: Iterable<number | null | undefined>): (value: number) => string;
362
+ /**
363
+ * The spec a number the engine works out on its own prints with (a mean, a
364
+ * median, a band bound, a tick of a per-value axis): an authored example as
365
+ * it printed before it became exact, with the chart's shared scale, the roll
366
+ * at 1000 and the roll down from 0 (ENGINE_SCALE). Other specs pass through.
367
+ */
368
+ export declare function engineNumberSpec(spec: NumberFormatSpec): NumberFormatSpec;
369
+ /** formatterFromExample for numbers the engine works out on its own: the example as engineNumberSpec reads it. */
370
+ export declare function engineFormatterFromExample(example: string, locale: string | undefined, unit?: string, values?: Iterable<number | null | undefined>): (value: number) => string;
224
371
  /**
225
372
  * An automatic format keeps its normal rounding and lifts only a zeroed value.
226
373
  */
@@ -301,7 +448,11 @@ export declare function rasterDecimals(values: Iterable<number | null | undefine
301
448
  * bound to full precision ("23.4", not "23.35").
302
449
  */
303
450
  export declare function formatStatWithSpec(value: number, spec: NumberFormatSpec): string;
304
- /** Trend rates choose their own magnitude and precision; they never use the small-value bound policy. */
451
+ /**
452
+ * Trend rates choose their own magnitude and precision; they never use the small-value bound policy.
453
+ * Without an example a rate is a statistic set of one value: a rate of a
454
+ * percent or points measure prints in points, another unit follows the number.
455
+ */
305
456
  export declare function trendRateFormatter(example: string | undefined, locale?: string, unit?: string, signed?: boolean): (rate: number) => string;
306
457
  /** Style-only default for charts with no authored example: en-US grouping,
307
458
  * point decimal, no unit — the exact face formatNumber's default shows. */
@@ -317,19 +468,40 @@ export declare function defaultFormatSpec(locale?: string): NumberFormatSpec;
317
468
  */
318
469
  export declare function percentRasterFormatter(values: Iterable<number | null | undefined>, locale?: string): (value: number) => string;
319
470
  /**
320
- * An authored format with no scale word prints a value of 1e6 or
321
- * more in all its digits ("1310000000.0" under "1.1"), and one that prints a
322
- * series' different values as one string hides them. The format stays the
323
- * author's; this warns and offers a compact or finer example of the same style.
324
- * A format that prints a nonzero value as its zero warns only where the chart's
325
- * own records (`records`, built only when an authored format exists) print that zero.
471
+ * Draws the chart with a format patch and says whether the format-hides-values
472
+ * warning at `field` is gone: the render proves a patch before it offers it.
473
+ */
474
+ export type FormatPatchCheck = (fix: JsonPatchOperation[], field: readonly (string | number)[]) => boolean;
475
+ /** What the format warnings read beside the spec. */
476
+ export interface FormatLintContext {
477
+ /** Whether the drawing shows a number of zeros only (drawsZeroNumber); read from `geo` when absent. */
478
+ zeroDrawn?: () => boolean;
479
+ /** The drawn scene where `geo` is not the chart's own (a grid panel): its table cells. */
480
+ scene?: readonly SceneNode[];
481
+ /** Proves a patch. Without it, the patch is the first example that shows every value. */
482
+ verify?: FormatPatchCheck;
483
+ }
484
+ /**
485
+ * The warnings of the formats an author wrote. A format with no scale word
486
+ * prints a value of 1e6 or more in all its digits ("1310000000.0" under
487
+ * "1.1"). An authored example prints exactly (exampleSpec), so where it prints
488
+ * a value off zero as its zero, or the different values of a series, a table
489
+ * row or a table column as one text, format-hides-values names the format and
490
+ * offers an example of the same style that shows them. It judges the text the
491
+ * chart states for each value: its label, or where none is drawn the text of
492
+ * the hover card. The records that hold those texts are built only where a
493
+ * format may hide a value: the data say so (mayHide), or the drawing shows a
494
+ * zero (drawsZeroNumber). A unit-only format ("$M") keeps its own warnings.
326
495
  */
327
496
  export declare function unscaledFormatLint(options: Record<string, unknown> | undefined, data: unknown, geo?: {
328
497
  labels?: readonly PlacedLabel[];
329
498
  scene: readonly SceneNode[];
330
- }, records?: () => readonly InteractionRecord[] | null): LintWarning[];
499
+ }, records?: () => readonly InteractionRecord[] | null, context?: FormatLintContext): LintWarning[];
331
500
  /** Whether the chart draws a value of zeros only ("0", "0.0k", "0%") in a value label or a table cell. Without one there is no printed zero to prove, and the records are not built. */
332
501
  export declare function drawsZeroNumber(scene: readonly SceneNode[]): boolean;
502
+ /** A text whose digits are all zero ("0", "$0.0M", "−0%"). */
503
+ /** A text whose every digit is 0 ("0.0%", "$0M"). */
504
+ export declare const zeroText: (text: string) => boolean;
333
505
  /**
334
506
  * The scale a unit names: "€M", "EUR m" and "CHFm" are millions, "k€"
335
507
  * thousands, "USD bn" billions, "Mio. CHF" millions; none for "%" or "EUR".
@@ -339,38 +511,18 @@ export declare function drawsZeroNumber(scene: readonly SceneNode[]): boolean;
339
511
  */
340
512
  export declare function unitMagnitude(unit: string | undefined): NumberFormatSpec['magnitude'] | undefined;
341
513
  /**
342
- * The exhibit-wide value formatter: an authored example sets style and
343
- * precision. Without an example, plotted values set the precision. `fmtSigned` forces '+' on positives — the
344
- * derived-delta face used by waterfall sums and diff/delta annotations.
345
- * `unit` applies the unit rule; an authored example overrides it.
346
- * `defaultExample` preserves a composing chart's existing default precision;
347
- * it is not authored and therefore still permits the currency default.
514
+ * The exhibit-wide value formatter. Without an example the plotted values
515
+ * form one set under the default rule (ruleRasterFormatter). An authored
516
+ * example prints every value exactly as it reads. `fmtSigned` forces '+' on
517
+ * positives: the derived-delta face of waterfall sums and diff annotations.
348
518
  *
349
- * `forSeries` is the formatter for one series' value labels (a series
350
- * format overrides). A series `format` example prints in its own style and
351
- * precision, as a cell `format` does. A series `unit` applies the unit rule
352
- * in place of the chart unit, on the exhibit raster. A series with neither
353
- * prints with `fmt`. `shared` keeps one precision for every series: series
354
- * that share a stack or a total read as one set.
355
- */
356
- /**
357
- * One magnitude for a set of comparable values, such as the stages of a funnel with
358
- * their totals: the largest step at which the smallest nonzero value prints as 1 or
359
- * more (after rounding), while the largest keeps at most four digits ("1,180M · 590M · 140M").
360
- * Undefined keeps one scale per label (effectiveScale): an authored format, a unit
361
- * that names a scale, a set below 1e6 (no engine scale), or a set no step fits.
362
- * `whole`: the magnitude differs from the M or B the engine picks for the set's largest
363
- * value, so a label of 1,000 or more prints whole ("1,540M", not "1,540.00M"). A set at
364
- * the engine's own M or B prints as one scale per label does, "1,000.00M" for 999,999,900 included.
365
- */
366
- export interface SetMagnitude {
367
- magnitude: 'bn' | 'm' | 'k';
368
- whole: boolean;
369
- }
370
- export declare function setMagnitude(values: Iterable<number | null | undefined>, example: string | undefined, unit: string | undefined, target: RenderTarget | undefined): SetMagnitude | undefined;
371
- export declare function seriesRasterFormatter(example: string | undefined, values: Iterable<number | null | undefined>, locale?: string, unit?: string, target?: RenderTarget, defaultExample?: string, shared?: boolean,
372
- /** The set's magnitude (setMagnitude), shared by every raster of the set: no label steps down on its own. */
373
- setScale?: SetMagnitude): {
519
+ * `forSeries` is the formatter for one series' value labels. A series
520
+ * `format` example prints in its own style and precision, as a cell `format`
521
+ * does. A series with its own `unit` is a set of its own. A series with
522
+ * neither prints with `fmt`. `cell` declares the values table cells (a bar table), whose
523
+ * scale words start at the cell threshold.
524
+ */
525
+ export declare function seriesRasterFormatter(example: string | undefined, values: Iterable<number | null | undefined>, locale?: string, unit?: string, cell?: boolean): {
374
526
  spec: NumberFormatSpec;
375
527
  fmt: (value: number) => string;
376
528
  fmtSigned: (value: number) => string;
@@ -27,7 +27,7 @@ import { type Point } from '../geometry.js';
27
27
  import type { FontSpec, TextMeasurer } from '../text.js';
28
28
  import type { Id, OwnerRef, SlotId } from '../types/cell.js';
29
29
  import type { FocusInput, LabelDensity, LabelKind } from '../types/options.js';
30
- import type { Paint, PlaceDecision, PlacedLabel, LintWarning, TextRole } from '../types/scene.js';
30
+ import type { Paint, PlaceDecision, PlacedLabel, LintWarning, ShownTexts, TextRole } from '../types/scene.js';
31
31
  import { type OccupiedIndex } from './occupied.js';
32
32
  import { HOST_CLAIMS, type HostClaims } from '../claims/ids.js';
33
33
  import { type PointOwnershipInput } from './ownership.js';
@@ -205,6 +205,8 @@ export interface LabelRequest {
205
205
  printedIn?: Id;
206
206
  /** The marks whose value this label prints (PlacedLabel.printsFor). */
207
207
  printsFor?: OwnerRef[];
208
+ /** The record values this label prints, with their texts (PlacedLabel.shows). */
209
+ shows?: ShownTexts;
208
210
  /** The claims whose number this label prints (src/core/claims/ids.ts). */
209
211
  claimIds?: readonly Id[];
210
212
  claimText?: string;
@@ -0,0 +1,109 @@
1
+ /**
2
+ * The default number rule: how Boardplot prints a number that no authored
3
+ * format covers. One call takes every value of one set (the values that share
4
+ * one format: a chart, a series with its own unit, a table column, a KPI
5
+ * figure) and gives each value its group: a scale word and a decimal count.
6
+ *
7
+ * 1. Scale words (k, M, B, T) only for a set that is no percent and has no
8
+ * unit text, from a largest value of 10,000 (a table cell or KPI figure:
9
+ * 100,000). German has no short word for thousand.
10
+ * 2. Zero prints as 0.
11
+ * 3. The largest value left opens a group; its band holds the values of at
12
+ * least a tenth of it.
13
+ * 4. The first group shows three digits of its largest value, but adds no
14
+ * decimal that no value of that power of ten carries. A later group shows
15
+ * two digits of its band's smallest value.
16
+ * 5. Close values stay apart: two digits of the band's spread, never more
17
+ * than three digits of the largest value (two decimals always allowed).
18
+ * 6. No more decimals than the band's values carry.
19
+ * 7. A value joins the group when the format shows its two leading digits or
20
+ * covers its decimals; every other value waits for a later group.
21
+ *
22
+ * A change set (changes in percent, growth rates, differences in percentage
23
+ * points) prints two digits of its band's smallest value in every group, and
24
+ * rule 5 does not apply: two changes equal at two digits print the same text.
25
+ *
26
+ * No Intl, no clock, no environment. The only module state is a bounded cache
27
+ * of built sets by content, so a set's text depends on its values, the set
28
+ * and the print face (affixes, sign, marks) alone.
29
+ */
30
+ export type RuleKind = 'number' | 'percent' | 'share';
31
+ export type RuleSmallValues = 'bound' | 'zero' | 'scientific' | 'p-value';
32
+ export type RuleScale = 0 | 3 | 6 | 9 | 12;
33
+ /** What a set states to the rule. Nothing here is read from a printed text. */
34
+ export interface NumberSet {
35
+ kind: RuleKind;
36
+ /** A unit that is no currency sign, no currency code, no % and no pp: no scale words. */
37
+ unitText: boolean;
38
+ /** A table, bar table, cohort, dimension-switch cell or KPI figure: scale words from 100,000. */
39
+ cell: boolean;
40
+ /** The scale-word decision of the set this set belongs to (a statistic, a late value). */
41
+ words?: boolean;
42
+ /** A scale the author stated (a unit-only format such as "$M"): every value prints at it. */
43
+ scale?: RuleScale;
44
+ /** The language of the scale words ('de' drops the short thousand). */
45
+ language: string;
46
+ /** The `smallValues` option while it lives: how a value that needs more than four decimals prints. */
47
+ small?: RuleSmallValues;
48
+ /** A change set: every group prints two digits of its band's smallest value, and close values may meet. */
49
+ change?: boolean;
50
+ }
51
+ /** How a text looks: affixes, sign and the chart's marks. The rule reads none of them. */
52
+ export interface PrintFace {
53
+ prefix: string;
54
+ suffix: string;
55
+ signed: boolean;
56
+ decimal: string;
57
+ group: string;
58
+ minus: string;
59
+ /** The scale word prints in a head, not in the text (a table moves the scale word into the column head). */
60
+ bare?: boolean;
61
+ }
62
+ export declare const DEFAULT_FACE: PrintFace;
63
+ export interface RuleGroup {
64
+ scale: RuleScale;
65
+ decimals: number;
66
+ }
67
+ /** One set under the rule: every value's group, and the texts that follow from them. */
68
+ export interface RuleSet {
69
+ readonly set: NumberSet;
70
+ /** The finite values the set was built from. */
71
+ readonly values: readonly number[];
72
+ /** Whether the set prints scale words (rule 1), for its statistics and its ticks. */
73
+ readonly words: boolean;
74
+ /** The groups in the order the rule opened them. */
75
+ readonly groups: readonly RuleGroup[];
76
+ /** The group of a value of the set, or the group a late value joins. */
77
+ groupOf(value: number): RuleGroup;
78
+ /** The text of `value` under `face`, without the sign: prefix, digits, scale word, suffix. */
79
+ core(value: number, face: PrintFace): string;
80
+ /** The full text of `value` under `face`. */
81
+ text(value: number, face?: PrintFace): string;
82
+ /** The number a reader sees for `value`: rounded at its group. */
83
+ rounded(value: number): number;
84
+ }
85
+ /** German has no short word for thousand: below one million it writes the number out. A stated thousand keeps " Tsd.". */
86
+ export declare const opensThousand: (language: string) => boolean;
87
+ /** The decimals a value carries: 0.042 carries 3, 57.5 carries 1, 12 carries 0. */
88
+ export declare function carried(y: number): number;
89
+ /** The decimals that give y two significant digits, and three. */
90
+ export declare const digits2: (y: number) => number;
91
+ export declare const digits3: (y: number) => number;
92
+ export declare function numberRuleSet(values: readonly number[], set: NumberSet): RuleSet;
93
+ /** `value` rounded at the digits of `group`: the number that group prints. */
94
+ export declare function roundedAt(value: number, { scale, decimals }: RuleGroup): number;
95
+ /**
96
+ * The scale of an axis's ticks: a stated scale, else
97
+ * the scale word that fits the largest tick where the axis set uses words,
98
+ * else none.
99
+ */
100
+ export declare function tickScale(of: RuleSet, largest: number): RuleScale;
101
+ /** A set that prints every value in one group, with the words of `of` and no smallValues mode: the ticks of an axis. */
102
+ export declare function fixedRuleSet(of: RuleSet, group: RuleGroup): RuleSet;
103
+ /** The texts of one set, in input order, and the set's groups. */
104
+ export declare function defaultNumberTexts(values: readonly number[], set: NumberSet, face?: PrintFace): {
105
+ texts: string[];
106
+ groups: readonly RuleGroup[];
107
+ words: boolean;
108
+ textOf: (value: number) => string;
109
+ };
@@ -0,0 +1,43 @@
1
+ /**
2
+ * What a set of numbers states to the default number rule (numberRule.ts),
3
+ * read from the declaration only: the unit, the value kind, the role the
4
+ * engine computed, and the chart's language tag (its language, marks and
5
+ * smallValues mode, numberMarks.ts). No rule here reads a printed text or a
6
+ * pattern in a unit text.
7
+ */
8
+ import { type NumberSet, type PrintFace, type RuleKind, type RuleScale, type RuleSet } from './numberRule.js';
9
+ /**
10
+ * A unit that is exactly a currency sign ("$", "US$", "CHF" as a code), "%" or "pp" is no unit text. Every other
11
+ * unit is one, a magnitude letter before a currency sign ("M$", "K€") too: the data are already scaled.
12
+ */
13
+ export declare function isUnitText(unit: string | undefined): boolean;
14
+ /** A unit that states percent or percentage points. */
15
+ export declare function isPercentUnit(unit: string | undefined): boolean;
16
+ export interface SetDeclaration {
17
+ unit?: string;
18
+ kind?: RuleKind;
19
+ /** A table, bar table, cohort, dimension-switch cell or KPI figure. */
20
+ cell?: boolean;
21
+ /** The scale-word decision of the set this set belongs to. */
22
+ words?: boolean;
23
+ /** A scale a unit-only format states. */
24
+ scale?: RuleScale;
25
+ /** Changes in percent, growth rates or differences in percentage points. */
26
+ change?: boolean;
27
+ }
28
+ /** The set a chart's language tag and a declaration describe. */
29
+ export declare function numberSetOf(locale: string | undefined, declared?: SetDeclaration): NumberSet;
30
+ /** The finite numbers of a list. */
31
+ export declare function finiteValues(values: Iterable<number | null | undefined>): number[];
32
+ /** The rule over the finite values of one set. */
33
+ export declare function ruleSetOf(values: Iterable<number | null | undefined>, locale: string | undefined, declared?: SetDeclaration): RuleSet;
34
+ /** How a text of the chart looks: affixes, sign and the marks its language tag carries. `group: ''` prints no grouping. */
35
+ export declare function printFace(locale: string | undefined, prefix?: string, suffix?: string, signed?: boolean, group?: string): PrintFace;
36
+ /** One formatter for a set: each value's text by the rule, a value outside the set as a late value. */
37
+ export declare function ruleFormatter(values: Iterable<number | null | undefined>, locale: string | undefined, declared?: SetDeclaration, prefix?: string, suffix?: string): (value: number, signed?: boolean) => string;
38
+ /**
39
+ * A statistic set (a mean, a median, a band bound, a rate): its own set under
40
+ * the rule, with the scale-word decision, kind and cell of the values it is
41
+ * computed from.
42
+ */
43
+ export declare function statisticSet(values: Iterable<number | null | undefined>, of: RuleSet): RuleSet;
@@ -0,0 +1,16 @@
1
+ import type { ShownMark } from './types/scene.js';
2
+ /**
3
+ * Would-be value texts that a chart states on demand, in
4
+ * `geometry.marks.wouldShow`: the texts the labels of undrawn values would
5
+ * print. A chart lays out several passes and keeps one, and the SVG never
6
+ * prints these texts, so a pass does not format them. The record link asks
7
+ * for them once, when a record needs one (`withShownTexts`). A copy of the
8
+ * geometry shares the holder, and JSON leaves it out.
9
+ */
10
+ export declare class DeferredShownMarks {
11
+ #private;
12
+ constructor(compute: () => readonly ShownMark[]);
13
+ /** The texts, computed on the first call. */
14
+ marks(): readonly ShownMark[];
15
+ toJSON(): undefined;
16
+ }
@@ -528,13 +528,13 @@ export interface BaseOptions {
528
528
  */
529
529
  detailFields?: DetailField[];
530
530
  /**
531
- * How an automatic number format prints a nonzero value below its last
532
- * shown digit. 'bound' (default): "<0.01" at two decimals, ">−0.01" below
533
- * zero, "<1" for whole numbers, "<+0.01" on a signed change label; below 0.0001, scientific form. 'zero': spreadsheet style, the format's
534
- * own "0.00". 'scientific': two significant digits and a power of ten,
535
- * "1.2 × 10⁻⁹". 'p-value': every value from 0 to 1 prints as APA 7
536
- * writes a p-value, ".042", and "<.001" below. An authored format prints
537
- * as authored.
531
+ * How the default rule prints a nonzero value that needs more than four
532
+ * decimals. Without the option the rule prints its own digits. 'bound':
533
+ * "<0.001" at the decimals of the set's first group, ">−0.001" below zero.
534
+ * 'zero': the set's zero, "0.000". 'scientific': two significant digits
535
+ * and a power of ten, "1.2 × 10⁻⁶". 'p-value': every value from 0 to 1
536
+ * prints as APA 7 writes a p-value, ".042", and "<.001" below. An authored
537
+ * format prints as authored.
538
538
  */
539
539
  smallValues?: 'bound' | 'zero' | 'scientific' | 'p-value';
540
540
  /** Named theme palette (theme.color.palettes key) for the series ramp. */
@@ -1044,7 +1044,7 @@ export interface LineOptions extends Omit<BaseOptionsFor<'line'>, 'annotations'>
1044
1044
  trend?: boolean | {
1045
1045
  label?: string;
1046
1046
  };
1047
- /** stacked100-area defaults to sum-consistent rounding of complete computed wholes; nearest preserves separate rounding. */
1047
+ /** `sum-consistent` makes the computed shares of each complete stacked100-area whole total 100%; by default each share is rounded on its own. */
1048
1048
  rounding?: 'nearest' | 'sum-consistent';
1049
1049
  /** The event lane and key: placement, lane rows, event groups. */
1050
1050
  events?: EventOptions;