boardplot 0.57.0 → 0.58.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (496) hide show
  1. package/CHANGELOG.md +311 -0
  2. package/README.md +48 -14
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-FXNTFSA4.js} +2 -2
  4. package/dist/{ReaderBox-GCIITQCX.js → ReaderBox-WVOT7VVJ.js} +8 -7
  5. package/dist/{annotateEngine-JMZI6QEG.js → annotateEngine-57L26X77.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-6LQKU6YN.js → chunk-23FT7RLN.js} +11 -10
  8. package/dist/{chunk-5WSIH4SR.js → chunk-2CQBBN7M.js} +4 -4
  9. package/dist/chunk-2DS4MT7T.js +25 -0
  10. package/dist/{chunk-QFIRPOXR.js → chunk-2HII2B6S.js} +3 -3
  11. package/dist/{chunk-JMOBA5ES.js → chunk-2IRMGCYE.js} +2 -2
  12. package/dist/{chunk-JKXJWCJ5.js → chunk-2SWSUNA4.js} +116 -54
  13. package/dist/{chunk-O7Y6RJ4D.js → chunk-33EBLJVZ.js} +11 -11
  14. package/dist/{chunk-EHQLLZCQ.js → chunk-34PKJZRY.js} +59 -34
  15. package/dist/{chunk-SHAAMKN7.js → chunk-35ZJUZUO.js} +18 -18
  16. package/dist/{chunk-TGR6PRKG.js → chunk-3BMPYY26.js} +6 -3
  17. package/dist/{chunk-XJUZC53Y.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-H3EWFSWI.js → chunk-3ESWPMDW.js} +43 -29
  19. package/dist/{chunk-6KHRMK3I.js → chunk-3M2F7KSS.js} +158 -75
  20. package/dist/{chunk-UBXIGE2P.js → chunk-3MFVJMP6.js} +2 -2
  21. package/dist/{chunk-MOQFYJ3F.js → chunk-3OSQ32GN.js} +5 -5
  22. package/dist/{chunk-HGPFEG2L.js → chunk-3RXUA6VY.js} +5 -5
  23. package/dist/{chunk-I65OLJ2X.js → chunk-42QKUSHJ.js} +13 -3
  24. package/dist/{chunk-FAFUMSPR.js → chunk-4DK67I3B.js} +83 -51
  25. package/dist/{chunk-EEBMK6T6.js → chunk-4DMRIL5K.js} +8 -8
  26. package/dist/chunk-4M3UADCM.js +602 -0
  27. package/dist/{chunk-WSKZZ2ZB.js → chunk-4OJF6DXL.js} +538 -503
  28. package/dist/{chunk-UD6U4EF5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-I7KDPCC7.js → chunk-4TUU3UGY.js} +18 -10
  30. package/dist/{chunk-6ZN2XJFI.js → chunk-54YO56IK.js} +1 -1
  31. package/dist/{chunk-JMGB444D.js → chunk-5ACFYNA4.js} +8 -4
  32. package/dist/{chunk-BQIADGJB.js → chunk-5CYLT6FJ.js} +5 -5
  33. package/dist/{chunk-IVQT2E3Y.js → chunk-5I4RPBNE.js} +13 -13
  34. package/dist/{chunk-LW4ZQGVL.js → chunk-5KAYLRRP.js} +7 -8
  35. package/dist/{chunk-2BHLRHF2.js → chunk-5SVGTQTW.js} +4 -4
  36. package/dist/{chunk-5JTRCSBN.js → chunk-62BDQTO6.js} +2 -2
  37. package/dist/{chunk-4RN4OM6I.js → chunk-63JUV7NR.js} +3 -3
  38. package/dist/chunk-645BGVPP.js +26 -0
  39. package/dist/{chunk-JIH52I36.js → chunk-65U6ZBZZ.js} +119 -85
  40. package/dist/{chunk-3DUGZ7ML.js → chunk-6ALORYH7.js} +46 -31
  41. package/dist/{chunk-HB3TH7GY.js → chunk-6AVUTZ6W.js} +10 -6
  42. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  43. package/dist/{chunk-W5SVS4B6.js → chunk-6JFQCVNN.js} +4 -4
  44. package/dist/{chunk-IZRTNCJQ.js → chunk-6JTCFPAD.js} +5 -5
  45. package/dist/{chunk-5TUDYKNL.js → chunk-6NGKQNTB.js} +42 -29
  46. package/dist/{chunk-IUVJVMKS.js → chunk-6V3A3MTG.js} +55 -32
  47. package/dist/{chunk-FJKFYQ5I.js → chunk-6YBNVI5I.js} +36 -28
  48. package/dist/chunk-76GPN6AT.js +72 -0
  49. package/dist/{chunk-SHCW2TCA.js → chunk-7GRR72MY.js} +25 -23
  50. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  51. package/dist/{chunk-Y5IKCXQR.js → chunk-7YZZCQT3.js} +5 -5
  52. package/dist/chunk-A65B23JK.js +113 -0
  53. package/dist/{chunk-2WTD3GCR.js → chunk-A6N24NGW.js} +3 -3
  54. package/dist/{chunk-72OJBDRB.js → chunk-AAQWFTDM.js} +52 -41
  55. package/dist/{chunk-4JNHF6JW.js → chunk-AGJ2QL4A.js} +84 -40
  56. package/dist/{chunk-I3DLERI7.js → chunk-AICO24HJ.js} +5 -2
  57. package/dist/{chunk-LSKCKGCF.js → chunk-AJGSCVVW.js} +2 -2
  58. package/dist/{chunk-7P7D6WXR.js → chunk-AKZOQGF3.js} +3 -3
  59. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  60. package/dist/{chunk-VY67Q6CJ.js → chunk-AMBQ6SWU.js} +36 -33
  61. package/dist/{chunk-73O6AOAA.js → chunk-AQ2PQ7FK.js} +241 -140
  62. package/dist/{chunk-XFCBH3TI.js → chunk-BHLNSJG7.js} +3 -3
  63. package/dist/{chunk-6XU5XGYV.js → chunk-BQ7SN7AW.js} +5 -5
  64. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  65. package/dist/{chunk-LSR3SBJ4.js → chunk-BSZOQJXB.js} +234 -136
  66. package/dist/{chunk-KJLH5EHD.js → chunk-BVIJCUWW.js} +175 -110
  67. package/dist/{chunk-2AJWRVZ2.js → chunk-C47POAC5.js} +1 -1
  68. package/dist/{chunk-AOIZJ7GR.js → chunk-C4SQU2PB.js} +6 -6
  69. package/dist/{chunk-Y7Q3VEYC.js → chunk-CCAAI56H.js} +30 -10
  70. package/dist/{chunk-T3WCDDIL.js → chunk-CDUR3KWV.js} +2 -2
  71. package/dist/{chunk-T5MBORBK.js → chunk-CFESVCZR.js} +1 -1
  72. package/dist/{chunk-EEL2N4Y6.js → chunk-CKEFAD4R.js} +5 -5
  73. package/dist/{chunk-WE5WVQE4.js → chunk-CMPHT2LS.js} +3 -3
  74. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  75. package/dist/{chunk-JSA3ESEJ.js → chunk-CR5FP5SF.js} +1 -1
  76. package/dist/{chunk-NCCDEUHD.js → chunk-CSMVKG2C.js} +1 -1
  77. package/dist/{chunk-JHWDTV4K.js → chunk-D2TQX7UJ.js} +2 -2
  78. package/dist/{chunk-GHFTKVJN.js → chunk-DHGE46UK.js} +1 -1
  79. package/dist/{chunk-26WNBTWB.js → chunk-DORE2RHL.js} +5 -5
  80. package/dist/{chunk-AFA32LHN.js → chunk-DUOGEFLG.js} +62 -36
  81. package/dist/{chunk-WZB6R2ZX.js → chunk-DZYTXZNS.js} +11 -3
  82. package/dist/{chunk-O4D27FKH.js → chunk-E5YF236N.js} +4 -1
  83. package/dist/{chunk-6EE6XEMA.js → chunk-EB4PQEI3.js} +26 -17
  84. package/dist/{chunk-ANNQJWDX.js → chunk-EBWMTQ4U.js} +285 -34
  85. package/dist/{chunk-EHNGPUTO.js → chunk-EDW5HQND.js} +5 -5
  86. package/dist/{chunk-VM5CQ7CG.js → chunk-EHRRHSPV.js} +2 -2
  87. package/dist/{chunk-PYGEIPPH.js → chunk-EILNJQMN.js} +32 -12
  88. package/dist/{chunk-KGS5Z7SL.js → chunk-ERDKMZ7O.js} +2 -2
  89. package/dist/{chunk-USFIDSTO.js → chunk-ETUKDEGL.js} +18 -11
  90. package/dist/chunk-F2ET5ZTT.js +49 -0
  91. package/dist/{chunk-HVX2E26J.js → chunk-F3XOBFS4.js} +9 -8
  92. package/dist/{chunk-I4NUYVP5.js → chunk-FB6X7QHA.js} +1 -1
  93. package/dist/{chunk-LO3AGGE3.js → chunk-FJNZ7NWD.js} +5 -5
  94. package/dist/{chunk-IRXTNSZL.js → chunk-FPFRLRQO.js} +40 -22
  95. package/dist/{chunk-YTEJYLU7.js → chunk-FRR7BJ3B.js} +2 -2
  96. package/dist/{chunk-DPUCT567.js → chunk-FVWHEM2N.js} +7 -5
  97. package/dist/{chunk-A33MFWHW.js → chunk-G7BCLYL4.js} +2 -2
  98. package/dist/{chunk-2KCK63DD.js → chunk-G7CXJPEN.js} +2 -2
  99. package/dist/{chunk-2X6XY4K4.js → chunk-GB3RZYTK.js} +39 -19
  100. package/dist/{chunk-MTCDGSYW.js → chunk-GHCU6OSE.js} +2 -2
  101. package/dist/{chunk-AFGQXMKT.js → chunk-GNMB72V7.js} +161 -67
  102. package/dist/chunk-GOFS336W.js +24 -0
  103. package/dist/{chunk-JMXNXLAC.js → chunk-GQYT7G4F.js} +2 -2
  104. package/dist/{chunk-RRPTQGRU.js → chunk-H3VICNTN.js} +1 -1
  105. package/dist/{chunk-JRRSKCGG.js → chunk-H4EDDGGX.js} +3 -3
  106. package/dist/{chunk-5H4HFRDO.js → chunk-H7BCNS5J.js} +5 -5
  107. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  108. package/dist/chunk-HF4BCPIV.js +26 -0
  109. package/dist/{chunk-YCUNFAEE.js → chunk-HM4AJ5U4.js} +238 -127
  110. package/dist/{chunk-7FAO4ICF.js → chunk-HO4ILCW7.js} +2 -2
  111. package/dist/{chunk-ZV3SNRJI.js → chunk-HTQGJQZN.js} +4 -2
  112. package/dist/{chunk-G5BUGYIL.js → chunk-I52OMC5B.js} +192 -113
  113. package/dist/{chunk-TMXRTYGT.js → chunk-I5VNHDPR.js} +3 -2
  114. package/dist/{chunk-M74H7QYD.js → chunk-IDXYHDQY.js} +1 -1
  115. package/dist/{chunk-SSZB3VXG.js → chunk-IFUAPFL5.js} +102 -47
  116. package/dist/{chunk-IPWUBZ4P.js → chunk-IIWZJ5ZM.js} +1 -1
  117. package/dist/{chunk-KF3ZHLHQ.js → chunk-IMUMPKXF.js} +5 -5
  118. package/dist/{chunk-HC6WHTBX.js → chunk-IPBOREIY.js} +1 -1
  119. package/dist/{chunk-76UL4CT4.js → chunk-IPZJCBWD.js} +27 -22
  120. package/dist/{chunk-5P4MXWKP.js → chunk-ITEJQHXE.js} +4 -4
  121. package/dist/{chunk-WDAZ2MT4.js → chunk-IVDTP6SV.js} +4 -4
  122. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  123. package/dist/{chunk-K6Y4HBK7.js → chunk-IXU5C3YY.js} +1000 -904
  124. package/dist/{chunk-EDBUVDRI.js → chunk-JBAVMO56.js} +372 -93
  125. package/dist/{chunk-VY2NPB2Q.js → chunk-JNDWRV34.js} +4 -4
  126. package/dist/{chunk-XYUXB5VK.js → chunk-JT3UTEWZ.js} +3 -3
  127. package/dist/{chunk-A6XCVOC5.js → chunk-JY4LTPOV.js} +1 -1
  128. package/dist/{chunk-VT7PBGL2.js → chunk-JYSFAH7C.js} +23 -36
  129. package/dist/chunk-K7XPTQBJ.js +267 -0
  130. package/dist/{chunk-2I76VFMZ.js → chunk-KI7VCHNZ.js} +49 -37
  131. package/dist/{chunk-YB6QGOCO.js → chunk-KUWIRCYJ.js} +2 -2
  132. package/dist/{chunk-MQ5EKWIG.js → chunk-KVBLTAO7.js} +5 -5
  133. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  134. package/dist/{chunk-BY5JGQFZ.js → chunk-KWIP5YRA.js} +4 -4
  135. package/dist/{chunk-KAAB2DIV.js → chunk-LJDATBPB.js} +6 -6
  136. package/dist/{chunk-TDDSWNGD.js → chunk-LOXZSTIM.js} +30 -28
  137. package/dist/{chunk-ZTSJ7NY6.js → chunk-LPMSGO7L.js} +3 -3
  138. package/dist/{chunk-IXM6BAM4.js → chunk-LXH4RPY4.js} +1 -1
  139. package/dist/{chunk-D5G67OER.js → chunk-LYAT62UT.js} +1 -1
  140. package/dist/{chunk-EFKFZNQC.js → chunk-M5LPP2GQ.js} +34 -20
  141. package/dist/{chunk-QZMLSK43.js → chunk-MALSSEXO.js} +294 -145
  142. package/dist/{chunk-XN7JDII2.js → chunk-MB5EX2YG.js} +230 -107
  143. package/dist/{chunk-PSYPB22T.js → chunk-MGXHFRQK.js} +5 -5
  144. package/dist/{chunk-GADI2DU7.js → chunk-MVR7YKBF.js} +152 -27
  145. package/dist/{chunk-IFURKTOL.js → chunk-MXUPMGRY.js} +2 -2
  146. package/dist/{chunk-C5SQEYTQ.js → chunk-NFGV5OAR.js} +153 -65
  147. package/dist/{chunk-RZNYW7UP.js → chunk-NNIZG3TH.js} +8 -0
  148. package/dist/{chunk-AKJO6N4K.js → chunk-NQPJWQTW.js} +11 -4
  149. package/dist/{chunk-YFI5PN5O.js → chunk-NSMYIUBZ.js} +34 -11
  150. package/dist/{chunk-H6EJ63QN.js → chunk-NT3HCXQC.js} +144 -83
  151. package/dist/chunk-NZ7FX3AE.js +65 -0
  152. package/dist/chunk-O3LT4TAI.js +34 -0
  153. package/dist/{chunk-L2XRUG4P.js → chunk-OELB7MTE.js} +5 -5
  154. package/dist/{chunk-7MYJUJZV.js → chunk-OMNB27GM.js} +4 -4
  155. package/dist/{chunk-GS5UG6QD.js → chunk-OO63YP35.js} +1 -1
  156. package/dist/{chunk-CEMXGMQN.js → chunk-OQUH7I5T.js} +3 -3
  157. package/dist/{chunk-Q7VPTN5X.js → chunk-OS7C2KMQ.js} +4 -4
  158. package/dist/{chunk-NRYERHEI.js → chunk-OTWIW2L3.js} +5 -5
  159. package/dist/chunk-OUNYHYJL.js +27 -0
  160. package/dist/{chunk-54HEIM2A.js → chunk-OUR5ZHCB.js} +2 -2
  161. package/dist/{chunk-Z257SH5U.js → chunk-OZA7HA6L.js} +1 -1
  162. package/dist/{chunk-WJQX7HBH.js → chunk-OZLKEBCD.js} +2 -2
  163. package/dist/{chunk-YGPLUENN.js → chunk-P3NMDPDP.js} +132 -83
  164. package/dist/{chunk-NINK4G7U.js → chunk-P5RCP4NK.js} +2 -2
  165. package/dist/{chunk-DYSEZVIJ.js → chunk-P6DEFCMQ.js} +2 -2
  166. package/dist/{chunk-J22ETKDJ.js → chunk-P7UOOMXE.js} +2 -2
  167. package/dist/chunk-PMT75APP.js +94 -0
  168. package/dist/{chunk-KLQKHA3T.js → chunk-PNYWBY4K.js} +5 -5
  169. package/dist/{chunk-XNV7VOIT.js → chunk-PVGJM2HP.js} +4 -4
  170. package/dist/{chunk-4U2WSW6F.js → chunk-Q2I3QLE3.js} +65 -36
  171. package/dist/{chunk-LGMV7ZV4.js → chunk-QATOOZMH.js} +5 -5
  172. package/dist/{chunk-H2POQ4LB.js → chunk-QFNWGSCT.js} +4 -4
  173. package/dist/{chunk-CIDOL4FO.js → chunk-QQMESIDA.js} +5 -5
  174. package/dist/{chunk-OTGNVAI4.js → chunk-R3VSWOTI.js} +4 -4
  175. package/dist/{chunk-UCIAHSJK.js → chunk-R5SGE2NS.js} +7 -3
  176. package/dist/{chunk-FX5VZK5F.js → chunk-RJICOOB3.js} +14 -8
  177. package/dist/{chunk-RMVCKO6N.js → chunk-RLH2CQCD.js} +458 -136
  178. package/dist/{chunk-VFLMBA2M.js → chunk-RPGEB3Z5.js} +19 -18
  179. package/dist/{chunk-KIXNHDXS.js → chunk-RQKDEJFQ.js} +5 -5
  180. package/dist/chunk-SBKM6XFS.js +211 -0
  181. package/dist/{chunk-TQ5HHNM3.js → chunk-SCAYWQZK.js} +2 -2
  182. package/dist/{chunk-Y5WHM2Q5.js → chunk-SH4FLUAD.js} +1 -1
  183. package/dist/{chunk-7EQU2TUN.js → chunk-SH4UGK5U.js} +84 -53
  184. package/dist/{chunk-EY4OA4OF.js → chunk-SHYS52VO.js} +370 -785
  185. package/dist/{chunk-ZSYU6LIH.js → chunk-SKPOXLG5.js} +5 -5
  186. package/dist/{chunk-OAT6FWKL.js → chunk-T7PRG6AO.js} +5 -5
  187. package/dist/chunk-TBZT5WUT.js +39 -0
  188. package/dist/{chunk-5HTGSB6Y.js → chunk-TKH655ON.js} +3 -3
  189. package/dist/{chunk-YO5UKKCQ.js → chunk-TMEUK2WS.js} +6 -2
  190. package/dist/{chunk-X5OVVMZX.js → chunk-TVOMGNFQ.js} +1 -1
  191. package/dist/{chunk-JARJP576.js → chunk-TX5FSNAU.js} +435 -29
  192. package/dist/{chunk-LUZ7HXBT.js → chunk-U52PNFPX.js} +1 -1
  193. package/dist/{chunk-OKM5LYYP.js → chunk-U6QZOMYC.js} +5 -5
  194. package/dist/{chunk-F4JAGDPD.js → chunk-UBYDY4B7.js} +8 -8
  195. package/dist/{chunk-V3UE3TB7.js → chunk-UCKUAKYQ.js} +2 -2
  196. package/dist/{chunk-NO7GRVUU.js → chunk-UOOXWGBU.js} +8 -8
  197. package/dist/{chunk-LFX5BERN.js → chunk-USMKNNOU.js} +47 -33
  198. package/dist/chunk-USSG6TJV.js +23 -0
  199. package/dist/{chunk-HFFKN7PA.js → chunk-UY34DDUM.js} +3 -3
  200. package/dist/{chunk-3LNVEE5Z.js → chunk-V7FV66KL.js} +1 -1
  201. package/dist/{chunk-62JZL6FW.js → chunk-V7JFT7NQ.js} +56 -42
  202. package/dist/{chunk-UP4JSNDR.js → chunk-V7NUJEJE.js} +1 -1
  203. package/dist/{chunk-FERP4WS3.js → chunk-VACZGW5R.js} +16 -18
  204. package/dist/{chunk-BO5EJBLH.js → chunk-VC62V7CX.js} +82 -47
  205. package/dist/{chunk-53OEKS4L.js → chunk-VESSIKBG.js} +6 -3
  206. package/dist/chunk-VJULLJLN.js +70 -0
  207. package/dist/{chunk-QLWUFEKR.js → chunk-VKNQOSGW.js} +8 -8
  208. package/dist/{chunk-BFDPY7JM.js → chunk-VTY6YHQZ.js} +11 -6
  209. package/dist/{chunk-UFZXZJJG.js → chunk-W2QILXAL.js} +5 -5
  210. package/dist/{chunk-QHPJ5ZKS.js → chunk-W6XSIBLR.js} +5 -5
  211. package/dist/{chunk-DJBMA4FW.js → chunk-WDJSDJLV.js} +4 -6
  212. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  213. package/dist/{chunk-IW3YUMPI.js → chunk-WFBN2HXR.js} +2 -2
  214. package/dist/chunk-WGJIYFVQ.js +24 -0
  215. package/dist/{chunk-43PCSBVQ.js → chunk-WKXLJNHW.js} +634 -8
  216. package/dist/{chunk-EWR6WVOV.js → chunk-WLH5IBFY.js} +6 -6
  217. package/dist/{chunk-RHVP62HI.js → chunk-WMQ57FOP.js} +5 -5
  218. package/dist/{chunk-GKQLKUMF.js → chunk-WNTUBGBB.js} +41 -32
  219. package/dist/{chunk-RHBQ2Q5H.js → chunk-WOICFLOJ.js} +60 -43
  220. package/dist/{chunk-QNLESRH6.js → chunk-WUP6C4ZD.js} +2 -2
  221. package/dist/chunk-WVCDISZP.js +89 -0
  222. package/dist/{chunk-CT4RFZO4.js → chunk-WW4KLAVO.js} +38 -23
  223. package/dist/{chunk-I5ZADE2U.js → chunk-X3QUASBR.js} +1 -1
  224. package/dist/{chunk-TXMS7QUJ.js → chunk-X46PSAJ7.js} +6 -6
  225. package/dist/{chunk-Z2BDTZDT.js → chunk-XC32OSCD.js} +97 -39
  226. package/dist/{chunk-M2OQK2FO.js → chunk-XD5XB22R.js} +2 -2
  227. package/dist/chunk-XLLWIHN2.js +24 -0
  228. package/dist/{chunk-SD6ENKTO.js → chunk-XMX4PCFL.js} +3 -3
  229. package/dist/{chunk-BM2A3IGQ.js → chunk-XO44IJGZ.js} +1 -1
  230. package/dist/{chunk-2HD5RY2U.js → chunk-XRRG4MBM.js} +3 -3
  231. package/dist/chunk-XSC4IXXC.js +24 -0
  232. package/dist/{chunk-D5RAVZ5C.js → chunk-XSEETONJ.js} +10 -9
  233. package/dist/{chunk-YBYV56FS.js → chunk-XZOFKLTD.js} +3 -3
  234. package/dist/{chunk-YNHPPZ7S.js → chunk-XZXZNI7A.js} +1 -1
  235. package/dist/{chunk-W7Q6PLT4.js → chunk-Y6E4JU3U.js} +37 -37
  236. package/dist/{chunk-XR7VOF2V.js → chunk-YGWPOYDE.js} +25 -13
  237. package/dist/{chunk-HDSHS2QZ.js → chunk-YJUBX3QF.js} +70 -47
  238. package/dist/{chunk-BDCKHLUB.js → chunk-YLRAAJYV.js} +72 -304
  239. package/dist/{chunk-I6QGYRY4.js → chunk-YW35KSXR.js} +2 -2
  240. package/dist/{chunk-GAFEN3H7.js → chunk-Z3WQXVFV.js} +2 -2
  241. package/dist/{chunk-WKWCNS6K.js → chunk-Z62TJQO5.js} +5 -5
  242. package/dist/{chunk-D3PQAVFW.js → chunk-Z6DUNKFU.js} +152 -29
  243. package/dist/{chunk-FF7MV4D4.js → chunk-Z6H5ED2I.js} +1 -1
  244. package/dist/{chunk-TWRFVW3J.js → chunk-ZB3JIL3L.js} +138 -89
  245. package/dist/{chunk-KUMJI5B6.js → chunk-ZBCCJPGW.js} +17 -14
  246. package/dist/{chunk-CV3NC75L.js → chunk-ZBOOMLHD.js} +1 -1
  247. package/dist/{chunk-QRZESG66.js → chunk-ZCHKIR7C.js} +64 -239
  248. package/dist/{chunk-ZDD3MJ2H.js → chunk-ZDJ7C64T.js} +1 -1
  249. package/dist/{chunk-KQ2WZ6BY.js → chunk-ZG4BMJRL.js} +1 -1
  250. package/dist/{chunk-QYOZ46ZQ.js → chunk-ZIVCPXXL.js} +467 -650
  251. package/dist/{chunk-V62B23VC.js → chunk-ZNRSYS76.js} +8 -2
  252. package/dist/{chunk-NIDH22DI.js → chunk-ZSYFQSPF.js} +12 -2
  253. package/dist/cli/index.js +8 -3
  254. package/dist/{core-5S5CJHBG.js → core-2GWH3ED7.js} +2 -1
  255. package/dist/{core-ZSERZGK6.js → core-3LCSHMKN.js} +3 -1
  256. package/dist/{core-FTQBESDS.js → core-3NQ5TXOJ.js} +3 -1
  257. package/dist/{core-D2OIGYC7.js → core-3XGQBHJI.js} +4 -1
  258. package/dist/{core-T3OSZOVV.js → core-4N6WH3IF.js} +3 -1
  259. package/dist/{core-VRVL6LIM.js → core-5CRTPVYA.js} +3 -1
  260. package/dist/{core-7XKNJM7Y.js → core-5K4HRIHX.js} +5 -1
  261. package/dist/{core-CCB3IXGD.js → core-743ZXTWK.js} +3 -1
  262. package/dist/{core-4M4RY7MX.js → core-7OAGK7ZJ.js} +3 -1
  263. package/dist/{core-VT35VDVS.js → core-7YDNMUU3.js} +6 -1
  264. package/dist/{core-4PW4MXWR.js → core-AAPPZSSZ.js} +4 -1
  265. package/dist/{core-OBPTBKX6.js → core-AC5AKSCM.js} +2 -1
  266. package/dist/{core-QFAVWFI3.js → core-AEALAFRA.js} +2 -1
  267. package/dist/{core-WXZJ7V7S.js → core-BEK6EPVF.js} +4 -1
  268. package/dist/{core-WP73P4CW.js → core-BRBJ3LPF.js} +5 -1
  269. package/dist/{core-AVA4XLQ2.js → core-EGTJOQK7.js} +2 -1
  270. package/dist/{core-XKXDXALI.js → core-FE4THVV3.js} +6 -1
  271. package/dist/{core-MAW4S3KA.js → core-FEBNVNVE.js} +5 -1
  272. package/dist/{core-L3UR75IJ.js → core-HIONDJGC.js} +4 -1
  273. package/dist/{core-GS4DXDDG.js → core-HMBMMF5Z.js} +4 -1
  274. package/dist/{core-QM34237W.js → core-LSYX4UQQ.js} +2 -1
  275. package/dist/{core-N2JEWJ7D.js → core-MIERUUUT.js} +2 -1
  276. package/dist/{core-A7HXVSKB.js → core-NTOOJZRA.js} +2 -1
  277. package/dist/{core-JDZDBTID.js → core-O5S2NETE.js} +2 -1
  278. package/dist/{core-OFPPRHYY.js → core-Q2Y3JEWL.js} +3 -1
  279. package/dist/{core-BJZEJ63L.js → core-RTBPKALG.js} +3 -1
  280. package/dist/{core-WNT6ZMRO.js → core-T7CKLMT2.js} +2 -1
  281. package/dist/{core-VWYXK2R3.js → core-TIIPSEK3.js} +4 -1
  282. package/dist/{core-EMSJRGSE.js → core-VBMWBPKM.js} +2 -1
  283. package/dist/{core-WPEYRK6Y.js → core-VLXOQ5CK.js} +4 -1
  284. package/dist/{core-7TTM4KRP.js → core-VYHQ5JY6.js} +3 -1
  285. package/dist/{core-DMDAXVMY.js → core-XJZWD43V.js} +2 -1
  286. package/dist/{core-AMWCZTOT.js → core-XUNZB6BM.js} +5 -1
  287. package/dist/{core-UNX4ZV4M.js → core-YKDDPMWW.js} +5 -1
  288. package/dist/{core-SKMHEA4Y.js → core-YN2VVGUL.js} +3 -1
  289. package/dist/{core-ZACFV6XR.js → core-YP4MNIMV.js} +5 -1
  290. package/dist/{core-FCSA74RT.js → core-ZETBHLSV.js} +3 -1
  291. package/dist/{dataTable-7IO546LM.js → dataTable-FEQZSDUZ.js} +7 -2
  292. package/dist/{engine-US3N6UCH.js → engine-SCQVNSAM.js} +23 -18
  293. package/dist/fixtures.js +2 -1
  294. package/dist/flags-BVLSAXT3.js +10 -0
  295. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  296. package/dist/geo/dach.js +1 -1
  297. package/dist/geo/de-states.js +1 -1
  298. package/dist/geo/eu27.js +1 -1
  299. package/dist/geo/europe.js +1 -1
  300. package/dist/geo/index.js +2 -2
  301. package/dist/geo/us-states.js +1 -1
  302. package/dist/geo/world.js +1 -1
  303. package/dist/index.js +27 -20
  304. package/dist/{main-2UWKGUHR.js → main-7UKLXCIL.js} +50 -119
  305. package/dist/mcp/server.js +121 -118
  306. package/dist/react/bar.js +5 -1
  307. package/dist/react/bartable.js +3 -1
  308. package/dist/react/box.js +3 -1
  309. package/dist/react/bullet.js +4 -1
  310. package/dist/react/butterfly.js +5 -1
  311. package/dist/react/choropleth.js +3 -1
  312. package/dist/react/cohort.js +3 -1
  313. package/dist/react/column.js +5 -1
  314. package/dist/react/combo.js +5 -1
  315. package/dist/react/creative.js +4 -1
  316. package/dist/react/diagram.js +3 -1
  317. package/dist/react/dimswitch.js +6 -1
  318. package/dist/react/dot.js +4 -1
  319. package/dist/react/export.js +29 -18
  320. package/dist/react/funnel.js +4 -1
  321. package/dist/react/gantt.js +3 -1
  322. package/dist/react/grid.js +6 -1
  323. package/dist/react/heatmap.js +3 -1
  324. package/dist/react/histogram.js +6 -1
  325. package/dist/react/index.js +92 -85
  326. package/dist/react/kpi.js +4 -1
  327. package/dist/react/likert.js +6 -1
  328. package/dist/react/line.js +4 -1
  329. package/dist/react/mekko.js +5 -1
  330. package/dist/react/pareto.js +6 -1
  331. package/dist/react/pie.js +4 -1
  332. package/dist/react/prepare.js +35 -22
  333. package/dist/react/pvm.js +6 -1
  334. package/dist/react/pyramid.js +5 -1
  335. package/dist/react/sankey.js +3 -1
  336. package/dist/react/scatter.js +3 -1
  337. package/dist/react/slope.js +4 -1
  338. package/dist/react/sparkline.js +4 -1
  339. package/dist/react/spec.js +17 -13
  340. package/dist/react/status.js +3 -1
  341. package/dist/react/story.js +3 -2
  342. package/dist/react/table.js +4 -1
  343. package/dist/react/theme.js +5 -3
  344. package/dist/react/tilemap.js +3 -1
  345. package/dist/react/treemap.js +3 -1
  346. package/dist/react/variance.js +5 -1
  347. package/dist/react/waffle.js +3 -1
  348. package/dist/react/waterfall.js +5 -1
  349. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  350. package/dist/rows.js +2 -2
  351. package/dist/{rowsModule-DYDVHBAX.js → rowsModule-WJH4QNXZ.js} +1 -1
  352. package/dist/{schema-YDZCGL56.js → schema-2R32F6AW.js} +1 -3
  353. package/dist/{schema-A2XUZUCV.js → schema-2TPGJGVR.js} +1 -3
  354. package/dist/{schema-MD22QYZU.js → schema-47BG2TZA.js} +1 -3
  355. package/dist/{schema-HEB6ZDI5.js → schema-56MOEOVR.js} +1 -3
  356. package/dist/{schema-K4V4PYBO.js → schema-5MSR4LNN.js} +1 -3
  357. package/dist/{schema-NOBNFD2F.js → schema-5RIYEWE6.js} +1 -3
  358. package/dist/{schema-OXO2XY4Y.js → schema-ALBF6V7Y.js} +1 -3
  359. package/dist/{schema-F2Q6MH7W.js → schema-BA6WP5YZ.js} +1 -3
  360. package/dist/{schema-G5KSSI5W.js → schema-CBL2SMVR.js} +1 -3
  361. package/dist/{schema-WFGDVBJK.js → schema-CWKGLDSR.js} +1 -3
  362. package/dist/{schema-DHMMGDTI.js → schema-DBIQFL56.js} +1 -3
  363. package/dist/{schema-626QXX4G.js → schema-DL7V6NN2.js} +1 -3
  364. package/dist/{schema-FC6J6KZC.js → schema-DUVJMFKQ.js} +1 -3
  365. package/dist/{schema-LGLQBRC4.js → schema-ECJERHKF.js} +1 -2
  366. package/dist/{schema-4JRNXEZF.js → schema-EDSEKZDJ.js} +1 -3
  367. package/dist/{schema-I44IDRGD.js → schema-ESR6ZIK4.js} +1 -3
  368. package/dist/{schema-FSYDLMGD.js → schema-F7TWGLRZ.js} +1 -3
  369. package/dist/{schema-JCU6LTYD.js → schema-FGB6IGZM.js} +1 -3
  370. package/dist/{schema-MGETMQYC.js → schema-FKGGTM4Z.js} +1 -2
  371. package/dist/{schema-XIHAKX3B.js → schema-JIAQE7WO.js} +1 -1
  372. package/dist/{schema-6V5K3J2V.js → schema-JYZ4RF6S.js} +1 -3
  373. package/dist/{schema-GXOG4MXL.js → schema-K7F6TEDK.js} +1 -2
  374. package/dist/{schema-NMIYKGHE.js → schema-KAK6DZX4.js} +1 -3
  375. package/dist/{schema-PHIHMDVB.js → schema-KCJ6WTGV.js} +1 -3
  376. package/dist/{schema-XRSORYBI.js → schema-MOKWIGF7.js} +1 -3
  377. package/dist/{schema-3KMU5737.js → schema-MQT6BMNK.js} +1 -3
  378. package/dist/{schema-JJWORI7D.js → schema-MR3BPPQR.js} +1 -3
  379. package/dist/{schema-IFTIMTS3.js → schema-OPXZYIW7.js} +1 -3
  380. package/dist/{schema-UXWKA3PI.js → schema-PV7JGX5H.js} +1 -3
  381. package/dist/{schema-CNJ4Y6CT.js → schema-PWPQF5RC.js} +1 -3
  382. package/dist/{schema-WBOPCTPC.js → schema-PYQEUC5P.js} +1 -3
  383. package/dist/{schema-J4HCSD5C.js → schema-Q5DACE4I.js} +6 -2
  384. package/dist/{schema-IUY7VYHJ.js → schema-R42VXFIS.js} +1 -3
  385. package/dist/{schema-WX2RS4OU.js → schema-TVUJNEX7.js} +1 -3
  386. package/dist/{schema-6PL46VXZ.js → schema-WZOSDDDJ.js} +1 -3
  387. package/dist/{schema-FGE5YK3S.js → schema-Y4TI2T3T.js} +1 -3
  388. package/dist/{schema-MQB6CE5V.js → schema-ZU2EU2VP.js} +1 -3
  389. package/dist/{specValidation-XGELWQUU.js → specValidation-DC4TVHWD.js} +3 -1
  390. package/dist/theme.js +4 -3
  391. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  392. package/dist/types/core/annotate.d.ts +27 -2
  393. package/dist/types/core/annotateArms.d.ts +3 -1
  394. package/dist/types/core/annotateTargets.d.ts +4 -0
  395. package/dist/types/core/annotationOrigin.d.ts +13 -0
  396. package/dist/types/core/axis.d.ts +2 -2
  397. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  398. package/dist/types/core/charts/column/model.d.ts +13 -0
  399. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  400. package/dist/types/core/charts/gantt/calendar.d.ts +4 -0
  401. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  402. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  403. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  404. package/dist/types/core/charts/pvm/types.d.ts +1 -0
  405. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  406. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  407. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  408. package/dist/types/core/charts/table/resolve.d.ts +8 -3
  409. package/dist/types/core/charts/table/view.d.ts +24 -1
  410. package/dist/types/core/claims/browser.d.ts +2 -0
  411. package/dist/types/core/claims/ids.d.ts +38 -0
  412. package/dist/types/core/deferred.d.ts +1 -0
  413. package/dist/types/core/diagnostics/describe.d.ts +6 -1
  414. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  415. package/dist/types/core/formatSpec.d.ts +33 -14
  416. package/dist/types/core/frame.d.ts +25 -58
  417. package/dist/types/core/frameText.d.ts +203 -0
  418. package/dist/types/core/geometry.d.ts +2 -0
  419. package/dist/types/core/label/categoryRow.d.ts +19 -2
  420. package/dist/types/core/label/solver.d.ts +23 -2
  421. package/dist/types/core/normalize/shared.d.ts +12 -2
  422. package/dist/types/core/notes.d.ts +15 -2
  423. package/dist/types/core/reading.d.ts +12 -1
  424. package/dist/types/core/request.d.ts +1 -1
  425. package/dist/types/core/schema/capability.d.ts +12 -0
  426. package/dist/types/core/seriesIdentity.d.ts +4 -1
  427. package/dist/types/core/sizing.d.ts +37 -1
  428. package/dist/types/core/structureCounts.d.ts +3 -1
  429. package/dist/types/core/theme.d.ts +33 -4
  430. package/dist/types/core/themeRules.d.ts +2 -0
  431. package/dist/types/core/types/annotations.d.ts +74 -4
  432. package/dist/types/core/types/options.d.ts +35 -3
  433. package/dist/types/core/types/scene.d.ts +30 -2
  434. package/dist/types/core/types/table.d.ts +6 -0
  435. package/dist/types/core/types/theme.d.ts +23 -0
  436. package/dist/types/react/TableChart.d.ts +5 -0
  437. package/dist/validate.js +13 -6
  438. package/docs/TELEMETRY.md +2 -2
  439. package/docs/manual.md +252 -62
  440. package/docs/reference/bar.md +12 -4
  441. package/docs/reference/bartable.md +2 -2
  442. package/docs/reference/box.md +8 -4
  443. package/docs/reference/bullet.md +9 -5
  444. package/docs/reference/butterfly.md +10 -5
  445. package/docs/reference/choropleth.md +3 -5
  446. package/docs/reference/cohort.md +1 -1
  447. package/docs/reference/column.md +18 -4
  448. package/docs/reference/combo.md +10 -5
  449. package/docs/reference/creative.md +3 -7
  450. package/docs/reference/diagram.md +1 -1
  451. package/docs/reference/dimswitch.md +23 -88
  452. package/docs/reference/dot.md +9 -5
  453. package/docs/reference/fixtures.md +37 -1
  454. package/docs/reference/funnel.md +9 -5
  455. package/docs/reference/gantt.md +8 -15
  456. package/docs/reference/grid.md +5 -2
  457. package/docs/reference/heatmap.md +10 -6
  458. package/docs/reference/kpi.md +1 -1
  459. package/docs/reference/likert.md +9 -4
  460. package/docs/reference/line.md +18 -5
  461. package/docs/reference/mekko.md +10 -5
  462. package/docs/reference/options.md +17 -13
  463. package/docs/reference/pareto.md +8 -4
  464. package/docs/reference/pie.md +9 -5
  465. package/docs/reference/pvm.md +9 -5
  466. package/docs/reference/pyramid.md +8 -4
  467. package/docs/reference/react.md +5 -5
  468. package/docs/reference/sankey.md +2 -2
  469. package/docs/reference/scatter.md +8 -4
  470. package/docs/reference/slope.md +9 -5
  471. package/docs/reference/sparkline.md +1 -1
  472. package/docs/reference/status.md +1 -1
  473. package/docs/reference/table.md +33 -114
  474. package/docs/reference/theme.md +12 -4
  475. package/docs/reference/tilemap.md +2 -4
  476. package/docs/reference/treemap.md +1 -1
  477. package/docs/reference/variance.md +12 -6
  478. package/docs/reference/waffle.md +1 -1
  479. package/docs/reference/warnings.md +1077 -0
  480. package/docs/reference/waterfall.md +16 -4
  481. package/docs/use-cases.md +25 -13
  482. package/llms.txt +19 -6
  483. package/package.json +18 -3
  484. package/dist/chunk-5RHP7YTL.js +0 -24
  485. package/dist/chunk-6VU2XI3W.js +0 -89
  486. package/dist/chunk-6WJOHZPW.js +0 -26
  487. package/dist/chunk-FL3FQ2YA.js +0 -27
  488. package/dist/chunk-G5CELEUR.js +0 -26
  489. package/dist/chunk-M4SPKUZE.js +0 -7
  490. package/dist/chunk-OF7FMGH5.js +0 -24
  491. package/dist/chunk-S2TSXUYP.js +0 -24
  492. package/dist/chunk-TKERVBJ3.js +0 -23
  493. package/dist/chunk-VMGTNB6H.js +0 -25
  494. package/dist/chunk-WZL4EEBS.js +0 -11
  495. package/dist/chunk-YJGFT63R.js +0 -27
  496. package/dist/chunk-ZNX5J7D7.js +0 -47
@@ -1,6 +1,7 @@
1
1
  import type { z } from 'zod';
2
2
  import type { DocExpansion } from './docExpand.js';
3
3
  import { type DiagnosticMetadata } from '../diagnostics/describe.js';
4
+ import { type JsonPatchOperation } from '../diagnostics/jsonPatch.js';
4
5
  interface DiagnosticSource {
5
6
  input: unknown;
6
7
  sources: DocExpansion['sources'];
@@ -74,7 +75,7 @@ export declare function sourceSchemaDiagnostic(source: DiagnosticSource, expande
74
75
  code: string;
75
76
  message: string;
76
77
  path: string;
77
- fix?: import("../diagnostics/jsonPatch.js").JsonPatchOperation[] | undefined;
78
+ fix?: JsonPatchOperation[] | undefined;
78
79
  suggest?: string | undefined;
79
80
  };
80
81
  export declare function chartSchemaDiagnostic(document: NamedDocument, chart: {
@@ -118,7 +119,7 @@ export declare function chartSchemaDiagnostic(document: NamedDocument, chart: {
118
119
  code: string;
119
120
  message: string;
120
121
  path: string;
121
- fix?: import("../diagnostics/jsonPatch.js").JsonPatchOperation[] | undefined;
122
+ fix?: JsonPatchOperation[] | undefined;
122
123
  suggest?: string | undefined;
123
124
  };
124
125
  export declare function completeDiagnostic<T extends Finding>(finding: T, input?: unknown, segments?: readonly (string | number)[], docs?: string): T & DiagnosticMetadata;
@@ -6,6 +6,7 @@
6
6
  */
7
7
  import type { RenderTarget } from './types/options.js';
8
8
  import type { LintWarning, PlacedLabel, SceneNode } from './types/scene.js';
9
+ import type { InteractionRecord } from './a11y/types.js';
9
10
  /** A composing chart's generated example is still an automatic format. */
10
11
  export declare const AUTOMATIC_FORMAT: unique symbol;
11
12
  export type AutomaticFormatSource = {
@@ -86,6 +87,8 @@ export interface NumberFormatSpec {
86
87
  autoMagnitude?: true;
87
88
  /** The decimals every value under the engine scale shares at its own scale ("+0.50" beside "+0.04"). */
88
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;
89
92
  /**
90
93
  * The magnitude word as the example wrote it, with the space before it
91
94
  * (" Mio.", "bn"): a value at that magnitude prints it. A value
@@ -162,16 +165,6 @@ export declare function specUnitKind(spec: NumberFormatSpec): 'percent' | 'pp' |
162
165
  /** A percentage, percentage points or a multiple ("1.0x"): a figure that does not add. */
163
166
  export declare function nonAdditiveSpec(spec: NumberFormatSpec): boolean;
164
167
  export declare function nonAdditiveFormat(format: string | undefined): boolean;
165
- /**
166
- * A pinned magnitude ROLLS OVER at 1000 instead of printing four digits of
167
- * itself: "$1000k" is a notation no reader should meet — the honest spelling
168
- * is "$1.0M". The decision runs on the ROUNDED value, so 999.6k at zero
169
- * decimals rolls too rather than rounding into "1000k" after the check.
170
- * Rolled values below 10 keep one decimal ("$1.0M", not "$1M") so the scale
171
- * continuity stays visible. formatWithSpec and roundedNumber MUST share this
172
- * — a reader-facing 1.0M whose reconciliation number stayed 1,049,000 would
173
- * fabricate a phantom gap (see roundedNumber's contract below).
174
- */
175
168
  export declare function effectiveScale(value: number, spec: NumberFormatSpec): {
176
169
  magnitude: NumberFormatSpec['magnitude'];
177
170
  decimals: number;
@@ -213,6 +206,8 @@ export declare function localized(spec: NumberFormatSpec, locale: string | undef
213
206
  export declare function exampleSpec(example: string, locale?: string, unit?: string, values?: Iterable<number | null | undefined>): NumberFormatSpec;
214
207
  /**
215
208
  * The example that sets how a chart prints its computed shares: `shareLabels.format`,
209
+ * else the percent `series[].format` that every data series sets alike (a series format
210
+ * overrides options.format, and a whole prints its shares at one precision),
216
211
  * else `options.format` when it is a percent example ("1.0%"). A format without a
217
212
  * percent sign belongs to the values and gives none.
218
213
  */
@@ -221,7 +216,9 @@ export declare function shareFormatExample(options: {
221
216
  shareLabels?: {
222
217
  format?: string;
223
218
  };
224
- }): string | undefined;
219
+ }, series?: readonly {
220
+ format?: string;
221
+ }[]): string | undefined;
225
222
  /** Parse an example and return a ready-to-use formatter. The chart locale is required (pass undefined for none), so no caller forgets it. */
226
223
  export declare function formatterFromExample(example: string, locale: string | undefined, unit?: string, values?: Iterable<number | null | undefined>): (value: number) => string;
227
224
  /**
@@ -324,16 +321,21 @@ export declare function percentRasterFormatter(values: Iterable<number | null |
324
321
  * more in all its digits ("1310000000.0" under "1.1"), and one that prints a
325
322
  * series' different values as one string hides them. The format stays the
326
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.
327
326
  */
328
327
  export declare function unscaledFormatLint(options: Record<string, unknown> | undefined, data: unknown, geo?: {
329
328
  labels?: readonly PlacedLabel[];
330
329
  scene: readonly SceneNode[];
331
- }): LintWarning[];
330
+ }, records?: () => readonly InteractionRecord[] | null): LintWarning[];
331
+ /** 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
+ export declare function drawsZeroNumber(scene: readonly SceneNode[]): boolean;
332
333
  /**
333
334
  * The scale a unit names: "€M", "EUR m" and "CHFm" are millions, "k€"
334
335
  * thousands, "USD bn" billions, "Mio. CHF" millions; none for "%" or "EUR".
335
336
  * Three letters joined to the word must be a currency code: "USDm" names
336
- * millions, "item" does not. A currency may follow the word too.
337
+ * millions, "item" does not. A currency may follow the word too. A scale
338
+ * before a noun names one as well: "k visits", "million tonnes", "M users".
337
339
  */
338
340
  export declare function unitMagnitude(unit: string | undefined): NumberFormatSpec['magnitude'] | undefined;
339
341
  /**
@@ -351,7 +353,24 @@ export declare function unitMagnitude(unit: string | undefined): NumberFormatSpe
351
353
  * prints with `fmt`. `shared` keeps one precision for every series: series
352
354
  * that share a stack or a total read as one set.
353
355
  */
354
- export declare function seriesRasterFormatter(example: string | undefined, values: Iterable<number | null | undefined>, locale?: string, unit?: string, target?: RenderTarget, defaultExample?: string, shared?: boolean): {
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): {
355
374
  spec: NumberFormatSpec;
356
375
  fmt: (value: number) => string;
357
376
  fmtSigned: (value: number) => string;
@@ -1,7 +1,8 @@
1
1
  import { type IdentityCollectionOptions, type SeriesIdentity as LegendItemInput } from './seriesIdentity.js';
2
2
  import type { Margin, Rect, Size } from './geometry.js';
3
3
  import type { TextMeasurer } from './text.js';
4
- import { type ChartCredit, type NoteList } from './notes.js';
4
+ import { type ChartCredit } from './notes.js';
5
+ import { type NoteCapOptions } from './frameText.js';
5
6
  import type { Id } from './types/cell.js';
6
7
  import type { BaseOptions, LegendOptions, Subtitle } from './types/options.js';
7
8
  import type { FrameGeometry, Geometry, LayoutResult, LegendGeometry, LintWarning, PlacedLabel, SceneNode } from './types/scene.js';
@@ -17,11 +18,13 @@ type LegendOptionInput = 'none' | 'auto' | LegendOptions['position'] | LegendOpt
17
18
  /**
18
19
  * A key the chart cannot be read without: a map's range and no-data encoding,
19
20
  * or a colour, hatch or glyph that no mark names. It cannot be hidden. 'none'
20
- * is answered with an info lint and the key at the theme's required position
21
+ * is answered with a warning, since the drawing differs from the spec, and the key at the theme's required position
21
22
  * (top by default: one row above the plot, which keeps the plot's width).
22
23
  * `reason` completes "the legend cannot be hidden because ...".
23
24
  */
24
- export declare function legendRequired(option: LegendOptionInput, warnings: LintWarning[], chartType: string, theme?: Theme, reason?: string): LegendOptions;
25
+ /** The chart types whose key `legend: 'none'` cannot hide; each names its own `<type>-legend-required` code. */
26
+ export type KeyRequiredType = 'bartable' | 'choropleth' | 'cohort' | 'heatmap' | 'pareto' | 'status' | 'table' | 'tilemap' | 'variance' | 'waffle' | 'waterfall';
27
+ export declare function legendRequired(option: LegendOptionInput, warnings: LintWarning[], chartType: KeyRequiredType, theme?: Theme, reason?: string): LegendOptions;
25
28
  /**
26
29
  * `legend: 'none'` drops the key of a table, heatmap, cohort or
27
30
  * variance for a host that draws its own. One info lint names what it left
@@ -32,6 +35,7 @@ export declare function normalizeLegendOption(option: Exclude<LegendOptionInput,
32
35
  export declare function normalizeLegendOption(option: Exclude<LegendOptionInput, 'none'>, defaultOptions: LegendOptions): LegendOptions;
33
36
  export declare function normalizeLegendOption(option: LegendOptionInput, defaultOptions?: LegendOptions): LegendOptions | undefined;
34
37
  export type { SeriesIdentity as LegendItemInput } from './seriesIdentity.js';
38
+ export { cappedItems, DEFAULT_NOTE_LIMIT, fittedNote, frameRendersUnit, HIDDEN_LABEL_LEAD, moreListedText, noteCap, subtitleLine, subtitleUnitClause, unitPrinted, type NoteCapOptions, } from './frameText.js';
35
39
  /**
36
40
  * The share of the chart width a plot block keeps beside a key column that a spec names. The block
37
41
  * holds the axis labels, so this is the lint's 62% floor for the drawn plot plus their gutter.
@@ -97,6 +101,8 @@ export interface FrameInput extends IdentityCollectionOptions, CompactSourceOpti
97
101
  credit?: ChartCredit;
98
102
  /** `options.notes`: the footer rule's placement, line budget, kinds shown and pointer. */
99
103
  notes?: BaseOptions['notes'];
104
+ /** The author wrote `notes.show`: only then do its disclosures print outside the line budget. */
105
+ notesShowAuthored?: boolean;
100
106
  /** Built-in wording for the renderer-composed labels this frame draws. */
101
107
  strings?: BaseOptions['strings'];
102
108
  footnotes?: string[];
@@ -157,6 +163,8 @@ export interface FrameInput extends IdentityCollectionOptions, CompactSourceOpti
157
163
  };
158
164
  /** The layout chose the key beside the plot itself, and checks the room itself: no fallback to the row above the plot. */
159
165
  sideKeyFixed?: boolean;
166
+ /** The chart does not fit its width with the key beside the plot: the key stands in the row above the plot. */
167
+ sideKeyGivesWay?: boolean;
160
168
  /** Automatic legend keys use the footnote token ('compact': the smaller of it and the secondary step); explicit keys keep axis type. */
161
169
  legendFont?: 'footnote' | 'compact';
162
170
  theme: Theme;
@@ -252,7 +260,7 @@ export declare function frameTextOptions(options: Pick<BaseOptions, Exclude<Fram
252
260
  mode?: unknown;
253
261
  theme?: ThemeRef;
254
262
  [LEGEND_HEIGHT]?: LegendBudget;
255
- }): Pick<FrameInput, FrameTextKey | 'footnotesOff' | 'numberedFootnotes' | 'unreferencedNotes' | 'pointedNotes' | 'legendFont' | 'compactTitleSize' | typeof CUT_LABEL_NOTES | typeof LEGEND_HEIGHT> & IdentityCollectionOptions & CompactSourceOptions;
263
+ }): Pick<FrameInput, FrameTextKey | 'notesShowAuthored' | 'footnotesOff' | 'numberedFootnotes' | 'unreferencedNotes' | 'pointedNotes' | 'legendFont' | 'compactTitleSize' | typeof CUT_LABEL_NOTES | typeof LEGEND_HEIGHT> & IdentityCollectionOptions & CompactSourceOptions;
256
264
  export interface FrameResult {
257
265
  /** Pixels the frame band lacks to give the plot its 10px minimum; absent when it fits. */
258
266
  deficit?: number;
@@ -279,21 +287,6 @@ export { wrapFootnote } from './footer.js';
279
287
  * drawing its axes into the footer.
280
288
  */
281
289
  export declare function plotHeightAfter(frameResult: FrameResult, canvasH: number, h: number): number;
282
- export declare function subtitleUnitClause(unit: string, measure: string): string;
283
- /**
284
- * Does the subtitle print the unit clause for this exact measure and unit?
285
- * Callers use the same predicate before moving a unit out of endpoint labels
286
- * or table headers. A subtitle can still render when this returns false.
287
- */
288
- export declare function frameRendersUnit(input: Pick<FrameInput, 'subtitle' | 'unit'>): boolean;
289
- /**
290
- * Is the unit printed outside the labels: by the subtitle, or by the host
291
- * under `options.unitShown`? Endpoint labels, table heads and the legend
292
- * check read this, so no label repeats a unit the reader already sees.
293
- */
294
- export declare function unitPrinted(input: Pick<FrameInput, 'subtitle' | 'unit'> & {
295
- unitShown?: boolean;
296
- }): boolean;
297
290
  /**
298
291
  * `unit-not-shown`: an authored options.unit printed
299
292
  * nowhere on the drawing. The subtitle prints it only beside a measure, so a
@@ -335,41 +328,8 @@ export declare function unitInFormatLints(options: Record<string, unknown> | und
335
328
  * not print a second one.
336
329
  */
337
330
  export declare function noteLine(lead: string, items: readonly string[], options?: NoteCapOptions, total?: number): string[];
338
- /**
339
- * a capped list note names as many items as fit `fits` (two footer lines at
340
- * the drawn width), at most noteCap, in its order, then "and N more"; a lone last item only when
341
- * it fits. When not even one name fits, the note counts: "18 of 36 values", else "18 items".
342
- */
343
- export declare function fittedNote(list: NoteList, fits: (text: string) => boolean): string;
344
331
  /** `noteLine` for values the drawing does not print and no label stands for: the `values-in-note` warning lists them. */
345
332
  export declare function valueNoteLine(lead: string, items: readonly string[], options?: NoteCapOptions, total?: number): string[];
346
- /** What a note line reads from the options: how many items it names, and the wording of its count. */
347
- export interface NoteCapOptions {
348
- notes?: {
349
- maxListed?: number | 'all';
350
- };
351
- strings?: {
352
- moreListed?: string;
353
- };
354
- }
355
- /**
356
- * Items a note line names by default: the first 8 in the note's order, then
357
- * "and N more"; the reading keeps the full list. An author-set `notes.maxListed` wins: 'all'
358
- * names every item, 0 names none and counts them ("18 of 36 values").
359
- */
360
- export declare const DEFAULT_NOTE_LIMIT = 8;
361
- /** The most items one note line names; `Infinity` under `notes.maxListed: 'all'`, 0 under `notes.maxListed: 0`. */
362
- export declare function noteCap(options?: NoteCapOptions, count?: number): number;
363
- /** The closing item of a capped list: the count of items left out, or of all items when the line names none. */
364
- export declare function moreListedText(count: number, options?: NoteCapOptions, alone?: boolean): string;
365
- /**
366
- * The items a note line prints: the first `noteCap` items and the count of the rest ("and 3
367
- * more"). Under `notes.maxListed: 0` it only counts: "18 of 36 values" when the caller knows
368
- * the `total` of values, else "18 items".
369
- */
370
- export declare function cappedItems(items: readonly string[], options?: NoteCapOptions, total?: number): string[];
371
- /** The note line the registered layout adds for labels the drawing hid. */
372
- export declare const HIDDEN_LABEL_LEAD = "Not labelled on the chart";
373
333
  /** Measure cut-label disclosures through the existing frame; a pinned canvas keeps its size. */
374
334
  export declare function withCutLabelNotes<O extends Pick<BaseOptions, 'notes' | 'footnotes' | 'strings' | 'locale' | 'target' | 'size'>, M extends object, D extends object>(data: unknown, options: O, layout: (options: O) => LayoutResult<M, D>): LayoutResult<M, D>;
375
335
  /** A note that cannot fit stays in the result after the footer has used its measured space. */
@@ -496,7 +456,8 @@ export declare function withNoteInA11y<T extends object>(options: T): T | undefi
496
456
  * note: the line over the registry's items and `extras` (id and text, in the
497
457
  * order to list them), and the footnotes without the line the registry wrote.
498
458
  * `counted` holds the ids the cap leaves to its count. The caller marks the
499
- * labels it names with `markNotedLabels`.
459
+ * labels it names with `markNotedLabels`, handing it `marks`, so the labels the
460
+ * drawn note leaves to "and N more" read as counted, not listed.
500
461
  */
501
462
  export declare function hiddenNoteWith(options: object, extras: readonly {
502
463
  id: Id;
@@ -506,6 +467,7 @@ export declare function hiddenNoteWith(options: object, extras: readonly {
506
467
  line: string[];
507
468
  ids: Set<Id>;
508
469
  counted: ReadonlySet<Id>;
470
+ marks: object;
509
471
  };
510
472
  /**
511
473
  * After a run that was handed the note: when the note reached the page (a
@@ -534,6 +496,16 @@ export declare function unitMissing(options: Record<string, unknown> | undefined
534
496
  warnings: readonly LintWarning[];
535
497
  derived?: unknown;
536
498
  }): boolean;
499
+ /**
500
+ * The unit rule on the texts a surface prints: a unit is declared, `unitShown` is not set, and no
501
+ * text carries the unit. `unitMissing` reads them from the drawing; the React table hands its own.
502
+ */
503
+ export declare function unitUnprinted(options: Record<string, unknown> | undefined, drawn: {
504
+ type?: string;
505
+ refused?: boolean;
506
+ derived?: unknown;
507
+ texts: () => Iterable<string>;
508
+ }): boolean;
537
509
  export declare const isPercentUnit: (unit: string) => boolean;
538
510
  /**
539
511
  * Whether a column prints an absolute figure on its segments: `labels.segment`
@@ -583,11 +555,6 @@ export declare function textCarriesUnit(text: string, unit: string): boolean;
583
555
  export declare function textCarriesCohortUnit(text: string, unit: string): boolean;
584
556
  /** Every string inside an option value (a subtitle object, a footnote list), in order. */
585
557
  export declare function stringsIn(value: unknown): string[];
586
- /**
587
- * The subtitle as one plain line, in the order the frame prints it. A fixed slot that misses
588
- * moves it into the notes list. The unit stays on the canvas as the unit line.
589
- */
590
- export declare function subtitleLine(sub: Subtitle): string;
591
558
  /**
592
559
  * A band the frame reserves above the footnotes and fills with what the band
593
560
  * draws: the event key (core/eventLane) lays itself out at the content width
@@ -0,0 +1,203 @@
1
+ import { type ChartCredit, type ChartNote, type EngineNoteMeta, type NoteKind, type NoteList, type NotePlacement } from './notes.js';
2
+ import type { FontSpec, TextMeasurer } from './text.js';
3
+ import type { BaseOptions, Subtitle } from './types/options.js';
4
+ import type { LintWarning } from './types/scene.js';
5
+ /**
6
+ * The frame's text decisions: which notes the footer prints, which go to the
7
+ * notes list, the pointer, the source line and the credit. `solveFrame` draws
8
+ * what this returns, and the React table reads it for its HTML footer. It
9
+ * reads no global state: the surface policy and the notes' kinds come in.
10
+ */
11
+ /** The note line the registered layout adds for labels the drawing hid. */
12
+ export declare const HIDDEN_LABEL_LEAD = "Not labelled on the chart";
13
+ /** How the surface shows the frame: a pinned static image prints every enabled note; a live surface has the 'info' button. */
14
+ export interface FrameTextPolicy {
15
+ /** A static export with a pinned canvas (`staticFrame.pinned`): every enabled note prints, no budget, no pointer. */
16
+ pinned: boolean;
17
+ /** A live React surface (`staticFrame.live`): under 'info' its button lists every note the frame does not print. */
18
+ live: boolean;
19
+ }
20
+ /** One composed note and the kind its composer gave it; a note without `meta` is an author note or a method note. */
21
+ export interface FrameTextNote {
22
+ text: string;
23
+ meta?: EngineNoteMeta;
24
+ }
25
+ export interface FrameTextInput {
26
+ target?: BaseOptions['target'];
27
+ title?: string;
28
+ /** The subtitle, or the unit line the layout composed in its place. */
29
+ subtitle?: Subtitle;
30
+ unit?: string;
31
+ source?: string;
32
+ credit?: ChartCredit;
33
+ notes?: BaseOptions['notes'];
34
+ /** The author wrote `notes.show` (not only `methodNote: true` or a `notes.placement`): its disclosures print outside the line budget. */
35
+ notesShowAuthored?: boolean;
36
+ strings?: BaseOptions['strings'];
37
+ /** The composed notes in order, each with its kind. */
38
+ footnotes: readonly FrameTextNote[];
39
+ footnotesOff?: boolean;
40
+ numberedFootnotes?: readonly string[];
41
+ unreferencedNotes?: readonly number[];
42
+ numberedDisclosures?: readonly number[];
43
+ pointedNotes?: readonly string[];
44
+ /** A fixed compact frame's source retry: 1 fits the source line on one line, 0 leaves it to the host. */
45
+ compactSourceLines?: 0 | 1;
46
+ /** The canvas width the target's default line budget reads. */
47
+ width: number;
48
+ /** The width the footer lines wrap at, and their font. */
49
+ footWidth: number;
50
+ footFont: FontSpec;
51
+ /** The weight a `**bold**` run takes. */
52
+ boldWeight: number;
53
+ measure: TextMeasurer;
54
+ policy: FrameTextPolicy;
55
+ }
56
+ /** A note as the frame sorts and prints it. */
57
+ export interface FrameTextEntry {
58
+ kind: NoteKind;
59
+ text: string;
60
+ short?: string;
61
+ /** The text the footer draws: the number mark, then the short form where the kind prints it. */
62
+ drawn: string;
63
+ ref?: number;
64
+ ranks?: true;
65
+ }
66
+ export interface FrameText {
67
+ title?: string;
68
+ /** The subtitle with its unit clause. */
69
+ subtitle?: SubtitleText;
70
+ placement: NotePlacement;
71
+ /** The measurer the footer lines wrap with: bold runs measure at the bold weight. */
72
+ footMeasure: TextMeasurer;
73
+ /** Every note, sorted by kind. */
74
+ entries: FrameTextEntry[];
75
+ /** The notes printed in the frame, in order, each with its wrapped lines. */
76
+ printed: {
77
+ entry: FrameTextEntry;
78
+ lines: string[];
79
+ }[];
80
+ /** The source line without its pointer, as drawn ("Source: …"), or undefined. */
81
+ sourceText?: string;
82
+ /** A fixed compact frame left the source line to the host. */
83
+ sourceOff: boolean;
84
+ /** The source paragraph: the source line, then the pointer; or the pointer alone. */
85
+ sourceBlock?: string;
86
+ /** The pointer at the end of the source paragraph ("+2 notes"), or undefined. */
87
+ pointer?: string;
88
+ /** The source paragraph's lines (a compact one-line source fits with an ellipsis, `title` then holds its full text). */
89
+ sourceLines: (text: string) => {
90
+ lines: string[];
91
+ title?: string;
92
+ };
93
+ /** The required credit prints in the frame. */
94
+ creditInFrame: boolean;
95
+ /** The pointer is on (no pinned frame, notes not off, `notes.pointer` not false). */
96
+ pointerOn: boolean;
97
+ /** The notes list: every note, then the source, then the credit, each with `inFrame`. */
98
+ noteList: ChartNote[];
99
+ /** The texts of the notes the frame does not print. */
100
+ unprinted: string[];
101
+ warnings: LintWarning[];
102
+ /** A capped list note in a pinned frame: the static footer counts its names. */
103
+ countable: boolean;
104
+ /** List notes the frame fitted to two lines, with the kinds they now carry. */
105
+ marked: {
106
+ text: string;
107
+ meta: EngineNoteMeta;
108
+ }[];
109
+ }
110
+ /**
111
+ * Select the frame's notes and source. The footer prints the author's notes
112
+ * within the target's line budget, then the source line, then a required map
113
+ * credit; the rest goes to the notes list and the source line ends with
114
+ * "+N notes".
115
+ */
116
+ export declare function frameText(input: FrameTextInput): FrameText;
117
+ export declare const listText: (lead: string, items: readonly string[]) => string;
118
+ /**
119
+ * a capped list note names as many items as fit `fits` (two footer lines at
120
+ * the drawn width), at most noteCap, in its order, then "and N more"; a lone last item only when
121
+ * it fits. When not even one name fits, the note counts: "18 of 36 values", else "18 items".
122
+ */
123
+ export declare function fittedNote(list: NoteList, fits: (text: string) => boolean): string;
124
+ /** The list note that names the first `k` items and counts the rest; with k = 0 it only counts. */
125
+ export declare function listedNoteText({ lead, items, total, options }: NoteList, k: number): string;
126
+ /** What a note line reads from the options: how many items it names, and the wording of its count. */
127
+ export interface NoteCapOptions {
128
+ notes?: {
129
+ maxListed?: number | 'all';
130
+ };
131
+ strings?: {
132
+ moreListed?: string;
133
+ };
134
+ }
135
+ /**
136
+ * Items a note line names by default: the first 8 in the note's order, then
137
+ * "and N more"; the reading keeps the full list. An author-set `notes.maxListed` wins: 'all'
138
+ * names every item, 0 names none and counts them ("18 of 36 values").
139
+ */
140
+ export declare const DEFAULT_NOTE_LIMIT = 8;
141
+ /** The most items one note line names; `Infinity` under `notes.maxListed: 'all'`, 0 under `notes.maxListed: 0`. */
142
+ export declare function noteCap(options?: NoteCapOptions, count?: number): number;
143
+ /** The closing item of a capped list: the count of items left out, or of all items when the line names none. */
144
+ export declare function moreListedText(count: number, options?: NoteCapOptions, alone?: boolean): string;
145
+ /** The count form of a note under `notes.maxListed: 0`: "18 of 36 values". */
146
+ export declare function countedValuesText(count: number, total: number, options?: NoteCapOptions): string;
147
+ /**
148
+ * The items a note line prints: the first `noteCap` items and the count of the rest ("and 3
149
+ * more"). Under `notes.maxListed: 0` it only counts: "18 of 36 values" when the caller knows
150
+ * the `total` of values, else "18 items".
151
+ */
152
+ export declare function cappedItems(items: readonly string[], options?: NoteCapOptions, total?: number): string[];
153
+ /** The text with each unit word the engine knows written as its sign: "Conversion percentage" reads "Conversion %". */
154
+ export declare function unitWordsAsSigns(text: string): string;
155
+ /** Does the measure name the unit, as written or as one of the engine's words for it ("percent" for "%")? */
156
+ export declare function measureNamesUnit(unit: string, measure: string): boolean;
157
+ export declare function subtitleUnitClause(unit: string, measure: string): string;
158
+ /**
159
+ * Does the subtitle print the unit clause for this exact measure and unit?
160
+ * Callers use the same predicate before moving a unit out of endpoint labels
161
+ * or table headers. A subtitle can still render when this returns false.
162
+ */
163
+ export declare function frameRendersUnit(input: {
164
+ subtitle?: Subtitle;
165
+ unit?: string;
166
+ }): boolean;
167
+ /**
168
+ * Is the unit printed outside the labels: by the subtitle, or by the host
169
+ * under `options.unitShown`? Endpoint labels, table heads and the legend
170
+ * check read this, so no label repeats a unit the reader already sees.
171
+ */
172
+ export declare function unitPrinted(input: {
173
+ subtitle?: Subtitle;
174
+ unit?: string;
175
+ } & {
176
+ unitShown?: boolean;
177
+ }): boolean;
178
+ /**
179
+ * The subtitle as one plain line, in the order the frame prints it. A fixed slot that misses
180
+ * moves it into the notes list. The unit stays on the canvas as the unit line.
181
+ */
182
+ export declare function subtitleLine(sub: Subtitle): string;
183
+ /**
184
+ * The unit a measure names after its last comma, from the space after the
185
+ * comma (" % of all orders", " EUR m", " in $m"), or ''. A tail that does
186
+ * not read as a unit (", quarterly") stays part of the measure.
187
+ */
188
+ export declare function measureUnitTail(measure: string, unit: string | undefined): string;
189
+ /** The subtitle as the frame prints it, with bold markers in place. */
190
+ export interface SubtitleText {
191
+ /** The subtitle with its `**bold**` runs marked. */
192
+ sub: Subtitle;
193
+ /** The runs in order: the company, the measure (bold unless it stands alone), then one regular run with the unit clause, period and scenarios. */
194
+ segments: {
195
+ text: string;
196
+ bold: boolean;
197
+ }[];
198
+ }
199
+ /**
200
+ * Compose the subtitle line: "<company> · <measure> in <unit> · <period> · <scenarios>".
201
+ * The unit clause follows `subtitleUnitClause`.
202
+ */
203
+ export declare function subtitleText(authored: Subtitle, unit: string | undefined): SubtitleText;
@@ -38,6 +38,8 @@ export declare function sideAwayFrom(point: Point, others: readonly (readonly Po
38
38
  * (Liang-Barsky clipping). A label box tested with the stroke's half width
39
39
  * plus its air as `pad` touches the drawn line exactly when this is true.
40
40
  */
41
+ /** The part of the segment from `a` to `b` inside `rect` grown by `pad`, as fractions [t0, t1] of it, or undefined when it misses. */
42
+ export declare function segmentSpanInRect(a: Point, b: Point, rect: Rect, pad?: number): [number, number] | undefined;
41
43
  export declare function segmentHitsRect(a: Point, b: Point, rect: Rect, pad?: number): boolean;
42
44
  /**
43
45
  * Whether `rect` grown by `pad` on every side overlaps the convex `polygon`,
@@ -319,9 +319,26 @@ export declare function rotatedClaimRect(anchorX: number, anchorY: number, lineH
319
319
  /**
320
320
  * How far the first drawn rotated label reaches left of `minX`. A chart
321
321
  * widens its left margin by this amount and re-plans, so the name is not
322
- * clipped at the canvas edge.
322
+ * clipped at the canvas edge. The plot it takes from keeps at least
323
+ * MIN_PLOT_WIDTH of its `plotWidth`: a narrow panel cannot give more, and
324
+ * its floor check refuses or repairs the size instead.
323
325
  */
324
- export declare function rotatedLeftOverhang(plan: CategoryRowPlan, centers: readonly number[], minX: number): number;
326
+ export declare function rotatedLeftOverhang(plan: CategoryRowPlan, centers: readonly number[], minX: number, plotWidth: number): number;
327
+ /**
328
+ * The room a rotated first name takes from the left of a banded plot. The plot
329
+ * yields it only where the row planned in the narrower plot still turns its
330
+ * names (45° or -90°), so they draw. Elsewhere the room would stand for a name
331
+ * the narrower row does not draw: the plot keeps its width and the row plans
332
+ * upright.
333
+ */
334
+ export declare function yieldToRotatedName<B extends {
335
+ center(index: number): number;
336
+ }>(plan: CategoryRowPlan, band: B, count: number, x0: number, width: number, bandAt: (x0: number, width: number) => B, planAt: (band: B, rotate?: false) => CategoryRowPlan): {
337
+ plan: CategoryRowPlan;
338
+ band: B;
339
+ x0: number;
340
+ width: number;
341
+ };
325
342
  /**
326
343
  * The box of a -90° name (CategoryRowPlan rotation 90) as the solver and the
327
344
  * label emitter use it: the emitter turns a rotated label about the right
@@ -29,6 +29,7 @@ import type { Id, OwnerRef, SlotId } from '../types/cell.js';
29
29
  import type { FocusInput, LabelDensity, LabelKind } from '../types/options.js';
30
30
  import type { Paint, PlaceDecision, PlacedLabel, LintWarning, TextRole } from '../types/scene.js';
31
31
  import { type OccupiedIndex } from './occupied.js';
32
+ import { HOST_CLAIMS, type HostClaims } from '../claims/ids.js';
32
33
  import { type PointOwnershipInput } from './ownership.js';
33
34
  /** Normative priority bands. */
34
35
  /** The air between two side-by-side values of one series. */
@@ -49,6 +50,8 @@ export interface SlotCandidate {
49
50
  slot: SlotId;
50
51
  rect: Rect;
51
52
  penalty: number;
53
+ /** An authored bar position keeps clear of rules and its own whisker as well as other marks. */
54
+ keepOffLines?: true;
52
55
  /** Optional multi-line text override for wrapped candidate slots. */
53
56
  lines?: string[];
54
57
  /** A deliberate gutter seat, such as a line endpoint. Canvas bounds still apply. */
@@ -102,6 +105,8 @@ export interface SlotCandidate {
102
105
  * draws no leader, as a label touching its mark needs none.
103
106
  */
104
107
  leaderVertical?: boolean;
108
+ /** A straight leader from `leaderFrom` to this point (a moved value's run from its own bar). */
109
+ leaderTo?: Point;
105
110
  /** Upper bound for a custom leader, such as an annotation glyph connector. */
106
111
  leaderLengthBound?: number;
107
112
  /** How far, in px, a mark value's seat may stand from its natural seat, in place of the label-line steps. */
@@ -160,7 +165,7 @@ export interface LabelRequest {
160
165
  }[];
161
166
  /** This numeric label names a mark rather than a separate readout rail. false: a name or other text, never bound to the plot. */
162
167
  markAnchored?: boolean;
163
- /** Authored value text stays eligible when the planner ranks engine values. */
168
+ /** Authored value text and a highlighted value stay eligible when the planner ranks engine values, and pass the 'minimal' density gate. */
164
169
  keepWhenDense?: true;
165
170
  /** An engine value outside the guaranteed set, or one its chart already reports lost: with no free seat it drops as `density` and the frame notes it. */
166
171
  quietWhenCrowded?: true;
@@ -200,7 +205,8 @@ export interface LabelRequest {
200
205
  printedIn?: Id;
201
206
  /** The marks whose value this label prints (PlacedLabel.printsFor). */
202
207
  printsFor?: OwnerRef[];
203
- claimId?: Id;
208
+ /** The claims whose number this label prints (src/core/claims/ids.ts). */
209
+ claimIds?: readonly Id[];
204
210
  claimText?: string;
205
211
  noteText?: string;
206
212
  /** A reader loses this value when it is hidden: the note line names it (class 2), with `noteText`. */
@@ -260,6 +266,8 @@ export interface LabelRequest {
260
266
  w?: number;
261
267
  h?: number;
262
268
  };
269
+ /** The point on its mark a label's leader starts from once labelOffsets moves it, where the request has no anchor (a callout). Read by moves only. */
270
+ movedLeaderFrom?: Point;
263
271
  /**
264
272
  * The label's drawn leader crosses no other label: a seat whose leader
265
273
  * would is passed over, and a placed leader claims its run, so no later
@@ -277,9 +285,19 @@ export interface LabelRequest {
277
285
  /** With `leaderClear`: a seat whose leader crosses an axis tick label is passed over too, such as a rank number. */
278
286
  leaderClearsAxis?: boolean;
279
287
  }
288
+ export type LabelOffset = {
289
+ x?: number;
290
+ y?: number;
291
+ };
280
292
  export interface SolveCtx {
293
+ /** Internal: a host chart names the claims of the labels (claims/ids.ts). */
294
+ [HOST_CLAIMS]?: HostClaims;
281
295
  density: LabelDensity;
282
296
  pins: Record<Id, SlotId>;
297
+ /** Authored moves by label id, in px (options.labelOffsets). A move that is blocked keeps the chosen seat and warns. */
298
+ labelOffsets?: Record<Id, LabelOffset>;
299
+ /** Internal: each label's seat without any offset. A move may not land on another label's seat, placed yet or not. */
300
+ naturalSeats?: ReadonlyMap<Id, Rect>;
283
301
  measure: TextMeasurer;
284
302
  plot: Rect;
285
303
  /** Full canvas — candidates outside it are rejected. */
@@ -309,11 +327,13 @@ export interface SolveCtx {
309
327
  /**
310
328
  * Ordered computed rows: keep all, every second from the end when allowed, or none.
311
329
  * `keepEnds` makes a row that is omitted keep its first and last value.
330
+ * `from` starts the row at a later step, for a chart whose floor the full row would put above the width.
312
331
  */
313
332
  valueRows?: {
314
333
  ids: readonly Id[];
315
334
  alternate?: boolean;
316
335
  keepEnds?: boolean;
336
+ from?: 'alternate' | 'none';
317
337
  }[];
318
338
  /**
319
339
  * The drawn line points of the plot. With it, a value
@@ -328,6 +348,7 @@ interface LabelCtxOptions {
328
348
  focus?: FocusInput | null;
329
349
  labelDensity?: LabelDensity;
330
350
  labelPlacements?: Record<Id, SlotId>;
351
+ labelOffsets?: Record<Id, LabelOffset>;
331
352
  }
332
353
  /**
333
354
  * A chart's solver context: the authored focus, density and pins, the canvas