@bino-bi/bn-template-engine 1.0.0-next.26 → 1.0.0-next.28

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 (420) hide show
  1. package/dist/bn-template-engine/bn-template-engine.esm.js +1 -1
  2. package/dist/bn-template-engine/p-5075771a.entry.js +1 -0
  3. package/dist/bn-template-engine/p-5d516435.entry.js +1 -0
  4. package/dist/bn-template-engine/p-5e90e728.entry.js +1 -0
  5. package/dist/bn-template-engine/p-9ef7e132.entry.js +1 -0
  6. package/dist/bn-template-engine/{p-f06c3703.entry.js → p-9f7a1980.entry.js} +1 -1
  7. package/dist/bn-template-engine/p-BeXgxHkW.js +1 -0
  8. package/dist/bn-template-engine/p-CH0bpt_k.js +1 -0
  9. package/dist/bn-template-engine/p-ClruFZD_.js +1 -0
  10. package/dist/bn-template-engine/{p-CTrNbSXN.js → p-DFmSrSnf.js} +1 -1
  11. package/dist/bn-template-engine/{p-BcLsoDrW.js → p-DI3efDSV.js} +1 -1
  12. package/dist/bn-template-engine/p-DXLTTILG.js +1 -0
  13. package/dist/bn-template-engine/p-DtP4jqG5.js +1 -0
  14. package/dist/bn-template-engine/p-a8281b71.entry.js +1 -0
  15. package/dist/bn-template-engine/p-b31277e7.entry.js +1 -0
  16. package/dist/bn-template-engine/p-b396ac84.entry.js +1 -0
  17. package/dist/cjs/{bn-asset_21.cjs.entry.js → bn-asset_28.cjs.entry.js} +21358 -6528
  18. package/dist/cjs/bn-grid.cjs.entry.js +4 -6
  19. package/dist/cjs/bn-image.cjs.entry.js +3 -5
  20. package/dist/cjs/bn-internationalization.cjs.entry.js +17 -6
  21. package/dist/cjs/bn-ruleset.cjs.entry.js +5 -5
  22. package/dist/cjs/bn-template-engine.cjs.js +1 -1
  23. package/dist/cjs/bn-template.cjs.entry.js +2 -2
  24. package/dist/cjs/bn-text.cjs.entry.js +115 -43
  25. package/dist/cjs/{context-protocol-DcTEh1rq.js → context-protocol-C0rKepqu.js} +108 -22
  26. package/dist/cjs/{diagnostics-CTgbq_Gc.js → diagnostics-Cq-qDtXq.js} +1 -1
  27. package/dist/cjs/editor-companion.cjs.entry.js +2 -2
  28. package/dist/cjs/loader.cjs.js +1 -1
  29. package/dist/cjs/queryError-BZjnIW_w.js +16 -0
  30. package/dist/cjs/{scaling-Dsb5_NXy.js → sanitizeHtml-Yx1xn6i_.js} +467 -287
  31. package/dist/cjs/{withBodyObserver-DJO98AJ-.js → withBodyObserver-CaPUjuC5.js} +1 -1
  32. package/dist/cjs/withHasError-qGW_yqIv.js +426 -0
  33. package/dist/cjs/{withStyled-D0jLwCib.js → withStyled-vSfogp9J.js} +543 -42
  34. package/dist/collection/components/bn-chart-bubble/bn-chart-bubble.css +37 -0
  35. package/dist/collection/components/bn-chart-bubble/bn-chart-bubble.js +53 -28
  36. package/dist/collection/components/bn-chart-bubble/ibcs-chart-bubble.css +37 -5
  37. package/dist/collection/components/bn-chart-bubble/ibcs-chart-bubble.js +16 -7
  38. package/dist/collection/components/bn-chart-bubble/utils/BubbleChart.js +67 -30
  39. package/dist/collection/components/bn-chart-bullet/bn-chart-bullet.css +37 -0
  40. package/dist/collection/components/bn-chart-bullet/bn-chart-bullet.js +49 -29
  41. package/dist/collection/components/bn-chart-bullet/ibcs-chart-bullet.css +37 -5
  42. package/dist/collection/components/bn-chart-bullet/ibcs-chart-bullet.js +17 -7
  43. package/dist/collection/components/bn-chart-bullet/utils/BulletChart.js +34 -18
  44. package/dist/collection/components/bn-chart-bullet/utils/model/BulletChartStyle.js +2 -0
  45. package/dist/collection/components/bn-chart-bullet/utils/model/BulletConfig.js +1 -1
  46. package/dist/collection/components/bn-chart-scatter/bn-chart-scatter.css +37 -0
  47. package/dist/collection/components/bn-chart-scatter/bn-chart-scatter.js +52 -27
  48. package/dist/collection/components/bn-chart-scatter/ibcs-chart-scatter.css +37 -5
  49. package/dist/collection/components/bn-chart-scatter/ibcs-chart-scatter.js +16 -7
  50. package/dist/collection/components/bn-chart-scatter/utils/ScatterChart.js +52 -18
  51. package/dist/collection/components/bn-chart-structure/bn-chart-structure.css +37 -5
  52. package/dist/collection/components/bn-chart-structure/bn-chart-structure.js +74 -44
  53. package/dist/collection/components/bn-chart-structure/ibcs-chart-structure.js +60 -19
  54. package/dist/collection/components/bn-chart-structure/utils/StructureChart.js +218 -262
  55. package/dist/collection/components/bn-chart-structure/utils/elements/Label.js +1 -1
  56. package/dist/collection/components/bn-chart-structure/utils/elements/Needle.js +11 -4
  57. package/dist/collection/components/bn-chart-structure/utils/elements/StackedBar.js +16 -25
  58. package/dist/collection/components/bn-chart-structure/utils/model/StructureChartComponentConfig.js +3 -2
  59. package/dist/collection/components/bn-chart-structure/utils/model/styles/StructureChartStyle.js +2 -0
  60. package/dist/collection/components/bn-chart-time/bn-chart-time.css +37 -0
  61. package/dist/collection/components/bn-chart-time/bn-chart-time.js +122 -52
  62. package/dist/collection/components/bn-chart-time/ibcs-chart-time.css +37 -0
  63. package/dist/collection/components/bn-chart-time/ibcs-chart-time.js +60 -19
  64. package/dist/collection/components/bn-chart-time/utils/TimeChart.js +245 -250
  65. package/dist/collection/components/bn-chart-time/utils/elements/AreaFill.js +1 -1
  66. package/dist/collection/components/bn-chart-time/utils/elements/Label.js +1 -1
  67. package/dist/collection/components/bn-chart-time/utils/elements/LineSeries.js +1 -1
  68. package/dist/collection/components/bn-chart-time/utils/elements/Needle.js +11 -4
  69. package/dist/collection/components/bn-chart-time/utils/elements/StackedColumn.js +22 -34
  70. package/dist/collection/components/bn-chart-time/utils/helper/LabelCollisionManager.js +3 -3
  71. package/dist/collection/components/bn-chart-time/utils/model/TimeChartComponentConfig.js +4 -3
  72. package/dist/collection/components/bn-chart-time/utils/model/TimeChartDataRow.js +2 -2
  73. package/dist/collection/components/bn-chart-time/utils/model/styles/TimeChartStyle.js +2 -0
  74. package/dist/collection/components/bn-component-style/bn-component-style.js +14 -2
  75. package/dist/collection/components/bn-context/bn-context.js +92 -22
  76. package/dist/collection/components/bn-dataset/bn-dataset.js +246 -90
  77. package/dist/collection/components/bn-datasource/bn-datasource.js +169 -77
  78. package/dist/collection/components/bn-footer/bn-footer.js +6 -6
  79. package/dist/collection/components/bn-internationalization/bn-internationalization.js +14 -3
  80. package/dist/collection/components/bn-layout-card/bn-layout-card.js +25 -74
  81. package/dist/collection/components/bn-layout-page/bn-layout-page.js +59 -71
  82. package/dist/collection/components/bn-message/bn-message.js +2 -2
  83. package/dist/collection/components/bn-page/bn-page.css +0 -240
  84. package/dist/collection/components/bn-page/bn-page.js +14 -4
  85. package/dist/collection/components/bn-page/pageFormats.js +69 -0
  86. package/dist/collection/components/bn-ruleset/bn-ruleset.js +2 -2
  87. package/dist/collection/components/bn-scaling-group/bn-scaling-group.js +7 -7
  88. package/dist/collection/components/bn-table/bn-table.css +38 -1
  89. package/dist/collection/components/bn-table/bn-table.js +96 -59
  90. package/dist/collection/components/bn-table/ibcs-table.css +39 -1
  91. package/dist/collection/components/bn-table/ibcs-table.js +89 -30
  92. package/dist/collection/components/bn-table/utils/Table.js +12 -13
  93. package/dist/collection/components/bn-table/utils/elements/Cell.js +9 -3
  94. package/dist/collection/components/bn-table/utils/elements/CellBarChart.js +38 -34
  95. package/dist/collection/components/bn-table/utils/elements/TableRow.js +2 -1
  96. package/dist/collection/components/bn-table/utils/elements/WaterfallBar.js +4 -4
  97. package/dist/collection/components/bn-table/utils/factories/tableDataSetFactory.js +17 -4
  98. package/dist/collection/components/bn-table/utils/helper/DataQuery.js +128 -98
  99. package/dist/collection/components/bn-table/utils/helper/IntervalColumns.js +6 -20
  100. package/dist/collection/components/bn-table/utils/helper/QueryGroup.js +9 -2
  101. package/dist/collection/components/bn-table/utils/helper/barColumnGeometry.js +2 -2
  102. package/dist/collection/components/bn-table/utils/model/TableAttribute.js +2 -2
  103. package/dist/collection/components/bn-table/utils/model/TableComponentConfig.js +3 -2
  104. package/dist/collection/components/bn-template/bn-template.js +1 -1
  105. package/dist/collection/components/bn-text/bn-text.js +36 -39
  106. package/dist/collection/components/bn-text/utils/template.js +79 -0
  107. package/dist/collection/components/bn-title/bn-title.js +10 -4
  108. package/dist/collection/components/bn-title/ibcs-title/ibcs-title.js +3 -1
  109. package/dist/collection/components/bn-tree/bn-tree.js +119 -23
  110. package/dist/collection/components/bn-tree/utils/EdgeRenderer.js +59 -51
  111. package/dist/collection/components/bn-tree/utils/TreeLayout.js +30 -5
  112. package/dist/collection/components/bn-tree/utils/TreeParser.js +35 -0
  113. package/dist/collection/components/editor-companion/editor-companion.js +1 -1
  114. package/dist/collection/context/context-protocol.js +1 -1
  115. package/dist/collection/context/scopedDb.js +47 -4
  116. package/dist/collection/stores/componentStyles.js +39 -0
  117. package/dist/collection/stores/internationalization.js +15 -13
  118. package/dist/collection/utils/DateStringFactory.js +17 -15
  119. package/dist/collection/utils/autoFit.js +2 -2
  120. package/dist/collection/utils/componentRegister.js +60 -16
  121. package/dist/collection/utils/constants.js +2 -2
  122. package/dist/collection/utils/dataAnalyzer.js +9 -12
  123. package/dist/collection/utils/emptyState.js +21 -0
  124. package/dist/collection/utils/formatter.js +29 -20
  125. package/dist/collection/utils/layoutObserver.js +1 -1
  126. package/dist/collection/utils/layoutState/generic.js +1 -1
  127. package/dist/collection/utils/layoutState/svgChartElements.js +2 -2
  128. package/dist/collection/utils/layoutTemplate.js +81 -0
  129. package/dist/collection/utils/measurementHost.js +2 -2
  130. package/dist/collection/utils/model/Order.js +1 -1
  131. package/dist/collection/utils/model/styles/SVGStyle.js +12 -4
  132. package/dist/collection/utils/parentDimensions.js +35 -3
  133. package/dist/collection/utils/queryError.js +11 -0
  134. package/dist/collection/utils/relativeVariance.js +14 -0
  135. package/dist/collection/utils/sanitizeHtml.js +30 -16
  136. package/dist/collection/utils/scaling.js +2 -2
  137. package/dist/collection/utils/stackColors.js +27 -5
  138. package/dist/collection/utils/stackLayout.js +71 -0
  139. package/dist/collection/utils/styled/attributes.js +16 -3
  140. package/dist/collection/utils/styled/style-sheet.js +1 -1
  141. package/dist/collection/utils/styled/withStyled.js +1 -1
  142. package/dist/collection/utils/testing/fakeGroup.js +21 -0
  143. package/dist/collection/utils/testing/mutationObserver.js +44 -0
  144. package/dist/collection/utils/testing/structureChart.js +26 -0
  145. package/dist/collection/utils/testing/timeChart.js +28 -0
  146. package/dist/collection/utils/validate.js +1 -1
  147. package/dist/collection/utils/withComponentStatus.js +137 -12
  148. package/dist/collection/utils/withInheritedProps.js +113 -64
  149. package/dist/collection/utils/withRuleSet.js +10 -7
  150. package/dist/collection/utils/withTranslation.js +3 -3
  151. package/dist/collection/utils/xy/FacetGrid.js +1 -1
  152. package/dist/collection/utils/xy/IsoCurves.js +1 -1
  153. package/dist/collection/utils/xy/NumericScale.js +46 -15
  154. package/dist/collection/utils/xy/PointLabeler.js +2 -2
  155. package/dist/collection/utils/xy/RadiusScale.js +2 -2
  156. package/dist/collection/utils/xy/SeriesPalette.js +3 -3
  157. package/dist/collection/utils/xy/VarianceMeasure.js +22 -4
  158. package/dist/collection/utils/xy/XYFrame.js +4 -4
  159. package/dist/collection/utils/xy/XYLegend.js +5 -7
  160. package/dist/collection/utils/xy/checkXYOverflow.js +32 -0
  161. package/dist/collection/utils/xy/formatXYValue.js +13 -0
  162. package/dist/collection/utils/xy/model/XYChartDataRow.js +0 -0
  163. package/dist/collection/utils/xy/model/XYChartStyle.js +2 -0
  164. package/dist/components/DataFormatDigits.js +1 -1
  165. package/dist/components/DateStringFactory.js +1 -1
  166. package/dist/components/LabelCollisionManager.js +1 -1
  167. package/dist/components/NumericScale.js +1 -1
  168. package/dist/components/Order.js +1 -1
  169. package/dist/components/SVGStyle.js +1 -0
  170. package/dist/components/TableAttribute.js +1 -0
  171. package/dist/components/VarianceMeasure.js +1 -1
  172. package/dist/components/XYChartDataRow.js +1 -1
  173. package/dist/components/bn-asset.js +1 -1
  174. package/dist/components/bn-body2.js +1 -1
  175. package/dist/components/bn-card2.js +1 -1
  176. package/dist/components/bn-chart-bubble.js +1 -1
  177. package/dist/components/bn-chart-bullet.js +1 -1
  178. package/dist/components/bn-chart-scatter.js +1 -1
  179. package/dist/components/bn-chart-structure.js +1 -1
  180. package/dist/components/bn-chart-time.js +1 -1
  181. package/dist/components/bn-component-style.js +1 -1
  182. package/dist/components/bn-context.js +1 -1
  183. package/dist/components/bn-dataset.js +1 -1
  184. package/dist/components/bn-datasource.js +1 -1
  185. package/dist/components/bn-footer2.js +1 -1
  186. package/dist/components/bn-grid.js +1 -1
  187. package/dist/components/bn-image.js +1 -1
  188. package/dist/components/bn-internationalization.js +1 -1
  189. package/dist/components/bn-layout-card.js +1 -1
  190. package/dist/components/bn-layout-page.js +1 -1
  191. package/dist/components/bn-message2.js +1 -1
  192. package/dist/components/bn-page2.js +1 -1
  193. package/dist/components/bn-ruleset.js +1 -1
  194. package/dist/components/bn-scaling-group.js +1 -1
  195. package/dist/components/bn-table.js +1 -1
  196. package/dist/components/bn-template.js +1 -1
  197. package/dist/components/bn-text.js +1 -1
  198. package/dist/components/bn-title2.js +1 -1
  199. package/dist/components/bn-tree.js +1 -1
  200. package/dist/components/checkXYOverflow.js +1 -0
  201. package/dist/components/context-protocol.js +1 -1
  202. package/dist/components/editor-companion.js +1 -1
  203. package/dist/components/emptyState.js +1 -0
  204. package/dist/components/formatter.js +1 -1
  205. package/dist/components/ibcs-chart-bubble2.js +1 -1
  206. package/dist/components/ibcs-chart-bullet2.js +1 -1
  207. package/dist/components/ibcs-chart-scatter2.js +1 -1
  208. package/dist/components/ibcs-chart-structure2.js +1 -1
  209. package/dist/components/ibcs-chart-time2.js +1 -1
  210. package/dist/components/ibcs-table2.js +1 -1
  211. package/dist/components/ibcs-title2.js +1 -1
  212. package/dist/components/layoutTemplate.js +1 -0
  213. package/dist/components/pageFormats.js +1 -0
  214. package/dist/components/parentDimensions.js +1 -0
  215. package/dist/components/queryError.js +1 -0
  216. package/dist/components/relativeVariance.js +1 -0
  217. package/dist/components/sanitizeHtml.js +1 -1
  218. package/dist/components/stackColors.js +1 -1
  219. package/dist/components/stackLayout.js +1 -0
  220. package/dist/components/svg.esm.js +1 -0
  221. package/dist/components/validate.js +1 -1
  222. package/dist/components/withBodyObserver.js +1 -1
  223. package/dist/components/withComponentStatus.js +1 -0
  224. package/dist/components/withComponentStyle.js +1 -1
  225. package/dist/components/withDataset.js +1 -1
  226. package/dist/components/withHasError.js +1 -1
  227. package/dist/components/withRuleSet.js +1 -1
  228. package/dist/components/withScalingGroup.js +1 -1
  229. package/dist/components/withStyled.js +1 -1
  230. package/dist/components/withTranslation.js +1 -1
  231. package/dist/esm/{bn-asset_21.entry.js → bn-asset_28.entry.js} +20948 -6125
  232. package/dist/esm/bn-grid.entry.js +4 -6
  233. package/dist/esm/bn-image.entry.js +3 -5
  234. package/dist/esm/bn-internationalization.entry.js +17 -6
  235. package/dist/esm/bn-ruleset.entry.js +5 -5
  236. package/dist/esm/bn-template-engine.js +1 -1
  237. package/dist/esm/bn-template.entry.js +2 -2
  238. package/dist/esm/bn-text.entry.js +111 -39
  239. package/dist/esm/{context-protocol-B-vdGKeG.js → context-protocol-CdTp19uA.js} +106 -22
  240. package/dist/esm/{diagnostics-CiquIw8B.js → diagnostics-vw6TKMiT.js} +1 -1
  241. package/dist/esm/editor-companion.entry.js +2 -2
  242. package/dist/esm/loader.js +1 -1
  243. package/dist/esm/queryError-ClruFZD_.js +13 -0
  244. package/dist/esm/{scaling-Dggyeqts.js → sanitizeHtml-C5bFtARM.js} +464 -287
  245. package/dist/esm/{withBodyObserver-Cb9ZC5_J.js → withBodyObserver-DD_-r04o.js} +1 -1
  246. package/dist/esm/withHasError-73WV2SP5.js +422 -0
  247. package/dist/esm/{withStyled-DoNsbwS3.js → withStyled-BDEyKd_H.js} +513 -27
  248. package/dist/types/components/bn-chart-bubble/bn-chart-bubble.d.ts +8 -4
  249. package/dist/types/components/bn-chart-bubble/ibcs-chart-bubble.d.ts +2 -1
  250. package/dist/types/components/bn-chart-bubble/utils/BubbleChart.d.ts +14 -2
  251. package/dist/types/components/bn-chart-bullet/bn-chart-bullet.d.ts +12 -11
  252. package/dist/types/components/bn-chart-bullet/ibcs-chart-bullet.d.ts +2 -1
  253. package/dist/types/components/bn-chart-bullet/utils/BulletChart.d.ts +8 -5
  254. package/dist/types/components/bn-chart-bullet/utils/model/BulletChartStyle.d.ts +2 -0
  255. package/dist/types/components/bn-chart-bullet/utils/model/BulletConfig.d.ts +1 -1
  256. package/dist/types/components/bn-chart-scatter/bn-chart-scatter.d.ts +8 -4
  257. package/dist/types/components/bn-chart-scatter/ibcs-chart-scatter.d.ts +2 -1
  258. package/dist/types/components/bn-chart-scatter/utils/ScatterChart.d.ts +11 -1
  259. package/dist/types/components/bn-chart-structure/bn-chart-structure.d.ts +13 -12
  260. package/dist/types/components/bn-chart-structure/ibcs-chart-structure.d.ts +8 -1
  261. package/dist/types/components/bn-chart-structure/utils/StructureChart.d.ts +29 -6
  262. package/dist/types/components/bn-chart-structure/utils/elements/StackedBar.d.ts +4 -3
  263. package/dist/types/components/bn-chart-structure/utils/model/DataPoint.d.ts +3 -2
  264. package/dist/types/components/bn-chart-structure/utils/model/StructureChartComponentConfig.d.ts +2 -1
  265. package/dist/types/components/bn-chart-structure/utils/model/styles/StructureChartStyle.d.ts +2 -0
  266. package/dist/types/components/bn-chart-time/bn-chart-time.d.ts +19 -15
  267. package/dist/types/components/bn-chart-time/ibcs-chart-time.d.ts +8 -1
  268. package/dist/types/components/bn-chart-time/utils/TimeChart.d.ts +63 -5
  269. package/dist/types/components/bn-chart-time/utils/elements/AreaFill.d.ts +1 -1
  270. package/dist/types/components/bn-chart-time/utils/elements/StackedColumn.d.ts +9 -8
  271. package/dist/types/components/bn-chart-time/utils/model/DataPoint.d.ts +3 -2
  272. package/dist/types/components/bn-chart-time/utils/model/TimeChartComponentConfig.d.ts +3 -2
  273. package/dist/types/components/bn-chart-time/utils/model/styles/TimeChartStyle.d.ts +2 -0
  274. package/dist/types/components/bn-context/bn-context.d.ts +15 -3
  275. package/dist/types/components/bn-dataset/bn-dataset.d.ts +41 -20
  276. package/dist/types/components/bn-datasource/bn-datasource.d.ts +34 -18
  277. package/dist/types/components/bn-footer/bn-footer.d.ts +2 -2
  278. package/dist/types/components/bn-layout-card/bn-layout-card.d.ts +3 -10
  279. package/dist/types/components/bn-layout-page/bn-layout-page.d.ts +13 -6
  280. package/dist/types/components/bn-message/bn-message.d.ts +2 -1
  281. package/dist/types/components/bn-page/bn-page.d.ts +2 -1
  282. package/dist/types/components/bn-page/pageFormats.d.ts +40 -0
  283. package/dist/types/components/bn-scaling-group/bn-scaling-group.d.ts +2 -2
  284. package/dist/types/components/bn-table/bn-table.d.ts +11 -10
  285. package/dist/types/components/bn-table/ibcs-table.d.ts +8 -5
  286. package/dist/types/components/bn-table/utils/Table.d.ts +3 -1
  287. package/dist/types/components/bn-table/utils/elements/Cell.d.ts +2 -2
  288. package/dist/types/components/bn-table/utils/elements/CellBarChart.d.ts +6 -4
  289. package/dist/types/components/bn-table/utils/elements/WaterfallBar.d.ts +1 -1
  290. package/dist/types/components/bn-table/utils/factories/tableDataSetFactory.d.ts +2 -0
  291. package/dist/types/components/bn-table/utils/helper/DataQuery.d.ts +14 -5
  292. package/dist/types/components/bn-table/utils/helper/IntervalColumns.d.ts +2 -2
  293. package/dist/types/components/bn-table/utils/helper/QueryGroup.d.ts +6 -1
  294. package/dist/types/components/bn-table/utils/helper/barColumnGeometry.d.ts +2 -2
  295. package/dist/types/components/bn-table/utils/model/TableAttribute.d.ts +2 -0
  296. package/dist/types/components/bn-table/utils/model/TableComponentConfig.d.ts +2 -1
  297. package/dist/types/components/bn-text/bn-text.d.ts +20 -13
  298. package/dist/types/components/bn-text/utils/template.d.ts +10 -0
  299. package/dist/types/components/bn-title/ibcs-title/ibcs-title.d.ts +1 -0
  300. package/dist/types/components/bn-tree/bn-tree.d.ts +8 -1
  301. package/dist/types/components/bn-tree/utils/EdgeRenderer.d.ts +18 -5
  302. package/dist/types/components/bn-tree/utils/TreeLayout.d.ts +5 -0
  303. package/dist/types/components.d.ts +226 -184
  304. package/dist/types/context/scopedDb.d.ts +20 -0
  305. package/dist/types/stores/componentStyles.d.ts +6 -0
  306. package/dist/types/utils/DateStringFactory.d.ts +3 -2
  307. package/dist/types/utils/autoFit.d.ts +2 -2
  308. package/dist/types/utils/componentRegister.d.ts +21 -5
  309. package/dist/types/utils/constants.d.ts +2 -2
  310. package/dist/types/utils/dataAnalyzer.d.ts +1 -1
  311. package/dist/types/utils/emptyState.d.ts +10 -0
  312. package/dist/types/utils/formatter.d.ts +7 -9
  313. package/dist/types/utils/layoutState/generic.d.ts +1 -1
  314. package/dist/types/utils/layoutState/svgChartElements.d.ts +2 -2
  315. package/dist/types/utils/layoutTemplate.d.ts +16 -0
  316. package/dist/types/utils/model/ChartStyles.d.ts +1 -1
  317. package/dist/types/utils/model/DataQueryResultRow.d.ts +2 -2
  318. package/dist/types/utils/model/Order.d.ts +1 -1
  319. package/dist/types/utils/model/styles/SVGStyle.d.ts +5 -1
  320. package/dist/types/utils/parentDimensions.d.ts +9 -0
  321. package/dist/types/utils/queryError.d.ts +5 -0
  322. package/dist/types/utils/relativeVariance.d.ts +9 -0
  323. package/dist/types/utils/sanitizeHtml.d.ts +2 -2
  324. package/dist/types/utils/scaling.d.ts +1 -1
  325. package/dist/types/utils/stackColors.d.ts +3 -2
  326. package/dist/types/utils/stackLayout.d.ts +49 -0
  327. package/dist/types/utils/testing/fakeGroup.d.ts +8 -0
  328. package/dist/types/utils/testing/mutationObserver.d.ts +5 -0
  329. package/dist/types/utils/testing/structureChart.d.ts +5 -0
  330. package/dist/types/utils/testing/timeChart.d.ts +5 -0
  331. package/dist/types/utils/validate.d.ts +1 -1
  332. package/dist/types/utils/withComponentStatus.d.ts +11 -3
  333. package/dist/types/utils/withInheritedProps.d.ts +42 -15
  334. package/dist/types/utils/withRuleSet.d.ts +2 -1
  335. package/dist/types/utils/withTranslation.d.ts +2 -2
  336. package/dist/types/utils/xy/FacetGrid.d.ts +1 -1
  337. package/dist/types/utils/xy/IsoCurves.d.ts +1 -1
  338. package/dist/types/utils/xy/NumericScale.d.ts +9 -4
  339. package/dist/types/utils/xy/PointLabeler.d.ts +2 -2
  340. package/dist/types/utils/xy/RadiusScale.d.ts +2 -2
  341. package/dist/types/utils/xy/SeriesPalette.d.ts +3 -3
  342. package/dist/types/utils/xy/VarianceMeasure.d.ts +10 -2
  343. package/dist/types/utils/xy/XYFrame.d.ts +4 -1
  344. package/dist/types/utils/xy/XYLegend.d.ts +3 -1
  345. package/dist/types/utils/xy/checkXYOverflow.d.ts +8 -0
  346. package/dist/types/utils/xy/formatXYValue.d.ts +7 -0
  347. package/dist/types/utils/xy/model/AxisConfig.d.ts +1 -1
  348. package/dist/types/utils/xy/model/XYChartStyle.d.ts +2 -0
  349. package/package.json +4 -2
  350. package/readme.md +11 -11
  351. package/dist/bn-template-engine/p-03304284.entry.js +0 -1
  352. package/dist/bn-template-engine/p-0fb02c57.entry.js +0 -1
  353. package/dist/bn-template-engine/p-4419db8f.entry.js +0 -1
  354. package/dist/bn-template-engine/p-45508f1b.entry.js +0 -1
  355. package/dist/bn-template-engine/p-461fdffa.entry.js +0 -1
  356. package/dist/bn-template-engine/p-5d7a3a77.entry.js +0 -1
  357. package/dist/bn-template-engine/p-62cc95b7.entry.js +0 -1
  358. package/dist/bn-template-engine/p-686d8e44.entry.js +0 -1
  359. package/dist/bn-template-engine/p-829212c3.entry.js +0 -1
  360. package/dist/bn-template-engine/p-B5Jd_eCX.js +0 -1
  361. package/dist/bn-template-engine/p-BA48JiHe.js +0 -1
  362. package/dist/bn-template-engine/p-BbmobTg0.js +0 -1
  363. package/dist/bn-template-engine/p-BcaI745G.js +0 -1
  364. package/dist/bn-template-engine/p-CG_Bcm6V.js +0 -1
  365. package/dist/bn-template-engine/p-CWWWM-XC.js +0 -1
  366. package/dist/bn-template-engine/p-CsJ84YRk.js +0 -1
  367. package/dist/bn-template-engine/p-D5e8I9Qe.js +0 -1
  368. package/dist/bn-template-engine/p-DVrDYxlh.js +0 -1
  369. package/dist/bn-template-engine/p-DjPXefnq.js +0 -1
  370. package/dist/bn-template-engine/p-DsTzlzxQ.js +0 -1
  371. package/dist/bn-template-engine/p-DtLI_CzV.js +0 -1
  372. package/dist/bn-template-engine/p-EtT29btN.js +0 -1
  373. package/dist/bn-template-engine/p-TuLpbB5O.js +0 -1
  374. package/dist/bn-template-engine/p-a5867a4c.entry.js +0 -1
  375. package/dist/bn-template-engine/p-b27009eb.entry.js +0 -1
  376. package/dist/bn-template-engine/p-bfa87b07.entry.js +0 -1
  377. package/dist/bn-template-engine/p-ceb80db3.entry.js +0 -1
  378. package/dist/bn-template-engine/p-fcfbb329.entry.js +0 -1
  379. package/dist/bn-template-engine/p-qRZrT-U3.js +0 -1
  380. package/dist/cjs/AxisConfig-DwiNUyYG.js +0 -233
  381. package/dist/cjs/LabelCollisionManager-Bv-xkeXw.js +0 -415
  382. package/dist/cjs/NumericScale-BAyYXpKL.js +0 -107
  383. package/dist/cjs/Order-2wRydarc.js +0 -87
  384. package/dist/cjs/SVGStyle-DoxylrEQ.js +0 -8219
  385. package/dist/cjs/SVGVariancesStyleGroup-CiI4GeWe.js +0 -50
  386. package/dist/cjs/VarianceMeasure-CQlSRzlp.js +0 -372
  387. package/dist/cjs/XYChartDataRow-C2FdL58s.js +0 -829
  388. package/dist/cjs/bn-chart-bubble.cjs.entry.js +0 -792
  389. package/dist/cjs/bn-chart-bullet.cjs.entry.js +0 -805
  390. package/dist/cjs/bn-chart-scatter.cjs.entry.js +0 -678
  391. package/dist/cjs/bn-tree.cjs.entry.js +0 -1042
  392. package/dist/cjs/ibcs-chart-bubble.cjs.entry.js +0 -624
  393. package/dist/cjs/ibcs-chart-bullet.cjs.entry.js +0 -673
  394. package/dist/cjs/ibcs-chart-scatter.cjs.entry.js +0 -667
  395. package/dist/cjs/sanitizeHtml-LuZr1IMd.js +0 -85
  396. package/dist/cjs/svgChartElements-tDA43aYj.js +0 -400
  397. package/dist/cjs/withHasError-BdDmiOXM.js +0 -258
  398. package/dist/cjs/withScalingGroup-CFIc5-6s.js +0 -73
  399. package/dist/components/autoFit.js +0 -1
  400. package/dist/components/main.js +0 -1
  401. package/dist/components/utils.js +0 -1
  402. package/dist/esm/AxisConfig-KqzWQbML.js +0 -224
  403. package/dist/esm/LabelCollisionManager-585bQMtP.js +0 -407
  404. package/dist/esm/NumericScale-DsTzlzxQ.js +0 -105
  405. package/dist/esm/Order-DZVWjEL_.js +0 -83
  406. package/dist/esm/SVGStyle-OrPkzjcb.js +0 -8209
  407. package/dist/esm/SVGVariancesStyleGroup-DO5QJfRQ.js +0 -48
  408. package/dist/esm/VarianceMeasure-DDjChp8C.js +0 -364
  409. package/dist/esm/XYChartDataRow-Dn83Tqh9.js +0 -820
  410. package/dist/esm/bn-chart-bubble.entry.js +0 -790
  411. package/dist/esm/bn-chart-bullet.entry.js +0 -803
  412. package/dist/esm/bn-chart-scatter.entry.js +0 -676
  413. package/dist/esm/bn-tree.entry.js +0 -1040
  414. package/dist/esm/ibcs-chart-bubble.entry.js +0 -622
  415. package/dist/esm/ibcs-chart-bullet.entry.js +0 -671
  416. package/dist/esm/ibcs-chart-scatter.entry.js +0 -665
  417. package/dist/esm/sanitizeHtml-BA48JiHe.js +0 -83
  418. package/dist/esm/svgChartElements-B3YClivG.js +0 -395
  419. package/dist/esm/withHasError-Bh1Viz52.js +0 -254
  420. package/dist/esm/withScalingGroup-DNBSqRC0.js +0 -71
@@ -111,7 +111,7 @@ export namespace Components {
111
111
  */
112
112
  "filter": string;
113
113
  /**
114
- * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region, point count and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified — XY marks carry no ids).
114
+ * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region, point count and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified - XY marks carry no ids).
115
115
  * @param options - `{ detail: "summary" | "full" }`, default `"summary"`
116
116
  */
117
117
  "getLayoutState": (options?: LayoutStateOptions) => Promise<ComponentLayoutState>;
@@ -158,11 +158,11 @@ export namespace Components {
158
158
  */
159
159
  "size": string;
160
160
  /**
161
- * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Market attractiveness", "refLine":0.5}`.
161
+ * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Market attractiveness", "refLine":0.5}`. A relative variance (`dr…`) gives an axis in percent: the ticks print `20%`, and `min`, `max`, `refLine` and `highlight` are written in percent too (`20` for 20 %).
162
162
  */
163
163
  "x": string;
164
164
  /**
165
- * Y axis mapping — same shape as `x`.
165
+ * Y axis mapping - same shape as `x`.
166
166
  */
167
167
  "y": string;
168
168
  }
@@ -170,9 +170,9 @@ export namespace Components {
170
170
  * IBCS bullet graph: one horizontal row per KPI with a solid actual bar and
171
171
  * a target marker.
172
172
  * Subscribes to a dataset (via `withDataset`) and renders in the IBCS
173
- * default mode with **normalized targets** — every row is scaled to
173
+ * default mode with **normalized targets** - every row is scaled to
174
174
  * fractions of its target so one continuous target line spans all rows and
175
- * KPIs become visually comparable — plus integrated variance bars in the
175
+ * KPIs become visually comparable - plus integrated variance bars in the
176
176
  * IBCS variance colors. The classic Stephen Few look is opt-in via
177
177
  * `normalize="none"` (per-row scales) and `ranges` (max two qualitative
178
178
  * gray bands). Actual and target scenarios are auto-detected from the
@@ -182,7 +182,7 @@ export namespace Components {
182
182
  */
183
183
  interface BnChartBullet {
184
184
  /**
185
- * Actual-value measure. JSON object or a bare scenario slot as shorthand: `{"measure":"ac1","label":"Revenue","unit":"EUR k"}`. Only plain scenario slots (`ac1`…`pl4`) are allowed — variance tokens are not. Empty or `"auto"` auto-detects (`ac1`, else the first available scenario).
185
+ * Actual-value measure. JSON object or a bare scenario slot as shorthand: `{"measure":"ac1","label":"Revenue","unit":"EUR k"}`. Only plain scenario slots (`ac1`…`pl4`) are allowed - variance tokens are not. Empty or `"auto"` auto-detects (`ac1`, else the first available scenario).
186
186
  * @default ""
187
187
  */
188
188
  "actual": string;
@@ -197,7 +197,7 @@ export namespace Components {
197
197
  */
198
198
  "filter": string;
199
199
  /**
200
- * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified — bullet marks carry no ids).
200
+ * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified - bullet marks carry no ids).
201
201
  * @param options - `{ detail: "summary" | "full" }`, default `"summary"`
202
202
  */
203
203
  "getLayoutState": (options?: LayoutStateOptions) => Promise<ComponentLayoutState>;
@@ -212,12 +212,12 @@ export namespace Components {
212
212
  */
213
213
  "level": string;
214
214
  /**
215
- * Maximum number of KPI rows (0 = unlimited). Truncates — there is no REST aggregate, summing heterogeneous KPIs would be meaningless.
215
+ * Maximum number of KPI rows (0 = unlimited). Truncates - there is no REST aggregate, summing heterogeneous KPIs would be meaningless.
216
216
  * @default 0
217
217
  */
218
218
  "limit": number;
219
219
  /**
220
- * Target normalization: `target` (default — rows share an aligned target position, the IBCS-comparable form) or `none` (classic per-row scales with tick strips).
220
+ * Target normalization: `target` (default - rows share an aligned target position, the IBCS-comparable form) or `none` (classic per-row scales with tick strips).
221
221
  * @default "target"
222
222
  */
223
223
  "normalize": string;
@@ -232,7 +232,7 @@ export namespace Components {
232
232
  */
233
233
  "orderDirection": string;
234
234
  /**
235
- * Qualitative range bands as a JSON array of ascending fractions of the target, at most two — e.g. `[0.6, 0.9]` (IBCS rejects a third band of arbitrary length). Classic mode only; ignored while `normalize` is `"target"`.
235
+ * Qualitative range bands as a JSON array of ascending fractions of the target, at most two - e.g. `[0.6, 0.9]` (IBCS rejects a third band of arbitrary length). Classic mode only; ignored while `normalize` is `"target"`.
236
236
  * @default ""
237
237
  */
238
238
  "ranges": string;
@@ -245,12 +245,12 @@ export namespace Components {
245
245
  */
246
246
  "scale"?: string;
247
247
  /**
248
- * Target measure — same shape as `actual`. Empty or `"auto"` auto-detects (`pl1` > `pp1` > `fc1`); without any target scenario the chart renders actual bars only.
248
+ * Target measure - same shape as `actual`. Empty or `"auto"` auto-detects (`pl1` > `pp1` > `fc1`); without any target scenario the chart renders actual bars only.
249
249
  * @default ""
250
250
  */
251
251
  "target": string;
252
252
  /**
253
- * Variance bars between actual and target: `auto` (default — drawn in normalized mode, favorable/unfavorable in the IBCS variance colors) or `none`.
253
+ * Variance bars between actual and target: `auto` (default - drawn in normalized mode, favorable/unfavorable in the IBCS variance colors) or `none`.
254
254
  * @default "auto"
255
255
  */
256
256
  "variances": string;
@@ -285,7 +285,7 @@ export namespace Components {
285
285
  */
286
286
  "filter": string;
287
287
  /**
288
- * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region, point count and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified — XY marks carry no ids).
288
+ * Lazily generates this chart's layout state: host box (context- and component-relative, CSS px), the canvas region, point count and diagnostics. With `detail: "full"` the rendered marks and labels are listed with their geometry (tag-classified - XY marks carry no ids).
289
289
  * @param options - `{ detail: "summary" | "full" }`, default `"summary"`
290
290
  */
291
291
  "getLayoutState": (options?: LayoutStateOptions) => Promise<ComponentLayoutState>;
@@ -328,11 +328,11 @@ export namespace Components {
328
328
  */
329
329
  "seriesLevel": string;
330
330
  /**
331
- * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Margin","unit":"%","min":0, "max":40,"refLine":0.5,"highlight":{"from":30}}`. The measure is a scenario column (`ac1`…`pl4`) or a variance token (`d…`/`dr…`, sentiment suffix optional).
331
+ * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Margin","unit":"%","min":0, "max":40,"refLine":0.5,"highlight":{"from":30}}`. The measure is a scenario column (`ac1`…`pl4`) or a variance token (`d…`/`dr…`, sentiment suffix optional). A relative variance (`dr…`) gives an axis in percent: the ticks print `20%`, and `min`, `max`, `refLine` and `highlight` are written in percent too (`20` for 20 %).
332
332
  */
333
333
  "x": string;
334
334
  /**
335
- * Y axis mapping — same shape as `x`.
335
+ * Y axis mapping - same shape as `x`.
336
336
  */
337
337
  "y": string;
338
338
  }
@@ -387,7 +387,7 @@ export namespace Components {
387
387
  */
388
388
  "measureUnit": string;
389
389
  /**
390
- * Comma-separated list of columns that define the sort order of bars. When ordering by a scenario column, that scenario must also be listed in `scenarios`. Valid values: `category`, `categoryIndex`, `rowGroup`, `rowGroupIndex`, `subCategory`, `subCategoryIndex`, `ac1`–`ac4`, `fc1`–`fc4`, `pp1`–`pp4`, `pl1`–`pl4`. | Value | Behavior | |----------------|-----------------------------------------------------| | `"ac1"` | Sort bars by the ac1 scenario values | | `"category"` | Sort bars alphabetically by category name | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect with `AUTO_order` warning |
390
+ * Comma-separated list of columns that define the sort order of bars. When ordering by a scenario column, that scenario must also be listed in `scenarios`. Valid values: `category`, `categoryIndex`, `rowGroup`, `rowGroupIndex`, `subCategory`, `subCategoryIndex`, `ac1`-`ac4`, `fc1`-`fc4`, `pp1`-`pp4`, `pl1`-`pl4`. | Value | Behavior | |----------------|-----------------------------------------------------| | `"ac1"` | Sort bars by the ac1 scenario values | | `"category"` | Sort bars alphabetically by category name | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect with `AUTO_order` warning |
391
391
  * @example order="ac1"
392
392
  */
393
393
  "order": string;
@@ -398,7 +398,7 @@ export namespace Components {
398
398
  */
399
399
  "orderDirection": string;
400
400
  /**
401
- * Percentage points displayed per 1 em of bar length for relative variances — a larger value means shorter bars. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available width | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
401
+ * Percentage points displayed per 1 em of bar length for relative variances - a larger value means shorter bars. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available width | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
402
402
  * @example percentage-scaling="10"
403
403
  * @example percentage-scaling="pct-scale"
404
404
  */
@@ -408,11 +408,11 @@ export namespace Components {
408
408
  */
409
409
  "ruleset"?: string;
410
410
  /**
411
- * Controls proportional scaling of the chart to fit the available parent height. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent height; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent height silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` |
411
+ * Controls proportional scaling of the chart to fit the available parent height. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent height; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent height silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` |
412
412
  */
413
413
  "scale"?: string;
414
414
  /**
415
- * Comma-separated list of scenario columns to display as bars. Up to 4 scenarios are supported; additional values are ignored. Valid scenario names: `ac1`–`ac4`, `fc1`–`fc4`, `pp1`–`pp4`, `pl1`–`pl4`. | Value | Behavior | |---------------|-------------------------------------------------------------| | `"ac1,fc1"` | Show the listed scenarios | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect from dataset metadata (emits `AUTO_scenarios` warning) |
415
+ * Comma-separated list of scenario columns to display as bars. Up to 4 scenarios are supported; additional values are ignored. Valid scenario names: `ac1`-`ac4`, `fc1`-`fc4`, `pp1`-`pp4`, `pl1`-`pl4`. | Value | Behavior | |---------------|-------------------------------------------------------------| | `"ac1,fc1"` | Show the listed scenarios | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect from dataset metadata (emits `AUTO_scenarios` warning) |
416
416
  * @example scenarios="ac1,pp1,pl1"
417
417
  */
418
418
  "scenarios": string;
@@ -429,14 +429,14 @@ export namespace Components {
429
429
  */
430
430
  "showMeasureScale": string;
431
431
  /**
432
- * Stacking configuration as a JSON string. When set, bars are drawn as stacked segments instead of side-by-side. **Properties:** | Key | Values | Description | |---------|-----------------------------------------------|----------------------------------------------------| | `by` | `"scenarios"` \| `"dimensions"` | **Required.** What to stack. | | `mode` | `"absolute"` \| `"relative"` \| `"absolute-relative"` | Stacking mode. Default: `"absolute"`. | | `order` | `"asc"` \| `"desc"` \| `"dataset"` | Segment sort order. Default: `"dataset"`. | - `by: "scenarios"` — stacks the scenarios listed in the `scenarios` prop end-to-end. - `by: "dimensions"` — stacks by the next-lower hierarchy level derived from `level` (e.g. level `"rowGroup"` stacks by category). Only the first scenario is used; extra scenarios trigger a `WARN_stack_dimensions_scenarios` warning. - `mode: "relative"` — normalizes each bar to 100%, showing proportions. - `mode: "absolute-relative"` — absolute bars with percentage labels. Segment colors are configurable via the `stackColors` array in component styles.
432
+ * Stacking configuration as a JSON string. When set, bars are drawn as stacked segments instead of side-by-side. **Properties:** | Key | Values | Description | |---------|-----------------------------------------------|----------------------------------------------------| | `by` | `"scenarios"` \| `"dimensions"` | **Required.** What to stack. | | `mode` | `"absolute"` \| `"relative"` \| `"absolute-relative"` | Stacking mode. Default: `"absolute"`. | | `order` | `"asc"` \| `"desc"` \| `"dataset"` | Segment sort order. Default: `"dataset"`. | - `by: "scenarios"` - stacks the scenarios listed in the `scenarios` prop end-to-end. - `by: "dimensions"` - stacks by the next-lower hierarchy level derived from `level` (e.g. level `"rowGroup"` stacks by category). Only the first scenario is used; extra scenarios trigger a `WARN_stack_dimensions_scenarios` warning. - `mode: "relative"` - normalizes each bar to 100%, showing proportions. - `mode: "absolute-relative"` - absolute bars with percentage labels. Segment colors are configurable via the `stackColors` array in component styles.
433
433
  * @default "" (no stacking)
434
434
  * @example stack='{"by":"scenarios","mode":"absolute"}'
435
435
  * @example stack='{"by":"dimensions","mode":"relative"}'
436
436
  */
437
437
  "stack": string;
438
438
  /**
439
- * Data units displayed per 1 em of bar length (horizontal bars) — map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container width | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | When using a custom value that causes the chart to exceed its container, a `WARN_overflow` error is emitted.
439
+ * Data units displayed per 1 em of bar length (horizontal bars) - map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container width | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | When using a custom value that causes the chart to exceed its container, a `WARN_overflow` error is emitted.
440
440
  * @example unit-scaling="auto"
441
441
  * @example unit-scaling="1M"
442
442
  * @example unit-scaling="revenue-scale"
@@ -488,7 +488,7 @@ export namespace Components {
488
488
  */
489
489
  "getLayoutState": (options?: LayoutStateOptions) => Promise<ComponentLayoutState>;
490
490
  /**
491
- * Max number of collumns is used to calculate Axis Date Interval (if dateInterval is set to AUTO)
491
+ * Max number of columns. Only used to choose the date interval when dateInterval is AUTO: the finest interval that gives fewer periods than this. The series is never cut.
492
492
  * @default 28
493
493
  */
494
494
  "intervalSpanLimit": number;
@@ -530,7 +530,7 @@ export namespace Components {
530
530
  */
531
531
  "orderDirection": string;
532
532
  /**
533
- * Percentage points displayed per 1 em of pin/bar length for relative variances — a larger value means shorter pins. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available height (same two-pass as unit-scaling) | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
533
+ * Percentage points displayed per 1 em of pin/bar length for relative variances - a larger value means shorter pins. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available height (same two-pass as unit-scaling) | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
534
534
  * @example percentage-scaling="10"
535
535
  * @example percentage-scaling="pct-scale"
536
536
  */
@@ -540,7 +540,7 @@ export namespace Components {
540
540
  */
541
541
  "ruleset"?: string;
542
542
  /**
543
- * Controls proportional scaling of the chart to fit the available parent width. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` |
543
+ * Controls proportional scaling of the chart to fit the available parent width. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` |
544
544
  */
545
545
  "scale"?: string;
546
546
  /**
@@ -565,8 +565,8 @@ export namespace Components {
565
565
  */
566
566
  "showOverlayMedian": string;
567
567
  /**
568
- * Stacking configuration for the chart as a JSON string. When set, bars/columns are drawn stacked (additive layers) instead of side-by-side. In line mode (`chart-mode="line"`), stacking produces a stacked area chart with filled regions between cumulative lines. **JSON schema:** ```json { "by": "scenario" | "category" | "subcategory" | "rowgroup", "mode": "absolute" | "relative" | "absolute-relative", "order": "asc" | "desc" | "dataset" } ``` - `by` (required): The dimension to stack. - `"scenario"` — stack the scenarios from the `scenarios` prop as layers. - `"category"` / `"subcategory"` / `"rowgroup"` — decompose a single scenario by this data dimension. Must be finer than `level`. - `mode` (optional, default `"absolute"`): - `"absolute"` — additive stacking, axis shows absolute units. - `"relative"` — 100% stacking, axis shows 0%–100%. `unit-scaling` is interpreted as pixels per percentage point (e.g. `0.4` → 40px full stack); `"auto"` fits the stack to the available height as usual. - `"absolute-relative"` — bar height is absolute (real value), but segment labels inside show percentages. - `order` (optional, default `"dataset"`): Segment order within each stack. `"asc"` / `"desc"` sort segments by value; `"dataset"` preserves the original data/scenario order.
569
- * @default '' (empty — no stacking)
568
+ * Stacking configuration for the chart as a JSON string. When set, bars/columns are drawn stacked (additive layers) instead of side-by-side. In line mode (`chart-mode="line"`), stacking produces a stacked area chart with filled regions between cumulative lines. **JSON schema:** ```json { "by": "scenario" | "category" | "subcategory" | "rowgroup", "mode": "absolute" | "relative" | "absolute-relative", "order": "asc" | "desc" | "dataset" } ``` - `by` (required): The dimension to stack. - `"scenario"` - stack the scenarios from the `scenarios` prop as layers. - `"category"` / `"subcategory"` / `"rowgroup"` - decompose a single scenario by this data dimension. Must be finer than `level`. - `mode` (optional, default `"absolute"`): - `"absolute"` - additive stacking, axis shows absolute units. - `"relative"` - 100% stacking, axis shows 0%-100%. `unit-scaling` is interpreted as pixels per percentage point (e.g. `0.4` → 40px full stack); `"auto"` fits the stack to the available height as usual. - `"absolute-relative"` - bar height is absolute (real value), but segment labels inside show percentages. - `order` (optional, default `"dataset"`): Segment order within each stack. `"asc"` / `"desc"` sort segments by value; `"dataset"` preserves the original data/scenario order.
569
+ * @default '' (empty - no stacking)
570
570
  * @example // Stack scenarios stack='{"by":"scenario"}'
571
571
  * @example // Stack by category, relative mode stack='{"by":"category","mode":"relative"}'
572
572
  */
@@ -576,7 +576,7 @@ export namespace Components {
576
576
  */
577
577
  "syncSpaceLeft": number;
578
578
  /**
579
- * Data units displayed per 1 em of bar length (vertical bars) — map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container height | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
579
+ * Data units displayed per 1 em of bar length (vertical bars) - map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container height | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
580
580
  * @example unit-scaling="auto"
581
581
  * @example unit-scaling="1M"
582
582
  * @example unit-scaling="revenue-scale"
@@ -595,7 +595,7 @@ export namespace Components {
595
595
  }
596
596
  interface BnContext {
597
597
  /**
598
- * Lazily generates a JSON-serializable snapshot of the rendered report: every visual descendant with its position and size (context- and component-relative, CSS px), render metadata, diagnostics and — with `detail: "full"` — per-element geometry (bars, labels, axes, cells). Nothing is tracked during rendering; each call measures the DOM at that moment. Call it after the report has settled (e.g. when `window.componentRegisterIsRenderedResult` is true) for final geometry.
598
+ * Lazily generates a JSON-serializable snapshot of the rendered report: every visual descendant with its position and size (context- and component-relative, CSS px), render metadata, diagnostics and - with `detail: "full"` - per-element geometry (bars, labels, axes, cells). Nothing is tracked during rendering; each call measures the DOM at that moment. Call it after the report has settled (e.g. when `window.componentRegisterIsRenderedResult` is true) for final geometry.
599
599
  * @param options - `{ detail: "summary" | "full" }`, default `"summary"`
600
600
  */
601
601
  "getLayoutState": (options?: LayoutStateOptions) => Promise<LayoutState>;
@@ -608,14 +608,13 @@ export namespace Components {
608
608
  /**
609
609
  * Queries data from one or more `bn-datasource` entries via AlaSQL and
610
610
  * writes the result to the `datasets` store (+ computed `DatasetMeta`).
611
- * The body content is observed via `withBodyObserver` and may be:
612
- * 1. **SQL** (default) — AlaSQL query against referenced `datasources`.
613
- * 2. **Static JSON** — set `static="true"` to bypass SQL and write the
611
+ * The body content is observed via `withBodyObserver` and is always inline:
612
+ * 1. **SQL** (default) - AlaSQL query against referenced `datasources`.
613
+ * 2. **Static JSON** - set `static="true"` to bypass SQL and write the
614
614
  * parsed body directly to the `datasets` store.
615
- * 3. **URL** — place an `http://`/`https://` URL or a same-origin path
616
- * starting with `/` in the body to fetch JSON from an HTTP endpoint and
617
- * write it to the `datasets` store. Set the `interval` prop (in seconds)
618
- * to enable periodic re-fetching.
615
+ * Set the `src` attribute to fetch JSON from an HTTP endpoint instead and
616
+ * write it to the `datasets` store. Set the `interval` prop (in seconds)
617
+ * to enable periodic re-fetching.
619
618
  */
620
619
  interface BnDataset {
621
620
  /**
@@ -624,7 +623,7 @@ export namespace Components {
624
623
  */
625
624
  "datasources": string;
626
625
  /**
627
- * Polling interval in **seconds** for URL mode. When set and the body content is a URL, the component re-fetches data at this interval. Has no effect for SQL, inline JSON or compressed content. Set to `0` or leave unset to disable polling.
626
+ * Polling interval in **seconds** for `src`. When set together with `src`, the component re-fetches data at this interval. Has no effect for SQL, inline JSON or compressed content. Set to `0` or leave unset to disable polling.
628
627
  * @default 0
629
628
  */
630
629
  "interval": number;
@@ -637,6 +636,10 @@ export namespace Components {
637
636
  * @default true
638
637
  */
639
638
  "raw": boolean;
639
+ /**
640
+ * URL to fetch the dataset JSON from. When set, the body is ignored and the fetched payload is written directly to the `datasets` store (`static` and `raw` do not apply).
641
+ */
642
+ "src"?: string;
640
643
  /**
641
644
  * When true, bypasses the AlaSQL query engine and parses the body content as raw JSON, writing it directly to the datasets store.
642
645
  * @default false
@@ -646,18 +649,18 @@ export namespace Components {
646
649
  /**
647
650
  * Ingests data and writes it to the scoped `datasources` store.
648
651
  * Data can be provided in three ways:
649
- * 1. **Inline JSON** — Place JSON text inside the element body (default).
650
- * 2. **Compressed payload** — Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
651
- * 3. **URL** — Place an `http://`/`https://` URL or a same-origin path
652
- * starting with `/` in the body to fetch JSON from an HTTP endpoint.
653
- * In URL mode the component fetches JSON from the URL. Set the `interval`
654
- * prop (in seconds) to enable periodic re-fetching (polling).
652
+ * 1. **Inline JSON** - Place JSON text inside the element body (default).
653
+ * 2. **Compressed payload** - Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
654
+ * 3. **URL** - Set the `src` attribute to fetch JSON from an HTTP endpoint.
655
+ * Set the `interval` prop (in seconds) to enable periodic re-fetching
656
+ * (polling).
657
+ * The body is always inline data and is ignored while `src` is set.
655
658
  * Other components (e.g. `bn-dataset`) reference the stored data by the
656
659
  * `name` prop to run queries against it.
657
660
  */
658
661
  interface BnDatasource {
659
662
  /**
660
- * Polling interval in **seconds** for URL mode. When set and the body content is a URL, the component re-fetches data at this interval. Has no effect for inline JSON or compressed content. Set to `0` or leave unset to disable polling.
663
+ * Polling interval in **seconds** for `src`. When set together with `src`, the component re-fetches data at this interval. Has no effect for inline JSON or compressed content. Set to `0` or leave unset to disable polling.
661
664
  * @default 0
662
665
  */
663
666
  "interval": number;
@@ -666,10 +669,14 @@ export namespace Components {
666
669
  */
667
670
  "name": string;
668
671
  /**
669
- * When true (default), body content is plain JSON text. When false, body content is a compressed payload (`<hash>:<base64_gzip>`). Ignored in URL mode.
672
+ * When true (default), body content is plain JSON text. When false, body content is a compressed payload (`<hash>:<base64_gzip>`). Ignored when `src` is set.
670
673
  * @default true
671
674
  */
672
675
  "raw": boolean;
676
+ /**
677
+ * URL to fetch the JSON from. When set, the body is ignored.
678
+ */
679
+ "src"?: string;
673
680
  }
674
681
  interface BnFooter {
675
682
  /**
@@ -682,10 +689,10 @@ export namespace Components {
682
689
  */
683
690
  "displayPageNumber": boolean;
684
691
  /**
685
- * Pagenumber value. Is displayed if displayPageNumber == true
692
+ * Page label: a number or any text, e.g. `3` or `A-1`. Is displayed if displayPageNumber == true
686
693
  * @default null
687
694
  */
688
- "pageNumber": number | null;
695
+ "pageNumber": string | null;
689
696
  /**
690
697
  * Footer text. <br />If empty string (`''` or `null`) the footer row is omitted
691
698
  */
@@ -918,7 +925,7 @@ export namespace Components {
918
925
  */
919
926
  "pageFitToContent": boolean;
920
927
  /**
921
- * Page size format. Determines the pixel dimensions of the rendered page. <br /><br /> values:<br /> ```xga // hd // full-hd // 4k // 4k2k // a4 // a3 // a2 // a1 // a0 // letter // legal```
928
+ * Page size format. Determines the pixel dimensions of the rendered page. <br /><br /> values:<br /> ```xga // hd // full-hd // 4k // 4k2k // a6 // a5 // a4 // a3 // a2 // a1 // a0 // letter // legal // tabloid // ledger```
922
929
  */
923
930
  "pageFormat"?: string;
924
931
  /**
@@ -943,11 +950,11 @@ export namespace Components {
943
950
  | "3-over-1"
944
951
  | "custom-template";
945
952
  /**
946
- * Page number displayed in the footer. If empty, no page number is shown (unless `footerDisplayPageNumber` is also set).
953
+ * Page label displayed in the footer: a number or any text, e.g. `A-1`. Without it `bn-context` numbers the page by its position.
947
954
  */
948
955
  "pageNumber"?: string;
949
956
  /**
950
- * Page orientation. Default depends on the chosen format. <br /><br /> values:<br /> ```landscape // portrait```
957
+ * Page orientation. Default depends on the chosen format. When it differs from the `render-orientation` of `bn-context`, the page is turned onto the sheet. <br /><br /> values:<br /> ```landscape // portrait```
951
958
  */
952
959
  "pageOrientation"?: string;
953
960
  /**
@@ -1021,13 +1028,13 @@ export namespace Components {
1021
1028
  */
1022
1029
  "image": string;
1023
1030
  /**
1024
- * Message text. Rendered as HTML, sanitized against XSS (only safe tags such as `br`, `b`, `i`, `strong`, `em`, `a` and their attributes are kept; event handlers and `javascript:` URLs are stripped). <br />Use `<br />` for an explicit line break. <br />If empty string (`''` or `null`) the message row is omitted
1031
+ * Message text. Rendered as HTML, sanitized against XSS (only safe tags such as `br`, `b`, `i`, `strong`, `em`, `a` and their attributes are kept; any other element is removed with its content, and links keep only `http:`, `https:`, `mailto:` and relative URLs). <br />Use `<br />` for an explicit line break. <br />If empty string (`''` or `null`) the message row is omitted
1025
1032
  */
1026
1033
  "text": string;
1027
1034
  }
1028
1035
  interface BnPage {
1029
1036
  /**
1030
- * Defines the size of the page <br /><br /> values: <br /> ``` xga // hd // full-hd // 4k // 4k2k // a4 // a3 // a2 // a1 // a0 // letter // legal ``` <br /><br /> default: <br /> ```xga```
1037
+ * Defines the size of the page <br /><br /> values: <br /> ``` xga // hd // full-hd // 4k // 4k2k // a6 // a5 // a4 // a3 // a2 // a1 // a0 // letter // legal // tabloid // ledger ``` <br /><br /> default: <br /> ```xga```
1031
1038
  */
1032
1039
  "format": string;
1033
1040
  /**
@@ -1055,7 +1062,7 @@ export namespace Components {
1055
1062
  */
1056
1063
  interface BnScalingGroup {
1057
1064
  /**
1058
- * Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes, or in a bubble chart's `size.group`. The name `"auto"` is reserved, and names that parse as a number/SI value (`"100"`, `"1M"`) are rejected — they would be ambiguous with a literal scaling value.
1065
+ * Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes, or in a bubble chart's `size.group`. The name `"auto"` is reserved, and names that parse as a number/SI value (`"100"`, `"1M"`) are rejected - they would be ambiguous with a literal scaling value.
1059
1066
  */
1060
1067
  "name": string;
1061
1068
  /**
@@ -1073,12 +1080,12 @@ export namespace Components {
1073
1080
  */
1074
1081
  interface BnTable {
1075
1082
  /**
1076
- * Set the total width of bar chart columns, in em of the table font — the same unit and vocabulary as ```categoryWidth```, so ```bar-column-width="w15"``` renders exactly as wide as ```category-width="w15"```. The bar/pin drawing area is that width minus the value-label gutters. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w30 // w40 // w60 // w80 // w100 ```
1083
+ * Set the total width of bar chart columns, in em of the table font - the same unit and vocabulary as ```categoryWidth```, so ```bar-column-width="w15"``` renders exactly as wide as ```category-width="w15"```. The bar/pin drawing area is that width minus the value-label gutters. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w30 // w40 // w60 // w80 // w100 ```
1077
1084
  * @default "w10"
1078
1085
  */
1079
1086
  "barColumnWidth": string;
1080
1087
  /**
1081
- * List of column names to render as bar charts instead of numbers. <br /><br /> Absolute variances (d_*) render as horizontal bar charts. Relative variances (dr_*) render as pin/dot charts. Scenario columns (ac1..pl4) render as horizontal bar charts; when the table contains grouping structure (sum rows, thereof, or partof) they automatically render as an IBCS waterfall — data rows cascade from the running total and sum rows anchor at zero. Waterfall columns auto-scale to fit the bar column width (unit-scaling does not apply) and are not supported in combination with `interval` or `columnthereof`. <br /><br /> example:<br /> ```dac1_pp1_pos,drac1_pp1_pos,ac1```
1088
+ * List of column names to render as bar charts instead of numbers. <br /><br /> Absolute variances (d_*) render as horizontal bar charts. Relative variances (dr_*) render as pin/dot charts. Scenario columns (ac1..pl4) render as horizontal bar charts; when the table contains grouping structure (sum rows, thereof, or partof) they automatically render as an IBCS waterfall - data rows cascade from the running total and sum rows anchor at zero. Waterfall columns auto-scale to fit the bar column width (unit-scaling does not apply) and are not supported in combination with `interval` or `columnthereof`. <br /><br /> example:<br /> ```dac1_pp1_pos,drac1_pp1_pos,ac1```
1082
1089
  */
1083
1090
  "barColumns": string;
1084
1091
  /**
@@ -1122,7 +1129,7 @@ export namespace Components {
1122
1129
  */
1123
1130
  "grouped": string;
1124
1131
  /**
1125
- * Repeats the entire scenario/variance column block once per interval group, rendered under a spanning header band (e.g. `2023 | 2024 | 2025`, each with the configured columns). <br /><br /> values:<br /> ```none // setname // year // quarter // month // week // day // hour // minute // second // millisecond // auto``` <br /><br /> ```none``` (default) deactivates the feature. ```setname``` groups by the dataset's `setname` column (non-date comparison); rows with a blank setname raise a warning and are grouped under `—`. Date values bucket rows by the `date` column; ```auto``` detects the granularity from the date span. Cannot be combined with `columnthereof`.
1132
+ * Repeats the entire scenario/variance column block once per interval group, rendered under a spanning header band (e.g. `2023 | 2024 | 2025`, each with the configured columns). <br /><br /> values:<br /> ```none // setname // year // quarter // month // week // day // hour // minute // second // millisecond // auto``` <br /><br /> ```none``` (default) deactivates the feature. ```setname``` groups by the dataset's `setname` column (non-date comparison); rows with a blank setname raise a warning and are grouped under `-`. Date values bucket rows by the `date` column; ```auto``` detects the granularity from the date span. Cannot be combined with `columnthereof`.
1126
1133
  * @default "none"
1127
1134
  */
1128
1135
  "interval": string;
@@ -1162,7 +1169,7 @@ export namespace Components {
1162
1169
  */
1163
1170
  "partof": string;
1164
1171
  /**
1165
- * Percentage points displayed per 1 em of pin length for relative variance pin charts (ΔPY%) — a larger value means shorter pins. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest pin to the pin area | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_percentageScaling` warning | Default: `"2"` (a +2 % variance pin is 1 em long)
1172
+ * Percentage points displayed per 1 em of pin length for relative variance pin charts (ΔPY%) - a larger value means shorter pins. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest pin to the pin area | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_percentageScaling` warning | Default: `"2"` (a +2 % variance pin is 1 em long)
1166
1173
  * @example percentage-scaling="10"
1167
1174
  * @example percentage-scaling="pct-scale"
1168
1175
  * @default "2"
@@ -1173,8 +1180,8 @@ export namespace Components {
1173
1180
  */
1174
1181
  "ruleset"?: string;
1175
1182
  /**
1176
- * Controls proportional scaling of the entire table relative to the available parent width. All visual dimensions scale together: font size, em-based spacing/padding, SVG bar-chart widths, pin lengths, dot radii, pattern fills, axis strokes, and label offsets. Scaling is driven by a single factor applied to the base font size (`global.fontSizePx` from the component-style store, default 13.3333 px). Because the table's SCSS uses `em` units for padding, borders, and column widths, changing the font size cascades to all layout dimensions. SVG elements (bars, pins, patterns) receive the factor via the `scaleFactor` prop on `ibcs-table` and multiply every pixel constant by it, so they stay proportional to the surrounding text. | Value | Behavior | |---------------------|----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` | **Auto-scale algorithm** (modes `""` and `"auto"`): 1. After each render, the current `scrollWidth` of the host element is divided by the current `appliedScaleFactor` to derive the unscaled content width. This avoids resetting `--bn-font-size` to base (which would only affect em-based widths but not SVG pixel attributes). 2. This unscaled width is compared against the parent's content-box width (via `getParentDimensions`). 3. If the table overflows, `factor = parentWidth / unscaledWidth` is computed and applied to both the CSS variable and the `appliedScaleFactor` state (which re-renders the SVG charts). 4. A guard flag (`_autoScaleGuard`) prevents the subsequent state-triggered re-render from re-measuring, avoiding an infinite measure → scale → fits → reset → overflow loop. Invalid values (negative numbers, non-numeric strings that are not `"none"` or `"auto"`) fall back to the default behaviour (auto + warning) and emit an `ERR_scale` warning. **Only the width is fitted.** A table that renders taller than its constrained parent is clipped by the layout cell — bottom rows and the grand total simply disappear — so every render reports the measured overflow as a `WARN_overflow` item in `has-error`: an `error` when the size is pinned by `scale` (`"none"` or a factor), a `warning` in auto mode. The same item reports a width overflow, which only a fixed `scale` can produce. Setting `scale="auto"` does not fix a height overflow: give the component more space, reduce rows (`limit`), or set a smaller fixed `scale`.
1177
- * @example // Auto-scale to parent (silent) <bn-table scale="auto" ...></bn-table> // Fixed 50 % reduction <bn-table scale="0.5" ...></bn-table> // Double size <bn-table scale="2" ...></bn-table> // No scaling — always render at base font size <bn-table scale="none" ...></bn-table>
1183
+ * Controls proportional scaling of the entire table relative to the available parent width. All visual dimensions scale together: font size, em-based spacing/padding, SVG bar-chart widths, pin lengths, dot radii, pattern fills, axis strokes, and label offsets. Scaling is driven by a single factor applied to the base font size (`global.fontSizePx` from the component-style store, default 13.3333 px). Because the table's SCSS uses `em` units for padding, borders, and column widths, changing the font size cascades to all layout dimensions. SVG elements (bars, pins, patterns) receive the factor via the `scaleFactor` prop on `ibcs-table` and multiply every pixel constant by it, so they stay proportional to the surrounding text. | Value | Behavior | |---------------------|----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` | **Auto-scale algorithm** (modes `""` and `"auto"`): 1. After each render, the current `scrollWidth` of the host element is divided by the current `appliedScaleFactor` to derive the unscaled content width. This avoids resetting `--bn-font-size` to base (which would only affect em-based widths but not SVG pixel attributes). 2. This unscaled width is compared against the parent's content-box width (via `getParentDimensions`). 3. If the table overflows, `factor = parentWidth / unscaledWidth` is computed and applied to both the CSS variable and the `appliedScaleFactor` state (which re-renders the SVG charts). 4. A guard flag (`_autoScaleGuard`) prevents the subsequent state-triggered re-render from re-measuring, avoiding an infinite measure → scale → fits → reset → overflow loop. Invalid values (negative numbers, non-numeric strings that are not `"none"` or `"auto"`) fall back to the default behaviour (auto + warning) and emit an `ERR_scale` warning. **Only the width is fitted.** A table that renders taller than its constrained parent is clipped by the layout cell - bottom rows and the grand total simply disappear - so every render reports the measured overflow as a `WARN_overflow` item in `has-error`: an `error` when the size is pinned by `scale` (`"none"` or a factor), a `warning` in auto mode. The same item reports a width overflow, which only a fixed `scale` can produce. Setting `scale="auto"` does not fix a height overflow: give the component more space, reduce rows (`limit`), or set a smaller fixed `scale`.
1184
+ * @example // Auto-scale to parent (silent) <bn-table scale="auto" ...></bn-table> // Fixed 50 % reduction <bn-table scale="0.5" ...></bn-table> // Double size <bn-table scale="2" ...></bn-table> // No scaling - always render at base font size <bn-table scale="none" ...></bn-table>
1178
1185
  */
1179
1186
  "scale"?: string;
1180
1187
  /**
@@ -1216,7 +1223,7 @@ export namespace Components {
1216
1223
  */
1217
1224
  "type": string;
1218
1225
  /**
1219
- * Data units displayed per 1 em of bar length for absolute variance bar charts (ΔPY) — map-scale semantics: a larger value means smaller bars. Bars exceeding barColumnWidth are shown with an arrow indicator. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest bar to the bar column width | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_unitScaling` warning | Default: `"100"` (1 em of bar represents 100 units)
1226
+ * Data units displayed per 1 em of bar length for absolute variance bar charts (ΔPY) - map-scale semantics: a larger value means smaller bars. Bars exceeding barColumnWidth are shown with an arrow indicator. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest bar to the bar column width | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_unitScaling` warning | Default: `"100"` (1 em of bar represents 100 units)
1220
1227
  * @example unit-scaling="1M"
1221
1228
  * @example unit-scaling="revenue-scale"
1222
1229
  * @default "100"
@@ -1234,19 +1241,20 @@ export namespace Components {
1234
1241
  "templateId": string;
1235
1242
  }
1236
1243
  /**
1237
- * Renders a template-driven text block with dataset interpolation.
1238
- * The `value` prop is evaluated as a JavaScript template literal in a
1239
- * sandboxed scope (`data` and `t` are available) and sanitized against
1240
- * XSS before being injected as HTML. Supports auto-scaling to fit the
1241
- * parent container.
1244
+ * Renders a text block from a template with dataset and translation
1245
+ * placeholders.
1246
+ * The `value` prop is markup with `${...}` placeholders. Placeholders are
1247
+ * looked up, never evaluated. Resolved values are HTML-escaped and the
1248
+ * result is sanitized before it is inserted. Supports auto-scaling to fit
1249
+ * the parent container.
1242
1250
  */
1243
1251
  interface BnText {
1244
1252
  /**
1245
- * Controls font-size scaling relative to the available parent space. Scaling considers both width and height — the tighter constraint wins. | Value | Behavior | |----------------|----------------------------------------------------------------| | not set / `""` | Auto-scale to fit, emit `AUTO_scale` warning with applied factor | | `"none"` | No scaling; emit `WARN_overflow` warning if content overflows | | `"auto"` | Auto-scale to fit, silent (no warning) | | `"0.5"`, `"1.2"`, … | Apply `baseFontSize × factor`; emit `WARN_overflow` if still overflows | Invalid values (negative, non-numeric, non-keyword) fall back to the default (auto + warning) and emit an `ERR_scale` warning.
1253
+ * Controls font-size scaling relative to the available parent space. Scaling considers both width and height - the tighter constraint wins. | Value | Behavior | |----------------|----------------------------------------------------------------| | not set / `""` | Auto-scale to fit, emit `AUTO_scale` warning with applied factor | | `"none"` | No scaling; emit `WARN_overflow` warning if content overflows | | `"auto"` | Auto-scale to fit, silent (no warning) | | `"0.5"`, `"1.2"`, … | Apply `baseFontSize × factor`; emit `WARN_overflow` if still overflows | Invalid values (negative, non-numeric, non-keyword) fall back to the default (auto + warning) and emit an `ERR_scale` warning.
1246
1254
  */
1247
1255
  "scale"?: string;
1248
1256
  /**
1249
- * Template string rendered as HTML. Supports JavaScript template literal syntax — use `${data.<dataset>}` to interpolate dataset values and `${t('<key>')}` for translated strings. The template is evaluated in a sandboxed scope (only `data` and `t` are accessible; globals like `window`/`document` are blocked) and the output is sanitized against XSS (only safe HTML tags and attributes are kept).
1257
+ * Template string rendered as HTML. These placeholders are replaced: `${data.<dataset>[<row>].<field>}`, `${data['<name>'][<row>].<field>}` (for names such as the datasource reference `$revenue`), `${t('<key>')}` and `${t('<key>', { <name>: <text, number or data path> })}`. Any other text, including any other `${...}`, is printed as written. Nothing is evaluated. Resolved values are HTML-escaped, so dataset values and translations are shown as text. Markup written in the template is kept if it is on the allowlist; other elements are removed with their content. A placeholder that does not resolve renders empty and adds a `WARN_value_path` warning.
1250
1258
  * @example // plain text value="Hello World" // with dataset interpolation value="Revenue: ${data.kpi[0].ac1}" // with translation value="${t('report.title')}" // with HTML formatting value="<b>Total</b>: ${data.kpi[0].ac1}<br>as of today"
1251
1259
  */
1252
1260
  "value"?: string;
@@ -1395,7 +1403,7 @@ export namespace Components {
1395
1403
  */
1396
1404
  "dataVersion": number;
1397
1405
  /**
1398
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
1406
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
1399
1407
  */
1400
1408
  "errors"?: ErrorDispatcher;
1401
1409
  /**
@@ -1469,7 +1477,7 @@ export namespace Components {
1469
1477
  */
1470
1478
  "dataVersion": number;
1471
1479
  /**
1472
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
1480
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
1473
1481
  */
1474
1482
  "errors"?: ErrorDispatcher;
1475
1483
  /**
@@ -1543,7 +1551,7 @@ export namespace Components {
1543
1551
  */
1544
1552
  "dataVersion": number;
1545
1553
  /**
1546
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
1554
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
1547
1555
  */
1548
1556
  "errors"?: ErrorDispatcher;
1549
1557
  /**
@@ -1604,6 +1612,10 @@ export namespace Components {
1604
1612
  * @default 0
1605
1613
  */
1606
1614
  "dataVersion": number;
1615
+ /**
1616
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
1617
+ */
1618
+ "errors"?: ErrorDispatcher;
1607
1619
  /**
1608
1620
  * @default ""
1609
1621
  */
@@ -1703,6 +1715,10 @@ export namespace Components {
1703
1715
  * @default DateDistance.AUTO
1704
1716
  */
1705
1717
  "dateInterval": DateDistance;
1718
+ /**
1719
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
1720
+ */
1721
+ "errors"?: ErrorDispatcher;
1706
1722
  /**
1707
1723
  * @default ""
1708
1724
  */
@@ -1802,7 +1818,7 @@ export namespace Components {
1802
1818
  /**
1803
1819
  * Internal rendering engine for `bn-table`.
1804
1820
  * Receives pre-validated, typed props from the outer `bn-table` wrapper and
1805
- * builds the IBCS-compliant HTML table — including header rows, scenario
1821
+ * builds the IBCS-compliant HTML table - including header rows, scenario
1806
1822
  * columns, variance columns (with optional inline bar/pin charts), thereof/
1807
1823
  * partof drill-down rows, and grouped row sections. This component should
1808
1824
  * not be used directly; use `bn-table` instead.
@@ -1813,7 +1829,7 @@ export namespace Components {
1813
1829
  */
1814
1830
  "attributeColumns": TableAttribute[];
1815
1831
  /**
1816
- * Total width of a bar chart column, in em of the table font — the same unit `categoryWidth` uses, so the two render at the same width for the same value.
1832
+ * Total width of a bar chart column, in em of the table font - the same unit `categoryWidth` uses, so the two render at the same width for the same value.
1817
1833
  * @default 30
1818
1834
  */
1819
1835
  "barColumnMaxWidth": number;
@@ -1838,12 +1854,16 @@ export namespace Components {
1838
1854
  * @default 0
1839
1855
  */
1840
1856
  "dataVersion": number;
1857
+ /**
1858
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
1859
+ */
1860
+ "errors"?: ErrorDispatcher;
1841
1861
  /**
1842
1862
  * @default ""
1843
1863
  */
1844
1864
  "filter": string;
1845
1865
  /**
1846
- * Collects the table's layout-state contribution: header/body regions, counts, and — with `detail: "full"` — per-cell geometry paired with the table model (values, column keys, in-cell bar charts). Called by the outer `bn-table`; not for end users.
1866
+ * Collects the table's layout-state contribution: header/body regions, counts, and - with `detail: "full"` - per-cell geometry paired with the table model (values, column keys, in-cell bar charts). Called by the outer `bn-table`; not for end users.
1847
1867
  */
1848
1868
  "getLayoutDetail": (origins: Origins, detail: "summary" | "full") => Promise<TableLayoutDetail1>;
1849
1869
  /**
@@ -1925,7 +1945,7 @@ export namespace Components {
1925
1945
  */
1926
1946
  "sumTitle": string;
1927
1947
  /**
1928
- * Name of the dataset (a table or view in the shared alasql database). The inner `Table` helper queries it directly — no array copy.
1948
+ * Name of the dataset (a table or view in the shared alasql database). The inner `Table` helper queries it directly - no array copy.
1929
1949
  * @default ""
1930
1950
  */
1931
1951
  "tableName": string;
@@ -2021,9 +2041,9 @@ declare global {
2021
2041
  * IBCS bullet graph: one horizontal row per KPI with a solid actual bar and
2022
2042
  * a target marker.
2023
2043
  * Subscribes to a dataset (via `withDataset`) and renders in the IBCS
2024
- * default mode with **normalized targets** — every row is scaled to
2044
+ * default mode with **normalized targets** - every row is scaled to
2025
2045
  * fractions of its target so one continuous target line spans all rows and
2026
- * KPIs become visually comparable — plus integrated variance bars in the
2046
+ * KPIs become visually comparable - plus integrated variance bars in the
2027
2047
  * IBCS variance colors. The classic Stephen Few look is opt-in via
2028
2048
  * `normalize="none"` (per-row scales) and `ranges` (max two qualitative
2029
2049
  * gray bands). Actual and target scenarios are auto-detected from the
@@ -2096,14 +2116,13 @@ declare global {
2096
2116
  /**
2097
2117
  * Queries data from one or more `bn-datasource` entries via AlaSQL and
2098
2118
  * writes the result to the `datasets` store (+ computed `DatasetMeta`).
2099
- * The body content is observed via `withBodyObserver` and may be:
2100
- * 1. **SQL** (default) — AlaSQL query against referenced `datasources`.
2101
- * 2. **Static JSON** — set `static="true"` to bypass SQL and write the
2119
+ * The body content is observed via `withBodyObserver` and is always inline:
2120
+ * 1. **SQL** (default) - AlaSQL query against referenced `datasources`.
2121
+ * 2. **Static JSON** - set `static="true"` to bypass SQL and write the
2102
2122
  * parsed body directly to the `datasets` store.
2103
- * 3. **URL** — place an `http://`/`https://` URL or a same-origin path
2104
- * starting with `/` in the body to fetch JSON from an HTTP endpoint and
2105
- * write it to the `datasets` store. Set the `interval` prop (in seconds)
2106
- * to enable periodic re-fetching.
2123
+ * Set the `src` attribute to fetch JSON from an HTTP endpoint instead and
2124
+ * write it to the `datasets` store. Set the `interval` prop (in seconds)
2125
+ * to enable periodic re-fetching.
2107
2126
  */
2108
2127
  interface HTMLBnDatasetElement extends Components.BnDataset, HTMLStencilElement {
2109
2128
  }
@@ -2114,12 +2133,12 @@ declare global {
2114
2133
  /**
2115
2134
  * Ingests data and writes it to the scoped `datasources` store.
2116
2135
  * Data can be provided in three ways:
2117
- * 1. **Inline JSON** — Place JSON text inside the element body (default).
2118
- * 2. **Compressed payload** — Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
2119
- * 3. **URL** — Place an `http://`/`https://` URL or a same-origin path
2120
- * starting with `/` in the body to fetch JSON from an HTTP endpoint.
2121
- * In URL mode the component fetches JSON from the URL. Set the `interval`
2122
- * prop (in seconds) to enable periodic re-fetching (polling).
2136
+ * 1. **Inline JSON** - Place JSON text inside the element body (default).
2137
+ * 2. **Compressed payload** - Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
2138
+ * 3. **URL** - Set the `src` attribute to fetch JSON from an HTTP endpoint.
2139
+ * Set the `interval` prop (in seconds) to enable periodic re-fetching
2140
+ * (polling).
2141
+ * The body is always inline data and is ignored while `src` is set.
2123
2142
  * Other components (e.g. `bn-dataset`) reference the stored data by the
2124
2143
  * `name` prop to run queries against it.
2125
2144
  */
@@ -2227,11 +2246,12 @@ declare global {
2227
2246
  new (): HTMLBnTemplateElement;
2228
2247
  };
2229
2248
  /**
2230
- * Renders a template-driven text block with dataset interpolation.
2231
- * The `value` prop is evaluated as a JavaScript template literal in a
2232
- * sandboxed scope (`data` and `t` are available) and sanitized against
2233
- * XSS before being injected as HTML. Supports auto-scaling to fit the
2234
- * parent container.
2249
+ * Renders a text block from a template with dataset and translation
2250
+ * placeholders.
2251
+ * The `value` prop is markup with `${...}` placeholders. Placeholders are
2252
+ * looked up, never evaluated. Resolved values are HTML-escaped and the
2253
+ * result is sanitized before it is inserted. Supports auto-scaling to fit
2254
+ * the parent container.
2235
2255
  */
2236
2256
  interface HTMLBnTextElement extends Components.BnText, HTMLStencilElement {
2237
2257
  }
@@ -2323,7 +2343,7 @@ declare global {
2323
2343
  /**
2324
2344
  * Internal rendering engine for `bn-table`.
2325
2345
  * Receives pre-validated, typed props from the outer `bn-table` wrapper and
2326
- * builds the IBCS-compliant HTML table — including header rows, scenario
2346
+ * builds the IBCS-compliant HTML table - including header rows, scenario
2327
2347
  * columns, variance columns (with optional inline bar/pin charts), thereof/
2328
2348
  * partof drill-down rows, and grouped row sections. This component should
2329
2349
  * not be used directly; use `bn-table` instead.
@@ -2470,11 +2490,11 @@ declare namespace LocalJSX {
2470
2490
  */
2471
2491
  "size": string;
2472
2492
  /**
2473
- * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Market attractiveness", "refLine":0.5}`.
2493
+ * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Market attractiveness", "refLine":0.5}`. A relative variance (`dr…`) gives an axis in percent: the ticks print `20%`, and `min`, `max`, `refLine` and `highlight` are written in percent too (`20` for 20 %).
2474
2494
  */
2475
2495
  "x": string;
2476
2496
  /**
2477
- * Y axis mapping — same shape as `x`.
2497
+ * Y axis mapping - same shape as `x`.
2478
2498
  */
2479
2499
  "y": string;
2480
2500
  }
@@ -2482,9 +2502,9 @@ declare namespace LocalJSX {
2482
2502
  * IBCS bullet graph: one horizontal row per KPI with a solid actual bar and
2483
2503
  * a target marker.
2484
2504
  * Subscribes to a dataset (via `withDataset`) and renders in the IBCS
2485
- * default mode with **normalized targets** — every row is scaled to
2505
+ * default mode with **normalized targets** - every row is scaled to
2486
2506
  * fractions of its target so one continuous target line spans all rows and
2487
- * KPIs become visually comparable — plus integrated variance bars in the
2507
+ * KPIs become visually comparable - plus integrated variance bars in the
2488
2508
  * IBCS variance colors. The classic Stephen Few look is opt-in via
2489
2509
  * `normalize="none"` (per-row scales) and `ranges` (max two qualitative
2490
2510
  * gray bands). Actual and target scenarios are auto-detected from the
@@ -2494,7 +2514,7 @@ declare namespace LocalJSX {
2494
2514
  */
2495
2515
  interface BnChartBullet {
2496
2516
  /**
2497
- * Actual-value measure. JSON object or a bare scenario slot as shorthand: `{"measure":"ac1","label":"Revenue","unit":"EUR k"}`. Only plain scenario slots (`ac1`…`pl4`) are allowed — variance tokens are not. Empty or `"auto"` auto-detects (`ac1`, else the first available scenario).
2517
+ * Actual-value measure. JSON object or a bare scenario slot as shorthand: `{"measure":"ac1","label":"Revenue","unit":"EUR k"}`. Only plain scenario slots (`ac1`…`pl4`) are allowed - variance tokens are not. Empty or `"auto"` auto-detects (`ac1`, else the first available scenario).
2498
2518
  * @default ""
2499
2519
  */
2500
2520
  "actual"?: string;
@@ -2519,12 +2539,12 @@ declare namespace LocalJSX {
2519
2539
  */
2520
2540
  "level"?: string;
2521
2541
  /**
2522
- * Maximum number of KPI rows (0 = unlimited). Truncates — there is no REST aggregate, summing heterogeneous KPIs would be meaningless.
2542
+ * Maximum number of KPI rows (0 = unlimited). Truncates - there is no REST aggregate, summing heterogeneous KPIs would be meaningless.
2523
2543
  * @default 0
2524
2544
  */
2525
2545
  "limit"?: number;
2526
2546
  /**
2527
- * Target normalization: `target` (default — rows share an aligned target position, the IBCS-comparable form) or `none` (classic per-row scales with tick strips).
2547
+ * Target normalization: `target` (default - rows share an aligned target position, the IBCS-comparable form) or `none` (classic per-row scales with tick strips).
2528
2548
  * @default "target"
2529
2549
  */
2530
2550
  "normalize"?: string;
@@ -2539,7 +2559,7 @@ declare namespace LocalJSX {
2539
2559
  */
2540
2560
  "orderDirection"?: string;
2541
2561
  /**
2542
- * Qualitative range bands as a JSON array of ascending fractions of the target, at most two — e.g. `[0.6, 0.9]` (IBCS rejects a third band of arbitrary length). Classic mode only; ignored while `normalize` is `"target"`.
2562
+ * Qualitative range bands as a JSON array of ascending fractions of the target, at most two - e.g. `[0.6, 0.9]` (IBCS rejects a third band of arbitrary length). Classic mode only; ignored while `normalize` is `"target"`.
2543
2563
  * @default ""
2544
2564
  */
2545
2565
  "ranges"?: string;
@@ -2552,12 +2572,12 @@ declare namespace LocalJSX {
2552
2572
  */
2553
2573
  "scale"?: string;
2554
2574
  /**
2555
- * Target measure — same shape as `actual`. Empty or `"auto"` auto-detects (`pl1` > `pp1` > `fc1`); without any target scenario the chart renders actual bars only.
2575
+ * Target measure - same shape as `actual`. Empty or `"auto"` auto-detects (`pl1` > `pp1` > `fc1`); without any target scenario the chart renders actual bars only.
2556
2576
  * @default ""
2557
2577
  */
2558
2578
  "target"?: string;
2559
2579
  /**
2560
- * Variance bars between actual and target: `auto` (default — drawn in normalized mode, favorable/unfavorable in the IBCS variance colors) or `none`.
2580
+ * Variance bars between actual and target: `auto` (default - drawn in normalized mode, favorable/unfavorable in the IBCS variance colors) or `none`.
2561
2581
  * @default "auto"
2562
2582
  */
2563
2583
  "variances"?: string;
@@ -2630,11 +2650,11 @@ declare namespace LocalJSX {
2630
2650
  */
2631
2651
  "seriesLevel"?: string;
2632
2652
  /**
2633
- * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Margin","unit":"%","min":0, "max":40,"refLine":0.5,"highlight":{"from":30}}`. The measure is a scenario column (`ac1`…`pl4`) or a variance token (`d…`/`dr…`, sentiment suffix optional).
2653
+ * X axis mapping. JSON object (`AxisSpec`) or a bare measure token as shorthand: `{"measure":"ac1","label":"Margin","unit":"%","min":0, "max":40,"refLine":0.5,"highlight":{"from":30}}`. The measure is a scenario column (`ac1`…`pl4`) or a variance token (`d…`/`dr…`, sentiment suffix optional). A relative variance (`dr…`) gives an axis in percent: the ticks print `20%`, and `min`, `max`, `refLine` and `highlight` are written in percent too (`20` for 20 %).
2634
2654
  */
2635
2655
  "x": string;
2636
2656
  /**
2637
- * Y axis mapping — same shape as `x`.
2657
+ * Y axis mapping - same shape as `x`.
2638
2658
  */
2639
2659
  "y": string;
2640
2660
  }
@@ -2684,7 +2704,7 @@ declare namespace LocalJSX {
2684
2704
  */
2685
2705
  "measureUnit"?: string;
2686
2706
  /**
2687
- * Comma-separated list of columns that define the sort order of bars. When ordering by a scenario column, that scenario must also be listed in `scenarios`. Valid values: `category`, `categoryIndex`, `rowGroup`, `rowGroupIndex`, `subCategory`, `subCategoryIndex`, `ac1`–`ac4`, `fc1`–`fc4`, `pp1`–`pp4`, `pl1`–`pl4`. | Value | Behavior | |----------------|-----------------------------------------------------| | `"ac1"` | Sort bars by the ac1 scenario values | | `"category"` | Sort bars alphabetically by category name | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect with `AUTO_order` warning |
2707
+ * Comma-separated list of columns that define the sort order of bars. When ordering by a scenario column, that scenario must also be listed in `scenarios`. Valid values: `category`, `categoryIndex`, `rowGroup`, `rowGroupIndex`, `subCategory`, `subCategoryIndex`, `ac1`-`ac4`, `fc1`-`fc4`, `pp1`-`pp4`, `pl1`-`pl4`. | Value | Behavior | |----------------|-----------------------------------------------------| | `"ac1"` | Sort bars by the ac1 scenario values | | `"category"` | Sort bars alphabetically by category name | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect with `AUTO_order` warning |
2688
2708
  * @example order="ac1"
2689
2709
  */
2690
2710
  "order": string;
@@ -2695,7 +2715,7 @@ declare namespace LocalJSX {
2695
2715
  */
2696
2716
  "orderDirection": string;
2697
2717
  /**
2698
- * Percentage points displayed per 1 em of bar length for relative variances — a larger value means shorter bars. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available width | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2718
+ * Percentage points displayed per 1 em of bar length for relative variances - a larger value means shorter bars. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available width | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2699
2719
  * @example percentage-scaling="10"
2700
2720
  * @example percentage-scaling="pct-scale"
2701
2721
  */
@@ -2705,11 +2725,11 @@ declare namespace LocalJSX {
2705
2725
  */
2706
2726
  "ruleset"?: string;
2707
2727
  /**
2708
- * Controls proportional scaling of the chart to fit the available parent height. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent height; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent height silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` |
2728
+ * Controls proportional scaling of the chart to fit the available parent height. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent height; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent height silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` |
2709
2729
  */
2710
2730
  "scale"?: string;
2711
2731
  /**
2712
- * Comma-separated list of scenario columns to display as bars. Up to 4 scenarios are supported; additional values are ignored. Valid scenario names: `ac1`–`ac4`, `fc1`–`fc4`, `pp1`–`pp4`, `pl1`–`pl4`. | Value | Behavior | |---------------|-------------------------------------------------------------| | `"ac1,fc1"` | Show the listed scenarios | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect from dataset metadata (emits `AUTO_scenarios` warning) |
2732
+ * Comma-separated list of scenario columns to display as bars. Up to 4 scenarios are supported; additional values are ignored. Valid scenario names: `ac1`-`ac4`, `fc1`-`fc4`, `pp1`-`pp4`, `pl1`-`pl4`. | Value | Behavior | |---------------|-------------------------------------------------------------| | `"ac1,fc1"` | Show the listed scenarios | | `"auto"` | Auto-detect from dataset metadata (no warning) | | not set / `""` | Auto-detect from dataset metadata (emits `AUTO_scenarios` warning) |
2713
2733
  * @example scenarios="ac1,pp1,pl1"
2714
2734
  */
2715
2735
  "scenarios": string;
@@ -2726,14 +2746,14 @@ declare namespace LocalJSX {
2726
2746
  */
2727
2747
  "showMeasureScale"?: string;
2728
2748
  /**
2729
- * Stacking configuration as a JSON string. When set, bars are drawn as stacked segments instead of side-by-side. **Properties:** | Key | Values | Description | |---------|-----------------------------------------------|----------------------------------------------------| | `by` | `"scenarios"` \| `"dimensions"` | **Required.** What to stack. | | `mode` | `"absolute"` \| `"relative"` \| `"absolute-relative"` | Stacking mode. Default: `"absolute"`. | | `order` | `"asc"` \| `"desc"` \| `"dataset"` | Segment sort order. Default: `"dataset"`. | - `by: "scenarios"` — stacks the scenarios listed in the `scenarios` prop end-to-end. - `by: "dimensions"` — stacks by the next-lower hierarchy level derived from `level` (e.g. level `"rowGroup"` stacks by category). Only the first scenario is used; extra scenarios trigger a `WARN_stack_dimensions_scenarios` warning. - `mode: "relative"` — normalizes each bar to 100%, showing proportions. - `mode: "absolute-relative"` — absolute bars with percentage labels. Segment colors are configurable via the `stackColors` array in component styles.
2749
+ * Stacking configuration as a JSON string. When set, bars are drawn as stacked segments instead of side-by-side. **Properties:** | Key | Values | Description | |---------|-----------------------------------------------|----------------------------------------------------| | `by` | `"scenarios"` \| `"dimensions"` | **Required.** What to stack. | | `mode` | `"absolute"` \| `"relative"` \| `"absolute-relative"` | Stacking mode. Default: `"absolute"`. | | `order` | `"asc"` \| `"desc"` \| `"dataset"` | Segment sort order. Default: `"dataset"`. | - `by: "scenarios"` - stacks the scenarios listed in the `scenarios` prop end-to-end. - `by: "dimensions"` - stacks by the next-lower hierarchy level derived from `level` (e.g. level `"rowGroup"` stacks by category). Only the first scenario is used; extra scenarios trigger a `WARN_stack_dimensions_scenarios` warning. - `mode: "relative"` - normalizes each bar to 100%, showing proportions. - `mode: "absolute-relative"` - absolute bars with percentage labels. Segment colors are configurable via the `stackColors` array in component styles.
2730
2750
  * @default "" (no stacking)
2731
2751
  * @example stack='{"by":"scenarios","mode":"absolute"}'
2732
2752
  * @example stack='{"by":"dimensions","mode":"relative"}'
2733
2753
  */
2734
2754
  "stack"?: string;
2735
2755
  /**
2736
- * Data units displayed per 1 em of bar length (horizontal bars) — map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container width | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | When using a custom value that causes the chart to exceed its container, a `WARN_overflow` error is emitted.
2756
+ * Data units displayed per 1 em of bar length (horizontal bars) - map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container width | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | When using a custom value that causes the chart to exceed its container, a `WARN_overflow` error is emitted.
2737
2757
  * @example unit-scaling="auto"
2738
2758
  * @example unit-scaling="1M"
2739
2759
  * @example unit-scaling="revenue-scale"
@@ -2780,7 +2800,7 @@ declare namespace LocalJSX {
2780
2800
  */
2781
2801
  "filter"?: string;
2782
2802
  /**
2783
- * Max number of collumns is used to calculate Axis Date Interval (if dateInterval is set to AUTO)
2803
+ * Max number of columns. Only used to choose the date interval when dateInterval is AUTO: the finest interval that gives fewer periods than this. The series is never cut.
2784
2804
  * @default 28
2785
2805
  */
2786
2806
  "intervalSpanLimit"?: number;
@@ -2822,7 +2842,7 @@ declare namespace LocalJSX {
2822
2842
  */
2823
2843
  "orderDirection": string;
2824
2844
  /**
2825
- * Percentage points displayed per 1 em of pin/bar length for relative variances — a larger value means shorter pins. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available height (same two-pass as unit-scaling) | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2845
+ * Percentage points displayed per 1 em of pin/bar length for relative variances - a larger value means shorter pins. | Value | Behavior | |-------------------|---------------------------------------------------------------| | `"auto"` | Auto-fit to available height (same two-pass as unit-scaling) | | not set / invalid | Same as auto with `AUTO_percentageScaling` warning | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2826
2846
  * @example percentage-scaling="10"
2827
2847
  * @example percentage-scaling="pct-scale"
2828
2848
  */
@@ -2832,7 +2852,7 @@ declare namespace LocalJSX {
2832
2852
  */
2833
2853
  "ruleset"?: string;
2834
2854
  /**
2835
- * Controls proportional scaling of the chart to fit the available parent width. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` |
2855
+ * Controls proportional scaling of the chart to fit the available parent width. | Value | Behavior | |---------------------|-----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` |
2836
2856
  */
2837
2857
  "scale"?: string;
2838
2858
  /**
@@ -2857,8 +2877,8 @@ declare namespace LocalJSX {
2857
2877
  */
2858
2878
  "showOverlayMedian"?: string;
2859
2879
  /**
2860
- * Stacking configuration for the chart as a JSON string. When set, bars/columns are drawn stacked (additive layers) instead of side-by-side. In line mode (`chart-mode="line"`), stacking produces a stacked area chart with filled regions between cumulative lines. **JSON schema:** ```json { "by": "scenario" | "category" | "subcategory" | "rowgroup", "mode": "absolute" | "relative" | "absolute-relative", "order": "asc" | "desc" | "dataset" } ``` - `by` (required): The dimension to stack. - `"scenario"` — stack the scenarios from the `scenarios` prop as layers. - `"category"` / `"subcategory"` / `"rowgroup"` — decompose a single scenario by this data dimension. Must be finer than `level`. - `mode` (optional, default `"absolute"`): - `"absolute"` — additive stacking, axis shows absolute units. - `"relative"` — 100% stacking, axis shows 0%–100%. `unit-scaling` is interpreted as pixels per percentage point (e.g. `0.4` → 40px full stack); `"auto"` fits the stack to the available height as usual. - `"absolute-relative"` — bar height is absolute (real value), but segment labels inside show percentages. - `order` (optional, default `"dataset"`): Segment order within each stack. `"asc"` / `"desc"` sort segments by value; `"dataset"` preserves the original data/scenario order.
2861
- * @default '' (empty — no stacking)
2880
+ * Stacking configuration for the chart as a JSON string. When set, bars/columns are drawn stacked (additive layers) instead of side-by-side. In line mode (`chart-mode="line"`), stacking produces a stacked area chart with filled regions between cumulative lines. **JSON schema:** ```json { "by": "scenario" | "category" | "subcategory" | "rowgroup", "mode": "absolute" | "relative" | "absolute-relative", "order": "asc" | "desc" | "dataset" } ``` - `by` (required): The dimension to stack. - `"scenario"` - stack the scenarios from the `scenarios` prop as layers. - `"category"` / `"subcategory"` / `"rowgroup"` - decompose a single scenario by this data dimension. Must be finer than `level`. - `mode` (optional, default `"absolute"`): - `"absolute"` - additive stacking, axis shows absolute units. - `"relative"` - 100% stacking, axis shows 0%-100%. `unit-scaling` is interpreted as pixels per percentage point (e.g. `0.4` → 40px full stack); `"auto"` fits the stack to the available height as usual. - `"absolute-relative"` - bar height is absolute (real value), but segment labels inside show percentages. - `order` (optional, default `"dataset"`): Segment order within each stack. `"asc"` / `"desc"` sort segments by value; `"dataset"` preserves the original data/scenario order.
2881
+ * @default '' (empty - no stacking)
2862
2882
  * @example // Stack scenarios stack='{"by":"scenario"}'
2863
2883
  * @example // Stack by category, relative mode stack='{"by":"category","mode":"relative"}'
2864
2884
  */
@@ -2868,7 +2888,7 @@ declare namespace LocalJSX {
2868
2888
  */
2869
2889
  "syncSpaceLeft"?: number;
2870
2890
  /**
2871
- * Data units displayed per 1 em of bar length (vertical bars) — map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container height | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2891
+ * Data units displayed per 1 em of bar length (vertical bars) - map-scale semantics: a larger value means smaller bars. | Value | Behavior | |--------------------|-------------------------------------------------------------| | `"auto"` | Auto-fit bars to fill the available container height | | not set / invalid | Same as auto, but emits `AUTO_unitScaling` warning | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling |
2872
2892
  * @example unit-scaling="auto"
2873
2893
  * @example unit-scaling="1M"
2874
2894
  * @example unit-scaling="revenue-scale"
@@ -2895,14 +2915,13 @@ declare namespace LocalJSX {
2895
2915
  /**
2896
2916
  * Queries data from one or more `bn-datasource` entries via AlaSQL and
2897
2917
  * writes the result to the `datasets` store (+ computed `DatasetMeta`).
2898
- * The body content is observed via `withBodyObserver` and may be:
2899
- * 1. **SQL** (default) — AlaSQL query against referenced `datasources`.
2900
- * 2. **Static JSON** — set `static="true"` to bypass SQL and write the
2918
+ * The body content is observed via `withBodyObserver` and is always inline:
2919
+ * 1. **SQL** (default) - AlaSQL query against referenced `datasources`.
2920
+ * 2. **Static JSON** - set `static="true"` to bypass SQL and write the
2901
2921
  * parsed body directly to the `datasets` store.
2902
- * 3. **URL** — place an `http://`/`https://` URL or a same-origin path
2903
- * starting with `/` in the body to fetch JSON from an HTTP endpoint and
2904
- * write it to the `datasets` store. Set the `interval` prop (in seconds)
2905
- * to enable periodic re-fetching.
2922
+ * Set the `src` attribute to fetch JSON from an HTTP endpoint instead and
2923
+ * write it to the `datasets` store. Set the `interval` prop (in seconds)
2924
+ * to enable periodic re-fetching.
2906
2925
  */
2907
2926
  interface BnDataset {
2908
2927
  /**
@@ -2911,7 +2930,7 @@ declare namespace LocalJSX {
2911
2930
  */
2912
2931
  "datasources"?: string;
2913
2932
  /**
2914
- * Polling interval in **seconds** for URL mode. When set and the body content is a URL, the component re-fetches data at this interval. Has no effect for SQL, inline JSON or compressed content. Set to `0` or leave unset to disable polling.
2933
+ * Polling interval in **seconds** for `src`. When set together with `src`, the component re-fetches data at this interval. Has no effect for SQL, inline JSON or compressed content. Set to `0` or leave unset to disable polling.
2915
2934
  * @default 0
2916
2935
  */
2917
2936
  "interval"?: number;
@@ -2924,6 +2943,10 @@ declare namespace LocalJSX {
2924
2943
  * @default true
2925
2944
  */
2926
2945
  "raw"?: boolean;
2946
+ /**
2947
+ * URL to fetch the dataset JSON from. When set, the body is ignored and the fetched payload is written directly to the `datasets` store (`static` and `raw` do not apply).
2948
+ */
2949
+ "src"?: string;
2927
2950
  /**
2928
2951
  * When true, bypasses the AlaSQL query engine and parses the body content as raw JSON, writing it directly to the datasets store.
2929
2952
  * @default false
@@ -2933,18 +2956,18 @@ declare namespace LocalJSX {
2933
2956
  /**
2934
2957
  * Ingests data and writes it to the scoped `datasources` store.
2935
2958
  * Data can be provided in three ways:
2936
- * 1. **Inline JSON** — Place JSON text inside the element body (default).
2937
- * 2. **Compressed payload** — Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
2938
- * 3. **URL** — Place an `http://`/`https://` URL or a same-origin path
2939
- * starting with `/` in the body to fetch JSON from an HTTP endpoint.
2940
- * In URL mode the component fetches JSON from the URL. Set the `interval`
2941
- * prop (in seconds) to enable periodic re-fetching (polling).
2959
+ * 1. **Inline JSON** - Place JSON text inside the element body (default).
2960
+ * 2. **Compressed payload** - Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
2961
+ * 3. **URL** - Set the `src` attribute to fetch JSON from an HTTP endpoint.
2962
+ * Set the `interval` prop (in seconds) to enable periodic re-fetching
2963
+ * (polling).
2964
+ * The body is always inline data and is ignored while `src` is set.
2942
2965
  * Other components (e.g. `bn-dataset`) reference the stored data by the
2943
2966
  * `name` prop to run queries against it.
2944
2967
  */
2945
2968
  interface BnDatasource {
2946
2969
  /**
2947
- * Polling interval in **seconds** for URL mode. When set and the body content is a URL, the component re-fetches data at this interval. Has no effect for inline JSON or compressed content. Set to `0` or leave unset to disable polling.
2970
+ * Polling interval in **seconds** for `src`. When set together with `src`, the component re-fetches data at this interval. Has no effect for inline JSON or compressed content. Set to `0` or leave unset to disable polling.
2948
2971
  * @default 0
2949
2972
  */
2950
2973
  "interval"?: number;
@@ -2953,10 +2976,14 @@ declare namespace LocalJSX {
2953
2976
  */
2954
2977
  "name": string;
2955
2978
  /**
2956
- * When true (default), body content is plain JSON text. When false, body content is a compressed payload (`<hash>:<base64_gzip>`). Ignored in URL mode.
2979
+ * When true (default), body content is plain JSON text. When false, body content is a compressed payload (`<hash>:<base64_gzip>`). Ignored when `src` is set.
2957
2980
  * @default true
2958
2981
  */
2959
2982
  "raw"?: boolean;
2983
+ /**
2984
+ * URL to fetch the JSON from. When set, the body is ignored.
2985
+ */
2986
+ "src"?: string;
2960
2987
  }
2961
2988
  interface BnFooter {
2962
2989
  /**
@@ -2969,10 +2996,10 @@ declare namespace LocalJSX {
2969
2996
  */
2970
2997
  "displayPageNumber"?: boolean;
2971
2998
  /**
2972
- * Pagenumber value. Is displayed if displayPageNumber == true
2999
+ * Page label: a number or any text, e.g. `3` or `A-1`. Is displayed if displayPageNumber == true
2973
3000
  * @default null
2974
3001
  */
2975
- "pageNumber"?: number | null;
3002
+ "pageNumber"?: string | null;
2976
3003
  /**
2977
3004
  * Footer text. <br />If empty string (`''` or `null`) the footer row is omitted
2978
3005
  */
@@ -3198,7 +3225,7 @@ declare namespace LocalJSX {
3198
3225
  */
3199
3226
  "pageFitToContent"?: boolean;
3200
3227
  /**
3201
- * Page size format. Determines the pixel dimensions of the rendered page. <br /><br /> values:<br /> ```xga // hd // full-hd // 4k // 4k2k // a4 // a3 // a2 // a1 // a0 // letter // legal```
3228
+ * Page size format. Determines the pixel dimensions of the rendered page. <br /><br /> values:<br /> ```xga // hd // full-hd // 4k // 4k2k // a6 // a5 // a4 // a3 // a2 // a1 // a0 // letter // legal // tabloid // ledger```
3202
3229
  */
3203
3230
  "pageFormat"?: string;
3204
3231
  /**
@@ -3223,11 +3250,11 @@ declare namespace LocalJSX {
3223
3250
  | "3-over-1"
3224
3251
  | "custom-template";
3225
3252
  /**
3226
- * Page number displayed in the footer. If empty, no page number is shown (unless `footerDisplayPageNumber` is also set).
3253
+ * Page label displayed in the footer: a number or any text, e.g. `A-1`. Without it `bn-context` numbers the page by its position.
3227
3254
  */
3228
3255
  "pageNumber"?: string;
3229
3256
  /**
3230
- * Page orientation. Default depends on the chosen format. <br /><br /> values:<br /> ```landscape // portrait```
3257
+ * Page orientation. Default depends on the chosen format. When it differs from the `render-orientation` of `bn-context`, the page is turned onto the sheet. <br /><br /> values:<br /> ```landscape // portrait```
3231
3258
  */
3232
3259
  "pageOrientation"?: string;
3233
3260
  /**
@@ -3301,13 +3328,13 @@ declare namespace LocalJSX {
3301
3328
  */
3302
3329
  "image"?: string;
3303
3330
  /**
3304
- * Message text. Rendered as HTML, sanitized against XSS (only safe tags such as `br`, `b`, `i`, `strong`, `em`, `a` and their attributes are kept; event handlers and `javascript:` URLs are stripped). <br />Use `<br />` for an explicit line break. <br />If empty string (`''` or `null`) the message row is omitted
3331
+ * Message text. Rendered as HTML, sanitized against XSS (only safe tags such as `br`, `b`, `i`, `strong`, `em`, `a` and their attributes are kept; any other element is removed with its content, and links keep only `http:`, `https:`, `mailto:` and relative URLs). <br />Use `<br />` for an explicit line break. <br />If empty string (`''` or `null`) the message row is omitted
3305
3332
  */
3306
3333
  "text"?: string;
3307
3334
  }
3308
3335
  interface BnPage {
3309
3336
  /**
3310
- * Defines the size of the page <br /><br /> values: <br /> ``` xga // hd // full-hd // 4k // 4k2k // a4 // a3 // a2 // a1 // a0 // letter // legal ``` <br /><br /> default: <br /> ```xga```
3337
+ * Defines the size of the page <br /><br /> values: <br /> ``` xga // hd // full-hd // 4k // 4k2k // a6 // a5 // a4 // a3 // a2 // a1 // a0 // letter // legal // tabloid // ledger ``` <br /><br /> default: <br /> ```xga```
3311
3338
  */
3312
3339
  "format"?: string;
3313
3340
  /**
@@ -3335,7 +3362,7 @@ declare namespace LocalJSX {
3335
3362
  */
3336
3363
  interface BnScalingGroup {
3337
3364
  /**
3338
- * Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes, or in a bubble chart's `size.group`. The name `"auto"` is reserved, and names that parse as a number/SI value (`"100"`, `"1M"`) are rejected — they would be ambiguous with a literal scaling value.
3365
+ * Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes, or in a bubble chart's `size.group`. The name `"auto"` is reserved, and names that parse as a number/SI value (`"100"`, `"1M"`) are rejected - they would be ambiguous with a literal scaling value.
3339
3366
  */
3340
3367
  "name": string;
3341
3368
  /**
@@ -3353,12 +3380,12 @@ declare namespace LocalJSX {
3353
3380
  */
3354
3381
  interface BnTable {
3355
3382
  /**
3356
- * Set the total width of bar chart columns, in em of the table font — the same unit and vocabulary as ```categoryWidth```, so ```bar-column-width="w15"``` renders exactly as wide as ```category-width="w15"```. The bar/pin drawing area is that width minus the value-label gutters. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w30 // w40 // w60 // w80 // w100 ```
3383
+ * Set the total width of bar chart columns, in em of the table font - the same unit and vocabulary as ```categoryWidth```, so ```bar-column-width="w15"``` renders exactly as wide as ```category-width="w15"```. The bar/pin drawing area is that width minus the value-label gutters. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w30 // w40 // w60 // w80 // w100 ```
3357
3384
  * @default "w10"
3358
3385
  */
3359
3386
  "barColumnWidth"?: string;
3360
3387
  /**
3361
- * List of column names to render as bar charts instead of numbers. <br /><br /> Absolute variances (d_*) render as horizontal bar charts. Relative variances (dr_*) render as pin/dot charts. Scenario columns (ac1..pl4) render as horizontal bar charts; when the table contains grouping structure (sum rows, thereof, or partof) they automatically render as an IBCS waterfall — data rows cascade from the running total and sum rows anchor at zero. Waterfall columns auto-scale to fit the bar column width (unit-scaling does not apply) and are not supported in combination with `interval` or `columnthereof`. <br /><br /> example:<br /> ```dac1_pp1_pos,drac1_pp1_pos,ac1```
3388
+ * List of column names to render as bar charts instead of numbers. <br /><br /> Absolute variances (d_*) render as horizontal bar charts. Relative variances (dr_*) render as pin/dot charts. Scenario columns (ac1..pl4) render as horizontal bar charts; when the table contains grouping structure (sum rows, thereof, or partof) they automatically render as an IBCS waterfall - data rows cascade from the running total and sum rows anchor at zero. Waterfall columns auto-scale to fit the bar column width (unit-scaling does not apply) and are not supported in combination with `interval` or `columnthereof`. <br /><br /> example:<br /> ```dac1_pp1_pos,drac1_pp1_pos,ac1```
3362
3389
  */
3363
3390
  "barColumns"?: string;
3364
3391
  /**
@@ -3397,7 +3424,7 @@ declare namespace LocalJSX {
3397
3424
  */
3398
3425
  "grouped"?: string;
3399
3426
  /**
3400
- * Repeats the entire scenario/variance column block once per interval group, rendered under a spanning header band (e.g. `2023 | 2024 | 2025`, each with the configured columns). <br /><br /> values:<br /> ```none // setname // year // quarter // month // week // day // hour // minute // second // millisecond // auto``` <br /><br /> ```none``` (default) deactivates the feature. ```setname``` groups by the dataset's `setname` column (non-date comparison); rows with a blank setname raise a warning and are grouped under `—`. Date values bucket rows by the `date` column; ```auto``` detects the granularity from the date span. Cannot be combined with `columnthereof`.
3427
+ * Repeats the entire scenario/variance column block once per interval group, rendered under a spanning header band (e.g. `2023 | 2024 | 2025`, each with the configured columns). <br /><br /> values:<br /> ```none // setname // year // quarter // month // week // day // hour // minute // second // millisecond // auto``` <br /><br /> ```none``` (default) deactivates the feature. ```setname``` groups by the dataset's `setname` column (non-date comparison); rows with a blank setname raise a warning and are grouped under `-`. Date values bucket rows by the `date` column; ```auto``` detects the granularity from the date span. Cannot be combined with `columnthereof`.
3401
3428
  * @default "none"
3402
3429
  */
3403
3430
  "interval"?: string;
@@ -3437,7 +3464,7 @@ declare namespace LocalJSX {
3437
3464
  */
3438
3465
  "partof"?: string;
3439
3466
  /**
3440
- * Percentage points displayed per 1 em of pin length for relative variance pin charts (ΔPY%) — a larger value means shorter pins. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest pin to the pin area | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_percentageScaling` warning | Default: `"2"` (a +2 % variance pin is 1 em long)
3467
+ * Percentage points displayed per 1 em of pin length for relative variance pin charts (ΔPY%) - a larger value means shorter pins. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest pin to the pin area | | `"10"`, `"2.5"` | Percentage points per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_percentageScaling` warning | Default: `"2"` (a +2 % variance pin is 1 em long)
3441
3468
  * @example percentage-scaling="10"
3442
3469
  * @example percentage-scaling="pct-scale"
3443
3470
  * @default "2"
@@ -3448,8 +3475,8 @@ declare namespace LocalJSX {
3448
3475
  */
3449
3476
  "ruleset"?: string;
3450
3477
  /**
3451
- * Controls proportional scaling of the entire table relative to the available parent width. All visual dimensions scale together: font size, em-based spacing/padding, SVG bar-chart widths, pin lengths, dot radii, pattern fills, axis strokes, and label offsets. Scaling is driven by a single factor applied to the base font size (`global.fontSizePx` from the component-style store, default 13.3333 px). Because the table's SCSS uses `em` units for padding, borders, and column widths, changing the font size cascades to all layout dimensions. SVG elements (bars, pins, patterns) receive the factor via the `scaleFactor` prop on `ibcs-table` and multiply every pixel constant by it, so they stay proportional to the surrounding text. | Value | Behavior | |---------------------|----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor — apply `baseFontSize × factor` | **Auto-scale algorithm** (modes `""` and `"auto"`): 1. After each render, the current `scrollWidth` of the host element is divided by the current `appliedScaleFactor` to derive the unscaled content width. This avoids resetting `--bn-font-size` to base (which would only affect em-based widths but not SVG pixel attributes). 2. This unscaled width is compared against the parent's content-box width (via `getParentDimensions`). 3. If the table overflows, `factor = parentWidth / unscaledWidth` is computed and applied to both the CSS variable and the `appliedScaleFactor` state (which re-renders the SVG charts). 4. A guard flag (`_autoScaleGuard`) prevents the subsequent state-triggered re-render from re-measuring, avoiding an infinite measure → scale → fits → reset → overflow loop. Invalid values (negative numbers, non-numeric strings that are not `"none"` or `"auto"`) fall back to the default behaviour (auto + warning) and emit an `ERR_scale` warning. **Only the width is fitted.** A table that renders taller than its constrained parent is clipped by the layout cell — bottom rows and the grand total simply disappear — so every render reports the measured overflow as a `WARN_overflow` item in `has-error`: an `error` when the size is pinned by `scale` (`"none"` or a factor), a `warning` in auto mode. The same item reports a width overflow, which only a fixed `scale` can produce. Setting `scale="auto"` does not fix a height overflow: give the component more space, reduce rows (`limit`), or set a smaller fixed `scale`.
3452
- * @example // Auto-scale to parent (silent) <bn-table scale="auto" ...></bn-table> // Fixed 50 % reduction <bn-table scale="0.5" ...></bn-table> // Double size <bn-table scale="2" ...></bn-table> // No scaling — always render at base font size <bn-table scale="none" ...></bn-table>
3478
+ * Controls proportional scaling of the entire table relative to the available parent width. All visual dimensions scale together: font size, em-based spacing/padding, SVG bar-chart widths, pin lengths, dot radii, pattern fills, axis strokes, and label offsets. Scaling is driven by a single factor applied to the base font size (`global.fontSizePx` from the component-style store, default 13.3333 px). Because the table's SCSS uses `em` units for padding, borders, and column widths, changing the font size cascades to all layout dimensions. SVG elements (bars, pins, patterns) receive the factor via the `scaleFactor` prop on `ibcs-table` and multiply every pixel constant by it, so they stay proportional to the surrounding text. | Value | Behavior | |---------------------|----------------------------------------------------------------------------------| | not set / `""` | Auto-scale to fit parent width; emit `AUTO_scale` warning with the applied factor | | `"none"` | No scaling (render at base font size regardless of available space) | | `"auto"` | Auto-scale to fit parent width silently (no warning) | | `"0.5"`, `"1.2"`, … | Fixed factor - apply `baseFontSize × factor` | **Auto-scale algorithm** (modes `""` and `"auto"`): 1. After each render, the current `scrollWidth` of the host element is divided by the current `appliedScaleFactor` to derive the unscaled content width. This avoids resetting `--bn-font-size` to base (which would only affect em-based widths but not SVG pixel attributes). 2. This unscaled width is compared against the parent's content-box width (via `getParentDimensions`). 3. If the table overflows, `factor = parentWidth / unscaledWidth` is computed and applied to both the CSS variable and the `appliedScaleFactor` state (which re-renders the SVG charts). 4. A guard flag (`_autoScaleGuard`) prevents the subsequent state-triggered re-render from re-measuring, avoiding an infinite measure → scale → fits → reset → overflow loop. Invalid values (negative numbers, non-numeric strings that are not `"none"` or `"auto"`) fall back to the default behaviour (auto + warning) and emit an `ERR_scale` warning. **Only the width is fitted.** A table that renders taller than its constrained parent is clipped by the layout cell - bottom rows and the grand total simply disappear - so every render reports the measured overflow as a `WARN_overflow` item in `has-error`: an `error` when the size is pinned by `scale` (`"none"` or a factor), a `warning` in auto mode. The same item reports a width overflow, which only a fixed `scale` can produce. Setting `scale="auto"` does not fix a height overflow: give the component more space, reduce rows (`limit`), or set a smaller fixed `scale`.
3479
+ * @example // Auto-scale to parent (silent) <bn-table scale="auto" ...></bn-table> // Fixed 50 % reduction <bn-table scale="0.5" ...></bn-table> // Double size <bn-table scale="2" ...></bn-table> // No scaling - always render at base font size <bn-table scale="none" ...></bn-table>
3453
3480
  */
3454
3481
  "scale"?: string;
3455
3482
  /**
@@ -3491,7 +3518,7 @@ declare namespace LocalJSX {
3491
3518
  */
3492
3519
  "type"?: string;
3493
3520
  /**
3494
- * Data units displayed per 1 em of bar length for absolute variance bar charts (ΔPY) — map-scale semantics: a larger value means smaller bars. Bars exceeding barColumnWidth are shown with an arrow indicator. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest bar to the bar column width | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_unitScaling` warning | Default: `"100"` (1 em of bar represents 100 units)
3521
+ * Data units displayed per 1 em of bar length for absolute variance bar charts (ΔPY) - map-scale semantics: a larger value means smaller bars. Bars exceeding barColumnWidth are shown with an arrow indicator. | Value | Behavior | |------------------|----------------------------------------------------------------| | `"auto"` | Auto-fit the largest bar to the bar column width | | `"250000"`, `"1M"` | Units per em; optional SI suffix `k`/`K`/`M`/`G`/`T` | | group name | References a `<bn-scaling-group>` for synchronized scaling | | invalid / unknown | Auto-fit + `AUTO_unitScaling` warning | Default: `"100"` (1 em of bar represents 100 units)
3495
3522
  * @example unit-scaling="1M"
3496
3523
  * @example unit-scaling="revenue-scale"
3497
3524
  * @default "100"
@@ -3509,19 +3536,20 @@ declare namespace LocalJSX {
3509
3536
  "templateId"?: string;
3510
3537
  }
3511
3538
  /**
3512
- * Renders a template-driven text block with dataset interpolation.
3513
- * The `value` prop is evaluated as a JavaScript template literal in a
3514
- * sandboxed scope (`data` and `t` are available) and sanitized against
3515
- * XSS before being injected as HTML. Supports auto-scaling to fit the
3516
- * parent container.
3539
+ * Renders a text block from a template with dataset and translation
3540
+ * placeholders.
3541
+ * The `value` prop is markup with `${...}` placeholders. Placeholders are
3542
+ * looked up, never evaluated. Resolved values are HTML-escaped and the
3543
+ * result is sanitized before it is inserted. Supports auto-scaling to fit
3544
+ * the parent container.
3517
3545
  */
3518
3546
  interface BnText {
3519
3547
  /**
3520
- * Controls font-size scaling relative to the available parent space. Scaling considers both width and height — the tighter constraint wins. | Value | Behavior | |----------------|----------------------------------------------------------------| | not set / `""` | Auto-scale to fit, emit `AUTO_scale` warning with applied factor | | `"none"` | No scaling; emit `WARN_overflow` warning if content overflows | | `"auto"` | Auto-scale to fit, silent (no warning) | | `"0.5"`, `"1.2"`, … | Apply `baseFontSize × factor`; emit `WARN_overflow` if still overflows | Invalid values (negative, non-numeric, non-keyword) fall back to the default (auto + warning) and emit an `ERR_scale` warning.
3548
+ * Controls font-size scaling relative to the available parent space. Scaling considers both width and height - the tighter constraint wins. | Value | Behavior | |----------------|----------------------------------------------------------------| | not set / `""` | Auto-scale to fit, emit `AUTO_scale` warning with applied factor | | `"none"` | No scaling; emit `WARN_overflow` warning if content overflows | | `"auto"` | Auto-scale to fit, silent (no warning) | | `"0.5"`, `"1.2"`, … | Apply `baseFontSize × factor`; emit `WARN_overflow` if still overflows | Invalid values (negative, non-numeric, non-keyword) fall back to the default (auto + warning) and emit an `ERR_scale` warning.
3521
3549
  */
3522
3550
  "scale"?: string;
3523
3551
  /**
3524
- * Template string rendered as HTML. Supports JavaScript template literal syntax — use `${data.<dataset>}` to interpolate dataset values and `${t('<key>')}` for translated strings. The template is evaluated in a sandboxed scope (only `data` and `t` are accessible; globals like `window`/`document` are blocked) and the output is sanitized against XSS (only safe HTML tags and attributes are kept).
3552
+ * Template string rendered as HTML. These placeholders are replaced: `${data.<dataset>[<row>].<field>}`, `${data['<name>'][<row>].<field>}` (for names such as the datasource reference `$revenue`), `${t('<key>')}` and `${t('<key>', { <name>: <text, number or data path> })}`. Any other text, including any other `${...}`, is printed as written. Nothing is evaluated. Resolved values are HTML-escaped, so dataset values and translations are shown as text. Markup written in the template is kept if it is on the allowlist; other elements are removed with their content. A placeholder that does not resolve renders empty and adds a `WARN_value_path` warning.
3525
3553
  * @example // plain text value="Hello World" // with dataset interpolation value="Revenue: ${data.kpi[0].ac1}" // with translation value="${t('report.title')}" // with HTML formatting value="<b>Total</b>: ${data.kpi[0].ac1}<br>as of today"
3526
3554
  */
3527
3555
  "value"?: string;
@@ -3662,7 +3690,7 @@ declare namespace LocalJSX {
3662
3690
  */
3663
3691
  "dataVersion"?: number;
3664
3692
  /**
3665
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
3693
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
3666
3694
  */
3667
3695
  "errors"?: ErrorDispatcher;
3668
3696
  /**
@@ -3736,7 +3764,7 @@ declare namespace LocalJSX {
3736
3764
  */
3737
3765
  "dataVersion"?: number;
3738
3766
  /**
3739
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
3767
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
3740
3768
  */
3741
3769
  "errors"?: ErrorDispatcher;
3742
3770
  /**
@@ -3810,7 +3838,7 @@ declare namespace LocalJSX {
3810
3838
  */
3811
3839
  "dataVersion"?: number;
3812
3840
  /**
3813
- * The facade's error dispatcher — data warnings are synced through it (stable ids).
3841
+ * The facade's error dispatcher - data warnings are synced through it (stable ids).
3814
3842
  */
3815
3843
  "errors"?: ErrorDispatcher;
3816
3844
  /**
@@ -3871,6 +3899,10 @@ declare namespace LocalJSX {
3871
3899
  * @default 0
3872
3900
  */
3873
3901
  "dataVersion"?: number;
3902
+ /**
3903
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
3904
+ */
3905
+ "errors"?: ErrorDispatcher;
3874
3906
  /**
3875
3907
  * @default ""
3876
3908
  */
@@ -3970,6 +4002,10 @@ declare namespace LocalJSX {
3970
4002
  * @default DateDistance.AUTO
3971
4003
  */
3972
4004
  "dateInterval"?: DateDistance;
4005
+ /**
4006
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
4007
+ */
4008
+ "errors"?: ErrorDispatcher;
3973
4009
  /**
3974
4010
  * @default ""
3975
4011
  */
@@ -4069,7 +4105,7 @@ declare namespace LocalJSX {
4069
4105
  /**
4070
4106
  * Internal rendering engine for `bn-table`.
4071
4107
  * Receives pre-validated, typed props from the outer `bn-table` wrapper and
4072
- * builds the IBCS-compliant HTML table — including header rows, scenario
4108
+ * builds the IBCS-compliant HTML table - including header rows, scenario
4073
4109
  * columns, variance columns (with optional inline bar/pin charts), thereof/
4074
4110
  * partof drill-down rows, and grouped row sections. This component should
4075
4111
  * not be used directly; use `bn-table` instead.
@@ -4080,7 +4116,7 @@ declare namespace LocalJSX {
4080
4116
  */
4081
4117
  "attributeColumns"?: TableAttribute[];
4082
4118
  /**
4083
- * Total width of a bar chart column, in em of the table font — the same unit `categoryWidth` uses, so the two render at the same width for the same value.
4119
+ * Total width of a bar chart column, in em of the table font - the same unit `categoryWidth` uses, so the two render at the same width for the same value.
4084
4120
  * @default 30
4085
4121
  */
4086
4122
  "barColumnMaxWidth"?: number;
@@ -4105,6 +4141,10 @@ declare namespace LocalJSX {
4105
4141
  * @default 0
4106
4142
  */
4107
4143
  "dataVersion"?: number;
4144
+ /**
4145
+ * The wrapper's error dispatcher: a failed query is reported through it as `ERR_sql`. Not for end users.
4146
+ */
4147
+ "errors"?: ErrorDispatcher;
4108
4148
  /**
4109
4149
  * @default ""
4110
4150
  */
@@ -4188,7 +4228,7 @@ declare namespace LocalJSX {
4188
4228
  */
4189
4229
  "sumTitle"?: string;
4190
4230
  /**
4191
- * Name of the dataset (a table or view in the shared alasql database). The inner `Table` helper queries it directly — no array copy.
4231
+ * Name of the dataset (a table or view in the shared alasql database). The inner `Table` helper queries it directly - no array copy.
4192
4232
  * @default ""
4193
4233
  */
4194
4234
  "tableName"?: string;
@@ -4356,14 +4396,16 @@ declare namespace LocalJSX {
4356
4396
  "static": boolean;
4357
4397
  "raw": boolean;
4358
4398
  "interval": number;
4399
+ "src": string;
4359
4400
  }
4360
4401
  interface BnDatasourceAttributes {
4361
4402
  "name": string;
4362
4403
  "raw": boolean;
4363
4404
  "interval": number;
4405
+ "src": string;
4364
4406
  }
4365
4407
  interface BnFooterAttributes {
4366
- "pageNumber": number | null;
4408
+ "pageNumber": string | null;
4367
4409
  "text": string;
4368
4410
  "code": string;
4369
4411
  "displayPageNumber": boolean;
@@ -4697,9 +4739,9 @@ declare module "@stencil/core" {
4697
4739
  * IBCS bullet graph: one horizontal row per KPI with a solid actual bar and
4698
4740
  * a target marker.
4699
4741
  * Subscribes to a dataset (via `withDataset`) and renders in the IBCS
4700
- * default mode with **normalized targets** — every row is scaled to
4742
+ * default mode with **normalized targets** - every row is scaled to
4701
4743
  * fractions of its target so one continuous target line spans all rows and
4702
- * KPIs become visually comparable — plus integrated variance bars in the
4744
+ * KPIs become visually comparable - plus integrated variance bars in the
4703
4745
  * IBCS variance colors. The classic Stephen Few look is opt-in via
4704
4746
  * `normalize="none"` (per-row scales) and `ranges` (max two qualitative
4705
4747
  * gray bands). Actual and target scenarios are auto-detected from the
@@ -4742,25 +4784,24 @@ declare module "@stencil/core" {
4742
4784
  /**
4743
4785
  * Queries data from one or more `bn-datasource` entries via AlaSQL and
4744
4786
  * writes the result to the `datasets` store (+ computed `DatasetMeta`).
4745
- * The body content is observed via `withBodyObserver` and may be:
4746
- * 1. **SQL** (default) — AlaSQL query against referenced `datasources`.
4747
- * 2. **Static JSON** — set `static="true"` to bypass SQL and write the
4787
+ * The body content is observed via `withBodyObserver` and is always inline:
4788
+ * 1. **SQL** (default) - AlaSQL query against referenced `datasources`.
4789
+ * 2. **Static JSON** - set `static="true"` to bypass SQL and write the
4748
4790
  * parsed body directly to the `datasets` store.
4749
- * 3. **URL** — place an `http://`/`https://` URL or a same-origin path
4750
- * starting with `/` in the body to fetch JSON from an HTTP endpoint and
4751
- * write it to the `datasets` store. Set the `interval` prop (in seconds)
4752
- * to enable periodic re-fetching.
4791
+ * Set the `src` attribute to fetch JSON from an HTTP endpoint instead and
4792
+ * write it to the `datasets` store. Set the `interval` prop (in seconds)
4793
+ * to enable periodic re-fetching.
4753
4794
  */
4754
4795
  "bn-dataset": LocalJSX.IntrinsicElements["bn-dataset"] & JSXBase.HTMLAttributes<HTMLBnDatasetElement>;
4755
4796
  /**
4756
4797
  * Ingests data and writes it to the scoped `datasources` store.
4757
4798
  * Data can be provided in three ways:
4758
- * 1. **Inline JSON** — Place JSON text inside the element body (default).
4759
- * 2. **Compressed payload** — Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
4760
- * 3. **URL** — Place an `http://`/`https://` URL or a same-origin path
4761
- * starting with `/` in the body to fetch JSON from an HTTP endpoint.
4762
- * In URL mode the component fetches JSON from the URL. Set the `interval`
4763
- * prop (in seconds) to enable periodic re-fetching (polling).
4799
+ * 1. **Inline JSON** - Place JSON text inside the element body (default).
4800
+ * 2. **Compressed payload** - Set `raw="false"` and provide `<hash>:<base64_gzip>` format.
4801
+ * 3. **URL** - Set the `src` attribute to fetch JSON from an HTTP endpoint.
4802
+ * Set the `interval` prop (in seconds) to enable periodic re-fetching
4803
+ * (polling).
4804
+ * The body is always inline data and is ignored while `src` is set.
4764
4805
  * Other components (e.g. `bn-dataset`) reference the stored data by the
4765
4806
  * `name` prop to run queries against it.
4766
4807
  */
@@ -4803,11 +4844,12 @@ declare module "@stencil/core" {
4803
4844
  "bn-table": LocalJSX.IntrinsicElements["bn-table"] & JSXBase.HTMLAttributes<HTMLBnTableElement>;
4804
4845
  "bn-template": LocalJSX.IntrinsicElements["bn-template"] & JSXBase.HTMLAttributes<HTMLBnTemplateElement>;
4805
4846
  /**
4806
- * Renders a template-driven text block with dataset interpolation.
4807
- * The `value` prop is evaluated as a JavaScript template literal in a
4808
- * sandboxed scope (`data` and `t` are available) and sanitized against
4809
- * XSS before being injected as HTML. Supports auto-scaling to fit the
4810
- * parent container.
4847
+ * Renders a text block from a template with dataset and translation
4848
+ * placeholders.
4849
+ * The `value` prop is markup with `${...}` placeholders. Placeholders are
4850
+ * looked up, never evaluated. Resolved values are HTML-escaped and the
4851
+ * result is sanitized before it is inserted. Supports auto-scaling to fit
4852
+ * the parent container.
4811
4853
  */
4812
4854
  "bn-text": LocalJSX.IntrinsicElements["bn-text"] & JSXBase.HTMLAttributes<HTMLBnTextElement>;
4813
4855
  /**
@@ -4854,7 +4896,7 @@ declare module "@stencil/core" {
4854
4896
  /**
4855
4897
  * Internal rendering engine for `bn-table`.
4856
4898
  * Receives pre-validated, typed props from the outer `bn-table` wrapper and
4857
- * builds the IBCS-compliant HTML table — including header rows, scenario
4899
+ * builds the IBCS-compliant HTML table - including header rows, scenario
4858
4900
  * columns, variance columns (with optional inline bar/pin charts), thereof/
4859
4901
  * partof drill-down rows, and grouped row sections. This component should
4860
4902
  * not be used directly; use `bn-table` instead.