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

package/esm/core/utils/a11y-utils.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * 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/internal/aria/aria.ts)
+ */
+/**
+ * Reflective ARIA property name types.
+ */
+export type ARIAProperty = Exclude<keyof ARIAMixin, 'role'>;
+/**
+ * Reflective ARIA attributes.
+ */
+export type ARIAAttribute = `${ARIAPropertyToAttribute<ARIAProperty>}` | 'role';
+/**
+ * Reflective ARIA properties.
+ */
+export declare const ARIA_PROPERTIES: ARIAProperty[];
+/**
+ * ARIA role values.
+ */
+export type ARIARole = 'alert' | 'alertdialog' | 'button' | 'checkbox' | 'dialog' | 'gridcell' | 'link' | 'log' | 'marquee' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'option' | 'progressbar' | 'radio' | 'scrollbar' | 'searchbox' | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'tabpanel' | 'textbox' | 'timer' | 'tooltip' | 'treeitem' | 'combobox' | 'grid' | 'listbox' | 'menu' | 'menubar' | 'radiogroup' | 'tablist' | 'tree' | 'treegrid' | 'application' | 'article' | 'cell' | 'columnheader' | 'definition' | 'directory' | 'document' | 'feed' | 'figure' | 'group' | 'heading' | 'img' | 'list' | 'listitem' | 'math' | 'none' | 'note' | 'presentation' | 'region' | 'row' | 'rowgroup' | 'rowheader' | 'separator' | 'table' | 'term' | 'text' | 'toolbar' | 'banner' | 'complementary' | 'contentinfo' | 'form' | 'main' | 'navigation' | 'region' | 'search' | 'doc-abstract' | 'doc-acknowledgments' | 'doc-afterword' | 'doc-appendix' | 'doc-backlink' | 'doc-biblioentry' | 'doc-bibliography' | 'doc-biblioref' | 'doc-chapter' | 'doc-colophon' | 'doc-conclusion' | 'doc-cover' | 'doc-credit' | 'doc-credits' | 'doc-dedication' | 'doc-endnote' | 'doc-endnotes' | 'doc-epigraph' | 'doc-epilogue' | 'doc-errata' | 'doc-example' | 'doc-footnote' | 'doc-foreword' | 'doc-glossary' | 'doc-glossref' | 'doc-index' | 'doc-introduction' | 'doc-noteref' | 'doc-notice' | 'doc-pagebreak' | 'doc-pagelist' | 'doc-part' | 'doc-preface' | 'doc-prologue' | 'doc-pullquote' | 'doc-qna' | 'doc-subtitle' | 'doc-tip' | 'doc-toc';
+/**
+ * Strictly typed ARIA properties.
+ */
+export interface ARIAMixinStrict extends ARIAMixin {
+    ariaAtomic: 'true' | 'false' | null;
+    ariaAutoComplete: 'none' | 'inline' | 'list' | 'both' | null;
+    ariaBusy: 'true' | 'false' | null;
+    ariaChecked: 'true' | 'false' | null;
+    ariaColCount: `${number}` | null;
+    ariaColIndex: `${number}` | null;
+    ariaColSpan: `${number}` | null;
+    ariaCurrent: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false' | null;
+    ariaDisabled: 'true' | 'false' | null;
+    ariaExpanded: 'true' | 'false' | null;
+    ariaHasPopup: 'false' | 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
+    ariaHidden: 'true' | 'false' | null;
+    ariaInvalid: 'true' | 'false' | null;
+    ariaKeyShortcuts: string | null;
+    ariaLabel: string | null;
+    ariaLevel: `${number}` | null;
+    ariaLive: 'assertive' | 'off' | 'polite' | null;
+    ariaModal: 'true' | 'false' | null;
+    ariaMultiLine: 'true' | 'false' | null;
+    ariaMultiSelectable: 'true' | 'false' | null;
+    ariaOrientation: 'horizontal' | 'vertical' | 'undefined' | null;
+    ariaPlaceholder: string | null;
+    ariaPosInSet: `${number}` | null;
+    ariaPressed: 'true' | 'false' | null;
+    ariaReadOnly: 'true' | 'false' | null;
+    ariaRequired: 'true' | 'false' | null;
+    ariaRoleDescription: string | null;
+    ariaRowCount: `${number}` | null;
+    ariaRowIndex: `${number}` | null;
+    ariaRowSpan: `${number}` | null;
+    ariaSelected: 'true' | 'false' | null;
+    ariaSetSize: `${number}` | null;
+    ariaSort: 'ascending' | 'descending' | 'none' | 'other' | null;
+    ariaValueMax: `${number}` | null;
+    ariaValueMin: `${number}` | null;
+    ariaValueNow: `${number}` | null;
+    ariaValueText: string | null;
+    role: ARIARole | null;
+}
+/**
+ * The ARIA attribute corresponding to a given ARIA property.
+ */
+export type ARIAPropertyToAttribute<K extends string> = K extends `aria${infer Suffix}Element${infer OptS}` ? `aria-${Lowercase<Suffix>}` : K extends `aria${infer Suffix}` ? `aria-${Lowercase<Suffix>}` : K;
+/**
+ * Gets the ARIA attribute corresponding to a given ARIA property.
+ *
+ * @param property An ARIA mixin property.
+ * @returns An ARIA attribute name.
+ */
+export declare function ariaPropertyToAttribute<K extends ARIAProperty | 'role'>(property: K): string;
+/**
+ * Gets the ARIA property corresponding to a given ARIA attribute.
+ *
+ * @param attribute An ARIA attribute name.
+ * @returns An ARIA mixin property.
+ */
+export declare function ariaAttributeToProperty<K extends ARIAAttribute | 'role'>(attribute: K): ARIAProperty;
+export interface DefaultAriaOptions {
+    overwrite?: boolean;
+}
+/**
+ * Applies default ARIA to an element through ElementInternals if supported. Otherwise, ARIA
+ * attributes are set directly on the element and stored in additional `data-default-*` attributes
+ * for restoration in case attributes are overwritten during the element's lifecycle.
+ *
+ * This fallback is needed for browsers that don't support ARIA in ElementInternals, such as most
+ * recent versions of Firefox.
+ *
+ * Because new attributes may be sprouted on the element, it is necessary to call this after the
+ * element has been connected to the DOM.
+ *
+ * @param element - The element to set up ARIA attributes for.
+ * @param internals - The ElementInternals object to use for setting ARIA attributes if supported.
+ * @param properties - An object containing ARIA properties and their values to set as defaults.
+ * @param options - A `DefaultAriaOptions` object.
+ *
+ * @example
+ * class ButtonComponent extends BaseComponent {
+ *  public readonly internals: ElementInternals;
+ *
+ *  constructor() {
+ *   super();
+ *   this.internals = this.attachInternals();
+ *  }
+ *
+ *  public connectedCallback(): void {
+ *    setDefaultAria(this, this.internals, {
+ *     role: 'button'
+ *    });
+ *   }
+ * }
+ */
+export declare function setDefaultAria(element: HTMLElement, internals: ElementInternals, properties: Partial<ARIAMixinStrict>, options?: DefaultAriaOptions): void;
+/**
+ * Sets a `*Default` property on an element to backup the default value of an ARIA attribute.
+ *
+ * @param element The element to store the default ARIA value on.
+ * @param property The ARIA mixin property.
+ * @param value The default value to store.
+ */
+export declare function storeDefaultAria<T extends keyof ARIAMixinStrict>(element: HTMLElement, property: T, value: ARIAMixinStrict[T]): void;
+/**
+ * Removes a `*Default` property from an element.
+ *
+ * @param element The element to remove the default ARIA value from.
+ * @param property The ARIA mixin property.
+ */
+export declare function removeDefaultAria<T extends keyof ARIAMixinStrict>(element: HTMLElement, property: T): void;
+/**
+ * Gets a default ARIA value from an element's `*Default` property.
+ *
+ * @param element The element to retrieve the default ARIA value from.
+ * @param property An ARIA mixin property.
+ * @returns The value of the default ARIA attribute, or null if it does not exist.
+ */
+export declare function retrieveDefaultAria<T extends keyof ARIAMixinStrict>(element: HTMLElement, property: T): ARIAMixinStrict[T] | null;
+/**
+ * Restores the given ARIA attribute of an element to its default value if it exists.
+ *
+ * @param element The element to restore the ARIA attribute on.
+ * @param property The ARIA mixin property.
+ */
+export declare function restoreDefaultAria<T extends keyof ARIAMixinStrict>(element: HTMLElement, property: T): void;

package/esm/core/utils/a11y-utils.js

@@ -0,0 +1,223 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * 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/internal/aria/aria.ts)
+ */
+import { toggleAttribute } from '@tylertech/forge-core';
+import { supportsElementInternalsAria } from './feature-detection';
+/**
+ * Reflective ARIA properties.
+ */
+export const ARIA_PROPERTIES = [
+    'ariaAtomic',
+    'ariaAutoComplete',
+    'ariaBusy',
+    'ariaChecked',
+    'ariaColCount',
+    'ariaColIndex',
+    'ariaColSpan',
+    'ariaCurrent',
+    'ariaDisabled',
+    'ariaExpanded',
+    'ariaHasPopup',
+    'ariaHidden',
+    'ariaInvalid',
+    'ariaKeyShortcuts',
+    'ariaLabel',
+    'ariaLevel',
+    'ariaLive',
+    'ariaModal',
+    'ariaMultiLine',
+    'ariaMultiSelectable',
+    'ariaOrientation',
+    'ariaPlaceholder',
+    'ariaPosInSet',
+    'ariaPressed',
+    'ariaReadOnly',
+    'ariaRequired',
+    'ariaRoleDescription',
+    'ariaRowCount',
+    'ariaRowIndex',
+    'ariaRowSpan',
+    'ariaSelected',
+    'ariaSetSize',
+    'ariaSort',
+    'ariaValueMax',
+    'ariaValueMin',
+    'ariaValueNow',
+    'ariaValueText'
+];
+/**
+ * An object mapping all ARIA attributes to their corresponding properties.
+ *
+ * This is required because the proeprty name cannot be reliably inferred from the attribute name.
+ */
+const ARIA_ATTRIBUTES_TO_PROPERTIES = {
+    'aria-atomic': 'ariaAtomic',
+    'aria-autocomplete': 'ariaAutoComplete',
+    'aria-busy': 'ariaBusy',
+    'aria-checked': 'ariaChecked',
+    'aria-colcount': 'ariaColCount',
+    'aria-colindex': 'ariaColIndex',
+    'aria-colindextext': 'ariaColIndexText',
+    'aria-colspan': 'ariaColSpan',
+    'aria-current': 'ariaCurrent',
+    'aria-disabled': 'ariaDisabled',
+    'aria-expanded': 'ariaExpanded',
+    'aria-haspopup': 'ariaHasPopup',
+    'aria-hidden': 'ariaHidden',
+    'aria-invalid': 'ariaInvalid',
+    'aria-keyshortcuts': 'ariaKeyShortcuts',
+    'aria-label': 'ariaLabel',
+    'aria-level': 'ariaLevel',
+    'aria-live': 'ariaLive',
+    'aria-modal': 'ariaModal',
+    'aria-multiline': 'ariaMultiLine',
+    'aria-multiselectable': 'ariaMultiSelectable',
+    'aria-orientation': 'ariaOrientation',
+    'aria-placeholder': 'ariaPlaceholder',
+    'aria-posinset': 'ariaPosInSet',
+    'aria-pressed': 'ariaPressed',
+    'aria-readonly': 'ariaReadOnly',
+    'aria-required': 'ariaRequired',
+    'aria-roledescription': 'ariaRoleDescription',
+    'aria-rowcount': 'ariaRowCount',
+    'aria-rowindex': 'ariaRowIndex',
+    'aria-rowindextext': 'ariaRowIndexText',
+    'aria-rowspan': 'ariaRowSpan',
+    'aria-selected': 'ariaSelected',
+    'aria-setsize': 'ariaSetSize',
+    'aria-sort': 'ariaSort',
+    'aria-valuemax': 'ariaValueMax',
+    'aria-valuemin': 'ariaValueMin',
+    'aria-valuenow': 'ariaValueNow',
+    'aria-valuetext': 'ariaValueText',
+    'role': 'role'
+};
+/**
+ * Gets the ARIA attribute corresponding to a given ARIA property.
+ *
+ * @param property An ARIA mixin property.
+ * @returns An ARIA attribute name.
+ */
+export function ariaPropertyToAttribute(property) {
+    return property
+        .replace('aria', 'aria-')
+        // IDREF attributes also include an "Element" or "Elements" suffix
+        .replace(/Elements?/g, '')
+        .toLowerCase();
+}
+/**
+ * Gets the ARIA property corresponding to a given ARIA attribute.
+ *
+ * @param attribute An ARIA attribute name.
+ * @returns An ARIA mixin property.
+ */
+export function ariaAttributeToProperty(attribute) {
+    return ARIA_ATTRIBUTES_TO_PROPERTIES[attribute];
+}
+/**
+ * Applies default ARIA to an element through ElementInternals if supported. Otherwise, ARIA
+ * attributes are set directly on the element and stored in additional `data-default-*` attributes
+ * for restoration in case attributes are overwritten during the element's lifecycle.
+ *
+ * This fallback is needed for browsers that don't support ARIA in ElementInternals, such as most
+ * recent versions of Firefox.
+ *
+ * Because new attributes may be sprouted on the element, it is necessary to call this after the
+ * element has been connected to the DOM.
+ *
+ * @param element - The element to set up ARIA attributes for.
+ * @param internals - The ElementInternals object to use for setting ARIA attributes if supported.
+ * @param properties - An object containing ARIA properties and their values to set as defaults.
+ * @param options - A `DefaultAriaOptions` object.
+ *
+ * @example
+ * class ButtonComponent extends BaseComponent {
+ *  public readonly internals: ElementInternals;
+ *
+ *  constructor() {
+ *   super();
+ *   this.internals = this.attachInternals();
+ *  }
+ *
+ *  public connectedCallback(): void {
+ *    setDefaultAria(this, this.internals, {
+ *     role: 'button'
+ *    });
+ *   }
+ * }
+ */
+export function setDefaultAria(element, internals, properties, options) {
+    if (supportsElementInternalsAria()) {
+        Object.entries(properties).forEach(([key, value]) => {
+            internals[key] = value;
+        });
+        return;
+    }
+    Object.entries(properties).forEach(([key, value]) => {
+        const ariaAttribute = ariaPropertyToAttribute(key);
+        if ((options === null || options === void 0 ? void 0 : options.overwrite) || !element.hasAttribute(ariaAttribute)) {
+            toggleAttribute(element, value != null, ariaPropertyToAttribute(key), value === null || value === void 0 ? void 0 : value.toString());
+        }
+        if (value != null) {
+            storeDefaultAria(element, key, value);
+        }
+        else {
+            removeDefaultAria(element, key);
+        }
+    });
+}
+/**
+ * Sets a `*Default` property on an element to backup the default value of an ARIA attribute.
+ *
+ * @param element The element to store the default ARIA value on.
+ * @param property The ARIA mixin property.
+ * @param value The default value to store.
+ */
+export function storeDefaultAria(element, property, value) {
+    element[getDefaultAriaPropertyName(property)] = value;
+}
+/**
+ * Removes a `*Default` property from an element.
+ *
+ * @param element The element to remove the default ARIA value from.
+ * @param property The ARIA mixin property.
+ */
+export function removeDefaultAria(element, property) {
+    delete element[getDefaultAriaPropertyName(property)];
+}
+/**
+ * Gets a default ARIA value from an element's `*Default` property.
+ *
+ * @param element The element to retrieve the default ARIA value from.
+ * @param property An ARIA mixin property.
+ * @returns The value of the default ARIA attribute, or null if it does not exist.
+ */
+export function retrieveDefaultAria(element, property) {
+    const value = element[getDefaultAriaPropertyName(property)];
+    return !!value ? value : null;
+}
+/**
+ * Restores the given ARIA attribute of an element to its default value if it exists.
+ *
+ * @param element The element to restore the ARIA attribute on.
+ * @param property The ARIA mixin property.
+ */
+export function restoreDefaultAria(element, property) {
+    const defaultValue = retrieveDefaultAria(element, property);
+    if (defaultValue !== null) {
+        toggleAttribute(element, true, ariaPropertyToAttribute(property), defaultValue.toString());
+    }
+}
+function getDefaultAriaPropertyName(property) {
+    return `_forge_${property}Default`;
+}

package/esm/core/utils/event-utils.d.ts

@@ -11,3 +11,4 @@
  */
 export declare function proxyShadowScrollEvent(shadowEl: Node, proxyEl: Node): () => void;
 export declare function eventIncludesArrowKey(evt: KeyboardEvent): boolean;
+export declare function task(): Promise<void>;

package/esm/core/utils/event-utils.js

@@ -17,3 +17,6 @@ export function proxyShadowScrollEvent(shadowEl, proxyEl) {
 export function eventIncludesArrowKey(evt) {
     return evt.key === 'ArrowLeft' || evt.key === 'ArrowRight' || evt.key === 'ArrowUp' || evt.key === 'ArrowDown';
 }
+export function task() {
+    return new Promise(resolve => setTimeout(resolve));
+}

package/esm/core/utils/feature-detection.d.ts

@@ -8,3 +8,11 @@
  * @returns {boolean}
  */
 export declare function supportsPopover(): boolean;
+/**
+ * Detects if the browser supports ARIA properties in Element Internals.
+ *
+ * This currently always returns false because tooling is not yet able able to detect properties
+ * set on Element Internals.
+ * @returns {boolean}
+ */
+export declare function supportsElementInternalsAria(): boolean;

package/esm/core/utils/feature-detection.js

@@ -10,3 +10,15 @@
 export function supportsPopover() {
     return HTMLElement.prototype.hasOwnProperty('popover');
 }
+/**
+ * Detects if the browser supports ARIA properties in Element Internals.
+ *
+ * This currently always returns false because tooling is not yet able able to detect properties
+ * set on Element Internals.
+ * @returns {boolean}
+ */
+export function supportsElementInternalsAria() {
+    // TODO: return whether the user agent actually supports this when tooling is able to detect it
+    // return ElementInternals.prototype.hasOwnProperty('role');
+    return false;
+}

package/esm/core/utils/form-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+export type FormValue = File | string | FormData;
+export type FormRestoreState = File | string | Array<[string, FormDataEntryValue]>;
+export type FormRestoreReason = 'restore' | 'autocomplete';
+export type InputType = 'button' | 'checkbox' | 'color' | 'date' | 'datetime-local' | 'email' | 'file' | 'hidden' | 'image' | 'month' | 'number' | 'password' | 'radio' | 'range' | 'reset' | 'search' | 'select' | 'submit' | 'tel' | 'text' | 'time' | 'url' | 'week';
+export type InputValidationProp = keyof InputValidationProps;
+export type ValidityStateFlag = Exclude<keyof ValidityState, 'valid'>;
+export interface InputValidationProps {
+    checked: boolean | null;
+    disabled: boolean | null;
+    max: number | null;
+    maxLength: number | null;
+    min: number | null;
+    minLength: number | null;
+    multiple: boolean | null;
+    pattern: string | null;
+    required: boolean | null;
+    step: number | null;
+    value: string | null;
+}

package/esm/core/utils/form-utils.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+export {};

package/esm/core/utils/index.d.ts

@@ -6,6 +6,7 @@
 export * from './date-utils';
 export * from './event-utils';
 export * from './feature-detection';
+export * from './form-utils';
 export * from './reflect-utils';
 export * from './svg-utils';
 export * from './time-utils';

package/esm/core/utils/index.js

@@ -6,6 +6,7 @@
 export * from './date-utils';
 export * from './event-utils';
 export * from './feature-detection';
+export * from './form-utils';
 export * from './reflect-utils';
 export * from './svg-utils';
 export * from './time-utils';

package/esm/core/utils/mixin-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+import { MixinBase } from '../../constants';
+type MixinFunction<T extends MixinBase = MixinBase, R extends T = T & MixinBase> = (Base: T) => R;
+type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends (x: infer R) => any ? R : never;
+type MixinReturnValue<T extends MixinFunction<any, any>[]> = UnionToIntersection<{
+    [K in keyof T]: T[K] extends MixinFunction<any, infer U> ? U : never;
+}[number]>;
+/**
+ * Combines multiple mixins into a single component class.
+ *
+ * @param base - The base mixin to start with.
+ * @param mixins - The mixins to combine.
+ * @returns The combined component class.
+ */
+export declare function combineMixins<T extends MixinBase, K extends MixinFunction<T, any>[]>(base: T, ...mixins: K): MixinReturnValue<K>;
+export {};

package/esm/core/utils/mixin-utils.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+/**
+ * Combines multiple mixins into a single component class.
+ *
+ * @param base - The base mixin to start with.
+ * @param mixins - The mixins to combine.
+ * @returns The combined component class.
+ */
+export function combineMixins(base, ...mixins) {
+    return mixins.reduce((acc, cur) => cur(acc), base);
+}

package/esm/core/utils/reflect-utils.d.ts

@@ -38,7 +38,7 @@ export declare function getPartPrefixedAttributes(part: string, attributes: stri
  * @param callback A function to handle forwarded attributes.
  * @returns A `MutationObserver`.
  */
-export declare function forwardAttributes(from: HTMLElement, attributes: string[], callback: AttributeForwardingCallback): MutationObserver;
+export declare function forwardAttributes(from: HTMLElement, attributes: string[], callback: AttributeForwardingCallback, genericize?: boolean): MutationObserver;
 /**
  * Clones attributes from one element to another.
  * @param from The source element to clone attributes from.

package/esm/core/utils/reflect-utils.js

@@ -98,10 +98,10 @@ export function getPartPrefixedAttributes(part, attributes) {
  * @param callback A function to handle forwarded attributes.
  * @returns A `MutationObserver`.
  */
-export function forwardAttributes(from, attributes, callback) {
+export function forwardAttributes(from, attributes, callback, genericize = true) {
     // Set the source element's role to presentation to prevent duplicated ARIA attributes being
     // seen by assistive technology
-    if (attributes.some(attr => attr.toLowerCase().startsWith('aria-'))) {
+    if (genericize && attributes.some(attr => attr.toLowerCase().startsWith('aria-'))) {
         from.setAttribute('role', 'presentation');
     }
     // Parses an attribute and sends it to the provided callback

package/esm/core/utils/utils.d.ts

@@ -97,4 +97,4 @@ export declare function locateTargetHeuristic(element: HTMLElement, id?: string
  * @param preserveChildren Whether or not to preserve the children of the old element in the new element.
  * @returns The new element.
  */
-export declare function replaceElement(oldElement: HTMLElement, newElement: HTMLElement, preserveChildren?: boolean): HTMLElement;
+export declare function replaceElement<T extends HTMLElement>(oldElement: HTMLElement, newElement: T, preserveChildren?: boolean): T;

package/esm/date-picker/base/base-date-picker.d.ts

@@ -35,7 +35,7 @@ export interface IBaseDatePickerComponent<TValue> extends IBaseComponent {
 export declare abstract class BaseDatePickerComponent<TPublicValue, TPrivateValue, TFoundation extends BaseDatePickerFoundation<IBaseDatePickerAdapter, TPublicValue, TPrivateValue>> extends BaseComponent implements IBaseDatePickerComponent<TPublicValue> {
     protected _foundation: TFoundation;
     constructor();
-    connectedCallback(): Promise<void>;
+    connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
     /** Gets/sets the value of the component. */

package/esm/date-picker/base/base-date-picker.js

@@ -11,13 +11,14 @@ export class BaseDatePickerComponent extends BaseComponent {
     constructor() {
         super();
     }
-    async connectedCallback() {
+    connectedCallback() {
         if (this.querySelector(BASE_DATE_PICKER_CONSTANTS.selectors.INPUT)) {
             this._foundation.initialize();
         }
         else {
-            await ensureChild(this, BASE_DATE_PICKER_CONSTANTS.selectors.INPUT);
-            this._foundation.initialize();
+            ensureChild(this, BASE_DATE_PICKER_CONSTANTS.selectors.INPUT).then(() => {
+                this._foundation.initialize();
+            });
         }
     }
     disconnectedCallback() {

package/esm/floating-action-button/floating-action-button-adapter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+import { BaseButtonAdapter, IBaseButtonAdapter } from '../button/base/base-button-adapter';
+import { IFloatingActionButtonComponent } from './floating-action-button';
+export interface IFloatingActionButtonAdapter extends IBaseButtonAdapter {
+    destroy(): void;
+}
+export declare class FloatingActionButtonAdapter extends BaseButtonAdapter implements IFloatingActionButtonAdapter {
+    private _labelSlotElement;
+    private _extendedObserver;
+    constructor(component: IFloatingActionButtonComponent);
+    initialize(): void;
+    destroy(): void;
+    toggleDefaultPopoverIcon(value: boolean): void;
+    private _startExtendedWatcher;
+    private _detectExtendedState;
+}

package/esm/floating-action-button/floating-action-button-adapter.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2023 Tyler Technologies, Inc. 
+ * License: Apache-2.0
+ */
+import { getShadowElement } from '@tylertech/forge-core';
+import { BaseButtonAdapter } from '../button/base/base-button-adapter';
+import { FLOATING_ACTION_BUTTON_CONSTANTS } from './floating-action-button-constants';
+export class FloatingActionButtonAdapter extends BaseButtonAdapter {
+    constructor(component) {
+        super(component);
+        this._labelSlotElement = getShadowElement(this._component, FLOATING_ACTION_BUTTON_CONSTANTS.selectors.LABEL_SLOT);
+    }
+    initialize() {
+        super.initialize();
+        if (!this._extendedObserver) {
+            this._startExtendedWatcher();
+        }
+        this._detectExtendedState();
+    }
+    destroy() {
+        var _a;
+        (_a = this._extendedObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this._extendedObserver = undefined;
+    }
+    toggleDefaultPopoverIcon(value) {
+        super.toggleDefaultPopoverIcon(value);
+        this._detectExtendedState();
+    }
+    _startExtendedWatcher() {
+        this._extendedObserver = new MutationObserver(() => this._detectExtendedState());
+        this._extendedObserver.observe(this._component, { childList: true, subtree: true, characterData: true });
+    }
+    _detectExtendedState() {
+        // If there are nodes in the "label" slot, then we always assume the extended state
+        const hasLabel = this._labelSlotElement.assignedNodes().length > 0;
+        if (hasLabel) {
+            this._rootElement.classList.add(FLOATING_ACTION_BUTTON_CONSTANTS.classes.EXTENDED);
+            return;
+        }
+        // Remove the extended class first so we can compare the width without it affecting the styles
+        this._rootElement.classList.remove(FLOATING_ACTION_BUTTON_CONSTANTS.classes.EXTENDED);
+        // When the width is greater than the height, we assume the button is in the extended state
+        const isExtended = this._component.clientWidth > this._component.clientHeight;
+        if (isExtended) {
+            this._rootElement.classList.add(FLOATING_ACTION_BUTTON_CONSTANTS.classes.EXTENDED);
+        }
+    }
+}