blob: 2bc79a3c323ac866f18bcf04901333cb314eb0ce [file] [log] [blame]
// Copyright 2019 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
import {LitElement, html} from 'lit-element';
import deepEqual from 'deep-equal';
import 'elements/chops/chops-button/chops-button.js';
import 'elements/framework/mr-upload/mr-upload.js';
import 'elements/framework/mr-star/mr-issue-star.js';
import 'elements/chops/chops-checkbox/chops-checkbox.js';
import 'elements/chops/chops-chip/chops-chip.js';
import 'elements/framework/mr-error/mr-error.js';
import 'elements/framework/mr-warning/mr-warning.js';
import 'elements/help/mr-cue/mr-cue.js';
import 'react/mr-react-autocomplete.tsx';
import {cueNames} from 'elements/help/mr-cue/cue-helpers.js';
import {store, connectStore} from 'reducers/base.js';
import {UserInputError} from 'shared/errors.js';
import {fieldTypes} from 'shared/issue-fields.js';
import {displayNameToUserRef, labelStringToRef, componentStringToRef,
componentRefsToStrings, issueStringToRef, issueStringToBlockingRef,
issueRefToString, issueRefsToStrings, filteredUserDisplayNames,
valueToFieldValue, fieldDefToName,
} from 'shared/convertersV0.js';
import {arrayDifference, isEmptyObject, equalsIgnoreCase} from 'shared/helpers.js';
import {NON_EDITING_KEY_EVENTS} from 'shared/dom-helpers.js';
import * as issueV0 from 'reducers/issueV0.js';
import * as permissions from 'reducers/permissions.js';
import * as projectV0 from 'reducers/projectV0.js';
import * as userV0 from 'reducers/userV0.js';
import * as ui from 'reducers/ui.js';
import '../mr-edit-field/mr-edit-field.js';
import '../mr-edit-field/mr-edit-status.js';
import {ISSUE_EDIT_PERMISSION, ISSUE_EDIT_SUMMARY_PERMISSION,
ISSUE_EDIT_STATUS_PERMISSION, ISSUE_EDIT_OWNER_PERMISSION,
ISSUE_EDIT_CC_PERMISSION,
} from 'shared/consts/permissions.js';
import {fieldDefsWithGroup, fieldDefsWithoutGroup, valuesForField,
HARDCODED_FIELD_GROUPS} from 'shared/metadata-helpers.js';
import {renderMarkdown, shouldRenderMarkdown} from 'shared/md-helper.js';
import {unsafeHTML} from 'lit-html/directives/unsafe-html.js';
import {MD_PREVIEW_STYLES, MD_STYLES} from 'shared/shared-styles.js';
/**
* `<mr-edit-metadata>`
*
* Editing form for either an approval or the overall issue.
*
*/
export class MrEditMetadata extends connectStore(LitElement) {
/** @override */
render() {
return html`
<style>
${MD_PREVIEW_STYLES}
${MD_STYLES}
mr-edit-metadata {
display: block;
font-size: var(--chops-main-font-size);
}
mr-edit-metadata.edit-actions-right .edit-actions {
flex-direction: row-reverse;
text-align: right;
}
mr-edit-metadata.edit-actions-right .edit-actions chops-checkbox {
text-align: left;
}
.edit-actions chops-checkbox {
max-width: 200px;
margin-top: 2px;
flex-grow: 2;
text-align: right;
}
.edit-actions {
width: 100%;
max-width: 500px;
margin: 0.5em 0;
text-align: left;
display: flex;
flex-direction: row;
align-items: center;
}
.edit-actions chops-button {
flex-grow: 0;
flex-shrink: 0;
}
.edit-actions .emphasized {
margin-left: 0;
}
input {
box-sizing: border-box;
width: var(--mr-edit-field-width);
padding: var(--mr-edit-field-padding);
font-size: var(--chops-main-font-size);
}
mr-upload {
margin-bottom: 0.25em;
}
textarea {
font-family: var(--mr-toggled-font-family);
width: 100%;
margin: 0.25em 0;
box-sizing: border-box;
border: var(--chops-accessible-border);
height: 8em;
transition: height 0.1s ease-in-out;
padding: 0.5em 4px;
grid-column-start: 1;
grid-column-end: 2;
}
button.toggle {
background: none;
color: var(--chops-link-color);
border: 0;
width: 100%;
padding: 0.25em 0;
text-align: left;
}
button.toggle:hover {
cursor: pointer;
text-decoration: underline;
}
.presubmit-derived {
color: gray;
font-style: italic;
text-decoration-line: underline;
text-decoration-style: dotted;
}
.presubmit-derived-header {
color: gray;
font-weight: bold;
}
.discard-button {
margin-right: 16px;
margin-left: 16px;
}
.group {
width: 100%;
border: 1px solid hsl(0, 0%, 83%);
grid-column: 1 / -1;
margin: 0;
margin-bottom: 0.5em;
padding: 0;
padding-bottom: 0.5em;
}
.group legend {
margin-left: 130px;
}
.group-title {
text-align: center;
font-style: oblique;
margin-top: 4px;
margin-bottom: -8px;
}
.star-line {
display: flex;
align-items: center;
background: var(--chops-notice-bubble-bg);
border: var(--chops-notice-border);
justify-content: flex-start;
margin-top: 4px;
padding: 2px 4px 2px 8px;
}
mr-issue-star {
margin-right: 4px;
}
</style>
<link href="https://fonts.googleapis.com/icon?family=Material+Icons"
rel="stylesheet">
<form id="editForm"
@submit=${this._save}
@keydown=${this._saveOnCtrlEnter}
>
<mr-cue cuePrefName=${cueNames.CODE_OF_CONDUCT}></mr-cue>
${this._renderStarLine()}
<textarea
id="commentText"
placeholder="Add a comment"
@keyup=${this._processChanges}
aria-label="Comment"
></textarea>
${(this._renderMarkdown)
? html`
<div class="markdown-preview preview-height-comment">
<div class="markdown">
${unsafeHTML(renderMarkdown(this.getCommentContent()))}
</div>
</div>`: ''}
<mr-upload
?hidden=${this.disableAttachments}
@change=${this._processChanges}
></mr-upload>
<div class="input-grid">
${this._renderEditFields()}
${this._renderErrorsAndWarnings()}
<span></span>
<div class="edit-actions">
<chops-button
@click=${this._save}
class="save-changes emphasized"
?disabled=${this.disabled}
title="Save changes (Ctrl+Enter / \u2318+Enter)"
>
Save changes
</chops-button>
<chops-button
@click=${this.discard}
class="de-emphasized discard-button"
?disabled=${this.disabled}
>
Discard
</chops-button>
<chops-checkbox
id="sendEmail"
@checked-change=${this._sendEmailChecked}
?checked=${this.sendEmail}
>Send email</chops-checkbox>
</div>
${!this.isApproval ? this._renderPresubmitChanges() : ''}
</div>
</form>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderStarLine() {
if (this._canEditIssue || this.isApproval) return '';
return html`
<div class="star-line">
<mr-issue-star
.issueRef=${this.issueRef}
></mr-issue-star>
<span>
${this.isStarred ? `
You have voted for this issue and will receive notifications.
` : `
Star this issue instead of commenting "+1 Me too!" to add a vote
and get notifications.`}
</span>
</div>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderPresubmitChanges() {
const {derivedCcs, derivedLabels} = this.presubmitResponse || {};
const hasCcs = derivedCcs && derivedCcs.length;
const hasLabels = derivedLabels && derivedLabels.length;
const hasDerivedValues = hasCcs || hasLabels;
return html`
${hasDerivedValues ? html`
<span></span>
<div class="presubmit-derived-header">
Filter rules and components will add
</div>
` : ''}
${hasCcs? html`
<label
for="derived-ccs"
class="presubmit-derived-header"
>CC:</label>
<div id="derived-ccs">
${derivedCcs.map((cc) => html`
<span
title=${cc.why}
class="presubmit-derived"
>${cc.value}</span>
`)}
</div>
` : ''}
${hasLabels ? html`
<label
for="derived-labels"
class="presubmit-derived-header"
>Labels:</label>
<div id="derived-labels">
${derivedLabels.map((label) => html`
<span
title=${label.why}
class="presubmit-derived"
>${label.value}</span>
`)}
</div>
` : ''}
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderErrorsAndWarnings() {
const presubmitResponse = this.presubmitResponse || {};
const presubmitWarnings = presubmitResponse.warnings || [];
const presubmitErrors = presubmitResponse.errors || [];
return (this.error || presubmitWarnings.length || presubmitErrors.length) ?
html`
<span></span>
<div>
${presubmitWarnings.map((warning) => html`
<mr-warning title=${warning.why}>${warning.value}</mr-warning>
`)}
<!-- TODO(ehmaldonado): Look into blocking submission on presubmit
-->
${presubmitErrors.map((error) => html`
<mr-error title=${error.why}>${error.value}</mr-error>
`)}
${this.error ? html`
<mr-error>${this.error}</mr-error>` : ''}
</div>
` : '';
}
/**
* @return {TemplateResult}
* @private
*/
_renderEditFields() {
if (this.isApproval) {
return html`
${this._renderStatus()}
${this._renderApprovers()}
${this._renderFieldDefs()}
${this._renderNicheFieldToggle()}
`;
}
return html`
${this._canEditSummary ? this._renderSummary() : ''}
${this._canEditStatus ? this._renderStatus() : ''}
${this._canEditOwner ? this._renderOwner() : ''}
${this._canEditCC ? this._renderCC() : ''}
${this._canEditIssue ? html`
${this._renderComponents()}
${this._renderFieldDefs()}
${this._renderRelatedIssues()}
${this._renderLabels()}
${this._renderNicheFieldToggle()}
` : ''}
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderSummary() {
return html`
<label for="summaryInput">Summary:</label>
<input
id="summaryInput"
value=${this.summary}
@keyup=${this._processChanges}
/>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderOwner() {
const ownerPresubmit = this._ownerPresubmit;
return html`
<label for="ownerInput">
${ownerPresubmit.message ? html`
<i
class=${`material-icons inline-${ownerPresubmit.icon}`}
title=${ownerPresubmit.message}
>${ownerPresubmit.icon}</i>
` : ''}
Owner:
</label>
<mr-react-autocomplete
label="ownerInput"
vocabularyName="owner"
.placeholder=${ownerPresubmit.placeholder}
.value=${this._values.owner}
.onChange=${this._changeHandlers.owner}
></mr-react-autocomplete>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderCC() {
return html`
<label for="ccInput">CC:</label>
<mr-react-autocomplete
label="ccInput"
vocabularyName="member"
.multiple=${true}
.fixedValues=${this._derivedCCs}
.value=${this._values.cc}
.onChange=${this._changeHandlers.cc}
></mr-react-autocomplete>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderComponents() {
return html`
<label for="componentsInput">Components:</label>
<mr-react-autocomplete
label="componentsInput"
vocabularyName="component"
.multiple=${true}
.value=${this._values.components}
.onChange=${this._changeHandlers.components}
></mr-react-autocomplete>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderApprovers() {
return this.hasApproverPrivileges && this.isApproval ? html`
<label for="approversInput_react">Approvers:</label>
<mr-edit-field
id="approversInput"
label="approversInput_react"
.type=${'USER_TYPE'}
.initialValues=${filteredUserDisplayNames(this.approvers)}
.name=${'approver'}
.acType=${'member'}
@change=${this._processChanges}
multi
></mr-edit-field>
` : '';
}
/**
* @return {TemplateResult}
* @private
*/
_renderStatus() {
return this.statuses && this.statuses.length ? html`
<label for="statusInput">Status:</label>
<mr-edit-status
id="statusInput"
.initialStatus=${this.status}
.statuses=${this.statuses}
.mergedInto=${issueRefToString(this.mergedInto, this.projectName)}
?isApproval=${this.isApproval}
@change=${this._processChanges}
></mr-edit-status>
` : '';
}
/**
* @return {TemplateResult}
* @private
*/
_renderFieldDefs() {
return html`
${fieldDefsWithGroup(this.fieldDefs, this.fieldGroups, this.issueType).map((group) => html`
<fieldset class="group">
<legend>${group.groupName}</legend>
<div class="input-grid">
${group.fieldDefs.map((field) => this._renderCustomField(field))}
</div>
</fieldset>
`)}
${fieldDefsWithoutGroup(this.fieldDefs, this.fieldGroups, this.issueType).map((field) => this._renderCustomField(field))}
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderRelatedIssues() {
return html`
<label for="blockedOnInput">BlockedOn:</label>
<mr-react-autocomplete
label="blockedOnInput"
vocabularyName="component"
.multiple=${true}
.value=${this._values.blockedOn}
.onChange=${this._changeHandlers.blockedOn}
></mr-react-autocomplete>
<label for="blockingInput">Blocking:</label>
<mr-react-autocomplete
label="blockingInput"
vocabularyName="component"
.multiple=${true}
.value=${this._values.blocking}
.onChange=${this._changeHandlers.blocking}
></mr-react-autocomplete>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderLabels() {
return html`
<label for="labelsInput">Labels:</label>
<mr-react-autocomplete
label="labelsInput"
vocabularyName="label"
.multiple=${true}
.fixedValues=${this.derivedLabels}
.value=${this._values.labels}
.onChange=${this._changeHandlers.labels}
></mr-react-autocomplete>
`;
}
/**
* @return {TemplateResult}
* @param {FieldDef} field The custom field beinf rendered.
* @private
*/
_renderCustomField(field) {
if (!field || !field.fieldRef) return '';
const userCanEdit = this._userCanEdit(field);
const {fieldRef, isNiche, docstring, isMultivalued} = field;
const isHidden = (!this.showNicheFields && isNiche) || !userCanEdit;
let acType;
if (fieldRef.type === fieldTypes.USER_TYPE) {
acType = isMultivalued ? 'member' : 'owner';
}
return html`
<label
?hidden=${isHidden}
for=${this._idForField(fieldRef.fieldName) + '_react'}
title=${docstring}
>
${fieldRef.fieldName}:
</label>
<mr-edit-field
?hidden=${isHidden}
id=${this._idForField(fieldRef.fieldName)}
.label=${this._idForField(fieldRef.fieldName) + '_react'}
.name=${fieldRef.fieldName}
.type=${fieldRef.type}
.options=${this._optionsForField(this.optionsPerEnumField, this.fieldValueMap, fieldRef.fieldName, this.phaseName)}
.initialValues=${valuesForField(this.fieldValueMap, fieldRef.fieldName, this.phaseName)}
.acType=${acType}
?multi=${isMultivalued}
@change=${this._processChanges}
></mr-edit-field>
`;
}
/**
* @return {TemplateResult}
* @private
*/
_renderNicheFieldToggle() {
return this._nicheFieldCount ? html`
<span></span>
<button type="button" class="toggle" @click=${this.toggleNicheFields}>
<span ?hidden=${this.showNicheFields}>
Show all fields (${this._nicheFieldCount} currently hidden)
</span>
<span ?hidden=${!this.showNicheFields}>
Hide niche fields (${this._nicheFieldCount} currently shown)
</span>
</button>
` : '';
}
/** @override */
static get properties() {
return {
fieldDefs: {type: Array},
formName: {type: String},
approvers: {type: Array},
setter: {type: Object},
summary: {type: String},
cc: {type: Array, hasChanged: _notDeepEqual},
components: {type: Array, hasChanged: _notDeepEqual},
status: {type: String},
statuses: {type: Array},
blockedOn: {type: Array, hasChanged: _notDeepEqual},
blocking: {type: Array, hasChanged: _notDeepEqual},
mergedInto: {type: Object},
ownerName: {type: String, hasChanged: _notDeepEqual},
labelNames: {type: Array, hasChanged: _notDeepEqual},
derivedLabels: {type: Array},
_permissions: {type: Array},
phaseName: {type: String},
projectConfig: {type: Object},
projectName: {type: String, hasChanged: _notDeepEqual},
isApproval: {type: Boolean},
isStarred: {type: Boolean},
issuePermissions: {type: Object},
issueRef: {type: Object},
hasApproverPrivileges: {type: Boolean},
showNicheFields: {type: Boolean},
disableAttachments: {type: Boolean},
error: {type: String},
sendEmail: {type: Boolean},
presubmitResponse: {type: Object},
fieldValueMap: {type: Object},
issueType: {type: String},
optionsPerEnumField: {type: String},
fieldGroups: {type: Object},
prefs: {type: Object},
saving: {type: Boolean},
isDirty: {type: Boolean},
_values: {type: Object},
_initialValues: {type: Object},
};
}
/** @override */
constructor() {
super();
this.summary = '';
this.ownerName = '';
this.sendEmail = true;
this.mergedInto = {};
this.issueRef = {};
this.fieldGroups = HARDCODED_FIELD_GROUPS;
this._permissions = {};
this.saving = false;
this.isDirty = false;
this.prefs = {};
this._values = {};
this._initialValues = {};
// Memoize change handlers so property updates don't cause excess rerenders.
this._changeHandlers = {
owner: this._onChange.bind(this, 'owner'),
cc: this._onChange.bind(this, 'cc'),
components: this._onChange.bind(this, 'components'),
labels: this._onChange.bind(this, 'labels'),
blockedOn: this._onChange.bind(this, 'blockedOn'),
blocking: this._onChange.bind(this, 'blocking'),
};
}
/** @override */
createRenderRoot() {
return this;
}
/** @override */
firstUpdated() {
this.hasRendered = true;
}
/** @override */
updated(changedProperties) {
if (changedProperties.has('ownerName') || changedProperties.has('cc')
|| changedProperties.has('components')
|| changedProperties.has('labelNames')
|| changedProperties.has('blockedOn')
|| changedProperties.has('blocking')
|| changedProperties.has('projectName')) {
this._initialValues.owner = this.ownerName;
this._initialValues.cc = this._ccNames;
this._initialValues.components = componentRefsToStrings(this.components);
this._initialValues.labels = this.labelNames;
this._initialValues.blockedOn = issueRefsToStrings(this.blockedOn, this.projectName);
this._initialValues.blocking = issueRefsToStrings(this.blocking, this.projectName);
this._values = {...this._initialValues};
}
}
/**
* Getter for checking if the user has Markdown enabled.
* @return {boolean} Whether Markdown preview should be rendered or not.
*/
get _renderMarkdown() {
if (!this.getCommentContent()) {
return false;
}
const enabled = this.prefs.get('render_markdown');
return shouldRenderMarkdown({project: this.projectName, enabled});
}
/**
* @return {boolean} Whether the "Save changes" button is disabled.
*/
get disabled() {
return !this.isDirty || this.saving;
}
/**
* Set isDirty to a property instead of only using a getter to cause
* lit-element to re-render when dirty state change.
*/
_updateIsDirty() {
if (!this.hasRendered) return;
const commentContent = this.getCommentContent();
const attachmentsElement = this.querySelector('mr-upload');
this.isDirty = !isEmptyObject(this.delta) || Boolean(commentContent) ||
attachmentsElement.hasAttachments;
}
get _nicheFieldCount() {
const fieldDefs = this.fieldDefs || [];
return fieldDefs.reduce((acc, fd) => acc + (fd.isNiche | 0), 0);
}
get _canEditIssue() {
const issuePermissions = this.issuePermissions || [];
return issuePermissions.includes(ISSUE_EDIT_PERMISSION);
}
get _canEditSummary() {
const issuePermissions = this.issuePermissions || [];
return this._canEditIssue ||
issuePermissions.includes(ISSUE_EDIT_SUMMARY_PERMISSION);
}
get _canEditStatus() {
const issuePermissions = this.issuePermissions || [];
return this._canEditIssue ||
issuePermissions.includes(ISSUE_EDIT_STATUS_PERMISSION);
}
get _canEditOwner() {
const issuePermissions = this.issuePermissions || [];
return this._canEditIssue ||
issuePermissions.includes(ISSUE_EDIT_OWNER_PERMISSION);
}
get _canEditCC() {
const issuePermissions = this.issuePermissions || [];
return this._canEditIssue ||
issuePermissions.includes(ISSUE_EDIT_CC_PERMISSION);
}
/**
* @return {Array<string>}
*/
get _ccNames() {
const users = this.cc || [];
return filteredUserDisplayNames(users.filter((u) => !u.isDerived));
}
get _derivedCCs() {
const users = this.cc || [];
return filteredUserDisplayNames(users.filter((u) => u.isDerived));
}
get _ownerPresubmit() {
const response = this.presubmitResponse;
if (!response) return {};
const ownerView = {message: '', placeholder: '', icon: ''};
if (response.ownerAvailability) {
ownerView.message = response.ownerAvailability;
ownerView.icon = 'warning';
} else if (response.derivedOwners && response.derivedOwners.length) {
ownerView.placeholder = response.derivedOwners[0].value;
ownerView.message = response.derivedOwners[0].why;
ownerView.icon = 'info';
}
return ownerView;
}
/** @override */
stateChanged(state) {
this.fieldValueMap = issueV0.fieldValueMap(state);
this.issueType = issueV0.type(state);
this.issueRef = issueV0.viewedIssueRef(state);
this._permissions = permissions.byName(state);
this.presubmitResponse = issueV0.presubmitResponse(state);
this.projectConfig = projectV0.viewedConfig(state);
this.projectName = issueV0.viewedIssueRef(state).projectName;
this.issuePermissions = issueV0.permissions(state);
this.optionsPerEnumField = projectV0.optionsPerEnumField(state);
// Access boolean value from allStarredIssues
const starredIssues = issueV0.starredIssues(state);
this.isStarred = starredIssues.has(issueRefToString(this.issueRef));
this.prefs = userV0.prefs(state);
}
/** @override */
disconnectedCallback() {
super.disconnectedCallback();
store.dispatch(ui.reportDirtyForm(this.formName, false));
}
/**
* Resets the edit form values to their default values.
*/
async reset() {
this._values = {...this._initialValues};
const form = this.querySelector('#editForm');
if (!form) return;
form.reset();
const statusInput = this.querySelector('#statusInput');
if (statusInput) {
statusInput.reset();
}
// Since custom elements containing <input> elements have the inputs
// wrapped in ShadowDOM, those inputs don't get reset with the rest of
// the form. Haven't been able to figure out a way to replicate form reset
// behavior with custom input elements.
if (this.isApproval) {
if (this.hasApproverPrivileges) {
const approversInput = this.querySelector(
'#approversInput');
if (approversInput) {
approversInput.reset();
}
}
}
this.querySelectorAll('mr-edit-field').forEach((el) => {
el.reset();
});
const uploader = this.querySelector('mr-upload');
if (uploader) {
uploader.reset();
}
// TODO(dtu, zhangtiff): Remove once all form fields are controlled.
await this.updateComplete;
this._processChanges();
}
/**
* @param {MouseEvent|SubmitEvent} event
* @private
*/
_save(event) {
event.preventDefault();
this.save();
}
/**
* Users may use either Ctrl+Enter or Command+Enter to save an issue edit
* while the issue edit form is focused.
* @param {KeyboardEvent} event
* @private
*/
_saveOnCtrlEnter(event) {
if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
event.preventDefault();
this.save();
}
}
/**
* Tells the parent to save the current edited values in the form.
* @fires CustomEvent#save
*/
save() {
this.dispatchEvent(new CustomEvent('save'));
}
/**
* Tells the parent component that the user is trying to discard the form,
* if they confirm that that's what they're doing. The parent decides what
* to do in order to quit the editing session.
* @fires CustomEvent#discard
*/
discard() {
const isDirty = this.isDirty;
if (!isDirty || confirm('Discard your changes?')) {
this.dispatchEvent(new CustomEvent('discard'));
}
}
/**
* Focuses the comment form.
*/
async focus() {
await this.updateComplete;
this.querySelector('#commentText').focus();
}
/**
* Retrieves the value of the comment that the user added from the DOM.
* @return {string}
*/
getCommentContent() {
if (!this.querySelector('#commentText')) {
return '';
}
return this.querySelector('#commentText').value;
}
async getAttachments() {
try {
return await this.querySelector('mr-upload').loadFiles();
} catch (e) {
this.error = `Error while loading file for attachment: ${e.message}`;
}
}
/**
* @param {FieldDef} field
* @return {boolean}
* @private
*/
_userCanEdit(field) {
const fieldName = fieldDefToName(this.projectName, field);
if (!this._permissions[fieldName] ||
!this._permissions[fieldName].permissions) return false;
const userPerms = this._permissions[fieldName].permissions;
return userPerms.includes(permissions.FIELD_DEF_VALUE_EDIT);
}
/**
* Shows or hides custom fields with the "isNiche" attribute set to true.
*/
toggleNicheFields() {
this.showNicheFields = !this.showNicheFields;
}
/**
* @return {IssueDelta}
* @throws {UserInputError}
*/
get delta() {
try {
this.error = '';
return this._getDelta();
} catch (e) {
if (!(e instanceof UserInputError)) throw e;
this.error = e.message;
return {};
}
}
/**
* Generates a change between the initial Issue state and what the user
* inputted.
* @return {IssueDelta}
*/
_getDelta() {
let result = {};
const {projectName, localId} = this.issueRef;
const statusInput = this.querySelector('#statusInput');
if (this._canEditStatus && statusInput) {
const statusDelta = statusInput.delta;
if (statusDelta.mergedInto) {
result.mergedIntoRef = issueStringToBlockingRef(
{projectName, localId}, statusDelta.mergedInto);
}
if (statusDelta.status) {
result.status = statusDelta.status;
}
}
if (this.isApproval) {
if (this._canEditIssue && this.hasApproverPrivileges) {
result = {
...result,
...this._changedValuesDom(
'approvers', 'approverRefs', displayNameToUserRef),
};
}
} else {
// TODO(zhangtiff): Consider representing baked-in fields such as owner,
// cc, and status similarly to custom fields to reduce repeated code.
if (this._canEditSummary) {
const summaryInput = this.querySelector('#summaryInput');
if (summaryInput) {
const newSummary = summaryInput.value;
if (newSummary !== this.summary) {
result.summary = newSummary;
}
}
}
if (this._values.owner !== this._initialValues.owner) {
result.ownerRef = displayNameToUserRef(this._values.owner);
}
const blockerAddFn = (refString) =>
issueStringToBlockingRef({projectName, localId}, refString);
const blockerRemoveFn = (refString) =>
issueStringToRef(refString, projectName);
result = {
...result,
...this._changedValuesControlled(
'cc', 'ccRefs', displayNameToUserRef),
...this._changedValuesControlled(
'components', 'compRefs', componentStringToRef),
...this._changedValuesControlled(
'labels', 'labelRefs', labelStringToRef),
...this._changedValuesControlled(
'blockedOn', 'blockedOnRefs', blockerAddFn, blockerRemoveFn),
...this._changedValuesControlled(
'blocking', 'blockingRefs', blockerAddFn, blockerRemoveFn),
};
}
if (this._canEditIssue) {
const fieldDefs = this.fieldDefs || [];
fieldDefs.forEach(({fieldRef}) => {
const {fieldValsAdd = [], fieldValsRemove = []} =
this._changedValuesDom(fieldRef.fieldName, 'fieldVals',
valueToFieldValue.bind(null, fieldRef));
// Because multiple custom fields share the same "fieldVals" key in
// delta, we hav to make sure to concatenate updated delta values with
// old delta values.
if (fieldValsAdd.length) {
result.fieldValsAdd = [...(result.fieldValsAdd || []),
...fieldValsAdd];
}
if (fieldValsRemove.length) {
result.fieldValsRemove = [...(result.fieldValsRemove || []),
...fieldValsRemove];
}
});
}
return result;
}
/**
* Computes delta values for a controlled input.
* @param {string} fieldName The key in the values property to retrieve data.
* from.
* @param {string} responseKey The key in the delta Object that changes will be
* saved in.
* @param {function(string): any} addFn A function to specify how to format
* the message for a given added field.
* @param {function(string): any} removeFn A function to specify how to format
* the message for a given removed field.
* @return {Object} delta fragment for added and removed values.
*/
_changedValuesControlled(fieldName, responseKey, addFn, removeFn) {
const values = this._values[fieldName];
const initialValues = this._initialValues[fieldName];
const valuesAdd = arrayDifference(values, initialValues, equalsIgnoreCase);
const valuesRemove =
arrayDifference(initialValues, values, equalsIgnoreCase);
return this._changedValues(valuesAdd, valuesRemove, responseKey, addFn, removeFn);
}
/**
* Gets changes values when reading from a legacy <mr-edit-field> element.
* @param {string} fieldName Name of the form input we're checking values on.
* @param {string} responseKey The key in the delta Object that changes will be
* saved in.
* @param {function(string): any} addFn A function to specify how to format
* the message for a given added field.
* @param {function(string): any} removeFn A function to specify how to format
* the message for a given removed field.
* @return {Object} delta fragment for added and removed values.
*/
_changedValuesDom(fieldName, responseKey, addFn, removeFn) {
const input = this.querySelector(`#${this._idForField(fieldName)}`);
if (!input) return;
const valuesAdd = input.getValuesAdded();
const valuesRemove = input.getValuesRemoved();
return this._changedValues(valuesAdd, valuesRemove, responseKey, addFn, removeFn);
}
/**
* Shared helper function for computing added and removed values for a
* single field in a delta.
* @param {Array<string>} valuesAdd The added values. For example, new CCed
* users.
* @param {Array<string>} valuesRemove Values that were removed in this edit.
* @param {string} responseKey The key in the delta Object that changes will be
* saved in.
* @param {function(string): any} addFn A function to specify how to format
* the message for a given added field.
* @param {function(string): any} removeFn A function to specify how to format
* the message for a given removed field.
* @return {Object} delta fragment for added and removed values.
*/
_changedValues(valuesAdd, valuesRemove, responseKey, addFn, removeFn) {
const delta = {};
if (valuesAdd && valuesAdd.length) {
delta[responseKey + 'Add'] = valuesAdd.map(addFn);
}
if (valuesRemove && valuesRemove.length) {
delta[responseKey + 'Remove'] = valuesRemove.map(removeFn || addFn);
}
return delta;
}
/**
* Generic onChange handler to be bound to each form field.
* @param {string} key Unique name for the form field we're binding this
* handler to. For example, 'owner', 'cc', or the name of a custom field.
* @param {Event} event
* @param {string|Array<string>} value The new form value.
* @param {*} _reason
*/
_onChange(key, event, value, _reason) {
this._values = {...this._values, [key]: value};
this._processChanges(event);
}
/**
* Event handler for running filter rules presubmit logic.
* @param {Event} e
*/
_processChanges(e) {
if (e instanceof KeyboardEvent) {
if (NON_EDITING_KEY_EVENTS.has(e.key)) return;
}
this._updateIsDirty();
store.dispatch(ui.reportDirtyForm(this.formName, this.isDirty));
this.dispatchEvent(new CustomEvent('change', {
detail: {
delta: this.delta,
commentContent: this.getCommentContent(),
},
}));
}
_idForField(name) {
return `${name}Input`;
}
_optionsForField(optionsPerEnumField, fieldValueMap, fieldName, phaseName) {
if (!optionsPerEnumField || !fieldName) return [];
const key = fieldName.toLowerCase();
if (!optionsPerEnumField.has(key)) return [];
const options = [...optionsPerEnumField.get(key)];
const values = valuesForField(fieldValueMap, fieldName, phaseName);
values.forEach((v) => {
const optionExists = options.find(
(opt) => equalsIgnoreCase(opt.optionName, v));
if (!optionExists) {
// Note that enum fields which are not explicitly defined can be set,
// such as in the case when an issue is moved.
options.push({optionName: v});
}
});
return options;
}
_sendEmailChecked(evt) {
this.sendEmail = evt.detail.checked;
}
}
function _notDeepEqual(a, b) {
return !deepEqual(a, b);
}
customElements.define('mr-edit-metadata', MrEditMetadata);