@nova-design-system/nova-react 3.0.0-beta.43 → 3.0.0-beta.44

package/dist/cjs/nv-fieldselect.entry-CFDqeR-D.js

@@ -0,0 +1,365 @@
+'use strict';
+
+var index = require('./index-CEWbQ5nh.js');
+var v4A79185f4 = require('./v4-a79185f4-2n0dOd_Y.js');
+require('react');
+
+const nvFieldselectCss = "nv-fieldselect{--nv-field-border-default:var(--components-form-field-border-default);--nv-field-border-hover:var(--components-form-field-border-hover);--nv-field-border-focus:var(--components-form-field-border-focus);--nv-field-border-disabled:var(--components-form-field-border-default);--nv-field-border-readonly:var(--components-form-field-border-default);--nv-field-focus-box-shadow:var(--color-focus-brand);--nv-field-background:var(--components-form-field-background-default);display:flex;flex-direction:column;align-items:flex-start;gap:var(--form-gap-y);box-sizing:border-box}nv-fieldselect[readonly]:not([readonly=false]){--nv-field-border-default:var(--components-form-field-border-readonly);--nv-field-border-hover:var(--nv-field-border-default);--nv-field-border-focus:var(--components-form-field-border-focus);--nv-field-border-disabled:var(--nv-field-border-default);--nv-field-border-readonly:var(--nv-field-border-default);--nv-field-background:var(--components-form-field-background-readonly)}nv-fieldselect[display-value]:not([display-value=false]){--nv-field-border-default:var(--components-form-field-border-readonly);--nv-field-border-hover:var(--nv-field-border-default);--nv-field-border-focus:var(--components-form-field-border-focus);--nv-field-border-disabled:var(--nv-field-border-default);--nv-field-border-readonly:var(--nv-field-border-default);--nv-field-background:var(--components-form-field-background-readonly)}nv-fieldselect[error]:not([error=false]){--nv-field-border-default:var(--components-form-field-border-error);--nv-field-border-hover:var(--nv-field-border-default);--nv-field-border-focus:var(--nv-field-border-default);--nv-field-border-disabled:var(--nv-field-border-default);--nv-field-border-readonly:var(--nv-field-border-default);--nv-field-focus-box-shadow:var(--color-focus-destructive)}nv-fieldselect[success]:not([success=false]){--nv-field-border-default:var(--components-form-field-border-success);--nv-field-border-hover:var(--nv-field-border-default);--nv-field-border-focus:var(--nv-field-border-default);--nv-field-border-disabled:var(--nv-field-border-default);--nv-field-border-readonly:var(--nv-field-border-default);--nv-field-focus-box-shadow:var(--color-focus-success)}nv-fieldselect[required]:not([required=false]) label::after{content:\"*\";color:var(--components-form-text-required);font-weight:700}nv-fieldselect[multiple]:not([multiple=false]) .select-wrapper>.select-container>.select-icons{top:var(--form-field-padding-y);right:var(--form-field-padding-x)}nv-fieldselect[multiple]:not([multiple=false]) .select-wrapper>.select-container>select{height:100%;box-sizing:border-box}nv-fieldselect label{display:flex;align-items:center;gap:var(--form-label-gap);align-self:stretch;color:var(--components-form-text-label-default);font-family:\"TT Norms Pro\", sans-serif;font-size:var(--form-label-font-size);font-style:normal;font-weight:500;line-height:var(--form-label-line-height)}nv-fieldselect .select-wrapper{display:flex;flex-wrap:wrap;align-items:stretch;align-self:stretch}nv-fieldselect .select-wrapper .select-container{position:relative;display:flex;flex-grow:1;justify-content:center;align-items:center;align-self:stretch;border-radius:var(--form-field-radius);border-width:1px;border-style:solid;border-color:var(--nv-field-border-default);opacity:var(--components-form-opacity-default);background:var(--nv-field-background);transition:all 150ms ease-out}nv-fieldselect .select-wrapper .select-container:hover{border-color:var(--nv-field-border-hover)}nv-fieldselect .select-wrapper .select-container:focus-within{border-color:var(--nv-field-border-focus);box-shadow:0 0 0 var(--focus-field-stroke) var(--nv-field-focus-box-shadow)}nv-fieldselect .select-wrapper .select-container:has(select:disabled){opacity:0.5;background-color:var(--components-form-field-background-disabled);border-color:var(--nv-field-border-disabled)}nv-fieldselect .select-wrapper .select-container>.select-icons{position:absolute;right:0;top:0;pointer-events:none}nv-fieldselect .select-wrapper .select-container>.select-icons>nv-iconbutton{border:0px;border-radius:0px}nv-fieldselect .select-wrapper .select-container>.select-icons>nv-iconbutton:focus-visible{border-radius:var(--button-md-border-radius);outline-offset:-3px}nv-fieldselect .select-wrapper .select-container input{display:flex;align-items:center;flex:1 0 0;overflow:hidden;background-color:transparent;color:var(--components-form-field-content-text);padding:var(--form-field-padding-y) var(--form-field-padding-x);font-size:var(--form-field-font-size);font-style:normal;font-weight:500;line-height:var(--form-field-line-height)}nv-fieldselect .select-wrapper .select-container input:focus{outline:none}nv-fieldselect .select-wrapper .select-container input::placeholder{overflow:hidden;color:var(--components-form-field-content-placeholder);text-overflow:ellipsis;font-family:\"TT Norms Pro\", sans-serif;font-size:var(--form-field-font-size);font-style:normal;font-weight:400;line-height:var(--form-field-line-height)}nv-fieldselect .select-wrapper .select-container input:read-only{opacity:0.5;background-color:var(--components-form-field-background-readonly, rgba(0, 0, 0, 0.1));border-color:var(--nv-field-border-readonly)}nv-fieldselect .select-wrapper .select-container select{display:flex;align-items:center;flex:1 0 0;overflow:hidden;background-color:transparent;color:var(--components-form-field-content-text);text-overflow:ellipsis;font-size:var(--form-field-font-size);font-style:normal;font-weight:500;height:var(--form-field-line-height);padding:var(--form-field-padding-y) var(--form-field-padding-x);box-sizing:content-box;-webkit-appearance:none;-moz-appearance:none;cursor:pointer}nv-fieldselect .select-wrapper .select-container select:focus{outline:none}nv-fieldselect .select-wrapper .select-container select::placeholder{overflow:hidden;color:var(--components-form-field-content-placeholder);text-overflow:ellipsis;font-family:\"TT Norms Pro\", sans-serif;font-size:var(--form-field-font-size);font-style:normal;font-weight:400;line-height:var(--form-field-line-height)}nv-fieldselect .select-wrapper .select-container select option{font-size:var(--form-field-font-size, 16px);font-style:normal;font-weight:500;line-height:var(--form-field-line-height, 24px)}nv-fieldselect .select-wrapper .select-container select.hidden{display:none}nv-fieldselect .select-wrapper .select-container nv-icon.readonly-icon{color:var(--nv-field-border-default)}nv-fieldselect .select-wrapper .select-container nv-icon.validation{color:var(--nv-field-border-default)}nv-fieldselect .description{align-self:stretch;color:var(--components-form-text-description-default);font-family:\"TT Norms Pro\", sans-serif;font-size:var(--form-description-font-size);font-style:normal;line-height:var(--form-description-line-height)}nv-fieldselect .error-description{align-self:stretch;color:var(--components-form-text-description-default);font-family:\"TT Norms Pro\", sans-serif;font-size:var(--form-description-font-size);font-style:normal;line-height:var(--form-description-line-height);color:var(--components-form-text-description-error)}";
+const NvFieldselectStyle0 = nvFieldselectCss;
+
+const NvFieldselect = class {
+    constructor(hostRef) {
+        index.registerInstance(this, hostRef);
+        this.valueChanged = index.createEvent(this, "valueChanged");
+        //#endregion DEPRECATED
+        /****************************************************************************/
+        //#region STATES
+        this.computedDisplayValue = '';
+        this.internalReadonly = false;
+        /**
+         * Parsed options stored internally
+         */
+        this.parsedOptions = [];
+        //#endregion STATES
+        /****************************************************************************/
+        //#region PROPERTIES
+        /**
+         * Sets the ID for the select element and the for attribute of the associated
+         * label. If no ID is provided, a random one will be automatically generated
+         * to ensure unique identification, facilitating proper label association and
+         * accessibility.
+         */
+        this.inputId = v4A79185f4.v4();
+        /**
+         * The disabled prop lets you turn off the select field so that users can’t
+         * choose something. When disabled, the field is grayed out and won’t respond to
+         * clicks or touches.
+         */
+        this.disabled = false;
+        /**
+         * Display the select field’s content without allowing users to change it.
+         * Users can still click on it, select, and copy the text, but they won’t be
+         * able to change or delete anything.
+         */
+        this.readonly = false;
+        /**
+         * Marks the select field as required, ensuring that the user must fill it out
+         * before submitting the form.
+         */
+        this.required = false;
+        /**
+         * Alters the select field’s appearance to indicate an error, helping users
+         * identify fields that need correction.
+         * @validator error
+         */
+        this.error = false;
+        /**
+         * Changes the select field’s appearance to indicate successful input or
+         * validation.
+         */
+        this.success = false;
+        /**
+         * When enabled, allows the select to handle multiple selections.
+         */
+        this.multiple = false;
+        /**
+         * The value of the select field.
+         * - If `multiple` is `false`, it's a single string.
+         * - If `multiple` is `true`, it's a comma-separated string of selected values.
+         */
+        this.value = '';
+        /**
+         * When enabled, displays the value element instead of the label when readonly.
+         * By default, the label is displayed in readonly mode. Also it automatically
+         * sets the component to readonly.
+         */
+        this.displayValue = false;
+        /**
+         * Applies focus to the input field as soon as the component is mounted. This
+         * is equivalent to setting the native autofocus attribute on a <select>
+         * element.
+         */
+        this.autofocus = false;
+        //#endregion WATCHERS
+        /****************************************************************************/
+        //#region METHODS
+        /**
+         * Handles the change event on the select element. This method is used to
+         * update the value property when the selected options change. It is also
+         * used to emit the selectChanged event when the selected value changes.
+         * @param {Event} event - The change event on the select element.
+         * @emits selectChanged
+         */
+        this.handleSelectChange = (event) => {
+            const select = event.target;
+            let selectedValues = Array.from(select.selectedOptions).map(option => option.value);
+            if (!this.multiple) {
+                selectedValues = selectedValues.slice(0, 1);
+            }
+            this.value = this.multiple
+                ? selectedValues.join(', ')
+                : selectedValues[0] || '';
+            this.valueChanged.emit(this.value);
+            // Update form value
+            this.setFormValue();
+        };
+        /**
+         * Handles focus when the select container is clicked.
+         */
+        this.handleSelectContainerClick = () => {
+            if (!this.internalReadonly && this.selectElement) {
+                this.selectElement.focus();
+            }
+        };
+    }
+    //#endregion EVENTS
+    /****************************************************************************/
+    //#region WATCHERS
+    /**
+     * Updates the display value when the value property changes. This watcher is
+     * used to update the display value when the selected value changes. This is
+     * necessary for readonly select fields to display the selected value.
+     * @internal This watcher is not intended to be called outside of the component.
+     * @param {string} newValue - The new value of the select field.
+     */
+    updateDisplayValueWatcher(newValue) {
+        this.updateDisplayValue();
+        if (this.selectElement) {
+            const selectedValues = newValue.split(',').map(val => val.trim());
+            const options = this.selectElement.options;
+            if (options) {
+                Array.from(options).forEach(option => {
+                    option.selected = this.multiple
+                        ? selectedValues.includes(option.value)
+                        : option.value === selectedValues[0];
+                });
+                if (!this.multiple) {
+                    this.selectElement.value = newValue; // Only set when not multiple
+                }
+            }
+            else {
+                this.selectElement.value = selectedValues[0] || '';
+            }
+        }
+        // Update form value
+        this.setFormValue();
+    }
+    /**
+     * Watcher for the displayValue prop to ensure internalReadonly is true when displayValue is true.
+     * @param {boolean} newValue - The new value of displayValue.
+     */
+    handleDisplayValueChange(newValue) {
+        this.internalReadonly = newValue; // Set internalReadonly to true if displayValue is true
+        if (this.readonly) {
+            this.internalReadonly = true;
+        }
+    }
+    /**
+     * Watcher for the readonly prop to ensure internalReadonly is true when readonly is true.
+     * @param {boolean} newValue - The new value of readonly.
+     */
+    handleReadonlyChange(newValue) {
+        this.internalReadonly = newValue; // Set internalReadonly to true if displayValue is true
+        if (this.displayValue) {
+            this.internalReadonly = true;
+        }
+    }
+    /**
+     * Parse options and update the internal state
+     * @param {string} newValue - The new value of options
+     */
+    handleOptionsChange(newValue) {
+        if (typeof newValue === 'string') {
+            try {
+                const parsedOpts = JSON.parse(newValue);
+                this.parsedOptions = [...parsedOpts];
+                // Update the value if an option is pre-selected
+                const selectedOption = parsedOpts.find(opt => opt.selected);
+                if (selectedOption) {
+                    this.value = selectedOption.value;
+                }
+            }
+            catch (error) {
+                console.error('Error parsing options:', error);
+                this.parsedOptions = [];
+            }
+        }
+    }
+    /**
+     * Updates the display value of the select field. This method is used to
+     * update the display value when the selected value changes. This is necessary
+     * for readonly select fields to display the selected value. This method is
+     * called in the componentDidLoad lifecycle hook and the updateDisplayValueWatcher
+     * watcher.
+     * @internal This method is not intended to be called outside of the component.
+     */
+    updateDisplayValue() {
+        if (this.internalReadonly && !this.displayValue) {
+            if (this.multiple) {
+                const selectedLabels = this.value
+                    .split(',')
+                    .map(key => key.trim())
+                    .map(key => this.getLabelFromId(key) || '')
+                    .filter(label => label !== '');
+                this.computedDisplayValue = selectedLabels.join(', ') || '';
+            }
+            else {
+                this.computedDisplayValue = this.getLabelFromId(this.value) || '';
+            }
+        }
+        else if (this.internalReadonly && this.displayValue) {
+            this.computedDisplayValue = this.value || '';
+        }
+    }
+    /**
+     * Retrieves the label from the <option> elements based on the provided key (value).
+     * This method uses the id or value attribute directly from the <select> options.
+     * @param {string} key - The key (value) for which to find the corresponding label.
+     * @returns {string} The label if found; otherwise, an empty string.
+     */
+    getLabelFromId(key) {
+        this.ensureSelectElement();
+        if (!this.selectElement) {
+            return '';
+        }
+        // Cache the option list
+        const options = this.selectElement.options;
+        if (options) {
+            const option = Array.from(options).find(option => option.value === key);
+            return option ? option.textContent.trim() || '' : '';
+        }
+        else {
+            return '';
+        }
+    }
+    /**
+     * Sets the value of the form element for form submission. This method is
+     * called when the selected value changes or when the value property is set.
+     * @internal This method is not intended to be called outside of the component.
+     */
+    setFormValue() {
+        this.internals.setFormValue(this.value);
+    }
+    /**
+     * Ensures the select element is available. This method is used to ensure
+     * the select element is available before attempting to access it.
+     * @internal This method is not intended to be called outside of the component.
+     */
+    ensureSelectElement() {
+        if (!this.selectElement) {
+            this.selectElement = this.el.querySelector('select');
+        }
+    }
+    //#endregion METHODS
+    /****************************************************************************/
+    //#region LIFECYCLE
+    componentWillRender() {
+        this.updateDisplayValue(); // Ensure display value is updated before render
+        if (this.message) {
+            this.description = this.message;
+        }
+        if (this.validation) {
+            this.errorDescription = this.validation;
+            this.error = true;
+        }
+    }
+    /**
+     * Lifecycle method that is called before the component is rendered. This is
+     * where the internal state is set up before rendering occurs.
+     */
+    componentWillLoad() {
+        // Set internalReadonly based on the readonly prop
+        this.internalReadonly = this.readonly;
+        // Ensure internalReadonly is true if displayValue is true during loading
+        if (this.displayValue) {
+            this.internalReadonly = true;
+        }
+        if ('attachInternals' in this.el) {
+            this.internals = this.el.attachInternals();
+        }
+        else {
+            // Fallback logic for browsers without attachInternals support
+            this.internals = {
+                setFormValue: (value) => {
+                    const formElement = this.el.closest('form');
+                    if (formElement) {
+                        const input = document.createElement('input');
+                        input.type = 'hidden';
+                        input.name = this.name;
+                        input.value = value;
+                        formElement.appendChild(input);
+                    }
+                },
+            };
+        }
+        // Initialize value as an empty string if multiple is true
+        if (this.multiple && typeof this.value !== 'string') {
+            this.value = '';
+        }
+        // Parse initial options if present
+        if (this.options) {
+            this.handleOptionsChange(this.options);
+        }
+    }
+    /**
+     * Lifecycle method that is called after the component has been rendered.
+     * This is where the display value is updated and the initial select element's
+     * state is set.
+     */
+    componentDidLoad() {
+        this.updateDisplayValue();
+        if (this.selectElement) {
+            // Only set the value for single selection, skip for multiple
+            if (!this.multiple) {
+                this.selectElement.value = this.value;
+            }
+            const selectedValues = this.multiple
+                ? this.value.split(',').map(v => v.trim())
+                : [this.value];
+            const options = this.selectElement.options;
+            if (options) {
+                Array.from(options).forEach(option => {
+                    option.selected = this.multiple
+                        ? selectedValues.includes(option.value)
+                        : option.value === selectedValues[0];
+                });
+            }
+            else {
+                // Handle case where there are no options
+                this.selectElement.value = selectedValues[0] || '';
+            }
+        }
+        // Set the initial form value
+        this.setFormValue();
+    }
+    //#endregion LIFECYCLE
+    /****************************************************************************/
+    //#region RENDERING
+    /**
+     * The render method creates the HTML structure for the component, including
+     * the label, select element, and any error or description messages. It also
+     * applies the appropriate CSS classes based on the readonly state and
+     * displayValue prop. This method is called when the component is rendered.
+     * @returns {HTMLStencilElement} The HTML element to render.
+     */
+    render() {
+        return (index.h(index.Host, { key: '017364e5a5df156be42741e3acc4457414f8e6ee' }, (this.label || this.el.querySelector('[slot="label"]')) && (index.h("label", { key: '2e4b247018a759307ea5e3920a4066a2c1c14e92', htmlFor: this.inputId }, index.h("slot", { key: '1bbad9d0b4be9fc35c0cc63859ba6dcdb4375377', name: "label" }, this.label))), index.h("div", { key: '572073518f738014fd27d8de84fc856a01889636', class: "select-wrapper" }, index.h("slot", { key: '490730d4fc16f78284a8ca40ab952870eb01b503', name: "before-input" }), index.h("div", { key: 'a92ea3295f64ce1c6d8da5cf439d7c796493fdf5', class: "select-container", onClick: this.handleSelectContainerClick }, index.h("slot", { key: 'f80e732415ec42a4c7b02922f1b50d2cf3950e88', name: "leading-input" }), this.internalReadonly && (index.h("input", { key: 'b1ee7e799434d0e36d1f98031338137347bcedea', id: this.inputId + '-readonly', type: "text", value: this.computedDisplayValue, readonly: true, class: "readonly-input", "aria-readonly": "true", "aria-label": this.label, "aria-describedby": this.error
+                ? `${this.inputId}-error`
+                : `${this.inputId}-description` })), index.h("select", { key: '9a8b48a7a41522b09b65a5c76b7e861b5d6eef49', id: this.inputId, ref: el => (this.selectElement = el), name: this.name, autofocus: this.autofocus, disabled: this.disabled, required: this.required, multiple: this.multiple, onChange: this.handleSelectChange, class: this.internalReadonly ? 'hidden' : '', "aria-label": this.label, "aria-describedby": this.error
+                ? `${this.inputId}-error`
+                : `${this.inputId}-description` }, this.parsedOptions.length > 0 ? (this.parsedOptions.map(option => (index.h("option", { value: option.value, selected: option.selected, disabled: option.disabled }, option.label)))) : (index.h("slot", null))), index.h("div", { key: '7ecac0a159ca2b4925b8a940c80f8aef94a2ca1d', class: "select-icons" }, this.error && (index.h("nv-icon", { key: 'fd3d75a5c621a49f45550d9596f4910ef01a56b2', name: "alert-circle", class: "validation", size: "md" })), this.success && (index.h("nv-icon", { key: '45b3e11a48f5f700ac9c21ba276ee9c93640d0d9', name: "circle-check", class: "validation", size: "md" })), !this.multiple && (index.h("nv-iconbutton", { key: '07171fbe1fc88f4c7af0513ed718376ce1a1aeb3', name: "chevron-down", size: "md", emphasis: "lower", tabIndex: -1 })))), index.h("slot", { key: '096bf49c55359062fc790d31660b331a5988ad22', name: "after-input" })), (this.description ||
+            this.el.querySelector('[slot="description"]')) && (index.h("div", { key: '7b292eeb3a1ca29b7cb1b631926b591183ab50fc', class: "description", id: `${this.inputId}-description` }, index.h("slot", { key: 'a2fdc1929f7aa2571cd11d01e2c1ed165afb856c', name: "description" }, this.description))), (this.errorDescription ||
+            this.el.querySelector('[slot="error-description"]')) && (index.h("div", { key: '3d189e87ff7cee9a43ccad85c6e84fcdb3343f1f', class: "error-description", id: `${this.inputId}-error` }, index.h("slot", { key: '515059b75c8e2c1e600a28124135cbd7af87ccbf', name: "error-description" }, this.errorDescription)))));
+    }
+    static get formAssociated() { return true; }
+    get el() { return index.getElement(this); }
+    static get watchers() { return {
+        "value": ["updateDisplayValueWatcher"],
+        "displayValue": ["handleDisplayValueChange"],
+        "readonly": ["handleReadonlyChange"],
+        "options": ["handleOptionsChange"]
+    }; }
+};
+NvFieldselect.style = NvFieldselectStyle0;
+
+exports.nv_fieldselect = NvFieldselect;