q2-tecton-elements 1.72.0 → 1.73.1

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

@@ -0,0 +1,122 @@
+import { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
+import type { DatePickerChangeDetail, DatePickerDay, DatePickerDisplayFormat, DatePickerMode, DatePickerNavigationAction, DatePickerSelectedMonthYear } from "../../utils/date-picker/date-picker-types";
+/**
+ * @name Date Calendar
+ * @category Forms
+ * @summary Use for selecting dates from a standalone calendar.
+ */
+export declare class Q2DateCalendar implements ComponentInterface {
+    dayAbbrStrings: string[];
+    dayStrings: string[];
+    hostElement: HTMLElement;
+    activeDate: Date;
+    rangeDraftEnd: Date;
+    rangeDraftStart: Date;
+    rangeError: string;
+    rangeHoverDate: Date;
+    selectedMonthYear: DatePickerSelectedMonthYear;
+    /** Accessible calendar dialog label. */
+    accessibleLabel: string;
+    /** Uses the action-sheet calendar presentation. */
+    actionSheet: boolean;
+    /** Accessible and visible calendar label. */
+    calendarLabel: string;
+    /** Specifies a time of day after which a date is no longer valid. */
+    cutoffTime: string;
+    /** Defines valid days of the week using calendar checksum values. */
+    daysOfWeekChecksum: number;
+    /** Controls whether navigation appears above or below the date grid. */
+    direction: 'up' | 'down';
+    /** Disables calendar interaction. */
+    disabled: boolean;
+    /** Localized disclaimer content. */
+    disclaimer: string;
+    /** Controls the date format used in range summaries. */
+    displayFormat?: DatePickerDisplayFormat;
+    /** Defines the last selectable date. */
+    endDate: string;
+    /** Defines an explicit date blacklist using ISO date strings. */
+    invalidDates: string[];
+    /** Formats calendar and range labels using the provided locale. */
+    locale: string | string[];
+    /** Selects single-date or range calendar behavior. */
+    mode: DatePickerMode;
+    /** Indicates that a new calendar session has opened. */
+    open: boolean;
+    /** The committed range end as an ISO date string. */
+    rangeEnd: string;
+    /** The committed range start as an ISO date string. */
+    rangeStart: string;
+    /** Prevents calendar selection while retaining calendar visibility. */
+    readonly: boolean;
+    /** Defines the first selectable date. */
+    startDate: string;
+    /** Defines an explicit date whitelist using ISO date strings. */
+    validDates: string[];
+    /** The committed single date as an ISO date string. */
+    value: string;
+    /** Emitted when the user cancels range selection. */
+    tctCalendarCancel: EventEmitter<void>;
+    /** Emitted when the user commits a single date or date range. */
+    tctCalendarCommit: EventEmitter<DatePickerChangeDetail>;
+    /** Emitted when the calendar asks its container to dismiss it. */
+    tctCalendarDismiss: EventEmitter<void>;
+    /** Emitted when range confirmation validation changes. */
+    tctCalendarError: EventEmitter<string>;
+    /** Emitted with the committed date or range for standalone consumers and framework models. */
+    tctChange: EventEmitter<DatePickerChangeDetail>;
+    connectedCallback(): void;
+    focusHandler(event: CustomEvent<{
+        value?: string;
+    }>): void;
+    /** Moves the visible month to the provided date and focuses that day. */
+    focusDate(value: string | Date): Promise<void>;
+    /** Selects the provided date when it satisfies the calendar constraints. */
+    setValue(value: string | Date): Promise<void>;
+    constraintsChanged(): void;
+    modeChanged(): void;
+    openChanged(open: boolean): void;
+    rangeChanged(): void;
+    valueChanged(): void;
+    get constraints(): {
+        cutoffTime: string;
+        daysOfWeekChecksum: number;
+        endDate: string;
+        invalidDates: string[];
+        startDate: string;
+        validDates: string[];
+    };
+    get currentWeeks(): DatePickerDay[][];
+    get dateList(): DatePickerDay[];
+    get isRangeMode(): boolean;
+    get normalizedDisplayFormat(): DatePickerDisplayFormat;
+    get rangeConfirmDisabled(): boolean;
+    get rangeEndDate(): Date | undefined;
+    get rangeSummary(): string;
+    get rangeValidationError(): string;
+    get rovingDate(): Date;
+    get selectedDate(): Date | undefined;
+    get title(): string;
+    activateDate(date: Date): void;
+    emitCommit(detail: DatePickerChangeDetail): void;
+    findValidNavigationDate(date: Date, direction: 1 | -1): Date | undefined;
+    focusRenderedDate(date: Date): void;
+    formatRangeDate(date: Date): string;
+    goToMonthYear(monthIndex: number, selectedYear: number): void;
+    isDateValid(date: Date): boolean;
+    isRangeValid(start: Date, end: Date): boolean;
+    onDateHover: (event: MouseEvent) => void;
+    onDateHoverEnd: () => void;
+    onDateKeydown: (event: KeyboardEvent) => void;
+    onDateSelection: (event: MouseEvent) => void;
+    onNavigate(action: DatePickerNavigationAction): void;
+    onRangeCancel: () => void;
+    onRangeCommit: () => void;
+    resetCalendarSession(): void;
+    resetRangeDraft(): void;
+    selectDate(selectedDate: Date): void;
+    setRangeError(error: string): void;
+    renderNavigation(): any[];
+    renderNavigationButton(action: DatePickerNavigationAction): any;
+    render(): any;
+}

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

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

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-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;
@@ -161,6 +167,13 @@ 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;

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

@@ -135,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;
     /**
@@ -159,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;

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-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;

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

@@ -16,13 +16,15 @@ export declare class Q2RadioGroup implements ComponentInterface {
     /** Determines if the component should display in an errant state. */
     hasError: boolean;
     /**
-     * Hide's the group's `<label>` element from view.
+     * Hides the group'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;
     /**
      * Text for the fieldset legend describing the radio group.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;

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

@@ -51,13 +51,15 @@ export declare class Q2Search implements ComponentInterface {
     /**
      * 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;
     /** Determines whether to show an error state. Its primary use-case is for an unfilled field. */
     invalid: boolean;
     /**
      * The text that will be used as the label for the field.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;

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

@@ -51,9 +51,9 @@ export declare class Q2Select implements ComponentInterface {
      */
     errors: 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;
     /**
@@ -70,6 +70,8 @@ export declare class Q2Select implements ComponentInterface {
     invalid: boolean;
     /**
      * The text that will be used as the label for the field.
+     * @warning
+     * Required for screen reader compliance even when `hideLabel` is `true`.
      * @localizable
      */
     label: string;

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

@@ -30,9 +30,9 @@ export declare class Q2Textarea {
      */
     errors: 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;
     /**
@@ -50,6 +50,8 @@ export declare class Q2Textarea {
     hints: string[];
     /**
      * 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;