lightning-base-components 1.27.5-alpha → 1.28.3-alpha

package/src/lightning/picklist/picklist.js

@@ -9,22 +9,16 @@ import labelChosen from '@salesforce/label/LightningPicklist.chosen';
 import { api } from 'lwc';
 import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
 import { normalizeBoolean, arraysEqual } from 'lightning/utilsPrivate';
-// eslint-disable-next-line @lwc/lwc/ssr-no-form-factor
 import formFactor from '@salesforce/client/formFactor';
-
 const i18n = {
     noneLabel: labelNoneLabel,
     available: labelAvailable,
     chosen: labelChosen,
 };
 const PROGRAMMATIC_CHANGE = true;
-
 export default class LightningPicklist extends LightningShadowBaseClass {
     static delegatesFocus = true;
-
-    // The value that is passed into the sub-components. dual-listbox accepts an array whereas combobox expects a string
     _internalValue;
-    // The value (String) returned by the picklist. In the multi case, the values are separated by a semicolon
     _picklistValue;
     _options;
     _required = false;
@@ -33,14 +27,18 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     _size = 4;
     _showActivityIndicator = false;
     _fieldLevelHelp;
-
-    @api label;
-    @api name;
-    @api placeholder;
-    @api variant;
-    @api autocomplete = 'off';
-    @api suppressNoneOption;
-
+    @api
+    label;
+    @api
+    name;
+    @api
+    placeholder;
+    @api
+    variant;
+    @api
+    autocomplete = 'off';
+    @api
+    suppressNoneOption;
     set fieldLevelHelp(value) {
         this._fieldLevelHelp = value;
     }
@@ -48,10 +46,8 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get fieldLevelHelp() {
         return this._fieldLevelHelp;
     }
-
     set value(newValue) {
         this._picklistValue = newValue;
-
         if (this.connected) {
             this.updateInternalValue(newValue, PROGRAMMATIC_CHANGE);
         }
@@ -60,8 +56,6 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get value() {
         return this._picklistValue;
     }
-
-    // only works for multi-select picklists
     set size(value) {
         this._size = this.normalizeSize(value);
     }
@@ -69,10 +63,8 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get size() {
         return this._size;
     }
-
     set options(newOptions) {
         this._options = newOptions;
-
         if (this.connected) {
             this.updatePicklistOptions(newOptions);
         }
@@ -81,7 +73,6 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get options() {
         return this._options;
     }
-
     set multiple(value) {
         this._multiple = normalizeBoolean(value);
     }
@@ -89,40 +80,29 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get multiple() {
         return this._multiple || false;
     }
-
     set required(value) {
         this._required = normalizeBoolean(value);
-        // reset the flag that hides the required indicator when we have no options
         this._requiredButDisabled = false;
     }
-
     @api
     get required() {
         return this._required;
     }
-
     set disabled(value) {
         this._disabled = normalizeBoolean(value);
-
-        // There are two ways a picklist could end up in a disabled state:
-        // 1- explicitly setting disabled and 2- when the picklist has no options
-        // If the element is explicitly set to be disabled, it should always remain disabled even when new options are provided
         this._externalDisabled = value;
     }
     @api
     get disabled() {
         return this._disabled;
     }
-
     @api
     get readOnly() {
         return this._readOnly;
     }
-
     set readOnly(value) {
         this._readOnly = normalizeBoolean(value);
     }
-
     set showActivityIndicator(value) {
         this._showActivityIndicator = normalizeBoolean(value);
     }
@@ -130,303 +110,227 @@ export default class LightningPicklist extends LightningShadowBaseClass {
     get showActivityIndicator() {
         return this._showActivityIndicator || false;
     }
-
     connectedCallback() {
         super.connectedCallback();
         this.updatePicklistOptions(this._options, true);
-
         this.connected = true;
     }
-
     disconnectedCallback() {
         this.connected = false;
     }
-
     @api
     focus() {
         if (this.connected) {
             this.getElement.focus();
         }
     }
-
     @api
     blur() {
         if (this.connected) {
             this.getElement.blur();
         }
     }
-
     @api
     get validity() {
         if (this.connected) {
             return this.getElement.validity;
         }
-
         return null;
     }
-
     @api
     checkValidity() {
         if (this.connected) {
             return this.validity.valid;
         }
-
         return false;
     }
-
     @api
     setCustomValidity(message) {
         if (this.connected) {
             this.getElement.setCustomValidity(message);
         }
     }
-
     @api
     reportValidity() {
         if (this.connected) {
             return this.getElement.reportValidity();
         }
-
         return false;
     }
-
     @api
     showHelpMessageIfInvalid() {
         if (this.connected) {
             this.getElement.showHelpMessageIfInvalid();
         }
     }
-
     get i18n() {
         return i18n;
     }
-
     get internalValue() {
         return this._internalValue !== undefined
             ? this._internalValue
             : this.getInternalValue(this._picklistValue);
     }
-
     updateInternalValue(value, isProgrammatic) {
         const oldInternalValue = this.internalValue;
         this._internalValue = this.getInternalValue(value);
-
         if (!this.isSameValue(value, oldInternalValue)) {
             this._picklistValue = this.getPicklistValue(value);
-
             this.dispatchChangeEvent(isProgrammatic);
         }
     }
-
     get getElement() {
         return !import.meta.env.SSR
-            ? this.template.querySelector(
-                  'lightning-combobox,lightning-dual-listbox,lightning-select'
-              )
+            ? this.template.querySelector('lightning-combobox,lightning-dual-listbox,lightning-select')
             : null;
     }
-
-    // disable reordering functionality on dual-listbox
     get disableReordering() {
         return true;
     }
-
     get isDesktop() {
         return formFactor === 'Large';
     }
-
     updatePicklistOptions(options, addMissingValues) {
         const newOptions = options ? [...options] : [];
         const existingInternalValue = this.internalValue;
-
         if (addMissingValues) {
             this.addMissingValuesToOptions(newOptions, existingInternalValue);
         }
-
         this.maybeAddNoneOption(newOptions);
         this._options = newOptions;
-
         this.updateDisabledState(options);
         this.updateRequiredState(options);
-
-        const value = this.getValueToSelect(
-            this.options,
-            existingInternalValue
-        );
-
+        const value = this.getValueToSelect(this.options, existingInternalValue);
         this.updateInternalValue(value, PROGRAMMATIC_CHANGE);
     }
-
     isSameValue(value1, value2) {
         if (Array.isArray(value1) && Array.isArray(value2)) {
             const a = [...value1].sort();
             const b = [...value2].sort();
-
             return arraysEqual(a, b);
         }
         return value1 === value2;
     }
-
     handleChange(event) {
         event.preventDefault();
         event.stopPropagation();
-
         const newValue = event.target.value;
         this.updateInternalValue(newValue);
     }
-
     handleFocus() {
-        // eslint-disable-next-line @lwc/lwc/ssr-no-unsupported-properties
         this.dispatchEvent(new CustomEvent('focus'));
     }
-
     handleBlur() {
-        // eslint-disable-next-line @lwc/lwc/ssr-no-unsupported-properties
         this.dispatchEvent(new CustomEvent('blur'));
     }
-
     handleOpen() {
-        // fire internal event for some force components to leverage
-        // e.g. to display the spinner while loading more picklist values
-        // eslint-disable-next-line @lwc/lwc/ssr-no-unsupported-properties
         this.dispatchEvent(new CustomEvent('open'));
     }
-
     maybeAddNoneOption(options) {
         if (this.shouldAddNoneOption(options.length)) {
             this.addOption(options, this.i18n.noneLabel, '');
         }
     }
-
     addOption(options, label, value) {
         options.unshift({ label, value });
     }
-
     shouldDisablePicklist(options) {
         if (!options || options.length === 0) {
             return true;
         }
-
         return false;
     }
-
     shouldAddNoneOption(numberOfOptions) {
         if (this.multiple) {
             return false;
         }
-
-        // We could have set required=false if the picklist had no options, see updateDisabledState and updateRequiredState
         const isRequiredPicklist = this.required || this._requiredButDisabled;
-
-        if (
-            this.suppressNoneOption ||
-            (isRequiredPicklist && numberOfOptions === 1)
-        ) {
+        if (this.suppressNoneOption ||
+            (isRequiredPicklist && numberOfOptions === 1)) {
             return false;
         }
-
         return true;
     }
-
     updateDisabledState(options) {
         this._disabled =
             this._externalDisabled !== undefined
                 ? normalizeBoolean(this._externalDisabled)
                 : this.shouldDisablePicklist(options);
     }
-
     updateRequiredState(options) {
         const shouldDisable = this.shouldDisablePicklist(options);
         if (shouldDisable) {
             if (this._required) {
-                // when disabling the picklist, we should remove the required indicator
                 this._required = false;
                 this._requiredButDisabled = true;
             }
-
             if (this.connected && this.validity.valueMissing) {
-                // if we're disabling the picklist, we should make sure any existing valueMissing message is cleared
-                // eslint-disable-next-line @lwc/lwc/no-async-operation, @lwc/lwc/ssr-no-restricted-browser-globals
                 requestAnimationFrame(() => {
                     this.showHelpMessageIfInvalid();
                 });
             }
-        } else if (this._requiredButDisabled) {
-            // we now have some options and are not going to have a disabled picklist, so we'll put the required flag back to what it was before
+        }
+        else if (this._requiredButDisabled) {
             this._requiredButDisabled = false;
             this._required = true;
         }
     }
-
     getValueToSelect(options, existingValue) {
         if (!options || options.length === 0) {
             return this.multiple ? [] : '';
         }
-
         if (this.isValueInOptions(existingValue, options)) {
             return existingValue;
         }
         if (this.multiple) {
             return [];
         }
-
         if (this.shouldAddNoneOption([...options].length)) {
             return '';
         }
         return options[0].value;
     }
-
     isValueInOptions(value, options) {
         if (!options || options.length === 0) {
             return false;
         }
-
-        const valueIsInOptions = (valueToCheck) =>
-            options.some((option) => {
-                return option.value === valueToCheck;
-            });
-
+        const valueIsInOptions = (valueToCheck) => options.some((option) => {
+            return option.value === valueToCheck;
+        });
         let valueExists = false;
         if (Array.isArray(value)) {
             valueExists = value.every((valueToCheck) => {
                 return valueIsInOptions(valueToCheck);
             });
-        } else {
+        }
+        else {
             valueExists = valueIsInOptions(value);
         }
         return valueExists;
     }
-
-    // If values are missing from the options, we will add them to the options.
-    // However, since we don't have the label, the same value will be used as label
-    // See W-4829389
     addMissingValuesToOptions(newOptions, value) {
         if (!value || (Array.isArray(value) && value.length === 0)) {
             return;
         }
-
         const valueIsInOptions = (valueToCheck) => {
             return newOptions.some((option) => {
                 return option.value === valueToCheck;
             });
         };
-
         const maybeAddOption = (valueToCheck) => {
             if (!valueIsInOptions(valueToCheck)) {
-                // Since we don't have the label, we will use the value instead
                 this.addOption(newOptions, valueToCheck, valueToCheck);
             }
         };
-
         if (Array.isArray(value)) {
             value.forEach((valueToCheck) => {
                 maybeAddOption(valueToCheck);
             });
-        } else {
+        }
+        else {
             maybeAddOption(value);
         }
     }
-
     dispatchChangeEvent(isProgrammatic) {
         const detail = {
             value: this._picklistValue,
@@ -435,54 +339,37 @@ export default class LightningPicklist extends LightningShadowBaseClass {
             detail.programmatic = true;
         }
         if (!import.meta.env.SSR) {
-            this.dispatchEvent(
-                new CustomEvent('change', {
-                    composed: true,
-                    bubbles: true,
-                    detail,
-                })
-            );
+            this.dispatchEvent(new CustomEvent('change', {
+                composed: true,
+                bubbles: true,
+                detail,
+            }));
         }
     }
-
     getPicklistValue(value) {
-        // multi select picklists should have a ';' separated value string
         if (this.multiple && Array.isArray(value)) {
             return value.join(';');
         }
         return value;
     }
-
-    // This is the value that is passed into the subcomponents dual-listbox and combobox.
-    // In the case of dual-listbox, the component accepts an array of selected values.
     getInternalValue(value) {
         if (this.multiple) {
             if (Array.isArray(value)) {
                 return value;
             }
-            return (
-                (typeof value === 'string' &&
-                    value !== '' &&
-                    value.split(';')) ||
-                []
-            );
-        }
-
-        // When value is null, None option('') should be selected
+            return ((typeof value === 'string' &&
+                value !== '' &&
+                value.split(';')) ||
+                []);
+        }
         if (value == null) {
             return '';
         }
-
         return value;
     }
-
     normalizeSize(value) {
         const parsedValue = parseInt(value, 10);
-
         if (isNaN(parsedValue) || parsedValue < 3 || parsedValue > 10) {
-            // A picklist field can only have a size between 3 and 10 when created declaratively
-            // however, there seems to be cases where the size can be outside of this range.
-            // In such cases, we will use the default value instead of throwing an error
             return 4;
         }
         return parsedValue;

package/src/lightning/pill/__examples__/avatarPill/avatarPill.d.ts

@@ -0,0 +1,4 @@
+export default class AvatarPill extends LightningElement {
+}
+import { LightningElement } from 'lwc';
+//# sourceMappingURL=avatarPill.d.ts.map

package/src/lightning/pill/__examples__/avatarPill/avatarPill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatarPill.d.ts","sourceRoot":"","sources":["../../../../../../../modules/interop/pill/__examples__/avatarPill/avatarPill.js"],"names":[],"mappings":"AAEA;CAA2D;iCAF1B,KAAK"}

package/src/lightning/pill/__examples__/avatarPill/avatarPill.js

@@ -4,5 +4,5 @@
  * For full license text, see the LICENSE.txt file
  */
 import { LightningElement } from 'lwc';
-
-export default class AvatarPill extends LightningElement {}
+export default class AvatarPill extends LightningElement {
+}

package/src/lightning/pill/__examples__/basic/basic.d.ts

@@ -0,0 +1,6 @@
+export default class Basic extends LightningElement {
+    infoText: any;
+    handleRemove(): void;
+}
+import { LightningElement } from 'lwc';
+//# sourceMappingURL=basic.d.ts.map

package/src/lightning/pill/__examples__/basic/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../../../../../modules/interop/pill/__examples__/basic/basic.js"],"names":[],"mappings":"AAEA;IACI,cAAS;IAET,qBAEC;CACJ;iCARgC,KAAK"}

package/src/lightning/pill/__examples__/basic/basic.js

@@ -4,10 +4,8 @@
  * For full license text, see the LICENSE.txt file
  */
 import { LightningElement } from 'lwc';
-
 export default class Basic extends LightningElement {
     infoText;
-
     handleRemove() {
         this.infoText = 'Remove button was clicked';
     }

package/src/lightning/pill/__examples__/errorPill/errorPill.d.ts

@@ -0,0 +1,4 @@
+export default class ErrorPill extends LightningElement {
+}
+import { LightningElement } from 'lwc';
+//# sourceMappingURL=errorPill.d.ts.map

package/src/lightning/pill/__examples__/errorPill/errorPill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorPill.d.ts","sourceRoot":"","sources":["../../../../../../../modules/interop/pill/__examples__/errorPill/errorPill.js"],"names":[],"mappings":"AAEA;CAA0D;iCAFzB,KAAK"}

package/src/lightning/pill/__examples__/errorPill/errorPill.js

@@ -4,5 +4,5 @@
  * For full license text, see the LICENSE.txt file
  */
 import { LightningElement } from 'lwc';
-
-export default class ErrorPill extends LightningElement {}
+export default class ErrorPill extends LightningElement {
+}

package/src/lightning/pill/__examples__/iconPill/iconPill.d.ts

@@ -0,0 +1,4 @@
+export default class IconPill extends LightningElement {
+}
+import { LightningElement } from 'lwc';
+//# sourceMappingURL=iconPill.d.ts.map

package/src/lightning/pill/__examples__/iconPill/iconPill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconPill.d.ts","sourceRoot":"","sources":["../../../../../../../modules/interop/pill/__examples__/iconPill/iconPill.js"],"names":[],"mappings":"AAEA;CAAyD;iCAFxB,KAAK"}

package/src/lightning/pill/__examples__/iconPill/iconPill.js

@@ -4,5 +4,5 @@
  * For full license text, see the LICENSE.txt file
  */
 import { LightningElement } from 'lwc';
-
-export default class IconPill extends LightningElement {}
+export default class IconPill extends LightningElement {
+}

package/src/lightning/pill/__examples__/plainLink/plainLink.d.ts

@@ -0,0 +1,4 @@
+export default class PlainLinkPill extends LightningElement {
+}
+import { LightningElement } from 'lwc';
+//# sourceMappingURL=plainLink.d.ts.map

package/src/lightning/pill/__examples__/plainLink/plainLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plainLink.d.ts","sourceRoot":"","sources":["../../../../../../../modules/interop/pill/__examples__/plainLink/plainLink.js"],"names":[],"mappings":"AAEA;CAA8D;iCAF7B,KAAK"}

package/src/lightning/pill/__examples__/plainLink/plainLink.js

@@ -4,5 +4,5 @@
  * For full license text, see the LICENSE.txt file
  */
 import { LightningElement } from 'lwc';
-
-export default class PlainLinkPill extends LightningElement {}
+export default class PlainLinkPill extends LightningElement {
+}

package/src/lightning/pill/pill.d.ts

@@ -0,0 +1,58 @@
+export const relatedTarget: unique symbol;
+export default class LightningPill extends LightningShadowBaseClass {
+    set href(value: string);
+    get href(): string;
+    _href: any;
+    label: string;
+    name: string;
+    _role: any;
+    _ariaSelected: any;
+    _hasMedia: boolean;
+    _hasError: any;
+    _tabIndex: any;
+    _standardContainer: any;
+    _variant: any;
+    set variant(value: string);
+    get variant(): string;
+    _connected: boolean;
+    _dispatcher: () => void;
+    set hasError(value: boolean);
+    get hasError(): boolean;
+    checkMediaElement(): boolean;
+    _mediaElement: HTMLSlotElement;
+    renderedCallback(): void;
+    get isPlainLink(): boolean;
+    get isPlain(): boolean;
+    get isLink(): boolean;
+    set ariaSelected(value: any);
+    get ariaSelected(): any;
+    set role(value: any);
+    get role(): any;
+    get i18n(): {
+        pillError: string;
+        pillRemove: string;
+        pillWarning: string;
+    };
+    get hasHref(): boolean;
+    get labelElement(): Element;
+    _labelElement: Element;
+    get anchorElement(): HTMLAnchorElement;
+    _anchorElement: HTMLAnchorElement;
+    get removeButtonElement(): Element;
+    _removeButtonElement: Element;
+    get computedPillRemoveLabel(): string;
+    disconnectedCallback(): void;
+    handleClick(event: any): void;
+    handleRemoveClick(event: any): void;
+    handleRemove(event: any): void;
+    focusLink(): void;
+    focusRemove(): void;
+    updateLinkInfo(url: any): void;
+    _url: string;
+    dispatchBlurEvent(pillRelatedTarget: any): void;
+    _hasFocus: boolean;
+    handleFocus(event: any): void;
+    handleBlur(event: any): void;
+}
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+//# sourceMappingURL=pill.d.ts.map

package/src/lightning/pill/pill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pill.d.ts","sourceRoot":"","sources":["../../../../../modules/interop/pill/pill.js"],"names":[],"mappings":"AAmCA,0CAAqD;AAkBrD;IASI,wBAUC;IAdD,mBAGC;IAYD,WAAM;IAON,OAHU,MAAM,CAGL;IAMX,MAFU,MAAM,CAEN;IAEV,WAAa;IACb,mBAAqB;IACrB,mBAAwB;IACxB,eAAiB;IACjB,eAAiB;IACjB,wBAA0B;IAC1B,cAAgB;IAiBhB,2BAcC;IAnBD,sBAGC;IAkBD,oBAAmB;IACnB,wBAAuB;IAoBvB,6BAEC;IAND,wBAGC;IAKD,6BAOC;IALO,+BAAwD;IAMhE,yBAqBC;IAOD,2BAGC;IAED,uBAEC;IAED,sBAEC;IA0BD,6BAGC;IAPD,wBAGC;IAcD,qBAGC;IAPD,gBAGC;IAMD;;;;MAEC;IAED,uBAEC;IAED,4BAMC;IAJO,uBACoD;IAK5D,uCAKC;IAHO,kCAAsD;IAK9D,mCAOC;IALO,8BAEC;IAKT,sCAEC;IAgBD,6BAEC;IAED,8BAOC;IAED,oCAGC;IAED,+BAcC;IAMD,kBAMC;IAMD,oBAMC;IAED,+BAKC;IAHO,aAAwB;IAKhC,gDAUC;IATG,mBAAsB;IAW1B,8BAOC;IAMD,6BAOC;CACJ;qCApYoC,kCAAkC"}