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
@@ -0,0 +1,1359 @@
1
+ import {
2
+ isIconName,
3
+ listIcons
4
+ } from "./chunk-BUPLB3EX.js";
5
+ import {
6
+ ownedDocumentCopy
7
+ } from "./chunk-BW5VLBSZ.js";
8
+ import {
9
+ parseTimeText
10
+ } from "./chunk-GDOW2KNP.js";
11
+ import {
12
+ isRecord
13
+ } from "./chunk-76ANFJOI.js";
14
+ import {
15
+ levenshtein
16
+ } from "./chunk-FIANWJXX.js";
17
+ import {
18
+ LEGEND_DRAWS,
19
+ LEGEND_REFUSED,
20
+ OPTION_CAPABILITY,
21
+ SIDE_KEY_REFUSED,
22
+ legendDrawsNothing,
23
+ valueAxisOnly,
24
+ valueAxisRefusal
25
+ } from "./chunk-DCCJRLAJ.js";
26
+ import {
27
+ formatExampleProblem,
28
+ parseFormatExample,
29
+ parseISODate,
30
+ specUnitKind
31
+ } from "./chunk-ASAON7G4.js";
32
+ import {
33
+ MAGNITUDE_CEILING,
34
+ NormalizeError,
35
+ SIZE_PRESETS,
36
+ TEXT_SCALE_RANGE,
37
+ TEXT_SIZE_RANGE,
38
+ canonicalLanguage,
39
+ magnitudeMessage,
40
+ resolveCanvasOptions,
41
+ resolveSize,
42
+ toLayoutPx
43
+ } from "./chunk-SGD3ZHID.js";
44
+ import {
45
+ maxOf,
46
+ pushAll
47
+ } from "./chunk-WYJEOMNY.js";
48
+
49
+ // src/core/schema/categoryLabels.ts
50
+ import * as z from "zod";
51
+ var categoryLabelsSchema = z.enum(["axis", "staircase"]).optional().describe(
52
+ "Where category names go: 'axis' (default), the row under the axis; 'staircase', each name over the lower columns beside its own, one step lower than the last, with a vertical leader to its column (column, combo, pareto). Without a seat for every name the row returns and staircase-labels-fallback warns."
53
+ );
54
+
55
+ // src/core/doc/docExpand.ts
56
+ import * as z2 from "zod";
57
+ var STANDARD_OBJECT_PROTOTYPE_MEMBERS = /* @__PURE__ */ new Set([
58
+ "constructor",
59
+ "hasOwnProperty",
60
+ "isPrototypeOf",
61
+ "propertyIsEnumerable",
62
+ "toLocaleString",
63
+ "toString",
64
+ "valueOf",
65
+ "__proto__",
66
+ "__defineGetter__",
67
+ "__defineSetter__",
68
+ "__lookupGetter__",
69
+ "__lookupSetter__"
70
+ ]);
71
+ function sanitizeObjectPrototype(warn) {
72
+ for (let name of Object.getOwnPropertyNames(Object.prototype)) {
73
+ if (STANDARD_OBJECT_PROTOTYPE_MEMBERS.has(name)) continue;
74
+ Object.getOwnPropertyDescriptor(Object.prototype, name)?.configurable ? delete Object.prototype[name] : warn(
75
+ `the JavaScript environment defines a non-removable property '${name}' on Object.prototype \u2014 results may be affected; run in a clean Node process`
76
+ );
77
+ }
78
+ }
79
+ var repeatSpecSchema = z2.strictObject({
80
+ dimension: z2.string().regex(/^[A-Za-z_][A-Za-z0-9_-]*$/).describe("Placeholder name; use it as $dimension in chart name, title, and subtitle strings."),
81
+ values: z2.array(z2.string().min(1).describe("Facet value bound to the placeholder and used to look up a data.bySlice entry.")).min(1).describe("Ordered facet values to bind and expand.")
82
+ }).describe("Chart-level repeat declaration expanded before chart validation.");
83
+ function missingChartName(issue) {
84
+ return issue.input === void 0 ? "chart name is missing; every chart in charts needs a name, unique in the document" : void 0;
85
+ }
86
+ var repeatChartSchema = z2.object({
87
+ name: z2.string({ error: missingChartName }).min(1).describe("Chart name template; without $dimension, expanded names are <name>-<value>."),
88
+ type: z2.string().min(1).describe("Registered chart type repeated for every facet value."),
89
+ repeat: repeatSpecSchema,
90
+ data: z2.strictObject({
91
+ bySlice: z2.record(z2.string(), z2.unknown().describe("Chart data for this facet; the selected chart schema validates it after expansion.")).describe("Exact slice lookup; every repeat value must have one chart-data entry.")
92
+ }).describe("Facet data keyed by repeat value."),
93
+ options: z2.record(z2.string(), z2.unknown().describe("Chart option value, validated by the selected chart schema after expansion.")).optional().describe("Chart options; title and subtitle strings may contain the dimension placeholder."),
94
+ annotations: z2.array(z2.unknown().describe("Annotation copied to each expanded chart; chart validation and annotation resolution check its shape and anchors.")).optional().describe("Shared annotations attached to each expanded chart.")
95
+ }).superRefine((chart, ctx) => {
96
+ let seen = /* @__PURE__ */ new Set();
97
+ chart.repeat.values.forEach((value, index) => {
98
+ seen.has(value) && ctx.addIssue({
99
+ code: "custom",
100
+ path: ["repeat", "values", index],
101
+ message: `duplicate repeat value '${value}'`
102
+ }), seen.add(value), Object.hasOwn(chart.data.bySlice, value) || ctx.addIssue({
103
+ code: "custom",
104
+ path: ["data", "bySlice", value],
105
+ message: `missing data slice for repeat value '${value}'`
106
+ });
107
+ });
108
+ }).describe("Chart specification expanded once per repeat value before validation, rendering, and manifests."), DocExpansionError = class extends Error {
109
+ constructor(issues) {
110
+ super(
111
+ `document schema errors:
112
+ ${issues.map((issue) => ` ${issue.path.join(".") || "(root)"}: ${issue.message}`).join(`
113
+ `)}`
114
+ );
115
+ this.issues = issues;
116
+ this.name = "DocExpansionError";
117
+ }
118
+ issues;
119
+ };
120
+ function expandDoc(input) {
121
+ if (!isRecord(input) || !Array.isArray(input.charts)) return { doc: input, warnings: [], sources: [] };
122
+ let entries = [], outputCharts = [], sources = [], repeats = [], issues = [];
123
+ if (input.charts.forEach((rawChart, sourceIndex) => {
124
+ if (!isRecord(rawChart) || !Object.hasOwn(rawChart, "repeat") || rawChart.repeat === void 0) {
125
+ let copied = ownedDocumentCopy(rawChart);
126
+ outputCharts.push(copied), sources.push({ index: sourceIndex }), isExpandedChart(copied) && entries.push({ chart: copied, index: outputCharts.length - 1 });
127
+ return;
128
+ }
129
+ let parsed = repeatChartSchema.safeParse(rawChart);
130
+ if (!parsed.success) {
131
+ pushAll(issues, parsed.error.issues.map((issue) => ({
132
+ path: [
133
+ "charts",
134
+ sourceIndex,
135
+ ...issue.path.map((segment) => typeof segment == "symbol" ? String(segment) : segment)
136
+ ],
137
+ message: issue.message
138
+ })));
139
+ return;
140
+ }
141
+ let chart = parsed.data;
142
+ repeats.push(chart);
143
+ let origin = `repeat:${sourceIndex}:${chart.repeat.dimension}`;
144
+ for (let value of chart.repeat.values) {
145
+ let expanded = expandRepeatChart(chart, value);
146
+ entries.push({
147
+ chart: expanded,
148
+ index: outputCharts.length,
149
+ repeatOrigin: origin,
150
+ repeatLabel: `repeat chart '${chart.name}' over '${chart.repeat.dimension}'`
151
+ }), outputCharts.push(expanded), sources.push({ index: sourceIndex, slice: value });
152
+ }
153
+ }), issues.length > 0) throw new DocExpansionError(issues);
154
+ return {
155
+ doc: { ...input, charts: outputCharts },
156
+ sources,
157
+ warnings: [
158
+ ...lintRepeatValues(repeats),
159
+ ...lintPaletteDrift(entries),
160
+ ...lintScaleDrift(entries)
161
+ ]
162
+ };
163
+ }
164
+ function expandRepeatChart(chart, value) {
165
+ let placeholder = `$${chart.repeat.dimension}`, substitutedName = substituteString(chart.name, placeholder, value), name = chart.name.includes(placeholder) ? substitutedName : `${substitutedName}-${value}`, options = chart.options ? ownedDocumentCopy(chart.options) : void 0;
166
+ return options && typeof options.title == "string" && (options.title = substituteString(options.title, placeholder, value)), options && options.subtitle !== void 0 && (options.subtitle = substituteStrings(options.subtitle, placeholder, value)), Object.assign(/* @__PURE__ */ Object.create(null), {
167
+ name,
168
+ type: chart.type,
169
+ data: ownedDocumentCopy(chart.data.bySlice[value]),
170
+ ...options ? { options } : {},
171
+ ...chart.annotations ? { annotations: ownedDocumentCopy(chart.annotations) } : {}
172
+ });
173
+ }
174
+ function lintRepeatValues(repeats) {
175
+ let byDimension = /* @__PURE__ */ new Map();
176
+ for (let chart of repeats) {
177
+ let group = byDimension.get(chart.repeat.dimension) ?? [];
178
+ group.push(chart), byDimension.set(chart.repeat.dimension, group);
179
+ }
180
+ let warnings = [];
181
+ for (let [dimension, charts] of byDimension)
182
+ charts.length < 2 || new Set(charts.map((chart) => JSON.stringify(chart.repeat.values))).size < 2 || warnings.push({
183
+ code: "facet-values-drift",
184
+ severity: "warn",
185
+ message: `repeat charts ${quoteList(charts.map((chart) => chart.name))} use different ordered values for dimension '${dimension}'; align the lists or call out the missing facet explicitly`
186
+ });
187
+ return warnings;
188
+ }
189
+ function lintPaletteDrift(entries) {
190
+ let byPalette = /* @__PURE__ */ new Map();
191
+ for (let entry of entries) {
192
+ let palette = entry.chart.options?.palette;
193
+ if (typeof palette != "string") continue;
194
+ let group = byPalette.get(palette) ?? [];
195
+ group.push(entry), byPalette.set(palette, group);
196
+ }
197
+ let warnings = [];
198
+ for (let [palette, charts] of byPalette)
199
+ for (let left = 0; left < charts.length; left++) {
200
+ let a = charts[left], aSlots = paletteSlots(a.chart.data);
201
+ if (aSlots.size !== 0)
202
+ for (let right = left + 1; right < charts.length; right++) {
203
+ let b = charts[right], bSlots = paletteSlots(b.chart.data), drifted = [...aSlots].flatMap(
204
+ ([seriesId, slot]) => bSlots.has(seriesId) && bSlots.get(seriesId) !== slot ? [seriesId] : []
205
+ );
206
+ drifted.length !== 0 && warnings.push({
207
+ code: "facet-palette-drift",
208
+ severity: "warn",
209
+ message: `charts '${a.chart.name}' and '${b.chart.name}' assign shared palette '${palette}' to series ${quoteList(drifted)} at different positions; keep series order consistent or set explicit color roles`
210
+ });
211
+ }
212
+ }
213
+ return warnings;
214
+ }
215
+ function paletteSlots(data) {
216
+ if (!isRecord(data) || !Array.isArray(data.series)) return /* @__PURE__ */ new Map();
217
+ let slots = /* @__PURE__ */ new Map(), slot = 0;
218
+ for (let rawSeries of data.series)
219
+ !isRecord(rawSeries) || rawSeries.role === "reference" || (typeof rawSeries.id == "string" && rawSeries.fill === void 0 && rawSeries.colorRole === void 0 && rawSeries.scenario === void 0 && slots.set(rawSeries.id, slot), slot++);
220
+ return slots;
221
+ }
222
+ function lintScaleDrift(entries) {
223
+ let groups = /* @__PURE__ */ new Map();
224
+ for (let entry of entries) {
225
+ entry.repeatOrigin && addScaleGroup(groups, entry.repeatOrigin, entry.repeatLabel ?? entry.repeatOrigin, entry);
226
+ let scaleGroup = entry.chart.options?.scaleGroup;
227
+ isRecord(scaleGroup) && typeof scaleGroup.y == "string" && addScaleGroup(groups, `scale:${scaleGroup.y}`, `y scale group '${scaleGroup.y}'`, entry);
228
+ }
229
+ let warnings = [], warnedPairs = /* @__PURE__ */ new Set();
230
+ for (let group of groups.values())
231
+ for (let left = 0; left < group.entries.length; left++) {
232
+ let a = group.entries[left], aMagnitude = domainMagnitude(a.chart);
233
+ if (aMagnitude !== null)
234
+ for (let right = left + 1; right < group.entries.length; right++) {
235
+ let b = group.entries[right], bMagnitude = domainMagnitude(b.chart);
236
+ if (bMagnitude === null) continue;
237
+ let ratio = scaleRatio(aMagnitude, bMagnitude);
238
+ if (!(ratio > 20)) continue;
239
+ let pair = [a.index, b.index].sort((x, y) => x - y).join(":");
240
+ if (warnedPairs.has(pair)) continue;
241
+ warnedPairs.add(pair);
242
+ let ratioText = Number.isFinite(ratio) ? `${roundRatio(ratio)}x` : "more than 20x", message = `charts '${a.chart.name}' and '${b.chart.name}' in ${group.label} have value domains that differ by ${ratioText}; use shared axis bounds or add an explicit callout so the scale difference cannot mislead`;
243
+ warnings.push({
244
+ code: "facet-scale-drift",
245
+ severity: "warn",
246
+ message,
247
+ suggest: "Use shared value-axis bounds or an explicit scale callout."
248
+ });
249
+ }
250
+ }
251
+ return warnings;
252
+ }
253
+ function addScaleGroup(groups, key, label, entry) {
254
+ let group = groups.get(key) ?? { label, entries: [] };
255
+ group.entries.push(entry), groups.set(key, group);
256
+ }
257
+ function domainMagnitude(chart) {
258
+ let values = yValues(chart.type, chart.data);
259
+ return values.length === 0 ? null : maxOf(values.map((value) => Math.abs(value)));
260
+ }
261
+ function yValues(type, data) {
262
+ return isRecord(data) ? Array.isArray(data.series) ? data.series.flatMap((series) => !isRecord(series) || series.role === "reference" || !Array.isArray(series.values) ? [] : series.values.flatMap(numericCell)) : (type === "scatter" || type === "bubble") && Array.isArray(data.points) ? data.points.flatMap((point) => isRecord(point) ? numericCell(point.y) : []) : type === "waterfall" || type === "bridge" ? waterfallDomainValues(data) : Array.isArray(data.rows) ? data.rows.flatMap((row) => isRecord(row) ? numericCell(row.value) : []) : type === "kpi" ? [
263
+ ...numericCell(data.value),
264
+ ...isRecord(data.spark) && Array.isArray(data.spark.values) ? data.spark.values.flatMap(numericCell) : []
265
+ ] : [] : [];
266
+ }
267
+ function waterfallDomainValues(data) {
268
+ if (!Array.isArray(data.items)) return [];
269
+ let values = [0], running = 0;
270
+ for (let item of data.items) {
271
+ if (!isRecord(item)) continue;
272
+ let segments = Array.isArray(item.segments) ? item.segments.flatMap((segment) => isRecord(segment) ? numericCell(segment.value) : []) : [], authored = numericCell(item.value), delta = segments.length > 0 ? segments.reduce((sum, value) => sum + value, 0) : authored[0];
273
+ item.type === "subtotal" || item.type === "total" ? values.push(running) : delta !== void 0 && (running += delta, values.push(running));
274
+ }
275
+ return values;
276
+ }
277
+ function numericCell(value) {
278
+ return typeof value == "number" && Number.isFinite(value) ? [value] : isRecord(value) ? typeof value.number == "number" && Number.isFinite(value.number) ? [value.number] : typeof value.pct == "number" && Number.isFinite(value.pct) ? [value.pct] : "value" in value ? numericCell(value.value) : [] : [];
279
+ }
280
+ function scaleRatio(a, b) {
281
+ let smaller = Math.min(a, b), larger = Math.max(a, b);
282
+ return smaller === 0 ? larger === 0 ? 1 : Number.POSITIVE_INFINITY : larger / smaller;
283
+ }
284
+ function roundRatio(value) {
285
+ return Math.round(value * 10) / 10;
286
+ }
287
+ function substituteString(value, placeholder, replacement) {
288
+ return value.split(placeholder).join(replacement);
289
+ }
290
+ function substituteStrings(value, placeholder, replacement) {
291
+ return typeof value == "string" ? substituteString(value, placeholder, replacement) : Array.isArray(value) ? value.map((item) => substituteStrings(item, placeholder, replacement)) : isRecord(value) ? Object.fromEntries(
292
+ Object.entries(value).map(([key, item]) => [key, substituteStrings(item, placeholder, replacement)])
293
+ ) : value;
294
+ }
295
+ function quoteList(values) {
296
+ return values.map((value) => `'${value}'`).join(", ");
297
+ }
298
+ function isExpandedChart(value) {
299
+ return isRecord(value) && typeof value.name == "string" && typeof value.type == "string" && "data" in value;
300
+ }
301
+
302
+ // src/core/schema/capabilityReasons.ts
303
+ var OPTION_REASONS = {
304
+ animate: "no chart type implements 'animate' \u2014 this library emits static, deterministic SVG; use 'interactive: true' for data-bp-* hover/focus semantics, or animate the emitted SVG downstream",
305
+ debug: "no chart type implements 'debug'; drop the key. The CLI refuses '--debug' as not supported in v1",
306
+ rowLabels: "only the horizontal row-label families read rowLabels (bar, bullet, box, dot, likert). A vertical category axis prints its labels under the bands, where they already share one baseline and there is nothing to align",
307
+ categoryAxis: "only 'line' accepts categoryAxis; crossesBetween selects bands or points and dateTicks picks a calendar interval for the tick labels. Banded category types cross between bands by construction",
308
+ categoryLabels: "staircase category names sit in the free space over columns sorted by height, and only the vertical column family reads categoryLabels (column, combo, pareto). A horizontal bar prints each name beside its row already; a waterfall or variance keeps its bridge order and its delta labels in that space; histogram bins and mekko widths have no free triangle over sorted columns",
309
+ secondaryAxis: "only 'combo' and 'box' have a second value scale to acknowledge; a single-scale chart has no second axis, so declaring one acknowledges nothing",
310
+ labels: "this type never consults the per-kind label toggle map. On waterfall/pvm use labelDensity ('minimal' keeps totals and endpoints, dropping delta and segment values); on grid author labels on each panel's own options; table and diagram have their own display models",
311
+ colorblindSafe: "colorblindSafe swaps a SEMANTIC good/bad pair for the colour-vision-safe one; bar, column, variance and status swap their signed marks, heatmap its valence cells, table its tones, grounds, bars and badges, and choropleth and tilemap the poles of a diverging scale. This type paints no good/bad pair; on a categorical ramp the equivalent control is a colorblind-safe 'palette'",
312
+ hatchStrength: "this type draws no forecast, partial-period or no-data hatch, so there is nothing to strengthen or soften. Drop hatchStrength",
313
+ sort: "sort reorders categories on bar, box, column, dot, heatmap, mekko, pie and table, and cohort takes sort.segments. Here the order is the data's own: a time axis, a bridge, a funnel or a histogram's bins keep their sequence, and butterfly ranks rows with its own sortBy. Send the categories in the order to draw",
314
+ topN: "topN keeps the n largest categories and folds the rest on bar, butterfly, column, mekko, pareto, pie and table, and picks the labelled regions on a choropleth world map. Here the categories are a sequence, a grid or a sample (time, stages, bridge steps, matrix cells, histogram bins, box groups), and dropping some would misstate the rest. Filter the data before sending it",
315
+ rounding: "rounding changes how computed shares of one whole print, on a bar, column or combo stack, a bartable cascade, a stacked100 area, a mekko and a pie. This type prints no share of a whole, or prints them through its own rules. Drop rounding",
316
+ bandFraction: "bandFraction sets how much of a category band a bar, column, bridge step or dot row fills. This type sets its own: a line or slope runs through points, mekko column widths come from the data, a box row takes the height its labels need, and a pie, map, matrix or table has no band. Drop the key",
317
+ highlight: "no mark here takes emphasis; a map colours every region by its value. Name the region in the title or an annotation, or rank the regions in a bar chart with highlight",
318
+ detailFields: "cell details and their detailFields reach the hover card on bar, butterfly, column, combo, dot, funnel, heatmap, line, mekko, pie and slope. This type's cells carry no details. Drop detailFields, or name the extra facts in a category label or an annotation",
319
+ story: "this type has no story layer. Drop story, or tell the story over a type that takes it, such as scatter, column or line"
320
+ }, VALUE_AXIS_REASONS = {
321
+ tickStep: "only line and column draw their ticks at an authored step; this type picks a readable step from the data. Drop tickStep, or set valueAxis.min/max where the domain must widen",
322
+ reverse: "only line and scatter reverse the value axis; bars, columns and bridge steps grow from their baseline, and a reversed axis would read gains as losses. Drop reverse",
323
+ break: "only bar, column, histogram and waterfall draw a value-axis break; this type would accept it and draw an unbroken axis. Drop break, or draw the data as a column or bar chart",
324
+ log: "only scatter draws a log scale; this type draws its values on a linear axis. Drop log, or plot the data as a scatter"
325
+ }, VALUE_AXIS_ONLY_REASONS = {
326
+ sankey: "a sankey has no value axis; node heights and ribbon widths share one scale, and the node labels carry the numbers",
327
+ waterfall: "a waterfall scales to its running levels and draws no value axis; only valueAxis.break applies",
328
+ pvm: "a pvm bridge scales to its running levels and draws no value axis; only valueAxis.break applies",
329
+ slope: "a slope draws no value axis; only valueAxis.min and max widen its domain",
330
+ sparkline: "a sparkline has no axes and scales to the data's own range",
331
+ dimswitch: "An dimswitch has no value axis; it draws a table of derived values.",
332
+ table: "a table has no value axis; in-cell bars scale per column",
333
+ bartable: "a bar table has no value axis; each panel scales to its own largest row, or all to one under sharedScale, and the labels carry the numbers",
334
+ diagram: "a diagram has no value axis",
335
+ creative: "the creative card has no value axis; its trend panels scale to their own observations",
336
+ pie: "a pie has no value scale; slice angles and the printed shares carry the values",
337
+ funnel: "a funnel has no value axis; every stage prints its own value and conversion",
338
+ heatmap: "a heatmap has no value axis; cell colour and the in-cell values carry the scale",
339
+ kpi: "a KPI tile prints its figures and has no value axis",
340
+ status: "a status board shows states and has no value scale",
341
+ gantt: "a gantt runs on a time axis and has no value axis",
342
+ tilemap: "a tile map has no value axis; tile colour and the colour key carry the scale",
343
+ choropleth: "a map has no value axis; region colour and the colour key carry the scale",
344
+ cohort: "a retention triangle has no value axis; colour and the in-cell percentages carry the scale",
345
+ likert: "a likert labels every segment with its share and draws no axis, because an axis around the diverging centre would print negative percentages",
346
+ butterfly: "a butterfly prints each value at its bar and draws no value axis; sharedScale puts both panes on one scale",
347
+ pyramid: "a pyramid prints each value at its bar and draws no value axis; both sides already share one scale"
348
+ }, LEGEND_REFUSED_REASONS = {
349
+ box: "a box plot names every row beside its box and its method note explains the box, whiskers and dots; drop legend"
350
+ }, LEGEND_DRAWS_REASONS = {
351
+ slope: "a slope chart names every line at both ends, so 'none' and 'auto' draw what the chart draws without them; drop legend, or name 'top' or 'bottom' for a key"
352
+ }, TRANSPOSE_REFUSED = "no chart type implements 'transpose' \u2014 orientation is a type, not a flag: use 'bar' for horizontal categories, 'column' for vertical, 'butterfly' for mirrored panes (waterfall has its own 'variant')", TYPE_REFUSED_REASONS = {
353
+ slope: {
354
+ seriesLabels: "'seriesLabels' is not accepted on a slope: it labels both ends of every line itself, name and value together; labels.series sets what the end labels show",
355
+ valueLabels: "'valueLabels' is not accepted on a slope: it prints the value at both ends of every line in its end labels; labels.series sets what they show"
356
+ }
357
+ };
358
+ function notImplemented(key, type, suggest) {
359
+ return `'${key}' is not implemented by '${type}' \u2014 ${suggest}`;
360
+ }
361
+ var SLOPE_REVERSE_REASON = "a slope draws no value axis to reverse. Ranks with 1 on top are a bump chart: type 'line' with variant 'bump', and bump.direction 'lowerIsBetter' ranks the smallest value first. A numeric scale flips on type 'line' with valueAxis.reverse";
362
+ function valueAxisReason(type, key, why) {
363
+ return type === "slope" && key === "reverse" ? SLOPE_REVERSE_REASON : why === "only" ? VALUE_AXIS_ONLY_REASONS[type] : VALUE_AXIS_REASONS[key];
364
+ }
365
+ var ALTERNATIVES = {
366
+ transpose: {
367
+ "*": "orientation is the chart type: type 'bar' draws horizontal bars and type 'column' vertical ones",
368
+ waterfall: "a waterfall turns with options.variant"
369
+ },
370
+ animate: { "*": "the SVG is static; options.interactive adds hover and focus semantics" },
371
+ debug: { "*": "no chart type reads it, and the CLI has no debug flag" },
372
+ ribbons: { bar: "bar rows are items, not a sequence, and ribbons draw a rank flow from period to period; type 'column' with variant 'stacked' draws them" },
373
+ rowLabels: { "*": "aligned row labels belong to horizontal rows such as type 'bar'; this type prints its category labels on one baseline already" },
374
+ categoryLabels: { "*": "type 'column', 'combo' or 'pareto' over columns sorted by height takes categoryLabels 'staircase'", bar: "a horizontal bar prints each name beside its row already" },
375
+ categoryAxis: { "*": "crossesBetween and dateTicks are type 'line' settings; a banded type crosses between its bands already" },
376
+ secondaryAxis: { "*": "a second value scale needs type 'combo'" },
377
+ labels: {
378
+ "*": "options.labelDensity 'minimal' keeps the totals and endpoints",
379
+ grid: "set labels in each panel's own options",
380
+ sparkline: "options.endLabels and options.valueLabel set what prints",
381
+ table: "the columns set what each cell prints",
382
+ bartable: "each row's value prints at its bar end",
383
+ creative: "the card prints the figures it is given",
384
+ diagram: "a diagram prints its own node and edge text"
385
+ },
386
+ colorblindSafe: {
387
+ "*": "this type paints no good/bad pair; options.palette names a colorblind-safe categorical ramp",
388
+ likert: "a likert always paints its agree side in color.colorblind.goodFill, so its sides stay apart without the option",
389
+ slope: "variant 'diverging' always paints its better side in color.colorblind.good and goodFill, so its sides stay apart without the option; the other variants paint no good/bad pair"
390
+ },
391
+ hatchStrength: {
392
+ "*": "this type draws no forecast, partial-period or no-data hatch"
393
+ },
394
+ sort: {
395
+ "*": "send the categories in the order to draw",
396
+ butterfly: "options.sortBy ranks the rows",
397
+ likert: "order the questions in the data",
398
+ pyramid: "send the bands in their age order",
399
+ pareto: "a Pareto sorts by contribution itself",
400
+ choropleth: "a map places its regions by geography",
401
+ tilemap: "a map places its regions by geography"
402
+ },
403
+ topN: {
404
+ "*": "filter the data before sending it",
405
+ likert: "options.neutral 'exclude' drops the midpoint; filter the questions in the data",
406
+ pyramid: "widen the bands in the data"
407
+ },
408
+ rounding: { "*": "this type prints no computed share of one whole" },
409
+ bandFraction: { "*": "this type has no category band to fill" },
410
+ mode: { mekko: "a mekko draws one framing at every width; options.variant 'stacked100', 'stacked' or 'bar' sets the form" },
411
+ highlight: {
412
+ "*": "this type has no mark that takes emphasis",
413
+ choropleth: "a region's colour is its value; name the region in the title or an annotation, or rank the regions in type 'bar' with options.highlight",
414
+ tilemap: "a region's colour is its value; name the region in the title or an annotation, or rank the regions in type 'bar' with options.highlight"
415
+ },
416
+ detailFields: { "*": "drop detailFields; this type has no cell details" },
417
+ story: { "*": "this type has no story layer; tell the story with a type that has one, such as type 'scatter', 'column' or 'line'" },
418
+ legend: { box: "a box plot names every row beside its box" },
419
+ seriesLabels: { slope: "options.labels.series sets what the end labels show" },
420
+ valueLabels: { slope: "options.labels.series sets what the end labels show" },
421
+ valueAxis: {
422
+ "*": "this type draws no value axis",
423
+ butterfly: "options.sharedScale puts both panes on one scale",
424
+ pyramid: "both sides share one scale already",
425
+ waterfall: "options.valueAxis.break is the one value-axis setting a waterfall reads",
426
+ pvm: "options.valueAxis.break is the one value-axis setting a pvm bridge reads",
427
+ slope: "options.valueAxis.min and options.valueAxis.max widen the domain"
428
+ },
429
+ "valueAxis.tickStep": { "*": "this type picks a readable step; options.valueAxis.min and options.valueAxis.max widen the domain" },
430
+ "valueAxis.reverse": {
431
+ "*": "this type grows its marks from a baseline, where a reversed axis reads gains as losses; type 'line' and type 'scatter' reverse",
432
+ slope: "for ranks with 1 on top, draw type 'line' with options.variant 'bump' and options.bump.direction 'lowerIsBetter'; to flip a numeric scale, draw type 'line' with options.valueAxis.reverse"
433
+ },
434
+ "valueAxis.break": { "*": "type 'column', 'bar', 'histogram' and 'waterfall' draw a break; draw the data as type 'column' or 'bar' to cut a tall value" },
435
+ "valueAxis.log": { "*": "type 'scatter' draws the one log scale" },
436
+ "scaleGroup.x": { "*": "options.scaleGroup.y shares the value scale; no chart type shares an x scale" },
437
+ "window.decimate": { "*": "keep options.window.last, or narrow the periods with options.viewDomain" },
438
+ "window.maxPoints": { "*": "keep options.window.last, or narrow the periods with options.viewDomain" }
439
+ };
440
+ function refusalSuggest(type, path) {
441
+ let key = path.join("."), own = ALTERNATIVES[key], only = path.length === 2 && path[0] === "valueAxis" && valueAxisRefusal(type, String(path[1])) === "only" ? ALTERNATIVES.valueAxis[type] : void 0, alternative = own?.[type] ?? only ?? own?.["*"];
442
+ return alternative === void 0 ? void 0 : `Remove '${key}'; ${alternative}.`;
443
+ }
444
+
445
+ // src/core/schema/shared.ts
446
+ import * as z3 from "zod";
447
+ var annotationIconNames = listIcons(), annotationIconSchema = z3.string().superRefine((name, ctx) => {
448
+ isIconName(name) || ctx.addIssue({
449
+ code: "custom",
450
+ message: `unknown annotation icon '${name}' \u2014 valid icons: ${annotationIconNames.join(", ")}`
451
+ });
452
+ }).describe("Registered icon name for a note or callout glyph; mutually exclusive with status.");
453
+ z3.globalRegistry.add(annotationIconSchema, { enum: annotationIconNames, description: annotationIconSchema.description });
454
+ var idSchema = z3.string().min(1).describe("Nonempty stable identifier used to match data, labels and annotation anchors."), categoryDateSchema = z3.string().refine((date) => parseISODate(date) !== null, { message: "a category date is an ISO date, yyyy-mm-dd, such as 2024-01-31" }), partialCategorySchema = z3.boolean().optional().describe('Period still running, such as the current week. Bars and segments on it are hatched and line markers on it are hollow; marks keep their positions. A drawn key names the running category once as "<label> to date". With no such key, the frame adds that note.');
455
+ function categorySchemaOf(spec) {
456
+ return z3.union([
457
+ spec.nonEmpty ? z3.string().min(1) : z3.string(),
458
+ z3.strictObject({
459
+ id: idSchema.describe("Category identity used to match keyed values and annotation anchors."),
460
+ label: spec.label ?? z3.string().optional().describe("Displayed category name; defaults to the category id and supports line breaks. A date id or `date` without a label prints a short date such as '4 Sep'."),
461
+ date: spec.date,
462
+ ...spec.fields,
463
+ footnote: spec.footnote ?? z3.number().int().optional().describe("1-based reference into options.footnotes. The number is drawn beside this category label as the reference mark, and the note it points at keeps that number; a reference to no note draws nothing and warns, and notes the engine derives print unnumbered."),
464
+ ...spec.after
465
+ })
466
+ ]);
467
+ }
468
+ var comparisonDirectionSchema = z3.enum(["higherIsBetter", "lowerIsBetter", "neutral"]), COLOR_ROLE_PATTERN = /^(?:good|bad|warn|neutral|neutralLight|highlight|total|others|series-[1-9]\d{0,14}|status-[A-Za-z0-9][A-Za-z0-9_-]*)$/, COLOR_ROLE_VALUES = "One of good, bad, warn, neutral, neutralLight, highlight, total, others; series-N for step N of the theme ramp, 1-based (series-2 is color.series[1]); or status-<key> for a theme status colour. A hex colour goes in fill.";
469
+ function colorRoleField(lead) {
470
+ return z3.string().regex(COLOR_ROLE_PATTERN, {
471
+ message: "colorRole must be a theme colour role: good, bad, warn, neutral, neutralLight, highlight, total, others, series-N (1-based ramp step, series-2 is color.series[1]) or status-<key>; put a hex colour in fill"
472
+ }).optional().describe(`${lead} ${COLOR_ROLE_VALUES}`);
473
+ }
474
+ var ownerSchema = z3.strictObject({
475
+ seriesId: idSchema.optional().describe("Source series identity."),
476
+ categoryId: idSchema.optional().describe("Source category identity."),
477
+ segmentId: idSchema.optional().describe("Source segment identity."),
478
+ pointId: idSchema.optional().describe("Source point identity."),
479
+ valueLineId: idSchema.optional().describe("Source value-line identity."),
480
+ annotationId: idSchema.optional().describe("Source annotation identity."),
481
+ rowId: idSchema.optional().describe("Source table row identity."),
482
+ colId: idSchema.optional().describe("Source table column identity.")
483
+ }).describe("Source identity fields; an empty owner addresses the whole domain scope.");
484
+ function addDuplicateIdIssues(ctx, entries, pathPrefix, label) {
485
+ let seen = /* @__PURE__ */ new Set();
486
+ entries.forEach((entry, index) => {
487
+ let id = typeof entry == "string" ? entry : entry.id;
488
+ if (seen.has(id)) {
489
+ let issuePath = typeof entry == "string" ? [...pathPrefix, index] : [...pathPrefix, ...entry.issuePath ?? [index, "id"]];
490
+ ctx.addIssue({
491
+ code: "custom",
492
+ path: issuePath,
493
+ message: `duplicate ${label.name} id '${id}' \u2014 ids key ${label.keys}, so each needs its own`
494
+ });
495
+ }
496
+ seen.add(id);
497
+ });
498
+ }
499
+ function addCategorySeriesIdIssues(ctx, data, between) {
500
+ addDuplicateIdIssues(ctx, data.categories, ["categories"], {
501
+ name: "category",
502
+ keys: "category values and scene identities"
503
+ }), addDuplicateIdIssues(ctx, data.series, ["series"], {
504
+ name: "series",
505
+ keys: "values, legends and scene identities"
506
+ }), between?.(), data.series.forEach((series, seriesIndex) => {
507
+ let points = series.values.flatMap(
508
+ (value, valueIndex) => typeof value == "object" && value !== null && "categoryId" in value ? [{ id: String(value.categoryId), issuePath: [seriesIndex, "values", valueIndex, "categoryId"] }] : []
509
+ );
510
+ addDuplicateIdIssues(ctx, points, ["series"], {
511
+ name: "point",
512
+ keys: `one category value in series '${series.id}'`
513
+ });
514
+ });
515
+ }
516
+ function addGeoIdIssues(data, ctx) {
517
+ addDuplicateIdIssues(ctx, data.regions, ["regions"], {
518
+ name: "region",
519
+ keys: "map values, marks and labels"
520
+ }), addDuplicateIdIssues(ctx, data.overlays ?? [], ["overlays"], {
521
+ name: "overlay",
522
+ keys: "overlay glyphs, labels and scene identities"
523
+ });
524
+ }
525
+ function diagnosedSafeParse(schema, value) {
526
+ try {
527
+ return schema.safeParse(value);
528
+ } catch (error) {
529
+ throw error instanceof TypeError ? new Error(
530
+ `the JavaScript environment defines a conflicting property on Object.prototype and parsing cannot proceed (${error.message}) \u2014 run the CLI in a clean Node process`
531
+ ) : error;
532
+ }
533
+ }
534
+ function parseOwned(schema, raw) {
535
+ return diagnosedSafeParse(schema, ownedDocumentCopy(raw));
536
+ }
537
+ function parseData(schema, raw) {
538
+ let result = parseOwned(schema, raw);
539
+ if (result.success) return result.data;
540
+ let issue = result.error.issues[0], path = issue?.path.join(".") || "(root)", node = raw;
541
+ for (let seg of issue?.path ?? []) {
542
+ if (node == null || typeof node != "object") break;
543
+ node = node[seg];
544
+ }
545
+ let isPctString = typeof node == "string" && /^[+\-\s]*[\d.,]+\s*%$/.test(node);
546
+ if (issue?.message.startsWith("range-inverted:")) {
547
+ let rangePath = issue.path.slice(0, -1).reduce(
548
+ (joined, segment) => typeof segment == "number" ? `${joined}[${segment}]` : joined ? `${joined}.${String(segment)}` : String(segment),
549
+ ""
550
+ );
551
+ throw new NormalizeError(
552
+ "range-inverted",
553
+ rangePath,
554
+ issue.message,
555
+ "swap low/high or correct the source interval"
556
+ );
557
+ }
558
+ let suggest = isPctString || JSON.stringify(raw)?.includes('"percentage"') === !0 ? "use 'pct' for percent cells (50.5 means 50.5%)" : void 0;
559
+ throw new NormalizeError("invalid-data", path, issue?.message ?? "invalid data", suggest);
560
+ }
561
+ var formatField = (withFix) => z3.string().superRefine((value, ctx) => {
562
+ let problem = formatExampleProblem(value);
563
+ problem && ctx.addIssue({ code: "custom", message: problem.message, params: { code: "invalid-format", ...withFix ? { replaceWith: problem.replacement } : {} } });
564
+ }), formatExample = formatField(!0), contextFormatExample = formatField(!1), valueKindSchema = z3.literal("fraction").optional().describe("Multiply numbers by 100 into pct cells; explicit pct cells stay in percent units."), dataValueKindSchema = valueKindSchema.describe("Default valueKind for all series."), PERCENT_FORMAT_UNITS = "A % example expects values in percent units: 3.53 prints 3.53%, a fraction 0.0353 prints 0.04%.", MAGNITUDE_WORDS_DOC = "A magnitude after the number divides the raw value: k, thousand, Tsd., Tausend (10\xB3); m, M, mn, mm, million(s), Mio., Million(en) (10\u2076); b, B, bn, billion(s), Mrd., Milliarde(n), milliard(s) (10\u2079); T glued to the number, tn, trillion(s), Bio., Billionen (10\xB9\xB2). A value of 1000 or more in a scale rolls up and one that would print as 0 rolls down, in the example's spelling; a German or French chart prints its own words (Mrd., Bio.; Md, Bn).", scenarioField = (meaning) => z3.string().optional().describe(`AC, PY, PL, FC (or ACT, BUD, FCST).${meaning ? ` ${meaning}` : ""}`), cellMetaSchema = {
565
+ fill: z3.string().optional().describe("Authored cell fill colour; overrides the inherited series fill where supported."),
566
+ format: formatExample.optional().describe("Format-by-example for this value, overriding the series or chart format."),
567
+ label: z3.union([
568
+ z3.string().describe("Authored value label; ${value} inserts the formatted value. On a slope it replaces only the value part of the end label and keeps the series name. On a line or combo it draws at that point whatever valueLabels asks of the rest, and replaces the series end label when the point is the series end."),
569
+ z3.literal(!1).describe("Suppress the cell label while retaining its value and mark, including the series end label when the cell is the series end.")
570
+ ]).optional().describe("Cell label override; omission uses the chart label policy."),
571
+ priority: z3.number().optional().describe("Authored label priority used when the solver must choose which labels fit."),
572
+ scenario: scenarioField("Cell scenario overriding its series."),
573
+ footnote: z3.number().int().optional().describe("Footnote reference kept in the interaction record for this cell; it draws no marker. The reference that draws one is categories[].footnote.")
574
+ };
575
+ var boundedNumber = z3.number().finite().superRefine((value, ctx) => {
576
+ Math.abs(value) > MAGNITUDE_CEILING && ctx.addIssue({ code: "custom", message: magnitudeMessage(value) });
577
+ }).describe("Finite numeric value with absolute magnitude at most 1e15; rescale larger values into a larger unit."), cellSchema = z3.union([
578
+ boundedNumber,
579
+ z3.null().describe("Missing observation; never interpreted as a numeric zero."),
580
+ z3.strictObject({ number: boundedNumber.describe("Value in the declared series or chart unit."), ...cellMetaSchema }).describe("Numeric cell with optional per-cell formatting and labels."),
581
+ z3.strictObject({ pct: boundedNumber.describe("Percentage points: 50.5 means 50.5%, not a fractional 0.505."), ...cellMetaSchema }).describe("Percentage cell with optional per-cell formatting and labels."),
582
+ z3.strictObject({ date: z3.string().describe("Date text intended as ISO 8601; this shared schema checks its string type only.") }).describe("Date cell expressed as ISO 8601 text.")
583
+ ]).describe("A numeric shorthand, missing value, numeric cell, percentage cell or date cell."), DETAIL_LIMITS = { fields: 20, text: 200 }, cellDetailsSchema = z3.preprocess((raw, ctx) => (raw !== null && typeof raw == "object" && Object.hasOwn(raw, "__proto__") && ctx.addIssue({ code: "custom", input: raw, message: "'__proto__' cannot name a detail; choose another key" }), raw), z3.record(
584
+ z3.string().min(1).max(64).describe("Detail key; options.detailFields names its label and format."),
585
+ z3.union([
586
+ boundedNumber.describe("Number, printed through the detailFields format of its key."),
587
+ z3.string().max(DETAIL_LIMITS.text).describe(`Text up to ${DETAIL_LIMITS.text} characters, printed as plain text.`),
588
+ z3.null().describe("Missing detail, printed as no observation.")
589
+ ])
590
+ ).refine((details) => Object.keys(details).length <= DETAIL_LIMITS.fields, { message: `a cell carries at most ${DETAIL_LIMITS.fields} details` })).describe("Extra facts for this value that the chart does not draw: the hover card and the keyboard reading list them after the value, labelled and formatted by options.detailFields. The static SVG draws the same picture with or without them."), detailCellSchema = z3.union([
591
+ boundedNumber,
592
+ z3.null().describe("Missing observation; never interpreted as a numeric zero. It carries no details."),
593
+ z3.strictObject({ number: boundedNumber.describe("Value in the declared series or chart unit."), ...cellMetaSchema, details: cellDetailsSchema.optional() }).describe("Numeric cell with optional per-cell formatting, labels and hover details."),
594
+ z3.strictObject({ pct: boundedNumber.describe("Percentage points: 50.5 means 50.5%, not a fractional 0.505."), ...cellMetaSchema, details: cellDetailsSchema.optional() }).describe("Percentage cell with optional per-cell formatting, labels and hover details."),
595
+ z3.strictObject({ date: z3.string().describe("Date text intended as ISO 8601; this shared schema checks its string type only.") }).describe("Date cell expressed as ISO 8601 text.")
596
+ ]).describe("A numeric shorthand, missing value, numeric cell, percentage cell or date cell."), detailFieldsSchema = z3.array(z3.strictObject({
597
+ key: z3.string().min(1).max(64).describe("The details key in the cells."),
598
+ label: z3.string().trim().min(1).max(80).optional().describe("Label on the hover card; default the key."),
599
+ format: formatExample.optional().describe("Format-by-example for number details of this key, such as 1,234 or 0.0%."),
600
+ unit: z3.string().min(1).max(16).optional().describe("Unit joined to number details of this key as the marks join it, such as EUR.")
601
+ }).describe("One details key: its label, format and unit.")).max(DETAIL_LIMITS.fields).superRefine((fields, ctx) => {
602
+ let seen = /* @__PURE__ */ new Set();
603
+ fields.forEach((field, index) => {
604
+ seen.has(field.key) && ctx.addIssue({ code: "custom", path: [index, "key"], message: `detailFields repeats key '${field.key}'` }), seen.add(field.key);
605
+ });
606
+ }), subtitleSchema = z3.union([
607
+ z3.string().describe("Measure text shorthand; normalized to an object with this measure."),
608
+ z3.object({
609
+ company: z3.string().optional().describe("Company or scope text before the measure."),
610
+ measure: z3.string().describe("Measure named by the subtitle; options.unit supplies its unit."),
611
+ period: z3.string().optional().describe("Reporting period text after the measure."),
612
+ scenarios: z3.array(z3.string().describe("Scenario text to append, such as AC or FC; arbitrary authored strings are accepted.")).optional().describe('Scenario captions in authored order, printed as their own segment joined with "vs": "\u2026 \xB7 6 Jul to 4 Oct \xB7 AC vs PL".')
613
+ }).describe("Structured subtitle with measure and optional company, period and scenarios.")
614
+ ]).describe("Visible measure subtitle, authored as text or structured fields."), MIN_CANVAS_WIDTH = 100, MIN_CANVAS_HEIGHT = 24, MIN_PLOT_SIZE = 10;
615
+ function addCanvasBoundsIssues(options, ctx) {
616
+ if (options.size !== void 0 && !sizeSchema.safeParse(options.size).success) return;
617
+ let size = resolveSize(options.size, options.target), margin = resolveCanvasOptions(options).margin ?? {}, path = options.canvas?.margin === void 0 ? ["margin"] : ["canvas", "margin"];
618
+ size.width - (margin.left ?? 0) - (margin.right ?? 0) < MIN_PLOT_SIZE && ctx.addIssue({
619
+ code: "custom",
620
+ path,
621
+ message: `left and right margins must leave at least ${MIN_PLOT_SIZE}px of plot width`
622
+ }), size.height - (margin.top ?? 0) - (margin.bottom ?? 0) < MIN_PLOT_SIZE && ctx.addIssue({
623
+ code: "custom",
624
+ path,
625
+ message: `top and bottom margins must leave at least ${MIN_PLOT_SIZE}px of plot height`
626
+ });
627
+ }
628
+ var renderTargetSchema = z3.enum(["report", "dashboard", "slide", "print"]).describe("Reading context. Default report."), textScaleSchema = z3.number().min(TEXT_SCALE_RANGE.min).max(TEXT_SCALE_RANGE.max).describe("Text scale; 1 (default) keeps the target sizes, 1.25 sets every text 25 % larger, from 0.5 to 2.5. It scales the width-class size; textSize gives equal text across charts. A factor under 1 stops each text at the target floor."), textSizeSchema = z3.number().min(TEXT_SIZE_RANGE.min).max(TEXT_SIZE_RANGE.max).describe("Primary label size in layout px, 6 to 32, the same at every width; other text keeps its ratio. Not with textScale."), sizeSchema = z3.union([
629
+ z3.enum(Object.keys(SIZE_PRESETS)).describe("Geometry preset; does not select a target. Existing pixel dimensions stay unchanged. A4 content presets are 267 by 180 mm and 180 by 267 mm."),
630
+ z3.object({
631
+ width: z3.number().finite().positive().describe("Canvas width in the stated unit; at least 100 layout px after conversion."),
632
+ height: z3.number().finite().positive().optional().describe("Canvas height in the stated unit; at least 24 layout px after conversion. Omitted, height stays automatic."),
633
+ unit: z3.enum(["px", "pt", "mm"]).optional().describe("Dimension unit. Default px. One pt is 96/72 layout px; one mm is 96/25.4 layout px.")
634
+ }).superRefine((size, ctx) => {
635
+ for (let [side, minimum] of [["width", MIN_CANVAS_WIDTH], ["height", MIN_CANVAS_HEIGHT]]) {
636
+ let value = size[side];
637
+ value !== void 0 && !Number.isFinite(toLayoutPx(value, size.unit)) ? ctx.addIssue({ code: "custom", path: [side], message: `${side} must remain finite after unit conversion` }) : value !== void 0 && toLayoutPx(value, size.unit) < minimum && ctx.addIssue({ code: "custom", path: [side], message: `${side} must be at least ${minimum} layout px after unit conversion` });
638
+ }
639
+ }).describe("Explicit dimensions. Width fixes width; an explicit height fixes height.")
640
+ ]).describe("Frame or geometry preset. Omission uses the target default and its automatic or fixed constraints.");
641
+ function addEventIssues(event, ctx, timeX = !1) {
642
+ let has = (key) => Object.hasOwn(event, key) && event[key] !== void 0, issue = (path, message) => ctx.addIssue({ code: "custom", path: [path], message });
643
+ (typeof event.label != "string" || event.label.trim() === "") && issue("label", "an event needs a label, the title it prints"), has("at") === has("date") && issue(has("at") ? "date" : "at", "an event takes exactly one of 'at' (a category id) and 'date' (an ISO date)");
644
+ for (let key of ["date", "end"]) {
645
+ let epoch = timeX && typeof event[key] == "number" && Number.isFinite(event[key]);
646
+ has(key) && !epoch && (typeof event[key] != "string" || parseISODate(event[key]) === null && parseTimeText(event[key]) === null) && issue(key, `event ${key} must be an ISO date, yyyy-mm-dd, or on a continuous time axis an ISO date-time such as 2026-10-25T03:00${timeX ? " or epoch milliseconds" : ""}`);
647
+ }
648
+ if (has("end") && !has("date") && issue("end", "an event 'end' needs its 'date'; a category-anchored period ends with 'to'"), has("to") && !has("at") && issue("to", "an event 'to' needs its 'at'; a dated period ends with 'end'"), has("to") && typeof event.to != "string" && !(timeX && typeof event.to == "number" && Number.isFinite(event.to)) && issue("to", "event 'to' is a category id"), typeof event.date == "string" && typeof event.end == "string" && parseISODate(event.date) && parseISODate(event.end) && event.end < event.date && issue("end", "an event period ends on or after its date"), has("detail") && typeof event.detail != "string" && !(Array.isArray(event.detail) && event.detail.every((line) => typeof line == "string")) && issue("detail", "event detail is a string or an array of strings"), has("items")) {
649
+ let items = event.items;
650
+ Array.isArray(items) && items.every((item) => typeof item == "object" && item !== null && !Array.isArray(item) && Object.keys(item).every((key) => key === "label" || key === "detail") && typeof item.label == "string" && item.label.trim() !== "" && (item.detail === void 0 || typeof item.detail == "string" || Array.isArray(item.detail) && item.detail.every((line) => typeof line == "string"))) || issue("items", "event items is a list of { label, detail? } and takes no other key (the allowed keys are label and detail): the further changes on this date, each with a title and an optional detail (a string or an array of strings)");
651
+ }
652
+ has("group") && typeof event.group != "string" && issue("group", "event group is the id of a group in options.events.groups"), has("tone") && !["neutral", "bad", "good"].includes(event.tone) && issue("tone", "event tone must be 'neutral', 'bad' or 'good'"), has("placement") && event.placement !== "auto" && event.placement !== "key" && issue("placement", "event placement must be 'auto' or 'key'");
653
+ }
654
+ function addAnnotationFormatIssues(annotation, ctx) {
655
+ let issue = (message, refused = !1) => ctx.addIssue({ code: "custom", path: ["format"], message, ...refused ? { params: { refused: !0 } } : {} });
656
+ if (annotation.kind === "event" || annotation.kind === "indicator100") {
657
+ issue(`${annotation.kind} computes no number, so format has nothing to print; drop it`, !0);
658
+ return;
659
+ }
660
+ let problem = formatExampleProblem(annotation.format);
661
+ if (problem) {
662
+ ctx.addIssue({ code: "custom", path: ["format"], message: problem.message, params: { code: "invalid-format" } });
663
+ return;
664
+ }
665
+ let unit;
666
+ try {
667
+ unit = specUnitKind(parseFormatExample(annotation.format));
668
+ } catch (error) {
669
+ issue(`format ${JSON.stringify(annotation.format)} is no format example (${error instanceof Error ? error.message : String(error)}); write one such as +0.0% or 1,234.5`);
670
+ return;
671
+ }
672
+ let mode = Object.hasOwn(annotation, "mode") ? annotation.mode : void 0;
673
+ (annotation.kind === "cagr" || annotation.kind === "diff" && mode !== "absolute") && unit !== "percent" && issue(`${annotation.kind === "cagr" ? "a cagr" : "a relative diff"} prints a percent, so its format is a percent example such as +0.0% or +0.00%`), annotation.kind === "diff" && mode === "absolute" && unit === "percent" && issue("an absolute diff prints the difference in the values' unit; a difference of two percent levels is in percentage points, written +1.0pp");
674
+ }
675
+ var eventOptionsSchema = z3.strictObject({
676
+ placement: z3.enum(["auto", "key"]).optional().describe("auto uses lane then key, key uses key only. 'auto' (default) sets events in the lane above the plot where they fit and numbers the rest into the key below it; 'key' draws every event as a numbered marker with its entry in the key. Under footnotes: false there is no key: those events are left off and listed in the footnotes-off lint.").meta({ default: "auto" }),
677
+ rows: z3.number().int().min(0).max(2).optional().describe("Lane rows for event blocks. Default by canvas width: 1 under 1080px, 2 from 1080px. 0 draws numbered markers only. A row gives way while the plot band left under the lane would keep less than 40% of the canvas height.").meta({ "x-boardplot-defaultDependsOn": ["size"] }),
678
+ groups: z3.array(
679
+ z3.strictObject({
680
+ id: idSchema.describe("Group id that events name in their group field."),
681
+ label: z3.string().min(1).describe("Kind label printed in the block header and the key, such as Out of stock."),
682
+ tone: z3.enum(["neutral", "bad", "good"]).optional().describe("Colour of the glyph, the marker ring and the period bar; default neutral. An event tone overrides it.").meta({ default: "neutral" }),
683
+ glyph: z3.enum(["dot", "triangle", "diamond", "square"]).optional().describe("Shape that marks the kind without colour; default by group order: dot, triangle, diamond, square.")
684
+ })
685
+ ).optional().superRefine((groups, ctx) => {
686
+ let seen = /* @__PURE__ */ new Set();
687
+ groups?.forEach((group, index) => {
688
+ seen.has(group.id) && ctx.addIssue({ code: "custom", path: [index, "id"], message: `duplicate event group id '${group.id}'` }), seen.add(group.id);
689
+ });
690
+ }).describe("Kinds of events, authored once: label, tone and glyph."),
691
+ keyTitle: z3.string().min(1).optional().describe("Heading printed over the event key.")
692
+ }).describe("Event lane and key. Events are annotations of kind event with at or date, an optional end or to for a period, group, detail, priority and, on column, combo and line charts only, items (more changes on the same date). Gantt events take one label and refuse items.");
693
+ function addCalloutHeadIssues(annotation, ctx) {
694
+ for (let field of ["headline", "arrow"]) {
695
+ if (!Object.hasOwn(annotation, field)) continue;
696
+ let value = annotation[field];
697
+ annotation.kind !== "callout" ? ctx.addIssue({ code: "custom", path: [field], message: `${field} belongs to a callout; a ${String(annotation.kind)} draws none` }) : (field === "headline" ? typeof value != "string" || value.trim() === "" : typeof value != "boolean") && ctx.addIssue({ code: "custom", path: [field], message: field === "headline" ? "a callout headline is non-empty text, such as '${value}'" : "a callout arrow is true or false" });
698
+ }
699
+ annotation.kind === "callout" && annotation.arrow === !0 && (annotation.icon !== void 0 || annotation.status !== void 0) && ctx.addIssue({ code: "custom", path: ["arrow"], message: "a callout with an icon or status leads from its chip, so the arrow would draw nothing; drop arrow or the glyph" });
700
+ }
701
+ var ANNOTATION_FIELDS = {
702
+ diff: ["from", "to", "mode", "placement", "caption"],
703
+ cagr: ["from", "to", "suffix", "period"],
704
+ delta: ["at", "vs", "placement", "caption"],
705
+ abs: ["at"],
706
+ note: ["at", "icon", "status"],
707
+ callout: ["at", "preferSide", "headline", "arrow", "icon", "status"],
708
+ valueLine: ["value", "valueKind", "seriesId", "from", "to", "label", "side", "axis", "tolerance", "attainment"],
709
+ indicator100: ["side"],
710
+ event: ["at", "date", "to", "end", "label", "detail", "items", "group", "tone", "placement", "labelPlacement"],
711
+ band: ["from", "to", "label", "tone", "style", "divider", "low", "high", "value", "seriesId", "scenario", "direction"]
712
+ }, SHARED_ANNOTATION_FIELDS = ["kind", "id", "text", "format", "priority", "icon", "status", "headline", "arrow"], ANCHOR_FIELDS = { diff: ["from", "to"], cagr: ["from", "to"], delta: ["at", "vs"], abs: ["at"], note: ["at"], callout: ["at"], event: ["at"] }, ANCHOR_SHAPE = "a category id such as 'c1', { categoryId, seriesId? }, { pointId } on scatter, or { valueLineId }", ANCHOR_KEYS = ["categoryId", "seriesId", "segmentId", "edge", "pointId", "valueLineId"];
713
+ function isAnchorRef(value, timeX = !1) {
714
+ return typeof value == "string" ? value !== "" : timeX && typeof value == "number" ? Number.isFinite(value) : typeof value == "object" && value !== null && !Array.isArray(value) && ["categoryId", "pointId", "valueLineId"].some((key) => typeof value[key] == "string" || timeX && key === "categoryId" && typeof value[key] == "number" && Number.isFinite(value[key]));
715
+ }
716
+ function misspelledField(key, fields) {
717
+ let lower = key.toLowerCase(), letters = (word) => [...word].sort().join("");
718
+ return fields.find((field) => {
719
+ let candidate = field.toLowerCase();
720
+ return letters(candidate) === letters(lower) || levenshtein(candidate, lower) <= 1;
721
+ });
722
+ }
723
+ function addAnnotationFieldIssues(annotation, ctx, timeX = !1) {
724
+ let kind = String(annotation.kind), fields = ANNOTATION_FIELDS[kind] ?? [];
725
+ for (let key of Object.keys(annotation)) {
726
+ if (SHARED_ANNOTATION_FIELDS.includes(key) || fields.includes(key)) continue;
727
+ let near = misspelledField(key, [...fields, ...SHARED_ANNOTATION_FIELDS]);
728
+ ctx.addIssue({
729
+ code: "custom",
730
+ path: [key],
731
+ message: near ? `unknown ${kind} field '${key}' \u2014 try: ${near}` : `unknown ${kind} field '${key}'; a ${kind} takes ${[...fields, "id", ...kind === "valueLine" || kind === "indicator100" ? [] : ["text"], "format", "priority"].join(", ")}`,
732
+ params: near ? { renameTo: near } : { refused: !0 }
733
+ });
734
+ }
735
+ for (let field of ANCHOR_FIELDS[kind] ?? []) {
736
+ let value = annotation[field];
737
+ if (value === void 0)
738
+ kind !== "cagr" && kind !== "event" && ctx.addIssue({ code: "custom", path: [field], message: `a ${kind} needs '${field}', the anchor it points at: ${ANCHOR_SHAPE}` });
739
+ else if (typeof value == "object" && value !== null && !Array.isArray(value) && Object.keys(value).some((key) => !ANCHOR_KEYS.includes(key)))
740
+ for (let key of Object.keys(value).filter((name) => !ANCHOR_KEYS.includes(name))) {
741
+ let near = misspelledField(key, ANCHOR_KEYS);
742
+ ctx.addIssue({
743
+ code: "custom",
744
+ path: [field, key],
745
+ message: near ? `unknown anchor field '${key}' \u2014 try: ${near}` : `unknown anchor field '${key}'; an anchor takes ${ANCHOR_KEYS.join(", ")}`,
746
+ params: near ? { renameTo: near } : { refused: !0 }
747
+ });
748
+ }
749
+ else !isAnchorRef(value, timeX) && !(field === "vs" && typeof value == "number" && Number.isFinite(value)) && ctx.addIssue({ code: "custom", path: [field], message: `'${field}' is an anchor: ${ANCHOR_SHAPE}${timeX ? ", or epoch milliseconds on a time axis" : ""}${field === "vs" ? ", or a number" : ""}` });
750
+ }
751
+ kind === "valueLine" && Object.hasOwn(annotation, "value") && annotation.value !== "mean" && !(typeof annotation.value == "number" && Number.isFinite(annotation.value)) && ctx.addIssue({ code: "custom", path: ["value"], message: "a valueLine value is a finite number or 'mean'" });
752
+ }
753
+ var existingAnnotationSchema = (timeX = !1) => z3.object({
754
+ kind: z3.enum(["diff", "cagr", "delta", "abs", "note", "callout", "valueLine", "indicator100", "event"]).describe("Annotation operation; its anchors and additional fields are checked by the chart annotation pass."),
755
+ id: z3.string().optional().describe("Stable annotation identity; omission generates an id from kind and authored order."),
756
+ text: z3.string().optional().describe("Authored annotation text; refused on valueLine, which prints label, and on indicator100. ${value} prints the computed number in it: a cagr's rate with its suffix, a diff's change, a delta's difference, the anchored value of an abs, note or callout. Without ${value}, text on a cagr, diff, delta or abs replaces the number, warns annotation-authored-override and the claim record marks the override."),
757
+ format: z3.string().optional().describe("Number format: annotation > anchored series > chart. Diff uses to, then from. CAGR and relative/reversed diff need a percent example; value differences use pp for percent levels. Refused on event and indicator100."),
758
+ priority: z3.number().optional().describe("Annotation label priority during collision resolution."),
759
+ icon: annotationIconSchema.optional().describe("Registered icon for note or callout annotations; cannot be combined with status."),
760
+ status: z3.enum(["good", "bad", "warn", "info"]).optional().describe("Semantic status glyph for a note or callout; cannot be combined with icon.")
761
+ }).catchall(z3.unknown().describe("Kind-specific annotation field, such as at, from or to; the annotation pass validates anchors and other requirements.")).superRefine((annotation, ctx) => {
762
+ if (addAnnotationFieldIssues(annotation, ctx, timeX), annotation.icon && annotation.status && ctx.addIssue({
763
+ code: "custom",
764
+ path: ["icon"],
765
+ message: "annotation icon and status are mutually exclusive glyph slots"
766
+ }), (annotation.icon || annotation.status) && annotation.kind !== "callout" && annotation.kind !== "note" && ctx.addIssue({
767
+ code: "custom",
768
+ path: [annotation.icon ? "icon" : "status"],
769
+ message: "annotation glyphs are supported only on callout and note annotations"
770
+ }), annotation.kind === "diff") {
771
+ let mode = Object.hasOwn(annotation, "mode") ? annotation.mode : void 0;
772
+ mode !== void 0 && mode !== "relative" && mode !== "absolute" && mode !== "reversed" && ctx.addIssue({
773
+ code: "custom",
774
+ path: ["mode"],
775
+ message: mode === "pctOf100" ? "diff mode 'pctOf100' is not implemented \u2014 annotation anchors resolve to absolute values, so the engine cannot derive share percentage points; use mode:'absolute' for the raw difference, or author the shares as data if the reader needs points of 100%" : `unknown diff mode '${String(mode)}' \u2014 expected 'relative', 'absolute' or 'reversed'`
776
+ });
777
+ }
778
+ if (annotation.kind === "event" && addEventIssues(annotation, ctx, timeX), annotation.kind === "delta" || annotation.kind === "diff") {
779
+ let { placement, caption } = annotation;
780
+ Object.hasOwn(annotation, "placement") && placement !== "auto" && placement !== "label" && placement !== "bracket" && ctx.addIssue({ code: "custom", path: ["placement"], message: `${annotation.kind} placement is 'auto', 'label' or 'bracket'` }), Object.hasOwn(annotation, "caption") && (typeof caption != "string" || caption.trim() === "") && ctx.addIssue({ code: "custom", path: ["caption"], message: `${annotation.kind} caption is a non-empty string` });
781
+ }
782
+ if ((annotation.kind === "valueLine" || annotation.kind === "indicator100") && Object.hasOwn(annotation, "text")) {
783
+ let rename = annotation.kind === "valueLine" && !Object.hasOwn(annotation, "label");
784
+ ctx.addIssue({
785
+ code: "custom",
786
+ path: ["text"],
787
+ message: annotation.kind === "valueLine" ? `a valueLine prints label, not text; ${rename ? "rename 'text' to 'label'" : "drop 'text', label is set"}` : "an indicator100 prints a fixed '100%' and no authored text; drop 'text'",
788
+ params: rename ? { renameTo: "label" } : { refused: !0 }
789
+ });
790
+ }
791
+ if (addCalloutHeadIssues(annotation, ctx), annotation.format !== void 0 && addAnnotationFormatIssues(annotation, ctx), annotation.kind === "cagr" && Object.hasOwn(annotation, "period") && typeof annotation.period != "boolean" && ctx.addIssue({ code: "custom", path: ["period"], message: "cagr period is true or false" }), annotation.kind === "valueLine") {
792
+ Object.hasOwn(annotation, "valueKind") && (annotation.valueKind !== "fraction" || typeof annotation.value != "number") && ctx.addIssue({ code: "custom", path: ["valueKind"], message: "valueLine valueKind 'fraction' needs a numeric value" });
793
+ let rec = annotation;
794
+ if (Object.hasOwn(annotation, "tolerance")) {
795
+ let tolerance = rec.tolerance, okNumber = typeof tolerance == "number" && Number.isFinite(tolerance) && tolerance > 0, okPair = typeof tolerance == "object" && tolerance !== null && typeof tolerance.low == "number" && typeof tolerance.high == "number" && Number.isFinite(tolerance.low) && Number.isFinite(tolerance.high) && tolerance.low !== tolerance.high;
796
+ !okNumber && !okPair && ctx.addIssue({
797
+ code: "custom",
798
+ path: ["tolerance"],
799
+ message: "valueLine tolerance is a positive finite number (\xB1) or {low, high} with unequal finite bounds"
800
+ });
801
+ }
802
+ if (Object.hasOwn(annotation, "attainment")) {
803
+ let attainment = rec.attainment, okFlag = attainment === !0 || attainment === !1, okObj = typeof attainment == "object" && attainment !== null && !Array.isArray(attainment);
804
+ !okFlag && !okObj && ctx.addIssue({
805
+ code: "custom",
806
+ path: ["attainment"],
807
+ message: "valueLine attainment is true or { seriesId?, direction? }"
808
+ });
809
+ }
810
+ rec.axis === "secondary" && (Object.hasOwn(annotation, "tolerance") || Object.hasOwn(annotation, "attainment")) && ctx.addIssue({
811
+ code: "custom",
812
+ path: ["axis"],
813
+ message: "tolerance and attainment are primary-axis only"
814
+ });
815
+ }
816
+ }).describe("Data-bound annotation. Additional kind-specific fields, including required anchors, are checked by the annotation pass."), bandAnnotationSchema = (timeX = !1) => z3.object({
817
+ kind: z3.literal("band").describe("Era band spanning inclusive category ids, or a value-axis plan corridor, tolerance band or attainment fill."),
818
+ id: z3.string().optional().describe("Stable band annotation identity; omission generates an id from kind and authored order."),
819
+ text: z3.string().optional().describe("Shared annotation text override; band captions use label."),
820
+ format: formatExample.optional().describe("Shared annotation value format; the band caption itself is authored text."),
821
+ priority: z3.number().optional().describe("Band label priority during collision resolution."),
822
+ from: (timeX ? z3.union([idSchema, z3.number().finite()]) : idSchema).optional().describe("First category included in the band; required for era shade/bracket, optional clip for value-axis bands." + (timeX ? " A time axis also takes epoch milliseconds." : "")),
823
+ to: (timeX ? z3.union([idSchema, z3.number().finite()]) : idSchema).optional().describe("Last category included in the band; required for era shade/bracket, optional clip for value-axis bands." + (timeX ? " A time axis also takes epoch milliseconds." : "")),
824
+ label: z3.string().optional().describe("Optional period or corridor label."),
825
+ tone: z3.enum(["neutral", "muted"]).optional().describe("Semantic era-band tone; both use the theme others tint. Refused on corridor, tolerance and attainment."),
826
+ style: z3.enum(["shade", "bracket", "corridor", "tolerance", "attainment"]).optional().describe("Band presentation; 'shade' is the default category tint, 'bracket' is a double-headed period arrow, 'corridor' is a plan value band, 'tolerance' is an authored value range, 'attainment' shades actual versus plan."),
827
+ divider: z3.union([
828
+ z3.literal(!1).describe("Do not draw category-span edge dividers."),
829
+ z3.enum(["start", "end", "both"]).describe("Draw a divider at the selected category-span edges.")
830
+ ]).optional().describe("Optional dashed divider at one or both bracket-band edges; other band styles refuse this field."),
831
+ low: z3.number().finite().optional().describe("Lower value-axis bound for corridor and tolerance bands."),
832
+ high: z3.number().finite().optional().describe("Upper value-axis bound for corridor and tolerance bands."),
833
+ value: z3.number().finite().optional().describe("Plan value for attainment shading; actuals are resolved per category."),
834
+ seriesId: idSchema.optional().describe("Series whose actuals are shaded for attainment; omission uses the category total."),
835
+ scenario: z3.enum(["AC", "PY", "PL", "FC"]).optional().describe("Scenario notation for a plan corridor; default PL."),
836
+ direction: z3.enum(["higherIsBetter", "lowerIsBetter"]).optional().describe("Whether exceeding the plan is favorable for attainment shading; default higherIsBetter.")
837
+ }).catchall(z3.unknown()).superRefine((band, ctx) => {
838
+ addAnnotationFieldIssues(band, ctx, timeX);
839
+ let style = band.style ?? "shade";
840
+ if (!(style === "corridor" || style === "tolerance" || style === "attainment")) {
841
+ band.from === void 0 && ctx.addIssue({ code: "custom", path: ["from"], message: "era band needs inclusive category from and to" }), band.to === void 0 && ctx.addIssue({ code: "custom", path: ["to"], message: "era band needs inclusive category from and to" }), (band.low !== void 0 || band.high !== void 0) && ctx.addIssue({
842
+ code: "custom",
843
+ path: ["low"],
844
+ message: "low/high belong to style 'corridor' or 'tolerance', not era shade/bracket"
845
+ }), band.value !== void 0 && ctx.addIssue({
846
+ code: "custom",
847
+ path: ["value"],
848
+ message: "value belongs to style 'attainment', not era shade/bracket"
849
+ }), band.seriesId !== void 0 && ctx.addIssue({
850
+ code: "custom",
851
+ path: ["seriesId"],
852
+ message: "seriesId belongs to style 'attainment'"
853
+ }), band.scenario !== void 0 && ctx.addIssue({
854
+ code: "custom",
855
+ path: ["scenario"],
856
+ message: "scenario belongs to style 'corridor'"
857
+ });
858
+ return;
859
+ }
860
+ band.from === void 0 != (band.to === void 0) && ctx.addIssue({
861
+ code: "custom",
862
+ path: [band.from === void 0 ? "from" : "to"],
863
+ message: "a category span needs both 'from' and 'to' (inclusive, like era band)"
864
+ }), band.divider && ctx.addIssue({
865
+ code: "custom",
866
+ path: ["divider"],
867
+ message: "divider applies only to bracket era bands"
868
+ }), band.tone !== void 0 && ctx.addIssue({
869
+ code: "custom",
870
+ path: ["tone"],
871
+ message: "tone applies to era bands; corridor, tolerance and attainment use scenario or good/bad tokens"
872
+ }), style !== "attainment" && band.seriesId !== void 0 && ctx.addIssue({
873
+ code: "custom",
874
+ path: ["seriesId"],
875
+ message: "seriesId belongs to style 'attainment'"
876
+ }), style !== "corridor" && band.scenario !== void 0 && ctx.addIssue({
877
+ code: "custom",
878
+ path: ["scenario"],
879
+ message: "scenario belongs to style 'corridor'"
880
+ }), style === "attainment" && (band.low !== void 0 || band.high !== void 0) && ctx.addIssue({
881
+ code: "custom",
882
+ path: ["low"],
883
+ message: "attainment uses 'value' as the plan, not low/high"
884
+ }), style !== "attainment" && band.value !== void 0 && ctx.addIssue({
885
+ code: "custom",
886
+ path: ["value"],
887
+ message: "value belongs to style 'attainment'"
888
+ }), (style === "corridor" || style === "tolerance") && (band.low === void 0 || band.high === void 0 ? ctx.addIssue({
889
+ code: "custom",
890
+ path: [band.low === void 0 ? "low" : "high"],
891
+ message: `${style} needs finite 'low' and 'high' on the value axis`
892
+ }) : band.low === band.high && ctx.addIssue({
893
+ code: "custom",
894
+ path: ["high"],
895
+ message: `${style} low and high must differ`
896
+ })), style === "attainment" && band.value === void 0 && ctx.addIssue({
897
+ code: "custom",
898
+ path: ["value"],
899
+ message: "attainment needs a finite plan 'value'"
900
+ });
901
+ }).describe("Unclaimed background era band, plan corridor, tolerance band or attainment fill."), annotationSchema = z3.union([existingAnnotationSchema(), bandAnnotationSchema()]).describe("Data-bound annotation or category-span band; supported kinds depend on the selected chart type."), timeAnnotationSchema = z3.union([existingAnnotationSchema(!0), bandAnnotationSchema(!0)]).describe("Data-bound annotation on a time axis; x anchors accept ISO strings or epoch milliseconds.");
902
+ function annotationArraySchema(itemSchema) {
903
+ return z3.array(itemSchema).superRefine((annotations, ctx) => {
904
+ let firstPosition = /* @__PURE__ */ new Map();
905
+ annotations.forEach((annotation, index) => {
906
+ if (typeof annotation != "object" || annotation === null || !("id" in annotation) || typeof annotation.id != "string")
907
+ return;
908
+ let first = firstPosition.get(annotation.id);
909
+ if (first !== void 0) {
910
+ ctx.addIssue({
911
+ code: "custom",
912
+ path: [index, "id"],
913
+ message: `duplicate annotation id '${annotation.id}' at positions ${first} and ${index} \u2014 explicit ids key annotation labels and scene identities`
914
+ });
915
+ return;
916
+ }
917
+ firstPosition.set(annotation.id, index);
918
+ });
919
+ }).describe("Annotations in authored order; explicit ids must be unique within this array.");
920
+ }
921
+ function addProjectedDashIssues(ctx, series, basePath = ["series"]) {
922
+ series.forEach((entry, index) => {
923
+ entry.lineStyle !== "dashed" && entry.lineStyle !== "dotted" || entry.scenario === "FC" || entry.scenario === "PL" || entry.role !== "reference" && ctx.addIssue({
924
+ code: "custom",
925
+ path: [...basePath, index, "lineStyle"],
926
+ message: `series '${entry.id}': lineStyle '${entry.lineStyle}' on actual data claims forecast status \u2014 dashed/dotted ink marks projected data only; declare scenario 'FC' or 'PL' if the series is projected, use role 'reference' for a context line, or drop lineStyle and let color carry identity`
927
+ });
928
+ });
929
+ }
930
+ var derivedRatioTierSchema = z3.object({
931
+ id: idSchema.describe("Stable id for the derived ratio tier."),
932
+ label: z3.string().min(1).describe("Quiet caption explaining what the ratio badges measure."),
933
+ numeratorSeriesId: idSchema.describe("Series used as the computed ratio numerator."),
934
+ denominatorSeriesId: idSchema.describe("Series used as the computed ratio denominator."),
935
+ at: z3.array(idSchema).min(1).describe("Selected category ids that receive a computed ratio trace."),
936
+ format: formatExample.min(1).optional().describe("Format-by-example for computed percentage points, e.g. '1.2pp' or '88%'."),
937
+ direction: z3.enum(["higherIsBetter", "lowerIsBetter"]).optional().describe("Whether an increase in the computed ratio is favourable; controls semantic treatment where supported.")
938
+ }).strict().describe(
939
+ "Below-axis ratio tier computed from normalized chart series cells; authored ratio values are not accepted."
940
+ ), marginSchema = z3.object({
941
+ top: z3.number().finite().nonnegative().optional().describe("Top outer margin in pixels; omission uses chart or theme defaults."),
942
+ right: z3.number().finite().nonnegative().optional().describe("Right outer margin in pixels; omission uses chart or theme defaults."),
943
+ bottom: z3.number().finite().nonnegative().optional().describe("Bottom outer margin in pixels; omission uses chart or theme defaults."),
944
+ left: z3.number().finite().nonnegative().optional().describe("Left outer margin in pixels; omission uses chart or theme defaults.")
945
+ }).describe("Optional per-side outer margins in pixels, applied before chart furniture reserves space.");
946
+ function primaryAxisTitleSchema(where) {
947
+ return z3.strictObject({
948
+ primary: z3.string().trim().min(1).optional().describe("'Measure, unit' title of the value axis, e.g. 'Margin, %'.")
949
+ }).optional().describe(`Title of the value axis when it is drawn: ${where}. Drawn only when authored.`);
950
+ }
951
+ var valueAxisSchema = z3.object({
952
+ show: z3.boolean().optional().describe("Draw the value axis with its ticks. Default: shown unless every value is labelled; true keeps it beside the labels, false hides it."),
953
+ min: z3.number().optional().describe("Requested lower domain bound; chart data can widen it to avoid clipping values."),
954
+ max: z3.number().optional().describe("Requested upper domain bound; chart data can widen it to avoid clipping values."),
955
+ tickStep: z3.number().positive().optional().describe("Requested positive tick step. Line and column draw their ticks at the step and snap the domain out to it, never cutting data; box ignores it with a warning, and every other type refuses it because it picks a readable step from the data."),
956
+ includeZero: z3.boolean().optional().describe("Include zero in the value domain; zero-based marks can require it even when false."),
957
+ percent: z3.boolean().optional().describe("Request the chart percent-axis or percentage presentation where supported; meanings and support follow the chart-specific schema."),
958
+ log: z3.union([z3.boolean(), z3.enum(["x", "y", "both"])]).optional().describe("Scatter only: a log10 scale on the horizontal axis ('x'), the vertical axis ('y', also true) or both. Ticks print plain numbers in the chart format at both ends and at 1, 2 and 5 of each decade (3, 4, 6 and 8 too under one decade), down to the decades alone where labels would touch, and the domain ends on the nearest round number past the data, never on a decade the data does not reach. Every value on a log axis must be above zero: a point, cut point, zone, value line, clamp or view bound at or below zero is refused with its path. Every other type refuses the key."),
959
+ reverse: z3.boolean().optional().describe("Reverse the value-axis direction on line and scatter; box ignores it with a warning, and every other type refuses it."),
960
+ gridlines: z3.boolean().optional().describe("Show value-axis gridlines where supported; default false."),
961
+ break: z3.union([z3.literal("auto"), z3.literal(!1), z3.object({
962
+ from: z3.number().describe("Lower value bounding the omitted domain span."),
963
+ to: z3.number().describe("Upper value bounding the omitted domain span."),
964
+ style: z3.enum(["straight"]).optional().describe("Break glyph style: 'straight'.")
965
+ }).superRefine((v, ctx) => {
966
+ v.from < v.to || ctx.addIssue({ code: "custom", message: "break requires from < to" });
967
+ }).describe(
968
+ "Straight value-axis break; the omitted span collapses to a fixed 12px gap when valid."
969
+ )]).describe("No break by default or with false. Waterfall and pvm alone accept 'auto' to choose a safe break; { from, to, style? } sets the omitted span. A valid straight break uses a fixed 12px gap and discloses the omitted range. Totals and levels stay visibly longer than smaller steps or segments and no shorter than equal ones. Unsafe automatic breaks move down when valid; unsafe authored breaks are ignored with a warning. An unbroken positive bridge gets an info hint when its smallest total divided by its largest step exceeds 10.").optional()
970
+ });
971
+ function sideKeyError(issue) {
972
+ let input = issue.input;
973
+ return input === "right" || typeof input == "object" && input !== null && input.position === "right" ? SIDE_KEY_REFUSED : void 0;
974
+ }
975
+ var keyPositionSchema = z3.enum(["top", "bottom"], { error: sideKeyError }).describe("Key position: 'top', one row above the plot, or 'bottom'. A key beside the plot ('right') is refused.");
976
+ function keyOptionSchema(values) {
977
+ return z3.union([
978
+ z3.enum(values).describe("Suppress keys, select explicit placement, or let visible series names determine whether automatic keys are needed."),
979
+ z3.object({
980
+ position: keyPositionSchema,
981
+ order: z3.array(idSchema).optional().describe("Legend item ids in the requested order; unspecified items follow.")
982
+ }).describe("Explicit legend placement and optional item order.")
983
+ ], { error: sideKeyError });
984
+ }
985
+ var baseOptionsSchema = z3.object({
986
+ target: renderTargetSchema.optional(),
987
+ textScale: textScaleSchema.optional(),
988
+ textSize: textSizeSchema.optional(),
989
+ a11y: z3.strictObject({
990
+ title: z3.boolean().optional().describe("Emit an SVG title element for hover text; default false. Accessible naming remains available."),
991
+ table: z3.enum(["hidden", "toggle", "below"]).optional().describe("Record-derived accessible data table rendered by the React chart components: 'hidden' keeps it available to assistive technology only, 'toggle' adds a disclosure control, 'below' renders it visibly under the chart. BoardplotChart includes it in the server output; a per-type component adds it after mount. Omitted: no table. The SVG is unchanged.")
992
+ }).optional().describe("Accessible presentation options; visible chart title is controlled separately by title."),
993
+ mode: z3.enum(["full", "compact"]).optional().describe("Presentation framing. Omitted: full at or above the chart minimum width, compact below it where the type draws there. Compact keeps the title at the theme smallest title size. Some chart-specific schemas use a different mode vocabulary."),
994
+ belowMinimum: z3.enum(["compact", "refuse"]).optional().describe("What a canvas below the chart minimum gets, on either axis, for the types with a compact floor: `measure` and `boardplot_describe` list it as `compactFloor`. 'compact' (default) draws the tight chart down to the floor: minimal labels, tight spacing, a smaller key, the whole title wrapped, and the subtitle dropped when the plot would be under 80 px. 'refuse' refuses below the minimum. On a canvas with a pinned size, a full-mode refusal for lack of room also falls back to compact under 'compact', and the chart is refused only when compact does not fit either. Types without a compact floor always refuse below their minimum, and every refusal names the minimum it needs.").meta({ default: "compact" }),
995
+ size: sizeSchema.optional().describe("Frame or preset. Defaults: report 720x405 px and dashboard 480x270 px automatic; slide 1184x528 px and print 267x180 mm fixed. Below minimum refuses with a verified size."),
996
+ // Embed claim (--embed-width twin). Strict: an `embed:{}` with no
997
+ // width would arm nothing — a silent no-op option — and unknown
998
+ // keys inside must refuse loudly rather than strip.
999
+ embed: z3.strictObject({ width: z3.number().positive().describe("Expected display width in CSS pixels, used to assess effective text size after scaling.") }).optional().describe("Declared host display width for readability checks; does not change chart geometry."),
1000
+ margin: marginSchema.optional().describe("Outer canvas margins in pixels; omitted sides use chart or theme defaults. canvas.margin overrides supplied sides."),
1001
+ canvas: z3.strictObject({ margin: marginSchema.optional().describe("Per-side outer margins overriding margin, then chart or theme defaults.") }).optional().describe("Canvas framing overrides applied before chart furniture is laid out."),
1002
+ title: z3.union([
1003
+ z3.string().describe("Visible chart title text."),
1004
+ z3.literal(!1).describe("Suppress the visible title while retaining the accessible chart name.")
1005
+ ]).optional().describe("Visible title override; omission retains the chart-specific title behaviour."),
1006
+ subtitle: subtitleSchema.optional().describe("Measure subtitle below the title; strings expand to the measure field."),
1007
+ unit: z3.string().optional().describe("Chart unit, composed into the subtitle where supported; individual series may declare their own units. A unit prints as text after the number, so unit 'USD' reads 2,456 USD. For a currency sign, set format instead, such as '$1,234'; a unit the format already prints warns unit-in-format, and a unit that names another currency than the format's sign warns unit-format-conflict."),
1008
+ unitShown: z3.boolean().optional().describe("True when the host prints the unit beside the chart: no unit line, no unit beside a kpi value; line end labels, a table head and the legend check treat the unit as shown. Number formatting does not change. Default false."),
1009
+ source: z3.string().optional().describe("Source credit rendered in the chart frame."),
1010
+ footnotes: z3.union([
1011
+ z3.array(z3.string().describe("Authored footnote text.")).describe("Footnotes in authored order; compact framing leaves optional notes off the canvas, keeps them in the accessible description and lists them in the info lint compact-notes-omitted."),
1012
+ z3.literal(!1).describe('No notes in the frame: authored notes, method notes, event keys and the "+N notes" pointer are left off. Disclosures that notes.show prints (rounding, partial periods, unlabelled values), the source line and a required map credit stay; leave source out for no source line. For a host that carries the notes in its own frame; the info lint footnotes-off lists what was left off and the render result lists every note in notes.')
1013
+ ]).optional().describe("Footnotes in authored order; the frame prints them within notes.maxLines and the rest go to the notes list. false leaves notes and the pointer off the frame; disclosures that notes.show prints, the source line and a required map credit stay."),
1014
+ notes: z3.object({
1015
+ maxListed: z3.union([
1016
+ z3.number().int().min(0).describe("Most items a note line names; the rest are counted. 0 names none and only counts them."),
1017
+ z3.literal("all").describe("Name every item.")
1018
+ ]).optional().describe(`Items a note line names before it counts the rest, such as "Not labelled on the chart: ... and 236 more". Default: every note line names as many items as fit two footer lines, at most 8, reference lines and line end values first, then the rest in data order, and ends with "and N more"; when no name fits, it counts. 'all' names every item. 0 names none and only counts them, "18 of 36 values". All items stay in the reading and the hover records.`).meta({ default: 8 }),
1019
+ placement: z3.enum(["frame", "info", "list"]).optional().describe(`Where the notes go. 'frame' prints notes in the frame within maxLines and the rest in the notes list; 'list' prints only the source line, a required map credit and the pointer; 'info' is the React "Notes and sources" button with one visible line of source and required credit (an SVG or PNG draws it as 'frame'). Default by target: dashboard 'info', slide 'list', report and print 'frame'.`),
1020
+ maxLines: z3.number().int().min(1).optional().describe("Visible lines of notes and source line in the frame; a required map credit and a disclosure do not count. Notes that do not fit go to the notes list and the pointer counts them. Default report and dashboard 3 (2 under 720 px wide), slide 2, print 3."),
1021
+ show: z3.array(z3.enum(["note", "method", "disclosure", "ranks"])).optional().describe("The kinds of note the frame prints. Default ['note'], the authored footnotes, within maxLines; an authored note a mark points at always prints. 'method' adds the one-line short form of the method notes the engine writes (likert net, pvm split). 'disclosure' adds the engine's notes on how to read the chart (a key, a data change, 'Not labelled on the chart: ...'), outside maxLines; then a chart may also key its marks to them, such as rank numbers under the columns. 'ranks' prints only the rank key: rank numbers under the columns where the names fit neither upright nor rotated, with the note that names them, and no other disclosure. Engine notes print nowhere under the chart by default; every note stays in the notes list of the render result and in its warnings."),
1022
+ pointer: z3.boolean().optional().describe('Default true: when the notes list holds notes of the kinds notes.show prints that the frame does not print, the source line ends with "+N notes".').meta({ default: !0 })
1023
+ }).strict().optional().describe("Notes; the footer rule: where the notes under the chart go, how many lines they take, and the note lines for what the drawing leaves out."),
1024
+ // any registered theme name (presets + registerTheme customs); existence
1025
+ // is checked at resolve time with a helpful error
1026
+ theme: z3.union([
1027
+ z3.string().min(1).describe("Registered theme name; existence is checked when resolving the theme."),
1028
+ z3.object({
1029
+ preset: z3.string().min(1).describe("Registered base theme whose tokens are overridden."),
1030
+ overrides: z3.record(z3.string(), z3.unknown().describe("Theme token override value; validated by theme resolution.")).optional().describe("Partial theme token tree merged with the named preset.")
1031
+ }).describe("Named theme with explicit token overrides.")
1032
+ ]).optional().describe("Theme preset or preset with overrides; request context may supply it, otherwise resolution uses boardroom."),
1033
+ locale: z3.object({
1034
+ language: z3.string().min(2).max(35).refine((tag) => canonicalLanguage(tag) !== null, { message: 'not a BCP 47 language tag; use a tag such as "de" or "de-DE"' }).optional().describe('BCP 47 language tag. Changes words only, such as notes and month names. It never changes the decimal or grouping marks; they come only from locale.decimal and locale.thousands. E.g. "de"; "de_DE" is read as "de-DE"; "en-US" puts the month first (Sep 4).'),
1035
+ decimal: z3.enum([".", ","]).optional().describe("Decimal mark of every number the chart prints. Default '.'. The language does not change it."),
1036
+ thousands: z3.enum([",", ".", "\u2019", " "]).optional().describe("Grouping mark of every number the chart prints. Default ',', or '.' with decimal ','. The language does not change it. A value equal to the decimal mark uses that fallback."),
1037
+ minusGlyph: z3.enum(["\u2212", "-"]).optional().describe("Minus glyph for locale-derived table formats; default Unicode minus."),
1038
+ weekStartsOn: z3.union([
1039
+ z3.literal(0).describe("Sunday as the requested first weekday."),
1040
+ z3.literal(1).describe("Monday as the requested first weekday.")
1041
+ ]).optional().describe("First weekday for week-granularity date ticks; default Monday. Line date ticks read this field, other layouts ignore it and report it.")
1042
+ }).optional().describe("Language and number marks. decimal and thousands set the marks of every number, as in a spreadsheet (default 1,234.5); a format example gives only the shape. language changes words only, never the marks."),
1043
+ strings: z3.object({
1044
+ newItems: z3.string().min(1).optional().describe("PVM entry-bar name; default New items."),
1045
+ lostItems: z3.string().min(1).optional().describe("PVM exit-bar name; default Lost items."),
1046
+ cohortMeasure: z3.string().trim().min(1).optional().describe("Cohort measure name for notes, keys and accessible descriptions; default Retention. Use Cumulative conversion for converted counts divided by cohort base."),
1047
+ cohortFormula: z3.string().trim().min(1).optional().describe("Complete cohort formula sentence for method notes and accessible descriptions. Wording only: rates still use the count and denominator selected by basis."),
1048
+ others: z3.string().min(1).optional().describe("Name of the aggregated rest bucket; default Others, and an explicit topN.restLabel still wins."),
1049
+ total: z3.string().min(1).optional().describe("Label of a computed total row; default Total."),
1050
+ source: z3.string().min(1).optional().describe("Word introducing the authored source credit; default Source."),
1051
+ notApplicable: z3.string().optional().describe("Not applicable text; n/a, German k. A."),
1052
+ legendCount: z3.string().optional().describe(`Legend disclosure wording; '{count}' becomes "2 of 4". Default depends on the legend subject.`),
1053
+ partial: z3.string().min(1).optional().describe("Word after the labels of partial categories in the column, bar, line and combo footnote, also the hatch key label; default Partial; a named key uses toDate."),
1054
+ better: z3.string().optional().describe("Meaning of a better sign-coloured value."),
1055
+ worse: z3.string().optional().describe("Meaning of a worse sign-coloured value."),
1056
+ positiveTotal: z3.string().optional().describe("Name of a mixed-sign stack positive boundary."),
1057
+ rangeMidNote: z3.string().optional().describe("Range method note."),
1058
+ sensitivityNote: z3.string().optional().describe("Tornado method note."),
1059
+ hatchedBaseNote: z3.string().optional().describe("Tornado base mismatch note."),
1060
+ missingSwingNote: z3.string().optional().describe("Tornado missing output note; {drivers} is replaced."),
1061
+ rankOmitted: z3.string().optional().describe("Focused bump note."),
1062
+ noRank: z3.string().optional().describe("A missing bump rank."),
1063
+ rankMethod: z3.string().optional().describe("Bump method note; {direction}, {format}, and {ring} are replaced."),
1064
+ higherBetter: z3.string().optional().describe("Direction of a bump rank."),
1065
+ lowerBetter: z3.string().optional().describe("Direction of a bump rank."),
1066
+ rankFormat: z3.string().optional().describe("Format clause in the bump method note."),
1067
+ rankRing: z3.string().optional().describe("Tie clause in the bump method note."),
1068
+ nearZeroNote: z3.string().optional().describe("Note for folded zero line ends."),
1069
+ flagged: z3.string().optional().describe("Anomaly marker key."),
1070
+ corridor: z3.string().optional().describe("Anomaly rule key."),
1071
+ corridorBounds: z3.string().optional().describe("Authored anomaly bounds key."),
1072
+ median: z3.string().optional().describe("Anomaly median rule label and key."),
1073
+ anomalySmallSample: z3.string().optional().describe("Small-sample anomaly sentence."),
1074
+ anomalyZeroMad: z3.string().optional().describe("Zero-MAD anomaly sentence."),
1075
+ anomalyMadRule: z3.string().optional().describe("MAD anomaly sentence; preserves the full calculation."),
1076
+ anomalyCentreZero: z3.string().optional().describe("Zero-centred anomaly rule clause."),
1077
+ anomalyCentreMedian: z3.string().optional().describe("Median-centred anomaly rule clause."),
1078
+ anomalyThresholdRule: z3.string().optional().describe("Threshold anomaly sentence."),
1079
+ outsideBounds: z3.string().optional().describe("Two-sided threshold clause."),
1080
+ belowBound: z3.string().optional().describe("Lower threshold clause."),
1081
+ aboveBound: z3.string().optional().describe("Upper threshold clause."),
1082
+ lowerBound: z3.string().optional().describe("Off-scale lower corridor bound."),
1083
+ upperBound: z3.string().optional().describe("Off-scale upper corridor bound."),
1084
+ undrawnBounds: z3.string().optional().describe("Off-scale corridor note."),
1085
+ hiddenLabels: z3.string().optional().describe("Heading of the note for hidden chart labels."),
1086
+ noteOne: z3.string().optional().describe("Pointer to one hidden note."),
1087
+ noteMany: z3.string().optional().describe("Pointer to hidden notes."),
1088
+ notesAndSources: z3.string().optional().describe("React notes panel label."),
1089
+ close: z3.string().optional().describe("React notes panel Close control. English Close; German Schlie\xDFen."),
1090
+ mapCredit: z3.string().optional().describe("Word before a map credit in the React notes panel."),
1091
+ gapBetween: z3.string().optional().describe("Key for a gap between two lines."),
1092
+ aboveSeries: z3.string().optional().describe("Positive line gap key."),
1093
+ belowSeries: z3.string().optional().describe("Negative line gap key."),
1094
+ average: z3.string().min(1).optional().describe("Name before a computed mean; English Average, German \xD8."),
1095
+ valueLineRange: z3.string().min(1, "valueLineRange must not be empty; use {v1} and {v2} for the formatted bounds").optional().describe("Tolerance-band bounds; {v1} and {v2} are the formatted bounds."),
1096
+ toDate: z3.string().min(1).optional().describe("Text after a running category name in its key or note."),
1097
+ forecast: z3.string().min(1).optional().describe("Key for the forecast pattern."),
1098
+ plan: z3.string().min(1).optional().describe("Key for the plan outline."),
1099
+ forecastHeader: z3.string().min(1).optional().describe("Header at the actual-to-forecast boundary. Keeps the scenario code by default."),
1100
+ net: z3.string().min(1).optional().describe("Name before a net total."),
1101
+ incomplete: z3.string().min(1).optional().describe("Marker on an incomplete stack total; prints under notes.show 'disclosure'."),
1102
+ range: z3.string().min(1).optional().describe("Key for a range whisker."),
1103
+ valuesNotOnColumns: z3.string().min(1).optional().describe("Note heading for omitted column values."),
1104
+ valuesNotBesideMarks: z3.string().min(1).optional().describe("Note heading for omitted combo values."),
1105
+ partialTotals: z3.string().min(1).optional().describe("Incomplete total note; {partial} is the marker."),
1106
+ knownPartsTotals: z3.string().min(1).optional().describe("Incomplete total note where the marker does not print. Column and combo only; a bar stack uses incompleteStacks."),
1107
+ without: z3.string().min(1).optional().describe("Word before missing stack parts."),
1108
+ and: z3.string().min(1).optional().describe("Word joining missing stack parts."),
1109
+ aboveZero: z3.string().min(1).optional().describe("Positive sign key; {series} and {meaning} are replaced."),
1110
+ belowZero: z3.string().min(1).optional().describe("Negative sign key; {series} and {meaning} are replaced."),
1111
+ declaredBounds: z3.string().min(1).optional().describe("Key for an authored uncertainty bound."),
1112
+ tied: z3.string().min(1).optional().describe("Label of a shared rank."),
1113
+ tiedSymbol: z3.string().min(1).optional().describe("Symbol before a displaced shared-rank label."),
1114
+ currentValue: z3.string().min(1).optional().describe("Football-field spine; {value} is replaced."),
1115
+ baseCase: z3.string().min(1).optional().describe("Tornado spine; {value} is replaced."),
1116
+ swingOutsideBase: z3.string().min(1).optional().describe("Tornado hatch key."),
1117
+ fanGap: z3.string().min(1).optional().describe("Missing uncertainty note; {categories} is replaced."),
1118
+ mixedShares: z3.string().min(1).optional().describe("Mixed-sign share note; {categories} is replaced."),
1119
+ heatBelow: z3.string().min(1).optional().describe("Key label of the bad side of a table's traffic-light heat lane (scale 'status'); default Below average, or Below total under center 'total'."),
1120
+ heatAround: z3.string().min(1).optional().describe("Key label of the warn band of a table's traffic-light heat lane; default Around average, or Around total."),
1121
+ heatAbove: z3.string().min(1).optional().describe("Key label of the good side of a table's traffic-light heat lane; default Above average, or Above total."),
1122
+ bandKey: z3.array(z3.string().trim().min(1)).min(2).max(5).optional().describe("Words of the bullet worse-to-better band key, worst first, one for each band (2 to 5). A list of another length than the bands keeps the built-in words (Worse ... Better; German with locale.language de)."),
1123
+ moreListed: z3.string().trim().min(1).optional().describe("Last item of a capped note line; '{count}' is the number left out. Default 'and {count} more'; a React chart with hover on reads 'and {count} more (hover shows each value)' unless this is set."),
1124
+ cellNote: z3.string().trim().min(1).optional().describe("Waffle note that names the share of one cell; '{value}' becomes the percent, such as 5%. Default 'One cell = {value}'."),
1125
+ storyBack: z3.string().min(1).optional().describe("Story Back button; default '\u2039 Back'."),
1126
+ storyNext: z3.string().min(1).optional().describe("Story Next button; default 'Next \u203A'."),
1127
+ storyCounter: z3.string().min(1).optional().describe("Story counter, unpadded '{step}' and '{count}'; default '{step} / {count}'."),
1128
+ storyStep: z3.string().min(1).optional().describe("Live region position with unpadded '{step}' and '{count}'; default 'Step {step} of {count}' (EN), 'Schritt {step} von {count}' (DE)."),
1129
+ axisLow: z3.string().min(1).optional().describe("Scatter qualitative axis low end; default 'Lower'."),
1130
+ axisHigh: z3.string().min(1).optional().describe("Scatter qualitative axis high end; default 'Higher'."),
1131
+ target: z3.string().trim().min(1).optional().describe("Word for the bullet comparison value in every phrase the bullet composes (vs target, of target, the keys, the hover card), such as plan; default target."),
1132
+ actualColumn: z3.string().trim().min(1).optional().describe("Head of the bullet column with the actual values; default Actual (German Ist)."),
1133
+ shareColumn: z3.string().trim().min(1).optional().describe("Head of the bullet percent-of-target column; '{v1}' is the comparison word. Default '% of {v1}'."),
1134
+ deltaColumn: z3.string().trim().min(1).optional().describe("Head of the bullet difference column on percent-of-target rows; '{v1}' is the comparison word. Default 'vs {v1}'."),
1135
+ targetColumn: z3.string().trim().min(1).optional().describe("Head of the bullet target column; default Target (German Ziel). The strings.target word heads it when this is not set."),
1136
+ gapColumn: z3.string().trim().min(1).optional().describe("Head of the bullet gap column; '{v1}' is the comparison word. Default 'Gap to {v1}'."),
1137
+ gapBelow: z3.string().trim().min(1).optional().describe("Line under a bullet gap that lies below the comparison value; '{v1}' is the comparison word. Default 'below {v1}'."),
1138
+ gapAbove: z3.string().trim().min(1).optional().describe("Line under a bullet gap that lies above the comparison value; '{v1}' is the comparison word. Default 'above {v1}'."),
1139
+ gapOn: z3.string().trim().min(1).optional().describe("Line under a bullet gap of zero; '{v1}' is the comparison word. Default 'on {v1}'."),
1140
+ nearZeroChange: z3.string().optional().describe("Table n.m. change note."),
1141
+ mixedCoverage: z3.string().optional().describe("Table n.m. note for a change between totals of different rows."),
1142
+ hiddenPeriods: z3.string().optional().describe("Dimswitch note for periods left out; {periods} is replaced."),
1143
+ share: z3.string().min(1).optional().describe("Cascade share-column heading."),
1144
+ histogramBins: z3.string().min(1).optional().describe("Histogram binning disclosure; {count}, {about}, {width}, {from}, {to} are replaced."),
1145
+ histogramAbout: z3.string().optional().describe("Histogram approximation word, including its trailing space."),
1146
+ histogramMethod: z3.string().min(1).optional().describe("Histogram method note; {count}, {width}, {from}, {rule}, {rounding}, {smallSample} are replaced."),
1147
+ histogramRuleCount: z3.string().min(1).optional().describe("Histogram authored bin-count rule name."),
1148
+ histogramRuleWidth: z3.string().min(1).optional().describe("Histogram authored bin-width rule name."),
1149
+ histogramSnapped: z3.string().min(1).optional().describe("Histogram rounded bin-width rule; {rule} is replaced."),
1150
+ histogramRounded: z3.string().optional().describe("Histogram rounded-number clause, including its separator."),
1151
+ histogramSmallSample: z3.string().optional().describe("Histogram small-sample clause, including its separator."),
1152
+ // required stack disclosures and rebase suppression.
1153
+ missingStack: z3.string().min(1).optional().describe("StackedArea source-null note; {categories} is replaced."),
1154
+ incompleteStacks: z3.string().min(1).optional().describe("Incomplete bar stack note (bar only; column and combo use knownPartsTotals); {categories} is replaced."),
1155
+ knownPartsShares: z3.string().min(1).optional().describe("Incomplete 100% stack note without total100; {categories} is replaced."),
1156
+ rebaseZero: z3.string().min(1).optional().describe("Line or stacked-area series left out by rebase100 for a zero base; {series} and {period} are replaced."),
1157
+ rebaseMissing: z3.string().min(1).optional().describe("Line or stacked-area series left out by rebase100 for a missing base; {series} and {period} are replaced.")
1158
+ }).strict().optional().describe("Wording of built-in labels. These are the labels the renderer composes itself: author chart text stays unchanged and an explicit option still wins per label; host-level wording comes from the theme provider."),
1159
+ format: formatExample.optional().describe(`Chart-level format-by-example, such as 1,234.5 or 1.2pp. A currency sign comes from here: '$1,234' prints $2,456. Its decimals are preserved; series and cell formats can override it. Without a format, precision follows the data. ${MAGNITUDE_WORDS_DOC} ${PERCENT_FORMAT_UNITS} A separator followed by exactly three digits after a nonzero integer part is a thousands mark: 1.000 groups thousands with a dot and prints decimals with a comma; write 0.000 for three decimals.`),
1160
+ detailFields: detailFieldsSchema.optional().describe("Label, format, unit and order of the cell details keys, the extra facts a value's hover card lists after it: [{ key: 'deals', label: 'Deals', format: '1,234' }]. Declared keys print first, in this order; a details key it does not declare prints after them, labelled with its key. Default: every key, labelled with itself."),
1161
+ smallValues: z3.enum(["bound", "zero", "scientific", "p-value"]).optional().describe("How an automatic number format prints a nonzero value below its last shown digit. Without a format, each table column and chart series takes one precision from its largest value: two significant digits below 1, at most 4 decimals. bound (default): the bound, <0.01 at two decimals, >\u22120.01 below zero, <1 for whole numbers; a signed change label keeps its sign, <+0.01; below 0.0001 a value prints in scientific form instead. zero: spreadsheet style, the format's own 0.00. scientific: two significant digits and a power of ten, 1.2 \xD7 10\u207B\u2079. p-value: every value from 0 to 1 prints as APA 7 writes a p-value, three decimals without the leading zero, .042, and <.001 below; larger values keep the rule above. A format the author sets prints as set."),
1162
+ palette: z3.string().min(1).optional().describe("Named identity ramp from theme color.palettes; every chart family takes its data ink from it, while good, bad and highlight stay the theme colours."),
1163
+ labelDensity: z3.enum(["full", "smart", "minimal"]).optional().describe("Label selection policy, default smart. full: every value label competes for a slot, and a segment value that does not fit its segment moves outside on a leader. smart: as full, but a stacked column or combo segment value prints inside its segment or not at all (where one is wider than its column, the stacked column values step down a size, to the floor; still too wide, none prints), and a segment value drops when the segment is shorter than the label height plus 4 px padding (the label width on a horizontal bar); mekko also drops segment values in columns narrower than 24 px. A labelPlacements pin keeps its label. minimal: keeps only the chart's essential labels (totals, endpoints, highlights). Collision suppression applies at every level."),
1164
+ labels: z3.union([
1165
+ z3.literal(!1).describe("Suppress optional data labels for chart types supporting this option."),
1166
+ z3.record(z3.string(), z3.union([
1167
+ z3.boolean().describe("Enable or suppress this label kind."),
1168
+ z3.array(z3.string().describe("Requested label content, such as absolute, percent, category or series; supported values depend on the chart.")).describe("Ordered content parts for this label kind.")
1169
+ ]).describe("Visibility or requested content for the named label kind.")).describe("Per-kind label settings, keyed by label kind.")
1170
+ ]).optional().describe("Label visibility and content overrides; omission uses the selected chart policy. Unsupported chart types refuse this shared option. false turns optional labels off. An object maps a label kind (category, series, segment, point, total, grandTotal, insidePie, outsidePie, percentIndicator, restSeries, tick, axisTitle, valueLine, annotation, growth, activity, item; each chart reads its own, and a kind it does not read is refused) to true, false or content parts from absolute, percent, category and series. On a stacked column with one PY reference series, { growth: false } drops the growth arrows over the totals (\u2191 6.1%) and keeps the PY ticks and their labels; { percentIndicator: false } drops the 100% marker of a 100% chart. On bar, box, column, combo, dot, line, Mekko, slope and variance, false keeps category names; { category: false } hides them. On bullet, butterfly, funnel, heatmap, pyramid and status, false keeps the row, column and stage names; on kpi it keeps the main number and the card name. Grid panels can leave category names to the grid. On a line, series false turns the series names off and point sets what each printed value shows, so { point: ['category', 'absolute'] } prints 08-16 44.7 at the point. On a stacked column or combo, { segment: ['absolute', 'percent'] } prints each segment value over its share of the stack; a stack with a negative or missing part prints the value alone and warns. restSeries sets the values of a stacked column, bar or area series whose colorRole is others: absent, they print everywhere except the dashboard target, where the hover card and the note line carry them; true prints them, false hides and notes them on every target."),
1171
+ categoryLabels: categoryLabelsSchema,
1172
+ labelPlacements: z3.record(z3.string(), z3.string().describe("Requested solver slot id, such as insideCenter.")).optional().describe("Authored placement pins keyed by label id; the solver checks each requested slot. On a line, a pinned end label removes the legend step of the end-label ladder. The slots a label can take depend on the chart and its data; a wrong slot warns unknown-slot and lists the valid and free slots of that render."),
1173
+ legend: keyOptionSchema(["top", "bottom", "none", "auto"]).optional().describe(
1174
+ "A key without a named position sits in one row above the plot, flush with it, under the subtitle; more items wrap to further rows and move the plot down. 'bottom' puts the row under the plot. 'right' is refused: a key beside the plot takes the plot's width. 'auto' adds keys when visible labels do not name every drawn series. A displayed subtitle measure or unit can name one primary series, matching the complete phrase without case sensitivity. Required explanatory keys remain, except the keys of a table, heatmap, cohort and variance, which 'none' drops for a host that draws its own. Automatic keys use footnote type in the top row. Explicit settings override theme.legend.auto, which defaults to false. Multi-series column, bar, combo, dot and scatter charts add a key when direct names are missing. A series key explains its scenario styling. Grids keep a required key under 'none' when direct names are incomplete."
1175
+ ),
1176
+ valueAxis: valueAxisSchema.optional().describe("Value-axis display and domain settings; each chart schema narrows the supported fields."),
1177
+ categoryAxis: z3.object({
1178
+ crossesBetween: z3.boolean().optional().describe("Line-chart category placement: default true centres categories in bands; false places the end categories at the plot edges."),
1179
+ dateTicks: z3.enum(["years", "quarters", "months", "weeks", "days"]).optional().describe("Line-chart date tick interval. A short tick under the plot marks the first category of each calendar interval. 'years', 'quarters' and 'months' name those ticks on the calendar: quarters read Jan, Apr, Jul, Oct. A row too narrow for every name keeps a larger round step counted from January (years 2, 5, 10, 20, 25, 50 or 100, so every tenth year from 1980; quarters 2, 4, 8, 20 or 40; months 2, 3, 6, 12, 24, 60 or 120), at most eight names. The latest period is always named; if it collides with the tick before it, that tick drops. 'weeks' and 'days' count equal steps back from the latest period (weeks 2, 4, 13, 26 or 52; days 2, 7, 14 or 28) and name it too. 'years' names the year alone ('Jan 1980' reads 1980) where the label carries it. 'months' over day dates the engine labels names the month ('1 Apr 2025' reads Apr 2025, then May, Jun). A monthly series through July 2026 with 'years' reads 1980, 1990, 2000, 2010, 2020, Jul 2026. Without dateTicks, column, stacked column, line, area and combo pick tick months by the same calendar rule for rows of months and quarters (step 3: Jan, Apr, Jul, Oct; step 6: Jan, Jul; step 12: Jan; plus the latest period) and count back from the latest period for days and weeks, so side-by-side panels with the same categories show the same months. A line or area day row that would step past 28 days names months as 'months' does. Categories without an ISO date leave the option unused and report date-ticks-unsupported.")
1180
+ }).optional().describe("Category-axis settings implemented by line charts; other shared-base charts refuse this option."),
1181
+ secondaryAxis: z3.object({ acknowledge: z3.literal(!0).describe("Explicitly acknowledge that the chart uses an independent second value scale.") }).optional().describe("Opt in to a second value scale on supported charts; combo adds chart-specific secondary-axis options."),
1182
+ scaleGroup: z3.object({
1183
+ // x shares nothing: no type reads back or pins its x domain, so it is refused.
1184
+ x: z3.never({ error: "'scaleGroup.x' is not implemented \u2014 only the value scale is shared, through scaleGroup.y; no chart type pins its x domain. Drop x" }).optional().describe("Refused: no chart type shares an x scale. Share the value scale with scaleGroup.y."),
1185
+ y: z3.string().optional().describe("Shared value-scale group id for compatible grid panels, charts of one envelope or separately mounted cards; members of the same group use a combined domain."),
1186
+ id: z3.string().optional().describe("Stable member id inside the scale group declared on the host ScaleGroup; reordering or removing cards does not change which member this chart is.")
1187
+ }).optional().describe("Scale-group identities for panel composition. Charts of one envelope that name the same y group draw on one domain, and a chart that cannot join (another unit, no numeric y scale) refuses the request. A chart alone in its group, or a single chart, keeps its own scale for the host to share. x is refused: no chart type shares an x scale."),
1188
+ rowLabels: z3.object({
1189
+ align: z3.enum(["left", "right"]).optional().describe(
1190
+ "Row-label alignment on a horizontal category axis; defaults to 'left' (one shared left edge), and to 'right' on a dot chart. 'right' pushes each label block against the plot."
1191
+ )
1192
+ }).optional().describe("Row-label alignment for the horizontal families (bar, bullet, box, dot, likert)."),
1193
+ sort: z3.object({
1194
+ categories: z3.enum(["sheet", "asc", "desc", "reverse"]).optional().describe("Category order: sheet preserves authored order, reverse reverses it, asc and desc use the chart category ranking value."),
1195
+ segments: z3.enum(["sheet", "asc", "desc", "reverse"]).optional().describe("Segment order: sheet preserves authored order, reverse reverses it, asc and desc use the chart segment ranking value.")
1196
+ }).optional().describe("Sorting requests for charts that support them; omitted settings preserve the chart default ordering."),
1197
+ topN: z3.object({
1198
+ n: z3.number().int().positive().describe("Maximum number of individually retained categories after chart-specific ranking."),
1199
+ rest: z3.boolean().optional().describe("Aggregate remaining categories into a rest bucket by default; false omits them where supported. Pareto retains the bucket to preserve its population."),
1200
+ restLabel: z3.string().optional().describe("Authored rest-bucket name; ordinary charts default to Others and Pareto to Rest."),
1201
+ showRestCount: z3.boolean().optional().describe("Append the number of aggregated categories; ordinary charts default to false, while Pareto always discloses the count."),
1202
+ threshold: z3.number().optional().describe("Bar-chart minimum absolute category total after the rank cut; not a universal Top-N threshold. Pareto warns that it ignores this field.")
1203
+ }).optional().describe("Chart-specific Top-N selection and rest aggregation; omission retains all categories. On a choropleth world map, topN.n picks the n regions it labels, largest absolute value first; other maps label every region."),
1204
+ // No registered layout implements this. Accepting it on the shared base
1205
+ // would let every type answer `ok:true` to `transpose: true` and draw the
1206
+ // identical chart.
1207
+ // `z.never` refuses it out loud instead — the same call the `break.style`
1208
+ // enum above makes: never advertise a value the runtime rejects 100% of the
1209
+ // time. Orientation here is a chart TYPE, so the message names the type.
1210
+ transpose: z3.never({ error: TRANSPOSE_REFUSED }).optional().describe("Refused on every type: orientation is chosen by picking the chart type ('bar' vs 'column')."),
1211
+ bandFraction: z3.number().gt(0).lte(1).optional().describe("Fraction of a category band occupied by its mark, greater than zero and at most one; default is chart-specific, commonly 0.7."),
1212
+ highlight: z3.union([idSchema, z3.array(idSchema).describe("Data ids to highlight together.")]).optional().describe("One or more data ids selected for chart-specific visual emphasis. Selected marks take color.focus, and color.highlight on a theme that sets no focus. On a single-series bar, column or dot chart the named categories take it and every other mark steps back to color.neutralLight, the rest role. A series fill or colorRole outranks both colours; scenario marks keep their pattern and signColor its good/bad colours, and unhighlighted scenario marks keep their scenario colour. A highlight with no visible mark (null, or a zero bar or column) recedes nothing. On a line the named series take it at 2.6px and the others step through muted tints toward ink, with a swatch on each end label. On an unstacked area with several series the first named series is the one that is filled."),
1213
+ story: z3.strictObject({
1214
+ steps: z3.array(z3.strictObject({
1215
+ id: z3.string().min(1).describe("Step id, as the React step prop names it."),
1216
+ title: z3.string().min(1).describe("Panel title."),
1217
+ body: z3.string().optional().describe("Panel text."),
1218
+ highlight: z3.union([idSchema, z3.array(idSchema)]).optional().describe("Data ids the step brings forward, as in highlight; the other marks fade. Omitted: an intro.")
1219
+ })).min(1).describe("Steps in order."),
1220
+ step: z3.string().min(1).optional().describe("Step static output draws; default the first.")
1221
+ }).optional().describe("Guided steps over one chart. Each step fades the marks it does not name and shows a panel with its title and body. React needs withStory from boardplot/react/story."),
1222
+ focus: z3.strictObject({
1223
+ owner: ownerSchema.refine((owner) => Object.values(owner).some((value) => value !== void 0), {
1224
+ message: "A focus owner needs at least one source identity."
1225
+ }).describe("Source owner to emphasise. A label is selected when its own owner carries every key named here with the same value, so a seriesId alone selects that series and a seriesId+categoryId pair selects one point.")
1226
+ }).nullable().optional().describe("Active source focus: labels whose owner the focus selects sort ahead in the solve order, because the focus adds a 250-point bonus to the label's sort key on top of its authored priority. The bonus can carry a focused label past a higher authored band, which is the point: a focused series or category wins contested label space. Layout only \u2014 totals, shares, scales and claims are unchanged, and a focused label still loses to the density gate, to an owned pin and to a collision. Omit the key (or set null) for byte-identical layout; null clears an inherited focus explicitly. On a grid, set it on the panel options that own the focus; sibling panels are separate layouts and never see it."),
1227
+ hatchStrength: z3.number().min(0, { error: "hatchStrength runs from 0 to 100; set 0 for the faintest hatch that still reads, 100 for the theme's recipe" }).max(100, { error: "hatchStrength runs from 0 to 100; set 100 for the theme's recipe, lower for a lighter hatch" }).optional().describe("How strongly forecast, partial-period and no-data hatches draw, 0 to 100; 100 is the theme's recipe. Lower values fade the stripes toward their ground and, on a line or area forecast, spread them up to 2.5 times the theme's gap. The fade stops at a floor: where the hatch is the only cue (a forecast column or bar, a partial period, a no-data cell) the stripes keep 3:1 on their ground and their spacing; on a line or area forecast, where the dashed line, the divider and the key already mark the forecast, they keep 2:1. A status cell lays its stripes on its own tone: there 60 is the theme's recipe at 3:1, 100 deepens the stripes to 4.5:1 on the same ground, and lower values fade them only as far as the cell stays apart from a cell with no status. Default 60 on a line or area forecast and a status cell, 100 elsewhere. The key swatch draws the same hatch."),
1228
+ colorblindSafe: z3.boolean().optional().describe("Paint the semantic good/bad pair from theme.color.colorblind, a pair told apart without red and green: signed bars and columns, variance bars, status cells, heatmap valence cells, table tones, heat grounds, in-cell bars and badges, and the poles of a diverging choropleth or tilemap scale. Other types refuse this option. Use palette for categorical colours."),
1229
+ rounding: z3.enum(["nearest", "sum-consistent"]).optional().describe("How computed shares print. nearest rounds each share separately. sum-consistent uses largest remainders to total 100%. 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. reading.rounding lists changes. Use format: 1.0% for one decimal. Mekko cell, series and chart share formats set the precision. Bar, column and combo stacks default to sum-consistent for each complete stack; a column's shares keep the chart's one share precision or shareLabels.format. Incompatible precisions or more than 13 decimals warn and keep the requested formats without sum-consistent rounding."),
1230
+ animate: z3.boolean().optional().describe("Reserved motion flag; registered charts currently refuse it because the engine emits static geometry."),
1231
+ interactive: z3.boolean().optional().describe("Emit data-bp-* semantics for dependency-free web interactivity; static output is unchanged by default."),
1232
+ debug: z3.boolean().optional().describe("Reserved layout debug flag; registered charts refuse it."),
1233
+ annotations: annotationArraySchema(annotationSchema).optional().describe("Data-bound annotations in authored order; explicit ids must be unique and each chart advertises its supported kinds.")
1234
+ }).superRefine(addCanvasBoundsIssues).describe("Shared JSON chart options; selected chart schemas narrow unsupported fields and add chart-specific settings."), anomalyOptionSchema = z3.union([
1235
+ z3.object({
1236
+ method: z3.literal("mad").describe("Use median absolute deviation to derive the anomaly corridor."),
1237
+ k: z3.number().positive().optional().describe(
1238
+ "Flag threshold on the absolute modified z-score; default 3.5, the published threshold of the modified z-score method with the 1.4826 MAD scale. Do not pair it with a 3.0 rule of thumb from a different method."
1239
+ ).meta({ default: 3.5 }),
1240
+ baseline: z3.enum(["zero", "median"]).optional().describe(
1241
+ "Centre of the judgement. 'zero' (default) reads the input as an already-computed deviation (surprise vs consensus, net cash movement, residual); 'median' centres on the series' own median. The SPREAD is measured around the actual median in both cases, so derived.anomaly reports `centre` and `median` as separate fields \u2014 under 'zero' they differ, and a levels series hands to this rule will flag almost everything (anomaly-most-flagged)."
1242
+ ).meta({ default: "zero" }),
1243
+ label: z3.string().optional().describe(
1244
+ "Names the rule on the exhibit. It is prefixed to the derived sentence, never a replacement \u2014 the median, MAD, k and corridor always stay printed."
1245
+ )
1246
+ }),
1247
+ z3.object({
1248
+ method: z3.literal("threshold").describe("Use authored low/high bounds to flag anomalies."),
1249
+ low: z3.number().optional().describe("Flag values strictly below this bound."),
1250
+ high: z3.number().optional().describe("Flag values strictly above this bound."),
1251
+ label: z3.string().optional().describe("Names the rule on the exhibit; the bounds stay printed.")
1252
+ })
1253
+ ]), averageMarkerSchema = z3.union([
1254
+ z3.boolean(),
1255
+ z3.object({
1256
+ scope: z3.union([z3.literal("all"), z3.array(idSchema).min(1)]).describe("Series included in the computed average; defaults to 'all'.")
1257
+ })
1258
+ ]).optional();
1259
+ function narrowValueAxis(type, base) {
1260
+ let refusals = {};
1261
+ for (let key of Object.keys(valueAxisSchema.shape)) {
1262
+ let why = valueAxisRefusal(type, key);
1263
+ if (why === void 0) continue;
1264
+ let suggest = valueAxisReason(type, key, why);
1265
+ refusals[key] = z3.never({ error: notImplemented(`valueAxis.${key}`, type, suggest) }).optional().describe(`Refused on '${type}': ${suggest}`);
1266
+ }
1267
+ if (valueAxisRefusal(type, "break") === void 0 && type !== "waterfall" && type !== "pvm") {
1268
+ let [, noBreak, authoredBreak] = valueAxisSchema.shape.break.unwrap().options;
1269
+ refusals.break = z3.union([noBreak, authoredBreak]).optional().describe("No break by default or with false. Set { from, to, style? } for a straight value-axis break; the omitted span collapses to a fixed 12px gap when valid. Automatic placement is supported only by waterfall and pvm.");
1270
+ }
1271
+ return Object.keys(refusals).length ? base.safeExtend(refusals) : base;
1272
+ }
1273
+ function refusedBaseOptions(type) {
1274
+ let out = {};
1275
+ for (let [key, capability] of Object.entries(OPTION_CAPABILITY)) {
1276
+ if (capability.implementedBy.includes(type) || "unsupportedSeverity" in capability && capability.unsupportedSeverity === "warn") continue;
1277
+ let suggest = OPTION_REASONS[key];
1278
+ out[key] = z3.never({ error: notImplemented(key, type, suggest) }).optional().describe(`Refused on '${type}': ${suggest}`);
1279
+ }
1280
+ if (Object.hasOwn(LEGEND_DRAWS, type)) {
1281
+ let values = LEGEND_DRAWS[type], why = LEGEND_DRAWS_REASONS[type];
1282
+ out.legend = baseOptionsSchema.shape.legend.unwrap().superRefine((value, ctx) => {
1283
+ legendDrawsNothing(type, value) && ctx.addIssue({ code: "custom", message: `legend '${String(value)}' draws nothing on '${type}' \u2014 ${why}`, params: { refused: !0 } });
1284
+ }).optional().describe(`On '${type}' only ${values.map((value) => `'${value}'`).join(" and ")} or a position object draw a key: ${why}.`);
1285
+ }
1286
+ LEGEND_REFUSED.includes(type) && (out.legend = z3.never({ error: notImplemented("legend", type, LEGEND_REFUSED_REASONS[type]) }).optional().describe(`Refused on '${type}': ${LEGEND_REFUSED_REASONS[type]}`));
1287
+ let only = valueAxisOnly(type), valueAxis = narrowValueAxis(type, valueAxisSchema);
1288
+ return only?.keys.length === 0 ? out.valueAxis = z3.never({ error: notImplemented("valueAxis", type, VALUE_AXIS_ONLY_REASONS[type]) }).optional().describe(`Refused on '${type}': ${VALUE_AXIS_ONLY_REASONS[type]}`) : valueAxis !== valueAxisSchema && (out.valueAxis = valueAxis.optional().describe(baseOptionsSchema.shape.valueAxis.description)), out;
1289
+ }
1290
+ function refuseUnstackedShares(options, ctx) {
1291
+ options.sharesOfOneWhole === void 0 || options.variant === "stacked" || options.variant === "stacked100" || ctx.addIssue({
1292
+ code: "custom",
1293
+ path: ["sharesOfOneWhole"],
1294
+ message: `sharesOfOneWhole declares the parts of a stack; variant '${options.variant ?? "grouped"}' stacks nothing. Set variant 'stacked' or 'stacked100', or remove it`,
1295
+ params: { refused: !0 }
1296
+ });
1297
+ }
1298
+ var readerStringsSchema = z3.object({
1299
+ refusalMessage: z3.string().optional().describe("Reader heading for a size refusal. Legacy width and height templates remain available only in full diagnostics."),
1300
+ refusalHint: z3.string().optional().describe("Reader hint for a size refusal; EN and DE defaults."),
1301
+ emptyMessage: z3.string().optional().describe("Reader heading for empty data; EN and DE defaults."),
1302
+ emptyHint: z3.string().optional().describe("Reader hint for empty data; EN and DE defaults."),
1303
+ failureMessage: z3.string().optional().describe("Reader heading when a chart cannot be shown; EN and DE defaults."),
1304
+ failureHint: z3.string().optional().describe("Reader hint when a chart cannot be shown; EN and DE defaults."),
1305
+ diagnosticDetails: z3.string().optional().describe("Label for the developer details disclosure; default Details.")
1306
+ });
1307
+
1308
+ export {
1309
+ categoryLabelsSchema,
1310
+ sanitizeObjectPrototype,
1311
+ missingChartName,
1312
+ DocExpansionError,
1313
+ expandDoc,
1314
+ TYPE_REFUSED_REASONS,
1315
+ notImplemented,
1316
+ refusalSuggest,
1317
+ idSchema,
1318
+ categoryDateSchema,
1319
+ partialCategorySchema,
1320
+ categorySchemaOf,
1321
+ comparisonDirectionSchema,
1322
+ colorRoleField,
1323
+ addDuplicateIdIssues,
1324
+ addCategorySeriesIdIssues,
1325
+ addGeoIdIssues,
1326
+ diagnosedSafeParse,
1327
+ parseData,
1328
+ formatExample,
1329
+ contextFormatExample,
1330
+ valueKindSchema,
1331
+ dataValueKindSchema,
1332
+ MAGNITUDE_WORDS_DOC,
1333
+ scenarioField,
1334
+ cellMetaSchema,
1335
+ boundedNumber,
1336
+ cellSchema,
1337
+ cellDetailsSchema,
1338
+ detailCellSchema,
1339
+ addCanvasBoundsIssues,
1340
+ renderTargetSchema,
1341
+ sizeSchema,
1342
+ eventOptionsSchema,
1343
+ annotationSchema,
1344
+ timeAnnotationSchema,
1345
+ annotationArraySchema,
1346
+ addProjectedDashIssues,
1347
+ derivedRatioTierSchema,
1348
+ primaryAxisTitleSchema,
1349
+ valueAxisSchema,
1350
+ sideKeyError,
1351
+ keyPositionSchema,
1352
+ baseOptionsSchema,
1353
+ anomalyOptionSchema,
1354
+ averageMarkerSchema,
1355
+ narrowValueAxis,
1356
+ refusedBaseOptions,
1357
+ refuseUnstackedShares,
1358
+ readerStringsSchema
1359
+ };