boardplot 0.0.0-stage → 0.52.5

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 (817) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/LICENSE +201 -0
  3. package/NOTICE.md +180 -0
  4. package/README.md +208 -2
  5. package/THIRD_PARTY_NOTICES.md +1110 -0
  6. package/dist/DiagnosticDetails-UNYNYCAH.js +69 -0
  7. package/dist/ReaderBox-VUNSFKZY.js +137 -0
  8. package/dist/annotateEngine-H7OW4H3W.js +30 -0
  9. package/dist/build-identity.json +6 -0
  10. package/dist/chunk-24WB3HMB.js +621 -0
  11. package/dist/chunk-263SZKIL.js +8 -0
  12. package/dist/chunk-27QQEWNV.js +18 -0
  13. package/dist/chunk-2AKWCMS4.js +24 -0
  14. package/dist/chunk-2DHJJ2EN.js +24 -0
  15. package/dist/chunk-2EQE4E3I.js +22 -0
  16. package/dist/chunk-2GELJH37.js +88 -0
  17. package/dist/chunk-2JAWQ7VV.js +3874 -0
  18. package/dist/chunk-2LMCD3ZR.js +6 -0
  19. package/dist/chunk-2MTWKMEG.js +841 -0
  20. package/dist/chunk-2SGIHKKU.js +33 -0
  21. package/dist/chunk-2UVTHU7A.js +1146 -0
  22. package/dist/chunk-33CBPK5Q.js +2800 -0
  23. package/dist/chunk-33PLBIMA.js +176 -0
  24. package/dist/chunk-35DZP2R2.js +22 -0
  25. package/dist/chunk-3D3D3D23.js +25 -0
  26. package/dist/chunk-3EZRM4YM.js +92 -0
  27. package/dist/chunk-3GZECHOK.js +802 -0
  28. package/dist/chunk-3HHNQPAH.js +68 -0
  29. package/dist/chunk-3I6RANBJ.js +1058 -0
  30. package/dist/chunk-3SIRPKMP.js +12 -0
  31. package/dist/chunk-3W23F7EY.js +185 -0
  32. package/dist/chunk-3XQ635KD.js +24 -0
  33. package/dist/chunk-3ZCKEANJ.js +24 -0
  34. package/dist/chunk-4DNOEV3Q.js +25857 -0
  35. package/dist/chunk-4GB7TBY7.js +373 -0
  36. package/dist/chunk-4SM2ONUC.js +18 -0
  37. package/dist/chunk-5C7TWNYZ.js +79 -0
  38. package/dist/chunk-5DJXJXDE.js +58 -0
  39. package/dist/chunk-5ENRZX6I.js +687 -0
  40. package/dist/chunk-5KWXRYAT.js +294 -0
  41. package/dist/chunk-5T5YW52S.js +47 -0
  42. package/dist/chunk-627P6T25.js +936 -0
  43. package/dist/chunk-62FR4FYJ.js +23 -0
  44. package/dist/chunk-6JUJ2DU3.js +67 -0
  45. package/dist/chunk-6KWIQ5KF.js +18 -0
  46. package/dist/chunk-6UBEGKIQ.js +25 -0
  47. package/dist/chunk-6XE3GVGU.js +116 -0
  48. package/dist/chunk-76ANFJOI.js +227 -0
  49. package/dist/chunk-7IFLQMJL.js +160 -0
  50. package/dist/chunk-7JVAQX6C.js +28 -0
  51. package/dist/chunk-7QDAHY5M.js +63 -0
  52. package/dist/chunk-7VXZDB45.js +149 -0
  53. package/dist/chunk-7X65ZQN4.js +38 -0
  54. package/dist/chunk-A2FHZH7E.js +1410 -0
  55. package/dist/chunk-A372DLQX.js +54 -0
  56. package/dist/chunk-A3ULWR5N.js +76 -0
  57. package/dist/chunk-A4QZXLXF.js +7 -0
  58. package/dist/chunk-A5JWFZVU.js +1467 -0
  59. package/dist/chunk-A5LZUYK4.js +59 -0
  60. package/dist/chunk-A6XCAQ52.js +89 -0
  61. package/dist/chunk-A7A4PDG5.js +24 -0
  62. package/dist/chunk-A7IEVBYI.js +35 -0
  63. package/dist/chunk-ACXX2JNL.js +6 -0
  64. package/dist/chunk-AFK47A6O.js +25 -0
  65. package/dist/chunk-ALKTNXMR.js +3650 -0
  66. package/dist/chunk-AOQ6VF5H.js +6 -0
  67. package/dist/chunk-ASAON7G4.js +648 -0
  68. package/dist/chunk-ATTE3FYC.js +24 -0
  69. package/dist/chunk-AZOUSKZD.js +728 -0
  70. package/dist/chunk-B2EBEXIS.js +113 -0
  71. package/dist/chunk-B67K5X4M.js +58 -0
  72. package/dist/chunk-BBL3R5YZ.js +186 -0
  73. package/dist/chunk-BIDIGDGH.js +6 -0
  74. package/dist/chunk-BKYMLFUG.js +69 -0
  75. package/dist/chunk-BLFWUMTD.js +12 -0
  76. package/dist/chunk-BM6SFFWF.js +6 -0
  77. package/dist/chunk-BUPLB3EX.js +129 -0
  78. package/dist/chunk-BVWU6GOB.js +47 -0
  79. package/dist/chunk-BW5VLBSZ.js +15 -0
  80. package/dist/chunk-C64FBRJO.js +290 -0
  81. package/dist/chunk-CAE2HK2G.js +295 -0
  82. package/dist/chunk-CCQNL33L.js +446 -0
  83. package/dist/chunk-CDZHNLO6.js +42 -0
  84. package/dist/chunk-COKHNEJP.js +24 -0
  85. package/dist/chunk-COYPDRJK.js +21 -0
  86. package/dist/chunk-CRZKGHZ6.js +1810 -0
  87. package/dist/chunk-CS4DHFNG.js +128 -0
  88. package/dist/chunk-CYDZP5W6.js +1589 -0
  89. package/dist/chunk-D4BIV6WG.js +1072 -0
  90. package/dist/chunk-D4SOADBD.js +19 -0
  91. package/dist/chunk-DCCJRLAJ.js +422 -0
  92. package/dist/chunk-DFKTS6XJ.js +75 -0
  93. package/dist/chunk-DGDOGOTQ.js +25 -0
  94. package/dist/chunk-DLC23CKC.js +53 -0
  95. package/dist/chunk-DRTA6JG5.js +160 -0
  96. package/dist/chunk-DVKBU23L.js +97 -0
  97. package/dist/chunk-E2HEVF23.js +692 -0
  98. package/dist/chunk-EC2NAYPQ.js +24 -0
  99. package/dist/chunk-EKQK5D6G.js +14 -0
  100. package/dist/chunk-EKQMYG2B.js +2353 -0
  101. package/dist/chunk-ELYU6TRQ.js +98 -0
  102. package/dist/chunk-EQT3EPTB.js +203 -0
  103. package/dist/chunk-ERAIVAK5.js +1359 -0
  104. package/dist/chunk-ETHWK2RZ.js +16 -0
  105. package/dist/chunk-EWVKBRLV.js +72 -0
  106. package/dist/chunk-F77BNDAT.js +43 -0
  107. package/dist/chunk-FGAGGPFF.js +566 -0
  108. package/dist/chunk-FIANWJXX.js +19 -0
  109. package/dist/chunk-FIWNDOMO.js +6 -0
  110. package/dist/chunk-FOKEGVPB.js +24 -0
  111. package/dist/chunk-FT3F72C3.js +30 -0
  112. package/dist/chunk-FT47HQ5U.js +47 -0
  113. package/dist/chunk-GDOW2KNP.js +19 -0
  114. package/dist/chunk-GDQ3NGDZ.js +17 -0
  115. package/dist/chunk-GH3ZMBFX.js +563 -0
  116. package/dist/chunk-GQPESFAF.js +3378 -0
  117. package/dist/chunk-GQS46LC3.js +50 -0
  118. package/dist/chunk-GULJ6KVT.js +587 -0
  119. package/dist/chunk-GWQIXU37.js +2774 -0
  120. package/dist/chunk-GZ2VNM4L.js +24 -0
  121. package/dist/chunk-GZ4RHGIW.js +836 -0
  122. package/dist/chunk-H4H4O62O.js +46 -0
  123. package/dist/chunk-H57TJD3B.js +72 -0
  124. package/dist/chunk-H7UZZ7KP.js +24 -0
  125. package/dist/chunk-HAAUJDGB.js +83 -0
  126. package/dist/chunk-HFG76JTS.js +296 -0
  127. package/dist/chunk-HJXXFPOL.js +211 -0
  128. package/dist/chunk-HTYFQHRC.js +24 -0
  129. package/dist/chunk-HUF6TQ2J.js +24 -0
  130. package/dist/chunk-HUFCSX2Y.js +89 -0
  131. package/dist/chunk-HX3MQ3H4.js +26 -0
  132. package/dist/chunk-HZQEQ34U.js +296 -0
  133. package/dist/chunk-I322G5UG.js +888 -0
  134. package/dist/chunk-IDDA5INB.js +60 -0
  135. package/dist/chunk-IDTLHPTK.js +60 -0
  136. package/dist/chunk-II7652VA.js +2918 -0
  137. package/dist/chunk-IN4QT33I.js +38 -0
  138. package/dist/chunk-IV2UXZXX.js +16 -0
  139. package/dist/chunk-IXSZ7OKR.js +133 -0
  140. package/dist/chunk-IYEFEBRN.js +41 -0
  141. package/dist/chunk-IZ35GMGB.js +2543 -0
  142. package/dist/chunk-IZCOG3FS.js +28 -0
  143. package/dist/chunk-JA755JHN.js +379 -0
  144. package/dist/chunk-JETXFF3M.js +33 -0
  145. package/dist/chunk-JFBEAUJ6.js +24 -0
  146. package/dist/chunk-JFG4DHKQ.js +48 -0
  147. package/dist/chunk-JL5BRMDT.js +179 -0
  148. package/dist/chunk-JLCAWQ3H.js +195 -0
  149. package/dist/chunk-JLZM7XMZ.js +525 -0
  150. package/dist/chunk-JMH5MD5A.js +19 -0
  151. package/dist/chunk-JRPI64AQ.js +3066 -0
  152. package/dist/chunk-JSX3C6LL.js +344 -0
  153. package/dist/chunk-JY4R3GML.js +83 -0
  154. package/dist/chunk-JYBT2JNY.js +61 -0
  155. package/dist/chunk-K2HNV4LE.js +2008 -0
  156. package/dist/chunk-KAXJFL7N.js +43 -0
  157. package/dist/chunk-KDMKHR5A.js +32 -0
  158. package/dist/chunk-KFFNCDX6.js +19 -0
  159. package/dist/chunk-KKWZWP67.js +24 -0
  160. package/dist/chunk-KOJ5QETJ.js +8 -0
  161. package/dist/chunk-KPMGGE4W.js +51 -0
  162. package/dist/chunk-KS7DXCXH.js +27 -0
  163. package/dist/chunk-KSYVTEKR.js +24 -0
  164. package/dist/chunk-KU4YS6HN.js +61 -0
  165. package/dist/chunk-KYELSLDJ.js +40 -0
  166. package/dist/chunk-LC3PSQJJ.js +383 -0
  167. package/dist/chunk-LC6DYCTG.js +85 -0
  168. package/dist/chunk-LNKY5Z2X.js +23 -0
  169. package/dist/chunk-LO2DANS6.js +302 -0
  170. package/dist/chunk-M4SPKUZE.js +7 -0
  171. package/dist/chunk-M4YLED7M.js +17 -0
  172. package/dist/chunk-M6KTNAND.js +746 -0
  173. package/dist/chunk-MCOIEWW6.js +54 -0
  174. package/dist/chunk-MDYLOIS2.js +48 -0
  175. package/dist/chunk-MEISCROL.js +24 -0
  176. package/dist/chunk-MFLH5ZDQ.js +69 -0
  177. package/dist/chunk-MIXKQJ64.js +935 -0
  178. package/dist/chunk-MJMJEURO.js +359 -0
  179. package/dist/chunk-MNJ2DHU6.js +526 -0
  180. package/dist/chunk-NEVSQGOI.js +63 -0
  181. package/dist/chunk-NG5IGZXC.js +1179 -0
  182. package/dist/chunk-NLOMCLKI.js +3303 -0
  183. package/dist/chunk-NMCOUVN5.js +24 -0
  184. package/dist/chunk-NT3HAZYT.js +51 -0
  185. package/dist/chunk-NXNQQ3DS.js +382 -0
  186. package/dist/chunk-NYEY6W5R.js +569 -0
  187. package/dist/chunk-OAPCJO6W.js +23 -0
  188. package/dist/chunk-OH7FA4TF.js +251 -0
  189. package/dist/chunk-OLNORNCT.js +331 -0
  190. package/dist/chunk-OQEBOVUO.js +30 -0
  191. package/dist/chunk-ORUJI3VB.js +83 -0
  192. package/dist/chunk-PEN2DK7T.js +49 -0
  193. package/dist/chunk-PGIQMQRU.js +1650 -0
  194. package/dist/chunk-PTVOXB5T.js +39 -0
  195. package/dist/chunk-PUVGWJQ5.js +24 -0
  196. package/dist/chunk-PWROWDZS.js +137 -0
  197. package/dist/chunk-Q6XJOJTY.js +29 -0
  198. package/dist/chunk-QBR6IKIX.js +50 -0
  199. package/dist/chunk-QETGGFH2.js +30 -0
  200. package/dist/chunk-QG6MOQLI.js +2934 -0
  201. package/dist/chunk-QGCEHR6S.js +13 -0
  202. package/dist/chunk-QHFQHQDC.js +43 -0
  203. package/dist/chunk-QHRE2M6V.js +26 -0
  204. package/dist/chunk-QKL7IY42.js +38 -0
  205. package/dist/chunk-QN6JHMGU.js +44 -0
  206. package/dist/chunk-QNHZXFRA.js +347 -0
  207. package/dist/chunk-QPWRHDLZ.js +17 -0
  208. package/dist/chunk-QVABTUDS.js +80 -0
  209. package/dist/chunk-QXILAMAU.js +28 -0
  210. package/dist/chunk-QZAT46PP.js +95 -0
  211. package/dist/chunk-R3WI7ZLE.js +545 -0
  212. package/dist/chunk-R5SWC3EW.js +30 -0
  213. package/dist/chunk-RJQ5YS3Q.js +40 -0
  214. package/dist/chunk-RNOD2UWF.js +613 -0
  215. package/dist/chunk-RNXITK5M.js +24 -0
  216. package/dist/chunk-ROXO4R3J.js +16 -0
  217. package/dist/chunk-RQ5DNYLG.js +10 -0
  218. package/dist/chunk-RSWVH7DB.js +24 -0
  219. package/dist/chunk-RTJXOIIQ.js +12 -0
  220. package/dist/chunk-RZNYW7UP.js +133 -0
  221. package/dist/chunk-S4F27M7N.js +37 -0
  222. package/dist/chunk-S4ONWRJE.js +28 -0
  223. package/dist/chunk-S53OGZL6.js +168 -0
  224. package/dist/chunk-S5ADHIZK.js +2508 -0
  225. package/dist/chunk-S62M63LU.js +19 -0
  226. package/dist/chunk-S7VDRUED.js +62 -0
  227. package/dist/chunk-SGD3ZHID.js +250 -0
  228. package/dist/chunk-SGSPYHFE.js +40 -0
  229. package/dist/chunk-SLTMRTXV.js +597 -0
  230. package/dist/chunk-SXGTRZFN.js +26 -0
  231. package/dist/chunk-SZPTTNW7.js +16 -0
  232. package/dist/chunk-T3IGJARD.js +22 -0
  233. package/dist/chunk-TA3TFKYZ.js +86 -0
  234. package/dist/chunk-TNEHPP3H.js +18 -0
  235. package/dist/chunk-TPYV2FTV.js +25 -0
  236. package/dist/chunk-TPZB2YWR.js +25 -0
  237. package/dist/chunk-TSR5YDPS.js +1266 -0
  238. package/dist/chunk-TTR7EWNH.js +170 -0
  239. package/dist/chunk-TVHLKVUO.js +24 -0
  240. package/dist/chunk-TXINIAFL.js +198 -0
  241. package/dist/chunk-TXZBBZOG.js +58 -0
  242. package/dist/chunk-UEU46Q3D.js +300 -0
  243. package/dist/chunk-UMDEWWXT.js +33 -0
  244. package/dist/chunk-UQSVWO7Z.js +334 -0
  245. package/dist/chunk-UZF3G2FN.js +942 -0
  246. package/dist/chunk-V422EKLW.js +24 -0
  247. package/dist/chunk-V4DYVLOO.js +433 -0
  248. package/dist/chunk-V4VC25UL.js +128 -0
  249. package/dist/chunk-V667FCIJ.js +12 -0
  250. package/dist/chunk-VABRPZVC.js +43 -0
  251. package/dist/chunk-VB2MJLET.js +19 -0
  252. package/dist/chunk-VDAKTZQP.js +18 -0
  253. package/dist/chunk-VDAZPGR2.js +79 -0
  254. package/dist/chunk-VXZFQKBJ.js +21 -0
  255. package/dist/chunk-VYMGZ27S.js +133 -0
  256. package/dist/chunk-W2RGSGRR.js +131 -0
  257. package/dist/chunk-W7UZXD5D.js +1109 -0
  258. package/dist/chunk-WDUNR2VI.js +2718 -0
  259. package/dist/chunk-WHSTEAVP.js +229 -0
  260. package/dist/chunk-WJMUMN3I.js +127 -0
  261. package/dist/chunk-WLZ54FWG.js +120 -0
  262. package/dist/chunk-WMJPFLF3.js +2980 -0
  263. package/dist/chunk-WRHFBCVY.js +24 -0
  264. package/dist/chunk-WVSNSWBJ.js +47 -0
  265. package/dist/chunk-WYJEOMNY.js +31 -0
  266. package/dist/chunk-WYJMV62X.js +24 -0
  267. package/dist/chunk-WZGJSQKN.js +29 -0
  268. package/dist/chunk-WZL4EEBS.js +11 -0
  269. package/dist/chunk-X7TXGKRX.js +272 -0
  270. package/dist/chunk-XB4KZ6WO.js +81 -0
  271. package/dist/chunk-XDLQRSSH.js +266 -0
  272. package/dist/chunk-XDS4UZGR.js +113 -0
  273. package/dist/chunk-XEGRWWNO.js +30 -0
  274. package/dist/chunk-XO5ONLVM.js +420 -0
  275. package/dist/chunk-XPWRD424.js +24 -0
  276. package/dist/chunk-XTNV2YMB.js +50 -0
  277. package/dist/chunk-XW5J5JAX.js +42 -0
  278. package/dist/chunk-XY5O74BH.js +33 -0
  279. package/dist/chunk-XYONCO5Q.js +984 -0
  280. package/dist/chunk-Y4PXIJMD.js +829 -0
  281. package/dist/chunk-YAYRRKC7.js +24 -0
  282. package/dist/chunk-YEDYBMCW.js +210 -0
  283. package/dist/chunk-YFG4E3N2.js +1161 -0
  284. package/dist/chunk-YHTO46W2.js +2670 -0
  285. package/dist/chunk-YI2ZVTCB.js +38 -0
  286. package/dist/chunk-YKO3VCTF.js +24 -0
  287. package/dist/chunk-YP3I6W7T.js +24 -0
  288. package/dist/chunk-YQ2B3YVF.js +687 -0
  289. package/dist/chunk-YS6KMYM4.js +91 -0
  290. package/dist/chunk-YTSSXSZR.js +197 -0
  291. package/dist/chunk-Z256ACGC.js +27 -0
  292. package/dist/chunk-Z2MGTKDR.js +20 -0
  293. package/dist/chunk-Z5VSLLNY.js +23 -0
  294. package/dist/chunk-Z7X3RGGA.js +22 -0
  295. package/dist/chunk-ZF43WRG3.js +29 -0
  296. package/dist/chunk-ZJKOLOVF.js +1754 -0
  297. package/dist/chunk-ZQ4VFQID.js +76 -0
  298. package/dist/chunk-ZSLGN6CO.js +89 -0
  299. package/dist/chunk-ZVTFZF4V.js +542 -0
  300. package/dist/cli/index.js +9 -0
  301. package/dist/core-5Z6UW5DS.js +31 -0
  302. package/dist/core-6ANZ2OWO.js +40 -0
  303. package/dist/core-6LLJNZ4O.js +37 -0
  304. package/dist/core-CPN2HF75.js +33 -0
  305. package/dist/core-CS7AKNME.js +37 -0
  306. package/dist/core-DBRILYNB.js +38 -0
  307. package/dist/core-DU77ZYPR.js +34 -0
  308. package/dist/core-E6YD7VU4.js +32 -0
  309. package/dist/core-EE55P6XK.js +56 -0
  310. package/dist/core-FFLPH5XK.js +41 -0
  311. package/dist/core-IV26EL5C.js +32 -0
  312. package/dist/core-IZVZ2B7Y.js +34 -0
  313. package/dist/core-JQV7STNF.js +34 -0
  314. package/dist/core-KBH3EJZV.js +32 -0
  315. package/dist/core-KFBW5PRT.js +36 -0
  316. package/dist/core-KWGXHBJE.js +37 -0
  317. package/dist/core-MZMR2DF4.js +32 -0
  318. package/dist/core-OK2ZY5OJ.js +29 -0
  319. package/dist/core-OV5MPTZP.js +43 -0
  320. package/dist/core-OW5V74Q4.js +40 -0
  321. package/dist/core-PL64QPOH.js +57 -0
  322. package/dist/core-PVINU5JJ.js +33 -0
  323. package/dist/core-QUYSNTC7.js +34 -0
  324. package/dist/core-RE3L6YCM.js +29 -0
  325. package/dist/core-RUA3EWW3.js +39 -0
  326. package/dist/core-RY6IFRKM.js +35 -0
  327. package/dist/core-SCWEVNUY.js +34 -0
  328. package/dist/core-SE67HHFG.js +55 -0
  329. package/dist/core-T5Q4DSH2.js +32 -0
  330. package/dist/core-TJX3I7KH.js +37 -0
  331. package/dist/core-ULUA5ZB2.js +55 -0
  332. package/dist/core-WLVU2HWX.js +46 -0
  333. package/dist/core-WQPHNVNY.js +51 -0
  334. package/dist/core-XXIOJY2X.js +52 -0
  335. package/dist/core-ZH7XTJTD.js +39 -0
  336. package/dist/core-ZHE7N4NS.js +50 -0
  337. package/dist/core-ZJYLJWZQ.js +38 -0
  338. package/dist/dataTable-IL7HVDHL.js +58 -0
  339. package/dist/engine-MYLZI5VH.js +961 -0
  340. package/dist/fixtures.d.ts +1 -0
  341. package/dist/fixtures.js +40 -0
  342. package/dist/fontTables-ZYBUCJ5N.js +18 -0
  343. package/dist/fonts.d.ts +1 -0
  344. package/dist/fonts.js +19 -0
  345. package/dist/geo/dach.d.ts +1 -0
  346. package/dist/geo/dach.js +14 -0
  347. package/dist/geo/de-states.d.ts +1 -0
  348. package/dist/geo/de-states.js +14 -0
  349. package/dist/geo/eu27.d.ts +1 -0
  350. package/dist/geo/eu27.js +14 -0
  351. package/dist/geo/europe.d.ts +1 -0
  352. package/dist/geo/europe.js +14 -0
  353. package/dist/geo/index.d.ts +1 -0
  354. package/dist/geo/index.js +41 -0
  355. package/dist/geo/us-states.d.ts +1 -0
  356. package/dist/geo/us-states.js +14 -0
  357. package/dist/geo/world.d.ts +1 -0
  358. package/dist/geo/world.js +14 -0
  359. package/dist/index.d.ts +1 -0
  360. package/dist/index.js +363 -0
  361. package/dist/main-ISJ53IS5.js +568 -0
  362. package/dist/mcp/server.js +1023 -0
  363. package/dist/module-SVEW5ZUE.js +137233 -0
  364. package/dist/react/bar.d.ts +1 -0
  365. package/dist/react/bar.js +80 -0
  366. package/dist/react/bartable.d.ts +1 -0
  367. package/dist/react/bartable.js +70 -0
  368. package/dist/react/box.d.ts +1 -0
  369. package/dist/react/box.js +64 -0
  370. package/dist/react/bullet.d.ts +1 -0
  371. package/dist/react/bullet.js +71 -0
  372. package/dist/react/butterfly.d.ts +1 -0
  373. package/dist/react/butterfly.js +65 -0
  374. package/dist/react/choropleth.d.ts +1 -0
  375. package/dist/react/choropleth.js +67 -0
  376. package/dist/react/cohort.d.ts +1 -0
  377. package/dist/react/cohort.js +69 -0
  378. package/dist/react/column.d.ts +1 -0
  379. package/dist/react/column.js +85 -0
  380. package/dist/react/combo.d.ts +1 -0
  381. package/dist/react/combo.js +85 -0
  382. package/dist/react/creative.d.ts +1 -0
  383. package/dist/react/creative.js +61 -0
  384. package/dist/react/diagram.d.ts +1 -0
  385. package/dist/react/diagram.js +60 -0
  386. package/dist/react/dimswitch.d.ts +1 -0
  387. package/dist/react/dimswitch.js +71 -0
  388. package/dist/react/dot.d.ts +1 -0
  389. package/dist/react/dot.js +69 -0
  390. package/dist/react/export.d.ts +1 -0
  391. package/dist/react/export.js +657 -0
  392. package/dist/react/funnel.d.ts +1 -0
  393. package/dist/react/funnel.js +62 -0
  394. package/dist/react/gantt.d.ts +1 -0
  395. package/dist/react/gantt.js +62 -0
  396. package/dist/react/grid.d.ts +1 -0
  397. package/dist/react/grid.js +66 -0
  398. package/dist/react/heatmap.d.ts +1 -0
  399. package/dist/react/heatmap.js +67 -0
  400. package/dist/react/histogram.d.ts +1 -0
  401. package/dist/react/histogram.js +85 -0
  402. package/dist/react/index.d.ts +1 -0
  403. package/dist/react/index.js +503 -0
  404. package/dist/react/kpi.d.ts +1 -0
  405. package/dist/react/kpi.js +67 -0
  406. package/dist/react/likert.d.ts +1 -0
  407. package/dist/react/likert.js +82 -0
  408. package/dist/react/line.d.ts +1 -0
  409. package/dist/react/line.js +80 -0
  410. package/dist/react/mekko.d.ts +1 -0
  411. package/dist/react/mekko.js +70 -0
  412. package/dist/react/pareto.d.ts +1 -0
  413. package/dist/react/pareto.js +89 -0
  414. package/dist/react/pie.d.ts +1 -0
  415. package/dist/react/pie.js +63 -0
  416. package/dist/react/prepare.d.ts +1 -0
  417. package/dist/react/prepare.js +277 -0
  418. package/dist/react/pvm.d.ts +1 -0
  419. package/dist/react/pvm.js +67 -0
  420. package/dist/react/pyramid.d.ts +1 -0
  421. package/dist/react/pyramid.js +66 -0
  422. package/dist/react/sankey.d.ts +1 -0
  423. package/dist/react/sankey.js +59 -0
  424. package/dist/react/scatter.d.ts +1 -0
  425. package/dist/react/scatter.js +62 -0
  426. package/dist/react/slope.d.ts +1 -0
  427. package/dist/react/slope.js +63 -0
  428. package/dist/react/sparkline.d.ts +1 -0
  429. package/dist/react/sparkline.js +59 -0
  430. package/dist/react/spec.d.ts +1 -0
  431. package/dist/react/spec.js +370 -0
  432. package/dist/react/status.d.ts +1 -0
  433. package/dist/react/status.js +64 -0
  434. package/dist/react/story.d.ts +1 -0
  435. package/dist/react/story.js +140 -0
  436. package/dist/react/table.d.ts +1 -0
  437. package/dist/react/table.js +68 -0
  438. package/dist/react/theme.d.ts +1 -0
  439. package/dist/react/theme.js +53 -0
  440. package/dist/react/tilemap.d.ts +1 -0
  441. package/dist/react/tilemap.js +66 -0
  442. package/dist/react/treemap.d.ts +1 -0
  443. package/dist/react/treemap.js +61 -0
  444. package/dist/react/variance.d.ts +1 -0
  445. package/dist/react/variance.js +64 -0
  446. package/dist/react/waffle.d.ts +1 -0
  447. package/dist/react/waffle.js +62 -0
  448. package/dist/react/waterfall.d.ts +1 -0
  449. package/dist/react/waterfall.js +67 -0
  450. package/dist/resvg-ZOVDIZTV.js +23 -0
  451. package/dist/rows.d.ts +1 -0
  452. package/dist/rows.js +23 -0
  453. package/dist/rowsModule-3Y4I3M3E.js +27 -0
  454. package/dist/schema-2BMZOHXI.js +22 -0
  455. package/dist/schema-2GUBWOBC.js +26 -0
  456. package/dist/schema-34ZELWRQ.js +25 -0
  457. package/dist/schema-3BHL2B76.js +22 -0
  458. package/dist/schema-4735XAZX.js +29 -0
  459. package/dist/schema-5YTNQ6JY.js +22 -0
  460. package/dist/schema-7J3NAIN2.js +27 -0
  461. package/dist/schema-AOJJ7JZB.js +22 -0
  462. package/dist/schema-CVMV4LRA.js +22 -0
  463. package/dist/schema-D3RCMN3T.js +22 -0
  464. package/dist/schema-E2ISJ65D.js +23 -0
  465. package/dist/schema-E6YOSOWB.js +28 -0
  466. package/dist/schema-EQQB43AY.js +22 -0
  467. package/dist/schema-EVLLL5UF.js +22 -0
  468. package/dist/schema-EYQ5IBLF.js +23 -0
  469. package/dist/schema-EYZVD73N.js +22 -0
  470. package/dist/schema-G4KFMQBL.js +22 -0
  471. package/dist/schema-GH7IKSOU.js +23 -0
  472. package/dist/schema-IF5N3J56.js +42 -0
  473. package/dist/schema-IG7JIR4H.js +23 -0
  474. package/dist/schema-JJYJOQTT.js +23 -0
  475. package/dist/schema-KFC4WYH4.js +32 -0
  476. package/dist/schema-L7263JMT.js +25 -0
  477. package/dist/schema-MEAFRXVH.js +53 -0
  478. package/dist/schema-P63S63GE.js +23 -0
  479. package/dist/schema-P7LJFJAJ.js +22 -0
  480. package/dist/schema-PA2MXYY4.js +23 -0
  481. package/dist/schema-PDZ6256H.js +23 -0
  482. package/dist/schema-PNC3Z7AH.js +25 -0
  483. package/dist/schema-QEVSIMGO.js +22 -0
  484. package/dist/schema-QJJPRRE7.js +22 -0
  485. package/dist/schema-S3EQKVOT.js +23 -0
  486. package/dist/schema-STGL44TL.js +22 -0
  487. package/dist/schema-T4NE2EAO.js +22 -0
  488. package/dist/schema-TQYTESG3.js +22 -0
  489. package/dist/schema-W376PAJG.js +22 -0
  490. package/dist/schema-XYYDUUHS.js +26 -0
  491. package/dist/specValidation-NVBIZMEE.js +48 -0
  492. package/dist/theme.d.ts +1 -0
  493. package/dist/theme.js +24 -0
  494. package/dist/themeShapeRules-5C2463YH.js +11 -0
  495. package/dist/types/core/a11y/accessibility.d.ts +43 -0
  496. package/dist/types/core/a11y/recordsShared.d.ts +44 -0
  497. package/dist/types/core/a11y/structuralRecords.d.ts +6 -0
  498. package/dist/types/core/a11y/types.d.ts +116 -0
  499. package/dist/types/core/annotate.d.ts +300 -0
  500. package/dist/types/core/annotateArms.d.ts +37 -0
  501. package/dist/types/core/annotateFields.d.ts +30 -0
  502. package/dist/types/core/annotateGapBracket.d.ts +66 -0
  503. package/dist/types/core/annotateLinks.d.ts +47 -0
  504. package/dist/types/core/annotateTargets.d.ts +90 -0
  505. package/dist/types/core/axis.d.ts +179 -0
  506. package/dist/types/core/bandSelect.d.ts +10 -0
  507. package/dist/types/core/bands.d.ts +14 -0
  508. package/dist/types/core/calendarLabels.d.ts +101 -0
  509. package/dist/types/core/charts/band/stacks.d.ts +155 -0
  510. package/dist/types/core/charts/bar/fixtures.d.ts +9 -0
  511. package/dist/types/core/charts/bar/layout.d.ts +95 -0
  512. package/dist/types/core/charts/bartable/fixtures.d.ts +4 -0
  513. package/dist/types/core/charts/bartable/types.d.ts +192 -0
  514. package/dist/types/core/charts/box/fixtures.d.ts +12 -0
  515. package/dist/types/core/charts/box/types.d.ts +110 -0
  516. package/dist/types/core/charts/bullet/fixtures.d.ts +11 -0
  517. package/dist/types/core/charts/butterfly/fixtures.d.ts +9 -0
  518. package/dist/types/core/charts/choropleth/fixtures.d.ts +3 -0
  519. package/dist/types/core/charts/choropleth/overlayTypes.d.ts +68 -0
  520. package/dist/types/core/charts/choropleth/types.d.ts +117 -0
  521. package/dist/types/core/charts/cohort/fixtures.d.ts +12 -0
  522. package/dist/types/core/charts/cohort/types.d.ts +165 -0
  523. package/dist/types/core/charts/column/anomaly.d.ts +204 -0
  524. package/dist/types/core/charts/column/fixtures.d.ts +12 -0
  525. package/dist/types/core/charts/column/layout.d.ts +116 -0
  526. package/dist/types/core/charts/column/model.d.ts +295 -0
  527. package/dist/types/core/charts/column/types.d.ts +56 -0
  528. package/dist/types/core/charts/combo/endpoints.d.ts +165 -0
  529. package/dist/types/core/charts/combo/fixtures.d.ts +12 -0
  530. package/dist/types/core/charts/combo/layout.d.ts +48 -0
  531. package/dist/types/core/charts/creative/fixtures.d.ts +4 -0
  532. package/dist/types/core/charts/creative/types.d.ts +73 -0
  533. package/dist/types/core/charts/diagram/fixtures.d.ts +3 -0
  534. package/dist/types/core/charts/dimswitch/compile.d.ts +20 -0
  535. package/dist/types/core/charts/dimswitch/fixtures.d.ts +3 -0
  536. package/dist/types/core/charts/dimswitch/types.d.ts +152 -0
  537. package/dist/types/core/charts/dot/fixtures.d.ts +11 -0
  538. package/dist/types/core/charts/funnel/fixtures.d.ts +11 -0
  539. package/dist/types/core/charts/gantt/fixtures.d.ts +9 -0
  540. package/dist/types/core/charts/gantt/layout.d.ts +56 -0
  541. package/dist/types/core/charts/grid/fixtures.d.ts +3 -0
  542. package/dist/types/core/charts/grid/metricStack.d.ts +108 -0
  543. package/dist/types/core/charts/grid/metricStackSchema.d.ts +74 -0
  544. package/dist/types/core/charts/grid/normalize.d.ts +99 -0
  545. package/dist/types/core/charts/grid/schema.d.ts +168 -0
  546. package/dist/types/core/charts/heatmap/fixtures.d.ts +11 -0
  547. package/dist/types/core/charts/histogram/fixtures.d.ts +15 -0
  548. package/dist/types/core/charts/histogram/types.d.ts +98 -0
  549. package/dist/types/core/charts/kpi/fixtures.d.ts +9 -0
  550. package/dist/types/core/charts/likert/fixtures.d.ts +11 -0
  551. package/dist/types/core/charts/likert/layout.d.ts +111 -0
  552. package/dist/types/core/charts/line/fixtures.d.ts +16 -0
  553. package/dist/types/core/charts/line/types.d.ts +6 -0
  554. package/dist/types/core/charts/mekko/fixtures.d.ts +13 -0
  555. package/dist/types/core/charts/pareto/fixtures.d.ts +5 -0
  556. package/dist/types/core/charts/pareto/layout.d.ts +68 -0
  557. package/dist/types/core/charts/pie/fixtures.d.ts +14 -0
  558. package/dist/types/core/charts/pvm/fixtures.d.ts +13 -0
  559. package/dist/types/core/charts/pvm/types.d.ts +118 -0
  560. package/dist/types/core/charts/pyramid/fixtures.d.ts +4 -0
  561. package/dist/types/core/charts/pyramid/types.d.ts +92 -0
  562. package/dist/types/core/charts/sankey/fixtures.d.ts +4 -0
  563. package/dist/types/core/charts/sankey/types.d.ts +116 -0
  564. package/dist/types/core/charts/scatter/fixtures.d.ts +12 -0
  565. package/dist/types/core/charts/scatter/types.d.ts +58 -0
  566. package/dist/types/core/charts/slope/fixtures.d.ts +13 -0
  567. package/dist/types/core/charts/sparkline/fixtures.d.ts +9 -0
  568. package/dist/types/core/charts/status/fixtures.d.ts +8 -0
  569. package/dist/types/core/charts/status/layout.d.ts +71 -0
  570. package/dist/types/core/charts/table/fitFormats.d.ts +67 -0
  571. package/dist/types/core/charts/table/fixtures.d.ts +7 -0
  572. package/dist/types/core/charts/table/resolve.d.ts +72 -0
  573. package/dist/types/core/charts/table/view.d.ts +156 -0
  574. package/dist/types/core/charts/tilemap/fixtures.d.ts +3 -0
  575. package/dist/types/core/charts/tilemap/types.d.ts +94 -0
  576. package/dist/types/core/charts/treemap/fixtures.d.ts +4 -0
  577. package/dist/types/core/charts/treemap/types.d.ts +78 -0
  578. package/dist/types/core/charts/variance/fixtures.d.ts +12 -0
  579. package/dist/types/core/charts/waffle/fixtures.d.ts +5 -0
  580. package/dist/types/core/charts/waffle/types.d.ts +117 -0
  581. package/dist/types/core/charts/waterfall/fixtures.d.ts +9 -0
  582. package/dist/types/core/claims/browser.d.ts +49 -0
  583. package/dist/types/core/claims/manifest.d.ts +22 -0
  584. package/dist/types/core/dateFormat.d.ts +39 -0
  585. package/dist/types/core/deferred.d.ts +121 -0
  586. package/dist/types/core/diagnostics/describe.d.ts +149 -0
  587. package/dist/types/core/diagnostics/jsonPatch.d.ts +36 -0
  588. package/dist/types/core/doc/bareChart.d.ts +2 -0
  589. package/dist/types/core/doc/diagnostics.d.ts +124 -0
  590. package/dist/types/core/doc/docExpand.d.ts +39 -0
  591. package/dist/types/core/doc/document.d.ts +43 -0
  592. package/dist/types/core/doc/ownedDocumentCopy.d.ts +5 -0
  593. package/dist/types/core/doc/specError.d.ts +6 -0
  594. package/dist/types/core/emptyData.d.ts +27 -0
  595. package/dist/types/core/eventLane.d.ts +208 -0
  596. package/dist/types/core/fontMetrics/index.d.ts +47 -0
  597. package/dist/types/core/fontMetrics/injected.d.ts +40 -0
  598. package/dist/types/core/fontMetrics/tableDocument.d.ts +73 -0
  599. package/dist/types/core/fontMetrics/tables.generated.d.ts +17 -0
  600. package/dist/types/core/footer.d.ts +59 -0
  601. package/dist/types/core/format.d.ts +149 -0
  602. package/dist/types/core/formatPrecision.d.ts +136 -0
  603. package/dist/types/core/formatSpec.d.ts +302 -0
  604. package/dist/types/core/frame.d.ts +583 -0
  605. package/dist/types/core/geo/packs/all.d.ts +7 -0
  606. package/dist/types/core/geo/packs/dach.d.ts +16 -0
  607. package/dist/types/core/geo/packs/de-states.d.ts +16 -0
  608. package/dist/types/core/geo/packs/eu27.d.ts +16 -0
  609. package/dist/types/core/geo/packs/europe.d.ts +16 -0
  610. package/dist/types/core/geo/packs/index.d.ts +22 -0
  611. package/dist/types/core/geo/packs/registry.d.ts +37 -0
  612. package/dist/types/core/geo/packs/us-states.d.ts +16 -0
  613. package/dist/types/core/geo/packs/world.d.ts +16 -0
  614. package/dist/types/core/geo/tiles/eu27.generated.d.ts +412 -0
  615. package/dist/types/core/geo/tiles/europe.generated.d.ts +842 -0
  616. package/dist/types/core/geo/tiles/index.d.ts +8 -0
  617. package/dist/types/core/geo/tiles/types.d.ts +36 -0
  618. package/dist/types/core/geo/tiles/us-states.generated.d.ts +952 -0
  619. package/dist/types/core/geo/tiles/world.generated.d.ts +968 -0
  620. package/dist/types/core/geo/types.d.ts +146 -0
  621. package/dist/types/core/geometry.d.ts +102 -0
  622. package/dist/types/core/grid/sharedScale.d.ts +82 -0
  623. package/dist/types/core/icons.d.ts +227 -0
  624. package/dist/types/core/inputError.d.ts +14 -0
  625. package/dist/types/core/isoDate.d.ts +2 -0
  626. package/dist/types/core/isoTime.d.ts +7 -0
  627. package/dist/types/core/label/categoryRow.d.ts +332 -0
  628. package/dist/types/core/label/occupied.d.ts +41 -0
  629. package/dist/types/core/label/ownership.d.ts +83 -0
  630. package/dist/types/core/label/solver.d.ts +380 -0
  631. package/dist/types/core/label/tickRow.d.ts +78 -0
  632. package/dist/types/core/live/types.d.ts +50 -0
  633. package/dist/types/core/normalize/shared.d.ts +56 -0
  634. package/dist/types/core/notes.d.ts +174 -0
  635. package/dist/types/core/othersShade.d.ts +9 -0
  636. package/dist/types/core/periodYears.d.ts +9 -0
  637. package/dist/types/core/polyline.d.ts +11 -0
  638. package/dist/types/core/rangeRules.d.ts +19 -0
  639. package/dist/types/core/ratioTier.d.ts +120 -0
  640. package/dist/types/core/readerStrings.d.ts +13 -0
  641. package/dist/types/core/reading.d.ts +120 -0
  642. package/dist/types/core/registry.d.ts +178 -0
  643. package/dist/types/core/repaintGeometry.d.ts +19 -0
  644. package/dist/types/core/request.d.ts +124 -0
  645. package/dist/types/core/rows.d.ts +45 -0
  646. package/dist/types/core/scale.d.ts +106 -0
  647. package/dist/types/core/schema/capability.d.ts +229 -0
  648. package/dist/types/core/schema/namedColumns.d.ts +45 -0
  649. package/dist/types/core/schema/reference.d.ts +31 -0
  650. package/dist/types/core/schema/refusals.d.ts +45 -0
  651. package/dist/types/core/schema/unknownKeys.d.ts +45 -0
  652. package/dist/types/core/seriesIdentity.d.ts +120 -0
  653. package/dist/types/core/shareRounding.d.ts +49 -0
  654. package/dist/types/core/sizing.d.ts +330 -0
  655. package/dist/types/core/staticFooter.d.ts +6 -0
  656. package/dist/types/core/story.d.ts +41 -0
  657. package/dist/types/core/structureCounts.d.ts +10 -0
  658. package/dist/types/core/svg/renderSvg.d.ts +51 -0
  659. package/dist/types/core/target.d.ts +89 -0
  660. package/dist/types/core/text.d.ts +113 -0
  661. package/dist/types/core/theme.d.ts +478 -0
  662. package/dist/types/core/themeFields.d.ts +11 -0
  663. package/dist/types/core/themeRules.d.ts +111 -0
  664. package/dist/types/core/themeShape.d.ts +87 -0
  665. package/dist/types/core/themeValidate.d.ts +15 -0
  666. package/dist/types/core/timeAxis.d.ts +106 -0
  667. package/dist/types/core/types/annotations.d.ts +223 -0
  668. package/dist/types/core/types/cell.d.ts +82 -0
  669. package/dist/types/core/types/data.d.ts +309 -0
  670. package/dist/types/core/types/diagram.d.ts +234 -0
  671. package/dist/types/core/types/index.d.ts +8 -0
  672. package/dist/types/core/types/options.d.ts +1583 -0
  673. package/dist/types/core/types/scene.d.ts +990 -0
  674. package/dist/types/core/types/sizing.d.ts +51 -0
  675. package/dist/types/core/types/table.d.ts +873 -0
  676. package/dist/types/core/types/theme.d.ts +806 -0
  677. package/dist/types/core/zoom.d.ts +106 -0
  678. package/dist/types/fixtures/index.d.ts +40 -0
  679. package/dist/types/fixtures/registry.d.ts +15 -0
  680. package/dist/types/fonts.d.ts +10 -0
  681. package/dist/types/index.d.ts +70 -0
  682. package/dist/types/react/BoardplotTheme.d.ts +9 -0
  683. package/dist/types/react/DimSwitchChart.d.ts +36 -0
  684. package/dist/types/react/ScaleGroup.d.ts +31 -0
  685. package/dist/types/react/SceneRenderer.d.ts +23 -0
  686. package/dist/types/react/SizePlaceholder.d.ts +51 -0
  687. package/dist/types/react/StoryFrame.d.ts +42 -0
  688. package/dist/types/react/TableChart.d.ts +220 -0
  689. package/dist/types/react/a11ySurface.d.ts +20 -0
  690. package/dist/types/react/barrelCharts.d.ts +1023 -0
  691. package/dist/types/react/charts/bar.d.ts +28 -0
  692. package/dist/types/react/charts/bartable.d.ts +27 -0
  693. package/dist/types/react/charts/box.d.ts +27 -0
  694. package/dist/types/react/charts/bullet.d.ts +28 -0
  695. package/dist/types/react/charts/butterfly.d.ts +28 -0
  696. package/dist/types/react/charts/choropleth.d.ts +27 -0
  697. package/dist/types/react/charts/cohort.d.ts +52 -0
  698. package/dist/types/react/charts/column.d.ts +27 -0
  699. package/dist/types/react/charts/combo.d.ts +7 -0
  700. package/dist/types/react/charts/creative.d.ts +27 -0
  701. package/dist/types/react/charts/diagram.d.ts +162 -0
  702. package/dist/types/react/charts/dimswitch.d.ts +6 -0
  703. package/dist/types/react/charts/dot.d.ts +28 -0
  704. package/dist/types/react/charts/funnel.d.ts +28 -0
  705. package/dist/types/react/charts/gantt.d.ts +28 -0
  706. package/dist/types/react/charts/grid.d.ts +29 -0
  707. package/dist/types/react/charts/heatmap.d.ts +28 -0
  708. package/dist/types/react/charts/histogram.d.ts +27 -0
  709. package/dist/types/react/charts/kpi.d.ts +28 -0
  710. package/dist/types/react/charts/likert.d.ts +27 -0
  711. package/dist/types/react/charts/line.d.ts +28 -0
  712. package/dist/types/react/charts/mekko.d.ts +28 -0
  713. package/dist/types/react/charts/pareto.d.ts +28 -0
  714. package/dist/types/react/charts/pie.d.ts +28 -0
  715. package/dist/types/react/charts/pvm.d.ts +27 -0
  716. package/dist/types/react/charts/pyramid.d.ts +27 -0
  717. package/dist/types/react/charts/sankey.d.ts +27 -0
  718. package/dist/types/react/charts/scatter.d.ts +28 -0
  719. package/dist/types/react/charts/slope.d.ts +28 -0
  720. package/dist/types/react/charts/sparkline.d.ts +28 -0
  721. package/dist/types/react/charts/status.d.ts +27 -0
  722. package/dist/types/react/charts/table.d.ts +6 -0
  723. package/dist/types/react/charts/tilemap.d.ts +27 -0
  724. package/dist/types/react/charts/treemap.d.ts +27 -0
  725. package/dist/types/react/charts/variance.d.ts +28 -0
  726. package/dist/types/react/charts/waffle.d.ts +28 -0
  727. package/dist/types/react/charts/waterfall.d.ts +28 -0
  728. package/dist/types/react/createChartComponent.d.ts +135 -0
  729. package/dist/types/react/export/clipboard.d.ts +8 -0
  730. package/dist/types/react/export/csv.d.ts +2 -0
  731. package/dist/types/react/export/frame.d.ts +35 -0
  732. package/dist/types/react/export/index.d.ts +7 -0
  733. package/dist/types/react/export/png.d.ts +14 -0
  734. package/dist/types/react/export/svg.d.ts +5 -0
  735. package/dist/types/react/export/types.d.ts +69 -0
  736. package/dist/types/react/export/useExport.d.ts +17 -0
  737. package/dist/types/react/exportLink.d.ts +49 -0
  738. package/dist/types/react/footerFrame.d.ts +25 -0
  739. package/dist/types/react/hover/dataTable.d.ts +13 -0
  740. package/dist/types/react/hover/engine.d.ts +210 -0
  741. package/dist/types/react/hover/keyboard.d.ts +44 -0
  742. package/dist/types/react/hover/labelCard.d.ts +170 -0
  743. package/dist/types/react/hover/placement.d.ts +49 -0
  744. package/dist/types/react/index.d.ts +16 -0
  745. package/dist/types/react/parseChartSpec.d.ts +16 -0
  746. package/dist/types/react/prepare.d.ts +32 -0
  747. package/dist/types/react/prepared.d.ts +53 -0
  748. package/dist/types/react/preparedTable.d.ts +15 -0
  749. package/dist/types/react/rowsInput.d.ts +55 -0
  750. package/dist/types/react/rowsModule.d.ts +18 -0
  751. package/dist/types/react/rowsStore.d.ts +50 -0
  752. package/dist/types/react/scale-group.d.ts +2 -0
  753. package/dist/types/react/scaleGroupContext.d.ts +22 -0
  754. package/dist/types/react/scenePaint.d.ts +10 -0
  755. package/dist/types/react/scrollState.d.ts +26 -0
  756. package/dist/types/react/spec.d.ts +65 -0
  757. package/dist/types/react/specValidation.d.ts +45 -0
  758. package/dist/types/react/story.d.ts +15 -0
  759. package/dist/types/react/theme.d.ts +9 -0
  760. package/dist/types/react/themeContext.d.ts +44 -0
  761. package/dist/types/react/useChartLayout.d.ts +22 -0
  762. package/dist/types/react/useContainerSize.d.ts +57 -0
  763. package/dist/types/react/useHover.d.ts +100 -0
  764. package/dist/types/react/useZoom.d.ts +50 -0
  765. package/dist/types/rows.d.ts +58 -0
  766. package/dist/types/tableLooks.d.ts +6 -0
  767. package/dist/types/theme.d.ts +3 -0
  768. package/dist/types/validate.d.ts +3 -0
  769. package/dist/validate.d.ts +1 -0
  770. package/dist/validate.js +222 -0
  771. package/docs/FONTS.md +68 -0
  772. package/docs/TELEMETRY.md +94 -0
  773. package/docs/manual.md +838 -0
  774. package/docs/reference/bar.md +222 -0
  775. package/docs/reference/bartable.md +143 -0
  776. package/docs/reference/box.md +93 -0
  777. package/docs/reference/bullet.md +118 -0
  778. package/docs/reference/butterfly.md +117 -0
  779. package/docs/reference/choropleth.md +148 -0
  780. package/docs/reference/cohort.md +149 -0
  781. package/docs/reference/column.md +275 -0
  782. package/docs/reference/combo.md +219 -0
  783. package/docs/reference/creative.md +147 -0
  784. package/docs/reference/diagram.md +191 -0
  785. package/docs/reference/dimswitch.md +1395 -0
  786. package/docs/reference/dot.md +117 -0
  787. package/docs/reference/fixtures.md +1088 -0
  788. package/docs/reference/funnel.md +121 -0
  789. package/docs/reference/gantt.md +132 -0
  790. package/docs/reference/grid.md +302 -0
  791. package/docs/reference/heatmap.md +127 -0
  792. package/docs/reference/histogram.md +77 -0
  793. package/docs/reference/kpi.md +115 -0
  794. package/docs/reference/likert.md +113 -0
  795. package/docs/reference/line.md +436 -0
  796. package/docs/reference/mekko.md +114 -0
  797. package/docs/reference/options.md +313 -0
  798. package/docs/reference/pareto.md +102 -0
  799. package/docs/reference/pie.md +114 -0
  800. package/docs/reference/pvm.md +114 -0
  801. package/docs/reference/pyramid.md +99 -0
  802. package/docs/reference/react.md +703 -0
  803. package/docs/reference/reading.md +28 -0
  804. package/docs/reference/sankey.md +110 -0
  805. package/docs/reference/scatter.md +211 -0
  806. package/docs/reference/slope.md +126 -0
  807. package/docs/reference/sparkline.md +74 -0
  808. package/docs/reference/status.md +107 -0
  809. package/docs/reference/table.md +673 -0
  810. package/docs/reference/theme.md +361 -0
  811. package/docs/reference/tilemap.md +121 -0
  812. package/docs/reference/treemap.md +86 -0
  813. package/docs/reference/variance.md +126 -0
  814. package/docs/reference/waffle.md +106 -0
  815. package/docs/reference/waterfall.md +164 -0
  816. package/llms.txt +57 -0
  817. package/package.json +437 -4
package/docs/manual.md ADDED
@@ -0,0 +1,838 @@
1
+ # Boardplot manual
2
+
3
+ ## What Boardplot is
4
+
5
+ Boardplot draws consulting-grade charts: 37 chart types, tables and maps among them, with every label placed by one collision solver. The output is deterministic SVG or a React component, so the same spec gives the same drawing byte for byte. Totals, differences, shares and growth rates are computed from the data, and each render reports the numbers the engine derived.
6
+
7
+ ## The spec
8
+
9
+ Every chart is one JSON object, the spec.
10
+
11
+ ```json
12
+ {
13
+ "name": "revenue-mix",
14
+ "type": "column",
15
+ "data": {
16
+ "categories": ["2021", "2022", "2023", "2024", "2025"],
17
+ "series": [
18
+ { "id": "subscriptions", "label": "Subscriptions", "values": [62, 74, 88, 103, 121] },
19
+ { "id": "services", "label": "Services", "values": [38, 41, 43, 44, 46] }
20
+ ]
21
+ },
22
+ "annotations": [{ "kind": "cagr" }],
23
+ "options": {
24
+ "variant": "stacked",
25
+ "title": "Subscriptions carry the growth",
26
+ "subtitle": { "measure": "Revenue by line" },
27
+ "unit": "$m"
28
+ },
29
+ "theme": "boardroom"
30
+ }
31
+ ```
32
+
33
+ - `name` is optional: the output file name and the chart's identity, default `chart`. It takes letters, digits, `.`, `_` and `-`.
34
+ - `type` names the chart type. `boardplot_list` returns all of them with their aliases.
35
+ - `data` has the shape of that type. `boardplot_describe` lists its fields.
36
+ - `options` is optional. It holds the title, subtitle, unit, source, axes and labels, plus the options of the type. `options.target` names the medium the chart is read in and `options.size` its slot; see [Sizing](#sizing). The subtitle prints the unit after its measure ("Revenue in $m"); a unit that neither the subtitle, an axis title nor a value label prints gets the warning `unit-not-shown`.
37
+ - `annotations` is optional. An annotation attaches a callout, note, difference arrow, CAGR arrow or value line to a data id, and the engine computes the number it prints.
38
+ - `theme` is optional. It takes a preset name or a theme object; see [Themes](#themes).
39
+
40
+ A field the type does not list is an error. `boardplot_render`, `boardplot_measure`, the CLI and the React component `BoardplotChart` all take this spec.
41
+
42
+ ## Choosing a chart
43
+
44
+ The table maps a frequent business message to a Boardplot type, the most common first. Get the fixture with `boardplot_fixtures` and the type and id, then change the data. The table does not decide what the exhibit should show; that stays the author's choice.
45
+
46
+ | Message | Type and key options | Fixture | Common pitfall |
47
+ |---|---|---|---|
48
+ | Actual vs plan per period | `grid`, `sharedAxis: "category"`: a `column` panel with AC and the PL series as `role: "reference"`, a `variance` panel with `variant: "absolute"` and `variance: { vs: "pl" }` | `weekly-actual-vs-plan` | AC and PL as grouped columns: the reader must find each gap by eye. |
49
+ | Actual vs prior year | `column`, `variant: "stacked"`, one PY series with `role: "reference"`; for ΔPY tiers, `grid` with `variance` panels | `integrated-stacked-variance`, `three-tier` | A PY series without `role: "reference"` draws as one more data series. |
50
+ | Ranking | `bar`, `sort: { categories: "desc" }` | `margin-by-brand` | Columns with long category names; a bar keeps the names on one line. |
51
+ | Trend against plan | `line`, the actual series and a plan series with `scenario: "PL"`, `gapFill` between them | `option-cost-gap` | `gapFill` tones follow the order in `between`: with the cost named first, above plan is bad, so set `positiveTone: "bad"`. |
52
+ | KPIs and a margin statement by channel over weeks | `dimswitch`, `dimension.sums: true`, measures with a `value` formula over the sums, `partOf` and `result` for the statement lines | `statement-channels` | A rate in the sums: the Total adds it up across the channels. Put counts and amounts in the sums, and let the formula divide. |
53
+ | Revenue report by segment against prior year and plan | `table`, `variant: "hierarchy"`, one `columnGroups` block per period, `computed` YoY and vs-plan columns | `management-report-compact` | A typed percentage column: parent rows add up the children's percentages. A `computed` column derives each row's own ratio. |
54
+ | Bridge: what moved the number | `waterfall`, `items[].type` `"total"` at both ends, deltas between; `pvm` for price, volume and mix | `ebit-bridge` | A typed end total: Boardplot sums the deltas, and a total value that differs warns `derived-mismatch`. |
55
+ | Mix or share | `column`, `variant: "stacked100"` | `stacked100-energy-mix` | A pie with more than six slices warns `pie-too-many-slices`, and pies do not compare periods. |
56
+ | KPI overview | `kpi` with `data.delta: { vs, scenario }` per card; for many metrics, `table` with `variant: "steering"` | `arr-card`, `steering-monthly` | A long row of cards where one table compares the metrics. |
57
+ | Status review | `status`, `options.states` with a `tone` each and a `pattern` on the at-risk state | `programme-rollout-rag` | Tone alone: a state without a pattern is lost in a grayscale print. |
58
+ | Distribution | `histogram` for one group, `box` for several | `order-value-distribution`, `deal-size-by-region` | A column of averages hides the spread and the skew. |
59
+ | Correlation | `scatter`, `trend: true` | `price-volume-trend` | The trend line shows association, not cause; r² comes back in the render's reading, not on the chart. |
60
+
61
+ ## Bartable totals
62
+
63
+ The `bartable` Total adds the rows given; if you cut rows, send a residual row with the rest or rename the Total through `options.strings.total`.
64
+
65
+ ## Getting a chart with MCP
66
+
67
+ The MCP server `boardplot` has six tools. Each answers with JSON; a rejected call carries `ok: false` and an `errors` list. Every answer carries `engineRev` and `version`, the build exactly as `boardplot --version` prints it, so a host can tell a stale server from the CLI beside it.
68
+
69
+ | Tool | Call it to | What comes back |
70
+ |---|---|---|
71
+ | `boardplot_list` | see which chart types exist | each type, the most common first, with summary, use cases, chart IDs (`type.variant`), aliases and size floor; the shared options; the theme presets; chart forms Boardplot does not draw |
72
+ | `boardplot_describe` | write a spec for one type | the data fields, the options with values and defaults, a minimal spec, the size floor, the annotation kinds and fixture ids |
73
+ | `boardplot_render` | draw a spec | a reading of the drawing (derived numbers, labels placed and dropped), warnings, the SVG on request, a PNG with `format: "png"` |
74
+ | `boardplot_measure` | fit a chart to a known width | the minimum, natural and comfortable size, the number of title lines, a refusal with the pixels it needs |
75
+ | `boardplot_fixtures` | start from a complete example | runnable specs with real-looking data, by `type` or `id` |
76
+ | `boardplot_feedback` | report a Boardplot problem | a draft report and `issueUrl`, a prefilled GitHub issue the user opens and submits; it sends nothing |
77
+
78
+ A render refusal keeps its size estimate in `expected.minimum` and `fix`. Library `canDraw()` returns it as `minimum`. Measurement verifies a size that draws without a size warning. CLI and MCP measurement return that size as `required`. A data warning such as `dual-axis`, or a proportion lint such as `height-off-ladder` or `aspect-cap`, does not reject that size. The height search is bounded. If no tested size draws within the bound, `suggest` names the bound and asks for less content or changed settings.
79
+
80
+ A worked example, an EBIT bridge. Ask for the waterfall contract:
81
+
82
+ ```json
83
+ { "name": "boardplot_describe", "arguments": { "type": "waterfall" } }
84
+ ```
85
+
86
+ The answer has a minimal spec and one line per field, the first clause of its description; a line that ends in … leaves text out, and `path` returns all of it. `"detail": "full"` (MCP), or `boardplot describe <type> --full` (CLI), returns the whole description of each field and every fixture id. `"path": "valueAxis.break"` returns that one field and the fields below it in full, or, when the type refuses the field, the reason under `refused`; a leading `data.` or `options.` picks the half, as in `data.items[].value`. `"schema": "data"` or `"options"` returns the JSON Schema of that half, for a generator that fills a schema. An excerpt of the plain answer:
87
+
88
+ ```json
89
+ {
90
+ "ok": true,
91
+ "type": "waterfall",
92
+ "data": {
93
+ "items": "array, required. Ordered bridge items…",
94
+ "items[].id": "string, required. Unique bridge-item identity used by connectors and annotations.",
95
+ "items[].label": "string. Displayed bridge-item name…",
96
+ "items[].type": "\"delta\" | \"subtotal\" | \"total\". Delta contribution by default…",
97
+ "items[].value": "cell. Signed delta contribution, or an optional check value for a subtotal or total…"
98
+ },
99
+ "sizing": { "minWidth": 280, "minHeight": 270, "fit": "fill" }
100
+ }
101
+ ```
102
+
103
+ Then draw it:
104
+
105
+ ```json
106
+ {
107
+ "name": "boardplot_render",
108
+ "arguments": {
109
+ "format": "png",
110
+ "spec": {
111
+ "type": "waterfall",
112
+ "data": {
113
+ "items": [
114
+ { "id": "fy24", "label": "EBIT FY24", "type": "total", "value": 120 },
115
+ { "id": "price", "label": "Price", "value": 18 },
116
+ { "id": "volume", "label": "Volume", "value": 9 },
117
+ { "id": "cost", "label": "Input cost", "value": -14 },
118
+ { "id": "fy25", "label": "EBIT FY25", "type": "total" }
119
+ ]
120
+ },
121
+ "options": { "title": "Price gains outweigh higher input cost", "subtitle": { "measure": "EBIT" }, "unit": "$m", "source": "Finance, FY25 close" }
122
+ }
123
+ }
124
+ }
125
+ ```
126
+
127
+ The result holds the chart as an image content block and this JSON, shown here in part:
128
+
129
+ ```json
130
+ {
131
+ "ok": true,
132
+ "size": { "width": 720, "height": 482 },
133
+ "reading": {
134
+ "type": "waterfall",
135
+ "labelsDropped": 0,
136
+ "derived": [{ "claimId": "wf:total:fy25", "operation": "waterfall total", "displayed": "133", "value": 133 }]
137
+ }
138
+ }
139
+ ```
140
+
141
+ Each derived reading has `visible: true` when it has displayed text. A calculation that is not printed has `visible: false` and `displayed: "Not displayed"`. `reading.omissions` lists each hidden label and its destination. This includes axis labels removed before placement and values moved straight to a note. A label without a replacement label or note has destination `reading.omissions`, which keeps its text. One `label-hidden` warning reports the missing labels for the chart. Redundant labels, whose information is printed elsewhere, do not cause this warning.
142
+
143
+ `reading.counts` lists structural counts and their exact phrases in the accessible description. A host can match these phrases without parsing prose. See [Chart reading counts](reference/reading.md).
144
+
145
+ The last item has no value, so the engine computed the FY25 total of 133. A total that carries a value is checked against the sum; the computed value is drawn and the render warns `derived-mismatch`.
146
+
147
+ `boardplot_render` takes `spec` and optionally `format` (`svg` or `png`), `target` (see [Sizing](#sizing)), `width` and `height` in px, `scale` (PNG pixels per layout pixel, default 2), `background` (`theme` by default; `transparent` leaves the canvas out, while halos and hollow marks keep the theme background colour, so place the chart on a surface of that colour), `return` (`["reading"]` by default; add `"svg"` for the markup) and `outDir`, an absolute directory to write the files to. PNG uses `@resvg/resvg-js`, an optional dependency, when it is installed, and otherwise Chrome or Chromium, found on the usual paths or through `BOARDPLOT_CHROME_PATH`. With neither, the render returns the SVG and the warning `no-rasterizer`. Chrome's exit code does not decide: on a busy machine Chrome writes the PNG and then exits 2, so a PNG that decodes at the requested size counts as drawn. Without one, Boardplot runs Chrome once more and then fails with `png-export-failed` (exit 2), whose message names the cause: a browser that would not start, the 60 s timeout, a crash, or Chrome's exit code with its last line of output. On Linux, resvg draws with the first family of the theme stack that fontconfig lists, else Liberation Sans, Arimo, Nimbus Sans, DejaVu Sans or Noto Sans; with none of them installed Chrome draws the PNG, and without Chrome the render returns the SVG and the warning `raster-fonts-missing`. A label with characters the theme font has no width for, such as emoji or CJK, gets the warning `png-glyph-coverage`, because resvg draws them as boxes or leaves them out. A PNG records 96 dpi times `scale`, so PowerPoint, Keynote and Word place a scale-2 PNG at the chart's own size.
148
+
149
+ ### Rows as data
150
+
151
+ A query result does not have to be copied into `data`. `boardplot_render` and `boardplot_measure` take a flat table, one row per category and series pair, as `rows` inline or as `rowsFile`, the absolute path of a local `.json` file (an array of row objects) or `.csv` file (a header row) of at most 2 MB. A CSV whose header line holds more semicolons than commas is read as semicolon-separated, as German-locale exports are, and its value column reads a decimal comma as a decimal (0,505 is 0.505); a number with grouping marks such as 1.234,5 is refused with its row, and so is 1.234, which could be 1234 or 1.234. A leading byte order mark is skipped. Read from a file, the numbers never pass through the model. `columns` names the source column for each role: `category`, `series` and `value` are required, `categoryLabel`, `seriesLabel`, `unit`, `date` and `state` (`na`, `nm` or `suppressed` for a cell whose value is null) are optional. Each role names its own column, with one exception: `date` may name the category column, so one SQL date column gives both the category ids and their dates. A category without a `categoryLabel` gets no label, so an ISO date id such as `2026-01-01` prints as a short date ('Jan', with the year on its own row) on the axis and in the hover card. `valueKind` says how the value column is written: `number` (the default), `percent` (50.5 is 50.5 %) or `fraction` (0.505 is 50.5 %).
152
+
153
+ The MCP server reads a `rowsFile` only from an allowed folder. The allowed folders are the roots the client sends (the server asks for them when the client declares the roots capability), the server's working directory (unless it is the filesystem root), the system temp folder, and every folder in the environment variable `BOARDPLOT_ROWS_ROOTS` (several separated by `:`, on Windows by `;`). The check runs on the resolved path, so a symlink that points outside is refused too. A file outside these folders is refused with `rows-outside-roots`, and nothing is read. `outDir` follows the same rule: a path outside these folders, also through a symlinked folder, is refused with `out-outside-roots`, and nothing is written. The CLI's `--rows` and `--out` take any path you name.
154
+
155
+ ```json
156
+ {
157
+ "name": "boardplot_render",
158
+ "arguments": {
159
+ "spec": { "type": "column", "data": { "series": [{ "id": "Online", "label": "Online shop", "colorRole": "highlight" }] }, "options": { "title": "Online holds half of North" } },
160
+ "rows": [
161
+ { "region": "North", "channel": "Online", "share": 0.5 },
162
+ { "region": "North", "channel": "Retail", "share": 0.5 },
163
+ { "region": "South", "channel": "Online", "share": 0.38 },
164
+ { "region": "South", "channel": "Retail", "share": 0.62 }
165
+ ],
166
+ "columns": { "category": "region", "series": "channel", "value": "share", "valueKind": "fraction" }
167
+ }
168
+ }
169
+ ```
170
+
171
+ The rows here are inline; `"rowsFile": "/data/exports/channel-share.csv"` in their place reads the same columns from a file. An absent category/series pair becomes `null`, which means unknown. A composition with a missing component withholds its share labels. When the source proves that a pair has no value, supply an explicit zero row. For example, `{ "category": "A", "series": "S1", "value": 12 }` and `{ "category": "A", "series": "S2", "value": 0 }` form a complete composition under `columns: { category: "category", series: "series", value: "value" }`. Keep unknown pairs as null.
172
+
173
+ For category charts, the rows become the spec's `data.categories` and `data.series`, in the order they first appear. A category or series the spec already names keeps its other fields, such as a label or a `colorRole`, so a spec works as a template the rows refill; a column the map names wins. Rows fill one bare spec of a type whose data is categories and series (bar, bartable, butterfly, column, combo, dot, funnel, heatmap, line, mekko, pie, slope, variance). A pair that appears twice, a text value, a state beside a value and a named column no row has are refused with the row that holds them, and rows with no data row (a CSV with only its header, an empty array) are refused as `rows-empty`. The reading gains `data`: the row count, the `sha256` of the file bytes (of the canonical JSON for inline rows), the source, the columns nothing read and the cells a state suppressed. `boardplot_measure` returns the same `data`.
174
+
175
+ ### Waterfall and scatter rows
176
+
177
+ Waterfall (alias `bridge`) takes one row per item. Use `--columns label=item,value=amount,type=kind`, or the MCP object `columns: { "label": "item", "value": "amount", "type": "kind" }`. `label` and `value` are required. The optional `type` column uses the waterfall names `delta`, `subtotal`, and `total`; an absent or blank type means `delta`. Row order is item order. A delta adds its value. An opening total sets the starting value. Later subtotals and totals use the running sum; their supplied value is a check value. A mismatch warns `derived-mismatch` and draws the running sum. Use null or a blank value for a total with no check value.
178
+
179
+ Scatter (alias `bubble`) takes one row per point. Use `--columns x=effort,y=output,size=volume,label=item,group=team`, or the same roles in the MCP `columns` object. Only `x` and `y` are required. `size` supplies bubble magnitude. `label` supplies the point name. `group` fills `points[].group` and creates `data.groups` in first-appearance order. A matching group in the spec keeps its label and style. With no group column, the spec's groups stay as authored. With no label column, point labels use their generated ids.
180
+
181
+ Sankey takes one row per link, the shape of a `GROUP BY source, target` result. Use `--columns source=from_page,target=to_page,value=visits`, or the same roles in the MCP `columns` object. `source`, `target` and `value` are required. For flows between segments month to month, add `sourceStage` and `targetStage` (for example the month and the next month): then a node is the pair of stage and id, so the same segment in two months is two nodes. A numeric id is read as text. Rows with the same ends add up.
182
+
183
+ Both mappings generate ids `row-1`, `row-2`, and so on. Labels can repeat. Rows replace `data.items` or `data.points`; other authored data stays in the spec. Named columns must exist in the source. Invalid cells report their source row and column. The reading and measure report the row count, SHA-256 and ignored columns, as for category rows. `valueKind` applies to the waterfall value or both scatter coordinates; bubble size stays a number. For different coordinate kinds, pass numeric cells in JSON rows and set each axis format in the spec. These mappings work with CLI render/measure and MCP `boardplot_render`/`boardplot_measure`, for inline rows and JSON or CSV files.
184
+
185
+ ### Map rows and classes
186
+
187
+ Choropleth and tilemap accept the same `rows` and `rowsFile` inputs. Set `columns: { "category": "area", "value": "score" }`. Each row supplies one region. Keep `data.pack` and any `data.overlays` in the spec. Maps accept `state` and `valueKind`; region names come from the pack, so other column roles are refused. Duplicate regions and invalid values are refused. The reading includes the row count and SHA-256, as for category charts.
188
+
189
+ Maps use a continuous ramp unless `classes` or `steps` is set. `classes` breaks on round numbers: steps of 1, 2, 2.5 or 5 times a power of ten, on a grid through 0 or through the diverging midpoint, so no class straddles the midpoint. One class holds at most 40 % of the regions when a round step allows it. `steps: [15, 25, 35, 45]` reuses the cohort chart's four ascending thresholds and defines five classes. A value on a threshold enters the higher class. The first and last classes are open-ended. `classes`, if also set, must be 5. The format must print the thresholds exactly. A choropleth key prints one range under each class, for example `<20`, `20–<40` and `≥80`. The key has no title unless you set `keyTitle`.
190
+
191
+ A choropleth writes each region's code on its shape. A region too small for its code gets the code beside the shape on a short leader. `valueTable` adds a table of every region with its swatch, code and value; the top regions are bold. `'auto'` (default) shows the table for at most 20 regions: beside the map when there is room, else below it when the frame can grow, else not at all. `'side'` and `'below'` set the place, and `false` turns the table off. With the table on, the map prints codes only.
192
+
193
+ A listed region with `value: null` has a hatch and the key says “Value missing”. An unlisted region has plain background and the key says “Not in data”. This distinction is automatic. A status glyph reserves space before labels are placed. Tile glyphs stay inside one tile. A glyph that cannot fit is omitted with a warning. Labels that move to the tile note also produce a warning.
194
+
195
+ ### Fraction values in chart data
196
+
197
+ Set `data.valueKind: "fraction"` when all numeric series values are fractions.
198
+ Set `data.series[].valueKind: "fraction"` for one series, such as a combo line beside count columns.
199
+ The engine converts `0.153` to `{ "pct": 15.3 }` once at input. Labels, axes, hover records, accessible text and calculations use percent units.
200
+ A percent format sets the printed style; it does not multiply values by 100. `percent-scale-suspect` warns when an undeclared series has values within ±1 and a percent format, percent cells or percent labels on a chart that shows the authored values. Composition charts derive shares from weights and do not need this warning. Grid panels get the same checks as separate charts. Numeric values without a percent claim keep their numeric units.
201
+ Numeric cells and their ranges convert. Null stays missing. Explicit `{ "pct": 15.3 }` cells already use percent units and do not convert again.
202
+ Formats, targets and axis bounds still use percent units. A numeric `valueLine` also uses percent units by default. Set its own `valueKind: "fraction"` to multiply its value and tolerance by 100. This setting is independent of `data.valueKind`. `"0.0%"` and `"1.0%"` both mean one decimal.
203
+ This field applies to bar, column, line, combo, dot, butterfly, slope, variance, heatmap, mekko, pie and funnel data. Sparkline uses `data.valueKind` for its single series.
204
+ Other data schemas refuse the field. For a combo rate, keep its separate percent axis and the required `secondaryAxis.acknowledge` setting.
205
+
206
+ ### Small values
207
+
208
+ Without an authored format, each table column and each chart series gets one precision from its largest value. Below 1, that value keeps two significant digits: 0.0341 gives three decimals, so 0.0123 and 0.0051 print 0.012 and 0.005. No automatic format prints more than four decimals. A nonzero value below the last shown digit prints its bound: `<0.001` at three decimals, `>−0.001` below zero, `<1` for whole numbers. A signed change label keeps its sign: `<+0.001` and `>−0.001`, so it reads as a change like its neighbours. Below 0.0001 it prints in scientific form, `1.2 × 10⁻⁹`. A true zero prints in the column's format, such as `0.0`. Set `options.smallValues: "zero"` for spreadsheet style (`0.000`) or `"scientific"` for a power of ten. `"p-value"` prints every value from 0 to 1 as APA 7 writes a p-value: three decimals without the leading zero (`.042`) and `<.001` below. An authored format prints as authored.
209
+
210
+ A `k`, `M` or `B` after the digits of a format example scales the value: `"$1.2M"` prints 2,456,000 as `$2.5M`, and `"1.2k"` prints 1,250 as `1.3k`.
211
+
212
+ ### Shares that add up
213
+
214
+ An authored `options.format` fixes its decimals, including trailing zeroes. Series formats and cell formats override it. Without an authored format, precision follows the data. On a percent mekko, a percent example formats shares; absolute column totals keep a number format. Their unit comes from `series[].unit` when every data series declares the same unit. `options.unit` names the shares and never labels those absolute totals.
215
+
216
+ Rounded one by one, the shares of a whole can print a sum such as 100.6 %. On mekko and pie, `options.rounding: "sum-consistent"` prints every share of a whole at the finest precision one of them needs and moves the fewest shares one step, those that rounding moved furthest, until the printed shares add up to 100 %; no share moves a whole step from its value. The reading lists each moved share under `rounding` with its value, what it prints on its own and what it prints now. The allocation uses the largest-remainder rule. For equal remainders, when the sum must go up, round up the smaller share first; when the sum must go down, take the step from the larger share first. Equal-size ties use the first input index. Use `options.format: "1.0%"` for one decimal when whole-percent adjustments are too coarse. Other types refuse the option.
217
+
218
+ ### Missing stack parts
219
+
220
+ In a stacked column, bar or combo, `null` means a value that is unknown. A stack with a `null` part prints the sum of its known parts as a plain total. The notes list names the missing parts ("Totals add the known parts only: Q1 without B"), and the chart gives one `incomplete-composition` warning. With `notes: { show: ["disclosure"] }` the total also prints "(partial)" under its value, and the note prints under the chart. When a component is known to be zero in a category, because it does not apply there, give it `0`. Then the total is complete. Keep `null` for values that are really missing.
221
+
222
+ ### SVG size and identifiers
223
+
224
+ The SVG carries its size as `width` and `height` and shrinks to a narrower container. A label halo is a second, stroked copy of the text under it. It works in importers that ignore `paint-order`, such as LibreOffice.
225
+
226
+ SVG `id` attributes and their references use a hash of the drawing, locale and resolved document theme. `data-id` is a stable part name. It is not a DOM id and does not need page-wide uniqueness. Light and dark renders have distinct ids. Identical charts in one document get a suffix for each copy. Use a distinct host prefix for identical charts rendered in separate calls.
227
+
228
+ ### Gantt and grid formats
229
+
230
+ Gantt and ordinary grid compositions have no numeric value labels of their own. Metric stacks set mark precision with panel `decimals` and `divisor`. A chart-level `format` is accepted and warns in this release. It will be refused in the next release. Set each numeric grid panel's `options.format` instead. Gantt uses calendar date options.
231
+
232
+ ### Metric stack
233
+
234
+ Use `grid` with `options.stack: {}` for two to five measures over the same cohorts or periods. Panels follow the data array from top to bottom. Each panel starts at zero on its own scale. One category axis and an optional period row sit below all panels. See [the metric stack section in the grid reference](reference/grid.md#metric-stack).
235
+
236
+ Store counts once in `data.measures`. Each panel names either a sum or a numerator and denominator. `readout: "change"` compares `data.windows.base` and `compare`: whole-percent change of average counts per category, or percentage-point change of weighted rates rounded to one decimal. `readout: { "base": "measure-id" }` gives a weighted mature step rate and the remaining-per-100 chain. The engine computes these figures from the same counts as the marks. `reading.metricStack.readouts[]` gives their inputs and category windows. Each readout has a `method` and `grain`. Count changes use `average-change`; rate changes use `rounded-rate-change`; step rates use `weighted-rate`. Grain is day, week, month, quarter, year or category. It comes from `data.windows.grain` or the category ids; unrecognised ids use category.
237
+
238
+ Mark a running category `partial: true`. Declare unavailable outcome panels in `data.states.partial.panels`. Declare the maturing range and its affected panels in `data.states.maturing`. The grid draws one continuous band across those panels. Provisional bars use light fills and dashed outlines. Provisional lines use grey dashes and hollow points. Partial points never connect. Dashes denote projected or provisional data. One panel may set `emphasis: true`.
239
+
240
+ The engine owns label space, one panel gap and one shared readout gutter. Use `stack.heights` for plot heights in layout pixels, or `rows` for proportional heights. Too-small authored gaps, gutters or heights are refused. A width-only size grows to the content height. Slide text can need more height than report text. The example fixtures are `metric-stack-volume` and `metric-stack-steps`. Existing grids keep their current layout.
241
+
242
+ ## Getting a chart with the CLI
243
+
244
+ The CLI `boardplot` has the same verbs and prints the same JSON, one object per command on stdout. `-` reads the spec from stdin.
245
+
246
+ ```sh
247
+ boardplot describe waterfall
248
+ boardplot render - <<'EOF'
249
+ {
250
+ "type": "waterfall",
251
+ "data": {
252
+ "items": [
253
+ { "id": "fy24", "label": "EBIT FY24", "type": "total", "value": 120 },
254
+ { "id": "price", "label": "Price", "value": 18 },
255
+ { "id": "volume", "label": "Volume", "value": 9 },
256
+ { "id": "cost", "label": "Input cost", "value": -14 },
257
+ { "id": "fy25", "label": "EBIT FY25", "type": "total" }
258
+ ]
259
+ },
260
+ "options": { "title": "Price gains outweigh higher input cost", "subtitle": { "measure": "EBIT" }, "unit": "$m" }
261
+ }
262
+ EOF
263
+ ```
264
+
265
+ The second command prints the same JSON as `boardplot_render`, here in part:
266
+
267
+ ```json
268
+ { "ok": true, "errors": [], "size": { "width": 720, "height": 454 }, "warnings": [] }
269
+ ```
270
+
271
+ The exit code is 0 when the call succeeded, 1 when the input was rejected and 2 for an internal error. The other commands: `boardplot list`, `boardplot describe waterfall --full`, `boardplot describe mekko --path valueAxis.break`, `boardplot describe column --schema options`, `boardplot render spec.json --rows sales.csv --columns category=month,series=segment,value=revenue` (a relative rows path resolves against the working directory), `boardplot fixtures --type waterfall`, `boardplot measure spec.json --width 400`, `boardplot render spec.json --format png --out ./charts` (a PNG goes to a file), `boardplot fonts build <font-dir>`, `boardplot telemetry status`, `boardplot feedback --category bug --summary "..."` and `boardplot --version`.
272
+
273
+ A file in `--out` takes the chart's name, `chart` when the spec has none; a taken name gets `-2`, so a render keeps existing files by default, and the warning `out-name-taken` names the requested and the written path. `--overwrite` replaces existing output files at the requested paths. The MCP tool uses `overwrite: true` for the same result. Duplicate chart names within one call still get separate files. `--quiet` prints only `ok` and `outputs` when the render succeeds, which keeps a shell loop over many variants readable; a refused spec still prints its errors. An `--out` that cannot be a folder, such as an existing file or a folder without write permission, is refused with `out-unwritable` and exit 1.
274
+
275
+ ### Problem reports and usage counts
276
+
277
+ When Boardplot itself fails, refuses wrongly or draws something misleading, offer the user a problem report: `boardplot_feedback`, or `boardplot feedback` on the CLI. Write the summary without client names, numbers, labels or paths, show the user the report, and let the user submit `issueUrl` on GitHub. Send nothing without the user's yes to that exact text. Usage counts are off until the user runs `boardplot telemetry on`; never run it for the user unasked. [Telemetry and feedback](TELEMETRY.md) lists every field.
278
+
279
+ ## Getting a chart in React
280
+
281
+ `BoardplotChart` takes the same spec.
282
+
283
+ ```tsx
284
+ import { BoardplotChart } from 'boardplot/react/spec';
285
+
286
+ const spec = {
287
+ name: 'revenue-mix',
288
+ type: 'column',
289
+ data: { categories: ['2021', '2022', '2023', '2024', '2025'], series: [{ id: 'subscriptions', label: 'Subscriptions', values: [62, 74, 88, 103, 121] }, { id: 'services', label: 'Services', values: [38, 41, 43, 44, 46] }] },
290
+ annotations: [{ kind: 'cagr' }],
291
+ options: { variant: 'stacked', title: 'Subscriptions carry the growth', subtitle: { measure: 'Revenue by line' }, unit: '$m' },
292
+ };
293
+
294
+ export function RevenueMix() {
295
+ return <BoardplotChart spec={spec} size="container" fit="fill" fallbackSize={{ width: 960, height: 540 }} />;
296
+ }
297
+ ```
298
+
299
+ The entry stays small because it links no chart engine and no chart schema. `BoardplotChart` reads the type a spec names and fetches three chunks. Spec validation — the document parser, the diagnostics and zod — serves every type, so a page loads it once. The type's data and options schemas are their own chunk, and its engine a third. A grid's engine links no panel engine: it fetches the engines its panels name, all at once. The repository's package check (`npm run smoke:package`) prints the current sizes of the entry and of the first chart of each type. Until the chunks arrive it draws the busy placeholder, the box a refused chart uses with the wording of `strings.loading`; in the browser an engine the page already holds needs no second wait. A server pass always draws the placeholder, whatever that server loaded for an earlier request, so its output stays the same as it warms up and hydration matches it; `prepared` is no exception, because a prepared chart's request is resolved against the type's registration before its scene is attached. Put a chart in the server HTML with the type's own component, such as `ColumnChart` from `boardplot/react/column`. A chunk that does not arrive leaves the diagnostic card in the chart's place and the next render asks for it again.
300
+
301
+ `BoardplotTheme` sets the theme, locale and built-in wording for every chart below it. The language sets words only: `locale="de-DE"` prints `1,234.5`, and `locale={{ language: 'de-DE', decimal: ',', thousands: '.' }}` prints `1.234,5`. For server rendering, `prepareChart` lays the chart out once on the server; pass its result as `prepared` with the same props, and the first client render reuses it. `prepareChart` and `parseChartSpec` return promises, because they load only the types the spec names.
302
+
303
+ ```tsx
304
+ import { BoardplotTheme } from 'boardplot/react/theme';
305
+ import { BoardplotChart } from 'boardplot/react/spec';
306
+ import { parseChartSpec, prepareChart } from 'boardplot/react/prepare';
307
+
308
+ const spec = { type: 'bar', data: { categories: ['North', 'South'], series: [{ id: 'orders', label: 'Orders', values: [42, 35] }] } };
309
+ const sizing = { size: 'container' as const, fit: 'content' as const, fallbackSize: { width: 800, height: 450 } };
310
+
311
+ export async function Orders() {
312
+ const prepared = await prepareChart({ ...(await parseChartSpec(spec)).request, ...sizing }, { theme: 'notation' });
313
+ return (
314
+ <BoardplotTheme theme="notation">
315
+ <BoardplotChart spec={spec} {...sizing} prepared={prepared} />
316
+ </BoardplotTheme>
317
+ );
318
+ }
319
+ ```
320
+
321
+ A host that draws its own card around a chart switches Boardplot's frame text off: `title: false`, `legend: 'none'`, `footnotes: false`, and no `subtitle` or `source`. `footnotes: false` also leaves off the method notes Boardplot derives, and the info lint `footnotes-off` names each one so the card can print it; the render's notes list holds them all. A disclosure that `notes.show` prints stays: a table's rounding note, a partial period, values the chart does not print. The source line and a required map credit stay: leave `source` out for no source line, and a map licence credit cannot be switched off. `legend: 'none'` leaves off the key of a table, heatmap, cohort or variance, and the scatter size key, and the info lint `legend-off` names that key and its entries so the card can draw its own.
322
+
323
+ An invalid spec renders an error card with the same errors the CLI returns. Each type also has its own component with flat props, such as `WaterfallChart` from `boardplot/react/waterfall`, which takes `data`, `annotations` and the options as props (`title`, `unit`, `valueAxis`). Such a component refuses a prop its type does not take with the same `unknown-option` card. It checks the keys and leaves the option values and a grid's panel options to the spec path. Props, container sizing, server preparation and export to SVG, PNG and PDF are in [the React reference](reference/react.md).
324
+
325
+ A `dimswitch` row id is `JSON.stringify([variant, memberId, measureId])`; a member row in by-member omits `measureId`. React `onRowSelect` and `isRowSelectable` get these ids, and `dimswitchRowId(variant, memberId, measureId)` builds them (exported from `boardplot`).
326
+
327
+ A per-type entry is the small one: it links its own chart and the shared layout core. A page pays for the core once, and each further type adds only its own engine. Two core modules are not in that load, because most charts never reach them. The annotation placement engine, with the event lane, loads when a chart carries an annotation (an event included), a value line, a target or a derived callout. The checks a PATCHED theme goes through load when a caller passes `theme={{ preset, overrides }}`. Pareto and likert are the two types that need one on every chart — the cumulative threshold line and the statement-label theme patch — so their entries link it rather than fetch it. While such a chunk loads the component draws the busy placeholder and then the chart, byte for byte the chart it drew before; a graph that already links the module — the CLI, the MCP server, `boardplot/react/prepare`, the `boardplot/react` barrel — never waits in the browser. A server pass, and the client pass that hydrates it, count only what the chart's own entry links, because a server process can hold a module that the page in the browser does not: `renderToStaticMarkup` of an annotated chart or a patched theme from a per-type entry (`boardplot/react/<type>`) writes the placeholder unless the component gets `prepared`, and the chart follows once the page has hydrated. The barrel's components draw it, because the barrel links both modules.
328
+
329
+ ### Rows in React
330
+
331
+ Every chart component takes query rows in place of `data`, with the same `columns` and the same refusals as `rows` in `boardplot_render`. `data` is then the template: a series it already names keeps its label and colour role. A SQL date column can be the category and the date at once, `columns: { category: 'month', date: 'month', series: 'product', value: 'revenue' }`; the months then print as 'Jan', 'Feb' and so on.
332
+
333
+ ```tsx
334
+ import { LineChart } from 'boardplot/react/line';
335
+
336
+ const rows = [
337
+ { week: '2026-W40', channel: 'Search', revenue: 120 },
338
+ { week: '2026-W40', channel: 'Social', revenue: 80 },
339
+ { week: '2026-W41', channel: 'Search', revenue: 135 },
340
+ { week: '2026-W41', channel: 'Social', revenue: 95 },
341
+ ];
342
+ const columns = { category: 'week', series: 'channel', value: 'revenue' } as const;
343
+
344
+ export function WeeklyRevenue() {
345
+ return <LineChart rows={rows} columns={columns} title="Search leads every week" unit="$k" size="container" fit="fill" fallbackSize={{ width: 960, height: 540 }} />;
346
+ }
347
+ ```
348
+
349
+ `onRowsReading` receives the reading: the row count, the columns no role names and the cells a `state` column suppressed, because the chart draws a suppressed cell as an empty one. Rows that do not map draw the error card with the CLI's `code` and the row, such as `invalid-value` at `rows.3.revenue`. `BoardplotChart` takes `rows` and `columns` too, beside a bare chart spec. The mapping loads as its own chunk the first time a chart gets rows, so a page without rows does not pay for it; `prepareChart` takes the same rows for a server render. [Rows from a query](reference/react.md#rows-from-a-query) has the details.
350
+
351
+ `specFromRows` from `boardplot/rows` runs the same mapping as a function, in the browser or in Node, and returns `{ spec, reading }`: use it to build a spec yourself, for example in a server component. Rows that do not map throw an `InputError` with the CLI's `code`, message and `details.path`, such as `/rows/3/revenue`. The entry links no chart engine and no zod. It reads no file: `rowsFile` is for the CLI and the MCP server. It checks a choropleth's region ids when the page has imported the map pack (`boardplot/geo/<id>`), and leaves a tilemap's region ids to the chart, which refuses an unknown region when it draws. `specFromRows` is also exported from `boardplot`.
352
+
353
+ ### Small bundles
354
+
355
+ With esbuild 0.28.2, code splitting, minification and React external, a column's first load through `boardplot/react/spec` is about 351 kB gzip. The initial entry is about 199 kB; validation adds about 83 kB, then the column schema and engine load. The validation chunk is shared across chart types. Importing `ColumnChart` from `boardplot/react/column` starts at about 203 kB gzip. These are package measurements with gzip level 9; the host build can produce different chunk sizes.
356
+
357
+ `boardplot/react` registers every chart core when it loads, so a page that imports it links the whole catalogue, whatever it draws. For a small page, import each chart from its own entry, or draw through `BoardplotChart` from `boardplot/react/spec`. Take the theme provider and the other shared pieces from `boardplot/react/theme`: `BoardplotTheme`, `useBoardplotTheme`, `ScaleGroup`, `useScaleGroupPlan` and `SceneRenderer`. That entry registers no chart core, so the page links only the cores it draws. Bundle with code splitting, as the production builds of Vite, webpack and Next.js do. A per-type entry loads the annotation engine, the checks a patched theme goes through and the hover and data-table records on demand; a single-file bundle inlines them into the page for every chart type, and `BoardplotChart` then inlines every engine. `useChartLayout` lays out any type by name and registers every core; it stays in `boardplot/react`.
358
+
359
+ ```tsx
360
+ import { BoardplotTheme } from 'boardplot/react/theme';
361
+ import { ColumnChart } from 'boardplot/react/column';
362
+
363
+ const data = {
364
+ categories: ['2021', '2022', '2023', '2024', '2025'].map((year) => ({ id: year, label: year })),
365
+ series: [
366
+ { id: 'subscriptions', label: 'Subscriptions', values: [62, 74, 88, 103, 121] },
367
+ { id: 'services', label: 'Services', values: [38, 41, 43, 44, 46] },
368
+ ],
369
+ };
370
+
371
+ export function RevenueMix() {
372
+ return (
373
+ <BoardplotTheme theme="notation">
374
+ <ColumnChart data={data} variant="stacked" annotations={[{ kind: 'cagr' }]} title="Subscriptions carry the growth" unit="$m" size="container" fit="content" fallbackSize={{ width: 800, height: 450 }} />
375
+ </BoardplotTheme>
376
+ );
377
+ }
378
+ ```
379
+
380
+ ### Export fonts
381
+
382
+ The React SVG export copies the page's web fonts that its text draws with into the SVG, as `@font-face` rules with `data:` URLs. It copies only the families, weights, styles and `unicode-range` slices that the text uses, each as the whole font file the page loaded. A file opened in a browser on another machine then draws the same face with the measured spacing. A family the machine lacks is skipped. An installed system family ends the stack for text in Latin-1 and general punctuation, which every system font draws, so the export copies no later web font for it; text with other characters keeps the later web fonts, which draw the glyphs the system family lacks. The built-in presets name system fonts only, so their exports add no bytes. A web font adds its file size plus a third for the base64 encoding: the variable Geist Latin file (29.4 kB, every weight) adds 39.3 kB to each SVG. Pass `embedFonts: false` for the plain SVG, for example when the page that shows it already loads the font, or when the font licence forbids copies in documents. Design and slide tools that import SVG can ignore embedded fonts; use the PNG there when the font is not installed.
383
+
384
+ Before export, the React export checks `document.fonts.check()` for the theme font stack. If the check fails, it warns once per page and font stack through `console.warn`, the existing export warning channel, and the file carries no copy of that font. Load the font before export. The check does not prove that an undeclared font is installed; see the [CSS Font Loading specification](https://www.w3.org/TR/css-font-loading/#dom-fontfaceset-check). The PNG export paints the SVG with the same font copies, also with `embedFonts: false`. If a loaded font file cannot be read (a style sheet from another origin, a `FontFace` built in script, a failed fetch), the export warns and the text draws a fallback font.
385
+
386
+ The CLI and MCP SVG names the theme font stack and embeds no font; their PNG draws with the fonts installed on the machine. For a brand web font, either export from React, or install the font on the machine that renders and pass `--font-tables` from `boardplot fonts build` ([Custom fonts](FONTS.md)), then hand on the PNG.
387
+
388
+ ## Story steps
389
+
390
+ Wrap a chart with `withStory` from `boardplot/react/story` to show `options.story.steps` with Back and Next controls. Each step uses the authored `title` and optional `body`. The marks stay in place. Back stops at the first step. Next stops at the last step.
391
+
392
+ The panel stays outside the plot. Wide charts reserve a 240–320 px right column. The S width class, or a chart that cannot give up that width, puts the panel below the x axis at the full plot width. Automatic height grows for the panel. Fixed height reduces the plot toward its measured minimum. If the panel still does not fit, its body loses lines first, down to zero. Then its title clamps to one line. The button row stays. The chart refuses only when this minimum panel and the plot cannot fit. The panel uses the background and grid tokens with a 6 px radius. Next uses ink with background text. Back has a hairline outline. Hover paint runs only on devices that support hover; pressed paint uses theme tokens.
393
+
394
+ Use Tab to focus the story or either button. Left and Right move between steps. The story declares these keys with `aria-keyshortcuts`. The story and buttons have a 2 px focus ring with a 2 px offset, in the theme's `ink` colour. Each HTML button has a minimum 44 × 44 CSS px hit box. Back grows left and Next grows right, so the hit boxes keep their gap when the SVG shrinks. The drawn buttons are at least 44 px high. Their labels wrap when needed. The counter sits on the left. Back and Next sit on the right with an 8 px gap. If the row is too narrow, the counter moves above the buttons.
395
+
396
+ The polite live region announces `Step N of M: title. body`. Set `strings.storyStep` to author the position wording. It accepts `{step}` and `{count}` without zero padding. Defaults are `Step {step} of {count}` in English and `Schritt {step} von {count}` in German. A chart string overrides the React theme provider string. The drawn counter uses `strings.storyCounter`, with the default `{step} / {count}` and no zero padding. There is no progress bar. A single step shows only the title and body, without buttons or a counter.
397
+
398
+ The panel shows up to four title lines and ten body lines. A cut title or body reports `story-text-truncated` with the step id and field path. Shorten that field or give the panel more width. The live region retains the full authored title and body.
399
+
400
+ ## Notes under the chart
401
+
402
+ Boardplot sorts every note under a chart by kind. In the live React chart, the render target decides how much of it the frame prints. A React chart with `fit="content"` takes its height from its content and prints the footer of the static image: every note of the kinds `notes.show` lists, in full, with no line budget, so it is as tall as `boardplot render` at the same width. Under `notes.placement: 'info'` a "Notes and sources (N)" button opens the notes the image does not print; it sits in the space the image leaves free for it.
403
+
404
+ Boardplot prints none of its own notes under a chart by default, on every target and surface: the `method` and `disclosure` notes go to the notes list only. `notes.show` prints them where the author asks for them. A spec that asks for notes another way gets them too: `methodNote: true` or an authored `notes.placement` prints the method notes and disclosures, as `notes.show: ['note', 'method', 'disclosure']` does. A changed note wording alone (`strings.incompleteStacks`) prints nothing. Static SVG, PNG and clipboard images print the full author notes, the kinds `notes.show` adds, the source and the credit. Compact charts retain note reference numbers. Grid panels move notes that do not fit into the outer footer, under the panel title and ID. They have no notes button or "+N notes" pointer. The notes start at the normal footer gap below the chart's last element. They use the existing footer space first. If they need more room, the canvas grows below its original boundary. The plot keeps its position and size. `footnotes: false` still suppresses notes other than the disclosures `notes.show` prints.
405
+
406
+ | Kind | What it is | Where it goes |
407
+ |---|---|---|
408
+ | `note` | Your `footnotes`, in your order | The frame, within the line budget |
409
+ | `method` | Boardplot's text on how a number is built (likert net, the pvm split) | The notes list; `notes.show: ['note', 'method']` prints its one-line short form |
410
+ | `disclosure` | Boardplot's text on how to read the chart: a key to an encoding ("One cell = 5%", "W38 partial", "Columns by rank"), a change to the data ("1 value below zero shown as 0."), or the marks the drawing leaves unlabelled ("Not labelled on the chart: ...") | The notes list and its warnings (`values-in-note`, `labels-as-ranks`); `notes.show` with `'disclosure'` prints it in the frame, outside the line budget |
411
+ | `source` | Your `source` | Always in the frame, last line |
412
+ | `credit` | A map pack's licence credit | Under the source line when the licence requires it (de-states, us-states), else the notes list |
413
+
414
+ The line budget counts the notes and the source line; a required credit and a disclosure do not count. A numbered author note that a mark on the chart points at ("1)" beside a category) prints on every target, like a required credit. A mark that points at one of Boardplot's own notes prints only where that note prints: without `'disclosure'` in `notes.show`, a column row draws no rank numbers and no note mark on a cut name, a gantt milestone keeps its diamond without a key number, a table head drops its † and a dimswitch period its *. `footnotes: false` keeps a disclosure that `notes.show` prints; it leaves a pointed note off with the other notes and hands it to the host in the `footnotes-off` lint. Report and dashboard take 3 lines (2 under 720 px wide), slide 2 and print 3. A note that does not fit moves to the notes list with every note after it, and the source line ends with "+N notes". The pointer counts only the hidden notes of the kinds `notes.show` prints. A slide prints only the source line, the credit and the pointer by default (`notes.placement: 'list'`); set `notes.placement: 'frame'` for its 2 lines of notes.
415
+
416
+ Every render returns the notes list, so a host can build an appendix or a backup slide from it: `notes` on each chart of the CLI and MCP result, `notes` in the reading, and `geometry.frame.noteList` in the library. Each entry is `{ n, kind, text, short, inFrame }`; a credit adds `links`, and a note the chart numbers adds `ref`, the number it prints with.
417
+
418
+ For example, in a live React layout, a likert chart's net note reads `{ "n": 3, "kind": "method", "text": "Net = share on the agree side minus share on the disagree side, in percentage points; the neutral option counts on neither side.", "short": "Net = agree minus disagree, in points.", "inFrame": false }`. Static output prints the full text and sets `inFrame` to `true` where `notes.show` lists `'method'`.
419
+
420
+ The options:
421
+
422
+ - `notes.placement`: 'frame', 'list' or 'info'. 'info' is the dashboard default: in React one line holds the source and a required credit, and a "Notes and sources (N)" button opens a panel with every other note, Boardplot's hidden notes included. Static output and a content-fit React chart print every note of the kinds `notes.show` lists for all three placements. Under 'info' a static footer (except a table's) keeps the width of the button free after the source line or its last line, or an empty row under its last line where the button fits after neither; a content-fit React chart puts the button in that space, and it opens the notes the footer does not print. `onNotes` and `renderNotes` still hand the host every note.
423
+ - `notes.maxLines`: the live chart's line budget. Static output and a content-fit React chart have no line limit.
424
+ - `notes.show`: the kinds the frame prints, default `['note']`, on every surface; `['note', 'method', 'disclosure']` where the spec sets `methodNote: true` or `notes.placement`. An authored `notes.show` always decides alone. Add `'method'` for the method notes and `'disclosure'` for the disclosures, for example `notes: { show: ['note', 'disclosure'] }`. On a pinned height, printed disclosures never take the plot under its floor: the chart refuses with `size-below-floor` and the height that seats both. On an open height the chart still gets the height a printed disclosure would take when the labels need it, so a hidden note does not cost a label.
425
+ - `notes.pointer`: false drops "+N notes", and in React the button and panel. Static output always has the full notes and no pointer.
426
+ - `notes.maxListed`: the items a disclosure names before it counts the rest, default 8. `'all'` names every item; `0` only counts them.
427
+
428
+ The de-states pack prints "Map: © BKG (2026) dl-de/by-2-0 (data changed), Datenquellen: <URL>" in SVG, PNG and PDF at every width, and under `footnotes: false`. React shows the full credit at every width and in print. The credit wraps as needed, with "BKG", "dl-de/by-2-0" and "Datenquellen" as links. The us-states pack prints "Map: U.S. Census Bureau (2025)". The Natural Earth packs (eu27, europe, world, dach) need no visible credit; theirs is in the notes list. NOTICE.md has the full licence texts.
429
+
430
+ In React the footer is HTML under the SVG. `onNotes(notes)` hands a host the list whenever it changes, and `renderNotes(notes)` draws the notes in place of the button and panel; the source line and a required credit stay under the chart. The panel opens by click or Enter, closes with Esc, and print CSS opens it.
431
+
432
+ A host's own document capture Escape handler runs before the browser closes the popover; the host should ignore Escape while it contains `[popover]:popover-open`.
433
+
434
+ ## Sizing
435
+
436
+ Pick the target, give the slot size. The target names the medium the chart is read in. It sets the type sizes, the readability floors and the default canvas. The slot is the space the host gives the chart. Boardplot lays the chart out at that size, so its text keeps the size the target sets.
437
+
438
+ | Medium | Target | Slot size | CLI flags |
439
+ |---|---|---|---|
440
+ | HTML report, Claude Artifact, email | `report`, the default | Column width in px, for example 680 to 720 | `--width 700` |
441
+ | Dashboard card | `dashboard` | The card. In React, `size="container"` measures it | `--target dashboard --width 480` |
442
+ | Slide picture | `slide` | Picture box in pt | `boardplot render spec.json --target slide --width 660pt --height 360pt`; a PNG at the default `--scale 2` |
443
+ | Print or PDF | `print` | Print area in mm | `--target print --width 180mm --height 110mm --scale 3.125` (300 dpi) |
444
+
445
+ Set the target with `--target` on `boardplot render` and `boardplot measure`, with `target` on `boardplot_render` and `boardplot_measure`, with `options.target` in the spec, or with the `target` prop in React. `BoardplotTheme` passes its `target` to the charts below it. A target given to the call wins over `options.target`, which wins over the provider. Without one, the target is `report`.
446
+
447
+ `options.textScale` multiplies every text the chart draws: title, subtitle, labels, axes, legends, notes, source, event lanes, KPI figures and eyebrows, and the table faces, the theme's absolute `table` sizes included. It takes 0.5 to 2.5; 1, like no value, keeps the target sizes, and 1.25 sets every text 25 % larger. The layout runs again at the new sizes, so lines wrap, labels move and ticks thin as they need to; the canvas keeps the size you give. A theme override of one role still works, and `textScale` multiplies it too. A scale under 1 stops each text at the target's readability floor (11 px for most report text), so it never draws text under it; a scale above 1 raises the floors with the text. In React, `BoardplotTheme` passes its `textScale` to the charts below it, the table grid and the hover cards included, and a chart's own `textScale` wins. `geometry.presentation.textScale` carries the scale the chart drew at (absent at 1), for HTML that a host prints beside the chart. `textScale` multiplies the size of the chart's width class, so charts of different widths draw different sizes at the same scale: at 1.4 a 1010 px chart sets its labels at 18.2 px and a 560 px chart at 15.4 px. For equal text, use `textSize`.
448
+
449
+ A theme override of `type.secondary.size` sets the key text size. An override of `type.footnote.size` sets the note and source text size. These sizes take priority over the frame defaults.
450
+
451
+ **Equal text across charts on one page or slide.** `options.textSize` pins the primary label size in px, the same at every width, from 6 to 32. Every other text role keeps its ratio to the primary label in the middle width class (720 to 1079 px): on the `report` target, `textSize: 13` draws a 560 px chart with the sizes a 1010 px chart has. A chart of 1080 px or more draws smaller than its default under `textSize: 13`, because its default class is larger. On `slide` and `print`, `textSize` is in layout px, not pt. Set the same `textSize` on every chart of the page or slide, on `BoardplotTheme` for all charts below it, or once on a grid, where it applies to every panel; a panel that sets another value is refused. It works on every chart type, in `boardplot render`, `boardplot measure`, the MCP tools, the API and React. `textSize` and `textScale` together are refused: keep one. The floors stay: a `textSize` under the target's sizes stops each text at its floor.
452
+
453
+ `--width` and `--height` take a number of px, or a number with `px`, `pt` or `mm`. The MCP `width` and `height` are px; put a physical size in `options.size` with its `unit`. 1 pt is 96/72 px and 1 mm is 96/25.4 px. A width alone leaves the height automatic. Over a pinned height, a width alone keeps that height; over a size preset, it keeps the preset's shape (`slide-4x3` at `--width 840` draws 840 × 632 px, the same ladder step).
454
+
455
+ ```json
456
+ {
457
+ "type": "column",
458
+ "data": {
459
+ "categories": ["2024", "2025"],
460
+ "series": [{ "id": "revenue", "label": "Revenue", "values": [120, 135] }]
461
+ },
462
+ "options": { "title": "Revenue grew 12.5 percent", "unit": "$m", "target": "slide", "size": { "width": 660, "height": 360, "unit": "pt" } }
463
+ }
464
+ ```
465
+
466
+ The answer gives the size in layout px: 660 × 360 pt is 880 × 480 px.
467
+
468
+ ```json
469
+ { "ok": true, "size": { "width": 880, "height": 480 } }
470
+ ```
471
+
472
+ The layout width selects a class: S below 720 px, M from 720 px, L from 1080 px. In the M class, title, label, axis and footnote are 20, 13, 13 and 12 px for `report`; 18, 13, 13 and 12 px for `dashboard`; 20, 14, 14 and 10 pt for `slide`; and 16, 11, 11 and 9 pt for `print`. KPI and bullet use the M sizes at every width. To fit, the engine wraps, moves or discloses labels; it never sets text below the target's floor. A chart that still does not fit is refused with the size it needs. A theme that sets a smaller size renders with one warning.
473
+
474
+ Without a size, `report` starts at 720 × 405 px and `dashboard` at 480 × 270 px; both take the height their content needs. `slide` is fixed at 888 × 396 pt (1184 × 528 px), the content frame of a 960 × 540 pt slide. `print` is fixed at 267 × 180 mm, landscape A4 inside 15 mm margins. The presets `slide-16x9` (720 × 405 px), `slide-4x3` (720 × 540 px), `a4` (1052 × 744 px) and `dashboard` (480 × 270 px) keep their sizes. `a4-landscape-content` (267 × 180 mm) and `a4-portrait-content` (180 × 267 mm) are new. A preset sets the size, not the target: use `target: "print"` with the A4 content presets. A full slide is `size: { "width": 960, "height": 540, "unit": "pt" }` with `target: "slide"`.
475
+
476
+ The SVG `viewBox` is in layout px. Its `width` and `height` are px for `report` and `dashboard`, and pt for `slide` and `print`, so the host places it at the slot size. A PNG has `scale` pixels per layout px, 2 by default for every target, and records 96 × `scale` dpi. Raster density does not change the text size or the placed size: a 660 × 360 pt chart at `--scale 4` is still 660 × 360 pt with 14 pt labels. Printing a `report` chart does not give it print type; render it again with `target: "print"`.
477
+
478
+ The SVG shrinks to a narrower container, and its text shrinks with it. An SVG may shrink by about 10 % at most before it warns, and a floor can allow less. `embed.width` declares the CSS px width the host shows the chart at; the render warns `type-below-effective-min` when that width is below the safe minimum. Do not change `embed.width` to remove the warning; render at the slot width instead. In code, `geometry.presentation` holds the target, the class, the natural size and `minDisplayWidth`, the narrowest CSS px width that shows the chart without a warning. A static SVG cannot know the width it gets.
479
+
480
+ A chart in a narrow phone layout needs a new layout, not shrinking. Render it again at the phone width, where many types draw in compact mode; use a simpler chart; or keep a readable minimum width with horizontal scrolling or a full-size view.
481
+
482
+ Each type has a floor, `minWidth` × `minHeight` in layout px, and a fit, listed by `boardplot_list` and `boardplot_describe`. A `fill` type uses the whole frame. A `content` type such as `bar`, `table` or `kpi` takes the height its rows need.
483
+
484
+ The width floor of a row chart (bar, bartable, funnel, butterfly, likert, gantt, cohort, heatmap) and of a band chart (waterfall, pareto, variance, pyramid, box, mekko, pvm) is the width its content measures, and never less than the card minimum of 280 px. The chart draws full where its content fits. Below that it draws compact, and it is refused only when compact does not fit either; the refusal names the size compact needs. This also holds for a width alone. Every row and band type has a compact form, except mekko, whose `mode` names its calculation, and bullet, which compacts only by `density: 'compact'`. A horizontal waterfall and a status grid keep a 480 px floor for now. A bullet chart's width floor is the width its rows measure. A diagram draws on a card down to 280 px when no card or group text is cut and no group frame overlaps another there; otherwise it keeps a 480 px floor. A node, group, caption, badge or edge label that the narrow card would hide, or an edge label it would cut, also keeps the 480 px floor. Column, line, combo, histogram, scatter and dot keep a 480 px floor and draw below `minWidth` or `minHeight`, on either axis, down to a `compactFloor`. A pie keeps its 320 px height floor for an automatic height; a pinned pie draws compact below it, down to 160 px, while its circle keeps a radius of at least 36 px. A pinned slope draws compact under its 270 px height floor, down to 180 px, while its plot keeps 80 px; with an automatic height it takes its content height. An authored grid of several columns that refuses under 480 px draws compact: its panels stack in one column, in authored order, down to the width its widest panel measures. Metric stacks, category tiers, legacy facet grids and grids with `anchors` or `alignmentRules` have no compact form.
485
+
486
+ Compact mode sets minimal labels, tight spacing and the key in the footnote size. It keeps the series key, the whole title and the subtitle; a canvas too short for them is refused with the height they need. A `fill` chart in compact mode keeps a plot of at least 80 px, whichever side of the canvas is short. On a fixed width and height a canvas that cannot hold it draws the plot under that floor, down to the type's hard minimum (step 7 under "Fixed height"), and warns `plot-under-floor` with the height it needs. `belowMinimum: 'refuse'` refuses below the measured floor instead of drawing compact. A type without a compact floor refuses below its minimum. Every refusal names the minimum it needs.
487
+
488
+ ### Frame text, key and automatic height
489
+
490
+ These rules apply on every target.
491
+
492
+ - The title is never cut. It wraps to three lines; a title that needs more takes more lines. The subtitle wraps until every word shows. The frame grows; the plot does not shrink for it.
493
+ - A chart with two or more series always names them: a key row or a direct name at each series. Compact mode keeps the key, in the footnote size, and keeps an explicit `options.legend`. A line whose end names do not fit puts its key in a row above the plot at 480 px wide and narrower, never beside the plot.
494
+ - A grid panel names its own series when its title names its one series, when a line or combo draws an end label with the name of every series, or when the panel draws its own key row. A grid whose panels all name their series draws no grid key under `legend: 'none'`. Otherwise the grid key row lists only the series no panel names, and the info lint `grid-legend-required` names them.
495
+ - An automatic height (no height, or a width alone) reserves the plot first. The plot gets at least half of the canvas and at least 160 px (`dashboard`: 140 px). Title lines, key, annotations and notes then grow the canvas. A `fill` type starts at its own minimum height, never at a 16:9 strip of a narrow width, and at card widths (under 480 px) a fill chart is never shorter than at 480 px, compact or full. Pie, waffle, choropleth and tilemap take the height of their content, and a sparkline card with an authored width scales its trend band with that width: their marks scale with the width, so a narrower card of these can be shorter. Wider charts keep their aspect height. A chart whose plot does not take more height (variance tiers) keeps its start height. A `content` type keeps the height of its content; at card widths a butterfly, diagram, funnel, grid, heatmap, KPI or status card is never shorter than at the next wider card step (400, then 480 px). A grid of fill panels also keeps the plot floor. When title, key, notes and the axis-label row take more of a fill chart's automatic height than the furniture budget (half of the canvas under 720 px, 40% from 720 px), the chart grows to the smallest height inside the size ladder that keeps the budget, never past the tallest ladder step; where no such height exists, the `furniture-budget` warning stands.
496
+
497
+ ### Fixed height
498
+
499
+ A slot with a fixed height (`options.size.height`, a size preset, or a host height in React) never grows. When the content does not fit, the chart gives up optional parts in this order:
500
+
501
+ On a fixed compact card, the plot first tries its hard minimum with the source line and subtitle still on the canvas. A rectangle treemap also gives up its 160 px plot floor before it refuses the card. Text keeps its size floor. `belowMinimum: 'refuse'` keeps the full floor.
502
+
503
+ 1. Value labels thin to the few the compact mode keeps.
504
+ 2. Axis ticks thin with the plot height.
505
+ 3. Notes move to the notes list; the source line ends with "+N notes". A compact frame then puts the source on one line, and as the last footer step moves it to `frame.source` for the host (the info lint `footnotes-off` names it).
506
+ 4. The key takes the footnote size, so more entries fit in one row.
507
+ 5. The plot shrinks to its floor.
508
+ 6. The subtitle moves into the notes list (warning `subtitle-moved-to-notes`). It stays readable there and in the React notes panel. The source line stays with the host, as step 3 left it. A unit line ("Revenue in $m" without the measure) can stay on the canvas.
509
+ 7. The plot goes under its floor, down to the type's hard minimum: a bar's rows get thinner than its segment labels need, and labels that do not fit are hidden. A column, line, combo, histogram, scatter or band chart keeps a plot of at least 40 px with room for two value-label rows, which holds two labelled value ticks; its other measured needs (end labels, rows) still apply. A value label that loses its seat goes to the note, as the note rules say.
510
+
511
+ The title is never cut and the key is never dropped. When the plot ends under its floor (160 px, `dashboard` 140 px), or a row type draws at its hard minimum, the chart is still drawn and warns `plot-under-floor`. Rendering gives an estimated height from the drawn frame and a `fix` that sets it. Use `measure` for the exact verified size. Only when step 7 still misses is the chart refused with the size it needs (`size-below-floor`). Steps 6 and 7 apply on a fixed width and height in compact mode. At step 7 a heatmap row drops its 28 px comfort height to its text line and 2 px, and a dot row keeps 1 px of air instead of 4.
512
+
513
+ In React the HTML footer takes exactly the height the layout reserved for the footer it replaces, and the notes panel opens over the chart, so a chart in a fixed-height slot never grows past it. A React container without a host height hands the engine its width alone, so it takes the same automatic height and plot floor as the CLI.
514
+
515
+ A size up to 0.5 px under a minimum still fits, for every type. A browser lays a card out in fractions of a pixel, and 777.98 px for a 778 px minimum draws. A refusal prints whole pixels.
516
+
517
+ `boardplot_measure` reports the size a spec needs without drawing it:
518
+
519
+ ```json
520
+ {
521
+ "name": "boardplot_measure",
522
+ "arguments": {
523
+ "width": 400,
524
+ "spec": {
525
+ "type": "waterfall",
526
+ "data": { "items": [{ "id": "fy24", "type": "total", "value": 120 }, { "id": "price", "value": 18 }, { "id": "fy25", "type": "total" }] }
527
+ }
528
+ }
529
+ }
530
+ ```
531
+
532
+ ```json
533
+ {
534
+ "minWidth": 280,
535
+ "minHeight": 270,
536
+ "naturalWidth": 280,
537
+ "naturalHeight": 334,
538
+ "fit": "fill",
539
+ "compactFloor": { "width": 280, "height": 180 },
540
+ "mode": "full",
541
+ "refused": null
542
+ }
543
+ ```
544
+
545
+ `measure` reports two minimum heights. The minimum height depends on the width: text wraps, and notes grow with the frame. So `minHeightAtWidth` is the height needed at exactly the width you asked for (the minimum width when you asked for less): a chart pinned at that width and that height draws in full mode. `minHeight` is checked at the minimum width as well, so a chart pinned at `minWidth` × `minHeight` draws too. In a wide slot `minHeight` can be taller than the slot needs, because the narrow case sets it. A 280-day combo at 1168 px wide reports `minHeight` 522, `minHeightAtWidth` 404 and `naturalHeight` 657. Do not read the minimum from a layout that was drawn taller (`geometry.sizing`): it holds for that frame only. `canDraw` answers a size refusal with the same at-width height when the request has a width.
546
+
547
+ Which value to use for a card:
548
+
549
+ | Value | Meaning | Use it for |
550
+ | --- | --- | --- |
551
+ | `minHeightAtWidth` | The height that draws in full at the width you asked for: every hidden value is named in the note. A pinned height a little below it can still draw, with a note that counts the hidden values instead of naming them; `canDraw` tells you. Lower still, the chart is refused, or drawn compact when the type has a `compactFloor`. | The floor of a dashboard card. |
552
+ | `minHeight` | A height that draws at this width and at `minWidth`. | A floor that must also hold when the card gets narrower. |
553
+ | `naturalHeight` | The height the chart wants at this width: its aspect height for a fill chart, the height of its content for a content chart, and never under `minHeight`. | The target height for a dense chart: many categories, a long footer, an event lane. |
554
+ | `comfortableHeight` | 1.25 × `minHeight`. | Spare room for longer labels. |
555
+
556
+ `size.height` is the height the chart draws at the width you asked for. A spec that pins a height taller than its chart needs (a circle treemap is bound by its width; a bullet panel or a Gantt chart stops at its row height) leaves the rest of the frame empty on render. `measure` does not report that empty part: `size.height` is the least height whose drawing has the same marks and words, and `naturalSize.height` follows it. A chart that grows with the frame, or a spec with no pinned height, keeps its height. Size a host frame from `size.height` and the pinned spec will not leave empty bands.
557
+
558
+ A dense chart grows with its data. Do not give it a fixed small height such as 300 px. Measure at the width of the card slot, use `minHeightAtWidth` as the floor and `naturalHeight` as the target. If the slot cannot be that tall, show a chart with fewer categories or events, or let the card scroll. Do not shrink the chart.
559
+
560
+ Below the floor a render is refused. It draws nothing and returns one error that names the pixels it needs, with a `fix` that sets them.
561
+
562
+ ```sh
563
+ boardplot render - --width 240 <<'EOF'
564
+ { "type": "waterfall", "data": { "items": [{ "id": "fy24", "type": "total", "value": 120 }, { "id": "price", "value": 18 }, { "id": "fy25", "type": "total" }] } }
565
+ EOF
566
+ ```
567
+
568
+ ```json
569
+ {
570
+ "ok": false,
571
+ "errors": [{
572
+ "code": "size-below-floor",
573
+ "path": "/width",
574
+ "suggest": "Pass width 280.",
575
+ "fix": [{ "op": "replace", "path": "/width", "value": 280 }]
576
+ }]
577
+ }
578
+ ```
579
+
580
+ Rendering at 280 pixels or more draws the chart. In React, `size="container"` lays the chart out at the size of its parent element, `fallbackSize` sets the frame for the server output and the first render, and a chart that does not fit its parent shows a placeholder until the parent is wide enough. The measured size is the layout size; Boardplot does not read the host's font size. A fixed-size chart does not grow past its natural width, and `onWarnings` reports a display narrower than its safe minimum.
581
+
582
+ ### Type sizes and floors
583
+
584
+ The target and the width class set the default type sizes. `report` and `dashboard` sizes are layout px; `slide` and `print` sizes are pt. Sources use the footnote size. Secondary text (ticks, axis titles, background series labels) uses the secondary size. The font family, weights and line heights come from the theme.
585
+
586
+ <!-- BEGIN GENERATED TYPE SIZES -->
587
+ <!-- Generated by scripts/generate-reference.mjs from TARGET_TYPE_TABLES in src/core/target.ts. -->
588
+ | Target | Unit | Class | Title | Subtitle | Label | Axis | Secondary | Footnote/source | Micro |
589
+ |---|---|---|---|---|---|---|---|---|---|
590
+ | `dashboard` | px | S | 16 | 13 | 13 | 13 | 13 | 12 | 11 |
591
+ | `dashboard` | px | M | 18 | 13 | 13 | 13 | 13 | 12 | 11 |
592
+ | `dashboard` | px | L | 20 | 14 | 14 | 14 | 14 | 12 | 11 |
593
+ | `report` | px | S | 17 | 13 | 12 | 12 | 11 | 12 | 12 |
594
+ | `report` | px | M | 20 | 14 | 13 | 13 | 12 | 12 | 12 |
595
+ | `report` | px | L | 22 | 15 | 15 | 15 | 13 | 13 | 13 |
596
+ | `slide` | pt | S | 18 | 13 | 13 | 13 | 13 | 10 | 11 |
597
+ | `slide` | pt | M | 20 | 14 | 14 | 14 | 14 | 10 | 11 |
598
+ | `slide` | pt | L | 22 | 14 | 14 | 14 | 14 | 11 | 11 |
599
+ | `print` | pt | S | 14 | 10 | 10 | 10 | 10 | 9 | 9 |
600
+ | `print` | pt | M | 16 | 11 | 11 | 11 | 11 | 9 | 9 |
601
+ | `print` | pt | L | 18 | 11 | 11 | 11 | 11 | 9 | 9 |
602
+
603
+ The engine never fits text below the floor of its target. The floors apply to the size the reader sees, after display scaling.
604
+
605
+ | Target | Unit | Title | Subtitle | Label | Axis | Secondary | Footnote/source | Micro |
606
+ |---|---|---|---|---|---|---|---|---|
607
+ | `dashboard` | px | 14 | 12 | 12 | 12 | 12 | 11 | 11 |
608
+ | `report` | px | 17 | 11 | 11 | 11 | 11 | 11 | 11 |
609
+ | `slide` | pt | 16 | 12 | 12 | 12 | 12 | 8.25 | 11 |
610
+ | `print` | pt | 12 | 10 | 9 | 9 | 9 | 8 | 8 |
611
+ <!-- END GENERATED TYPE SIZES -->
612
+
613
+ Table values and data-bearing chips use the label floor. Table headers use the axis floor. Notes and sources use the footnote floor. Ordinary values never drop to the micro size. Text without a typography role uses the label floor.
614
+
615
+ The KPI hero figure prefers 1.5 × the M title size, rounded in the table unit, and never goes below its minimum. The existing KPI fitting and sibling alignment stay.
616
+
617
+ | Target | Preferred hero with the default M title | Minimum |
618
+ |---|---:|---:|
619
+ | `dashboard` | 27 px | 24 px |
620
+ | `report` | 30 px | 28 px |
621
+ | `slide` | 30 pt | 24 pt |
622
+ | `print` | 24 pt | 16 pt |
623
+
624
+ ## Reading errors and warnings
625
+
626
+ A callout that uses a side other than `preferSide` reports `callout-side-changed` at info level. The warning names the callout and the side used. It does not change placement.
627
+
628
+ `story-text-truncated` reports a story title cut at four lines or a body cut at ten lines. Its severity is `warn`. It names the step id, the line limit and `options.story.steps[index].title` or `.body`. It reports only the chosen panel layout. The suggested fix is to shorten that field or give the panel more width.
629
+
630
+ Every error and warning has one shape:
631
+
632
+ ```sh
633
+ boardplot render - <<'EOF'
634
+ { "type": "column", "data": { "categories": ["2024"], "series": [{ "id": "revenue", "values": [120] }] }, "options": { "labelDensity": "sparse" } }
635
+ EOF
636
+ ```
637
+
638
+ ```json
639
+ {
640
+ "ok": false,
641
+ "errors": [{
642
+ "code": "invalid-options",
643
+ "message": "options.labelDensity: labelDensity accepts one of full, smart, minimal",
644
+ "path": "/options/labelDensity",
645
+ "expected": { "values": ["full", "smart", "minimal"] },
646
+ "received": { "type": "string", "value": "sparse" },
647
+ "docs": "docs/reference/column.md#options",
648
+ "fix": [
649
+ { "op": "test", "path": "/options/labelDensity", "value": "sparse" },
650
+ { "op": "replace", "path": "/options/labelDensity", "value": "smart" }
651
+ ],
652
+ "suggest": "Use one of: \"full\", \"smart\", \"minimal\"."
653
+ }]
654
+ }
655
+ ```
656
+
657
+ - `path` is a JSON Pointer into the spec you sent.
658
+ - `fix` is a JSON Patch. Apply it to that spec as it is, or read `suggest` and change the field yourself. It is absent when the engine has no single repair.
659
+ - `docs` names the reference section that describes the field.
660
+ - Errors come sorted by path, at most ten, then one `more-errors` entry with the count.
661
+
662
+ Column, combo, bar and line charts use locale strings for built-in labels and notes. English mean labels read `Average 27.5`. German mean labels keep `Ø`. Set `options.strings.average` to change that word. Other keys cover status labels, missing-value notes, ranks, ranges and anomaly rules. Each key is listed in the reference. `options.strings` also works through the React theme provider. Authored text stays as written. Unsupported languages use English built-in wording.
663
+
664
+ A partial category is named once, such as `W38 to date`. On combo, column, bar and variance charts, and on a line chart with one line, the words stand under the running value itself where a single value or total prints there and they fit its column; the chart then draws no partial key or axis words. On a time axis (`xAxis.type: "time"`), the words stand under the running value where they have room, else after the end value in the key, else under the reading below the axis, in a row of their own where the tick rows have no room. Otherwise its key comes after the series keys. With no partial key, the chart adds a note. Set `strings.toDate` to change the suffix and `strings.partial` to change a generic partial key. Combo charts hide the default value axis when all column totals are labelled. An explicit `valueAxis.show` still wins. Column and combo category rows try a smaller font before rotation. Combo line end labels stay inside the plot and clear the columns; a moved label has a leader to its point.
665
+
666
+ Warnings have the same shape, arrive in `warnings`, and leave the drawing in place. `label-hidden`, for example, says the solver dropped a label that had no free space; `derived-mismatch` says an authored total differs from the computed one. A label collision that no size resolves refuses the chart with the error `label-collision`, which names each hidden label and what blocks it. More room does not lift it, so React shows it at once. A size refusal, and a hidden-label refusal that more width can clear, waits in a container that is still growing until the size holds still. A value, a series name, a value line or a pinned label that finds no seat is still on the page: the chart names it in a note, "Not labelled on the chart: North 42 (Q3).". The note is a disclosure: it is in the notes list and the `values-in-note` warning, and prints under the plot, also under `footnotes: false`, where `notes.show` lists `'disclosure'`. It is one note per chart. It names as many items as fit two footer lines at the drawn width, at most 8, reference lines and line end values first, then the rest in data order, and ends with a count, "and 236 more". A lone last item is named instead of "and 1 more" when it fits. When not even one name fits, the note only counts, "18 of 36 values". On a pinned height where the two-line note would push values off the plot, the note counts instead. A callout or note annotation that prints a value with `${value}` is that value's label, so the note does not name the value again. When the height is not pinned the chart first tries more height, so labels that can be drawn are drawn; the cap applies to what is left. Every item stays in the reading's `omissions` and in the hover records. `notes.maxListed` sets the number: `'all'` names every item, and `0` names none and only counts them, "18 of 36 values". `strings.moreListed` sets the wording of the count (a React chart with hover on adds "(hover shows each value)" to the default). The info warning `values-in-note` lists every value and name a chart moved into a note, once per chart, so a check of the warnings sees them. A canvas too small to name them all is refused with `size-below-floor` and the height it needs. `unknown-slot` and `pin-blocked` list a label's valid slots and, apart, the ones free now, so a pin can be corrected from the message alone.
667
+
668
+ A chart with nothing to draw (no categories, series, rows or points) is reported with the one code `empty-data`, in the CLI and MCP findings, in the layout error and in React. In React, `onEmpty` is called once, and the chart shows `strings.emptyMessage` of the provider (default "No data to show.") instead of an error. `canDraw(request)` from `boardplot` answers without drawing: `{ ok: true }`, or `{ ok: false, code, minimum? }`, where `code` is `empty-data`, `too-many-items` or `size-below-floor` and `minimum` is the size the chart needs, so a host can hide a card. A table with no rows still draws its header and counts as drawn.
669
+
670
+ A chart whose drawn list holds more than 2,000 entries (the categories of a column, bar, combo, dot, variance, butterfly, funnel, waffle or bartable chart; the rows and columns of a heatmap or status matrix; the rows of a bullet or gantt chart; the items of a pareto, waterfall, likert or treemap chart; the bands of a pyramid; the cohorts of a cohort chart; a likert chart draws at most 500 items, and a mekko chart 20,000 categories) refuses at once with `too-many-items`, at the path of that list. Its layout would take minutes, and no entry would be wider than a pixel. The budget counts what the chart draws: the categories left after `topN` (bar, butterfly, column, mekko, pareto, likert, pyramid), after `viewDomain` and `window.last` on a column or combo, and after a pareto's automatic fold of a crowded tail into Rest. Aggregate the list first, or keep the largest with `topN` where the type takes it. A pie keeps its seven largest slices by default, and a pvm bridge draws aggregate effects, so neither has a budget. A dated line or area samples a long series instead, and tables, scatter, histogram and box plots draw every row.
671
+
672
+ On a canvas the host pinned, a chart of a type with a compact floor (bar, bartable, box, butterfly, cohort, column, combo, dot, funnel, gantt, heatmap, histogram, likert, line, pareto, pvm, pyramid, scatter, variance, waffle, waterfall) that lacks room in full mode is drawn compact, and refused only when compact does not fit either; the refusal names the size compact needs. `belowMinimum: 'refuse'` keeps the full-mode refusal. A chart with no size, or a width alone, grows to its full floor instead.
673
+
674
+ React reader cards reserve the chart frame. Loading and reader frames scale with the host, as the SVG does; `fixedSize` keeps their intrinsic size. A cold content-sized chart estimates its height from the data row count and row pitch plus fixed space for the chart frame. Pass `prepared` for the exact loading height, including measured text and automatic content height. The message sits in the centre and uses the chart theme. Valid full theme objects keep their tokens even when the spec is invalid. Invalid themes use the default theme. The card keeps a supplied title and source. A long host message shows at most three lines; its `title` attribute keeps the full text. The reader body and host refusal content load when needed. The server and first browser pass use a minimal busy frame with the title and source. This frame inherits host typography and paint; theme resolution and theme tokens load with the reader body. It keeps findings in `data-bp-diagnostics`; individual code and path markers load with the reader body. Developer details load only in full mode.
675
+
676
+ Set `diagnostics` on `BoardplotTheme` to `auto`, `full` or `reader`. The default is `auto`: it selects `full` when `process.env.NODE_ENV` is not `production`, and `reader` in production. The check also works when `process` is absent. An explicit mode wins. Nested providers inherit the mode unless they override it.
677
+
678
+ In `reader` mode, size, empty and invalid-spec cards use `role="status"`. They show no paths, codes, minimum pixels, schema values or fix patches. Diagnostics remain in `data-bp-diagnostics`, with codes and paths in `data-bp-error-code` and `data-bp-error-path`. The browser logs diagnostics once per card mount; invalid specs use `console.error`, size refusals use `console.warn`. Each record starts with one line of text, such as `Boardplot refused: size-below-floor: …`, with the code, the path and the message of every finding, and then passes the findings. Server rendering does not log them. These attributes and console records are developer access, not a data security boundary.
679
+
680
+ In `full` mode, a closed native `Details` disclosure sits below the reader message. Invalid specs use `role="alert"`. Equal errors are grouped by code and suggestion, with a count. Paths, values and fix patches use monospace. Raw schemas stay in a second closed disclosure.
681
+
682
+ Provider strings `refusalMessage`, `refusalHint`, `emptyMessage`, `emptyHint`, `failureMessage`, `failureHint` and `diagnosticDetails` set the wording. English and German defaults are available. These keys belong to the React provider, not `options.strings`. Legacy `{width}` and `{height}` templates appear only in full diagnostics. The reader heading uses plain default wording when such a template is supplied. `onRefused`, `onEmpty` and `renderRefused` keep their existing host contracts.
683
+
684
+ In code, `refused` on a layout from `layoutResolvedRequest` marks a size refusal only. A layout whose own lints carry severity `error` is refused too: render answers it with those errors and the components draw the error card. `isRefused(layout)` from `boardplot` is true in both cases; `measure` reports both in `refused`, without `geometry`. The second argument of `measure(request, context)` takes only `theme`, `locale` and `strings`; any other key is ignored with the warning `unknown-context-key`, and a width or height belongs in `options.size`.
685
+
686
+ ### Design advice
687
+
688
+ Bar, line and waterfall have a design card: what the chart says, when to use it and when not, and four to eight rules. `boardplot_describe` prints the message, the use, the not-when and the first two rules; `path: "design"` (CLI: `boardplot describe bar --path design`) prints every rule. Each rule is marked `engine` or `describe`. Render checks the `engine` rules on the drawn chart and returns each finding as a warning with severity `advice`, a code that starts with `design-`, one sentence and a `docs` link to the rule. A `fix` patch is included only when it can apply to the input as sent. Otherwise follow `suggest`; for example, a waterfall built from rows gets written advice when a patch would target generated items. Advice never changes the drawing and never refuses. A render returns at most three, the MCP server returns each code once per session, and a refused render returns none. The `describe` rules need the author's judgment, such as the business order of a bridge.
689
+
690
+ ## Named reference bands on a line
691
+
692
+ Use `options.referenceBands` on a line when the reader judges one long series against a few fixed regimes, such as the strong, typical and down cycles of a growth rate. Each band is one level (`value`) or a range (`low`, `high`) in the value-axis units, drawn thin and neutral behind the line. Its bold `label` and plain `description` stand in a column right of the plot, and an elbow leader ties a name to its band where the names had to spread apart. For the number at a point, a callout with `"headline": "${value}"` prints the value from the data in bold over its text, and `"arrow": true` points at the point.
693
+
694
+ ```json
695
+ {
696
+ "type": "line",
697
+ "data": {
698
+ "categories": ["2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026"],
699
+ "series": [{ "id": "growth", "label": "Sensor-module sales growth", "values": [-11, 7, 26, 3, -8, 19, 45, 52] }]
700
+ },
701
+ "options": {
702
+ "title": "Sensor-module growth left the typical cycle in 2025",
703
+ "subtitle": { "measure": "Year-over-year sensor-module sales growth" },
704
+ "unit": "%",
705
+ "referenceBands": [
706
+ { "value": 45, "label": "45+", "description": "strong cycle" },
707
+ { "low": 20, "high": 25, "label": "20 to 25", "description": "typical cycle" },
708
+ { "low": -10, "high": -5, "label": "−5 to −10", "description": "modest down cycle" }
709
+ ]
710
+ }
711
+ }
712
+ ```
713
+
714
+ Common mistakes:
715
+
716
+ - Overlapping bands. Two bands that share a span leave a value in it with two names; the render warns `reference-band-overlap`.
717
+ - Too many bands. Three or four read; more than six is refused, because the reader stops matching names to bands.
718
+ - A label that repeats the axis. "45" alone says what the tick already says; the description says what the level means ("strong cycle"). A band named only by numbers warns `reference-band-unexplained`.
719
+ - A plan corridor or a target drawn as a reference band. Those are a `band` annotation with `style: "corridor"` or a `valueLine`, which print their bounds.
720
+
721
+ The line reference has the full recipe under "Cycle bands", and the fixture `cycle-bands` draws 583 monthly points this way.
722
+
723
+ For a `valueLine` with `value: "mean"`, `seriesId` selects the series. A paired `from` and `to` selects the inclusive category window. The mean line spans only that window. Adjacent shaded `band` annotations have a hairline between them, so each period remains distinct.
724
+
725
+ ## Times and numbers on the x axis of a line
726
+
727
+ A line or area draws `data.categories` as evenly spaced names by default. For readings at real times, or along a measured distance, give `data.x` and `options.xAxis` instead. The chart then places each reading by its value, so 7 minutes and 55 minutes keep their spacing, and it draws its own ticks: 1, 5, 15 and 30 minutes up to hours, days, weeks, months, quarters and years for times, and 1-2-5 steps for numbers. `series[].values` give one value per x, in the order of `data.x`, with `null` for a missing reading.
728
+
729
+ ```json
730
+ {
731
+ "type": "line",
732
+ "data": {
733
+ "x": ["2026-10-25T01:00", "2026-10-25T02:30", "2026-10-25T02:30", "2026-10-25T03:10", "2026-10-25T05:00"],
734
+ "series": [{ "id": "hall", "label": "Hall", "values": [20.4, 20.1, 19.9, 19.8, 20.6] }]
735
+ },
736
+ "options": {
737
+ "title": "The hall cooled through the extra hour",
738
+ "unit": "°C",
739
+ "xAxis": { "type": "time", "zone": "Europe/Berlin" }
740
+ }
741
+ }
742
+ ```
743
+
744
+ - `type` is `"time"` or `"number"`. A time is an ISO date-time; without an offset it is a wall time in `zone` (an IANA name, default `"UTC"`). A time with an offset, such as `Z` or `+01:00`, names its instant, and `zone` sets only the labels.
745
+ - When the clocks go back, a wall time occurs twice. The second reading of a repeated time counts as the later instant only when the order of the readings proves it, as above. Otherwise the render refuses `x-time-ambiguous`; give the offset. A wall time the change skips refuses `x-time-skipped`. The chart notes the zone and its offsets under it.
746
+ - `min` and `max` set the range. `tickStep` (`{ "unit": "hour", "step": 6 }`, or a number) or `ticks` (values, or `{ "value", "label" }`) set the ticks; `maxTicks` caps the automatic ones. `format` takes a time pattern such as `"HH:mm"` or a number example such as `"1.5"`. `title` and, on a number axis, `unit` name the axis.
747
+ - Automatic ticks never use hours for readings that all sit at midnight in `zone`. Whole-month readings start at month ticks, and whole-year readings start at year ticks. Crowded ticks use coarser steps. This also applies to zoom views and buckets. Authored `tickStep` or `ticks` wins.
748
+ - Events and bands stand at any x. A value line, a delta, a callout or a target names the x of a reading. A trend fits on elapsed time and prints its slope per second, minute, hour, day or week, or per `unit` on a number axis.
749
+ - On a time axis, `data.x` and every annotation x anchor accept epoch milliseconds. This includes `at`, `from`, `to`, object `categoryId`, and event `date` and `end`. An epoch value names an instant; the zone sets its labels. For example, `1772496000000` is `2026-03-03T00:00:00Z`. A numeric `delta.vs` stays a comparison value. Use `vs: { categoryId: 1772496000000 }` to compare with that reading.
750
+ - A `cagr` annotation on a time axis draws the same bracket and label as on a category axis. Its `from` and `to` name the x of two readings (default: the first and the last). The rate counts the exact years between the two readings on the calendar of `zone`: the whole years to the last anniversary, plus the rest as a share of the year after it, in milliseconds. So 1 January 2020 to 1 January 2025 is 5 years, and 1 January to 2 July 12:00 of 2025 is 0.5. An anniversary keeps the start's wall time, and 29 February falls on 28 February in a common year. A start value at or below zero omits the rate and warns `cagr-undefined`, as on a category axis. A number axis has no years, so a CAGR there warns `x-cagr-unsupported` and is not drawn.
751
+ - Not with `variant: "bump"` or `categoryAxis`.
752
+
753
+ The fixtures `x-time-daily`, `x-time-berlin-dst`, `x-time-uneven-sensors` and `x-number-trail` show the forms.
754
+
755
+ ## Themes
756
+
757
+ A theme sets colours, type sizes, spacing and the scenario patterns. The presets are `boardroom` (the default), `standard`, `standard-dark`, `notation`, `notation-dark`, `capital`, `studio` and `glass`.
758
+
759
+ The `notation` preset follows the IBCS® Standards; IBCS is a registered trademark of the IBCS Institute, and the standards are published under CC BY-SA 4.0 at [www.ibcs.com](https://www.ibcs.com).
760
+
761
+ A brand theme is a preset plus overrides:
762
+
763
+ ```json
764
+ {
765
+ "type": "column",
766
+ "data": { "categories": ["2024", "2025"], "series": [{ "id": "revenue", "values": [120, 135] }] },
767
+ "theme": { "preset": "standard", "overrides": { "color": { "highlight": "#0B5CAD", "series": ["#0B5CAD", "#5B8DB8", "#A9C1D9"] } } }
768
+ }
769
+ ```
770
+
771
+ The target replaces the type sizes of a preset; a size that `overrides` names still wins. A full theme registered under its own `name` keeps its sizes; `typeForTarget(theme.type, target)` from `boardplot/theme` rebuilds them for a target and keeps families, weights and line heights.
772
+
773
+ A theme key that Boardplot removed is refused with `invalid-theme-override` or `invalid-theme`, a suggest and a patch that removes it. `type.eyebrow.case` is removed: KPI eyebrows and waffle panel labels print names as written, so write capitals in the name to keep them. If the theme widened `type.eyebrow.tracking` for capitals, set `type.eyebrow.tracking` back or remove it. Absent means no letter-spacing, and a name in mixed case reads too wide with capital tracking.
774
+
775
+ An override can give `color.series` one or two colours. These colours come first. The remaining slots come from the preset, with colours that repeat an authored colour skipped. An override with three or more colours keeps its own ramp and overflow policy. A full theme needs at least three colours.
776
+
777
+ ### Design system colours
778
+
779
+ Colour fields accept hex, the supported colour keywords, `rgb()` / `rgba()`, `hsl()` / `hsla()` and `oklch()`. For example, `oklch(65% 0.15 270)` becomes `#6c88ea`. Space-separated functions accept `/ alpha`, as in `hsl(210 50% 40% / 50%)`. Hue accepts degrees, `deg`, `grad`, `rad` and `turn`. OKLCH lightness accepts a number or percent; 100% chroma means 0.4. Missing components (`none`) become zero. Relative colours, `calc()`, `color-mix()` and other colour spaces are not supported. Use their computed literal colour instead.
780
+
781
+ Boardplot converts new colour forms to 8-bit sRGB before drawing. It clips each linear RGB channel to 0–1, applies the sRGB transfer function, then rounds each channel to the nearest byte. Alpha is kept. This is a fixed channel clip, so a colour outside sRGB can differ from a browser's gamut mapping. Contrast checks use the same bytes that the SVG draws. Existing hex and comma-separated RGB spellings keep their output bytes.
782
+
783
+ `var(--brand, #1f4e79)` is accepted with a required colour fallback. **Boardplot always draws the fallback.** It does not read the page variable, and it warns `css-var-fallback-used` once per variable: the warning names the variable, the colour it painted and the repair below. The fallback can itself be `oklch()` or `hsl()`. Bare `var(--brand)`, `currentColor` and an invalid fallback are refused with a fix. This rule is the same in React, SVG, PNG, CLI and MCP. It prevents a page variable from changing the fill while the label keeps ink chosen for another fill.
784
+
785
+ When the page changes a variable later, the chart does not change. For a page theme switch, pass new literal token values in the same update as the preset:
786
+
787
+ ```tsx
788
+ import { BoardplotTheme } from 'boardplot/react/theme';
789
+ import { ColumnChart } from 'boardplot/react/column';
790
+
791
+ export function BrandChart({ dark = false }) {
792
+ const theme = {
793
+ preset: dark ? 'standard-dark' : 'boardroom',
794
+ overrides: { color: { series: [dark ? '#8cbcff' : '#1f4e79'] } },
795
+ };
796
+ return <BoardplotTheme theme={theme}>
797
+ <ColumnChart data={{ categories: [{ id: 'a' }], series: [{ id: 'core', values: [42] }] }} />
798
+ </BoardplotTheme>;
799
+ }
800
+ ```
801
+
802
+ Keep shared design tokens in application data when possible. If CSS owns the tokens, read `getComputedStyle(element).getPropertyValue('--brand').trim()` after the page has applied its theme. Pass that literal value as the override and repeat the read on each page theme switch. Choose the element that contains the chart, since variables can differ by page section. The host owns this update. Boardplot adds no DOM observer and reads no page state during server rendering.
803
+
804
+ ### Stable series colours
805
+
806
+ Assign `colorRole` from one map keyed by series id before filtering or rendering. Use the same map for every chart and export. A `series-N` role always selects step N of `color.series`, with N starting at 1. It does not select a step of `options.palette`. An explicit `fill` still wins over `colorRole`.
807
+
808
+ ```ts
809
+ const series = [{ id: 'core', values: [42] }, { id: 'extra', values: [18] }];
810
+ const selectedIds = new Set(['extra']);
811
+ const roleById = { core: 'series-1', extra: 'series-3', other: 'others' } as const;
812
+ const colouredSeries = series.map(s => ({
813
+ ...s,
814
+ colorRole: roleById[s.id as keyof typeof roleById],
815
+ }));
816
+ const visibleSeries = colouredSeries.filter(s => selectedIds.has(s.id));
817
+ ```
818
+
819
+ Map every id whose colour must stay fixed. Unmapped series keep the automatic order-based colours. The map is application data; no provider state or new Boardplot option is needed. Roles follow the active theme, so a light-to-dark theme change keeps the series' rank while the theme chooses its colour. Use a shared map to `fill` instead when each id must keep an exact literal colour, and check that colour on both page themes.
820
+
821
+ If the ramp runs out, Boardplot keeps its repeat policy and warns. `series-colour-repeated` names each group that shares a colour. `series-indistinguishable` names keys with the same colour and shape. Group the tail into an “Other” series only when the values add. Otherwise use small multiples, or supply more distinct colours and assign them with `colorRole` or `fill`. Changing `seriesOverflow` to `cycle` still repeats colours. Boardroom's eight colours and their order stay unchanged.
822
+
823
+ Render checks colour roles present in the chart layout. `validateTheme(theme)` from `boardplot/validate` checks the full theme. Colour findings name the measured colours, vision mode and floor; contrast ratios round down to two decimals.
824
+
825
+ A full token object with its own `name` works too. `boardplot_describe` with type `theme` lists every token with its type and default.
826
+
827
+ In code, `registerTheme` makes a full token object available under its `name` to every chart, and `resolveTheme` returns a theme resolved and frozen, from a name or from `{ preset, overrides }`. Import both from `boardplot/theme`: it links no chart engine. The package root exports them too, but it registers the whole catalogue, so a host that draws through `boardplot/react/<type>` would carry every engine in its main bundle.
828
+
829
+ Layout measures text with bundled width tables for Geist, Helvetica and Arial, taking the first family of the stack that has one. Helvetica Neue is measured with the Helvetica widths (Liberation Sans), because no free Helvetica Neue font exists; for exact Helvetica Neue widths, build tables with `boardplot fonts build` ([FONTS.md](FONTS.md)). Inter has no table: the capital and glass presets lead with Inter and are measured as Helvetica Neue, the next family in their stack, so on a machine with Inter installed their text draws a little wider than measured. A leading family outside these, Inter and the metric clones Arimo, Liberation Sans and Nimbus Sans returns the warning `family-outside-metric-class`, a licensed brand font included; `boardplot fonts build <font-dir>` writes the tables for a licensed font ([FONTS.md](FONTS.md)). Boardplot rejects a theme for low contrast (`contrast-ink` below 4.5:1, `contrast-ink-muted` below 3:1), an unsupported colour (`unparseable-color`; see [Design system colours](#design-system-colours)), good and bad colours that look alike (`good-bad-similar`) or an unknown token (`invalid-theme`). These errors carry the path `/theme`.
830
+
831
+ ## Where the reference is
832
+
833
+ - [reference/&lt;type&gt;.md](reference/waterfall.md): one page per chart type with use cases, chart IDs, minimal spec, data, options, annotations, sizing and fixtures.
834
+ - [reference/options.md](reference/options.md): the options every type shares, the value cell and annotation anchors.
835
+ - [reference/theme.md](reference/theme.md): presets, every token and the theme errors.
836
+ - [reference/react.md](reference/react.md): `BoardplotChart`, the per-type components, container sizing, server preparation and export.
837
+ - [reference/fixtures.md](reference/fixtures.md): every fixture by type.
838
+ - [FONTS.md](FONTS.md): width tables for a licensed font.