@heartlandone/vega-angular 2.77.1 → 2.78.0

package/src/lib/stencil-generated/components.ts

@@ -1554,59 +1554,125 @@ import type { DataTransferType as IVegaInputDataTransferType } from '@heartlando
 import type { VegaDropdownSourceItem as IVegaInputVegaDropdownSourceItem } from '@heartlandone/vega/dist/types/components/vega-dropdown/types';
 export declare interface VegaInput extends Components.VegaInput {
   /**
-   * An event emitter notifying a value change. @vegaVersion 1.0.10
+   * Emitted when the input value changes.
+
+The timing of this event depends on the `valueUpdateTrigger` prop:
+- When `valueUpdateTrigger` is `'input'` (default), fires on every keystroke.
+- When `valueUpdateTrigger` is `'change'`, fires on blur or when the user presses Enter.
+
+Also fires when the user clicks the clear icon or when the value is
+programmatically updated. @eventDetail `string` — The current input value after the change.,@vegaVersion 1.0.10
    */
   vegaChange: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.0.0
+   * Native-namespace alias for the `vegaChange` event.
+
+Emitted at the same time and under the same conditions as `vegaChange`.
+Use this event when integrating with frameworks that expect native-style
+event names (e.g., `@change` in Vue or Angular). @eventDetail `string` — The current input value after the change.,@eventSemantics namespace:native,@vegaVersion 2.0.0
    */
   change: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying a value change by input action of native input dom. @vegaVersion 2.75.0
+   * Emitted on every native `input` event from the underlying `<input>` element,
+regardless of the `valueUpdateTrigger` setting.
+
+This event fires on every keystroke and provides the raw input value.
+Use this for real-time monitoring (e.g., driving a suggestions dropdown)
+while keeping `vegaChange` set to `'change'` trigger for the main value binding. @eventDetail `string` — The raw value from the native input element.,@vegaVersion 2.75.0
    */
   vegaNativeInputChange: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying a value change by input action of native input dom. @eventSemantics namespace:native,@vegaVersion 2.75.0
+   * Native-namespace alias for the `vegaNativeInputChange` event.
+
+Emitted at the same time and under the same conditions as
+`vegaNativeInputChange`. Use this event when integrating with frameworks
+that expect native-style event names. @eventDetail `string` — The raw value from the native input element.,@eventSemantics namespace:native,@vegaVersion 2.75.0
    */
   nativeInputChange: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying the blur of the inner input element. @vegaVersion 1.3.0
+   * Emitted when the input field loses focus.
+
+This event fires after the underlying native `<input>` element's `blur`
+event. Useful for triggering validation, saving state, or updating UI
+when the user navigates away from the field. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@vegaVersion 1.3.0
    */
   vegaBlur: EventEmitter<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying the blur of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.0.0
+   * Native-namespace alias for the `vegaBlur` event.
+
+Emitted at the same time and under the same conditions as `vegaBlur`.
+Use this event when integrating with frameworks that expect native-style
+event names. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@eventSemantics namespace:native,@vegaVersion 2.0.0
    */
   blur: EventEmitter<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying the focus of the inner input element. @vegaVersion 1.12.0
+   * Emitted when the input field receives focus.
+
+This event fires after the underlying native `<input>` element's `focus`
+event, including when focus is set programmatically via the `doFocus()` method.
+Useful for highlighting the field, showing contextual help, or opening
+a suggestions dropdown. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@vegaVersion 1.12.0
    */
   vegaFocus: EventEmitter<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying the focus of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.0.0
+   * Native-namespace alias for the `vegaFocus` event.
+
+Emitted at the same time and under the same conditions as `vegaFocus`.
+Use this event when integrating with frameworks that expect native-style
+event names. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@eventSemantics namespace:native,@vegaVersion 2.0.0
    */
   focus: EventEmitter<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked. @vegaVersion 2.25.0
+   * Emitted when the user clicks the suffix button in the field label.
+
+This event only fires when a `labelSuffixButtonConfig` (or the deprecated
+`labelSuffixButtonProps`) is provided. Use it to handle contextual actions
+such as opening a tooltip, navigating to a help page, or triggering a
+"Forgot password?" flow. @eventDetail `void` — No payload.,@vegaVersion 2.25.0
    */
   vegaLabelButtonClick: EventEmitter<CustomEvent<any>>;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked. @eventSemantics namespace:native,@vegaVersion 2.25.0
+   * Native-namespace alias for the `vegaLabelButtonClick` event.
+
+Emitted at the same time and under the same conditions as
+`vegaLabelButtonClick`. Use this event when integrating with frameworks
+that expect native-style event names. @eventDetail `void` — No payload.,@eventSemantics namespace:native,@vegaVersion 2.25.0
    */
   labelButtonClick: EventEmitter<CustomEvent<any>>;
   /**
-   * An event emitter notifying the paste of the inner input element. @vegaVersion 2.66.0
+   * Emitted when the user pastes content into the input field.
+
+This event fires regardless of the `disableCopyPaste` setting — the paste
+action is blocked visually, but the event still propagates for tracking
+purposes. Use this to inspect or transform pasted data before it is applied. @eventDetail `DataTransferType` — An object containing the pasted data,
+including the MIME type and raw text content from the clipboard.,@vegaVersion 2.66.0
    */
   vegaPaste: EventEmitter<CustomEvent<IVegaInputDataTransferType>>;
   /**
-   * An event emitter notifying the paste of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.66.0
+   * Native-namespace alias for the `vegaPaste` event.
+
+Emitted at the same time and under the same conditions as `vegaPaste`.
+Use this event when integrating with frameworks that expect native-style
+event names. @eventDetail `DataTransferType` — An object containing the pasted data,
+including the MIME type and raw text content from the clipboard.,@eventSemantics namespace:native,@vegaVersion 2.66.0
    */
   paste: EventEmitter<CustomEvent<IVegaInputDataTransferType>>;
   /**
-   * An event emitter notifying the click of a suggestion item. @vegaVersion 2.75.0
+   * Emitted when the user selects an item from the suggestions dropdown.
+
+This event only fires when the `suggestionsDropdownSource` prop is set.
+Use it to respond to the user's selection — for example, to populate
+related fields, navigate to a detail page, or trigger a search. @eventDetail `VegaDropdownSourceItem` — The full data object of the selected
+suggestion item, including its `label`, `value`, and any custom properties.,@vegaVersion 2.75.0
    */
   vegaSuggestionItemClick: EventEmitter<CustomEvent<IVegaInputVegaDropdownSourceItem>>;
   /**
-   * An event emitter notifying the click of a suggestion item. @eventSemantics namespace:native,@vegaVersion 2.75.0
+   * Native-namespace alias for the `vegaSuggestionItemClick` event.
+
+Emitted at the same time and under the same conditions as
+`vegaSuggestionItemClick`. Use this event when integrating with frameworks
+that expect native-style event names. @eventDetail `VegaDropdownSourceItem` — The full data object of the selected
+suggestion item, including its `label`, `value`, and any custom properties.,@eventSemantics namespace:native,@vegaVersion 2.75.0
    */
   suggestionItemClick: EventEmitter<CustomEvent<IVegaInputVegaDropdownSourceItem>>;
 
@@ -1683,11 +1749,17 @@ export class VegaInputCreditCard {
 
 export declare interface VegaInputNumeric extends Components.VegaInputNumeric {
   /**
-   * An event emitter notifying a value change. @vegaVersion 2.29.0
+   * Fires whenever the numeric input's value changes — including typing,
+keyboard increment/decrement, clearing, and programmatic updates.
+
+The event detail contains the new numeric value (`number`), or `NaN`
+when the field is empty. @eventDetail number,@vegaVersion 2.29.0
    */
   vegaChange: EventEmitter<CustomEvent<number>>;
   /**
-   * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.29.0
+   * 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 number,@eventSemantics namespace:native,@vegaVersion 2.29.0
    */
   change: EventEmitter<CustomEvent<number>>;
 
@@ -1715,23 +1787,28 @@ export class VegaInputNumeric {
 
 export declare interface VegaInputPasscode extends Components.VegaInputPasscode {
   /**
-   * An event emitter notifying the change of the value in the input passcode,
-   whether triggered programmatically or through user interaction. @vegaVersion 2.66.0
+   * Fires whenever the passcode value changes — each time a character is
+entered, deleted, or pasted into any box. The event detail contains the
+concatenated string of all box values at the time of the change. @eventDetail string,@vegaVersion 2.66.0
    */
   vegaChange: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying the change of the value in the input passcode,
-   whether triggered programmatically or through user interaction. @eventSemantics namespace:native,@vegaVersion 2.66.0
+   * 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.66.0
    */
   change: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying the completion of all input passcode boxes.
-   whether triggered programmatically or through user interaction. @vegaVersion 2.66.0
+   * Fires when all passcode boxes have been filled (i.e., the value length
+equals the configured `length`). The event detail contains the complete
+passcode string. Useful for triggering auto-submit or verification
+workflows. @eventDetail string,@vegaVersion 2.66.0
    */
   vegaComplete: EventEmitter<CustomEvent<string>>;
   /**
-   * An event emitter notifying the completion of all input passcode boxes.
-   whether triggered programmatically or through user interaction. @eventSemantics namespace:native,@vegaVersion 2.66.0
+   * Native-equivalent mirror of `vegaComplete`. Fires with the same payload
+and at the same time, allowing consumers to listen using the standard
+`complete` event name. @eventDetail string,@eventSemantics namespace:native,@vegaVersion 2.66.0
    */
   complete: EventEmitter<CustomEvent<string>>;
 
@@ -1759,19 +1836,27 @@ export class VegaInputPasscode {
 import type { VegaCountryType as IVegaInputPhoneNumberVegaCountryType } from '@heartlandone/vega/dist/types/components/vega-input-phone-number/types';
 export declare interface VegaInputPhoneNumber extends Components.VegaInputPhoneNumber {
   /**
-   * An event emitter notifying a value change. @vegaVersion 2.18.0
+   * 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<CustomEvent<string>>;
   /**
-   * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.18.0
+   * 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<CustomEvent<string>>;
   /**
-   * An event emitter notifying a country change. @vegaVersion 2.18.0
+   * 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<CustomEvent<IVegaInputPhoneNumberVegaCountryType>>;
   /**
-   * An event emitter notifying a country change. @eventSemantics namespace:native,@vegaVersion 2.18.0
+   * 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
    */
   countryChange: EventEmitter<CustomEvent<IVegaInputPhoneNumberVegaCountryType>>;
 
@@ -2575,6 +2660,14 @@ export declare interface VegaRichTextEditor extends Components.VegaRichTextEdito
    * An event emitter notifying an image insertion event. @eventSemantics namespace:native,@vegaVersion 2.34.0
    */
   imageInserted: EventEmitter<CustomEvent<IVegaRichTextEditorVegaRichTextEditorImage>>;
+  /**
+   * 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<CustomEvent<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<CustomEvent<string>>;
 
 }
 
@@ -2593,7 +2686,7 @@ export class VegaRichTextEditor {
   constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
     c.detach();
     this.el = r.nativeElement;
-    proxyOutputs(this, this.el, ['vegaChange', 'change', 'vegaImageInserted', 'imageInserted']);
+    proxyOutputs(this, this.el, ['vegaChange', 'change', 'vegaImageInserted', 'imageInserted', 'vegaSourceCodeChange', 'sourceCodeChange']);
   }
 }
 
@@ -3481,31 +3574,39 @@ export class VegaText {
 
 export declare interface VegaTextarea extends Components.VegaTextarea {
   /**
-   * An event emitter notifying about changes in the value
-   of the text area. @vegaVersion 1.11.0
+   * 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<CustomEvent<string>>;
   /**
-   * An event emitter notifying about changes in the value
-   of the text area. @eventSemantics namespace:native,@vegaVersion 2.0.0
+   * 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<CustomEvent<string>>;
   /**
-   * An event emitter notifying the blur event of the inner
-   textarea element within the text area. @vegaVersion 1.11.0
+   * 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<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying the blur event of the inner
-   textarea element within the text area. @eventSemantics namespace:native,@vegaVersion 2.0.0
+   * 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<CustomEvent<undefined>>;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked. @vegaVersion 2.68.0
+   * 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<CustomEvent<any>>;
   /**
-   * An event emitter notifying that the suffix button associated with the field label has been clicked. @eventSemantics namespace:native,@vegaVersion 2.68.0
+   * 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
    */
   labelButtonClick: EventEmitter<CustomEvent<any>>;