@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
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,1106 @@
|
|
|
1
1
|
## Unreleased
|
|
2
2
|
|
|
3
|
+
## 0.13.4 — 2026-09-23
|
|
4
|
+
|
|
5
|
+
### Breaking
|
|
6
|
+
|
|
7
|
+
- **The second-axis modes are renamed: `'rounded'` is `'aligned'`, `'independent'` is `'dual-grid'`,
|
|
8
|
+
`'stacked'` is `'split'`.** `'exact'` is unchanged. The four words name what is done to the
|
|
9
|
+
GRIDLINES, which is the only thing the modes differ in; the old three named something else or
|
|
10
|
+
nothing at all.
|
|
11
|
+
|
|
12
|
+
```html
|
|
13
|
+
<ds-line-chart yAxisMode="dual-grid" [categories]="months" [series]="series" />
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
It applies to `yAxisMode` on `ds-line-chart`, `secondaryAxisMode` on `ds-chart`, and the
|
|
17
|
+
`ChartAxisMode` union both take. `'stacked'` had to go whatever else happened: `ds-column-chart`
|
|
18
|
+
ships `stack="stacked"`, which puts SERIES on top of each other, while the axis mode puts two
|
|
19
|
+
PLOTS one above the other - one word, two meanings, on charts read side by side.
|
|
20
|
+
|
|
21
|
+
An unknown string does not error. Angular assigns it, no mode matches it, and the plot falls back
|
|
22
|
+
to one shared grid - a chart that looks plausible and is measured against the wrong axis. Grep for
|
|
23
|
+
the three old values on those two inputs; there is nothing to see at runtime.
|
|
24
|
+
|
|
25
|
+
- **`ds-donut-chart` is `ds-pie-chart`.** `DonutChartComponent` is `PieChartComponent`,
|
|
26
|
+
`DonutChartSlice` is `PieChartSlice`, and the entry point is
|
|
27
|
+
`@ids-group-ltd/ids-design-system/components/pie-chart`. The eight `--ds-donut-chart-*` tokens
|
|
28
|
+
take the `--ds-pie-chart-` prefix, and the internal wrapper class `.donut-chart` is `.pie-chart`.
|
|
29
|
+
|
|
30
|
+
```html
|
|
31
|
+
<ds-pie-chart [data]="slices" centerValue="4,208" centerLabel="Total" />
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The component has drawn a solid pie since it shipped - closing the hole was one value of one
|
|
35
|
+
input - so `Donut` named a default rather than the component. Under `Pie` the ring is the
|
|
36
|
+
default and the disc is the zero case, which is how every other library in the field spells it.
|
|
37
|
+
|
|
38
|
+
The old tag is an unknown element, not an error: Angular renders nothing and logs nothing outside
|
|
39
|
+
strict schema mode, so a missed one is a chart that silently vanished. A `--ds-donut-chart-*`
|
|
40
|
+
declaration left behind is valid CSS the component no longer reads, and the chart draws at its
|
|
41
|
+
default size with nothing reported.
|
|
42
|
+
|
|
43
|
+
- **`thickness` is `innerRadius`, and the value is `1` minus what it was.** `0.32` becomes `0.68`,
|
|
44
|
+
`0.1` becomes `0.9`, `1` becomes `0`. The default draws the identical ring.
|
|
45
|
+
|
|
46
|
+
```html
|
|
47
|
+
<ds-pie-chart [data]="slices" [innerRadius]="0" />
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
The knob names the hole now rather than the band, because the base case is a solid pie and the
|
|
51
|
+
ring is the hole opened in it. `innerRadius="0"` is the pie; `1` no longer is. A value outside
|
|
52
|
+
`[0, 1)` falls back to the default rather than drawing nothing.
|
|
53
|
+
|
|
54
|
+
**Renaming without inverting is the hazard here, and nothing catches it.** A value carried across
|
|
55
|
+
untouched is still in range and still valid, so a ring set to `0.32` becomes a nearly solid disc
|
|
56
|
+
and a pie set to `1` becomes a ring. There is no error, no warning, and no type change - only a
|
|
57
|
+
different picture.
|
|
58
|
+
|
|
59
|
+
- **Centre content renders only where there is a hole to hold it.** At `innerRadius="0"`,
|
|
60
|
+
`centerValue` and `centerLabel` draw nothing.
|
|
61
|
+
|
|
62
|
+
They used to render over the solid disc, where the halo behind them had nothing to separate them
|
|
63
|
+
from and no single text colour is readable against three hues. Where a pie's centre figure was
|
|
64
|
+
the only place a total appeared, move it to the caption, the legend or the page around the chart.
|
|
65
|
+
|
|
66
|
+
- **The grouped slice's id is `ds-pie-other`.** It reaches a consumer through `sliceClicked`
|
|
67
|
+
whenever `maxSlices` groups a tail, so code comparing `slice.id` to `'ds-donut-other'` stops
|
|
68
|
+
matching - without erroring, and with the grouped `Other` then handled as a real category.
|
|
69
|
+
|
|
70
|
+
- **118 `--ds-*` tokens take their CSS property's name.** `-pad` is `-padding`, `-btn` is
|
|
71
|
+
`-button`, `-fs` is `-font-size`, `-tracking` is `-letter-spacing`, `-transform` is
|
|
72
|
+
`-text-transform`, a bare `-weight` is `-font-weight`, and the truncated dimensions
|
|
73
|
+
(`-w`, `-h`, `-maxw`, `-maxh`, `-minw`, `-col-w`) are spelled in full. Three fall outside those
|
|
74
|
+
rules: `--ds-container-max` is `--ds-container-max-width`, `--ds-segmented-r-inner` is
|
|
75
|
+
`--ds-segmented-radius-inner`, and `--ds-color-picker-sv-h` is
|
|
76
|
+
`--ds-color-picker-saturation-value-height`.
|
|
77
|
+
|
|
78
|
+
```scss
|
|
79
|
+
ds-button { --ds-button-padding-x: var(--space-6); --ds-button-letter-spacing: 0; }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Several properties were tokenised all along under names nobody would guess from the property
|
|
83
|
+
being set: tab padding lived under `-tab-pad-*`, menu-item padding under `-menu-item-pad-*`, and
|
|
84
|
+
the checkbox label weight under `--ds-checkbox-label-weight` rather than
|
|
85
|
+
`--ds-checkbox-label-font-weight`. A hook nobody can find is not a hook.
|
|
86
|
+
|
|
87
|
+
The whole surface is now guessable from the property being set. What was already spelled out
|
|
88
|
+
(`--ds-button-height`, `--ds-chart-frame-padding`, `--ds-checkbox-label-font-size`) is
|
|
89
|
+
unchanged, and nothing was added or removed.
|
|
90
|
+
|
|
91
|
+
An unknown custom property is not an error. The declaration stays in the stylesheet, the
|
|
92
|
+
component reads its own fallback, and the element draws at its default with no build error and
|
|
93
|
+
no console warning, so a missed rename is silent. Grep for the six spellings and the three
|
|
94
|
+
named tokens above.
|
|
95
|
+
|
|
96
|
+
- **`--ds-container-pad` is `--ds-surface-padding`.** It is the padding every surface component
|
|
97
|
+
falls back to - `card` and `stat` read it, `<ds-container>` never did - so it sat in the
|
|
98
|
+
namespace of a component it had nothing to do with, beside `--ds-container-pad-x`, which is
|
|
99
|
+
that component's own padding and is now `--ds-container-padding-x`.
|
|
100
|
+
|
|
101
|
+
The two old names read as a pair and controlled unrelated things: a value moved to the wrong one
|
|
102
|
+
re-pads every card in the app and leaves the container alone, or the reverse.
|
|
103
|
+
|
|
104
|
+
- **Fourteen more tokens take the name of what they configure.** The spelling pass fixed
|
|
105
|
+
abbreviations; this one fixes tokens whose name points at the wrong component or uses a word
|
|
106
|
+
only we say.
|
|
107
|
+
|
|
108
|
+
```scss
|
|
109
|
+
ds-description-item { --ds-description-item-term-text-transform: uppercase; }
|
|
110
|
+
ds-segmented { --ds-segmented-segment-border: 1px solid var(--border-default); }
|
|
111
|
+
ds-tabs { --ds-tabs-gap: var(--space-4); }
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
The eight `--ds-description-list-term-*` and `-details-*` tokens are declared in
|
|
115
|
+
`description-item.component.scss` and style one item, so they are `--ds-description-item-*`.
|
|
116
|
+
The three `--ds-segmented-button-*` are `--ds-segmented-segment-*`, because the component calls
|
|
117
|
+
its parts segments everywhere else it speaks - `class="segment"` in the template,
|
|
118
|
+
`SegmentedOption` as the published type. `--ds-tabs-strip-gap` is `--ds-tabs-gap`: `strip` is
|
|
119
|
+
our internal word for the tab list and appears nowhere a consumer reads.
|
|
120
|
+
`--ds-description-list-col-gap` is `-column-gap`, and
|
|
121
|
+
`--ds-split-button-bg-hover-color` is `-bg-color-hover`, which is how every other hover colour
|
|
122
|
+
in the library is spelled.
|
|
123
|
+
|
|
124
|
+
`--ds-description-list-label-width`, `-row-gap` and `-column-gap` stay on the list, which is
|
|
125
|
+
what they size. `--ds-button-*`, `--ds-split-button-*`, `--ds-icon-button-*` and
|
|
126
|
+
`--ds-pagination-button-*` all style real buttons, so this pass leaves them in their own
|
|
127
|
+
namespace.
|
|
128
|
+
|
|
129
|
+
A word that disambiguates a real part is not an abbreviation and was kept:
|
|
130
|
+
`--ds-tab-label-font-size` stays, because a tab has a label and a badge, and
|
|
131
|
+
`--ds-tab-color` would not say which it meant.
|
|
132
|
+
|
|
133
|
+
An unknown custom property is not an error, so a missed rename is silent - the component reads
|
|
134
|
+
its own fallback and draws at the default.
|
|
135
|
+
|
|
136
|
+
- **Nine exported names now say what they are.** A name is a defect when it misleads, when it
|
|
137
|
+
stands for two things, or when two names stand for one.
|
|
138
|
+
|
|
139
|
+
```ts
|
|
140
|
+
import type { ChartGaps, DateRangeValue, SortDirection } from '@ids-group-ltd/ids-design-system';
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
`LineChartGaps` is `ChartGaps`, in `core` beside `ChartAxisMode`, and so is its
|
|
144
|
+
character-identical `@internal` twin `LineSeriesGaps`, which was reachable through the
|
|
145
|
+
`components/chart` entry point. `LineChartAxisMode` was a bare alias of `ChartAxisMode` published next to it,
|
|
146
|
+
and is now that type. `RangeValue` is `DateRangeValue`, which is what its already-qualified
|
|
147
|
+
neighbour `TimeRangeValue` made clear it should have been. `LineChartPoint` is
|
|
148
|
+
`LineChartReading`: `...ChartPoint` is an input datum everywhere else, this one is the
|
|
149
|
+
`pointClicked` payload, matching the new scatter chart's `ScatterChartReading`.
|
|
150
|
+
|
|
151
|
+
`SortDir`, `sortDir` and `sortDirChange` are `SortDirection`, `sortDirection` and
|
|
152
|
+
`sortDirectionChange`, and `SortChangeEvent.dir` keeps its name with the type `SortDirection`.
|
|
153
|
+
`TableColumn.srLabel` is
|
|
154
|
+
`screenReaderLabel` - it renders visually-hidden text, so `ariaLabel` would have been a second
|
|
155
|
+
wrong name. `ds-accordion[multi]` is `multiple`, which is how `ds-autocomplete`, `ds-dropzone`
|
|
156
|
+
and `TableExpandMode` all spell it.
|
|
157
|
+
|
|
158
|
+
`LayoutScrollService` and `LayoutNavigationService` take their component's name -
|
|
159
|
+
`AppLayoutScrollService` and `AppLayoutNavigationService` - and `DsScrollReset` is no longer
|
|
160
|
+
exported, having become `DsAppLayoutScrollReset`. All three move because `LayoutAlign`, `LayoutGap` and `LayoutJustify` already make `Layout` mean the flex
|
|
161
|
+
container entry point on this same surface.
|
|
162
|
+
|
|
163
|
+
**Two of these fail quietly.** A static `sortDir="asc"` left behind is an unknown attribute:
|
|
164
|
+
Angular leaves it on the DOM, the input keeps its default, and the table sorts by nothing with
|
|
165
|
+
no warning. And `[multi]="false"`, written to get a single-open accordion, becomes an unknown
|
|
166
|
+
attribute against a default of `true` - the accordion opens several panels instead, silently.
|
|
167
|
+
A property binding fails the build; a plain attribute does not.
|
|
168
|
+
|
|
169
|
+
- **`ds-dropzone` loses `single`; the file count is `multiple` and the width is a token.**
|
|
170
|
+
|
|
171
|
+
```html
|
|
172
|
+
<ds-dropzone [multiple]="true" />
|
|
173
|
+
```
|
|
174
|
+
```scss
|
|
175
|
+
ds-dropzone { --ds-dropzone-max-width: var(--col-cap-text); }
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Two booleans encoded one three-state fact. `single` set the file count, which `multiple` already
|
|
179
|
+
carried - its unset default takes one file, which is exactly what `single` did - and the
|
|
180
|
+
component resolved the overlap by making one silently win: `[multiple]="single() ? false :
|
|
181
|
+
multiple()"`. Setting both to `true` gave a single-file dropzone, with no error and no warning.
|
|
182
|
+
|
|
183
|
+
Separately, and with nothing in its name to say so, `single` capped the panel at
|
|
184
|
+
`--col-cap-text`. A narrow dropzone that takes several files could not be expressed at all. That
|
|
185
|
+
width is now `--ds-dropzone-max-width`, unset by default, which is how every other component
|
|
186
|
+
sizes itself.
|
|
187
|
+
|
|
188
|
+
Dropping the binding needs no thought about the count - `single` and an unset `multiple` were
|
|
189
|
+
the same file count. It does need a thought about the width: without the token the panel fills
|
|
190
|
+
its column, and nothing reports that.
|
|
191
|
+
|
|
192
|
+
**A drop now honours the count too.** The native `multiple` attribute constrains the file
|
|
193
|
+
PICKER and has no say over a drag, so dropping three files on a dropzone that takes one emitted
|
|
194
|
+
three - under `single` as much as without it, for as long as the component has shipped. Both
|
|
195
|
+
ways in run through one place now, and a drop of several files on a one-file dropzone keeps the
|
|
196
|
+
first.
|
|
197
|
+
|
|
198
|
+
- **`ds-line-chart` draws its plot through `ds-chart`, and two DOM hooks change with it.** The
|
|
199
|
+
second-axis gridline class is `.grid-line.is-secondary`, not `.grid-line.secondary`, and the
|
|
200
|
+
markers no longer carry `data-series-index` - they are numbered across the whole chart, so
|
|
201
|
+
`data-mark-index` alone names one reading.
|
|
202
|
+
|
|
203
|
+
```css
|
|
204
|
+
::ng-deep ds-line-chart .grid-line.is-secondary { stroke-dasharray: 2 6; }
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Every `--ds-line-chart-*` hook still reaches the plot; the preset re-points each one at the
|
|
208
|
+
container's own name. `.plot`, `.canvas`, `.axis-label`, `.series-line`, `.series-marker`,
|
|
209
|
+
`.cursor-line` and `.category-band` are all still there, and `.axis-label` gained
|
|
210
|
+
`.is-primary` / `.is-secondary`.
|
|
211
|
+
|
|
212
|
+
A selector that stops matching is valid CSS. The rule goes dead, the plot draws at its default,
|
|
213
|
+
and nothing reports either - which is also true of a test locator built on `data-series-index`.
|
|
214
|
+
|
|
215
|
+
- **The 96 typography hooks spell out their prefix: `--ds-t-*` is `--ds-typography-*`.** Every
|
|
216
|
+
name is otherwise unchanged - `--ds-t-h4-font-size` is `--ds-typography-h4-font-size`.
|
|
217
|
+
|
|
218
|
+
```css
|
|
219
|
+
:root { --ds-typography-h4-font-size: 1.375rem; }
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
`t` was the last abbreviation in the token surface and the one hardest to guess from the property
|
|
223
|
+
it sets: a reader looking for the h4 size in devtools sees `font-size` and has no route from
|
|
224
|
+
there to a single letter.
|
|
225
|
+
|
|
226
|
+
**The `.t-h4` / `.t-s` / `.t-mono-inline` classes keep their names.** They are the markup
|
|
227
|
+
vocabulary rather than tokens, and renaming them would rewrite every template that carries one.
|
|
228
|
+
|
|
229
|
+
A declaration left on an old name is valid CSS nobody reads. The type falls back to the global
|
|
230
|
+
`--font-size-*` behind each hook, which is near enough the overridden value that a page reads as
|
|
231
|
+
slightly off rather than broken.
|
|
232
|
+
|
|
233
|
+
### Added
|
|
234
|
+
|
|
235
|
+
- **`ds-chart-legend` sizes its colour chip from `--ds-chart-legend-swatch-size`.** The column, line
|
|
236
|
+
and scatter charts render the legend and take it, and a preset with a swatch token of its own
|
|
237
|
+
points that at it.
|
|
238
|
+
|
|
239
|
+
```css
|
|
240
|
+
ds-chart-legend { --ds-chart-legend-swatch-size: 14px; }
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
Defaults to `--space-2-5`, which is what the chip measured before.
|
|
244
|
+
|
|
245
|
+
- **`DS_CONFIG` takes `banner.announce` and `alert.announce`, the app-wide default for whether a
|
|
246
|
+
banner or an alert is spoken when it appears.**
|
|
247
|
+
|
|
248
|
+
```ts
|
|
249
|
+
provideDsConfig({ banner: { announce: true }, alert: { announce: true } });
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Both default to `false`, which is what the element already did. An app whose banners are raised in
|
|
253
|
+
response to events sets the key once and binds `[announce]="false"` on the strips that are page
|
|
254
|
+
furniture, instead of deciding at every element.
|
|
255
|
+
|
|
256
|
+
**The input reads `boolean | null` now**, with `null` meaning unset, because a signal input cannot
|
|
257
|
+
otherwise report whether it was bound. Writing the attribute is unchanged. A subclass that reads
|
|
258
|
+
`announce()` back gets the three-state value and wants `announceResolved()`, which is the one the
|
|
259
|
+
component's own ARIA reads.
|
|
260
|
+
|
|
261
|
+
- **`ds-chart` holds the category cursor: `cursorPin` and `tooltipLingerMs`.** A press holds the
|
|
262
|
+
cursor where it is until it is pressed again, Escape, or a press outside the plot; the linger is
|
|
263
|
+
the grace period that lets the pointer cross from the plot to a portaled tooltip panel.
|
|
264
|
+
|
|
265
|
+
```html
|
|
266
|
+
<ds-chart cursor="category" cursorPin [tooltipLingerMs]="180" [categories]="months">
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
Both are off by default. The cursor runs on the same state machine the element marks already
|
|
270
|
+
use, so a pin behaves identically whether it is held on a column or on a category.
|
|
271
|
+
|
|
272
|
+
- **`ds-chart` is exported as `dsChart`.** A template reference reads `cursorPinned()` and calls
|
|
273
|
+
`releaseCursor()`, which is what a preset needs to render its own way out of a held cursor.
|
|
274
|
+
|
|
275
|
+
```html
|
|
276
|
+
<ds-chart #plot="dsChart" cursor="category" cursorPin [categories]="months">
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
- **`g[dsLineSeries]` takes `highlighted` and `tooltipAnchor`.** `highlighted` is the id of the one
|
|
280
|
+
series to single out: with `dimOthers` beside it, that series keeps its colour and thickens while
|
|
281
|
+
the rest fade. `tooltipAnchor` decides where an `axis` panel hangs - `'reading'`, the default,
|
|
282
|
+
over the highest reading in the category, `'pointer'` following the cursor.
|
|
283
|
+
|
|
284
|
+
```html
|
|
285
|
+
<svg:g dsLineSeries dimOthers [highlighted]="hovered()" [data]="series()" />
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
Its markers also rove per series now: one tab stop per line, and the arrows walk that line rather
|
|
289
|
+
than every reading on the plot. A focused marker narrows an `axis` panel to its own series.
|
|
290
|
+
|
|
291
|
+
- **`ChartScales` carries `cursorPointer`**, the pointer position in client pixels, for a mark that
|
|
292
|
+
anchors a panel to the cursor rather than to a reading. `CHART_DEFAULT_VALUE_SPACE` is exported
|
|
293
|
+
alongside it, so a preset can reserve the same box the container will take.
|
|
294
|
+
|
|
295
|
+
- **`ds-chart-data-table` holds the annex table every chart was drawing itself.** The
|
|
296
|
+
`details`, the summary, the caption and the table; the chart supplies `columns` and `rows` of
|
|
297
|
+
already-formatted cells.
|
|
298
|
+
|
|
299
|
+
```html
|
|
300
|
+
<ds-chart-data-table [columns]="['Label', 'Value']" [rows]="tableRows()" [caption]="caption()" />
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
`rowHeader` renders each row's first cell as a `<th scope="row">`,
|
|
304
|
+
for a matrix whose rows are named rather than numbered. The formatting stays with the chart:
|
|
305
|
+
two charts reading the same number differently is a chart decision, not a table one.
|
|
306
|
+
|
|
307
|
+
- **`LineSeriesData` takes `lower`.** The band's floor, one entry per category: an `area` series
|
|
308
|
+
given one fills the band between the two curves rather than down to the baseline, which is what
|
|
309
|
+
a stacked plot draws.
|
|
310
|
+
|
|
311
|
+
```ts
|
|
312
|
+
{ id: 'pro', label: 'Pro', data: tops, lower: floors, area: true }
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
Unset, the fill reaches the baseline exactly as before. The caller that owns the pile is the one
|
|
316
|
+
that knows where each band starts - a mark never sees the other marks. A `null` must sit in the
|
|
317
|
+
same categories `data` has one, or the two sides break in different places.
|
|
318
|
+
|
|
319
|
+
- **`g[dsLineSeries]` takes `tooltip="axis"`.** It names every series of that mark at the
|
|
320
|
+
category under the pointer, rather than the one marker hovered.
|
|
321
|
+
|
|
322
|
+
```html
|
|
323
|
+
<ds-chart cursor="category" [categories]="months">
|
|
324
|
+
<svg:g #line="dsLineSeries" dsLineSeries tooltip="axis" [data]="series"
|
|
325
|
+
[dsChartTooltip]="line.tooltipContext()"
|
|
326
|
+
[dsChartTooltipOrigin]="line.tooltipOrigin()" />
|
|
327
|
+
</ds-chart>
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
It follows the container rather than its own hover: set `cursor="category"` on `ds-chart`
|
|
331
|
+
beside it and the panel anchors to the band the cursor draws, which is also what tells the
|
|
332
|
+
reader which category is being named. `'item'` stays the default, so no chart changes on its
|
|
333
|
+
own. `ChartScales` gains `cursorOrigin` for it - the band element, or `null` while the cursor
|
|
334
|
+
is off.
|
|
335
|
+
|
|
336
|
+
- **`g[dsSeriesAnnotation]` pins labels to readings.** A peak, a launch, the month a number
|
|
337
|
+
turned - legible in a printed page or a screenshot, where a tooltip is not.
|
|
338
|
+
|
|
339
|
+
```html
|
|
340
|
+
<ds-chart [categories]="months">
|
|
341
|
+
<svg:g dsLineSeries [data]="series" />
|
|
342
|
+
<svg:g dsSeriesAnnotation [annotations]="notes" />
|
|
343
|
+
</ds-chart>
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
It takes the readings rather than finding them: a mark never sees the other marks, so the caller
|
|
347
|
+
that owns the series is the one that knows which value a label belongs to. It reports no domain,
|
|
348
|
+
because the series it annotates already did.
|
|
349
|
+
|
|
350
|
+
- **`ds-chart` takes `cursor`.** `'category'` draws a band and a crosshair down the category
|
|
351
|
+
under the pointer, and reports that category to every mark through the shared scales.
|
|
352
|
+
|
|
353
|
+
```html
|
|
354
|
+
<ds-chart cursor="category" [categories]="weeks">…</ds-chart>
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
`'none'` is the default and what every chart drew before. A plot whose marks are themselves the
|
|
358
|
+
hover targets already answers per mark, and two affordances on one plot read as two different
|
|
359
|
+
questions - so the whole-column cursor is the opt-in, not the baseline.
|
|
360
|
+
|
|
361
|
+
- **`ds-chart` takes `maxSecondary`.** It pins the ceiling of the second value axis the way
|
|
362
|
+
`max` pins the first.
|
|
363
|
+
|
|
364
|
+
```html
|
|
365
|
+
<ds-chart [max]="40000" [maxSecondary]="250000" [categories]="months">…</ds-chart>
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
Two plots read against each other need both axes pinned, or the second one rescales under the
|
|
369
|
+
reader when a series loses its tallest value. Unset, the axis is derived from what the marks
|
|
370
|
+
report, which is what it did before.
|
|
371
|
+
|
|
372
|
+
- **A published input can now name its own type.** `g[dsColumnSeries]` and `g[dsLineSeries]` ship
|
|
373
|
+
from the package root, and two of their inputs were typed by symbols the root did not export:
|
|
374
|
+
`offsets` by `ChartStackOffset`, and `curve` by a type that existed twice.
|
|
375
|
+
|
|
376
|
+
```ts
|
|
377
|
+
import type { ChartCurve, ChartStackOffset } from '@ids-group-ltd/ids-design-system';
|
|
378
|
+
import { stackOffsets } from '@ids-group-ltd/ids-design-system';
|
|
379
|
+
```
|
|
380
|
+
|
|
381
|
+
`ChartStackOffset` and `stackOffsets` are published, so a consumer composing a stacked plot out
|
|
382
|
+
of the marks can both compute the offsets and annotate them. `LineCurve` and `LineChartCurve`
|
|
383
|
+
were declared character-identical in two files - one internal, one published - and are one
|
|
384
|
+
`ChartCurve` in `core`, beside `ChartAxisMode` and `ChartGaps`. Both curve names were new in
|
|
385
|
+
this release, so nothing shipped under them.
|
|
386
|
+
|
|
387
|
+
- **`ds-checkbox` gets the three hooks its label already half had.** `--ds-checkbox-row-align`
|
|
388
|
+
for how the box and its label line up, `--ds-checkbox-gap` for the space between them, and
|
|
389
|
+
`--ds-checkbox-message-indent` for the hint.
|
|
390
|
+
|
|
391
|
+
```scss
|
|
392
|
+
ds-checkbox { --ds-checkbox-message-indent: calc(var(--check-glyph-md) + var(--space-2)); }
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
The hint sits under the box, which is where it has always been; set the indent to the box plus
|
|
396
|
+
the gap and it lines up with the label instead. The other two defaults draw what the component
|
|
397
|
+
drew before, so nothing moves on its own.
|
|
398
|
+
|
|
399
|
+
- **`ds-segmented` takes `joined`.** The segments share their edges instead of floating in a
|
|
400
|
+
padded track: adjacent borders collapse into one hairline and only the two ends carry the group
|
|
401
|
+
radius.
|
|
402
|
+
|
|
403
|
+
```html
|
|
404
|
+
<ds-segmented joined [options]="ranges" [(value)]="range" />
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
It needs `--ds-segmented-segment-border` set, because the shared edge IS the border. Off by
|
|
408
|
+
default, which is the padded track every consumer draws today.
|
|
409
|
+
|
|
410
|
+
- **`ds-button` takes `align`.** `'center'` is the default and what every button already drew;
|
|
411
|
+
`'between'` pushes the label and a trailing icon to opposite edges.
|
|
412
|
+
|
|
413
|
+
```html
|
|
414
|
+
<ds-button fullWidth align="between" icon="arrowRight">Continue</ds-button>
|
|
415
|
+
```
|
|
416
|
+
|
|
417
|
+
It only shows once something widens the button past its contents, so on an inline button the two
|
|
418
|
+
values are identical. Named values rather than a `justify-content` token: the shape a full-width
|
|
419
|
+
action wants is the label at one edge and the arrow at the other, and publishing the CSS property
|
|
420
|
+
would publish every other flex arrangement with it.
|
|
421
|
+
|
|
422
|
+
- **`ds-pagination` takes `size` and `layout`.** `size` is the sm/md/lg control scale the rest of
|
|
423
|
+
the library uses, unset resolving `DS_CONFIG.control.size` and then `sm`, which is the height the
|
|
424
|
+
pager already had. `layout="spread"` gives the nav full width and pushes the count label and the
|
|
425
|
+
controls to opposite edges; `'grouped'`, the default, keeps them together.
|
|
426
|
+
|
|
427
|
+
```html
|
|
428
|
+
<ds-pagination size="md" layout="spread" [total]="rows.length" [(currentPage)]="page" />
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
A pager under a full-width table needs bigger targets than the dense default, and that is a
|
|
432
|
+
density question the scale already answers everywhere else.
|
|
433
|
+
|
|
434
|
+
- **Seven styling hooks where a consumer was reaching past the surface.** Each one is a property
|
|
435
|
+
the component tokenised everything around and not itself, so the only way to set it was a rule
|
|
436
|
+
that doubles a class to out-specify our compiled selector.
|
|
437
|
+
|
|
438
|
+
```scss
|
|
439
|
+
ds-badge { --ds-badge-letter-spacing: 0.01em; }
|
|
440
|
+
ds-pagination { --ds-pagination-label-text-transform: uppercase; }
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
`--ds-badge-letter-spacing`; `--ds-pagination-label-letter-spacing` and
|
|
444
|
+
`--ds-pagination-label-text-transform`; `--ds-option-color` for an unselected picker row, whose
|
|
445
|
+
selected sibling had a colour token all along; `--ds-dropdown-empty-color` and
|
|
446
|
+
`--ds-dropdown-empty-font-size` for the panel's no-results line; and
|
|
447
|
+
`--ds-autocomplete-input-font-size`.
|
|
448
|
+
|
|
449
|
+
Every default is the value the component already drew, so a chart of the surface before and
|
|
450
|
+
after is identical. The no-results line takes `inherit` as its size default, which is what it
|
|
451
|
+
resolved to when it declared none.
|
|
452
|
+
|
|
453
|
+
The empty line's tokens are named for the dropdown panel rather than spelled `--ds-empty-*`,
|
|
454
|
+
because `--ds-empty-state-*` is a different component and the two would have sat one hyphen
|
|
455
|
+
apart meaning unrelated things.
|
|
456
|
+
|
|
457
|
+
- **Each axis says which numbers it is counting, and in whose colour.** A plot carrying two scales
|
|
458
|
+
is ambiguous without both: nothing on the canvas says which line is read against which set of
|
|
459
|
+
numbers, and nothing says what those numbers ARE.
|
|
460
|
+
|
|
461
|
+
```html
|
|
462
|
+
<ds-line-chart yAxisLabel="Sessions" secondaryAxisLabel="Rate, %" [series]="series" />
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
`ds-line-chart` takes `yAxisLabel` and `secondaryAxisLabel`, and tints each axis with the colour
|
|
466
|
+
of the series measured against it - derived, not asked for, since the chart already knows its own
|
|
467
|
+
series colours. The tint appears only where two scales share one plot: on a single-scale chart it
|
|
468
|
+
would restate the marks' own colour in the furniture, and under `'split'` the two plots are
|
|
469
|
+
already apart. `ds-chart` takes the same pair as `axisLabel` and `secondaryAxisLabel`.
|
|
470
|
+
|
|
471
|
+
**On a two-scale plot, where the lines cross depends on the scale chosen, not on the data.** One
|
|
472
|
+
dataset drawn twice crosses between February and March with the right axis at 5% and never meets
|
|
473
|
+
with it at 12%, without a single reading changing. Naming and tinting each axis is what tells the
|
|
474
|
+
reader which scale a line is read against.
|
|
475
|
+
|
|
476
|
+
- **Category labels turn before they thin.** A chart narrow enough for its labels to collide used to
|
|
477
|
+
print them over each other. It now measures the widest one as it actually rendered and spends the
|
|
478
|
+
cheaper remedy first: a 45-degree tilt, which takes about 71% of the label's width across the
|
|
479
|
+
axis, and only past that does it draw every second or every third.
|
|
480
|
+
|
|
481
|
+
Rotation is spent before thinning because a tilt costs the reader a glance and a dropped label
|
|
482
|
+
costs them a reading. The widest label decides for all of them: an axis that thinned on the
|
|
483
|
+
average would still collide on the one long name.
|
|
484
|
+
|
|
485
|
+
- **`ds-scatter-chart`, with a decimation layer behind it.** Two continuous quantities against each
|
|
486
|
+
other - weight against carriage cost, distance against time. The other charts all put categories
|
|
487
|
+
on one axis; this one does not.
|
|
488
|
+
|
|
489
|
+
```html
|
|
490
|
+
<ds-scatter-chart
|
|
491
|
+
xLabel="Weight, kg"
|
|
492
|
+
yLabel="Cost"
|
|
493
|
+
[data]="[{ id: 'road', label: 'Road', data: readings }]" />
|
|
494
|
+
```
|
|
495
|
+
|
|
496
|
+
**It is the only chart whose mark count the caller decides**, so it is the only one that thins its
|
|
497
|
+
own data. SVG degrades by the number of NODES, not readings: the same data as a line is one
|
|
498
|
+
`<path>` and as a scatter it is one node per point, while Lighthouse warns at about 800 nodes and
|
|
499
|
+
errors at about 1400 on a page that may hold four more charts. Past FOUR times the plot's width in
|
|
500
|
+
marks - not two, where the saving is invisible and the loss of detail is not - the series is
|
|
501
|
+
decimated, a line under the plot says how many readings were thinned, and the annex table still
|
|
502
|
+
lists every one.
|
|
503
|
+
|
|
504
|
+
`decimator` picks how. `'minMax'`, the default, keeps each bucket's highest and lowest reading by
|
|
505
|
+
construction, so the spike a reader is looking for cannot be the point that was dropped; it also
|
|
506
|
+
stays stable while the reader pans, because a bucket's answer does not depend on its neighbours.
|
|
507
|
+
`'lttb'` draws a truer silhouette at the same budget and makes no such promise. `'none'` is the
|
|
508
|
+
caller taking the node budget on themselves.
|
|
509
|
+
|
|
510
|
+
The annex table is built when it is OPENED rather than sitting in the DOM shut, where one node per
|
|
511
|
+
reading would undo what decimating the plot saved; opened, every reading is one click away.
|
|
512
|
+
|
|
513
|
+
Marks are semi-transparent by default, because the interesting thing is where they pile up: at
|
|
514
|
+
full opacity a cluster of forty and a cluster of four are the same solid disc. `xLabel` and
|
|
515
|
+
`yLabel` are not decoration - without them the reader has two numbers and no idea which is which.
|
|
516
|
+
|
|
517
|
+
- **`ds-bar-chart` takes a value range, a target and qualitative bands.** Three small additions that
|
|
518
|
+
turn the same bar into a floating bar and into a bullet chart, neither of which needed a component
|
|
519
|
+
of its own.
|
|
520
|
+
|
|
521
|
+
```html
|
|
522
|
+
<ds-bar-chart [data]="[
|
|
523
|
+
{ label: 'Build', value: [2, 9] },
|
|
524
|
+
{ label: 'Revenue', value: 268, target: 250, ranges: [150, 220, 300] },
|
|
525
|
+
]" />
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
A row's `value` may be a `[low, high]` pair, and the bar then spans between its own ends rather
|
|
529
|
+
than from zero - what compares a duration and its PLACEMENT at once, which a bar from zero cannot
|
|
530
|
+
do. The ends may be written either way round, because a reader who reverses them means the same
|
|
531
|
+
band. `BarChartRow.value` is now `BarChartValue`, `number | readonly [low: number, high: number]`,
|
|
532
|
+
so code that READS `row.value` as a number stops compiling; code that only writes it is
|
|
533
|
+
unaffected. `target` draws a tick at one reading; `ranges` paints bands behind the bar, given as their
|
|
534
|
+
upper bounds in ascending order.
|
|
535
|
+
|
|
536
|
+
The bands take one neutral hue at rising opacity rather than the series palette: a band is a
|
|
537
|
+
backdrop and the bar is the reading, so a second palette behind them would compete with the bars.
|
|
538
|
+
The track's scale holds the target and the outermost band as well as the bars, so a goal above
|
|
539
|
+
every reading still lands on the plot. `--ds-bar-chart-band-color`,
|
|
540
|
+
`--ds-bar-chart-target-color`, `--ds-bar-chart-target-width` and `--ds-bar-chart-target-overhang`
|
|
541
|
+
tune them.
|
|
542
|
+
|
|
543
|
+
- **`ds-waterfall-chart`: a running total, bar by bar.** What a figure started at, what moved it,
|
|
544
|
+
and what it ended at - the one variant in the family that genuinely cannot be a mode on another,
|
|
545
|
+
because it needs an accumulating level, bars pinned to zero for the totals and its own
|
|
546
|
+
three-colour semantic all at once.
|
|
547
|
+
|
|
548
|
+
```html
|
|
549
|
+
<ds-waterfall-chart caption="Settlement" [data]="[
|
|
550
|
+
{ label: 'Billed', value: 1200, kind: 'total' },
|
|
551
|
+
{ label: 'Commission', value: -320 },
|
|
552
|
+
{ label: 'Net', value: 0, kind: 'total' },
|
|
553
|
+
]" />
|
|
554
|
+
```
|
|
555
|
+
|
|
556
|
+
Every row adds its `value` to the running sum wherever it sits. A `'delta'`, the default, hangs
|
|
557
|
+
from the level the bar before it left off at; a `'total'` or `'subtotal'` stands on zero at the
|
|
558
|
+
sum reached. A closing total carries `value: 0` and prints the sum, not a change of its own; a
|
|
559
|
+
subtotal differs from a total only in that the chain carries on past it. The order is never
|
|
560
|
+
sorted, because the sequence is the meaning.
|
|
561
|
+
|
|
562
|
+
**Colour never carries the meaning alone.** Each bar prints its own sign above it and each bar's
|
|
563
|
+
accessible name says "increase", "decrease" or "total" in words. The new
|
|
564
|
+
`--ds-chart-positive-color` and `--ds-chart-negative-color` point at the palette's two lead hues
|
|
565
|
+
rather than at `--success` and `--error`: a waterfall's up and down are not success and failure,
|
|
566
|
+
and a cost rising is a rise and a bad one. A total takes `--ds-chart-series-default-color`.
|
|
567
|
+
|
|
568
|
+
`showConnectors` draws the dashed rule chaining one bar to the next at the level they share.
|
|
569
|
+
|
|
570
|
+
- **`ds-heatmap-chart`: a matrix of readings coloured by magnitude.** Depot by weekday, hour by
|
|
571
|
+
date, queue by region - the case where the interesting thing is the shape of a whole grid rather
|
|
572
|
+
than any one reading in it.
|
|
573
|
+
|
|
574
|
+
```html
|
|
575
|
+
<ds-heatmap-chart
|
|
576
|
+
caption="Collections a day, by depot"
|
|
577
|
+
[columns]="weekdays"
|
|
578
|
+
[data]="depots" />
|
|
579
|
+
```
|
|
580
|
+
|
|
581
|
+
`data` is one `HeatmapChartRow` per row, each carrying one reading per column.
|
|
582
|
+
|
|
583
|
+
**Two things are not optional here.** Colour is the only channel carrying the quantity on the
|
|
584
|
+
grid, so the scale under it and the annex table below it are always drawn - there is no
|
|
585
|
+
`dataTable` input to turn the table off, because WCAG 1.4.1 is not satisfied by a grid of coloured
|
|
586
|
+
squares. Every cell also names its own reading to assistive tech as `row, column: value`.
|
|
587
|
+
|
|
588
|
+
**A `null` reading is a hole, not a low value.** It draws as the surface, stays out of the colour
|
|
589
|
+
scale, is inert under `interactive` and never fires `cellClicked`. The ramp's coldest step is a
|
|
590
|
+
real measurement, and painting "we never measured this" with it states a figure nobody recorded.
|
|
591
|
+
|
|
592
|
+
`min` and `max` pin the scale and only ever open it further; set both to compare two heat maps by
|
|
593
|
+
colour, because unset each one spans its own readings and the same hue means a different quantity
|
|
594
|
+
on each. `showValues` prints the readings in the cells, drawing each glyph in its own cell's
|
|
595
|
+
colour inverted so it stays legible at both ends of the heat scale, which runs 1.14:1 to 9.07:1
|
|
596
|
+
against white.
|
|
597
|
+
|
|
598
|
+
- **A heat scale, `--ds-chart-heat-1..8`, separate from the ramp.** Magnitude on a grid is read
|
|
599
|
+
from the step between two colours and nothing else, and the ramp does not give one: its adjacent
|
|
600
|
+
steps are 2.1-3.9 dE apart with 20.7 end to end, so eight cells show about three the eye can
|
|
601
|
+
separate. The heat scale runs the same hue across the full lightness range, 95% to 31%, which is
|
|
602
|
+
6.9-10.6 with 55.0 end to end (OKLab).
|
|
603
|
+
|
|
604
|
+
**`--ds-chart-ramp-*` is unchanged and `ds-funnel-chart` looks exactly as it did.** The two scales
|
|
605
|
+
want opposite things: a funnel's stages are a shape read at a glance, where a stage at either
|
|
606
|
+
extreme reads as a different object rather than as the next step, and a heat map needs every step
|
|
607
|
+
the eye can hold. `ds-heatmap-chart` is the only thing painting with the heat scale.
|
|
608
|
+
|
|
609
|
+
Contrast on white runs 1.14:1 to 9.07:1 across it, so a label placed over a heat colour is chosen
|
|
610
|
+
against that cell's own end of the scale rather than once for the whole of it. The dark theme
|
|
611
|
+
carries the same span, flipped.
|
|
612
|
+
|
|
613
|
+
- **`stack` on the line: several series as a composition rather than as separate readings.** A set
|
|
614
|
+
of lines answers "how is each one doing"; a stack answers "what is the total made of", which is a
|
|
615
|
+
different question and the one a mix of tiers usually asks.
|
|
616
|
+
|
|
617
|
+
```html
|
|
618
|
+
<ds-line-chart stack="stacked" [categories]="months" [series]="tiers" />
|
|
619
|
+
```
|
|
620
|
+
|
|
621
|
+
`'stacked'` starts each series where the one below it ended; `'normalized'` divides by the
|
|
622
|
+
category's own total, so every category is full and the axis reads in shares. `'none'` stays the
|
|
623
|
+
default and nothing changes without asking. Only a series with `area: true` fills - the lines sit
|
|
624
|
+
on the running total either way.
|
|
625
|
+
|
|
626
|
+
A stacked band fills down to the series below it rather than to the baseline, and the boundary is
|
|
627
|
+
a 2px stroke in the surface colour rather than a drawn rule, which survives print and
|
|
628
|
+
colour-vision deficiency. Stacking runs per AXIS, so a secondary-axis series never piles onto one
|
|
629
|
+
measured against the primary. `stack="stacked"` and `yAxisMode="split"` are different things:
|
|
630
|
+
series on top of each other, against two plots one above the other.
|
|
631
|
+
|
|
632
|
+
- **`curve` on the line: `'linear'`, `'step'` or `'smooth'`.** A line drawn between two readings is
|
|
633
|
+
a claim about what happened in between, and this is where the claim is made. `'linear'` stays the
|
|
634
|
+
default and asserts nothing the data does not say.
|
|
635
|
+
|
|
636
|
+
```html
|
|
637
|
+
<ds-line-chart curve="step" [categories]="months" [series]="baseRate" />
|
|
638
|
+
```
|
|
639
|
+
|
|
640
|
+
`'step'` holds each reading until the next, which is what a quantity that CHANGES at a moment
|
|
641
|
+
actually did - a price, a headcount, a rate - rather than drifting between two. `'smooth'` is a
|
|
642
|
+
monotone cubic, NOT a Catmull-Rom: a Catmull-Rom overshoots, drawing a trough below a minimum the
|
|
643
|
+
data never reaches, which on a chart is a reading that does not exist.
|
|
644
|
+
|
|
645
|
+
A filled series follows the same curve, so the fill and its own line share one edge instead of the
|
|
646
|
+
line floating off a straight-edged fill. `dsLineSeries` takes the same input with the same three
|
|
647
|
+
words, so a composed plot and a preset draw one series the same way.
|
|
648
|
+
|
|
649
|
+
- **The chart container's marks are published API.** `ColumnSeriesComponent`,
|
|
650
|
+
`LineSeriesComponent`, `ReferenceLineComponent` and `ReferenceLabelComponent`, with
|
|
651
|
+
`ColumnSeriesPoint` and `LineSeriesData`, come from the package root as well as
|
|
652
|
+
from `@ids-group-ltd/ids-design-system/components/chart`, and every input on them is documented.
|
|
653
|
+
|
|
654
|
+
In `0.13.3` they sat in the `components/chart` entry point still marked `@internal`: reachable
|
|
655
|
+
there, but not public API. Nothing about how they are written
|
|
656
|
+
changes - a mark is still an ATTRIBUTE selector on a real `<svg:g>`. What changes is that a combo
|
|
657
|
+
plot, the case the container exists for, can now be assembled by a consumer: no preset draws
|
|
658
|
+
columns and a cumulative line on two axes, so the marks were the only route to it and were not
|
|
659
|
+
reachable as one.
|
|
660
|
+
|
|
661
|
+
### Changed
|
|
662
|
+
|
|
663
|
+
- **A `+N` strip says how many toasts are waiting.** `maxVisible` has always queued the extras, and
|
|
664
|
+
nothing on screen said so: past the cap a toast simply did not appear. The region now renders a
|
|
665
|
+
small counter at the end the next toast will come from - above a top-anchored stack, below a
|
|
666
|
+
bottom-anchored one - and it disappears the moment the queue empties. It is `aria-hidden`, because
|
|
667
|
+
`ToastService` announces every toast through the LiveAnnouncer, queued ones included, so a reader
|
|
668
|
+
has already heard everything it counts.
|
|
669
|
+
|
|
670
|
+
On by default. Turn it off with `DS_CONFIG.toast.showQueueCount: false` or
|
|
671
|
+
`[showQueueCount]="false"` on `ds-toast-region`. Colours come from
|
|
672
|
+
`--ds-toast-queue-bg-color` and `--ds-toast-queue-text-color`.
|
|
673
|
+
|
|
674
|
+
- **`ds-toast`, `ds-banner` and `ds-alert` grow into place instead of fading in.** Their default
|
|
675
|
+
`--ds-<surface>-enter-keyframes` moves from `ds-fade-in` to `ds-scale-in`, so all three now enter
|
|
676
|
+
the way `ds-modal` and the overlay panels already do: opacity plus a growth from `--ds-*-enter-scale`,
|
|
677
|
+
which each of them has declared since motion shipped and which `ds-fade-in` never read. They grow
|
|
678
|
+
from their own centre - `transform-origin` stays unset, as on `ds-modal`.
|
|
679
|
+
|
|
680
|
+
`--ds-toast-enter-offset`, `--ds-banner-enter-offset` and `--ds-alert-enter-offset` keep their
|
|
681
|
+
values and their meaning: a preset that travels reads them, so pointing a surface at `ds-slide-in`
|
|
682
|
+
still gets that surface's own distance and direction. Set
|
|
683
|
+
`--ds-toast-enter-keyframes: ds-fade-in` to keep the old entrance.
|
|
684
|
+
|
|
685
|
+
A value already set on `--ds-toast-enter-scale`, `--ds-banner-enter-scale` or
|
|
686
|
+
`--ds-alert-enter-scale` did nothing under `ds-fade-in` and takes effect now - a `0.5` left behind
|
|
687
|
+
becomes a visible lurch rather than a no-op.
|
|
688
|
+
|
|
689
|
+
- **Portaled panels grow out of their trigger instead of fading in place.** The default of
|
|
690
|
+
`--ds-overlay-enter-keyframes` moves from `ds-fade-in` to `ds-scale-in`, so every panel carrying
|
|
691
|
+
`ds-overlay-pane` - select, autocomplete, multi-select, the three pickers, popover, tooltip, the
|
|
692
|
+
chart tooltip and the menu submenu - grows out of its trigger.
|
|
693
|
+
|
|
694
|
+
```css
|
|
695
|
+
:root { --ds-overlay-enter-keyframes: ds-fade-in; }
|
|
696
|
+
```
|
|
697
|
+
|
|
698
|
+
`--_overlay-enter-origin` is already resolved per placement, so a panel below its trigger grows
|
|
699
|
+
from its top edge and one above it from its bottom. Drawer, bottom-sheet, toast, banner and alert
|
|
700
|
+
each name their own keyframe and never read this one; drawer and bottom-sheet keep their edge
|
|
701
|
+
slide, and the other three change under their own entry.
|
|
702
|
+
|
|
703
|
+
- **`ds-line-chart` measures its plot instead of scaling a fixed viewBox.** One unit is one CSS
|
|
704
|
+
pixel, the axis gutter widens to the widest tick label as it actually rendered, and the category
|
|
705
|
+
labels tilt then thin when they stop fitting - the same treatment `ds-column-chart` and
|
|
706
|
+
`ds-chart` already got.
|
|
707
|
+
|
|
708
|
+
**`--ds-line-chart-plot-height` now drives the plot.** It has been declared since the chart
|
|
709
|
+
shipped and reached only the loading skeleton: the plot was a 640x320 viewBox scaled to the
|
|
710
|
+
card's width, so the token parsed and changed nothing. The empty and error boxes reserve the
|
|
711
|
+
height the plot will take rather than a width-derived ratio, so the card no longer moves when the
|
|
712
|
+
last series is switched off.
|
|
713
|
+
|
|
714
|
+
Escape now releases the category cursor and its panel together, a tap latches the cursor the way
|
|
715
|
+
a tap on a column latches that column, and a pointer that leaves the plot for the tooltip panel
|
|
716
|
+
keeps it open. None of that was reachable before without a pin.
|
|
717
|
+
|
|
718
|
+
- **Exported class member surface grew, and some members were renamed or retyped - this matters
|
|
719
|
+
only if you SUBCLASS one of these.** `ButtonComponent` gained `align`; `SegmentedComponent` gained
|
|
720
|
+
`joined`; `PaginationComponent` gained `layout`, `size`, `sizeResolved` and `navClass`;
|
|
721
|
+
`DropzoneComponent` gained `emitPicked`; `ToastRegionComponent` gained `showQueueCount` and
|
|
722
|
+
`queuedLabel`; `AlertComponent` and `BannerComponent` each gained
|
|
723
|
+
`announceResolved` and widened `announce` to `boolean | null`. `ChartComponent` gained 21 members -
|
|
724
|
+
the cursor, second-axis and category-label machinery, `cursor`, `cursorPin`, `cursorPinned`,
|
|
725
|
+
`cursorPointer`, `releaseCursor`, `maxSecondary`, `axisLabel`, `secondaryAxisLabel`,
|
|
726
|
+
`tooltipLingerMs` and `defaults` among them. `LineChartComponent` gained 24 (`curve`, `stack`,
|
|
727
|
+
`yAxisLabel`, `secondaryAxisLabel`, `plot`, `plotHeight` and the rest) and lost 51 protected and
|
|
728
|
+
private geometry members now that its plot is drawn by `ds-chart`, so a subclass that overrode one
|
|
729
|
+
of those overrides nothing. `LineSeriesComponent`, public now, gained 17 (`curve`, `dimOthers`,
|
|
730
|
+
`highlighted`, `patterns`, `pinOnClick`, `stacked`, `tooltipAnchor` and their helpers). Every
|
|
731
|
+
chart gained the `defaults` and the table rows it hands `ds-chart-data-table`:
|
|
732
|
+
`BarChartComponent`, `ColumnChartComponent`, `FunnelChartComponent`, `PieChartComponent` and
|
|
733
|
+
`LineChartComponent`, and the three new ones, `HeatmapChartComponent`, `ScatterChartComponent` and
|
|
734
|
+
`WaterfallChartComponent`, carry the same members.
|
|
735
|
+
|
|
736
|
+
Some members changed name or type rather than only being added. `AccordionComponent` traded
|
|
737
|
+
`multi` for `multiple`, `TableComponent` `sortDir` / `sortDirChange` for `sortDirection` /
|
|
738
|
+
`sortDirectionChange`, and `PieChartComponent` `thickness` for `innerRadius`.
|
|
739
|
+
`AppLayoutComponent.scrollReset`, `DatePickerComponent.value` and several chart members
|
|
740
|
+
(`ChartComponent.secondaryAxisMode`, `LineChartComponent.gaps` / `pointClicked` / `yAxisMode`,
|
|
741
|
+
`PieChartComponent.data`) changed type with the symbol renames, so an override typed against the
|
|
742
|
+
old symbol stops compiling.
|
|
743
|
+
|
|
744
|
+
Subclassing a DS component is unsupported, but a release that only adds can still fail such a build
|
|
745
|
+
on a name collision: TS4114 demands `override` for a same-named member, TS2416 fires where the
|
|
746
|
+
signature differs. Rename your own member, or add `override` where it genuinely means the same
|
|
747
|
+
thing.
|
|
748
|
+
|
|
749
|
+
### Fixed
|
|
750
|
+
|
|
751
|
+
- **`ds-chart`'s error message was grey.** Its template marks the message `is-error`, but `ds-chart`
|
|
752
|
+
carried no colour rule for that state, so "Could not load the data" printed in the same grey as
|
|
753
|
+
"No data". It is `--error` red now, matching what the other charts already showed.
|
|
754
|
+
|
|
755
|
+
- **The funnel and pie focus hooks did nothing.** `--ds-funnel-chart-focus-color` / `-width`, and
|
|
756
|
+
the pie's pair (`--ds-donut-chart-focus-color` / `-width` before the rename, now
|
|
757
|
+
`--ds-pie-chart-focus-color` / `-width`), resolved into a private name no rule read: an override
|
|
758
|
+
parsed, cascaded and changed no pixel. Each now points its pair at `--ds-chart-focus-ring-color`
|
|
759
|
+
and `--focus-ring-*`, which draws the ring.
|
|
760
|
+
|
|
761
|
+
- **`--ds-table-head-height` is in the token reference, and the loading scrim honours it.** The
|
|
762
|
+
hook, spelled `--ds-table-head-h` before this release, only ever existed as a string inside a
|
|
763
|
+
template attribute rather than in a stylesheet, so the token reference never listed it.
|
|
764
|
+
|
|
765
|
+
```css
|
|
766
|
+
ds-table { --ds-table-head-height: 56px; }
|
|
767
|
+
```
|
|
768
|
+
|
|
769
|
+
It resolves through `--_table-head-height` on the host now, between the pin and the measured row
|
|
770
|
+
height the component publishes: a consumer value wins over the measurement, the measurement wins
|
|
771
|
+
over the 40px floor.
|
|
772
|
+
|
|
773
|
+
- **An indeterminate `ds-bar` is on the track for most of its cycle instead of under half of it.**
|
|
774
|
+
The sliding chunk ran on the standard ease curve, which decelerates into the end of a transition -
|
|
775
|
+
on a loop there is no end, so it crawled at both extremes, where the chunk sits outside the track.
|
|
776
|
+
Over one 1400ms cycle the chunk was at least partly on the track 48.3% of the time; it is now
|
|
777
|
+
86.7%. On a short track that reads as an empty bar rather than a busy one.
|
|
778
|
+
|
|
779
|
+
```html
|
|
780
|
+
<ds-bar indeterminate ariaLabel="Importing" />
|
|
781
|
+
```
|
|
782
|
+
|
|
783
|
+
Nothing to change - the geometry, the duration and the 30% chunk are the same, and the reduced-motion
|
|
784
|
+
branch still replaces the animation with a full track.
|
|
785
|
+
|
|
786
|
+
- **`--ds-line-chart-swatch-size` reaches the swatch again.** The token has been declared and
|
|
787
|
+
documented since the chart shipped and reached nothing since the legend became its own component:
|
|
788
|
+
the line chart kept the `.legend-swatch` rule that read it and stopped rendering the element.
|
|
789
|
+
|
|
790
|
+
```css
|
|
791
|
+
ds-line-chart { --ds-line-chart-swatch-size: 14px; }
|
|
792
|
+
```
|
|
793
|
+
|
|
794
|
+
The chart forwards it to `--ds-chart-legend-swatch-size` now, and the three dead legend rules are
|
|
795
|
+
gone. The default is unchanged: the legend's own `--space-2-5` is the 10px the token always
|
|
796
|
+
claimed, so no chart moves.
|
|
797
|
+
|
|
798
|
+
- **A rule on `.ds-overlay-pane` now decides an autocomplete's panel radius, and either picker's
|
|
799
|
+
panel background.** Each picker declared its panel tokens with a fallback, so they always computed
|
|
800
|
+
to something and were always copied onto the portaled pane as an inline style - which outranks a
|
|
801
|
+
pane-class rule, the only route a consumer has to a panel that is not a descendant of its trigger.
|
|
802
|
+
A shell that squared `--ds-radius-panel` and re-rounded `.ds-overlay-pane` got the rounded panel
|
|
803
|
+
everywhere except autocomplete; multi-select never pinned a radius, only its background.
|
|
804
|
+
|
|
805
|
+
```scss
|
|
806
|
+
.ds-overlay-pane .dropdown-panel { border-radius: var(--ds-radius-panel); } // now applies
|
|
807
|
+
```
|
|
808
|
+
|
|
809
|
+
Nothing moves at the defaults: unset, the tokens fall to the same values the shared panel
|
|
810
|
+
stylesheet has always supplied. `--ds-autocomplete-panel-radius`,
|
|
811
|
+
`--ds-autocomplete-panel-bg-color` and `--ds-multi-select-panel-bg-color` still reach the pane and
|
|
812
|
+
still outrank a pane-class rule, which is what they are for.
|
|
813
|
+
|
|
814
|
+
- **The two greens in the chart palette are no longer the same colour.**
|
|
815
|
+
`--chart-categorical-6` moves from `hsl(152deg 58% 41%)` to `hsl(148deg 58% 41%)`, which takes it
|
|
816
|
+
from 5.3 to 6.3 away from `--chart-categorical-2` in OKLab. The palette holds itself to 6, below
|
|
817
|
+
which two slots read as one to somebody glancing between a line and its legend swatch - and these
|
|
818
|
+
two sit four positions apart, so a chart with six or more series handed out both.
|
|
819
|
+
|
|
820
|
+
All 28 pairs in the palette now sit at least 6 apart.
|
|
821
|
+
|
|
822
|
+
Nothing to change in a consumer - the token name is the same and the new hue arrives with it.
|
|
823
|
+
|
|
824
|
+
- **A chart tooltip no longer runs off the screen.** The panel is never shrunk by the overlay, so a
|
|
825
|
+
tall one - a grouped chart's every series, or a long custom template - was pushed until its top
|
|
826
|
+
met the viewport and the rest ran off the bottom, where nothing could reach it.
|
|
827
|
+
|
|
828
|
+
It now stops at the viewport height less the 12px margin the overlay pushes against, and scrolls
|
|
829
|
+
past that. A panel that already fits is untouched.
|
|
830
|
+
|
|
831
|
+
- **A line series measured against the first axis no longer raises an empty second one.** A mark
|
|
832
|
+
registers a contribution per axis, and a line series registers both whether or not it uses them,
|
|
833
|
+
so a plot whose series all read against the left axis grew a right-hand axis labelled `0` the
|
|
834
|
+
whole way down, and lost the plot width its labels reserved.
|
|
835
|
+
|
|
836
|
+
The predicate now counts reported VALUES rather than reporters, which fixes it for any mark that
|
|
837
|
+
registers an axis it does not use, not only the line series. A plot that genuinely carries two
|
|
838
|
+
scales is untouched.
|
|
839
|
+
|
|
840
|
+
## 0.13.3 — 2026-09-17
|
|
841
|
+
|
|
842
|
+
### Breaking
|
|
843
|
+
|
|
844
|
+
- **`ds-progress` and `ds-meter` are one component, `ds-bar`.** They were the same drawing — the
|
|
845
|
+
same 6px pill track, the same fill, the same clamping — under two names, and the only thing that
|
|
846
|
+
genuinely differed between them is now an input. `ds-meter` shipped in `0.13.2` and existed for
|
|
847
|
+
that one release.
|
|
848
|
+
|
|
849
|
+
```html
|
|
850
|
+
<ds-bar [value]="68" ariaLabel="Manifest upload progress" />
|
|
851
|
+
```
|
|
852
|
+
|
|
853
|
+
**For a progress bar the rename is the whole upgrade.** `value`, `max`, `variant`,
|
|
854
|
+
`indeterminate`, `target` and `ariaLabel` keep their names and their defaults, and `semantics`
|
|
855
|
+
defaults to `'progress'` — so a renamed `ds-progress` behaves exactly as it did.
|
|
856
|
+
`ProgressComponent` and `MeterComponent` are both `BarComponent`, and `ProgressVariant` is
|
|
857
|
+
`BarVariant` — all from `@ids-group-ltd/ids-design-system/components/bar`. A subclass of either
|
|
858
|
+
old class stops building; there is one class to extend now, and it carries every member both of
|
|
859
|
+
them had.
|
|
860
|
+
|
|
861
|
+
**A renamed `ds-meter` needs one more edit.** It was `aria-hidden` unless `ariaLabel` named it;
|
|
862
|
+
`ds-bar` announces as a progress bar by default. Add `semantics="none"` where the figure is
|
|
863
|
+
printed beside the bar, or `semantics="meter"` where the bar is the only place the measurement
|
|
864
|
+
appears. Nothing errors and nothing looks different — the change is entirely in what a screen
|
|
865
|
+
reader says, which is what the input exists to control.
|
|
866
|
+
|
|
867
|
+
**`ds-bar-chart` is a different component and is NOT renamed.** `ds-bar` is a prefix of it, so a
|
|
868
|
+
find-and-replace without a word boundary will corrupt every chart in the app.
|
|
869
|
+
|
|
870
|
+
- **The `--ds-progress-*` and `--ds-meter-*` tokens are `--ds-bar-*`.** `-height`,
|
|
871
|
+
`-track-color`, `-target-color`, `-target-width` and `-min-width` keep their suffix.
|
|
872
|
+
`--ds-progress-bar-color` and its `-success` / `-warning` / `-error` siblings became
|
|
873
|
+
`--ds-bar-fill-color` and siblings, because `--ds-bar-bar-color` stutters. The global
|
|
874
|
+
`--progress-h` is `--bar-h` — same 6px, under a name that still describes the component.
|
|
875
|
+
|
|
876
|
+
An override of a name nothing reads still parses, so a missed rename reports nothing and the bar
|
|
877
|
+
simply returns to its default look.
|
|
878
|
+
|
|
879
|
+
- **`valueFormat` on `ds-column-chart` and `ds-line-chart` now receives a second argument,
|
|
880
|
+
`location`.** The axis tick and the annex table used to share one call with no way to tell them
|
|
881
|
+
apart, so a custom formatter that spelled a value out in full also spelled it out on the axis,
|
|
882
|
+
where a fixed-width column has room for `1.2M` and not `1,248,392`. The callback is
|
|
883
|
+
`(value: number, location: ChartFormatLocation) => string` now, called with `'tick'` for the axis
|
|
884
|
+
label and `'tooltip'` everywhere else a value is printed in full (the annex table, the generated
|
|
885
|
+
description, the value beside a mark).
|
|
886
|
+
|
|
887
|
+
```ts
|
|
888
|
+
valueFormat: ChartValueFormat = (value, location) =>
|
|
889
|
+
location === 'tick' ? compact(value) : spelled(value);
|
|
890
|
+
```
|
|
891
|
+
|
|
892
|
+
An existing one-argument callback still compiles and still runs, because JavaScript ignores an
|
|
893
|
+
argument nothing reads. It cannot tell the two locations apart, though, so it prints the same
|
|
894
|
+
string for both, which is un-abbreviated on the axis wherever the built-in default used to
|
|
895
|
+
abbreviate for it.
|
|
896
|
+
|
|
897
|
+
**The built-in default changed too, with no callback involved.** It used to pick one suffix for
|
|
898
|
+
the whole axis, from the axis's own step, so `800K` and `1600K` shared a unit even past a million.
|
|
899
|
+
It now compacts each tick by that tick's own magnitude, so the same axis prints `800K` beside
|
|
900
|
+
`1.6M`. An axis whose ticks cross a thousand, million or billion boundary renders differently.
|
|
901
|
+
|
|
902
|
+
### Added
|
|
903
|
+
|
|
904
|
+
- **`ds-chart` is importable, with the marks that draw inside it.** The container the column chart is
|
|
905
|
+
built inside now ships as its own entry point,
|
|
906
|
+
`@ids-group-ltd/ids-design-system/components/chart`, for a plot the five presets do not cover - a
|
|
907
|
+
combo of columns and a cumulative line being the case that asked for it. It owns the frame, the
|
|
908
|
+
axes, the gridlines, the caption, the legend slot, the annex table and the generated description;
|
|
909
|
+
what is drawn against its scales is projected in.
|
|
910
|
+
|
|
911
|
+
```html
|
|
912
|
+
<ds-chart [categories]="months" secondaryAxisMode="rounded">
|
|
913
|
+
<svg:g dsColumnSeries [data]="billed" />
|
|
914
|
+
<svg:g dsLineSeries [data]="cumulative" axis="secondary" />
|
|
915
|
+
</ds-chart>
|
|
916
|
+
```
|
|
917
|
+
|
|
918
|
+
The entry point carries the container, the two series marks, the reference line and label marks,
|
|
919
|
+
their data types, the scales token and the two geometry helpers. A mark is an ATTRIBUTE selector
|
|
920
|
+
on a real `<svg:g>`, never an element of its own: an element the SVG specification does not know
|
|
921
|
+
renders nothing, its children included. Write `<svg:g dsColumnSeries>`, not `<ds-column-series>`.
|
|
922
|
+
|
|
923
|
+
**Reach for a preset first.** `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart`,
|
|
924
|
+
`ds-funnel-chart` and `ds-line-chart` carry the accessible defaults, and the container is the
|
|
925
|
+
escape hatch for the plot none of them draws. The marks are Angular components, so nothing
|
|
926
|
+
projected from React or from `@angular/elements` can draw inside the canvas.
|
|
927
|
+
|
|
928
|
+
- **A column chart can carry several named series per category.** Hand `data` a list of
|
|
929
|
+
`ColumnChartSeries` instead of a flat list of points and every category carries one column per
|
|
930
|
+
series, keyed by a `ds-chart-legend` under the plot. `stack` decides how they share the band:
|
|
931
|
+
`'none'` (the default) and `'grouped'` stand them side by side, `'stacked'` puts each on top of
|
|
932
|
+
the one before it, and `'normalized'` stacks then divides by the category's own total, so every
|
|
933
|
+
band is full and the axis reads in shares.
|
|
934
|
+
|
|
935
|
+
```html
|
|
936
|
+
<ds-column-chart stack="grouped" [data]="[
|
|
937
|
+
{ id: 'billed', label: 'Billed', data: months },
|
|
938
|
+
{ id: 'committed', label: 'Committed', fill: 'hatched', data: forecast },
|
|
939
|
+
]" />
|
|
940
|
+
```
|
|
941
|
+
|
|
942
|
+
A series takes one colour for all of its marks and a series-wide `fill` paints every one of its
|
|
943
|
+
columns, where a flat list of points still colours each mark by its own position — the marks of a
|
|
944
|
+
single-series chart ARE the categories and the marks of a grouped one are not. A flat list still
|
|
945
|
+
takes the whole band, so a chart that was passing one stays exactly as it was. Stacked segments
|
|
946
|
+
are separated by a 2px gap in the surface colour rather than a drawn rule, which survives print
|
|
947
|
+
and colour-vision deficiency. `stack="stacked"` and `ds-line-chart`'s `axisMode="stacked"` are
|
|
948
|
+
different things: series on top of each other, against two plots one above the other.
|
|
949
|
+
|
|
950
|
+
- **`ds-donut-chart` takes `partOfWhole`, so its percentages can be turned off.** A ring always
|
|
951
|
+
printed each slice's share and there was no way to stop it. The input defaults to `true`, which is
|
|
952
|
+
what the ring already did, so nothing changes without asking; `[partOfWhole]="false"` drops the
|
|
953
|
+
percentage from the legend, the tooltip and the data table alike.
|
|
954
|
+
|
|
955
|
+
It starts `true` here and `false` on every other chart on purpose: a ring IS parts of one whole, so
|
|
956
|
+
a share of the total is a real quantity whatever the data, while a column chart's categories often
|
|
957
|
+
sum to a number nobody can point at.
|
|
958
|
+
|
|
959
|
+
- **A column can be drawn as a projection rather than a reading.** A `ColumnChartPoint` that sets
|
|
960
|
+
`fill: 'hatched'` keeps its colour and takes a striped texture over it, which is what separates a
|
|
961
|
+
forecast from a settled figure without spending a second hue on it.
|
|
962
|
+
|
|
963
|
+
```html
|
|
964
|
+
<ds-column-chart [data]="[
|
|
965
|
+
{ label: 'Jun', value: 3020 },
|
|
966
|
+
{ label: 'Jul', value: 3400, fill: 'hatched' },
|
|
967
|
+
]" />
|
|
968
|
+
```
|
|
969
|
+
|
|
970
|
+
Texture is the encoding that survives greyscale, print and colour-vision deficiency, so it carries
|
|
971
|
+
the distinction where a lighter tint of the same colour would not. The chart reads nothing into the
|
|
972
|
+
flag: which columns are projections is a fact only the caller has. `--ds-chart-hatch-color` and
|
|
973
|
+
`--ds-chart-hatch-width` tune the stripes.
|
|
974
|
+
|
|
975
|
+
- **A second value axis on `ds-chart`, and a line series to draw against it.** A plot can now carry
|
|
976
|
+
two quantities at two magnitudes - a figure per month on the left axis, the running total of
|
|
977
|
+
those months on the right - instead of flattening one of them against the other's scale.
|
|
978
|
+
|
|
979
|
+
`secondaryAxisMode` takes the same four words `ds-line-chart`'s `yAxisMode` does:
|
|
980
|
+
`'rounded'` (the default) hangs the second scale on the first's own gridlines at a round step,
|
|
981
|
+
`'exact'` ends it on its largest reading, `'independent'` scales and grids it on its own, and
|
|
982
|
+
`'stacked'` draws two plots one above the other over a shared category axis. `ChartAxisMode` and
|
|
983
|
+
`ChartAxis` are exported from the core entry point, and `LineChartAxisMode` is now an alias of
|
|
984
|
+
the first.
|
|
985
|
+
|
|
986
|
+
`axisColor` and `secondaryAxisColor` paint each axis's tick labels in the colour of the marks
|
|
987
|
+
measured against it, which on a two-scale plot is the only thing that says which numbers a mark
|
|
988
|
+
is read against. They are inert while the plot has one axis.
|
|
989
|
+
|
|
990
|
+
`--ds-chart-area-opacity` sets how solid the band a line series fills down to its baseline is.
|
|
991
|
+
|
|
992
|
+
- **Reference lines and bands on `ds-column-chart`.** `thresholds` draws a target, a budget or an
|
|
993
|
+
SLA across the plot, behind the columns.
|
|
994
|
+
|
|
995
|
+
```ts
|
|
996
|
+
thresholds: ChartThreshold[] = [
|
|
997
|
+
{ value: 85, label: 'Target' },
|
|
998
|
+
{ value: 73, label: 'Escalation', dash: 'dotted' },
|
|
999
|
+
];
|
|
1000
|
+
```
|
|
1001
|
+
|
|
1002
|
+
Each entry is ONE number, not a coordinate pair: `value`, plus an optional `label`, `color` and
|
|
1003
|
+
`dash` (`'solid' | 'dashed' | 'dotted'`, default `'dashed'`). `to` turns the same object into a
|
|
1004
|
+
band filled between two readings instead of a line, written in either order.
|
|
1005
|
+
|
|
1006
|
+
A threshold widens the value axis to hold it, so a target above every column still lands on the
|
|
1007
|
+
plot rather than off it. It is also named in the generated description - "Target at 85, 2 of 5
|
|
1008
|
+
points above" - so the line reaches a reader who cannot see it.
|
|
1009
|
+
|
|
1010
|
+
Four tokens set the default look: `--ds-chart-threshold-color`,
|
|
1011
|
+
`--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and
|
|
1012
|
+
`--ds-chart-threshold-dotted-pattern`. A threshold's own `color` overrides the first.
|
|
1013
|
+
|
|
1014
|
+
### Changed
|
|
1015
|
+
|
|
1016
|
+
- **Hovering a legend item behaves as hovering the mark it names.** On `ds-donut-chart` the panel
|
|
1017
|
+
opened over the legend row rather than over the arc, so the reader was pointed at the label
|
|
1018
|
+
instead of the slice; on `ds-funnel-chart` the stage rows did nothing at all. Both now open the
|
|
1019
|
+
same panel over the MARK and dim the rest of the plot, identical to pointing at the arc or the bar
|
|
1020
|
+
directly, and the keyboard route follows wherever the legend carries it.
|
|
1021
|
+
|
|
1022
|
+
- **A chart tooltip opens against its mark, not against the row that holds it.** `ds-bar-chart`
|
|
1023
|
+
anchored the panel to the whole row — label, value and track — so it opened a row-height above
|
|
1024
|
+
the bar it was about: 46.7px from the mark where the gap asks for 6. It anchors to the bar now.
|
|
1025
|
+
The gap itself went from 12px to 6px on every chart, because a panel a finger's width off its
|
|
1026
|
+
mark reads as floating free of it.
|
|
1027
|
+
|
|
1028
|
+
- **`ds-column-chart`'s `data` input accepts a second shape.** It was
|
|
1029
|
+
`readonly ColumnChartPoint[]` and is now
|
|
1030
|
+
`readonly ColumnChartPoint[] | readonly ColumnChartSeries[]`. Passing one is unaffected; reading
|
|
1031
|
+
the signal back or overriding it is not. `chart.data()[0].value` stops type-checking without a
|
|
1032
|
+
narrowing test, because a `ColumnChartSeries` has no `value`, and a subclass redeclaring `data`
|
|
1033
|
+
fails on TS2416 since an input signal's type is invariant. Narrow on the shape —
|
|
1034
|
+
`'data' in entry` — wherever the values are read back.
|
|
1035
|
+
|
|
1036
|
+
- **Exported class member surface moved — only matters if you SUBCLASS one of these.**
|
|
1037
|
+
`ProgressComponent` and `MeterComponent` are gone; `BarComponent` carries every member both of
|
|
1038
|
+
them had. `ChartTooltipDirective`, internal and not exported from the package root, gains
|
|
1039
|
+
`dsChartTooltipPreferBelow`. `ColumnChartComponent` moved its drawing into the shared container
|
|
1040
|
+
and took several series, so it gained `thresholds`, `categories`, `geometry`, `tableRows`,
|
|
1041
|
+
`viewHeightPx`, `skeletonHeightPx`, `stack`, `resolvedSeries`, `seriesRefs`, `pinnedSeries`,
|
|
1042
|
+
`slotCount`, `offsets`, `offsetsFor`, `multiSeries`, `legendItems` and `axisFormat`, and lost the
|
|
1043
|
+
members that used to draw its marks. `DonutChartComponent` gained
|
|
1044
|
+
`partOfWhole`, `arcAt`, `isDimmed` and three legend handlers; `FunnelChartComponent` gained
|
|
1045
|
+
`isDimmed` and `onRowEnter`. A subclass declaring any of those names collides: rename yours, or
|
|
1046
|
+
add `override` where it genuinely means the same thing.
|
|
1047
|
+
|
|
1048
|
+
- **A held mark opens its panel BELOW itself.** The Unpin control sits at the plot's top edge, and
|
|
1049
|
+
a panel opening upward from a mark in the upper half landed on top of it. No z-index fixes that
|
|
1050
|
+
— the panel is portaled to the body, and an app layout that isolates its stacking context traps
|
|
1051
|
+
the chart's own chrome underneath whatever number it carries. Below-first while pinned keeps the
|
|
1052
|
+
two apart; the other three fallbacks still catch a mark with no room under it.
|
|
1053
|
+
|
|
1054
|
+
- **Moving a pin from one mark to another no longer blinks.** The press that re-aimed it cleared
|
|
1055
|
+
the pin first and the click set it again, so the Unpin control and the held mark's styling
|
|
1056
|
+
unmounted for a frame between the two marks. A press that lands on another mark of the same
|
|
1057
|
+
chart is a re-aim now, and `pinned` never goes false across it.
|
|
1058
|
+
|
|
1059
|
+
- **The pin glyph is a drawing pin seen from the side.** Head-on it read as a lamp or a bell at the
|
|
1060
|
+
14px the charts badge it at.
|
|
1061
|
+
|
|
1062
|
+
- **A focused mark wears the app's own focus colour.** The ring was white with a dark halo, which
|
|
1063
|
+
on a coloured band read as an artefact rather than as a focus indicator. It is
|
|
1064
|
+
`--focus-ring-color` with a light keyline around it now — the keyline is what separates it from
|
|
1065
|
+
a mark of the same hue family, which is why the indicator is two tones either way.
|
|
1066
|
+
`--ds-chart-focus-ring-color` and `--ds-chart-focus-halo-color` still set both.
|
|
1067
|
+
|
|
1068
|
+
- **A chart with nothing to draw keeps its axes.** `ds-line-chart` and `ds-column-chart` render
|
|
1069
|
+
the value axis and the category axis behind the empty, error and no-visible-series messages, so
|
|
1070
|
+
the message stands in a plot rather than in a blank card. Without ticks or labels: there is no
|
|
1071
|
+
data to scale them against. The charts with no axes — donut, funnel, bar — are unchanged.
|
|
1072
|
+
|
|
1073
|
+
- **`ds-bar` cannot collapse to nothing in a content-sized cell.** It carries
|
|
1074
|
+
`min-inline-size: 3rem`, overridable through `--ds-bar-min-width`. A box sized to its content —
|
|
1075
|
+
a `width: 'content'` table column, a shrink-to-fit flex or grid item — is sized by what its
|
|
1076
|
+
contents contribute intrinsically, and a bar that is 100% of its cell contributes nothing: one
|
|
1077
|
+
alone in such a cell measures 0px wide. `ds-progress` had no floor, so a bar that used to
|
|
1078
|
+
disappear there is now visible; set the property to `0` for the old behaviour.
|
|
1079
|
+
|
|
1080
|
+
- **`indeterminate` is ignored unless `semantics` is `'progress'`.** Only a task has an unknown
|
|
1081
|
+
duration. Nothing that set it on `ds-progress` is affected, because that is the default.
|
|
1082
|
+
|
|
1083
|
+
### Fixed
|
|
1084
|
+
|
|
1085
|
+
- **A pinned tooltip survives a scroll.** Every chart tore its panel down on any scroll of the page,
|
|
1086
|
+
and because a pinned mark deliberately stops answering the pointer, nothing brought it back: the
|
|
1087
|
+
pin badge and the Unpin control were left sitting over a reading that was no longer on screen.
|
|
1088
|
+
The panel repositions now instead of closing. An unpinned tooltip still goes away on both a scroll
|
|
1089
|
+
and the pointer leaving, as it always did.
|
|
1090
|
+
|
|
1091
|
+
- **A column chart plots a domain that reaches below zero.** Every scale clamped its floor at zero,
|
|
1092
|
+
so a negative reading drew nothing at all and a P&L series rendered as a flat baseline with no
|
|
1093
|
+
warning. The axis now spans the data, the zero line is drawn where it falls inside the plot, and a
|
|
1094
|
+
negative column grows downward from it with its value label at its own tip. Room for that label is
|
|
1095
|
+
reserved only when the domain actually reaches below zero, so an all-positive chart keeps its
|
|
1096
|
+
height.
|
|
1097
|
+
|
|
1098
|
+
- **The value axis fits its own labels.** The gutter was a fixed width, which an SVG canvas CLIPS
|
|
1099
|
+
rather than overflows, so a locale whose compact numbers are wider than an English `3.5k` lost the
|
|
1100
|
+
leading digit of every tick - `3,5 тыс.` printed as `,5 тыс.`. The gutter is measured from the
|
|
1101
|
+
widest label that actually rendered, and `axisGutter` is the floor it will not go below.
|
|
1102
|
+
|
|
1103
|
+
|
|
3
1104
|
## 0.13.2 — 2026-09-15
|
|
4
1105
|
|
|
5
1106
|
### Added
|
|
@@ -715,11 +1816,10 @@
|
|
|
715
1816
|
`--chart-line-width-bold`, `--chart-dot-r` becomes `--chart-dot-radius`, and
|
|
716
1817
|
`--chart-dot-r-active` becomes `--chart-dot-radius-active`.
|
|
717
1818
|
|
|
718
|
-
Three more are REMOVED rather than renamed, because no chart draws what they named and
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
it.
|
|
1819
|
+
Three more are REMOVED rather than renamed, because no chart draws what they named and no rule
|
|
1820
|
+
read them: `--chart-axis-title`, `--chart-grid-line-strong` and `--chart-tick-size`. Handle
|
|
1821
|
+
`--chart-grid-line-strong` before `--chart-grid-line`: the short name is a prefix of the long
|
|
1822
|
+
one, and a prefix-blind sweep renames this one instead of deleting it.
|
|
723
1823
|
|
|
724
1824
|
The sequential and divergent VALUES are unchanged in both themes; the eight categorical values are
|
|
725
1825
|
not — they are retuned in this same release, so a rename there lands a different colour rather than
|
|
@@ -1254,9 +2354,6 @@
|
|
|
1254
2354
|
| `ds-stat { --ds-stat-value-white-space: normal; }` written only to stop a long value painting over the tile beside it | the value clips by default, so it no longer escapes its card | nothing — keep the hook only where you want the value wrapped and the tile taller |
|
|
1255
2355
|
| `ds-stat .value { overflow: hidden; text-overflow: ellipsis; }` — your own clip on the value | the component clips it, and with `overflow: clip` plus a clip margin, so descenders survive where `hidden` shaved them | nothing |
|
|
1256
2356
|
| `.cell-text-pop` — a rule sizing or colouring the table's full-value popover | the popover is gone; a clipped cell opens a tooltip instead | `--ds-tooltip-*`, if the panel needs changing at all |
|
|
1257
|
-
| `--ds-chart-axis-title-color` | no chart draws an axis title, so the token reached no rule and setting it changed nothing | nothing |
|
|
1258
|
-
| `--ds-chart-grid-line-strong-color` | no chart draws a strong gridline, so the token reached no rule | nothing |
|
|
1259
|
-
| `--ds-chart-tick-size` | no chart draws tick marks on its axes, so the token reached no rule | nothing |
|
|
1260
2357
|
|
|
1261
2358
|
## 0.12.3 — 2026-09-10
|
|
1262
2359
|
|
|
@@ -3351,7 +4448,7 @@ workaround written against a hook that only landed in this release.
|
|
|
3351
4448
|
| `--ds-button-label-color-disabled` pinned on a tonal button to make its disabled state visible, most likely only in the dark theme | The default disabled-label recipe carries it |
|
|
3352
4449
|
| `count.toLocaleString('en-US')` (or any hand-rolled formatting) inside a `ds-stat` binding, because `[value]="count \| number"` would not typecheck | The pipe binds now, and it reads `LOCALE_ID` instead of a pinned locale |
|
|
3353
4450
|
| A `::ng-deep ds-table tr:hover .some-cell { color; text-decoration }` rule to make one cell read as the row's link target | `interactive: true` on that column, retuned with `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration` |
|
|
3354
|
-
| `
|
|
4451
|
+
| `name="error"`, `name="warn"`, `.field-message` | A `ds-icon` rendered by hand beside a field's error or warning text, or a rule on the message row nudging it into line against the old centred layout. Replace with: the built-in state glyph (error / warning / success carry one now), retuned through DS_CONFIG.field.stateIcons or messageIcon, with --ds-field-message-icon-gap / -offset for the spacing. |
|
|
3355
4452
|
| `box-shadow: none`, `--ds-field-focus-shadow` | A rule that killed one of the two focus rings a field used to paint - on an inner input, or by re-declaring the field focus shadow. SCOPE, and it matters: this release suppresses the inner ring on ds-search, ds-autocomplete, ds-date-picker, ds-number-stepper and ds-field-group ONLY. A workaround on ds-input or ds-textarea is still load-bearing here - deleting it brings the double ring back. Leave those two until you are on the release that names them. Also leave any rule you wrote against the universal :where(:focus-visible) base indicator itself: that rule is still the one this library ships. Replace with: nothing: the field paints one ring now. |
|
|
3356
4453
|
| `padding-block`, `line-height`, `option-label` | A padding or line-height override added to an option label, a clipped table cell or a breadcrumb to stop the descenders being shaved. Replace with: nothing: the clip carries a --space-1 margin now, at the same row height. |
|
|
3357
4454
|
|