@pine-ds/core 4.7.0 → 4.7.2

package/dist/collection/components/pds-modal/pds-modal.js

@@ -72,6 +72,20 @@ function oneRadioPerGroup(elements) {
     const stops = new Set(groups.map((radios) => { var _a; return (_a = radios.find((radio) => radio.checked)) !== null && _a !== void 0 ? _a : radios[0]; }));
     return elements.filter((el) => groupedRadio(el) === null || stops.has(el));
 }
+/** The controls Tab reaches in `root`, in order: visible ones, and one radio per group. */
+function tabbableIn(root) {
+    const found = [];
+    collectTabbable(root, found);
+    // checkVisibility() also drops an element inside a hidden ancestor, whose own computed
+    // display isn't none; such an element can't take focus.
+    const visible = found.filter(el => {
+        if (typeof el.checkVisibility === 'function')
+            return el.checkVisibility({ checkVisibilityCSS: true });
+        const style = window.getComputedStyle(el);
+        return style.display !== 'none' && style.visibility !== 'hidden';
+    });
+    return oneRadioPerGroup(visible);
+}
 /** Whether `node` is `ancestor` or inside it, crossing shadow roots, which `Node.contains` doesn't. */
 function containsComposed(ancestor, node) {
     for (let current = node; current; current = current instanceof ShadowRoot ? current.host : current.parentNode) {
@@ -355,17 +369,7 @@ export class PdsModal {
     updateFocusableElements() {
         if (!this.modalRef)
             return;
-        this.focusableElements = [];
-        collectTabbable(this.modalRef, this.focusableElements);
-        // checkVisibility() also drops an element inside a hidden ancestor, whose own computed
-        // display isn't none; such an element can't take focus, so it can't anchor the trap.
-        this.focusableElements = this.focusableElements.filter(el => {
-            if (typeof el.checkVisibility === 'function')
-                return el.checkVisibility({ checkVisibilityCSS: true });
-            const style = window.getComputedStyle(el);
-            return style.display !== 'none' && style.visibility !== 'hidden';
-        });
-        this.focusableElements = oneRadioPerGroup(this.focusableElements);
+        this.focusableElements = tabbableIn(this.modalRef);
     }
     /**
      * Sets focus to the first focusable element in the modal
@@ -389,10 +393,13 @@ export class PdsModal {
      * Opens the modal
      */
     async showModal() {
+        var _a;
         if (this.modalRef) {
             try {
-                // Store the currently focused element to restore focus when modal closes
-                this.previousActiveElement = document.activeElement;
+                // Store the currently focused element to restore focus when modal closes. Showing an open
+                // modal again (the open watcher does) would record a control inside it instead.
+                if (!this.modalRef.open)
+                    this.previousActiveElement = document.activeElement;
                 // showModal() promotes the dialog to the browser top layer (and makes the
                 // rest of the page inert), which prevents any overlay outside the dialog
                 // from ever painting above it. show() opens a non-modal dialog that stays
@@ -409,9 +416,20 @@ export class PdsModal {
                     openModals.set(this.el, ++openSequence);
                 // Update focusable elements and set initial focus
                 // Using a longer timeout to ensure all components are fully rendered
+                const openedAs = (_a = openModals.get(this.el)) !== null && _a !== void 0 ? _a : 0;
                 setTimeout(() => {
                     var _a, _b;
                     this.updateFocusableElements();
+                    // A modal opened above this one in the meantime has focus; don't take it back. Not this
+                    // modal itself (moving it gives it a new place), and not a disableTopLayer modal outside
+                    // it while this one is in the top layer, which sits below it.
+                    const openedAbove = Array.from(openModals).some(([modal, sequence]) => sequence > openedAs &&
+                        modal !== this.el &&
+                        (containsComposed(this.el, modal) || !modal.disableTopLayer || this.disableTopLayer));
+                    if (openedAbove) {
+                        this.pdsModalOpen.emit();
+                        return;
+                    }
                     if (this.disableInitialFocus) {
                         // show()/showModal() also move focus into the dialog natively (the
                         // HTML spec's "dialog focusing steps") — that native step isn't
@@ -455,6 +473,7 @@ export class PdsModal {
      * Closes the modal
      */
     async hideModal() {
+        var _a;
         if (this.modalRef) {
             try {
                 // Capture before close(): with the async task queue, a prop change
@@ -470,11 +489,18 @@ export class PdsModal {
                 this.modalRef.close();
                 this.open = false;
                 openModals.delete(this.el);
-                // Restore focus to the element that was focused before the modal was opened
-                if (!focusAlreadyMovedElsewhere &&
-                    this.previousActiveElement &&
-                    typeof this.previousActiveElement.focus === 'function') {
-                    this.previousActiveElement.focus();
+                // Restore focus to the element that was focused before the modal was opened. If that's
+                // gone or can't take focus (disabled, hidden, or nothing), fall back to the open modal now
+                // on top, so focus doesn't land on an inert page behind it.
+                if (!focusAlreadyMovedElsewhere) {
+                    const previous = this.previousActiveElement;
+                    if (previous && previous !== document.body && previous.isConnected)
+                        (_a = previous.focus) === null || _a === void 0 ? void 0 : _a.call(previous);
+                    const active = deepActiveElement();
+                    // document.body isn't a real restore target — it's just where focus lands when nothing
+                    // was focused before opening, so landing back there never counts as a successful restore.
+                    if (!previous || previous === document.body || !containsComposed(previous, active) || containsComposed(this.el, active))
+                        this.focusTopModal();
                 }
                 this.pdsModalClose.emit();
             }
@@ -483,6 +509,21 @@ export class PdsModal {
             }
         }
     }
+    /**
+     * Focuses the first control of the open modal now on top, when the page behind it is inert: that
+     * modal is in the top layer (or paints there inside a top-layer one), or it wraps this one. A
+     * non-modal one over an interactive page, like a drawer, is left alone.
+     */
+    focusTopModal() {
+        var _a;
+        const top = this.innermostOpenModal();
+        const dialog = top === null || top === void 0 ? void 0 : top.querySelector('.pds-modal__backdrop');
+        if (!dialog)
+            return;
+        if (!closest('dialog:modal', dialog) && !containsComposed(top, this.el))
+            return;
+        (_a = tabbableIn(dialog).find(el => !containsComposed(this.el, el))) === null || _a === void 0 ? void 0 : _a.focus();
+    }
     /**
      * Gets the z-index of a modal's backdrop element
      */
@@ -604,14 +645,14 @@ export class PdsModal {
     }
     render() {
         const [sizeClass = 'md', customSize] = this.resolveSize();
-        return (h("dialog", { key: '0633d4e8a7cb81f2f9280e754564960a00a4d60b', class: {
+        return (h("dialog", { key: '0b187f36910a859afe57b891f1ebffd1d2d49ab7', class: {
                 'pds-modal__backdrop': true,
                 'open': this.open
-            }, "aria-modal": this.disableTopLayer ? 'false' : 'true', "aria-labelledby": `${this.componentId}-heading`, onClick: this.handleBackdropClick, onCancel: this.handleCancel }, h("div", { key: '466f8a3476cf066817554f47ec7d3a0e3ab10b89', class: {
+            }, "aria-modal": this.disableTopLayer ? 'false' : 'true', "aria-labelledby": `${this.componentId}-heading`, onClick: this.handleBackdropClick, onCancel: this.handleCancel }, h("div", { key: 'f5e652d4dae0e7c272b37b63eb9c65f04c69536a', class: {
                 'pds-modal': true,
                 [`pds-modal--${sizeClass}`]: true,
                 'pds-modal--scrollable': this.scrollable
-            }, style: customSize !== undefined ? { '--pds-modal-max-width': customSize } : undefined, part: "modal" }, h("slot", { key: '01ca45c96540416216a1082bad52b137720f0f4d' }))));
+            }, style: customSize !== undefined ? { '--pds-modal-max-width': customSize } : undefined, part: "modal" }, h("slot", { key: 'a954e1694741f78230599c476b270079797a263e' }))));
     }
     static get is() { return "pds-modal"; }
     static get originalStyleUrls() {
@@ -848,6 +889,10 @@ export class PdsModal {
                         "HTMLElement": {
                             "location": "global",
                             "id": "global::HTMLElement"
+                        },
+                        "HTMLPdsModalElement": {
+                            "location": "global",
+                            "id": "global::HTMLPdsModalElement"
                         }
                     },
                     "return": "Promise<void>"

package/dist/collection/components/pds-multiselect/pds-multiselect.css

@@ -249,9 +249,13 @@
   transition: background 0.15s;
 }
 .pds-multiselect__option pds-checkbox {
+  min-width: var(--pine-dimension-none);
   pointer-events: none;
   width: 100%;
 }
+.pds-multiselect__option pds-chip {
+  pointer-events: auto;
+}
 .pds-multiselect__option:hover:not(.pds-multiselect__option--disabled), .pds-multiselect__option.pds-multiselect__option--highlighted:not(.pds-multiselect__option--disabled) {
   background: var(--pine-color-background-muted);
 }

package/dist/collection/components/pds-multiselect/pds-multiselect.js

@@ -345,6 +345,11 @@ export class PdsMultiselect {
             e.preventDefault(); // Prevent focus change
             this.toggleOption(option);
         };
+        // mousedown already toggled the option. Without this, a click on the chip reaches the
+        // checkbox through its label and toggles it a second time.
+        this.handleOptionClick = (e) => {
+            e.preventDefault();
+        };
         this.handleOptionMouseEnter = (index, option) => () => {
             if (option.disabled)
                 return;
@@ -403,6 +408,18 @@ export class PdsMultiselect {
             this.internals = this.el.attachInternals();
         }
     }
+    /**
+     * Form Associated Custom Elements API: Called when the form is disabled
+     */
+    formDisabledCallback(disabled) {
+        // Also fires when this element's own `disabled` attribute is merely present, even as the
+        // literal string "false" (a consumer's or React's attribute serialization can write that) —
+        // the platform treats any value as disabled, independent of fieldset state. A real disabled
+        // fieldset ancestor confirms this is genuinely that, not this element's own attribute.
+        if (disabled && !this.el.closest('fieldset[disabled]'))
+            return;
+        this.disabled = disabled;
+    }
     componentWillLoad() {
         this.originalSearchEmitter = this.pdsMultiselectSearch;
         this.syncSelectedItems();
@@ -501,8 +518,20 @@ export class PdsMultiselect {
         var _a;
         (_a = this.slottedTriggerEl) === null || _a === void 0 ? void 0 : _a.setAttribute('aria-expanded', String(this.isOpen));
     }
-    disabledChanged() {
+    disabledChanged(disabled) {
+        var _a, _b;
         this.syncSlottedTrigger();
+        // A disabled control can't stay open, or its options could still be toggled.
+        if (!disabled || !this.isOpen)
+            return;
+        const activeElement = document.activeElement;
+        const focusInside = !!(((_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.contains(activeElement)) || this.el.contains(activeElement));
+        this.closeDropdown();
+        // A disabled built-in trigger can't take focus back (falls to <body>, as natively); a slotted
+        // trigger without its own disabled property only gets aria-disabled and stays focusable, so
+        // focus would otherwise stay stranded on the closed panel's former content.
+        if (focusInside)
+            (_b = this.activeTriggerEl) === null || _b === void 0 ? void 0 : _b.focus();
     }
     /**
      * Sets focus on the trigger button.
@@ -512,7 +541,8 @@ export class PdsMultiselect {
         (_a = this.activeTriggerEl) === null || _a === void 0 ? void 0 : _a.focus();
     }
     /**
-     * Clears all selected values and resets the component.
+     * Clears all selected values and resets the component. Works while disabled too, as setting a
+     * native control's value from script does.
      */
     async clear() {
         const hadValues = this.value.length > 0 || this.searchQuery !== '';
@@ -1148,7 +1178,7 @@ export class PdsMultiselect {
                 'pds-multiselect__option--selected': isSelected,
                 'pds-multiselect__option--create': isCreateOption,
                 'pds-multiselect__option--disabled': isDisabled || isCreateDisabled,
-            }, role: "option", "aria-selected": isSelected ? 'true' : 'false', "aria-disabled": isDisabled || isCreateDisabled ? 'true' : undefined, "aria-label": isCreateOption ? formatMessage(this.createOptionAriaLabel, { text: option.text }) : undefined, "aria-describedby": hasAction ? `${optionId}-action-description` : undefined, "data-index": index, onMouseDown: this.handleOptionMouseDown(option), onMouseEnter: this.handleOptionMouseEnter(index, option) }, isCreateOption ? (h("pds-box", { class: "pds-multiselect__create-option", "align-items": "center", gap: "xs" }, h("pds-icon", { name: "add", size: "small" }), h("pds-text", null, formatMessage(this.createOptionLabel, { text: option.text })))) : (h("pds-checkbox", { componentId: `${this.componentId}-checkbox-${index}`, checked: isSelected, label: option.text, disabled: isDisabled, style: { pointerEvents: 'none' } }, this.optionDisplay === 'chip' && (h("pds-chip", { slot: "label", sentiment: "subtle", dot: !!option.dotColor, "dot-color": option.dotColor }, option.text)))), hasAction && this.renderOptionAction(option, optionId, isHighlighted)));
+            }, role: "option", "aria-selected": isSelected ? 'true' : 'false', "aria-disabled": isDisabled || isCreateDisabled ? 'true' : undefined, "aria-label": isCreateOption ? formatMessage(this.createOptionAriaLabel, { text: option.text }) : undefined, "aria-describedby": hasAction ? `${optionId}-action-description` : undefined, "data-index": index, onMouseDown: this.handleOptionMouseDown(option), onClick: this.handleOptionClick, onMouseEnter: this.handleOptionMouseEnter(index, option) }, isCreateOption ? (h("pds-box", { class: "pds-multiselect__create-option", "align-items": "center", gap: "xs" }, h("pds-icon", { name: "add", size: "small" }), h("pds-text", null, formatMessage(this.createOptionLabel, { text: option.text })))) : (h("pds-checkbox", { componentId: `${this.componentId}-checkbox-${index}`, checked: isSelected, label: option.text, disabled: isDisabled, style: { pointerEvents: 'none' } }, this.optionDisplay === 'chip' && (h("pds-chip", { slot: "label", sentiment: "subtle", dot: !!option.dotColor, "dot-color": option.dotColor, "max-width": "100%" }, option.text)))), hasAction && this.renderOptionAction(option, optionId, isHighlighted)));
     }
     renderOptionAction(option, optionId, isHighlighted) {
         var _a;
@@ -1230,10 +1260,10 @@ export class PdsMultiselect {
     }
     render() {
         const hasSelections = this.selectedItems.length > 0;
-        return (h(Host, { key: 'fcc35a82c16d5cf35a49ce997f19618104f9cc45', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '72d1fdf759d9173f54bac80ec50aff651fd2b357', class: "pds-multiselect", onFocusout: this.handleContainerFocusOut }, this.label && (h("label", { key: 'e28f02c2beb23dc2c0deefadbd0645b20d938d91', id: `${this.componentId}-label`, htmlFor: this.componentId, class: {
+        return (h(Host, { key: 'a7806379c53598d41af91be63ee5bd300cc87755', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '0213d40953f1735b84c038e0e0afd1bc289d45ad', class: "pds-multiselect", onFocusout: this.handleContainerFocusOut }, this.label && (h("label", { key: 'fa91c2337cdc9f5dea62173aeaa6b56e118a1316', id: `${this.componentId}-label`, htmlFor: this.componentId, class: {
                 'pds-multiselect__label': true,
                 'visually-hidden': this.hideLabel,
-            } }, this.label)), h("div", { key: '06539bf2c4b8da2889505a9f042d5cd6721b1853', class: "pds-multiselect__wrapper", ref: el => (this.containerEl = el), style: { width: this.triggerWidth } }, this.slottedTriggerEl ? (h("slot", { name: "trigger" })) : this.selectedDisplay === 'pill' && this.pillPosition === 'inline' ? (h("div", { ref: el => (this.pillInlineTriggerEl = el || undefined), part: "trigger", class: {
+            } }, this.label)), h("div", { key: '54209b3edfb3583ab1bcecd2b1df973955abfcc3', class: "pds-multiselect__wrapper", ref: el => (this.containerEl = el), style: { width: this.triggerWidth } }, this.slottedTriggerEl ? (h("slot", { name: "trigger" })) : this.selectedDisplay === 'pill' && this.pillPosition === 'inline' ? (h("div", { ref: el => (this.pillInlineTriggerEl = el || undefined), part: "trigger", class: {
                 'pds-multiselect__trigger': true,
                 'pds-multiselect__trigger--open': this.isOpen,
                 'pds-multiselect__trigger--disabled': this.disabled,
@@ -1249,7 +1279,7 @@ export class PdsMultiselect {
             }, id: this.componentId, disabled: this.disabled, "aria-required": this.required ? 'true' : undefined, "aria-expanded": this.isOpen ? 'true' : 'false', "aria-haspopup": "listbox", "aria-describedby": assignDescription(this.componentId, this.invalid || !!this.errorMessage, this.helperMessage, this.errorMessage), "aria-invalid": this.invalid || !!this.errorMessage ? 'true' : undefined, onClick: this.handleTriggerClick, onKeyDown: this.handleTriggerKeyDown }, h("span", { class: {
                 'pds-multiselect__trigger-text': true,
                 'pds-multiselect__trigger-text--placeholder': !hasSelections || (this.selectedDisplay === 'pill' && this.pillPosition === 'below'),
-            } }, this.getTriggerText()), h("pds-icon", { "aria-hidden": "true", class: "pds-multiselect__icon", icon: enlarge }))), this.renderDropdown()), this.selectedDisplay === 'pill' && this.pillPosition === 'below' && this.renderBelowPills(), h("span", { key: '3364fc00bc744fcd599436a9cb6dc563564d89d9', class: "visually-hidden", "aria-live": "polite", "aria-atomic": "true" }, this.removalAnnouncement), this.helperMessage && !(this.errorMessage && this.errorMessage.length > 0) && (h("p", { key: 'bf712c65b9acb66e2998a43686fed408fc1ff48a', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: 'b485db6c2c3ae312cce2b90db60e850ad6dfdcf5', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: '20daf861cf9584f33f5a9574e9581acc487e7dfe', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '018d333254771695a8c191f1cea40af6e78427a2', style: { display: 'none' } }, h("slot", { key: '2ef4a01fbe5d294a9ead5cc1183c28341834539b' })))));
+            } }, this.getTriggerText()), h("pds-icon", { "aria-hidden": "true", class: "pds-multiselect__icon", icon: enlarge }))), this.renderDropdown()), this.selectedDisplay === 'pill' && this.pillPosition === 'below' && this.renderBelowPills(), h("span", { key: 'e3c1bb5c484d851b332e994cd2a528ae95cbfc4d', class: "visually-hidden", "aria-live": "polite", "aria-atomic": "true" }, this.removalAnnouncement), this.helperMessage && !(this.errorMessage && this.errorMessage.length > 0) && (h("p", { key: '2009f6487118252ef1ec14170ddd0c6853ad279f', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: 'c740f4845ff0c1ccff4633810c1d9d92fb2e8a78', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: 'b2406ab3b0957a440593b4b986c98476258349be', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '6d2db6563864c71ab92ed9a8d4133efca23b1c55', style: { display: 'none' } }, h("slot", { key: '2af0e0a7e2410b9850fd15ef524fb388c32dc320' })))));
     }
     static get is() { return "pds-multiselect"; }
     static get encapsulation() { return "shadow"; }
@@ -2440,7 +2470,7 @@ export class PdsMultiselect {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Clears all selected values and resets the component.",
+                    "text": "Clears all selected values and resets the component. Works while disabled too, as setting a\nnative control's value from script does.",
                     "tags": []
                 }
             },

package/dist/collection/components/pds-radio/pds-radio.css

@@ -181,6 +181,7 @@ label:has(input:disabled) {
   column-gap: var(--pine-dimension-xs);
   display: flex;
   flex: 1;
+  flex-direction: row;
   padding: var(--pine-dimension-md);
 }
 @media (max-width: 767px) {
@@ -235,6 +236,11 @@ label:has(input:disabled) {
   object-fit: cover;
   width: 100%;
 }
+:host(.has-image) .pds-radio__content-wrapper {
+  flex: 1;
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
 :host(.has-image) .pds-radio__message {
   grid-area: message;
   margin-block-start: 0;

package/dist/collection/components/pds-row/pds-row.js

@@ -51,23 +51,23 @@ export class PdsRow {
     }
     render() {
         const rowClasses = `
-    ${this.alignItems !== undefined && this.alignItems.trim() !== '' ? `pds-align-items-${this.alignItems}` : ''}
+    ${this.alignItems != null && this.alignItems.trim() !== '' ? `pds-align-items-${this.alignItems}` : ''}
     ${this.border ? 'pds-row--border' : ''}
-    ${this.justifyContent !== undefined && this.justifyContent.trim() !== '' ? `pds-justify-content-${this.justifyContent}` : ''}
+    ${this.justifyContent != null && this.justifyContent.trim() !== '' ? `pds-justify-content-${this.justifyContent}` : ''}
     ${this.noWrap ? 'pds-row--no-wrap' : ''}
   `;
         const rowInlineStyles = Object.assign(Object.assign(Object.assign(Object.assign({}, (this.colGap && {
-            '--row-gap-x': this.colGap !== undefined && this.colGap.trim() !== '' ? this.colGapMap[this.colGap] : '',
-            '--row-gap-y': this.colGap !== undefined && this.colGap.trim() !== '' ? this.colGapMap[this.colGap] : '',
+            '--row-gap-x': this.colGap != null && this.colGap.trim() !== '' ? this.colGapMap[this.colGap] : '',
+            '--row-gap-y': this.colGap != null && this.colGap.trim() !== '' ? this.colGapMap[this.colGap] : '',
         })), (this.colGapBlock && {
-            '--row-gap-y': this.colGapBlock !== undefined && this.colGapBlock.trim() !== '' ? this.colGapMap[this.colGapBlock] : '',
+            '--row-gap-y': this.colGapBlock != null && this.colGapBlock.trim() !== '' ? this.colGapMap[this.colGapBlock] : '',
         })), (this.colGapInline && {
-            '--row-gap-x': this.colGapInline !== undefined && this.colGapInline.trim() !== '' ? this.colGapMap[this.colGapInline] : '',
+            '--row-gap-x': this.colGapInline != null && this.colGapInline.trim() !== '' ? this.colGapMap[this.colGapInline] : '',
         })), (this.minHeight && {
             'min-height': this.minHeight,
         }));
         this.hostKeeper.record(`pds-row ${rowClasses}`, rowInlineStyles);
-        return h(Host, { key: '78a505fef7132f9545916155d2485a6d2df8f4a5', class: `pds-row ${rowClasses}`, style: rowInlineStyles });
+        return h(Host, { key: '452882c1105868f5d392e7cb165311b1abc4a243', class: `pds-row ${rowClasses}`, style: rowInlineStyles });
     }
     static get is() { return "pds-row"; }
     static get originalStyleUrls() {

package/dist/collection/components/pds-switch/pds-switch.js

@@ -93,6 +93,18 @@ export class PdsSwitch {
             this.checked = state === (this.value || 'on');
         }
     }
+    /**
+     * Form Associated Custom Elements API: Called when the form is disabled
+     */
+    formDisabledCallback(disabled) {
+        // Also fires when this element's own `disabled` attribute is merely present, even as the
+        // literal string "false" (a consumer's or React's attribute serialization can write that) —
+        // the platform treats any value as disabled, independent of fieldset state. A real disabled
+        // fieldset ancestor confirms this is genuinely that, not this element's own attribute.
+        if (disabled && !this.el.closest('fieldset[disabled]'))
+            return;
+        this.disabled = disabled;
+    }
     componentWillLoad() {
         this.inheritedAttributes = Object.assign({}, inheritAriaAttributes(this.el));
         this.updateHasLabelSlot();
@@ -101,9 +113,9 @@ export class PdsSwitch {
         const hostClass = this.switchClassNames();
         const ariaDisabled = this.disabled ? 'true' : null;
         this.hostKeeper.record(hostClass, {}, { 'aria-disabled': ariaDisabled });
-        return (h(Host, { key: 'ee8576e523348ff9eed1b6087626849bb0966608', class: hostClass, "aria-disabled": ariaDisabled }, h("label", { key: '09433b5356d718be65f4f2eb61f35fff1d000e10', htmlFor: this.componentId }, h("input", Object.assign({ key: 'f996a0fad56119674cfb7d95e1444bf411b64396', "aria-describedby": assignDescription(this.componentId, this.invalid, this.helperMessage, this.errorMessage), "aria-invalid": this.invalid ? "true" : undefined, checked: this.checked, class: "pds-switch__input", disabled: this.disabled, id: this.componentId, name: this.name ? this.name : this.componentId, onChange: this.onSwitchUpdate, required: this.required, type: "checkbox", value: this.value }, this.inheritedAttributes)), h("span", { key: '4b23305d3cc0f5b37b23c6b79a14cfba57c16816', class: this.hideLabel ? 'visually-hidden' : '' }, h("slot", { key: '258b5ccf0d4b01518df3a37772d694cb37569ffa', name: "label", onSlotchange: this.updateHasLabelSlot }), !this.hasLabelSlot && this.label)), this.helperMessage &&
-            h("div", { key: 'c8196fa2ce832de3a8c6d987a78fd65d791c4c59', class: `pds-switch__message`, id: messageId(this.componentId, 'helper') }, this.helperMessage), this.errorMessage &&
-            h("div", { key: '948894dd2e642689af6cad545a0b31f7c4711d87', class: `pds-switch__message pds-switch__message--error`, id: messageId(this.componentId, 'error'), "aria-live": "assertive" }, h("pds-icon", { key: 'd4b72b49bfd38a396b8f7c0686e1b2ef92d65491', icon: danger, size: "small" }), this.errorMessage)));
+        return (h(Host, { key: 'b8bd2870be101081aa8a65cdee45397bc4c21435', class: hostClass, "aria-disabled": ariaDisabled }, h("label", { key: '1e223f22f7fc6c576098353ad67dc11500def8b4', htmlFor: this.componentId }, h("input", Object.assign({ key: 'edf59869e165a65b97465ea9de06f7ea82fbc9a6', "aria-describedby": assignDescription(this.componentId, this.invalid, this.helperMessage, this.errorMessage), "aria-invalid": this.invalid ? "true" : undefined, checked: this.checked, class: "pds-switch__input", disabled: this.disabled, id: this.componentId, name: this.name ? this.name : this.componentId, onChange: this.onSwitchUpdate, required: this.required, type: "checkbox", value: this.value }, this.inheritedAttributes)), h("span", { key: '1c252b9455471069f8c6ea6c13f2e88c99308b41', class: this.hideLabel ? 'visually-hidden' : '' }, h("slot", { key: 'ce0d471918bd3018f5e55d0d1e6c5c2247790f81', name: "label", onSlotchange: this.updateHasLabelSlot }), !this.hasLabelSlot && this.label)), this.helperMessage &&
+            h("div", { key: '64874b15403f1f42344715ac34febdfb8d94042a', class: `pds-switch__message`, id: messageId(this.componentId, 'helper') }, this.helperMessage), this.errorMessage &&
+            h("div", { key: '560ea486859124bb0ac2f75ab4bd34b0bca7efbc', class: `pds-switch__message pds-switch__message--error`, id: messageId(this.componentId, 'error'), "aria-live": "assertive" }, h("pds-icon", { key: 'f49caaba976579eb5588e442499595c7dba7ceff', icon: danger, size: "small" }), this.errorMessage)));
     }
     static get is() { return "pds-switch"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/pds-table/pds-table-cell/pds-table-cell.js

@@ -6,6 +6,7 @@ export class PdsTableCell {
         this.scrollContainer = null;
         this.setupRetries = 0;
         this.truncationCleanup = null;
+        this.hasLoaded = false;
         /**
          * Determines if the table is currently scrolling.
          * @defaultValue false
@@ -31,8 +32,23 @@ export class PdsTableCell {
     componentWillRender() {
         this.tableRef = this.hostElement.closest('pds-table');
     }
+    // Fires again each time the cell is moved (a sort re-appends every row), unlike componentDidLoad,
+    // so it re-binds what disconnectedCallback tore down. The tooltip binds to the host, which exists before load.
+    connectedCallback() {
+        if (!this.hasLoaded)
+            return;
+        this.tableRef = this.hostElement.closest('pds-table');
+        this.cleanupScrollListener();
+        if (this.needsScrollShadow) {
+            this.setupScrollListener();
+        }
+        if (this.truncate) {
+            this.initTruncationTooltip();
+        }
+    }
     componentDidLoad() {
-        if (this.tableRef && this.tableRef.responsive && this.tableRef.fixedColumn) {
+        this.hasLoaded = true;
+        if (this.needsScrollShadow) {
             // For responsive tables with fixed columns, set up scroll detection
             // This enables the first column to show a shadow when the table is scrolled horizontally
             this.setupScrollListener();
@@ -45,6 +61,10 @@ export class PdsTableCell {
         this.cleanupScrollListener();
         this.destroyTruncationTooltip();
     }
+    get needsScrollShadow() {
+        var _a;
+        return Boolean(((_a = this.tableRef) === null || _a === void 0 ? void 0 : _a.responsive) && this.tableRef.fixedColumn);
+    }
     setupScrollListener() {
         var _a;
         if (!this.tableRef)
@@ -123,11 +143,11 @@ export class PdsTableCell {
         return classNames.join(' ');
     }
     render() {
-        return (h(Host, { key: 'bedaeeb5723299656f872a760ed1dd80c7fe8793', class: this.classNames(), role: "gridcell", part: "cell", style: this.tableRef &&
+        return (h(Host, { key: 'de70a1002cc46e204f87349069b86ca43aa2129a', class: this.classNames(), role: "gridcell", part: "cell", style: this.tableRef &&
                 this.tableRef.fixedColumn &&
                 this.tableRef.selectable
                 ? { '--fixed-cell-position': '40px' }
-                : {} }, h("slot", { key: '45182ee3e004097660432f552780b3d27671bd46' })));
+                : {} }, h("slot", { key: '5e2b3308291e480323d7a1ac0575035758fb3695' })));
     }
     static get is() { return "pds-table-cell"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/pds-text/pds-text.js

@@ -23,9 +23,10 @@ export class PdsText {
     }
     validateSize(newValue) {
         // Skip when the prop is omitted or explicitly cleared (an empty string is a
-        // common "unset" sentinel). Any other unsupported value — including a
+        // common "unset" sentinel), or its attribute was removed (Stencil sets the
+        // prop to `null`). Any other unsupported value — including a
         // whitespace-only string — is a developer mistake worth warning about.
-        if (newValue === undefined || newValue === '') {
+        if (newValue == null || newValue === '') {
             return;
         }
         if (!TEXT_SIZES.includes(newValue)) {
@@ -38,6 +39,13 @@ export class PdsText {
         // any attempt to apply an unknown size class. @Watch covers later changes.
         this.validateSize(this.size);
     }
+    // componentDidLoad runs once, so a moved element re-binds here what disconnectedCallback tore
+    // down. Before the first render there's no contentEl yet, and componentDidLoad binds it.
+    connectedCallback() {
+        if (this.truncate && this.contentEl) {
+            this.initTruncationTooltip();
+        }
+    }
     componentDidLoad() {
         if (this.truncate) {
             this.initTruncationTooltip();
@@ -67,23 +75,23 @@ export class PdsText {
         const Tag = this.tag;
         const typeClasses = `
       pds-text
-      ${this.align !== undefined && this.align.trim() !== ''
+      ${this.align != null && this.align.trim() !== ''
             ? `pds-text--align-${this.align}`
             : ''}
-      ${this.gutter !== undefined && this.gutter.trim() !== ''
+      ${this.gutter != null && this.gutter.trim() !== ''
             ? `pds-text--gutter-${this.gutter}`
             : ''}
-      ${this.size !== undefined && this.size.trim() !== ''
+      ${this.size != null && this.size.trim() !== ''
             ? `pds-text--size-${this.size}`
             : ''}
-      ${this.weight !== undefined && this.weight.trim() !== ''
+      ${this.weight != null && this.weight.trim() !== ''
             ? `pds-text--weight-${this.weight}`
             : ''}
-      ${this.decoration !== undefined && this.decoration.trim() !== ''
+      ${this.decoration != null && this.decoration.trim() !== ''
             ? `pds-text--decoration-${this.decoration}`
             : ''}
     `;
-        return (h(Tag, { key: '6ae89af63963745cd4e8fa734a62f37bc27c59ac', ref: (el) => (this.contentEl = el), style: this.color && setColor(this.color), class: typeClasses, part: "content" }, h("slot", { key: '008f5852aeb4b43cff1a2fea9be9d8fbba9f7934' })));
+        return (h(Tag, { key: '6460288f1d395080a39aec214e55cab87fdaec9f', ref: (el) => (this.contentEl = el), style: this.color && setColor(this.color), class: typeClasses, part: "content" }, h("slot", { key: 'a8be0d96f72d8ee44288d7c8615155dc68d92663' })));
     }
     static get is() { return "pds-text"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/utils/truncation-tooltip.js

@@ -69,7 +69,7 @@ function isOverflowing(el) {
  * @returns A cleanup function that removes all listeners, observers, and DOM elements.
  */
 export function setupTruncationTooltip(options) {
-    const { hostEl, contentEl, getTooltipText, placement = 'top', manageTabIndex = true } = options;
+    const { hostEl, contentEl, getTooltipText, placement = 'top', reference = hostEl, manageTabIndex = true, focusEl = hostEl } = options;
     injectStyles();
     let portalEl = null;
     let isHovering = false;
@@ -164,7 +164,7 @@ export function setupTruncationTooltip(options) {
         if (!portalEl)
             return;
         try {
-            const { x, y } = await computePosition(hostEl, portalEl, {
+            const { x, y } = await computePosition(reference, portalEl, {
                 placement,
                 strategy: 'fixed',
                 middleware: [offset(4), flip(), shift({ padding: 5 })],
@@ -177,7 +177,7 @@ export function setupTruncationTooltip(options) {
         catch (_a) {
             // Fallback: position above the element with bounds checking
             if (portalEl) {
-                const rect = hostEl.getBoundingClientRect();
+                const rect = reference.getBoundingClientRect();
                 const portalRect = portalEl.getBoundingClientRect();
                 const padding = 5;
                 // Ensure tooltip stays within viewport bounds
@@ -263,8 +263,8 @@ export function setupTruncationTooltip(options) {
     }
     hostEl.addEventListener('mouseenter', handleMouseEnter);
     hostEl.addEventListener('mouseleave', handleMouseLeave);
-    hostEl.addEventListener('focusin', handleFocusIn);
-    hostEl.addEventListener('focusout', handleFocusOut);
+    focusEl.addEventListener('focusin', handleFocusIn);
+    focusEl.addEventListener('focusout', handleFocusOut);
     // Return cleanup function
     return () => {
         disposed = true;
@@ -284,8 +284,8 @@ export function setupTruncationTooltip(options) {
         }
         hostEl.removeEventListener('mouseenter', handleMouseEnter);
         hostEl.removeEventListener('mouseleave', handleMouseLeave);
-        hostEl.removeEventListener('focusin', handleFocusIn);
-        hostEl.removeEventListener('focusout', handleFocusOut);
+        focusEl.removeEventListener('focusin', handleFocusIn);
+        focusEl.removeEventListener('focusout', handleFocusOut);
         removePortal();
     };
 }

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-10-21T00:46:53",
+  "timestamp": "2026-10-23T15:39:06",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -14659,7 +14659,7 @@
           },
           "signature": "clear() => Promise<void>",
           "parameters": [],
-          "docs": "Clears the selected value and resets the component.",
+          "docs": "Clears the selected value and resets the component. Works while disabled too, as setting a\nnative control's value from script does.",
           "docsTags": []
         },
         {
@@ -20004,6 +20004,10 @@
               "HTMLElement": {
                 "location": "global",
                 "id": "global::HTMLElement"
+              },
+              "HTMLPdsModalElement": {
+                "location": "global",
+                "id": "global::HTMLPdsModalElement"
               }
             },
             "return": "Promise<void>"
@@ -21587,7 +21591,7 @@
           },
           "signature": "clear() => Promise<void>",
           "parameters": [],
-          "docs": "Clears all selected values and resets the component.",
+          "docs": "Clears all selected values and resets the component. Works while disabled too, as setting a\nnative control's value from script does.",
           "docsTags": []
         },
         {