@nldd/design-system 0.8.90 → 0.8.92

package/NOTICES.md

@@ -1,6 +1,6 @@
 ## Third-party notices
 
-Het NLDD Design System (de broncode) is gelicentieerd onder **EUPL-1.2**,
+Het NLDD Designsysteem (de broncode) is gelicentieerd onder **EUPL-1.2**,
 zie [`LICENSE`](./LICENSE) voor de volledige tekst. De fontbestanden in
 `src/assets/fonts/` vallen daar niet onder; die hebben hun eigen licenties:
 
@@ -49,7 +49,7 @@ Het feit dat de fontbestanden in deze repository aanwezig zijn impliceert
 geen licentie of toestemming buiten het hierboven beschreven kader; de
 publicatie dient om consumers binnen dat kader (zoals overheidspartners
 en contractors die voor de Rijksoverheid werken) een werkende installatie
-van het design system te bieden.
+van het designsysteem te bieden.
 
 Volledige gebruiksvoorwaarden:
 https://www.rijkshuisstijl.nl/basiselementen/typografie/gebruiksvoorwaarden-typografie

package/README.md

@@ -1,4 +1,4 @@
-# NLDD Design System
+# NLDD Designsysteem
 
 Web Components voor Nederlandse Digitale Dienst (Rijksoverheid).
 
@@ -125,7 +125,7 @@ Mis je een component of wil je een wijziging voorstellen? [Maak een issue aan](h
 
 ## Fonts
 
-Het design system gebruikt twee fonts, met verschillende licenties:
+Het designsysteem gebruikt twee fonts, met verschillende licenties:
 
 - **JetBrains Mono** (monospace) — vrij te gebruiken onder de
   [SIL Open Font License 1.1](https://openfontlicense.org).
@@ -143,7 +143,7 @@ buiten het hierboven beschreven kader.
 
 Copyright © 2026 Staat der Nederlanden.
 
-De broncode van dit design system valt onder de **EUPL-1.2**. De volledige
+De broncode van dit designsysteem valt onder de **EUPL-1.2**. De volledige
 licentietekst staat in [`LICENSE`](./LICENSE).
 
 De fontbestanden in `src/assets/fonts/` vallen daar niet onder; die hebben hun

package/custom-elements.json

@@ -481,7 +481,7 @@
                 "text": "string | undefined"
               },
               "default": "undefined",
-              "description": "Link rel attribute. Only used when href is set.\nDefaults to 'noopener noreferrer' when target is '_blank' and rel is not explicitly set.",
+              "description": "Link rel attribute. Only used when href is set.\nWith target '_blank', 'noopener noreferrer' is added to it.",
               "attribute": "rel"
             },
             {
@@ -748,7 +748,7 @@
                 "text": "string | undefined"
               },
               "default": "undefined",
-              "description": "Link rel attribute; defaults to 'noopener noreferrer' when target is '_blank'",
+              "description": "Link rel attribute, used with href; with target '_blank', 'noopener noreferrer' is added to whatever you set",
               "fieldName": "rel"
             },
             {
@@ -1066,7 +1066,7 @@
                 "text": "string | undefined"
               },
               "default": "undefined",
-              "description": "Link rel attribute. Only used when href is set.\nDefaults to 'noopener noreferrer' when target is '_blank' and rel is not explicitly set.",
+              "description": "Link rel attribute. Only used when href is set.\nWith target '_blank', 'noopener noreferrer' is added to it.",
               "attribute": "rel"
             },
             {
@@ -1279,7 +1279,7 @@
                 "text": "string | undefined"
               },
               "default": "undefined",
-              "description": "Link rel attribute; defaults to 'noopener noreferrer' when target is '_blank'",
+              "description": "Link rel attribute, used with href; with target '_blank', 'noopener noreferrer' is added to whatever you set",
               "fieldName": "rel"
             },
             {
@@ -3314,7 +3314,7 @@
               },
               "default": "''",
               "fieldName": "rel",
-              "description": "Link rel for href; defaults to 'noopener noreferrer' when target='_blank'"
+              "description": "Link rel for href; with target '_blank', 'noopener noreferrer' is added to whatever you set"
             },
             {
               "name": "translations",
@@ -3620,7 +3620,7 @@
         },
         {
           "kind": "class",
-          "description": "A customizable icon component that renders SVG icons from a predefined library. Icons are decorative by default: the host gets `aria-hidden=\"true\"` automatically. If you want the icon to be announced by assistive tech, set `aria-hidden=\"false\"` on the consumer side together with an `aria-label`. Sizing: the icon fills whatever sizes it — an `nldd-icon-cell`, a button, a menu item. `size=\"full\"` names that default explicitly. `size=\"inherit\"` makes it follow the surrounding text (1em), for an icon set inline in a sentence. Any spacer-aligned number (16–96) pins a fixed dimension. Reach for `inherit` rather than a global `nldd-icon { width: 1em }` rule in the consumer: such a rule wins over the component's own :host styling and so also shrinks the icons that a cell or button was already sizing correctly. Color: by default the icon inherits its parent's `color`. Set `color` to one of the functional semantics (`primary-content`, `secondary-content`, `accent`, `critical`, `warning`, `success`) or a rijkskleur (`lintblauw`, `paars`, `groen`, …). For a color the design system cannot know — the jacket of a cable, a color someone picked — set `custom-color` to any CSS color.",
+          "description": "A customizable icon component that renders SVG icons from a predefined library. Icons are decorative by default: the host gets `aria-hidden=\"true\"` automatically. If you want the icon to be announced by assistive tech, set `aria-hidden=\"false\"` on the consumer side together with an `aria-label`. Sizing: the icon fills whatever sizes it — an `nldd-icon-cell`, a button, a menu item. `size=\"full\"` names that default explicitly. `size=\"inherit\"` makes it follow the surrounding text (1em), for an icon set inline in a sentence. Any spacer-aligned number (16–96) pins a fixed dimension. Reach for `inherit` rather than a global `nldd-icon { width: 1em }` rule in the consumer: such a rule wins over the component's own :host styling and so also shrinks the icons that a cell or button was already sizing correctly. Color: by default the icon inherits its parent's `color`. Set `color` to one of the functional semantics (`primary-content`, `secondary-content`, `accent`, `critical`, `warning`, `success`) or a rijkskleur (`lintblauw`, `paars`, `groen`, …). For a color the system cannot know — the jacket of a cable, a color someone picked — set `custom-color` to any CSS color.",
           "name": "NLDDIcon",
           "members": [
             {
@@ -3707,7 +3707,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "A color of its own, as any CSS color value ('#a90061', 'oklch(0.6 0.2 20)', 'var(--brand-cable-blue)'). For a color the design system cannot know. It wins over `color`.",
+              "description": "A color of its own, as any CSS color value ('#a90061', 'oklch(0.6 0.2 20)', 'var(--brand-cable-blue)'). For a color the system cannot know. It wins over `color`.",
               "name": "custom-color",
               "default": "''",
               "fieldName": "customColor"
@@ -7330,6 +7330,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -7784,6 +7798,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -8283,6 +8311,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -8904,6 +8946,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -9540,6 +9596,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -10702,6 +10772,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -11260,6 +11344,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -11853,6 +11951,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -12463,6 +12575,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -12988,6 +13114,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -13609,6 +13749,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -14132,6 +14286,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -14781,6 +14949,20 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "The group has no focus of its own, so an invalid submit lands where Tab\nwould: on the chosen option, or the first one that is enabled.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -15364,6 +15546,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -16061,6 +16257,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -18629,6 +18839,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -19396,6 +19620,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -20085,6 +20323,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -21257,6 +21509,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -21791,6 +22057,20 @@
                 "module": "src/utilities/form-associated-mixin.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own.",
+              "inheritedFrom": {
+                "name": "FormAssociated",
+                "module": "src/utilities/form-associated-mixin.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -22307,7 +22587,7 @@
               },
               "default": "''",
               "fieldName": "rel",
-              "description": "Link rel for href; defaults to 'noopener noreferrer' with target='_blank'"
+              "description": "Link rel for href; with target '_blank', 'noopener noreferrer' is added to whatever you set"
             },
             {
               "name": "translations",
@@ -27852,7 +28132,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Add explicit space between elements. Components in this design system have no margins of their own — all whitespace is set by a spacer. Use a single `size` attribute for whitespace that's the same at every viewport. Combine with `sm-size`, `md-size` and/or `lg-size` to override the size at specific breakpoints (mobile-first cascade is intentionally avoided — each breakpoint that needs a different value declares it explicitly): - `size` applies at every breakpoint that has no per-viewport override. - `sm-size` overrides at sm (max-width: 640px). - `md-size` overrides at md (641px–1007px). - `lg-size` overrides at lg (min-width: 1008px). Use `flexible` (in any of the four attributes) to fill the remaining space in a flex container.",
+          "description": "Add explicit space between elements. Components here have no margins of their own — all whitespace is set by a spacer. Use a single `size` attribute for whitespace that's the same at every viewport. Combine with `sm-size`, `md-size` and/or `lg-size` to override the size at specific breakpoints (mobile-first cascade is intentionally avoided — each breakpoint that needs a different value declares it explicitly): - `size` applies at every breakpoint that has no per-viewport override. - `sm-size` overrides at sm (max-width: 640px). - `md-size` overrides at md (641px–1007px). - `lg-size` overrides at lg (min-width: 1008px). Use `flexible` (in any of the four attributes) to fill the remaining space in a flex container.",
           "name": "NLDDSpacer",
           "members": [
             {
@@ -30860,7 +31140,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Link rel forwarded to the `<a>`; only applies with `href`",
+              "description": "Link rel forwarded to the `<a>`, only with `href`; with target '_blank', 'noopener noreferrer' is added to whatever you set",
               "name": "rel",
               "fieldName": "rel"
             },
@@ -31104,7 +31384,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Link rel (e.g. 'noopener noreferrer'). Forwarded to the `<a>`; only applies with href.",
+              "description": "Link rel, forwarded to the `<a>` with href. With target '_blank',\n'noopener noreferrer' is added to it.",
               "attribute": "rel",
               "reflects": true
             },
@@ -31277,7 +31557,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Link rel forwarded to the `<a>` (e.g. 'noopener noreferrer'); only applies with `href`",
+              "description": "Link rel forwarded to the `<a>`, only with `href`; with target '_blank', 'noopener noreferrer' is added to whatever you set",
               "name": "rel",
               "fieldName": "rel"
             },
@@ -32437,7 +32717,7 @@
               },
               "default": "undefined",
               "fieldName": "rel",
-              "description": "Link rel attribute; defaults to 'noopener noreferrer' with target='_blank'"
+              "description": "Link rel attribute; with target '_blank', 'noopener noreferrer' is added to whatever you set"
             },
             {
               "name": "size",
@@ -34417,7 +34697,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "A color of its own, as any CSS color value ('#a90061', 'oklch(0.6 0.2 20)', 'var(--brand-cable-blue)'). For a color the design system cannot know: the jacket of a cable, a color someone picked. It wins over `color`. Whatever it paints, the text and icon on top become white or black, whichever contrasts. The text on it is black or white, picked on the relative luminance of the fill, so it clears 4.5:1 whatever color you hand it.",
+              "description": "A color of its own, as any CSS color value ('#a90061', 'oklch(0.6 0.2 20)', 'var(--brand-cable-blue)'). For a color the system cannot know: the jacket of a cable, a color someone picked. It wins over `color`. Whatever it paints, the text and icon on top become white or black, whichever contrasts. The text on it is black or white, picked on the relative luminance of the fill, so it clears 4.5:1 whatever color you hand it.",
               "fieldName": "customColor"
             },
             {
@@ -36474,7 +36754,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Link rel; defaults to 'noopener noreferrer' with target='_blank'",
+              "description": "Link rel, used with href; with target '_blank', 'noopener noreferrer' is added to whatever you set",
               "fieldName": "rel"
             },
             {
@@ -37105,6 +37385,16 @@
               },
               "description": "The native control this host speaks for.\n\nThe constraint attributes are handed to a control inside the shadow\nroot, and that control is not a member of the form around the host: the\nform sees the host, the host sees the control, and without something\njoining them a `required` field submits empty. Override when the control\nis not the first one in the shadow root, or return null for a component\nthat has no native control to speak for."
             },
+            {
+              "kind": "method",
+              "name": "validationAnchor",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Where an invalid submit points its message and puts the focus.\n\nThe native control, where the user reads and fixes it. Not when that\ncontrol is hidden, as the radio that only carries `required` is: a radio\ninside an element that is itself the radio is a control inside a control,\nand a hidden element cannot hold the message. Then it goes on this\nelement. Override where neither is what the user should land on, such as\na group that has no focus of its own."
+            },
             {
               "kind": "method",
               "name": "setCustomValidity",
@@ -37315,6 +37605,46 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utilities/link-rel.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "linkRel",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "rel",
+              "type": {
+                "text": "string | null | undefined"
+              }
+            },
+            {
+              "name": "target",
+              "type": {
+                "text": "string | null | undefined"
+              }
+            }
+          ],
+          "description": "The `rel` of a link that may open in a new tab.\n\nA link with `target=\"_blank\"` gets `noopener noreferrer`: the page it opens\ngets no handle on this one through `window.opener`, and no referrer. A `rel`\nthe consumer sets is added to, never replaced. `rel=\"external\"` on a `_blank`\nlink describes the link, and it is no reason to leave that door open.\n\nReturns an empty string when there is nothing to write, so a template can\nleave the attribute off with `|| nothing`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "linkRel",
+          "declaration": {
+            "name": "linkRel",
+            "module": "src/utilities/link-rel.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utilities/open-when-rendered.ts",