@pine-ds/core 4.3.0 → 4.4.0

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

@@ -1,18 +1,24 @@
 import { h, Host } from "@stencil/core";
 import { computePosition, flip, offset, shift, size, autoUpdate } from "@floating-ui/dom";
-import { debounceEvent } from "../../utils/utils";
+import { cancelDebouncedEvent, debounceEvent, flushDebouncedEvent } from "../../utils/utils";
 import { isSpecTest, messageId, assignDescription } from "../../utils/form";
 import { danger, enlarge } from "@pine-ds/icons/icons";
 import { formatMessage, pluralize } from "../../i18n";
+// Names only: pds-icon's `icon` prop also fetches URLs and data: SVGs, unsanitized.
+const PINE_ICON_NAME = /^[a-z0-9-]+$/i;
+const TABBABLE_SELECTOR = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
 /**
  * @slot (default) - Static option elements for the multiselect
  * @slot empty - Custom empty state message when no options match
  * @slot loading - Custom loading indicator
+ * @slot trigger - Custom trigger element that replaces the built-in trigger. It opens the dropdown panel and receives `aria-expanded` and `aria-haspopup`; it supplies its own accessible name. Slot the focusable control itself, not a wrapper around it.
+ * @slot footer - Links or buttons displayed below the options inside the dropdown panel
  * @part trigger - The trigger surface that opens the dropdown panel
  * @part pill-toggle - The chevron button inside the inline pill trigger
  */
 export class PdsMultiselect {
     constructor() {
+        this.hasDisabledSlottedTrigger = false;
         /**
          * Placeholder text for the input field. Pass a translated string to localize it; defaults to English.
          * @defaultValue 'Select...'
@@ -138,6 +144,13 @@ export class PdsMultiselect {
          * @default 3
          */
         this.maxInlinePills = 3;
+        /**
+         * Display mode for options in the dropdown panel.
+         * `'text'` shows each option's text (default). `'chip'` shows each option as a
+         * pds-chip, with a dot when the option has a `dotColor`.
+         * @defaultValue 'text'
+         */
+        this.optionDisplay = 'text';
         /**
          * If true, the multiselect is required.
          */
@@ -150,6 +163,21 @@ export class PdsMultiselect {
          * CSRF header name for authenticated requests. Defaults to `X-CSRF-Token`.
          */
         this.csrfHeaderName = 'X-CSRF-Token';
+        /**
+         * Shows an action icon on each option that has an `actionIcon`, such as an edit pencil.
+         * The icon shows on the hovered or highlighted option; clicking it, or pressing Right Arrow on the highlighted option, emits `pdsMultiselectOptionAction`.
+         */
+        this.optionActions = false;
+        /**
+         * Tooltip for an option's action icon when the option has no `actionLabel`. Pass a translated string to localize it; `{text}` is interpolated.
+         * @defaultValue 'Edit {text}'
+         */
+        this.optionActionLabel = 'Edit {text}';
+        /**
+         * Screen-reader hint on each option that has an action, naming the key that runs it. Pass a translated string to localize it; `{action}` is interpolated with the option's action label.
+         * @defaultValue 'Press Right Arrow to {action}'
+         */
+        this.optionActionDescription = 'Press Right Arrow to {action}';
         // Internal state
         this.isOpen = false;
         this.searchQuery = '';
@@ -173,7 +201,7 @@ export class PdsMultiselect {
                 return;
             // In inline-pill mode, ignore clicks that originated inside a pds-chip.
             // Chip close-button clicks are handled by handlePillRemove; chip body clicks should not toggle the panel.
-            if (e && this.selectedDisplay === 'pill' && this.pillPosition === 'inline') {
+            if (e && !this.slottedTriggerEl && this.selectedDisplay === 'pill' && this.pillPosition === 'inline') {
                 const fromChip = e.composedPath().some(el => { var _a; return ((_a = el.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === 'pds-chip'; });
                 if (fromChip)
                     return;
@@ -186,9 +214,11 @@ export class PdsMultiselect {
             }
         };
         this.handleTriggerKeyDown = (e) => {
+            if (this.disabled)
+                return;
             // Ignore keydown events that bubbled from child elements (e.g. chip close buttons).
             // Only handle keys when the trigger itself is the event target.
-            if (e.target !== this.triggerEl)
+            if (e.target !== this.activeTriggerEl)
                 return;
             switch (e.key) {
                 case 'ArrowDown':
@@ -252,10 +282,43 @@ export class PdsMultiselect {
                         }
                     }
                     break;
+                // Right Arrow still moves the caret through typed text; a plain Right Arrow at the end runs the action.
+                case 'ArrowRight': {
+                    const option = filteredOptions[this.highlightedIndex];
+                    const isPlainKey = !e.altKey && !e.ctrlKey && !e.metaKey && !e.shiftKey && !e.isComposing;
+                    if (isPlainKey && option && this.hasOptionAction(option) && this.isCaretAtEndOfSearch()) {
+                        e.preventDefault();
+                        this.runOptionAction(option);
+                    }
+                    break;
+                }
                 // Escape is handled by the global @Listen('keydown') handler
-                case 'Tab':
-                    this.closeDropdown();
+                case 'Tab': {
+                    const firstFooterTabbable = e.shiftKey ? undefined : this.getFooterTabbables()[0];
+                    firstFooterTabbable === null || firstFooterTabbable === void 0 ? void 0 : firstFooterTabbable.focus();
+                    if (firstFooterTabbable === null || firstFooterTabbable === void 0 ? void 0 : firstFooterTabbable.matches(':focus')) {
+                        // Each option's checkbox is a tab stop, so jump past them to the footer.
+                        e.preventDefault();
+                    }
+                    else {
+                        this.closeDropdown();
+                    }
                     break;
+                }
+            }
+        };
+        this.handleFooterKeyDown = (e) => {
+            var _a;
+            if (e.key !== 'Tab')
+                return;
+            const tabbables = this.getFooterTabbables();
+            const focused = e.composedPath()[0];
+            if (e.shiftKey && focused === tabbables[0]) {
+                e.preventDefault();
+                (_a = this.searchInputEl) === null || _a === void 0 ? void 0 : _a.focus();
+            }
+            else if (!e.shiftKey && focused === tabbables[tabbables.length - 1]) {
+                this.closeDropdown();
             }
         };
         this.handleContainerFocusOut = () => {
@@ -270,9 +333,9 @@ export class PdsMultiselect {
                 const activeElement = document.activeElement;
                 // Check if focus is within our component's shadow root
                 const isInShadowRoot = (_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.contains(activeElement);
-                // Also check if focus is on the host element itself
-                const isOnHost = activeElement === this.el;
-                if (!isInShadowRoot && !isOnHost) {
+                // Also check the host itself and its light DOM, where slotted trigger and footer content live
+                const isInHost = this.el.contains(activeElement);
+                if (!isInShadowRoot && !isInHost) {
                     this.pdsMultiselectDismiss.emit();
                     this.closeDropdown();
                 }
@@ -287,6 +350,18 @@ export class PdsMultiselect {
                 return;
             this.highlightedIndex = index;
         };
+        this.handleOptionActionMouseDown = (e) => {
+            // Stops the row's mousedown from toggling the option, and keeps focus in the search input.
+            e.preventDefault();
+            e.stopPropagation();
+        };
+        this.handleOptionActionClick = (option) => () => {
+            this.runOptionAction(option);
+        };
+        // Keeps focus in the search input so the panel stays open until the footer's click lands.
+        this.handleFooterMouseDown = (e) => {
+            e.preventDefault();
+        };
         this.handleScroll = (e) => {
             if (!this.asyncUrl || !this.hasMore || this.loading)
                 return;
@@ -308,7 +383,7 @@ export class PdsMultiselect {
             const optionId = String(item.id);
             this.value = this.value.filter(v => v !== optionId);
             this.syncSelectedItems();
-            this.pdsMultiselectChange.emit({ values: this.value, items: this.selectedItems });
+            this.emitChange({ removed: [optionId] });
             // Clear first so screen readers re-announce even when the same item is removed twice
             this.removalAnnouncement = '';
             queueMicrotask(() => { this.removalAnnouncement = formatMessage(this.itemRemovedLabel, { item: item.text }); });
@@ -317,7 +392,7 @@ export class PdsMultiselect {
                 (_a = this.searchInputEl) === null || _a === void 0 ? void 0 : _a.focus();
             }
             else {
-                (_b = this.triggerEl) === null || _b === void 0 ? void 0 : _b.focus();
+                (_b = this.activeTriggerEl) === null || _b === void 0 ? void 0 : _b.focus();
             }
             setTimeout(() => { this.isClosingViaSelection = false; }, 0);
         };
@@ -331,6 +406,7 @@ export class PdsMultiselect {
     componentWillLoad() {
         this.originalSearchEmitter = this.pdsMultiselectSearch;
         this.syncSelectedItems();
+        this.syncSlottedTrigger();
     }
     componentDidLoad() {
         this.setupDebounce();
@@ -364,6 +440,7 @@ export class PdsMultiselect {
     }
     disconnectedCallback() {
         var _a, _b;
+        cancelDebouncedEvent(this.pdsMultiselectSearch);
         (_a = this.observer) === null || _a === void 0 ? void 0 : _a.disconnect();
         (_b = this.cleanupAutoUpdate) === null || _b === void 0 ? void 0 : _b.call(this);
         this.clearAsyncFetchState();
@@ -373,6 +450,8 @@ export class PdsMultiselect {
         this.pdsMultiselectSearch = debounce === undefined
             ? originalSearchEmitter !== null && originalSearchEmitter !== void 0 ? originalSearchEmitter : pdsMultiselectSearch
             : debounceEvent(pdsMultiselectSearch, debounce);
+        // After the swap, so an emit made while flushing goes to the new emitter, not the old one.
+        flushDebouncedEvent(pdsMultiselectSearch);
     }
     valueChanged(newValue) {
         // Handle JSON string values (from HTML attributes)
@@ -418,26 +497,42 @@ export class PdsMultiselect {
         // This handles the case where value is set before options are loaded (e.g., from slot)
         this.syncSelectedItems();
     }
+    isOpenChanged() {
+        var _a;
+        (_a = this.slottedTriggerEl) === null || _a === void 0 ? void 0 : _a.setAttribute('aria-expanded', String(this.isOpen));
+    }
+    disabledChanged() {
+        this.syncSlottedTrigger();
+    }
     /**
      * Sets focus on the trigger button.
      */
     async setFocus() {
         var _a;
-        (_a = this.triggerEl) === null || _a === void 0 ? void 0 : _a.focus();
+        (_a = this.activeTriggerEl) === null || _a === void 0 ? void 0 : _a.focus();
     }
     /**
      * Clears all selected values and resets the component.
      */
     async clear() {
         const hadValues = this.value.length > 0 || this.searchQuery !== '';
+        const removed = this.ensureValueArray();
         this.value = [];
         this.searchQuery = '';
         this.syncSelectedItems();
         this.updateFormValue();
         if (hadValues) {
-            this.pdsMultiselectChange.emit({ values: [], items: [] });
+            this.emitChange({ removed });
         }
     }
+    /**
+     * Refetches the first page of options from `asyncUrl` for the current search, such as after an option is renamed
+     * or recolored elsewhere. Selected items in that page pick up the new text and dot color without emitting a change;
+     * other selected items keep the text and dot color they were last loaded with. Does nothing without `asyncUrl`.
+     */
+    async refreshOptions() {
+        await this.fetchOptions(this.searchQuery, 1);
+    }
     /**
      * Handle global keyboard events for accessibility.
      * Closes dropdown on Escape key press regardless of focus location.
@@ -450,12 +545,70 @@ export class PdsMultiselect {
             event.preventDefault();
             this.pdsMultiselectDismiss.emit();
             this.closeDropdown();
-            (_a = this.triggerEl) === null || _a === void 0 ? void 0 : _a.focus();
+            (_a = this.activeTriggerEl) === null || _a === void 0 ? void 0 : _a.focus();
+        }
+    }
+    get activeTriggerEl() {
+        var _a;
+        return (_a = this.slottedTriggerEl) !== null && _a !== void 0 ? _a : this.triggerEl;
+    }
+    syncSlottedTrigger() {
+        const trigger = Array.from(this.el.children).find(child => child.getAttribute('slot') === 'trigger');
+        if (trigger !== this.slottedTriggerEl) {
+            const previous = this.slottedTriggerEl;
+            if (previous) {
+                previous.removeEventListener('click', this.handleTriggerClick);
+                previous.removeEventListener('keydown', this.handleTriggerKeyDown);
+                previous.removeAttribute('aria-expanded');
+                previous.removeAttribute('aria-haspopup');
+                previous.removeAttribute('aria-disabled');
+                this.setSlottedTriggerDisabled(previous, false);
+            }
+            trigger === null || trigger === void 0 ? void 0 : trigger.addEventListener('click', this.handleTriggerClick);
+            trigger === null || trigger === void 0 ? void 0 : trigger.addEventListener('keydown', this.handleTriggerKeyDown);
+            this.slottedTriggerEl = trigger;
+        }
+        if (!trigger)
+            return;
+        trigger.setAttribute('aria-haspopup', 'listbox');
+        trigger.setAttribute('aria-expanded', String(this.isOpen));
+        if (this.disabled) {
+            trigger.setAttribute('aria-disabled', 'true');
+        }
+        else {
+            trigger.removeAttribute('aria-disabled');
+        }
+        this.setSlottedTriggerDisabled(trigger, this.disabled);
+    }
+    setSlottedTriggerDisabled(trigger, disabled) {
+        if (!('disabled' in trigger)) {
+            // A custom element gets its `disabled` property once it's defined, which can be after the multiselect loads.
+            if (disabled && trigger.localName.includes('-') && customElements.get(trigger.localName) === undefined) {
+                customElements.whenDefined(trigger.localName).then(() => this.syncSlottedTrigger());
+            }
+            return;
+        }
+        const control = trigger;
+        // Only re-enable a trigger the multiselect disabled, so one the consumer disabled stays disabled.
+        if (disabled && !control.disabled) {
+            control.disabled = true;
+            this.hasDisabledSlottedTrigger = true;
+        }
+        else if (!disabled && this.hasDisabledSlottedTrigger) {
+            control.disabled = false;
+            this.hasDisabledSlottedTrigger = false;
         }
     }
     setupMutationObserver() {
-        this.observer = new MutationObserver(() => {
-            this.updateOptionsFromSlot();
+        this.observer = new MutationObserver(records => {
+            if (records.some(record => record.target === this.el)) {
+                this.syncSlottedTrigger();
+            }
+            // Changes inside the slotted trigger, like re-rendered chips, can't change the options.
+            const trigger = this.slottedTriggerEl;
+            if (!trigger || records.some(record => !trigger.contains(record.target))) {
+                this.updateOptionsFromSlot();
+            }
         });
         this.observer.observe(this.el, {
             childList: true,
@@ -469,18 +622,12 @@ export class PdsMultiselect {
             return;
         const options = [];
         slot.assignedElements({ flatten: true }).forEach(el => {
-            var _a;
             if (el.tagName === 'OPTGROUP') {
                 const optgroup = el;
                 const groupLabel = optgroup.label;
                 const groupDisabled = optgroup.disabled;
                 optgroup.querySelectorAll('option').forEach((opt) => {
-                    var _a;
-                    const option = {
-                        id: opt.value,
-                        text: ((_a = opt.textContent) === null || _a === void 0 ? void 0 : _a.trim()) || opt.value,
-                        disabled: opt.disabled || groupDisabled || undefined,
-                    };
+                    const option = this.parseSlottedOption(opt, groupDisabled);
                     if (groupLabel) {
                         option.group = groupLabel;
                     }
@@ -488,12 +635,7 @@ export class PdsMultiselect {
                 });
             }
             else if (el.tagName === 'OPTION') {
-                const opt = el;
-                options.push({
-                    id: opt.value,
-                    text: ((_a = opt.textContent) === null || _a === void 0 ? void 0 : _a.trim()) || opt.value,
-                    disabled: opt.disabled || undefined,
-                });
+                options.push(this.parseSlottedOption(el, false));
             }
         });
         // Only update if we actually found options AND we're not using async/external options
@@ -502,6 +644,27 @@ export class PdsMultiselect {
             this.internalOptions = options;
         }
     }
+    parseSlottedOption(opt, groupDisabled) {
+        var _a;
+        const option = {
+            id: opt.value,
+            text: ((_a = opt.textContent) === null || _a === void 0 ? void 0 : _a.trim()) || opt.value,
+            disabled: opt.disabled || groupDisabled || undefined,
+        };
+        const dotColor = opt.getAttribute('data-dot-color');
+        if (dotColor) {
+            option.dotColor = dotColor;
+        }
+        const actionIcon = opt.getAttribute('data-action-icon');
+        if (actionIcon) {
+            option.actionIcon = actionIcon;
+        }
+        const actionLabel = opt.getAttribute('data-action-label');
+        if (actionLabel) {
+            option.actionLabel = actionLabel;
+        }
+        return option;
+    }
     clearAsyncFetchState() {
         var _a;
         if (this.fetchDebounceTimer !== undefined) {
@@ -611,7 +774,7 @@ export class PdsMultiselect {
             this.internals.setFormValue(formData);
             // Update validity state for required validation
             if (this.required && valueArray.length === 0) {
-                this.internals.setValidity({ valueMissing: true }, 'Please select at least one option.', this.triggerEl);
+                this.internals.setValidity({ valueMissing: true }, 'Please select at least one option.', this.activeTriggerEl);
             }
             else {
                 this.internals.setValidity({});
@@ -764,10 +927,7 @@ export class PdsMultiselect {
                 newOption,
             });
             // Emit change event with synced items
-            this.pdsMultiselectChange.emit({
-                values: this.value,
-                items: this.selectedItems,
-            });
+            this.emitChange({ added: [String(newOption.id)] });
             // Clear search and keep dropdown open
             this.searchQuery = '';
             this.highlightedIndex = -1;
@@ -784,6 +944,44 @@ export class PdsMultiselect {
             this.creating = false;
         }
     }
+    getFooterTabbables() {
+        const candidates = [];
+        Array.from(this.el.children)
+            .filter(child => child.getAttribute('slot') === 'footer')
+            .forEach(content => candidates.push(content, ...Array.from(content.querySelectorAll('*'))));
+        // Browsers without checkVisibility (Safari before 17.4) count every control as visible.
+        return candidates
+            .map(el => { var _a; return (el.matches(TABBABLE_SELECTOR) ? el : (_a = el.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(TABBABLE_SELECTOR)); })
+            .filter((el) => { var _a, _b; return !!el && ((_b = (_a = el.checkVisibility) === null || _a === void 0 ? void 0 : _a.call(el)) !== null && _b !== void 0 ? _b : true); });
+    }
+    isCaretAtEndOfSearch() {
+        var _a, _b;
+        const input = this.searchInputEl;
+        if (!input)
+            return true;
+        const end = input.value.length;
+        return ((_a = input.selectionStart) !== null && _a !== void 0 ? _a : end) === end && ((_b = input.selectionEnd) !== null && _b !== void 0 ? _b : end) === end;
+    }
+    hasOptionAction(option) {
+        return (this.optionActions &&
+            typeof option.actionIcon === 'string' &&
+            PINE_ICON_NAME.test(option.actionIcon) &&
+            !option.isCreateOption &&
+            !option.disabled);
+    }
+    // Without hover, revealing the icon would take a tap that also toggles the option, so touch shows every icon.
+    get isHoverless() {
+        var _a, _b, _c;
+        (_a = this.hoverlessQuery) !== null && _a !== void 0 ? _a : (this.hoverlessQuery = (_b = window.matchMedia) === null || _b === void 0 ? void 0 : _b.call(window, '(hover: none)'));
+        return !!((_c = this.hoverlessQuery) === null || _c === void 0 ? void 0 : _c.matches);
+    }
+    runOptionAction(option) {
+        var _a;
+        this.isClosingViaSelection = true;
+        this.closeDropdown();
+        (_a = this.activeTriggerEl) === null || _a === void 0 ? void 0 : _a.focus();
+        this.pdsMultiselectOptionAction.emit({ option });
+    }
     openDropdown() {
         if (this.disabled)
             return;
@@ -828,12 +1026,12 @@ export class PdsMultiselect {
             return;
         // In inline pill mode, triggerEl is the small chevron button — use the full-width
         // wrapper div as the Floating UI reference so the panel aligns with the whole trigger.
-        const referenceEl = this.pillInlineTriggerEl || this.triggerEl || this.containerEl;
+        const referenceEl = this.slottedTriggerEl || this.pillInlineTriggerEl || this.triggerEl || this.containerEl;
         const { minWidth, panelWidth } = this;
         const updatePosition = () => {
             computePosition(referenceEl, this.panelEl, {
                 placement: 'bottom-start',
-                strategy: 'absolute',
+                strategy: 'fixed',
                 middleware: [
                     offset(12),
                     flip(),
@@ -870,6 +1068,9 @@ export class PdsMultiselect {
             highlighted === null || highlighted === void 0 ? void 0 : highlighted.scrollIntoView({ block: 'nearest', behavior: 'smooth' });
         });
     }
+    emitChange({ added = [], removed = [] }) {
+        this.pdsMultiselectChange.emit({ values: this.value, items: this.selectedItems, added, removed });
+    }
     toggleOption(option) {
         var _a, _b;
         if (option.disabled)
@@ -898,14 +1099,11 @@ export class PdsMultiselect {
         // Sync selected items to ensure no duplicates and accurate state
         this.syncSelectedItems();
         // Emit change event with synced items
-        this.pdsMultiselectChange.emit({
-            values: this.value,
-            items: this.selectedItems,
-        });
+        this.emitChange(isSelected ? { removed: [optionId] } : { added: [optionId] });
         if (this.closePanelOnSelect) {
             this.isClosingViaSelection = true;
             this.closeDropdown();
-            (_a = this.triggerEl) === null || _a === void 0 ? void 0 : _a.focus();
+            (_a = this.activeTriggerEl) === null || _a === void 0 ? void 0 : _a.focus();
         }
         else {
             // Keep focus on search input, don't close dropdown
@@ -942,13 +1140,22 @@ export class PdsMultiselect {
         const isHighlighted = index === this.highlightedIndex && !isCreateOption;
         const optionId = `${this.componentId}-option-${index}`;
         const isCreateDisabled = isCreateOption && this.creating;
+        const hasAction = this.hasOptionAction(option);
         return (h("li", { key: String(option.id), id: optionId, class: {
                 'pds-multiselect__option': true,
                 'pds-multiselect__option--highlighted': isHighlighted,
                 '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, "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' } }))));
+            }, 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)));
+    }
+    renderOptionAction(option, optionId, isHighlighted) {
+        var _a;
+        const label = formatMessage((_a = option.actionLabel) !== null && _a !== void 0 ? _a : this.optionActionLabel, { text: option.text });
+        return [
+            h("span", { class: "pds-multiselect__option-action", title: label, "aria-hidden": "true", onMouseDown: this.handleOptionActionMouseDown, onClick: this.handleOptionActionClick(option) }, (isHighlighted || this.isHoverless) && h("pds-icon", { name: option.actionIcon })),
+            h("span", { id: `${optionId}-action-description`, hidden: true }, formatMessage(this.optionActionDescription, { action: label })),
+        ];
     }
     renderSelectedItemsList() {
         if (this.hideSelectedItems || this.selectedItems.length === 0)
@@ -962,12 +1169,13 @@ export class PdsMultiselect {
         const valueArray = this.ensureValueArray();
         const hasSlottedEmpty = !!this.el.querySelector('[slot="empty"]');
         const hasSlottedLoading = !!this.el.querySelector('[slot="loading"]');
+        const hasSlottedFooter = !!this.el.querySelector('[slot="footer"]');
         return (h("div", { class: "pds-multiselect__panel", ref: el => (this.panelEl = el), style: { minWidth: this.minWidth } }, h("div", { class: "pds-multiselect__search" }, h("pds-icon", { name: "search", size: "small" }), h("input", { ref: el => (this.searchInputEl = el), type: "text", class: "pds-multiselect__search-input", placeholder: this.searchPlaceholder, value: this.searchQuery, "aria-label": this.searchOptionsLabel, "aria-controls": `${this.componentId}-listbox`, "aria-activedescendant": this.highlightedIndex >= 0 ? `${this.componentId}-option-${this.highlightedIndex}` : undefined, role: "combobox", "aria-haspopup": "listbox", "aria-expanded": "true", "aria-autocomplete": "list", autocomplete: "off", onInput: this.handleSearchInputChange, onKeyDown: this.handleSearchInputKeyDown })), this.renderSelectedItemsList(), h("ul", { class: "pds-multiselect__listbox", role: "listbox", "aria-multiselectable": "true", "aria-label": this.label || this.optionsLabel, id: `${this.componentId}-listbox`, ref: el => (this.listboxEl = el), style: { maxHeight: this.maxHeight }, onScroll: this.handleScroll }, this.loading && (h("li", { class: "pds-multiselect__loading", role: "presentation" }, hasSlottedLoading ? (h("slot", { name: "loading" })) : (h("pds-loader", { size: "small" })))), !this.loading && filteredOptions.length === 0 && (h("li", { class: "pds-multiselect__empty", role: "presentation" }, hasSlottedEmpty ? (h("slot", { name: "empty" })) : (h("span", null, this.noOptionsFoundLabel)))), this.getGroupedRenderItems(filteredOptions).map((item, itemIndex) => {
             if (item.type === 'group') {
                 return (h("li", { key: `group-${itemIndex}`, role: "group", "aria-label": item.group, class: "pds-multiselect__group" }, h("span", { class: "pds-multiselect__group-header", "aria-hidden": "true" }, item.group), h("ul", { class: "pds-multiselect__group-list", role: "presentation" }, item.options.map(({ option, index }) => this.renderOption(option, index, valueArray)))));
             }
             return this.renderOption(item.option, item.index, valueArray);
-        }), this.hasMore && !this.loading && (h("li", { class: "pds-multiselect__load-more", role: "presentation" }, h("pds-loader", { size: "small" }))))));
+        }), this.hasMore && !this.loading && (h("li", { class: "pds-multiselect__load-more", role: "presentation" }, h("pds-loader", { size: "small" })))), hasSlottedFooter && (h("div", { class: "pds-multiselect__footer", onMouseDown: this.handleFooterMouseDown, onKeyDown: this.handleFooterKeyDown }, h("slot", { name: "footer" })))));
     }
     renderInlinePills() {
         const hasSelections = this.selectedItems.length > 0;
@@ -1021,17 +1229,17 @@ export class PdsMultiselect {
     }
     render() {
         const hasSelections = this.selectedItems.length > 0;
-        return (h(Host, { key: '5d4de9ca729d5bfb63a8a73f8f40328b9ab48f57', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '2b5e1e01caaa4a6540a67e2638a20072e9f706cb', class: "pds-multiselect", onFocusout: this.handleContainerFocusOut }, this.label && (h("label", { key: 'f23b840feb4e243d90b3a9913dab1b238e7c497d', id: `${this.componentId}-label`, htmlFor: this.componentId, class: {
+        return (h(Host, { key: '295354c218d03a512ee87a9f19d2267a59731eb1', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '8696c02fad869239fa85dcec7f92a3efb402c963', class: "pds-multiselect", onFocusout: this.handleContainerFocusOut }, this.label && (h("label", { key: '2a9cc565c5dbcf78305eb65e94d795669fb0f93b', id: `${this.componentId}-label`, htmlFor: this.componentId, class: {
                 'pds-multiselect__label': true,
                 'visually-hidden': this.hideLabel,
-            } }, this.label)), h("div", { key: '2e1f89d6f06332e957858c0eea34fca1a9629921', class: "pds-multiselect__wrapper", ref: el => (this.containerEl = el), style: { width: this.triggerWidth } }, this.selectedDisplay === 'pill' && this.pillPosition === 'inline' ? (h("div", { ref: el => (this.pillInlineTriggerEl = el || undefined), part: "trigger", class: {
+            } }, this.label)), h("div", { key: '9358ebffb50e74fe4ceb9ca1c13cf819cc3e96e6', 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,
                 'pds-multiselect__trigger--invalid': this.invalid || !!this.errorMessage,
                 'pds-multiselect__trigger--has-value': hasSelections,
                 'pds-multiselect__trigger--pill-inline': true,
-            }, onClick: this.handleTriggerClick }, this.renderInlinePills(), h("button", { ref: el => (this.triggerEl = el), type: "button", id: this.componentId, part: "pill-toggle", class: "pds-multiselect__pill-toggle", disabled: this.disabled, "aria-expanded": this.isOpen ? 'true' : 'false', "aria-haspopup": "listbox", "aria-labelledby": this.label ? `${this.componentId}-label` : undefined, "aria-required": this.required ? 'true' : undefined, "aria-describedby": assignDescription(this.componentId, this.invalid || !!this.errorMessage, this.helperMessage, this.errorMessage), "aria-invalid": this.invalid || !!this.errorMessage ? 'true' : undefined, onKeyDown: this.handleTriggerKeyDown }, h("pds-icon", { class: "pds-multiselect__icon", icon: enlarge })))) : (h("button", { ref: el => (this.triggerEl = el), type: "button", part: "trigger", class: {
+            }, onClick: this.handleTriggerClick }, this.renderInlinePills(), h("button", { ref: el => (this.triggerEl = el), type: "button", id: this.componentId, part: "pill-toggle", class: "pds-multiselect__pill-toggle", disabled: this.disabled, "aria-expanded": this.isOpen ? 'true' : 'false', "aria-haspopup": "listbox", "aria-labelledby": this.label ? `${this.componentId}-label` : undefined, "aria-required": this.required ? 'true' : undefined, "aria-describedby": assignDescription(this.componentId, this.invalid || !!this.errorMessage, this.helperMessage, this.errorMessage), "aria-invalid": this.invalid || !!this.errorMessage ? 'true' : undefined, onKeyDown: this.handleTriggerKeyDown }, h("pds-icon", { "aria-hidden": "true", class: "pds-multiselect__icon", icon: enlarge })))) : (h("button", { ref: el => (this.triggerEl = el), type: "button", part: "trigger", class: {
                 'pds-multiselect__trigger': true,
                 'pds-multiselect__trigger--open': this.isOpen,
                 'pds-multiselect__trigger--disabled': this.disabled,
@@ -1040,7 +1248,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", { class: "pds-multiselect__icon", icon: enlarge }))), this.renderDropdown()), this.selectedDisplay === 'pill' && this.pillPosition === 'below' && this.renderBelowPills(), h("span", { key: '3d2e201157ce16abbcd12fa9254ced7f2b562a8f', class: "visually-hidden", "aria-live": "polite", "aria-atomic": "true" }, this.removalAnnouncement), this.helperMessage && !(this.errorMessage && this.errorMessage.length > 0) && (h("p", { key: '3bbf405df2e72ae730529f28273b003b3332e980', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: 'ef4a27162b00b14c3c9dfcb695f311961f2f56e5', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: '99fb12375e2d660018276091bf8014b9bc9a672e', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '8fc6369015e8d04d1dec582007733eb5db6776f5', style: { display: 'none' } }, h("slot", { key: 'a808ecb0f4b2c00fca478cda5c0054c6aba29a8d' })))));
+            } }, 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: '722da251199792366dc72b6c7f016e24ae807b30', class: "visually-hidden", "aria-live": "polite", "aria-atomic": "true" }, this.removalAnnouncement), this.helperMessage && !(this.errorMessage && this.errorMessage.length > 0) && (h("p", { key: '7b4da9b2e04f53f3e8f245c119135f3b664897ec', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: '95a152f6a350eee2f67dbab2930f19e583ca3b85', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: '7b9cded907054757a6f054d0d325811a2199e496', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '8b07974c8e2d838d76c17c3a52ba4282fb101968', style: { display: 'none' } }, h("slot", { key: '0a34d582bc4dd780072f00ac13bfdce7e297191e' })))));
     }
     static get is() { return "pds-multiselect"; }
     static get encapsulation() { return "shadow"; }
@@ -1763,6 +1971,29 @@ export class PdsMultiselect {
                 "attribute": "max-inline-pills",
                 "defaultValue": "3"
             },
+            "optionDisplay": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'text' | 'chip'",
+                    "resolved": "\"chip\" | \"text\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "defaultValue",
+                            "text": "'text'"
+                        }],
+                    "text": "Display mode for options in the dropdown panel.\n`'text'` shows each option's text (default). `'chip'` shows each option as a\npds-chip, with a dot when the option has a `dotColor`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "option-display",
+                "defaultValue": "'text'"
+            },
             "errorMessage": {
                 "type": "string",
                 "mutable": false,
@@ -1965,6 +2196,72 @@ export class PdsMultiselect {
                 "reflect": false,
                 "attribute": "csrf-header-name",
                 "defaultValue": "'X-CSRF-Token'"
+            },
+            "optionActions": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Shows an action icon on each option that has an `actionIcon`, such as an edit pencil.\nThe icon shows on the hovered or highlighted option; clicking it, or pressing Right Arrow on the highlighted option, emits `pdsMultiselectOptionAction`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "option-actions",
+                "defaultValue": "false"
+            },
+            "optionActionLabel": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "defaultValue",
+                            "text": "'Edit {text}'"
+                        }],
+                    "text": "Tooltip for an option's action icon when the option has no `actionLabel`. Pass a translated string to localize it; `{text}` is interpolated."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "option-action-label",
+                "defaultValue": "'Edit {text}'"
+            },
+            "optionActionDescription": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "defaultValue",
+                            "text": "'Press Right Arrow to {action}'"
+                        }],
+                    "text": "Screen-reader hint on each option that has an action, naming the key that runs it. Pass a translated string to localize it; `{action}` is interpolated with the option's action label."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "option-action-description",
+                "defaultValue": "'Press Right Arrow to {action}'"
             }
         };
     }
@@ -1978,7 +2275,8 @@ export class PdsMultiselect {
             "currentPage": {},
             "hasMore": {},
             "creating": {},
-            "removalAnnouncement": {}
+            "removalAnnouncement": {},
+            "slottedTriggerEl": {}
         };
     }
     static get events() {
@@ -2085,6 +2383,28 @@ export class PdsMultiselect {
                     "resolved": "void",
                     "references": {}
                 }
+            }, {
+                "method": "pdsMultiselectOptionAction",
+                "name": "pdsMultiselectOptionAction",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when an option's action runs, from a click on its icon or Right Arrow on the highlighted option.\nThe panel closes and focus returns to the trigger first, so a modal opened from the handler restores focus to the trigger."
+                },
+                "complexType": {
+                    "original": "MultiselectOptionActionEventDetail",
+                    "resolved": "MultiselectOptionActionEventDetail",
+                    "references": {
+                        "MultiselectOptionActionEventDetail": {
+                            "location": "import",
+                            "path": "./multiselect-interface",
+                            "id": "src/components/pds-multiselect/multiselect-interface.ts::MultiselectOptionActionEventDetail",
+                            "referenceLocation": "MultiselectOptionActionEventDetail"
+                        }
+                    }
+                }
             }];
     }
     static get methods() {
@@ -2122,6 +2442,23 @@ export class PdsMultiselect {
                     "text": "Clears all selected values and resets the component.",
                     "tags": []
                 }
+            },
+            "refreshOptions": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Refetches the first page of options from `asyncUrl` for the current search, such as after an option is renamed\nor recolored elsewhere. Selected items in that page pick up the new text and dot color without emitting a change;\nother selected items keep the text and dot color they were last loaded with. Does nothing without `asyncUrl`.",
+                    "tags": []
+                }
             }
         };
     }
@@ -2139,6 +2476,12 @@ export class PdsMultiselect {
             }, {
                 "propName": "internalOptions",
                 "methodName": "internalOptionsChanged"
+            }, {
+                "propName": "isOpen",
+                "methodName": "isOpenChanged"
+            }, {
+                "propName": "disabled",
+                "methodName": "disabledChanged"
             }];
     }
     static get listeners() {