@itwin/presentation-common 5.0.0-dev.7 → 5.0.0-dev.70

package/lib/esm/presentation-common/content/Fields.js

@@ -9,6 +9,7 @@ import { assert } from "@itwin/core-bentley";
 import { NavigationPropertyInfo, RelatedClassInfo, RelationshipPath, } from "../EC";
 import { PresentationError, PresentationStatus } from "../Error";
 import { RelationshipMeaning } from "../rules/content/modifiers/RelatedPropertiesSpecification";
+import { omitUndefined } from "../Utils";
 import { Property } from "./Property";
 function isPropertiesField(field) {
     return !!field.properties;
@@ -29,28 +30,50 @@ function isNestedContentField(field) {
  * @public
  */
 export class Field {
-    /**
-     * Creates an instance of Field.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param editor Property editor used to edit values of this field
-     * @param renderer Property renderer used to render values of this field
-     * @param extendedData Extended data associated with this field
-     */
-    constructor(category, name, label, type, isReadonly, priority, editor, renderer, extendedData) {
-        this.category = category;
-        this.name = name;
-        this.label = label;
-        this.type = type;
-        this.isReadonly = isReadonly;
-        this.priority = priority;
-        this.editor = editor;
-        this.renderer = renderer;
-        this.extendedData = extendedData;
+    /** Category information */
+    category;
+    /** Unique name */
+    name;
+    /** Display label */
+    label;
+    /** Description of this field's values data type */
+    type;
+    /** Are values in this field read-only */
+    isReadonly;
+    /** Priority of the field. Higher priority fields should appear first in the UI */
+    priority;
+    /** Property renderer used to render values of this field */
+    renderer;
+    /** Property editor used to edit values of this field */
+    editor;
+    /** Extended data associated with this field */
+    extendedData;
+    /** Parent field */
+    _parent;
+    constructor(categoryOrProps, name, label, type, isReadonly, priority, editor, renderer, extendedData) {
+        /* istanbul ignore next */
+        const props = "category" in categoryOrProps
+            ? categoryOrProps
+            : {
+                category: categoryOrProps,
+                name: name,
+                label: label,
+                type: type,
+                isReadonly: isReadonly,
+                priority: priority,
+                editor,
+                renderer,
+                extendedData,
+            };
+        this.category = props.category;
+        this.name = props.name;
+        this.label = props.label;
+        this.type = props.type;
+        this.isReadonly = props.isReadonly;
+        this.priority = props.priority;
+        this.editor = props.editor;
+        this.renderer = props.renderer;
+        this.extendedData = props.extendedData;
     }
     /**
      * Is this a [[PropertiesField]]
@@ -71,13 +94,20 @@ export class Field {
         return this._parent;
     }
     clone() {
-        const clone = new Field(this.category, this.name, this.label, this.type, this.isReadonly, this.priority, this.editor, this.renderer, this.extendedData);
+        const clone = new Field(this);
         clone.rebuildParentship(this.parent);
         return clone;
     }
-    /** Serialize this object to JSON */
+    /**
+     * Serialize this object to JSON.
+     * @deprecated in 5.x. Use [[toCompressedJSON]] instead.
+     */
     toJSON() {
-        return {
+        return this.toCompressedJSON({});
+    }
+    /** Serialize this object to compressed JSON */
+    toCompressedJSON(_classesMap) {
+        return omitUndefined({
             category: this.category.name,
             name: this.name,
             label: this.label,
@@ -86,28 +116,34 @@ export class Field {
             priority: this.priority,
             renderer: this.renderer,
             editor: this.editor,
-            extendedData: this.extendedData
-        };
-    }
-    /** Serialize this object to compressed JSON */
-    toCompressedJSON(_classesMap) {
-        return this.toJSON();
+            extendedData: this.extendedData,
+        });
     }
-    /** Deserialize [[Field]] from JSON */
+    /**
+     * Deserialize [[Field]] from JSON.
+     * @deprecated in 5.x. Use [[fromCompressedJSON]] instead.
+     */
     static fromJSON(json, categories) {
         if (!json) {
             return undefined;
         }
         if (isPropertiesField(json)) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return PropertiesField.fromJSON(json, categories);
         }
         if (isNestedContentField(json)) {
-            // eslint-disable-next-line @typescript-eslint/no-deprecated
-            return NestedContentField.fromJSON(json, categories);
+            return new NestedContentField({
+                ...json,
+                ...fromNestedContentFieldJSON(json, categories),
+                nestedFields: json.nestedFields
+                    // eslint-disable-next-line @typescript-eslint/no-deprecated
+                    .map((nestedFieldJson) => Field.fromJSON(nestedFieldJson, categories))
+                    .filter((nestedField) => !!nestedField),
+            });
         }
-        const field = Object.create(Field.prototype);
-        return Object.assign(field, json, {
-            category: Field.getCategoryFromFieldJson(json, categories),
+        return new Field({
+            ...json,
+            category: this.getCategoryFromFieldJson(json, categories),
         });
     }
     /** Deserialize a [[Field]] from compressed JSON. */
@@ -121,17 +157,13 @@ export class Field {
         if (isNestedContentField(json)) {
             return NestedContentField.fromCompressedJSON(json, classesMap, categories);
         }
-        const field = Object.create(Field.prototype);
-        return Object.assign(field, json, {
-            category: Field.getCategoryFromFieldJson(json, categories),
+        return new Field({
+            ...json,
+            category: this.getCategoryFromFieldJson(json, categories),
         });
     }
     static getCategoryFromFieldJson(fieldJson, categories) {
-        const category = categories.find((c) => c.name === fieldJson.category);
-        if (!category) {
-            throw new PresentationError(PresentationStatus.InvalidArgument, `Invalid content field category`);
-        }
-        return category;
+        return getCategoryFromFieldJson(fieldJson, categories);
     }
     /** Resets field's parent. */
     resetParentship() {
@@ -166,21 +198,25 @@ export class Field {
  * @public
  */
 export class PropertiesField extends Field {
-    /**
-     * Creates an instance of PropertiesField.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param properties A list of properties this field is created from
-     * @param editor Property editor used to edit values of this field
-     * @param renderer Property renderer used to render values of this field
-     */
-    constructor(category, name, label, description, isReadonly, priority, properties, editor, renderer) {
-        super(category, name, label, description, isReadonly, priority, editor, renderer);
-        this.properties = properties;
+    /** A list of properties this field is created from */
+    properties;
+    constructor(categoryOrProps, name, label, type, isReadonly, priority, properties, editor, renderer) {
+        /* istanbul ignore next */
+        const props = "category" in categoryOrProps
+            ? categoryOrProps
+            : {
+                category: categoryOrProps,
+                name: name,
+                label: label,
+                type: type,
+                isReadonly: isReadonly,
+                priority: priority,
+                editor,
+                renderer,
+                properties: properties,
+            };
+        super(props);
+        this.properties = props.properties;
     }
     /** Is this a an array property field */
     isArrayPropertiesField() {
@@ -191,13 +227,17 @@ export class PropertiesField extends Field {
         return false;
     }
     clone() {
-        const clone = new PropertiesField(this.category, this.name, this.label, this.type, this.isReadonly, this.priority, this.properties, this.editor, this.renderer);
+        const clone = new PropertiesField(this);
         clone.rebuildParentship(this.parent);
         return clone;
     }
-    /** Serialize this object to JSON */
+    /**
+     * Serialize this object to JSON
+     * @deprecated in 5.x. Use [[toCompressedJSON]] instead.
+     */
     toJSON() {
         return {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             ...super.toJSON(),
             properties: this.properties,
         };
@@ -209,19 +249,24 @@ export class PropertiesField extends Field {
             properties: this.properties.map((property) => Property.toCompressedJSON(property, classesMap)),
         };
     }
-    /** Deserialize [[PropertiesField]] from JSON */
+    /**
+     * Deserialize [[PropertiesField]] from JSON.
+     * @deprecated in 5.x. Use [[fromCompressedJSON]] instead.
+     */
     static fromJSON(json, categories) {
         if (!json) {
             return undefined;
         }
         if (isArrayPropertiesField(json)) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return ArrayPropertiesField.fromJSON(json, categories);
         }
         if (isStructPropertiesField(json)) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             return StructPropertiesField.fromJSON(json, categories);
         }
-        const field = Object.create(PropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new PropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
         });
     }
@@ -236,8 +281,8 @@ export class PropertiesField extends Field {
         if (isStructPropertiesField(json)) {
             return StructPropertiesField.fromCompressedJSON(json, classesMap, categories);
         }
-        const field = Object.create(PropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new PropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
             properties: json.properties.map((propertyJson) => fromCompressedPropertyJSON(propertyJson, classesMap)),
         });
@@ -298,22 +343,43 @@ export class PropertiesField extends Field {
  * @public
  */
 export class ArrayPropertiesField extends PropertiesField {
-    constructor(category, name, label, description, itemsField, isReadonly, priority, properties, editor, renderer) {
-        super(category, name, label, description, isReadonly, priority, properties, editor, renderer);
-        this.itemsField = itemsField;
+    itemsField;
+    constructor(categoryOrProps, name, label, type, itemsField, isReadonly, priority, properties, editor, renderer) {
+        /* istanbul ignore next */
+        const props = "category" in categoryOrProps
+            ? categoryOrProps
+            : {
+                category: categoryOrProps,
+                name: name,
+                label: label,
+                type: type,
+                isReadonly: isReadonly,
+                priority: priority,
+                editor,
+                renderer,
+                properties: properties,
+                itemsField: itemsField,
+            };
+        super(props);
+        this.itemsField = props.itemsField;
     }
     isArrayPropertiesField() {
         return true;
     }
     clone() {
-        const clone = new ArrayPropertiesField(this.category, this.name, this.label, this.type, this.itemsField.clone(), this.isReadonly, this.priority, this.properties, this.editor, this.renderer);
+        const clone = new ArrayPropertiesField(this);
         clone.rebuildParentship(this.parent);
         return clone;
     }
-    /** Serialize this object to JSON */
+    /**
+     * Serialize this object to JSON.
+     * @deprecated in 5.x. Use [[toCompressedJSON]] instead.
+     */
     toJSON() {
         return {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             ...super.toJSON(),
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             itemsField: this.itemsField.toJSON(),
         };
     }
@@ -324,11 +390,15 @@ export class ArrayPropertiesField extends PropertiesField {
             itemsField: this.itemsField.toCompressedJSON(classesMap),
         };
     }
-    /** Deserialize [[ArrayPropertiesField]] from JSON */
+    /**
+     * Deserialize [[ArrayPropertiesField]] from JSON.
+     * @deprecated in 5.x. Use [[fromCompressedJSON]] instead.
+     */
     static fromJSON(json, categories) {
-        const field = Object.create(ArrayPropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new ArrayPropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             itemsField: PropertiesField.fromJSON(json.itemsField, categories),
         });
     }
@@ -337,8 +407,8 @@ export class ArrayPropertiesField extends PropertiesField {
      * @public
      */
     static fromCompressedJSON(json, classesMap, categories) {
-        const field = Object.create(ArrayPropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new ArrayPropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
             properties: json.properties.map((propertyJson) => fromCompressedPropertyJSON(propertyJson, classesMap)),
             itemsField: PropertiesField.fromCompressedJSON(json.itemsField, classesMap, categories),
@@ -350,22 +420,43 @@ export class ArrayPropertiesField extends PropertiesField {
  * @public
  */
 export class StructPropertiesField extends PropertiesField {
-    constructor(category, name, label, description, memberFields, isReadonly, priority, properties, editor, renderer) {
-        super(category, name, label, description, isReadonly, priority, properties, editor, renderer);
-        this.memberFields = memberFields;
+    memberFields;
+    constructor(categoryOrProps, name, label, type, memberFields, isReadonly, priority, properties, editor, renderer) {
+        /* istanbul ignore next */
+        const props = "category" in categoryOrProps
+            ? categoryOrProps
+            : {
+                category: categoryOrProps,
+                name: name,
+                label: label,
+                type: type,
+                isReadonly: isReadonly,
+                priority: priority,
+                editor,
+                renderer,
+                properties: properties,
+                memberFields: memberFields,
+            };
+        super(props);
+        this.memberFields = props.memberFields;
     }
     isStructPropertiesField() {
         return true;
     }
     clone() {
-        const clone = new StructPropertiesField(this.category, this.name, this.label, this.type, this.memberFields.map((m) => m.clone()), this.isReadonly, this.priority, this.properties, this.editor, this.renderer);
+        const clone = new StructPropertiesField(this);
         clone.rebuildParentship(this.parent);
         return clone;
     }
-    /** Serialize this object to JSON */
+    /**
+     * Serialize this object to JSON.
+     * @deprecated in 5.x. Use [[toCompressedJSON]] instead.
+     */
     toJSON() {
         return {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             ...super.toJSON(),
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             memberFields: this.memberFields.map((m) => m.toJSON()),
         };
     }
@@ -376,11 +467,15 @@ export class StructPropertiesField extends PropertiesField {
             memberFields: this.memberFields.map((m) => m.toCompressedJSON(classesMap)),
         };
     }
-    /** Deserialize [[StructPropertiesField]] from JSON */
+    /**
+     * Deserialize [[StructPropertiesField]] from JSON.
+     * @deprecated in 5.x. Use [[fromCompressedJSON]] instead.
+     */
     static fromJSON(json, categories) {
-        const field = Object.create(StructPropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new StructPropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             memberFields: json.memberFields.map((m) => PropertiesField.fromJSON(m, categories)),
         });
     }
@@ -389,8 +484,8 @@ export class StructPropertiesField extends PropertiesField {
      * @public
      */
     static fromCompressedJSON(json, classesMap, categories) {
-        const field = Object.create(StructPropertiesField.prototype);
-        return Object.assign(field, json, {
+        return new StructPropertiesField({
+            ...json,
             category: this.getCategoryFromFieldJson(json, categories),
             properties: json.properties.map((propertyJson) => fromCompressedPropertyJSON(propertyJson, classesMap)),
             memberFields: json.memberFields.map((m) => PropertiesField.fromCompressedJSON(m, classesMap, categories)),
@@ -403,35 +498,64 @@ export class StructPropertiesField extends PropertiesField {
  * @public
  */
 export class NestedContentField extends Field {
+    /** Information about an ECClass whose properties are nested inside this field */
+    contentClassInfo;
+    /** Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class) */
+    pathToPrimaryClass;
+    /**
+     * Meaning of the relationship between the [primary class]($docs/presentation/content/Terminology#primary-class)
+     * and content class of this field.
+     *
+     * The value is set up through [[RelatedPropertiesSpecification.relationshipMeaning]] attribute when setting up
+     * presentation rules for creating the content.
+     */
+    relationshipMeaning;
     /**
-     * Creates an instance of NestedContentField.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param contentClassInfo Information about an ECClass whose properties are nested inside this field
-     * @param pathToPrimaryClass Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class)
-     * @param nestedFields Contained nested fields
-     * @param editor Property editor used to edit values of this field
-     * @param autoExpand Flag specifying whether field should be expanded
-     * @param relationshipMeaning RelationshipMeaning of the field
-     * @param renderer Property renderer used to render values of this field
+     * When content descriptor is requested in a polymorphic fashion, fields get created if at least one of the concrete classes
+     * has it. In certain situations it's necessary to know which concrete classes caused that and this attribute is
+     * here to help.
+     *
+     * **Example:** There's a base class `A` and it has two derived classes `B` and `C` and class `B` has a relationship to class `D`.
+     * When content descriptor is requested for class `A` polymorphically, it's going to contain fields for all properties of class `B`,
+     * class `C` and a nested content field for the `B -> D` relationship. The nested content field's `actualPrimaryClassIds` attribute
+     * will contain ID of class `B`, identifying that only this specific class has the relationship.
      */
-    constructor(category, name, label, description, isReadonly, priority, contentClassInfo, pathToPrimaryClass, nestedFields, editor, autoExpand, renderer) {
-        super(category, name, label, description, isReadonly, priority, editor, renderer);
-        this.contentClassInfo = contentClassInfo;
-        this.pathToPrimaryClass = pathToPrimaryClass;
-        this.relationshipMeaning = RelationshipMeaning.RelatedInstance;
-        this.nestedFields = nestedFields;
-        this.autoExpand = autoExpand;
-        this.actualPrimaryClassIds = [];
+    actualPrimaryClassIds;
+    /** Contained nested fields */
+    nestedFields;
+    /** Flag specifying whether field should be expanded */
+    autoExpand;
+    constructor(categoryOrProps, name, label, type, isReadonly, priority, contentClassInfo, pathToPrimaryClass, nestedFields, editor, autoExpand, renderer) {
+        /* istanbul ignore next */
+        const props = "category" in categoryOrProps
+            ? categoryOrProps
+            : {
+                category: categoryOrProps,
+                name: name,
+                label: label,
+                type: type,
+                isReadonly: isReadonly,
+                priority: priority,
+                editor,
+                renderer,
+                contentClassInfo: contentClassInfo,
+                pathToPrimaryClass: pathToPrimaryClass,
+                nestedFields: nestedFields,
+                autoExpand,
+            };
+        super(props);
+        this.contentClassInfo = props.contentClassInfo;
+        this.pathToPrimaryClass = props.pathToPrimaryClass;
+        this.relationshipMeaning = props.relationshipMeaning ?? RelationshipMeaning.RelatedInstance;
+        this.nestedFields = props.nestedFields;
+        this.autoExpand = props.autoExpand;
+        this.actualPrimaryClassIds = props.actualPrimaryClassIds ?? [];
     }
     clone() {
-        const clone = new NestedContentField(this.category, this.name, this.label, this.type, this.isReadonly, this.priority, this.contentClassInfo, this.pathToPrimaryClass, this.nestedFields.map((n) => n.clone()), this.editor, this.autoExpand, this.renderer);
-        clone.actualPrimaryClassIds = this.actualPrimaryClassIds;
-        clone.relationshipMeaning = this.relationshipMeaning;
+        const clone = new NestedContentField({
+            ...this,
+            nestedFields: this.nestedFields.map((n) => n.clone()),
+        });
         clone.rebuildParentship(this.parent);
         return clone;
     }
@@ -443,16 +567,21 @@ export class NestedContentField extends Field {
     getFieldByName(name, recurse) {
         return getFieldByName(this.nestedFields, name, recurse);
     }
-    /** Serialize this object to JSON */
+    /**
+     * Serialize this object to JSON.
+     * @deprecated in 5.x. Use [[toCompressedJSON]] instead.
+     */
     toJSON() {
         return {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             ...super.toJSON(),
             contentClassInfo: this.contentClassInfo,
             pathToPrimaryClass: this.pathToPrimaryClass,
             relationshipMeaning: this.relationshipMeaning,
             actualPrimaryClassIds: this.actualPrimaryClassIds,
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
             nestedFields: this.nestedFields.map((field) => field.toJSON()),
-            autoExpand: this.autoExpand,
+            ...(this.autoExpand ? { autoExpand: true } : undefined),
         };
     }
     /** Serialize this object to compressed JSON */
@@ -462,30 +591,19 @@ export class NestedContentField extends Field {
         return {
             ...super.toCompressedJSON(classesMap),
             contentClassInfo: id,
+            relationshipMeaning: this.relationshipMeaning,
+            actualPrimaryClassIds: this.actualPrimaryClassIds,
             pathToPrimaryClass: this.pathToPrimaryClass.map((classInfo) => RelatedClassInfo.toCompressedJSON(classInfo, classesMap)),
             nestedFields: this.nestedFields.map((field) => field.toCompressedJSON(classesMap)),
+            ...(this.autoExpand ? { autoExpand: true } : undefined),
         };
     }
-    /**
-     * Deserialize [[NestedContentField]] from JSON
-     * @deprecated in 3.x. Use [[NestedContentField.fromCompressedJSON]]
-     */
-    static fromJSON(json, categories) {
-        if (!json) {
-            return undefined;
-        }
-        const field = Object.create(NestedContentField.prototype);
-        return Object.assign(field, json, this.fromCommonJSON(json, categories), {
-            nestedFields: json.nestedFields
-                .map((nestedFieldJson) => Field.fromJSON(nestedFieldJson, categories))
-                .filter((nestedField) => !!nestedField),
-        });
-    }
     /** Deserialize a [[NestedContentField]] from compressed JSON. */
     static fromCompressedJSON(json, classesMap, categories) {
         assert(classesMap.hasOwnProperty(json.contentClassInfo));
-        const field = Object.create(NestedContentField.prototype);
-        return Object.assign(field, json, this.fromCommonJSON(json, categories), {
+        return new NestedContentField({
+            ...json,
+            ...fromNestedContentFieldJSON(json, categories),
             category: this.getCategoryFromFieldJson(json, categories),
             nestedFields: json.nestedFields
                 .map((nestedFieldJson) => Field.fromCompressedJSON(nestedFieldJson, classesMap, categories))
@@ -494,15 +612,6 @@ export class NestedContentField extends Field {
             pathToPrimaryClass: json.pathToPrimaryClass.map((stepJson) => RelatedClassInfo.fromCompressedJSON(stepJson, classesMap)),
         });
     }
-    // eslint-disable-next-line @typescript-eslint/no-deprecated
-    static fromCommonJSON(json, categories) {
-        return {
-            category: this.getCategoryFromFieldJson(json, categories),
-            relationshipMeaning: json.relationshipMeaning ?? RelationshipMeaning.RelatedInstance,
-            actualPrimaryClassIds: json.actualPrimaryClassIds ?? [],
-            autoExpand: json.autoExpand,
-        };
-    }
     /** Resets parent of this field and all nested fields. */
     resetParentship() {
         super.resetParentship();
@@ -591,4 +700,19 @@ function fromCompressedPropertyInfoJSON(compressedPropertyJSON, classesMap) {
         ...(navigationPropertyInfo ? { navigationPropertyInfo: NavigationPropertyInfo.fromCompressedJSON(navigationPropertyInfo, classesMap) } : undefined),
     };
 }
+function getCategoryFromFieldJson(fieldJson, categories) {
+    const category = categories.find((c) => c.name === fieldJson.category);
+    if (!category) {
+        throw new PresentationError(PresentationStatus.InvalidArgument, `Invalid content field category`);
+    }
+    return category;
+}
+function fromNestedContentFieldJSON(json, categories) {
+    return {
+        category: getCategoryFromFieldJson(json, categories),
+        relationshipMeaning: json.relationshipMeaning ?? RelationshipMeaning.RelatedInstance,
+        actualPrimaryClassIds: json.actualPrimaryClassIds ?? [],
+        autoExpand: json.autoExpand,
+    };
+}
 //# sourceMappingURL=Fields.js.map