@pine-ds/core 3.14.2 → 3.15.1

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

@@ -30,6 +30,10 @@ export class PdsMultiselect {
          * Debounce delay in milliseconds for search/fetch.
          */
         this.debounce = 300;
+        /**
+         * Timeout in milliseconds for async fetch requests.
+         */
+        this.fetchTimeout = 30000;
         /**
          * Maximum height of the dropdown before scrolling.
          */
@@ -62,6 +66,7 @@ export class PdsMultiselect {
         this.selectedItems = [];
         this.currentPage = 1;
         this.hasMore = false;
+        this.creating = false;
         // Flag to prevent focusout from closing during open transition
         this.isOpening = false;
         this.handleTriggerClick = () => {
@@ -294,6 +299,10 @@ export class PdsMultiselect {
             window.clearTimeout(this.fetchDebounceTimer);
             this.fetchDebounceTimer = undefined;
         }
+        if (this.fetchTimeoutTimer !== undefined) {
+            window.clearTimeout(this.fetchTimeoutTimer);
+            this.fetchTimeoutTimer = undefined;
+        }
         (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.abort();
         this.abortController = undefined;
     }
@@ -314,9 +323,25 @@ export class PdsMultiselect {
         // Ensure value is an array (may be string from HTML attribute)
         const valueArray = this.ensureValueArray();
         const allOptions = this.getAllOptions();
-        this.selectedItems = valueArray
-            .map(val => allOptions.find(opt => String(opt.id) === String(val)))
-            .filter((opt) => opt !== undefined);
+        // Map values to options, preserving existing selectedItems for values not yet in options
+        const newSelectedItems = [];
+        const existingItemsMap = new Map(this.selectedItems.map(item => [String(item.id), item]));
+        valueArray.forEach(val => {
+            // First try to find in available options
+            const option = allOptions.find(opt => String(opt.id) === String(val));
+            if (option) {
+                newSelectedItems.push(option);
+            }
+            else if (existingItemsMap.has(String(val))) {
+                // If not in options but exists in current selectedItems, preserve it
+                // This handles the case where async data hasn't loaded yet or newly created items
+                newSelectedItems.push(existingItemsMap.get(String(val)));
+            }
+            // Note: We don't create placeholders for values without matching options.
+            // This ensures selectedItems remains empty until options are actually loaded,
+            // which matches the expected behavior for preselected values.
+        });
+        this.selectedItems = newSelectedItems;
     }
     ensureValueArray() {
         // Handle JSON string values passed via HTML attribute
@@ -343,13 +368,22 @@ export class PdsMultiselect {
     getFilteredOptions() {
         const allOptions = this.getAllOptions();
         const query = this.searchQuery.toLowerCase();
-        return allOptions.filter(opt => {
+        const filtered = allOptions.filter(opt => {
             // Filter by search query only - don't filter out selected items
             if (query) {
                 return opt.text.toLowerCase().includes(query);
             }
             return true;
         });
+        // Add create option if enabled and no matches found
+        if (this.createUrl && this.searchQuery.trim() && filtered.length === 0) {
+            return [{
+                    id: '__create__',
+                    text: this.searchQuery.trim(),
+                    isCreateOption: true,
+                }];
+        }
+        return filtered;
     }
     updateFormValue() {
         var _a;
@@ -373,33 +407,79 @@ export class PdsMultiselect {
             }
         }
     }
+    getCsrfToken() {
+        // Use provided token if available
+        if (this.csrfToken) {
+            return this.csrfToken;
+        }
+        // Try to read from meta tag
+        const metaTag = document.querySelector('meta[name="csrf-token"]');
+        return (metaTag === null || metaTag === void 0 ? void 0 : metaTag.content) || null;
+    }
     async fetchOptions(query, page = 1) {
         var _a;
         if (!this.asyncUrl)
             return;
+        // Abort any pending request and clear existing timeout
         (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.abort();
+        if (this.fetchTimeoutTimer !== undefined) {
+            window.clearTimeout(this.fetchTimeoutTimer);
+            this.fetchTimeoutTimer = undefined;
+        }
         this.abortController = new AbortController();
         this.loading = true;
+        // Set up timeout for fetch request
+        this.fetchTimeoutTimer = window.setTimeout(() => {
+            var _a;
+            (_a = this.abortController) === null || _a === void 0 ? void 0 : _a.abort();
+            this.fetchTimeoutTimer = undefined;
+        }, this.fetchTimeout);
         try {
-            const url = new URL(this.asyncUrl, window.location.origin);
+            // Guard against malformed asyncUrl
+            let url;
+            try {
+                url = new URL(this.asyncUrl, window.location.origin);
+            }
+            catch (urlError) {
+                throw new TypeError(`Invalid asyncUrl: ${this.asyncUrl}`);
+            }
             if (this.asyncMethod === 'GET') {
                 url.searchParams.set('search', query);
                 url.searchParams.set('page', String(page));
             }
-            const response = await fetch(url.toString(), Object.assign({ method: this.asyncMethod, signal: this.abortController.signal, headers: {
-                    'Content-Type': 'application/json',
-                    'Accept': 'application/json',
-                } }, (this.asyncMethod === 'POST' && {
+            const csrfToken = this.getCsrfToken();
+            const headers = {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            };
+            if (csrfToken) {
+                headers['X-CSRF-Token'] = csrfToken;
+            }
+            const response = await fetch(url.toString(), Object.assign({ method: this.asyncMethod, signal: this.abortController.signal, headers }, (this.asyncMethod === 'POST' && {
                 body: JSON.stringify({ search: query, page }),
             })));
+            // Clear timeout on successful response
+            if (this.fetchTimeoutTimer !== undefined) {
+                window.clearTimeout(this.fetchTimeoutTimer);
+                this.fetchTimeoutTimer = undefined;
+            }
             if (!response.ok)
                 throw new Error('Failed to fetch options');
             const data = await response.json();
             const formattedResults = data.results.map(item => {
+                // If formatResult is provided, use it
                 if (this.formatResult) {
                     return this.formatResult(item);
                 }
-                return Object.assign({ id: item.id, text: item.text }, item);
+                // Defensive check: ensure item is an object before spreading
+                if (typeof item === 'object' && item !== null) {
+                    return Object.assign({ id: item.id, text: item.text }, item);
+                }
+                // Handle primitives by converting to safe shape
+                return {
+                    id: String(item),
+                    text: String(item),
+                };
             });
             if (page === 1) {
                 this.internalOptions = formattedResults;
@@ -411,6 +491,11 @@ export class PdsMultiselect {
             this.currentPage = page;
         }
         catch (error) {
+            // Clear timeout on error
+            if (this.fetchTimeoutTimer !== undefined) {
+                window.clearTimeout(this.fetchTimeoutTimer);
+                this.fetchTimeoutTimer = undefined;
+            }
             if (error.name !== 'AbortError') {
                 console.error('PdsMultiselect: Failed to fetch options', error);
             }
@@ -419,6 +504,64 @@ export class PdsMultiselect {
             this.loading = false;
         }
     }
+    async createOption(query) {
+        if (!this.createUrl || !query.trim())
+            return;
+        // Reentrancy guard: prevent duplicate POSTs if creation is already in-flight
+        if (this.creating)
+            return;
+        this.creating = true;
+        try {
+            const url = new URL(this.createUrl, window.location.origin);
+            const csrfToken = this.getCsrfToken();
+            const headers = {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            };
+            if (csrfToken) {
+                headers['X-CSRF-Token'] = csrfToken;
+            }
+            const response = await fetch(url.toString(), {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ text: query.trim() }),
+            });
+            if (!response.ok)
+                throw new Error('Failed to create option');
+            const data = await response.json();
+            const newOption = Object.assign({ id: data.id, text: data.text }, data);
+            // Add to internal options first
+            this.internalOptions = [...this.internalOptions, newOption];
+            // Select the new option
+            this.value = [...this.value, String(newOption.id)];
+            // Sync selected items to update display with new option
+            this.syncSelectedItems();
+            // Emit create event
+            this.pdsMultiselectCreate.emit({
+                query: query.trim(),
+                newOption,
+            });
+            // Emit change event with synced items
+            this.pdsMultiselectChange.emit({
+                values: this.value,
+                items: this.selectedItems,
+            });
+            // Clear search and keep dropdown open
+            this.searchQuery = '';
+            this.highlightedIndex = -1;
+            // Focus back on search input
+            requestAnimationFrame(() => {
+                var _a;
+                (_a = this.searchInputEl) === null || _a === void 0 ? void 0 : _a.focus();
+            });
+        }
+        catch (error) {
+            console.error('PdsMultiselect: Failed to create option', error);
+        }
+        finally {
+            this.creating = false;
+        }
+    }
     openDropdown() {
         if (this.disabled)
             return;
@@ -497,30 +640,33 @@ export class PdsMultiselect {
     }
     toggleOption(option) {
         var _a;
+        // Handle create option
+        if (option.isCreateOption) {
+            // Prevent multiple create calls while one is in-flight
+            if (!this.creating) {
+                this.createOption(this.searchQuery);
+            }
+            return;
+        }
         const isSelected = this.value.includes(String(option.id));
         if (isSelected) {
             // Remove from selection
-            const newValue = this.value.filter(v => v !== String(option.id));
-            this.value = newValue;
-            const newSelectedItems = this.selectedItems.filter(item => String(item.id) !== String(option.id));
-            this.pdsMultiselectChange.emit({
-                values: newValue,
-                items: newSelectedItems,
-            });
+            this.value = this.value.filter(v => v !== String(option.id));
         }
         else {
             // Add to selection
             if (this.maxSelections && this.value.length >= this.maxSelections) {
                 return;
             }
-            const newValue = [...this.value, String(option.id)];
-            this.value = newValue;
-            const newSelectedItems = [...this.selectedItems, option];
-            this.pdsMultiselectChange.emit({
-                values: newValue,
-                items: newSelectedItems,
-            });
+            this.value = [...this.value, String(option.id)];
         }
+        // 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,
+        });
         // Keep focus on search input, don't close dropdown
         (_a = this.searchInputEl) === null || _a === void 0 ? void 0 : _a.focus();
     }
@@ -542,13 +688,17 @@ export class PdsMultiselect {
         const hasSlottedLoading = !!this.el.querySelector('[slot="loading"]');
         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: "Find...", value: this.searchQuery, "aria-label": "Search options", "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 || 'Options', 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, "No options found")))), filteredOptions.map((option, index) => {
             const isSelected = valueArray.includes(String(option.id));
-            const isHighlighted = index === this.highlightedIndex;
+            const isCreateOption = option.isCreateOption;
+            const isHighlighted = index === this.highlightedIndex && !isCreateOption;
             const optionId = `${this.componentId}-option-${index}`;
+            const isCreateDisabled = isCreateOption && this.creating;
             return (h("li", { key: String(option.id), id: optionId, class: {
                     'pds-multiselect__option': true,
                     'pds-multiselect__option--highlighted': isHighlighted,
                     'pds-multiselect__option--selected': isSelected,
-                }, role: "option", "aria-selected": isSelected ? 'true' : 'false', "data-index": index, onMouseDown: this.handleOptionMouseDown(option), onMouseEnter: this.handleOptionMouseEnter(index) }, h("pds-checkbox", { componentId: `${this.componentId}-checkbox-${index}`, checked: isSelected, label: option.text, style: { pointerEvents: 'none' } })));
+                    'pds-multiselect__option--create': isCreateOption,
+                    'pds-multiselect__option--disabled': isCreateDisabled,
+                }, role: "option", "aria-selected": isSelected ? 'true' : 'false', "aria-disabled": isCreateDisabled ? 'true' : undefined, "aria-label": isCreateOption ? `Create new tag: ${option.text}` : undefined, "data-index": index, onMouseDown: this.handleOptionMouseDown(option), onMouseEnter: this.handleOptionMouseEnter(index) }, 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, "Add \"", option.text, "\""))) : (h("pds-checkbox", { componentId: `${this.componentId}-checkbox-${index}`, checked: isSelected, label: option.text, style: { pointerEvents: 'none' } }))));
         }), this.hasMore && !this.loading && (h("li", { class: "pds-multiselect__load-more", role: "presentation" }, h("pds-loader", { size: "small" }))))));
     }
     getTriggerText() {
@@ -560,19 +710,19 @@ export class PdsMultiselect {
     }
     render() {
         const hasSelections = this.selectedItems.length > 0;
-        return (h(Host, { key: 'e7d872fd9bedb03390eaf8a2bd9c5d6ba1cc7ecc', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '141dee3c657dd17d3389d4a25979d0f748e36361', class: "pds-multiselect" }, this.label && (h("label", { key: '386114a823424506857a1e927a2538e88d3c82f5', htmlFor: this.componentId, class: {
+        return (h(Host, { key: '5eabf872bf4e4f109106c0dd7f9fc8ea48e8c0c0', "aria-disabled": this.disabled ? 'true' : null }, h("div", { key: '2623280ddbb4e116da4dbf0fe9123b5f06f0da0c', class: "pds-multiselect" }, this.label && (h("label", { key: 'ec644a7af54ca4dcdece849c6df692fae268b445', htmlFor: this.componentId, class: {
                 'pds-multiselect__label': true,
                 'visually-hidden': this.hideLabel,
-            } }, this.label)), h("div", { key: '9fc18bf93f981ee7f72f31c20f43f5251ed647e4', class: "pds-multiselect__wrapper", ref: el => (this.containerEl = el), onFocusout: this.handleContainerFocusOut, style: { width: this.triggerWidth } }, h("button", { key: '74e8eb5ef5984307dce779ef63d54e49e07497ea', ref: el => (this.triggerEl = el), type: "button", class: {
+            } }, this.label)), h("div", { key: 'ae08d5be617ee801a730fd9289146e82f2df8258', class: "pds-multiselect__wrapper", ref: el => (this.containerEl = el), onFocusout: this.handleContainerFocusOut, style: { width: this.triggerWidth } }, h("button", { key: 'c4639d573de4bb7963f848284057afcf9cc65cb9', ref: el => (this.triggerEl = el), type: "button", 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,
-            }, 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.errorMessage || this.helperMessage), "aria-invalid": this.invalid || !!this.errorMessage ? 'true' : undefined, onClick: this.handleTriggerClick, onKeyDown: this.handleTriggerKeyDown }, h("span", { key: 'fb7f9b9fffd46839ddc4ab0bb549b61de191f76c', class: {
+            }, 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.errorMessage || this.helperMessage), "aria-invalid": this.invalid || !!this.errorMessage ? 'true' : undefined, onClick: this.handleTriggerClick, onKeyDown: this.handleTriggerKeyDown }, h("span", { key: 'b16da29ea9a98d6672813d9c142ef63135b12dca', class: {
                 'pds-multiselect__trigger-text': true,
                 'pds-multiselect__trigger-text--placeholder': !hasSelections,
-            } }, this.getTriggerText()), h("pds-icon", { key: '354e1c57758350d73557a6c94d0b31eb6732f12a', class: "pds-multiselect__icon", icon: enlarge })), this.renderDropdown()), this.helperMessage && !this.errorMessage && (h("p", { key: '3709f184a7972e1acfd3826faefc4ba139a8d518', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: '8029b58286455b7b4789a4336a79c324ca91ad74', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: 'cd781f3caed8b81deef2ce43f0a4406b6ed2d53c', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '7c303f4d64247b41b9e88892cfb8c02acd5d8d59', style: { display: 'none' } }, h("slot", { key: 'e9b384038e67bb951613933bbf68fd2b2efc71ef' })))));
+            } }, this.getTriggerText()), h("pds-icon", { key: '4e86739529355331c9fa6b95b63f223d5a315ad5', class: "pds-multiselect__icon", icon: enlarge })), this.renderDropdown()), this.helperMessage && !(this.errorMessage && this.errorMessage.length > 0) && (h("p", { key: '34cd42ddb1725546ce367699ef520e37d24cae25', class: "pds-multiselect__helper", id: messageId(this.componentId, 'helper') }, this.helperMessage)), this.errorMessage && (h("p", { key: '0eada43d1bcb44ea7b95927dd3f799aff6cc6b3a', class: "pds-multiselect__error", id: messageId(this.componentId, 'error') }, h("pds-icon", { key: '546dcc24794d274d73b3de867b79123b6f0069fc', icon: danger, size: "small" }), this.errorMessage)), h("div", { key: '3921e646c9e3638077c016e7cb28a19adaa302f0', style: { display: 'none' } }, h("slot", { key: '3923872eaae0a59da8c4a5b9801abf41ae9a3c3d' })))));
     }
     static get is() { return "pds-multiselect"; }
     static get encapsulation() { return "shadow"; }
@@ -763,6 +913,26 @@ export class PdsMultiselect {
                 "attribute": "debounce",
                 "defaultValue": "300"
             },
+            "fetchTimeout": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Timeout in milliseconds for async fetch requests."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "fetch-timeout",
+                "defaultValue": "30000"
+            },
             "maxSelections": {
                 "type": "number",
                 "mutable": false,
@@ -1023,6 +1193,44 @@ export class PdsMultiselect {
                 },
                 "getter": false,
                 "setter": false
+            },
+            "createUrl": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "URL endpoint for creating new options. When set, shows \"Add\" option when no matches found."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "create-url"
+            },
+            "csrfToken": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "CSRF token for authenticated requests. If not provided, attempts to read from meta tag."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "csrf-token"
             }
         };
     }
@@ -1034,7 +1242,8 @@ export class PdsMultiselect {
             "internalOptions": {},
             "selectedItems": {},
             "currentPage": {},
-            "hasMore": {}
+            "hasMore": {},
+            "creating": {}
         };
     }
     static get events() {
@@ -1101,6 +1310,27 @@ export class PdsMultiselect {
                         }
                     }
                 }
+            }, {
+                "method": "pdsMultiselectCreate",
+                "name": "pdsMultiselectCreate",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when a new option is created."
+                },
+                "complexType": {
+                    "original": "MultiselectCreateEventDetail",
+                    "resolved": "MultiselectCreateEventDetail",
+                    "references": {
+                        "MultiselectCreateEventDetail": {
+                            "location": "import",
+                            "path": "./multiselect-interface",
+                            "id": "src/components/pds-multiselect/multiselect-interface.ts::MultiselectCreateEventDetail"
+                        }
+                    }
+                }
             }];
     }
     static get methods() {