boardplot 0.56.0 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (552) hide show
  1. package/CHANGELOG.md +408 -0
  2. package/README.md +49 -15
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-VGSL4NJK.js} +1 -1
  4. package/dist/{ReaderBox-GLCKYXBU.js → ReaderBox-MHMXIDAJ.js} +8 -7
  5. package/dist/{annotateEngine-QVNAE3EH.js → annotateEngine-753KQBNN.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-HZUAEMN5.js → chunk-2CQBBN7M.js} +4 -4
  8. package/dist/{chunk-K3VZ5QJK.js → chunk-2ETK5TSA.js} +4 -4
  9. package/dist/{chunk-HHXIVFAU.js → chunk-2ETSI2EL.js} +11 -9
  10. package/dist/{chunk-ECBUFKCP.js → chunk-2GRXHWRH.js} +3 -3
  11. package/dist/{chunk-ZVM5TFGR.js → chunk-2HII2B6S.js} +6 -2
  12. package/dist/{chunk-WBETBGSC.js → chunk-2LC2H3ZM.js} +1003 -907
  13. package/dist/chunk-2NX7EO7H.js +23 -0
  14. package/dist/{chunk-52WNCUIN.js → chunk-2QI2PK2O.js} +1 -1
  15. package/dist/{chunk-QWCLWFKC.js → chunk-2VKQQLP7.js} +180 -58
  16. package/dist/chunk-3DOVXJ6K.js +602 -0
  17. package/dist/{chunk-CAJ54IEP.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-MOS6WFWM.js → chunk-3HA4IJTO.js} +9 -9
  19. package/dist/{chunk-JCIXYOND.js → chunk-3HPPTQEW.js} +4 -4
  20. package/dist/{chunk-7VVHTOE7.js → chunk-3KT2647F.js} +4 -2
  21. package/dist/{chunk-O6ZTIDWB.js → chunk-3MFVJMP6.js} +3 -2
  22. package/dist/{chunk-KQCKK3LD.js → chunk-3P3FKPFN.js} +170 -73
  23. package/dist/{chunk-WI5VOSQX.js → chunk-3XAJSMYD.js} +2 -2
  24. package/dist/{chunk-CPGASWNN.js → chunk-42QKUSHJ.js} +13 -3
  25. package/dist/{chunk-QB5HV4IY.js → chunk-44JU3VOT.js} +7 -8
  26. package/dist/{chunk-BYCJ6TKI.js → chunk-44K75CYE.js} +3 -3
  27. package/dist/{chunk-MS7O3KDJ.js → chunk-4FNM4D57.js} +6 -6
  28. package/dist/{chunk-BVYIKLQ5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-3V62N3Z7.js → chunk-4VV3KUFT.js} +7 -8
  30. package/dist/{chunk-MAFPVR4G.js → chunk-54YO56IK.js} +10 -5
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-6AMN7IKJ.js → chunk-5JEU6MWC.js} +49 -28
  33. package/dist/{chunk-NCLRZQR6.js → chunk-5JIB4VJA.js} +18 -10
  34. package/dist/{chunk-SXD3OYAR.js → chunk-5OP3E2ZD.js} +205 -96
  35. package/dist/{chunk-SS4YGK3E.js → chunk-5SLBD4BT.js} +72 -304
  36. package/dist/{chunk-XMP2DNLI.js → chunk-5SVGTQTW.js} +4 -4
  37. package/dist/chunk-5U567TYU.js +23 -0
  38. package/dist/chunk-5ZLF4S7X.js +40 -0
  39. package/dist/{chunk-T2YDWT54.js → chunk-5ZMTQATF.js} +261 -147
  40. package/dist/{chunk-WXJ5MHLH.js → chunk-62BDQTO6.js} +2 -2
  41. package/dist/chunk-64K3V4VN.js +25 -0
  42. package/dist/{chunk-BK6P6KMW.js → chunk-67YJJJIB.js} +1 -1
  43. package/dist/{chunk-32LLDRPI.js → chunk-6DJNFT2K.js} +42 -32
  44. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  45. package/dist/{chunk-7STMIK2X.js → chunk-6JFQCVNN.js} +4 -4
  46. package/dist/chunk-6JXBLQJ2.js +32 -0
  47. package/dist/{chunk-5TWY3ZIC.js → chunk-6XPV6M3Q.js} +5 -5
  48. package/dist/{chunk-MPO5TVGF.js → chunk-6ZDSEITW.js} +3 -3
  49. package/dist/{chunk-75WIUG2W.js → chunk-72HVDLMT.js} +172 -78
  50. package/dist/chunk-75NU5RLX.js +24 -0
  51. package/dist/chunk-76GPN6AT.js +72 -0
  52. package/dist/chunk-7BQK2UDV.js +13 -0
  53. package/dist/{chunk-CF4NMRN7.js → chunk-7CAYRPJV.js} +45 -25
  54. package/dist/{chunk-U3A6FMSI.js → chunk-7GWWBHVQ.js} +7 -7
  55. package/dist/{chunk-CHAS5A5B.js → chunk-7NYUFMLJ.js} +149 -86
  56. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  57. package/dist/chunk-A65B23JK.js +113 -0
  58. package/dist/{chunk-4KMZAK6J.js → chunk-A7R6FUS6.js} +4 -4
  59. package/dist/{chunk-E2ZUBP4Q.js → chunk-AEVGUOPB.js} +7 -8
  60. package/dist/chunk-AHIK2N72.js +53 -0
  61. package/dist/{chunk-KLB2QC24.js → chunk-AICO24HJ.js} +5 -2
  62. package/dist/{chunk-7KSUMFBK.js → chunk-AJGSCVVW.js} +5 -1
  63. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  64. package/dist/{chunk-E7V3OHQQ.js → chunk-AN2V2LC4.js} +37 -22
  65. package/dist/{chunk-JIEVDGAF.js → chunk-AOFUA5XP.js} +1 -1
  66. package/dist/chunk-B5A7X2BA.js +44 -0
  67. package/dist/{chunk-2HTYGMMG.js → chunk-BCMEGJRX.js} +2 -2
  68. package/dist/{chunk-KD5GOR2K.js → chunk-BDIKWR45.js} +124 -69
  69. package/dist/{chunk-FNRPQIQE.js → chunk-BG6AIWAK.js} +4 -6
  70. package/dist/{chunk-ZMPH2OC4.js → chunk-BOT6W3VB.js} +7 -8
  71. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  72. package/dist/{chunk-2DOEZ5QY.js → chunk-BZ67BJBH.js} +11 -10
  73. package/dist/{chunk-UBCVBBJJ.js → chunk-C47POAC5.js} +4 -3
  74. package/dist/{chunk-O7REHICC.js → chunk-C5OBPO4Z.js} +36 -28
  75. package/dist/{chunk-IGNBQT23.js → chunk-CCAAI56H.js} +121 -10
  76. package/dist/{chunk-RPIKNMZA.js → chunk-CDUR3KWV.js} +7 -2
  77. package/dist/{chunk-MZACASZY.js → chunk-CMPHT2LS.js} +14 -2
  78. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  79. package/dist/{chunk-IVRYF7QA.js → chunk-CR5FP5SF.js} +1 -1
  80. package/dist/{chunk-DD6RVD3S.js → chunk-D2TQX7UJ.js} +5 -1
  81. package/dist/{chunk-VVXKFU72.js → chunk-DEANHDXU.js} +62 -41
  82. package/dist/{chunk-GM3EGUYW.js → chunk-DHGE46UK.js} +1 -1
  83. package/dist/{chunk-UZTQUPTB.js → chunk-DIHX6NUB.js} +5 -5
  84. package/dist/{chunk-MD6DCQMA.js → chunk-DILQ34NW.js} +37 -37
  85. package/dist/{chunk-YMTXTQCN.js → chunk-DJKRYJP7.js} +6 -6
  86. package/dist/{chunk-JCAGVAB3.js → chunk-DKLC6QLF.js} +1200 -21
  87. package/dist/{chunk-SRAV6FPB.js → chunk-DNHTMCUP.js} +3 -3
  88. package/dist/{chunk-CKGSGRP7.js → chunk-DORE2RHL.js} +21 -5
  89. package/dist/{chunk-SMHZXHHD.js → chunk-DZYTXZNS.js} +15 -5
  90. package/dist/chunk-E262NRFP.js +39 -0
  91. package/dist/{chunk-V5JQQMFQ.js → chunk-E5YF236N.js} +4 -1
  92. package/dist/{chunk-IGJ2G5C6.js → chunk-EBUK7HJP.js} +6 -6
  93. package/dist/{chunk-ZL6IHMOW.js → chunk-ECBHC272.js} +198 -119
  94. package/dist/{chunk-SA46CNMS.js → chunk-ED7GLWTF.js} +4 -1
  95. package/dist/chunk-EFW43JQJ.js +24 -0
  96. package/dist/{chunk-5P2TTHBZ.js → chunk-EHRRHSPV.js} +2 -2
  97. package/dist/{chunk-JXBZIJCG.js → chunk-EILNJQMN.js} +32 -12
  98. package/dist/{chunk-GELSK76Y.js → chunk-ERDKMZ7O.js} +3 -3
  99. package/dist/{chunk-T2CYNDYU.js → chunk-ETRAPN5G.js} +366 -130
  100. package/dist/{chunk-JEUL777U.js → chunk-ETUKDEGL.js} +21 -12
  101. package/dist/chunk-F2ET5ZTT.js +49 -0
  102. package/dist/{chunk-2YO4WRJN.js → chunk-F3XOBFS4.js} +40 -29
  103. package/dist/{chunk-SPSGUFTI.js → chunk-FB6X7QHA.js} +1 -1
  104. package/dist/{chunk-5PPQIF4D.js → chunk-FGW54I23.js} +7 -8
  105. package/dist/{chunk-JTC5SEAQ.js → chunk-FP5B5XIL.js} +7 -3
  106. package/dist/{chunk-RJGCYGC3.js → chunk-FRHQGA5Q.js} +86 -250
  107. package/dist/{chunk-YZZLIYPA.js → chunk-FRR7BJ3B.js} +5 -1
  108. package/dist/{chunk-4DZFR52I.js → chunk-FVWHEM2N.js} +7 -5
  109. package/dist/{chunk-YPYD6OJ3.js → chunk-FWSMENKH.js} +2 -2
  110. package/dist/{chunk-YYJORENB.js → chunk-FWTUGNSF.js} +8 -8
  111. package/dist/{chunk-GIHH6VC2.js → chunk-FZKDZQ6U.js} +10 -6
  112. package/dist/{chunk-S7NRL66K.js → chunk-G4FF6G3I.js} +26 -17
  113. package/dist/{chunk-PQLAZEQV.js → chunk-GB6BZSTL.js} +248 -92
  114. package/dist/chunk-GCIHRRDJ.js +24 -0
  115. package/dist/{chunk-X3KCQEYZ.js → chunk-GHCU6OSE.js} +9 -1
  116. package/dist/chunk-GKDUIDU6.js +138 -0
  117. package/dist/chunk-GO66OCN7.js +24 -0
  118. package/dist/chunk-GOFS336W.js +24 -0
  119. package/dist/{chunk-AGDDH6XY.js → chunk-GQYT7G4F.js} +5 -1
  120. package/dist/{chunk-WN3HEU3P.js → chunk-GUTLXO7Q.js} +140 -89
  121. package/dist/chunk-H3VICNTN.js +47 -0
  122. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  123. package/dist/{chunk-CB4CERXZ.js → chunk-HBQHSZ6S.js} +11 -2
  124. package/dist/chunk-HTQGJQZN.js +124 -0
  125. package/dist/{chunk-F77TMAUY.js → chunk-HUQRO6VF.js} +39 -36
  126. package/dist/{chunk-4KQHKPB3.js → chunk-I5VDW2XZ.js} +543 -509
  127. package/dist/{chunk-43GGVT7W.js → chunk-I5VNHDPR.js} +11 -4
  128. package/dist/{chunk-4LTN7SND.js → chunk-IDXYHDQY.js} +1 -1
  129. package/dist/{chunk-Y54LU4CU.js → chunk-IIWZJ5ZM.js} +1 -1
  130. package/dist/{chunk-FMDNJ6PC.js → chunk-IPBOREIY.js} +2 -2
  131. package/dist/chunk-IU335UO7.js +27 -0
  132. package/dist/{chunk-JVZTKQFS.js → chunk-IVDTP6SV.js} +9 -5
  133. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  134. package/dist/{chunk-EIL3KHAL.js → chunk-J4QRB6DQ.js} +5 -5
  135. package/dist/{chunk-3465633G.js → chunk-JCMGKQVS.js} +3 -3
  136. package/dist/{chunk-YK2KWNTU.js → chunk-JM7UTLF3.js} +28 -14
  137. package/dist/{chunk-CXETOLPX.js → chunk-JNDWRV34.js} +4 -4
  138. package/dist/{chunk-DLUNQHFO.js → chunk-JSRQTDZZ.js} +26 -24
  139. package/dist/{chunk-WTQAG2OT.js → chunk-JT3UTEWZ.js} +8 -3
  140. package/dist/{chunk-GQT2SY2S.js → chunk-JUYRDZSV.js} +291 -151
  141. package/dist/{chunk-LKMFMNQX.js → chunk-JVGL2SCN.js} +1 -1
  142. package/dist/{chunk-4JC3SE4G.js → chunk-JY4LTPOV.js} +1 -1
  143. package/dist/chunk-K7XPTQBJ.js +267 -0
  144. package/dist/{chunk-P4SMC4BY.js → chunk-KGBUXMFP.js} +120 -86
  145. package/dist/{chunk-XC5IRUEL.js → chunk-KIE5V3DA.js} +2 -2
  146. package/dist/{chunk-RT66UTLJ.js → chunk-KU4PCG4W.js} +2 -2
  147. package/dist/{chunk-VPL3JYC6.js → chunk-KVBLTAO7.js} +52 -10
  148. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  149. package/dist/{chunk-PJBEJR2U.js → chunk-KWIP5YRA.js} +24 -7
  150. package/dist/{chunk-JYBT2JNY.js → chunk-LE3LSEUL.js} +27 -2
  151. package/dist/{chunk-R2IKOLBK.js → chunk-LG6M2JTH.js} +3 -3
  152. package/dist/{chunk-DF3XEFQ7.js → chunk-LIE2WSB4.js} +21 -18
  153. package/dist/{chunk-Z55DXFWS.js → chunk-LJDATBPB.js} +26 -16
  154. package/dist/{chunk-KLIZXSBK.js → chunk-LMMS675D.js} +10 -9
  155. package/dist/{chunk-MRAP2UVV.js → chunk-LPKGZ664.js} +286 -35
  156. package/dist/{chunk-JFFREZGT.js → chunk-LPMSGO7L.js} +6 -2
  157. package/dist/chunk-LQWINE7K.js +211 -0
  158. package/dist/{chunk-6MJUW5R5.js → chunk-MKMMQDIY.js} +139 -71
  159. package/dist/{chunk-F5BYLT3M.js → chunk-MQ4IEDM5.js} +462 -138
  160. package/dist/{chunk-QGFKSDQO.js → chunk-MRM4KJ2O.js} +2 -2
  161. package/dist/{chunk-ETMHDCEH.js → chunk-MX2OZHIT.js} +102 -42
  162. package/dist/{chunk-6EYTD777.js → chunk-MXUPMGRY.js} +2 -2
  163. package/dist/{chunk-2FKEF2AC.js → chunk-NHU26HQ7.js} +58 -35
  164. package/dist/{chunk-KBJMLXNW.js → chunk-NQVJ4FPY.js} +161 -78
  165. package/dist/chunk-NZ7FX3AE.js +65 -0
  166. package/dist/chunk-OALBVELJ.js +23 -0
  167. package/dist/{chunk-5S3JQ5AT.js → chunk-OGZ4UPYK.js} +183 -137
  168. package/dist/{chunk-6WHWXCHJ.js → chunk-OMNB27GM.js} +7 -3
  169. package/dist/{chunk-EGGDPDYJ.js → chunk-OO63YP35.js} +1 -1
  170. package/dist/{chunk-ZYQYX66L.js → chunk-OPYDTW5Q.js} +6 -6
  171. package/dist/{chunk-A2GAWGVJ.js → chunk-OSJN7KDS.js} +68 -39
  172. package/dist/{chunk-RMC4OONA.js → chunk-OSJXIW6I.js} +1030 -1123
  173. package/dist/{chunk-X23SZHV5.js → chunk-OVVE42P4.js} +6 -6
  174. package/dist/{chunk-CCJP6QZO.js → chunk-OZA7HA6L.js} +1 -1
  175. package/dist/chunk-OZLKEBCD.js +54 -0
  176. package/dist/{chunk-TE4M52AA.js → chunk-P6DEFCMQ.js} +18 -2
  177. package/dist/{chunk-AMR4SUAN.js → chunk-PDTIQL3B.js} +6 -6
  178. package/dist/{chunk-BIVL764T.js → chunk-PJ5BYZPN.js} +2 -2
  179. package/dist/{chunk-BISJK67O.js → chunk-PK7Z7WRJ.js} +98 -46
  180. package/dist/{chunk-7VMEM3LN.js → chunk-PL6NWB5U.js} +178 -113
  181. package/dist/chunk-PMT75APP.js +94 -0
  182. package/dist/chunk-PP6A4X55.js +11 -0
  183. package/dist/{chunk-I7H5DU34.js → chunk-PPCH3PLO.js} +25 -13
  184. package/dist/{chunk-BIGQKCU7.js → chunk-PPE6S7WU.js} +42 -24
  185. package/dist/{chunk-2NSQIPAA.js → chunk-PT7KSIEO.js} +23 -36
  186. package/dist/{chunk-KZJ5VM6E.js → chunk-PZ3TQFSY.js} +15 -1
  187. package/dist/{chunk-ZJFJ2IKQ.js → chunk-QAUGRVRU.js} +122 -23
  188. package/dist/{chunk-BTDGWHGJ.js → chunk-QMFWZG2P.js} +39 -19
  189. package/dist/{chunk-L6YVK6VC.js → chunk-QZGGCE45.js} +2 -2
  190. package/dist/{chunk-67QSW5RW.js → chunk-R2RJQ3BM.js} +4 -4
  191. package/dist/{chunk-ZY72LSQK.js → chunk-R7HBIQ63.js} +102 -61
  192. package/dist/{chunk-4JHMCXOB.js → chunk-RBNDZLYS.js} +77 -36
  193. package/dist/chunk-RCSY4CT4.js +2170 -0
  194. package/dist/{chunk-NGA7ICG4.js → chunk-RDJ3ZU6O.js} +16 -13
  195. package/dist/{chunk-2NN676RI.js → chunk-RHQRPJHS.js} +7 -8
  196. package/dist/chunk-RI6XQKWJ.js +26 -0
  197. package/dist/{chunk-YOOHNQ3L.js → chunk-RJICOOB3.js} +18 -8
  198. package/dist/{chunk-5DTCOOLU.js → chunk-RLAVNCQJ.js} +2 -2
  199. package/dist/{chunk-CYKXROFG.js → chunk-ROPPWJQB.js} +23 -12
  200. package/dist/{chunk-54ROMBU7.js → chunk-SELOV32X.js} +105 -50
  201. package/dist/{chunk-TUW5IYGA.js → chunk-SQI4NWTQ.js} +9 -9
  202. package/dist/{chunk-ZEYBI47P.js → chunk-SRJ74CMG.js} +11 -3
  203. package/dist/{chunk-NHC2ADGI.js → chunk-STWOURLG.js} +253 -144
  204. package/dist/chunk-SWMFXSVW.js +23 -0
  205. package/dist/chunk-SXAZDIGM.js +84 -0
  206. package/dist/{chunk-EMFUZKYK.js → chunk-SZ5VGWDY.js} +3 -3
  207. package/dist/{chunk-R5MEBBAA.js → chunk-T26G23RS.js} +442 -119
  208. package/dist/{chunk-QHRE2M6V.js → chunk-T2L5H2WW.js} +4 -3
  209. package/dist/chunk-T7GPIJ4L.js +89 -0
  210. package/dist/{chunk-MJPXHCBW.js → chunk-TAEB3RU6.js} +5 -5
  211. package/dist/{chunk-V7F4F6JA.js → chunk-TBDIMTRD.js} +37 -16
  212. package/dist/{chunk-63Y3ROZ7.js → chunk-TFFPEWNP.js} +102 -64
  213. package/dist/{chunk-EZZ533MH.js → chunk-TMEUK2WS.js} +6 -2
  214. package/dist/{chunk-37PKNVLS.js → chunk-TVOMGNFQ.js} +1 -1
  215. package/dist/{chunk-HJRNBKIT.js → chunk-TX5FSNAU.js} +436 -30
  216. package/dist/{chunk-V634AXDM.js → chunk-U52PNFPX.js} +1 -1
  217. package/dist/{chunk-QLANK3VN.js → chunk-U74AWJ3X.js} +6 -6
  218. package/dist/chunk-UC7LBW7N.js +26 -0
  219. package/dist/{chunk-PZ46S2SY.js → chunk-UCKUAKYQ.js} +2 -2
  220. package/dist/{chunk-KF7HD3EH.js → chunk-UCYL3YA7.js} +77 -55
  221. package/dist/{chunk-HOU2MZHC.js → chunk-UD2GI3CS.js} +11 -4
  222. package/dist/{chunk-SNQ7D5R7.js → chunk-UIHGGWES.js} +51 -11
  223. package/dist/{chunk-LGNJCPFP.js → chunk-ULQIC76A.js} +10 -13
  224. package/dist/{chunk-KTHFHD6C.js → chunk-UY34DDUM.js} +11 -6
  225. package/dist/{chunk-6QDMRPXI.js → chunk-UYMFLWM6.js} +215 -258
  226. package/dist/{chunk-KDSYZLF6.js → chunk-V5IFI3FV.js} +8 -1
  227. package/dist/{chunk-JTFKRDDA.js → chunk-V7FV66KL.js} +1 -1
  228. package/dist/{chunk-27OIGDRK.js → chunk-V7NUJEJE.js} +1 -1
  229. package/dist/{chunk-CCDXK5NA.js → chunk-VESSIKBG.js} +8 -3
  230. package/dist/{chunk-QSMGZOT5.js → chunk-VRFJAF3R.js} +7 -8
  231. package/dist/chunk-VS2R3OGN.js +34 -0
  232. package/dist/{chunk-RLMC5CUP.js → chunk-VS5B4J2D.js} +7 -8
  233. package/dist/{chunk-7M2GK7XQ.js → chunk-W4R6SGU3.js} +252 -121
  234. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  235. package/dist/{chunk-7DAH2E4T.js → chunk-WFBN2HXR.js} +2 -2
  236. package/dist/{chunk-DLDDRXAI.js → chunk-WJS6SAWA.js} +296 -145
  237. package/dist/{chunk-WWGPTEQB.js → chunk-WQYNKF33.js} +73 -22
  238. package/dist/{chunk-64LJDGJH.js → chunk-WUP6C4ZD.js} +4 -2
  239. package/dist/{chunk-F2EVCJ4U.js → chunk-X24WAHHV.js} +87 -43
  240. package/dist/{chunk-OJ5CQV7H.js → chunk-X3UCQPVV.js} +209 -96
  241. package/dist/{chunk-7FKY6YWU.js → chunk-X46PSAJ7.js} +6 -6
  242. package/dist/{chunk-H3IBJQ5A.js → chunk-XD5XB22R.js} +2 -2
  243. package/dist/chunk-XDIAQEYK.js +28 -0
  244. package/dist/{chunk-7PPMT5EJ.js → chunk-XFPNYHX3.js} +372 -105
  245. package/dist/{chunk-FCECYJVA.js → chunk-XIBVAKCO.js} +1 -1
  246. package/dist/{chunk-OG2YUVBW.js → chunk-XMX4PCFL.js} +8 -3
  247. package/dist/{chunk-2NRHD2G7.js → chunk-XRRG4MBM.js} +12 -4
  248. package/dist/{chunk-FNMH5WEY.js → chunk-XTFO6D4L.js} +1 -1
  249. package/dist/chunk-XWRI3N5O.js +70 -0
  250. package/dist/{chunk-ZKJ5L35C.js → chunk-XXPLPSOE.js} +36 -25
  251. package/dist/{chunk-XQMYQ4TN.js → chunk-XZXZNI7A.js} +1 -1
  252. package/dist/{chunk-E555EDOQ.js → chunk-YEJZ2OYS.js} +490 -182
  253. package/dist/chunk-YGZEG3JV.js +123 -0
  254. package/dist/{chunk-F6OLHND5.js → chunk-Z3WQXVFV.js} +2 -2
  255. package/dist/{chunk-FFJGC2DX.js → chunk-Z6DUNKFU.js} +173 -40
  256. package/dist/{chunk-N5HN5QGH.js → chunk-Z6H5ED2I.js} +1 -1
  257. package/dist/{chunk-7Q37C6GZ.js → chunk-ZBOOMLHD.js} +1 -1
  258. package/dist/{chunk-MOK3ZS6P.js → chunk-ZDJ7C64T.js} +1 -1
  259. package/dist/{chunk-GLQ3KCTY.js → chunk-ZGZLEUKM.js} +7 -8
  260. package/dist/{chunk-YHD2FZFP.js → chunk-ZHRGX225.js} +6 -6
  261. package/dist/{chunk-76Q7E3TM.js → chunk-ZIVCPXXL.js} +510 -646
  262. package/dist/{chunk-BSATR6ZO.js → chunk-ZNRSYS76.js} +21 -3
  263. package/dist/{chunk-DMAMWUYY.js → chunk-ZSLTSCTI.js} +5 -5
  264. package/dist/{chunk-IGVAWAOK.js → chunk-ZSYFQSPF.js} +43 -9
  265. package/dist/cli/index.js +8 -3
  266. package/dist/{core-7Y5BZZON.js → core-43GLGBOY.js} +8 -1
  267. package/dist/{core-7S3XMW5O.js → core-5GI3ERXO.js} +4 -1
  268. package/dist/{core-K3JX5WPM.js → core-5L7TMK7I.js} +6 -1
  269. package/dist/{core-LB5M7XL4.js → core-7TO4OVY5.js} +6 -1
  270. package/dist/{core-ILPXXC2Z.js → core-BJVENHFQ.js} +7 -1
  271. package/dist/{core-JDFUZFRH.js → core-BX4MFWKC.js} +6 -1
  272. package/dist/{core-XW7UJFJZ.js → core-C3KXTOIZ.js} +7 -1
  273. package/dist/{core-WJNK7F2J.js → core-C5Y6BFLL.js} +7 -1
  274. package/dist/{core-WZ4CHVYL.js → core-CLUSJ2SK.js} +5 -1
  275. package/dist/{core-TCSW24N6.js → core-E3IN2VVH.js} +5 -1
  276. package/dist/{core-MU4ALRR7.js → core-FD67NQOV.js} +6 -1
  277. package/dist/{core-YMXYUGF5.js → core-FDKMLRAK.js} +5 -1
  278. package/dist/{core-VKZSQFRG.js → core-FL6Z3VVX.js} +5 -1
  279. package/dist/{core-5UF44NDI.js → core-JC7JUFPY.js} +8 -1
  280. package/dist/{core-RR2CAZC5.js → core-JF33TADA.js} +8 -1
  281. package/dist/{core-4RR6VSXM.js → core-JH32ZAKM.js} +4 -1
  282. package/dist/{core-G3LXHW73.js → core-JYYZPPQV.js} +7 -1
  283. package/dist/{core-4HFVG4CP.js → core-KJTKCV4U.js} +4 -1
  284. package/dist/{core-GSILPKUR.js → core-LCQPE5Y6.js} +8 -1
  285. package/dist/{core-GLOZY6Z7.js → core-LHVGWE54.js} +6 -1
  286. package/dist/{core-J2JD5ODO.js → core-OVSNBOCE.js} +9 -1
  287. package/dist/{core-BLHEJ5OK.js → core-PPEC236B.js} +5 -1
  288. package/dist/{core-ZLSQHZ3I.js → core-QTJZDK5H.js} +5 -1
  289. package/dist/{core-TKZZZ6UW.js → core-R3YZCOUZ.js} +7 -1
  290. package/dist/{core-HTD5RHE7.js → core-RIBW5XU4.js} +7 -1
  291. package/dist/{core-AR2T32Y3.js → core-RJFILBWL.js} +8 -1
  292. package/dist/{core-A5AKUB7H.js → core-RWSXEKTE.js} +4 -1
  293. package/dist/{core-DD62MWEW.js → core-SOPPZLEH.js} +5 -1
  294. package/dist/{core-HDNWVLJW.js → core-TBUZCXLX.js} +5 -1
  295. package/dist/{core-BOG33BFD.js → core-TZ5QLTAX.js} +5 -1
  296. package/dist/{core-H5HO2CED.js → core-U7E5W4MY.js} +3 -1
  297. package/dist/{core-QPSAYRFT.js → core-UBNVSL44.js} +7 -1
  298. package/dist/{core-E2XOSHPR.js → core-UDRD4WIU.js} +6 -1
  299. package/dist/{core-DFZMOO7E.js → core-UVJZ4HY2.js} +7 -1
  300. package/dist/{core-LGJZUP6H.js → core-X7WWYQH4.js} +8 -1
  301. package/dist/{core-BBNY2BX4.js → core-XP56X47I.js} +5 -1
  302. package/dist/{core-3KLQSYWB.js → core-XQG54CYG.js} +6 -1
  303. package/dist/{dataTable-CNDRVGA5.js → dataTable-U7W4I6IF.js} +15 -2
  304. package/dist/{engine-FVEIM3WV.js → engine-O5V26MGR.js} +32 -19
  305. package/dist/fixtures.js +4 -1
  306. package/dist/flags-BVLSAXT3.js +10 -0
  307. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  308. package/dist/fonts.js +1 -1
  309. package/dist/geo/dach.js +1 -1
  310. package/dist/geo/de-states.js +1 -1
  311. package/dist/geo/eu27.js +1 -1
  312. package/dist/geo/europe.js +1 -1
  313. package/dist/geo/index.js +2 -2
  314. package/dist/geo/us-states.js +1 -1
  315. package/dist/geo/world.js +1 -1
  316. package/dist/index.js +41 -22
  317. package/dist/{main-THU6VIVU.js → main-35GS47XC.js} +68 -123
  318. package/dist/mcp/server.js +131 -118
  319. package/dist/react/bar.js +10 -1
  320. package/dist/react/bartable.js +10 -1
  321. package/dist/react/box.js +8 -1
  322. package/dist/react/bullet.js +10 -1
  323. package/dist/react/butterfly.js +10 -1
  324. package/dist/react/choropleth.js +10 -1
  325. package/dist/react/cohort.js +11 -1
  326. package/dist/react/column.js +10 -1
  327. package/dist/react/combo.js +10 -1
  328. package/dist/react/creative.js +11 -1
  329. package/dist/react/diagram.js +10 -1
  330. package/dist/react/dimswitch.js +11 -1
  331. package/dist/react/dot.js +9 -1
  332. package/dist/react/export.js +36 -18
  333. package/dist/react/funnel.js +9 -1
  334. package/dist/react/gantt.js +9 -1
  335. package/dist/react/grid.js +10 -1
  336. package/dist/react/heatmap.js +9 -1
  337. package/dist/react/histogram.js +11 -1
  338. package/dist/react/index.js +101 -85
  339. package/dist/react/kpi.js +10 -1
  340. package/dist/react/likert.js +11 -1
  341. package/dist/react/line.js +9 -1
  342. package/dist/react/mekko.js +10 -1
  343. package/dist/react/pareto.js +11 -1
  344. package/dist/react/pie.js +9 -1
  345. package/dist/react/prepare.js +49 -21
  346. package/dist/react/pvm.js +12 -1
  347. package/dist/react/pyramid.js +10 -1
  348. package/dist/react/sankey.js +10 -1
  349. package/dist/react/scatter.js +8 -1
  350. package/dist/react/slope.js +10 -1
  351. package/dist/react/sparkline.js +10 -1
  352. package/dist/react/spec.js +24 -14
  353. package/dist/react/status.js +9 -1
  354. package/dist/react/story.js +5 -2
  355. package/dist/react/table.js +9 -1
  356. package/dist/react/theme.js +10 -3
  357. package/dist/react/tilemap.js +9 -1
  358. package/dist/react/treemap.js +9 -1
  359. package/dist/react/variance.js +10 -1
  360. package/dist/react/waffle.js +9 -1
  361. package/dist/react/waterfall.js +11 -1
  362. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  363. package/dist/rows.js +3 -2
  364. package/dist/{rowsModule-LI6KOS46.js → rowsModule-H2S6WW4D.js} +2 -1
  365. package/dist/{schema-CGQID64D.js → schema-2R32F6AW.js} +1 -1
  366. package/dist/{schema-H2EC4GAQ.js → schema-2TPGJGVR.js} +1 -1
  367. package/dist/{schema-THXXFY6I.js → schema-47BG2TZA.js} +1 -3
  368. package/dist/{schema-AMT7P7KB.js → schema-56MOEOVR.js} +1 -1
  369. package/dist/{schema-GNTKL5DN.js → schema-5MSR4LNN.js} +1 -1
  370. package/dist/{schema-5ZTGVQAJ.js → schema-5RIYEWE6.js} +1 -1
  371. package/dist/{schema-LOQ3AFC7.js → schema-A26ZNGTZ.js} +1 -3
  372. package/dist/{schema-MMVPMJEF.js → schema-ALBF6V7Y.js} +1 -3
  373. package/dist/{schema-BKUFZLLI.js → schema-BA6WP5YZ.js} +1 -1
  374. package/dist/{schema-PQZWO3BP.js → schema-CBL2SMVR.js} +1 -3
  375. package/dist/{schema-BBTXTWYI.js → schema-CWKGLDSR.js} +1 -3
  376. package/dist/{schema-5KDEQBBT.js → schema-DBIQFL56.js} +1 -1
  377. package/dist/{schema-KPEPBGAX.js → schema-DL7V6NN2.js} +1 -1
  378. package/dist/{schema-PL3EU6EQ.js → schema-DUVJMFKQ.js} +4 -2
  379. package/dist/{schema-L5U4OROI.js → schema-ECJERHKF.js} +2 -1
  380. package/dist/{schema-YLE4XXQQ.js → schema-EDSEKZDJ.js} +1 -1
  381. package/dist/{schema-HH5HOORE.js → schema-ESR6ZIK4.js} +1 -3
  382. package/dist/{schema-5DUTAVO7.js → schema-F7TWGLRZ.js} +1 -3
  383. package/dist/{schema-B2GCEYXD.js → schema-FGB6IGZM.js} +1 -3
  384. package/dist/{schema-7NSV542V.js → schema-FKGGTM4Z.js} +2 -1
  385. package/dist/{schema-72EEMYS3.js → schema-FU2AFIEE.js} +1 -1
  386. package/dist/{schema-QORUB6EK.js → schema-JNJFCYBM.js} +18 -1
  387. package/dist/{schema-JH57NFXJ.js → schema-JYZ4RF6S.js} +2 -1
  388. package/dist/{schema-25INXAMY.js → schema-K7F6TEDK.js} +1 -2
  389. package/dist/{schema-OU35XA3Z.js → schema-KAK6DZX4.js} +1 -1
  390. package/dist/{schema-R5Y6NVBH.js → schema-MOKWIGF7.js} +1 -1
  391. package/dist/{schema-ZQSIR5UC.js → schema-MQT6BMNK.js} +1 -3
  392. package/dist/{schema-FDFQKIO5.js → schema-MR3BPPQR.js} +1 -1
  393. package/dist/{schema-VYECMPON.js → schema-OPXZYIW7.js} +1 -3
  394. package/dist/{schema-ZEVJMFLV.js → schema-PV7JGX5H.js} +1 -1
  395. package/dist/{schema-QPOBZUAR.js → schema-PWPQF5RC.js} +1 -1
  396. package/dist/{schema-GN6GAIU5.js → schema-PYQEUC5P.js} +1 -3
  397. package/dist/{schema-M5JBHQIV.js → schema-QPIC5MAG.js} +9 -2
  398. package/dist/{schema-QCIE6M2P.js → schema-R42VXFIS.js} +1 -1
  399. package/dist/{schema-J7TNCZIP.js → schema-TVUJNEX7.js} +1 -1
  400. package/dist/{schema-AXRDF6ND.js → schema-Y4TI2T3T.js} +1 -1
  401. package/dist/{schema-ZG6ZKFRZ.js → schema-ZU2EU2VP.js} +1 -1
  402. package/dist/{specValidation-VHLGDEME.js → specValidation-2NHJT7TQ.js} +4 -1
  403. package/dist/theme.js +7 -2
  404. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  405. package/dist/types/core/annotate.d.ts +27 -2
  406. package/dist/types/core/annotateArms.d.ts +3 -1
  407. package/dist/types/core/annotateTargets.d.ts +4 -0
  408. package/dist/types/core/annotationOrigin.d.ts +13 -0
  409. package/dist/types/core/axis.d.ts +2 -2
  410. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  411. package/dist/types/core/charts/bartable/types.d.ts +14 -1
  412. package/dist/types/core/charts/box/types.d.ts +3 -1
  413. package/dist/types/core/charts/choropleth/layout.d.ts +1 -5
  414. package/dist/types/core/charts/choropleth/types.d.ts +19 -0
  415. package/dist/types/core/charts/cohort/types.d.ts +16 -3
  416. package/dist/types/core/charts/column/model.d.ts +13 -0
  417. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  418. package/dist/types/core/charts/creative/types.d.ts +21 -0
  419. package/dist/types/core/charts/dimswitch/compile.d.ts +15 -2
  420. package/dist/types/core/charts/dimswitch/types.d.ts +24 -1
  421. package/dist/types/core/charts/gantt/calendar.d.ts +24 -0
  422. package/dist/types/core/charts/gantt/columns.d.ts +56 -0
  423. package/dist/types/core/charts/gantt/layout.d.ts +8 -2
  424. package/dist/types/core/charts/gantt/model.d.ts +296 -0
  425. package/dist/types/core/charts/grid/metricStack.d.ts +9 -0
  426. package/dist/types/core/charts/grid/metricStackSchema.d.ts +13 -0
  427. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  428. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  429. package/dist/types/core/charts/histogram/types.d.ts +8 -0
  430. package/dist/types/core/charts/likert/layout.d.ts +10 -8
  431. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  432. package/dist/types/core/charts/pvm/types.d.ts +10 -1
  433. package/dist/types/core/charts/pyramid/types.d.ts +3 -1
  434. package/dist/types/core/charts/sankey/types.d.ts +5 -1
  435. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  436. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  437. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  438. package/dist/types/core/charts/status/layout.d.ts +3 -0
  439. package/dist/types/core/charts/table/resolve.d.ts +22 -3
  440. package/dist/types/core/charts/table/view.d.ts +24 -1
  441. package/dist/types/core/claims/browser.d.ts +2 -0
  442. package/dist/types/core/claims/ids.d.ts +38 -0
  443. package/dist/types/core/deferred.d.ts +1 -0
  444. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  445. package/dist/types/core/footer.d.ts +2 -0
  446. package/dist/types/core/formatSpec.d.ts +43 -14
  447. package/dist/types/core/frame.d.ts +26 -59
  448. package/dist/types/core/frameText.d.ts +203 -0
  449. package/dist/types/core/geo/types.d.ts +2 -0
  450. package/dist/types/core/geometry.d.ts +3 -1
  451. package/dist/types/core/label/categoryRow.d.ts +19 -2
  452. package/dist/types/core/label/solver.d.ts +23 -2
  453. package/dist/types/core/normalize/shared.d.ts +14 -2
  454. package/dist/types/core/notes.d.ts +15 -2
  455. package/dist/types/core/reading.d.ts +12 -1
  456. package/dist/types/core/registry.d.ts +4 -5
  457. package/dist/types/core/request.d.ts +7 -1
  458. package/dist/types/core/schema/capability.d.ts +32 -7
  459. package/dist/types/core/schema/generatedColumns.d.ts +168 -0
  460. package/dist/types/core/seriesIdentity.d.ts +4 -1
  461. package/dist/types/core/sizing.d.ts +32 -1
  462. package/dist/types/core/structureCounts.d.ts +3 -1
  463. package/dist/types/core/text.d.ts +16 -0
  464. package/dist/types/core/theme.d.ts +33 -4
  465. package/dist/types/core/themeGeometry.d.ts +9 -0
  466. package/dist/types/core/themeRules.d.ts +2 -0
  467. package/dist/types/core/timeAxis.d.ts +6 -1
  468. package/dist/types/core/types/annotations.d.ts +74 -4
  469. package/dist/types/core/types/diagram.d.ts +7 -0
  470. package/dist/types/core/types/options.d.ts +118 -15
  471. package/dist/types/core/types/scene.d.ts +30 -2
  472. package/dist/types/core/types/table.d.ts +27 -3
  473. package/dist/types/core/types/theme.d.ts +23 -0
  474. package/dist/types/index.d.ts +2 -0
  475. package/dist/types/react/TableChart.d.ts +5 -0
  476. package/dist/types/react/barrelCharts.d.ts +16 -5
  477. package/dist/types/react/charts/butterfly.d.ts +2 -2
  478. package/dist/types/react/charts/dot.d.ts +7 -1
  479. package/dist/types/react/charts/pareto.d.ts +4 -1
  480. package/dist/types/react/charts/variance.d.ts +3 -1
  481. package/dist/types/react/hover/labelCard.d.ts +11 -2
  482. package/dist/types/react/prepare.d.ts +7 -1
  483. package/dist/types/theme.d.ts +2 -0
  484. package/dist/validate.js +23 -6
  485. package/docs/TELEMETRY.md +2 -2
  486. package/docs/manual.md +283 -65
  487. package/docs/reference/bar.md +15 -4
  488. package/docs/reference/bartable.md +17 -2
  489. package/docs/reference/box.md +15 -4
  490. package/docs/reference/bullet.md +21 -6
  491. package/docs/reference/butterfly.md +17 -6
  492. package/docs/reference/choropleth.md +16 -5
  493. package/docs/reference/cohort.md +25 -5
  494. package/docs/reference/column.md +19 -4
  495. package/docs/reference/combo.md +11 -5
  496. package/docs/reference/creative.md +17 -8
  497. package/docs/reference/diagram.md +6 -1
  498. package/docs/reference/dimswitch.md +71 -118
  499. package/docs/reference/dot.md +16 -7
  500. package/docs/reference/fixtures.md +94 -1
  501. package/docs/reference/funnel.md +14 -5
  502. package/docs/reference/gantt.md +17 -16
  503. package/docs/reference/grid.md +13 -3
  504. package/docs/reference/heatmap.md +16 -6
  505. package/docs/reference/histogram.md +2 -2
  506. package/docs/reference/kpi.md +5 -1
  507. package/docs/reference/likert.md +17 -4
  508. package/docs/reference/line.md +18 -5
  509. package/docs/reference/mekko.md +10 -5
  510. package/docs/reference/options.md +20 -15
  511. package/docs/reference/pareto.md +9 -5
  512. package/docs/reference/pie.md +9 -5
  513. package/docs/reference/pvm.md +16 -6
  514. package/docs/reference/pyramid.md +14 -4
  515. package/docs/reference/react.md +6 -7
  516. package/docs/reference/sankey.md +7 -3
  517. package/docs/reference/scatter.md +8 -4
  518. package/docs/reference/slope.md +15 -5
  519. package/docs/reference/sparkline.md +1 -1
  520. package/docs/reference/status.md +7 -1
  521. package/docs/reference/table.md +41 -110
  522. package/docs/reference/theme.md +12 -4
  523. package/docs/reference/tilemap.md +2 -4
  524. package/docs/reference/treemap.md +1 -1
  525. package/docs/reference/variance.md +12 -6
  526. package/docs/reference/waffle.md +1 -1
  527. package/docs/reference/warnings.md +1077 -0
  528. package/docs/reference/waterfall.md +20 -5
  529. package/docs/use-cases.md +25 -13
  530. package/llms.txt +19 -6
  531. package/package.json +18 -3
  532. package/dist/chunk-6364WO5D.js +0 -47
  533. package/dist/chunk-DQ7YMQVX.js +0 -26
  534. package/dist/chunk-EBB4PYBN.js +0 -24
  535. package/dist/chunk-FG5L2LUK.js +0 -89
  536. package/dist/chunk-IFQN4GKK.js +0 -1852
  537. package/dist/chunk-IRXVV65V.js +0 -24
  538. package/dist/chunk-JGFHNAHS.js +0 -22
  539. package/dist/chunk-JHWYG7V5.js +0 -24
  540. package/dist/chunk-M4SPKUZE.js +0 -7
  541. package/dist/chunk-O36WX56O.js +0 -13
  542. package/dist/chunk-QJWLNP64.js +0 -24
  543. package/dist/chunk-QZIHKQRH.js +0 -26
  544. package/dist/chunk-SE7MJ2LQ.js +0 -24
  545. package/dist/chunk-TXBO2LWM.js +0 -25
  546. package/dist/chunk-UPTXFTKH.js +0 -25
  547. package/dist/chunk-UREXN6WG.js +0 -25
  548. package/dist/chunk-UZLR25BW.js +0 -24
  549. package/dist/chunk-WIVFIVFZ.js +0 -27
  550. package/dist/chunk-WZL4EEBS.js +0 -11
  551. package/dist/chunk-XHRUXZD7.js +0 -28
  552. package/dist/chunk-ZWNRLIFT.js +0 -24
@@ -1,8 +1,3 @@
1
- /**
2
- * Chart registry. Charts are values; the registry is the single
3
- * source for the CLI, JSON Schemas, docs, React component generation, and
4
- * third-party extension.
5
- */
6
1
  import type { z } from 'zod';
7
2
  import type { Annotation, AnnotationKind } from './types/annotations.js';
8
3
  import type { Id, OwnerRef } from './types/cell.js';
@@ -58,6 +53,10 @@ export interface ChartCore<D = unknown, O extends ChartOptions = BaseOptions, M
58
53
  /** Alias-specific values for existing options, applied before authored options. */
59
54
  aliasDefaults?: Record<string, Partial<O>>;
60
55
  layout: LayoutFn<D, O, M, DV>;
56
+ /** Prepares private chart data once for all size and note trials in this request. */
57
+ prepareLayout?(data: D, options?: O): LayoutFn<D, O, M, DV>;
58
+ /** Wraps the finished layout, for a check that must see the chart the registry accepts. */
59
+ finishLayout?: (layout: LayoutFn<D, O, M, DV>) => LayoutFn<D, O, M, DV>;
61
60
  defaults: Partial<O>;
62
61
  annotationKinds: AnnotationKind[];
63
62
  lint?(data: D, options: O): LintWarning[];
@@ -1,6 +1,6 @@
1
1
  import { type TextMeasurer } from './text.js';
2
2
  import type { Size } from './geometry.js';
3
- import type { Annotation } from './types/annotations.js';
3
+ import { type Annotation } from './types/annotations.js';
4
4
  import type { BaseOptions, LocaleSpec, RenderTarget, StringsSpec } from './types/options.js';
5
5
  import type { Geometry, LayoutResult, LintWarning, RefusedLayout } from './types/scene.js';
6
6
  import type { ResolvedSizing } from './types/sizing.js';
@@ -68,6 +68,12 @@ export interface ResolvedChartRequest<D = unknown, O extends RequestOptions = Re
68
68
  export declare function resolveChartRequest<D, O extends object>(input: ChartRequest<D, O & RequestInputOptions>, context?: RequestContext): ResolvedChartRequest<D, O & RequestOptions>;
69
69
  /** The same registered layout used by components, measurement and artifacts. */
70
70
  export declare function layoutResolvedRequest(request: ResolvedChartRequest): LayoutResult;
71
+ /** @internal Host sizing path. Tables keep their fit diagnostics without drawing a scene. */
72
+ export declare function planResolvedRequest(request: ResolvedChartRequest): Pick<LayoutResult, 'type' | 'size' | 'sizing' | 'warnings'> & {
73
+ refused?: true;
74
+ plot?: Geometry['plot'];
75
+ scene: [];
76
+ };
71
77
  export interface ChartMeasurement extends ResolvedSizing {
72
78
  /**
73
79
  * The height needed at exactly the width asked for (the minimum width when the request is
@@ -13,7 +13,17 @@
13
13
  * Types whose layout draws nothing for any legend value: the
14
14
  * key is ignored with a warning there.
15
15
  */
16
+ declare const LEGEND_REFUSED_TYPES: readonly ['box', 'dimswitch', 'histogram', 'kpi', 'pvm', 'sankey', 'sparkline'];
16
17
  export declare const LEGEND_REFUSED: readonly string[];
18
+ export type LegendRefusedType = (typeof LEGEND_REFUSED_TYPES)[number];
19
+ /**
20
+ * Types that draw no annotation of any kind. The key is retired there: an old
21
+ * spec still draws and warns option-deprecated (retired.ts), and the schemas
22
+ * publish it as never.
23
+ */
24
+ declare const ANNOTATIONS_RETIRED_TYPES: readonly ['bartable', 'choropleth', 'cohort', 'dimswitch', 'grid', 'histogram', 'kpi', 'sankey', 'sparkline', 'status', 'table', 'tilemap', 'treemap', 'waffle'];
25
+ export declare const ANNOTATIONS_RETIRED: readonly string[];
26
+ export type AnnotationsRetiredType = (typeof ANNOTATIONS_RETIRED_TYPES)[number];
17
27
  /**
18
28
  * Types on which some legend values draw exactly what the default draws:
19
29
  * 'none' and 'auto' are ignored with a warning, and the values that draw a
@@ -22,6 +32,15 @@ export declare const LEGEND_REFUSED: readonly string[];
22
32
  export declare const LEGEND_DRAWS: Readonly<Record<string, readonly string[]>>;
23
33
  /** Options ignored with a warning when a chart type does not read them. */
24
34
  export declare const IGNORED_OPTION_KEYS: ReadonlySet<string>;
35
+ /**
36
+ * Settings these types accept and draw nothing for, by dotted path under
37
+ * options. Each is removed with one option-ignored warning that says what the
38
+ * setting does on the types that have it (retired.ts).
39
+ */
40
+ export declare const IGNORED_ON: Readonly<Record<string, {
41
+ types: readonly string[];
42
+ does: string;
43
+ }>>;
25
44
  /**
26
45
  * Per-capability narrowing of the shared base.
27
46
  *
@@ -47,6 +66,9 @@ export declare const IGNORED_OPTION_KEYS: ReadonlySet<string>;
47
66
  * inheriting every key.
48
67
  */
49
68
  export declare const OPTION_CAPABILITY: {
69
+ readonly labelPosition: {
70
+ readonly implementedBy: readonly ['bar', 'butterfly', 'column', 'combo', 'histogram', 'likert', 'mekko', 'pareto', 'pvm', 'pyramid', 'variance', 'waterfall'];
71
+ };
50
72
  readonly animate: {
51
73
  readonly implementedBy: readonly [];
52
74
  };
@@ -63,10 +85,10 @@ export declare const OPTION_CAPABILITY: {
63
85
  readonly implementedBy: readonly ['column', 'combo', 'pareto'];
64
86
  };
65
87
  readonly secondaryAxis: {
66
- readonly implementedBy: readonly ['box', 'combo'];
88
+ readonly implementedBy: readonly ['combo'];
67
89
  };
68
90
  readonly labels: {
69
- readonly implementedBy: readonly ['bar', 'box', 'bullet', 'butterfly', 'choropleth', 'cohort', 'column', 'combo', 'dot', 'funnel', 'gantt', 'heatmap', 'histogram', 'kpi', 'likert', 'line', 'mekko', 'pareto', 'pie', 'pyramid', 'scatter', 'slope', 'status', 'tilemap', 'variance'];
91
+ readonly implementedBy: readonly ['bar', 'bartable', 'box', 'bullet', 'butterfly', 'choropleth', 'cohort', 'column', 'combo', 'dot', 'funnel', 'gantt', 'heatmap', 'histogram', 'kpi', 'likert', 'line', 'mekko', 'pareto', 'pie', 'pvm', 'pyramid', 'scatter', 'slope', 'status', 'tilemap', 'variance'];
70
92
  };
71
93
  readonly hatchStrength: {
72
94
  readonly implementedBy: readonly ['bar', 'butterfly', 'choropleth', 'cohort', 'column', 'combo', 'funnel', 'grid', 'heatmap', 'line', 'mekko', 'slope', 'status', 'tilemap', 'waterfall'];
@@ -84,7 +106,7 @@ export declare const OPTION_CAPABILITY: {
84
106
  readonly implementedBy: readonly ['bar', 'bullet', 'butterfly', 'column', 'combo', 'dot', 'funnel', 'gantt', 'histogram', 'likert', 'pareto', 'pvm', 'pyramid', 'variance', 'waterfall'];
85
107
  };
86
108
  readonly highlight: {
87
- readonly implementedBy: readonly ['bar', 'bartable', 'box', 'bullet', 'butterfly', 'cohort', 'column', 'combo', 'diagram', 'dot', 'funnel', 'gantt', 'grid', 'heatmap', 'histogram', 'kpi', 'likert', 'line', 'mekko', 'pareto', 'pie', 'pvm', 'pyramid', 'sankey', 'scatter', 'slope', 'sparkline', 'status', 'table', 'dimswitch', 'variance', 'waterfall'];
109
+ readonly implementedBy: readonly ['bar', 'bartable', 'box', 'bullet', 'butterfly', 'cohort', 'column', 'combo', 'diagram', 'dot', 'funnel', 'gantt', 'grid', 'heatmap', 'histogram', 'kpi', 'likert', 'line', 'mekko', 'pie', 'pvm', 'pyramid', 'sankey', 'scatter', 'slope', 'sparkline', 'status', 'table', 'dimswitch', 'variance', 'waterfall'];
88
110
  };
89
111
  readonly detailFields: {
90
112
  readonly implementedBy: readonly ['bar', 'butterfly', 'column', 'combo', 'dot', 'funnel', 'heatmap', 'line', 'mekko', 'pie', 'slope'];
@@ -101,8 +123,7 @@ export declare const OPTION_CAPABILITY: {
101
123
  * Two shapes, both enforced by `narrowValueAxis`:
102
124
  *
103
125
  * - `VALUE_AXIS_CAPABILITY`: a sub-key only some types read, fail-closed like
104
- * the table above. box reads tickStep and reverse only to warn that it
105
- * ignores them. break is refused wherever no glyph is drawn.
126
+ * the table above. break is refused wherever no glyph is drawn.
106
127
  * - `VALUE_AXIS_ONLY`: a type whose layout reads just the listed sub-keys;
107
128
  * every other sub-key is refused there, and with no sub-key listed the
108
129
  * whole object is.
@@ -112,10 +133,10 @@ export declare const OPTION_CAPABILITY: {
112
133
  */
113
134
  export declare const VALUE_AXIS_CAPABILITY: {
114
135
  readonly tickStep: {
115
- readonly implementedBy: readonly ['bar', 'box', 'bullet', 'column', 'combo', 'dot', 'histogram', 'line', 'mekko', 'scatter', 'variance'];
136
+ readonly implementedBy: readonly ['bar', 'bullet', 'column', 'combo', 'dot', 'histogram', 'line', 'mekko', 'scatter', 'variance'];
116
137
  };
117
138
  readonly reverse: {
118
- readonly implementedBy: readonly ['box', 'line', 'scatter'];
139
+ readonly implementedBy: readonly ['line', 'scatter'];
119
140
  };
120
141
  readonly break: {
121
142
  readonly implementedBy: readonly ['bar', 'box', 'column', 'histogram', 'pvm', 'waterfall'];
@@ -125,6 +146,9 @@ export declare const VALUE_AXIS_CAPABILITY: {
125
146
  };
126
147
  };
127
148
  export declare const VALUE_AXIS_ONLY: {
149
+ readonly box: {
150
+ readonly keys: readonly ["show", "min", "max", "gridlines", "break"];
151
+ };
128
152
  readonly waterfall: {
129
153
  readonly keys: readonly ["break"];
130
154
  };
@@ -224,3 +248,4 @@ export declare function schemaRefusedKeys(type: string): {
224
248
  * (OPTION_CAPABILITY.labels).
225
249
  */
226
250
  export declare const LABEL_KINDS: Readonly<Record<string, readonly string[]>>;
251
+ export {};
@@ -0,0 +1,168 @@
1
+ /**
2
+ * The ids of the columns, blocks and rows a chart type generates itself: the
3
+ * ones an author cannot name in `data`. The option builders beside this file
4
+ * print these lists in the reference, and `generatedIdWarnings` prints them
5
+ * when an id is wrong. This module stays free of zod, because layouts import it.
6
+ *
7
+ * Naming rule: the name column is `label`, the marks are `plot`, every other
8
+ * column is its head word in lowerCamel. A type with no generated columns has
9
+ * no entry. The generic `table` has none: `data.columns[]` authors its columns.
10
+ */
11
+ import type { LintWarning } from '../types/scene.js';
12
+ export interface GeneratedIds {
13
+ /** The ids `columnVisibility` takes. */
14
+ columns: readonly string[];
15
+ /** The ids `columnOverrides` takes, where they differ from `columns`. */
16
+ tracks?: readonly string[];
17
+ /** The ids `columnOrder` takes: whole blocks, never single columns. */
18
+ blocks: readonly string[];
19
+ /** The ids `rowVisibility`, `rowOrder` and `rowOverrides` take. */
20
+ rows: readonly string[];
21
+ /** The column ids that come from the data, in words. */
22
+ columnsFromData?: string;
23
+ /** The row ids that come from the data, in words. */
24
+ rowsFromData?: string;
25
+ }
26
+ export declare const GENERATED_COLUMNS: {
27
+ readonly bar: {
28
+ readonly columns: readonly ["label"];
29
+ readonly blocks: readonly [];
30
+ readonly rows: readonly [];
31
+ };
32
+ readonly bartable: {
33
+ readonly columns: readonly ["label"];
34
+ readonly columnsFromData: 'each data.columns id and each data.panels id';
35
+ readonly blocks: readonly ["numbers", "panels"];
36
+ readonly rows: readonly [];
37
+ };
38
+ readonly box: {
39
+ readonly columns: readonly ["label", "n", "median"];
40
+ readonly blocks: readonly [];
41
+ readonly rows: readonly [];
42
+ };
43
+ readonly bullet: {
44
+ readonly columns: readonly ["label", "actual", "share", "delta", "target", "gap"];
45
+ readonly blocks: readonly ["actual", "share", "delta", "target", "gap", "plot"];
46
+ readonly rows: readonly [];
47
+ };
48
+ readonly butterfly: {
49
+ readonly columns: readonly ["label", "diff"];
50
+ readonly blocks: readonly [];
51
+ readonly rows: readonly [];
52
+ };
53
+ readonly choropleth: {
54
+ readonly columns: readonly ["swatch", "code", "value"];
55
+ readonly blocks: readonly [];
56
+ readonly rows: readonly [];
57
+ readonly rowsFromData: 'each region id, through the aliases of the map pack';
58
+ };
59
+ readonly cohort: {
60
+ readonly columns: readonly ["size"];
61
+ readonly tracks: readonly ["label", "size", "periods"];
62
+ readonly blocks: readonly ["size", "periods"];
63
+ readonly rows: readonly [];
64
+ };
65
+ readonly creative: {
66
+ readonly columns: readonly ["label", "value", "median", "delta"];
67
+ readonly blocks: readonly ["label", "value", "median", "delta"];
68
+ readonly rows: readonly ["ctr", "cpa", "roas", "hookRate", "holdRate", "frequency"];
69
+ };
70
+ readonly diagram: {
71
+ readonly columns: readonly ["label", "value"];
72
+ readonly blocks: readonly [];
73
+ readonly rows: readonly [];
74
+ };
75
+ readonly dimswitch: {
76
+ readonly columns: readonly ["label", "range", "pp", "pl"];
77
+ readonly columnsFromData: 'each displayed period id';
78
+ readonly blocks: readonly ["block", "periods"];
79
+ readonly rows: readonly [];
80
+ readonly rowsFromData: 'dimension.total.id, group:<measures[].group as authored>, and group: for the ungrouped section';
81
+ };
82
+ readonly dot: {
83
+ readonly columns: readonly ["label", "gap"];
84
+ readonly blocks: readonly [];
85
+ readonly rows: readonly [];
86
+ };
87
+ readonly funnel: {
88
+ readonly columns: readonly ["label", "value", "totalCvr"];
89
+ readonly blocks: readonly [];
90
+ readonly rows: readonly [];
91
+ };
92
+ readonly gantt: {
93
+ readonly columns: readonly ["name", "meta0", "meta1", "meta2"];
94
+ readonly blocks: readonly ["meta", "plot"];
95
+ readonly rows: readonly [];
96
+ };
97
+ readonly grid: {
98
+ readonly columns: readonly ["unit", "headline", "span"];
99
+ readonly tracks: readonly ["gutter"];
100
+ readonly blocks: readonly ["gutter", "plot"];
101
+ readonly rows: readonly [];
102
+ };
103
+ readonly heatmap: {
104
+ readonly columns: readonly ["label"];
105
+ readonly columnsFromData: 'each data.categories id';
106
+ readonly blocks: readonly [];
107
+ readonly rows: readonly [];
108
+ };
109
+ readonly kpi: {
110
+ readonly columns: readonly ["label", "value"];
111
+ readonly blocks: readonly [];
112
+ readonly rows: readonly [];
113
+ };
114
+ readonly likert: {
115
+ readonly columns: readonly ["label", "net", "base"];
116
+ readonly blocks: readonly ["plot", "net", "base"];
117
+ readonly rows: readonly [];
118
+ };
119
+ readonly pvm: {
120
+ readonly columns: readonly ["label", "value"];
121
+ readonly blocks: readonly [];
122
+ readonly rows: readonly [];
123
+ };
124
+ readonly pyramid: {
125
+ readonly columns: readonly ["label"];
126
+ readonly blocks: readonly [];
127
+ readonly rows: readonly [];
128
+ };
129
+ readonly sankey: {
130
+ readonly columns: readonly ["first", "last"];
131
+ readonly blocks: readonly [];
132
+ readonly rows: readonly [];
133
+ };
134
+ readonly slope: {
135
+ readonly columns: readonly ["change"];
136
+ readonly blocks: readonly [];
137
+ readonly rows: readonly [];
138
+ };
139
+ readonly status: {
140
+ readonly columns: readonly ["label"];
141
+ readonly columnsFromData: 'each data.columns id';
142
+ readonly blocks: readonly [];
143
+ readonly rows: readonly [];
144
+ };
145
+ readonly waterfall: {
146
+ readonly columns: readonly ["label", "value"];
147
+ readonly blocks: readonly [];
148
+ readonly rows: readonly [];
149
+ };
150
+ };
151
+ /** One entry of `columnOverrides`: the fields a type reads are in its schema. */
152
+ export interface ColumnOverride {
153
+ width?: number;
154
+ align?: 'left' | 'right' | 'center';
155
+ headAlign?: 'left' | 'right' | 'center';
156
+ label?: string;
157
+ }
158
+ export type GeneratedColumnType = keyof typeof GENERATED_COLUMNS;
159
+ export type GeneratedIdKey = 'columnVisibility' | 'columnOverrides' | 'columnOrder' | 'rowVisibility' | 'rowOrder' | 'rowOverrides';
160
+ /** The ids one key takes on one type, with the ids from the data in words: 'label, range, or each displayed period id'. */
161
+ export declare function generatedIdList(type: GeneratedColumnType, key: GeneratedIdKey): string;
162
+ /**
163
+ * What a generated-id key warns on one draw. `authored` is the key's value: a
164
+ * record, or a list for an order. `drawn` holds the ids the current form draws.
165
+ * A wrong id warns with the type's list and never refuses, and a hidden name
166
+ * column warns and stays. The caller ignores every id this returns a warning for.
167
+ */
168
+ export declare function generatedIdWarnings(type: GeneratedColumnType, key: GeneratedIdKey, authored: readonly string[] | Readonly<Record<string, unknown>> | undefined, drawn: readonly string[]): LintWarning[];
@@ -113,7 +113,10 @@ export interface IdentityCollectionOptions {
113
113
  }
114
114
  export declare function identityCollector(options: object): IdentityCollectionOptions;
115
115
  export declare function collectSeriesIdentities(layout: (data: unknown, options: any) => unknown, data: unknown, options: object): SeriesIdentity[];
116
- /** Match a complete name in visible text, never a substring of another word. */
116
+ /**
117
+ * Match a complete name in visible text, never a substring of another word.
118
+ * A break in the name, authored or wrapped, matches any break in the text.
119
+ */
117
120
  export declare function textNames(node: SceneNode, name: string): boolean;
118
121
  /** A key or direct name maps a series to its marks; prose alone does not. */
119
122
  export declare function nameIsDrawn(geometry: Geometry<object, object>, name: string, id?: string): boolean;
@@ -292,6 +292,24 @@ export type LayoutCall<O extends ChartOptions = ChartOptions, M extends object =
292
292
  probe(options?: O): LayoutResult<M, DV>;
293
293
  };
294
294
  export declare const FORCE_COMPACT: unique symbol;
295
+ /**
296
+ * Set by render's last step before a width refusal: the form the layout picked for the width has a floor
297
+ * above it, so the layout draws the form a narrower width draws (the bullet's card rows, the heatmap's
298
+ * wrapped row names, the status board's heads wrapped in their columns, the waterfall's step values
299
+ * thinned, the grid's one-column card form, the waffle's panels in fewer columns). Only these types read it.
300
+ */
301
+ export declare const NARROW_FORM: unique symbol;
302
+ export declare const NARROW_FORM_TYPES: ReadonlySet<string>;
303
+ /** Set by `sideKeyGivesWay`: the frame stands the key in the row above the plot (its `sideKeyGivesWay` input). */
304
+ export declare const SIDE_KEY_OFF: unique symbol;
305
+ export declare const sideKeyOff: (options: object) => boolean;
306
+ /**
307
+ * Compact, the last form before a refusal, keeps a key beside the plot only where the chart then fits its width;
308
+ * else the chart lays out again with the key in the row above the plot, as a narrower width draws it.
309
+ */
310
+ export declare function sideKeyGivesWay<O extends {
311
+ mode?: unknown;
312
+ }, G extends Geometry<object, object>>(options: O, geo: G, again: (options: O) => G): G;
295
313
  /** The owning chart's width-only search; its rejected probes do not need repair advice. */
296
314
  export declare const WIDTH_PROBE: unique symbol;
297
315
  export declare const FIXED_SIZE_PROBE: unique symbol;
@@ -329,7 +347,20 @@ export interface CardHeightMemo {
329
347
  restore?: () => void;
330
348
  }[];
331
349
  }
332
- /** A chart-owned wider-card request shares the current call's dependency results. */
350
+ /**
351
+ * A chart-owned wider-card request shares the current call's dependency results.
352
+ * Requests match by content: each prepared pass resolves its own theme, locale and strings, and a
353
+ * compact gantt pass builds its request from the options the last wider draw left behind. By
354
+ * identity, every such pass missed and drew the wider card again.
355
+ */
333
356
  export declare function cardReferenceHeight<D, O extends ChartOptions>(data: D, options: O, wider: O, draw: (options: O) => LayoutResult, capture?: () => () => void): number | undefined;
334
357
  /** Run one top-level layout call with a fresh full-layout memo; nested calls share it. */
335
358
  export declare function withLayoutMemo<T>(run: () => T): T;
359
+ /**
360
+ * The floor `fitSize` checks before it lays anything out, and whether the frame is in the tight band
361
+ * (compact below the type's own minimum). Size advice reads it to skip widths this check refuses.
362
+ */
363
+ export declare function sizeGate<D, O extends ChartOptions, M extends object, DV extends object>(definition: ChartCore<D, O, M, DV>, data: D, options: O | undefined, compactFallback: boolean, declared?: ChartSizing, requested?: Size): {
364
+ tight: boolean;
365
+ gatePolicy: ChartSizing;
366
+ };
@@ -7,4 +7,6 @@ export interface StructureCount {
7
7
  text: string;
8
8
  }
9
9
  import type { BaseOptions } from './types/options.js';
10
- export declare function structureCount(what: StructureCount['what'], n: number, text?: string | undefined, options?: Pick<BaseOptions, 'locale' | 'strings'>): StructureCount;
10
+ /** The default phrase reads the locale, so a call without its own text must pass the options. */
11
+ export declare function structureCount(what: StructureCount['what'], n: number, text: string): StructureCount;
12
+ export declare function structureCount(what: StructureCount['what'], n: number, text: string | undefined, options: Pick<BaseOptions, 'locale' | 'strings'>): StructureCount;
@@ -87,6 +87,16 @@ export declare function estimateTextWidthForFace(text: string, font: FontSpec, f
87
87
  * fixed by the spec now so adding tables later is non-breaking.
88
88
  */
89
89
  export declare function createMeasurer(): TextMeasurer;
90
+ export declare function markCachedTextMeasurer<T extends TextMeasurer>(measure: T): T;
91
+ export declare const isCachedTextMeasurer: (measure: TextMeasurer) => boolean;
92
+ /**
93
+ * An exact measurer over `rawWidth`, which must be a pure function of the text
94
+ * and the font's fields. The cache is keyed by field values, because callers
95
+ * build new font objects and may change one in place, and belongs to this
96
+ * measurer, so a caller's wrapper still sees its own calls. Every call returns
97
+ * a new object, which the caller may change.
98
+ */
99
+ export declare function cachedMeasurer(rawWidth: (text: string, font: FontSpec) => number): TextMeasurer;
90
100
  /** Cap height in px of a resolved face (tables hold it in 1/1000 em). */
91
101
  export declare function capHeightOfFace(font: FontSpec, face: Face | undefined): number | undefined;
92
102
  export declare const defaultMeasurer: TextMeasurer;
@@ -99,6 +109,12 @@ export declare function measureText(text: string, font: FontSpec): TextSize;
99
109
  * takes its one-line width.
100
110
  */
101
111
  export declare function twoLineWidth(text: string, font: FontSpec, measure: TextMeasurer, breakAfter?: boolean): number;
112
+ /**
113
+ * `twoLineWidth` for any line count: the narrowest width at which `wrapText`
114
+ * holds a text on `lines` lines without a cut. More paragraphs than lines join,
115
+ * as `fitText` joins them.
116
+ */
117
+ export declare function lineBlockWidth(text: string, lines: number, font: FontSpec, measure: TextMeasurer, breakAfter?: boolean): number;
102
118
  /** A name split where a line may break after `_ - / .` (NAME_BREAK); joined, the pieces are the name. */
103
119
  export declare function splitNameBreaks(text: string): string[];
104
120
  export declare function wrapText(text: string, font: FontSpec, maxWidth: number, maxLines?: number, measure?: TextMeasurer,
@@ -13,6 +13,28 @@ export type TypeWidthClass = 'S' | 'M' | 'L';
13
13
  * clamp to the smallest class rather than inventing a sub-S scale.
14
14
  */
15
15
  export declare function typeWidthClass(width: number): TypeWidthClass;
16
+ /** The largest width class `typeWidthClass` returns while `withTypeClassCap` runs; undefined outside it. */
17
+ export declare function typeClassCap(): TypeWidthClass | undefined;
18
+ /**
19
+ * Runs a layout whose canvases take at most the width class `cap`: a chart refused for width in the
20
+ * class its width selects draws in the next smaller one (request.ts, smallerClass).
21
+ */
22
+ export declare function withTypeClassCap<T>(cap: TypeWidthClass, run: () => T): T;
23
+ /** The type class cap and the canvas margin step of the running layout: the part of a layout cache key they set. */
24
+ export declare function layoutStepKey(): string;
25
+ /**
26
+ * Runs a layout whose default canvas margins, at a width in a margin step band (`inMarginStepBand`), are those of the
27
+ * step under it: a chart refused for width just over a margin step draws with the margins of the width just under
28
+ * it (request.ts, marginStep). Other widths keep their margins.
29
+ */
30
+ export declare function withMarginStepBelow<T>(run: () => T): T;
31
+ /** Whether the default margins at this width leave a narrower plot than the pixel under its margin step has. */
32
+ export declare function inMarginStepBand(width: number): boolean;
33
+ /**
34
+ * The width a step at 720 or 1080 px reads. Under a class cap it is at most the last pixel of the capped
35
+ * class, so a capped layout takes the steps of the width just under the step; outside a cap it is the width.
36
+ */
37
+ export declare function classStepWidth(width: number): number;
16
38
  /**
17
39
  * The smallest size the theme gives its title across the width classes. A
18
40
  * compact frame sets its title at this size in the title weight, so
@@ -479,16 +501,23 @@ export declare function markRolePaint(role: string, fill?: boolean): Paint;
479
501
  /**
480
502
  * The fill of each series that draws in a colour role, by series id. Series of
481
503
  * one chart that share a role take distinct steps of the role's colour (the
482
- * pie ramp, decided in the active theme), the first series the full colour, so
483
- * the reader can tell them apart by more than their order. A series with its
504
+ * role steps, decided in the active theme), strongest first, so the reader
505
+ * can tell them apart by more than their order and the steps run one way. The
506
+ * role's full colour is one of the steps. A series with its
484
507
  * own fill keeps it and takes no step. `fill: false` steps the role's stroke
485
- * colour (a dot), as markRolePaint.
508
+ * colour (a line or a dot), as markRolePaint, and holds each step to the
509
+ * stroke floor (roleSteps). `fill` as a test by series id serves a chart that
510
+ * draws some series as fills and others as strokes (a combo's columns and
511
+ * lines): a role whose series mix both takes one ladder of stroke steps, so a
512
+ * column and a line never land on one colour. On that ladder the filled marks
513
+ * take the steps nearest the role's colour and the lines the others, each kind
514
+ * strongest first, so a large area never draws the darkest step.
486
515
  */
487
516
  export declare function colorRolePaints(series: readonly {
488
517
  id: string;
489
518
  colorRole?: string;
490
519
  fill?: string;
491
- }[], fill?: boolean): Map<string, Paint>;
520
+ }[], fill?: boolean | ((id: string) => boolean)): Map<string, Paint>;
492
521
  /** A mark's colour role as its paint token: the neutral paints a mark through `neutralMark`. */
493
522
  export declare function markRoleToken(role: string): PaintToken;
494
523
  /**
@@ -0,0 +1,9 @@
1
+ import type { Geometry } from './types/scene.js';
2
+ import type { RenderTarget } from './types/options.js';
3
+ import type { PresentationInfo } from './types/sizing.js';
4
+ import { type TypeWidthClass } from './theme.js';
5
+ import type { Theme } from './types/theme.js';
6
+ /** Paint values are excluded; anything that can change layout remains. */
7
+ export declare function themeGeometryTokens(theme: Theme, target?: RenderTarget): unknown;
8
+ /** Output metadata from the final layout. Text roles are supplied by the text lanes. */
9
+ export declare function presentationInfo(geometry: Geometry<object, object>, target: RenderTarget, inheritedClass?: TypeWidthClass, textScale?: number): PresentationInfo;
@@ -6,6 +6,8 @@
6
6
  */
7
7
  import type { LintWarning } from './types/scene.js';
8
8
  import type { Theme } from './types/theme.js';
9
+ /** The table ink roles that step back: they fall back to the muted ink and read at its floor. */
10
+ export declare const MUTED_TABLE_INKS: ReadonlySet<string>;
9
11
  /** The paint roles and chart types present in a render. Omitted for full theme validation. */
10
12
  export interface ThemeUsage {
11
13
  roles: ReadonlySet<string>;
@@ -63,13 +63,18 @@ export declare function authoredTimeStep(step: {
63
63
  unit: TimeUnit | 'quarter';
64
64
  step?: number;
65
65
  }): TimeStep;
66
+ /**
67
+ * A sub-day step longer than a day ticks at each local midnight, so its ticks follow the days of the
68
+ * range and not the step. Over more days than the plot has pixels those ticks only make a solid bar.
69
+ */
70
+ export declare function timeStepOutrunsPlot(lo: number, hi: number, step: TimeStep, pixels: number): boolean;
66
71
  /**
67
72
  * The ticks of one step inside [lo, hi], on the zone's wall clock: 6-hour
68
73
  * ticks at 00, 06, 12 and 18 local time, days at local midnight, weeks on the
69
74
  * week start, months on the 1st, years on 1 January. A wall time the zone
70
75
  * repeats ticks at both instants; one it skips has no tick.
71
76
  */
72
- export declare function timeTicks(lo: number, hi: number, step: TimeStep, clock: ZoneClock, weekStartsOn?: 0 | 1, limit?: number): number[] | undefined;
77
+ export declare function timeTicks(lo: number, hi: number, step: TimeStep, clock: ZoneClock, weekStartsOn?: 0 | 1, limit?: number, pixels?: number): number[] | undefined;
73
78
  /** The text of one tick at its step: '06:00', '24 Oct', 'Oct', '2026'. */
74
79
  export declare function timeTickText(ms: number, step: TimeStep, clock: ZoneClock, language?: string): string;
75
80
  /**
@@ -23,6 +23,15 @@ export type AnchorRef<X extends string | number = Id> = X | {
23
23
  } | {
24
24
  valueLineId: Id;
25
25
  };
26
+ /** A drawing's point: an anchor, or the spot on a category's position at `value`, in axis units. */
27
+ export type DrawingPoint<X extends string | number = Id> = AnchorRef<X> | {
28
+ categoryId: X;
29
+ value: number;
30
+ };
31
+ /** A line's or an arrow's end: a point, or the edge of a `text` annotation, by its id. */
32
+ export type DrawingEnd<X extends string | number = Id> = DrawingPoint<X> | {
33
+ annotationId: Id;
34
+ };
26
35
  export interface AnnotationBase {
27
36
  id?: Id;
28
37
  text?: string;
@@ -34,7 +43,8 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
34
43
  kind: 'diff';
35
44
  from: AnchorRef<X>;
36
45
  to: AnchorRef<X>;
37
- mode?: 'relative' | 'absolute' | 'reversed';
46
+ /** 'relative' (default) the percent change from `from` to `to`, 'reversed' from `to` to `from`, 'absolute' the value difference, 'both' the value difference and the percent change as "+149 (+36%)". */
47
+ mode?: 'relative' | 'absolute' | 'reversed' | 'both';
38
48
  } & GapPlacement) | (AnnotationBase & {
39
49
  kind: 'cagr';
40
50
  from?: AnchorRef<X>;
@@ -47,8 +57,9 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
47
57
  }) | (AnnotationBase & {
48
58
  /**
49
59
  * A bracket over the steps `from` to `to` (inclusive) of a bridge. The engine adds up the
50
- * steps and prints the sum, after `label` when one is given: "Commercial +81". Brackets
51
- * over one chart stand in one row above the steps.
60
+ * steps and prints the sum, after `label` when one is given: "Commercial +81". A bracket
61
+ * stands directly above its own bars and their values, or in the row at the top of the plot
62
+ * when that seat is taken.
52
63
  */
53
64
  kind: 'bracket';
54
65
  from: X;
@@ -58,6 +69,8 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
58
69
  kind: 'delta';
59
70
  at: AnchorRef<X>;
60
71
  vs: AnchorRef<X> | number;
72
+ /** 'absolute' (default) prints at − vs, 'relative' the percent change from vs, 'both' the two as "+149 (+36%)". */
73
+ mode?: 'absolute' | 'relative' | 'both';
61
74
  } & GapPlacement) | (AnnotationBase & {
62
75
  kind: 'abs';
63
76
  at: AnchorRef<X>;
@@ -122,7 +135,41 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
122
135
  kind: 'indicator100';
123
136
  side?: 'left' | 'right'; /** Refused: it prints a fixed '100%'. */
124
137
  text?: never;
125
- }) | (AnnotationBase & {
138
+ })
139
+ /** Authored text at a point, seated by the label solver. It takes `id` and `priority` only. */
140
+ | {
141
+ kind: 'text';
142
+ id?: Id;
143
+ priority?: number;
144
+ at: DrawingPoint<X>;
145
+ text: string;
146
+ format?: never;
147
+ }
148
+ /**
149
+ * A straight line or arrow between two points, in the ink and rule width of a bracket. An end may be
150
+ * `{ annotationId }` of a `text` annotation: it then starts at the nearest edge of that text, at every size.
151
+ */
152
+ | {
153
+ kind: 'line' | 'arrow';
154
+ id?: Id;
155
+ from: DrawingEnd<X>;
156
+ to: DrawingEnd<X>;
157
+ dashed?: boolean;
158
+ text?: never;
159
+ format?: never;
160
+ priority?: never;
161
+ }
162
+ /** An unfilled box with two points as opposite corners. An end given by category spans that category's band. */
163
+ | {
164
+ kind: 'box';
165
+ id?: Id;
166
+ from: DrawingPoint<X>;
167
+ to: DrawingPoint<X>;
168
+ dashed?: boolean;
169
+ text?: never;
170
+ format?: never;
171
+ priority?: never;
172
+ } | (AnnotationBase & {
126
173
  /**
127
174
  * Inclusive category span as a shade or bracket, or a value-axis plan
128
175
  * corridor / tolerance / attainment band. Era bands keep from/to as
@@ -182,6 +229,13 @@ export type Annotation<X extends string | number = Id> = (AnnotationBase & {
182
229
  * ends, dashed guides, a bracket with an arrowhead and the gap as a large
183
230
  * number. 'auto' (default) draws it where gapFill washes the same two series
184
231
  * and keeps the label elsewhere. 'label' keeps the label at the anchor.
232
+ * On a bar chart, a diff between two categories of one series rides in the
233
+ * shorter bar's row under 'auto': an arrow from the longer bar's end to the
234
+ * `to` end with the number in a break of the shaft. 'label' keeps the arrow
235
+ * off the rows with its label beside it.
236
+ * On a column chart, a diff or delta between the totals of two columns
237
+ * that are not neighbours runs as the growth bracket over the columns under
238
+ * 'auto', as a cagr does. 'label' keeps the arrow between the columns.
185
239
  * Other anchors and other charts keep the label.
186
240
  */
187
241
  export interface GapPlacement {
@@ -235,5 +289,21 @@ export declare function defaultAnnotationId(annotation: {
235
289
  kind: AnnotationKind;
236
290
  id?: Id;
237
291
  }, index: number): Id;
292
+ /**
293
+ * Where the author wrote an annotation: `['annotations', i]` at the chart root or `['options', 'annotations', i]`.
294
+ * The request sets it on each authored entry before the chart drops the kinds it does not draw, so a refusal points at
295
+ * the authored entry, not at its position in the list the chart kept. An entry the engine adds has none.
296
+ */
297
+ export { ANNOTATION_ORIGIN, withAnnotationOrigins } from '../annotationOrigin.js';
298
+ /** Options as a caller receives them: annotations without the origin the engine keeps for refusal pointers. */
299
+ export declare function withoutAnnotationOrigins<T>(options: T): T;
300
+ /**
301
+ * The pointer segments and the display name of an annotation: from its origin, or, for an annotation without one,
302
+ * no pointer and the name the site gave before (`annotations[index]` by default).
303
+ */
304
+ export declare function annotationRef(annotation: unknown, index: number, fallback?: string): {
305
+ segments: (string | number)[];
306
+ name: string;
307
+ };
238
308
  /** Technical purpose text used by discovery commands for every annotation kind. */
239
309
  export declare const ANNOTATION_KIND_PURPOSES: Record<AnnotationKind, string>;