@tylertech/forge 3.10.5 → 3.12.0

package/esm/table/table.js

@@ -15,7 +15,10 @@ import { IconRegistry, IconComponent } from '../icon';
 import { BaseComponent } from '../core/base/base-component';
 import { CellAlign } from './types';
 import { TooltipComponent } from '../tooltip';
+import { FocusIndicatorComponent } from '../focus-indicator';
 /**
+ * @summary Tables are used to display sets of data. They organize information into rows and columns, making it easier to read, compare, and analyze. The Forge table provides a configuration-based approach to building data tables with means for sorting, filtering, selecting, and customizing the display of tabular data.
+ *
  * @tag forge-table
  *
  * @dependency forge-expansion-panel
@@ -309,7 +312,7 @@ __decorate([
 TableComponent = __decorate([
     customElement({
         name: TABLE_CONSTANTS.elementName,
-        dependencies: [ExpansionPanelComponent, IconComponent, CheckboxComponent, TooltipComponent]
+        dependencies: [ExpansionPanelComponent, IconComponent, CheckboxComponent, TooltipComponent, FocusIndicatorComponent]
     })
 ], TableComponent);
 export { TableComponent };

package/esm/tabs/tab/tab-adapter.js

@@ -8,12 +8,12 @@ import { STATE_LAYER_CONSTANTS } from '../../state-layer';
 import { BaseAdapter } from '../../core/base/base-adapter';
 import { TAB_BAR_CONSTANTS } from '../tab-bar/tab-bar-constants';
 import { TAB_CONSTANTS } from './tab-constants';
-import { FOCUS_INDICATOR_CONSTANTS } from '../../focus-indicator';
+import { FOCUS_INDICATOR_TAG_NAME } from '../../focus-indicator';
 export class TabAdapter extends BaseAdapter {
     constructor(component) {
         super(component);
         this._tabIndicatorElement = getShadowElement(this._component, TAB_CONSTANTS.selectors.INDICATOR);
-        this._focusIndicatorElement = getShadowElement(this._component, FOCUS_INDICATOR_CONSTANTS.elementName);
+        this._focusIndicatorElement = getShadowElement(this._component, FOCUS_INDICATOR_TAG_NAME);
         this._stateLayerElement = getShadowElement(this._component, STATE_LAYER_CONSTANTS.elementName);
     }
     initialize() {

package/esm/tabs/tab/tab.d.ts

@@ -26,6 +26,8 @@ declare global {
 /**
  * @tag forge-tab
  *
+ * @summary Tab components represent a single tab inside a tab bar.
+ *
  * @dependency forge-focus-indicator
  * @dependency forge-state-layer
  *

package/esm/tabs/tab/tab.js

@@ -16,6 +16,8 @@ const styles = ':host{display:inline-flex;outline:0;-webkit-tap-highlight-color:
 /**
  * @tag forge-tab
  *
+ * @summary Tab components represent a single tab inside a tab bar.
+ *
  * @dependency forge-focus-indicator
  * @dependency forge-state-layer
  *

package/esm/tabs/tab-bar/tab-bar.d.ts

@@ -31,7 +31,7 @@ declare const TabBarComponent_base: import("../../constants").AbstractConstructo
 /**
  * @tag forge-tab-bar
  *
- * @summary Tabs organize content across different screens and views.
+ * @summary Tab bars organize a set of tabs, holding selection state and enabling navigation between different views or sections of content.
  *
  * @description
  * Use tabs to group content into helpful categories. Tabs are typically placed

package/esm/tabs/tab-bar/tab-bar.js

@@ -21,7 +21,7 @@ const styles = ':host{position:relative;display:block}:host([hidden]){display:no
 /**
  * @tag forge-tab-bar
  *
- * @summary Tabs organize content across different screens and views.
+ * @summary Tab bars organize a set of tabs, holding selection state and enabling navigation between different views or sections of content.
  *
  * @description
  * Use tabs to group content into helpful categories. Tabs are typically placed

package/esm/text-field/text-field-adapter.d.ts

@@ -12,13 +12,14 @@ export interface ITextFieldAdapter extends IBaseFieldAdapter {
     addRootListener(name: keyof HTMLElementEventMap, listener: EventListener): void;
     removeRootListener(name: keyof HTMLElementEventMap, listener: EventListener): void;
     disableInput(disabled: boolean): void;
+    setInvalid(value: boolean): void;
     handleDefaultSlotChange(listener: TextFieldInputAttributeObserver): void;
     tryAddValueChangeListener(context: unknown, listener: TextFieldValueChangeListener): void;
     removeValueChangeListener(): void;
     tryFloatLabel(force?: boolean): void;
     tryConnectSlottedLabel(): void;
-    connectClearButton(listener: EventListener): void;
-    disconnectClearButton(listener: EventListener): void;
+    connectClearButton(clickListener: EventListener, mouseDownListener: EventListener): void;
+    disconnectClearButton(clickListener: EventListener, mouseDownListener: EventListener): void;
     toggleClearButtonVisibility(visible: boolean): void;
     clearInput(): void;
     getAllSlotElements(): HTMLSlotElement[];
@@ -39,6 +40,7 @@ export declare class TextFieldAdapter extends BaseFieldAdapter implements ITextF
     addRootListener(name: keyof HTMLElementEventMap, listener: EventListener): void;
     removeRootListener(name: keyof HTMLElementEventMap, listener: EventListener): void;
     disableInput(disabled: boolean): void;
+    setInvalid(value: boolean): void;
     inputIsDisabled(): boolean;
     click(): void;
     applyLabel(value: string | null): void;
@@ -47,8 +49,8 @@ export declare class TextFieldAdapter extends BaseFieldAdapter implements ITextF
     removeValueChangeListener(): void;
     tryFloatLabel(force?: boolean): void;
     tryConnectSlottedLabel(): void;
-    connectClearButton(listener: EventListener): void;
-    disconnectClearButton(listener: EventListener): void;
+    connectClearButton(clickListener: EventListener, mouseDownListener: EventListener): void;
+    disconnectClearButton(clickListener: EventListener, mouseDownListener: EventListener): void;
     toggleClearButtonVisibility(visible: boolean): void;
     clearInput(): void;
     getAllSlotElements(): HTMLSlotElement[];

package/esm/text-field/text-field-adapter.js

@@ -40,6 +40,9 @@ export class TextFieldAdapter extends BaseFieldAdapter {
     disableInput(disabled) {
         this._inputElements.forEach(el => (el.disabled = disabled));
     }
+    setInvalid(value) {
+        this._inputElements.forEach(el => toggleAttribute(el, value, 'aria-invalid', 'true'));
+    }
     inputIsDisabled() {
         return this._inputElements.some(el => el.disabled);
     }
@@ -130,11 +133,15 @@ export class TextFieldAdapter extends BaseFieldAdapter {
         inputElement.id = id;
         label.htmlFor = id;
     }
-    connectClearButton(listener) {
-        this._clearButtonSlotElement.addEventListener('click', listener);
+    connectClearButton(clickListener, mouseDownListener) {
+        this._clearButtonSlotElement.addEventListener('click', clickListener);
+        if (mouseDownListener) {
+            this._clearButtonSlotElement.addEventListener('mousedown', mouseDownListener);
+        }
     }
-    disconnectClearButton(listener) {
-        this._clearButtonSlotElement.removeEventListener('click', listener);
+    disconnectClearButton(clickListener, mouseDownListener) {
+        this._clearButtonSlotElement.removeEventListener('click', clickListener);
+        this._clearButtonSlotElement.removeEventListener('mousedown', mouseDownListener);
     }
     toggleClearButtonVisibility(visible) {
         if (visible) {

package/esm/text-field/text-field-core.d.ts

@@ -18,6 +18,7 @@ export declare class TextFieldCore extends BaseFieldCore<ITextFieldAdapter> impl
     private _valueChangeListener;
     private _inputListener;
     private _clearButtonClickListener;
+    private _clearButtonMouseDownListener;
     constructor(_adapter: TextFieldAdapter);
     initialize(): void;
     destroy(): void;
@@ -27,6 +28,7 @@ export declare class TextFieldCore extends BaseFieldCore<ITextFieldAdapter> impl
     private _handleSlotChange;
     private _onInputAttributeChange;
     private _onClearButtonClick;
+    private _onClearButtonMouseDown;
     /** Responds to the `input` event from the <input> element. */
     private _onInputChange;
     /** Called from the `value` property setter on the <input> element. */
@@ -35,6 +37,8 @@ export declare class TextFieldCore extends BaseFieldCore<ITextFieldAdapter> impl
     private _toggleClearButtonVisibility;
     get showClear(): boolean;
     set showClear(value: boolean);
+    get invalid(): boolean;
+    set invalid(value: boolean);
     get disabled(): boolean;
     set disabled(value: boolean);
     get labelPosition(): FieldLabelPosition;

package/esm/text-field/text-field-core.js

@@ -17,6 +17,7 @@ export class TextFieldCore extends BaseFieldCore {
         this._valueChangeListener = this._onValueChange.bind(this);
         this._inputListener = this._onInputChange.bind(this);
         this._clearButtonClickListener = (evt) => this._onClearButtonClick(evt);
+        this._clearButtonMouseDownListener = (evt) => this._onClearButtonMouseDown(evt);
     }
     initialize() {
         this._adapter.tryApplyGlobalConfiguration(['labelPosition', 'variant']);
@@ -72,6 +73,9 @@ export class TextFieldCore extends BaseFieldCore {
             this._adapter.clearInput();
         }
     }
+    _onClearButtonMouseDown(evt) {
+        evt.preventDefault(); // Prevent focus change to avoid blur event
+    }
     /** Responds to the `input` event from the <input> element. */
     _onInputChange(evt) {
         let floatLabel;
@@ -101,14 +105,21 @@ export class TextFieldCore extends BaseFieldCore {
             this._showClear = value;
             this._adapter.toggleHostAttribute(TEXT_FIELD_CONSTANTS.attributes.SHOW_CLEAR, value);
             if (value) {
-                this._adapter.connectClearButton(this._clearButtonClickListener);
+                this._adapter.connectClearButton(this._clearButtonClickListener, this._clearButtonMouseDownListener);
             }
             else {
-                this._adapter.disconnectClearButton(this._clearButtonClickListener);
+                this._adapter.disconnectClearButton(this._clearButtonClickListener, this._clearButtonMouseDownListener);
             }
             this._toggleClearButtonVisibility();
         }
     }
+    get invalid() {
+        return super.invalid;
+    }
+    set invalid(value) {
+        super.invalid = value;
+        this._adapter.setInvalid(value);
+    }
     get disabled() {
         return super.disabled;
     }

package/esm/text-field/text-field.d.ts

@@ -20,7 +20,7 @@ declare global {
 /**
  * @tag forge-text-field
  *
- * @summary The Forge Text Field component wraps and styles an input or textarea element.
+ * @summary The Forge Text Field component is an input field used to capture user text input. It requires a child `<input>` or `<textarea>` element to function properly, and an optional `<label>` element can be used to provide a label for the `<input>`.
  *
  * @dependency forge-field
  * @dependency forge-icon-button

package/esm/text-field/text-field.js

@@ -19,7 +19,7 @@ const styles = ':host{display:block}:host([hidden]){display:none}forge-field{dis
 /**
  * @tag forge-text-field
  *
- * @summary The Forge Text Field component wraps and styles an input or textarea element.
+ * @summary The Forge Text Field component is an input field used to capture user text input. It requires a child `<input>` or `<textarea>` element to function properly, and an optional `<label>` element can be used to provide a label for the `<input>`.
  *
  * @dependency forge-field
  * @dependency forge-icon-button

package/esm/time-picker/time-picker-adapter.js

@@ -189,6 +189,7 @@ export class TimePickerAdapter extends BaseAdapter {
             this._toggleElement.setAttribute('aria-disabled', value.toString());
             if ('disabled' in this._toggleElement) {
                 this._toggleElement.disabled = value;
+                this._toggleElement.tabIndex = -1;
             }
             else {
                 const button = this._toggleElement.querySelector('button');

package/esm/time-picker/time-picker-core.js

@@ -579,7 +579,7 @@ export class TimePickerCore {
                 for (let totalMinutes = minMinutes; totalMinutes < TIME_PICKER_CONSTANTS.numbers.MAX_DAY_MINUTES; totalMinutes += minuteStep) {
                     const millis = minutesToMillis(totalMinutes);
                     const disabled = this._restrictedTimes.includes(millis);
-                    const label = millisToTimeString(millis, this._use24HourTime, false) || '';
+                    const label = millisToTimeString(millis, this._use24HourTime, this._allowSeconds) || '';
                     const value = { time: millis };
                     times.push({ label, value, disabled });
                 }
@@ -587,7 +587,7 @@ export class TimePickerCore {
                 for (let totalMinutes = 0; totalMinutes <= maxMinutes; totalMinutes += minuteStep) {
                     const millis = minutesToMillis(totalMinutes);
                     const disabled = this._restrictedTimes.includes(millis);
-                    const label = millisToTimeString(millis, this._use24HourTime, false) || '';
+                    const label = millisToTimeString(millis, this._use24HourTime, this._allowSeconds) || '';
                     const value = { time: millis };
                     times.push({ label, value, disabled });
                 }
@@ -602,7 +602,7 @@ export class TimePickerCore {
                     }
                     const millis = minutesToMillis(totalMinutes);
                     const disabled = this._restrictedTimes.includes(millis);
-                    const label = millisToTimeString(millis, this._use24HourTime, false) || '';
+                    const label = millisToTimeString(millis, this._use24HourTime, this._allowSeconds) || '';
                     const value = { time: millis };
                     times.push({ label, value, disabled });
                 }

package/esm/time-picker/time-picker.d.ts

@@ -44,6 +44,8 @@ declare global {
     }
 }
 /**
+ * @summary A time input component with integrated dropdown for selecting time values with support for various formats, masking, and validation options.
+ *
  * @tag forge-time-picker
  */
 export declare class TimePickerComponent extends BaseComponent implements ITimePickerComponent {

package/esm/time-picker/time-picker.js

@@ -18,6 +18,8 @@ import { PopoverComponent } from '../popover/popover';
 const template = '<template><slot></slot></template>';
 const styles = ':host{display:block}:host([hidden]){display:none}';
 /**
+ * @summary A time input component with integrated dropdown for selecting time values with support for various formats, masking, and validation options.
+ *
  * @tag forge-time-picker
  */
 let TimePickerComponent = class TimePickerComponent extends BaseComponent {

package/esm/toast/toast-adapter.d.ts

@@ -14,6 +14,16 @@ export interface IToastAdapter extends IBaseAdapter<IToastComponent> {
     removeActionListener(listener: EventListener): void;
     setDismissLabel(label: string): void;
     setActionText(text: string): void;
+    addPointerEnterListener(listener: EventListener): void;
+    removePointerEnterListener(listener: EventListener): void;
+    addPointerLeaveListener(listener: EventListener): void;
+    removePointerLeaveListener(listener: EventListener): void;
+    addFocusInListener(listener: EventListener): void;
+    removeFocusInListener(listener: EventListener): void;
+    addFocusOutListener(listener: EventListener): void;
+    removeFocusOutListener(listener: EventListener): void;
+    addKeyboardListener(listener: EventListener): void;
+    removeKeyboardListener(listener: EventListener): void;
 }
 export declare class ToastAdapter extends BaseAdapter<IToastComponent> implements IToastAdapter {
     private _overlayElement;
@@ -29,4 +39,14 @@ export declare class ToastAdapter extends BaseAdapter<IToastComponent> implement
     removeActionListener(listener: EventListener): void;
     setDismissLabel(label: string): void;
     setActionText(text: string): void;
+    addPointerEnterListener(listener: EventListener): void;
+    removePointerEnterListener(listener: EventListener): void;
+    addPointerLeaveListener(listener: EventListener): void;
+    removePointerLeaveListener(listener: EventListener): void;
+    addFocusInListener(listener: EventListener): void;
+    removeFocusInListener(listener: EventListener): void;
+    addFocusOutListener(listener: EventListener): void;
+    removeFocusOutListener(listener: EventListener): void;
+    addKeyboardListener(listener: EventListener): void;
+    removeKeyboardListener(listener: EventListener): void;
 }

package/esm/toast/toast-adapter.js

@@ -46,4 +46,34 @@ export class ToastAdapter extends BaseAdapter {
             this._actionButtonElement.setAttribute('hidden', '');
         }
     }
+    addPointerEnterListener(listener) {
+        this._component.addEventListener('pointerenter', listener);
+    }
+    removePointerEnterListener(listener) {
+        this._component.removeEventListener('pointerenter', listener);
+    }
+    addPointerLeaveListener(listener) {
+        this._component.addEventListener('pointerleave', listener);
+    }
+    removePointerLeaveListener(listener) {
+        this._component.removeEventListener('pointerleave', listener);
+    }
+    addFocusInListener(listener) {
+        this._component.addEventListener('focusin', listener);
+    }
+    removeFocusInListener(listener) {
+        this._component.removeEventListener('focusin', listener);
+    }
+    addFocusOutListener(listener) {
+        this._component.addEventListener('focusout', listener);
+    }
+    removeFocusOutListener(listener) {
+        this._component.removeEventListener('focusout', listener);
+    }
+    addKeyboardListener(listener) {
+        this._component.addEventListener('keydown', listener);
+    }
+    removeKeyboardListener(listener) {
+        this._component.removeEventListener('keydown', listener);
+    }
 }

package/esm/toast/toast-core.d.ts

@@ -3,6 +3,7 @@
  * Copyright Tyler Technologies, Inc. 
  * License: Apache-2.0
  */
+import { IDismissibleStackState, tryDismiss } from '../core/utils/dismissible-stack';
 import { IToastAdapter } from './toast-adapter';
 import { ToastPlacement, ToastTheme } from './toast-constants';
 export interface IToastCore {
@@ -26,6 +27,13 @@ export declare class ToastCore implements IToastCore {
     private _hideTimeout;
     private _actionListener;
     private _closeListener;
+    private _isHovered;
+    private _isFocused;
+    private _pointerEnterListener;
+    private _pointerLeaveListener;
+    private _focusInListener;
+    private _focusOutListener;
+    private _keyboardListener;
     constructor(_adapter: IToastAdapter);
     initialize(): void;
     show(): void;
@@ -34,6 +42,15 @@ export declare class ToastCore implements IToastCore {
     }): Promise<void>;
     private _onAction;
     private _onClose;
+    private _handlePointerEnter;
+    private _handlePointerLeave;
+    private _handleFocusIn;
+    private _handleFocusOut;
+    private _handleKeyboard;
+    private _updateTimerState;
+    private _pauseTimer;
+    private _resumeTimer;
+    [tryDismiss](state?: IDismissibleStackState): boolean;
     get open(): boolean;
     set open(value: boolean);
     get duration(): number;

package/esm/toast/toast-core.js

@@ -3,6 +3,7 @@
  * Copyright Tyler Technologies, Inc. 
  * License: Apache-2.0
  */
+import { DismissibleStack, tryDismiss } from '../core/utils/dismissible-stack';
 import { TOAST_CONSTANTS } from './toast-constants';
 export class ToastCore {
     constructor(_adapter) {
@@ -14,15 +15,28 @@ export class ToastCore {
         this._theme = TOAST_CONSTANTS.defaults.THEME;
         this._actionListener = this._onAction.bind(this);
         this._closeListener = this._onClose.bind(this);
+        this._isHovered = false;
+        this._isFocused = false;
+        this._pointerEnterListener = this._handlePointerEnter.bind(this);
+        this._pointerLeaveListener = this._handlePointerLeave.bind(this);
+        this._focusInListener = this._handleFocusIn.bind(this);
+        this._focusOutListener = this._handleFocusOut.bind(this);
+        this._keyboardListener = this._handleKeyboard.bind(this);
     }
     initialize() {
         this._adapter.tryApplyGlobalConfiguration(['duration', 'placement', 'dismissible']);
+        this._adapter.addPointerEnterListener(this._pointerEnterListener);
+        this._adapter.addPointerLeaveListener(this._pointerLeaveListener);
+        this._adapter.addFocusInListener(this._focusInListener);
+        this._adapter.addFocusOutListener(this._focusOutListener);
+        this._adapter.addKeyboardListener(this._keyboardListener);
         if (this._open) {
             this.show();
         }
     }
     show() {
         this._adapter.show();
+        DismissibleStack.instance.add(this._adapter.hostElement);
         if (isFinite(this._duration) && this._duration > 0) {
             /* c8 ignore next 3 */
             if (this._hideTimeout) {
@@ -38,6 +52,9 @@ export class ToastCore {
             window.clearTimeout(this._hideTimeout);
             this._hideTimeout = undefined;
         }
+        this._isHovered = false;
+        this._isFocused = false;
+        DismissibleStack.instance.remove(this._adapter.hostElement);
         await this._adapter.hide();
         this._open = false;
         this._adapter.toggleHostAttribute(TOAST_CONSTANTS.attributes.OPEN, this._open);
@@ -52,6 +69,55 @@ export class ToastCore {
     _onClose(_evt) {
         this.hide();
     }
+    _handlePointerEnter() {
+        this._isHovered = true;
+        this._updateTimerState();
+    }
+    _handlePointerLeave() {
+        this._isHovered = false;
+        this._updateTimerState();
+    }
+    _handleFocusIn() {
+        this._isFocused = true;
+        this._updateTimerState();
+    }
+    _handleFocusOut() {
+        this._isFocused = false;
+        this._updateTimerState();
+    }
+    _handleKeyboard(event) {
+        if (event.key === 'Escape' && this._open) {
+            event.stopPropagation();
+            DismissibleStack.instance.dismiss(this._adapter.hostElement, { reason: 'escape' });
+        }
+    }
+    _updateTimerState() {
+        const shouldPause = this._isHovered || this._isFocused;
+        if (shouldPause && this._hideTimeout) {
+            this._pauseTimer();
+        }
+        else if (!shouldPause && !this._hideTimeout) {
+            this._resumeTimer();
+        }
+    }
+    _pauseTimer() {
+        if (this._hideTimeout) {
+            window.clearTimeout(this._hideTimeout);
+            this._hideTimeout = undefined;
+        }
+    }
+    _resumeTimer() {
+        if (isFinite(this._duration) && this._duration > 0) {
+            this._hideTimeout = window.setTimeout(() => this.hide(), this._duration);
+        }
+    }
+    [tryDismiss](state) {
+        if (state?.reason === 'escape') {
+            this.hide();
+            return true;
+        }
+        return false;
+    }
     get open() {
         return this._open;
     }

package/esm/toast/toast.d.ts

@@ -6,6 +6,7 @@
 import { BaseComponent } from '../core/base/base-component';
 import { IWithDefaultAria } from '../core/mixins/internals/with-default-aria';
 import { IWithElementInternals } from '../core/mixins/internals/with-element-internals';
+import { IDismissible, IDismissibleStackState, tryDismiss } from '../core/utils/dismissible-stack';
 import { IIconProperties } from '../icon';
 import { ToastPlacement, ToastTheme } from './toast-constants';
 export interface IToastProperties {
@@ -24,7 +25,7 @@ export interface IToastPresentConfiguration extends Partial<IToastProperties> {
     icon?: Partial<IIconProperties>;
     topLayer?: boolean;
 }
-export interface IToastComponent extends IToastProperties, IWithElementInternals, IWithDefaultAria {
+export interface IToastComponent extends IToastProperties, IWithElementInternals, IWithDefaultAria, IDismissible {
     show(): void;
     hide(): Promise<void>;
 }
@@ -41,7 +42,7 @@ declare const ToastComponent_base: import("../constants").AbstractConstructor<im
 /**
  * @tag forge-toast
  *
- * @summary Toasts are non-modal notifications that appear in response to user interactions.
+ * @summary Toasts are non-modal notifications that appear in response to user interactions. Use toasts to provide brief messages about app processes at the bottom or top of the screen. They automatically disappear after a timeout, but can also include an action button and a dismiss button.
  *
  * @dependency forge-overlay
  * @dependency forge-button
@@ -117,6 +118,12 @@ export declare class ToastComponent extends ToastComponent_base implements IToas
      * @returns A promise that resolves when the toast animation completes.
      */
     hide(): Promise<void>;
+    /**
+     * Attempts to dismiss the toast.
+     * @param state The dismiss state.
+     * @returns True if the toast was dismissed, false otherwise.
+     */
+    [tryDismiss](state?: IDismissibleStackState): boolean;
     /**
      * Presents a toast notification.
      * @param config The configuration for the toast.

package/esm/toast/toast.js

@@ -11,6 +11,7 @@ import { setDefaultAria } from '../constants';
 import { BaseComponent } from '../core/base/base-component';
 import { WithDefaultAria } from '../core/mixins/internals/with-default-aria';
 import { WithElementInternals } from '../core/mixins/internals/with-element-internals';
+import { tryDismiss } from '../core/utils/dismissible-stack';
 import { DialogComponent, dialogStack } from '../dialog';
 import { IconComponent, IconRegistry } from '../icon';
 import { IconButtonComponent } from '../icon-button';
@@ -23,7 +24,7 @@ const styles = '@keyframes slidein{from{transform:translateY(var(--_toast-slide-
 /**
  * @tag forge-toast
  *
- * @summary Toasts are non-modal notifications that appear in response to user interactions.
+ * @summary Toasts are non-modal notifications that appear in response to user interactions. Use toasts to provide brief messages about app processes at the bottom or top of the screen. They automatically disappear after a timeout, but can also include an action button and a dismiss button.
  *
  * @dependency forge-overlay
  * @dependency forge-button
@@ -138,6 +139,14 @@ let ToastComponent = class ToastComponent extends WithElementInternals(WithDefau
     hide() {
         return this._core.hide();
     }
+    /**
+     * Attempts to dismiss the toast.
+     * @param state The dismiss state.
+     * @returns True if the toast was dismissed, false otherwise.
+     */
+    [tryDismiss](state) {
+        return this._core[tryDismiss](state);
+    }
     /**
      * Presents a toast notification.
      * @param config The configuration for the toast.

package/esm/toolbar/toolbar.d.ts

@@ -15,9 +15,7 @@ declare global {
 /**
  * @tag forge-toolbar
  *
- * @summary
- * Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar.
- * This component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.
+ * @summary Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar. This component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.
  *
  * @property {boolean} [inverted=false] - Controls whether a bottom divider (default) or top divider (true) is used.
  *

package/esm/toolbar/toolbar.js

@@ -12,9 +12,7 @@ const styles = ':host{display:block}:host([hidden]){display:none}.forge-toolbar{
 /**
  * @tag forge-toolbar
  *
- * @summary
- * Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar.
- * This component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.
+ * @summary Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar. This component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.
  *
  * @property {boolean} [inverted=false] - Controls whether a bottom divider (default) or top divider (true) is used.
  *

package/esm/tooltip/tooltip-adapter.d.ts

@@ -17,6 +17,9 @@ export interface ITooltipAdapter extends IBaseAdapter<ITooltipComponent> {
     removeAnchorListener(type: string, listener: EventListener): void;
     addLightDismissListener(listener: EventListener): void;
     removeLightDismissListener(listener: EventListener): void;
+    addTooltipListener(type: string, listener: EventListener, opts?: AddEventListenerOptions): void;
+    removeTooltipListener(type: string, listener: EventListener): void;
+    isKeyboardFocused(): boolean;
     show(): void;
     hide(): void;
 }
@@ -41,6 +44,9 @@ export declare class TooltipAdapter extends BaseAdapter<ITooltipComponent> imple
     removeAnchorListener(type: string, listener: EventListener): void;
     addLightDismissListener(listener: EventListener): void;
     removeLightDismissListener(listener: EventListener): void;
+    addTooltipListener(type: string, listener: EventListener, opts?: AddEventListenerOptions): void;
+    removeTooltipListener(type: string, listener: EventListener): void;
+    isKeyboardFocused(): boolean;
     show(): void;
     hide(): void;
     /**

package/esm/tooltip/tooltip-adapter.js

@@ -80,6 +80,15 @@ export class TooltipAdapter extends BaseAdapter {
     removeLightDismissListener(listener) {
         this._overlayElement?.removeEventListener(OVERLAY_CONSTANTS.events.LIGHT_DISMISS, listener);
     }
+    addTooltipListener(type, listener, opts) {
+        this.hostElement?.addEventListener(type, listener, opts);
+    }
+    removeTooltipListener(type, listener) {
+        this.hostElement?.removeEventListener(type, listener);
+    }
+    isKeyboardFocused() {
+        return !!this._anchorElement?.matches(':focus-visible');
+    }
     show() {
         // Tooltips are shown above all content via <forge-overlay>
         // We do this by dynamically creating an overlay element and appending it to the shadow root

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

@@ -39,6 +39,7 @@ export declare const TOOLTIP_CONSTANTS: {
     };
     numbers: {
         LONGPRESS_VISIBILITY_DURATION: number;
+        HOVER_OUTSIDE_THRESHOLD: number;
     };
     defaults: {
         DELAY: number;

package/esm/tooltip/tooltip-constants.js

@@ -24,7 +24,8 @@ const attributes = {
     ...observedAttributes
 };
 const numbers = {
-    LONGPRESS_VISIBILITY_DURATION: 3000
+    LONGPRESS_VISIBILITY_DURATION: 3000,
+    HOVER_OUTSIDE_THRESHOLD: 100
 };
 const defaults = {
     DELAY: 500,