q2-tecton-elements 1.71.4 → 1.73.0

package/dist/types/components/q2-date-picker/q2-date-picker.d.ts

@@ -0,0 +1,304 @@
+import { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
+import type { ActionSheetDatePickerData } from 'q2-tecton-common/lib/types/action-sheet';
+import type { DatePickerChangeDetail, DatePickerCloseDetail, DatePickerDisplayFormat, DatePickerErrorDetail, DatePickerMode, DatePickerMomentLike, DatePickerSuccessDetail, DatePickerValue } from "../../utils/date-picker/date-picker-types";
+type DatePickerStandaloneElement = HTMLElement & {
+    focusDate: (value: string | Date) => Promise<void>;
+    setValue: (value: string | Date) => Promise<void>;
+};
+/**
+ * @name Date Picker
+ * @category Forms
+ * @summary Use for selecting a date or date range with an input and calendar popup.
+ * @slot label - Custom content for the input label.
+ */
+export declare class Q2DatePicker implements ComponentInterface {
+    calendarElement: DatePickerStandaloneElement;
+    closeTimeout: ReturnType<typeof setTimeout>;
+    committingValue: boolean;
+    controlElement: HTMLQ2InputElement;
+    normalizedDateLists: WeakMap<string[], string[]>;
+    popoverElement: HTMLQ2PopoverElement;
+    hostElement: HTMLElement;
+    activePopoverDirection: 'up' | 'down';
+    calendarError: string;
+    typeableError: string;
+    typeableValue: string;
+    /**
+     * Renders the calendar panel inline with behavior specific to being hosted by `q2-action-sheet`.
+     * @private
+     */
+    _actionSheet: boolean;
+    /**
+     * Determines the year for a committed month/day typeable date with no year.
+     * `future` selects the next year for dates before today, while `past` selects the prior year for dates after today.
+     * Only applies to `single-typeable` mode with a month-first or day-first display format.
+     */
+    assume: 'current' | 'future' | 'past';
+    /** A label shown above the date picker navigation. */
+    calendarLabel: string;
+    /** Displays a button in the input field allowing the user to clear the selected date or range. */
+    clearable: boolean;
+    /** Delay in milliseconds before the popover closes after selection. Explicitly undefined or non-positive values close immediately. */
+    closeDelay: number | undefined;
+    /**
+     * Specifies a time of day after which a date is no longer valid.
+     *
+     * @warning
+     * Must be a valid ISO date string.
+     */
+    cutoffTime: string;
+    /**
+     * Defines valid days of the week using the calendar checksum values.
+     *
+     * Sunday begins at `1` and each following day doubles through Saturday at `64`.
+     */
+    daysOfWeekChecksum: number;
+    /** Indicates the date picker cannot be focused or interacted with. */
+    disabled: boolean;
+    /** Text displayed as the input placeholder when the field is disabled. */
+    disabledMsg: string;
+    /** Text shown below the date grid. */
+    disclaimer: string;
+    /**
+     * Formats the displayed date using legacy Moment-style tokens. Typeable modes support the numeric formats defined
+     * by `DatePickerDisplayFormat` and fall back to `MM/DD/YYYY` for other formats.
+     */
+    displayFormat?: string;
+    /**
+     * Defines the last selectable date. ISO date strings are preferred; legacy date strings and
+     * timestamps are normalized to their calendar date, without shifting timestamp time zones.
+     */
+    endDate: string;
+    /** Consumer-provided error messages displayed below the input field. */
+    errors: string[];
+    /**
+     * Hides the input field's visible label while retaining its accessible name.
+     * @warning
+     * Hides the label visually. `label` text is still required for screenreader compliance.
+     */
+    hideLabel: boolean;
+    /** Consumer-provided hint messages displayed below the input field. */
+    hints: string[];
+    /**
+     * Instructs the component to use the action sheet workflow for displaying its calendar.
+     *
+     * For more information, see [Action Sheets](https://tecton.q2developer.com/guides/action-sheets/).
+     */
+    hoist: boolean | undefined;
+    /** Shows the input field's error visual state. */
+    invalid: boolean;
+    /**
+     * Defines an explicit date blacklist. ISO dates, legacy date strings, and timestamps are normalized to calendar dates.
+     *
+     * Assign a new array when changing this property. Mutating the existing array does not trigger validation updates.
+     */
+    invalidDates: string[];
+    /**
+     * The visible label for the date picker input field.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
+     */
+    label: string;
+    /** Formats selected dates using the provided locale. Accepts multiple locales in an array as sequential fallbacks. */
+    locale: string | string[];
+    /**
+     * Selects calendar or typeable behavior for a single date or date range.
+     * Enabling the legacy `typeable` prop uses `single-typeable` when `mode` is left at its default; an explicit mode takes precedence.
+     */
+    mode: DatePickerMode;
+    /** Controls whether the date picker popover is open or closed. */
+    open: boolean;
+    /** Appends "(optional)" to the input label and marks the field as not required. */
+    optional: boolean;
+    /** Text shown in the input field when no date is selected. */
+    placeholder: string;
+    /**
+     * Forces the direction of the popover when it opens.
+     * @deprecated Use `popoverDirection` instead.
+     */
+    popDirection: 'up' | 'down';
+    /** Aligns the calendar popover to the left or right side of the input field. */
+    popoverAlignment: 'left' | 'right';
+    /**
+     * Forces the direction of the popover when it opens.
+     *
+     * If no value is passed, the popover automatically selects a direction based on available space.
+     * Use `up` to place navigation below the date grid.
+     */
+    popoverDirection: 'up' | 'down';
+    /** @deprecated Retained for compatibility with `q2-date-picker`. */
+    popoverMinHeight: number;
+    /**
+     * Uses absolute positioning for the popover when set to `legacy`.
+     *
+     * This compatibility option supports layouts where transformed ancestors interfere with fixed positioning.
+     */
+    popoverMode: 'legacy';
+    /** The selected range end. ISO dates, legacy date strings, and timestamps are accepted. */
+    rangeEnd: string;
+    /** The selected range start. ISO dates, legacy date strings, and timestamps are accepted. */
+    rangeStart: string;
+    /**
+     * The field's content is not editable, but the field remains focusable.
+     *
+     * Appends "(read only)" to the field label.
+     */
+    readonly: boolean;
+    /**
+     * Defines the first selectable date. ISO date strings are preferred; legacy date strings and
+     * timestamps are normalized to their calendar date, without shifting timestamp time zones.
+     */
+    startDate: string;
+    /** Enables the legacy single-date typeable input behavior. */
+    typeable: boolean;
+    /** Shows the input field's success visual state when no errors are active. */
+    valid: boolean;
+    /**
+     * Defines an explicit date whitelist. ISO dates, legacy date strings, and timestamps are normalized to calendar dates.
+     *
+     * Assign a new array when changing this property. Mutating the existing array does not trigger validation updates.
+     */
+    validDates: string[];
+    /**
+     * The selected date. ISO date strings are preferred; legacy date strings and Moment-like values are normalized to
+     * an ISO date string.
+     */
+    value: DatePickerValue;
+    /**
+     * Emitted when a date is selected.
+     * @legacyEvent
+     * @deprecated Use `tctChange` instead.
+     */
+    change: EventEmitter<DatePickerChangeDetail>;
+    /**
+     * Emitted when an invalid single date is entered or assigned.
+     * @deprecated Use `tctError` instead.
+     */
+    error: EventEmitter<DatePickerErrorDetail>;
+    /**
+     * Emitted when a valid single date is entered, selected, or assigned.
+     * @deprecated Use `tctSuccess` instead.
+     */
+    success: EventEmitter<DatePickerSuccessDetail>;
+    /** Emitted when an action-sheet date range is cancelled. */
+    tctCancel: EventEmitter<void>;
+    /** Emitted when a date is selected. */
+    tctChange: EventEmitter<DatePickerChangeDetail>;
+    /** Emitted when the picker closes after confirmation. Includes validation details when confirmation fails. */
+    tctClose: EventEmitter<DatePickerCloseDetail | void>;
+    /** Emitted when an invalid single date is entered or assigned. */
+    tctError: EventEmitter<DatePickerErrorDetail>;
+    /** Emitted when a valid single date is entered, selected, or assigned. */
+    tctSuccess: EventEmitter<DatePickerSuccessDetail>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    beforeInputHandler(event: InputEvent): void;
+    delegateFocus(event: FocusEvent): void;
+    popoverStateHandler({ detail: { open } }: CustomEvent<{
+        open: boolean;
+    }>): void;
+    /** Closes the calendar popover if it is open. */
+    closePopover(): Promise<void>;
+    /** Moves the visible month to the provided date and focuses that day. */
+    focusDate(date: Date): Promise<void>;
+    /** Opens the calendar popover if it is closed. */
+    openPopover(): Promise<void>;
+    /** Clears selected values, uncommitted typeable input, and error state without changing configuration props. */
+    reset(): Promise<void>;
+    /** Opens the calendar and selects the provided date when it is valid. */
+    setValue(value: string | Date | DatePickerMomentLike): Promise<void>;
+    /**
+     * Focuses the single typeable input and stages a valid date without committing it.
+     *
+     * @warning
+     * Only applicable when the effective mode is `single-typeable`.
+     */
+    typeValue(value: string | Date): Promise<void>;
+    constraintsChanged(): void;
+    disabledChanged(disabled: boolean): void;
+    displayFormatChanged(): void;
+    modeChanged(): void;
+    openChanged(open: boolean): void;
+    popDirectionChanged(): void;
+    popoverDirectionChanged(): void;
+    rangeEndChanged(): void;
+    rangeStartChanged(): void;
+    readonlyChanged(readonly: boolean): void;
+    valueChanged(value: DatePickerValue): void;
+    get acceptsTypeableInput(): boolean;
+    get actionSheetData(): ActionSheetDatePickerData;
+    get automaticPopoverDirection(): 'up' | 'down';
+    get canClear(): boolean;
+    get computedErrors(): string[] | undefined;
+    get computedPlaceholder(): string;
+    get dateFormatValidationError(): string;
+    get effectiveMode(): DatePickerMode;
+    get effectivePopoverDirection(): 'up' | 'down' | undefined;
+    get formattedTypeableValue(): string;
+    get formattedValue(): string;
+    get isRangeMode(): boolean;
+    get isRangeTypeable(): boolean;
+    get isSingleTypeable(): boolean;
+    get normalizedDisplayFormat(): DatePickerDisplayFormat;
+    get normalizedInvalidDates(): string[] | undefined;
+    get normalizedValidDates(): string[] | undefined;
+    get normalizedValue(): string | undefined;
+    get rangeEndDate(): Date | undefined;
+    get rangeFormatValidationError(): string;
+    get rangeOrderValidationError(): string;
+    get rangeTypeableFormat(): string;
+    get rangeValidationError(): string;
+    get selectedDate(): Date | undefined;
+    get typeableAllowedCharacters(): RegExp;
+    closeAfterSelection(): void;
+    closeCalendar(returnFocus?: boolean, emitClose?: boolean): void;
+    commitSingleValue(value: string): void;
+    emitValidationError(message: string): void;
+    emitValidationSuccess(value: string): void;
+    focusRenderedDate(value?: string): void;
+    formatDateWithModifier(date: Date): string;
+    formatLongDate(date: Date): string;
+    formatTypeableDate(value: string): string;
+    isDateValid(date: Date): boolean;
+    isRangeValid(start: Date, end: Date): boolean;
+    isTypeableDatePrefixInvalid(digits: string): boolean;
+    localizeForLocale(value: string, substitutions?: Record<string, string>): string;
+    normalizeDateList(values?: string[]): string[] | undefined;
+    onCalendarCancel: (event: CustomEvent<void>) => void;
+    onCalendarCommit: (event: CustomEvent<DatePickerChangeDetail | void>) => void;
+    onCalendarDismiss: (event: CustomEvent<void>) => void;
+    onCalendarError: (event: CustomEvent<string>) => void;
+    onCalendarToggleClick: (event: MouseEvent) => void;
+    onClear: () => void;
+    onClickElsewhere: (event: CustomEvent) => void;
+    onInputClick: () => void;
+    onInputKeydown: (event: KeyboardEvent) => void;
+    onTypeableChange: (event: CustomEvent<{
+        value: string;
+    }>) => void;
+    onTypeableInput: (event: CustomEvent<{
+        value: string;
+    }>) => void;
+    parseTypeableDate(value: string): Date | undefined;
+    /**
+     * Recomputes the typeable error from the current `typeableValue`, applying the same range checks the commit path
+     * uses so a stale error cannot outlive the text that produced it.
+     */
+    revalidateTypeableValue(): void;
+    scrollDownCalendarToTop(): Promise<void>;
+    scrollUpCalendarToBottom(): Promise<void>;
+    setActivePopoverDirection(): void;
+    setTypeableError(error: string): void;
+    showActionSheet(): Promise<void>;
+    syncTypeableValue(): void;
+    toggleCalendar(): void;
+    typeableRangeError(start: Date, end: Date): string;
+    validateCurrentValue(value?: DatePickerValue): void;
+    validateTypeableValue(): void;
+    renderCalendar(): any;
+    render(): any;
+}
+export {};

package/dist/types/components/q2-date-picker/test/q2-date-picker-test.vr.d.ts

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

package/dist/types/components/q2-dropdown/q2-dropdown.d.ts

@@ -41,9 +41,9 @@ export declare class Q2Dropdown implements ComponentInterface {
     /** If `true`, it takes up 100% width. */
     fullWidth: boolean;
     /**
-     * Hide's the field's `<label>` element from view.
+     * Hides the dropdown's label text from view.
      * @warning
-     * Only use when a visible label is impractical.
+     * Hides the label visually. `label` text is still required for screenreader compliance.
      */
     hideLabel: boolean;
     /**
@@ -57,7 +57,7 @@ export declare class Q2Dropdown implements ComponentInterface {
     /**
      * The text that appears within the button.
      * @warning
-     * This property should not be used if the `type` is `icon`.
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;

package/dist/types/components/q2-dropdown/test/q2-dropdown-test.vr.d.ts

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

package/dist/types/components/q2-editable-field/q2-editable-field.d.ts

@@ -39,7 +39,11 @@ export declare class Q2EditableField {
      * See [q2-input](https://tecton.q2developer.com/design-system/q2-input/) for more information.
      */
     formatModifier: string;
-    /** Hide's the field's `<label>` element from view. */
+    /**
+     * Hides the field's `<label>` element from view.
+     * @warning
+     * Hides the label visually. `label` text is still required for screenreader compliance.
+     */
     hideLabel: boolean;
     /**
      * Determines the `hints` applied to the `q2-input` element.
@@ -50,6 +54,8 @@ export declare class Q2EditableField {
     /**
      * The visible descriptor for the element.
      * Serves as the input label while in the edit state and as a decorative label for the read state when `persistentLabel` is `true`.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;
@@ -75,6 +81,8 @@ export declare class Q2EditableField {
      * Emitted when the 'Edit', 'Cancel', or 'Save' buttons are clicked.
      *
      * The event detail will not include a `value` or `formattedValue` if the event name is 'edit' or 'cancel'.
+     *
+     * Call `event.preventDefault()` to prevent the default behavior (the component's internal `editing` and `value` updates).
      *@info
      * If you are utilizing events to provide input validation, it is recommended you use the `input` event, not the `change` event.
      * @deprecated Use 'tctChange' instead
@@ -98,6 +106,8 @@ export declare class Q2EditableField {
      *
      * The event detail will not include a `value` or `formattedValue` if the event name is 'edit' or 'cancel'.
      *
+     * Call `event.preventDefault()` to prevent the default behavior (the component's internal `editing` and `value` updates).
+     *
      * @info
      * If you are utilizing events to provide input validation, it is recommended you use the `input` event, not the `change` event.
      */
@@ -117,7 +127,6 @@ export declare class Q2EditableField {
     componentWillLoad(): void;
     componentDidLoad(): void;
     componentDidRender(): void;
-    onHostElementChange(event: CustomEvent): void;
     delegateFocus(event: FocusEvent): void;
     inputFormatted(event: CustomEvent<FormatterValueObject>): void;
     /**
@@ -158,13 +167,22 @@ export declare class Q2EditableField {
     get locLabel(): string;
     get wrapperClass(): string;
     cancelClick: (event?: CustomEvent) => void;
+    /**
+     * Drops the in-progress draft and re-syncs the input and the read state display from `value`.
+     *
+     * Runs whenever the field leaves the edit state, including when a consumer drives `editing` itself, so the
+     * read state never renders a discarded draft.
+     */
+    discardDraft(): void;
     editClick: (event: CustomEvent) => void;
+    private emitChangeEvents;
     generateEditStateDOM(): any;
     generateReadStateDOM(): any;
     inputChange: (e: CustomEvent) => void;
     inputClick: (event: MouseEvent) => void;
     inputInput: (event: Q2InputCustomEvent<EventDetail> & InputEvent) => void;
     inputKeyDown: (e: KeyboardEvent) => void;
+    private isDefaultPrevented;
     saveClick: (event?: CustomEvent) => void;
     render(): any;
 }

package/dist/types/components/q2-file-picker/q2-file-picker.d.ts

@@ -20,6 +20,9 @@ export declare class Q2FilePicker implements ComponentInterface {
     browseButtonInput: HTMLElement;
     dropZone: HTMLElement;
     fileItemsToBeDeleted: any;
+    fileList: HTMLElement;
+    fileListContainer: HTMLElement;
+    fileListResizeObserver: ResizeObserver;
     queuedFiles: File[];
     el: HTMLElement;
     areFilesUploading: boolean;
@@ -39,6 +42,12 @@ export declare class Q2FilePicker implements ComponentInterface {
      * Disables the file picker, preventing user interaction.
      */
     disabled: boolean;
+    /**
+     * When `false`, the file name renders as-is and may wrap. Otherwise, long
+     * file names are middle-ellipsized so the beginning and end of the name
+     * remain visible.
+     */
+    ellipsizeFileName: boolean;
     /**
      * Allowed file types based on extensions (e.g., ['jpg', 'png', 'pdf'] or
      * 'jpg, png, pdf'). When using the attribute, provide a comma-separated
@@ -59,6 +68,10 @@ export declare class Q2FilePicker implements ComponentInterface {
      * The maximum size (in bytes) of any file that can be selected.
      */
     maxFileSize: number;
+    /**
+     * Shows a gradient at the bottom of the file list when more files are available below the visible area.
+     */
+    showGradient: boolean;
     /**
      * An array of `ValidFileStatus` objects representing the upload status of
      * files. Each `ValidFileStatus` object contains the following properties:
@@ -109,6 +122,10 @@ export declare class Q2FilePicker implements ComponentInterface {
      *   `"over-max-files-limit"` (total exceeds the max files limit).
      */
     tctChange: EventEmitter<FilesObject>;
+    disconnectedCallback(): void;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    updateGradientVisibility(): void;
     updateFileList(newValue: ValidFileStatus[]): void;
     get actualButtonSize(): "small" | "medium" | "large";
     get dropZoneClasses(): string;
@@ -117,6 +134,7 @@ export declare class Q2FilePicker implements ComponentInterface {
     get hasDescriptionSlotContent(): boolean;
     get hasLabel(): boolean;
     get hasLabelSlotContent(): boolean;
+    get isMobileViewport(): boolean;
     buildFilesObject(filesToUpload: File[]): FilesObject;
     dimDropZone: (e: DragEvent) => void;
     disableEvent(event: Event): void;
@@ -135,6 +153,8 @@ export declare class Q2FilePicker implements ComponentInterface {
     grabSelectedFiles: (e: Event) => void;
     highlightDropZone: (e: DragEvent) => void;
     launchFileBrowser(): void;
+    observeFileListContent(): void;
+    updateFileListGradient: () => void;
     render: () => any;
 }
 export {};

package/dist/types/components/q2-input/q2-input.d.ts

@@ -47,11 +47,17 @@ export declare class Q2Input {
     scheduledAfterRender: (() => void)[];
     textSelectedForDeletion: boolean;
     valueOnFocus: string;
+    visibleLastContentRef: HTMLSpanElement;
     hostElement: HTMLElement;
     checkSlotCount: number;
     formattedValueObject: FormatterValueObject;
     hasFocus: boolean;
     isSmall: boolean;
+    /**
+     * Provides additional descriptive text for the native input.
+     * @private
+     */
+    _ariaDescription: string;
     /**
      * Sets readonly to true on the input without adding the "read only" label.
      *
@@ -129,9 +135,9 @@ export declare class Q2Input {
      */
     formatModifier: string;
     /**
-     * Hide's the field's `<label>` element from view.
+     * Hides the field's `<label>` element from view.
      * @warning
-     * Only use when a visible label is impractical.
+     * Hides the label visually. `label` text is still required for screenreader compliance.
      */
     hideLabel: boolean;
     /**
@@ -153,6 +159,8 @@ export declare class Q2Input {
     iconRight: Q2Icon['type'];
     /**
      * The label that appears above the field. This is announced by screen readers when the field is focused.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;
@@ -215,7 +223,7 @@ export declare class Q2Input {
     /**
      * Displays a toggle button at the end of the input field which shows or hides the actual value.
      * @info
-     * Only applicable when `type` is `text`, `password`, or `ssn`.
+     * Applicable when `type` is `text`, `password`, `ssn`, or `tin`, or when `visibleLastCount` is set.
      */
     showVisibilityToggle: boolean;
     /**
@@ -225,7 +233,8 @@ export declare class Q2Input {
      */
     step: number;
     /**
-     * Controls visibility of the value when the type is `text`, `password`, or `ssn`.
+     * Controls visibility of the value. When `visibleLastCount` is set, hidden values keep the specified number of
+     * trailing characters visible.
      * When the input type is `password`, it will default to `true`, hiding the text.
      */
     textHidden: boolean;
@@ -251,6 +260,11 @@ export declare class Q2Input {
      *
      */
     value: string;
+    /**
+     * Controls the number of trailing characters that remain visible when the field value is masked by `textHidden`
+     * or the visibility toggle. The element's `value` and emitted event details remain unmasked.
+     */
+    visibleLastCount: number;
     /**
      * Emitted when the field loses focus after the value has been changed.
      * @deprecated Use 'tctChange' instead
@@ -342,6 +356,7 @@ export declare class Q2Input {
     formatModifierObserver(): void;
     formattedValueObjectObserver(): void;
     hintsObserver(): void;
+    textHiddenObserver(): void;
     typeObserver(): void;
     valueObserver(): void;
     get ariaAttributes(): {
@@ -357,6 +372,9 @@ export declare class Q2Input {
     get computedClassForIconLeft(): string | undefined;
     get computedIconLeft(): string | undefined;
     get computedType(): string;
+    get currencyCode(): string | undefined;
+    get currencyDescription(): string | undefined;
+    get currencyDescriptionId(): string;
     get hasCustomDisplaySlot(): boolean;
     get hasError(): boolean;
     get hasInputLeftSlot(): boolean;
@@ -367,11 +385,18 @@ export declare class Q2Input {
     get inputId(): string;
     get inputMode(): any;
     get isMaskedType(): boolean;
+    get maskedDisplayParts(): {
+        maskedCharacters: string[];
+        visibleValue: string;
+    };
+    get maskedDisplayValue(): string;
     get messages(): string[];
+    get normalizedVisibleLastCount(): number | undefined;
     get shouldCursorStartAtEnd(): boolean;
     get shouldCursorStayAtEnd(): boolean;
     get showIconSeparator(): boolean;
     get showMessages(): boolean;
+    get showVisibilityToggleButton(): boolean;
     get stringValue(): string;
     get visibilityToggleAriaLabel(): string;
     get visibilityToggleText(): string;
@@ -397,11 +422,14 @@ export declare class Q2Input {
     onInputKeydown: (event: KeyboardEvent) => void;
     onInputMousedown: () => void;
     onInputPaste: (event: ClipboardEvent) => void;
+    onInputScroll: () => void;
     onMutationObserved: () => void;
     onRefocusInput: () => void;
     onToggleVisibility: () => void;
     placeCursorAtEnd(): void;
+    scheduleVisibleLastScrollSync(): void;
     setCursorPosition(cursorData: CursorData): void;
+    syncVisibleLastScroll: () => void;
     validateInput: () => boolean;
     renderCountDOM(): any;
     renderInputContainerDOM(): any;

package/dist/types/components/q2-item/q2-item.d.ts

@@ -40,5 +40,8 @@ export declare class Q2Item {
     get itemClasses(): string;
     get mainClasses(): string;
     get shouldAlignSingleContentSlot(): boolean;
+    handleKeydown: (event: KeyboardEvent) => void;
+    handleKeyup: (event: KeyboardEvent) => void;
+    isSpaceKey(event: KeyboardEvent): boolean;
     render(): any;
 }

package/dist/types/components/q2-modal/q2-modal.d.ts

@@ -17,7 +17,7 @@ export declare class Q2Modal implements ComponentInterface {
     maxActionButtons: number;
     renderStatus: 'is-open' | 'is-closing' | 'is-opening';
     /**
-     * Controls visibility of the close button in the top right corner.
+     * Controls visibility of the close button and whether the modal can be dismissed with the backdrop or Escape key.
      */
     closable: boolean;
     /**
@@ -28,6 +28,10 @@ export declare class Q2Modal implements ComponentInterface {
      * A plain text description of the modal. Use this to provide context or information to the user.
      */
     description: string;
+    /**
+     * Whether the action buttons should take up the full width of the modal footer.
+     */
+    fullWidthButton: boolean;
     /**
      * The icon to display at the top of the modal. [See Icon documentation](https://tecton.q2developer.com/design-system/q2-icon).
      */
@@ -40,6 +44,10 @@ export declare class Q2Modal implements ComponentInterface {
      * A plain text title of the modal displayed at the top.
      */
     title: string;
+    /**
+     * Emitted when the modal backdrop is clicked.
+     */
+    tctBackdropClick: EventEmitter<undefined>;
     /**
      * Emitted when one of action buttons is clicked.
      */
@@ -62,6 +70,7 @@ export declare class Q2Modal implements ComponentInterface {
     componentDidRender(): void;
     closeModal(data?: ModalResponse): Promise<void>;
     openModal(option?: ModalOption): Promise<void>;
+    hasDialogTransition: () => boolean;
     initializeModal: () => void;
     onCancel: (event: Event) => void;
     onClick: (event: MouseEvent) => void;

package/dist/types/components/q2-option-list/q2-option-list.d.ts

@@ -96,6 +96,7 @@ export declare class Q2OptionList implements ComponentInterface {
     checkOptions(): void;
     clickHandler: (event: Event) => void;
     externalKeydownHandler: (event: KeyboardEvent) => void;
+    findScrollableAncestor(node: Node): HTMLElement | null;
     focusoutHandler: (event: FocusEvent) => void;
     focusSelectedSibling(option: ValidOptionElements): void;
     getDefaultActiveIndex(): number;

package/dist/types/components/q2-popover/q2-popover.d.ts

@@ -40,6 +40,7 @@ export declare class Q2Popover implements ComponentInterface {
     displayBuffer: number;
     orientationChanged: boolean;
     pendingAnimationResolve: (() => void) | null;
+    platformScrollUnsubscribe: (() => void) | null;
     hostElement: HTMLElement;
     animationState: 'idle' | 'opening' | 'closing';
     currentDirection: 'down' | 'up';
@@ -95,7 +96,10 @@ export declare class Q2Popover implements ComponentInterface {
     addViewportListeners(): void;
     clearCSSProperties(): void;
     determinePopDirection(): Promise<void>;
+    handleInsideScroll: (event: WheelEvent | TouchEvent) => void;
     handleMinHeight: () => void;
+    handleOutsideScroll: (event: Event) => void;
+    handlePlatformScroll: () => void;
     handlePopoverToggleEvent: (event: ToggleEvent) => void;
     removeViewportListeners(): void;
     setAbsoluteCSSProperties: () => Promise<void>;

package/dist/types/components/q2-radio/q2-radio.d.ts

@@ -32,13 +32,14 @@ export declare class Q2Radio implements ComponentInterface {
     groupTileLayout: boolean;
     /**
      * Hides the field's `<label>` element from view.
-     *
      * @warning
-     * Only use when a visible label is impractical.
+     * Hides the label visually. `label` text is still required for screenreader compliance.
      */
     hideLabel: boolean;
     /**
      * The text that describes the individual radio option.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;