lightning-base-components 1.27.5-alpha → 1.28.4-alpha

package/src/lightning/multiColumnSortingModal/multiColumnSortingModal.js

@@ -40,76 +40,51 @@ const i18n = {
     columnMovedUp,
     columnMovedDown,
 };
-
-// represents a rule that has not been configured with sorting settings
 const getEmptyRule = () => ({
     selectedColumn: undefined,
-    sortOrder: 'asc', // default sort order is set to 'ascending'
+    sortOrder: 'asc',
 });
-
-// base state: one rule that is not configured with sorting settings
 const initialRules = [getEmptyRule()];
-
 export default class MultiColumnSortingModal extends LightningModal {
-    @api dynamicCmp; // component reference to be dynamically rendered in modal-body
-    @api dynamicCmpEvents; // events for dynamic component
-    @api dynamicCmpAttributes; // attributes for dynamic component
-
-    // lightning-datatable instance
-    @api dtInstance;
+    @api
+    dynamicCmp;
+    @api
+    dynamicCmpEvents;
+    @api
+    dynamicCmpAttributes;
+    @api
+    dtInstance;
     size = 'small';
-    @track rules = initialRules;
-
-    // variable track if validation errors are present
+    @track
+    rules = initialRules;
     validInputs = true;
     _modalBody;
     _scrollToBottom = false;
     assistiveText = '';
-    // the index of the last changed rule for duplicate validation
     ruleIndexToSetLast = undefined;
-
     get i18n() {
         return i18n;
     }
-
-    /**
-     * On initial load, the modal will create rules based on the passed in attributes:
-     * 'sortedBy' and 'sortedDirection'
-     */
     connectedCallback() {
         const { sortedBy, sortedDirection } = this.dtInstance;
-        this.clearRules(); // reset rules
+        this.clearRules();
         if (Array.isArray(sortedBy) || Array.isArray(sortedDirection)) {
-            if (
-                sortedBy &&
+            if (sortedBy &&
                 sortedDirection &&
-                sortedBy.length === sortedDirection.length
-            ) {
-                const length = Math.min(sortedBy.length, 5); // 5 rules is the max limit
-                // Create rules based on sortedBy and sortedDirection
+                sortedBy.length === sortedDirection.length) {
+                const length = Math.min(sortedBy.length, 5);
                 for (let i = 0; i < length; i += 1) {
                     this.rules[i] = {
                         selectedColumn: sortedBy[i],
                         sortOrder: sortedDirection[i],
                     };
                 }
-                // set `isDupe` property on this.rules so renderedCallback can report validity
                 this.setDuplicates(this.rules);
             }
         }
     }
-
     renderedCallback() {
-        const {
-            comboboxInputs,
-            rules,
-            dynamicCmp,
-            dynamicCmpAttributes,
-            dynamicCmpEvents,
-            refs,
-        } = this;
-
-        // handling and configuring dynamically rendered element
+        const { comboboxInputs, rules, dynamicCmp, dynamicCmpAttributes, dynamicCmpEvents, refs, } = this;
         if (dynamicCmp) {
             if (dynamicCmpEvents) {
                 Object.entries(dynamicCmpEvents).forEach(([key, value]) => {
@@ -122,256 +97,141 @@ export default class MultiColumnSortingModal extends LightningModal {
                 });
             }
         }
-
         const duplicateEntryExists = rules.some((rule) => rule.isDupe);
-        const lastRuleSelected =
-            rules.length >= 1 &&
+        const lastRuleSelected = rules.length >= 1 &&
             rules[rules.length - 1].selectedColumn !== undefined;
-
-        // report validity if user has clicked on apply button, if there is a duplicate entry, or if the
-        // last rule was selected
-        if (
-            this.validationThroughApplyButton ||
+        if (this.validationThroughApplyButton ||
             duplicateEntryExists ||
-            lastRuleSelected
-        ) {
+            lastRuleSelected) {
             comboboxInputs.forEach((combobox, index) => {
-                combobox.setCustomValidity(
-                    rules[index].isDupe
-                        ? this.i18n.duplicateValueValidation
-                        : ''
-                );
+                combobox.setCustomValidity(rules[index].isDupe
+                    ? this.i18n.duplicateValueValidation
+                    : '');
             });
             this.reportValidity(comboboxInputs);
             this.validationThroughApplyButton = false;
         }
-
-        // scroll to appropriate element
         this.handleScrolling();
     }
-
-    // getter to get all `lightning-primitive-column-sorter` elements
     get columnSorters() {
-        return Array.from(
-            this.template.querySelectorAll('lightning-primitive-column-sorter')
-        );
+        return Array.from(this.template.querySelectorAll('lightning-primitive-column-sorter'));
     }
-
-    // getter to get all `lightning-combobox` elements from all the `lightning-primitive-column-sorter` elements
     get comboboxInputs() {
         return this.columnSorters.map((sorter) => sorter.combobox);
     }
-
-    // getter to get the `lightning-modal-body's` `[part='modal-body']`
     get modalBody() {
         if (!this._modalBody) {
-            this._modalBody = this.template.querySelector(
-                'lightning-modal-body'
-            ).shadowRoot.firstChild;
+            this._modalBody = this.template.querySelector('lightning-modal-body').shadowRoot.firstChild;
         }
         return this._modalBody;
     }
-
     get rulesWithData() {
         const { rules } = this;
         this.setDuplicates(rules);
         return rules.map((rule, index) => ({
             key: `sorter-${index}`,
-            ...rule, // sortOrder and selectedColumn
-            heading:
-                index === 0 ? i18n.firstRuleHeading : i18n.otherRuleHeading,
-            unselectedInitialRules:
-                rules.length <= 1 && rules[0].selectedColumn === undefined, // used to disable up/down movement when only 1 rule is configured
-            disabledTrash: rules.length < 2, // user should not be able to delete rules if there is only 1
+            ...rule,
+            heading: index === 0 ? i18n.firstRuleHeading : i18n.otherRuleHeading,
+            unselectedInitialRules: rules.length <= 1 && rules[0].selectedColumn === undefined,
+            disabledTrash: rules.length < 2,
         }));
     }
-
-    /**
-     * an additional 'value' property needs to be added for `lightning-combobox` in the
-     * `primitive-column-sorter` to function properly
-     */
     get processedColumns() {
-        const filteredColumns = this.dtInstance.columns.filter(
-            (column) => column.label && column.sortable
-        );
+        const filteredColumns = this.dtInstance.columns.filter((column) => column.label && column.sortable);
         const processedColumns = filteredColumns.map((column) => {
             return {
                 ...column,
-                value: column.fieldName, // Set the 'value' property to the same value as 'fieldName'
+                value: column.fieldName,
             };
         });
         return processedColumns;
     }
-
-    /**
-     * Text to indicate if the sorting rule limit has been reached.
-     */
     get ruleLimitText() {
         if (this.rules.length >= 5) {
             return i18n.ruleLimitReached;
         }
         return i18n.ruleLimit;
     }
-
-    /**
-     * inline style for the rule limit text;
-     */
     get ruleLimitTextStyle() {
         return this.ruleLimitText === i18n.ruleLimitReached
             ? 'color:#8C4B02;'
             : '';
     }
-
-    /**
-     * Disable the add new rule button
-     */
     get isAddRuleButtonDisabled() {
-        const unselectedRuleExists = this.rules.some(
-            (rule) => rule.selectedColumn === undefined
-        );
-
-        return (
-            unselectedRuleExists || this.rules.length >= 5 || !this.validInputs
-        );
+        const unselectedRuleExists = this.rules.some((rule) => rule.selectedColumn === undefined);
+        return (unselectedRuleExists || this.rules.length >= 5 || !this.validInputs);
     }
-
-    /**
-     * Disable the apply button
-     */
     get isApplyButtonDisabled() {
         const { sortedBy, sortedDirection } = this.dtInstance;
-
-        // Verify valid and matching lengths for sortedBy and sortedDirection
-        const isSortable =
-            Array.isArray(sortedBy) &&
+        const isSortable = Array.isArray(sortedBy) &&
             Array.isArray(sortedDirection) &&
             sortedBy.length === sortedDirection.length &&
             sortedBy.length === this.rules.length;
-
-        // Check if `this.rules` matches `sortedBy` and `sortedDirection`
-        const isSame =
-            isSortable &&
-            sortedBy.every(
-                (column, i) =>
-                    this.rules[i]?.selectedColumn === column &&
-                    this.rules[i]?.sortOrder === sortedDirection[i]
-            );
-
-        // Ensure there are at least two selected columns
-        const hasEnoughColumnsSelected =
-            this.rules.filter((rule) => rule.selectedColumn).length >= 1;
-
+        const isSame = isSortable &&
+            sortedBy.every((column, i) => this.rules[i]?.selectedColumn === column &&
+                this.rules[i]?.sortOrder === sortedDirection[i]);
+        const hasEnoughColumnsSelected = this.rules.filter((rule) => rule.selectedColumn).length >= 1;
         return !hasEnoughColumnsSelected || !this.validInputs || isSame;
     }
-
-    /**
-     * Disable the clear button
-     */
     get isClearButtonDisabled() {
         return this.rules[0].selectedColumn === undefined;
     }
-
-    /**
-     * Handles adding a new rule from the 'add rule' button
-     */
     handleAddRule() {
-        this._scrollToBottom = true; // scroll to new rule
+        this._scrollToBottom = true;
         this.rules.push(getEmptyRule());
     }
-
-    /**
-     * Handles the 'delete' event which is dispatched from `primitive-column-sorter` elements
-     */
     handleDeleteRule(event) {
         const ruleIndexToDelete = event.target.index;
         this.rules.splice(ruleIndexToDelete, 1);
-
-        // adjusting ruleIndexToSetLast if a rule with lower index was deleted
-        if (
-            this.ruleIndexToSetLast !== undefined &&
-            ruleIndexToDelete < this.ruleIndexToSetLast
-        ) {
+        if (this.ruleIndexToSetLast !== undefined &&
+            ruleIndexToDelete < this.ruleIndexToSetLast) {
             this.ruleIndexToSetLast--;
-        } else if (this.ruleIndexToSetLast === ruleIndexToDelete) {
-            // clear ruleIndexToSetLast if the deleted rule was the last changed rule
+        }
+        else if (this.ruleIndexToSetLast === ruleIndexToDelete) {
             this.ruleIndexToSetLast = undefined;
         }
-
-        // Update 'isDupe' property
         this.setDuplicates(this.rules);
     }
-
-    /**
-     * Handles the 'selection' event which is dispatched from `primitive-column-sorter` elements
-     */
     handleSelectionChange(event) {
         const { index, selectedColumn, sortOrder } = event.detail;
-        // Get the existing rule object at the specified index
         const existingRule = this.rules[index];
         if (existingRule) {
-            const newColumnSelection =
-                existingRule.selectedColumn !== selectedColumn;
-            // Update the existing rule object with the new selectedColumn and sortOrder
+            const newColumnSelection = existingRule.selectedColumn !== selectedColumn;
             existingRule.selectedColumn = selectedColumn;
             existingRule.sortOrder = sortOrder;
             if (newColumnSelection) {
-                // set the index of the rule that was just changed
                 this.ruleIndexToSetLast = index;
-                // Update 'isDupe' property
                 this.setDuplicates(this.rules);
             }
         }
     }
-
-    /**
-     * Handles the 'moveup' or 'movedown' event which is dispatched from `primitive-column-sorter` elements
-     */
     handleRuleMovement(event) {
         const { rules } = this;
         const dir = event.type;
         const ruleIndexToMove = event.target.index;
-        const ruleIndexToSwitch =
-            dir === 'moveup' ? ruleIndexToMove - 1 : ruleIndexToMove + 1;
-
-        // Switch rules
+        const ruleIndexToSwitch = dir === 'moveup' ? ruleIndexToMove - 1 : ruleIndexToMove + 1;
         const tempRule = rules[ruleIndexToMove];
         rules[ruleIndexToMove] = rules[ruleIndexToSwitch];
         rules[ruleIndexToSwitch] = tempRule;
-
-        // screen reader annoucement logic
-        const column = this.processedColumns.find(
-            (col) => col.fieldName === tempRule.selectedColumn
-        );
+        const column = this.processedColumns.find((col) => col.fieldName === tempRule.selectedColumn);
         const columnLabel = column ? column.label : tempRule.selectedColumn;
-        // preserve undefined value so that it's communicated to screen reader
         const colLabelFiltered = columnLabel ? columnLabel : 'undefined';
-
-        // add column name to label
         if (features.enableA11yMultiColSortModal) {
             this.assistiveText = dir === 'moveup'
                 ? formatLabel(i18n.columnMovedUp, colLabelFiltered)
                 : formatLabel(i18n.columnMovedDown, colLabelFiltered);
-        } else {
+        }
+        else {
             const dirText = dir === 'moveup' ? 'moved up' : 'moved down';
             this.assistiveText = `Column ${columnLabel} ${dirText}`;
         }
     }
-
-    /**
-     * Dispatches the 'privateupdatecolsort' custom event to send selected data to parent component
-     * Also extracts sorting orders and columns from rules and cleaning anything 'undefined'
-     */
     applyRules() {
         const fieldNames = this.rules.map((rule) => rule.selectedColumn);
         const sortDirections = this.rules.map((rule) => rule.sortOrder);
-
-        // validation to ensure that there are no invalid inputs
         this.reportValidity(this.comboboxInputs);
         this.validationThroughApplyButton = true;
-
-        // only dispatch event with data if all inputs are valid
         if (this.validInputs) {
-            // Dispatch event from datatable
             const event = new CustomEvent('sort', {
                 detail: {
                     fieldNames,
@@ -380,11 +240,7 @@ export default class MultiColumnSortingModal extends LightningModal {
                 },
             });
             this.dtInstance.dispatchEvent(event);
-            // Construct toast
-            const toastMessage = this.getToastMessage(
-                fieldNames,
-                sortDirections
-            );
+            const toastMessage = this.getToastMessage(fieldNames, sortDirections);
             this.close({
                 event,
                 success: this.sendToast(toastMessage, 'success'),
@@ -392,60 +248,32 @@ export default class MultiColumnSortingModal extends LightningModal {
             });
         }
     }
-
     getToastMessage(fieldNames, sortDirections) {
-        // Method used to format the Toast notification's message
-        const capitalizeFirstLetter = (str) =>
-            str.charAt(0).toUpperCase() + str.slice(1);
-
-        // constructing and formatting the toast message
+        const capitalizeFirstLetter = (str) => str.charAt(0).toUpperCase() + str.slice(1);
         const message = fieldNames
-            .map(
-                (sortBy, index) =>
-                    `${capitalizeFirstLetter(sortBy)} (${
-                        sortDirections[index] === 'asc'
-                            ? i18n.ascending
-                            : i18n.descending
-                    })`
-            )
+            .map((sortBy, index) => `${capitalizeFirstLetter(sortBy)} (${sortDirections[index] === 'asc'
+            ? i18n.ascending
+            : i18n.descending})`)
             .join(', ');
         return formatLabel(i18n.multiColumnSortingToast, message);
     }
-
     sendToast(toastMessage, variant) {
         return () => {
-            Toast.show(
-                {
-                    label: toastMessage,
-                    mode: 'dismissible',
-                    variant,
-                },
-                this.dtInstance
-            );
+            Toast.show({
+                label: toastMessage,
+                mode: 'dismissible',
+                variant,
+            }, this.dtInstance);
         };
     }
-
-    /**
-     * Handles clearing all sorting rules from the modal from the 'clear' button
-     */
     clearRules() {
         this.rules = [getEmptyRule()];
         this.ruleIndexToSetLast = undefined;
     }
-
-    /**
-     * Handles closing the modal when the 'cancel' button is clicked
-     */
     cancelRules() {
         this.close();
     }
-
-    /**
-     * method to handle the scrolling to a newly added `lightning-primitive-column-sorter` or the
-     * first one with a validation error present
-     */
     handleScrolling() {
-        // scroll to the bottom for when new `lightning-primitive-column-sorters` are added
         const { comboboxInputs } = this;
         let modalBody;
         if (this._scrollToBottom) {
@@ -453,8 +281,6 @@ export default class MultiColumnSortingModal extends LightningModal {
             modalBody.scrollTop = modalBody.scrollHeight;
             this._scrollToBottom = false;
         }
-
-        // if there are errors present, auto-scroll to the first error
         for (let i = 0; i < comboboxInputs.length; i += 1) {
             const combobox = comboboxInputs[i];
             if (combobox.classList.contains('slds-has-error')) {
@@ -465,17 +291,9 @@ export default class MultiColumnSortingModal extends LightningModal {
             }
         }
     }
-
-    /**
-     * Helper function to check if there are duplicate `selectedColumn` properties for
-     * each of the entries in this.rules array. if there is, then that rule gets its `isDupe`
-     * property set to `true`.
-     * @param {Array} rules
-     */
     setDuplicates(rules) {
         const selectedColumns = new Set();
         const ruleIndexToSetLast = this.ruleIndexToSetLast;
-
         for (let i = 0; i < rules.length; i += 1) {
             if (ruleIndexToSetLast !== i) {
                 const { selectedColumn } = rules[i];
@@ -492,19 +310,8 @@ export default class MultiColumnSortingModal extends LightningModal {
         }
         return selectedColumns;
     }
-
-    /**
-     * This function will go through the list of `lightning-combobox`s and will reportValidity()
-     * on each to show the errors.
-     * Sets the `validInputs` property to track if all entries are valid or not
-     * @param {Array} comboboxInputs
-     */
     reportValidity(comboboxInputs) {
-        comboboxInputs.forEach(
-            (combobox) => combobox && combobox.reportValidity()
-        );
-        this.validInputs = comboboxInputs.every(
-            (combobox) => combobox && combobox.validity.valid
-        );
+        comboboxInputs.forEach((combobox) => combobox && combobox.reportValidity());
+        this.validInputs = comboboxInputs.every((combobox) => combobox && combobox.validity.valid);
     }
 }

package/src/lightning/navigation/navigation.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../modules/interop/navigation/navigation.js"],"names":[],"mappings":""}

package/src/lightning/navigation/navigation.js

@@ -3,12 +3,4 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-/**
- * `CurrentPageReference` gets a reference to the current page in Salesforce.
- *  Page URL formats can change in future releases.
- *  To future proof your apps, use page references instead of URLs.
- *  Use the page reference to create a deep link to the page.
- * `NavigationMixin` gets a reference to the navigation service.
- *  Use the navigation service to navigate to another page in the application and generate a URL for a page.
- */
 export { CurrentPageReference, NavigationMixin } from 'force/navigation';

package/src/lightning/numberUtils/numberUtils.d.ts

@@ -0,0 +1,19 @@
+export function toIsoDecimal(numberAsString: any): any;
+export function isValidNumber(numberAsString: any): boolean;
+export function fromIsoDecimal(numberAsString: any): string;
+export function increaseNumberByStep({ value, increment, step, fractionDigits, }: {
+    value: any;
+    increment: any;
+    step: any;
+    fractionDigits: any;
+}): any;
+export function calculateFractionDigitsFromStep(step: any): number;
+export function formatNumber(numberAsString: any, options: any): any;
+export function transformLocalizedNumberToIsoDecimal(numberAsString: any, separators: any): any;
+export function isValidNumberCharacter(character: any): boolean;
+export function stringifyNumber(value: string): string;
+export function hasValidNumberSymbol(value: any): boolean;
+export function hasValidNumberShortcut(value: any): boolean;
+export function expandShortcuts(isoValue: any): any;
+export function getDecimalPlaces(num: any): number;
+//# sourceMappingURL=numberUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numberUtils.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/numberUtils/numberUtils.js"],"names":[],"mappings":"AAiCA,uDAMC;AAED,4DAEC;AAED,4DAEC;AAGD;;;;;QAsBC;AAED,mEAiCC;AAED,qEA8CC;AAGD,gGAsBC;AAED,gEAEC;AAOD,uDAIC;AAED,0DAIC;AAED,4DAcC;AAGD,oDAyBC;AAiCD,mDAYC"}