@tylertech/forge 3.0.0-next.14 → 3.0.0-next.15

package/esm/button/base/base-button.d.ts

@@ -3,14 +3,14 @@
  * Copyright 2023 Tyler Technologies, Inc. 
  * License: Apache-2.0
  */
-import { BaseFocusableComponent } from '../../core/base/base-focusable-component';
+import { IWithFocusable } from '../../core/base/base-focusable-component';
+import { BaseComponent } from '../../core/base/base-component';
 import { ExperimentalFocusOptions, internals } from '../../constants';
-import { IBaseComponent } from '../../core/base/base-component';
 import { IBaseButtonAdapter } from './base-button-adapter';
 import { ButtonType } from './base-button-constants';
 import { BaseButtonFoundation } from './base-button-foundation';
-import { ILabelAware } from '../../label/label-aware';
-export interface IBaseButton extends IBaseComponent {
+import { IWithLabelAwareness } from '../../core/base/base-label-aware-component';
+export interface IBaseButton extends IWithFocusable, IWithLabelAwareness {
     type: ButtonType;
     disabled: boolean;
     popoverIcon: boolean;
@@ -25,7 +25,8 @@ export interface IBaseButton extends IBaseComponent {
     form: HTMLFormElement | null;
     focus(options?: ExperimentalFocusOptions): void;
 }
-export declare abstract class BaseButton<T extends BaseButtonFoundation<IBaseButtonAdapter>> extends BaseFocusableComponent implements IBaseButton, ILabelAware {
+declare const BaseButtonClass: import("../../constants").AbstractConstructor<import("../../core/base/base-label-aware-component").WithLabelAwarenessContract> & import("../../constants").AbstractConstructor<import("../../core/base/base-focusable-component").WithFocusableContract> & typeof BaseComponent;
+export declare abstract class BaseButton<T extends BaseButtonFoundation<IBaseButtonAdapter>> extends BaseButtonClass implements IBaseButton {
     static readonly formAssociated = true;
     [internals]: ElementInternals;
     protected abstract _foundation: T;
@@ -51,3 +52,4 @@ export declare abstract class BaseButton<T extends BaseButtonFoundation<IBaseBut
     click(): void;
     focus(options: ExperimentalFocusOptions): void;
 }
+export {};

package/esm/button/base/base-button.js

@@ -7,10 +7,13 @@ import { __decorate } from "tslib";
 import { coerceBoolean, FoundationProperty } from '@tylertech/forge-core';
 import { tylIconArrowDropDown } from '@tylertech/tyler-icons/standard';
 import { IconRegistry } from '../../icon/icon-registry';
-import { BaseFocusableComponent } from '../../core/base/base-focusable-component';
+import { WithFocusable } from '../../core/base/base-focusable-component';
+import { BaseComponent } from '../../core/base/base-component';
 import { internals } from '../../constants';
 import { BASE_BUTTON_CONSTANTS } from './base-button-constants';
-export class BaseButton extends BaseFocusableComponent {
+import { WithLabelAwareness } from '../../core/base/base-label-aware-component';
+const BaseButtonClass = WithLabelAwareness(WithFocusable(BaseComponent));
+export class BaseButton extends BaseButtonClass {
     constructor() {
         super();
         IconRegistry.define(tylIconArrowDropDown);

package/esm/button/button-constants.d.ts

@@ -10,11 +10,13 @@ export declare const BUTTON_CONSTANTS: {
         VARIANT: string;
         PILL: string;
         THEME: string;
+        FULL_WIDTH: string;
     };
     attributes: {
         VARIANT: string;
         PILL: string;
         THEME: string;
+        FULL_WIDTH: string;
     };
 };
 export type ButtonVariant = 'text' | 'outlined' | 'tonal' | 'filled' | 'raised' | 'link';

package/esm/button/button-constants.js

@@ -8,7 +8,8 @@ const elementName = `${COMPONENT_NAME_PREFIX}button`;
 const observedAttributes = {
     VARIANT: 'variant',
     PILL: 'pill',
-    THEME: 'theme'
+    THEME: 'theme',
+    FULL_WIDTH: 'full-width'
 };
 const attributes = Object.assign({}, observedAttributes);
 export const BUTTON_CONSTANTS = {

package/esm/button/button-foundation.d.ts

@@ -10,11 +10,13 @@ export interface IButtonFoundation extends IBaseButtonFoundation {
     variant: ButtonVariant;
     pill: boolean;
     theme: ButtonTheme;
+    fullWidth: boolean;
 }
 export declare class ButtonFoundation extends BaseButtonFoundation<IButtonAdapter> implements IButtonFoundation {
     private _variant;
     private _pill;
     private _theme;
+    private _fullWidth;
     constructor(adapter: IButtonAdapter);
     get variant(): ButtonVariant;
     set variant(value: ButtonVariant);
@@ -22,4 +24,6 @@ export declare class ButtonFoundation extends BaseButtonFoundation<IButtonAdapte
     set pill(value: boolean);
     get theme(): ButtonTheme;
     set theme(value: ButtonTheme);
+    get fullWidth(): boolean;
+    set fullWidth(value: boolean);
 }

package/esm/button/button-foundation.js

@@ -11,6 +11,7 @@ export class ButtonFoundation extends BaseButtonFoundation {
         this._variant = 'text';
         this._pill = false;
         this._theme = 'primary';
+        this._fullWidth = false;
     }
     get variant() {
         return this._variant;
@@ -46,4 +47,13 @@ export class ButtonFoundation extends BaseButtonFoundation {
             this._adapter.setHostAttribute(BUTTON_CONSTANTS.attributes.THEME, this._theme);
         }
     }
+    get fullWidth() {
+        return this._fullWidth;
+    }
+    set fullWidth(value) {
+        if (this._fullWidth !== value) {
+            this._fullWidth = value;
+            this._adapter.toggleHostAttribute(BUTTON_CONSTANTS.attributes.FULL_WIDTH, this._fullWidth);
+        }
+    }
 }

package/esm/button/button.d.ts

@@ -10,6 +10,7 @@ export interface IButtonComponent extends IBaseButton {
     variant: ButtonVariant;
     pill: boolean;
     theme: ButtonTheme;
+    fullWidth: boolean;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -28,6 +29,7 @@ declare global {
  *
  * @property {string} type - The type of button. Defaults to `button`. Valid values are `button`, `submit`, and `reset`.
  * @property {ButtonVariant} variant - The variant of the button. Defaults to `text`.
+ * @property {boolean} fullWidth - Whether or not the button is full-width.
  * @property {boolean} disabled - Whether or not the button is disabled.
  * @property {boolean} popoverIcon - Whether or not the button shows a built-in popover icon.
  * @property {string} name - The name of the button.
@@ -44,6 +46,7 @@ declare global {
  *
  * @attribute {string} type - The type of button. Defaults to `button`. Valid values are `button`, `submit`, and `reset`.
  * @attribute {ButtonVariant} variant - The variant of the button. Defaults to `text`.
+ * @attribute {boolean} full-width - Whether or not the button is full-width.
  * @attribute {boolean} disabled - Whether or not the button is disabled.
  * @attribute {boolean} popover-icon - Whether or not the button shows a built-in popover icon.
  * @attribute {string} name - The name of the button.
@@ -141,4 +144,5 @@ export declare class ButtonComponent extends BaseButton<ButtonFoundation> implem
     variant: ButtonVariant;
     pill: boolean;
     theme: ButtonTheme;
+    fullWidth: boolean;
 }

package/esm/button/button.js

@@ -14,7 +14,7 @@ import { ButtonAdapter } from './button-adapter';
 import { BUTTON_CONSTANTS } from './button-constants';
 import { ButtonFoundation } from './button-foundation';
 const template = '<template><div class=\"forge-button\" part=\"root\"><slot name=\"start\"></slot><slot></slot><slot name=\"end\"></slot><forge-focus-indicator target=\":host\" part=\"focus-indicator\"></forge-focus-indicator><forge-state-layer target=\":host\" exportparts=\"surface:state-layer\"></forge-state-layer></div></template>';
-const styles = ':host{--_button-display:var(--forge-button-display, inline-flex);--_button-disabled-cursor:var(--forge-button-disabled-cursor, not-allowed)}:host{display:var(--_button-display);position:relative;outline:0;-webkit-tap-highlight-color:transparent}:host([hidden]){display:none}.forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-primary, #3f51b5));--_button-text-color:var(--forge-button-text-color, var(--_button-primary-color));--_button-disabled-color:var(--forge-button-disabled, var(--forge-theme-surface-container, #e0e0e0));--_button-padding:var(--forge-button-padding, 8px);--_button-justify:var(--forge-button-justify, center);--_button-shape:var(--forge-button-shape, var(--forge-shape-medium, 4px));--_button-height:var(--forge-button-height, 36px);--_button-min-width:var(--forge-button-min-width, 64px);--_button-spacing:var(--forge-button-spacing, var(--forge-spacing-xsmall, 8px));--_button-border-width:var(--forge-button-border-width, medium);--_button-border-style:var(--forge-button-border-style, none);--_button-border-color:var(--forge-button-border-color, currentColor);--_button-shape-start-start-radius:var(--forge-button-shape-start-start-radius, var(--_button-shape));--_button-shape-start-end-radius:var(--forge-button-shape-start-end-radius, var(--_button-shape));--_button-shape-end-start-radius:var(--forge-button-shape-end-start-radius, var(--_button-shape));--_button-shape-end-end-radius:var(--forge-button-shape-end-end-radius, var(--_button-shape));--_button-padding-block:var(--forge-button-padding-block, var(--_button-padding));--_button-padding-inline:var(--forge-button-padding-inline, var(--_button-padding));--_button-background:var(--forge-button-background, transparent);--_button-hover-background:var(--forge-button-hover-background, var(--_button-background));--_button-active-background:var(--forge-button-active-background, var(--_button-background));--_button-color:var(--forge-button-color, var(--_button-text-color));--_button-icon-size:var(--forge-button-icon-size, calc(var(--forge-typography-font-size, 1rem) * 1.125));--_button-shadow:var(--forge-button-shadow, none);--_button-hover-shadow:var(--forge-button-hover-shadow, none);--_button-active-shadow:var(--forge-button-active-shadow, none);--_button-cursor:var(--forge-button-cursor, pointer);--_button-transition-duration:var(--forge-button-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-transition-timing:var(--forge-button-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-outlined-background:var(--forge-button-outlined-background, var(--_button-background));--_button-outlined-color:var(--forge-button-outlined-color, var(--_button-primary-color));--_button-outlined-border-width:var(--forge-button-outlined-border-width, var(--forge-border-thin, 1px));--_button-outlined-border-style:var(--forge-button-outlined-border-style, solid);--_button-outlined-border-color:var(--forge-button-outlined-border-color, var(--_button-primary-color));--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-primary-container, #d1d5ed));--_button-tonal-disabled-background:var(--forge-button-tonal-disabled-background, var(--_button-disabled-color));--_button-tonal-color:var(--forge-button-flat-color, var(--forge-theme-on-primary-container, #222c62));--_button-tonal-disabled-color:var(--forge-button-tonal-disabled-color, var(--_button-disabled-text-color));--_button-filled-background:var(--forge-button-filled-background, var(--_button-primary-color));--_button-filled-disabled-background:var(--forge-button-filled-disabled-background, var(--_button-disabled-color));--_button-filled-color:var(--forge-button-filled-color, var(--forge-theme-on-primary, #ffffff));--_button-filled-disabled-color:var(--forge-button-filled-disabled-color, var(--_button-disabled-text-color));--_button-raised-shadow:var(--forge-button-raised-shadow, 0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14), 0px 1px 5px 0px rgba(0, 0, 0, 0.12));--_button-raised-hover-shadow:var(--forge-button-raised-hover-shadow, 0px 2px 4px -1px rgba(0, 0, 0, 0.2), 0px 4px 5px 0px rgba(0, 0, 0, 0.14), 0px 1px 10px 0px rgba(0, 0, 0, 0.12));--_button-raised-active-shadow:var(--forge-button-raised-active-shadow, 0px 5px 5px -3px rgba(0, 0, 0, 0.2), 0px 8px 10px 1px rgba(0, 0, 0, 0.14), 0px 3px 14px 2px rgba(0, 0, 0, 0.12));--_button-raised-disabled-shadow:var(--forge-button-raised-disabled-shadow, none);--_button-link-color:var(--forge-button-link-color, var(--_button-primary-color));--_button-link-text-decoration:var(--forge-button-link-text-decoration, underline);--_button-link-height:var(--forge-button-link-height, auto);--_button-link-padding:var(--forge-button-link-padding, 0);--_button-link-line-height:var(--forge-button-link-line-height, normal);--_button-link-width:var(--forge-button-link-width, auto);--_button-link-hover-text-decoration:var(--forge-button-link-hover-text-decoration, none);--_button-link-active-opacity:var(--forge-button-link-active-opacity, 0.65);--_button-link-transition-duration:var(--forge-button-link-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-link-transition-timing:var(--forge-button-link-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-disabled-text-color:var(--forge-button-disabled-text-color, var(--forge-theme-text-low, rgba(0, 0, 0, 0.38)));--_button-disabled-background:var(--forge-button-disabled-background, transparent);--_button-disabled-border-color:var(--forge-button-disabled-border-color, var(--_button-disabled-color));--_button-disabled-shadow:var(--forge-button-disabled-shadow, none);--_button-dense-height:var(--forge-button-dense-height, 24px);--_button-pill-shape:var(--forge-button-pill-shape, var(--forge-shape-full, 9999px));--_button-pill-padding-inline:var(--forge-button-pill-padding-inline, var(--forge-spacing-small, 12px));--_button-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 4px);--_button-text-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 0px);--_button-link-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 2px);--_button-popover-icon-transition-duration:var(--forge-button-popover-icon-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-popover-icon-transition-timing:var(--forge-button-popover-icon-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-popover-icon-open-rotation:var(--forge-button-popover-icon-open-rotation, 180deg)}.forge-button{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-button-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-button-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-button-font-size-scale, .875)));font-weight:var(--forge-typography-button-font-weight,500);line-height:var(--forge-typography-button-line-height, normal);letter-spacing:var(--forge-typography-button-letter-spacing, .0714285714em);text-transform:var(--forge-typography-button-text-transform,inherit);-webkit-text-decoration:var(--forge-typography-button-text-decoration,inherit);text-decoration:var(--forge-typography-button-text-decoration,inherit);position:relative;display:var(--_button-display);-webkit-box-align:center;align-items:center;-webkit-box-pack:var(--_button-justify);justify-content:var(--_button-justify);gap:var(--_button-spacing);z-index:0;-webkit-box-sizing:border-box;box-sizing:border-box;min-inline-size:var(--_button-min-width);height:var(--_button-height);inline-size:100%;border-width:var(--_button-border-width);border-style:var(--_button-border-style);border-color:var(--_button-border-color);border-start-start-radius:var(--_button-shape-start-start-radius);border-start-end-radius:var(--_button-shape-start-end-radius);border-end-start-radius:var(--_button-shape-end-start-radius);border-end-end-radius:var(--_button-shape-end-end-radius);padding-block:var(--_button-padding-block);padding-inline:var(--_button-padding-inline);-webkit-box-shadow:var(--_button-shadow);box-shadow:var(--_button-shadow);outline:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-appearance:none;vertical-align:middle;text-decoration:none;white-space:nowrap;background:var(--_button-background);color:var(--_button-color);cursor:var(--_button-cursor);-webkit-transition-property:background,-webkit-box-shadow;transition-property:background,-webkit-box-shadow;transition-property:box-shadow,background;transition-property:box-shadow,background,-webkit-box-shadow;-webkit-transition-duration:var(--_button-transition-duration);transition-duration:var(--_button-transition-duration);-webkit-transition-timing-function:var(--_button-transition-timing);transition-timing-function:var(--_button-transition-timing)}.forge-button::-moz-focus-inner{padding:0;border:0}.forge-button:hover{--_button-shadow:var(--_button-hover-shadow);background:var(--_button-hover-background)}.forge-button:active{--_button-shadow:var(--_button-active-shadow);background:var(--_button-active-background)}.forge-button ::slotted(:is([slot=start],[slot=end])){font-size:var(--_button-icon-size)}a{position:absolute;inset:0;text-decoration:none}forge-state-layer{--forge-state-layer-color:var(--_button-color)}forge-focus-indicator{--forge-focus-indicator-color:var(--_button-primary-color);--forge-focus-indicator-outward-offset:var(--_button-focus-indicator-offset)}:host([theme=secondary]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-secondary, #ffc107))}:host([theme=secondary][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-secondary-container, #fff0c3));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-secondary-container, #8a6804))}:host([theme=tertiary]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-tertiary, #3d5afe))}:host([theme=tertiary][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-tertiary-container, #d0d7ff));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-tertiary-container, #213189))}:host([theme=success]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-success, #2e7d32))}:host([theme=success][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-success-container, #cde0ce));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-success-container, #19441b))}:host([theme=error]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-error, #b00020))}:host([theme=error][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-error-container, #ecc2c9));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-error-container, #5f0011))}:host([theme=warning]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-warning, #d14900))}:host([theme=warning][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-warning-container, #f4d3c2));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-warning-container, #712700))}:host([theme=info]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-info, #1565c0))}:host([theme=info][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-info-container, #c7daf0));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-info-container, #0b3768))}:host(:is(:not([variant],[variant=text]))) .forge-button{--_button-focus-indicator-offset:var(--_button-text-focus-indicator-offset)}:host(:is([variant=filled],[variant=raised])) .forge-button{--_button-background:var(--_button-filled-background);--_button-color:var(--_button-filled-color)}:host(:is([variant=filled],[variant=raised])) forge-state-layer{--forge-state-layer-color:var(--_button-filled-color)}:host([variant=raised]) .forge-button{--_button-shadow:var(--_button-raised-shadow)}:host([variant=raised]) .forge-button:hover{--_button-shadow:var(--_button-raised-hover-shadow)}:host([variant=raised]) .forge-button:active{--_button-shadow:var(--_button-raised-active-shadow)}:host([variant=tonal]) .forge-button{--_button-background:var(--_button-tonal-background);--_button-color:var(--_button-tonal-color)}:host([variant=tonal]) forge-state-layer{--forge-state-layer-color:var(--_button-tonal-color)}:host([variant=outlined]) .forge-button{--_button-background:var(--_button-outlined-background);--_button-color:var(--_button-outlined-color);--_button-border-width:var(--_button-outlined-border-width);--_button-border-style:var(--_button-outlined-border-style);--_button-border-color:var(--_button-outlined-border-color)}:host([variant=link]) .forge-button{--_button-color:var(--_button-link-color);--_button-height:var(--_button-link-height);--_button-padding:var(--_button-link-padding);--_button-focus-indicator-offset:var(--_button-link-focus-indicator-offset);-webkit-text-decoration:var(--_button-link-text-decoration);text-decoration:var(--_button-link-text-decoration);line-height:var(--_button-link-line-height);-webkit-transition:opacity var(--_button-link-transition-duration) var(--_button-link-transition-timing);transition:opacity var(--_button-link-transition-duration) var(--_button-link-transition-timing);inline-size:var(--_button-link-width)}:host([variant=link]) .forge-button:hover{-webkit-text-decoration:var(--_button-link-hover-text-decoration);text-decoration:var(--_button-link-hover-text-decoration)}:host([variant=link]) .forge-button:active{opacity:var(--_button-link-active-opacity)}:host([dense]) .forge-button{--_button-height:var(--_button-dense-height)}:host([pill]) .forge-button{--_button-shape:var(--_button-pill-shape);--_button-padding-inline:var(--_button-pill-padding-inline)}:host([pill]) forge-focus-indicator{--forge-focus-indicator-shape:var(--_button-pill-shape)}:host(:not([anchor])[disabled]){cursor:var(--_button-disabled-cursor)}:host(:not([anchor])[disabled]) .forge-button{--_button-background:var(--_button-disabled-background);--_button-color:var(--_button-disabled-text-color);--_button-shadow:var(--_button-disabled-shadow);pointer-events:none}:host(:not([anchor])[variant=outlined][disabled]) .forge-button{--_button-border-color:var(--_button-disabled-border-color)}:host(:not([anchor])[variant=tonal][disabled]) .forge-button{--_button-background:var(--_button-tonal-disabled-background);--_button-color:var(--_button-tonal-disabled-color)}:host(:not([anchor]):is([variant=filled],[variant=raised])[disabled]) .forge-button{--_button-background:var(--_button-filled-disabled-background);--_button-color:var(--_button-filled-disabled-color)}:host(:not([anchor])[variant=raised][disabled]) .forge-button{--_button-shadow:var(--_button-raised-disabled-shadow)}:host([popover-icon]) .forge-button__popover-icon{-webkit-transition:rotate var(--_button-popover-icon-transition-duration) var(--_button-popover-icon-transition-timing);transition:rotate var(--_button-popover-icon-transition-duration) var(--_button-popover-icon-transition-timing)}:host([popover-icon][aria-expanded=true]) .forge-button__popover-icon{rotate:var(--_button-popover-icon-open-rotation)}::slotted(forge-circular-progress){--forge-circular-progress-indicator-color:var(--_button-color);--forge-circular-progress-track-color:transparent;--forge-circular-progress-size:1em}';
+const styles = ':host{--_button-display:var(--forge-button-display, inline-flex);--_button-disabled-cursor:var(--forge-button-disabled-cursor, not-allowed)}:host{display:var(--_button-display);position:relative;outline:0;-webkit-tap-highlight-color:transparent}:host([hidden]){display:none}.forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-primary, #3f51b5));--_button-text-color:var(--forge-button-text-color, var(--_button-primary-color));--_button-disabled-color:var(--forge-button-disabled, var(--forge-theme-surface-container, #e0e0e0));--_button-padding:var(--forge-button-padding, 8px);--_button-justify:var(--forge-button-justify, center);--_button-shape:var(--forge-button-shape, var(--forge-shape-medium, 4px));--_button-height:var(--forge-button-height, 36px);--_button-min-width:var(--forge-button-min-width, 64px);--_button-spacing:var(--forge-button-spacing, var(--forge-spacing-xsmall, 8px));--_button-border-width:var(--forge-button-border-width, medium);--_button-border-style:var(--forge-button-border-style, none);--_button-border-color:var(--forge-button-border-color, currentColor);--_button-shape-start-start-radius:var(--forge-button-shape-start-start-radius, var(--_button-shape));--_button-shape-start-end-radius:var(--forge-button-shape-start-end-radius, var(--_button-shape));--_button-shape-end-start-radius:var(--forge-button-shape-end-start-radius, var(--_button-shape));--_button-shape-end-end-radius:var(--forge-button-shape-end-end-radius, var(--_button-shape));--_button-padding-block:var(--forge-button-padding-block, var(--_button-padding));--_button-padding-inline:var(--forge-button-padding-inline, var(--_button-padding));--_button-background:var(--forge-button-background, transparent);--_button-hover-background:var(--forge-button-hover-background, var(--_button-background));--_button-active-background:var(--forge-button-active-background, var(--_button-background));--_button-color:var(--forge-button-color, var(--_button-text-color));--_button-icon-size:var(--forge-button-icon-size, calc(var(--forge-typography-font-size, 1rem) * 1.125));--_button-shadow:var(--forge-button-shadow, none);--_button-hover-shadow:var(--forge-button-hover-shadow, none);--_button-active-shadow:var(--forge-button-active-shadow, none);--_button-cursor:var(--forge-button-cursor, pointer);--_button-transition-duration:var(--forge-button-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-transition-timing:var(--forge-button-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-outlined-background:var(--forge-button-outlined-background, var(--_button-background));--_button-outlined-color:var(--forge-button-outlined-color, var(--_button-primary-color));--_button-outlined-border-width:var(--forge-button-outlined-border-width, var(--forge-border-thin, 1px));--_button-outlined-border-style:var(--forge-button-outlined-border-style, solid);--_button-outlined-border-color:var(--forge-button-outlined-border-color, var(--_button-primary-color));--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-primary-container, #d1d5ed));--_button-tonal-disabled-background:var(--forge-button-tonal-disabled-background, var(--_button-disabled-color));--_button-tonal-color:var(--forge-button-flat-color, var(--forge-theme-on-primary-container, #222c62));--_button-tonal-disabled-color:var(--forge-button-tonal-disabled-color, var(--_button-disabled-text-color));--_button-filled-background:var(--forge-button-filled-background, var(--_button-primary-color));--_button-filled-disabled-background:var(--forge-button-filled-disabled-background, var(--_button-disabled-color));--_button-filled-color:var(--forge-button-filled-color, var(--forge-theme-on-primary, #ffffff));--_button-filled-disabled-color:var(--forge-button-filled-disabled-color, var(--_button-disabled-text-color));--_button-raised-shadow:var(--forge-button-raised-shadow, 0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14), 0px 1px 5px 0px rgba(0, 0, 0, 0.12));--_button-raised-hover-shadow:var(--forge-button-raised-hover-shadow, 0px 2px 4px -1px rgba(0, 0, 0, 0.2), 0px 4px 5px 0px rgba(0, 0, 0, 0.14), 0px 1px 10px 0px rgba(0, 0, 0, 0.12));--_button-raised-active-shadow:var(--forge-button-raised-active-shadow, 0px 5px 5px -3px rgba(0, 0, 0, 0.2), 0px 8px 10px 1px rgba(0, 0, 0, 0.14), 0px 3px 14px 2px rgba(0, 0, 0, 0.12));--_button-raised-disabled-shadow:var(--forge-button-raised-disabled-shadow, none);--_button-link-color:var(--forge-button-link-color, var(--_button-primary-color));--_button-link-text-decoration:var(--forge-button-link-text-decoration, underline);--_button-link-height:var(--forge-button-link-height, auto);--_button-link-padding:var(--forge-button-link-padding, 0);--_button-link-line-height:var(--forge-button-link-line-height, normal);--_button-link-width:var(--forge-button-link-width, auto);--_button-link-hover-text-decoration:var(--forge-button-link-hover-text-decoration, none);--_button-link-active-opacity:var(--forge-button-link-active-opacity, 0.65);--_button-link-transition-duration:var(--forge-button-link-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-link-transition-timing:var(--forge-button-link-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-disabled-text-color:var(--forge-button-disabled-text-color, var(--forge-theme-text-low, rgba(0, 0, 0, 0.38)));--_button-disabled-background:var(--forge-button-disabled-background, transparent);--_button-disabled-border-color:var(--forge-button-disabled-border-color, var(--_button-disabled-color));--_button-disabled-shadow:var(--forge-button-disabled-shadow, none);--_button-dense-height:var(--forge-button-dense-height, 24px);--_button-pill-shape:var(--forge-button-pill-shape, var(--forge-shape-full, 9999px));--_button-pill-padding-inline:var(--forge-button-pill-padding-inline, var(--forge-spacing-small, 12px));--_button-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 4px);--_button-text-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 0px);--_button-link-focus-indicator-offset:var(--forge-button-focus-indicator-offset, 2px);--_button-popover-icon-transition-duration:var(--forge-button-popover-icon-transition-duration, var(--forge-animation-duration-short3, 150ms));--_button-popover-icon-transition-timing:var(--forge-button-popover-icon-transition-timing, var(--forge-animation-easing-standard, cubic-bezier(0.2, 0, 0, 1)));--_button-popover-icon-open-rotation:var(--forge-button-popover-icon-open-rotation, 180deg)}.forge-button{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-button-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-button-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-button-font-size-scale, .875)));font-weight:var(--forge-typography-button-font-weight,500);line-height:var(--forge-typography-button-line-height, normal);letter-spacing:var(--forge-typography-button-letter-spacing, .0714285714em);text-transform:var(--forge-typography-button-text-transform,inherit);-webkit-text-decoration:var(--forge-typography-button-text-decoration,inherit);text-decoration:var(--forge-typography-button-text-decoration,inherit);position:relative;display:var(--_button-display);-webkit-box-align:center;align-items:center;-webkit-box-pack:var(--_button-justify);justify-content:var(--_button-justify);gap:var(--_button-spacing);z-index:0;-webkit-box-sizing:border-box;box-sizing:border-box;min-inline-size:var(--_button-min-width);height:var(--_button-height);inline-size:100%;border-width:var(--_button-border-width);border-style:var(--_button-border-style);border-color:var(--_button-border-color);border-start-start-radius:var(--_button-shape-start-start-radius);border-start-end-radius:var(--_button-shape-start-end-radius);border-end-start-radius:var(--_button-shape-end-start-radius);border-end-end-radius:var(--_button-shape-end-end-radius);padding-block:var(--_button-padding-block);padding-inline:var(--_button-padding-inline);-webkit-box-shadow:var(--_button-shadow);box-shadow:var(--_button-shadow);outline:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-appearance:none;vertical-align:middle;text-decoration:none;white-space:nowrap;background:var(--_button-background);color:var(--_button-color);cursor:var(--_button-cursor);-webkit-transition-property:background,-webkit-box-shadow;transition-property:background,-webkit-box-shadow;transition-property:box-shadow,background;transition-property:box-shadow,background,-webkit-box-shadow;-webkit-transition-duration:var(--_button-transition-duration);transition-duration:var(--_button-transition-duration);-webkit-transition-timing-function:var(--_button-transition-timing);transition-timing-function:var(--_button-transition-timing)}.forge-button::-moz-focus-inner{padding:0;border:0}.forge-button:hover{--_button-shadow:var(--_button-hover-shadow);background:var(--_button-hover-background)}.forge-button:active{--_button-shadow:var(--_button-active-shadow);background:var(--_button-active-background)}.forge-button ::slotted(:is([slot=start],[slot=end])){font-size:var(--_button-icon-size)}a{position:absolute;inset:0;text-decoration:none}forge-state-layer{--forge-state-layer-color:var(--_button-color)}forge-focus-indicator{--forge-focus-indicator-color:var(--_button-primary-color);--forge-focus-indicator-outward-offset:var(--_button-focus-indicator-offset)}:host([theme=secondary]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-secondary, #ffc107))}:host([theme=secondary][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-secondary-container, #fff0c3));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-secondary-container, #8a6804))}:host([theme=tertiary]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-tertiary, #3d5afe))}:host([theme=tertiary][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-tertiary-container, #d0d7ff));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-tertiary-container, #213189))}:host([theme=success]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-success, #2e7d32))}:host([theme=success][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-success-container, #cde0ce));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-success-container, #19441b))}:host([theme=error]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-error, #b00020))}:host([theme=error][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-error-container, #ecc2c9));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-error-container, #5f0011))}:host([theme=warning]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-warning, #d14900))}:host([theme=warning][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-warning-container, #f4d3c2));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-warning-container, #712700))}:host([theme=info]) .forge-button{--_button-primary-color:var(--forge-button-primary-color, var(--forge-theme-info, #1565c0))}:host([theme=info][variant=tonal]) .forge-button{--_button-tonal-background:var(--forge-button-tonal-background, var(--forge-theme-info-container, #c7daf0));--_button-tonal-color:var(--forge-button-tonal-color, var(--forge-theme-on-info-container, #0b3768))}:host(:is(:not([variant],[variant=text]))) .forge-button{--_button-focus-indicator-offset:var(--_button-text-focus-indicator-offset)}:host(:is([variant=filled],[variant=raised])) .forge-button{--_button-background:var(--_button-filled-background);--_button-color:var(--_button-filled-color)}:host(:is([variant=filled],[variant=raised])) forge-state-layer{--forge-state-layer-color:var(--_button-filled-color)}:host([variant=raised]) .forge-button{--_button-shadow:var(--_button-raised-shadow)}:host([variant=raised]) .forge-button:hover{--_button-shadow:var(--_button-raised-hover-shadow)}:host([variant=raised]) .forge-button:active{--_button-shadow:var(--_button-raised-active-shadow)}:host([variant=tonal]) .forge-button{--_button-background:var(--_button-tonal-background);--_button-color:var(--_button-tonal-color)}:host([variant=tonal]) forge-state-layer{--forge-state-layer-color:var(--_button-tonal-color)}:host([variant=outlined]) .forge-button{--_button-background:var(--_button-outlined-background);--_button-color:var(--_button-outlined-color);--_button-border-width:var(--_button-outlined-border-width);--_button-border-style:var(--_button-outlined-border-style);--_button-border-color:var(--_button-outlined-border-color)}:host([variant=link]) .forge-button{--_button-color:var(--_button-link-color);--_button-height:var(--_button-link-height);--_button-padding:var(--_button-link-padding);--_button-focus-indicator-offset:var(--_button-link-focus-indicator-offset);-webkit-text-decoration:var(--_button-link-text-decoration);text-decoration:var(--_button-link-text-decoration);line-height:var(--_button-link-line-height);-webkit-transition:opacity var(--_button-link-transition-duration) var(--_button-link-transition-timing);transition:opacity var(--_button-link-transition-duration) var(--_button-link-transition-timing);inline-size:var(--_button-link-width)}:host([variant=link]) .forge-button:hover{-webkit-text-decoration:var(--_button-link-hover-text-decoration);text-decoration:var(--_button-link-hover-text-decoration)}:host([variant=link]) .forge-button:active{opacity:var(--_button-link-active-opacity)}:host([full-width]){width:100%}:host([dense]) .forge-button{--_button-height:var(--_button-dense-height)}:host([pill]) .forge-button{--_button-shape:var(--_button-pill-shape);--_button-padding-inline:var(--_button-pill-padding-inline)}:host([pill]) forge-focus-indicator{--forge-focus-indicator-shape:var(--_button-pill-shape)}:host(:not([anchor])[disabled]){cursor:var(--_button-disabled-cursor)}:host(:not([anchor])[disabled]) .forge-button{--_button-background:var(--_button-disabled-background);--_button-color:var(--_button-disabled-text-color);--_button-shadow:var(--_button-disabled-shadow);pointer-events:none}:host(:not([anchor])[variant=outlined][disabled]) .forge-button{--_button-border-color:var(--_button-disabled-border-color)}:host(:not([anchor])[variant=tonal][disabled]) .forge-button{--_button-background:var(--_button-tonal-disabled-background);--_button-color:var(--_button-tonal-disabled-color)}:host(:not([anchor]):is([variant=filled],[variant=raised])[disabled]) .forge-button{--_button-background:var(--_button-filled-disabled-background);--_button-color:var(--_button-filled-disabled-color)}:host(:not([anchor])[variant=raised][disabled]) .forge-button{--_button-shadow:var(--_button-raised-disabled-shadow)}:host([popover-icon]) .forge-button__popover-icon{-webkit-transition:rotate var(--_button-popover-icon-transition-duration) var(--_button-popover-icon-transition-timing);transition:rotate var(--_button-popover-icon-transition-duration) var(--_button-popover-icon-transition-timing)}:host([popover-icon][aria-expanded=true]) .forge-button__popover-icon{rotate:var(--_button-popover-icon-open-rotation)}::slotted(forge-circular-progress){--forge-circular-progress-indicator-color:var(--_button-color);--forge-circular-progress-track-color:transparent;--forge-circular-progress-size:1em}';
 /**
  * @tag forge-button
  *
@@ -27,6 +27,7 @@ const styles = ':host{--_button-display:var(--forge-button-display, inline-flex)
  *
  * @property {string} type - The type of button. Defaults to `button`. Valid values are `button`, `submit`, and `reset`.
  * @property {ButtonVariant} variant - The variant of the button. Defaults to `text`.
+ * @property {boolean} fullWidth - Whether or not the button is full-width.
  * @property {boolean} disabled - Whether or not the button is disabled.
  * @property {boolean} popoverIcon - Whether or not the button shows a built-in popover icon.
  * @property {string} name - The name of the button.
@@ -43,6 +44,7 @@ const styles = ':host{--_button-display:var(--forge-button-display, inline-flex)
  *
  * @attribute {string} type - The type of button. Defaults to `button`. Valid values are `button`, `submit`, and `reset`.
  * @attribute {ButtonVariant} variant - The variant of the button. Defaults to `text`.
+ * @attribute {boolean} full-width - Whether or not the button is full-width.
  * @attribute {boolean} disabled - Whether or not the button is disabled.
  * @attribute {boolean} popover-icon - Whether or not the button shows a built-in popover icon.
  * @attribute {string} name - The name of the button.
@@ -155,6 +157,9 @@ let ButtonComponent = class ButtonComponent extends BaseButton {
             case BUTTON_CONSTANTS.observedAttributes.THEME:
                 this.theme = newValue;
                 return;
+            case BUTTON_CONSTANTS.observedAttributes.FULL_WIDTH:
+                this.fullWidth = coerceBoolean(newValue);
+                return;
         }
         super.attributeChangedCallback(name, oldValue, newValue);
     }
@@ -168,6 +173,9 @@ __decorate([
 __decorate([
     FoundationProperty()
 ], ButtonComponent.prototype, "theme", void 0);
+__decorate([
+    FoundationProperty()
+], ButtonComponent.prototype, "fullWidth", void 0);
 ButtonComponent = __decorate([
     CustomElement({
         name: BUTTON_CONSTANTS.elementName,

package/esm/constants.d.ts

@@ -3,18 +3,30 @@
  * Copyright 2023 Tyler Technologies, Inc. 
  * License: Apache-2.0
  */
+import type { IBaseComponent } from './core/base/base-component';
 export declare const COMPONENT_NAME_PREFIX = "forge-";
 export declare const KEYSTROKE_DEBOUNCE_THRESHOLD = 500;
 export declare const ICON_CLASS_NAME = "tyler-icons";
 export declare const CDN_BASE_URL = "https://cdn.forge.tylertech.com/";
+/** A method symbol that gets the submitted value of a form-associated component. */
+export declare const getFormValue: unique symbol;
+/** A method symbol that gets the form state of a form-associated component. */
+export declare const getFormState: unique symbol;
+/** A method symbol that gets the validation message of a form-associated component. */
+export declare const getValidationMessage: unique symbol;
 /** A property symbol that references the `ElementInternals` instance of an element. */
 export declare const internals: unique symbol;
+/** A property symbol that sets the type of an internal input element used to create validations messages */
+export declare const inputType: unique symbol;
 /** A property symbol that indicates whether or not a `Focusable` element can be focused. */
 export declare const isFocusable: unique symbol;
+/** A method symbol that sets default ARIA on the `ElementInternals` instance of an element if
+ * supported or sprouts attributes if not. */
+export declare const setDefaultAria: unique symbol;
 export type Theme = 'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'error' | 'info';
 export type Density = 'small' | 'medium' | 'large';
-export type MixinBase<ExpectedBase = object> = abstract new (...args: any[]) => ExpectedBase;
-export type MixinReturn<TBase extends MixinBase, MixinClass = object> = (abstract new (...args: any[]) => MixinClass) & TBase;
+export type AbstractConstructor<T> = abstract new (...args: any[]) => T;
+export type MixinBase<TBase = IBaseComponent> = AbstractConstructor<TBase>;
 /**
  * The `focusVisible` property is an experimental feature that is not yet supported by all browsers.
  *

package/esm/constants.js

@@ -7,7 +7,18 @@ export const COMPONENT_NAME_PREFIX = 'forge-';
 export const KEYSTROKE_DEBOUNCE_THRESHOLD = 500;
 export const ICON_CLASS_NAME = 'tyler-icons';
 export const CDN_BASE_URL = 'https://cdn.forge.tylertech.com/';
+/** A method symbol that gets the submitted value of a form-associated component. */
+export const getFormValue = Symbol('getFormValue');
+/** A method symbol that gets the form state of a form-associated component. */
+export const getFormState = Symbol('getFormState');
+/** A method symbol that gets the validation message of a form-associated component. */
+export const getValidationMessage = Symbol('getValidityMessage');
 /** A property symbol that references the `ElementInternals` instance of an element. */
 export const internals = Symbol('ElementInternals');
+/** A property symbol that sets the type of an internal input element used to create validations messages */
+export const inputType = Symbol('inputType');
 /** A property symbol that indicates whether or not a `Focusable` element can be focused. */
 export const isFocusable = Symbol('isFocusable');
+/** A method symbol that sets default ARIA on the `ElementInternals` instance of an element if
+ * supported or sprouts attributes if not. */
+export const setDefaultAria = Symbol('setDefaultAria');

package/esm/core/base/base-adapter.d.ts

@@ -8,6 +8,7 @@ export interface IBaseAdapter<T extends HTMLElement = HTMLElement> {
     readonly hostElement: T;
     readonly isConnected: boolean;
     removeHostAttribute(name: string): void;
+    hasHostAttribute(name: string): boolean;
     getHostAttribute(name: string): string | null;
     setHostAttribute(name: string, value?: string): void;
     toggleHostAttribute(name: string, hasAttribute: boolean, value?: string): void;
@@ -17,6 +18,7 @@ export interface IBaseAdapter<T extends HTMLElement = HTMLElement> {
         composed?: boolean;
     }): boolean;
     emitHostEvent(type: string, data?: any, bubble?: boolean, cancelable?: boolean): boolean;
+    dispatchHostEvent<U extends Event>(event: U): boolean;
     addHostListener(event: string, callback: (event: Event) => void, options?: boolean | AddEventListenerOptions): void;
     removeHostListener(event: string, callback: (event: Event) => void, options?: boolean | AddEventListenerOptions): void;
     addWindowListener(event: string, callback: (event: Event) => void, options?: boolean | AddEventListenerOptions): void;
@@ -32,6 +34,7 @@ export declare class BaseAdapter<T extends IBaseComponent> implements IBaseAdapt
     protected _component: T;
     constructor(_component: T);
     get hostElement(): T;
+    hasHostAttribute(name: string): boolean;
     getHostAttribute(name: string): string | null;
     setHostAttribute(name: string, value?: string): void;
     removeHostAttribute(name: string): void;
@@ -42,6 +45,7 @@ export declare class BaseAdapter<T extends IBaseComponent> implements IBaseAdapt
         composed?: boolean;
     }): boolean;
     emitHostEvent(type: string, data?: any, bubble?: boolean, cancelable?: boolean): boolean;
+    dispatchHostEvent<U extends Event>(event: U): boolean;
     toggleHostListener(event: string, listener: EventListener, value: boolean, options?: boolean | AddEventListenerOptions): void;
     addHostListener(event: string, callback: (event: Event) => void, options?: boolean | AddEventListenerOptions): void;
     removeHostListener(event: string, callback: (event: Event) => void, options?: boolean | AddEventListenerOptions): void;

package/esm/core/base/base-adapter.js

@@ -11,6 +11,9 @@ export class BaseAdapter {
     get hostElement() {
         return this._component;
     }
+    hasHostAttribute(name) {
+        return this._component.hasAttribute(name);
+    }
     getHostAttribute(name) {
         return this._component.getAttribute(name);
     }
@@ -40,6 +43,9 @@ export class BaseAdapter {
     emitHostEvent(type, data = null, bubble = true, cancelable) {
         return emitEvent(this._component, type, data, bubble, cancelable);
     }
+    dispatchHostEvent(event) {
+        return !this._component.dispatchEvent(event);
+    }
     toggleHostListener(event, listener, value, options) {
         if (value) {
             this.addHostListener(event, listener, options);

package/esm/core/base/base-component.d.ts

@@ -4,6 +4,10 @@
  * License: Apache-2.0
  */
 export interface IBaseComponent extends HTMLElement {
+    initializedCallback?(): void;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    attributeChangedCallback?(name: string, oldValue: string, newValue: string): void;
 }
 export declare abstract class BaseComponent extends HTMLElement implements IBaseComponent {
 }

package/esm/core/base/base-element-internals-component.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+import { internals, MixinBase, setDefaultAria, AbstractConstructor } from '../../constants';
+import { ARIAAttribute, ARIAMixinStrict, DefaultAriaOptions } from '../utils/a11y-utils';
+import { IBaseComponent } from './base-component';
+/**
+ * A component with attached Element Internals.
+ */
+export interface IWithElementInternals extends IBaseComponent {
+    /**
+     * The Element Internals of the component.
+     */
+    readonly [internals]: ElementInternals;
+    /**
+     * Sets the default ARIA of the component using Element Internals if supported or sprouting
+     * ARIA attributes if not.
+     *
+     * @param properties The ARIA properties and values to set.
+     * @param options Whether or not to overwrite existing ARIA attributes. This only takes effect
+     * if Element Internals are not supported and a new attribute will be sprouted.
+     */
+    [setDefaultAria](properties: Partial<ARIAMixinStrict>, options?: DefaultAriaOptions): void;
+}
+export declare abstract class WithElementInternalsContract {
+    readonly [internals]: ElementInternals;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    [setDefaultAria](properties: Partial<ARIAMixinStrict>, options?: DefaultAriaOptions): void;
+}
+/**
+ * Mixes in Element Internals functionality into a base component.
+ *
+ * @param base The base component to mix into.
+ * @param observedAria An array of ARIA attributes to observe for changes. If an observed attribute
+ * is removed, the default ARIA will be restored. This is only used if Element Internals is not
+ * supported.
+ * @returns The mixed-in base component.
+ */
+export declare function WithElementInternals<TBase extends MixinBase>(base: TBase, observedAria?: ARIAAttribute[]): AbstractConstructor<WithElementInternalsContract> & TBase;

package/esm/core/base/base-element-internals-component.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+import { internals, setDefaultAria } from '../../constants';
+import { ariaAttributeToProperty, restoreDefaultAria as restoreDefaultAriaUtil, setDefaultAria as setDefaultAriaUtil } from '../utils/a11y-utils';
+import { supportsElementInternalsAria } from '../utils/feature-detection';
+/**
+ * Mixes in Element Internals functionality into a base component.
+ *
+ * @param base The base component to mix into.
+ * @param observedAria An array of ARIA attributes to observe for changes. If an observed attribute
+ * is removed, the default ARIA will be restored. This is only used if Element Internals is not
+ * supported.
+ * @returns The mixed-in base component.
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function WithElementInternals(base, observedAria) {
+    class ElementInternalsComponent extends base {
+        constructor(...args) {
+            super(...args);
+            this[internals] = this.attachInternals();
+        }
+        attributeChangedCallback(name, oldValue, newValue) {
+            var _a;
+            (_a = super.attributeChangedCallback) === null || _a === void 0 ? void 0 : _a.call(this, name, oldValue, newValue);
+            // If Element Internals is supported our default ARIA is never set as an attribute, so
+            // there's nothing to do here.
+            if (!observedAria || supportsElementInternalsAria()) {
+                return;
+            }
+            // If the observed attribute is removed, restore the default ARIA.
+            if (observedAria.includes(name) && !newValue) {
+                const ariaPropertyName = ariaAttributeToProperty(name);
+                this._restoreDefaultAria(ariaPropertyName);
+            }
+        }
+        [setDefaultAria](properties, options) {
+            setDefaultAriaUtil(this, this[internals], properties, options);
+        }
+        _restoreDefaultAria(name) {
+            restoreDefaultAriaUtil(this, name);
+        }
+    }
+    return ElementInternalsComponent;
+}

package/esm/core/base/base-focusable-component.d.ts

@@ -11,28 +11,24 @@
  * Adapted and influenced from [Material Web](https://github.com/material-components/material-web).
  * The original source code can be found at: [GitHub](https://github.com/material-components/material-web/blob/main/labs/behaviors/focusable.ts)
  */
-import { isFocusable, MixinBase, MixinReturn } from '../../constants';
-import { BaseComponent, IBaseComponent } from './base-component';
+import { AbstractConstructor, isFocusable, MixinBase } from '../../constants';
+import { IBaseComponent } from './base-component';
 /**
  * An element that can enable and disable `tabindex` focusability.
  */
-export interface IBaseFocusableComponent extends IBaseComponent {
+export interface IWithFocusable extends IBaseComponent {
     /**
      * Whether or not the element can be focused. Defaults to true. Set to false
      * to disable focusing (unless a user has set a `tabindex`).
      */
     [isFocusable]: boolean;
+}
+export declare abstract class WithFocusableContract {
+    get [isFocusable](): boolean;
+    set [isFocusable](value: boolean);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
 }
-/**
- * Mixes in focusable functionality into a base component.
- *
- * @param base The base component to mix into.
- * @returns The mixed-in base component.
- */
-export declare function WithFocusable<T extends MixinBase<BaseComponent>>(base: T): MixinReturn<T, IBaseFocusableComponent>;
-declare const BaseFocusableComponent_base: MixinReturn<typeof BaseComponent, IBaseFocusableComponent>;
 /**
  * Provides focusable functionality for an element.
  *
@@ -43,7 +39,8 @@ declare const BaseFocusableComponent_base: MixinReturn<typeof BaseComponent, IBa
  * but a user sets `tabindex="0"`, it will still be focusable.
  *
  * To remove user overrides and restore focus control to the element, remove the `tabindex` attribute.
+ *
+ * @param base The base component to mix into.
+ * @returns The mixed-in base component.
  */
-export declare abstract class BaseFocusableComponent extends BaseFocusableComponent_base implements IBaseFocusableComponent {
-}
-export {};
+export declare function WithFocusable<TBase extends MixinBase>(base: TBase): AbstractConstructor<WithFocusableContract> & TBase;

package/esm/core/base/base-focusable-component.js

@@ -12,17 +12,25 @@
  * The original source code can be found at: [GitHub](https://github.com/material-components/material-web/blob/main/labs/behaviors/focusable.ts)
  */
 import { isFocusable } from '../../constants';
-import { BaseComponent } from './base-component';
 const _privateIsFocusable = Symbol('privateIsFocusable');
 const _externalTabIndex = Symbol('externalTabIndex');
 const _isUpdatingTabIndex = Symbol('isUpdatingTabIndex');
 const _updateTabIndex = Symbol('updateTabIndex');
 /**
- * Mixes in focusable functionality into a base component.
+ * Provides focusable functionality for an element.
+ *
+ * Elements can enable and disable their focusability with the `isFocusable`
+ * symbol property. **Use this instead of changing `tabIndex` directly.**
+ *
+ * This will preserve externally-set tabindices. If an element sets `tabindex="-1"`,
+ * but a user sets `tabindex="0"`, it will still be focusable.
+ *
+ * To remove user overrides and restore focus control to the element, remove the `tabindex` attribute.
  *
  * @param base The base component to mix into.
  * @returns The mixed-in base component.
  */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function WithFocusable(base) {
     var _a, _b, _c;
     class FocusableComponent extends base {
@@ -48,10 +56,14 @@ export function WithFocusable(base) {
             this[_updateTabIndex]();
         }
         connectedCallback() {
+            var _d;
+            (_d = super.connectedCallback) === null || _d === void 0 ? void 0 : _d.call(this);
             // This must be set in the connectedCallback to avoid sprouting a tabindex attribute on the host from the ctor
             this[isFocusable] = true;
         }
         attributeChangedCallback(name, oldValue, newValue) {
+            var _d;
+            (_d = super.attributeChangedCallback) === null || _d === void 0 ? void 0 : _d.call(this, name, oldValue, newValue);
             if (name !== 'tabindex' || this[_isUpdatingTabIndex]) {
                 return;
             }
@@ -75,16 +87,3 @@ export function WithFocusable(base) {
     }
     return FocusableComponent;
 }
-/**
- * Provides focusable functionality for an element.
- *
- * Elements can enable and disable their focusability with the `isFocusable`
- * symbol property. **Use this instead of changing `tabIndex` directly.**
- *
- * This will preserve externally-set tabindices. If an element sets `tabindex="-1"`,
- * but a user sets `tabindex="0"`, it will still be focusable.
- *
- * To remove user overrides and restore focus control to the element, remove the `tabindex` attribute.
- */
-export class BaseFocusableComponent extends WithFocusable(BaseComponent) {
-}