@lwc/shared 2.30.2 → 2.31.0

package/dist/index.cjs.js

@@ -294,6 +294,7 @@ function isVoidElement(name, namespace) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
+const CAMEL_REGEX = /-([a-z])/g;
 /**
  * Maps boolean attribute name to supported tags: 'boolean attr name' => Set of allowed tag names
  * that supports them.
@@ -366,32 +367,49 @@ const GLOBAL_ATTRIBUTE = new Set([
 function isGlobalHtmlAttribute(attrName) {
     return GLOBAL_ATTRIBUTE.has(attrName);
 }
-/**
- * Map composed of properties to attributes not following the HTML property to attribute mapping
- * convention.
- */
-const NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING = new Map([
-    ['accessKey', 'accesskey'],
-    ['readOnly', 'readonly'],
-    ['tabIndex', 'tabindex'],
-    ['bgColor', 'bgcolor'],
-    ['colSpan', 'colspan'],
-    ['rowSpan', 'rowspan'],
-    ['contentEditable', 'contenteditable'],
-    ['crossOrigin', 'crossorigin'],
-    ['dateTime', 'datetime'],
-    ['formAction', 'formaction'],
-    ['isMap', 'ismap'],
-    ['maxLength', 'maxlength'],
-    ['minLength', 'minlength'],
-    ['noValidate', 'novalidate'],
-    ['useMap', 'usemap'],
-    ['htmlFor', 'for'],
-]);
+// Convoluted map generation so that @lwc/shared remains fully tree-shakable (verify-treeshakable)
+const { NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING, NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING } = 
+/*#__PURE__*/ (() => {
+    /**
+     * Map composed of properties to attributes not following the HTML property to attribute mapping
+     * convention.
+     */
+    const NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING = new Map([
+        ['accessKey', 'accesskey'],
+        ['readOnly', 'readonly'],
+        ['tabIndex', 'tabindex'],
+        ['bgColor', 'bgcolor'],
+        ['colSpan', 'colspan'],
+        ['rowSpan', 'rowspan'],
+        ['contentEditable', 'contenteditable'],
+        ['crossOrigin', 'crossorigin'],
+        ['dateTime', 'datetime'],
+        ['formAction', 'formaction'],
+        ['isMap', 'ismap'],
+        ['maxLength', 'maxlength'],
+        ['minLength', 'minlength'],
+        ['noValidate', 'novalidate'],
+        ['useMap', 'usemap'],
+        ['htmlFor', 'for'],
+    ]);
+    /**
+     * Inverted map with attribute name key and property name value.
+     */
+    const NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING = new Map();
+    NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING.forEach((value, key) => NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING.set(value, key));
+    return {
+        NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING,
+        NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING,
+    };
+})();
 /**
  * Map associating previously transformed HTML property into HTML attribute.
  */
 const CACHED_PROPERTY_ATTRIBUTE_MAPPING = new Map();
+/**
+ * Map associating previously transformed HTML attribute into HTML property.
+ */
+const CACHED_ATTRIBUTE_PROPERTY_MAPPING = new Map();
 function htmlPropertyToAttribute(propName) {
     const ariaAttributeName = AriaPropNameToAttrNameMap[propName];
     if (!isUndefined(ariaAttributeName)) {
@@ -420,6 +438,23 @@ function htmlPropertyToAttribute(propName) {
     CACHED_PROPERTY_ATTRIBUTE_MAPPING.set(propName, attributeName);
     return attributeName;
 }
+function htmlAttributeToProperty(attrName) {
+    const ariaPropertyName = AriaAttrNameToPropNameMap[attrName];
+    if (!isUndefined(ariaPropertyName)) {
+        return ariaPropertyName;
+    }
+    const specialPropertyName = NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING.get(attrName);
+    if (!isUndefined(specialPropertyName)) {
+        return specialPropertyName;
+    }
+    const cachedPropertyName = CACHED_ATTRIBUTE_PROPERTY_MAPPING.get(attrName);
+    if (!isUndefined(cachedPropertyName)) {
+        return cachedPropertyName;
+    }
+    const propertyName = StringReplace.call(attrName, CAMEL_REGEX, (g) => g[1].toUpperCase());
+    CACHED_ATTRIBUTE_PROPERTY_MAPPING.set(attrName, propertyName);
+    return propertyName;
+}
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -456,7 +491,7 @@ const hasNativeSymbolSupport = /*@__PURE__*/ (() => Symbol('x').toString() === '
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 // Increment whenever the LWC template compiler changes
-const LWC_VERSION = "2.30.2";
+const LWC_VERSION = "2.31.0";
 const LWC_VERSION_COMMENT = `LWC compiler v${LWC_VERSION}`;
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
 
@@ -516,6 +551,7 @@ exports.getPrototypeOf = getPrototypeOf;
 exports.globalThis = _globalThis;
 exports.hasNativeSymbolSupport = hasNativeSymbolSupport;
 exports.hasOwnProperty = hasOwnProperty;
+exports.htmlAttributeToProperty = htmlAttributeToProperty;
 exports.htmlEscape = htmlEscape;
 exports.htmlPropertyToAttribute = htmlPropertyToAttribute;
 exports.isAriaAttribute = isAriaAttribute;
@@ -538,4 +574,4 @@ exports.noop = noop;
 exports.seal = seal;
 exports.setPrototypeOf = setPrototypeOf;
 exports.toString = toString;
-/** version: 2.30.2 */
+/** version: 2.31.0 */

package/dist/index.js

@@ -292,6 +292,7 @@ function isVoidElement(name, namespace) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
+const CAMEL_REGEX = /-([a-z])/g;
 /**
  * Maps boolean attribute name to supported tags: 'boolean attr name' => Set of allowed tag names
  * that supports them.
@@ -364,32 +365,49 @@ const GLOBAL_ATTRIBUTE = new Set([
 function isGlobalHtmlAttribute(attrName) {
     return GLOBAL_ATTRIBUTE.has(attrName);
 }
-/**
- * Map composed of properties to attributes not following the HTML property to attribute mapping
- * convention.
- */
-const NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING = new Map([
-    ['accessKey', 'accesskey'],
-    ['readOnly', 'readonly'],
-    ['tabIndex', 'tabindex'],
-    ['bgColor', 'bgcolor'],
-    ['colSpan', 'colspan'],
-    ['rowSpan', 'rowspan'],
-    ['contentEditable', 'contenteditable'],
-    ['crossOrigin', 'crossorigin'],
-    ['dateTime', 'datetime'],
-    ['formAction', 'formaction'],
-    ['isMap', 'ismap'],
-    ['maxLength', 'maxlength'],
-    ['minLength', 'minlength'],
-    ['noValidate', 'novalidate'],
-    ['useMap', 'usemap'],
-    ['htmlFor', 'for'],
-]);
+// Convoluted map generation so that @lwc/shared remains fully tree-shakable (verify-treeshakable)
+const { NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING, NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING } = 
+/*#__PURE__*/ (() => {
+    /**
+     * Map composed of properties to attributes not following the HTML property to attribute mapping
+     * convention.
+     */
+    const NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING = new Map([
+        ['accessKey', 'accesskey'],
+        ['readOnly', 'readonly'],
+        ['tabIndex', 'tabindex'],
+        ['bgColor', 'bgcolor'],
+        ['colSpan', 'colspan'],
+        ['rowSpan', 'rowspan'],
+        ['contentEditable', 'contenteditable'],
+        ['crossOrigin', 'crossorigin'],
+        ['dateTime', 'datetime'],
+        ['formAction', 'formaction'],
+        ['isMap', 'ismap'],
+        ['maxLength', 'maxlength'],
+        ['minLength', 'minlength'],
+        ['noValidate', 'novalidate'],
+        ['useMap', 'usemap'],
+        ['htmlFor', 'for'],
+    ]);
+    /**
+     * Inverted map with attribute name key and property name value.
+     */
+    const NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING = new Map();
+    NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING.forEach((value, key) => NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING.set(value, key));
+    return {
+        NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING,
+        NO_STANDARD_PROPERTY_ATTRIBUTE_MAPPING,
+    };
+})();
 /**
  * Map associating previously transformed HTML property into HTML attribute.
  */
 const CACHED_PROPERTY_ATTRIBUTE_MAPPING = new Map();
+/**
+ * Map associating previously transformed HTML attribute into HTML property.
+ */
+const CACHED_ATTRIBUTE_PROPERTY_MAPPING = new Map();
 function htmlPropertyToAttribute(propName) {
     const ariaAttributeName = AriaPropNameToAttrNameMap[propName];
     if (!isUndefined(ariaAttributeName)) {
@@ -418,6 +436,23 @@ function htmlPropertyToAttribute(propName) {
     CACHED_PROPERTY_ATTRIBUTE_MAPPING.set(propName, attributeName);
     return attributeName;
 }
+function htmlAttributeToProperty(attrName) {
+    const ariaPropertyName = AriaAttrNameToPropNameMap[attrName];
+    if (!isUndefined(ariaPropertyName)) {
+        return ariaPropertyName;
+    }
+    const specialPropertyName = NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING.get(attrName);
+    if (!isUndefined(specialPropertyName)) {
+        return specialPropertyName;
+    }
+    const cachedPropertyName = CACHED_ATTRIBUTE_PROPERTY_MAPPING.get(attrName);
+    if (!isUndefined(cachedPropertyName)) {
+        return cachedPropertyName;
+    }
+    const propertyName = StringReplace.call(attrName, CAMEL_REGEX, (g) => g[1].toUpperCase());
+    CACHED_ATTRIBUTE_PROPERTY_MAPPING.set(attrName, propertyName);
+    return propertyName;
+}
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -454,9 +489,9 @@ const hasNativeSymbolSupport = /*@__PURE__*/ (() => Symbol('x').toString() === '
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 // Increment whenever the LWC template compiler changes
-const LWC_VERSION = "2.30.2";
+const LWC_VERSION = "2.31.0";
 const LWC_VERSION_COMMENT = `LWC compiler v${LWC_VERSION}`;
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
 
-export { AriaAttrNameToPropNameMap, AriaPropNameToAttrNameMap, ArrayConcat, ArrayCopyWithin, ArrayFill, ArrayFilter, ArrayFind, ArrayIndexOf, ArrayJoin, ArrayMap, ArrayPop, ArrayPush, ArrayReduce, ArrayReverse, ArrayShift, ArraySlice, ArraySome, ArraySort, ArraySplice, ArrayUnshift, HTML_NAMESPACE, KEY__IS_NATIVE_SHADOW_ROOT_DEFINED, KEY__SCOPED_CSS, KEY__SHADOW_RESOLVER, KEY__SHADOW_RESOLVER_PRIVATE, KEY__SHADOW_STATIC, KEY__SHADOW_STATIC_PRIVATE, KEY__SHADOW_TOKEN, KEY__SHADOW_TOKEN_PRIVATE, KEY__SYNTHETIC_MODE, LWC_VERSION, LWC_VERSION_COMMENT, LWC_VERSION_COMMENT_REGEX, MATHML_NAMESPACE, SVG_NAMESPACE, StringCharCodeAt, StringFromCharCode, StringReplace, StringSlice, StringToLowerCase, XLINK_NAMESPACE, XML_NAMESPACE, assert, assign, create, defineProperties, defineProperty, forEach, freeze, getOwnPropertyDescriptor, getOwnPropertyNames, getPropertyDescriptor, getPrototypeOf, _globalThis as globalThis, hasNativeSymbolSupport, hasOwnProperty, htmlEscape, htmlPropertyToAttribute, isAriaAttribute, isArray, isBoolean, isBooleanAttribute, isFalse, isFrozen, isFunction, isGlobalHtmlAttribute, isNull, isNumber, isObject, isString, isTrue, isUndefined, isVoidElement, keys, noop, seal, setPrototypeOf, toString };
-/** version: 2.30.2 */
+export { AriaAttrNameToPropNameMap, AriaPropNameToAttrNameMap, ArrayConcat, ArrayCopyWithin, ArrayFill, ArrayFilter, ArrayFind, ArrayIndexOf, ArrayJoin, ArrayMap, ArrayPop, ArrayPush, ArrayReduce, ArrayReverse, ArrayShift, ArraySlice, ArraySome, ArraySort, ArraySplice, ArrayUnshift, HTML_NAMESPACE, KEY__IS_NATIVE_SHADOW_ROOT_DEFINED, KEY__SCOPED_CSS, KEY__SHADOW_RESOLVER, KEY__SHADOW_RESOLVER_PRIVATE, KEY__SHADOW_STATIC, KEY__SHADOW_STATIC_PRIVATE, KEY__SHADOW_TOKEN, KEY__SHADOW_TOKEN_PRIVATE, KEY__SYNTHETIC_MODE, LWC_VERSION, LWC_VERSION_COMMENT, LWC_VERSION_COMMENT_REGEX, MATHML_NAMESPACE, SVG_NAMESPACE, StringCharCodeAt, StringFromCharCode, StringReplace, StringSlice, StringToLowerCase, XLINK_NAMESPACE, XML_NAMESPACE, assert, assign, create, defineProperties, defineProperty, forEach, freeze, getOwnPropertyDescriptor, getOwnPropertyNames, getPropertyDescriptor, getPrototypeOf, _globalThis as globalThis, hasNativeSymbolSupport, hasOwnProperty, htmlAttributeToProperty, htmlEscape, htmlPropertyToAttribute, isAriaAttribute, isArray, isBoolean, isBooleanAttribute, isFalse, isFrozen, isFunction, isGlobalHtmlAttribute, isNull, isNumber, isObject, isString, isTrue, isUndefined, isVoidElement, keys, noop, seal, setPrototypeOf, toString };
+/** version: 2.31.0 */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/shared",
-    "version": "2.30.2",
+    "version": "2.31.0",
     "description": "Utilities and methods that are shared across packages",
     "homepage": "https://lwc.dev/",
     "repository": {

package/types/html-attributes.d.ts

@@ -1,3 +1,4 @@
 export declare function isBooleanAttribute(attrName: string, tagName: string): boolean;
 export declare function isGlobalHtmlAttribute(attrName: string): boolean;
 export declare function htmlPropertyToAttribute(propName: string): string;
+export declare function htmlAttributeToProperty(attrName: string): string;