@ids-group-ltd/ids-design-system 0.13.3 → 0.14.0
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 +1104 -14
- package/components.md +567 -34
- package/design-system.md +9 -0
- package/docs/agent/INDEX.md +57 -15
- 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 +10 -0
- package/docs/agent/charts/ds-column-chart.md +5 -1
- 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 +4 -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 +5 -1
- 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 +7 -1
- package/docs/agent/forms/ds-textarea.md +6 -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/platform/ds-config.md +2 -1
- 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 +12 -4
- 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 +140 -43
- 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 +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
- 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 +42 -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 +39 -14
- 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 +727 -93
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
- 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 +29 -12
- 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 +25 -24
- 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 +183 -501
- 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 +44 -8
- 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 +22 -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 +382 -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 +322 -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 +6 -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-skeleton.mjs +23 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.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-switch.mjs +20 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +6 -6
- 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 +36 -28
- 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 +23 -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 +361 -17
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +2 -3
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +7 -3
- 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 +5 -2
- 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 +32 -10
- package/migrations/0.13.4.json +2492 -0
- package/migrations/0.14.0.json +591 -0
- package/migrations/0.5.0.json +11 -5
- package/migrations/0.7.0.json +5 -2
- package/migrations/0.8.0.json +4 -3
- package/migrations/0.9.0.json +6 -3
- package/migrations/README.md +7 -2
- package/package.json +41 -9
- package/styles/_chart-frame.scss +19 -6
- package/styles/_chart-motion.scss +17 -10
- 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 +15 -7
- package/styles/_skeleton-shimmer.scss +4 -1
- package/styles/_table-controls.scss +3 -3
- package/styles/_tokens-charts.scss +40 -7
- 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 +40 -9
- 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 +8 -4
- package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +34 -0
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +15 -3
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +345 -60
- 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 +8 -2
- 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 +8 -7
- 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 +88 -139
- package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +4 -0
- 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 +18 -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} +25 -23
- 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 +189 -0
- package/types/ids-group-ltd-ids-design-system-components-search.d.ts +2 -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-skeleton.d.ts +1 -0
- package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +10 -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 +44 -33
- package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +13 -0
- 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 +142 -6
- package/types/ids-group-ltd-ids-design-system-core.d.ts +42 -10
- package/types/ids-group-ltd-ids-design-system.d.ts +14 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +0 -382
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +0 -1
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
|
|
2
|
-
import { NiceDomain,
|
|
3
|
-
import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, 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';
|
|
2
|
+
import { NiceDomain, leaveMark } 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';
|
|
6
4
|
import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
7
|
-
import { ChartItemTooltipTrigger,
|
|
5
|
+
import { ChartTooltipContext, ChartTooltipOrigin, ChartTooltipEntry, ChartItemTooltipTrigger, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
|
|
6
|
+
import * as _angular_core from '@angular/core';
|
|
7
|
+
import { InjectionToken, Signal, TemplateRef, OnDestroy } from '@angular/core';
|
|
8
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';
|
|
9
10
|
|
|
11
|
+
declare const CHART_DEFAULT_VALUE_SPACE = 20;
|
|
10
12
|
/** The viewBox's height, and the `<svg>`'s rendered height in pixels - the two are the same
|
|
11
13
|
* number, which is what holds the 1:1 scale on the vertical axis too.
|
|
12
14
|
*
|
|
@@ -44,14 +46,6 @@ interface SecondaryAxis {
|
|
|
44
46
|
* one set of gridlines rather than two crossing each other. */
|
|
45
47
|
readonly aligned: boolean;
|
|
46
48
|
}
|
|
47
|
-
/** Where one series' segment starts and ends on the value axis, in the axis's own unit - or in
|
|
48
|
-
* shares of the category total under `'normalized'`.
|
|
49
|
-
*
|
|
50
|
-
* @internal */
|
|
51
|
-
interface ChartStackOffset {
|
|
52
|
-
readonly from: number;
|
|
53
|
-
readonly to: number;
|
|
54
|
-
}
|
|
55
49
|
/** Every segment's span on the value axis, series-major: `offsets[series][category]`.
|
|
56
50
|
*
|
|
57
51
|
* `'none'` and `'grouped'` give every series the same span it would have alone - the two differ in
|
|
@@ -61,10 +55,48 @@ interface ChartStackOffset {
|
|
|
61
55
|
*
|
|
62
56
|
* `'normalized'` divides a running SUM rather than each share in turn: adding 20/60 to 40/60
|
|
63
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.
|
|
64
61
|
*
|
|
65
62
|
* @internal */
|
|
66
|
-
|
|
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
|
+
}
|
|
67
86
|
|
|
87
|
+
/** What a mark hands the container so the container can open the panel for it. The mark decides
|
|
88
|
+
* WHAT the panel says and WHERE it points; the container decides that there is one, which is what
|
|
89
|
+
* keeps a plot from opening two. */
|
|
90
|
+
interface ChartTooltipSource {
|
|
91
|
+
readonly context: Signal<ChartTooltipContext | null>;
|
|
92
|
+
readonly origin: Signal<ChartTooltipOrigin | null>;
|
|
93
|
+
/** Flips the panel under the mark, for a held reading whose own value label sits above it. */
|
|
94
|
+
readonly preferBelow?: Signal<boolean>;
|
|
95
|
+
/** What this mark reads at the category the cursor is on, whatever its own tooltip setting. A
|
|
96
|
+
* category panel names every series at that category, and a mark that answers per-mark still
|
|
97
|
+
* belongs in it. */
|
|
98
|
+
readonly axisEntries?: Signal<readonly ChartTooltipEntry[]>;
|
|
99
|
+
}
|
|
68
100
|
/** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
|
|
69
101
|
* sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
|
|
70
102
|
* the length it says it is, at every card width. The gutters outside it carry the axis labels. */
|
|
@@ -84,6 +116,10 @@ interface ChartPlot {
|
|
|
84
116
|
interface ChartScales {
|
|
85
117
|
readonly categories: Signal<readonly string[]>;
|
|
86
118
|
readonly plot: Signal<ChartPlot>;
|
|
119
|
+
/** Whether the plot has its real width yet. Until it does, the scales describe a stand-in width
|
|
120
|
+
* that the first measurement replaces, so a mark that waits for this builds its geometry once
|
|
121
|
+
* instead of twice. Absent means always measured. */
|
|
122
|
+
readonly measured?: Signal<boolean>;
|
|
87
123
|
/** The CENTRE of a category's band. A mark with a width of its own subtracts half of
|
|
88
124
|
* `bandWidth` to reach its leading edge. */
|
|
89
125
|
readonly xPosition: Signal<(index: number) => number>;
|
|
@@ -103,6 +139,15 @@ interface ChartScales {
|
|
|
103
139
|
readonly zeroOffset: Signal<number>;
|
|
104
140
|
/** The category under the pointer or the keyboard, or `-1` for none. */
|
|
105
141
|
readonly activeIndex: Signal<number>;
|
|
142
|
+
/** The band drawn over the active category, for a mark that anchors a panel to the CATEGORY
|
|
143
|
+
* rather than to one of its own marks. `null` while `cursor` is off or nothing is active. */
|
|
144
|
+
readonly cursorOrigin: Signal<Element | null>;
|
|
145
|
+
/** Where the pointer last was, in client pixels, for a mark that anchors a panel to the cursor
|
|
146
|
+
* rather than to a reading. `null` while `cursor` is off or the pointer has left. */
|
|
147
|
+
readonly cursorPointer: Signal<{
|
|
148
|
+
readonly x: number;
|
|
149
|
+
readonly y: number;
|
|
150
|
+
} | null>;
|
|
106
151
|
setActiveIndex(index: number): void;
|
|
107
152
|
/** Contributes values to the shared domain under an id the caller owns. Reporting again with
|
|
108
153
|
* the same id replaces that contribution.
|
|
@@ -112,6 +157,10 @@ interface ChartScales {
|
|
|
112
157
|
reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
|
|
113
158
|
/** Withdraws a contribution, which a mark does in `ngOnDestroy`. */
|
|
114
159
|
releaseDomain(id: string): void;
|
|
160
|
+
/** Offers the container a panel to open while this mark is the active one. Reporting again with
|
|
161
|
+
* the same id replaces the offer. */
|
|
162
|
+
reportTooltip(id: string, source: ChartTooltipSource): void;
|
|
163
|
+
releaseTooltip(id: string): void;
|
|
115
164
|
}
|
|
116
165
|
declare const CHART_SCALES: InjectionToken<ChartScales>;
|
|
117
166
|
|
|
@@ -128,6 +177,21 @@ declare class ChartComponent implements ChartScales {
|
|
|
128
177
|
/** Pins the ceiling of the value axis. See `min`. Two charts drawn one subject at a time are
|
|
129
178
|
* only comparable when both are pinned. */
|
|
130
179
|
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
180
|
+
/** Draws a band and a crosshair down the category under the pointer, and reports that category
|
|
181
|
+
* to every mark through `activeIndex`. `'none'`, the default, leaves the plot alone: a chart
|
|
182
|
+
* whose marks are the hover targets already answers per mark, and two affordances on one plot
|
|
183
|
+
* read as two different questions. */
|
|
184
|
+
readonly cursor: _angular_core.InputSignal<"none" | "category">;
|
|
185
|
+
/** Whether a press holds the category cursor where it is, so the reader can look away from the
|
|
186
|
+
* plot with the comparison still on screen. Released by pressing it again, by Escape, or by a
|
|
187
|
+
* press outside the plot. */
|
|
188
|
+
readonly cursorPin: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
189
|
+
/** Milliseconds the cursor survives the pointer leaving the plot. The tooltip panel is portaled
|
|
190
|
+
* out of the plot, so without a grace period it closes before the pointer can reach it. */
|
|
191
|
+
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
192
|
+
/** Pins the ceiling of the SECOND value axis, the way `max` pins the first. Two plots read
|
|
193
|
+
* against each other need both pinned, or the second rescales under them. */
|
|
194
|
+
readonly maxSecondary: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
131
195
|
/** Height of the plot itself, in CSS pixels, axis labels and value headroom excluded. Real
|
|
132
196
|
* pixels rather than a share of the width: one viewBox unit is one pixel, so a card that
|
|
133
197
|
* widens spreads the categories further apart and leaves the plot exactly this tall. */
|
|
@@ -181,15 +245,26 @@ declare class ChartComponent implements ChartScales {
|
|
|
181
245
|
readonly axisColor: _angular_core.InputSignal<string | null>;
|
|
182
246
|
/** `axisColor` for the second axis. */
|
|
183
247
|
readonly secondaryAxisColor: _angular_core.InputSignal<string | null>;
|
|
248
|
+
/** Names the first axis's unit beside it. On a two-scale plot the colour says which line reads
|
|
249
|
+
* which axis and this says what the numbers ARE - a reader who has neither is left comparing
|
|
250
|
+
* two quantities that may not be comparable at all. */
|
|
251
|
+
readonly axisLabel: _angular_core.InputSignal<string | null>;
|
|
252
|
+
/** `axisLabel` for the second axis. */
|
|
253
|
+
readonly secondaryAxisLabel: _angular_core.InputSignal<string | null>;
|
|
254
|
+
private readonly defaults;
|
|
184
255
|
readonly frameResolved: Signal<ChartFrame>;
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
256
|
+
readonly emptyTextResolved: Signal<string>;
|
|
257
|
+
readonly errorTextResolved: Signal<string>;
|
|
258
|
+
readonly valueFormatResolved: Signal<typeof _ids_group_ltd_ids_design_system_components.defaultChartFormat>;
|
|
188
259
|
private readonly host;
|
|
260
|
+
private readonly zone;
|
|
261
|
+
private readonly isBrowser;
|
|
189
262
|
/** The `<svg>`'s own rendered width: `:host(.framed)` carries the frame padding, so the host's
|
|
190
263
|
* CONTENT box - which is what a `ResizeObserver` reports - is the box the canvas fills at
|
|
191
264
|
* `inline-size: 100%`. Measuring the host is therefore measuring the canvas. */
|
|
192
265
|
private readonly measuredWidth;
|
|
266
|
+
/** Server-rendered output has no width to wait for, so it draws at the stand-in. */
|
|
267
|
+
readonly measured: Signal<boolean>;
|
|
193
268
|
protected readonly viewWidth: Signal<number>;
|
|
194
269
|
/** Whether the marks may animate yet. The first frame draws at `CHART_FALLBACK_WIDTH` scaled to
|
|
195
270
|
* fit, so the measurement that follows moves every mark - and a mark that transitions its
|
|
@@ -215,6 +290,8 @@ declare class ChartComponent implements ChartScales {
|
|
|
215
290
|
/** Widest tick label actually rendered, in the CSS pixels the canvas is drawn in. Zero until the
|
|
216
291
|
* first read, and zero under SSR, where `axisGutter` alone decides. */
|
|
217
292
|
private readonly measuredLabelWidth;
|
|
293
|
+
/** The widest category label as drawn, which is what decides whether they all fit. */
|
|
294
|
+
private readonly measuredCategoryLabelWidth;
|
|
218
295
|
/** `axisGutter` is the FLOOR, not the answer: a compact number is far wider in some locales than
|
|
219
296
|
* in others - `3,5 тыс.` against `3.5k` - and an SVG canvas CLIPS what a DOM column merely
|
|
220
297
|
* overflowed, so a fixed gutter silently eats the leading digit. The gutter takes whichever is
|
|
@@ -224,6 +301,16 @@ declare class ChartComponent implements ChartScales {
|
|
|
224
301
|
* count, neither of which the gutter feeds, so widening it moves the labels without rewriting
|
|
225
302
|
* them and the second measurement equals the first. */
|
|
226
303
|
protected readonly effectiveAxisGutter: Signal<number>;
|
|
304
|
+
/** A rotated axis title stands in the same gutter as the tick labels, so the gutter has to carry
|
|
305
|
+
* both or the widest tick runs through the title. Its own width is its line height, because it
|
|
306
|
+
* is turned on its side. */
|
|
307
|
+
protected readonly axisTitleGutter: Signal<20 | 0>;
|
|
308
|
+
/** Where a rotated axis title sits: hard against the outer edge, with the tick labels between it
|
|
309
|
+
* and the plot. */
|
|
310
|
+
protected readonly axisTitleX: Signal<number>;
|
|
311
|
+
/** Mirrors `axisTitleX` against the right edge, so the two titles stand the same distance from
|
|
312
|
+
* their own ticks. */
|
|
313
|
+
protected readonly secondaryTitleX: Signal<number>;
|
|
227
314
|
/** Widest secondary tick label, measured the same way and for the same reason as the primary
|
|
228
315
|
* one: those labels sit OUTSIDE the plot's right edge and an SVG canvas clips what a DOM
|
|
229
316
|
* column merely overflowed. */
|
|
@@ -231,12 +318,32 @@ declare class ChartComponent implements ChartScales {
|
|
|
231
318
|
/** The plot gives the right-hand labels room only when they are drawn there - a stacked second
|
|
232
319
|
* axis puts both label columns down the left, so the plot keeps the full width. */
|
|
233
320
|
protected readonly rightGutter: Signal<number>;
|
|
321
|
+
/** The second axis's title stands in the right gutter exactly as the first one's stands in the
|
|
322
|
+
* left, so both sides reserve the same band and the plot sits centred between its two labels. */
|
|
323
|
+
protected readonly secondaryTitleGutter: Signal<20 | 0>;
|
|
234
324
|
readonly plot: Signal<ChartPlot>;
|
|
235
325
|
readonly secondaryPlot: Signal<ChartPlot>;
|
|
236
326
|
private readonly reportedDomains;
|
|
237
327
|
reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
|
|
238
328
|
private valuesOn;
|
|
239
329
|
releaseDomain(id: string): void;
|
|
330
|
+
/** A template that replaces the panel's body, for a preset that prints more than label+value. */
|
|
331
|
+
readonly tooltipTemplate: _angular_core.InputSignal<TemplateRef<{
|
|
332
|
+
$implicit: ChartTooltipContext;
|
|
333
|
+
}> | null>;
|
|
334
|
+
/** Extra clearance between the mark and the panel, for a chart that prints a value label in
|
|
335
|
+
* the gap the panel would otherwise take. */
|
|
336
|
+
readonly tooltipExtraGap: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
337
|
+
private readonly tooltipSources;
|
|
338
|
+
reportTooltip(id: string, source: ChartTooltipSource): void;
|
|
339
|
+
releaseTooltip(id: string): void;
|
|
340
|
+
/** The offer to show, if any mark is making one. At most one mark has a context at a time: a
|
|
341
|
+
* per-mark tooltip only fills it while that mark is hovered, and an axis tooltip only while the
|
|
342
|
+
* category cursor is on. The container opening the panel is what stops two marks opening two. */
|
|
343
|
+
private readonly activeTooltip;
|
|
344
|
+
protected readonly tooltipContext: Signal<ChartTooltipContext | null>;
|
|
345
|
+
protected readonly tooltipOrigin: Signal<_ids_group_ltd_ids_design_system_components_chart_tooltip.ChartTooltipOrigin | null>;
|
|
346
|
+
protected readonly tooltipPreferBelow: Signal<boolean>;
|
|
240
347
|
/** Compared by value, which is what stops a mark that reports AND reads `yPosition()` in one
|
|
241
348
|
* effect from running forever: every report allocates a fresh `Map` and `niceDomain` a fresh
|
|
242
349
|
* object, so identity always differs and the read would re-arm the write. Measured without it:
|
|
@@ -254,7 +361,7 @@ declare class ChartComponent implements ChartScales {
|
|
|
254
361
|
* aligned axis they would land on the primary's own lines and double every stroke. */
|
|
255
362
|
protected readonly showSecondaryGridlines: Signal<boolean>;
|
|
256
363
|
protected readonly secondaryLabelX: Signal<number>;
|
|
257
|
-
protected readonly secondaryLabelAnchor: Signal<"
|
|
364
|
+
protected readonly secondaryLabelAnchor: Signal<"start" | "end">;
|
|
258
365
|
protected readonly secondaryPlotBottom: Signal<number>;
|
|
259
366
|
/** No tint on a single-scale plot: one axis needs no telling apart, and colouring it would only
|
|
260
367
|
* restate the marks' own colour in the furniture. */
|
|
@@ -265,8 +372,35 @@ declare class ChartComponent implements ChartScales {
|
|
|
265
372
|
readonly xPosition: Signal<(index: number) => number>;
|
|
266
373
|
readonly yPosition: Signal<(value: number) => number>;
|
|
267
374
|
readonly zeroOffset: Signal<number>;
|
|
268
|
-
readonly
|
|
375
|
+
protected readonly cursorBand: Signal<{
|
|
376
|
+
x: number;
|
|
377
|
+
width: number;
|
|
378
|
+
top: number;
|
|
379
|
+
bottom: number;
|
|
380
|
+
} | null>;
|
|
381
|
+
/** The same state machine the element marks run on: pin, linger, the grace period that lets the
|
|
382
|
+
* pointer reach a portaled panel, Escape and press-outside. A category cursor differs from a
|
|
383
|
+
* mark only in what the index counts, so it takes the behaviour rather than restating it. */
|
|
384
|
+
private readonly cursorState;
|
|
385
|
+
readonly activeIndex: Signal<number>;
|
|
386
|
+
private readonly pointerAt;
|
|
387
|
+
readonly cursorPointer: Signal<{
|
|
388
|
+
x: number;
|
|
389
|
+
y: number;
|
|
390
|
+
} | null>;
|
|
391
|
+
/** Whether the cursor is held. A preset renders its own way out of the pin from this. */
|
|
392
|
+
readonly cursorPinned: Signal<boolean>;
|
|
393
|
+
releaseCursor(): void;
|
|
394
|
+
private readonly canvasElement;
|
|
395
|
+
private canvasRect;
|
|
396
|
+
private plotPointer;
|
|
397
|
+
/** The plot listens to the pointer only when it draws a category cursor, and outside the zone:
|
|
398
|
+
* the handler writes signals, which schedule the render they need. */
|
|
399
|
+
private listenForCursor;
|
|
400
|
+
private readonly bandElement;
|
|
401
|
+
readonly cursorOrigin: Signal<Element | null>;
|
|
269
402
|
setActiveIndex(index: number): void;
|
|
403
|
+
private clampIndex;
|
|
270
404
|
protected readonly plotRight: Signal<number>;
|
|
271
405
|
protected readonly plotBottom: Signal<number>;
|
|
272
406
|
protected readonly axisLabelX: Signal<number>;
|
|
@@ -278,9 +412,15 @@ declare class ChartComponent implements ChartScales {
|
|
|
278
412
|
y: number;
|
|
279
413
|
label: string;
|
|
280
414
|
}[]>;
|
|
415
|
+
private readonly labelTexts;
|
|
416
|
+
/** Rotation is spent before thinning: a tilt costs the reader a glance, dropping a label costs
|
|
417
|
+
* them a reading. Both are decided from the widest label as it actually rendered. */
|
|
418
|
+
protected readonly categoryLabelsRotated: Signal<boolean>;
|
|
419
|
+
private readonly categoryLabelInterval;
|
|
281
420
|
protected readonly categoryLabels: Signal<{
|
|
282
421
|
x: number;
|
|
283
422
|
text: string;
|
|
423
|
+
index: number;
|
|
284
424
|
}[]>;
|
|
285
425
|
protected readonly reachesBelowZero: Signal<boolean>;
|
|
286
426
|
/** Empty is read off `categories` alone, never off the reported domains: the marks are
|
|
@@ -289,10 +429,9 @@ declare class ChartComponent implements ChartScales {
|
|
|
289
429
|
protected readonly isEmpty: Signal<boolean>;
|
|
290
430
|
protected readonly accessibleName: Signal<string>;
|
|
291
431
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
|
|
292
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart",
|
|
432
|
+
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; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
|
|
293
433
|
}
|
|
294
434
|
|
|
295
|
-
/** @internal */
|
|
296
435
|
interface ColumnSeriesPoint {
|
|
297
436
|
id?: string;
|
|
298
437
|
label: string;
|
|
@@ -306,23 +445,40 @@ interface ColumnSeriesPoint {
|
|
|
306
445
|
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
307
446
|
* know is not rendered, and neither are its descendants, so `<ds-column-series>` inside the
|
|
308
447
|
* container's canvas would draw nothing. Written as `<svg:g dsColumnSeries>`.
|
|
309
|
-
*
|
|
310
|
-
* @internal
|
|
311
448
|
*/
|
|
312
449
|
declare class ColumnSeriesComponent implements OnDestroy {
|
|
450
|
+
protected readonly leaveMark: typeof leaveMark;
|
|
313
451
|
private readonly scales;
|
|
314
452
|
/** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
|
|
315
453
|
* element, and a required input throws NG0950 for the pass before its own value is written. */
|
|
316
454
|
readonly data: _angular_core.InputSignal<readonly ColumnSeriesPoint[]>;
|
|
455
|
+
/** Prints each column's value above the column. */
|
|
317
456
|
readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
457
|
+
/** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
|
|
458
|
+
* fires whether or not this is set. */
|
|
318
459
|
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
460
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
|
|
461
|
+
* press outside releases it. Pinning is a state, not a handler. */
|
|
319
462
|
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
463
|
+
/** Fades every mark but the one under the pointer. Off by default: the dimming buys loudness
|
|
464
|
+
* for one mark and pays for it with the separation between the rest. */
|
|
320
465
|
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
466
|
+
/** Milliseconds between one mark's entrance and the next. The total is capped, so a long
|
|
467
|
+
* series does not crawl in. */
|
|
321
468
|
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
469
|
+
/** Declares that the marks are parts of one whole, which is what makes a share of their total
|
|
470
|
+
* a real quantity. On, each mark's share appears on the tooltip's second line. */
|
|
322
471
|
readonly partOfWhole: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
472
|
+
/** Whether a hovered or focused column opens a tooltip. */
|
|
323
473
|
readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
|
|
474
|
+
/** Where the tooltip is pinned. `'mark'` is the column itself; `'cell'` is the full-height
|
|
475
|
+
* category cell, which puts the panel at the top of the plot whatever the column's value. */
|
|
324
476
|
readonly tooltipAnchor: _angular_core.InputSignal<"mark" | "cell">;
|
|
477
|
+
/** How long the panel survives the pointer leaving the mark. Raise it only for a panel a
|
|
478
|
+
* reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
|
|
325
479
|
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
480
|
+
/** Formats every value this series prints. Called with `'tick'` for an axis label and
|
|
481
|
+
* `'tooltip'` everywhere a value is printed in full. */
|
|
326
482
|
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
|
|
327
483
|
/** The mark's share of its category's own slot, before the maximum width caps it. Measured off
|
|
328
484
|
* the slot rather than off `bandWidth()`, which has the container's own padding already taken
|
|
@@ -346,6 +502,12 @@ declare class ColumnSeriesComponent implements OnDestroy {
|
|
|
346
502
|
/** Names the series in the tooltip, where the category then becomes the panel's heading. Unset,
|
|
347
503
|
* the panel names the category instead, which is what a chart of one series has to say. */
|
|
348
504
|
readonly seriesLabel: _angular_core.InputSignal<string | null>;
|
|
505
|
+
/** Identifies this series to the legend, so hovering a legend item can single it out. */
|
|
506
|
+
readonly seriesKey: _angular_core.InputSignal<string | null>;
|
|
507
|
+
/** The series the reader is pointing at in the legend. Every other series fades. */
|
|
508
|
+
readonly highlighted: _angular_core.InputSignal<string | null>;
|
|
509
|
+
protected readonly dimmedBySeries: _angular_core.Signal<boolean>;
|
|
510
|
+
/** The clicked datum. Fires on click and on Enter or Space, whatever `interactive` says. */
|
|
349
511
|
readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
|
|
350
512
|
private readonly seriesId;
|
|
351
513
|
private readonly domainId;
|
|
@@ -368,6 +530,19 @@ declare class ColumnSeriesComponent implements OnDestroy {
|
|
|
368
530
|
* reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
|
|
369
531
|
* strip under the plot that answers no pointer. */
|
|
370
532
|
protected readonly hitHeight: _angular_core.Signal<number>;
|
|
533
|
+
/** Stacked series sit on top of one another, so a full-slot hit box on each one means only the
|
|
534
|
+
* series drawn last is ever reachable. Stacked, a mark catches the pointer over its own segment
|
|
535
|
+
* and nothing else. */
|
|
536
|
+
protected readonly stacked: _angular_core.Signal<boolean>;
|
|
537
|
+
/** Keeps a thin segment reachable without letting it reach into its neighbours. */
|
|
538
|
+
private static readonly MIN_STACK_HIT;
|
|
539
|
+
protected hitBox(mark: {
|
|
540
|
+
top: number;
|
|
541
|
+
height: number;
|
|
542
|
+
}): {
|
|
543
|
+
y: number;
|
|
544
|
+
height: number;
|
|
545
|
+
};
|
|
371
546
|
protected readonly pinDiscRadius = 11;
|
|
372
547
|
protected readonly pinGlyphSize = 14;
|
|
373
548
|
protected readonly pinGlyphOffset: number;
|
|
@@ -389,26 +564,26 @@ declare class ColumnSeriesComponent implements OnDestroy {
|
|
|
389
564
|
hatched: boolean;
|
|
390
565
|
}[]>;
|
|
391
566
|
protected markStagger(index: number): string;
|
|
392
|
-
|
|
393
|
-
protected
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
protected
|
|
398
|
-
protected
|
|
399
|
-
protected
|
|
400
|
-
protected onMarkNavigation(event: KeyboardEvent, index: number): void;
|
|
401
|
-
protected onPointKey(point: ColumnSeriesPoint, event: Event): void;
|
|
567
|
+
private readonly tooltipMark;
|
|
568
|
+
protected onMarkClick(event: MouseEvent): void;
|
|
569
|
+
protected onMarkOver(event: PointerEvent): void;
|
|
570
|
+
protected onMarkOut(event: PointerEvent): void;
|
|
571
|
+
protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
|
|
572
|
+
protected onMarkFocus(event: FocusEvent): void;
|
|
573
|
+
protected onMarkBlur(event: FocusEvent): void;
|
|
574
|
+
protected onMarkKey(event: KeyboardEvent): void;
|
|
402
575
|
protected entryLabel(mark: {
|
|
403
576
|
point: ColumnSeriesPoint;
|
|
404
577
|
formattedValue: string;
|
|
405
578
|
}): string;
|
|
579
|
+
/** This series' reading at the category the cursor is on. Filled whatever `tooltip` says: it
|
|
580
|
+
* feeds the container's category panel, never a panel of this mark's own. */
|
|
581
|
+
readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
|
|
406
582
|
readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
407
583
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
|
|
408
|
-
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>;
|
|
584
|
+
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; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
|
|
409
585
|
}
|
|
410
586
|
|
|
411
|
-
/** @internal */
|
|
412
587
|
interface LineSeriesData {
|
|
413
588
|
id: string;
|
|
414
589
|
label: string;
|
|
@@ -418,34 +593,83 @@ interface LineSeriesData {
|
|
|
418
593
|
axis?: ChartAxis;
|
|
419
594
|
/** Fills the band between the line and its axis baseline. */
|
|
420
595
|
area?: boolean;
|
|
596
|
+
/** The band's floor, one entry per category, in the axis's own unit. Unset fills to the
|
|
597
|
+
* baseline. Given, the fill is the band between the two curves - which is what a stacked plot
|
|
598
|
+
* needs, and the caller that owns the pile is the one that knows where each band starts. A
|
|
599
|
+
* `null` must sit in exactly the categories `data` has one, or the two sides break in
|
|
600
|
+
* different places. */
|
|
601
|
+
lower?: readonly (number | null)[];
|
|
421
602
|
/** Any CSS colour. Unset takes the categorical palette slot for the series' position. */
|
|
422
603
|
color?: string;
|
|
423
604
|
}
|
|
424
|
-
/** What a `null` reading draws: a hole in the line, or a point at zero.
|
|
425
|
-
*
|
|
426
|
-
* @internal */
|
|
427
|
-
type LineSeriesGaps = 'break' | 'zero';
|
|
428
605
|
/**
|
|
429
606
|
* One line per series, drawn against the scales `ds-chart` supplies, on either of its two value
|
|
430
607
|
* axes.
|
|
431
608
|
*
|
|
432
609
|
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
433
610
|
* know is not rendered, and neither are its descendants. Written as `<svg:g dsLineSeries>`.
|
|
434
|
-
*
|
|
435
|
-
* @internal
|
|
436
611
|
*/
|
|
437
612
|
declare class LineSeriesComponent implements OnDestroy {
|
|
613
|
+
protected readonly leaveMark: typeof leaveMark;
|
|
438
614
|
private readonly scales;
|
|
439
615
|
/** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
|
|
440
616
|
* element, and a required input throws NG0950 for the pass before its own value is written. */
|
|
441
617
|
readonly data: _angular_core.InputSignal<readonly LineSeriesData[]>;
|
|
618
|
+
/** Draws a round marker at every reading. Off leaves the line alone, which reads better past
|
|
619
|
+
* roughly twenty points. */
|
|
442
620
|
readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
621
|
+
/** Lays the line and its markers on a band of the surface colour, so they stay legible where
|
|
622
|
+
* they cross other marks. On by default: a line shares its plot more often than not, and on an
|
|
623
|
+
* empty plot the band only separates it from the gridlines. */
|
|
624
|
+
readonly outline: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
625
|
+
/** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
|
|
626
|
+
* fires whether or not this is set. */
|
|
443
627
|
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
628
|
+
/** Holds the hovered mark and its tooltip in place when it is clicked, until Escape or a
|
|
629
|
+
* press outside releases it. Pinning is a state, not a handler. */
|
|
630
|
+
readonly pinOnClick: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
631
|
+
/** Fades every series but the one under the pointer. Off by default: the dimming buys loudness
|
|
632
|
+
* for one line and pays for it with the separation between the rest. */
|
|
633
|
+
readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
634
|
+
/** The one series to single out: every other one draws faded and this one draws bold, so the
|
|
635
|
+
* comparison survives a monochrome print. Driven from a legend, or from whatever else the app
|
|
636
|
+
* uses to mean "show me this one". Fades the others whether or not `dimOthers` is set, which
|
|
637
|
+
* governs only what a pointer over a marker does. */
|
|
638
|
+
readonly highlighted: _angular_core.InputSignal<string | null>;
|
|
639
|
+
/** A dash pattern per series, in the order the series are given. A series past the end of the
|
|
640
|
+
* list, or given an empty string, draws solid. */
|
|
641
|
+
readonly patterns: _angular_core.InputSignal<readonly string[]>;
|
|
642
|
+
/** Fills each area from the series below it rather than from the baseline, which is what a
|
|
643
|
+
* stacked plot needs and what the fill reads as. */
|
|
644
|
+
readonly stacked: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
645
|
+
/** The dash for a series' position, or null where it draws solid. */
|
|
646
|
+
protected dashFor(seriesIndex: number): string | null;
|
|
647
|
+
/** Milliseconds between one marker's entrance and the next. The total is capped. */
|
|
444
648
|
readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
445
|
-
|
|
446
|
-
|
|
649
|
+
/** What a `null` reading draws: `'break'` leaves a hole in the line, `'zero'` plots a point
|
|
650
|
+
* at zero. A missing measurement and a measured zero are different facts. */
|
|
651
|
+
readonly gaps: _angular_core.InputSignal<ChartGaps>;
|
|
652
|
+
/** How the line joins its readings. `'linear'` by default, which asserts nothing the data does
|
|
653
|
+
* not say; a curve is a claim about what happened BETWEEN two readings. `'step'` holds each
|
|
654
|
+
* reading to the next, `'smooth'` is a monotone cubic that draws no peak the data lacks. */
|
|
655
|
+
readonly curve: _angular_core.InputSignal<ChartCurve>;
|
|
656
|
+
/** Whether a hovered or focused reading opens a tooltip, and for what. `'item'` names the
|
|
657
|
+
* marker itself. `'axis'` names every series at the category under the pointer, which is the
|
|
658
|
+
* reading a multi-series line is compared on - it follows the container's `cursor`, so set
|
|
659
|
+
* `cursor="category"` on `ds-chart` with it or nothing marks the category being read. */
|
|
660
|
+
readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
|
|
661
|
+
/** Where an `'axis'` panel hangs: `'reading'` puts it over the highest reading in the category,
|
|
662
|
+
* so it names what it points at and stays put while the pointer travels within one band;
|
|
663
|
+
* `'pointer'` follows the cursor. */
|
|
664
|
+
readonly tooltipAnchor: _angular_core.InputSignal<"reading" | "pointer">;
|
|
665
|
+
/** How long the panel survives the pointer leaving the marker. Raise it only for a panel a
|
|
666
|
+
* reader has to REACH, which is WCAG 1.4.13's hoverable clause; about 140 crosses the gap. */
|
|
447
667
|
readonly tooltipLingerMs: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
668
|
+
/** Formats every value this series prints. Called with `'tick'` for an axis label and
|
|
669
|
+
* `'tooltip'` everywhere a value is printed in full. */
|
|
448
670
|
readonly valueFormat: _angular_core.InputSignal<ChartValueFormat>;
|
|
671
|
+
/** The clicked reading, with the series it belongs to and its position in `categories`.
|
|
672
|
+
* Fires on click and on Enter or Space, whatever `interactive` says. */
|
|
449
673
|
readonly pointClicked: _angular_core.OutputEmitterRef<{
|
|
450
674
|
series: LineSeriesData;
|
|
451
675
|
categoryIndex: number;
|
|
@@ -463,8 +687,8 @@ declare class LineSeriesComponent implements OnDestroy {
|
|
|
463
687
|
series: LineSeriesData;
|
|
464
688
|
color: string;
|
|
465
689
|
seriesIndex: number;
|
|
466
|
-
|
|
467
|
-
areaPaths: string[];
|
|
690
|
+
linePaths: string[];
|
|
691
|
+
areaPaths: readonly string[];
|
|
468
692
|
markers: {
|
|
469
693
|
key: string;
|
|
470
694
|
markIndex: number;
|
|
@@ -479,24 +703,58 @@ declare class LineSeriesComponent implements OnDestroy {
|
|
|
479
703
|
color: string;
|
|
480
704
|
}[];
|
|
481
705
|
}[]>;
|
|
706
|
+
private areaPathsFor;
|
|
482
707
|
private readonly allMarkers;
|
|
483
708
|
protected seriesStagger(index: number): string;
|
|
484
|
-
/** One tab stop
|
|
485
|
-
*
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
protected
|
|
491
|
-
|
|
709
|
+
/** One tab stop PER SERIES: each line is a strand the reader walks with the arrows, and the
|
|
710
|
+
* strands are what the chart is comparing. WCAG 2.1.1's Understanding is explicit that not
|
|
711
|
+
* every mouse-operable control has to be separately focusable, which is what keeps a
|
|
712
|
+
* 12-category, 2-series plot from being twenty-four stops in the page's tab order. */
|
|
713
|
+
private readonly rovingBySeries;
|
|
714
|
+
private readonly firstMarkerBySeries;
|
|
715
|
+
protected isTabStop(seriesId: string, markIndex: number): boolean;
|
|
716
|
+
/** The series a marker holds focus on, which narrows an `'axis'` panel to that one reading: a
|
|
717
|
+
* pointer answers for every series at once, a focused marker answers for its own. */
|
|
718
|
+
private readonly focusedSeries;
|
|
719
|
+
/** A reading is active when its own marker is hovered OR when the category cursor is on its
|
|
720
|
+
* category: one band, one answer, so the dot grows wherever in the band the pointer is rather
|
|
721
|
+
* than only on the 4px dot itself. */
|
|
722
|
+
protected isActiveMarker(marker: {
|
|
723
|
+
markIndex: number;
|
|
724
|
+
categoryIndex: number;
|
|
725
|
+
}): boolean;
|
|
726
|
+
protected onMarkerOver(event: PointerEvent): void;
|
|
727
|
+
protected onMarkerOut(event: PointerEvent): void;
|
|
728
|
+
protected onMarkerFocus(event: FocusEvent): void;
|
|
729
|
+
protected onMarkerBlur(event: FocusEvent): void;
|
|
730
|
+
protected onMarkerKey(event: KeyboardEvent): void;
|
|
731
|
+
protected isDimmed(seriesId: string): boolean;
|
|
732
|
+
protected onMarkerClick(event: MouseEvent): void;
|
|
733
|
+
private selectMarker;
|
|
492
734
|
protected markerLabel(marker: {
|
|
493
735
|
seriesLabel: string;
|
|
494
736
|
category: string;
|
|
495
737
|
formattedValue: string;
|
|
496
738
|
}): string;
|
|
739
|
+
/** What this series reads at the category the cursor is on, whatever `tooltip` says. It feeds
|
|
740
|
+
* the container's category panel, so one band answers for every mark on the plot rather than
|
|
741
|
+
* each mark owning a hover field of its own. */
|
|
742
|
+
readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
|
|
497
743
|
readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
|
|
744
|
+
private readonly markerElements;
|
|
745
|
+
/** The topmost reading at the active category, as its own element. The cursor band spans the
|
|
746
|
+
* whole plot, so anchoring an `'axis'` panel to it opens the panel at the top of the chart
|
|
747
|
+
* rather than over the readings it is about. */
|
|
748
|
+
private readonly topReadingElement;
|
|
749
|
+
/** Where the panel hangs: the reading or the pointer in `'axis'` mode, the hovered mark
|
|
750
|
+
* otherwise. */
|
|
751
|
+
readonly tooltipOrigin: _angular_core.Signal<ChartTooltipOrigin | null>;
|
|
752
|
+
/** Every series' reading at the category the CONTAINER says is active, which is what the
|
|
753
|
+
* category cursor sets. A series with no reading there contributes no row rather than a
|
|
754
|
+
* blank one. */
|
|
755
|
+
private readonly axisTooltipContext;
|
|
498
756
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
|
|
499
|
-
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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
|
|
757
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "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>;
|
|
500
758
|
}
|
|
501
759
|
|
|
502
760
|
/**
|
|
@@ -505,11 +763,12 @@ declare class LineSeriesComponent implements OnDestroy {
|
|
|
505
763
|
* A second element rather than part of `g[dsReferenceLine]`: the strokes belong under the marks
|
|
506
764
|
* and the names over them, and a projected element lands in exactly one of the container's slots.
|
|
507
765
|
* Reports no domain - the line it names already did.
|
|
508
|
-
*
|
|
509
|
-
* @internal
|
|
510
766
|
*/
|
|
511
767
|
declare class ReferenceLabelComponent {
|
|
512
768
|
private readonly scales;
|
|
769
|
+
/** The same list `dsReferenceLine` is given. This mark draws only the labels, so it is placed
|
|
770
|
+
* AFTER the series and the line mark before it, which is what keeps a label legible over a mark
|
|
771
|
+
* that would otherwise cover it. */
|
|
513
772
|
readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
|
|
514
773
|
protected readonly lines: _angular_core.Signal<ThresholdMark[]>;
|
|
515
774
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceLabelComponent, never>;
|
|
@@ -525,11 +784,12 @@ declare class ReferenceLabelComponent {
|
|
|
525
784
|
*
|
|
526
785
|
* Hosted on a `<g>` rather than an element of its own: an element the SVG specification does not
|
|
527
786
|
* know is not rendered, and neither are its descendants. Written as `<svg:g dsReferenceLine>`.
|
|
528
|
-
*
|
|
529
|
-
* @internal
|
|
530
787
|
*/
|
|
531
788
|
declare class ReferenceLineComponent implements OnDestroy {
|
|
532
789
|
private readonly scales;
|
|
790
|
+
/** The lines and bands to draw across the plot. Each entry is ONE reading, `value`, plus an
|
|
791
|
+
* optional `label`, `color` and `dash`; a `to` makes it a band between two readings. Each one
|
|
792
|
+
* widens the value axis to hold it, so a target above every mark still lands on the plot. */
|
|
533
793
|
readonly thresholds: _angular_core.InputSignal<readonly ChartThreshold[]>;
|
|
534
794
|
private readonly domainId;
|
|
535
795
|
constructor();
|
|
@@ -539,5 +799,30 @@ declare class ReferenceLineComponent implements OnDestroy {
|
|
|
539
799
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferenceLineComponent, "g[dsReferenceLine]", never, { "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
540
800
|
}
|
|
541
801
|
|
|
542
|
-
|
|
543
|
-
|
|
802
|
+
interface ChartAnnotation {
|
|
803
|
+
/** 0-based position along the category axis. */
|
|
804
|
+
readonly categoryIndex: number;
|
|
805
|
+
/** The reading the label names, in the axis's own unit. */
|
|
806
|
+
readonly value: number;
|
|
807
|
+
readonly label: string;
|
|
808
|
+
/** Which value axis the reading is measured against. Defaults to `'primary'`. */
|
|
809
|
+
readonly axis?: ChartAxis;
|
|
810
|
+
}
|
|
811
|
+
/**
|
|
812
|
+
* A tooltip answers "what is this?" on hover; an annotation answers it in a printed page or a
|
|
813
|
+
* screenshot.
|
|
814
|
+
*
|
|
815
|
+
* Takes the readings rather than finding them: a mark never sees the other marks, so the caller
|
|
816
|
+
* that owns the series is the one that knows which value a label belongs to. Reports no domain -
|
|
817
|
+
* the series it annotates already did.
|
|
818
|
+
*/
|
|
819
|
+
declare class SeriesAnnotationComponent {
|
|
820
|
+
private readonly scales;
|
|
821
|
+
readonly annotations: _angular_core.InputSignal<readonly ChartAnnotation[]>;
|
|
822
|
+
protected readonly placed: _angular_core.Signal<readonly _ids_group_ltd_ids_design_system_components_chart.ChartAnnotationMark[]>;
|
|
823
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SeriesAnnotationComponent, never>;
|
|
824
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SeriesAnnotationComponent, "g[dsSeriesAnnotation]", never, { "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
825
|
+
}
|
|
826
|
+
|
|
827
|
+
export { CHART_DEFAULT_VALUE_SPACE, CHART_SCALES, ChartComponent, ColumnSeriesComponent, LineSeriesComponent, ReferenceLabelComponent, ReferenceLineComponent, SeriesAnnotationComponent, annotationMarks, chartViewHeight, stackOffsets };
|
|
828
|
+
export type { ChartAnnotation, ChartAnnotationMark, ChartPlot, ChartScales, ChartStackOffset, ColumnSeriesPoint, LineSeriesData };
|