@bino-bi/bn-template-engine 1.0.0-next.21 → 1.0.0-next.23
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.
- package/dist/bn-template-engine/bn-template-engine.esm.js +1 -1
- package/dist/bn-template-engine/{p-28d5c266.entry.js → p-0a49cf00.entry.js} +1 -1
- package/dist/bn-template-engine/{p-b9e94127.entry.js → p-22b8d044.entry.js} +1 -1
- package/dist/bn-template-engine/{p-6c7f0076.entry.js → p-251bb53d.entry.js} +1 -1
- package/dist/bn-template-engine/p-2aed639e.entry.js +1 -0
- package/dist/bn-template-engine/{p-7e9dbc93.entry.js → p-4616b879.entry.js} +1 -1
- package/dist/bn-template-engine/{p-99477a27.entry.js → p-629edcca.entry.js} +1 -1
- package/dist/bn-template-engine/p-686d8e44.entry.js +1 -0
- package/dist/bn-template-engine/{p-a4ea9a79.entry.js → p-68aa61cc.entry.js} +1 -1
- package/dist/bn-template-engine/{p-DwYUTvvI.js → p-B5x8M8OC.js} +1 -1
- package/dist/bn-template-engine/{p-fFtEvsY-.js → p-BGrnfif3.js} +1 -1
- package/dist/bn-template-engine/{p-6lOdN-fB.js → p-BVfLus3u.js} +1 -1
- package/dist/bn-template-engine/{p-CJThzFZm.js → p-BcZ5GQZ8.js} +1 -1
- package/dist/bn-template-engine/{p-CYE0I1Mx.js → p-Bca5V28_.js} +1 -1
- package/dist/bn-template-engine/p-C5UYpZUU.js +2 -0
- package/dist/bn-template-engine/{p-BgIpdpfH.js → p-C7T4DAAW.js} +1 -1
- package/dist/bn-template-engine/p-CDo04UEU.js +1 -0
- package/dist/bn-template-engine/p-CTrNbSXN.js +1 -0
- package/dist/bn-template-engine/{p-C5uvAEKI.js → p-CbciPY-M.js} +1 -1
- package/dist/bn-template-engine/{p-BpWWgN6k.js → p-CuR4S456.js} +1 -1
- package/dist/bn-template-engine/p-DWtTjg0f.js +1 -0
- package/dist/bn-template-engine/{p-eEfqksk-.js → p-DdqXNsKP.js} +1 -1
- package/dist/bn-template-engine/{p-B4JfKvVT.js → p-DtLI_CzV.js} +1 -1
- package/dist/bn-template-engine/p-UtNHLX1j.js +1 -0
- package/dist/bn-template-engine/{p-ba912130.entry.js → p-aecb5de3.entry.js} +1 -1
- package/dist/bn-template-engine/{p-687032d5.entry.js → p-ba43d46e.entry.js} +1 -1
- package/dist/bn-template-engine/{p-6077155f.entry.js → p-c476e7bb.entry.js} +1 -1
- package/dist/bn-template-engine/{p-2d3ea756.entry.js → p-d7c670ec.entry.js} +1 -1
- package/dist/bn-template-engine/{p-a1380d7c.entry.js → p-e4a584a8.entry.js} +1 -1
- package/dist/bn-template-engine/{p-de29986f.entry.js → p-f12fb09b.entry.js} +1 -1
- package/dist/bn-template-engine/p-f9a721bb.entry.js +1 -0
- package/dist/cjs/{AxisConfig-D7CAyPLO.js → AxisConfig-DmP4U3JM.js} +1 -1
- package/dist/cjs/{LabelCollisionManager-DkdQ9Xdg.js → LabelCollisionManager-Cet3WPm0.js} +2 -2
- package/dist/cjs/{Order-IPfAP0q8.js → Order-DlKLywO_.js} +1 -1
- package/dist/cjs/{SVGStyle-BD8jApd4.js → SVGStyle-D78RaNnj.js} +2 -2
- package/dist/cjs/{SVGVariancesStyleGroup-BaWzR951.js → SVGVariancesStyleGroup-XvNAnYYA.js} +1 -1
- package/dist/cjs/{VarianceMeasure-BBWTgv2e.js → VarianceMeasure-BfZLlICl.js} +4 -4
- package/dist/cjs/{XYChartDataRow-BoR0CTfl.js → XYChartDataRow-B0NNOqxB.js} +4 -4
- package/dist/cjs/bn-asset_21.cjs.entry.js +1052 -314
- package/dist/cjs/bn-chart-bubble.cjs.entry.js +25 -15
- package/dist/cjs/bn-chart-bullet.cjs.entry.js +9 -9
- package/dist/cjs/bn-chart-scatter.cjs.entry.js +9 -9
- package/dist/cjs/bn-grid.cjs.entry.js +6 -6
- package/dist/cjs/bn-image.cjs.entry.js +6 -6
- package/dist/cjs/bn-internationalization.cjs.entry.js +4 -4
- package/dist/cjs/bn-ruleset.cjs.entry.js +4 -4
- package/dist/cjs/bn-template-engine.cjs.js +3 -3
- package/dist/cjs/bn-template.cjs.entry.js +2 -2
- package/dist/cjs/bn-text.cjs.entry.js +7 -7
- package/dist/cjs/bn-tree.cjs.entry.js +6 -6
- package/dist/cjs/{context-protocol-BBhT9B52.js → context-protocol-DeLmu5s2.js} +1 -1
- package/dist/cjs/editor-companion.cjs.entry.js +2 -2
- package/dist/cjs/ibcs-chart-bubble.cjs.entry.js +6 -6
- package/dist/cjs/ibcs-chart-bullet.cjs.entry.js +6 -6
- package/dist/cjs/ibcs-chart-scatter.cjs.entry.js +6 -6
- package/dist/cjs/{index-CDKG4xmO.js → index-C1Z9vO7z.js} +61 -19
- package/dist/cjs/{layoutObserver-DUYYkDMQ.js → layoutObserver-CrzQQGpv.js} +5 -5
- package/dist/cjs/loader.cjs.js +2 -2
- package/dist/cjs/{scaling-BIJQ2NV1.js → scaling-JAU6IJnR.js} +85 -3
- package/dist/cjs/{withBodyObserver-BKUE_ypL.js → withBodyObserver-DJO98AJ-.js} +2 -2
- package/dist/cjs/{withHasError-Cl2gTQzA.js → withHasError-BdDmiOXM.js} +1 -1
- package/dist/cjs/{withScalingGroup-D5clRvRe.js → withScalingGroup-Bu5gatHT.js} +3 -3
- package/dist/cjs/{withStyled-Cm9dWQhu.js → withStyled-50UepUwV.js} +8 -8
- package/dist/collection/collection-manifest.json +1 -1
- package/dist/collection/components/bn-chart-bubble/bn-chart-bubble.js +15 -5
- package/dist/collection/components/bn-chart-structure/bn-chart-structure.css +6 -0
- package/dist/collection/components/bn-chart-structure/bn-chart-structure.js +149 -57
- package/dist/collection/components/bn-chart-structure/ibcs-chart-structure.js +135 -28
- package/dist/collection/components/bn-chart-structure/utils/StructureChart.js +30 -19
- package/dist/collection/components/bn-chart-time/bn-chart-time.js +186 -49
- package/dist/collection/components/bn-chart-time/ibcs-chart-time.css +9 -3
- package/dist/collection/components/bn-chart-time/ibcs-chart-time.js +141 -22
- package/dist/collection/components/bn-chart-time/utils/TimeChart.js +36 -0
- package/dist/collection/components/bn-scaling-group/bn-scaling-group.js +76 -19
- package/dist/collection/components/bn-table/bn-table.js +121 -49
- package/dist/collection/components/bn-table/ibcs-table.js +83 -42
- package/dist/collection/components/bn-table/utils/elements/CellBarChart.js +20 -34
- package/dist/collection/components/bn-table/utils/elements/WaterfallBar.js +4 -5
- package/dist/collection/components/bn-table/utils/helper/barColumnGeometry.js +89 -0
- package/dist/collection/utils/autoFit.js +63 -0
- package/dist/collection/utils/constants.js +3 -3
- package/dist/collection/utils/dataAnalyzer.js +17 -8
- package/dist/collection/utils/scaling.js +79 -0
- package/dist/collection/utils/validate.js +3 -3
- package/dist/components/DataFormatDigits.js +1 -1
- package/dist/components/autoFit.js +1 -0
- package/dist/components/bn-chart-bubble.js +1 -1
- package/dist/components/bn-chart-bullet.js +1 -1
- package/dist/components/bn-chart-scatter.js +1 -1
- package/dist/components/bn-chart-structure.js +1 -1
- package/dist/components/bn-chart-time.js +1 -1
- package/dist/components/bn-grid.js +1 -1
- package/dist/components/bn-scaling-group.js +1 -1
- package/dist/components/bn-table.js +1 -1
- package/dist/components/bn-text.js +1 -1
- package/dist/components/bn-tree.js +1 -1
- package/dist/components/ibcs-chart-structure2.js +1 -1
- package/dist/components/ibcs-chart-time2.js +1 -1
- package/dist/components/ibcs-table2.js +1 -1
- package/dist/components/scaling.js +1 -0
- package/dist/components/validate.js +1 -1
- package/dist/components/withDataset.js +1 -1
- package/dist/components/withStyled.js +1 -1
- package/dist/esm/{AxisConfig-ByIP5J-9.js → AxisConfig-Cjy_RANi.js} +1 -1
- package/dist/esm/{LabelCollisionManager-DaNiDiM9.js → LabelCollisionManager-B_NUM9yq.js} +2 -2
- package/dist/esm/{Order-BQeJE_yi.js → Order-B-aF6Rwn.js} +1 -1
- package/dist/esm/{SVGStyle-BwBlY3Km.js → SVGStyle-8FfAtUF-.js} +2 -2
- package/dist/esm/{SVGVariancesStyleGroup-BpGW4CvN.js → SVGVariancesStyleGroup-DD4mIOjT.js} +1 -1
- package/dist/esm/{VarianceMeasure-CE3N8Bea.js → VarianceMeasure-DLOuIIJ7.js} +4 -4
- package/dist/esm/{XYChartDataRow-DeMI1JKU.js → XYChartDataRow-CKfILBFG.js} +4 -4
- package/dist/esm/bn-asset_21.entry.js +1052 -314
- package/dist/esm/bn-chart-bubble.entry.js +25 -15
- package/dist/esm/bn-chart-bullet.entry.js +9 -9
- package/dist/esm/bn-chart-scatter.entry.js +9 -9
- package/dist/esm/bn-grid.entry.js +6 -6
- package/dist/esm/bn-image.entry.js +6 -6
- package/dist/esm/bn-internationalization.entry.js +4 -4
- package/dist/esm/bn-ruleset.entry.js +4 -4
- package/dist/esm/bn-template-engine.js +4 -4
- package/dist/esm/bn-template.entry.js +2 -2
- package/dist/esm/bn-text.entry.js +7 -7
- package/dist/esm/bn-tree.entry.js +6 -6
- package/dist/esm/{context-protocol-d8MHrEo8.js → context-protocol-BoEL0caI.js} +1 -1
- package/dist/esm/editor-companion.entry.js +2 -2
- package/dist/esm/ibcs-chart-bubble.entry.js +6 -6
- package/dist/esm/ibcs-chart-bullet.entry.js +6 -6
- package/dist/esm/ibcs-chart-scatter.entry.js +6 -6
- package/dist/esm/{index-B_d-jp99.js → index-C5UYpZUU.js} +61 -19
- package/dist/esm/{layoutObserver-BJBEyhNf.js → layoutObserver-cgIXg2sg.js} +5 -5
- package/dist/esm/loader.js +3 -3
- package/dist/esm/{scaling-BGnpSN1j.js → scaling-CxyNpMQM.js} +83 -4
- package/dist/esm/{withBodyObserver-IokS6fHD.js → withBodyObserver-Cb9ZC5_J.js} +2 -2
- package/dist/esm/{withHasError-DW_vMDUp.js → withHasError-Bh1Viz52.js} +1 -1
- package/dist/esm/{withScalingGroup-CC3UcvC5.js → withScalingGroup-Yv9nGGe1.js} +3 -3
- package/dist/esm/{withStyled-2l5Tx3cf.js → withStyled-By9Jd-Oy.js} +8 -8
- package/dist/types/components/bn-chart-bubble/bn-chart-bubble.d.ts +5 -2
- package/dist/types/components/bn-chart-structure/bn-chart-structure.d.ts +47 -19
- package/dist/types/components/bn-chart-structure/ibcs-chart-structure.d.ts +17 -3
- package/dist/types/components/bn-chart-structure/utils/StructureChart.d.ts +11 -3
- package/dist/types/components/bn-chart-time/bn-chart-time.d.ts +52 -18
- package/dist/types/components/bn-chart-time/ibcs-chart-time.d.ts +18 -3
- package/dist/types/components/bn-chart-time/utils/TimeChart.d.ts +12 -0
- package/dist/types/components/bn-scaling-group/bn-scaling-group.d.ts +28 -8
- package/dist/types/components/bn-table/bn-table.d.ts +45 -19
- package/dist/types/components/bn-table/ibcs-table.d.ts +23 -6
- package/dist/types/components/bn-table/utils/elements/CellBarChart.d.ts +9 -1
- package/dist/types/components/bn-table/utils/helper/barColumnGeometry.d.ts +51 -0
- package/dist/types/components.d.ts +91 -55
- package/dist/types/stencil-public-runtime.d.ts +1 -0
- package/dist/types/utils/autoFit.d.ts +79 -0
- package/dist/types/utils/constants.d.ts +3 -3
- package/dist/types/utils/dataAnalyzer.d.ts +5 -1
- package/dist/types/utils/scaling.d.ts +63 -0
- package/dist/types/utils/validate.d.ts +2 -2
- package/package.json +1 -1
- package/readme.md +2 -0
- package/dist/bn-template-engine/p-2fba7c99.entry.js +0 -1
- package/dist/bn-template-engine/p-A8xyE4b1.js +0 -1
- package/dist/bn-template-engine/p-B_d-jp99.js +0 -2
- package/dist/bn-template-engine/p-BjBz5cSL.js +0 -1
- package/dist/bn-template-engine/p-C8Q0lsaU.js +0 -1
- package/dist/bn-template-engine/p-C9i1Xsib.js +0 -1
- package/dist/bn-template-engine/p-a8291de2.entry.js +0 -1
- package/dist/bn-template-engine/p-b5274369.entry.js +0 -1
|
@@ -16,6 +16,7 @@ import { BulletLabelConfig, BulletMeasureConfig } from "./components/bn-chart-bu
|
|
|
16
16
|
import { AggregationLevel, AxisLabelsMode, ChartMode, DataFormat, I18nMode, MeasureType, TableCategoryWidth } from "./utils/constants";
|
|
17
17
|
import { Order } from "./utils/model/Order";
|
|
18
18
|
import { BulletChartStyle } from "./components/bn-chart-bullet/utils/model/BulletChartStyle";
|
|
19
|
+
import { AutoScalingReport } from "./utils/scaling";
|
|
19
20
|
import { StructureChartStyle } from "./components/bn-chart-structure/utils/model/styles/StructureChartStyle";
|
|
20
21
|
import { DataFormatDigits } from "./utils/model/DataFormatDigits";
|
|
21
22
|
import { StackConfigParsed } from "./components/bn-chart-structure/utils/model/StructureChartComponentConfig";
|
|
@@ -39,6 +40,7 @@ export { BulletLabelConfig, BulletMeasureConfig } from "./components/bn-chart-bu
|
|
|
39
40
|
export { AggregationLevel, AxisLabelsMode, ChartMode, DataFormat, I18nMode, MeasureType, TableCategoryWidth } from "./utils/constants";
|
|
40
41
|
export { Order } from "./utils/model/Order";
|
|
41
42
|
export { BulletChartStyle } from "./components/bn-chart-bullet/utils/model/BulletChartStyle";
|
|
43
|
+
export { AutoScalingReport } from "./utils/scaling";
|
|
42
44
|
export { StructureChartStyle } from "./components/bn-chart-structure/utils/model/styles/StructureChartStyle";
|
|
43
45
|
export { DataFormatDigits } from "./utils/model/DataFormatDigits";
|
|
44
46
|
export { StackConfigParsed } from "./components/bn-chart-structure/utils/model/StructureChartComponentConfig";
|
|
@@ -366,8 +368,8 @@ export namespace Components {
|
|
|
366
368
|
*/
|
|
367
369
|
"orderDirection": string;
|
|
368
370
|
/**
|
|
369
|
-
*
|
|
370
|
-
* @example percentage-scaling="
|
|
371
|
+
* 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 |
|
|
372
|
+
* @example percentage-scaling="10"
|
|
371
373
|
* @example percentage-scaling="pct-scale"
|
|
372
374
|
*/
|
|
373
375
|
"percentageScaling": string | number;
|
|
@@ -404,9 +406,9 @@ export namespace Components {
|
|
|
404
406
|
*/
|
|
405
407
|
"stack": string;
|
|
406
408
|
/**
|
|
407
|
-
*
|
|
409
|
+
* 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.
|
|
408
410
|
* @example unit-scaling="auto"
|
|
409
|
-
* @example unit-scaling="
|
|
411
|
+
* @example unit-scaling="1M"
|
|
410
412
|
* @example unit-scaling="revenue-scale"
|
|
411
413
|
*/
|
|
412
414
|
"unitScaling": string | number;
|
|
@@ -475,7 +477,7 @@ export namespace Components {
|
|
|
475
477
|
*/
|
|
476
478
|
"maxBars": number;
|
|
477
479
|
/**
|
|
478
|
-
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // μ // n // p //
|
|
480
|
+
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // my (μ) // n // p // f // a // z // y // GREATEST // LEAST``` <br /><br /> SiPrefix overview: ``` "Y": 1E+24,```<br /> ``` "Z": 1E+21,```<br /> ``` "E": 1E+18,```<br /> ``` "P": 1E+15,```<br /> ``` "T": 1E+12,```<br /> ``` "G": 1000000000,```<br /> ``` "M": 1000000,```<br /> ``` "k": 1000,```<br /> <br /> ``` "m": 0.001,```<br /> ``` "my" (μ): 0.000001,```<br /> ``` "n": 0.000000001,```<br /> ``` "p": 0.000000000001,```<br /> ``` "f": 0.000000000000001,```<br /> ``` "a": 0.000000000000000001,```<br /> ``` "z": 0.000000000000000000001,```<br /> ``` "y": 0.000000000000000000000001,```<br /> <br /><br /> Special modes: ```GREATEST``` seaches for the bigest (farest to zero) Value in the dataset and sets this value to SiPrefix<br /> ```LEAST``` searches for smallest (closest to zero) Value in the dataset and sets this value to SiPrefix<br /> <br /><br /> ```_``` is the value for no SiPrefix the value is displayed as in the dataset stored.
|
|
479
481
|
* @default "greatest"
|
|
480
482
|
*/
|
|
481
483
|
"measureScale": string;
|
|
@@ -493,8 +495,8 @@ export namespace Components {
|
|
|
493
495
|
*/
|
|
494
496
|
"orderDirection": string;
|
|
495
497
|
/**
|
|
496
|
-
*
|
|
497
|
-
* @example percentage-scaling="
|
|
498
|
+
* 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 |
|
|
499
|
+
* @example percentage-scaling="10"
|
|
498
500
|
* @example percentage-scaling="pct-scale"
|
|
499
501
|
*/
|
|
500
502
|
"percentageScaling": string | number;
|
|
@@ -539,9 +541,9 @@ export namespace Components {
|
|
|
539
541
|
*/
|
|
540
542
|
"syncSpaceLeft": number;
|
|
541
543
|
/**
|
|
542
|
-
*
|
|
544
|
+
* 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 |
|
|
543
545
|
* @example unit-scaling="auto"
|
|
544
|
-
* @example unit-scaling="
|
|
546
|
+
* @example unit-scaling="1M"
|
|
545
547
|
* @example unit-scaling="revenue-scale"
|
|
546
548
|
*/
|
|
547
549
|
"unitScaling": string | number;
|
|
@@ -996,23 +998,25 @@ export namespace Components {
|
|
|
996
998
|
}
|
|
997
999
|
/**
|
|
998
1000
|
* Defines a named scaling value that chart and table components can reference
|
|
999
|
-
* via their `unit-scaling` or `percentage-scaling` attributes
|
|
1001
|
+
* via their `unit-scaling` or `percentage-scaling` attributes, or a bubble
|
|
1002
|
+
* chart via its `size` spec's `group` key.
|
|
1000
1003
|
* Multiple components sharing the same group name will use the same scaling
|
|
1001
1004
|
* value, allowing synchronized scaling across an entire page or section.
|
|
1002
|
-
* The reserved name `"auto"` is not allowed and
|
|
1003
|
-
*
|
|
1005
|
+
* The reserved name `"auto"` is not allowed, and neither is a name that would
|
|
1006
|
+
* parse as a number/SI value (e.g. `"1M"`); both are rejected with a warning.
|
|
1007
|
+
* @example <bn-scaling-group name="revenue" value="250k"></bn-scaling-group>
|
|
1004
1008
|
* <bn-chart-structure unit-scaling="revenue" ...></bn-chart-structure>
|
|
1005
1009
|
* <bn-table unit-scaling="revenue" ...></bn-table>
|
|
1006
1010
|
*/
|
|
1007
1011
|
interface BnScalingGroup {
|
|
1008
1012
|
/**
|
|
1009
|
-
* Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes. The name `"auto"` is reserved and
|
|
1013
|
+
* 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.
|
|
1010
1014
|
*/
|
|
1011
1015
|
"name": string;
|
|
1012
1016
|
/**
|
|
1013
|
-
* The scaling value (
|
|
1017
|
+
* The scaling value: a positive number with optional SI suffix (`k`/`K` = 1e3, `M` = 1e6, `G` = 1e9, `T` = 1e12), e.g. `"250k"` or `2.5`. The unit depends on which attribute references this group: - from `unit-scaling`: data units per 1 em of bar length - from `percentage-scaling`: percentage points per 1 em of pin length - from a bubble chart's `size.group`: data units per 1 em² of bubble area
|
|
1014
1018
|
*/
|
|
1015
|
-
"value": number;
|
|
1019
|
+
"value": string | number;
|
|
1016
1020
|
}
|
|
1017
1021
|
/**
|
|
1018
1022
|
* Public-facing wrapper for the IBCS table component.
|
|
@@ -1024,7 +1028,7 @@ export namespace Components {
|
|
|
1024
1028
|
*/
|
|
1025
1029
|
interface BnTable {
|
|
1026
1030
|
/**
|
|
1027
|
-
* Set width of bar chart columns
|
|
1031
|
+
* 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 ```
|
|
1028
1032
|
* @default "w10"
|
|
1029
1033
|
*/
|
|
1030
1034
|
"barColumnWidth": string;
|
|
@@ -1033,7 +1037,7 @@ export namespace Components {
|
|
|
1033
1037
|
*/
|
|
1034
1038
|
"barColumns": string;
|
|
1035
1039
|
/**
|
|
1036
|
-
* Set width of category column. <br /> If INF is selected the columns scaling to the min space they need seperatly. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w50 // inf ```
|
|
1040
|
+
* Set width of category column, in em of the table font. <br /> If INF is selected the columns scaling to the min space they need seperatly. <br /><br /> The column is fixed at this width; a category label too long to fit is truncated with an ellipsis. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w50 // inf ```
|
|
1037
1041
|
* @default "w15"
|
|
1038
1042
|
*/
|
|
1039
1043
|
"categoryWidth": string;
|
|
@@ -1078,7 +1082,7 @@ export namespace Components {
|
|
|
1078
1082
|
*/
|
|
1079
1083
|
"limit": number;
|
|
1080
1084
|
/**
|
|
1081
|
-
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // μ // n // p //
|
|
1085
|
+
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // my (μ) // n // p // f // a // z // y // GREATEST // LEAST``` <br /><br /> SiPrefix overview: ``` "Y": 1E+24,```<br /> ``` "Z": 1E+21,```<br /> ``` "E": 1E+18,```<br /> ``` "P": 1E+15,```<br /> ``` "T": 1E+12,```<br /> ``` "G": 1000000000,```<br /> ``` "M": 1000000,```<br /> ``` "k": 1000,```<br /> <br /> ``` "m": 0.001,```<br /> ``` "my" (μ): 0.000001,```<br /> ``` "n": 0.000000001,```<br /> ``` "p": 0.000000000001,```<br /> ``` "f": 0.000000000000001,```<br /> ``` "a": 0.000000000000000001,```<br /> ``` "z": 0.000000000000000000001,```<br /> ``` "y": 0.000000000000000000000001,```<br /> <br /><br /> Special modes: ```GREATEST``` seaches for the bigest (farest to zero) Value in the dataset and sets this value to SiPrefix<br /> ```LEAST``` searches for smallest (closest to zero) Value in the dataset and sets this value to SiPrefix<br /> <br /><br /> ```_``` is the value for no SiPrefix the value is displayed as in the dataset stored.
|
|
1082
1086
|
* @default "greatest"
|
|
1083
1087
|
*/
|
|
1084
1088
|
"measureScale": string;
|
|
@@ -1108,10 +1112,10 @@ export namespace Components {
|
|
|
1108
1112
|
*/
|
|
1109
1113
|
"partof": string;
|
|
1110
1114
|
/**
|
|
1111
|
-
*
|
|
1112
|
-
* @example percentage-scaling="
|
|
1115
|
+
* 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)
|
|
1116
|
+
* @example percentage-scaling="10"
|
|
1113
1117
|
* @example percentage-scaling="pct-scale"
|
|
1114
|
-
* @default
|
|
1118
|
+
* @default "2"
|
|
1115
1119
|
*/
|
|
1116
1120
|
"percentageScaling": string | number;
|
|
1117
1121
|
/**
|
|
@@ -1162,10 +1166,10 @@ export namespace Components {
|
|
|
1162
1166
|
*/
|
|
1163
1167
|
"type": string;
|
|
1164
1168
|
/**
|
|
1165
|
-
*
|
|
1166
|
-
* @example unit-scaling="
|
|
1169
|
+
* 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)
|
|
1170
|
+
* @example unit-scaling="1M"
|
|
1167
1171
|
* @example unit-scaling="revenue-scale"
|
|
1168
|
-
* @default
|
|
1172
|
+
* @default "100"
|
|
1169
1173
|
*/
|
|
1170
1174
|
"unitScaling": string | number;
|
|
1171
1175
|
/**
|
|
@@ -1589,6 +1593,10 @@ export namespace Components {
|
|
|
1589
1593
|
* @default 10
|
|
1590
1594
|
*/
|
|
1591
1595
|
"pixelPerUnit": number;
|
|
1596
|
+
/**
|
|
1597
|
+
* Internal wrapper channel: called with the auto-fitted values (px for one data unit / px per 1.0 fraction) whenever one of them was auto-resolved, so the outer `bn-chart-structure` can surface them in its AUTO_* warnings. Not for end users.
|
|
1598
|
+
*/
|
|
1599
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
1592
1600
|
"ruleSetConfig"?: RuleSetConfig;
|
|
1593
1601
|
/**
|
|
1594
1602
|
* @default []
|
|
@@ -1700,6 +1708,10 @@ export namespace Components {
|
|
|
1700
1708
|
* @default 2
|
|
1701
1709
|
*/
|
|
1702
1710
|
"pixelPerUnit": number;
|
|
1711
|
+
/**
|
|
1712
|
+
* Internal wrapper channel: called with the auto-fitted values (px for one data unit / px per 1.0 fraction) whenever one of them was auto-resolved, so the outer `bn-chart-time` can surface them in its AUTO_* warnings. Not for end users.
|
|
1713
|
+
*/
|
|
1714
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
1703
1715
|
"ruleSetConfig"?: RuleSetConfig;
|
|
1704
1716
|
/**
|
|
1705
1717
|
* @default []
|
|
@@ -1746,6 +1758,7 @@ export namespace Components {
|
|
|
1746
1758
|
*/
|
|
1747
1759
|
"attributeColumns": TableAttribute[];
|
|
1748
1760
|
/**
|
|
1761
|
+
* 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.
|
|
1749
1762
|
* @default 30
|
|
1750
1763
|
*/
|
|
1751
1764
|
"barColumnMaxWidth": number;
|
|
@@ -1818,6 +1831,10 @@ export namespace Components {
|
|
|
1818
1831
|
* @default 0.5
|
|
1819
1832
|
*/
|
|
1820
1833
|
"percentageScaling": number;
|
|
1834
|
+
/**
|
|
1835
|
+
* Internal wrapper channel: called with the auto-fitted scaling values (em per unit / em per percentage point) whenever one of them was auto-resolved, so the outer `bn-table` can surface them in its AUTO_* warnings. Not for end users.
|
|
1836
|
+
*/
|
|
1837
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
1821
1838
|
"ruleSetConfig"?: RuleSetConfig;
|
|
1822
1839
|
/**
|
|
1823
1840
|
* @default 1
|
|
@@ -2114,11 +2131,13 @@ declare global {
|
|
|
2114
2131
|
};
|
|
2115
2132
|
/**
|
|
2116
2133
|
* Defines a named scaling value that chart and table components can reference
|
|
2117
|
-
* via their `unit-scaling` or `percentage-scaling` attributes
|
|
2134
|
+
* via their `unit-scaling` or `percentage-scaling` attributes, or a bubble
|
|
2135
|
+
* chart via its `size` spec's `group` key.
|
|
2118
2136
|
* Multiple components sharing the same group name will use the same scaling
|
|
2119
2137
|
* value, allowing synchronized scaling across an entire page or section.
|
|
2120
|
-
* The reserved name `"auto"` is not allowed and
|
|
2121
|
-
*
|
|
2138
|
+
* The reserved name `"auto"` is not allowed, and neither is a name that would
|
|
2139
|
+
* parse as a number/SI value (e.g. `"1M"`); both are rejected with a warning.
|
|
2140
|
+
* @example <bn-scaling-group name="revenue" value="250k"></bn-scaling-group>
|
|
2122
2141
|
* <bn-chart-structure unit-scaling="revenue" ...></bn-chart-structure>
|
|
2123
2142
|
* <bn-table unit-scaling="revenue" ...></bn-table>
|
|
2124
2143
|
*/
|
|
@@ -2617,8 +2636,8 @@ declare namespace LocalJSX {
|
|
|
2617
2636
|
*/
|
|
2618
2637
|
"orderDirection": string;
|
|
2619
2638
|
/**
|
|
2620
|
-
*
|
|
2621
|
-
* @example percentage-scaling="
|
|
2639
|
+
* 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 |
|
|
2640
|
+
* @example percentage-scaling="10"
|
|
2622
2641
|
* @example percentage-scaling="pct-scale"
|
|
2623
2642
|
*/
|
|
2624
2643
|
"percentageScaling": string | number;
|
|
@@ -2655,9 +2674,9 @@ declare namespace LocalJSX {
|
|
|
2655
2674
|
*/
|
|
2656
2675
|
"stack"?: string;
|
|
2657
2676
|
/**
|
|
2658
|
-
*
|
|
2677
|
+
* 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.
|
|
2659
2678
|
* @example unit-scaling="auto"
|
|
2660
|
-
* @example unit-scaling="
|
|
2679
|
+
* @example unit-scaling="1M"
|
|
2661
2680
|
* @example unit-scaling="revenue-scale"
|
|
2662
2681
|
*/
|
|
2663
2682
|
"unitScaling": string | number;
|
|
@@ -2726,7 +2745,7 @@ declare namespace LocalJSX {
|
|
|
2726
2745
|
*/
|
|
2727
2746
|
"maxBars"?: number;
|
|
2728
2747
|
/**
|
|
2729
|
-
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // μ // n // p //
|
|
2748
|
+
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // my (μ) // n // p // f // a // z // y // GREATEST // LEAST``` <br /><br /> SiPrefix overview: ``` "Y": 1E+24,```<br /> ``` "Z": 1E+21,```<br /> ``` "E": 1E+18,```<br /> ``` "P": 1E+15,```<br /> ``` "T": 1E+12,```<br /> ``` "G": 1000000000,```<br /> ``` "M": 1000000,```<br /> ``` "k": 1000,```<br /> <br /> ``` "m": 0.001,```<br /> ``` "my" (μ): 0.000001,```<br /> ``` "n": 0.000000001,```<br /> ``` "p": 0.000000000001,```<br /> ``` "f": 0.000000000000001,```<br /> ``` "a": 0.000000000000000001,```<br /> ``` "z": 0.000000000000000000001,```<br /> ``` "y": 0.000000000000000000000001,```<br /> <br /><br /> Special modes: ```GREATEST``` seaches for the bigest (farest to zero) Value in the dataset and sets this value to SiPrefix<br /> ```LEAST``` searches for smallest (closest to zero) Value in the dataset and sets this value to SiPrefix<br /> <br /><br /> ```_``` is the value for no SiPrefix the value is displayed as in the dataset stored.
|
|
2730
2749
|
* @default "greatest"
|
|
2731
2750
|
*/
|
|
2732
2751
|
"measureScale"?: string;
|
|
@@ -2744,8 +2763,8 @@ declare namespace LocalJSX {
|
|
|
2744
2763
|
*/
|
|
2745
2764
|
"orderDirection": string;
|
|
2746
2765
|
/**
|
|
2747
|
-
*
|
|
2748
|
-
* @example percentage-scaling="
|
|
2766
|
+
* 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 |
|
|
2767
|
+
* @example percentage-scaling="10"
|
|
2749
2768
|
* @example percentage-scaling="pct-scale"
|
|
2750
2769
|
*/
|
|
2751
2770
|
"percentageScaling": string | number;
|
|
@@ -2790,9 +2809,9 @@ declare namespace LocalJSX {
|
|
|
2790
2809
|
*/
|
|
2791
2810
|
"syncSpaceLeft"?: number;
|
|
2792
2811
|
/**
|
|
2793
|
-
*
|
|
2812
|
+
* 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 |
|
|
2794
2813
|
* @example unit-scaling="auto"
|
|
2795
|
-
* @example unit-scaling="
|
|
2814
|
+
* @example unit-scaling="1M"
|
|
2796
2815
|
* @example unit-scaling="revenue-scale"
|
|
2797
2816
|
*/
|
|
2798
2817
|
"unitScaling": string | number;
|
|
@@ -3245,23 +3264,25 @@ declare namespace LocalJSX {
|
|
|
3245
3264
|
}
|
|
3246
3265
|
/**
|
|
3247
3266
|
* Defines a named scaling value that chart and table components can reference
|
|
3248
|
-
* via their `unit-scaling` or `percentage-scaling` attributes
|
|
3267
|
+
* via their `unit-scaling` or `percentage-scaling` attributes, or a bubble
|
|
3268
|
+
* chart via its `size` spec's `group` key.
|
|
3249
3269
|
* Multiple components sharing the same group name will use the same scaling
|
|
3250
3270
|
* value, allowing synchronized scaling across an entire page or section.
|
|
3251
|
-
* The reserved name `"auto"` is not allowed and
|
|
3252
|
-
*
|
|
3271
|
+
* The reserved name `"auto"` is not allowed, and neither is a name that would
|
|
3272
|
+
* parse as a number/SI value (e.g. `"1M"`); both are rejected with a warning.
|
|
3273
|
+
* @example <bn-scaling-group name="revenue" value="250k"></bn-scaling-group>
|
|
3253
3274
|
* <bn-chart-structure unit-scaling="revenue" ...></bn-chart-structure>
|
|
3254
3275
|
* <bn-table unit-scaling="revenue" ...></bn-table>
|
|
3255
3276
|
*/
|
|
3256
3277
|
interface BnScalingGroup {
|
|
3257
3278
|
/**
|
|
3258
|
-
* Unique name identifying this scaling group. Components reference this name in their `unit-scaling` or `percentage-scaling` attributes. The name `"auto"` is reserved and
|
|
3279
|
+
* 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.
|
|
3259
3280
|
*/
|
|
3260
3281
|
"name": string;
|
|
3261
3282
|
/**
|
|
3262
|
-
* The scaling value (
|
|
3283
|
+
* The scaling value: a positive number with optional SI suffix (`k`/`K` = 1e3, `M` = 1e6, `G` = 1e9, `T` = 1e12), e.g. `"250k"` or `2.5`. The unit depends on which attribute references this group: - from `unit-scaling`: data units per 1 em of bar length - from `percentage-scaling`: percentage points per 1 em of pin length - from a bubble chart's `size.group`: data units per 1 em² of bubble area
|
|
3263
3284
|
*/
|
|
3264
|
-
"value": number;
|
|
3285
|
+
"value": string | number;
|
|
3265
3286
|
}
|
|
3266
3287
|
/**
|
|
3267
3288
|
* Public-facing wrapper for the IBCS table component.
|
|
@@ -3273,7 +3294,7 @@ declare namespace LocalJSX {
|
|
|
3273
3294
|
*/
|
|
3274
3295
|
interface BnTable {
|
|
3275
3296
|
/**
|
|
3276
|
-
* Set width of bar chart columns
|
|
3297
|
+
* 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 ```
|
|
3277
3298
|
* @default "w10"
|
|
3278
3299
|
*/
|
|
3279
3300
|
"barColumnWidth"?: string;
|
|
@@ -3282,7 +3303,7 @@ declare namespace LocalJSX {
|
|
|
3282
3303
|
*/
|
|
3283
3304
|
"barColumns"?: string;
|
|
3284
3305
|
/**
|
|
3285
|
-
* Set width of category column. <br /> If INF is selected the columns scaling to the min space they need seperatly. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w50 // inf ```
|
|
3306
|
+
* Set width of category column, in em of the table font. <br /> If INF is selected the columns scaling to the min space they need seperatly. <br /><br /> The column is fixed at this width; a category label too long to fit is truncated with an ellipsis. <br /><br /> values:<br /> ``` w5 // w10 // w15 // w20 // w25 // w50 // inf ```
|
|
3286
3307
|
* @default "w15"
|
|
3287
3308
|
*/
|
|
3288
3309
|
"categoryWidth"?: string;
|
|
@@ -3327,7 +3348,7 @@ declare namespace LocalJSX {
|
|
|
3327
3348
|
*/
|
|
3328
3349
|
"limit"?: number;
|
|
3329
3350
|
/**
|
|
3330
|
-
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // μ // n // p //
|
|
3351
|
+
* Sets the SiPrefix of the Mesaurements and converts the original value. <br /><br /> values: <br /> ```_ // k // M // G // T // P // E // Z // Y // m // my (μ) // n // p // f // a // z // y // GREATEST // LEAST``` <br /><br /> SiPrefix overview: ``` "Y": 1E+24,```<br /> ``` "Z": 1E+21,```<br /> ``` "E": 1E+18,```<br /> ``` "P": 1E+15,```<br /> ``` "T": 1E+12,```<br /> ``` "G": 1000000000,```<br /> ``` "M": 1000000,```<br /> ``` "k": 1000,```<br /> <br /> ``` "m": 0.001,```<br /> ``` "my" (μ): 0.000001,```<br /> ``` "n": 0.000000001,```<br /> ``` "p": 0.000000000001,```<br /> ``` "f": 0.000000000000001,```<br /> ``` "a": 0.000000000000000001,```<br /> ``` "z": 0.000000000000000000001,```<br /> ``` "y": 0.000000000000000000000001,```<br /> <br /><br /> Special modes: ```GREATEST``` seaches for the bigest (farest to zero) Value in the dataset and sets this value to SiPrefix<br /> ```LEAST``` searches for smallest (closest to zero) Value in the dataset and sets this value to SiPrefix<br /> <br /><br /> ```_``` is the value for no SiPrefix the value is displayed as in the dataset stored.
|
|
3331
3352
|
* @default "greatest"
|
|
3332
3353
|
*/
|
|
3333
3354
|
"measureScale"?: string;
|
|
@@ -3357,10 +3378,10 @@ declare namespace LocalJSX {
|
|
|
3357
3378
|
*/
|
|
3358
3379
|
"partof"?: string;
|
|
3359
3380
|
/**
|
|
3360
|
-
*
|
|
3361
|
-
* @example percentage-scaling="
|
|
3381
|
+
* 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)
|
|
3382
|
+
* @example percentage-scaling="10"
|
|
3362
3383
|
* @example percentage-scaling="pct-scale"
|
|
3363
|
-
* @default
|
|
3384
|
+
* @default "2"
|
|
3364
3385
|
*/
|
|
3365
3386
|
"percentageScaling"?: string | number;
|
|
3366
3387
|
/**
|
|
@@ -3411,10 +3432,10 @@ declare namespace LocalJSX {
|
|
|
3411
3432
|
*/
|
|
3412
3433
|
"type"?: string;
|
|
3413
3434
|
/**
|
|
3414
|
-
*
|
|
3415
|
-
* @example unit-scaling="
|
|
3435
|
+
* 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)
|
|
3436
|
+
* @example unit-scaling="1M"
|
|
3416
3437
|
* @example unit-scaling="revenue-scale"
|
|
3417
|
-
* @default
|
|
3438
|
+
* @default "100"
|
|
3418
3439
|
*/
|
|
3419
3440
|
"unitScaling"?: string | number;
|
|
3420
3441
|
/**
|
|
@@ -3835,6 +3856,10 @@ declare namespace LocalJSX {
|
|
|
3835
3856
|
* @default 10
|
|
3836
3857
|
*/
|
|
3837
3858
|
"pixelPerUnit"?: number;
|
|
3859
|
+
/**
|
|
3860
|
+
* Internal wrapper channel: called with the auto-fitted values (px for one data unit / px per 1.0 fraction) whenever one of them was auto-resolved, so the outer `bn-chart-structure` can surface them in its AUTO_* warnings. Not for end users.
|
|
3861
|
+
*/
|
|
3862
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
3838
3863
|
"ruleSetConfig"?: RuleSetConfig;
|
|
3839
3864
|
/**
|
|
3840
3865
|
* @default []
|
|
@@ -3946,6 +3971,10 @@ declare namespace LocalJSX {
|
|
|
3946
3971
|
* @default 2
|
|
3947
3972
|
*/
|
|
3948
3973
|
"pixelPerUnit"?: number;
|
|
3974
|
+
/**
|
|
3975
|
+
* Internal wrapper channel: called with the auto-fitted values (px for one data unit / px per 1.0 fraction) whenever one of them was auto-resolved, so the outer `bn-chart-time` can surface them in its AUTO_* warnings. Not for end users.
|
|
3976
|
+
*/
|
|
3977
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
3949
3978
|
"ruleSetConfig"?: RuleSetConfig;
|
|
3950
3979
|
/**
|
|
3951
3980
|
* @default []
|
|
@@ -3992,6 +4021,7 @@ declare namespace LocalJSX {
|
|
|
3992
4021
|
*/
|
|
3993
4022
|
"attributeColumns"?: TableAttribute[];
|
|
3994
4023
|
/**
|
|
4024
|
+
* 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.
|
|
3995
4025
|
* @default 30
|
|
3996
4026
|
*/
|
|
3997
4027
|
"barColumnMaxWidth"?: number;
|
|
@@ -4064,6 +4094,10 @@ declare namespace LocalJSX {
|
|
|
4064
4094
|
* @default 0.5
|
|
4065
4095
|
*/
|
|
4066
4096
|
"percentageScaling"?: number;
|
|
4097
|
+
/**
|
|
4098
|
+
* Internal wrapper channel: called with the auto-fitted scaling values (em per unit / em per percentage point) whenever one of them was auto-resolved, so the outer `bn-table` can surface them in its AUTO_* warnings. Not for end users.
|
|
4099
|
+
*/
|
|
4100
|
+
"reportAutoScaling"?: (report: AutoScalingReport) => void;
|
|
4067
4101
|
"ruleSetConfig"?: RuleSetConfig;
|
|
4068
4102
|
/**
|
|
4069
4103
|
* @default 1
|
|
@@ -4378,7 +4412,7 @@ declare namespace LocalJSX {
|
|
|
4378
4412
|
}
|
|
4379
4413
|
interface BnScalingGroupAttributes {
|
|
4380
4414
|
"name": string;
|
|
4381
|
-
"value":
|
|
4415
|
+
"value": string;
|
|
4382
4416
|
}
|
|
4383
4417
|
interface BnTableAttributes {
|
|
4384
4418
|
"scale": string;
|
|
@@ -4688,11 +4722,13 @@ declare module "@stencil/core" {
|
|
|
4688
4722
|
"bn-ruleset": LocalJSX.IntrinsicElements["bn-ruleset"] & JSXBase.HTMLAttributes<HTMLBnRulesetElement>;
|
|
4689
4723
|
/**
|
|
4690
4724
|
* Defines a named scaling value that chart and table components can reference
|
|
4691
|
-
* via their `unit-scaling` or `percentage-scaling` attributes
|
|
4725
|
+
* via their `unit-scaling` or `percentage-scaling` attributes, or a bubble
|
|
4726
|
+
* chart via its `size` spec's `group` key.
|
|
4692
4727
|
* Multiple components sharing the same group name will use the same scaling
|
|
4693
4728
|
* value, allowing synchronized scaling across an entire page or section.
|
|
4694
|
-
* The reserved name `"auto"` is not allowed and
|
|
4695
|
-
*
|
|
4729
|
+
* The reserved name `"auto"` is not allowed, and neither is a name that would
|
|
4730
|
+
* parse as a number/SI value (e.g. `"1M"`); both are rejected with a warning.
|
|
4731
|
+
* @example <bn-scaling-group name="revenue" value="250k"></bn-scaling-group>
|
|
4696
4732
|
* <bn-chart-structure unit-scaling="revenue" ...></bn-chart-structure>
|
|
4697
4733
|
* <bn-table unit-scaling="revenue" ...></bn-table>
|
|
4698
4734
|
*/
|
|
@@ -1070,6 +1070,7 @@ export declare namespace JSXBase {
|
|
|
1070
1070
|
importance?: 'low' | 'auto' | 'high';
|
|
1071
1071
|
height?: number | string;
|
|
1072
1072
|
loading?: 'lazy' | 'auto' | 'eager';
|
|
1073
|
+
referrerPolicy?: ReferrerPolicy;
|
|
1073
1074
|
sizes?: string;
|
|
1074
1075
|
src?: string;
|
|
1075
1076
|
srcSet?: string;
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure math for the chart auto-fit loops (ibcs-chart-structure fits width,
|
|
3
|
+
* ibcs-chart-time fits height). Kept free of chart/svg.js imports so it can
|
|
4
|
+
* be unit-tested under mock-doc (which lacks getBBox).
|
|
5
|
+
*
|
|
6
|
+
* Model: a chart's size along its fit axis is affine in the pixel scales,
|
|
7
|
+
* measured = fixed + unitExtent * pixelPerUnit + pctExtent * pixelPerPercentage
|
|
8
|
+
* where the extents are the total bar lengths in data units (positive plus
|
|
9
|
+
* negative side of the axis). The chart classes report their extents via
|
|
10
|
+
* getUnitBarExtent()/getPercentBarExtent(); {@link solveAutoFitStep} solves
|
|
11
|
+
* the model for the target size against a fresh measurement, so repeated
|
|
12
|
+
* steps converge even when clamped label widths flip between passes.
|
|
13
|
+
*/
|
|
14
|
+
/** Lower bound for auto-fitted pixelPerUnit / pixelPerPercentage values. */
|
|
15
|
+
export declare const MIN_PIXEL_SCALE = 0.001;
|
|
16
|
+
/** Inputs describing which data extent scales with pixelPerUnit. */
|
|
17
|
+
export interface UnitExtentInputs {
|
|
18
|
+
/**
|
|
19
|
+
* When set, the bar domain is fixed and overrides the data-driven extent:
|
|
20
|
+
* stacked charts use their stacked total (or the relative-stack span),
|
|
21
|
+
* regardless of individual min/max values.
|
|
22
|
+
*/
|
|
23
|
+
fixedDomain?: number;
|
|
24
|
+
/** True when the chart renders a relative (percentage) variance. */
|
|
25
|
+
relativeVariance: boolean;
|
|
26
|
+
/** Highest data value on the positive side of the axis (or 0). */
|
|
27
|
+
maxPositive: number;
|
|
28
|
+
/** Smallest data value on the negative side of the axis (or 0). */
|
|
29
|
+
minNegative: number;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Total bar extent (in data units) that scales linearly with pixelPerUnit.
|
|
33
|
+
* Counts BOTH sides of the axis — a chart with values -13..+12 spans 25
|
|
34
|
+
* units, not 12 (fitting only the positive side is how charts used to
|
|
35
|
+
* overshoot their container).
|
|
36
|
+
*/
|
|
37
|
+
export declare function computeUnitBarExtent(inputs: UnitExtentInputs): number;
|
|
38
|
+
/** Inputs describing which data extent scales with pixelPerPercentage. */
|
|
39
|
+
export interface PercentExtentInputs {
|
|
40
|
+
/** True when the chart renders a relative (percentage) variance. */
|
|
41
|
+
relativeVariance: boolean;
|
|
42
|
+
/** Highest variance fraction on the positive side (0.12 = +12%). */
|
|
43
|
+
maxPositive: number;
|
|
44
|
+
/** Smallest variance fraction on the negative side (-0.05 = -5%). */
|
|
45
|
+
minNegative: number;
|
|
46
|
+
/** Per-side clamp in fraction units (IBCS pins beyond ±145% -> 1.45). */
|
|
47
|
+
sideClamp?: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Total bar extent (in fraction units) that scales linearly with
|
|
51
|
+
* pixelPerPercentage. Only relative variances use it; each side is clamped
|
|
52
|
+
* because extreme pins render as fixed-size arrows instead of longer bars.
|
|
53
|
+
*/
|
|
54
|
+
export declare function computePercentBarExtent(inputs: PercentExtentInputs): number;
|
|
55
|
+
/** One verify-and-correct step against a fresh chart measurement. */
|
|
56
|
+
export interface AutoFitStepInputs {
|
|
57
|
+
/** Available size along the fit axis (width or height) in px. */
|
|
58
|
+
target: number;
|
|
59
|
+
/** Rendered chart size along the fit axis at the current scales, in px. */
|
|
60
|
+
measured: number;
|
|
61
|
+
/** Unit extent being solved, or 0 when pixelPerUnit is explicit. */
|
|
62
|
+
unitExtent: number;
|
|
63
|
+
/** Percent extent being solved, or 0 when pixelPerPercentage is explicit. */
|
|
64
|
+
pctExtent: number;
|
|
65
|
+
/** pixelPerUnit the measurement was rendered with. */
|
|
66
|
+
currentPpu: number;
|
|
67
|
+
/** pixelPerPercentage the measurement was rendered with. */
|
|
68
|
+
currentPpp: number;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Solves the affine size model for the target and returns corrected scale
|
|
72
|
+
* values (floored at {@link MIN_PIXEL_SCALE}). Returns an empty object when
|
|
73
|
+
* nothing scales with the solved values (both extents 0) — callers fall back
|
|
74
|
+
* to a ratio heuristic. Only the quantities whose extent is > 0 are returned.
|
|
75
|
+
*/
|
|
76
|
+
export declare function solveAutoFitStep(inputs: AutoFitStepInputs): {
|
|
77
|
+
ppu?: number;
|
|
78
|
+
ppp?: number;
|
|
79
|
+
};
|
|
@@ -64,7 +64,7 @@ export declare enum TableType {
|
|
|
64
64
|
OPT = "opt",
|
|
65
65
|
OPTNOTOTAL = "optnototal"
|
|
66
66
|
}
|
|
67
|
-
/** Width of the category label column
|
|
67
|
+
/** Width of the category label column, in em of the table font. INF = auto/infinite. */
|
|
68
68
|
export declare enum TableCategoryWidth {
|
|
69
69
|
INF = "inf",
|
|
70
70
|
W100 = "w100",
|
|
@@ -75,7 +75,7 @@ export declare enum TableCategoryWidth {
|
|
|
75
75
|
W10 = "w10",
|
|
76
76
|
W5 = "w5"
|
|
77
77
|
}
|
|
78
|
-
/** Width preset for inline bar/pin chart columns. Value =
|
|
78
|
+
/** Width preset for inline bar/pin chart columns. Value = total column width in em. */
|
|
79
79
|
export declare enum TableBarColumnWidth {
|
|
80
80
|
W5 = "w5",
|
|
81
81
|
W10 = "w10",
|
|
@@ -88,7 +88,7 @@ export declare enum TableBarColumnWidth {
|
|
|
88
88
|
W80 = "w80",
|
|
89
89
|
W100 = "w100"
|
|
90
90
|
}
|
|
91
|
-
/** Maps TableBarColumnWidth presets to
|
|
91
|
+
/** Maps TableBarColumnWidth presets to total bar column width in em. */
|
|
92
92
|
export declare const BAR_COLUMN_WIDTH_EM: Record<TableBarColumnWidth, number>;
|
|
93
93
|
/**
|
|
94
94
|
* Three-level row hierarchy for grouping and drill-down: rowGroup > category > subCategory.
|
|
@@ -50,7 +50,11 @@ export declare class DataAnalyzer {
|
|
|
50
50
|
* - `null` with data: defaults to GREATEST auto-detection
|
|
51
51
|
*/
|
|
52
52
|
static calculateMeasureScale(db: AlaSQLDatabase, fromExpr: string, scenarios: string[], mode: string | null): SiPrefix;
|
|
53
|
-
/**
|
|
53
|
+
/**
|
|
54
|
+
* Maps an absolute numeric value to the best-fitting SI prefix based on
|
|
55
|
+
* its decimal magnitude. Values in (0.001, 1000) keep the identity prefix.
|
|
56
|
+
* Magnitudes beyond the covered SI range clamp to the outermost prefix.
|
|
57
|
+
*/
|
|
54
58
|
private static determinePrefix;
|
|
55
59
|
/** Looks up an explicit SI prefix string in the NumeralFigure enum. */
|
|
56
60
|
private static lookupPrefix;
|