@ids-group-ltd/ids-design-system 0.12.3 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/CHANGELOG.md +603 -6
  2. package/components.md +85 -2
  3. package/docs/agent/INDEX.md +11 -1
  4. package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +9 -0
  5. package/docs/agent/charts/chart-frame-the-box-a-chart-draws-around-itself.md +12 -0
  6. package/docs/agent/charts/ds-bar-chart.md +15 -0
  7. package/docs/agent/charts/ds-column-chart.md +14 -0
  8. package/docs/agent/charts/ds-donut-chart.md +17 -0
  9. package/docs/agent/charts/ds-funnel-chart.md +16 -0
  10. package/docs/agent/charts/ds-line-chart.md +15 -0
  11. package/docs/agent/forms/ds-button.md +4 -2
  12. package/docs/agent/forms/ds-number-stepper.md +1 -0
  13. package/docs/agent/navigation/ds-sidenav-item.md +1 -0
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +16 -14
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +161 -0
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +58 -8
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +43 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +197 -0
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +1 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +1 -0
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +173 -0
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -6
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +299 -0
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +69 -17
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +366 -0
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +10 -14
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +631 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +1 -0
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +1 -0
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -10
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -6
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +1 -0
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +1 -0
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +1 -0
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +31 -9
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +393 -5
  91. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
  95. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  98. package/migrations/0.13.0.json +530 -0
  99. package/package.json +57 -1
  100. package/styles/_chart-data-table.scss +95 -0
  101. package/styles/_chart-frame.scss +53 -0
  102. package/styles/_chart-interactive.scss +40 -0
  103. package/styles/_chart-motion.scss +45 -0
  104. package/styles/_focus.scss +1 -1
  105. package/styles/_tokens-charts.scss +149 -39
  106. package/styles/_tokens.scss +17 -4
  107. package/themes/dark/_theme.scss +37 -29
  108. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +11 -9
  109. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +104 -0
  110. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +37 -4
  111. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
  112. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +78 -0
  113. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +105 -0
  114. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -1
  115. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +113 -0
  116. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
  117. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +109 -0
  118. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
  119. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +241 -0
  120. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +5 -2
  121. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
  122. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
  123. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
  124. package/types/ids-group-ltd-ids-design-system-components.d.ts +154 -4
  125. package/types/ids-group-ltd-ids-design-system-core.d.ts +12 -1
  126. package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
package/components.md CHANGED
@@ -153,17 +153,19 @@ text rather than a state. Retune app-wide with `DS_CONFIG.field.stateIcons` (per
153
153
  is not a validated field; where a search needs a label or an error line, use `ds-input`.
154
154
 
155
155
  #### `<ds-button>` — `ButtonComponent`
156
- Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: string | readonly unknown[] | null = null` / `href: string = ''`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
156
+ Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: DsRouterLink = null` (a path, a command array or a `UrlTree`) / `href: string = ''`, with the modifiers `fragment` / `queryParams` / `queryParamsHandling` (routerLink-only) and `target` / `rel` (either link), plus `routerLinkActiveOptions` and `ariaCurrent`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
157
157
  Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
158
158
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
159
159
  **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
160
+ **Modifying a destination.** `fragment`, `queryParams` and `queryParamsHandling` go with a `routerLink` and dev-warn on any other destination; `target` and `rel` work on both link destinations and dev-warn on a plain button. Each is a pass-through to the anchor the component already renders. For the `UrlCreationOptions` with no input here — `relativeTo`, `preserveFragment` — pass a `UrlTree` built with `Router.createUrlTree` as the `routerLink`; folding a query or hash into the link STRING does not work, because `createUrlTree` treats the commands as path segments and percent-encodes `?` and `#`. Do NOT import `RouterLink` in your own component to write the extra inputs on a `<ds-button>`: the directive's selector matches the host, so that puts a SECOND `RouterLink` on the control disagreeing with the anchor's about where it goes.
161
+ **What an active link announces, and why it is not the `active` class.** An EXACT match announces `aria-current="page"`, a PREFIX match announces `true`, everything else announces nothing — ARIA's own split: `page` is the page you are on, `true` is the current section or an ancestor. The `active` CLASS keeps matching by prefix, so a section link still looks lit; `routerLinkActiveOptions` moves the class and `ariaCurrent` overrides the announcement (`null` silences it). Before this the attribute was derived from `routerLinkActive`, so a back-link claimed to be the page the reader was leaving — invisible on a button, because `.active` is painted by nothing there. **Two mechanism traps, both measured.** `RouterLinkActive.update()` removes `aria-current` from its host in a microtask whenever its own `ariaCurrentWhenActive` is unset, so an `[attr.aria-current]` binding on the same element is written and then wiped — the value has to go through `ariaCurrentWhenActive`. And a RELATIVE destination (`routerLink="."`, `['..', 'x']`) has to be resolved against the route the control sits on, exactly as `RouterLink` does: resolved from the root instead, `.` becomes `/`, which is a prefix of every page, so the control that IS the current page announces `true`.
160
162
  **A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
161
163
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
162
164
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
163
165
  - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
164
166
  - **Temporary** (the form is not filled in yet): do NOT disable the button at all. Leave it live, judge validity in the submit handler, and carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid` / `touched`: a button has no validation state of its own.
165
167
  Layout: a message-bearing button becomes a column (host class `with-message`), and because the host shrinks to fit, a message longer than the label widens the pair — button included, exactly as a field's control spans its own message. Without a message the host keeps the `inline-flex` box every existing layout was built against.
166
- Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border`, `--ds-button-radius`, `--ds-button-focus-shadow`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
168
+ Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border-color`, `--ds-button-border-color-disabled`, `--ds-button-border-width`, `--ds-button-radius`, `--ds-button-focus-shadow`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
167
169
 
168
170
  #### `<ds-icon-button>` — `IconButtonComponent`
169
171
  Icon-only action with its own taxonomy, distinct from `ds-button`. `ariaLabel` is required (icon-only must be labelled for a11y).
@@ -201,6 +203,7 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
201
203
  Spinbox for bounded quantities — −/+ buttons around a numeric value.
202
204
  Inputs: `value: model<number> = 0`, `min: number = 0`, `max: number | null = null`, `step: number = 1`, `size: 'sm' | 'md' | 'lg' = 'md'`, `disabled: boolean = false`
203
205
  Methods: `inc()`, `dec()` (clamp to min/max). Buttons disable at the bounds.
206
+ Tokens: `--ds-number-stepper-field-width` sizes the number itself and is derived from the box height by default — a value with more digits than that width holds is clipped rather than wrapped, so widen it for large quantities. Also `--ds-number-stepper-bg-color`, `--ds-number-stepper-border-color`, `--ds-number-stepper-step-bg-color-active`, `--ds-number-stepper-focus-shadow`.
204
207
 
205
208
  #### `<ds-checkbox>` — `CheckboxComponent`
206
209
  Inputs: `checked: model<boolean>`, `indeterminate: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `inputId: string | null = null`
@@ -337,6 +340,7 @@ When `expandable=true` renders header button with toggle + caret; collapses body
337
340
  #### `<ds-sidenav-item>` — `SidenavItemComponent`
338
341
  Inputs: `icon: IconName | null = null` (optional — falls back to `[icon]` slot), `label: required string`, `href: string = ''`, `routerLink: string | readonly unknown[] | null = null`, `active: boolean = false`, `badge: number | null = null`, `hasAlert: boolean = false`, `rail: boolean | null = null` (draws the active item's edge marker; unset follows the parent `ds-sidenav`)
339
342
  Content slots: `[icon]` (custom icon when not using a DS IconName), `[trailing]` (right-aligned chrome — badges, indicators, kbd shortcuts)
343
+ **What an active item announces.** An EXACT match on the item's destination announces `aria-current="page"`; a PREFIX match announces `true`, which in a sidenav is the useful case — "you are in this section". `ariaCurrent` overrides it, `null` silences it, and the `active` class is a separate question decided by `routerLinkActive`. `ds-sidenav-group` follows the same rule on a header that is itself a destination, and `routerLink` on both accepts a `UrlTree`. The value must go through `ariaCurrentWhenActive`, never `[attr.aria-current]`, and a relative destination must be resolved against the control's own route — see the two traps under `ds-button`.
340
344
  **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`**. Until 0.11.0 the last case fell back to `href="#"`, which navigates: it rewrites the URL and discards the scroll position on every click. An item that only emits `activate` is a button. Styling is identical across all three — the rules are class-based (`.item`) and the button's UA chrome is reset — so target the class, never the tag.
341
345
  Tokens (on `:host`): `--ds-sidenav-item-label-color`, `--ds-sidenav-item-label-color-hover`, `--ds-sidenav-item-bg-color-hover`, `--ds-sidenav-item-bg-color-active` (default: `--accent-subtitle` — a wash, not a solid pill), `--ds-sidenav-item-label-color-active` (default: `--accent-strong`), `--ds-sidenav-item-bg-color-active-hover` (default: `--accent-muted`, deepening toward the accent), `--ds-sidenav-item-rail` (left rail, default: `--accent-strong`), `--ds-sidenav-item-radius`, `--ds-sidenav-alert-color`
342
346
 
@@ -453,6 +457,85 @@ Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--ra
453
457
 
454
458
  ---
455
459
 
460
+ ### Charts
461
+
462
+ #### `<ds-bar-chart>` — `BarChartComponent`
463
+ Inputs: `data: readonly BarChartRow[]` (required), `max: number | null = null` (track length is relative to this; null uses the largest value, so the longest row always fills its track — a max BELOW the largest value is allowed and its bar clips at the track edge), `caption: string | null = null`, `summary: string | null = null` (accessible name; generated from the data when omitted), `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'` (`'toggle'` renders a closed `<details>`; `'none'` is only correct when the same numbers are already in the DOM nearby), `showPercent: boolean = true`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
464
+ Output: `(rowClicked): BarChartRow` — emits the clicked row.
465
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
466
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
467
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
468
+ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string }`. `percent` is derived from `value / max` when omitted.
469
+ Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
470
+ Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
471
+ Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
472
+ Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
473
+
474
+ #### `<ds-column-chart>` — `ColumnChartComponent`
475
+ Vertical columns for a short series read left to right — months, stages, teams — measured against one value axis whose ticks snap to round numbers.
476
+ Inputs: `data: readonly ColumnChartPoint[]` (required), `showValues: boolean = true` (each column prints its own value above itself), `tickCount: number = 5` (a hint: ticks snap to a round step, so an axis asked for three ends up with five and one asked for ten stops at eight), `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
477
+ Output: `(pointClicked): ColumnChartPoint` — same contract as `ds-bar-chart`'s `rowClicked`.
478
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
479
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
480
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
481
+ Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
482
+ Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
483
+ Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped).
484
+
485
+ #### `<ds-donut-chart>` — `DonutChartComponent`
486
+ A ring that splits one total into its parts, with the middle free for the total or a headline figure of your own.
487
+ Inputs: `data: readonly DonutChartSlice[]` (required), `centerValue: string | null = null`, `centerLabel: string | null = null`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string = 'Other'`, `thickness: number = 0.32`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
488
+ Output: `(sliceClicked): DonutChartSlice`
489
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
490
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
491
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
492
+ Slice: `DonutChartSlice = { id: string; label: string; value: number; slot?: number }`. `slot` is a 1-based palette slot: pinning a slice keeps every other slice's colour where it is when one is filtered out of `data`; left off, the colour follows the index and the whole ring repaints.
493
+ Colour: slices ARE different things, so this is the chart the categorical palette exists for — `--ds-chart-series-1-color` … `--ds-chart-series-8-color`.
494
+ Behaviour: percentages use largest-remainder rounding, so a legend's shares add up to exactly 100 and a real non-zero slice never prints `0%`.
495
+ `maxSlices` caps the legend: past it the smallest slices are summed into one named by `otherLabel`, which takes the neutral eighth palette slot. Off by default, because grouping changes what the chart says. The kept slices stay in the order given rather than being re-sorted by value, and the total is unchanged — the tail is summed, never dropped. A limit below 2 is ignored.
496
+ `thickness: 1` closes the hole into a pie. The centre value renders unconditionally either way, falling back to the formatted total, so over a pie it sits on the slices and carries a halo of the chart's own background — no single text colour is readable against three different hues. The centre box is held to the square that fits inside the hole, so a long `centerLabel` wraps rather than running out over the ring.
497
+ Tokens: `--ds-donut-chart-size`, `--ds-donut-chart-gap`, `--ds-donut-chart-swatch-size`, `--ds-donut-chart-legend-row-gap`, `--ds-donut-chart-legend-row-height`, `--ds-donut-chart-outline-width` (the placeholder ring drawn when there is no data and when every slice is zero).
498
+
499
+ #### `<ds-funnel-chart>` — `FunnelChartComponent`
500
+ Stages of a journey, drawn top to bottom in the order you give them — they are never sorted, because the order is the meaning.
501
+ Inputs: `data: readonly FunnelChartStage[]` (required), `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true` (the aligned stage table under the funnel: value, share of the first stage, and how much fell away since the stage above), `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
502
+ Output: `(stageClicked): FunnelChartStage`
503
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
504
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
505
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
506
+ Stage: `FunnelChartStage = { id: string; label: string; value: number }`
507
+ Shape: `'area'` is the default — the fixed silhouette with the stage boundaries moved so each band's AREA is proportional to its value, the honest encoding that still leaves a labellable tail. `'width'` reads every boundary straight off the values, which collapses the tail of a steep funnel below a labellable width. `'taper'` encodes NOTHING: the silhouette is fixed whatever the data, so editing the values moves the table and never the shape — reach for it only where the numbers are read from the table.
508
+ `dataTable` is suppressed while `showTable` is on: with both, the same numbers print twice.
509
+ Colour: the stages are one quantity draining, not N categories, so they take the single-hue ramp `--ds-chart-ramp-1-color` … `--ds-chart-ramp-8-color`, spread across however many stages there are. The LAST stage leaves the ramp for `--ds-chart-series-accent-color` — it is the outcome the funnel is read for.
510
+ Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
511
+
512
+ #### `<ds-line-chart>` — `LineChartComponent`
513
+ One or more series plotted over a shared set of categories.
514
+ Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'rounded' | 'exact' | 'independent' | 'stacked' = 'rounded'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 0`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string = 'All series are hidden'`
515
+ Output: `(pointClicked): LineChartPoint` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
516
+ Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. Tabbing reaches ONE marker per series; arrows walk that series' readings, and a focused marker's tooltip names its own series alone. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`.
517
+ Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering an entry dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
518
+ Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
519
+ Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
520
+ `yAxisMode` only matters once a series sets `axis: 'secondary'`: `'rounded'` shares one set of gridlines and rounds the secondary step up, so that series stops short of the top; `'exact'` shares the gridlines but ends the secondary axis on its largest reading, so it uses the full height and its labels are not round; `'independent'` scales and grids each axis on its own; `'stacked'` draws two plots one above the other, sharing the category axis.
521
+ Colour: series ARE different things, so the categorical palette applies — `--ds-chart-series-1-color` onward, by position or by `slot`.
522
+ Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`.
523
+
524
+ #### Chart frame — the box a chart draws around itself
525
+ Every chart paints its own border, radius, padding and `--surface-default` background, on by default. That is unusual here — most components resist owning chrome — and a chart earns the exception because it is read as an OBJECT: a plot with axes, a legend and an annex table, whose parts run into the page without an edge. A chart that already sits inside a card drops the frame with two declarations rather than a mode flag:
526
+
527
+ ```scss
528
+ ds-bar-chart { --ds-chart-frame-border-width: 0; --ds-chart-frame-padding: 0; }
529
+ ```
530
+
531
+ Tokens: `--ds-chart-frame-border-color`, `--ds-chart-frame-border-width`, `--ds-chart-frame-radius`, `--ds-chart-frame-padding`, `--ds-chart-frame-bg-color`.
532
+
533
+ #### Chart colour — which palette a chart takes
534
+ Three families, and reaching for the wrong one is the usual chart bug. Set the `--ds-chart-*` contract tokens, never the `--chart-categorical-*` / `--chart-ramp-*` palette behind them.
535
+ - **Categorical** — `--ds-chart-series-1-color` … `--ds-chart-series-8-color`, for marks that are DIFFERENT THINGS: donut slices, line series. Eight hues, each clearing 3:1 on white for WCAG 1.4.11 and at least dE 15 from every other under normal, deuteranope and protanope vision. No hue between 35 and 130: a yellow or a lime cannot be both rich and 3:1 on white, and forcing one past the floor turns it to mustard. Slots 7 and 8 are the "rest" / "other" buckets, and slot 8 is a neutral on purpose — every eighth HUE that clears the floor lands within dE 4 of one of the other seven under some colour-vision deficiency.
536
+ - **Single series** — `--ds-chart-series-default-color` plus `--ds-chart-series-accent-color`, for marks that are ONE thing measured repeatedly: bar rows, columns. One colour for all of them, and the accent on the one the reader should land on.
537
+ - **Ramp** — `--ds-chart-ramp-1-color` … `--ds-chart-ramp-8-color`, one hue light to deep, for the ORDERED stages of a single quantity: the funnel.
538
+
456
539
  ### Domain
457
540
 
458
541
  #### `<ds-w3w>` — `W3wComponent`
@@ -17,6 +17,16 @@ and token names.** These leaves are for orientation and usage.
17
17
  - [Foundations — Grid](foundations/grid.md)
18
18
  - [Foundations — Global helper classes](foundations/global-helper-classes.md)
19
19
 
20
+ ## charts
21
+
22
+ - [<ds-bar-chart> — BarChartComponent](charts/ds-bar-chart.md) — Interaction: interactive: boolean = false turns on the affordance — pointer cursor, hover tint and the keyboar
23
+ - [<ds-column-chart> — ColumnChartComponent](charts/ds-column-chart.md) — Vertical columns for a short series read left to right — months, stages, teams — measured against one value ax
24
+ - [<ds-donut-chart> — DonutChartComponent](charts/ds-donut-chart.md) — A ring that splits one total into its parts, with the middle free for the total or a headline figure of your o
25
+ - [<ds-funnel-chart> — FunnelChartComponent](charts/ds-funnel-chart.md) — Stages of a journey, drawn top to bottom in the order you give them — they are never sorted, because the order
26
+ - [<ds-line-chart> — LineChartComponent](charts/ds-line-chart.md) — One or more series plotted over a shared set of categories.
27
+ - [Chart frame — the box a chart draws around itself](charts/chart-frame-the-box-a-chart-draws-around-itself.md) — Every chart paints its own border, radius, padding and --surface-default background, on by default. That is un
28
+ - [Chart colour — which palette a chart takes](charts/chart-colour-which-palette-a-chart-takes.md) — Three families, and reaching for the wrong one is the usual chart bug. Set the --ds-chart-* contract tokens, n
29
+
20
30
  ## domain
21
31
 
22
32
  - [<ds-w3w> — W3wComponent](domain/ds-w3w.md) — What3Words address chip — branded display for ///word.word.word addresses; click-to-copy.
@@ -59,7 +69,7 @@ and token names.** These leaves are for orientation and usage.
59
69
 
60
70
  - [<ds-sidenav> — SidenavComponent](navigation/ds-sidenav.md) — Content: default slot for groups/items + custom brand/footer rows
61
71
  - [<ds-sidenav-group> — SidenavGroupComponent](navigation/ds-sidenav-group.md) — When expandable=true renders header button with toggle + caret; collapses body when not expanded.
62
- - [<ds-sidenav-item> — SidenavItemComponent](navigation/ds-sidenav-item.md) — **Three elements, decided by destination.** routerLink → an <a [routerLink]> with routerLinkActive; href → a p
72
+ - [<ds-sidenav-item> — SidenavItemComponent](navigation/ds-sidenav-item.md) — **What an active item announces.** An EXACT match on the item's destination announces aria-current="page"; a P
63
73
  - [<ds-topbar> — TopBarComponent](navigation/ds-topbar.md) — No inputs.
64
74
  - [<ds-app-layout> — AppLayoutComponent](navigation/ds-app-layout.md) — Reads: railId and the read-only railOverlay signal, for a consumer-built burger; dsRailTrigger wires one for y
65
75
  - [<ds-auth-layout> — AuthLayoutComponent](navigation/ds-auth-layout.md) — landmark="main" only when the page has no other <main>; the sign-in card is not automatically the document's m
@@ -0,0 +1,9 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # Chart colour — which palette a chart takes
3
+
4
+ Group: Charts
5
+
6
+ Three families, and reaching for the wrong one is the usual chart bug. Set the `--ds-chart-*` contract tokens, never the `--chart-categorical-*` / `--chart-ramp-*` palette behind them.
7
+ - **Categorical** — `--ds-chart-series-1-color` … `--ds-chart-series-8-color`, for marks that are DIFFERENT THINGS: donut slices, line series. Eight hues, each clearing 3:1 on white for WCAG 1.4.11 and at least dE 15 from every other under normal, deuteranope and protanope vision. No hue between 35 and 130: a yellow or a lime cannot be both rich and 3:1 on white, and forcing one past the floor turns it to mustard. Slots 7 and 8 are the "rest" / "other" buckets, and slot 8 is a neutral on purpose — every eighth HUE that clears the floor lands within dE 4 of one of the other seven under some colour-vision deficiency.
8
+ - **Single series** — `--ds-chart-series-default-color` plus `--ds-chart-series-accent-color`, for marks that are ONE thing measured repeatedly: bar rows, columns. One colour for all of them, and the accent on the one the reader should land on.
9
+ - **Ramp** — `--ds-chart-ramp-1-color` … `--ds-chart-ramp-8-color`, one hue light to deep, for the ORDERED stages of a single quantity: the funnel.
@@ -0,0 +1,12 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # Chart frame — the box a chart draws around itself
3
+
4
+ Group: Charts
5
+
6
+ Every chart paints its own border, radius, padding and `--surface-default` background, on by default. That is unusual here — most components resist owning chrome — and a chart earns the exception because it is read as an OBJECT: a plot with axes, a legend and an annex table, whose parts run into the page without an edge. A chart that already sits inside a card drops the frame with two declarations rather than a mode flag:
7
+
8
+ ```scss
9
+ ds-bar-chart { --ds-chart-frame-border-width: 0; --ds-chart-frame-padding: 0; }
10
+ ```
11
+
12
+ Tokens: `--ds-chart-frame-border-color`, `--ds-chart-frame-border-width`, `--ds-chart-frame-radius`, `--ds-chart-frame-padding`, `--ds-chart-frame-bg-color`.
@@ -0,0 +1,15 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-bar-chart>` — `BarChartComponent`
3
+
4
+ Group: Charts
5
+
6
+ Inputs: `data: readonly BarChartRow[]` (required), `max: number | null = null` (track length is relative to this; null uses the largest value, so the longest row always fills its track — a max BELOW the largest value is allowed and its bar clips at the track edge), `caption: string | null = null`, `summary: string | null = null` (accessible name; generated from the data when omitted), `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'` (`'toggle'` renders a closed `<details>`; `'none'` is only correct when the same numbers are already in the DOM nearby), `showPercent: boolean = true`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
7
+ Output: `(rowClicked): BarChartRow` — emits the clicked row.
8
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
9
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
10
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
11
+ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: string }`. `percent` is derived from `value / max` when omitted.
12
+ Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
13
+ Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
14
+ Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
15
+ Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
@@ -0,0 +1,14 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-column-chart>` — `ColumnChartComponent`
3
+
4
+ Group: Charts
5
+
6
+ Vertical columns for a short series read left to right — months, stages, teams — measured against one value axis whose ticks snap to round numbers.
7
+ Inputs: `data: readonly ColumnChartPoint[]` (required), `showValues: boolean = true` (each column prints its own value above itself), `tickCount: number = 5` (a hint: ticks snap to a round step, so an axis asked for three ends up with five and one asked for ten stops at eight), `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
8
+ Output: `(pointClicked): ColumnChartPoint` — same contract as `ds-bar-chart`'s `rowClicked`.
9
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
10
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
11
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
12
+ Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
13
+ Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
14
+ Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped).
@@ -0,0 +1,17 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-donut-chart>` — `DonutChartComponent`
3
+
4
+ Group: Charts
5
+
6
+ A ring that splits one total into its parts, with the middle free for the total or a headline figure of your own.
7
+ Inputs: `data: readonly DonutChartSlice[]` (required), `centerValue: string | null = null`, `centerLabel: string | null = null`, `legend: 'end' | 'bottom' | 'none' = 'end'`, `maxSlices: number | null = null`, `otherLabel: string = 'Other'`, `thickness: number = 0.32`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
8
+ Output: `(sliceClicked): DonutChartSlice`
9
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
10
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
11
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
12
+ Slice: `DonutChartSlice = { id: string; label: string; value: number; slot?: number }`. `slot` is a 1-based palette slot: pinning a slice keeps every other slice's colour where it is when one is filtered out of `data`; left off, the colour follows the index and the whole ring repaints.
13
+ Colour: slices ARE different things, so this is the chart the categorical palette exists for — `--ds-chart-series-1-color` … `--ds-chart-series-8-color`.
14
+ Behaviour: percentages use largest-remainder rounding, so a legend's shares add up to exactly 100 and a real non-zero slice never prints `0%`.
15
+ `maxSlices` caps the legend: past it the smallest slices are summed into one named by `otherLabel`, which takes the neutral eighth palette slot. Off by default, because grouping changes what the chart says. The kept slices stay in the order given rather than being re-sorted by value, and the total is unchanged — the tail is summed, never dropped. A limit below 2 is ignored.
16
+ `thickness: 1` closes the hole into a pie. The centre value renders unconditionally either way, falling back to the formatted total, so over a pie it sits on the slices and carries a halo of the chart's own background — no single text colour is readable against three different hues. The centre box is held to the square that fits inside the hole, so a long `centerLabel` wraps rather than running out over the ring.
17
+ Tokens: `--ds-donut-chart-size`, `--ds-donut-chart-gap`, `--ds-donut-chart-swatch-size`, `--ds-donut-chart-legend-row-gap`, `--ds-donut-chart-legend-row-height`, `--ds-donut-chart-outline-width` (the placeholder ring drawn when there is no data and when every slice is zero).
@@ -0,0 +1,16 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-funnel-chart>` — `FunnelChartComponent`
3
+
4
+ Group: Charts
5
+
6
+ Stages of a journey, drawn top to bottom in the order you give them — they are never sorted, because the order is the meaning.
7
+ Inputs: `data: readonly FunnelChartStage[]` (required), `shape: 'taper' | 'width' | 'area' = 'area'`, `showTable: boolean = true` (the aligned stage table under the funnel: value, share of the first stage, and how much fell away since the stage above), `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `staggerMs: number = 0`
8
+ Output: `(stageClicked): FunnelChartStage`
9
+ Interaction: `interactive: boolean = false` turns on the affordance — pointer cursor, hover tint and the keyboard route. The output fires whether or not it is set. The keyboard route is ONE tab stop for the whole chart, not one per mark: arrows walk the marks, Home and End reach the extremes, and the ends wrap. `tooltip: 'item' | 'none' = 'item'` opens a panel for the hovered, tapped or focused mark; a tap latches it until the next tap outside. Project an `<ng-template #dsChartTooltip let-tip>` to replace its contents — `tip` is `{ category: string; entries: { label, value, formatted, color }[] }`.
10
+ Motion: marks that leave finish leaving before marks that arrive start. `staggerMs: number = 0` spaces the arrivals; `40` is the documented step and the total is capped at 300ms. Every duration is a `--ds-motion-chart-*` role, so `prefers-reduced-motion` zeroes them with nothing per chart.
11
+ States: `loading` draws skeleton marks at the real count; `error` shows `errorText` in place of the plot, which is a different claim from an empty `data` showing `emptyText`.
12
+ Stage: `FunnelChartStage = { id: string; label: string; value: number }`
13
+ Shape: `'area'` is the default — the fixed silhouette with the stage boundaries moved so each band's AREA is proportional to its value, the honest encoding that still leaves a labellable tail. `'width'` reads every boundary straight off the values, which collapses the tail of a steep funnel below a labellable width. `'taper'` encodes NOTHING: the silhouette is fixed whatever the data, so editing the values moves the table and never the shape — reach for it only where the numbers are read from the table.
14
+ `dataTable` is suppressed while `showTable` is on: with both, the same numbers print twice.
15
+ Colour: the stages are one quantity draining, not N categories, so they take the single-hue ramp `--ds-chart-ramp-1-color` … `--ds-chart-ramp-8-color`, spread across however many stages there are. The LAST stage leaves the ramp for `--ds-chart-series-accent-color` — it is the outcome the funnel is read for.
16
+ Tokens: `--ds-funnel-chart-stage-height`, `--ds-funnel-chart-stage-gap`, `--ds-funnel-chart-row-gap`.
@@ -0,0 +1,15 @@
1
+ <!-- GENERATED by tools/split-agent-catalogue.mjs from components.md. Do not edit. -->
2
+ # `<ds-line-chart>` — `LineChartComponent`
3
+
4
+ Group: Charts
5
+
6
+ One or more series plotted over a shared set of categories.
7
+ Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'rounded' | 'exact' | 'independent' | 'stacked' = 'rounded'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = 'toggle'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 0`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string = 'All series are hidden'`
8
+ Output: `(pointClicked): LineChartPoint` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
9
+ Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. Tabbing reaches ONE marker per series; arrows walk that series' readings, and a focused marker's tooltip names its own series alone. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`.
10
+ Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering an entry dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
11
+ Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
12
+ Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
13
+ `yAxisMode` only matters once a series sets `axis: 'secondary'`: `'rounded'` shares one set of gridlines and rounds the secondary step up, so that series stops short of the top; `'exact'` shares the gridlines but ends the secondary axis on its largest reading, so it uses the full height and its labels are not round; `'independent'` scales and grids each axis on its own; `'stacked'` draws two plots one above the other, sharing the category axis.
14
+ Colour: series ARE different things, so the categorical palette applies — `--ds-chart-series-1-color` onward, by position or by `slot`.
15
+ Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`.
@@ -3,14 +3,16 @@
3
3
 
4
4
  Group: Form & input
5
5
 
6
- Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: string | readonly unknown[] | null = null` / `href: string = ''`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
6
+ Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: DsRouterLink = null` (a path, a command array or a `UrlTree`) / `href: string = ''`, with the modifiers `fragment` / `queryParams` / `queryParamsHandling` (routerLink-only) and `target` / `rel` (either link), plus `routerLinkActiveOptions` and `ariaCurrent`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
7
7
  Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
8
8
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
9
9
  **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
10
+ **Modifying a destination.** `fragment`, `queryParams` and `queryParamsHandling` go with a `routerLink` and dev-warn on any other destination; `target` and `rel` work on both link destinations and dev-warn on a plain button. Each is a pass-through to the anchor the component already renders. For the `UrlCreationOptions` with no input here — `relativeTo`, `preserveFragment` — pass a `UrlTree` built with `Router.createUrlTree` as the `routerLink`; folding a query or hash into the link STRING does not work, because `createUrlTree` treats the commands as path segments and percent-encodes `?` and `#`. Do NOT import `RouterLink` in your own component to write the extra inputs on a `<ds-button>`: the directive's selector matches the host, so that puts a SECOND `RouterLink` on the control disagreeing with the anchor's about where it goes.
11
+ **What an active link announces, and why it is not the `active` class.** An EXACT match announces `aria-current="page"`, a PREFIX match announces `true`, everything else announces nothing — ARIA's own split: `page` is the page you are on, `true` is the current section or an ancestor. The `active` CLASS keeps matching by prefix, so a section link still looks lit; `routerLinkActiveOptions` moves the class and `ariaCurrent` overrides the announcement (`null` silences it). Before this the attribute was derived from `routerLinkActive`, so a back-link claimed to be the page the reader was leaving — invisible on a button, because `.active` is painted by nothing there. **Two mechanism traps, both measured.** `RouterLinkActive.update()` removes `aria-current` from its host in a microtask whenever its own `ariaCurrentWhenActive` is unset, so an `[attr.aria-current]` binding on the same element is written and then wiped — the value has to go through `ariaCurrentWhenActive`. And a RELATIVE destination (`routerLink="."`, `['..', 'x']`) has to be resolved against the route the control sits on, exactly as `RouterLink` does: resolved from the root instead, `.` becomes `/`, which is a prefix of every page, so the control that IS the current page announces `true`.
10
12
  **A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
11
13
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
12
14
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
13
15
  - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
14
16
  - **Temporary** (the form is not filled in yet): do NOT disable the button at all. Leave it live, judge validity in the submit handler, and carry the text UNDER the button with `hint` / `warning` / `error` — the same three inputs the fields take, resolved and rendered by the same `ds-field-message` row the fields use, with the same `messageIcon` and `reserveMessage` knobs and the same `DS_CONFIG.field.*` fallbacks. Those inputs live on an internal shared base class that `ButtonComponent` and every field extend, so the behaviour cannot drift apart. What it does NOT take is `errors` / `invalid` / `touched`: a button has no validation state of its own.
15
17
  Layout: a message-bearing button becomes a column (host class `with-message`), and because the host shrinks to fit, a message longer than the label widens the pair — button included, exactly as a field's control spans its own message. Without a message the host keeps the `inline-flex` box every existing layout was built against.
16
- Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border`, `--ds-button-radius`, `--ds-button-focus-shadow`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
18
+ Tokens: `--ds-button-bg-color`, `--ds-button-bg-color-hover`, `--ds-button-bg-color-active`, `--ds-button-bg-color-disabled`, `--ds-button-label-color`, `--ds-button-label-color-disabled`, `--ds-button-border-color`, `--ds-button-border-color-disabled`, `--ds-button-border-width`, `--ds-button-radius`, `--ds-button-focus-shadow`, `--ds-button-pressed-shadow`, `--ds-button-shadow`, `--ds-button-shadow-hover`. The last two are the REST and hover shadow, both `none` by default — before them the only way to give a button a resting shadow was a deep selector into its inner `<button>`. `-shadow-hover` falls back to `-shadow`, so setting the resting one alone keeps the button steady under the pointer; focus and pressed keep their own hooks and still win while those states are on. For `variant="solid"`, `-bg-color-hover` / `-bg-color-active` / `-pressed-shadow` default to a `color-mix()` derivation of the resolved fill (88 % / 76 % + black — the theme's hover/pressed recipe), so overriding the fill alone retints the whole state set; tonal, outline, ghost and text keep explicit ramp defaults, so a full retint there means setting the state tokens too.
@@ -6,3 +6,4 @@ Group: Form & input
6
6
  Spinbox for bounded quantities — −/+ buttons around a numeric value.
7
7
  Inputs: `value: model<number> = 0`, `min: number = 0`, `max: number | null = null`, `step: number = 1`, `size: 'sm' | 'md' | 'lg' = 'md'`, `disabled: boolean = false`
8
8
  Methods: `inc()`, `dec()` (clamp to min/max). Buttons disable at the bounds.
9
+ Tokens: `--ds-number-stepper-field-width` sizes the number itself and is derived from the box height by default — a value with more digits than that width holds is clipped rather than wrapped, so widen it for large quantities. Also `--ds-number-stepper-bg-color`, `--ds-number-stepper-border-color`, `--ds-number-stepper-step-bg-color-active`, `--ds-number-stepper-focus-shadow`.
@@ -5,5 +5,6 @@ Group: Layout & navigation
5
5
 
6
6
  Inputs: `icon: IconName | null = null` (optional — falls back to `[icon]` slot), `label: required string`, `href: string = ''`, `routerLink: string | readonly unknown[] | null = null`, `active: boolean = false`, `badge: number | null = null`, `hasAlert: boolean = false`, `rail: boolean | null = null` (draws the active item's edge marker; unset follows the parent `ds-sidenav`)
7
7
  Content slots: `[icon]` (custom icon when not using a DS IconName), `[trailing]` (right-aligned chrome — badges, indicators, kbd shortcuts)
8
+ **What an active item announces.** An EXACT match on the item's destination announces `aria-current="page"`; a PREFIX match announces `true`, which in a sidenav is the useful case — "you are in this section". `ariaCurrent` overrides it, `null` silences it, and the `active` class is a separate question decided by `routerLinkActive`. `ds-sidenav-group` follows the same rule on a header that is itself a destination, and `routerLink` on both accepts a `UrlTree`. The value must go through `ariaCurrentWhenActive`, never `[attr.aria-current]`, and a relative destination must be resolved against the control's own route — see the two traps under `ds-button`.
8
9
  **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`**. Until 0.11.0 the last case fell back to `href="#"`, which navigates: it rewrites the URL and discards the scroll position on every click. An item that only emits `activate` is a button. Styling is identical across all three — the rules are class-based (`.item`) and the button's UA chrome is reset — so target the class, never the tag.
9
10
  Tokens (on `:host`): `--ds-sidenav-item-label-color`, `--ds-sidenav-item-label-color-hover`, `--ds-sidenav-item-bg-color-hover`, `--ds-sidenav-item-bg-color-active` (default: `--accent-subtitle` — a wash, not a solid pill), `--ds-sidenav-item-label-color-active` (default: `--accent-strong`), `--ds-sidenav-item-bg-color-active-hover` (default: `--accent-muted`, deepening toward the accent), `--ds-sidenav-item-rail` (left rail, default: `--accent-strong`), `--ds-sidenav-item-radius`, `--ds-sidenav-alert-color`
@@ -38,11 +38,11 @@ class AccordionItemComponent {
38
38
  this.expanded.set(false);
39
39
  }
40
40
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.22", ngImport: i0, type: AccordionItemComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
41
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.22", type: AccordionItemComponent, isStandalone: true, selector: "ds-accordion-item", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: true, transformFunction: null }, expanded: { classPropertyName: "expanded", publicName: "expanded", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { expanded: "expandedChange" }, ngImport: i0, template: "<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n", styles: [":where(:focus-visible){outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:var(--focus-ring-offset);animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}@keyframes ds-focus-ring-in{0%{outline-color:transparent}}:root[data-focus=ring]{--ds-field-focus-shadow: var(--focus-ring);--ds-field-focus-shadow-error: var(--focus-ring-error)}:root[data-focus=edge]{--focus-ring-offset: 0px;--ds-field-focus-shadow: 0 0 0 var(--border-width-default) var(--primary);--ds-field-focus-shadow-error: 0 0 0 var(--border-width-default) var(--error)}[data-focus=inset]{--focus-ring-offset: calc(-1 * var(--focus-ring-width));--ds-field-focus-shadow: var(--focus-ring-inset);--ds-field-focus-shadow-error: var(--focus-ring-inset-error)}@media(forced-colors:active){:where(:focus-visible){outline:var(--focus-ring-width) solid CanvasText;outline-offset:var(--focus-ring-offset)}}:host{--_accordion-header-bg-color: var(--ds-accordion-header-bg-color, var(--surface-default));--_accordion-header-text-color: var(--ds-accordion-header-text-color, var(--text-primary));--_accordion-header-hover-bg-color: var(--ds-accordion-header-hover-bg-color, var(--surface-secondary));--_accordion-divider-color: var(--ds-accordion-divider-color, var(--border-divider));--_accordion-chevron-color: var(--ds-accordion-chevron-color, var(--icon-default));--_accordion-body-text-color: var(--ds-accordion-body-text-color, var(--text-secondary));display:block}:host+:host{border-top:var(--border-width-default) solid var(--_accordion-divider-color)}:host:first-of-type .head{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}:host:last-of-type .head{border-bottom-left-radius:var(--radius-lg);border-bottom-right-radius:var(--radius-lg)}:host .head{display:flex;align-items:center;gap:var(--space-2);width:100%;padding:var(--space-3) var(--space-4);border:0;background:var(--_accordion-header-bg-color);text-align:left;cursor:pointer;font:var(--font-weight-medium) var(--font-size-s)/var(--line-height-flat) var(--font-sans);color:var(--_accordion-header-text-color)}:host .head:hover:not(:disabled){background:var(--_accordion-header-hover-bg-color)}:host .head:active:not(:disabled){background:var(--surface-muted)}:host .head:focus-visible{outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:calc(-1 * var(--focus-ring-width));animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}:host .head .chev{margin-left:auto;transition:transform var(--duration-base) var(--ease-standard);color:var(--_accordion-chevron-color)}:host .head[aria-expanded=true] .chev{transform:rotate(90deg)}:host .head:disabled{cursor:not-allowed;color:var(--text-disabled)}:host .head:disabled .chev{color:var(--text-disabled)}:host .body{display:grid;grid-template-rows:0fr;transition:grid-template-rows var(--duration-base) var(--ease-standard)}:host .body.is-open{grid-template-rows:1fr}@media(prefers-reduced-motion:reduce){:host .body{transition:none}}:host .body-inner{overflow:hidden;min-height:0}:host .body-content{padding:var(--space-2) var(--space-4) var(--space-4);color:var(--_accordion-body-text-color);font:var(--font-weight-regular) var(--font-size-s)/var(--line-height-base) var(--font-sans)}\n"], dependencies: [{ kind: "component", type: IconComponent, selector: "ds-icon", inputs: ["name", "size", "stroke", "ariaLabel"] }] });
41
+ static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.22", type: AccordionItemComponent, isStandalone: true, selector: "ds-accordion-item", inputs: { title: { classPropertyName: "title", publicName: "title", isSignal: true, isRequired: true, transformFunction: null }, expanded: { classPropertyName: "expanded", publicName: "expanded", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { expanded: "expandedChange" }, ngImport: i0, template: "<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n", styles: ["@charset \"UTF-8\";:where(:focus-visible){outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:var(--focus-ring-offset);animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}@keyframes ds-focus-ring-in{0%{outline-color:transparent}}:root[data-focus=ring]{--ds-field-focus-shadow: var(--focus-ring);--ds-field-focus-shadow-error: var(--focus-ring-error)}:root[data-focus=edge]{--focus-ring-offset: 0px;--ds-field-focus-shadow: 0 0 0 var(--border-width-default) var(--primary);--ds-field-focus-shadow-error: 0 0 0 var(--border-width-default) var(--error)}[data-focus=inset]{--focus-ring-offset: calc(-1 * var(--focus-ring-width));--ds-field-focus-shadow: var(--focus-ring-inset);--ds-field-focus-shadow-error: var(--focus-ring-inset-error)}@media(forced-colors:active){:where(:focus-visible){outline:var(--focus-ring-width) solid CanvasText;outline-offset:var(--focus-ring-offset)}}:host{--_accordion-header-bg-color: var(--ds-accordion-header-bg-color, var(--surface-default));--_accordion-header-text-color: var(--ds-accordion-header-text-color, var(--text-primary));--_accordion-header-hover-bg-color: var(--ds-accordion-header-hover-bg-color, var(--surface-secondary));--_accordion-divider-color: var(--ds-accordion-divider-color, var(--border-divider));--_accordion-chevron-color: var(--ds-accordion-chevron-color, var(--icon-default));--_accordion-body-text-color: var(--ds-accordion-body-text-color, var(--text-secondary));display:block}:host+:host{border-top:var(--border-width-default) solid var(--_accordion-divider-color)}:host:first-of-type .head{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}:host:last-of-type .head{border-bottom-left-radius:var(--radius-lg);border-bottom-right-radius:var(--radius-lg)}:host .head{display:flex;align-items:center;gap:var(--space-2);width:100%;padding:var(--space-3) var(--space-4);border:0;background:var(--_accordion-header-bg-color);text-align:left;cursor:pointer;font:var(--font-weight-medium) var(--font-size-s)/var(--line-height-flat) var(--font-sans);color:var(--_accordion-header-text-color)}:host .head:hover:not(:disabled){background:var(--_accordion-header-hover-bg-color)}:host .head:active:not(:disabled){background:var(--surface-muted)}:host .head:focus-visible{outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:calc(-1 * var(--focus-ring-width));animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}:host .head .chev{margin-left:auto;transition:transform var(--duration-base) var(--ease-standard);color:var(--_accordion-chevron-color)}:host .head[aria-expanded=true] .chev{transform:rotate(90deg)}:host .head:disabled{cursor:not-allowed;color:var(--text-disabled)}:host .head:disabled .chev{color:var(--text-disabled)}:host .body{display:grid;grid-template-rows:0fr;transition:grid-template-rows var(--duration-base) var(--ease-standard)}:host .body.is-open{grid-template-rows:1fr}@media(prefers-reduced-motion:reduce){:host .body{transition:none}}:host .body-inner{overflow:hidden;min-height:0}:host .body-content{padding:var(--space-2) var(--space-4) var(--space-4);color:var(--_accordion-body-text-color);font:var(--font-weight-regular) var(--font-size-s)/var(--line-height-base) var(--font-sans)}\n"], dependencies: [{ kind: "component", type: IconComponent, selector: "ds-icon", inputs: ["name", "size", "stroke", "ariaLabel"] }] });
42
42
  }
43
43
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.22", ngImport: i0, type: AccordionItemComponent, decorators: [{
44
44
  type: Component,
45
- args: [{ selector: 'ds-accordion-item', standalone: true, imports: [IconComponent], encapsulation: ViewEncapsulation.Emulated, template: "<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n", styles: [":where(:focus-visible){outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:var(--focus-ring-offset);animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}@keyframes ds-focus-ring-in{0%{outline-color:transparent}}:root[data-focus=ring]{--ds-field-focus-shadow: var(--focus-ring);--ds-field-focus-shadow-error: var(--focus-ring-error)}:root[data-focus=edge]{--focus-ring-offset: 0px;--ds-field-focus-shadow: 0 0 0 var(--border-width-default) var(--primary);--ds-field-focus-shadow-error: 0 0 0 var(--border-width-default) var(--error)}[data-focus=inset]{--focus-ring-offset: calc(-1 * var(--focus-ring-width));--ds-field-focus-shadow: var(--focus-ring-inset);--ds-field-focus-shadow-error: var(--focus-ring-inset-error)}@media(forced-colors:active){:where(:focus-visible){outline:var(--focus-ring-width) solid CanvasText;outline-offset:var(--focus-ring-offset)}}:host{--_accordion-header-bg-color: var(--ds-accordion-header-bg-color, var(--surface-default));--_accordion-header-text-color: var(--ds-accordion-header-text-color, var(--text-primary));--_accordion-header-hover-bg-color: var(--ds-accordion-header-hover-bg-color, var(--surface-secondary));--_accordion-divider-color: var(--ds-accordion-divider-color, var(--border-divider));--_accordion-chevron-color: var(--ds-accordion-chevron-color, var(--icon-default));--_accordion-body-text-color: var(--ds-accordion-body-text-color, var(--text-secondary));display:block}:host+:host{border-top:var(--border-width-default) solid var(--_accordion-divider-color)}:host:first-of-type .head{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}:host:last-of-type .head{border-bottom-left-radius:var(--radius-lg);border-bottom-right-radius:var(--radius-lg)}:host .head{display:flex;align-items:center;gap:var(--space-2);width:100%;padding:var(--space-3) var(--space-4);border:0;background:var(--_accordion-header-bg-color);text-align:left;cursor:pointer;font:var(--font-weight-medium) var(--font-size-s)/var(--line-height-flat) var(--font-sans);color:var(--_accordion-header-text-color)}:host .head:hover:not(:disabled){background:var(--_accordion-header-hover-bg-color)}:host .head:active:not(:disabled){background:var(--surface-muted)}:host .head:focus-visible{outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:calc(-1 * var(--focus-ring-width));animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}:host .head .chev{margin-left:auto;transition:transform var(--duration-base) var(--ease-standard);color:var(--_accordion-chevron-color)}:host .head[aria-expanded=true] .chev{transform:rotate(90deg)}:host .head:disabled{cursor:not-allowed;color:var(--text-disabled)}:host .head:disabled .chev{color:var(--text-disabled)}:host .body{display:grid;grid-template-rows:0fr;transition:grid-template-rows var(--duration-base) var(--ease-standard)}:host .body.is-open{grid-template-rows:1fr}@media(prefers-reduced-motion:reduce){:host .body{transition:none}}:host .body-inner{overflow:hidden;min-height:0}:host .body-content{padding:var(--space-2) var(--space-4) var(--space-4);color:var(--_accordion-body-text-color);font:var(--font-weight-regular) var(--font-size-s)/var(--line-height-base) var(--font-sans)}\n"] }]
45
+ args: [{ selector: 'ds-accordion-item', standalone: true, imports: [IconComponent], encapsulation: ViewEncapsulation.Emulated, template: "<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n", styles: ["@charset \"UTF-8\";:where(:focus-visible){outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:var(--focus-ring-offset);animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}@keyframes ds-focus-ring-in{0%{outline-color:transparent}}:root[data-focus=ring]{--ds-field-focus-shadow: var(--focus-ring);--ds-field-focus-shadow-error: var(--focus-ring-error)}:root[data-focus=edge]{--focus-ring-offset: 0px;--ds-field-focus-shadow: 0 0 0 var(--border-width-default) var(--primary);--ds-field-focus-shadow-error: 0 0 0 var(--border-width-default) var(--error)}[data-focus=inset]{--focus-ring-offset: calc(-1 * var(--focus-ring-width));--ds-field-focus-shadow: var(--focus-ring-inset);--ds-field-focus-shadow-error: var(--focus-ring-inset-error)}@media(forced-colors:active){:where(:focus-visible){outline:var(--focus-ring-width) solid CanvasText;outline-offset:var(--focus-ring-offset)}}:host{--_accordion-header-bg-color: var(--ds-accordion-header-bg-color, var(--surface-default));--_accordion-header-text-color: var(--ds-accordion-header-text-color, var(--text-primary));--_accordion-header-hover-bg-color: var(--ds-accordion-header-hover-bg-color, var(--surface-secondary));--_accordion-divider-color: var(--ds-accordion-divider-color, var(--border-divider));--_accordion-chevron-color: var(--ds-accordion-chevron-color, var(--icon-default));--_accordion-body-text-color: var(--ds-accordion-body-text-color, var(--text-secondary));display:block}:host+:host{border-top:var(--border-width-default) solid var(--_accordion-divider-color)}:host:first-of-type .head{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}:host:last-of-type .head{border-bottom-left-radius:var(--radius-lg);border-bottom-right-radius:var(--radius-lg)}:host .head{display:flex;align-items:center;gap:var(--space-2);width:100%;padding:var(--space-3) var(--space-4);border:0;background:var(--_accordion-header-bg-color);text-align:left;cursor:pointer;font:var(--font-weight-medium) var(--font-size-s)/var(--line-height-flat) var(--font-sans);color:var(--_accordion-header-text-color)}:host .head:hover:not(:disabled){background:var(--_accordion-header-hover-bg-color)}:host .head:active:not(:disabled){background:var(--surface-muted)}:host .head:focus-visible{outline:var(--focus-ring-width) solid var(--focus-ring-color);outline-offset:calc(-1 * var(--focus-ring-width));animation:ds-focus-ring-in var(--duration-fast) var(--ease-standard)}:host .head .chev{margin-left:auto;transition:transform var(--duration-base) var(--ease-standard);color:var(--_accordion-chevron-color)}:host .head[aria-expanded=true] .chev{transform:rotate(90deg)}:host .head:disabled{cursor:not-allowed;color:var(--text-disabled)}:host .head:disabled .chev{color:var(--text-disabled)}:host .body{display:grid;grid-template-rows:0fr;transition:grid-template-rows var(--duration-base) var(--ease-standard)}:host .body.is-open{grid-template-rows:1fr}@media(prefers-reduced-motion:reduce){:host .body{transition:none}}:host .body-inner{overflow:hidden;min-height:0}:host .body-content{padding:var(--space-2) var(--space-4) var(--space-4);color:var(--_accordion-body-text-color);font:var(--font-weight-regular) var(--font-size-s)/var(--line-height-base) var(--font-sans)}\n"] }]
46
46
  }], ctorParameters: () => [], propDecorators: { title: [{ type: i0.Input, args: [{ isSignal: true, alias: "title", required: true }] }], expanded: [{ type: i0.Input, args: [{ isSignal: true, alias: "expanded", required: false }] }, { type: i0.Output, args: ["expandedChange"] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }] } });
47
47
 
48
48
  class AccordionComponent {
@@ -1 +1 @@
1
- {"version":3,"file":"ids-group-ltd-ids-design-system-components-accordion.mjs","sources":["../../../src/lib/components/accordion/accordion.token.ts","../../../src/lib/components/accordion/accordion-item.component.ts","../../../src/lib/components/accordion/accordion-item.component.html","../../../src/lib/components/accordion/accordion.component.ts","../../../src/lib/components/accordion/ids-group-ltd-ids-design-system-components-accordion.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\n\n/** Contract that ds-accordion-item reads from its parent ds-accordion. */\nexport interface AccordionContract {\n readonly multi: () => boolean;\n /** Called when an item opens; coordinator may close other items. */\n notifyOpen(item: AccordionItemRef): void;\n}\n\n/** Contract ds-accordion reads back from each projected item. */\nexport interface AccordionItemRef {\n /** Closes this item (sets expanded to false). */\n closeItem(): void;\n}\n\nexport const ACCORDION = new InjectionToken<AccordionContract>('ACCORDION');\n","import {\n Component,\n ViewEncapsulation,\n booleanAttribute,\n effect,\n inject,\n input,\n model,\n} from '@angular/core';\nimport { IconComponent } from '@ids-group-ltd/ids-design-system/icons';\nimport { ACCORDION, type AccordionItemRef } from './accordion.token';\n\nlet nextId = 0;\n\n@Component({\n selector: 'ds-accordion-item',\n standalone: true,\n imports: [IconComponent],\n templateUrl: './accordion-item.component.html',\n styleUrl: './accordion-item.component.scss',\n encapsulation: ViewEncapsulation.Emulated,\n})\nexport class AccordionItemComponent implements AccordionItemRef {\n /** Header text shown in the toggle button. */\n readonly title = input.required<string>();\n /** Open state, two-way bound. */\n readonly expanded = model<boolean>(false);\n /** Disables the toggle button; state stays as-is. */\n readonly disabled = input(false, { transform: booleanAttribute });\n\n protected readonly uid = `ds-accordion-${++nextId}`;\n protected readonly headId = `${this.uid}-head`;\n protected readonly bodyId = `${this.uid}-body`;\n\n private readonly accordion = inject(ACCORDION, { optional: true });\n\n /** Tracks last expanded state so we only notify on a true open transition. */\n private previousExpanded = false;\n\n constructor() {\n effect(() => {\n const isExpanded = this.expanded();\n if (isExpanded && !this.previousExpanded) {\n this.accordion?.notifyOpen(this);\n }\n this.previousExpanded = isExpanded;\n });\n }\n\n protected toggle(): void {\n if (this.disabled()) {\n return;\n }\n this.expanded.set(!this.expanded());\n }\n\n /** Called by the accordion coordinator to enforce single-open mode. */\n closeItem(): void {\n this.expanded.set(false);\n }\n}\n","<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n","import {\n Component,\n ViewEncapsulation,\n booleanAttribute,\n contentChildren,\n forwardRef,\n input,\n} from '@angular/core';\nimport {\n ACCORDION,\n type AccordionContract,\n type AccordionItemRef,\n} from './accordion.token';\nimport { AccordionItemComponent } from './accordion-item.component';\n\n@Component({\n selector: 'ds-accordion',\n standalone: true,\n imports: [],\n template: `<ng-content></ng-content>`,\n styles: [\n `\n :host {\n display: block;\n border: var(--border-width-default) solid var(--border-divider);\n border-radius: var(--radius-lg);\n overflow: hidden;\n }\n `,\n ],\n encapsulation: ViewEncapsulation.Emulated,\n providers: [\n {\n provide: ACCORDION,\n useExisting: forwardRef(() => AccordionComponent),\n },\n ],\n})\nexport class AccordionComponent implements AccordionContract {\n /** When false, opening one item automatically closes all others. */\n readonly multi = input(true, { transform: booleanAttribute });\n\n private readonly items = contentChildren(AccordionItemComponent);\n\n notifyOpen(opened: AccordionItemRef): void {\n if (this.multi()) {\n return;\n }\n for (const item of this.items() as unknown as AccordionItemRef[]) {\n if (item !== opened) {\n item.closeItem();\n }\n }\n }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ids-group-ltd-ids-design-system-components-accordion.mjs","sources":["../../../src/lib/components/accordion/accordion.token.ts","../../../src/lib/components/accordion/accordion-item.component.ts","../../../src/lib/components/accordion/accordion-item.component.html","../../../src/lib/components/accordion/accordion.component.ts","../../../src/lib/components/accordion/ids-group-ltd-ids-design-system-components-accordion.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\n\n/** Contract that ds-accordion-item reads from its parent ds-accordion. */\nexport interface AccordionContract {\n readonly multi: () => boolean;\n /** Called when an item opens; coordinator may close other items. */\n notifyOpen(item: AccordionItemRef): void;\n}\n\n/** Contract ds-accordion reads back from each projected item. */\nexport interface AccordionItemRef {\n /** Closes this item (sets expanded to false). */\n closeItem(): void;\n}\n\nexport const ACCORDION = new InjectionToken<AccordionContract>('ACCORDION');\n","import {\n Component,\n ViewEncapsulation,\n booleanAttribute,\n effect,\n inject,\n input,\n model,\n} from '@angular/core';\nimport { IconComponent } from '@ids-group-ltd/ids-design-system/icons';\nimport { ACCORDION, type AccordionItemRef } from './accordion.token';\n\nlet nextId = 0;\n\n@Component({\n selector: 'ds-accordion-item',\n standalone: true,\n imports: [IconComponent],\n templateUrl: './accordion-item.component.html',\n styleUrl: './accordion-item.component.scss',\n encapsulation: ViewEncapsulation.Emulated,\n})\nexport class AccordionItemComponent implements AccordionItemRef {\n /** Header text shown in the toggle button. */\n readonly title = input.required<string>();\n /** Open state, two-way bound. */\n readonly expanded = model<boolean>(false);\n /** Disables the toggle button; state stays as-is. */\n readonly disabled = input(false, { transform: booleanAttribute });\n\n protected readonly uid = `ds-accordion-${++nextId}`;\n protected readonly headId = `${this.uid}-head`;\n protected readonly bodyId = `${this.uid}-body`;\n\n private readonly accordion = inject(ACCORDION, { optional: true });\n\n /** Tracks last expanded state so we only notify on a true open transition. */\n private previousExpanded = false;\n\n constructor() {\n effect(() => {\n const isExpanded = this.expanded();\n if (isExpanded && !this.previousExpanded) {\n this.accordion?.notifyOpen(this);\n }\n this.previousExpanded = isExpanded;\n });\n }\n\n protected toggle(): void {\n if (this.disabled()) {\n return;\n }\n this.expanded.set(!this.expanded());\n }\n\n /** Called by the accordion coordinator to enforce single-open mode. */\n closeItem(): void {\n this.expanded.set(false);\n }\n}\n","<button\n type=\"button\"\n class=\"head\"\n [id]=\"headId\"\n [attr.aria-expanded]=\"expanded()\"\n [attr.aria-controls]=\"bodyId\"\n [disabled]=\"disabled() || null\"\n [attr.aria-disabled]=\"disabled() ? 'true' : null\"\n (click)=\"toggle()\">\n <span>\n {{ title() }}\n </span>\n\n <ng-content select=\"[badge]\"></ng-content>\n\n <ds-icon\n name=\"chevronRight\"\n class=\"chev\"\n [size]=\"16\" />\n</button>\n\n<div\n class=\"body\"\n role=\"region\"\n [id]=\"bodyId\"\n [attr.aria-labelledby]=\"headId\"\n [class.is-open]=\"expanded()\"\n [attr.inert]=\"expanded() ? null : ''\">\n <div class=\"body-inner\">\n <div class=\"body-content\">\n <ng-content></ng-content>\n </div>\n </div>\n</div>\n","import {\n Component,\n ViewEncapsulation,\n booleanAttribute,\n contentChildren,\n forwardRef,\n input,\n} from '@angular/core';\nimport {\n ACCORDION,\n type AccordionContract,\n type AccordionItemRef,\n} from './accordion.token';\nimport { AccordionItemComponent } from './accordion-item.component';\n\n@Component({\n selector: 'ds-accordion',\n standalone: true,\n imports: [],\n template: `<ng-content></ng-content>`,\n styles: [\n `\n :host {\n display: block;\n border: var(--border-width-default) solid var(--border-divider);\n border-radius: var(--radius-lg);\n overflow: hidden;\n }\n `,\n ],\n encapsulation: ViewEncapsulation.Emulated,\n providers: [\n {\n provide: ACCORDION,\n useExisting: forwardRef(() => AccordionComponent),\n },\n ],\n})\nexport class AccordionComponent implements AccordionContract {\n /** When false, opening one item automatically closes all others. */\n readonly multi = input(true, { transform: booleanAttribute });\n\n private readonly items = contentChildren(AccordionItemComponent);\n\n notifyOpen(opened: AccordionItemRef): void {\n if (this.multi()) {\n return;\n }\n for (const item of this.items() as unknown as AccordionItemRef[]) {\n if (item !== opened) {\n item.closeItem();\n }\n }\n }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}