@ids-group-ltd/ids-design-system 0.13.2 → 0.13.4
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/CHANGELOG.md +1106 -9
- package/components.md +563 -44
- package/design-system.md +9 -0
- package/docs/agent/INDEX.md +58 -17
- package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +1 -1
- package/docs/agent/charts/column-series-component.md +8 -0
- package/docs/agent/charts/ds-bar-chart.md +6 -1
- package/docs/agent/charts/ds-chart-data-table.md +10 -0
- package/docs/agent/charts/ds-chart.md +8 -0
- package/docs/agent/charts/ds-column-chart.md +7 -2
- package/docs/agent/charts/ds-funnel-chart.md +5 -1
- package/docs/agent/charts/ds-heatmap-chart.md +20 -0
- package/docs/agent/charts/ds-line-chart.md +8 -4
- package/docs/agent/charts/{ds-donut-chart.md → ds-pie-chart.md} +10 -6
- package/docs/agent/charts/ds-scatter-chart.md +20 -0
- package/docs/agent/charts/ds-waterfall-chart.md +20 -0
- package/docs/agent/charts/line-series-component.md +8 -0
- package/docs/agent/charts/reference-label-component.md +8 -0
- package/docs/agent/charts/reference-line-component.md +8 -0
- package/docs/agent/charts/series-annotation-component.md +10 -0
- package/docs/agent/feedback/ds-alert.md +4 -0
- package/docs/agent/feedback/ds-avatar-group.md +4 -0
- package/docs/agent/feedback/ds-avatar.md +4 -0
- package/docs/agent/feedback/ds-badge.md +4 -0
- package/docs/agent/feedback/ds-banner.md +5 -1
- package/docs/agent/feedback/ds-bar.md +17 -0
- package/docs/agent/feedback/ds-description-item.md +8 -0
- package/docs/agent/feedback/ds-description-list.md +8 -0
- package/docs/agent/feedback/ds-empty-state.md +4 -0
- package/docs/agent/feedback/ds-list-item.md +8 -0
- package/docs/agent/feedback/ds-list.md +8 -0
- package/docs/agent/feedback/ds-loading-overlay.md +8 -0
- package/docs/agent/feedback/ds-skeleton.md +4 -0
- package/docs/agent/feedback/ds-spinner.md +4 -0
- package/docs/agent/feedback/ds-stat.md +4 -0
- package/docs/agent/feedback/ds-status-dot.md +4 -0
- package/docs/agent/feedback/ds-tag.md +4 -0
- package/docs/agent/feedback/ds-timeline-item.md +8 -0
- package/docs/agent/feedback/ds-toast-region.md +8 -0
- package/docs/agent/feedback/ds-toast.md +4 -0
- package/docs/agent/feedback/ds-tree.md +8 -0
- package/docs/agent/forms/ds-autocomplete.md +4 -0
- package/docs/agent/forms/ds-button-group.md +8 -0
- package/docs/agent/forms/ds-button.md +6 -2
- package/docs/agent/forms/ds-checkbox.md +4 -0
- package/docs/agent/forms/ds-color-picker.md +8 -0
- package/docs/agent/forms/ds-date-picker.md +5 -1
- package/docs/agent/forms/ds-dropzone.md +4 -0
- package/docs/agent/forms/ds-field-group.md +8 -0
- package/docs/agent/forms/ds-filter-bar.md +8 -0
- package/docs/agent/forms/ds-icon-button.md +4 -0
- package/docs/agent/forms/ds-input.md +13 -1
- package/docs/agent/forms/ds-multi-select.md +4 -0
- package/docs/agent/forms/ds-number-stepper.md +4 -0
- package/docs/agent/forms/ds-otp-input.md +8 -0
- package/docs/agent/forms/ds-password-rules.md +8 -0
- package/docs/agent/forms/ds-radio-group.md +8 -0
- package/docs/agent/forms/ds-radio.md +4 -0
- package/docs/agent/forms/ds-search.md +4 -0
- package/docs/agent/forms/ds-segmented.md +8 -0
- package/docs/agent/forms/ds-select.md +4 -0
- package/docs/agent/forms/ds-slider.md +8 -0
- package/docs/agent/forms/ds-split-button.md +8 -0
- package/docs/agent/forms/ds-switch.md +4 -0
- package/docs/agent/forms/ds-textarea.md +5 -1
- package/docs/agent/forms/ds-time-picker.md +8 -0
- package/docs/agent/forms/ds-toggle-button.md +8 -0
- package/docs/agent/forms/filter-item-directive.md +8 -0
- package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +4 -0
- package/docs/agent/navigation/ds-app-layout.md +6 -2
- package/docs/agent/navigation/ds-auth-layout.md +5 -1
- package/docs/agent/navigation/ds-breadcrumbs.md +4 -0
- package/docs/agent/navigation/ds-container.md +8 -0
- package/docs/agent/navigation/ds-divider.md +4 -0
- package/docs/agent/navigation/ds-inline.md +8 -0
- package/docs/agent/navigation/ds-page-footer.md +4 -0
- package/docs/agent/navigation/ds-page-header.md +5 -1
- package/docs/agent/navigation/ds-pagination.md +5 -1
- package/docs/agent/navigation/ds-sidenav-footer.md +8 -0
- package/docs/agent/navigation/ds-sidenav-group.md +4 -0
- package/docs/agent/navigation/ds-sidenav-item.md +4 -0
- package/docs/agent/navigation/ds-sidenav.md +4 -0
- package/docs/agent/navigation/ds-stack.md +8 -0
- package/docs/agent/navigation/ds-stepper.md +4 -0
- package/docs/agent/navigation/ds-tab.md +8 -0
- package/docs/agent/navigation/ds-tabs.md +5 -1
- package/docs/agent/overlays/ds-bottom-sheet.md +4 -0
- package/docs/agent/overlays/ds-drawer.md +4 -0
- package/docs/agent/overlays/ds-menu.md +4 -0
- package/docs/agent/overlays/ds-modal-card.md +4 -0
- package/docs/agent/overlays/ds-modal.md +4 -0
- package/docs/agent/overlays/ds-popover.md +4 -0
- package/docs/agent/overlays/ds-tooltip-panel.md +8 -0
- package/docs/agent/overlays/ds-tooltip.md +4 -0
- package/docs/agent/surfaces/ds-accordion-item.md +8 -0
- package/docs/agent/surfaces/ds-accordion.md +4 -0
- package/docs/agent/surfaces/ds-card.md +6 -2
- package/docs/agent/tables/ds-cell-template.md +8 -0
- package/docs/agent/tables/ds-table-columns.md +8 -0
- package/docs/agent/tables/ds-table-export.md +8 -0
- package/docs/agent/tables/ds-table.md +9 -2
- package/docs/agent/tables/header-filter-directive.md +8 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +10 -8
- package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +19 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +7 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +9 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +119 -30
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +95 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +3 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +7 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +32 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +84 -43
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +1322 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +8 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +164 -126
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +5 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +23 -16
- package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +32 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +217 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +185 -573
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-loading-overlay.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +6 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +7 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +391 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +300 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +9 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +7 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +4 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +9 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +5 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-timeline.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +34 -21
- package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +252 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +429 -24
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +8 -4
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.10.0.json +2 -2
- package/migrations/0.10.1.json +3 -3
- package/migrations/0.10.2.json +8 -28
- package/migrations/0.11.0.json +3 -3
- package/migrations/0.11.1.json +15 -15
- package/migrations/0.11.2.json +9 -9
- package/migrations/0.11.3.json +1 -1
- package/migrations/0.11.4.json +8 -8
- package/migrations/0.12.1.json +1 -1
- package/migrations/0.12.2.json +1 -1
- package/migrations/0.12.3.json +3 -3
- package/migrations/0.13.0.json +24 -32
- package/migrations/0.13.1.json +5 -5
- package/migrations/0.13.3.json +211 -0
- package/migrations/0.13.4.json +994 -0
- package/migrations/0.5.0.json +1 -1
- package/migrations/0.8.0.json +4 -3
- package/migrations/0.9.0.json +1 -1
- package/package.json +57 -25
- package/styles/_chart-frame.scss +31 -8
- package/styles/_check-box.scss +12 -12
- package/styles/_dropdown-overlay.scss +14 -10
- package/styles/_field-box.scss +3 -3
- package/styles/_field-label.scss +7 -7
- package/styles/_overlay-motion.scss +1 -1
- package/styles/_table-controls.scss +3 -3
- package/styles/_tokens-charts.scss +69 -12
- package/styles/_tokens.scss +3 -3
- package/styles/_typography.scss +101 -101
- package/themes/dark/_theme.scss +13 -0
- package/types/ids-group-ltd-ids-design-system-components-accordion.d.ts +3 -3
- package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +5 -4
- package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +17 -17
- package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +4 -2
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +37 -3
- package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +63 -0
- package/types/ids-group-ltd-ids-design-system-components-bottom-sheet.d.ts +1 -1
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +6 -2
- package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +31 -0
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +11 -4
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +729 -0
- package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +99 -38
- package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +9 -7
- package/types/ids-group-ltd-ids-design-system-components-dropzone.d.ts +4 -4
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +9 -1
- package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +124 -0
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +84 -148
- package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +13 -1
- package/types/{ids-group-ltd-ids-design-system-components-donut-chart.d.ts → ids-group-ltd-ids-design-system-components-pie-chart.d.ts} +35 -17
- package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +183 -0
- package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +5 -1
- package/types/ids-group-ltd-ids-design-system-components-select.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-table-export.d.ts +3 -0
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +11 -11
- package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
- package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +5 -2
- package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +116 -0
- package/types/ids-group-ltd-ids-design-system-components.d.ts +151 -9
- package/types/ids-group-ltd-ids-design-system-core.d.ts +78 -4
- package/types/ids-group-ltd-ids-design-system.d.ts +16 -12
- package/docs/agent/feedback/ds-meter.md +0 -11
- package/docs/agent/feedback/ds-progress.md +0 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +0 -351
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +0 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +0 -61
- package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +0 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +0 -65
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +0 -1
- package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +0 -36
- package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +0 -40
|
@@ -0,0 +1,729 @@
|
|
|
1
|
+
import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
|
|
2
|
+
import { NiceDomain } from '@ids-group-ltd/ids-design-system/components';
|
|
3
|
+
import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
|
|
4
|
+
import * as _angular_core from '@angular/core';
|
|
5
|
+
import { InjectionToken, Signal, OnDestroy } from '@angular/core';
|
|
6
|
+
import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
7
|
+
import { ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipTrigger, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
8
|
+
import { SafeHtml } from '@angular/platform-browser';
|
|
9
|
+
import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-ltd/ids-design-system/components/chart';
|
|
10
|
+
|
|
11
|
+
declare const CHART_DEFAULT_VALUE_SPACE = 20;
|
|
12
|
+
/** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
|
|
13
|
+
* number, which is what holds the 1:1 scale on the vertical axis too.
|
|
14
|
+
*
|
|
15
|
+
* `valueSpace` is always budgeted above the plot, for a value label over the tallest mark. It is
|
|
16
|
+
* budgeted a SECOND time below the baseline only when the domain reaches under zero, where a
|
|
17
|
+
* negative mark's label would otherwise print into the category labels: reserving it for every
|
|
18
|
+
* chart costs the all-positive ones - the common case - that much height for nothing.
|
|
19
|
+
*
|
|
20
|
+
* @internal */
|
|
21
|
+
declare function chartViewHeight(plotHeight: number, valueSpace: number, reservesBelowBaseline?: boolean): number;
|
|
22
|
+
/** @internal */
|
|
23
|
+
interface ThresholdMark {
|
|
24
|
+
/** Position in the list, not the reading: two thresholds may legitimately name the same value -
|
|
25
|
+
* a target and the floor of the band around it - and keying on the value would collapse them
|
|
26
|
+
* into one drawn line. */
|
|
27
|
+
readonly key: number;
|
|
28
|
+
readonly label: string;
|
|
29
|
+
readonly color: string | null;
|
|
30
|
+
readonly dash: ChartThresholdDash;
|
|
31
|
+
readonly band: boolean;
|
|
32
|
+
readonly left: number;
|
|
33
|
+
readonly right: number;
|
|
34
|
+
readonly width: number;
|
|
35
|
+
readonly y: number;
|
|
36
|
+
readonly top: number;
|
|
37
|
+
readonly height: number;
|
|
38
|
+
readonly labelX: number;
|
|
39
|
+
readonly labelY: number;
|
|
40
|
+
}
|
|
41
|
+
/** @internal */
|
|
42
|
+
interface SecondaryAxis {
|
|
43
|
+
readonly domain: NiceDomain;
|
|
44
|
+
readonly ticks: readonly number[];
|
|
45
|
+
/** True when the labels below belong on the PRIMARY axis's own tick rows, so the plot carries
|
|
46
|
+
* one set of gridlines rather than two crossing each other. */
|
|
47
|
+
readonly aligned: boolean;
|
|
48
|
+
}
|
|
49
|
+
/** Every segment's span on the value axis, series-major: `offsets[series][category]`.
|
|
50
|
+
*
|
|
51
|
+
* `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
|
|
52
|
+
* where the band puts them, which is geometry rather than value. The stacking modes run a
|
|
53
|
+
* POSITIVE and a NEGATIVE pile per category, so a negative segment hangs below the baseline
|
|
54
|
+
* instead of being subtracted from the positive pile it sits in.
|
|
55
|
+
*
|
|
56
|
+
* `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
|
|
57
|
+
* lands on 0.9999999999999999, which draws a category that visibly falls short of full.
|
|
58
|
+
*/
|
|
59
|
+
declare function stackOffsets(series: readonly (readonly number[])[], mode: ChartStackMode): readonly (readonly ChartStackOffset[])[];
|
|
60
|
+
/** A label pinned to one reading, so the point it names is legible with no pointer.
|
|
61
|
+
*
|
|
62
|
+
* @internal */
|
|
63
|
+
interface ChartAnnotationMark {
|
|
64
|
+
readonly key: string;
|
|
65
|
+
readonly label: string;
|
|
66
|
+
readonly x: number;
|
|
67
|
+
readonly y: number;
|
|
68
|
+
readonly anchor: 'start' | 'middle' | 'end';
|
|
69
|
+
}
|
|
70
|
+
/** Places a label against each reading it names.
|
|
71
|
+
*
|
|
72
|
+
* @internal */
|
|
73
|
+
declare function annotationMarks(readings: readonly {
|
|
74
|
+
key: string;
|
|
75
|
+
label: string;
|
|
76
|
+
x: number;
|
|
77
|
+
y: number;
|
|
78
|
+
}[], plotWidth: number): readonly ChartAnnotationMark[];
|
|
79
|
+
/** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
|
|
80
|
+
* shares of the category total under `'normalized'`.
|
|
81
|
+
*/
|
|
82
|
+
interface ChartStackOffset {
|
|
83
|
+
readonly from: number;
|
|
84
|
+
readonly to: number;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
|
|
88
|
+
* sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
|
|
89
|
+
* the length it says it is, at every card width. The gutters outside it carry the axis labels. */
|
|
90
|
+
interface ChartPlot {
|
|
91
|
+
readonly width: number;
|
|
92
|
+
readonly height: number;
|
|
93
|
+
readonly left: number;
|
|
94
|
+
readonly top: number;
|
|
95
|
+
}
|
|
96
|
+
/** What `ds-chart` offers the marks projected into it: one shared coordinate space, one shared
|
|
97
|
+
* value domain, and one shared idea of which category the reader is on.
|
|
98
|
+
*
|
|
99
|
+
* A mark injects the token, reports the values it intends to draw, and reads its coordinates
|
|
100
|
+
* back. It never sees the other marks, and the container never learns what kind of mark it is
|
|
101
|
+
* holding - which is what lets a reference line, a bar series and an annotation share an axis
|
|
102
|
+
* without any of them importing the others. */
|
|
103
|
+
interface ChartScales {
|
|
104
|
+
readonly categories: Signal<readonly string[]>;
|
|
105
|
+
readonly plot: Signal<ChartPlot>;
|
|
106
|
+
/** The CENTRE of a category's band. A mark with a width of its own subtracts half of
|
|
107
|
+
* `bandWidth` to reach its leading edge. */
|
|
108
|
+
readonly xPosition: Signal<(index: number) => number>;
|
|
109
|
+
/** Clamped into the plot, so a value outside the drawn domain lands on an edge rather than
|
|
110
|
+
* over the axis labels. */
|
|
111
|
+
readonly yPosition: Signal<(value: number) => number>;
|
|
112
|
+
readonly bandWidth: Signal<number>;
|
|
113
|
+
/** The rectangle a secondary-axis mark draws in. The same one as `plot` unless the two axes are
|
|
114
|
+
* stacked, where it is the lower of the two plots. */
|
|
115
|
+
readonly secondaryPlot: Signal<ChartPlot>;
|
|
116
|
+
/** `yPosition` for the second value axis. Identical to it while no mark has reported against
|
|
117
|
+
* that axis, so a mark may read it without first asking whether one exists. */
|
|
118
|
+
readonly secondaryYPosition: Signal<(value: number) => number>;
|
|
119
|
+
readonly hasSecondaryAxis: Signal<boolean>;
|
|
120
|
+
/** The y of value zero, which is the baseline a bar grows from and the line a signed domain
|
|
121
|
+
* is read against. */
|
|
122
|
+
readonly zeroOffset: Signal<number>;
|
|
123
|
+
/** The category under the pointer or the keyboard, or `-1` for none. */
|
|
124
|
+
readonly activeIndex: Signal<number>;
|
|
125
|
+
/** The band drawn over the active category, for a mark that anchors a panel to the CATEGORY
|
|
126
|
+
* rather than to one of its own marks. `null` while `cursor` is off or nothing is active. */
|
|
127
|
+
readonly cursorOrigin: Signal<Element | null>;
|
|
128
|
+
/** Where the pointer last was, in client pixels, for a mark that anchors a panel to the cursor
|
|
129
|
+
* rather than to a reading. `null` while `cursor` is off or the pointer has left. */
|
|
130
|
+
readonly cursorPointer: Signal<{
|
|
131
|
+
readonly x: number;
|
|
132
|
+
readonly y: number;
|
|
133
|
+
} | null>;
|
|
134
|
+
setActiveIndex(index: number): void;
|
|
135
|
+
/** Contributes values to the shared domain under an id the caller owns. Reporting again with
|
|
136
|
+
* the same id replaces that contribution.
|
|
137
|
+
*
|
|
138
|
+
* Call it from an `effect`: a mark whose values come from a required `input` cannot read them
|
|
139
|
+
* in its constructor, and the effect is also what re-reports when they change. */
|
|
140
|
+
reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
|
|
141
|
+
/** Withdraws a contribution, which a mark does in `ngOnDestroy`. */
|
|
142
|
+
releaseDomain(id: string): void;
|
|
143
|
+
}
|
|
144
|
+
declare const CHART_SCALES: InjectionToken<ChartScales>;
|
|
145
|
+
|
|
146
|
+
declare class ChartComponent implements ChartScales {
|
|
147
|
+
/** The category axis. Every projected mark is positioned against this list, so its length is
|
|
148
|
+
* what decides how many bands the plot has. */
|
|
149
|
+
readonly categories: _angular_core.InputSignal<readonly string[]>;
|
|
150
|
+
/** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
|
|
151
|
+
* the axis may carry one more or one fewer. */
|
|
152
|
+
readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
153
|
+
/** Pins the floor of the value axis instead of deriving it from the marks. It only ever opens
|
|
154
|
+
* the axis further: a floor above the data would push readings off the plot. */
|
|
155
|
+
readonly min: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
156
|
+
/** Pins the ceiling of the value axis. See `min`. Two charts drawn one subject at a time are
|
|
157
|
+
* only comparable when both are pinned. */
|
|
158
|
+
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
159
|
+
/** Draws a band and a crosshair down the category under the pointer, and reports that category
|
|
160
|
+
* to every mark through `activeIndex`. `'none'`, the default, leaves the plot alone: a chart
|
|
161
|
+
* whose marks are the hover targets already answers per mark, and two affordances on one plot
|
|
162
|
+
* read as two different questions. */
|
|
163
|
+
readonly cursor: _angular_core.InputSignal<"none" | "category">;
|
|
164
|
+
/** Whether a press holds the category cursor where it is, so the reader can look away from the
|
|
165
|
+
* plot with the comparison still on screen. Released by pressing it again, by Escape, or by a
|
|
166
|
+
* press outside the plot. */
|
|
167
|
+
readonly cursorPin: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
168
|
+
/** Milliseconds the cursor survives the pointer leaving the plot. The tooltip panel is portaled
|
|
169
|
+
* out of the plot, so without a grace period it closes before the pointer can reach it. */
|
|
170
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
171
|
+
/** Pins the ceiling of the SECOND value axis, the way `max` pins the first. Two plots read
|
|
172
|
+
* against each other need both pinned, or the second rescales under them. */
|
|
173
|
+
readonly maxSecondary: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
174
|
+
/** Height of the plot itself, in CSS pixels, axis labels and value headroom excluded. Real
|
|
175
|
+
* pixels rather than a share of the width: one viewBox unit is one pixel, so a card that
|
|
176
|
+
* widens spreads the categories further apart and leaves the plot exactly this tall. */
|
|
177
|
+
readonly plotHeight: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
178
|
+
/** Width in CSS pixels of the gutter down the left that carries the value-axis labels. Widen it
|
|
179
|
+
* for long tick labels; the plot takes whatever is left. */
|
|
180
|
+
readonly axisGutter: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
181
|
+
/** Pixels reserved for a value label at each end of the plot: above the top tick for a mark at
|
|
182
|
+
* the ceiling, and below the baseline for a negative mark, whose label would otherwise print
|
|
183
|
+
* over the category labels. Reserved whether or not a mark draws one, because a chart that
|
|
184
|
+
* gains a label on one value must not change height. */
|
|
185
|
+
readonly valueSpace: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
186
|
+
/** Printed above the plot as the chart's visible title. */
|
|
187
|
+
readonly caption: _angular_core.InputSignal<string | null>;
|
|
188
|
+
/** Whether the projected marks answer to the pointer and the keyboard. The container draws no
|
|
189
|
+
* marks of its own and only reads this for the plot's role: a group of controls to step
|
|
190
|
+
* through, against a single image to be described. */
|
|
191
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
192
|
+
/** Accessible name for the plot. The container holds no readings of its own, so a chart that
|
|
193
|
+
* needs its numbers described supplies the sentence here - `describeSeries` is what the five
|
|
194
|
+
* presets build it with. It is the whole label in the static case, where nothing else is
|
|
195
|
+
* reachable. */
|
|
196
|
+
readonly summary: _angular_core.InputSignal<string | null>;
|
|
197
|
+
/** Whether the chart draws its own bordered, padded box. `'auto'`, the default, draws it;
|
|
198
|
+
* `'none'` leaves it bare, for one placed inside a card the page has already drawn. Unset
|
|
199
|
+
* falls back to `DS_CONFIG.chart.frame`, then `'auto'`. */
|
|
200
|
+
readonly frame: _angular_core.InputSignal<ChartFrame | null>;
|
|
201
|
+
/** Draws a placeholder in place of the plot, at the plot's own height, so the page does not
|
|
202
|
+
* resize when the data lands. */
|
|
203
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
204
|
+
/** Shown in place of the plot when `categories` is empty. Unset falls back to
|
|
205
|
+
* `DS_CONFIG.chart.emptyText`, then `'No data'`. */
|
|
206
|
+
readonly emptyText: _angular_core.InputSignal<string | null>;
|
|
207
|
+
/** Shows `errorText` in place of the plot. Separate from `loading` and from an empty
|
|
208
|
+
* `categories`, because "the request failed" and "there is nothing to show" read the same to a
|
|
209
|
+
* reader and mean opposite things. */
|
|
210
|
+
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
211
|
+
/** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
|
|
212
|
+
* `'Could not load the data'`. */
|
|
213
|
+
readonly errorText: _angular_core.InputSignal<string | null>;
|
|
214
|
+
/** Formats the value-axis ticks. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the
|
|
215
|
+
* browser's locale grouping with a K/M/B suffix past four digits. */
|
|
216
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
|
|
217
|
+
/** How the second value axis relates to the first, once a mark has reported against it. The
|
|
218
|
+
* same four words `ds-line-chart` takes. */
|
|
219
|
+
readonly secondaryAxisMode: _angular_core.InputSignal<ChartAxisMode>;
|
|
220
|
+
/** Paints the first axis's tick labels in the colour of the marks measured against it. A
|
|
221
|
+
* two-scale plot is ambiguous without it - nothing on the canvas says which of two lines is
|
|
222
|
+
* read against which set of numbers - and it is the author, not the container, who knows which
|
|
223
|
+
* colour an axis belongs to, because several marks can share one. */
|
|
224
|
+
readonly axisColor: _angular_core.InputSignal<string | null>;
|
|
225
|
+
/** `axisColor` for the second axis. */
|
|
226
|
+
readonly secondaryAxisColor: _angular_core.InputSignal<string | null>;
|
|
227
|
+
/** Names the first axis's unit beside it. On a two-scale plot the colour says which line reads
|
|
228
|
+
* which axis and this says what the numbers ARE - a reader who has neither is left comparing
|
|
229
|
+
* two quantities that may not be comparable at all. */
|
|
230
|
+
readonly axisLabel: _angular_core.InputSignal<string | null>;
|
|
231
|
+
/** `axisLabel` for the second axis. */
|
|
232
|
+
readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
|
|
233
|
+
private readonly defaults;
|
|
234
|
+
readonly frameResolved: Signal<ChartFrame>;
|
|
235
|
+
readonly emptyTextResolved: Signal<string>;
|
|
236
|
+
readonly errorTextResolved: Signal<string>;
|
|
237
|
+
readonly valueFormatResolved: Signal<typeof _ids_group_ltd_ids_design_system_components.defaultChartFormat>;
|
|
238
|
+
private readonly host;
|
|
239
|
+
/** The `<svg>`'s own rendered width: `:host(.framed)` carries the frame padding, so the host's
|
|
240
|
+
* CONTENT box - which is what a `ResizeObserver` reports - is the box the canvas fills at
|
|
241
|
+
* `inline-size: 100%`. Measuring the host is therefore measuring the canvas. */
|
|
242
|
+
private readonly measuredWidth;
|
|
243
|
+
protected readonly viewWidth: Signal<number>;
|
|
244
|
+
/** Whether the marks may animate yet. The first frame draws at `CHART_FALLBACK_WIDTH` scaled to
|
|
245
|
+
* fit, so the measurement that follows moves every mark - and a mark that transitions its
|
|
246
|
+
* geometry would play that correction as an animated slide on every load, hydration included.
|
|
247
|
+
*
|
|
248
|
+
* Two frames, not one. A transition starts when the property changes in a style that also
|
|
249
|
+
* enables it, so the enabling must not land in the same style recalculation as the correction.
|
|
250
|
+
* One `requestAnimationFrame` is not enough: scheduled from the change detection that writes
|
|
251
|
+
* the corrected geometry, it runs at the START of the next frame, still before that geometry
|
|
252
|
+
* has been through a recalculation. Measured with one frame: `transitionrun` on `x` and
|
|
253
|
+
* `width`, both marks, on the same tick the class cleared. */
|
|
254
|
+
protected readonly settled: _angular_core.WritableSignal<boolean>;
|
|
255
|
+
constructor();
|
|
256
|
+
private widestLabel;
|
|
257
|
+
/** Two plots, one above the other, sharing the category axis: the only mode whose second axis
|
|
258
|
+
* is a second PLOT rather than a second scale over the first. */
|
|
259
|
+
protected readonly stacked: Signal<boolean>;
|
|
260
|
+
protected readonly viewHeight: Signal<number>;
|
|
261
|
+
/** One viewBox unit is one CSS pixel, in both axes. That is the whole point of measuring: a
|
|
262
|
+
* radius, a gutter or a width cap set anywhere inside the plot is then the length it says it
|
|
263
|
+
* is, at every card width, instead of a share of one that a fixed viewBox stretches. */
|
|
264
|
+
protected readonly viewBox: Signal<string>;
|
|
265
|
+
/** Widest tick label actually rendered, in the CSS pixels the canvas is drawn in. Zero until the
|
|
266
|
+
* first read, and zero under SSR, where `axisGutter` alone decides. */
|
|
267
|
+
private readonly measuredLabelWidth;
|
|
268
|
+
/** The widest category label as drawn, which is what decides whether they all fit. */
|
|
269
|
+
private readonly measuredCategoryLabelWidth;
|
|
270
|
+
/** `axisGutter` is the FLOOR, not the answer: a compact number is far wider in some locales than
|
|
271
|
+
* in others - `3,5 тыс.` against `3.5k` - and an SVG canvas CLIPS what a DOM column merely
|
|
272
|
+
* overflowed, so a fixed gutter silently eats the leading digit. The gutter takes whichever is
|
|
273
|
+
* larger, so setting the token still guarantees at least that much room.
|
|
274
|
+
*
|
|
275
|
+
* This converges rather than oscillating: a tick's TEXT is decided by the domain and the tick
|
|
276
|
+
* count, neither of which the gutter feeds, so widening it moves the labels without rewriting
|
|
277
|
+
* them and the second measurement equals the first. */
|
|
278
|
+
protected readonly effectiveAxisGutter: Signal<number>;
|
|
279
|
+
/** Widest secondary tick label, measured the same way and for the same reason as the primary
|
|
280
|
+
* one: those labels sit OUTSIDE the plot's right edge and an SVG canvas clips what a DOM
|
|
281
|
+
* column merely overflowed. */
|
|
282
|
+
private readonly measuredSecondaryLabelWidth;
|
|
283
|
+
/** The plot gives the right-hand labels room only when they are drawn there - a stacked second
|
|
284
|
+
* axis puts both label columns down the left, so the plot keeps the full width. */
|
|
285
|
+
protected readonly rightGutter: Signal<number>;
|
|
286
|
+
readonly plot: Signal<ChartPlot>;
|
|
287
|
+
readonly secondaryPlot: Signal<ChartPlot>;
|
|
288
|
+
private readonly reportedDomains;
|
|
289
|
+
reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
|
|
290
|
+
private valuesOn;
|
|
291
|
+
releaseDomain(id: string): void;
|
|
292
|
+
/** Compared by value, which is what stops a mark that reports AND reads `yPosition()` in one
|
|
293
|
+
* effect from running forever: every report allocates a fresh `Map` and `niceDomain` a fresh
|
|
294
|
+
* object, so identity always differs and the read would re-arm the write. Measured without it:
|
|
295
|
+
* 97507 effect runs in 45 seconds, no Angular loop error, renderer unresponsive. */
|
|
296
|
+
protected readonly domain: Signal<_ids_group_ltd_ids_design_system_components.NiceDomain>;
|
|
297
|
+
readonly hasSecondaryAxis: Signal<boolean>;
|
|
298
|
+
protected readonly secondary: Signal<SecondaryAxis>;
|
|
299
|
+
readonly secondaryYPosition: Signal<(value: number) => number>;
|
|
300
|
+
protected readonly secondaryTicks: Signal<{
|
|
301
|
+
value: number;
|
|
302
|
+
y: number;
|
|
303
|
+
label: string;
|
|
304
|
+
}[]>;
|
|
305
|
+
/** A second set of gridlines only where the two scales do NOT share rows: drawn against an
|
|
306
|
+
* aligned axis they would land on the primary's own lines and double every stroke. */
|
|
307
|
+
protected readonly showSecondaryGridlines: Signal<boolean>;
|
|
308
|
+
protected readonly secondaryLabelX: Signal<number>;
|
|
309
|
+
protected readonly secondaryLabelAnchor: Signal<"start" | "end">;
|
|
310
|
+
protected readonly secondaryPlotBottom: Signal<number>;
|
|
311
|
+
/** No tint on a single-scale plot: one axis needs no telling apart, and colouring it would only
|
|
312
|
+
* restate the marks' own colour in the furniture. */
|
|
313
|
+
protected readonly axisLabelFill: Signal<string | null>;
|
|
314
|
+
protected readonly secondaryAxisLabelFill: Signal<string | null>;
|
|
315
|
+
private readonly bands;
|
|
316
|
+
readonly bandWidth: Signal<number>;
|
|
317
|
+
readonly xPosition: Signal<(index: number) => number>;
|
|
318
|
+
readonly yPosition: Signal<(value: number) => number>;
|
|
319
|
+
readonly zeroOffset: Signal<number>;
|
|
320
|
+
protected readonly cursorBand: Signal<{
|
|
321
|
+
x: number;
|
|
322
|
+
width: number;
|
|
323
|
+
top: number;
|
|
324
|
+
bottom: number;
|
|
325
|
+
} | null>;
|
|
326
|
+
/** The same state machine the element marks run on: pin, linger, the grace period that lets the
|
|
327
|
+
* pointer reach a portaled panel, Escape and press-outside. A category cursor differs from a
|
|
328
|
+
* mark only in what the index counts, so it takes the behaviour rather than restating it. */
|
|
329
|
+
private readonly cursorState;
|
|
330
|
+
readonly activeIndex: Signal<number>;
|
|
331
|
+
private readonly pointerAt;
|
|
332
|
+
readonly cursorPointer: Signal<{
|
|
333
|
+
x: number;
|
|
334
|
+
y: number;
|
|
335
|
+
} | null>;
|
|
336
|
+
/** Whether the cursor is held. A preset renders its own way out of the pin from this. */
|
|
337
|
+
readonly cursorPinned: Signal<boolean>;
|
|
338
|
+
releaseCursor(): void;
|
|
339
|
+
protected onPlotPointer(event: PointerEvent): void;
|
|
340
|
+
protected clearCursor(): void;
|
|
341
|
+
private readonly bandElement;
|
|
342
|
+
readonly cursorOrigin: Signal<Element | null>;
|
|
343
|
+
setActiveIndex(index: number): void;
|
|
344
|
+
private clampIndex;
|
|
345
|
+
protected readonly plotRight: Signal<number>;
|
|
346
|
+
protected readonly plotBottom: Signal<number>;
|
|
347
|
+
protected readonly axisLabelX: Signal<number>;
|
|
348
|
+
/** Clears the same reservation the view height budgets, and only when it is there: adding it
|
|
349
|
+
* unconditionally would drop the labels past a viewBox that no longer holds the space. */
|
|
350
|
+
protected readonly categoryLabelY: Signal<number>;
|
|
351
|
+
protected readonly ticks: Signal<{
|
|
352
|
+
value: number;
|
|
353
|
+
y: number;
|
|
354
|
+
label: string;
|
|
355
|
+
}[]>;
|
|
356
|
+
/** Rotation is spent before thinning: a tilt costs the reader a glance, dropping a label costs
|
|
357
|
+
* them a reading. Both are decided from the widest label as it actually rendered. */
|
|
358
|
+
protected readonly categoryLabelsRotated: Signal<boolean>;
|
|
359
|
+
private readonly categoryLabelInterval;
|
|
360
|
+
protected readonly categoryLabels: Signal<{
|
|
361
|
+
x: number;
|
|
362
|
+
text: string;
|
|
363
|
+
index: number;
|
|
364
|
+
}[]>;
|
|
365
|
+
protected readonly reachesBelowZero: Signal<boolean>;
|
|
366
|
+
/** Empty is read off `categories` alone, never off the reported domains: the marks are
|
|
367
|
+
* projected INTO the branch that this decides, so a container that waited for a report before
|
|
368
|
+
* rendering them would never receive one. */
|
|
369
|
+
protected readonly isEmpty: Signal<boolean>;
|
|
370
|
+
protected readonly accessibleName: Signal<string>;
|
|
371
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
|
|
372
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
interface ColumnSeriesPoint {
|
|
376
|
+
id?: string;
|
|
377
|
+
label: string;
|
|
378
|
+
value: number;
|
|
379
|
+
color?: string;
|
|
380
|
+
fill?: 'solid' | 'hatched';
|
|
381
|
+
}
|
|
382
|
+
/**
|
|
383
|
+
* One column per datum, drawn against the scales `ds-chart` supplies.
|
|
384
|
+
*
|
|
385
|
+
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
386
|
+
* know is not rendered, and neither are its descendants, so `<ds-column-series>` inside the
|
|
387
|
+
* container's canvas would draw nothing. Written as `<svg:g dsColumnSeries>`.
|
|
388
|
+
*/
|
|
389
|
+
declare class ColumnSeriesComponent implements OnDestroy {
|
|
390
|
+
private readonly scales;
|
|
391
|
+
/** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
|
|
392
|
+
* element, and a required input throws NG0950 for the pass before its own value is written. */
|
|
393
|
+
readonly data: _angular_core.InputSignal<readonly ColumnSeriesPoint[]>;
|
|
394
|
+
/** Prints each column's value above the column. */
|
|
395
|
+
readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
396
|
+
/** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
|
|
397
|
+
* fires whether or not this is set. */
|
|
398
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
399
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
|
|
400
|
+
* press outside releases it. Pinning is a state, not a handler. */
|
|
401
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
402
|
+
/** Fades every mark but the one under the pointer. Off by default: the dimming buys loudness
|
|
403
|
+
* for one mark and pays for it with the separation between the rest. */
|
|
404
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
405
|
+
/** Milliseconds between one mark's entrance and the next. The total is capped, so a long
|
|
406
|
+
* series does not crawl in. */
|
|
407
|
+
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
408
|
+
/** Declares that the marks are parts of one whole, which is what makes a share of their total
|
|
409
|
+
* a real quantity. On, each mark's share appears on the tooltip's second line. */
|
|
410
|
+
readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
411
|
+
/** Whether a hovered or focused column opens a tooltip. */
|
|
412
|
+
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
413
|
+
/** Where the tooltip is pinned. `'mark'` is the column itself; `'cell'` is the full-height
|
|
414
|
+
* category cell, which puts the panel at the top of the plot whatever the column's value. */
|
|
415
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
|
|
416
|
+
/** How long the panel survives the pointer leaving the mark. Raise it only for a panel a
|
|
417
|
+
* reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
|
|
418
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
419
|
+
/** Formats every value this series prints. Called with `'tick'` for an axis label and
|
|
420
|
+
* `'tooltip'` everywhere a value is printed in full. */
|
|
421
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
|
|
422
|
+
/** The mark's share of its category's own slot, before the maximum width caps it. Measured off
|
|
423
|
+
* the slot rather than off `bandWidth()`, which has the container's own padding already taken
|
|
424
|
+
* out of it - applying both would narrow every uncapped column twice. */
|
|
425
|
+
readonly columnWidthRatio: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
426
|
+
/** This series' position among the slots a category's band is divided into. */
|
|
427
|
+
readonly slot: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
428
|
+
/** How many slots the band is divided into - the number of series drawn side by side. One, the
|
|
429
|
+
* default, is the whole band, which is what a single series has always taken. */
|
|
430
|
+
readonly slotCount: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
431
|
+
/** Where each mark starts and ends on the value axis, one entry per point. Unset, every mark
|
|
432
|
+
* runs from zero to its own value, which is the unstacked case. */
|
|
433
|
+
readonly offsets: _angular_core.InputSignal<readonly ChartStackOffset[] | null>;
|
|
434
|
+
/** One colour for the whole series, which is what several series drawn together need. Unset,
|
|
435
|
+
* each mark takes the categorical palette by its own position - the right reading when the
|
|
436
|
+
* marks ARE the categories, which is the single-series case. A point's own colour wins over
|
|
437
|
+
* both. */
|
|
438
|
+
readonly seriesColor: _angular_core.InputSignal<string | null>;
|
|
439
|
+
/** `seriesColor` for the fill pattern. A point's own `fill` wins. */
|
|
440
|
+
readonly seriesFill: _angular_core.InputSignal<"solid" | "hatched" | null>;
|
|
441
|
+
/** Names the series in the tooltip, where the category then becomes the panel's heading. Unset,
|
|
442
|
+
* the panel names the category instead, which is what a chart of one series has to say. */
|
|
443
|
+
readonly seriesLabel: _angular_core.InputSignal<string | null>;
|
|
444
|
+
/** The clicked datum. Fires on click and on Enter or Space, whatever `interactive` says. */
|
|
445
|
+
readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
|
|
446
|
+
private readonly seriesId;
|
|
447
|
+
private readonly domainId;
|
|
448
|
+
/** Per instance: two charts on one page would otherwise share the first `<pattern>` to reach the
|
|
449
|
+
* document, and every hatched mark would take that chart's colour. */
|
|
450
|
+
protected readonly hatchId: string;
|
|
451
|
+
/** Where each mark actually spans, which is what the axis has to hold: a stacked segment's top
|
|
452
|
+
* is its category's running total, not its own reading. */
|
|
453
|
+
private readonly spans;
|
|
454
|
+
constructor();
|
|
455
|
+
ngOnDestroy(): void;
|
|
456
|
+
readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
457
|
+
/** One SERIES' slot inside a category's band: the whole band while a chart draws one series,
|
|
458
|
+
* a share of it per series when several are grouped. The box that catches the pointer is sized
|
|
459
|
+
* from this rather than from the drawn column, so a short column stays reachable. */
|
|
460
|
+
private readonly slotStep;
|
|
461
|
+
protected readonly slotStepPx: _angular_core.Signal<string>;
|
|
462
|
+
protected readonly markWidthPx: _angular_core.Signal<string>;
|
|
463
|
+
/** The whole canvas, reserved end included. Overshooting when the container drops that
|
|
464
|
+
* reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
|
|
465
|
+
* strip under the plot that answers no pointer. */
|
|
466
|
+
protected readonly hitHeight: _angular_core.Signal<number>;
|
|
467
|
+
protected readonly pinDiscRadius = 11;
|
|
468
|
+
protected readonly pinGlyphSize = 14;
|
|
469
|
+
protected readonly pinGlyphOffset: number;
|
|
470
|
+
protected readonly pinGlyph: SafeHtml;
|
|
471
|
+
protected readonly marks: _angular_core.Signal<{
|
|
472
|
+
key: string;
|
|
473
|
+
point: ColumnSeriesPoint;
|
|
474
|
+
x: number;
|
|
475
|
+
tip: number;
|
|
476
|
+
below: boolean;
|
|
477
|
+
baseline: number;
|
|
478
|
+
top: number;
|
|
479
|
+
height: number;
|
|
480
|
+
labelY: number;
|
|
481
|
+
pinY: number;
|
|
482
|
+
origin: string;
|
|
483
|
+
formattedValue: string;
|
|
484
|
+
color: string;
|
|
485
|
+
hatched: boolean;
|
|
486
|
+
}[]>;
|
|
487
|
+
protected markStagger(index: number): string;
|
|
488
|
+
protected onMarkClick(payload: ColumnSeriesPoint, index: number, event: Event): void;
|
|
489
|
+
protected onMarkEnter(index: number, event: Event): void;
|
|
490
|
+
/** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
|
|
491
|
+
* every mouse-operable control has to be separately focusable, and that is what keeps a
|
|
492
|
+
* twenty-five mark chart from being twenty-five stops in the page's tab order. */
|
|
493
|
+
protected readonly rovingIndex: _angular_core.WritableSignal<number>;
|
|
494
|
+
protected readonly tabStopIndex: _angular_core.Signal<number>;
|
|
495
|
+
protected onMarkFocus(index: number, event: FocusEvent): void;
|
|
496
|
+
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
497
|
+
protected onPointKey(point: ColumnSeriesPoint, event: Event): void;
|
|
498
|
+
protected entryLabel(mark: {
|
|
499
|
+
point: ColumnSeriesPoint;
|
|
500
|
+
formattedValue: string;
|
|
501
|
+
}): string;
|
|
502
|
+
readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
503
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
|
|
504
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
|
|
505
|
+
}
|
|
506
|
+
|
|
507
|
+
interface LineSeriesData {
|
|
508
|
+
id: string;
|
|
509
|
+
label: string;
|
|
510
|
+
/** One reading per category. A `null` is a missing reading, and `gaps` decides what it draws. */
|
|
511
|
+
data: readonly (number | null)[];
|
|
512
|
+
/** Which value axis the readings are measured against. Defaults to `'primary'`. */
|
|
513
|
+
axis?: ChartAxis;
|
|
514
|
+
/** Fills the band between the line and its axis baseline. */
|
|
515
|
+
area?: boolean;
|
|
516
|
+
/** The band's floor, one entry per category, in the axis's own unit. Unset fills to the
|
|
517
|
+
* baseline. Given, the fill is the band between the two curves - which is what a stacked plot
|
|
518
|
+
* needs, and the caller that owns the pile is the one that knows where each band starts. A
|
|
519
|
+
* `null` must sit in exactly the categories `data` has one, or the two sides break in
|
|
520
|
+
* different places. */
|
|
521
|
+
lower?: readonly (number | null)[];
|
|
522
|
+
/** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
|
|
523
|
+
color?: string;
|
|
524
|
+
}
|
|
525
|
+
/**
|
|
526
|
+
* One line per series, drawn against the scales `ds-chart` supplies, on either of its two value
|
|
527
|
+
* axes.
|
|
528
|
+
*
|
|
529
|
+
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
530
|
+
* know is not rendered, and neither are its descendants. Written as `<svg:g dsLineSeries>`.
|
|
531
|
+
*/
|
|
532
|
+
declare class LineSeriesComponent implements OnDestroy {
|
|
533
|
+
private readonly scales;
|
|
534
|
+
/** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
|
|
535
|
+
* element, and a required input throws NG0950 for the pass before its own value is written. */
|
|
536
|
+
readonly data: _angular_core.InputSignal<readonly LineSeriesData[]>;
|
|
537
|
+
/** Draws a round marker at every reading. Off leaves the line alone, which reads better past
|
|
538
|
+
* roughly twenty points. */
|
|
539
|
+
readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
540
|
+
/** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
|
|
541
|
+
* fires whether or not this is set. */
|
|
542
|
+
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
543
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
|
|
544
|
+
* press outside releases it. Pinning is a state, not a handler. */
|
|
545
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
546
|
+
/** Fades every series but the one under the pointer. Off by default: the dimming buys loudness
|
|
547
|
+
* for one line and pays for it with the separation between the rest. */
|
|
548
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
549
|
+
/** The one series to single out: every other one draws faded and this one draws bold, so the
|
|
550
|
+
* comparison survives a monochrome print. Driven from a legend, or from whatever else the app
|
|
551
|
+
* uses to mean "show me this one". Needs `dimOthers`, which is what says fading is wanted at
|
|
552
|
+
* all. */
|
|
553
|
+
readonly highlighted: _angular_core.InputSignal<string | null>;
|
|
554
|
+
/** A dash pattern per series, in the order the series are given. A series past the end of the
|
|
555
|
+
* list, or given an empty string, draws solid. */
|
|
556
|
+
readonly patterns: _angular_core.InputSignal<readonly string[]>;
|
|
557
|
+
/** Fills each area from the series below it rather than from the baseline, which is what a
|
|
558
|
+
* stacked plot needs and what the fill reads as. */
|
|
559
|
+
readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
560
|
+
/** The dash for a series' position, or null where it draws solid. */
|
|
561
|
+
protected dashFor(seriesIndex: number): string | null;
|
|
562
|
+
/** Milliseconds between one marker's entrance and the next. The total is capped. */
|
|
563
|
+
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
564
|
+
/** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point
|
|
565
|
+
* at zero. A missing measurement and a measured zero are different facts. */
|
|
566
|
+
readonly gaps: _angular_core.InputSignal<ChartGaps>;
|
|
567
|
+
/** How the line joins its readings. `'linear'` by default, which asserts nothing the data does
|
|
568
|
+
* not say; a curve is a claim about what happened BETWEEN two readings. `'step'` holds each
|
|
569
|
+
* reading to the next, `'smooth'` is a monotone cubic that draws no peak the data lacks. */
|
|
570
|
+
readonly curve: _angular_core.InputSignal<ChartCurve>;
|
|
571
|
+
/** Whether a hovered or focused reading opens a tooltip, and for what. `'item'` names the
|
|
572
|
+
* marker itself. `'axis'` names every series at the category under the pointer, which is the
|
|
573
|
+
* reading a multi-series line is compared on - it follows the container's `cursor`, so set
|
|
574
|
+
* `cursor="category"` on `ds-chart` with it or nothing marks the category being read. */
|
|
575
|
+
readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
|
|
576
|
+
/** Where an `'axis'` panel hangs: `'reading'` puts it over the highest reading in the category,
|
|
577
|
+
* so it names what it points at and stays put while the pointer travels within one band;
|
|
578
|
+
* `'pointer'` follows the cursor. */
|
|
579
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
|
|
580
|
+
/** How long the panel survives the pointer leaving the marker. Raise it only for a panel a
|
|
581
|
+
* reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
|
|
582
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
583
|
+
/** Formats every value this series prints. Called with `'tick'` for an axis label and
|
|
584
|
+
* `'tooltip'` everywhere a value is printed in full. */
|
|
585
|
+
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
|
|
586
|
+
/** The clicked reading, with the series it belongs to and its position in `categories`.
|
|
587
|
+
* Fires on click and on Enter or Space, whatever `interactive` says. */
|
|
588
|
+
readonly pointClicked: _angular_core.OutputEmitterRef<{
|
|
589
|
+
series: LineSeriesData;
|
|
590
|
+
categoryIndex: number;
|
|
591
|
+
value: number;
|
|
592
|
+
}>;
|
|
593
|
+
private readonly domainId;
|
|
594
|
+
constructor();
|
|
595
|
+
ngOnDestroy(): void;
|
|
596
|
+
readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
|
|
597
|
+
private valuesOn;
|
|
598
|
+
/** A `null` past the end is the same missing reading as a `null` inside the run, so a series
|
|
599
|
+
* shorter than `categories` ends its line rather than running off the plot's edge. */
|
|
600
|
+
private readingsOf;
|
|
601
|
+
protected readonly plotted: _angular_core.Signal<{
|
|
602
|
+
series: LineSeriesData;
|
|
603
|
+
color: string;
|
|
604
|
+
seriesIndex: number;
|
|
605
|
+
linePaths: string[];
|
|
606
|
+
areaPaths: readonly string[];
|
|
607
|
+
markers: {
|
|
608
|
+
key: string;
|
|
609
|
+
markIndex: number;
|
|
610
|
+
x: number;
|
|
611
|
+
y: number;
|
|
612
|
+
value: number;
|
|
613
|
+
category: string;
|
|
614
|
+
formattedValue: string;
|
|
615
|
+
seriesLabel: string;
|
|
616
|
+
seriesId: string;
|
|
617
|
+
categoryIndex: number;
|
|
618
|
+
color: string;
|
|
619
|
+
}[];
|
|
620
|
+
}[]>;
|
|
621
|
+
private areaPathsFor;
|
|
622
|
+
private readonly allMarkers;
|
|
623
|
+
protected seriesStagger(index: number): string;
|
|
624
|
+
/** One tab stop PER SERIES: each line is a strand the reader walks with the arrows, and the
|
|
625
|
+
* strands are what the chart is comparing. WCAG 2.1.1's Understanding is explicit that not
|
|
626
|
+
* every mouse-operable control has to be separately focusable, which is what keeps a
|
|
627
|
+
* 12-category, 2-series plot from being twenty-four stops in the page's tab order. */
|
|
628
|
+
private readonly rovingBySeries;
|
|
629
|
+
protected isTabStop(seriesId: string, markIndex: number): boolean;
|
|
630
|
+
/** The series a marker holds focus on, which narrows an `'axis'` panel to that one reading: a
|
|
631
|
+
* pointer answers for every series at once, a focused marker answers for its own. */
|
|
632
|
+
private readonly focusedSeries;
|
|
633
|
+
protected onMarkerEnter(markIndex: number, event: Event): void;
|
|
634
|
+
protected onMarkerFocus(markIndex: number, event: FocusEvent): void;
|
|
635
|
+
protected onMarkerBlur(): void;
|
|
636
|
+
protected onMarkerNavigation(event: KeyboardEvent, markIndex: number): void;
|
|
637
|
+
protected isDimmed(seriesId: string): boolean;
|
|
638
|
+
protected onMarkerClick(markIndex: number, event?: Event): void;
|
|
639
|
+
protected markerLabel(marker: {
|
|
640
|
+
seriesLabel: string;
|
|
641
|
+
category: string;
|
|
642
|
+
formattedValue: string;
|
|
643
|
+
}): string;
|
|
644
|
+
readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
645
|
+
private readonly markerElements;
|
|
646
|
+
/** The topmost reading at the active category, as its own element. The cursor band spans the
|
|
647
|
+
* whole plot, so anchoring an `'axis'` panel to it opens the panel at the top of the chart
|
|
648
|
+
* rather than over the readings it is about. */
|
|
649
|
+
private readonly topReadingElement;
|
|
650
|
+
/** Where the panel hangs: the reading or the pointer in `'axis'` mode, the hovered mark
|
|
651
|
+
* otherwise. */
|
|
652
|
+
readonly tooltipOrigin: _angular_core.Signal<ChartTooltipOrigin | null>;
|
|
653
|
+
/** Every series' reading at the category the CONTAINER says is active, which is what the
|
|
654
|
+
* category cursor sets. A series with no reading there contributes no row rather than a
|
|
655
|
+
* blank one. */
|
|
656
|
+
private readonly axisTooltipContext;
|
|
657
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
|
|
658
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
|
|
659
|
+
}
|
|
660
|
+
|
|
661
|
+
/**
|
|
662
|
+
* The names of a chart's reference lines, laid out by the same geometry that draws them.
|
|
663
|
+
*
|
|
664
|
+
* A second element rather than part of `g[dsReferenceLine]`: the strokes belong under the marks
|
|
665
|
+
* and the names over them, and a projected element lands in exactly one of the container's slots.
|
|
666
|
+
* Reports no domain - the line it names already did.
|
|
667
|
+
*/
|
|
668
|
+
declare class ReferenceLabelComponent {
|
|
669
|
+
private readonly scales;
|
|
670
|
+
/** The same list `dsReferenceLine` is given. This mark draws only the labels, so it is placed
|
|
671
|
+
* AFTER the series and the line mark before it, which is what keeps a label legible over a mark
|
|
672
|
+
* that would otherwise cover it. */
|
|
673
|
+
readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
|
|
674
|
+
protected readonly lines: _angular_core.Signal<ThresholdMark[]>;
|
|
675
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceLabelComponent, never>;
|
|
676
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferenceLabelComponent, "g[dsReferenceLabel]", never, { "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
677
|
+
}
|
|
678
|
+
|
|
679
|
+
/**
|
|
680
|
+
* Reference lines and bands across the plot, drawn against the scales `ds-chart` supplies.
|
|
681
|
+
*
|
|
682
|
+
* Strokes only: the LABELS are a second element, `g[dsReferenceLabel]`, because the two belong in
|
|
683
|
+
* different layers of the canvas - a line reads as furniture under the marks, a label has to stay
|
|
684
|
+
* legible over them - and one projected element can only land in one of the container's slots.
|
|
685
|
+
*
|
|
686
|
+
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
687
|
+
* know is not rendered, and neither are its descendants. Written as `<svg:g dsReferenceLine>`.
|
|
688
|
+
*/
|
|
689
|
+
declare class ReferenceLineComponent implements OnDestroy {
|
|
690
|
+
private readonly scales;
|
|
691
|
+
/** The lines and bands to draw across the plot. Each entry is ONE reading, `value`, plus an
|
|
692
|
+
* optional `label`, `color` and `dash`; a `to` makes it a band between two readings. Each one
|
|
693
|
+
* widens the value axis to hold it, so a target above every mark still lands on the plot. */
|
|
694
|
+
readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
|
|
695
|
+
private readonly domainId;
|
|
696
|
+
constructor();
|
|
697
|
+
ngOnDestroy(): void;
|
|
698
|
+
protected readonly lines: _angular_core.Signal<readonly ThresholdMark[]>;
|
|
699
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceLineComponent, never>;
|
|
700
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferenceLineComponent, "g[dsReferenceLine]", never, { "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
701
|
+
}
|
|
702
|
+
|
|
703
|
+
interface ChartAnnotation {
|
|
704
|
+
/** 0-based position along the category axis. */
|
|
705
|
+
readonly categoryIndex: number;
|
|
706
|
+
/** The reading the label names, in the axis's own unit. */
|
|
707
|
+
readonly value: number;
|
|
708
|
+
readonly label: string;
|
|
709
|
+
/** Which value axis the reading is measured against. Defaults to `'primary'`. */
|
|
710
|
+
readonly axis?: ChartAxis;
|
|
711
|
+
}
|
|
712
|
+
/**
|
|
713
|
+
* A tooltip answers "what is this?" on hover; an annotation answers it in a printed page or a
|
|
714
|
+
* screenshot.
|
|
715
|
+
*
|
|
716
|
+
* Takes the readings rather than finding them: a mark never sees the other marks, so the caller
|
|
717
|
+
* that owns the series is the one that knows which value a label belongs to. Reports no domain -
|
|
718
|
+
* the series it annotates already did.
|
|
719
|
+
*/
|
|
720
|
+
declare class SeriesAnnotationComponent {
|
|
721
|
+
private readonly scales;
|
|
722
|
+
readonly annotations: _angular_core.InputSignal<readonly ChartAnnotation[]>;
|
|
723
|
+
protected readonly placed: _angular_core.Signal<readonly _ids_group_ltd_ids_design_system_components_chart.ChartAnnotationMark[]>;
|
|
724
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SeriesAnnotationComponent, never>;
|
|
725
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SeriesAnnotationComponent, "g[dsSeriesAnnotation]", never, { "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
726
|
+
}
|
|
727
|
+
|
|
728
|
+
export { CHART_DEFAULT_VALUE_SPACE, CHART_SCALES, ChartComponent, ColumnSeriesComponent, LineSeriesComponent, ReferenceLabelComponent, ReferenceLineComponent, SeriesAnnotationComponent, annotationMarks, chartViewHeight, stackOffsets };
|
|
729
|
+
export type { ChartAnnotation, ChartAnnotationMark, ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData };
|