@pine-ds/core 4.7.2 → 4.9.0

package/dist/types/components/pds-radio/pds-radio.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
- * @slot image - Custom image content to display instead of the default radio input
+ * @slot image - Custom image content to display instead of the default radio input. Ignored when `variant` is `pill`.
  * @part image-container - The container for the image
  * @lightDom renders-markup
  */
@@ -32,7 +32,7 @@ export declare class PdsRadio {
      */
     helperMessage: string;
     /**
-     * Adds a border around the radio component for better visual separation.
+     * Adds a border around the radio component for better visual separation. Ignored when `variant` is `pill`.
      * @defaultValue false
      */
     hasBorder: boolean;
@@ -46,7 +46,7 @@ export declare class PdsRadio {
      */
     label: string;
     /**
-     * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers.
+     * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`.
      */
     hideLabel: boolean;
     /**
@@ -62,6 +62,11 @@ export declare class PdsRadio {
      * The value of the radio that is submitted with a form.
      */
     value: string;
+    /**
+     * Sets the style variant of the radio. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.
+     * @defaultValue default
+     */
+    variant: 'default' | 'pill';
     /**
      * Emits a boolean indicating whether the radio is currently checked or unchecked.
      */
@@ -69,6 +74,7 @@ export declare class PdsRadio {
     private handleRadioChange;
     private hasImageSlot;
     private hasImage;
+    private isPill;
     private classNames;
     componentWillLoad(): void;
     connectedCallback(): void;

package/dist/types/components/pds-select/pds-select.d.ts

@@ -7,6 +7,9 @@ export declare class PdsSelect {
     private slotContainer;
     private internals?;
     private _type;
+    private optionObserver;
+    private optionSyncFrame;
+    private hasHadOptions;
     el: HTMLPdsSelectElement;
     private hostKeeper;
     /**
@@ -97,6 +100,20 @@ export declare class PdsSelect {
     disconnectedCallback(): void;
     componentWillLoad(): void;
     componentDidLoad(): void;
+    /**
+     * Keeps the inner select in step with the slotted options. `slotchange` only fires when
+     * top-level options are added or removed, so an option's text, value or disabled state
+     * changing, or an option added inside an optgroup, would otherwise never reach the select.
+     * Changes are batched into one copy per animation frame.
+     */
+    private startOptionSync;
+    /**
+     * Whether a mutation is inside an option or optgroup. The host's own attributes and children
+     * (top-level adds and removes reach `slotchange`) and the action slot's content are not.
+     */
+    private touchesOption;
+    private scheduleOptionSync;
+    private stopOptionSync;
     /**
      * Updates the selected option in the select element based on the current value.
      *
@@ -116,12 +133,23 @@ export declare class PdsSelect {
     private onFocus;
     private onKeyDown;
     /**
-     * Handles the change event for the slot element.
-     * This method is triggered when the slot content changes.
-     * It updates the inner HTML of the select element by cloning and appending
-     * the assigned <option> elements from the slot.
+     * Copies the slotted <option> and <optgroup> elements into the inner select, then
+     * reselects the current value. Runs on `slotchange` and when a slotted option changes
+     * (see startOptionSync).
+     *
+     * Nothing happens when the copies match what the select already holds. When only text or
+     * attributes changed, the select's own options are updated in place rather than replaced,
+     * so an open picker keeps its highlight, a multiple select keeps its range anchor, and a
+     * screen reader keeps its place. Selecting programmatically fires no change event, so a
+     * copy never emits `pdsSelectChange`.
      */
     private handleSlotChange;
+    /**
+     * After a copy that changes an existing option set, a value whose option was renamed or removed
+     * has nothing to select. Like a native select, show nothing selected rather than the first
+     * option; the value itself is kept, with no change event.
+     */
+    private showNoSelectionWithoutMatch;
     private getHelperMessage;
     private getErrorMessage;
     private renderMessages;

package/dist/types/components/pds-toast/pds-toast.d.ts

@@ -38,6 +38,14 @@ export declare class PdsToast {
      * @defaultValue 'Dismiss message'
      */
     dismissLabel: string;
+    /**
+     * Accessible label announcing the toast's severity, read before the message.
+     * Pass a translated string to localize it; defaults to English (`Error`) for
+     * the `danger` type. Other types announce none unless this is set; pass an
+     * empty string to announce none.
+     * @defaultValue undefined
+     */
+    severityLabel?: string;
     /**
      * Whether the toast is currently visible.
      */
@@ -66,5 +74,6 @@ export declare class PdsToast {
     private cleanup;
     private startDismissTimer;
     private renderIcon;
+    private severityText;
     render(): any;
 }

package/dist/types/components/pds-tooltip/pds-tooltip.d.ts

@@ -15,7 +15,9 @@ export declare class PdsTooltip {
     private resolvedPlacement;
     private triggerEl;
     private contentDiv;
+    private lastCopiedHtml;
     private slotMutationObserver;
+    private contentSyncFrame;
     private currentPathname;
     private pathnameCheckInterval;
     private stopAutoUpdate;
@@ -90,6 +92,35 @@ export declare class PdsTooltip {
      */
     private repositionPortal;
     private createPortal;
+    /**
+     * The host's own content slot wrapper. Matched among direct children only, so a nested
+     * pds-tooltip inside the trigger slot isn't mistaken for this one's.
+     */
+    private get contentSlotWrapper();
+    /**
+     * Copies the slotted content (or the `content` prop's text) into a detached container. The
+     * portal holds copies so the framework that owns the slotted nodes keeps them.
+     */
+    private copySlottedContent;
+    /**
+     * While the tooltip is open, keeps the portal's copy in step with the slotted content at any
+     * depth: content that loads or re-renders after opening shows without reopening. Changes are
+     * batched to one re-copy per animation frame, and a re-copy that matches the last one shown is
+     * dropped, so screen readers aren't re-announced, iframes don't reload and the tooltip isn't
+     * repositioned for nothing. Only the hidden slot wrapper is observed, so copying into the portal
+     * can't trigger another sync.
+     */
+    private startContentSync;
+    private scheduleContentSync;
+    /**
+     * A copy's serialized HTML with Stencil's own hydration and scope classes removed from every
+     * `pds-*` descendant, so a nested component finishing hydration (or re-hydrating once reconnected
+     * inside the portal) isn't mistaken for a real content change. Without this, that class-only
+     * difference fails the equality check above and triggers a recopy that replaces still-loaded
+     * nodes — reloading any iframe or media the slotted content held.
+     */
+    private strippedHtml;
+    private stopContentSync;
     private removePortal;
     render(): any;
 }

package/dist/types/components.d.ts

@@ -8,7 +8,7 @@ import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { BoxColumnType, BoxShadowSizeType, BoxSpacingType, TextSizeType } from "./utils/types";
 import { Event } from "./stencil-public-runtime";
 import { CheckboxChangeEventDetail } from "./components/pds-checkbox/checkbox-interface";
-import { ChipSentimentType, ChipSizeType, ChipVariantType, ModalSizeType, PlacementType } from "./utils/types";
+import { ChipSentimentType, ChipSizeType, ChipVariantType, ModalSizeType, PlacementType, PopoverPaddingType } from "./utils/types";
 import { ComboboxLoadOptionsEventDetail, ComboboxOption, ComboboxSearchEventDetail } from "./components/pds-combobox/combobox-interface";
 import { DatepickerChangeEventDetail, DatepickerPreset } from "./components/pds-datepicker/datepicker-interface";
 import { PdsFilterClearEventDetail, PdsFilterCloseEventDetail, PdsFilterOpenEventDetail, PdsFilterVariant } from "./components/pds-filters/pds-filter/filter-interface";
@@ -22,7 +22,7 @@ import { TextareaChangeEventDetail, TextareaInputEventDetail } from "./component
 export { BoxColumnType, BoxShadowSizeType, BoxSpacingType, TextSizeType } from "./utils/types";
 export { Event } from "./stencil-public-runtime";
 export { CheckboxChangeEventDetail } from "./components/pds-checkbox/checkbox-interface";
-export { ChipSentimentType, ChipSizeType, ChipVariantType, ModalSizeType, PlacementType } from "./utils/types";
+export { ChipSentimentType, ChipSizeType, ChipVariantType, ModalSizeType, PlacementType, PopoverPaddingType } from "./utils/types";
 export { ComboboxLoadOptionsEventDetail, ComboboxOption, ComboboxSearchEventDetail } from "./components/pds-combobox/combobox-interface";
 export { DatepickerChangeEventDetail, DatepickerPreset } from "./components/pds-datepicker/datepicker-interface";
 export { PdsFilterClearEventDetail, PdsFilterCloseEventDetail, PdsFilterOpenEventDetail, PdsFilterVariant } from "./components/pds-filters/pds-filter/filter-interface";
@@ -108,6 +108,11 @@ export namespace Components {
           * @defaultValue false
          */
         "hideIcon": boolean;
+        /**
+          * Accessible label announcing the alert's severity, read before the heading and message. Pass a translated string to localize it; defaults to English for each variant (`Error`, `Info`, `Success`, `Warning`). The `default` variant has no severity and announces none unless this is set; pass an empty string to announce none for any variant.
+          * @defaultValue undefined
+         */
+        "severityLabel"?: string;
         /**
           * If true, the alert is displayed in a smaller size and description text is truncated. Heading is not displayed.
           * @default false
@@ -130,6 +135,11 @@ export namespace Components {
           * @defaultValue false
          */
         "badge"?: boolean;
+        /**
+          * Accessible label for the badge icon. Pass a translated string to localize it; defaults to English. Pass an empty string to make the badge decorative. Has no effect on dropdown avatars, where the trigger's `triggerLabel` owns the accessible name.
+          * @defaultValue 'Verified'
+         */
+        "badgeLabel"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
@@ -853,11 +863,11 @@ export namespace Components {
          */
         "helperMessage": string;
         /**
-          * Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`.
          */
         "hideLabel": boolean;
         /**
-          * If `true`, the checkbox will visually appear as indeterminate. Only JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes).
+          * If `true`, the checkbox will visually appear as indeterminate. Only JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes). Has no visual style when `variant` is `pill`.
          */
         "indeterminate": boolean;
         /**
@@ -880,6 +890,11 @@ export namespace Components {
           * The value of the checkbox that is submitted with a form.
          */
         "value": string;
+        /**
+          * Sets the style variant of the checkbox. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.
+          * @defaultValue default
+         */
+        "variant": 'default' | 'pill';
     }
     interface PdsChip {
         /**
@@ -1136,6 +1151,11 @@ export namespace Components {
           * @default 'fit-content'
          */
         "triggerWidth": string;
+        /**
+          * Determines whether the button trigger's label and the option labels should truncate and display with an ellipsis. When a label overflows, a `title` showing the full label will appear on hover. Chip options, custom layouts and group rows aren't affected.
+          * @defaultValue false
+         */
+        "truncate": boolean;
         /**
           * The value of the combobox input.
           * @default ''
@@ -1531,20 +1551,30 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it. It can be used without a value to download with the default filename, or with a string value to suggest a specific filename for the download. Only applies when href is set.
+          * Prompts the user to save the linked URL instead of navigating to it. It can be used without a value to download with the default filename, or with a string value to suggest a specific filename for the download. Only applies when href is set. Ignored when `informational` is set.
          */
         "download"?: string;
         /**
-          * Determines whether the link should open in a new tab and display an external icon. This is a simpler alternative to using `target="_blank"` for the common case.
+          * Determines whether the link should open in a new tab and display an external icon. This is a simpler alternative to using `target="_blank"` for the common case. Ignored when `informational` is set.
           * @defaultValue false
          */
         "external": boolean;
         /**
-          * If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button.
+          * Accessible label for the external-link icon, passed to the inner `pds-link`. Pass a translated string to localize it; defaults to English. Pass an empty string to make the icon decorative.
+          * @defaultValue '(opens in a new tab)'
+         */
+        "externalLabel"?: string;
+        /**
+          * If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button. Ignored when `informational` is set.
          */
         "href": string | undefined;
         /**
-          * Specifies where to open the linked document when href is provided. Takes precedence over the `external` prop if both are set. Only applies when href is set.
+          * It determines whether or not the dropdown-item is informational: text that the arrow keys reach but that can't be activated. Takes precedence over `href` and `destructive`. Screen readers announce it as dimmed or unavailable, the same way as a disabled item.
+          * @defaultValue false
+         */
+        "informational": boolean;
+        /**
+          * Specifies where to open the linked document when href is provided. Takes precedence over the `external` prop if both are set. Only applies when href is set. Ignored when `informational` is set.
           * @defaultValue undefined
          */
         "target"?: '_blank' | '_self' | '_parent' | '_top';
@@ -1759,6 +1789,11 @@ export namespace Components {
           * @deprecated Consider using the `target` prop for more control. This prop will be maintained for backward compatibility.
          */
         "external": boolean;
+        /**
+          * Accessible label for the icon that `external` shows, appended to the link's name. It isn't announced when `target` keeps the link in the same tab. Pass a translated string to localize it; defaults to English. Pass an empty string to make the icon decorative.
+          * @defaultValue '(opens in a new tab)'
+         */
+        "externalLabel"?: string;
         /**
           * The font size of the link's text.
           * @defaultValue lg
@@ -2156,6 +2191,16 @@ export namespace Components {
           * @defaultValue 352
          */
         "maxWidth"?: number;
+        /**
+          * Determines how the popover opens. With `hover`, it also opens when the pointer rests on the trigger and closes when the pointer leaves, until a click on the trigger keeps it open. Enter or Space on the trigger opens it either way.
+          * @defaultValue "click"
+         */
+        "openOn"?: 'click' | 'hover';
+        /**
+          * Sets the padding of the popover content
+          * @defaultValue "md"
+         */
+        "padding"?: PopoverPaddingType;
         /**
           * Determines the preferred position of the popover
           * @defaultValue "right"
@@ -2244,7 +2289,7 @@ export namespace Components {
          */
         "errorMessage": string;
         /**
-          * Adds a border around the radio component for better visual separation.
+          * Adds a border around the radio component for better visual separation. Ignored when `variant` is `pill`.
           * @defaultValue false
          */
         "hasBorder": boolean;
@@ -2253,7 +2298,7 @@ export namespace Components {
          */
         "helperMessage": string;
         /**
-          * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`.
          */
         "hideLabel": boolean;
         /**
@@ -2278,6 +2323,11 @@ export namespace Components {
           * The value of the radio that is submitted with a form.
          */
         "value": string;
+        /**
+          * Sets the style variant of the radio. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.
+          * @defaultValue default
+         */
+        "variant": 'default' | 'pill';
     }
     /**
      * @lightDom renders-markup
@@ -2893,6 +2943,11 @@ export namespace Components {
           * The name of the icon to display in the toast.
          */
         "icon"?: string;
+        /**
+          * Accessible label announcing the toast's severity, read before the message. Pass a translated string to localize it; defaults to English (`Error`) for the `danger` type. Other types announce none unless this is set; pass an empty string to announce none.
+          * @defaultValue undefined
+         */
+        "severityLabel"?: string;
         /**
           * The type of toast to display. - default: Grey background (default) - danger: Red background - loading: With spinner animation
           * @default 'default'
@@ -3943,6 +3998,11 @@ declare namespace LocalJSX {
           * Event emitted when the dismiss button is clicked.
          */
         "onPdsAlertDismissClick"?: (event: PdsAlertCustomEvent<void>) => void;
+        /**
+          * Accessible label announcing the alert's severity, read before the heading and message. Pass a translated string to localize it; defaults to English for each variant (`Error`, `Info`, `Success`, `Warning`). The `default` variant has no severity and announces none unless this is set; pass an empty string to announce none for any variant.
+          * @defaultValue undefined
+         */
+        "severityLabel"?: string;
         /**
           * If true, the alert is displayed in a smaller size and description text is truncated. Heading is not displayed.
           * @default false
@@ -3965,6 +4025,11 @@ declare namespace LocalJSX {
           * @defaultValue false
          */
         "badge"?: boolean;
+        /**
+          * Accessible label for the badge icon. Pass a translated string to localize it; defaults to English. Pass an empty string to make the badge decorative. Has no effect on dropdown avatars, where the trigger's `triggerLabel` owns the accessible name.
+          * @defaultValue 'Verified'
+         */
+        "badgeLabel"?: string;
         /**
           * A unique identifier used for the underlying component `id` attribute.
          */
@@ -4693,11 +4758,11 @@ declare namespace LocalJSX {
          */
         "helperMessage"?: string;
         /**
-          * Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * Visually hides the label text for instances where only the checkbox should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`.
          */
         "hideLabel"?: boolean;
         /**
-          * If `true`, the checkbox will visually appear as indeterminate. Only JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes).
+          * If `true`, the checkbox will visually appear as indeterminate. Only JavaScript can set the objects `indeterminate` property. See [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes). Has no visual style when `variant` is `pill`.
          */
         "indeterminate"?: boolean;
         /**
@@ -4725,6 +4790,11 @@ declare namespace LocalJSX {
           * The value of the checkbox that is submitted with a form.
          */
         "value"?: string;
+        /**
+          * Sets the style variant of the checkbox. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.
+          * @defaultValue default
+         */
+        "variant"?: 'default' | 'pill';
     }
     interface PdsChip {
         /**
@@ -4989,6 +5059,11 @@ declare namespace LocalJSX {
           * @default 'fit-content'
          */
         "triggerWidth"?: string;
+        /**
+          * Determines whether the button trigger's label and the option labels should truncate and display with an ellipsis. When a label overflows, a `title` showing the full label will appear on hover. Chip options, custom layouts and group rows aren't affected.
+          * @defaultValue false
+         */
+        "truncate"?: boolean;
         /**
           * The value of the combobox input.
           * @default ''
@@ -5396,24 +5471,34 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it. It can be used without a value to download with the default filename, or with a string value to suggest a specific filename for the download. Only applies when href is set.
+          * Prompts the user to save the linked URL instead of navigating to it. It can be used without a value to download with the default filename, or with a string value to suggest a specific filename for the download. Only applies when href is set. Ignored when `informational` is set.
          */
         "download"?: string;
         /**
-          * Determines whether the link should open in a new tab and display an external icon. This is a simpler alternative to using `target="_blank"` for the common case.
+          * Determines whether the link should open in a new tab and display an external icon. This is a simpler alternative to using `target="_blank"` for the common case. Ignored when `informational` is set.
           * @defaultValue false
          */
         "external"?: boolean;
         /**
-          * If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button.
+          * Accessible label for the external-link icon, passed to the inner `pds-link`. Pass a translated string to localize it; defaults to English. Pass an empty string to make the icon decorative.
+          * @defaultValue '(opens in a new tab)'
+         */
+        "externalLabel"?: string;
+        /**
+          * If provided, renders the dropdown-item as an anchor (`<a>`) element instead of a button. Ignored when `informational` is set.
          */
         "href"?: string | undefined;
+        /**
+          * It determines whether or not the dropdown-item is informational: text that the arrow keys reach but that can't be activated. Takes precedence over `href` and `destructive`. Screen readers announce it as dimmed or unavailable, the same way as a disabled item.
+          * @defaultValue false
+         */
+        "informational"?: boolean;
         /**
           * Emitted when the dropdown-item is clicked.
          */
         "onPdsClick"?: (event: PdsDropdownMenuItemCustomEvent<{itemIndex: number, item: HTMLPdsDropdownMenuItemElement, content: string}>) => void;
         /**
-          * Specifies where to open the linked document when href is provided. Takes precedence over the `external` prop if both are set. Only applies when href is set.
+          * Specifies where to open the linked document when href is provided. Takes precedence over the `external` prop if both are set. Only applies when href is set. Ignored when `informational` is set.
           * @defaultValue undefined
          */
         "target"?: '_blank' | '_self' | '_parent' | '_top';
@@ -5652,6 +5737,11 @@ declare namespace LocalJSX {
           * @deprecated Consider using the `target` prop for more control. This prop will be maintained for backward compatibility.
          */
         "external"?: boolean;
+        /**
+          * Accessible label for the icon that `external` shows, appended to the link's name. It isn't announced when `target` keeps the link in the same tab. Pass a translated string to localize it; defaults to English. Pass an empty string to make the icon decorative.
+          * @defaultValue '(opens in a new tab)'
+         */
+        "externalLabel"?: string;
         /**
           * The font size of the link's text.
           * @defaultValue lg
@@ -6069,6 +6159,16 @@ declare namespace LocalJSX {
           * Emitted when the popover is opened
          */
         "onPdsPopoverOpen"?: (event: PdsPopoverCustomEvent<PdsPopoverEventDetail>) => void;
+        /**
+          * Determines how the popover opens. With `hover`, it also opens when the pointer rests on the trigger and closes when the pointer leaves, until a click on the trigger keeps it open. Enter or Space on the trigger opens it either way.
+          * @defaultValue "click"
+         */
+        "openOn"?: 'click' | 'hover';
+        /**
+          * Sets the padding of the popover content
+          * @defaultValue "md"
+         */
+        "padding"?: PopoverPaddingType;
         /**
           * Determines the preferred position of the popover
           * @defaultValue "right"
@@ -6149,7 +6249,7 @@ declare namespace LocalJSX {
          */
         "errorMessage"?: string;
         /**
-          * Adds a border around the radio component for better visual separation.
+          * Adds a border around the radio component for better visual separation. Ignored when `variant` is `pill`.
           * @defaultValue false
          */
         "hasBorder"?: boolean;
@@ -6158,7 +6258,7 @@ declare namespace LocalJSX {
          */
         "helperMessage"?: string;
         /**
-          * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers.
+          * Visually hides the label text for instances where only the radio should be displayed. Label remains accessible to assistive technology such as screen readers. Ignored when `variant` is `pill`.
          */
         "hideLabel"?: boolean;
         /**
@@ -6187,6 +6287,11 @@ declare namespace LocalJSX {
           * The value of the radio that is submitted with a form.
          */
         "value"?: string;
+        /**
+          * Sets the style variant of the radio. `pill` renders the label as a pill-shaped choice; the native input still handles keyboard, form, and screen reader behavior.
+          * @defaultValue default
+         */
+        "variant"?: 'default' | 'pill';
     }
     /**
      * @lightDom renders-markup
@@ -6849,6 +6954,11 @@ declare namespace LocalJSX {
           * Event emitted when the toast is dismissed, either manually or automatically.
          */
         "onPdsToastDismissed"?: (event: PdsToastCustomEvent<{ componentId?: string }>) => void;
+        /**
+          * Accessible label announcing the toast's severity, read before the message. Pass a translated string to localize it; defaults to English (`Error`) for the `danger` type. Other types announce none unless this is set; pass an empty string to announce none.
+          * @defaultValue undefined
+         */
+        "severityLabel"?: string;
         /**
           * The type of toast to display. - default: Grey background (default) - danger: Red background - loading: With spinner animation
           * @default 'default'
@@ -6913,10 +7023,12 @@ declare namespace LocalJSX {
         "hideIcon": boolean;
         "variant": 'default' | 'danger' | 'info' | 'success' | 'warning';
         "dismissLabel": string;
+        "severityLabel": string;
     }
     interface PdsAvatarAttributes {
         "alt": string | null;
         "badge": boolean;
+        "badgeLabel": string;
         "componentId": string;
         "dropdown": boolean;
         "image": string | null;
@@ -7086,6 +7198,7 @@ declare namespace LocalJSX {
         "name": string;
         "required": boolean;
         "value": string;
+        "variant": 'default' | 'pill';
     }
     interface PdsChipAttributes {
         "componentId": string;
@@ -7131,6 +7244,7 @@ declare namespace LocalJSX {
         "triggerWidth": string;
         "triggerVariant": 'secondary' | 'primary' | 'accent' | 'destructive';
         "triggerShape": 'pill' | 'input';
+        "truncate": boolean;
         "chipSentiment": ChipSentimentType;
         "chipLarge": boolean;
         "chipIcon": string;
@@ -7227,7 +7341,9 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "download": string;
         "href": string | undefined;
+        "informational": boolean;
         "external": boolean;
+        "externalLabel": string;
         "target": '_blank' | '_self' | '_parent' | '_top';
     }
     interface PdsDropdownMenuSeparatorAttributes {
@@ -7284,6 +7400,7 @@ declare namespace LocalJSX {
         "download": string;
         "componentId": string;
         "external": boolean;
+        "externalLabel": string;
         "target": '_blank' | '_self' | '_parent' | '_top';
         "variant": 'inline' | 'plain';
         "fontSize": 'sm' | 'md' | 'lg';
@@ -7368,9 +7485,11 @@ declare namespace LocalJSX {
     }
     interface PdsPopoverAttributes {
         "popoverTargetAction": 'show' | 'toggle' | 'hide';
+        "openOn": 'click' | 'hover';
         "popoverType": 'auto' | 'manual';
         "componentId": string;
         "maxWidth": number;
+        "padding": PopoverPaddingType;
         "placement": PlacementType;
     }
     interface PdsProgressAttributes {
@@ -7398,6 +7517,7 @@ declare namespace LocalJSX {
         "name": string;
         "required": boolean;
         "value": string;
+        "variant": 'default' | 'pill';
     }
     interface PdsRadioGroupAttributes {
         "componentId": string;
@@ -7566,6 +7686,7 @@ declare namespace LocalJSX {
         "icon": string;
         "type": 'default' | 'danger' | 'loading';
         "dismissLabel": string;
+        "severityLabel": string;
     }
     interface PdsTooltipAttributes {
         "content": string;

package/dist/types/utils/aria-references.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The ARIA attributes that take ID references, and the element-reflection property each is forwarded
+ * through. An ID on a host can't reach an element inside its shadow root, so a component that
+ * delegates focus forwards the elements the IDs point at instead. A browser without ARIA element
+ * reflection gets none of them.
+ */
+export declare const ARIA_REFERENCE_PROPERTIES: {
+    readonly 'aria-controls': "ariaControlsElements";
+    readonly 'aria-describedby': "ariaDescribedByElements";
+    readonly 'aria-labelledby': "ariaLabelledByElements";
+};
+export declare const ARIA_REFERENCE_ATTRIBUTES: string[];
+/**
+ * Finds an element by ID in the host's tree, then in each shadow root that contains it, so a host
+ * inside another component's shadow root still reaches, say, a popover portal on document.body.
+ * The closest root wins when an ID repeats.
+ */
+export declare const findInAncestorRoots: (host: Element, id: string) => HTMLElement | null;
+/**
+ * Points the target's reflected ARIA properties at the elements the host's ID-reference attributes
+ * name, or clears them. Run it again whenever the attributes or the referenced elements may have
+ * changed: element references don't follow an ID to a node added or replaced later.
+ */
+export declare const forwardAriaReferences: (host: Element, target: Element) => void;

package/dist/types/utils/tabbable.d.ts

@@ -0,0 +1,2 @@
+/** The controls Tab reaches in `root`, in order: visible ones, and one radio per group. */
+export declare function tabbableIn(root: Element): HTMLElement[];

package/dist/types/utils/truncation-tooltip.d.ts

@@ -25,7 +25,7 @@ export interface TruncationTooltipOptions {
      */
     manageTabIndex?: boolean;
     /**
-     * The element whose focus shows the tooltip (default: `hostEl`).
+     * The element whose keyboard focus shows the tooltip (default: `hostEl`).
      *
      * Pass the wrapping control when it sits outside `hostEl`, so focusing it
      * still reveals the text once `manageTabIndex` is `false`.
@@ -35,9 +35,9 @@ export interface TruncationTooltipOptions {
 /**
  * Sets up automatic tooltip behavior for a truncated element.
  *
- * When the element's text overflows, hovering or focusing the host element
- * will display a tooltip showing the full text content. The tooltip is
- * rendered as a portal on document.body and positioned with Floating UI.
+ * When the element's text overflows, hovering the host element or giving it
+ * keyboard focus will display a tooltip showing the full text content. The
+ * tooltip is rendered as a portal on document.body and positioned with Floating UI.
  *
  * Also owns the element's `tabindex` while it is clipped — see syncTabIndex.
  *

package/dist/types/utils/types.d.ts

@@ -6,5 +6,6 @@ export type ChipSentimentType = 'accent' | 'brand' | 'danger' | 'info' | 'neutra
 export type ModalSizeType = 'sm' | 'md' | 'lg' | 'fullscreen';
 export type ChipSizeType = 'sm' | 'md' | 'lg';
 export type ChipVariantType = 'text' | 'tag' | 'dropdown';
+export type PopoverPaddingType = Extract<BoxSpacingType, 'none' | 'xs' | 'sm' | 'md'>;
 export declare const TEXT_SIZES: readonly ["2xl", "xl", "lg", "md", "sm", "xs", "2xs", "h1", "h2", "h3", "h4", "h5", "h6"];
 export type TextSizeType = (typeof TEXT_SIZES)[number];