@tylertech/forge 3.10.5 → 3.12.0

package/esm/accordion/accordion.d.ts

@@ -15,6 +15,8 @@ declare global {
 /**
  * @tag forge-accordion
  *
+ * @summary Accordions wrap a collection of expansion panels to ensure that only one panel is expanded at a time.
+ *
  * @dependency forge-expansion-panel
  *
  * @fires {CustomEvent<IExpansionPanelComponent>} forge-accordion-toggle - Dispatched when a child expansion panel is toggled. Includes the related expansion panel element in the event detail.

package/esm/accordion/accordion.js

@@ -13,6 +13,8 @@ import { AccordionCore } from './accordion-core';
 /**
  * @tag forge-accordion
  *
+ * @summary Accordions wrap a collection of expansion panels to ensure that only one panel is expanded at a time.
+ *
  * @dependency forge-expansion-panel
  *
  * @fires {CustomEvent<IExpansionPanelComponent>} forge-accordion-toggle - Dispatched when a child expansion panel is toggled. Includes the related expansion panel element in the event detail.

package/esm/app-bar/app-bar/app-bar-adapter.js

@@ -8,7 +8,7 @@ import { replaceElement } from '../../core/utils/utils';
 import { BaseAdapter } from '../../core/base/base-adapter';
 import { APP_BAR_CONSTANTS } from './app-bar-constants';
 import { STATE_LAYER_CONSTANTS } from '../../state-layer';
-import { FOCUS_INDICATOR_CONSTANTS } from '../../focus-indicator';
+import { FOCUS_INDICATOR_TAG_NAME } from '../../focus-indicator';
 export class AppBarAdapter extends BaseAdapter {
     constructor(component) {
         super(component);
@@ -50,7 +50,7 @@ export class AppBarAdapter extends BaseAdapter {
             this._logoTitleContainerElement = replaceElement(this._logoTitleContainerElement, document.createElement('div'));
             this._logoTitleContainerElement.classList.add(APP_BAR_CONSTANTS.classes.LOGO_TITLE_CONTAINER);
             this._logoTitleContainerElement.querySelector(STATE_LAYER_CONSTANTS.elementName)?.remove();
-            this._logoTitleContainerElement.querySelector(FOCUS_INDICATOR_CONSTANTS.elementName)?.remove();
+            this._logoTitleContainerElement.querySelector(FOCUS_INDICATOR_TAG_NAME)?.remove();
         }
     }
     setTarget(value) {

package/esm/app-bar/app-bar/app-bar.d.ts

@@ -24,7 +24,7 @@ declare global {
 /**
  * @tag forge-app-bar
  *
- * @description App bars are a collection of components placed as a horizontal bar at the top of the screen. They typically contain a logo, title, and optional application-wide actions.
+ * @summary App bars are headers used to display branding, navigation, and actions at the top of an application. They typically contain a logo, title, and various action items.
  *
  * @property {string} titleText - The text to display in the title.
  * @property {AppBarElevation} [elevation="raised"] - The elevation of the app bar.

package/esm/app-bar/app-bar/app-bar.js

@@ -14,7 +14,7 @@ const styles = ':host{--_app-bar-background:var(--forge-app-bar-background, var(
 /**
  * @tag forge-app-bar
  *
- * @description App bars are a collection of components placed as a horizontal bar at the top of the screen. They typically contain a logo, title, and optional application-wide actions.
+ * @summary App bars are headers used to display branding, navigation, and actions at the top of an application. They typically contain a logo, title, and various action items.
  *
  * @property {string} titleText - The text to display in the title.
  * @property {AppBarElevation} [elevation="raised"] - The elevation of the app bar.

package/esm/app-bar/help-button/app-bar-help-button.d.ts

@@ -17,7 +17,7 @@ declare global {
 /**
  * @tag forge-app-bar-help-button
  *
- * @description A utility component with predefined icon and descriptions for use in an app bar `end` slot.
+ * @summary A help button component with a predefined help icon that displays a dropdown menu when clicked, designed for use in an app bar's end slot.
  *
  * @property {IMenuOption[]} [options=[]] - The menu options to display when the button is clicked
  * @property {string} [icon=help] - The name of an alternative icon to display.

package/esm/app-bar/help-button/app-bar-help-button.js

@@ -18,7 +18,7 @@ const template = '<template><forge-menu placement=\"bottom-end\"><forge-icon-but
 /**
  * @tag forge-app-bar-help-button
  *
- * @description A utility component with predefined icon and descriptions for use in an app bar `end` slot.
+ * @summary A help button component with a predefined help icon that displays a dropdown menu when clicked, designed for use in an app bar's end slot.
  *
  * @property {IMenuOption[]} [options=[]] - The menu options to display when the button is clicked
  * @property {string} [icon=help] - The name of an alternative icon to display.

package/esm/app-bar/menu-button/app-bar-menu-button.d.ts

@@ -15,7 +15,7 @@ declare global {
 /**
  * @tag forge-app-bar-menu-button
  *
- * @description A utility component with predefined icon and descriptions for use in an app bar `start` slot.
+ * @summary A menu toggle button component with a predefined hamburger menu icon, typically used in an app bar's start slot to open navigation menus.
  *
  * @property {string} [icon=menu] - The name of an alternative icon to display.
  *

package/esm/app-bar/menu-button/app-bar-menu-button.js

@@ -16,7 +16,7 @@ const template = '<template><forge-icon-button theme=\"app-bar\"><forge-icon nam
 /**
  * @tag forge-app-bar-menu-button
  *
- * @description A utility component with predefined icon and descriptions for use in an app bar `start` slot.
+ * @summary A menu toggle button component with a predefined hamburger menu icon, typically used in an app bar's start slot to open navigation menus.
  *
  * @property {string} [icon=menu] - The name of an alternative icon to display.
  *

package/esm/app-bar/notification-button/app-bar-notification-button.d.ts

@@ -19,6 +19,8 @@ export interface IAppBarNotificationButtonComponent extends IBaseComponent {
 /**
  * @tag forge-app-bar-notification-button
  *
+ * @summary A notification button component with a predefined notification bell icon that can display a badge with count or dot indicator, designed for use in app bars.
+ *
  * @property {number | string} [count = 0] - The number to display in the badge.
  * @property {boolean} [dot = false] - Whether to display the dot variant of the badge or not.
  * @property {boolean} [showBadge = false] - Whether to display the badge or not.

package/esm/app-bar/notification-button/app-bar-notification-button.js

@@ -18,6 +18,8 @@ const template = '<template><forge-icon-button theme=\"app-bar\"><forge-icon></f
 /**
  * @tag forge-app-bar-notification-button
  *
+ * @summary A notification button component with a predefined notification bell icon that can display a badge with count or dot indicator, designed for use in app bars.
+ *
  * @property {number | string} [count = 0] - The number to display in the badge.
  * @property {boolean} [dot = false] - Whether to display the dot variant of the badge or not.
  * @property {boolean} [showBadge = false] - Whether to display the badge or not.

package/esm/app-bar/profile-button/app-bar-profile-button-adapter.d.ts

@@ -6,7 +6,7 @@
 import { BaseAdapter, IBaseAdapter } from '../../core/base/base-adapter';
 import { IAppBarProfileButtonComponent } from './app-bar-profile-button';
 import { IAppBarProfileCardConfig } from './app-bar-profile-button-constants';
-import { IPopoverComponent } from '../../popover';
+import { type IPopoverComponent } from '../../popover';
 export interface IAppBarProfileButtonAdapter extends IBaseAdapter {
     popupElement: IPopoverComponent | undefined;
     initialize(): void;
@@ -25,6 +25,7 @@ export interface IAppBarProfileButtonAdapter extends IBaseAdapter {
 }
 export declare class AppBarProfileButtonAdapter extends BaseAdapter<IAppBarProfileButtonComponent> implements IAppBarProfileButtonAdapter {
     private _avatarElement;
+    private _tooltipElement;
     private _iconButtonElement;
     private _popupElement?;
     private _profileCardElement?;

package/esm/app-bar/profile-button/app-bar-profile-button-adapter.js

@@ -20,6 +20,7 @@ export class AppBarProfileButtonAdapter extends BaseAdapter {
     }
     initialize() {
         this._avatarElement = getLightElement(this._component, AVATAR_CONSTANTS.elementName);
+        this._tooltipElement = getLightElement(this._component, 'forge-tooltip');
         this._iconButtonElement = getLightElement(this._component, ICON_BUTTON_CONSTANTS.elementName);
         const originalAriaLabelledBy = this._iconButtonElement.getAttribute('aria-labelledby'); // Set by tooltip
         this._forwardObserver = forwardAttributes(this._component, APP_BAR_PROFILE_BUTTON_CONSTANTS.forwardedAttributes, (name, value) => {
@@ -97,6 +98,7 @@ export class AppBarProfileButtonAdapter extends BaseAdapter {
     }
     setAvatarText(value) {
         this._avatarElement.text = value;
+        this._tooltipElement.textContent = `View ${value}'s profile`;
         removeAllChildren(this._avatarElement);
     }
     setAvatarIcon(value) {

package/esm/app-bar/profile-button/app-bar-profile-button.d.ts

@@ -29,6 +29,8 @@ declare global {
 /**
  * @tag forge-app-bar-profile-button
  *
+ * @summary A user profile button component that displays an avatar and opens a profile card popup with user information and action buttons when clicked.
+ *
  * @property {string} avatarImageUrl - The url of the avatar image to display.
  * @property {number} [avatarLetterCount=2] - The number of letters to display in the avatar.
  * @property {string} avatarText - The text to display in the avatar.

package/esm/app-bar/profile-button/app-bar-profile-button.js

@@ -18,6 +18,8 @@ const template = '<template><forge-icon-button theme=\"app-bar\"><forge-avatar a
 /**
  * @tag forge-app-bar-profile-button
  *
+ * @summary A user profile button component that displays an avatar and opens a profile card popup with user information and action buttons when clicked.
+ *
  * @property {string} avatarImageUrl - The url of the avatar image to display.
  * @property {number} [avatarLetterCount=2] - The number of letters to display in the avatar.
  * @property {string} avatarText - The text to display in the avatar.

package/esm/app-bar/search/app-bar-search.d.ts

@@ -21,6 +21,8 @@ declare global {
 /**
  * @tag forge-app-bar-search
  *
+ * @summary A search input component with integrated search icon and styling optimized for use within app bars, supporting keyboard interaction and customizable actions.
+ *
  * @slot - The default (unnamed) slot is where child `<input>` elements will be placed.
  * @slot action - Places actions at the end of the input.
  *

package/esm/app-bar/search/app-bar-search.js

@@ -17,6 +17,8 @@ const styles = ':host{display:block;color:var(--_app-bar-theme-foreground)}:host
 /**
  * @tag forge-app-bar-search
  *
+ * @summary A search input component with integrated search icon and styling optimized for use within app bars, supporting keyboard interaction and customizable actions.
+ *
  * @slot - The default (unnamed) slot is where child `<input>` elements will be placed.
  * @slot action - Places actions at the end of the input.
  *

package/esm/autocomplete/autocomplete-core.js

@@ -138,6 +138,7 @@ export class AutocompleteCore extends ListDropdownAwareCore {
         }
     }
     _onClear(evt) {
+        evt.preventDefault();
         this._filterText = '';
         this._clearValue();
         this._adapter.setSelectedText(this._getSelectedText());
@@ -352,14 +353,26 @@ export class AutocompleteCore extends ListDropdownAwareCore {
             asyncStyle: ListDropdownAsyncStyle.Skeleton,
             headerBuilder: this._popupHeaderBuilder,
             footerBuilder: this._popupFooterBuilder,
-            transform: label => {
-                if (this._filterText) {
-                    // Highlight the filter text within the label
+            transform: (label, option, isSelected) => {
+                const inputValue = this._adapter.getInputValue();
+                const isUserTyping = this._filterText &&
+                    inputValue?.length &&
+                    inputValue !== label && // User hasn't just selected this exact option
+                    this._adapter.hasFocus();
+                if (isUserTyping) {
+                    // When filtering: highlight only the matching search text
                     const highlightElement = highlightTextHTML(label, this._filterText);
                     if (highlightElement) {
                         return highlightElement;
                     }
                 }
+                else if (isSelected) {
+                    // When not filtering: bold the entire text of selected options
+                    const boldElement = document.createElement('span');
+                    boldElement.style.fontWeight = 'bold';
+                    boldElement.textContent = label;
+                    return boldElement;
+                }
                 return label;
             },
             allowBusy: true,

package/esm/autocomplete/autocomplete.d.ts

@@ -41,6 +41,8 @@ declare global {
 /**
  * @tag forge-autocomplete
  *
+ * @summary Autocomplete components provide real-time typeahead suggestions as users type in a text field. Use autocompletes to help users quickly find and select from a list of options, improving form usability and data accuracy.
+ *
  * @event {CustomEvent<any>} forge-autocomplete-change - Fired when the value changes.
  * @event {CustomEvent<IAutocompleteSelectEventData>} forge-autocomplete-select -  Fired when an option is selected. Only applies when in "stateless" `mode`.
  * @event {CustomEvent<void>} forge-autocomplete-scrolled-bottom - Fired when the dropdown is scrolled to the bottom. Only applies when `observe-scroll` is enabled.

package/esm/autocomplete/autocomplete.js

@@ -22,6 +22,8 @@ const styles = ':host{display:block}:host([hidden]){display:none}';
 /**
  * @tag forge-autocomplete
  *
+ * @summary Autocomplete components provide real-time typeahead suggestions as users type in a text field. Use autocompletes to help users quickly find and select from a list of options, improving form usability and data accuracy.
+ *
  * @event {CustomEvent<any>} forge-autocomplete-change - Fired when the value changes.
  * @event {CustomEvent<IAutocompleteSelectEventData>} forge-autocomplete-select -  Fired when an option is selected. Only applies when in "stateless" `mode`.
  * @event {CustomEvent<void>} forge-autocomplete-scrolled-bottom - Fired when the dropdown is scrolled to the bottom. Only applies when `observe-scroll` is enabled.

package/esm/avatar/avatar.d.ts

@@ -20,7 +20,7 @@ export declare const AVATAR_TAG_NAME: keyof HTMLElementTagNameMap;
 /**
  * @tag forge-avatar
  *
- * @summary Avatars represent an entity via text or image.
+ * @summary Avatars represent an entity via text or image. Use avatars to visually represent users, objects, or identifiers in your application.
  *
  * @cssproperty {string} --forge-avatar-background - The background color of the avatar.
  * @cssproperty {number} --forge-avatar-shape - The border radius of the avatar, defaults to 50%.

package/esm/avatar/avatar.js

@@ -28,7 +28,7 @@ export const AVATAR_TAG_NAME = 'forge-avatar';
 /**
  * @tag forge-avatar
  *
- * @summary Avatars represent an entity via text or image.
+ * @summary Avatars represent an entity via text or image. Use avatars to visually represent users, objects, or identifiers in your application.
  *
  * @cssproperty {string} --forge-avatar-background - The background color of the avatar.
  * @cssproperty {number} --forge-avatar-shape - The border radius of the avatar, defaults to 50%.

package/esm/backdrop/backdrop.d.ts

@@ -20,6 +20,8 @@ declare global {
 /**
  * @tag forge-backdrop
  *
+ * @summary Backdrops provide a semi-transparent overlay behind modal content like dialogs and drawers. These are building blocks for creating modal experiences, not intended to be used directly.
+ *
  * @property {boolean} [visible=false] - Whether the backdrop is visible.
  * @property {boolean} [fixed=false] - Whether the backdrop uses "fixed" or "relative" positioning.
  *

package/esm/backdrop/backdrop.js

@@ -12,6 +12,8 @@ const styles = '@keyframes enter{from{opacity:0}to{opacity:var(--_backdrop-opaci
 /**
  * @tag forge-backdrop
  *
+ * @summary Backdrops provide a semi-transparent overlay behind modal content like dialogs and drawers. These are building blocks for creating modal experiences, not intended to be used directly.
+ *
  * @property {boolean} [visible=false] - Whether the backdrop is visible.
  * @property {boolean} [fixed=false] - Whether the backdrop uses "fixed" or "relative" positioning.
  *

package/esm/badge/badge.d.ts

@@ -22,6 +22,8 @@ export declare const BADGE_TAG_NAME: keyof HTMLElementTagNameMap;
 /**
  * @tag forge-badge
  *
+ * @summary Badges display small amounts of non-interactive information like counts, status indicators, or notifications.
+ *
  * @cssproperty --forge-badge-background - The background color.
  * @cssproperty --forge-badge-color - The text color.
  * @cssproperty --forge-badge-shape - The shape radius.

package/esm/badge/badge.js

@@ -15,6 +15,8 @@ export const BADGE_TAG_NAME = 'forge-badge';
 /**
  * @tag forge-badge
  *
+ * @summary Badges display small amounts of non-interactive information like counts, status indicators, or notifications.
+ *
  * @cssproperty --forge-badge-background - The background color.
  * @cssproperty --forge-badge-color - The text color.
  * @cssproperty --forge-badge-shape - The shape radius.

package/esm/banner/banner.d.ts

@@ -25,7 +25,7 @@ declare global {
 /**
  * @tag forge-banner
  *
- * @summary Banners are used to inform users of important information, such as errors, warnings, or success messages.
+ * @summary Banners are used to inform users of important information, such as errors, warnings, or success messages. Use banners for non-critical messages that require user attention but do not interrupt workflow.
  *
  * @property {boolean} [dismissed=false] - Controls the visibility of the banner.
  * @property {boolean} [persistent=false] - Controls the visibility of the built-in dismiss button.

package/esm/banner/banner.js

@@ -18,7 +18,7 @@ const styles = ':host{display:block;container-type:inline-size}:host([hidden]){d
 /**
  * @tag forge-banner
  *
- * @summary Banners are used to inform users of important information, such as errors, warnings, or success messages.
+ * @summary Banners are used to inform users of important information, such as errors, warnings, or success messages. Use banners for non-critical messages that require user attention but do not interrupt workflow.
  *
  * @property {boolean} [dismissed=false] - Controls the visibility of the banner.
  * @property {boolean} [persistent=false] - Controls the visibility of the built-in dismiss button.

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

@@ -6,7 +6,7 @@
 import { getShadowElement } from '@tylertech/forge-core';
 import { tylIconArrowDropDown } from '@tylertech/tyler-icons';
 import { BaseAdapter } from '../../core/base/base-adapter';
-import { FOCUS_INDICATOR_CONSTANTS } from '../../focus-indicator';
+import { FOCUS_INDICATOR_TAG_NAME } from '../../focus-indicator';
 import { STATE_LAYER_CONSTANTS } from '../../state-layer';
 import { BASE_BUTTON_CONSTANTS } from './base-button-constants';
 import { BUTTON_FORM_ATTRIBUTES, cloneAttributes } from '../../core/utils/reflect-utils';
@@ -16,7 +16,7 @@ export class BaseButtonAdapter extends BaseAdapter {
     constructor(component) {
         super(component);
         this._rootElement = getShadowElement(this._component, BASE_BUTTON_CONSTANTS.selectors.ROOT);
-        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);
         this._defaultSlotElement = getShadowElement(this._component, BASE_BUTTON_CONSTANTS.selectors.DEFAULT_SLOT);
         this._endSlotElement = getShadowElement(this._component, BASE_BUTTON_CONSTANTS.selectors.END_SLOT);

package/esm/button/button.d.ts

@@ -20,12 +20,7 @@ declare global {
 /**
  * @tag forge-button
  *
- * @summary Buttons represent actions that a user can take.
- *
- * @description
- * Buttons are used when a user needs to take an action, such as submitting a form or opening a dialog.
- * Buttons can be used to trigger an action or to navigate to a new location. Buttons can be styled with
- * a variety of themes and variants.
+ * @summary Buttons are used when a user needs to take an action. They can be used to trigger an action, navigate to a new location, and can be styled with a variety of themes and variants.
  *
  * @dependency forge-icon
  * @dependency forge-focus-indicator

package/esm/button/button.js

@@ -18,12 +18,7 @@ const styles = ':host{--_button-display:var(--forge-button-display, inline-grid)
 /**
  * @tag forge-button
  *
- * @summary Buttons represent actions that a user can take.
- *
- * @description
- * Buttons are used when a user needs to take an action, such as submitting a form or opening a dialog.
- * Buttons can be used to trigger an action or to navigate to a new location. Buttons can be styled with
- * a variety of themes and variants.
+ * @summary Buttons are used when a user needs to take an action. They can be used to trigger an action, navigate to a new location, and can be styled with a variety of themes and variants.
  *
  * @dependency forge-icon
  * @dependency forge-focus-indicator

package/esm/button-area/button-area-adapter.js

@@ -5,7 +5,7 @@
  */
 import { getShadowElement } from '@tylertech/forge-core';
 import { BaseAdapter } from '../core';
-import { FOCUS_INDICATOR_CONSTANTS } from '../focus-indicator';
+import { FOCUS_INDICATOR_TAG_NAME } from '../focus-indicator';
 import { STATE_LAYER_CONSTANTS } from '../state-layer';
 import { BUTTON_AREA_CONSTANTS } from './button-area-constants';
 export class ButtonAreaAdapter extends BaseAdapter {
@@ -14,7 +14,7 @@ export class ButtonAreaAdapter extends BaseAdapter {
         this._rootElement = getShadowElement(component, BUTTON_AREA_CONSTANTS.selectors.ROOT);
         this._buttonSlotElement = getShadowElement(component, BUTTON_AREA_CONSTANTS.selectors.BUTTON_SLOT);
         this._contentSlotElement = getShadowElement(component, BUTTON_AREA_CONSTANTS.selectors.CONTENT_SLOT);
-        this._focusIndicatorElement = getShadowElement(component, FOCUS_INDICATOR_CONSTANTS.elementName);
+        this._focusIndicatorElement = getShadowElement(component, FOCUS_INDICATOR_TAG_NAME);
         this._stateLayerElement = getShadowElement(component, STATE_LAYER_CONSTANTS.elementName);
     }
     setDisabled(value) {

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

@@ -15,10 +15,7 @@ declare global {
 /**
  * @tag forge-button-area
  *
- * @summary Button areas are used to create a clickable area that group related information and actions about a single subject.
- *
- * @description
- * The button area component wraps any arbitrary content with a `<button>` element to enable accessible clickable interfaces including nested controls and other complex content.
+ * @summary Button areas are used to create clickable areas that group related information and actions about a single subject. The button area component wraps any arbitrary content with a `<button>` element to enable accessible, clickable interfaces including nested controls and other complex content.
  *
  * @property {boolean} [disabled=false] - Sets whether the button area and slotted button are disabled. Setting this on one will also set it on the other.
  *

package/esm/button-area/button-area.js

@@ -16,10 +16,7 @@ const styles = ':host{display:block;position:relative}:host .forge-button-area{c
 /**
  * @tag forge-button-area
  *
- * @summary Button areas are used to create a clickable area that group related information and actions about a single subject.
- *
- * @description
- * The button area component wraps any arbitrary content with a `<button>` element to enable accessible clickable interfaces including nested controls and other complex content.
+ * @summary Button areas are used to create clickable areas that group related information and actions about a single subject. The button area component wraps any arbitrary content with a `<button>` element to enable accessible, clickable interfaces including nested controls and other complex content.
  *
  * @property {boolean} [disabled=false] - Sets whether the button area and slotted button are disabled. Setting this on one will also set it on the other.
  *

package/esm/button-toggle/button-toggle/button-toggle-adapter.js

@@ -7,11 +7,11 @@ import { getShadowElement } from '@tylertech/forge-core';
 import { BaseAdapter } from '../../core/base/base-adapter';
 import { isFocusable, setDefaultAria } from '../../constants';
 import { STATE_LAYER_CONSTANTS } from '../../state-layer/state-layer-constants';
-import { FOCUS_INDICATOR_CONSTANTS } from '../../focus-indicator/focus-indicator-constants';
+import { FOCUS_INDICATOR_TAG_NAME } from '../../focus-indicator/focus-indicator';
 export class ButtonToggleAdapter extends BaseAdapter {
     constructor(component) {
         super(component);
-        this._focusIndicatorElement = getShadowElement(component, FOCUS_INDICATOR_CONSTANTS.elementName);
+        this._focusIndicatorElement = getShadowElement(component, FOCUS_INDICATOR_TAG_NAME);
         this._stateLayerElement = getShadowElement(component, STATE_LAYER_CONSTANTS.elementName);
     }
     initialize() {

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

@@ -27,6 +27,8 @@ declare const ButtonToggleComponent_base: import("../../constants").AbstractCons
 /**
  * @tag forge-button-toggle
  *
+ * @summary Button toggles allow users to select from a group of choices with single or multiple selection.
+ *
  * @property {unknown} value - The value of the button toggle.
  * @property {boolean} [selected=false] - Whether or not the button is selected.
  * @property {boolean} [disabled=false] - Whether or not the button is disabled.

package/esm/button-toggle/button-toggle/button-toggle.js

@@ -19,6 +19,8 @@ const styles = ':host{--_button-toggle-display:var(--forge-button-toggle-display
 /**
  * @tag forge-button-toggle
  *
+ * @summary Button toggles allow users to select from a group of choices with single or multiple selection.
+ *
  * @property {unknown} value - The value of the button toggle.
  * @property {boolean} [selected=false] - Whether or not the button is selected.
  * @property {boolean} [disabled=false] - Whether or not the button is disabled.

package/esm/button-toggle/button-toggle-group/button-toggle-group.d.ts

@@ -36,7 +36,7 @@ declare const ButtonToggleGroupComponent_base: import("../../constants").Abstrac
 /**
  * @tag forge-button-toggle-group
  *
- * @description Button toggle groups allow users to select one or more options from a set of related options.
+ * @summary Button toggle groups allow users to select one or more options from a set of button toggles.
  *
  * @property {any} value - The value of the selected button toggle(s).
  * @property {boolean} [outlined=true] - Whether or not the group should be outlined.

package/esm/button-toggle/button-toggle-group/button-toggle-group.js

@@ -21,7 +21,7 @@ const styles = ':host{--_button-toggle-group-display:var(--forge-button-toggle-g
 /**
  * @tag forge-button-toggle-group
  *
- * @description Button toggle groups allow users to select one or more options from a set of related options.
+ * @summary Button toggle groups allow users to select one or more options from a set of button toggles.
  *
  * @property {any} value - The value of the selected button toggle(s).
  * @property {boolean} [outlined=true] - Whether or not the group should be outlined.

package/esm/calendar/calendar-menu/calendar-menu.js

@@ -12,7 +12,7 @@ import { CALENDAR_MENU_CONSTANTS } from './calendar-menu-constants';
 import { CalendarMenuCore } from './calendar-menu-core';
 import { BaseComponent } from '../../core/base/base-component';
 const template = '<template><div class=\"forge-calendar-menu\" part=\"root\"></div></template>';
-const styles = '.forge-calendar-menu{background-color:var(--forge-theme-surface,#fff);position:relative;height:100%;width:100%;overflow:hidden}.forge-calendar-menu__view{position:absolute;top:0;left:0;height:100%;width:100%;background-color:inherit}.forge-calendar-menu__grid{max-height:var(--forge-calendar-menu-max-height,320px);display:grid;gap:16px;justify-items:center;align-items:center;padding:8px;box-sizing:border-box}.forge-calendar-menu__grid--three-col{grid-template-columns:repeat(3,1fr)}.forge-calendar-menu__grid--four-col{grid-template-columns:repeat(4,1fr)}.forge-calendar-menu__list{position:relative;background-color:inherit}.forge-calendar-menu__list__wrapper{position:relative;height:100%;overflow:auto}.forge-calendar-menu__list__wrapper::-webkit-scrollbar{height:var(--forge-scrollbar-height,16px);width:var(--forge-scrollbar-width,16px)}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-track{background-color:var(--forge-scrollbar-track-container,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-track:hover{background-color:var(--forge-scrollbar-track-container-hover,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-corner{background-color:var(--forge-scrollbar-track-container,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-thumb{height:var(--forge-scrollbar-thumb-min-height,32px);width:var(--forge-scrollbar-thumb-min-width,32px);border-radius:var(--forge-scrollbar-border-radius,calc(var(--forge-shape-full,9999px) * var(--forge-shape-factor,1)));border-width:var(--forge-scrollbar-border-width,3px);border-style:solid;border-color:transparent;background-color:var(--forge-scrollbar-thumb-container,var(--forge-theme-surface-container-medium,#c2c2c2));background-clip:content-box}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-thumb:hover{background-color:var(--forge-scrollbar-thumb-container-hover,var(--forge-theme-surface-container-high,#9e9e9e))}.forge-calendar-menu__item--grid{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-body1-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-body1-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-font-size-scale, .875)));font-weight:var(--forge-typography-body1-font-weight,400);line-height:var(--forge-typography-body1-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-line-height-scale, 1.125)));letter-spacing:var(--forge-typography-body1-letter-spacing, .0357142857em);text-transform:var(--forge-typography-body1-text-transform,inherit);text-decoration:var(--forge-typography-body1-text-decoration,inherit);display:flex;justify-content:center;align-items:center;position:relative;width:100%;height:100%;border-radius:4px;overflow:hidden;font-weight:500;user-select:none}.forge-calendar-menu__item--grid:not([disabled]){border:1px solid var(--forge-theme-outline,#e0e0e0);cursor:pointer}.forge-calendar-menu__item--grid[disabled]{color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar-menu__item--grid.forge-calendar-menu__item--selected{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar-menu__item--grid.forge-calendar-menu__item--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container, #d1d5ed)}.forge-calendar-menu__item--list{display:flex;align-items:center;justify-content:center;margin:0 4px;width:calc(100% - 8px);height:48px;border-radius:4px;overflow:hidden;text-align:center;cursor:pointer;position:relative}.forge-calendar-menu__item--list.forge-calendar-menu__item--selected{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar-menu__item--list.forge-calendar-menu__item--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container)}.forge-calendar-menu__item--focused,.forge-calendar-menu__item:focus{outline:0}.forge-calendar-menu--open{animation-duration:.2s;animation-name:scale-open;transform-origin:top center}.forge-calendar-menu--open[data-animation=fade]{animation-name:fade-in}.forge-calendar-menu--open[data-animation=none]{animation-duration:1ms}@media (prefers-reduced-motion){.forge-calendar-menu--open{animation-name:fade-in}}.forge-calendar-menu--closing{animation-duration:.2s;animation-name:scale-closed;transform-origin:top center}.forge-calendar-menu--closing[data-animation=fade]{animation-name:fade-out}.forge-calendar-menu--closing[data-animation=none]{animation-duration:1ms}@media (prefers-reduced-motion){.forge-calendar-menu--closing{animation-name:fade-out}}.forge-calendar-menu--slide-right .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:slide-out-to-right}@media (prefers-reduced-motion){.forge-calendar-menu--slide-right .forge-calendar-menu__view:first-child{animation-name:fade-out}}.forge-calendar-menu--slide-right .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:slide-in-from-left}@media (prefers-reduced-motion){.forge-calendar-menu--slide-right .forge-calendar-menu__view:last-child{animation-name:fade-in}}.forge-calendar-menu--slide-left .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:slide-out-to-left}@media (prefers-reduced-motion){.forge-calendar-menu--slide-left .forge-calendar-menu__view:first-child{animation-name:fade-out}}.forge-calendar-menu--slide-left .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:slide-in-from-right}@media (prefers-reduced-motion){.forge-calendar-menu--slide-left .forge-calendar-menu__view:last-child{animation-name:fade-in}}.forge-calendar-menu--replacing-view .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:fade-out}.forge-calendar-menu--replacing-view .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:fade-in}#scroll-spy-bottom{position:absolute;bottom:0;height:48px;pointer-events:none}#scroll-spy-top{position:absolute;top:0;height:48px;pointer-events:none}@keyframes scale-open{from{opacity:0;transform:scale(.4)}to{opacity:1;transform:scale(1)}}@keyframes scale-closed{from{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(.4)}}@keyframes fade-in{from{opacity:0}to{opacity:1}}@keyframes fade-out{from{opacity:1}to{opacity:0}}@keyframes slide-in-from-left{from{transform:translateX(-100%)}to{transform:translateX(0)}}@keyframes slide-in-from-right{from{transform:translateX(100%)}to{transform:translateX(0)}}@keyframes slide-out-to-left{from{transform:translateX(0)}to{transform:translateX(-100%)}}@keyframes slide-out-to-right{from{transform:translateX(0)}to{transform:translateX(100%)}}:host{display:block;position:absolute;top:0;left:0;height:100%;width:100%}:host([hidden]){display:none}:host([forge-popover-context=true]) .forge-calendar-menu{background-color:var(--forge-theme-surface-bright,#fff)}';
+const styles = '.forge-calendar-menu{background-color:var(--forge-theme-surface,#fff);position:relative;height:100%;width:100%;overflow:hidden}.forge-calendar-menu__view{position:absolute;top:0;left:0;height:100%;width:100%;background-color:inherit}.forge-calendar-menu__grid{max-height:var(--forge-calendar-menu-max-height,320px);display:grid;gap:16px;justify-items:center;align-items:center;padding:8px;box-sizing:border-box}.forge-calendar-menu__grid--three-col{grid-template-columns:repeat(3,1fr)}.forge-calendar-menu__grid--four-col{grid-template-columns:repeat(4,1fr)}.forge-calendar-menu__list{position:relative;background-color:inherit}.forge-calendar-menu__list__wrapper::-webkit-scrollbar{height:var(--forge-scrollbar-height,16px);width:var(--forge-scrollbar-width,16px)}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-track{background-color:var(--forge-scrollbar-track-container,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-track:hover{background-color:var(--forge-scrollbar-track-container-hover,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-corner{background-color:var(--forge-scrollbar-track-container,var(--forge-theme-surface-container-low,#ebebeb))}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-thumb{height:var(--forge-scrollbar-thumb-min-height,32px);width:var(--forge-scrollbar-thumb-min-width,32px);border-radius:var(--forge-scrollbar-border-radius,calc(var(--forge-shape-full,9999px) * var(--forge-shape-factor,1)));border-width:var(--forge-scrollbar-border-width,3px);border-style:solid;border-color:transparent;background-color:var(--forge-scrollbar-thumb-container,var(--forge-theme-surface-container-medium,#c2c2c2));background-clip:content-box}.forge-calendar-menu__list__wrapper::-webkit-scrollbar-thumb:hover{background-color:var(--forge-scrollbar-thumb-container-hover,var(--forge-theme-surface-container-high,#9e9e9e))}.forge-calendar-menu__list__wrapper{position:relative;height:100%;overflow:auto}.forge-calendar-menu__item--grid{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-body1-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-body1-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-font-size-scale, .875)));font-weight:var(--forge-typography-body1-font-weight,400);line-height:var(--forge-typography-body1-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-line-height-scale, 1.125)));letter-spacing:var(--forge-typography-body1-letter-spacing, .0357142857em);text-transform:var(--forge-typography-body1-text-transform,inherit);text-decoration:var(--forge-typography-body1-text-decoration,inherit);display:flex;justify-content:center;align-items:center;position:relative;width:100%;height:100%;border-radius:4px;overflow:hidden;font-weight:500;user-select:none}.forge-calendar-menu__item--grid:not([disabled]){border:1px solid var(--forge-theme-outline,#e0e0e0);cursor:pointer}.forge-calendar-menu__item--grid[disabled]{color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar-menu__item--grid.forge-calendar-menu__item--selected{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar-menu__item--grid.forge-calendar-menu__item--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container, #d1d5ed)}.forge-calendar-menu__item--list{display:flex;align-items:center;justify-content:center;margin:0 4px;width:calc(100% - 8px);height:48px;border-radius:4px;overflow:hidden;text-align:center;cursor:pointer;position:relative}.forge-calendar-menu__item--list.forge-calendar-menu__item--selected{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar-menu__item--list.forge-calendar-menu__item--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container)}.forge-calendar-menu__item--focused,.forge-calendar-menu__item:focus{outline:0}.forge-calendar-menu--open{animation-duration:.2s;animation-name:scale-open;transform-origin:top center}.forge-calendar-menu--open[data-animation=fade]{animation-name:fade-in}.forge-calendar-menu--open[data-animation=none]{animation-duration:1ms}@media (prefers-reduced-motion){.forge-calendar-menu--open{animation-name:fade-in}}.forge-calendar-menu--closing{animation-duration:.2s;animation-name:scale-closed;transform-origin:top center}.forge-calendar-menu--closing[data-animation=fade]{animation-name:fade-out}.forge-calendar-menu--closing[data-animation=none]{animation-duration:1ms}@media (prefers-reduced-motion){.forge-calendar-menu--closing{animation-name:fade-out}}.forge-calendar-menu--slide-right .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:slide-out-to-right}@media (prefers-reduced-motion){.forge-calendar-menu--slide-right .forge-calendar-menu__view:first-child{animation-name:fade-out}}.forge-calendar-menu--slide-right .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:slide-in-from-left}@media (prefers-reduced-motion){.forge-calendar-menu--slide-right .forge-calendar-menu__view:last-child{animation-name:fade-in}}.forge-calendar-menu--slide-left .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:slide-out-to-left}@media (prefers-reduced-motion){.forge-calendar-menu--slide-left .forge-calendar-menu__view:first-child{animation-name:fade-out}}.forge-calendar-menu--slide-left .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:slide-in-from-right}@media (prefers-reduced-motion){.forge-calendar-menu--slide-left .forge-calendar-menu__view:last-child{animation-name:fade-in}}.forge-calendar-menu--replacing-view .forge-calendar-menu__view:first-child{animation-duration:.2s;animation-name:fade-out}.forge-calendar-menu--replacing-view .forge-calendar-menu__view:last-child{animation-duration:.2s;animation-name:fade-in}#scroll-spy-bottom{position:absolute;bottom:0;height:48px;pointer-events:none}#scroll-spy-top{position:absolute;top:0;height:48px;pointer-events:none}@keyframes scale-open{from{opacity:0;transform:scale(.4)}to{opacity:1;transform:scale(1)}}@keyframes scale-closed{from{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(.4)}}@keyframes fade-in{from{opacity:0}to{opacity:1}}@keyframes fade-out{from{opacity:1}to{opacity:0}}@keyframes slide-in-from-left{from{transform:translateX(-100%)}to{transform:translateX(0)}}@keyframes slide-in-from-right{from{transform:translateX(100%)}to{transform:translateX(0)}}@keyframes slide-out-to-left{from{transform:translateX(0)}to{transform:translateX(-100%)}}@keyframes slide-out-to-right{from{transform:translateX(0)}to{transform:translateX(100%)}}:host{display:block;position:absolute;top:0;left:0;height:100%;width:100%}:host([hidden]){display:none}:host([forge-popover-context=true]) .forge-calendar-menu{background-color:var(--forge-theme-surface-bright,#fff)}';
 /**
  * @internal
  * @tag forge-calendar-menu

package/esm/calendar/calendar.d.ts

@@ -42,6 +42,8 @@ declare global {
     }
 }
 /**
+ * @summary A flexible calendar component for date selection with support for single dates, ranges, multiple selections, and extensive customization options.
+ *
  * @tag forge-calendar
  *
  * @property {Date} activeDate - The currently active date in the calendar.

package/esm/calendar/calendar.js

@@ -18,8 +18,10 @@ import { StateLayerComponent } from '../state-layer';
 import { FocusIndicatorComponent } from '../focus-indicator';
 import { BaseComponent } from '../core/base/base-component';
 const template = '<template><div class=\"forge-calendar\" part=\"root\"><div id=\"view\" class=\"forge-calendar__view\" part=\"view\"><div id=\"date-view\" class=\"forge-calendar__date-view\" role=\"grid\" part=\"date-view\"><div role=\"rowgroup\" part=\"date-view-container\"><div id=\"day-row\" class=\"forge-calendar__date-view__row\" role=\"row\" part=\"date-view-row\"></div></div><div id=\"date-grid\" class=\"forge-calendar__date-grid\" role=\"rowgroup\" part=\"date-grid-container\"></div></div><forge-calendar-menu id=\"menu\" part=\"calendar-menu\"></forge-calendar-menu></div></div></template>';
-const styles = '.forge-calendar{width:var(--forge-calendar-width,100%);height:fit-content;position:relative}.forge-calendar__header{padding:var(--forge-calendar-controls-padding,0);display:flex;align-items:center;justify-content:space-between}.forge-calendar__footer{padding:var(--forge-calendar-controls-padding,0);display:flex;align-items:center;justify-content:space-between}.forge-calendar__view{position:relative}.forge-calendar__date-view{display:block}.forge-calendar__date-view__row{display:grid;grid-template-columns:repeat(7,1fr)}.forge-calendar__date-grid{display:grid}.forge-calendar__day{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-label2-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-label2-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-label-font-size-scale, .8125)));font-weight:var(--forge-typography-label2-font-weight,400);line-height:var(--forge-typography-label2-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-label-line-height-scale, 1.25)));letter-spacing:var(--forge-typography-label2-letter-spacing, .0096153846em);text-transform:var(--forge-typography-label2-text-transform,inherit);text-decoration:var(--forge-typography-label2-text-decoration,inherit);display:flex;justify-content:center;align-items:center;min-width:0;padding:0;font-weight:700;user-select:none}.forge-calendar__day::after{float:left;padding-top:100%;content:\"\"}.forge-calendar__date{margin-top:var(--forge-calendar-row-gap,2px);min-width:0;padding:0;border-radius:50%;position:relative;outline:0;cursor:default;user-select:none}.forge-calendar__date::after{float:left;padding-top:100%;content:\"\"}.forge-calendar__date forge-focus-indicator{--forge-focus-indicator-shape:50%}.forge-calendar__date__inner{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-body1-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-body1-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-font-size-scale, .875)));font-weight:var(--forge-typography-body1-font-weight,400);line-height:var(--forge-typography-body1-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-line-height-scale, 1.125)));letter-spacing:var(--forge-typography-body1-letter-spacing, .0357142857em);text-transform:var(--forge-typography-body1-text-transform,inherit);text-decoration:var(--forge-typography-body1-text-decoration,inherit);position:absolute;width:calc(100% - 2px);height:calc(100% - 2px);top:calc(2px / 2);left:calc(2px / 2);display:flex;justify-content:center;align-items:center;border-radius:inherit;box-sizing:border-box}.forge-calendar--show-today .forge-calendar__date--today:not([disabled]){color:var(--forge-theme-primary,#3f51b5);border-color:var(--forge-theme-primary,#3f51b5)}.forge-calendar--show-today .forge-calendar__date--today .forge-calendar__date__inner{border-color:inherit;border-width:1px;border-style:solid;font-weight:700}.forge-calendar--show-today .forge-calendar__date--today.forge-calendar__date--selected{color:var(--forge-theme-on-primary,#fff)}.forge-calendar:not(.forge-calendar--readonly) .forge-calendar__date:not([disabled]){cursor:pointer}.forge-calendar__date--selected:not([disabled]) .forge-calendar__date__inner{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar__date--selected[disabled] .forge-calendar__date__inner{background-color:var(--forge-theme-primary-container-minimum,#f7f8fc);color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar__date--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container)}.forge-calendar__date[disabled]{color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar__date-spacer{pointer-events:none}.forge-calendar--fixed-height .forge-calendar__date-spacer{margin-top:var(--forge-calendar-row-gap,2px)}.forge-calendar--fixed-height .forge-calendar__date-spacer::after{float:left;padding-top:100%;content:\"\"}.forge-calendar__range:not(.forge-calendar__date-spacer) .forge-calendar__range__target{background-color:var(--forge-theme-primary,#3f51b5);position:absolute;width:100%;height:100%;opacity:.14;border-radius:0}.forge-calendar__range:not(.forge-calendar__date-spacer).forge-calendar__range--start .forge-calendar__range__target{border-top-left-radius:50%;border-bottom-left-radius:50%}.forge-calendar__range:not(.forge-calendar__date-spacer).forge-calendar__range--end .forge-calendar__range__target{border-top-right-radius:50%;border-bottom-right-radius:50%}.forge-calendar__range:not(.forge-calendar__range--start):first-of-type .forge-calendar__range__target{border-top-left-radius:4px;border-bottom-left-radius:4px}.forge-calendar__range:not(.forge-calendar__range--end):last-of-type .forge-calendar__range__target{border-top-right-radius:4px;border-bottom-right-radius:4px}.forge-calendar--allow-single-date-range .forge-calendar__range--start.forge-calendar__range--end .forge-calendar__range__target{transition:transform .2s;transform:scale(1.15);transform-origin:center}.forge-calendar__event{font-size:var(--forge-calendar-event-dot-size, 12px)}.forge-calendar__event[data-event-theme=primary]{color:var(--forge-calendar-theme-event-primary-accent,#3f51b5)}.forge-calendar__event[data-event-theme=secondary]{color:var(--forge-calendar-theme-event-secondary-accent,#ffc107)}.forge-calendar__event[data-event-theme=blue]{color:var(--forge-calendar-theme-event-blue-accent,#2196f3)}.forge-calendar__event[data-event-theme=light-green]{color:var(--forge-calendar-theme-event-light-green-accent,#8bc34a)}.forge-calendar__event[data-event-theme=cyan]{color:var(--forge-calendar-theme-event-cyan-accent,#00bcd4)}.forge-calendar__event[data-event-theme=teal]{color:var(--forge-calendar-theme-event-teal-accent,#009688)}.forge-calendar__event[data-event-theme=orange]{color:var(--forge-calendar-theme-event-orange-accent,#ff9800)}.forge-calendar__event[data-event-theme=blue-grey]{color:var(--forge-calendar-theme-event-blue-grey-accent,#607d8b)}.forge-calendar__event[data-event-theme=grey]{color:var(--forge-calendar-theme-event-grey-accent,#9e9e9e)}.forge-calendar__event[data-event-theme=red]{color:var(--forge-calendar-theme-event-red-accent,#f44336)}.forge-calendar__event[data-event-theme=pink]{color:var(--forge-calendar-theme-event-pink-accent,#e91e63)}.forge-calendar__event[data-event-theme=purple]{color:var(--forge-calendar-theme-event-purple-accent,#9c27b0)}.forge-calendar__event[data-event-theme=light-blue]{color:var(--forge-calendar-theme-event-light-blue-accent,#03a9f4)}.forge-calendar__event[data-event-theme=deep-purple]{color:var(--forge-calendar-theme-event-deep-purple-accent,#673ab7)}.forge-calendar__event[data-event-theme=green]{color:var(--forge-calendar-theme-event-green-accent,#4caf50)}.forge-calendar__event[data-event-theme=lime]{color:var(--forge-calendar-theme-event-lime-accent,#cddc39)}.forge-calendar__event[data-event-theme=yellow]{color:var(--forge-calendar-theme-event-yellow-accent,#ffeb3b)}.forge-calendar__event[data-event-theme=brown]{color:var(--forge-calendar-theme-event-brown-accent,#795548)}.forge-calendar__event[data-event-theme=deep-orange]{color:var(--forge-calendar-theme-event-deep-orange-accent,#ff5722)}.forge-calendar__date[disabled] .forge-calendar__event{opacity:.14}.forge-calendar__event--overflow{background-color:var(--forge-theme-surface,#fff);color:var(--forge-theme-on-surface,#000);border-radius:50%}.forge-calendar__event__wrapper{display:flex;justify-content:center;gap:2px;position:absolute;bottom:0;left:0;width:100%;padding-bottom:2px;pointer-events:none}.forge-calendar__date-spacer .forge-calendar__event__wrapper{display:none}.forge-calendar--rtl .forge-calendar__header forge-icon-button forge-icon{transform:rotate(180deg)}#accessible-header{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0}#month-button forge-icon{transition:transform .2s}.forge-calendar--month-menu-open #month-button forge-icon{transform:rotate(180deg)}#year-button forge-icon{transition:transform .2s}.forge-calendar--year-menu-open #year-button forge-icon{transform:rotate(180deg)}:host{--forge-calendar-event-stroke-color:var(--forge-theme-surface, #ffffff);display:inline-block}:host([hidden]){display:none}:host([forge-popover-context=true]){--forge-calendar-event-stroke-color:var(--forge-theme-surface-bright, #ffffff)}';
+const styles = '.forge-calendar{width:var(--forge-calendar-width,100%);height:fit-content;position:relative}.forge-calendar__header{padding:var(--forge-calendar-controls-padding,0);display:flex;align-items:center;justify-content:space-between}.forge-calendar__footer{padding:var(--forge-calendar-controls-padding,0);display:flex;align-items:center;justify-content:space-between}.forge-calendar__view{position:relative}.forge-calendar__date-view{display:block}.forge-calendar__date-view__row{display:grid;grid-template-columns:repeat(7,1fr)}.forge-calendar__date-grid{display:grid}.forge-calendar__day{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-label2-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-label2-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-label-font-size-scale, .8125)));font-weight:var(--forge-typography-label2-font-weight,400);line-height:var(--forge-typography-label2-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-label-line-height-scale, 1.25)));letter-spacing:var(--forge-typography-label2-letter-spacing, .0096153846em);text-transform:var(--forge-typography-label2-text-transform,inherit);text-decoration:var(--forge-typography-label2-text-decoration,inherit)}.forge-calendar__day::after{float:left;padding-top:100%;content:\"\"}.forge-calendar__day{display:flex;justify-content:center;align-items:center;min-width:0;padding:0;font-weight:700;user-select:none}.forge-calendar__date::after{float:left;padding-top:100%;content:\"\"}.forge-calendar__date{margin-top:var(--forge-calendar-row-gap,2px);min-width:0;padding:0;border-radius:50%;position:relative;outline:0;cursor:default;user-select:none}.forge-calendar__date forge-focus-indicator{--forge-focus-indicator-shape:50%}.forge-calendar__date__inner{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;font-family:var(--forge-typography-body1-font-family, var(--forge-typography-font-family, \"Roboto\", sans-serif));font-size:var(--forge-typography-body1-font-size, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-font-size-scale, .875)));font-weight:var(--forge-typography-body1-font-weight,400);line-height:var(--forge-typography-body1-line-height, calc(var(--forge-typography-font-size, 1rem) * var(--forge-typography-body-line-height-scale, 1.125)));letter-spacing:var(--forge-typography-body1-letter-spacing, .0357142857em);text-transform:var(--forge-typography-body1-text-transform,inherit);text-decoration:var(--forge-typography-body1-text-decoration,inherit);position:absolute;width:calc(100% - 2px);height:calc(100% - 2px);top:calc(2px / 2);left:calc(2px / 2);display:flex;justify-content:center;align-items:center;border-radius:inherit;box-sizing:border-box}.forge-calendar--show-today .forge-calendar__date--today:not([disabled]){color:var(--forge-theme-primary,#3f51b5);border-color:var(--forge-theme-primary,#3f51b5)}.forge-calendar--show-today .forge-calendar__date--today .forge-calendar__date__inner{border-color:inherit;border-width:1px;border-style:solid;font-weight:700}.forge-calendar--show-today .forge-calendar__date--today.forge-calendar__date--selected{color:var(--forge-theme-on-primary,#fff)}.forge-calendar:not(.forge-calendar--readonly) .forge-calendar__date:not([disabled]){cursor:pointer}.forge-calendar__date--selected:not([disabled]) .forge-calendar__date__inner{background-color:var(--forge-theme-primary,#3f51b5);color:var(--forge-theme-on-primary,#fff)}.forge-calendar__date--selected[disabled] .forge-calendar__date__inner{background-color:var(--forge-theme-primary-container-minimum,#f7f8fc);color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar__date--selected forge-focus-indicator{--forge-focus-indicator-color:var(--forge-theme-primary-container)}.forge-calendar__date[disabled]{color:var(--forge-theme-text-low,rgba(0,0,0,.38))}.forge-calendar__date-spacer{pointer-events:none}.forge-calendar--fixed-height .forge-calendar__date-spacer::after{float:left;padding-top:100%;content:\"\"}.forge-calendar--fixed-height .forge-calendar__date-spacer{margin-top:var(--forge-calendar-row-gap,2px)}.forge-calendar__range:not(.forge-calendar__date-spacer) .forge-calendar__range__target{background-color:var(--forge-theme-primary,#3f51b5);position:absolute;width:100%;height:100%;opacity:.14;border-radius:0}.forge-calendar__range:not(.forge-calendar__date-spacer).forge-calendar__range--start .forge-calendar__range__target{border-top-left-radius:50%;border-bottom-left-radius:50%}.forge-calendar__range:not(.forge-calendar__date-spacer).forge-calendar__range--end .forge-calendar__range__target{border-top-right-radius:50%;border-bottom-right-radius:50%}.forge-calendar__range:not(.forge-calendar__range--start):first-of-type .forge-calendar__range__target{border-top-left-radius:4px;border-bottom-left-radius:4px}.forge-calendar__range:not(.forge-calendar__range--end):last-of-type .forge-calendar__range__target{border-top-right-radius:4px;border-bottom-right-radius:4px}.forge-calendar--allow-single-date-range .forge-calendar__range--start.forge-calendar__range--end .forge-calendar__range__target{transition:transform .2s;transform:scale(1.15);transform-origin:center}.forge-calendar__event[data-event-theme=primary]{color:var(--forge-calendar-theme-event-primary-accent,#3f51b5)}.forge-calendar__event[data-event-theme=secondary]{color:var(--forge-calendar-theme-event-secondary-accent,#ffc107)}.forge-calendar__event[data-event-theme=blue]{color:var(--forge-calendar-theme-event-blue-accent,#2196f3)}.forge-calendar__event[data-event-theme=light-green]{color:var(--forge-calendar-theme-event-light-green-accent,#8bc34a)}.forge-calendar__event[data-event-theme=cyan]{color:var(--forge-calendar-theme-event-cyan-accent,#00bcd4)}.forge-calendar__event[data-event-theme=teal]{color:var(--forge-calendar-theme-event-teal-accent,#009688)}.forge-calendar__event[data-event-theme=orange]{color:var(--forge-calendar-theme-event-orange-accent,#ff9800)}.forge-calendar__event[data-event-theme=blue-grey]{color:var(--forge-calendar-theme-event-blue-grey-accent,#607d8b)}.forge-calendar__event[data-event-theme=grey]{color:var(--forge-calendar-theme-event-grey-accent,#9e9e9e)}.forge-calendar__event[data-event-theme=red]{color:var(--forge-calendar-theme-event-red-accent,#f44336)}.forge-calendar__event[data-event-theme=pink]{color:var(--forge-calendar-theme-event-pink-accent,#e91e63)}.forge-calendar__event[data-event-theme=purple]{color:var(--forge-calendar-theme-event-purple-accent,#9c27b0)}.forge-calendar__event[data-event-theme=light-blue]{color:var(--forge-calendar-theme-event-light-blue-accent,#03a9f4)}.forge-calendar__event[data-event-theme=deep-purple]{color:var(--forge-calendar-theme-event-deep-purple-accent,#673ab7)}.forge-calendar__event[data-event-theme=green]{color:var(--forge-calendar-theme-event-green-accent,#4caf50)}.forge-calendar__event[data-event-theme=lime]{color:var(--forge-calendar-theme-event-lime-accent,#cddc39)}.forge-calendar__event[data-event-theme=yellow]{color:var(--forge-calendar-theme-event-yellow-accent,#ffeb3b)}.forge-calendar__event[data-event-theme=brown]{color:var(--forge-calendar-theme-event-brown-accent,#795548)}.forge-calendar__event[data-event-theme=deep-orange]{color:var(--forge-calendar-theme-event-deep-orange-accent,#ff5722)}.forge-calendar__event{font-size:var(--forge-calendar-event-dot-size, 12px)}.forge-calendar__date[disabled] .forge-calendar__event{opacity:.14}.forge-calendar__event--overflow{background-color:var(--forge-theme-surface,#fff);color:var(--forge-theme-on-surface,#000);border-radius:50%}.forge-calendar__event__wrapper{display:flex;justify-content:center;gap:2px;position:absolute;bottom:0;left:0;width:100%;padding-bottom:2px;pointer-events:none}.forge-calendar__date-spacer .forge-calendar__event__wrapper{display:none}.forge-calendar--rtl .forge-calendar__header forge-icon-button forge-icon{transform:rotate(180deg)}#accessible-header{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0}#month-button forge-icon{transition:transform .2s}.forge-calendar--month-menu-open #month-button forge-icon{transform:rotate(180deg)}#year-button forge-icon{transition:transform .2s}.forge-calendar--year-menu-open #year-button forge-icon{transform:rotate(180deg)}:host{--forge-calendar-event-stroke-color:var(--forge-theme-surface, #ffffff);display:inline-block}:host([hidden]){display:none}:host([forge-popover-context=true]){--forge-calendar-event-stroke-color:var(--forge-theme-surface-bright, #ffffff)}';
 /**
+ * @summary A flexible calendar component for date selection with support for single dates, ranges, multiple selections, and extensive customization options.
+ *
  * @tag forge-calendar
  *
  * @property {Date} activeDate - The currently active date in the calendar.

package/esm/card/card.d.ts

@@ -18,6 +18,8 @@ export declare const CARD_TAG_NAME: keyof HTMLElementTagNameMap;
 /**
  * @tag forge-card
  *
+ * @summary Cards group related content and actions together in a single container.
+ *
  * @attribute {boolean} [no-padding=false] - Removes the default padding from the card.
  *
  * @cssproperty --forge-card-background - The background color of the card.