@heartlandone/vega-angular 2.77.1 → 2.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -946,59 +946,125 @@ export declare class VegaImageUploader {
946
946
  }
947
947
  export declare interface VegaInput extends Components.VegaInput {
948
948
  /**
949
- * An event emitter notifying a value change. @vegaVersion 1.0.10
949
+ * Emitted when the input value changes.
950
+
951
+ The timing of this event depends on the `valueUpdateTrigger` prop:
952
+ - When `valueUpdateTrigger` is `'input'` (default), fires on every keystroke.
953
+ - When `valueUpdateTrigger` is `'change'`, fires on blur or when the user presses Enter.
954
+
955
+ Also fires when the user clicks the clear icon or when the value is
956
+ programmatically updated. @eventDetail `string` — The current input value after the change.,@vegaVersion 1.0.10
950
957
  */
951
958
  vegaChange: EventEmitter<CustomEvent<string>>;
952
959
  /**
953
- * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.0.0
960
+ * Native-namespace alias for the `vegaChange` event.
961
+
962
+ Emitted at the same time and under the same conditions as `vegaChange`.
963
+ Use this event when integrating with frameworks that expect native-style
964
+ 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
954
965
  */
955
966
  change: EventEmitter<CustomEvent<string>>;
956
967
  /**
957
- * An event emitter notifying a value change by input action of native input dom. @vegaVersion 2.75.0
968
+ * Emitted on every native `input` event from the underlying `<input>` element,
969
+ regardless of the `valueUpdateTrigger` setting.
970
+
971
+ This event fires on every keystroke and provides the raw input value.
972
+ Use this for real-time monitoring (e.g., driving a suggestions dropdown)
973
+ 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
958
974
  */
959
975
  vegaNativeInputChange: EventEmitter<CustomEvent<string>>;
960
976
  /**
961
- * An event emitter notifying a value change by input action of native input dom. @eventSemantics namespace:native,@vegaVersion 2.75.0
977
+ * Native-namespace alias for the `vegaNativeInputChange` event.
978
+
979
+ Emitted at the same time and under the same conditions as
980
+ `vegaNativeInputChange`. Use this event when integrating with frameworks
981
+ that expect native-style event names. @eventDetail `string` — The raw value from the native input element.,@eventSemantics namespace:native,@vegaVersion 2.75.0
962
982
  */
963
983
  nativeInputChange: EventEmitter<CustomEvent<string>>;
964
984
  /**
965
- * An event emitter notifying the blur of the inner input element. @vegaVersion 1.3.0
985
+ * Emitted when the input field loses focus.
986
+
987
+ This event fires after the underlying native `<input>` element's `blur`
988
+ event. Useful for triggering validation, saving state, or updating UI
989
+ when the user navigates away from the field. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@vegaVersion 1.3.0
966
990
  */
967
991
  vegaBlur: EventEmitter<CustomEvent<undefined>>;
968
992
  /**
969
- * An event emitter notifying the blur of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.0.0
993
+ * Native-namespace alias for the `vegaBlur` event.
994
+
995
+ Emitted at the same time and under the same conditions as `vegaBlur`.
996
+ Use this event when integrating with frameworks that expect native-style
997
+ event names. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@eventSemantics namespace:native,@vegaVersion 2.0.0
970
998
  */
971
999
  blur: EventEmitter<CustomEvent<undefined>>;
972
1000
  /**
973
- * An event emitter notifying the focus of the inner input element. @vegaVersion 1.12.0
1001
+ * Emitted when the input field receives focus.
1002
+
1003
+ This event fires after the underlying native `<input>` element's `focus`
1004
+ event, including when focus is set programmatically via the `doFocus()` method.
1005
+ Useful for highlighting the field, showing contextual help, or opening
1006
+ a suggestions dropdown. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@vegaVersion 1.12.0
974
1007
  */
975
1008
  vegaFocus: EventEmitter<CustomEvent<undefined>>;
976
1009
  /**
977
- * An event emitter notifying the focus of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.0.0
1010
+ * Native-namespace alias for the `vegaFocus` event.
1011
+
1012
+ Emitted at the same time and under the same conditions as `vegaFocus`.
1013
+ Use this event when integrating with frameworks that expect native-style
1014
+ event names. @eventDetail `undefined` — No payload; listen for the event occurrence only.,@eventSemantics namespace:native,@vegaVersion 2.0.0
978
1015
  */
979
1016
  focus: EventEmitter<CustomEvent<undefined>>;
980
1017
  /**
981
- * An event emitter notifying that the suffix button associated with the field label has been clicked. @vegaVersion 2.25.0
1018
+ * Emitted when the user clicks the suffix button in the field label.
1019
+
1020
+ This event only fires when a `labelSuffixButtonConfig` (or the deprecated
1021
+ `labelSuffixButtonProps`) is provided. Use it to handle contextual actions
1022
+ such as opening a tooltip, navigating to a help page, or triggering a
1023
+ "Forgot password?" flow. @eventDetail `void` — No payload.,@vegaVersion 2.25.0
982
1024
  */
983
1025
  vegaLabelButtonClick: EventEmitter<CustomEvent<any>>;
984
1026
  /**
985
- * An event emitter notifying that the suffix button associated with the field label has been clicked. @eventSemantics namespace:native,@vegaVersion 2.25.0
1027
+ * Native-namespace alias for the `vegaLabelButtonClick` event.
1028
+
1029
+ Emitted at the same time and under the same conditions as
1030
+ `vegaLabelButtonClick`. Use this event when integrating with frameworks
1031
+ that expect native-style event names. @eventDetail `void` — No payload.,@eventSemantics namespace:native,@vegaVersion 2.25.0
986
1032
  */
987
1033
  labelButtonClick: EventEmitter<CustomEvent<any>>;
988
1034
  /**
989
- * An event emitter notifying the paste of the inner input element. @vegaVersion 2.66.0
1035
+ * Emitted when the user pastes content into the input field.
1036
+
1037
+ This event fires regardless of the `disableCopyPaste` setting — the paste
1038
+ action is blocked visually, but the event still propagates for tracking
1039
+ purposes. Use this to inspect or transform pasted data before it is applied. @eventDetail `DataTransferType` — An object containing the pasted data,
1040
+ including the MIME type and raw text content from the clipboard.,@vegaVersion 2.66.0
990
1041
  */
991
1042
  vegaPaste: EventEmitter<CustomEvent<IVegaInputDataTransferType>>;
992
1043
  /**
993
- * An event emitter notifying the paste of the inner input element. @eventSemantics namespace:native,@vegaVersion 2.66.0
1044
+ * Native-namespace alias for the `vegaPaste` event.
1045
+
1046
+ Emitted at the same time and under the same conditions as `vegaPaste`.
1047
+ Use this event when integrating with frameworks that expect native-style
1048
+ event names. @eventDetail `DataTransferType` — An object containing the pasted data,
1049
+ including the MIME type and raw text content from the clipboard.,@eventSemantics namespace:native,@vegaVersion 2.66.0
994
1050
  */
995
1051
  paste: EventEmitter<CustomEvent<IVegaInputDataTransferType>>;
996
1052
  /**
997
- * An event emitter notifying the click of a suggestion item. @vegaVersion 2.75.0
1053
+ * Emitted when the user selects an item from the suggestions dropdown.
1054
+
1055
+ This event only fires when the `suggestionsDropdownSource` prop is set.
1056
+ Use it to respond to the user's selection — for example, to populate
1057
+ related fields, navigate to a detail page, or trigger a search. @eventDetail `VegaDropdownSourceItem` — The full data object of the selected
1058
+ suggestion item, including its `label`, `value`, and any custom properties.,@vegaVersion 2.75.0
998
1059
  */
999
1060
  vegaSuggestionItemClick: EventEmitter<CustomEvent<IVegaInputVegaDropdownSourceItem>>;
1000
1061
  /**
1001
- * An event emitter notifying the click of a suggestion item. @eventSemantics namespace:native,@vegaVersion 2.75.0
1062
+ * Native-namespace alias for the `vegaSuggestionItemClick` event.
1063
+
1064
+ Emitted at the same time and under the same conditions as
1065
+ `vegaSuggestionItemClick`. Use this event when integrating with frameworks
1066
+ that expect native-style event names. @eventDetail `VegaDropdownSourceItem` — The full data object of the selected
1067
+ suggestion item, including its `label`, `value`, and any custom properties.,@eventSemantics namespace:native,@vegaVersion 2.75.0
1002
1068
  */
1003
1069
  suggestionItemClick: EventEmitter<CustomEvent<IVegaInputVegaDropdownSourceItem>>;
1004
1070
  }
@@ -1044,11 +1110,17 @@ export declare class VegaInputCreditCard {
1044
1110
  }
1045
1111
  export declare interface VegaInputNumeric extends Components.VegaInputNumeric {
1046
1112
  /**
1047
- * An event emitter notifying a value change. @vegaVersion 2.29.0
1113
+ * Fires whenever the numeric input's value changes including typing,
1114
+ keyboard increment/decrement, clearing, and programmatic updates.
1115
+
1116
+ The event detail contains the new numeric value (`number`), or `NaN`
1117
+ when the field is empty. @eventDetail number,@vegaVersion 2.29.0
1048
1118
  */
1049
1119
  vegaChange: EventEmitter<CustomEvent<number>>;
1050
1120
  /**
1051
- * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.29.0
1121
+ * Native-equivalent mirror of `vegaChange`. Fires with the same payload
1122
+ and at the same time, allowing consumers to listen using the standard
1123
+ `change` event name. @eventDetail number,@eventSemantics namespace:native,@vegaVersion 2.29.0
1052
1124
  */
1053
1125
  change: EventEmitter<CustomEvent<number>>;
1054
1126
  }
@@ -1061,23 +1133,28 @@ export declare class VegaInputNumeric {
1061
1133
  }
1062
1134
  export declare interface VegaInputPasscode extends Components.VegaInputPasscode {
1063
1135
  /**
1064
- * An event emitter notifying the change of the value in the input passcode,
1065
- whether triggered programmatically or through user interaction. @vegaVersion 2.66.0
1136
+ * Fires whenever the passcode value changes each time a character is
1137
+ entered, deleted, or pasted into any box. The event detail contains the
1138
+ concatenated string of all box values at the time of the change. @eventDetail string,@vegaVersion 2.66.0
1066
1139
  */
1067
1140
  vegaChange: EventEmitter<CustomEvent<string>>;
1068
1141
  /**
1069
- * An event emitter notifying the change of the value in the input passcode,
1070
- whether triggered programmatically or through user interaction. @eventSemantics namespace:native,@vegaVersion 2.66.0
1142
+ * Native-equivalent mirror of `vegaChange`. Fires with the same payload
1143
+ and at the same time, allowing consumers to listen using the standard
1144
+ `change` event name. @eventDetail string,@eventSemantics namespace:native,@vegaVersion 2.66.0
1071
1145
  */
1072
1146
  change: EventEmitter<CustomEvent<string>>;
1073
1147
  /**
1074
- * An event emitter notifying the completion of all input passcode boxes.
1075
- whether triggered programmatically or through user interaction. @vegaVersion 2.66.0
1148
+ * Fires when all passcode boxes have been filled (i.e., the value length
1149
+ equals the configured `length`). The event detail contains the complete
1150
+ passcode string. Useful for triggering auto-submit or verification
1151
+ workflows. @eventDetail string,@vegaVersion 2.66.0
1076
1152
  */
1077
1153
  vegaComplete: EventEmitter<CustomEvent<string>>;
1078
1154
  /**
1079
- * An event emitter notifying the completion of all input passcode boxes.
1080
- whether triggered programmatically or through user interaction. @eventSemantics namespace:native,@vegaVersion 2.66.0
1155
+ * Native-equivalent mirror of `vegaComplete`. Fires with the same payload
1156
+ and at the same time, allowing consumers to listen using the standard
1157
+ `complete` event name. @eventDetail string,@eventSemantics namespace:native,@vegaVersion 2.66.0
1081
1158
  */
1082
1159
  complete: EventEmitter<CustomEvent<string>>;
1083
1160
  }
@@ -1090,19 +1167,27 @@ export declare class VegaInputPasscode {
1090
1167
  }
1091
1168
  export declare interface VegaInputPhoneNumber extends Components.VegaInputPhoneNumber {
1092
1169
  /**
1093
- * An event emitter notifying a value change. @vegaVersion 2.18.0
1170
+ * Fires whenever the phone number value changes including typing,
1171
+ pasting, or programmatic updates. The event detail contains the full
1172
+ phone number in E.164 format (e.g., `'+14155552671'`). @eventDetail string,@vegaVersion 2.18.0
1094
1173
  */
1095
1174
  vegaChange: EventEmitter<CustomEvent<string>>;
1096
1175
  /**
1097
- * An event emitter notifying a value change. @eventSemantics namespace:native,@vegaVersion 2.18.0
1176
+ * Native-equivalent mirror of `vegaChange`. Fires with the same payload
1177
+ and at the same time, allowing consumers to listen using the standard
1178
+ `change` event name. @eventDetail string,@eventSemantics namespace:native,@vegaVersion 2.18.0
1098
1179
  */
1099
1180
  change: EventEmitter<CustomEvent<string>>;
1100
1181
  /**
1101
- * An event emitter notifying a country change. @vegaVersion 2.18.0
1182
+ * Fires whenever the selected country changes via the country dropdown.
1183
+ The event detail contains a `VegaCountryType` object with the country
1184
+ code, calling code, and display name of the newly selected country. @eventDetail VegaCountryType,@vegaVersion 2.18.0
1102
1185
  */
1103
1186
  vegaCountryChange: EventEmitter<CustomEvent<IVegaInputPhoneNumberVegaCountryType>>;
1104
1187
  /**
1105
- * An event emitter notifying a country change. @eventSemantics namespace:native,@vegaVersion 2.18.0
1188
+ * Native-equivalent mirror of `vegaCountryChange`. Fires with the same
1189
+ payload and at the same time, allowing consumers to listen using the
1190
+ standard `countryChange` event name. @eventDetail VegaCountryType,@eventSemantics namespace:native,@vegaVersion 2.18.0
1106
1191
  */
1107
1192
  countryChange: EventEmitter<CustomEvent<IVegaInputPhoneNumberVegaCountryType>>;
1108
1193
  }
@@ -1544,6 +1629,14 @@ export declare interface VegaRichTextEditor extends Components.VegaRichTextEdito
1544
1629
  * An event emitter notifying an image insertion event. @eventSemantics namespace:native,@vegaVersion 2.34.0
1545
1630
  */
1546
1631
  imageInserted: EventEmitter<CustomEvent<IVegaRichTextEditorVegaRichTextEditorImage>>;
1632
+ /**
1633
+ * An event emitter notifying a source code change event. It triggers when the editor loses focus in source edit mode. @vegaVersion 2.78.0
1634
+ */
1635
+ vegaSourceCodeChange: EventEmitter<CustomEvent<string>>;
1636
+ /**
1637
+ * 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
1638
+ */
1639
+ sourceCodeChange: EventEmitter<CustomEvent<string>>;
1547
1640
  }
1548
1641
  export declare class VegaRichTextEditor {
1549
1642
  protected z: NgZone;
@@ -2026,31 +2119,39 @@ export declare class VegaText {
2026
2119
  }
2027
2120
  export declare interface VegaTextarea extends Components.VegaTextarea {
2028
2121
  /**
2029
- * An event emitter notifying about changes in the value
2030
- of the text area. @vegaVersion 1.11.0
2122
+ * Fired whenever the text area value changes, whether by user input or
2123
+ programmatic update of the `value` property. This is the primary event
2124
+ for reacting to content changes and implementing two-way binding. @eventDetail string — The updated text area value.,@vegaVersion 1.11.0
2031
2125
  */
2032
2126
  vegaChange: EventEmitter<CustomEvent<string>>;
2033
2127
  /**
2034
- * An event emitter notifying about changes in the value
2035
- of the text area. @eventSemantics namespace:native,@vegaVersion 2.0.0
2128
+ * Native-namespace mirror of `vegaChange`. Fired whenever the text area
2129
+ value changes. Provided for compatibility with standard DOM event
2130
+ listeners. @eventDetail string — The updated text area value.,@eventSemantics namespace:native,@vegaVersion 2.0.0
2036
2131
  */
2037
2132
  change: EventEmitter<CustomEvent<string>>;
2038
2133
  /**
2039
- * An event emitter notifying the blur event of the inner
2040
- textarea element within the text area. @vegaVersion 1.11.0
2134
+ * Fired when the inner `<textarea>` element loses focus (blur). Use this
2135
+ event to trigger validation or save actions when the user leaves the
2136
+ text area. @eventDetail undefined — No payload; signals the blur occurrence only.,@vegaVersion 1.11.0
2041
2137
  */
2042
2138
  vegaBlur: EventEmitter<CustomEvent<undefined>>;
2043
2139
  /**
2044
- * An event emitter notifying the blur event of the inner
2045
- textarea element within the text area. @eventSemantics namespace:native,@vegaVersion 2.0.0
2140
+ * Native-namespace mirror of `vegaBlur`. Fired when the inner `<textarea>`
2141
+ element loses focus. Provided for compatibility with standard DOM event
2142
+ listeners. @eventDetail undefined — No payload; signals the blur occurrence only.,@eventSemantics namespace:native,@vegaVersion 2.0.0
2046
2143
  */
2047
2144
  blur: EventEmitter<CustomEvent<undefined>>;
2048
2145
  /**
2049
- * An event emitter notifying that the suffix button associated with the field label has been clicked. @vegaVersion 2.68.0
2146
+ * Fired when the suffix button configured via `labelSuffixButtonConfig` is
2147
+ clicked. Listen for this event to handle inline label actions such as
2148
+ opening a help dialog or toggling additional information. @eventDetail void,@vegaVersion 2.68.0
2050
2149
  */
2051
2150
  vegaLabelButtonClick: EventEmitter<CustomEvent<any>>;
2052
2151
  /**
2053
- * An event emitter notifying that the suffix button associated with the field label has been clicked. @eventSemantics namespace:native,@vegaVersion 2.68.0
2152
+ * Native-namespace mirror of `vegaLabelButtonClick`. Fired when the label
2153
+ suffix button is clicked. Provided for compatibility with standard DOM
2154
+ event listeners. @eventDetail void,@eventSemantics namespace:native,@vegaVersion 2.68.0
2054
2155
  */
2055
2156
  labelButtonClick: EventEmitter<CustomEvent<any>>;
2056
2157
  }
package/dist/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@heartlandone/vega-angular",
3
3
  "sideEffects": false,
4
- "version": "2.77.0",
4
+ "version": "2.77.1",
5
5
  "description": "Angular specific wrapper for @heartlandone/vega",
6
6
  "license": "UNLICENSED",
7
7
  "peerDependencies": {
@@ -19,7 +19,7 @@
19
19
  "url": "https://github.com/heartlandpayments/Vega/tree/main/vega-angular-workspace/projects/vega-angular"
20
20
  },
21
21
  "dependencies": {
22
- "@heartlandone/vega": "2.77.0",
22
+ "@heartlandone/vega": "2.77.1",
23
23
  "tslib": "^2.3.0",
24
24
  "@juggle/resize-observer": "^3.4.0"
25
25
  },
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@heartlandone/vega-angular",
3
3
  "sideEffects": false,
4
- "version": "2.77.1",
4
+ "version": "2.78.0",
5
5
  "description": "Angular specific wrapper for @heartlandone/vega",
6
6
  "license": "UNLICENSED",
7
7
  "peerDependencies": {
@@ -27,7 +27,7 @@
27
27
  "url": "https://github.com/heartlandpayments/Vega/tree/main/vega-angular-workspace/projects/vega-angular"
28
28
  },
29
29
  "dependencies": {
30
- "@heartlandone/vega": "2.77.1",
30
+ "@heartlandone/vega": "2.78.0",
31
31
  "tslib": "^2.3.0",
32
32
  "@juggle/resize-observer": "^3.4.0"
33
33
  },