boardplot 0.57.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 (494) hide show
  1. package/CHANGELOG.md +298 -0
  2. package/README.md +48 -14
  3. package/dist/{DiagnosticDetails-JFBBXOT2.js → DiagnosticDetails-VGSL4NJK.js} +1 -1
  4. package/dist/{ReaderBox-GCIITQCX.js → ReaderBox-MHMXIDAJ.js} +8 -7
  5. package/dist/{annotateEngine-JMZI6QEG.js → annotateEngine-753KQBNN.js} +2 -1
  6. package/dist/build-identity.json +3 -3
  7. package/dist/{chunk-5WSIH4SR.js → chunk-2CQBBN7M.js} +4 -4
  8. package/dist/{chunk-Q7VPTN5X.js → chunk-2ETK5TSA.js} +4 -4
  9. package/dist/{chunk-NO7GRVUU.js → chunk-2ETSI2EL.js} +8 -8
  10. package/dist/{chunk-4RN4OM6I.js → chunk-2GRXHWRH.js} +3 -3
  11. package/dist/{chunk-QFIRPOXR.js → chunk-2HII2B6S.js} +3 -3
  12. package/dist/{chunk-K6Y4HBK7.js → chunk-2LC2H3ZM.js} +1000 -904
  13. package/dist/{chunk-KF3ZHLHQ.js → chunk-2NX7EO7H.js} +5 -5
  14. package/dist/{chunk-D5G67OER.js → chunk-2QI2PK2O.js} +1 -1
  15. package/dist/{chunk-AFA32LHN.js → chunk-2VKQQLP7.js} +62 -36
  16. package/dist/chunk-3DOVXJ6K.js +602 -0
  17. package/dist/{chunk-XJUZC53Y.js → chunk-3E6NLODZ.js} +1 -1
  18. package/dist/{chunk-D5RAVZ5C.js → chunk-3HA4IJTO.js} +9 -8
  19. package/dist/{chunk-OTGNVAI4.js → chunk-3HPPTQEW.js} +4 -4
  20. package/dist/{chunk-TGR6PRKG.js → chunk-3KT2647F.js} +4 -2
  21. package/dist/{chunk-UBXIGE2P.js → chunk-3MFVJMP6.js} +2 -2
  22. package/dist/{chunk-JKXJWCJ5.js → chunk-3P3FKPFN.js} +116 -54
  23. package/dist/{chunk-JMOBA5ES.js → chunk-3XAJSMYD.js} +2 -2
  24. package/dist/{chunk-I65OLJ2X.js → chunk-42QKUSHJ.js} +13 -3
  25. package/dist/{chunk-Y5IKCXQR.js → chunk-44JU3VOT.js} +5 -5
  26. package/dist/{chunk-YBYV56FS.js → chunk-44K75CYE.js} +3 -3
  27. package/dist/{chunk-WKWCNS6K.js → chunk-4FNM4D57.js} +5 -5
  28. package/dist/{chunk-UD6U4EF5.js → chunk-4ROZ4TFL.js} +1 -1
  29. package/dist/{chunk-LO3AGGE3.js → chunk-4VV3KUFT.js} +5 -5
  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-SHAAMKN7.js → chunk-5JEU6MWC.js} +18 -18
  33. package/dist/{chunk-I7KDPCC7.js → chunk-5JIB4VJA.js} +18 -10
  34. package/dist/{chunk-C5SQEYTQ.js → chunk-5OP3E2ZD.js} +153 -65
  35. package/dist/{chunk-BDCKHLUB.js → chunk-5SLBD4BT.js} +72 -304
  36. package/dist/{chunk-2BHLRHF2.js → chunk-5SVGTQTW.js} +4 -4
  37. package/dist/chunk-5U567TYU.js +23 -0
  38. package/dist/{chunk-BFDPY7JM.js → chunk-5ZLF4S7X.js} +11 -6
  39. package/dist/{chunk-73O6AOAA.js → chunk-5ZMTQATF.js} +241 -140
  40. package/dist/{chunk-5JTRCSBN.js → chunk-62BDQTO6.js} +2 -2
  41. package/dist/chunk-64K3V4VN.js +25 -0
  42. package/dist/{chunk-BM2A3IGQ.js → chunk-67YJJJIB.js} +1 -1
  43. package/dist/{chunk-TDDSWNGD.js → chunk-6DJNFT2K.js} +30 -28
  44. package/dist/{chunk-JYAZPMSA.js → chunk-6IUK6PAH.js} +7 -6
  45. package/dist/{chunk-W5SVS4B6.js → chunk-6JFQCVNN.js} +4 -4
  46. package/dist/{chunk-H2POQ4LB.js → chunk-6XPV6M3Q.js} +4 -4
  47. package/dist/{chunk-XFCBH3TI.js → chunk-6ZDSEITW.js} +3 -3
  48. package/dist/{chunk-LFX5BERN.js → chunk-72HVDLMT.js} +46 -32
  49. package/dist/chunk-75NU5RLX.js +24 -0
  50. package/dist/chunk-76GPN6AT.js +72 -0
  51. package/dist/{chunk-EFKFZNQC.js → chunk-7CAYRPJV.js} +34 -20
  52. package/dist/{chunk-EWR6WVOV.js → chunk-7GWWBHVQ.js} +6 -6
  53. package/dist/{chunk-H6EJ63QN.js → chunk-7NYUFMLJ.js} +143 -82
  54. package/dist/{chunk-D2B3KP35.js → chunk-7VWXXBTC.js} +4 -0
  55. package/dist/chunk-A65B23JK.js +113 -0
  56. package/dist/{chunk-XNV7VOIT.js → chunk-A7R6FUS6.js} +4 -4
  57. package/dist/{chunk-KIXNHDXS.js → chunk-AEVGUOPB.js} +5 -5
  58. package/dist/{chunk-IXM6BAM4.js → chunk-AHIK2N72.js} +1 -1
  59. package/dist/{chunk-I3DLERI7.js → chunk-AICO24HJ.js} +5 -2
  60. package/dist/{chunk-LSKCKGCF.js → chunk-AJGSCVVW.js} +2 -2
  61. package/dist/{chunk-RSCRIWAH.js → chunk-AL62JJTB.js} +10 -3
  62. package/dist/{chunk-CT4RFZO4.js → chunk-AN2V2LC4.js} +37 -22
  63. package/dist/{chunk-T5MBORBK.js → chunk-AOFUA5XP.js} +1 -1
  64. package/dist/{chunk-7FAO4ICF.js → chunk-BCMEGJRX.js} +2 -2
  65. package/dist/{chunk-H3EWFSWI.js → chunk-BDIKWR45.js} +43 -29
  66. package/dist/{chunk-DJBMA4FW.js → chunk-BG6AIWAK.js} +4 -6
  67. package/dist/{chunk-6XU5XGYV.js → chunk-BOT6W3VB.js} +5 -5
  68. package/dist/{chunk-DRHQG44U.js → chunk-BQBD6Q5J.js} +6 -2
  69. package/dist/{chunk-6LQKU6YN.js → chunk-BZ67BJBH.js} +11 -10
  70. package/dist/{chunk-2AJWRVZ2.js → chunk-C47POAC5.js} +1 -1
  71. package/dist/{chunk-FJKFYQ5I.js → chunk-C5OBPO4Z.js} +36 -28
  72. package/dist/{chunk-Y7Q3VEYC.js → chunk-CCAAI56H.js} +30 -10
  73. package/dist/{chunk-T3WCDDIL.js → chunk-CDUR3KWV.js} +2 -2
  74. package/dist/{chunk-WE5WVQE4.js → chunk-CMPHT2LS.js} +3 -3
  75. package/dist/{chunk-FHA3KMFC.js → chunk-CQBPNE7Z.js} +5 -1
  76. package/dist/{chunk-JSA3ESEJ.js → chunk-CR5FP5SF.js} +1 -1
  77. package/dist/{chunk-JHWDTV4K.js → chunk-D2TQX7UJ.js} +2 -2
  78. package/dist/{chunk-5TUDYKNL.js → chunk-DEANHDXU.js} +42 -29
  79. package/dist/{chunk-GHFTKVJN.js → chunk-DHGE46UK.js} +1 -1
  80. package/dist/{chunk-ZSYU6LIH.js → chunk-DIHX6NUB.js} +5 -5
  81. package/dist/{chunk-W7Q6PLT4.js → chunk-DILQ34NW.js} +37 -37
  82. package/dist/{chunk-IZRTNCJQ.js → chunk-DJKRYJP7.js} +5 -5
  83. package/dist/{chunk-43PCSBVQ.js → chunk-DKLC6QLF.js} +634 -8
  84. package/dist/{chunk-I6QGYRY4.js → chunk-DNHTMCUP.js} +2 -2
  85. package/dist/{chunk-26WNBTWB.js → chunk-DORE2RHL.js} +5 -5
  86. package/dist/{chunk-WZB6R2ZX.js → chunk-DZYTXZNS.js} +11 -3
  87. package/dist/chunk-E262NRFP.js +39 -0
  88. package/dist/{chunk-O4D27FKH.js → chunk-E5YF236N.js} +4 -1
  89. package/dist/{chunk-5H4HFRDO.js → chunk-EBUK7HJP.js} +5 -5
  90. package/dist/{chunk-YGPLUENN.js → chunk-ECBHC272.js} +132 -83
  91. package/dist/{chunk-KLQKHA3T.js → chunk-EFW43JQJ.js} +5 -5
  92. package/dist/{chunk-VM5CQ7CG.js → chunk-EHRRHSPV.js} +2 -2
  93. package/dist/{chunk-PYGEIPPH.js → chunk-EILNJQMN.js} +32 -12
  94. package/dist/{chunk-KGS5Z7SL.js → chunk-ERDKMZ7O.js} +2 -2
  95. package/dist/{chunk-AFGQXMKT.js → chunk-ETRAPN5G.js} +143 -62
  96. package/dist/{chunk-USFIDSTO.js → chunk-ETUKDEGL.js} +18 -11
  97. package/dist/chunk-F2ET5ZTT.js +49 -0
  98. package/dist/{chunk-HVX2E26J.js → chunk-F3XOBFS4.js} +9 -8
  99. package/dist/{chunk-I4NUYVP5.js → chunk-FB6X7QHA.js} +1 -1
  100. package/dist/{chunk-LW4ZQGVL.js → chunk-FGW54I23.js} +7 -8
  101. package/dist/{chunk-UCIAHSJK.js → chunk-FP5B5XIL.js} +7 -3
  102. package/dist/{chunk-QRZESG66.js → chunk-FRHQGA5Q.js} +64 -239
  103. package/dist/{chunk-YTEJYLU7.js → chunk-FRR7BJ3B.js} +2 -2
  104. package/dist/{chunk-DPUCT567.js → chunk-FVWHEM2N.js} +7 -5
  105. package/dist/{chunk-54HEIM2A.js → chunk-FWSMENKH.js} +2 -2
  106. package/dist/{chunk-F4JAGDPD.js → chunk-FWTUGNSF.js} +8 -8
  107. package/dist/{chunk-HB3TH7GY.js → chunk-FZKDZQ6U.js} +10 -6
  108. package/dist/{chunk-6EE6XEMA.js → chunk-G4FF6G3I.js} +25 -16
  109. package/dist/{chunk-72OJBDRB.js → chunk-GB6BZSTL.js} +52 -41
  110. package/dist/{chunk-QLWUFEKR.js → chunk-GCIHRRDJ.js} +8 -8
  111. package/dist/{chunk-MTCDGSYW.js → chunk-GHCU6OSE.js} +2 -2
  112. package/dist/chunk-GO66OCN7.js +24 -0
  113. package/dist/chunk-GOFS336W.js +24 -0
  114. package/dist/{chunk-JMXNXLAC.js → chunk-GQYT7G4F.js} +2 -2
  115. package/dist/{chunk-TWRFVW3J.js → chunk-GUTLXO7Q.js} +138 -89
  116. package/dist/{chunk-RRPTQGRU.js → chunk-H3VICNTN.js} +1 -1
  117. package/dist/{chunk-GC4WOLV3.js → chunk-HAG3K6PQ.js} +14 -2
  118. package/dist/{chunk-7P7D6WXR.js → chunk-HBQHSZ6S.js} +3 -3
  119. package/dist/{chunk-ZV3SNRJI.js → chunk-HTQGJQZN.js} +4 -2
  120. package/dist/{chunk-VY67Q6CJ.js → chunk-HUQRO6VF.js} +36 -33
  121. package/dist/{chunk-WSKZZ2ZB.js → chunk-I5VDW2XZ.js} +538 -503
  122. package/dist/{chunk-TMXRTYGT.js → chunk-I5VNHDPR.js} +3 -2
  123. package/dist/{chunk-M74H7QYD.js → chunk-IDXYHDQY.js} +1 -1
  124. package/dist/{chunk-IPWUBZ4P.js → chunk-IIWZJ5ZM.js} +1 -1
  125. package/dist/{chunk-HC6WHTBX.js → chunk-IPBOREIY.js} +1 -1
  126. package/dist/chunk-IU335UO7.js +27 -0
  127. package/dist/{chunk-WDAZ2MT4.js → chunk-IVDTP6SV.js} +4 -4
  128. package/dist/{chunk-BDGLMWPO.js → chunk-IXOBDDMW.js} +11 -2
  129. package/dist/{chunk-PSYPB22T.js → chunk-J4QRB6DQ.js} +5 -5
  130. package/dist/{chunk-CEMXGMQN.js → chunk-JCMGKQVS.js} +3 -3
  131. package/dist/{chunk-XR7VOF2V.js → chunk-JM7UTLF3.js} +25 -13
  132. package/dist/{chunk-VY2NPB2Q.js → chunk-JNDWRV34.js} +4 -4
  133. package/dist/{chunk-SHCW2TCA.js → chunk-JSRQTDZZ.js} +25 -23
  134. package/dist/{chunk-XYUXB5VK.js → chunk-JT3UTEWZ.js} +3 -3
  135. package/dist/{chunk-BO5EJBLH.js → chunk-JUYRDZSV.js} +63 -43
  136. package/dist/{chunk-I5ZADE2U.js → chunk-JVGL2SCN.js} +1 -1
  137. package/dist/{chunk-A6XCVOC5.js → chunk-JY4LTPOV.js} +1 -1
  138. package/dist/chunk-K7XPTQBJ.js +267 -0
  139. package/dist/{chunk-JIH52I36.js → chunk-KGBUXMFP.js} +119 -85
  140. package/dist/{chunk-2KCK63DD.js → chunk-KIE5V3DA.js} +2 -2
  141. package/dist/{chunk-A33MFWHW.js → chunk-KU4PCG4W.js} +2 -2
  142. package/dist/{chunk-MQ5EKWIG.js → chunk-KVBLTAO7.js} +5 -5
  143. package/dist/{chunk-XCROSJ2Z.js → chunk-KW4JXWHO.js} +1 -1
  144. package/dist/{chunk-BY5JGQFZ.js → chunk-KWIP5YRA.js} +4 -4
  145. package/dist/{chunk-JRRSKCGG.js → chunk-LG6M2JTH.js} +3 -3
  146. package/dist/{chunk-KUMJI5B6.js → chunk-LIE2WSB4.js} +17 -14
  147. package/dist/{chunk-KAAB2DIV.js → chunk-LJDATBPB.js} +6 -6
  148. package/dist/{chunk-EHNGPUTO.js → chunk-LMMS675D.js} +5 -5
  149. package/dist/{chunk-ANNQJWDX.js → chunk-LPKGZ664.js} +285 -34
  150. package/dist/{chunk-ZTSJ7NY6.js → chunk-LPMSGO7L.js} +3 -3
  151. package/dist/chunk-LQWINE7K.js +211 -0
  152. package/dist/{chunk-RHBQ2Q5H.js → chunk-MKMMQDIY.js} +60 -43
  153. package/dist/{chunk-RMVCKO6N.js → chunk-MQ4IEDM5.js} +458 -136
  154. package/dist/{chunk-J22ETKDJ.js → chunk-MRM4KJ2O.js} +2 -2
  155. package/dist/{chunk-Z2BDTZDT.js → chunk-MX2OZHIT.js} +97 -39
  156. package/dist/{chunk-IFURKTOL.js → chunk-MXUPMGRY.js} +2 -2
  157. package/dist/{chunk-IUVJVMKS.js → chunk-NHU26HQ7.js} +55 -32
  158. package/dist/{chunk-6KHRMK3I.js → chunk-NQVJ4FPY.js} +158 -75
  159. package/dist/chunk-NZ7FX3AE.js +65 -0
  160. package/dist/{chunk-L2XRUG4P.js → chunk-OALBVELJ.js} +5 -5
  161. package/dist/{chunk-3DUGZ7ML.js → chunk-OGZ4UPYK.js} +46 -31
  162. package/dist/{chunk-7MYJUJZV.js → chunk-OMNB27GM.js} +4 -4
  163. package/dist/{chunk-GS5UG6QD.js → chunk-OO63YP35.js} +1 -1
  164. package/dist/{chunk-RHVP62HI.js → chunk-OPYDTW5Q.js} +5 -5
  165. package/dist/{chunk-4U2WSW6F.js → chunk-OSJN7KDS.js} +65 -36
  166. package/dist/{chunk-EY4OA4OF.js → chunk-OSJXIW6I.js} +370 -785
  167. package/dist/{chunk-NRYERHEI.js → chunk-OVVE42P4.js} +5 -5
  168. package/dist/{chunk-Z257SH5U.js → chunk-OZA7HA6L.js} +1 -1
  169. package/dist/{chunk-WJQX7HBH.js → chunk-OZLKEBCD.js} +2 -2
  170. package/dist/{chunk-DYSEZVIJ.js → chunk-P6DEFCMQ.js} +2 -2
  171. package/dist/{chunk-CIDOL4FO.js → chunk-PDTIQL3B.js} +5 -5
  172. package/dist/{chunk-TQ5HHNM3.js → chunk-PJ5BYZPN.js} +2 -2
  173. package/dist/{chunk-EHQLLZCQ.js → chunk-PK7Z7WRJ.js} +59 -34
  174. package/dist/{chunk-KJLH5EHD.js → chunk-PL6NWB5U.js} +175 -110
  175. package/dist/chunk-PMT75APP.js +94 -0
  176. package/dist/{chunk-KQ2WZ6BY.js → chunk-PP6A4X55.js} +1 -1
  177. package/dist/{chunk-O7Y6RJ4D.js → chunk-PPCH3PLO.js} +11 -11
  178. package/dist/{chunk-IRXTNSZL.js → chunk-PPE6S7WU.js} +40 -22
  179. package/dist/{chunk-VT7PBGL2.js → chunk-PT7KSIEO.js} +23 -36
  180. package/dist/{chunk-GADI2DU7.js → chunk-QAUGRVRU.js} +121 -23
  181. package/dist/{chunk-2X6XY4K4.js → chunk-QMFWZG2P.js} +39 -19
  182. package/dist/{chunk-YB6QGOCO.js → chunk-QZGGCE45.js} +2 -2
  183. package/dist/{chunk-5P4MXWKP.js → chunk-R2RJQ3BM.js} +4 -4
  184. package/dist/{chunk-FAFUMSPR.js → chunk-R7HBIQ63.js} +83 -51
  185. package/dist/{chunk-76UL4CT4.js → chunk-RBNDZLYS.js} +27 -22
  186. package/dist/{chunk-XN7JDII2.js → chunk-RCSY4CT4.js} +230 -107
  187. package/dist/{chunk-OAT6FWKL.js → chunk-RHQRPJHS.js} +5 -5
  188. package/dist/chunk-RI6XQKWJ.js +26 -0
  189. package/dist/{chunk-FX5VZK5F.js → chunk-RJICOOB3.js} +14 -8
  190. package/dist/{chunk-NINK4G7U.js → chunk-RLAVNCQJ.js} +2 -2
  191. package/dist/{chunk-FERP4WS3.js → chunk-ROPPWJQB.js} +11 -10
  192. package/dist/{chunk-SSZB3VXG.js → chunk-SELOV32X.js} +102 -47
  193. package/dist/{chunk-EEBMK6T6.js → chunk-SQI4NWTQ.js} +8 -8
  194. package/dist/{chunk-2WTD3GCR.js → chunk-SRJ74CMG.js} +2 -2
  195. package/dist/{chunk-LSR3SBJ4.js → chunk-STWOURLG.js} +234 -136
  196. package/dist/{chunk-BQIADGJB.js → chunk-SWMFXSVW.js} +5 -5
  197. package/dist/{chunk-5HTGSB6Y.js → chunk-SZ5VGWDY.js} +3 -3
  198. package/dist/{chunk-EDBUVDRI.js → chunk-T26G23RS.js} +359 -86
  199. package/dist/chunk-T7GPIJ4L.js +89 -0
  200. package/dist/{chunk-LGMV7ZV4.js → chunk-TAEB3RU6.js} +5 -5
  201. package/dist/{chunk-YFI5PN5O.js → chunk-TBDIMTRD.js} +34 -11
  202. package/dist/{chunk-HDSHS2QZ.js → chunk-TFFPEWNP.js} +70 -47
  203. package/dist/{chunk-YO5UKKCQ.js → chunk-TMEUK2WS.js} +6 -2
  204. package/dist/{chunk-X5OVVMZX.js → chunk-TVOMGNFQ.js} +1 -1
  205. package/dist/{chunk-JARJP576.js → chunk-TX5FSNAU.js} +435 -29
  206. package/dist/{chunk-LUZ7HXBT.js → chunk-U52PNFPX.js} +1 -1
  207. package/dist/chunk-U74AWJ3X.js +24 -0
  208. package/dist/chunk-UC7LBW7N.js +26 -0
  209. package/dist/{chunk-V3UE3TB7.js → chunk-UCKUAKYQ.js} +2 -2
  210. package/dist/{chunk-62JZL6FW.js → chunk-UCYL3YA7.js} +56 -42
  211. package/dist/{chunk-AKJO6N4K.js → chunk-UD2GI3CS.js} +11 -4
  212. package/dist/{chunk-MOQFYJ3F.js → chunk-ULQIC76A.js} +5 -5
  213. package/dist/{chunk-HFFKN7PA.js → chunk-UY34DDUM.js} +3 -3
  214. package/dist/{chunk-2I76VFMZ.js → chunk-UYMFLWM6.js} +49 -37
  215. package/dist/{chunk-3LNVEE5Z.js → chunk-V7FV66KL.js} +1 -1
  216. package/dist/{chunk-UP4JSNDR.js → chunk-V7NUJEJE.js} +1 -1
  217. package/dist/{chunk-53OEKS4L.js → chunk-VESSIKBG.js} +6 -3
  218. package/dist/{chunk-HGPFEG2L.js → chunk-VRFJAF3R.js} +5 -5
  219. package/dist/chunk-VS2R3OGN.js +34 -0
  220. package/dist/{chunk-EEL2N4Y6.js → chunk-VS5B4J2D.js} +5 -5
  221. package/dist/{chunk-G5BUGYIL.js → chunk-W4R6SGU3.js} +192 -113
  222. package/dist/{chunk-JKOEHRGV.js → chunk-WDLWWEHZ.js} +1 -1
  223. package/dist/{chunk-IW3YUMPI.js → chunk-WFBN2HXR.js} +2 -2
  224. package/dist/{chunk-YCUNFAEE.js → chunk-WJS6SAWA.js} +238 -127
  225. package/dist/{chunk-VFLMBA2M.js → chunk-WQYNKF33.js} +19 -18
  226. package/dist/{chunk-QNLESRH6.js → chunk-WUP6C4ZD.js} +2 -2
  227. package/dist/{chunk-4JNHF6JW.js → chunk-X24WAHHV.js} +84 -40
  228. package/dist/{chunk-GKQLKUMF.js → chunk-X3UCQPVV.js} +41 -32
  229. package/dist/{chunk-TXMS7QUJ.js → chunk-X46PSAJ7.js} +6 -6
  230. package/dist/{chunk-M2OQK2FO.js → chunk-XD5XB22R.js} +2 -2
  231. package/dist/{chunk-AOIZJ7GR.js → chunk-XDIAQEYK.js} +6 -6
  232. package/dist/{chunk-7EQU2TUN.js → chunk-XFPNYHX3.js} +84 -53
  233. package/dist/{chunk-NCCDEUHD.js → chunk-XIBVAKCO.js} +1 -1
  234. package/dist/{chunk-SD6ENKTO.js → chunk-XMX4PCFL.js} +3 -3
  235. package/dist/{chunk-2HD5RY2U.js → chunk-XRRG4MBM.js} +3 -3
  236. package/dist/{chunk-Y5WHM2Q5.js → chunk-XTFO6D4L.js} +1 -1
  237. package/dist/chunk-XWRI3N5O.js +70 -0
  238. package/dist/{chunk-IVQT2E3Y.js → chunk-XXPLPSOE.js} +13 -13
  239. package/dist/{chunk-YNHPPZ7S.js → chunk-XZXZNI7A.js} +1 -1
  240. package/dist/{chunk-QZMLSK43.js → chunk-YEJZ2OYS.js} +294 -145
  241. package/dist/{chunk-GAFEN3H7.js → chunk-Z3WQXVFV.js} +2 -2
  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-CV3NC75L.js → chunk-ZBOOMLHD.js} +1 -1
  245. package/dist/{chunk-ZDD3MJ2H.js → chunk-ZDJ7C64T.js} +1 -1
  246. package/dist/{chunk-OKM5LYYP.js → chunk-ZGZLEUKM.js} +5 -5
  247. package/dist/{chunk-QHPJ5ZKS.js → chunk-ZHRGX225.js} +5 -5
  248. package/dist/{chunk-QYOZ46ZQ.js → chunk-ZIVCPXXL.js} +467 -650
  249. package/dist/{chunk-V62B23VC.js → chunk-ZNRSYS76.js} +8 -2
  250. package/dist/{chunk-UFZXZJJG.js → chunk-ZSLTSCTI.js} +5 -5
  251. package/dist/{chunk-NIDH22DI.js → chunk-ZSYFQSPF.js} +12 -2
  252. package/dist/cli/index.js +8 -3
  253. package/dist/{core-UNX4ZV4M.js → core-43GLGBOY.js} +5 -1
  254. package/dist/{core-T3OSZOVV.js → core-5GI3ERXO.js} +3 -1
  255. package/dist/{core-AMWCZTOT.js → core-5L7TMK7I.js} +5 -1
  256. package/dist/{core-5S5CJHBG.js → core-7TO4OVY5.js} +2 -1
  257. package/dist/{core-BJZEJ63L.js → core-BJVENHFQ.js} +3 -1
  258. package/dist/{core-A7HXVSKB.js → core-BX4MFWKC.js} +2 -1
  259. package/dist/{core-4PW4MXWR.js → core-C3KXTOIZ.js} +4 -1
  260. package/dist/{core-SKMHEA4Y.js → core-C5Y6BFLL.js} +3 -1
  261. package/dist/{core-FTQBESDS.js → core-CLUSJ2SK.js} +3 -1
  262. package/dist/{core-QM34237W.js → core-E3IN2VVH.js} +2 -1
  263. package/dist/{core-4M4RY7MX.js → core-FD67NQOV.js} +3 -1
  264. package/dist/{core-WXZJ7V7S.js → core-FDKMLRAK.js} +4 -1
  265. package/dist/{core-L3UR75IJ.js → core-FL6Z3VVX.js} +4 -1
  266. package/dist/{core-XKXDXALI.js → core-JC7JUFPY.js} +6 -1
  267. package/dist/{core-WP73P4CW.js → core-JF33TADA.js} +5 -1
  268. package/dist/{core-DMDAXVMY.js → core-JH32ZAKM.js} +2 -1
  269. package/dist/{core-GS4DXDDG.js → core-JYYZPPQV.js} +4 -1
  270. package/dist/{core-N2JEWJ7D.js → core-KJTKCV4U.js} +2 -1
  271. package/dist/{core-7XKNJM7Y.js → core-LCQPE5Y6.js} +5 -1
  272. package/dist/{core-ZACFV6XR.js → core-LHVGWE54.js} +5 -1
  273. package/dist/{core-VT35VDVS.js → core-OVSNBOCE.js} +6 -1
  274. package/dist/{core-AVA4XLQ2.js → core-PPEC236B.js} +2 -1
  275. package/dist/{core-QFAVWFI3.js → core-QTJZDK5H.js} +2 -1
  276. package/dist/{core-VWYXK2R3.js → core-R3YZCOUZ.js} +4 -1
  277. package/dist/{core-OFPPRHYY.js → core-RIBW5XU4.js} +3 -1
  278. package/dist/{core-MAW4S3KA.js → core-RJFILBWL.js} +5 -1
  279. package/dist/{core-FCSA74RT.js → core-RWSXEKTE.js} +3 -1
  280. package/dist/{core-WPEYRK6Y.js → core-SOPPZLEH.js} +4 -1
  281. package/dist/{core-EMSJRGSE.js → core-TBUZCXLX.js} +2 -1
  282. package/dist/{core-OBPTBKX6.js → core-TZ5QLTAX.js} +2 -1
  283. package/dist/{core-JDZDBTID.js → core-U7E5W4MY.js} +2 -1
  284. package/dist/{core-ZSERZGK6.js → core-UBNVSL44.js} +3 -1
  285. package/dist/{core-WNT6ZMRO.js → core-UDRD4WIU.js} +2 -1
  286. package/dist/{core-VRVL6LIM.js → core-UVJZ4HY2.js} +3 -1
  287. package/dist/{core-7TTM4KRP.js → core-X7WWYQH4.js} +3 -1
  288. package/dist/{core-D2OIGYC7.js → core-XP56X47I.js} +4 -1
  289. package/dist/{core-CCB3IXGD.js → core-XQG54CYG.js} +3 -1
  290. package/dist/{dataTable-7IO546LM.js → dataTable-U7W4I6IF.js} +7 -2
  291. package/dist/{engine-US3N6UCH.js → engine-O5V26MGR.js} +23 -18
  292. package/dist/fixtures.js +2 -1
  293. package/dist/flags-BVLSAXT3.js +10 -0
  294. package/dist/{fontTables-ZPZQ6IR3.js → fontTables-JUW7ZTQY.js} +3 -1
  295. package/dist/geo/dach.js +1 -1
  296. package/dist/geo/de-states.js +1 -1
  297. package/dist/geo/eu27.js +1 -1
  298. package/dist/geo/europe.js +1 -1
  299. package/dist/geo/index.js +2 -2
  300. package/dist/geo/us-states.js +1 -1
  301. package/dist/geo/world.js +1 -1
  302. package/dist/index.js +27 -20
  303. package/dist/{main-2UWKGUHR.js → main-35GS47XC.js} +50 -119
  304. package/dist/mcp/server.js +121 -118
  305. package/dist/react/bar.js +5 -1
  306. package/dist/react/bartable.js +3 -1
  307. package/dist/react/box.js +3 -1
  308. package/dist/react/bullet.js +4 -1
  309. package/dist/react/butterfly.js +5 -1
  310. package/dist/react/choropleth.js +3 -1
  311. package/dist/react/cohort.js +3 -1
  312. package/dist/react/column.js +5 -1
  313. package/dist/react/combo.js +5 -1
  314. package/dist/react/creative.js +4 -1
  315. package/dist/react/diagram.js +3 -1
  316. package/dist/react/dimswitch.js +6 -1
  317. package/dist/react/dot.js +4 -1
  318. package/dist/react/export.js +29 -18
  319. package/dist/react/funnel.js +4 -1
  320. package/dist/react/gantt.js +3 -1
  321. package/dist/react/grid.js +6 -1
  322. package/dist/react/heatmap.js +3 -1
  323. package/dist/react/histogram.js +6 -1
  324. package/dist/react/index.js +92 -85
  325. package/dist/react/kpi.js +4 -1
  326. package/dist/react/likert.js +6 -1
  327. package/dist/react/line.js +4 -1
  328. package/dist/react/mekko.js +5 -1
  329. package/dist/react/pareto.js +6 -1
  330. package/dist/react/pie.js +4 -1
  331. package/dist/react/prepare.js +35 -22
  332. package/dist/react/pvm.js +6 -1
  333. package/dist/react/pyramid.js +5 -1
  334. package/dist/react/sankey.js +3 -1
  335. package/dist/react/scatter.js +3 -1
  336. package/dist/react/slope.js +4 -1
  337. package/dist/react/sparkline.js +4 -1
  338. package/dist/react/spec.js +17 -13
  339. package/dist/react/status.js +3 -1
  340. package/dist/react/story.js +3 -2
  341. package/dist/react/table.js +4 -1
  342. package/dist/react/theme.js +5 -3
  343. package/dist/react/tilemap.js +3 -1
  344. package/dist/react/treemap.js +3 -1
  345. package/dist/react/variance.js +5 -1
  346. package/dist/react/waffle.js +3 -1
  347. package/dist/react/waterfall.js +5 -1
  348. package/dist/{resvg-VB7S5HRF.js → resvg-ZYEZTSUO.js} +3 -1
  349. package/dist/rows.js +2 -2
  350. package/dist/{rowsModule-DYDVHBAX.js → rowsModule-H2S6WW4D.js} +1 -1
  351. package/dist/{schema-YDZCGL56.js → schema-2R32F6AW.js} +1 -3
  352. package/dist/{schema-A2XUZUCV.js → schema-2TPGJGVR.js} +1 -3
  353. package/dist/{schema-MD22QYZU.js → schema-47BG2TZA.js} +1 -3
  354. package/dist/{schema-HEB6ZDI5.js → schema-56MOEOVR.js} +1 -3
  355. package/dist/{schema-K4V4PYBO.js → schema-5MSR4LNN.js} +1 -3
  356. package/dist/{schema-NOBNFD2F.js → schema-5RIYEWE6.js} +1 -3
  357. package/dist/{schema-PHIHMDVB.js → schema-A26ZNGTZ.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-6PL46VXZ.js → schema-FU2AFIEE.js} +1 -3
  372. package/dist/{schema-XIHAKX3B.js → schema-JNJFCYBM.js} +1 -1
  373. package/dist/{schema-6V5K3J2V.js → schema-JYZ4RF6S.js} +1 -3
  374. package/dist/{schema-GXOG4MXL.js → schema-K7F6TEDK.js} +1 -2
  375. package/dist/{schema-NMIYKGHE.js → schema-KAK6DZX4.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-QPIC5MAG.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-FGE5YK3S.js → schema-Y4TI2T3T.js} +1 -3
  387. package/dist/{schema-MQB6CE5V.js → schema-ZU2EU2VP.js} +1 -3
  388. package/dist/{specValidation-XGELWQUU.js → specValidation-2NHJT7TQ.js} +3 -1
  389. package/dist/theme.js +4 -3
  390. package/dist/{themeShapeRules-PW4BQHKL.js → themeShapeRules-G7UZX6GJ.js} +1 -1
  391. package/dist/types/core/annotate.d.ts +27 -2
  392. package/dist/types/core/annotateArms.d.ts +3 -1
  393. package/dist/types/core/annotateTargets.d.ts +4 -0
  394. package/dist/types/core/annotationOrigin.d.ts +13 -0
  395. package/dist/types/core/axis.d.ts +2 -2
  396. package/dist/types/core/charts/band/stacks.d.ts +7 -1
  397. package/dist/types/core/charts/column/model.d.ts +13 -0
  398. package/dist/types/core/charts/combo/layout.d.ts +7 -0
  399. package/dist/types/core/charts/gantt/calendar.d.ts +4 -0
  400. package/dist/types/core/charts/grid/normalize.d.ts +5 -0
  401. package/dist/types/core/charts/grid/schema.d.ts +2 -2
  402. package/dist/types/core/charts/pareto/layout.d.ts +2 -0
  403. package/dist/types/core/charts/pvm/types.d.ts +1 -0
  404. package/dist/types/core/charts/scatter/clamp.d.ts +2 -1
  405. package/dist/types/core/charts/scatter/model.d.ts +5 -0
  406. package/dist/types/core/charts/scatter/valueLines.d.ts +3 -1
  407. package/dist/types/core/charts/table/resolve.d.ts +8 -3
  408. package/dist/types/core/charts/table/view.d.ts +24 -1
  409. package/dist/types/core/claims/browser.d.ts +2 -0
  410. package/dist/types/core/claims/ids.d.ts +38 -0
  411. package/dist/types/core/deferred.d.ts +1 -0
  412. package/dist/types/core/doc/diagnostics.d.ts +3 -2
  413. package/dist/types/core/formatSpec.d.ts +33 -14
  414. package/dist/types/core/frame.d.ts +25 -58
  415. package/dist/types/core/frameText.d.ts +203 -0
  416. package/dist/types/core/geometry.d.ts +2 -0
  417. package/dist/types/core/label/categoryRow.d.ts +19 -2
  418. package/dist/types/core/label/solver.d.ts +23 -2
  419. package/dist/types/core/normalize/shared.d.ts +12 -2
  420. package/dist/types/core/notes.d.ts +15 -2
  421. package/dist/types/core/reading.d.ts +12 -1
  422. package/dist/types/core/request.d.ts +1 -1
  423. package/dist/types/core/schema/capability.d.ts +12 -0
  424. package/dist/types/core/seriesIdentity.d.ts +4 -1
  425. package/dist/types/core/sizing.d.ts +32 -1
  426. package/dist/types/core/structureCounts.d.ts +3 -1
  427. package/dist/types/core/theme.d.ts +33 -4
  428. package/dist/types/core/themeRules.d.ts +2 -0
  429. package/dist/types/core/types/annotations.d.ts +74 -4
  430. package/dist/types/core/types/options.d.ts +35 -3
  431. package/dist/types/core/types/scene.d.ts +30 -2
  432. package/dist/types/core/types/table.d.ts +6 -0
  433. package/dist/types/core/types/theme.d.ts +23 -0
  434. package/dist/types/react/TableChart.d.ts +5 -0
  435. package/dist/validate.js +13 -6
  436. package/docs/TELEMETRY.md +2 -2
  437. package/docs/manual.md +252 -62
  438. package/docs/reference/bar.md +12 -4
  439. package/docs/reference/bartable.md +2 -2
  440. package/docs/reference/box.md +8 -4
  441. package/docs/reference/bullet.md +9 -5
  442. package/docs/reference/butterfly.md +10 -5
  443. package/docs/reference/choropleth.md +3 -5
  444. package/docs/reference/cohort.md +1 -1
  445. package/docs/reference/column.md +18 -4
  446. package/docs/reference/combo.md +10 -5
  447. package/docs/reference/creative.md +3 -7
  448. package/docs/reference/diagram.md +1 -1
  449. package/docs/reference/dimswitch.md +23 -88
  450. package/docs/reference/dot.md +9 -5
  451. package/docs/reference/fixtures.md +37 -1
  452. package/docs/reference/funnel.md +9 -5
  453. package/docs/reference/gantt.md +8 -15
  454. package/docs/reference/grid.md +5 -2
  455. package/docs/reference/heatmap.md +10 -6
  456. package/docs/reference/kpi.md +1 -1
  457. package/docs/reference/likert.md +9 -4
  458. package/docs/reference/line.md +18 -5
  459. package/docs/reference/mekko.md +10 -5
  460. package/docs/reference/options.md +17 -13
  461. package/docs/reference/pareto.md +8 -4
  462. package/docs/reference/pie.md +9 -5
  463. package/docs/reference/pvm.md +9 -5
  464. package/docs/reference/pyramid.md +8 -4
  465. package/docs/reference/react.md +5 -5
  466. package/docs/reference/sankey.md +2 -2
  467. package/docs/reference/scatter.md +8 -4
  468. package/docs/reference/slope.md +9 -5
  469. package/docs/reference/sparkline.md +1 -1
  470. package/docs/reference/status.md +1 -1
  471. package/docs/reference/table.md +33 -114
  472. package/docs/reference/theme.md +12 -4
  473. package/docs/reference/tilemap.md +2 -4
  474. package/docs/reference/treemap.md +1 -1
  475. package/docs/reference/variance.md +12 -6
  476. package/docs/reference/waffle.md +1 -1
  477. package/docs/reference/warnings.md +1077 -0
  478. package/docs/reference/waterfall.md +16 -4
  479. package/docs/use-cases.md +25 -13
  480. package/llms.txt +19 -6
  481. package/package.json +18 -3
  482. package/dist/chunk-5RHP7YTL.js +0 -24
  483. package/dist/chunk-6VU2XI3W.js +0 -89
  484. package/dist/chunk-6WJOHZPW.js +0 -26
  485. package/dist/chunk-FL3FQ2YA.js +0 -27
  486. package/dist/chunk-G5CELEUR.js +0 -26
  487. package/dist/chunk-M4SPKUZE.js +0 -7
  488. package/dist/chunk-OF7FMGH5.js +0 -24
  489. package/dist/chunk-S2TSXUYP.js +0 -24
  490. package/dist/chunk-TKERVBJ3.js +0 -23
  491. package/dist/chunk-VMGTNB6H.js +0 -25
  492. package/dist/chunk-WZL4EEBS.js +0 -11
  493. package/dist/chunk-YJGFT63R.js +0 -27
  494. package/dist/chunk-ZNX5J7D7.js +0 -47
@@ -31,13 +31,23 @@ export declare function normalizedNumber(raw: unknown, path: string): number;
31
31
  /** Scenario aliases. */
32
32
  export declare function normalizeScenario(s: string | undefined, path: string, namedBaseline?: string): Scenario | undefined;
33
33
  /** Category shorthands. */
34
+ /**
35
+ * A series a bar or column ranks and cuts by: every series but a reference. The
36
+ * topN cut and the item budget both read it, so the budget counts what the cut keeps.
37
+ */
38
+ export declare const ranksCategories: (series: {
39
+ role?: string;
40
+ }) => boolean;
34
41
  export declare function normalizeCategory(raw: string | Category, index: number): Category;
35
42
  /** Bare number ⇒ NumberCell; null passes through. */
36
43
  export declare function normalizeCell(raw: unknown, path: string): Cell;
37
- /** Point-keyed values ⇒ positional. */
44
+ /**
45
+ * Point-keyed values ⇒ positional. A refusal points at data.series[seriesIndex], or, when the caller
46
+ * passes the authored list, at the index of `series` in it; null means the caller cannot know the authored item.
47
+ */
38
48
  export declare function normalizeSeriesValues(series: Series & {
39
49
  values: unknown;
40
- }, categories: Category[], seriesIndex: number): Cell[];
50
+ }, categories: Category[], seriesIndex: number, field?: 'values' | 'negative', authored?: readonly unknown[] | null): Cell[];
41
51
  /** Convert an authored frame to layout pixels. */
42
52
  export declare function resolveSize(size: BaseOptions['size'], target?: RenderTarget): Size;
43
53
  /** Apply outer margins before layouts reserve space for their own labels. */
@@ -81,12 +81,19 @@ export declare function footerParts(notes: readonly ChartNote[], placement: Note
81
81
  * note the static footer does not print. A note it prints (a compact note can repeat one) stays out.
82
82
  */
83
83
  export declare function unprintedNotes(notes: readonly ChartNote[]): ChartNote[];
84
+ /**
85
+ * Set by a composing chart on the options it hands its host, beside the `notes.show`
86
+ * it writes for a `methodNote: true` or a `notes.placement`: no author wrote that list,
87
+ * so the host's live frame prints those disclosures within the line budget.
88
+ */
89
+ export declare const NOTES_ASKED: unique symbol;
84
90
  type NoteAsk = {
85
91
  methodNote?: unknown;
86
92
  notes?: {
87
93
  show?: readonly string[];
88
94
  placement?: unknown;
89
95
  };
96
+ [NOTES_ASKED]?: true;
90
97
  } | undefined;
91
98
  /**
92
99
  * The note kinds the chart prints: `notes.show`, else every engine note where
@@ -94,7 +101,11 @@ type NoteAsk = {
94
101
  * `notes.placement`), else undefined (author notes only).
95
102
  */
96
103
  export declare function shownNoteKinds(options: NoteAsk): readonly string[] | undefined;
97
- /** The options a composing chart hands its host chart, with the note kinds its `methodNote` asked for. */
104
+ /**
105
+ * The options a composing chart hands its host chart, with the note kinds its
106
+ * author asked for. A list the author did not write carries NOTES_ASKED, so the
107
+ * host keys its marks as before and only its live line budget tells the two apart.
108
+ */
98
109
  export declare function keepShownNotes<T extends object>(options: NoteAsk, passed: T): T;
99
110
  /**
100
111
  * True where the author prints the engine's disclosures (`notes.show` lists
@@ -122,6 +133,8 @@ export declare function rankKeyShown(options: {
122
133
  show?: readonly string[];
123
134
  };
124
135
  } | undefined): boolean;
136
+ /** The label of the button that opens the notes panel under 'info': "Notes and sources (3)". */
137
+ export declare function notesPanelLabel(count: number, word: string): string;
125
138
  /** The pointer to the notes list. */
126
139
  export declare function notesPointer(count: number, strings?: StringsSpec): string;
127
140
  /** A capped list note: the frame names as many of its items as fit two footer lines. */
@@ -131,7 +144,7 @@ export interface NoteList {
131
144
  total?: number;
132
145
  options: object;
133
146
  }
134
- interface EngineNoteMeta {
147
+ export interface EngineNoteMeta {
135
148
  kind: 'note' | 'method' | 'disclosure';
136
149
  short?: string;
137
150
  values?: readonly string[];
@@ -8,8 +8,9 @@ import type { StackReadout } from './charts/grid/metricStack.js';
8
8
  */
9
9
  import { type ClaimRecordV1 } from './claims/browser.js';
10
10
  import { type ChartNote } from './notes.js';
11
+ import type { InteractionRecord } from './a11y/types.js';
11
12
  import type { RoundingAdjustment } from './shareRounding.js';
12
- import type { ResolvedChartRequest } from './request.js';
13
+ import { type ResolvedChartRequest } from './request.js';
13
14
  import type { Geometry } from './types/scene.js';
14
15
  import type { StructureCount } from './structureCounts.js';
15
16
  export type { StructureCount } from './structureCounts.js';
@@ -29,6 +30,8 @@ interface DerivedNumber {
29
30
  op: string;
30
31
  operation: string;
31
32
  displayed: string;
33
+ /** What the value means in words, where the chart type has a description; `displayed` is the printed text. */
34
+ description?: string;
32
35
  /** Whether a final label or other published text displays this calculation. */
33
36
  visible: boolean;
34
37
  /** Destination when the displayed value is published in a note. */
@@ -115,6 +118,14 @@ interface ChartReadingInput {
115
118
  request: ResolvedChartRequest;
116
119
  geometry: Geometry;
117
120
  claims: readonly ClaimRecordV1[];
121
+ /** The chart's records when the caller built them already (chartRecords). */
122
+ records?: ChartRecords;
118
123
  }
124
+ type ChartRecords = {
125
+ records: InteractionRecord[] | null;
126
+ note?: string;
127
+ };
128
+ /** The chart's interaction records, without annotation records; null with a note where no adapter covers the type. */
129
+ export declare function chartRecords(input: Omit<ChartReadingInput, 'name' | 'records'>): ChartRecords;
119
130
  /** One chart's reading, from its accepted layout. */
120
131
  export declare function chartReading(input: ChartReadingInput): ChartReading;
@@ -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';
@@ -32,6 +32,15 @@ export type AnnotationsRetiredType = (typeof ANNOTATIONS_RETIRED_TYPES)[number];
32
32
  export declare const LEGEND_DRAWS: Readonly<Record<string, readonly string[]>>;
33
33
  /** Options ignored with a warning when a chart type does not read them. */
34
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
+ }>>;
35
44
  /**
36
45
  * Per-capability narrowing of the shared base.
37
46
  *
@@ -57,6 +66,9 @@ export declare const IGNORED_OPTION_KEYS: ReadonlySet<string>;
57
66
  * inheriting every key.
58
67
  */
59
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
+ };
60
72
  readonly animate: {
61
73
  readonly implementedBy: readonly [];
62
74
  };
@@ -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;
@@ -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
  /**
@@ -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>;
@@ -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>;
@@ -409,6 +409,7 @@ export interface DetailField {
409
409
  format?: string;
410
410
  unit?: string;
411
411
  }
412
+ export type LabelPosition = 'auto' | 'center' | 'insideEnd' | 'insideBase' | 'outsideEnd';
412
413
  export interface BaseOptions {
413
414
  /**
414
415
  * Accessible presentation. `title` emits the SVG hover title (default false);
@@ -502,8 +503,10 @@ export interface BaseOptions {
502
503
  * 'disclosure' the engine's notes on how to read the chart (keys, data
503
504
  * changes, "Not labelled on the chart:..."), outside the budget; 'ranks'
504
505
  * only the rank key, the disclosure that names the rank numbers a column
505
- * row draws when its names do not fit (also printed by 'disclosure'). Engine
506
- * notes not shown stay in the notes list. `pointer`: default true, prints
506
+ * row draws when its names do not fit (also printed by 'disclosure').
507
+ * Without `show`, `methodNote: true` or an authored `placement` prints the
508
+ * method notes and disclosures within the budget, after the author notes.
509
+ * Engine notes not shown stay in the notes list. `pointer`: default true, prints
507
510
  * "+N notes" when the notes list holds more of the kinds `show` prints.
508
511
  */
509
512
  notes?: {
@@ -537,8 +540,15 @@ export interface BaseOptions {
537
540
  /** Named theme palette (theme.color.palettes key) for the series ramp. */
538
541
  palette?: string;
539
542
  labelDensity?: LabelDensity;
543
+ /** Position of bar values. Pins win; auto keeps the chart's normal seats. */
544
+ labelPosition?: LabelPosition;
540
545
  labels?: false | Partial<Record<LabelKind, boolean | LabelContent>>;
541
546
  labelPlacements?: Record<Id, SlotId>;
547
+ /** Moves a label from its chosen seat by a set distance in px, positive x right and positive y down. A blocked move keeps the seat and warns. */
548
+ labelOffsets?: Record<Id, {
549
+ x?: number;
550
+ y?: number;
551
+ }>;
542
552
  /**
543
553
  * Where the category names go (column, combo, pareto). 'axis' (default): the
544
554
  * row under the axis. 'staircase': each name in the free space over the
@@ -731,6 +741,17 @@ export interface ColumnOptions extends Omit<BaseOptionsFor<'column'>, 'categoryA
731
741
  /** Every stacked series is a share of the same whole; the stack then has a total. Stacked variants only. */
732
742
  sharesOfOneWhole?: boolean;
733
743
  referenceStyle?: 'tick' | 'line' | 'marker';
744
+ /**
745
+ * Where a plan tick draws, read under `referenceStyle: 'tick'` only.
746
+ * 'behind' (default): behind its column, reaching up to 4 px past each
747
+ * side (2 px where a plan value beside it needs the room), and a column
748
+ * short of its plan prints its value inside its end.
749
+ * 'front': over the column on a page-colour band, 2 px past each side,
750
+ * and the value takes its earlier seat.
751
+ */
752
+ referenceTick?: {
753
+ position?: 'behind' | 'front';
754
+ };
734
755
  /** Per-category cumulative-boundary ticks; ordered column axes connect them by default. */
735
756
  netLine?: boolean | {
736
757
  seriesId?: Id;
@@ -825,7 +846,7 @@ export interface TornadoCases {
825
846
  low: Id;
826
847
  high: Id;
827
848
  }
828
- export interface BarOptions extends Omit<ColumnOptions, 'ratioTier' | 'variant' | 'anomaly' | 'rowLabels' | 'events' | 'seriesRamp' | 'othersShade' | 'seriesLabels' | 'shareLabels' | 'window' | 'viewDomain' | 'categoryLabels' | 'categoryAxis' | 'ribbons'> {
849
+ export interface BarOptions extends Omit<ColumnOptions, 'ratioTier' | 'variant' | 'anomaly' | 'rowLabels' | 'events' | 'referenceTick' | 'seriesRamp' | 'othersShade' | 'seriesLabels' | 'shareLabels' | 'window' | 'viewDomain' | 'categoryLabels' | 'categoryAxis' | 'ribbons'> {
829
850
  /** Settings per generated column, by column id. A width beats the width the type would pick. */
830
851
  columnOverrides?: Record<string, ColumnOverride>;
831
852
  /** Refused: a bar has no date ticks or band crossing; column, combo and line read categoryAxis. */
@@ -900,6 +921,8 @@ export interface WaterfallOptions extends BaseOptionsFor<'waterfall'> {
900
921
  columnOverrides?: Record<string, {
901
922
  width?: number;
902
923
  }>;
924
+ /** Where step brackets stand: 'shared' (default) puts all on one row, 'span' each right above its own steps. */
925
+ bracketRow?: 'shared' | 'span';
903
926
  }
904
927
  export type LineInterpolation = 'linear' | 'step-after' | 'step-before' | 'monotone';
905
928
  export type GapFillTone = 'good' | 'bad' | 'neutral';
@@ -1013,6 +1036,8 @@ export interface LineXAxis {
1013
1036
  maxTicks?: number;
1014
1037
  }
1015
1038
  export interface LineOptions extends Omit<BaseOptionsFor<'line'>, 'annotations'> {
1039
+ /** Drawn series IDs, or category IDs on one plain data line without a fan. Category selection enlarges the marker and focuses its value while preserving line ink. Series IDs win a shared ID. References do not count as data lines. Unsupported IDs warn without changing the drawing. */
1040
+ highlight?: Id | Id[];
1016
1041
  /** On a time x axis, x anchors also accept epoch milliseconds, including categoryId, date and end. */
1017
1042
  annotations?: Annotation<string | number>[];
1018
1043
  /** Least-squares fit per shown series (line/area) over every source value in the shown range. Regular months, quarters and years fit on the period index; other dates use weeks or elapsed UTC days; otherwise category positions. The key prints slope per period unit and r². At least 3 non-null points; window/zoom sets the fitted range. */
@@ -1063,6 +1088,8 @@ export interface LineOptions extends Omit<BaseOptionsFor<'line'>, 'annotations'>
1063
1088
  seriesLabels?: SeriesLabelMode | {
1064
1089
  only: Id[];
1065
1090
  };
1091
+ /** Point-value side preference. 'shape' defaults on one plain data line without a fan: first finite value left, strict peak above, strict trough below, last finite value right. References do not count. Flat plateaus keep their preference. The solver and labelPlacements pins still apply. 'auto' restores the previous candidate order and endpoint reserves. Other forms keep auto. */
1092
+ pointLabelSide?: 'shape' | 'auto';
1066
1093
  /** Which point values print, each at its own point. Default 'last'; 'ends' on stacked100-area, 'none' on bump. */
1067
1094
  valueLabels?: ValueLabelMode;
1068
1095
  /**
@@ -1657,6 +1684,11 @@ export interface GridOptions extends Omit<BaseOptionsFor<'grid'>, 'format'> {
1657
1684
  columns?: number;
1658
1685
  /** Category-aligned column/variance tiers use 4:1 plot heights unless authored tracks or a shared y scale apply. */
1659
1686
  sharedAxis?: 'category' | 'none';
1687
+ /**
1688
+ * Where category-aligned variance tiers stand: 'above' the column panel (default), the column's category labels
1689
+ * at the bottom of the exhibit, or 'below' it, the column's category labels between the columns and the tiers.
1690
+ */
1691
+ variancePosition?: 'above' | 'below';
1660
1692
  /**
1661
1693
  * Numeric panels with matching unit and format read against one value scale,
1662
1694
  * so panel heights compare in facets and category-aligned tiers.
@@ -141,6 +141,20 @@ export type ThemePaintSource = {
141
141
  } | {
142
142
  kind: 'colorblind';
143
143
  role: 'good' | 'bad' | 'goodFill' | 'badFill';
144
+ }
145
+ /**
146
+ * Step `index` of `count` series that share one colour role (roleSteps): `stroke` holds a thin line or small dot to the 3:1 mark floor.
147
+ * `fills` marks a role whose series mix filled marks and lines on one stroke ladder: the `fills` filled marks take the steps
148
+ * nearest the base, the lines the others, and `index` counts within the mark's own kind (`filled` for a filled mark).
149
+ */
150
+ | {
151
+ kind: 'role-step';
152
+ base: Paint;
153
+ index: number;
154
+ count: number;
155
+ stroke?: true;
156
+ fills?: number;
157
+ filled?: true;
144
158
  } | {
145
159
  kind: 'pie-ramp';
146
160
  base: Paint;
@@ -172,6 +186,16 @@ export type ThemePaintSource = {
172
186
  paint: Paint | Paint[];
173
187
  distance: number;
174
188
  };
189
+ /**
190
+ * On any page, a wash that has to read apart from the marks beside it
191
+ * (a likert option next to the other side or the neutral): when the
192
+ * wash sits closer than `distance` OKLab to one of them, the amount
193
+ * walks back toward the base until it does not.
194
+ */
195
+ apartFrom?: {
196
+ paint: Paint | Paint[];
197
+ distance: number;
198
+ };
175
199
  /**
176
200
  * On a dark page, the wash deepens toward the base until its APCA
177
201
  * contrast with the page reaches the contrast the same wash draws on a
@@ -722,8 +746,8 @@ export interface PlacedLabel extends TypographyMetadata {
722
746
  printedIn?: Id;
723
747
  /** The marks whose value this label prints: absent means its owner; [] a label that only names its mark. */
724
748
  printsFor?: OwnerRef[];
725
- /** Calculation whose displayed text comes from this final label. */
726
- claimId?: Id;
749
+ /** Calculations whose displayed text comes from this final label. */
750
+ claimIds?: readonly Id[];
727
751
  /** Computed text before an authored label override. */
728
752
  claimText?: string;
729
753
  /** Full text behind cut lines; emitted as the text node's `<title>`. */
@@ -858,6 +882,8 @@ export interface PlacedAnnotation {
858
882
  */
859
883
  labelNodeId?: Id;
860
884
  derivation?: AnnotationDerivation;
885
+ /** The mark whose own value the annotation prints (a callout's `${value}`, an `abs`): that value counts as labelled. */
886
+ valueOwner?: OwnerRef;
861
887
  /** A value line's value as its label's format prints it: the line's own format, the series' or the chart's, with its unit. */
862
888
  valueText?: string;
863
889
  /** A value line's drawn tolerance band: its bounds as the band prints them. */
@@ -1016,6 +1042,8 @@ export interface StoryStepGeometry {
1016
1042
  export interface StoryGeometry {
1017
1043
  /** Localized live region position template. Optional for older prepared geometry. */
1018
1044
  stepLabel?: string;
1045
+ /** Localized position template of the accessible description. Optional for older prepared geometry. */
1046
+ descLabel?: string;
1019
1047
  /** The step the scene shows (options.story.step, else 0). */
1020
1048
  step: number;
1021
1049
  /** Where the panel sits: in an empty area of the plot, or beside the chart. */
@@ -836,11 +836,15 @@ export interface ResolvedTable {
836
836
  rows: ResolvedRow[];
837
837
  /** Uniform money unit hoisted out of every cell ("in €M"). */
838
838
  unit?: string;
839
+ /** The column heads print their own, different units, so `options.unit` names none of them and the frame leaves it out. */
840
+ columnUnits?: true;
839
841
  /** Authored nouns for the children of each level; absent means no collapsed hint. */
840
842
  levelNouns?: LevelNoun[];
841
843
  footnotes: string[];
842
844
  /** Columns whose aggregates skipped a null child; the partial footnote shows only while one of them is drawn. */
843
845
  partialColumnIds?: Id[];
846
+ /** The partial-aggregate note as composed: it names the mark the table carries, the head's † or the cell word "(partial)". */
847
+ partialNote?: string;
844
848
  /** Judgments paint in theme.color.colorblind, so the notes name the good tone, not green. */
845
849
  colorblindSafe?: true;
846
850
  provenance: {
@@ -878,6 +882,8 @@ export interface ComputedCellRecord {
878
882
  * either (a) a `sum` receipt over no operands or (b) silence.
879
883
  */
880
884
  kind: 'calc' | 'aggregate' | 'reconciliation' | 'rounding-adjustment' | 'unaudited';
885
+ /** A reconciliation whose sum, in the cell's own format, is the text the author's total prints. */
886
+ printedInCell?: true;
881
887
  }
882
888
  export interface TableDerived {
883
889
  table: ResolvedTable;
@@ -511,6 +511,13 @@ export interface Theme {
511
511
  * apart on rows that do not print their band names.
512
512
  */
513
513
  bulletBandFill?: 'light' | 'full';
514
+ /**
515
+ * The look of every annotation arrow (a drawn arrow, a callout arrow, a
516
+ * bracket, a difference, a growth arrow, a link): head size, stroke and
517
+ * the air at both ends. 'compact' brings back the small heads and 1 px
518
+ * strokes of before; see themeFields.
519
+ */
520
+ arrow?: ThemeArrow;
514
521
  };
515
522
  /** Label conventions; absent keeps the shipped placement. */
516
523
  labels?: {
@@ -659,6 +666,22 @@ export interface Theme {
659
666
  */
660
667
  dash?: Partial<Record<DashRole, number[]>>;
661
668
  }
669
+ /** The annotation arrow look (`marks.arrow`). Absent keys keep the standard: an 8 x 7 px head, a `stroke.rule` shaft, 6 px tip gap, 4 px tail gap, 24 px shaft. */
670
+ export interface ThemeArrow {
671
+ style?: 'standard' | 'compact';
672
+ /** Head length in px, tip to base. */
673
+ head?: number;
674
+ /** Head width in px at its base. */
675
+ headWidth?: number;
676
+ /** Air in px between the tip and the edge of the mark it points at. */
677
+ tipGap?: number;
678
+ /** Air in px between the tail and its text. */
679
+ tailGap?: number;
680
+ /** The shortest shaft in px, tail to head base. */
681
+ minShaft?: number;
682
+ /** Shaft width in px. Absent means the thin `stroke.rule` line. */
683
+ stroke?: number;
684
+ }
662
685
  /** The stroke roles of the theme. */
663
686
  export type StrokeRole = 'seam' | 'hair' | 'rule' | 'mark' | 'data' | 'focus' | 'casing';
664
687
  /** The dash roles of the theme. */