lightning-base-components 1.13.10-alpha → 1.14.4-alpha

package/src/lightning/primitiveDatatableStatusBar/primitiveDatatableStatusBar.html

@@ -2,6 +2,7 @@
     <div class="slds-docked-form-footer slds-is-absolute">
         <div class="slds-grid slds-grid_align-center">
             <template if:true={showError}>
+                <!-- Error Tooltip -->
                 <lightning-primitive-datatable-tooltip
                     class="slds-button"
                     size="small"
@@ -12,18 +13,17 @@
                     offset={bubbleOffset}
                 ></lightning-primitive-datatable-tooltip>
             </template>
+            <!-- Cancel and Save Buttons -->
             <button
                 type="button"
                 class="slds-button slds-button_neutral"
-                onclick={handleCancelButtonClick}
-            >
+                onclick={handleCancelButtonClick}>
                 {i18n.cancel}
             </button>
             <button
                 type="button"
                 class="slds-button slds-button_brand save-btn"
-                onclick={handleSaveButtonClick}
-            >
+                onclick={handleSaveButtonClick}>
                 {i18n.save}
             </button>
         </div>

package/src/lightning/primitiveDatatableStatusBar/primitiveDatatableStatusBar.js

@@ -47,6 +47,10 @@ export default class LightningPrimitiveDatatableStatusBar extends LightningEleme
         };
     }
 
+    isSaveBtnFocused() {
+        return this.template.querySelector('button.save-btn:focus') !== null;
+    }
+
     handleCancelButtonClick(event) {
         event.preventDefault();
         event.stopPropagation();
@@ -78,10 +82,6 @@ export default class LightningPrimitiveDatatableStatusBar extends LightningEleme
         );
     }
 
-    isSaveBtnFocused() {
-        return this.template.querySelector('button.save-btn:focus') !== null;
-    }
-
     /**
      * Handling between displaying/focusing tooltip icon and/or error bubble
      * If showBubble property is set within error object, display/focus the error bubble.

package/src/lightning/primitiveHeaderActions/primitiveHeaderActions.js

@@ -10,24 +10,28 @@ const i18n = {
     wrapText: labelWrapText,
 };
 
+/**
+ * A header-level action.
+ */
 export default class PrimitiveHeaderActions extends LightningElement {
-    static delegatesFocus = true;
-    @api colKeyValue;
-
+    // Tracked objects
     @track containerRect;
     @track _internalActions = [];
     @track _customerActions = [];
+
+    // Private variables
+    static delegatesFocus = true;
     _actionMenuAlignment;
 
-    @api
-    focus() {
-        const btnMenu = this.template.querySelector('lightning-button-menu');
+    /************************** PUBLIC ATTRIBUTES ***************************/
 
-        if (btnMenu) {
-            btnMenu.focus();
-        }
-    }
+    @api colKeyValue;
 
+    /**
+     * Defines the actions on a header cell
+     *
+     * @type {Object}
+     */
     @api
     get actions() {
         return this._actions;
@@ -38,49 +42,60 @@ export default class PrimitiveHeaderActions extends LightningElement {
         this.updateActions();
     }
 
-    get i18n() {
-        return i18n;
-    }
-
-    updateActions() {
-        const actionTypeReducer = (type) => (actions, action) => {
-            const overrides = { _type: type, _action: action };
-            actions.push(Object.assign({}, action, overrides));
+    /************************** PUBLIC METHODS ***************************/
 
-            return actions;
-        };
+    /**
+     * Sets focus on a lightning-button-menu
+     */
+    @api
+    focus() {
+        const btnMenu = this.template.querySelector('lightning-button-menu');
 
-        this._internalActions = this.getActionsByType('internalActions').reduce(
-            actionTypeReducer('internal'),
-            []
-        );
+        if (btnMenu) {
+            btnMenu.focus();
+        }
+    }
 
-        this._customerActions = this.getActionsByType('customerActions').reduce(
-            actionTypeReducer('customer'),
-            []
-        );
+    /************************** PRIVATE GETTERS **************************/
 
-        // ToDo: W-8389508 Refactor so menu is outside of header
-        this._actionMenuAlignment =
-            this._actions.menuAlignment &&
-            this._actions.menuAlignment.replace('auto-', '');
+    /**
+     * Returns the internationalization definition object
+     *
+     * @return {Object} The i18n definition object
+     */
+    get i18n() {
+        return i18n;
     }
 
+    /**
+     * Determines whether or not a header has actions
+     *
+     * @return {Boolean}
+     */
     get hasActions() {
         return (
             this._internalActions.length > 0 || this._customerActions.length > 0
         );
     }
+
+    /**
+     * Determines whether or not a header has an action divider
+     *
+     * @return {Boolean}
+     */
     get hasActionsDivider() {
         return (
             this._internalActions.length > 0 && this._customerActions.length > 0
         );
     }
 
-    getActionsByType(type) {
-        return Array.isArray(this._actions[type]) ? this._actions[type] : [];
-    }
+    /************************ EVENT DISPATCHERS **************************/
 
+    /**
+     * Handles opening a menu
+     *
+     * @param {Event} event
+     */
     handleMenuOpen(event) {
         event.preventDefault();
         event.stopPropagation();
@@ -107,6 +122,9 @@ export default class PrimitiveHeaderActions extends LightningElement {
         );
     }
 
+    /**
+     * Handles closing a menu
+     */
     handleMenuClose() {
         this.dispatchEvent(
             new CustomEvent('privatecellheaderactionmenuclosed', {
@@ -117,8 +135,13 @@ export default class PrimitiveHeaderActions extends LightningElement {
         );
     }
 
-    handleActionSelect(evt) {
-        const action = evt.detail.value;
+    /**
+     * Handles selecting an action
+     *
+     * @param {Event} event
+     */
+    handleActionSelect(event) {
+        const action = event.detail.value;
 
         this.dispatchEvent(
             new CustomEvent('privatecellheaderactiontriggered', {
@@ -133,4 +156,43 @@ export default class PrimitiveHeaderActions extends LightningElement {
             })
         );
     }
+
+    /************************* HELPER FUNCTIONS **************************/
+
+    /**
+     * Updates the actions object
+     */
+    updateActions() {
+        const actionTypeReducer = (type) => (actions, action) => {
+            const overrides = { _type: type, _action: action };
+            actions.push(Object.assign({}, action, overrides));
+
+            return actions;
+        };
+
+        this._internalActions = this.getActionsByType('internalActions').reduce(
+            actionTypeReducer('internal'),
+            []
+        );
+
+        this._customerActions = this.getActionsByType('customerActions').reduce(
+            actionTypeReducer('customer'),
+            []
+        );
+
+        // TODO: W-8389508 Refactor so menu is outside of header
+        this._actionMenuAlignment =
+            this._actions.menuAlignment &&
+            this._actions.menuAlignment.replace('auto-', '');
+    }
+
+    /**
+     * Returns actions by action type
+     *
+     * @param {String} type The action type to filter by
+     * @return {Array} An array of actions that match the provided type
+     */
+    getActionsByType(type) {
+        return Array.isArray(this._actions[type]) ? this._actions[type] : [];
+    }
 }

package/src/lightning/progressIndicator/progressIndicator.js

@@ -53,7 +53,7 @@ export default class LightningProgressIndicator extends LightningElement {
     set currentStep(value) {
         this.privateCurrentStep = value;
         if (this.privateRendered) {
-            this.updateSteps();
+            this.updateSteps(value);
         }
     }
 

package/src/lightning/progressStep/progressStep.js

@@ -31,6 +31,8 @@ export default class LightningProgressStep extends LightningElement {
      */
     @api value;
 
+    _privateLabel;
+
     @track state = {};
 
     updateInternal(newStatus, newType, newIndex, newActive, shouldFocus) {
@@ -47,6 +49,7 @@ export default class LightningProgressStep extends LightningElement {
         this.state.type = newType;
         this.state.index = newIndex;
         this.state.active = newActive;
+        this.initializeTooltip();
     }
     /**
      * Text to display as the name or tooltip for the step.
@@ -54,30 +57,12 @@ export default class LightningProgressStep extends LightningElement {
      */
     @api
     set label(value) {
-        if (this._tooltip) {
-            this._tooltip.value = value;
-        } else if (value && !this.isPath) {
-            // Note that because the tooltip target is a child element it may not be present in the
-            // dom during initial rendering.
-            this._tooltip = new Tooltip(value, {
-                root: this,
-                target: () => this.template.querySelector('button'),
-                type: TooltipType.Toggle,
-                align: {
-                    horizontal: Direction.Center,
-                    vertical: Direction.Bottom,
-                },
-                targetAlign: {
-                    horizontal: Direction.Center,
-                    vertical: Direction.Top,
-                },
-            });
-            this._tooltip.initialize();
-        }
+        this._privateLabel = value;
+        this.initializeTooltip();
     }
 
     get label() {
-        return this._tooltip ? this._tooltip.value : undefined;
+        return this._privateLabel;
     }
 
     computeClassSet(type, status, isActive) {
@@ -87,7 +72,7 @@ export default class LightningProgressStep extends LightningElement {
             'slds-is-completed': !isPath && status === 'completed',
             'slds-has-error': !isPath && status === 'error',
             'slds-is-active':
-                (type !== 'base' && isActive === true) ||
+                (isPath && isActive === true) ||
                 (type === 'base' && status === 'current'),
             'slds-path__item': isPath,
             'slds-is-complete': isPath && status === 'completed',
@@ -240,4 +225,27 @@ export default class LightningProgressStep extends LightningElement {
         }
         return base;
     }
+
+    initializeTooltip() {
+        if (this._tooltip) {
+            this._tooltip.value = this._privateLabel;
+        } else if (this._privateLabel && this.state.type && !this.isPath) {
+            // Note that because the tooltip target is a child element it may not be present in the
+            // dom during initial rendering.
+            this._tooltip = new Tooltip(this._privateLabel, {
+                root: this,
+                target: () => this.template.querySelector('button'),
+                type: TooltipType.Toggle,
+                align: {
+                    horizontal: Direction.Center,
+                    vertical: Direction.Bottom,
+                },
+                targetAlign: {
+                    horizontal: Direction.Center,
+                    vertical: Direction.Top,
+                },
+            });
+            this._tooltip.initialize();
+        }
+    }
 }

package/src/lightning/staticMap/staticMap.html

@@ -6,6 +6,7 @@
                     oniframeload={handleIframeLoad}
                     width={width}
                     height={height}
+                    title={mapTitle}
                     frame-style={mapStyle}>
         </lightning-primitive-iframe>
         <div class="slds-iframe-cover"></div>

package/src/lightning/staticMap/staticMap.js

@@ -1,5 +1,7 @@
 import lang from '@salesforce/i18n/lang';
 import formFactor from '@salesforce/client/formFactor';
+import labelTitleWithAddress from '@salesforce/label/LightningMap.titleWithAddress';
+import labelTitleWithoutAddress from '@salesforce/label/LightningMap.iframeTitle';
 import { LightningElement, api, track } from 'lwc';
 import { ratioToScale, calculateSize } from './util';
 import {
@@ -9,12 +11,19 @@ import {
     postMessage,
 } from 'lightning/messageDispatcher';
 import { buildMapSourceUrl } from 'lightning/mapUtils';
+import { isEmptyString } from 'lightning/inputUtils';
+import { formatLabel } from 'lightning/utils';
 
 const EVENT_NAME = {
     LOADING_MAP: 'loadingMap',
     STATIC_MAP_LOADED: 'lightning:staticMapLoaded',
 };
 
+const i18n = {
+    titleWithAddress: labelTitleWithAddress,
+    titleWithoutAddress: labelTitleWithoutAddress,
+};
+
 export default class LightningStaticMap extends LightningElement {
     @api width;
     @api height;
@@ -23,6 +32,7 @@ export default class LightningStaticMap extends LightningElement {
     @api province;
     @api postalCode;
     @api country;
+    @api title;
 
     _zoom = 14;
     _scale = 1;
@@ -109,8 +119,7 @@ export default class LightningStaticMap extends LightningElement {
         return '';
     }
 
-    get address() {
-        // if latitude/longitude specified use that to avoid expensive Google geo-coding processing
+    get latLongString() {
         if (
             this.latitude != null &&
             this.latitude >= -90.0 &&
@@ -121,12 +130,40 @@ export default class LightningStaticMap extends LightningElement {
         ) {
             return `${this.latitude},${this.longitude}`;
         }
+        return null;
+    }
 
+    get addressString() {
         return `${this.street || ''} ${this.city || ''} ${
             this.province || ''
         } ${this.postalCode || ''} ${this.country || ''}`;
     }
 
+    get address() {
+        // if latitude/longitude specified use that to avoid expensive Google geo-coding processing
+        return this.latLongString || this.addressString;
+    }
+
+    /**
+     * getter for the i18 constant containing the localized strings
+     */
+    get i18n() {
+        return i18n;
+    }
+
+    get mapTitle() {
+        if (isEmptyString(this.title)) {
+            let titleAddress =
+                (this.addressString && this.addressString.trim()) ||
+                (this.latLongString && this.latLongString.trim());
+            if (isEmptyString(titleAddress)) {
+                return this.i18n.titleWithoutAddress;
+            }
+            return formatLabel(this.i18n.titleWithAddress, titleAddress);
+        }
+        return this.title;
+    }
+
     handleMessage(data) {
         if (data.event === EVENT_NAME.STATIC_MAP_LOADED) {
             this._mapLoaded = true;

package/src/lightning/utils/classSet.js

@@ -3,7 +3,10 @@ const classNamesHash = (classes) => {
         ? classes
               .trim()
               .split(/\s+/)
-              .reduce((acc, cn) => ({ ...acc, [cn]: true }), {})
+              .reduce((acc, cn) => {
+                  acc[cn] = true;
+                  return acc;
+              }, {})
         : classes;
 };
 

package/src/lightning/utilsPrivate/utilsPrivate.js

@@ -23,7 +23,6 @@ export {
 } from './keyboard';
 export { raf } from './scroll';
 export { isChrome, isIE11, isSafari } from './browser';
-export { ContentMutation } from './contentMutation';
 export { observePosition } from './observers';
 export { hasOnlyAllowedVideoIframes } from './videoUtils';
 export {
@@ -212,3 +211,15 @@ export function buttonGroupOrderClass(groupOrder) {
         [BUTTON_GROUP_ORDER.ONLY]: 'single-button',
     }[groupOrder];
 }
+
+/**
+ * Checks if the given component is native
+ * @param {Object} cmp Component instance
+ * @returns {Boolean} Whether the component is native
+ */
+export function isNativeComponent(cmp) {
+    if (cmp && cmp.template && cmp.template.constructor) {
+        return !!String(cmp.template.constructor).match(/\[native code\]/);
+    }
+    return false;
+}

package/scopedImports/@salesforce-label-LightningModalBase.close.js

@@ -1 +0,0 @@
-export default 'Close';

package/src/lightning/datatable/inlineEdit-shared.js

@@ -1,14 +0,0 @@
-export function getDirtyValue(state, rowKeyValue, colKeyValue) {
-    const dirtyValues = state.inlineEdit.dirtyValues;
-
-    if (
-        // eslint-disable-next-line no-prototype-builtins
-        dirtyValues.hasOwnProperty(rowKeyValue) &&
-        // eslint-disable-next-line no-prototype-builtins
-        dirtyValues[rowKeyValue].hasOwnProperty(colKeyValue)
-    ) {
-        return dirtyValues[rowKeyValue][colKeyValue];
-    }
-
-    return undefined;
-}

package/src/lightning/datatable/selector-shared.js

@@ -1,38 +0,0 @@
-export function isSelectedRow(state, rowKeyValue) {
-    return !!state.selectedRowsKeys[rowKeyValue];
-}
-
-export function isDisabledRow(state, rowKeyValue) {
-    if (!isSelectedRow(state, rowKeyValue)) {
-        const maxRowSelection = getMaxRowSelection(state);
-
-        // W-4819182 when selection is 1, we should not disable selection.
-        return (
-            maxRowSelection !== 1 &&
-            getCurrentSelectionLength(state) === maxRowSelection
-        );
-    }
-
-    return false;
-}
-
-export function getRowSelectionInputType(state) {
-    if (getMaxRowSelection(state) === 1) {
-        return 'radio';
-    }
-    return 'checkbox';
-}
-
-export function getMaxRowSelection(state) {
-    return state.maxRowSelection;
-}
-
-export function getCurrentSelectionLength(state) {
-    return getSelectedRowsKeys(state).length;
-}
-
-export function getSelectedRowsKeys(state) {
-    return Object.keys(state.selectedRowsKeys).filter(
-        (key) => state.selectedRowsKeys[key]
-    );
-}