@momentum-design/components 0.18.4 → 0.18.6

package/dist/components/input/input.component.js

@@ -0,0 +1,401 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { html, nothing } from 'lit';
+import { property, query } from 'lit/decorators.js';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import styles from './input.styles';
+import FormfieldWrapper from '../formfieldwrapper';
+import { NameMixin } from '../../utils/mixins/NameMixin';
+import { AUTO_CAPITALIZE, DEFAULTS, PREFIX_TEXT_OPTIONS } from './input.constants';
+import { ValueMixin } from '../../utils/mixins/ValueMixin';
+import { DataAriaLabelMixin } from '../../utils/mixins/DataAriaLabelMixin';
+/**
+ * mdc-input is a component that allows users to input text.
+ *  It contains:
+ * - label field - describe the input field.
+ * - input field - contains the value
+ * - help text or validation message - displayed below the input field.
+ * - trailing button - it displays a clear the input field.
+ * - prefix text - displayed before the input field.
+ * - leading icon - displayed before the input field.
+ * - clear-aria-label - aria label for the trailing button.
+ * - all the attributes of the input field.
+ *
+ * @tagname mdc-input
+ *
+ * @dependency mdc-icon
+ * @dependency mdc-text
+ * @dependency mdc-button
+ *
+ * @cssproperty --mdc-input-disabled-border-color - Border color for the input container when disabled
+ * @cssproperty --mdc-input-disabled-text-color - Text color for the input field when disabled
+ * @cssproperty --mdc-input-disabled-background-color - Background color for the input field when disabled
+ * @cssproperty --mdc-input-border-color - Border color for the input container
+ * @cssproperty --mdc-input-text-color - Text color for the input field
+ * @cssproperty --mdc-input-background-color - Background color for the input field
+ * @cssproperty --mdc-input-selection-background-color - Background color for the selected text
+ * @cssproperty --mdc-input-selection-text-color - Text color for the selected text
+ * @cssproperty --mdc-input-support-text-color - Text color for the help text
+ * @cssproperty --mdc-input-hover-background-color - Background color for the input field when hovered
+ * @cssproperty --mdc-input-focused-background-color - Background color for the input field when focused
+ * @cssproperty --mdc-input-focused-border-color - Border color for the input container when focused
+ * @cssproperty --mdc-input-error-border-color - Border color for the input container when error
+ * @cssproperty --mdc-input-warning-border-color - Border color for the input container when warning
+ * @cssproperty --mdc-input-success-border-color - Border color for the input container when success
+ * @cssproperty --mdc-input-primary-border-color - Border color for the input container when primary
+ *
+ */
+class Input extends DataAriaLabelMixin(ValueMixin(NameMixin(FormfieldWrapper))) {
+    checkValidity() {
+        this.setValidityFromInput();
+        return this.internals.checkValidity();
+    }
+    reportValidity() {
+        this.setValidityFromInput();
+        return this.internals.reportValidity();
+    }
+    /** @internal */
+    get form() {
+        return this.internals.form;
+    }
+    constructor() {
+        super();
+        /**
+         * The placeholder text that is displayed when the input field is empty.
+         */
+        this.placeholder = '';
+        /**
+         * required attribute of the input field.
+         * If true, the consumer should indicate it on the label that the input field is required.
+         */
+        this.required = false;
+        /**
+         * readonly attribute of the input field. If true, the input field is read-only.
+         */
+        this.readonly = false;
+        /**
+         * The trailing button when set to true, shows a clear button that clears the input field.
+         * @default false
+         */
+        this.trailingButton = false;
+        /**
+         * The autocapitalize attribute of the input field.
+         * @default 'off'
+         */
+        this.autocapitalize = AUTO_CAPITALIZE.OFF;
+        /**
+         * The autocomplete attribute of the input field.
+         * @default 'off'
+         */
+        this.autocomplete = 'off';
+        /**
+         * If true, the input field is focused when the component is rendered.
+         * @default false
+         */
+        this.autofocus = false;
+        /**
+         * Aria label for the trailing button. If trailing button is set to true, this label is used for the clear button.
+         * @default ''
+         */
+        this.clearAriaLabel = '';
+        /** @internal */
+        this.internals = this.attachInternals();
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.updateComplete.then(() => {
+            if (this.inputElement) {
+                this.inputElement.checkValidity();
+                this.setValidityFromInput();
+                this.internals.setFormValue(this.inputElement.value);
+            }
+        }).catch((error) => {
+            if (this.onerror) {
+                this.onerror(error);
+            }
+        });
+    }
+    updated(changedProperties) {
+        super.updated(changedProperties);
+        if (changedProperties.has('value')) {
+            this.handleValueChange();
+        }
+    }
+    /**
+   * Handles the value change of the input field.
+   * Sets the form value and updates the validity of the input field.
+   * @returns void
+   */
+    handleValueChange() {
+        this.internals.setFormValue(this.value);
+        this.updateComplete.then(() => {
+            this.setValidityFromInput();
+        }).catch((error) => {
+            if (this.onerror) {
+                this.onerror(error);
+            }
+        });
+    }
+    /**
+   * This function is called when the attribute changes.
+   * It updates the validity of the input field based on the input field's validity.
+   *
+   * @param name - attribute name
+   * @param old - old value
+   * @param value - new value
+   */
+    attributeChangedCallback(name, old, value) {
+        super.attributeChangedCallback(name, old, value);
+        const validationRelatedAttributes = [
+            'maxlength',
+            'minlength',
+            'pattern',
+            'required',
+        ];
+        if (validationRelatedAttributes.includes(name)) {
+            this.updateComplete.then(() => {
+                this.setValidityFromInput();
+            }).catch((error) => {
+                if (this.onerror) {
+                    this.onerror(error);
+                }
+            });
+        }
+    }
+    /**
+   * Sets the validity of the input field based on the input field's validity.
+   * @returns void
+   */
+    setValidityFromInput() {
+        if (this.inputElement) {
+            this.internals.setValidity(this.inputElement.validity, this.inputElement.validationMessage, this.inputElement);
+        }
+    }
+    /**
+   * Updates the value of the input field.
+   * Sets the form value.
+   * @returns void
+   */
+    updateValue() {
+        this.value = this.inputElement.value;
+        this.internals.setFormValue(this.inputElement.value);
+    }
+    /**
+   * Handles the input event of the input field.
+   * Updates the value and sets the validity of the input field.
+   *
+   */
+    onInput() {
+        this.updateValue();
+        this.setValidityFromInput();
+    }
+    /**
+   * Handles the change event of the input field.
+   * Updates the value and sets the validity of the input field.
+   *
+   * The 'change' event does not bubble up through the shadow DOM as it was not composed.
+   * Therefore, we need to re-dispatch the same event to ensure it is propagated correctly.
+   * Read more: https://developer.mozilla.org/en-US/docs/Web/API/Event/composed
+   *
+   * @param event - Event which contains information about the value change.
+   */
+    onChange(event) {
+        this.updateValue();
+        this.setValidityFromInput();
+        const EventConstructor = event.constructor;
+        this.dispatchEvent(new EventConstructor(event.type, event));
+    }
+    /**
+   * Renders the leading icon before the input field.
+   * If the leading icon is not set, it will not be displayed.
+   *
+   * @returns void
+   */
+    renderLeadingIcon() {
+        if (!this.leadingIcon) {
+            return nothing;
+        }
+        return html `
+      <mdc-icon 
+        class="leading-icon" 
+        part="leading-icon"
+        name=${this.leadingIcon} 
+        size="${DEFAULTS.ICON_SIZE_VALUE}" 
+        length-unit="${DEFAULTS.ICON_SIZE_UNIT}">
+      </mdc-icon>
+    `;
+    }
+    /**
+   * Renders the prefix text before the input field.
+   * If the prefix text is more than 10 characters,
+   * - it will not be displayed.
+   * - the validation messsage will be displayed.
+   *
+   *  Note: We are setting aria-hidden so that the screen reader does not read the prefix text.
+   *  The consumers should set the appropriate aria-label for the input field using 'data-aria-label' attribute.
+   * @returns void
+   */
+    renderPrefixText() {
+        if (!this.prefixText) {
+            return nothing;
+        }
+        return html `
+      <mdc-text 
+        class="prefix-text" 
+        tagname="${DEFAULTS.PREFIX_TEXT_TAG}" 
+        type="${DEFAULTS.PREFIX_TEXT_TYPE}"
+        aria-hidden="true"
+      >
+        ${this.prefixText.slice(0, PREFIX_TEXT_OPTIONS.MAX_LENGTH)}
+      </mdc-text>
+    `;
+    }
+    /**
+   * Clears the input field.
+   */
+    clearInputText() {
+        var _a;
+        this.value = '';
+        // focus the input field after clearing the text
+        (_a = this.inputElement) === null || _a === void 0 ? void 0 : _a.focus();
+    }
+    /**
+   * Renders the trailing button to clear the input field if the trailingButton is set to true.
+   * @returns void
+   */
+    renderTrailingButton() {
+        if (!this.trailingButton) {
+            return nothing;
+        }
+        return html `
+      <mdc-button 
+        class='${!this.value ? 'hidden' : ''}'
+        prefix-icon='${DEFAULTS.CLEAR_BUTTON_ICON}'
+        variant='${DEFAULTS.CLEAR_BUTTON_VARIANT}'
+        size="${DEFAULTS.CLEAR_BUTTON_SIZE}"
+        aria-label="${this.clearAriaLabel}"
+        @click=${this.clearInputText}
+        ?disabled=${this.disabled || this.readonly || !this.value}
+      ></mdc-button>
+    `;
+    }
+    render() {
+        var _a;
+        return html `
+      ${this.renderLabel()}
+      <div class="input-container mdc-focus-ring" part="input-container">
+        <slot name="input-leading-icon">${this.renderLeadingIcon()}</slot>
+       <div class="input-section" part="input-section">
+       <slot name="input-prefix-text">${this.renderPrefixText()}</slot>
+        <slot name="input">
+          <input 
+            aria-label="${(_a = this.dataAriaLabel) !== null && _a !== void 0 ? _a : ''}"
+            class='input'
+            part='input'
+            id="${this.id}"
+            name="${this.name}"
+            .value="${this.value}"
+            ?disabled="${this.disabled}"
+            ?readonly="${this.readonly}"
+            ?required="${this.required}"
+            type="text"
+            placeholder=${ifDefined(this.placeholder)}
+            minlength=${ifDefined(this.minlength)}
+            maxlength=${ifDefined(this.maxlength)}
+            autocapitalize=${this.autocapitalize}
+            autocomplete=${this.autocomplete}
+            ?autofocus="${this.autofocus}"
+            dirname=${ifDefined(this.dirname)}
+            pattern=${ifDefined(this.pattern)}
+            list=${ifDefined(this.list)}
+            size=${ifDefined(this.size)}
+            @input=${this.onInput}
+            @change=${this.onChange}
+          />
+        </slot>
+       </div>
+        <slot name="trailing-button">${this.renderTrailingButton()}</slot>
+      </div>
+      ${this.helpText ? this.renderHelperText() : nothing}
+    `;
+    }
+}
+/** @internal */
+Input.formAssociated = true;
+Input.styles = [...FormfieldWrapper.styles, ...styles];
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", Object)
+], Input.prototype, "placeholder", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], Input.prototype, "required", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], Input.prototype, "readonly", void 0);
+__decorate([
+    property({ type: String, attribute: 'prefix-text' }),
+    __metadata("design:type", String)
+], Input.prototype, "prefixText", void 0);
+__decorate([
+    property({ type: String, attribute: 'leading-icon' }),
+    __metadata("design:type", String)
+], Input.prototype, "leadingIcon", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'trailing-button' }),
+    __metadata("design:type", Object)
+], Input.prototype, "trailingButton", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Number)
+], Input.prototype, "maxlength", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Number)
+], Input.prototype, "minlength", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], Input.prototype, "autocapitalize", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", Object)
+], Input.prototype, "autocomplete", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], Input.prototype, "autofocus", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], Input.prototype, "dirname", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], Input.prototype, "pattern", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], Input.prototype, "list", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Object)
+], Input.prototype, "size", void 0);
+__decorate([
+    property({ type: String, attribute: 'clear-aria-label' }),
+    __metadata("design:type", Object)
+], Input.prototype, "clearAriaLabel", void 0);
+__decorate([
+    query('input'),
+    __metadata("design:type", HTMLInputElement)
+], Input.prototype, "inputElement", void 0);
+export default Input;

package/dist/components/input/input.constants.d.ts

@@ -0,0 +1,25 @@
+declare const TAG_NAME: "mdc-input";
+declare const AUTO_CAPITALIZE: {
+    readonly OFF: "off";
+    readonly NONE: "none";
+    readonly ON: "on";
+    readonly SENTENCES: "sentences";
+    readonly WORDS: "words";
+    readonly CHARACTERS: "characters";
+};
+declare const PREFIX_TEXT_OPTIONS: {
+    MAX_LENGTH: number;
+    HELPERTEXT: string;
+    VALIDATION: "error";
+};
+declare const DEFAULTS: {
+    VALIDATION: "default";
+    ICON_SIZE_VALUE: number;
+    ICON_SIZE_UNIT: string;
+    CLEAR_BUTTON_ICON: string;
+    CLEAR_BUTTON_VARIANT: "tertiary";
+    CLEAR_BUTTON_SIZE: 20;
+    PREFIX_TEXT_TYPE: "body-midsize-regular";
+    PREFIX_TEXT_TAG: "span";
+};
+export { TAG_NAME, PREFIX_TEXT_OPTIONS, AUTO_CAPITALIZE, DEFAULTS };

package/dist/components/input/input.constants.js

@@ -0,0 +1,29 @@
+import utils from '../../utils/tag-name';
+import { BUTTON_VARIANTS, ICON_BUTTON_SIZES } from '../button/button.constants';
+import { VALIDATION } from '../formfieldwrapper/formfieldwrapper.constants';
+import { TYPE, VALID_TEXT_TAGS } from '../text/text.constants';
+const TAG_NAME = utils.constructTagName('input');
+const AUTO_CAPITALIZE = {
+    OFF: 'off',
+    NONE: 'none',
+    ON: 'on',
+    SENTENCES: 'sentences',
+    WORDS: 'words',
+    CHARACTERS: 'characters',
+};
+const PREFIX_TEXT_OPTIONS = {
+    MAX_LENGTH: 10,
+    HELPERTEXT: 'Prefix text should not exceed 10 characters',
+    VALIDATION: VALIDATION.ERROR,
+};
+const DEFAULTS = {
+    VALIDATION: VALIDATION.DEFAULT,
+    ICON_SIZE_VALUE: 1,
+    ICON_SIZE_UNIT: 'rem',
+    CLEAR_BUTTON_ICON: 'cancel-bold',
+    CLEAR_BUTTON_VARIANT: BUTTON_VARIANTS.TERTIARY,
+    CLEAR_BUTTON_SIZE: ICON_BUTTON_SIZES[20],
+    PREFIX_TEXT_TYPE: TYPE.BODY_MIDSIZE_REGULAR,
+    PREFIX_TEXT_TAG: VALID_TEXT_TAGS.SPAN,
+};
+export { TAG_NAME, PREFIX_TEXT_OPTIONS, AUTO_CAPITALIZE, DEFAULTS };

package/dist/components/input/input.styles.d.ts

@@ -0,0 +1,2 @@
+declare const styles: import("lit").CSSResult[];
+export default styles;

package/dist/components/input/input.styles.js

@@ -0,0 +1,118 @@
+import { css } from 'lit';
+import { hostFocusRingStyles } from '../../utils/styles';
+const styles = [css `
+  :host{
+    --mdc-input-disabled-border-color: var(--mds-color-theme-outline-primary-disabled);
+    --mdc-input-disabled-text-color: var(--mds-color-theme-text-primary-disabled);
+    --mdc-input-disabled-background-color: var(--mds-color-theme-background-primary-disabled);
+    --mdc-input-border-color: var(--mds-color-theme-outline-input-normal);
+    --mdc-input-text-color: var(--mds-color-theme-text-primary-normal);
+    --mdc-input-background-color: var(--mds-color-theme-background-primary-ghost);
+    --mdc-input-selection-background-color: var(--mds-color-theme-background-accent-active);
+    --mdc-input-selection-text-color: var(--mds-color-theme-inverted-text-primary-normal);
+    --mdc-input-support-text-color: var(--mds-color-theme-text-secondary-normal);
+    --mdc-input-hover-background-color: var(--mds-color-theme-background-primary-hover);
+    --mdc-input-focused-background-color: var(--mds-color-theme-background-primary-active);
+    --mdc-input-focused-border-color: var(--mds-color-theme-outline-input-active);
+    --mdc-input-error-border-color: var(--mds-color-theme-text-error-normal);
+    --mdc-input-warning-border-color: var(--mds-color-theme-text-warning-normal);
+    --mdc-input-success-border-color: var(--mds-color-theme-text-success-normal);
+    --mdc-input-primary-border-color: var(--mds-color-theme-text-accent-normal);
+  }
+
+  :host, .input-container, .input-section, .input{
+    width: 100%;
+  }
+
+  :host([readonly]) .leading-icon {
+    color: var(--mdc-input-support-text-color);
+  }
+
+  :host([disabled]) .input,
+  :host([disabled]) .input::placeholder,
+  :host([disabled]) .prefix-text{
+    color: var(--mdc-input-disabled-text-color);
+  }
+
+  :host([disabled]) .input,
+  :host([readonly]) .input{
+    border-color: var(--mdc-input-disabled-border-color);
+    background: var(--mdc-input-disabled-background-color);
+  }
+
+  :host([disabled][help-text-type="default"]) .input-container,
+  :host([disabled][help-text-type="success"]) .input-container,
+  :host([disabled][help-text-type="warning"]) .input-container,
+  :host([disabled][help-text-type="error"]) .input-container,
+  :host([disabled][help-text-type="priority"]) .input-container{
+    border-color: var(--mdc-input-disabled-border-color);
+  }
+
+  .leading-icon{
+    aspect-ratio: 1;
+  }
+
+  .input-container{
+    height: 2rem;
+    border-radius: 0.5rem;
+    border: 0.0625rem solid var(--mdc-input-border-color);
+    display: flex;
+    align-items: center;
+    gap: 0.375rem;
+    padding: 0.34375rem 0.375rem 0.34375rem 0.75rem;
+  }
+
+  .input-section{
+    display: flex;
+    gap: 0.25rem;
+  }
+
+  .input {
+    border: none;
+    color: var(--mdc-input-text-color);
+    background-color: var(--mdc-input-background-color);
+    outline: none;
+  }
+
+  .input::selection { 
+    background-color: var(--mdc-input-selection-background-color);
+    color: var(--mdc-input-selection-text-color);
+  }
+
+  .prefix-text{
+    color: var(--mdc-input-support-text-color);
+    white-space: nowrap; // restirct prefix text to be in one line
+  }
+
+  :host(:not([disabled])) .input-container:hover{
+    background-color: var(--mdc-input-hover-background-color);
+  }
+
+  :host(:not([disabled])) .input-container:active, :host(:not([disabled])) .input-container:focus-within{
+    background-color: var(--mdc-input-focused-background-color);
+    border-color:  var(--mdc-input-focused-border-color);
+  }
+
+  .input::placeholder{
+    color: var(--mdc-input-support-text-color);
+  }
+
+  :host([help-text-type="error"]) .input-container {
+    border-color: var(--mdc-input-error-border-color);
+  }
+  :host([help-text-type="warning"]) .input-container {
+    border-color: var(--mdc-input-warning-border-color);
+  }
+  :host([help-text-type="success"]) .input-container {
+    border-color: var(--mdc-input-success-border-color);
+  }
+  :host([help-text-type="priority"]) .input-container {
+    border-color: var(--mdc-input-primary-border-color);
+  }
+
+  .hidden{
+    opacity: 0;
+    pointer-events: none;
+  }
+  `, ...hostFocusRingStyles(true)];
+export default styles;

package/dist/components/input/input.types.d.ts

@@ -0,0 +1,4 @@
+import type { ValueOf } from '../../utils/types';
+import { AUTO_CAPITALIZE } from './input.constants';
+type AutoCapitalizeType = ValueOf<typeof AUTO_CAPITALIZE>;
+export { AutoCapitalizeType };

package/dist/components/input/input.types.js

@@ -0,0 +1 @@
+export {};