@momentum-design/components 0.66.2 → 0.66.4

package/dist/components/menuitemcheckbox/index.d.ts

@@ -0,0 +1,12 @@
+import '../icon';
+import '../staticcheckbox';
+import '../statictoggle';
+import '../text';
+import '../tooltip';
+import MenuItemCheckbox from './menuitemcheckbox.component';
+declare global {
+    interface HTMLElementTagNameMap {
+        ['mdc-menuitemcheckbox']: MenuItemCheckbox;
+    }
+}
+export default MenuItemCheckbox;

package/dist/components/menuitemcheckbox/index.js

@@ -0,0 +1,9 @@
+import '../icon';
+import '../staticcheckbox';
+import '../statictoggle';
+import '../text';
+import '../tooltip';
+import MenuItemCheckbox from './menuitemcheckbox.component';
+import { TAG_NAME } from './menuitemcheckbox.constants';
+MenuItemCheckbox.register(TAG_NAME);
+export default MenuItemCheckbox;

package/dist/components/menuitemcheckbox/menuitemcheckbox.component.d.ts

@@ -0,0 +1,54 @@
+import type { CSSResult, TemplateResult } from 'lit';
+import MenuItem from '../menuitem/menuitem.component';
+import type { AriaCheckedStates, Indicator } from './menuitemcheckbox.types';
+/**
+ * A menuitemcheckbox component is a checkable menuitem.
+ * There should be no focusable descendants inside this menuitemcheckbox component.
+ *
+ * The `aria-checked` attribute indicates whether the menuitemcheckbox is checked or not.
+ *
+ * The `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b> and <b>toggle</b>.
+ * By default the `indicator` is set to <b>checkbox</b>.<br/>
+ *
+ * The checkbox will always be positioned on the leading side of the menuitem label and
+ * the toggle and checkmark will always be positioned on the trailing side.
+ *
+ * The checkbox will have the possible states of `true` or `false`.
+ * If the indicator is set to <b>checkmark</b> and if the `aria-checked` attribute is set to `true`,
+ * then the checkmark will be displayed. if not, then no indicator will be displayed.
+ *
+ * If you want only one item in a group to be checked, consider using menuitemradio component.
+ *
+ * If a menuitemcheckbox is disabled, then the `aria-disabled` attribute is set to `true`.
+ *
+ * @dependency mdc-staticcheckbox
+ * @dependency mdc-statictoggle
+ * @dependency mdc-icon
+ *
+ * @tagname mdc-menuitemcheckbox
+ *
+ * @cssproperty --mdc-checkmark-indicator-color - Allows customization of the checkmark indicator color
+ *
+ * @event change - (React: onChange) This event is dispatched when the menuitemcheckbox changes.
+ * @event click - (React: onClick) This event is dispatched when the menuitemcheckbox is clicked.
+ * @event focus - (React: onFocus) This event is dispatched when the menuitemcheckbox receives focus.
+ */
+declare class MenuItemCheckbox extends MenuItem {
+    /**
+     * The aria-checked attribute is used to indicate that the menuitemcheckbox is checked or not.
+     * @default 'false'
+     */
+    ariaChecked: AriaCheckedStates;
+    /**
+     * The indicator attribute is used to differentiate between <b>checkbox</b> and <b>toggle</b>.
+     * @default 'checkbox'
+     */
+    indicator: Indicator;
+    connectedCallback(): void;
+    private staticCheckbox;
+    private staticToggle;
+    private getCheckmarkIcon;
+    render(): TemplateResult<1>;
+    static styles: Array<CSSResult>;
+}
+export default MenuItemCheckbox;

package/dist/components/menuitemcheckbox/menuitemcheckbox.component.js

@@ -0,0 +1,137 @@
+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 } from 'lit/decorators.js';
+import { ROLE } from '../../utils/roles';
+import MenuItem from '../menuitem/menuitem.component';
+import { TYPE } from '../text/text.constants';
+import { TOGGLE_SIZE } from '../toggle/toggle.constants';
+import { ARIA_CHECKED_STATES, DEFAULTS, INDICATOR } from './menuitemcheckbox.constants';
+import styles from './menuitemcheckbox.styles';
+/**
+ * A menuitemcheckbox component is a checkable menuitem.
+ * There should be no focusable descendants inside this menuitemcheckbox component.
+ *
+ * The `aria-checked` attribute indicates whether the menuitemcheckbox is checked or not.
+ *
+ * The `indicator` attribute is used to differentiate between <b>checkbox</b>, <b>checkmark</b> and <b>toggle</b>.
+ * By default the `indicator` is set to <b>checkbox</b>.<br/>
+ *
+ * The checkbox will always be positioned on the leading side of the menuitem label and
+ * the toggle and checkmark will always be positioned on the trailing side.
+ *
+ * The checkbox will have the possible states of `true` or `false`.
+ * If the indicator is set to <b>checkmark</b> and if the `aria-checked` attribute is set to `true`,
+ * then the checkmark will be displayed. if not, then no indicator will be displayed.
+ *
+ * If you want only one item in a group to be checked, consider using menuitemradio component.
+ *
+ * If a menuitemcheckbox is disabled, then the `aria-disabled` attribute is set to `true`.
+ *
+ * @dependency mdc-staticcheckbox
+ * @dependency mdc-statictoggle
+ * @dependency mdc-icon
+ *
+ * @tagname mdc-menuitemcheckbox
+ *
+ * @cssproperty --mdc-checkmark-indicator-color - Allows customization of the checkmark indicator color
+ *
+ * @event change - (React: onChange) This event is dispatched when the menuitemcheckbox changes.
+ * @event click - (React: onClick) This event is dispatched when the menuitemcheckbox is clicked.
+ * @event focus - (React: onFocus) This event is dispatched when the menuitemcheckbox receives focus.
+ */
+class MenuItemCheckbox extends MenuItem {
+    constructor() {
+        super(...arguments);
+        /**
+         * The aria-checked attribute is used to indicate that the menuitemcheckbox is checked or not.
+         * @default 'false'
+         */
+        this.ariaChecked = DEFAULTS.ARIA_CHECKED;
+        /**
+         * The indicator attribute is used to differentiate between <b>checkbox</b> and <b>toggle</b>.
+         * @default 'checkbox'
+         */
+        this.indicator = DEFAULTS.INDICATOR;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.role = ROLE.MENUITEMCHECKBOX;
+    }
+    staticCheckbox() {
+        if (this.indicator !== INDICATOR.CHECKBOX) {
+            return nothing;
+        }
+        return html `
+      <mdc-staticcheckbox
+        slot="leading-controls"
+        ?checked="${this.ariaChecked === ARIA_CHECKED_STATES.TRUE}"
+        ?disabled="${this.disabled}"
+      ></mdc-staticcheckbox>
+  `;
+    }
+    staticToggle() {
+        if (this.indicator !== INDICATOR.TOGGLE) {
+            return nothing;
+        }
+        return html `
+      <mdc-statictoggle
+        slot="trailing-controls"
+        ?checked="${this.ariaChecked === ARIA_CHECKED_STATES.TRUE}"
+        ?disabled="${this.disabled}"
+        size="${TOGGLE_SIZE.COMPACT}"
+      ></mdc-statictoggle>
+    `;
+    }
+    getCheckmarkIcon() {
+        if (this.indicator !== INDICATOR.CHECKMARK || this.ariaChecked === ARIA_CHECKED_STATES.FALSE) {
+            return nothing;
+        }
+        return html `
+      <mdc-icon
+        slot="trailing-controls"
+        name="check-bold"
+        part="checkmark-icon"
+      ></mdc-icon>
+    `;
+    }
+    render() {
+        return html `
+      <div part="leading">
+        ${this.staticCheckbox()}
+        <slot name="leading-controls"></slot>
+        <div part="leading-text">
+          ${this.getText('leading-text-primary-label', TYPE.BODY_MIDSIZE_REGULAR, this.label)}
+          ${this.getText('leading-text-secondary-label', TYPE.BODY_SMALL_REGULAR, this.secondaryLabel)}
+          ${this.getText('leading-text-tertiary-label', TYPE.BODY_SMALL_REGULAR, this.tertiaryLabel)}
+        </div>
+      </div>
+      <div part="trailing">
+        <div part="trailing-text">
+          ${this.getText('trailing-text-side-header', TYPE.BODY_MIDSIZE_REGULAR, this.sideHeaderText)}
+          ${this.getText('trailing-text-subline', TYPE.BODY_SMALL_REGULAR, this.sublineText)}
+        </div>
+        <slot name="trailing-controls"></slot>
+        ${this.staticToggle()}
+        ${this.getCheckmarkIcon()}
+      </div>
+    `;
+    }
+}
+MenuItemCheckbox.styles = [...MenuItem.styles, ...styles];
+__decorate([
+    property({ type: String, reflect: true, attribute: 'aria-checked' }),
+    __metadata("design:type", String)
+], MenuItemCheckbox.prototype, "ariaChecked", void 0);
+__decorate([
+    property({ type: String, reflect: true }),
+    __metadata("design:type", String)
+], MenuItemCheckbox.prototype, "indicator", void 0);
+export default MenuItemCheckbox;

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

@@ -0,0 +1,15 @@
+declare const TAG_NAME: "mdc-menuitemcheckbox";
+declare const ARIA_CHECKED_STATES: {
+    readonly FALSE: "false";
+    readonly TRUE: "true";
+};
+declare const INDICATOR: {
+    readonly CHECKBOX: "checkbox";
+    readonly CHECKMARK: "checkmark";
+    readonly TOGGLE: "toggle";
+};
+declare const DEFAULTS: {
+    readonly ARIA_CHECKED: "false";
+    readonly INDICATOR: "checkbox";
+};
+export { TAG_NAME, ARIA_CHECKED_STATES, INDICATOR, DEFAULTS };

package/dist/components/menuitemcheckbox/menuitemcheckbox.constants.js

@@ -0,0 +1,16 @@
+import utils from '../../utils/tag-name';
+const TAG_NAME = utils.constructTagName('menuitemcheckbox');
+const ARIA_CHECKED_STATES = {
+    FALSE: 'false',
+    TRUE: 'true',
+};
+const INDICATOR = {
+    CHECKBOX: 'checkbox',
+    CHECKMARK: 'checkmark',
+    TOGGLE: 'toggle',
+};
+const DEFAULTS = {
+    ARIA_CHECKED: ARIA_CHECKED_STATES.FALSE,
+    INDICATOR: INDICATOR.CHECKBOX,
+};
+export { TAG_NAME, ARIA_CHECKED_STATES, INDICATOR, DEFAULTS };

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

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

package/dist/components/menuitemcheckbox/menuitemcheckbox.styles.js

@@ -0,0 +1,13 @@
+import { css } from 'lit';
+const styles = css `
+  :host {
+    --mdc-checkmark-indicator-color: var(--mds-color-theme-control-active-normal);
+  }
+  :host::part(checkmark-icon) {
+    --mdc-icon-fill-color: var(--mdc-checkmark-indicator-color);
+  }
+  :host([disabled])::part(checkmark-icon) {
+    --mdc-icon-fill-color: currentColor;
+  }
+`;
+export default [styles];

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

@@ -0,0 +1,10 @@
+import { ValueOf } from '../../utils/types';
+import { ARIA_CHECKED_STATES, INDICATOR } from './menuitemcheckbox.constants';
+type AriaCheckedStates = ValueOf<typeof ARIA_CHECKED_STATES>;
+type Indicator = ValueOf<typeof INDICATOR>;
+interface Events {
+    onChangeEvent: Event;
+    onClickEvent: MouseEvent;
+    onFocusEvent: FocusEvent;
+}
+export type { Events, AriaCheckedStates, Indicator };

package/dist/components/menuitemcheckbox/menuitemcheckbox.types.js

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

package/dist/components/menuitemradio/index.d.ts

@@ -0,0 +1,10 @@
+import '../staticradio';
+import '../text';
+import '../tooltip';
+import MenuItemRadio from './menuitemradio.component';
+declare global {
+    interface HTMLElementTagNameMap {
+        ['mdc-menuitemradio']: MenuItemRadio;
+    }
+}
+export default MenuItemRadio;

package/dist/components/menuitemradio/index.js

@@ -0,0 +1,7 @@
+import '../staticradio';
+import '../text';
+import '../tooltip';
+import MenuItemRadio from './menuitemradio.component';
+import { TAG_NAME } from './menuitemradio.constants';
+MenuItemRadio.register(TAG_NAME);
+export default MenuItemRadio;

package/dist/components/menuitemradio/menuitemradio.component.d.ts

@@ -0,0 +1,34 @@
+import type { CSSResult } from 'lit';
+import MenuItem from '../menuitem/menuitem.component';
+import { AriaChecked } from './menuitemradio.types';
+/**
+ * A menuitemradio component is a checkable menuitem that is used in a menu.
+ * A menuitemradio should be checked only one at a time. <br/>
+ * There should be no focusable descendants inside this menuitemradio component.
+ *
+ * The `aria-checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.
+ *
+ * If you want more than one item in a group to be checked, consider using menuitemcheckbox component.
+ *
+ * If a menuitemradio is disabled, then the `aria-disabled` attribute is set to `true`.
+ *
+ * @dependency mdc-staticradio
+ * @dependency mdc-text
+ *
+ * @tagname mdc-menuitemradio
+ *
+ * @event change - (React: onChange) This event is dispatched when the menuitemradio changes.
+ * @event click - (React: onClick) This event is dispatched when the menuitemradio is clicked.
+ * @event focus - (React: onFocus) This event is dispatched when the menuitemradio receives focus.
+ */
+declare class MenuItemRadio extends MenuItem {
+    /**
+     * The aria-checked attribute is used to indicate that the menuitemradio is checked or not.
+     * @default 'false'
+     */
+    ariaChecked: AriaChecked;
+    connectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: Array<CSSResult>;
+}
+export default MenuItemRadio;

package/dist/components/menuitemradio/menuitemradio.component.js

@@ -0,0 +1,70 @@
+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 } from 'lit';
+import { property } from 'lit/decorators.js';
+import { ROLE } from '../../utils/roles';
+import MenuItem from '../menuitem/menuitem.component';
+import { TYPE } from '../text/text.constants';
+import { ARIA_CHECKED_STATES } from './menuitemradio.constants';
+/**
+ * A menuitemradio component is a checkable menuitem that is used in a menu.
+ * A menuitemradio should be checked only one at a time. <br/>
+ * There should be no focusable descendants inside this menuitemradio component.
+ *
+ * The `aria-checked` menuitemradio attribute is used to indicate that the menuitemradio is checked or not.
+ *
+ * If you want more than one item in a group to be checked, consider using menuitemcheckbox component.
+ *
+ * If a menuitemradio is disabled, then the `aria-disabled` attribute is set to `true`.
+ *
+ * @dependency mdc-staticradio
+ * @dependency mdc-text
+ *
+ * @tagname mdc-menuitemradio
+ *
+ * @event change - (React: onChange) This event is dispatched when the menuitemradio changes.
+ * @event click - (React: onClick) This event is dispatched when the menuitemradio is clicked.
+ * @event focus - (React: onFocus) This event is dispatched when the menuitemradio receives focus.
+ */
+class MenuItemRadio extends MenuItem {
+    constructor() {
+        super(...arguments);
+        /**
+         * The aria-checked attribute is used to indicate that the menuitemradio is checked or not.
+         * @default 'false'
+         */
+        this.ariaChecked = ARIA_CHECKED_STATES.FALSE;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.role = ROLE.MENUITEMRADIO;
+    }
+    render() {
+        return html `
+      <div part="leading-controls">
+        <mdc-staticradio
+          slot="leading-controls"
+          ?checked="${this.ariaChecked === ARIA_CHECKED_STATES.TRUE}"
+          ?disabled="${this.disabled}"
+        ></mdc-staticradio>
+      </div>
+      <div part="leading-text">
+        ${this.getText('leading-text-primary-label', TYPE.BODY_MIDSIZE_REGULAR, this.label)}
+        ${this.getText('leading-text-secondary-label', TYPE.BODY_MIDSIZE_REGULAR, this.secondaryLabel)}
+      </div>
+    `;
+    }
+}
+MenuItemRadio.styles = [...MenuItem.styles];
+__decorate([
+    property({ type: String, reflect: true, attribute: 'aria-checked' }),
+    __metadata("design:type", String)
+], MenuItemRadio.prototype, "ariaChecked", void 0);
+export default MenuItemRadio;

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

@@ -0,0 +1,6 @@
+declare const TAG_NAME: "mdc-menuitemradio";
+declare const ARIA_CHECKED_STATES: {
+    readonly TRUE: "true";
+    readonly FALSE: "false";
+};
+export { TAG_NAME, ARIA_CHECKED_STATES };

package/dist/components/menuitemradio/menuitemradio.constants.js

@@ -0,0 +1,7 @@
+import utils from '../../utils/tag-name';
+const TAG_NAME = utils.constructTagName('menuitemradio');
+const ARIA_CHECKED_STATES = {
+    TRUE: 'true',
+    FALSE: 'false',
+};
+export { TAG_NAME, ARIA_CHECKED_STATES };

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

@@ -0,0 +1,9 @@
+import { ValueOf } from '../../utils/types';
+import { ARIA_CHECKED_STATES } from './menuitemradio.constants';
+type AriaChecked = ValueOf<typeof ARIA_CHECKED_STATES>;
+interface Events {
+    onChangeEvent: Event;
+    onClickEvent: MouseEvent;
+    onFocusEvent: FocusEvent;
+}
+export type { Events, AriaChecked };

package/dist/components/menuitemradio/menuitemradio.types.js

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