q2-tecton-elements 1.51.0 → 1.52.0

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

@@ -59,6 +59,8 @@ export declare class Q2Input {
     ariaOwns: string;
     /**
      * The `autocapitalize` attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.
+     *
+     * [See MDN for a list of supported values](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autocapitalize#value).
      * @info
      * This attribute only affects the behavior of input mechanisms like virtual keyboards on mobile devices and voice input.
      */
@@ -81,7 +83,7 @@ export declare class Q2Input {
      * If applied to multiple elements, the first one will receive focus.
      */
     autofocus: boolean;
-    /** The color of the badge when in the active state. */
+    /** The color of the badge when in the active state. The property `badgeValue` must be provided. */
     badgeTheme: Q2Badge['theme'];
     /** Displays a `q2-badge` element on the right side of the input. */
     badgeValue: string;
@@ -111,7 +113,7 @@ export declare class Q2Input {
      */
     hideLabel: boolean;
     /**
-     * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array above).
+     * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array).
      * Primarily used for dropdown selects and date pickers whose controls appear below the input field (where the error messages, if displayed, would also appear).
      */
     hideMessages: boolean;
@@ -195,7 +197,7 @@ export declare class Q2Input {
      */
     showVisibilityToggle: boolean;
     /**
-     * When present, it jumps the value in incremens of `step` when the user uses the Up/Down arrow keys to change the value.
+     * When present, it jumps the value in increments of `step` when the user uses the Up/Down arrow keys to change the value.
      * @info
      * Only applicable when `type="number"`.
      */
@@ -205,7 +207,7 @@ export declare class Q2Input {
      * When the input type is `password`, it will default to `true`, hiding the text.
      */
     textHidden: boolean;
-    /** Specifies the field's expeted [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices. */
+    /** Specifies the field's expected [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices. */
     type: InputType;
     /**
      * Returns a read-only `ValidityState` object representing the validity states of the element.
@@ -254,12 +256,12 @@ export declare class Q2Input {
     componentWillLoad(): void;
     componentDidLoad(): void;
     componentDidRender(): void;
-    onHostElementChange(event: CustomEvent): void;
+    onHostElementChange(event: CustomEvent | Event): void;
     onHostElementFocus(event: any): void;
     /**
      * Emulates firing checkValidity on `<input>`, emits `invalid` event if validation failed.
      */
-    checkValidity(): void;
+    checkValidity(): Promise<void>;
     /**
      * Emulates clicking the clear button when the input is clearable.
      *
@@ -268,7 +270,7 @@ export declare class Q2Input {
      *
      * @testOnly
      */
-    clearValue(): void;
+    clearValue(): Promise<void>;
     /**
      * Emulates focusing the `<input>`, entering the provided value, and emitting an `input` event.
      *
@@ -302,7 +304,7 @@ export declare class Q2Input {
     get hasError(): boolean;
     get hasInputLeftSlot(): boolean;
     get hasInputRightSlot(): boolean;
-    get inputDescribedBy(): string;
+    get inputDescribedBy(): string | undefined;
     get inputField(): HTMLInputElement;
     get inputId(): string;
     get inputMode(): any;
@@ -318,7 +320,6 @@ export declare class Q2Input {
     get wrapperClasses(): string;
     calculateCursorPositionOnFocus(): ICursorData;
     calculateCursorPositionOnInput(): ICursorData;
-    countDOM(): any;
     formatAndUpdateValueFromProp(): void;
     getFormattedValue(value: string, valueChangedFromProperty: boolean): IFormatterValueObject;
     handleCurrencyDeletion(event: InputEvent): void;
@@ -329,7 +330,7 @@ export declare class Q2Input {
     handleCurrencyKeydown: (event: KeyboardEvent) => void;
     handleDataInput(newFormattedValue: IFormatterValueObject): void;
     handleValueAndCursor: () => void;
-    inputContainerDOM(): any;
+    initMutationObserver: () => void;
     onClearInput: () => void;
     onInputBlur: () => void;
     onInputClick: () => void;
@@ -341,10 +342,12 @@ export declare class Q2Input {
     onRefocusInput: () => void;
     onToggleVisibility: () => void;
     placeCursorAtEnd(): void;
-    pseudoInputDOM(): any;
     setCursorPosition(cursorData: ICursorData): void;
-    standardInputDOM(): any;
     validateInput: () => void;
+    renderCountDOM(): any;
+    renderInputContainerDOM(): any;
+    renderPseudoInputDOM(): any;
+    renderStandardInputDOM(): any;
     render(): any;
 }
 export {};

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

@@ -1,7 +1,21 @@
 export declare class Q2Loc {
+    mutationObserver: MutationObserver;
+    hostElement: HTMLElement;
+    displayValue: string;
     /** Any substitutions you would like to pass into the localization string. */
     substitutions: string[];
-    /** The reference to the localization key you would like to display the localized output of. */
+    /**
+     * The reference to the localization key you would like to display the localized output of.
+     * If no value is provided, any text inside the element will be used as a fallback.
+     * @localizable
+     */
     value: string;
+    disconnectedCallback(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    propHandler(): void;
+    initMutationObserver: () => void;
+    initValue: () => Promise<void>;
+    mutationHandler: () => Promise<void>;
     render(): any;
 }

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

@@ -1,5 +1,6 @@
 import { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 export declare class Q2Option implements ComponentInterface {
+    displayProvidedAtInit: boolean;
     mutationObserver: MutationObserver;
     hostElement: HTMLElement;
     _multiSelectHidden: boolean;
@@ -15,7 +16,10 @@ export declare class Q2Option implements ComponentInterface {
      * @private
      */
     disabledGroup: boolean;
-    /** The text that is presented in the field when selected. If not set, the text inside the element will be used. */
+    /**
+     * The text that is displayed in the field when selected. If not provided, any text inside the element will be used.
+     * @localizable
+     */
     display: string;
     /**
      * Used by consuming elements to enable multiline content support
@@ -43,9 +47,13 @@ export declare class Q2Option implements ComponentInterface {
         value: string;
         display: string;
     }>;
+    disconnectedCallback(): void;
     componentWillLoad(): void;
     componentDidLoad(): void;
-    initDisplay(): void;
-    mutationHandler: (mutations: MutationRecord[]) => void;
+    displayChangedHandler(): Promise<void>;
+    handleTextContent: () => Promise<void>;
+    initDisplay: () => Promise<void>;
+    initMutationObserver: () => void;
+    mutationHandler: () => Promise<void>;
     render(): any;
 }

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

@@ -3,15 +3,15 @@ import { IOptionValue } from '../q2-option-list/q2-option-list';
 export declare class Q2Pill implements ComponentInterface {
     mutationObserver: MutationObserver;
     optionList: HTMLQ2OptionListElement;
+    popoverBottomContainer: HTMLElement;
     popoverElement: HTMLQ2PopoverElement;
     popoverTopContainer: HTMLElement;
-    popoverBottomContainer: HTMLElement;
     primaryBtn: HTMLButtonElement;
     primaryBtnWrapper: HTMLElement;
     scheduledAfterRender: (() => void)[];
     hostElement: HTMLElement;
-    hasPopoverTop: boolean;
     hasPopoverBottom: boolean;
+    hasPopoverTop: boolean;
     optionCount: number;
     selectedOptionElements: HTMLQ2OptionElement[];
     /** Determine if the elements is in the selected state, with values. */
@@ -130,9 +130,9 @@ export declare class Q2Pill implements ComponentInterface {
     handleWrapperClick: () => void;
     onClickElsewhere: (event: CustomEvent) => void;
     onMutationObserved: () => void;
-    updateSlotState: () => void;
     syncValueProperties: () => void;
     updateSelectedOptionElements: () => Promise<void>;
+    updateSlotState: () => void;
     renderHiddenElement(): any;
     renderIcon(): any;
     render(): any;

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

@@ -46,6 +46,7 @@ export declare class Q2Popover implements ComponentInterface {
     }>): void;
     scrollContainerTo(options: ScrollToOptions): Promise<void>;
     toggle(): Promise<void>;
+    handleControlElement(): void;
     minHeightProvided(): void;
     openChanged(open: boolean): Promise<void>;
     get isModule(): boolean;

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

@@ -3,7 +3,6 @@ import { EventEmitter, ComponentInterface } from '../../stencil-public-runtime';
 import { IEventDetail, Q2InputCustomEvent, Q2OptionListCustomEvent } from "../../components";
 import { IOptionValue } from '../q2-option-list/q2-option-list';
 export declare class Q2Select implements ComponentInterface {
-    inputField?: HTMLQ2InputElement;
     mutationObserver: MutationObserver;
     optionList: HTMLQ2OptionListElement;
     popoverElement?: HTMLQ2PopoverElement;
@@ -14,6 +13,7 @@ export declare class Q2Select implements ComponentInterface {
     hasCustomDisplay: boolean;
     hasPopoverBottom: boolean;
     hasPopoverTop: boolean;
+    inputField?: HTMLQ2InputElement;
     inputFocused: boolean;
     open: boolean;
     prioritizeSearch: boolean;

package/dist/types/components/q2-stepper-vertical/q2-stepper-vertical.d.ts

@@ -54,6 +54,12 @@ export declare class Q2StepperVertical implements ComponentInterface {
     setDefaultPane(): void;
     showStep(stepId: string): void;
     showStepPane(stepId: string): void;
+    /**
+     * A method to select a step corresponding with the step id.
+     *
+     * @testOnly
+     */
+    selectStep(stepId: string): Promise<void>;
     renderChildStepBtn(pane: IBaseStructuredPane, index: number, children: number, parentLabel: string): any;
     renderSpacer(pane: IStructuredPane, stepLabel: string, isExpanded: boolean, isLastStep: boolean): any;
     renderStepBtn(pane: IStructuredPane, index: number): any;

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

@@ -1,10 +1,10 @@
 import { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 export declare class Q2Tag implements ComponentInterface {
-    dropdownBtn: HTMLButtonElement;
     mutationObserver: MutationObserver;
     optionList: HTMLQ2OptionListElement;
     popoverElement: HTMLQ2PopoverElement;
     hostElement: HTMLElement;
+    dropdownBtn: HTMLButtonElement;
     optionCount: number;
     /**
      * Instructs the component to use the action sheet workflow for displaying its options.

package/dist/types/components.d.ts

@@ -520,6 +520,11 @@ export namespace Components {
           * Controls visibility of labels on the value axis.
          */
         "hideValueAxisLabels": boolean;
+        /**
+          * A method to fire change event on hover on a point.
+          * @testOnly
+         */
+        "hoverDataPoint": (index: number) => Promise<void>;
         /**
           * Controls color of the data line on the chart. Accepts variables, hex codes, and CSS color names.  **Examples:**
           * @snippet element.areaColor = "#ff0000"; element.areaColor = "papayawhip"; element.areaColor = "var(--t-accent-1)";
@@ -682,6 +687,11 @@ export namespace Components {
           * Selects a slice by its index in the provided `data`.
          */
         "selectByIndex": (index: number) => Promise<void>;
+        /**
+          * A method to select a slice with index.
+          * @testOnly
+         */
+        "selectDataPoint": (index: number) => Promise<void>;
         /**
           * The id of the data point that is currently selected in the chart. You may set this to pre-select a data point on render, or force a selection change.
          */
@@ -818,6 +828,11 @@ export namespace Components {
           * Formats the `amount` to a specific currency.
          */
         "currency": string;
+        /**
+          * A method to select a tab pane corresponding with the value.
+          * @testOnly
+         */
+        "displayedMessageValue": () => Promise<string>;
         /**
           * Formats to the language provided. Accepts multiple locales in an array as sequential fallbacks.
          */
@@ -1171,6 +1186,25 @@ export namespace Components {
          */
         "value": string;
     }
+    interface Q2Example {
+        /**
+          * Closes the menu.
+         */
+        "close": () => Promise<void>;
+        /**
+          * The content of the menu.
+         */
+        "content": string;
+        /**
+          * If `true`, the user cannot interact with the menu.
+         */
+        "disabled": boolean;
+        "openMenu": () => Promise<boolean>;
+        /**
+          * Specifies the menu type.
+         */
+        "type": string;
+    }
     interface Q2FormattedText {
         /**
           * Formats to the language provided. Accepts multiple locales in an array as sequential fallbacks.
@@ -1240,7 +1274,7 @@ export namespace Components {
         "ariaLabel": string;
         "ariaOwns": string;
         /**
-          * The `autocapitalize` attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.
+          * The `autocapitalize` attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.  [See MDN for a list of supported values](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autocapitalize#value).
           * @info This attribute only affects the behavior of input mechanisms like virtual keyboards on mobile devices and voice input.
          */
         "autocapitalize": string;
@@ -1258,7 +1292,7 @@ export namespace Components {
          */
         "autofocus": boolean;
         /**
-          * The color of the badge when in the active state.
+          * The color of the badge when in the active state. The property `badgeValue` must be provided.
          */
         "badgeTheme": Q2Badge['theme'];
         /**
@@ -1302,7 +1336,7 @@ export namespace Components {
          */
         "hideLabel": boolean;
         /**
-          * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array above). Primarily used for dropdown selects and date pickers whose controls appear below the input field (where the error messages, if displayed, would also appear).
+          * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array). Primarily used for dropdown selects and date pickers whose controls appear below the input field (where the error messages, if displayed, would also appear).
          */
         "hideMessages": boolean;
         /**
@@ -1381,7 +1415,7 @@ export namespace Components {
          */
         "showVisibilityToggle": boolean;
         /**
-          * When present, it jumps the value in incremens of `step` when the user uses the Up/Down arrow keys to change the value.
+          * When present, it jumps the value in increments of `step` when the user uses the Up/Down arrow keys to change the value.
           * @info Only applicable when `type="number"`.
          */
         "step": number;
@@ -1390,7 +1424,7 @@ export namespace Components {
          */
         "textHidden": boolean;
         /**
-          * Specifies the field's expeted [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices.
+          * Specifies the field's expected [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices.
          */
         "type": InputType;
         /**
@@ -1516,7 +1550,8 @@ export namespace Components {
          */
         "substitutions": string[];
         /**
-          * The reference to the localization key you would like to display the localized output of.
+          * The reference to the localization key you would like to display the localized output of. If no value is provided, any text inside the element will be used as a fallback.
+          * @localizable
          */
         "value": string;
     }
@@ -1570,7 +1605,8 @@ export namespace Components {
          */
         "disabledGroup": boolean;
         /**
-          * The text that is presented in the field when selected. If not set, the text inside the element will be used.
+          * The text that is displayed in the field when selected. If not provided, any text inside the element will be used.
+          * @localizable
          */
         "display": string;
         /**
@@ -2187,6 +2223,11 @@ export namespace Components {
           * The `id` of the currently selected `q2-stepper-pane`.
          */
         "currentStepId": string;
+        /**
+          * A method to select a step corresponding with the step id.
+          * @testOnly
+         */
+        "selectStep": (stepId: string) => Promise<void>;
     }
     interface Q2TabContainer {
         /**
@@ -2482,6 +2523,10 @@ export interface Q2EditableFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLQ2EditableFieldElement;
 }
+export interface Q2ExampleCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLQ2ExampleElement;
+}
 export interface Q2InputCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLQ2InputElement;
@@ -2856,6 +2901,25 @@ declare global {
         prototype: HTMLQ2EditableFieldElement;
         new (): HTMLQ2EditableFieldElement;
     };
+    interface HTMLQ2ExampleElementEventMap {
+        "tctClick": any;
+        "tctDrag": any;
+        "tctOpen": any;
+    }
+    interface HTMLQ2ExampleElement extends Components.Q2Example, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLQ2ExampleElementEventMap>(type: K, listener: (this: HTMLQ2ExampleElement, ev: Q2ExampleCustomEvent<HTMLQ2ExampleElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLQ2ExampleElementEventMap>(type: K, listener: (this: HTMLQ2ExampleElement, ev: Q2ExampleCustomEvent<HTMLQ2ExampleElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLQ2ExampleElement: {
+        prototype: HTMLQ2ExampleElement;
+        new (): HTMLQ2ExampleElement;
+    };
     interface HTMLQ2FormattedTextElement extends Components.Q2FormattedText, HTMLStencilElement {
     }
     var HTMLQ2FormattedTextElement: {
@@ -3336,6 +3400,7 @@ declare global {
         "q2-dropdown": HTMLQ2DropdownElement;
         "q2-dropdown-item": HTMLQ2DropdownItemElement;
         "q2-editable-field": HTMLQ2EditableFieldElement;
+        "q2-example": HTMLQ2ExampleElement;
         "q2-formatted-text": HTMLQ2FormattedTextElement;
         "q2-icon": HTMLQ2IconElement;
         "q2-input": HTMLQ2InputElement;
@@ -4490,6 +4555,27 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    interface Q2Example {
+        /**
+          * The content of the menu.
+         */
+        "content"?: string;
+        /**
+          * If `true`, the user cannot interact with the menu.
+         */
+        "disabled"?: boolean;
+        /**
+          * 5. Events    Custom events dispatched from the component that are defined via the
+          * @Event () decorator. Start each event name with "tct" so they do not conflict with native events. Document each using JSDoc comments and list in alphabetical order.
+         */
+        "onTctClick"?: (event: Q2ExampleCustomEvent<any>) => void;
+        "onTctDrag"?: (event: Q2ExampleCustomEvent<any>) => void;
+        "onTctOpen"?: (event: Q2ExampleCustomEvent<any>) => void;
+        /**
+          * Specifies the menu type.
+         */
+        "type"?: string;
+    }
     interface Q2FormattedText {
         /**
           * Formats to the language provided. Accepts multiple locales in an array as sequential fallbacks.
@@ -4559,7 +4645,7 @@ declare namespace LocalJSX {
         "ariaLabel"?: string;
         "ariaOwns"?: string;
         /**
-          * The `autocapitalize` attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.
+          * The `autocapitalize` attribute is an enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.  [See MDN for a list of supported values](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autocapitalize#value).
           * @info This attribute only affects the behavior of input mechanisms like virtual keyboards on mobile devices and voice input.
          */
         "autocapitalize"?: string;
@@ -4577,7 +4663,7 @@ declare namespace LocalJSX {
          */
         "autofocus"?: boolean;
         /**
-          * The color of the badge when in the active state.
+          * The color of the badge when in the active state. The property `badgeValue` must be provided.
          */
         "badgeTheme"?: Q2Badge['theme'];
         /**
@@ -4611,7 +4697,7 @@ declare namespace LocalJSX {
          */
         "hideLabel"?: boolean;
         /**
-          * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array above). Primarily used for dropdown selects and date pickers whose controls appear below the input field (where the error messages, if displayed, would also appear).
+          * When `true` and the input field has an active validation error, the field shows the error state without displaying associated error messages below the field (from the errors array). Primarily used for dropdown selects and date pickers whose controls appear below the input field (where the error messages, if displayed, would also appear).
          */
         "hideMessages"?: boolean;
         /**
@@ -4708,7 +4794,7 @@ declare namespace LocalJSX {
          */
         "showVisibilityToggle"?: boolean;
         /**
-          * When present, it jumps the value in incremens of `step` when the user uses the Up/Down arrow keys to change the value.
+          * When present, it jumps the value in increments of `step` when the user uses the Up/Down arrow keys to change the value.
           * @info Only applicable when `type="number"`.
          */
         "step"?: number;
@@ -4717,7 +4803,7 @@ declare namespace LocalJSX {
          */
         "textHidden"?: boolean;
         /**
-          * Specifies the field's expeted [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices.
+          * Specifies the field's expected [input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types), and provides the optimal keyboard on mobile devices.
          */
         "type"?: InputType;
         /**
@@ -4846,7 +4932,8 @@ declare namespace LocalJSX {
          */
         "substitutions"?: string[];
         /**
-          * The reference to the localization key you would like to display the localized output of.
+          * The reference to the localization key you would like to display the localized output of. If no value is provided, any text inside the element will be used as a fallback.
+          * @localizable
          */
         "value"?: string;
     }
@@ -4898,7 +4985,8 @@ declare namespace LocalJSX {
          */
         "disabledGroup"?: boolean;
         /**
-          * The text that is presented in the field when selected. If not set, the text inside the element will be used.
+          * The text that is displayed in the field when selected. If not provided, any text inside the element will be used.
+          * @localizable
          */
         "display"?: string;
         /**
@@ -5782,6 +5870,7 @@ declare namespace LocalJSX {
         "q2-dropdown": Q2Dropdown;
         "q2-dropdown-item": Q2DropdownItem;
         "q2-editable-field": Q2EditableField;
+        "q2-example": Q2Example;
         "q2-formatted-text": Q2FormattedText;
         "q2-icon": Q2Icon;
         "q2-input": Q2Input;
@@ -5842,6 +5931,7 @@ declare module "@stencil/core" {
             "q2-dropdown": LocalJSX.Q2Dropdown & JSXBase.HTMLAttributes<HTMLQ2DropdownElement>;
             "q2-dropdown-item": LocalJSX.Q2DropdownItem & JSXBase.HTMLAttributes<HTMLQ2DropdownItemElement>;
             "q2-editable-field": LocalJSX.Q2EditableField & JSXBase.HTMLAttributes<HTMLQ2EditableFieldElement>;
+            "q2-example": LocalJSX.Q2Example & JSXBase.HTMLAttributes<HTMLQ2ExampleElement>;
             "q2-formatted-text": LocalJSX.Q2FormattedText & JSXBase.HTMLAttributes<HTMLQ2FormattedTextElement>;
             "q2-icon": LocalJSX.Q2Icon & JSXBase.HTMLAttributes<HTMLQ2IconElement>;
             "q2-input": LocalJSX.Q2Input & JSXBase.HTMLAttributes<HTMLQ2InputElement>;

package/dist/types/utils/helpers.d.ts

@@ -70,4 +70,17 @@ export declare const evaluateA11y: (page: any, ...args: string[]) => Promise<{}>
  * @note Be sure to call `jest.restoreAllMocks()` after the test to restore the original fetch function.
  */
 export declare const mockIconFetch: (iconMarkup?: string) => jest.SpyInstance<Promise<Response>, [input: string | URL | Request, init?: RequestInit], any>;
+declare global {
+    interface Window {
+        getAllText: (element: Element, options: any) => Promise<string>;
+    }
+}
+/**
+ * Mimicks the behavior of the {@link getAllText} utility function, with a few extractions to simplify usage.
+ * @param {E2EPage} page
+ * @param {string} selector
+ * @param {Object} options
+ * @returns {Promise<string>}
+ */
+export declare const getAllElementTextE2E: (page: E2EPage, selector: string, options?: {}) => Promise<string>;
 export {};

package/dist/types/utils/index.d.ts

@@ -46,3 +46,14 @@ export declare function renderMessages(target: FormFieldTypes): any;
 export declare function setMessageHeight(target: FormFieldTypes): void;
 export declare const resizeIframe: () => void;
 export declare const handleColor: (target: Q2Btn) => void;
+/**
+ * Gets all translated text content from an element, including shadow DOM content
+ *
+ * @param {Element} element - The element to extract text from
+ * @param {Object} options - Configuration options
+ * @param {boolean} [options.trim=true] - Whether to trim whitespace
+ * @param {boolean} [options.normalizeWhitespace=false] - Whether to normalize whitespace
+ * @param {boolean} [options.skipComponentReady=false] - Skip waiting for components (for test environments)
+ * @return {Promise<string>} All translated text content in DOM order
+ */
+export declare const getAllText: (element: any, options?: {}) => Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "q2-tecton-elements",
-    "version": "1.51.0",
+    "version": "1.52.0",
     "description": "Q2 Tecton Custom Elements",
     "license": "MIT",
     "author": "Q2 Tecton Team",
@@ -16,13 +16,13 @@
         "access": "public"
     },
     "scripts": {
-        "build": "stencil build && node ../../build/create-theme-files.js",
-        "build:dev": "stencil build && node ../../build/create-theme-files.js",
+        "build": "stencil build --debug && node ../../build/create-theme-files.js",
+        "build:dev": "stencil build --debug && node ../../build/create-theme-files.js",
         "build:docs-json": "stencil build --docs-json dist/docs.json",
         "build:elements": "stencil build",
         "build:local": "stencil build --dev --watch --serve",
-        "build:prerelease": "stencil build && node ../../build/create-theme-files.js",
-        "build:prod": "stencil build && node ../../build/create-theme-files.js",
+        "build:prerelease": "stencil build --debug && node ../../build/create-theme-files.js",
+        "build:prod": "stencil build --debug && node ../../build/create-theme-files.js",
         "clean": "rm -rf dist tmp",
         "lint": "cross-env ESLINT_USE_FLAT_CONFIG=false eslint --config .cli-eslintrc.js --ext .ts,.tsx --ignore-path .gitignore .",
         "lint:fix": "cross-env ESLINT_USE_FLAT_CONFIG=false eslint --fix --config .cli-eslintrc.js --ext .ts,.tsx --ignore-path .gitignore .",
@@ -35,7 +35,7 @@
     },
     "dependencies": {
         "@stencil/core": "4.18.0",
-        "q2-tecton-common": "1.51.0",
+        "q2-tecton-common": "1.52.0",
         "swiper": "8.4.4"
     },
     "devDependencies": {
@@ -60,5 +60,5 @@
         "typescript": "5.4.5",
         "typescript-eslint": "^7.11.0"
     },
-    "gitHead": "2948ae3915111c10c85e325dbdaedde04c796f59"
+    "gitHead": "f2c09f8d74c4e925e3ec5cfb50835e2ea56381f2"
 }