@heartlandone/vega 2.77.1 → 2.78.0

package/dist/types/components/vega-input-phone-number/vega-input-phone-number.d.ts

@@ -30,127 +30,192 @@ export declare class VegaInputPhoneNumber {
   host: HTMLVegaInputPhoneNumberElement;
   phoneNumberInputValue: string;
   /**
-   * Specifies the label or title for the phone number input field.
-   *
-   * It provides descriptive text that helps identify the
-   *    purpose or content expected in the input field.
+   * Specifies the visible label text rendered above the phone number input.
+   * The label identifies the purpose of the field and serves as the
+   * accessible name for screen readers.
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   label: string;
   /**
-   * Specifies the size of the phone number input field.
+   * Controls the visual size of the phone number input field.
+   *
+   * - `'default'` — Standard height, suitable for most form layouts.
+   * - `'small'` — Compact height, useful for dense UIs.
    *
+   * @default 'default'
    * @vegaVersion 2.18.0
    */
   size: 'default' | 'small';
   /**
-   * Determines whether the phone number input field is required.
+   * Determines whether the phone number input field must have a value before
+   * the form can be submitted. When `true`, the built-in
+   * `InputPhoneNumberRequiredRule` is applied during validation and a
+   * required indicator is shown on the label.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   required: boolean;
   /**
-   * Determines whether the phone number input field is disabled.
+   * Specifies whether the phone number input field is disabled. When `true`,
+   * both the country selector and the phone number text field become
+   * non-interactive — the user cannot type, select a country, or focus
+   * any part of the component.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   disabled: boolean;
   /**
-   * Specifies the default country calling code using the two-letter uppercase country code.
+   * Specifies the currently selected country using a two-letter uppercase
+   * ISO 3166-1 alpha-2 code (e.g., `'US'`, `'GB'`, `'CN'`). The country
+   * code determines the flag icon and calling code prefix displayed in the
+   * country selector. Changing this value updates the phone number prefix
+   * accordingly.
    *
+   * @default 'US'
    * @vegaVersion 2.18.0
-   * @defaultValue US
    */
   countryCode: VegaCountryCode;
   watchCountryCode(newCountryCode: VegaCountryCode, oldCountryCode: VegaCountryCode): void;
   /**
-   * Specifies the countries available for selection.
+   * An array of country codes available for selection in the country
+   * dropdown. Each entry must be a two-letter uppercase ISO 3166-1 alpha-2
+   * code.
    *
-   * Note: By default, 245 codes are provided, but loading all of them may take time. To improve performance, it is recommended to include only the necessary codes.
+   * By default all 245 supported codes are loaded, but providing a smaller
+   * subset improves initial render performance.
    *
+   * @default VegaCountryCode[] (all 245 codes)
    * @vegaVersion 2.18.0
-   * @defaultValue ['US', 'CN', ...]{@link VegaCountryCode}
    */
   allowedCountryCodes: VegaCountryCode[];
   /**
-   * Specifies whether the phone number input field can be set to an empty value.
-   * - `true`:
-   *      The value property is cleared when the input field is empty.
-   * - `false`:
-   *      The value property is `+1` when no phone number is entered.
+   * Controls whether the `value` property can be an empty string.
    *
+   * - `true` — The `value` property is cleared to `''` when the user
+   *   deletes all digits from the input field.
+   * - `false` — The `value` property always retains at least the country
+   *   calling code prefix (e.g., `'+1'` for US) even when no phone number
+   *   digits have been entered.
+   *
+   * @default false
    * @vegaVersion 2.35.0
    */
   emptyValueEnabled: boolean;
   watchEmptyValueEnabled(): void;
   /**
-   * Specifies the value of the phone number input in [E.164]{@link https://en.wikipedia.org/wiki/E.164} format.
+   * The current value of the phone number input in
+   * [E.164](https://en.wikipedia.org/wiki/E.164) format (e.g., `'+14155552671'`).
+   *
+   * This property is mutable and reflected to the host element attribute.
+   * It updates as the user types and can be set externally to pre-populate
+   * or reset the field. When `emptyValueEnabled` is `false` and no digits
+   * have been entered, the value defaults to the country calling code
+   * prefix (e.g., `'+1'` for US).
    *
-   * @VegaWarning - Note: The input phone number field will always have a value. If no phone number is entered, the default format is `+{default_country_code}`.
-   *              - For example, if the default country code is US, the default value will be `+1`.
+   * @default '+1'
    * @vegaVersion 2.18.0
-   * @defaultValue +1
    */
   value: string;
   watchValue(newValue: string, oldValue: string): void;
   /**
-   * Specifies custom validation rules for the phone number input field.
+   * An array of custom validation rules applied to the phone number input in
+   * addition to the built-in rules (`InputPhoneNumberRequiredRule`,
+   * `ValidPhoneNumberRule`). Each rule must implement the
+   * `FormFieldValidationRule` interface.
    *
+   * Rules are evaluated in order when `autoValidation` is enabled or when
+   * validation is triggered programmatically.
+   *
+   * @default []
    * @vegaVersion 2.18.0
    */
   validationRules: FormFieldValidationRule<unknown>[];
   watchValidationRules(): void;
   /**
-   * Indicates whether the current value in the field is considered valid
-   *    based on the defined validation rules.
+   * Reflects the current validation status of the phone number input.
+   *
+   * - `true` — the field value passes all validation rules.
+   * - `false` — one or more validation rules have failed.
+   * - `null` — the field has not been validated yet (initial state).
    *
+   * This property is mutable: it is updated automatically when
+   * `autoValidation` is enabled, but can also be set manually to override
+   * the validation state.
+   *
+   * @default null
    * @vegaVersion 2.18.0
    */
   isValid: boolean;
   /**
-   * Determines whether the phone number input field should undergo automatic validation
-   *    during the user's input.
+   * Determines whether the phone number input should be validated
+   * automatically as the user interacts with it. When `true`, validation
+   * rules (including `required`, `ValidPhoneNumberRule`, and custom
+   * `validationRules`) are evaluated and the `isValid` property is updated
+   * accordingly.
+   *
+   * Set to `false` to handle validation manually.
    *
+   * @default true
    * @vegaVersion 2.18.0
    */
   autoValidation: boolean;
   /**
-   * Specifies a placeholder string that displays as a temporary hint
-   *    or example inside the input field.
+   * Specifies placeholder text displayed inside the phone number text field
+   * when it is empty. The placeholder disappears once the user begins typing
+   * and is typically used to indicate the expected format
+   * (e.g., `'(555) 555-5555'`).
    *
+   * @default undefined
    * @vegaVersion 2.18.0
    */
   placeholder: string;
   /**
-   * Provides a supplementary prompt message that assists users in
-   *    understanding the expected value for the input field.
+   * Supplementary helper message displayed below the phone number input that
+   * assists users in understanding the expected value or provides additional
+   * context (e.g., `'We will send a verification code to this number'`).
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   hint: string;
   /**
-   * An event emitter notifying a value change.
+   * Fires whenever the phone number value changes — including typing,
+   * pasting, or programmatic updates. The event detail contains the full
+   * phone number in E.164 format (e.g., `'+14155552671'`).
    *
+   * @eventDetail string
    * @vegaVersion 2.18.0
    */
   vegaChange: EventEmitter<string>;
   /**
-   * An event emitter notifying a value change.
+   * Native-equivalent mirror of `vegaChange`. Fires with the same payload
+   * and at the same time, allowing consumers to listen using the standard
+   * `change` event name.
    *
+   * @eventDetail string
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */
   change: EventEmitter<string>;
   /**
-   * An event emitter notifying a country change.
+   * Fires whenever the selected country changes via the country dropdown.
+   * The event detail contains a `VegaCountryType` object with the country
+   * code, calling code, and display name of the newly selected country.
    *
+   * @eventDetail VegaCountryType
    * @vegaVersion 2.18.0
    */
   vegaCountryChange: EventEmitter<VegaCountryType>;
   /**
-   * An event emitter notifying a country change.
+   * Native-equivalent mirror of `vegaCountryChange`. Fires with the same
+   * payload and at the same time, allowing consumers to listen using the
+   * standard `countryChange` event name.
    *
+   * @eventDetail VegaCountryType
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */

package/dist/types/components/vega-input-range/slimmers/renderers/vega-input-range-input-renderer.d.ts

@@ -10,6 +10,7 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
   protected max: VegaInputRange['max'];
   protected size: VegaInputRange['size'];
   protected placeholder: VegaInputRange['placeholder'];
+  protected label: VegaInputRange['label'];
   protected showClearIcon: VegaInputRange['showClearIcon'];
   protected valueController: VegaInputRange['valueController'];
   protected clearIconRenderer: VegaInputRange['clearIconRenderer'];
@@ -54,6 +55,13 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
    * @returns {string} the input placeholder text
    */
   private getPlaceholderByIndex;
+  /**
+   * Get the data aria label for the input range input by the input range index
+   *
+   * @param {number} index the range index 0|1
+   * @returns {string} the data aria label for the input range input
+   */
+  private getDataAriaLabel;
   /**
    * get the input value by the input range index
    *

package/dist/types/components/vega-input-select/vega-input-select.d.ts

@@ -80,11 +80,11 @@ export declare class VegaInputSelect {
    * Allows customization of the text displayed within the
    *    select field when single or multiple items are selected.
    *    The default format for the selected label is
-   *    `${number of selected items} Selected` for multiple mode only.
+   *    `{0} Selected` for multiple mode only.
    *
    *	To enable all modes, use the `SelectedLabelTypeForAllModes` type.
    * 		For single mode, the default format is the `displayName` of the selected item if not set
-   * 		For multiple mode, the default format is `${number of selected items} Selected` if not set
+   * 		For multiple mode, the default format is `{0} Selected` if not set
    *
    * @vegaVersion 1.35.0
    */

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/source-edit-toolbar-button-slimmer.d.ts

@@ -4,7 +4,7 @@ export declare class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer
   sourceView: VegaRichTextEditor['sourceView'];
   selectionController: VegaRichTextEditor['selectionController'];
   valueController: VegaRichTextEditor['valueController'];
-  vegaRichTextEditorRenderer: VegaRichTextEditor['vegaRichTextEditorRenderer'];
+  richTextEditorSourceViewRenderer: VegaRichTextEditor['richTextEditorSourceViewRenderer'];
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   value: VegaRichTextEditor['value'];
   constructor();

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/vega-rich-text-editor-renderer.d.ts

@@ -16,10 +16,10 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
   extensions: VegaRichTextEditor['extensions'];
+  richTextEditorSourceViewRenderer: VegaRichTextEditor['richTextEditorSourceViewRenderer'];
   private richTextContainerRef;
   private richTextContentRef;
   private richTextWrapperRef;
-  private sourceCodeBlockRef;
   /**
    * Component lifecycle - [componentDidRender]{@link VegaRichTextEditor.componentDidRender}
    */
@@ -48,7 +48,6 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
    * @returns {Nullable<HTMLDivElement>} The div element which has property contenteditable
    */
   getRTEEditableElementRef(): Nullable<HTMLDivElement>;
-  getSourceCode(): Nullable<string>;
   render(): VegaRichTextEditor;
   private renderRichTextEditor;
   private renderLabel;
@@ -57,6 +56,5 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   private renderCharacterCounter;
   private renderErrorMessage;
   private richTextContentFocus;
-  private renderSourceViewContent;
   private renderContent;
 }

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/vega-rich-text-editor-source-view-renderer.d.ts

@@ -0,0 +1,37 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { VegaRichTextEditor } from '../../vega-rich-text-editor';
+import { Nullable } from '../../../../types/general';
+/**
+ * The renderer for the source view of the rich text editor. It renders a code block for editing the source code of the rich text editor content.
+ */
+export declare class VegaRichTextEditorSourceViewRenderer extends VegaSlimmer {
+  host: VegaRichTextEditor['host'];
+  allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
+  sourceView: VegaRichTextEditor['sourceView'];
+  value: VegaRichTextEditor['value'];
+  disabled: VegaRichTextEditor['disabled'];
+  sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
+  sourceCodeChangeEventEmitter: VegaRichTextEditor['sourceCodeChangeEventEmitter'];
+  private sourceCodeBlockRef;
+  private prevRecord;
+  /**
+   * Clean up the code block blur observer when the component is disconnected to prevent memory leaks.
+   */
+  clearCodeBlockBlurObserver(): void;
+  /**
+   * Get the source code from the source view's code block.
+   *
+   * @returns {Nullable<string>} The source code, or null if the code block reference is not set.
+   */
+  getSourceCode(): Nullable<string>;
+  /**
+   * Render the source view, which is a code block for editing the source code of the rich text editor content.
+   *
+   * @returns {Nullable<HTMLElement>} The rendered source view element, or null if source editing is not allowed.
+   */
+  render(): Nullable<HTMLElement>;
+  /**
+   * Handle the blur event of the code block. When the code block loses focus, emit the source code change event with the current source code.
+   */
+  private handleCodeBlockBlur;
+}

package/dist/types/components/vega-rich-text-editor/vega-rich-text-editor.d.ts

@@ -44,6 +44,7 @@ import { InternalCodeBlockSelectionController } from './slimmers/controllers/int
 import { SourceEditToolbarButtonSlimmer } from './slimmers/renderers/tools/source-edit-toolbar-button-slimmer';
 import { VegaRTEExtension } from './extensions/extension.abstract';
 import { RTEExtensionController } from './slimmers/controllers/extension-controller';
+import { VegaRichTextEditorSourceViewRenderer } from './slimmers/renderers/vega-rich-text-editor-source-view-renderer';
 /**
  * @vegaVersion 2.34.0
  */
@@ -88,6 +89,8 @@ export declare class VegaRichTextEditor {
   protected readonly historyController: HistoryController;
   protected readonly internalCodeBlockSelectionController: InternalCodeBlockSelectionController;
   protected readonly rteExtensionController: RTEExtensionController;
+  protected readonly sourceCodeChangeEventEmitter: EventEmitSlimmerBase;
+  protected readonly richTextEditorSourceViewRenderer: VegaRichTextEditorSourceViewRenderer;
   host: HTMLVegaRichTextEditorElement;
   richTextContentEditable: boolean;
   watchRichTextContentEditable(): void;
@@ -222,6 +225,19 @@ export declare class VegaRichTextEditor {
    * @vegaVersion 2.34.0
    */
   imageInserted: EventEmitter<VegaRichTextEditorImage>;
+  /**
+   * An event emitter notifying a source code change event. It triggers when the editor loses focus in source edit mode.
+   *
+   * @vegaVersion 2.78.0
+   */
+  vegaSourceCodeChange: EventEmitter<string>;
+  /**
+   * An event emitter notifying a source code change event. It triggers when the editor loses focus in source edit mode.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.78.0
+   */
+  sourceCodeChange: EventEmitter<string>;
   componentWillLoad(): void;
   render(): VegaRichTextEditor;
 }

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

@@ -23,154 +23,236 @@ export declare class VegaTextarea {
   host: HTMLVegaTextareaElement;
   currentCharCount: number;
   /**
-   * Specifies a placeholder string that displays as a
-   *    temporary hint or example within the text area.
+   * Specifies a placeholder string that displays as a temporary hint or
+   * example within the text area. The placeholder text is shown when the
+   * field is empty and disappears once the user begins typing.
    *
-   * It indicates the expected format or pattern of
-   *    the input within the text area.
+   * Use this to indicate the expected format or content of the input,
+   * for example `'Enter your comments here...'`.
    *
+   * @default ''
    * @vegaVersion 1.11.0
    */
   placeholder: string;
   /**
-   * Provides a supplementary prompt message that assists users in
-   *    understanding the expected value within the text area.
+   * Provides a supplementary helper message displayed below the text area
+   * that assists users in understanding the expected value or format.
    *
+   * The hint is visible at all times (not just on focus) and is typically
+   * used for guidance such as character requirements or formatting rules.
+   *
+   * @default ''
    * @vegaVersion 1.11.0
    */
   hint: string;
   /**
-   * Specifies whether the text area is disabled.
+   * Specifies whether the text area is disabled. When `true`, the text area
+   * is non-interactive — the user cannot type, focus, or select the field.
+   * The disabled state is reflected as an HTML attribute for CSS styling.
    *
+   * @default false
    * @vegaVersion 1.11.0
    */
   disabled: boolean;
   /**
-   * Specifies the label or title for the text area.
+   * Specifies the visible label text rendered above the text area. The label
+   * helps identify the purpose or content expected within the field and also
+   * serves as the accessible `aria-label` for screen readers when present.
    *
-   * It provides descriptive text that helps identify the
-   *    purpose or content expected within the text area.
+   * Clicking the label will focus the text area.
    *
+   * @default ''
    * @vegaVersion 1.11.0
    */
   label: string;
   /**
-   * Specifies the properties for the suffix button associated with the input.
+   * Configuration object for an optional suffix button rendered beside the
+   * field label. Use this to provide an inline action (e.g., a help or info
+   * button) next to the label text.
    *
-   * It provides essential information and functionality
-   *  related to the suffix button's role and behavior.
+   * When the button is clicked, the `vegaLabelButtonClick` event is emitted.
+   * Set to `null` to hide the suffix button.
    *
+   * @default null
    * @vegaVersion 2.68.0
    */
   labelSuffixButtonConfig: Nullable<LabelSuffixButtonConfig>;
   /**
-   * Determines whether to display a character counter
-   *    for the textarea.
+   * Determines whether to display a live character counter below the text area.
+   *
+   * When `true`, the counter shows the current character count. If `maxLength`
+   * is also set, the counter displays in the format `current/max` and visually
+   * highlights when the limit is exceeded.
    *
+   * @default false
    * @vegaVersion 1.11.0
    */
   showCounter: boolean;
   /**
-   * Specifies the initial value or content of the
-   *    textarea field.
+   * The current value (content) of the text area field.
+   *
+   * This property is mutable and will be updated programmatically when the
+   * user types into the text area. It can also be set externally to
+   * pre-populate or reset the field. Changes to this property trigger the
+   * `vegaChange` event and update the character counter if `showCounter`
+   * is enabled. Supports two-way binding in framework wrappers.
    *
+   * @default ''
    * @vegaVersion 1.11.0
    */
   value: string;
   watchValue(value: string): void;
   /**
-   * Specifies the validation status of the
-   *    text area component.
+   * Reflects the current validation status of the text area.
    *
+   * - `true` — the field value passes all validation rules.
+   * - `false` — one or more validation rules have failed.
+   * - `null` — the field has not been validated yet (initial state).
+   *
+   * This property is mutable: it is updated automatically when
+   * `autoValidation` is enabled, but can also be set manually to override
+   * the validation state. The value is reflected as an HTML attribute.
+   *
+   * @default null
    * @vegaVersion 1.11.0
    */
   isValid: boolean;
   /**
-   * Determines whether automatic validation should be
-   *    implemented for the text area.
+   * Determines whether the text area should be validated automatically as the
+   * user types. When `true`, validation rules (including `required`, `minLength`,
+   * `maxLength`, and custom `validationRules`) are evaluated on blur and the
+   * `isValid` property is updated accordingly.
+   *
+   * Set to `false` to handle validation manually.
    *
+   * @default true
    * @vegaVersion 1.11.0
    */
   autoValidation: boolean;
   /**
-   * Determines whether the content of the textarea must be
-   *    provided by the user before submitting the form or
-   *    completing the input process.
+   * Determines whether the text area must have a non-empty value before the
+   * form can be submitted. When `true`, a required-field indicator is shown
+   * on the label and the built-in `RequiredFieldRule` is applied during
+   * validation.
    *
+   * @default false
    * @vegaVersion 1.11.0
    */
   required: boolean;
   /**
-   * Specifies the maximum number of characters (UTF-16 code units)
-   *    that the user can enter in the text area.
+   * Specifies the maximum number of characters (UTF-16 code units) that the
+   * user can enter in the text area. The native `maxlength` attribute is
+   * applied to the inner `<textarea>` element.
    *
+   * When `showCounter` is `true`, the maximum value is displayed alongside
+   * the current character count (e.g., `42/200`). Exceeding this limit
+   * triggers a visual warning on the counter and fails the
+   * `MaxStringLengthRule` during validation.
+   *
+   * Set to `null` to allow unlimited input.
+   *
+   * @default null
    * @vegaVersion 1.11.0
    */
   maxLength: number;
-  /** Specifies the minimum number of characters (UTF-16 code units)
-   *    that the user must enter in the text area.
+  /**
+   * Specifies the minimum number of characters (UTF-16 code units) that the
+   * user must enter in the text area for the value to be considered valid.
+   * The native `minlength` attribute is applied to the inner `<textarea>`
+   * element.
    *
+   * When set, the `MinStringLengthRule` is applied during validation. Set to
+   * `null` to impose no minimum length.
+   *
+   * @default null
    * @vegaVersion 1.11.0
    */
   minLength: number;
   /**
-   * Determines whether the text area is vertically resizable.
+   * Determines whether the user can vertically resize the text area by
+   * dragging its bottom-right corner. When `false`, the resize handle is
+   * hidden via CSS and the text area height is fixed.
    *
+   * @default true
    * @vegaVersion 2.19.0
    */
   resizable: boolean;
   /**
-   * Specifies the number of visible lines in the textarea. The value must be an integer greater than or equal to 2.
+   * Specifies the number of visible text lines in the text area, controlling
+   * its initial height. Accepts integers ≥ 2. For optimal display, values
+   * below 2 are internally adjusted to 4 rows.
    *
+   * @default 5
    * @vegaVersion 2.63.0
    */
   rows: number;
   /**
-   * Specifies custom validation rules for the text area.
+   * An array of custom validation rules applied to the text area in addition
+   * to the built-in rules (`RequiredFieldRule`, `MinStringLengthRule`,
+   * `MaxStringLengthRule`). Each rule must implement the
+   * `FormFieldValidationRule` interface.
+   *
+   * Rules are evaluated in order when `autoValidation` is enabled or when
+   * validation is triggered programmatically.
    *
+   * @default []
    * @vegaVersion 1.11.0
    */
   validationRules: FormFieldValidationRule<unknown>[];
   watchValidationRules(): void;
   /**
-   * An event emitter notifying about changes in the value
-   *    of the text area.
+   * Fired whenever the text area value changes, whether by user input or
+   * programmatic update of the `value` property. This is the primary event
+   * for reacting to content changes and implementing two-way binding.
    *
+   * @eventDetail string — The updated text area value.
    * @vegaVersion 1.11.0
    */
   vegaChange: EventEmitter<string>;
   /**
-   * An event emitter notifying about changes in the value
-   *    of the text area.
+   * Native-namespace mirror of `vegaChange`. Fired whenever the text area
+   * value changes. Provided for compatibility with standard DOM event
+   * listeners.
    *
+   * @eventDetail string — The updated text area value.
    * @eventSemantics namespace:native
    * @vegaVersion 2.0.0
    */
   change: EventEmitter<string>;
   /**
-   * An event emitter notifying the blur event of the inner
-   *    textarea element within the text area.
+   * Fired when the inner `<textarea>` element loses focus (blur). Use this
+   * event to trigger validation or save actions when the user leaves the
+   * text area.
    *
+   * @eventDetail undefined — No payload; signals the blur occurrence only.
    * @vegaVersion 1.11.0
    */
   vegaBlur: EventEmitter<undefined>;
   /**
-   * An event emitter notifying the blur event of the inner
-   *    textarea element within the text area.
+   * Native-namespace mirror of `vegaBlur`. Fired when the inner `<textarea>`
+   * element loses focus. Provided for compatibility with standard DOM event
+   * listeners.
    *
+   * @eventDetail undefined — No payload; signals the blur occurrence only.
    * @eventSemantics namespace:native
    * @vegaVersion 2.0.0
    */
   blur: EventEmitter<undefined>;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   * Fired when the suffix button configured via `labelSuffixButtonConfig` is
+   * clicked. Listen for this event to handle inline label actions such as
+   * opening a help dialog or toggling additional information.
    *
+   * @eventDetail void
    * @vegaVersion 2.68.0
    */
   vegaLabelButtonClick: EventEmitter;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   * Native-namespace mirror of `vegaLabelButtonClick`. Fired when the label
+   * suffix button is clicked. Provided for compatibility with standard DOM
+   * event listeners.
    *
+   * @eventDetail void
    * @eventSemantics namespace:native
    * @vegaVersion 2.68.0
    */