@globalpayments/vega 2.88.0 → 2.89.0

package/dist/types/components/vega-checkbox/vega-checkbox-group/vega-checkbox-group.d.ts

@@ -14,12 +14,15 @@ export declare class VegaCheckboxGroup {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected readonly formFieldController: FormFieldControllerSlimmer<string[]>;
   protected checkboxValueChangeObserver: ChildNodesNotifyObserverSlimmer<boolean>;
+  protected checkboxUserInteractionObserver: ChildNodesNotifyObserverSlimmer<boolean>;
   protected checkboxEventPrevent: ChildNodesEventPreventSlimmer;
   protected changeEventEmitter: EventEmitSlimmerBase;
+  protected userChangeEventEmitter: EventEmitSlimmerBase;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCheckboxGroupElement>;
   private vegaFlexElement;
   private inputContainerRef;
   private vegaCheckboxArray;
+  private userInteractionPending;
   host: HTMLVegaCheckboxGroupElement;
   /**
    * Specifies the label or title for the checkbox group.
@@ -36,7 +39,7 @@ export declare class VegaCheckboxGroup {
    * @vegaVersion 1.0.7
    */
   value: string[];
-  watchValue(): Promise<void>;
+  watchValue(newValue: string[], oldValue: string[]): Promise<void>;
   /**
    * Specifies all properties of a `vega-flex` component,
    *    accessible as an object.
@@ -96,6 +99,33 @@ export declare class VegaCheckboxGroup {
    * @vegaVersion 1.0.10
    */
   vegaChange: EventEmitter<string[]>;
+  /** An event emitter notifying changes in the value of the checkbox group
+   *    triggered exclusively by user interaction (mouse click or keyboard
+   *    activation) on a nested checkbox.
+   *
+   * Unlike `vegaChange`, this event does NOT fire when the `value` prop
+   *    is reassigned programmatically. Use this event when you want to
+   *    react only to real user input (e.g., analytics, derived
+   *    "select all" state).
+   *
+   * @remarks Calling `event.preventDefault()` is a no-op — it does not roll
+   *    back `value` nor suppress the paired `vegaChange` event.
+   *    `cancelable: true` is retained only for parity with `vegaChange`.
+   *
+   * @see{module:vega-checkbox-group-user-change}
+   * @see{module:vega-checkbox-group-user-change-programmatic}
+   * @see{module:vega-checkbox-group-user-change-no-double}
+   * @vegaVersion 2.89.0
+   */
+  vegaUserChange: EventEmitter<string[]>;
+  /** An event emitter notifying changes in the value
+   *    of any nested checkbox within the checkbox group,
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.89.0
+   */
+  userChange: EventEmitter<string[]>;
   /** An event emitter notifying changes in the value
    *    of any nested checkbox within the checkbox group,
    *    whether triggered programmatically or through
@@ -106,6 +136,16 @@ export declare class VegaCheckboxGroup {
    */
   change: EventEmitter<string[]>;
   componentDidLoad(): void;
+  /**
+   * Check the value prop to avoid unnecessary updates when the new value
+   * is element-wise equal to the old value (same elements, different array reference).
+   *
+   * @param {unknown} newValue - The new prop value.
+   * @param {unknown} oldValue - The old prop value.
+   * @param {string} name - The property name.
+   * @returns {boolean} Return false to skip the current update flow.
+   */
+  componentShouldUpdate(newValue: unknown, oldValue: unknown, name: string): boolean;
   /**
    * The below method is e2e-test covered in
    * @see{module:vega-checkbox-group-dark-change-background-color }

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

@@ -15,12 +15,15 @@ export declare class VegaCheckbox {
   protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   protected readonly formFieldController: FormFieldControllerSlimmer<boolean | string>;
   protected changeEventEmitter: EventEmitSlimmerBase;
+  protected userChangeEventEmitter: EventEmitSlimmerBase;
   protected dropdownEventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCheckboxElement>;
   private labelElement;
   private inputContainerRef;
   private inputRef;
   private groupDisabledObserver;
+  private labelClickPending;
+  private isUserInteraction;
   host: HTMLVegaCheckboxElement;
   /**
    * Indicates whether the parent checkbox group is disabled.
@@ -111,6 +114,34 @@ export declare class VegaCheckbox {
    * @vegaVersion 1.0.10
    */
   vegaChange: EventEmitter<string | boolean>;
+  /**
+   * An event emitter notifying changes in the value of the checkbox
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * Unlike `vegaChange`, this event does NOT fire when the `checked` or `value`
+   *    prop is reassigned programmatically. Use this event when you want to react
+   *    only to real user input (e.g., analytics, derived "select all" state).
+   *
+   * @remarks Calling `event.preventDefault()` is a no-op — it does not roll
+   *    back `checked`/`value` nor suppress the paired `vegaChange` event.
+   *    `cancelable: true` is retained only for parity with `vegaChange`.
+   *
+   * @see{module:vega-checkbox-user-change}
+   * @see{module:vega-checkbox-user-change-keyboard}
+   * @see{module:vega-checkbox-user-change-keyboard-enter}
+   * @see{module:vega-checkbox-user-change-programmatic}
+   * @see{module:vega-checkbox-user-change-containment}
+   * @vegaVersion 2.89.0
+   */
+  vegaUserChange: EventEmitter<string | boolean>;
+  /**
+   * An event emitter notifying changes in the value of the checkbox
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.89.0
+   */
+  userChange: EventEmitter<string | boolean>;
   /**
    * An event emitter notifying changes in the value of the checkbox,
    *    whether triggered programmatically or through user interaction.
@@ -121,6 +152,16 @@ export declare class VegaCheckbox {
   change: EventEmitter<string | boolean>;
   disconnectedCallback(): void;
   componentWillLoad(): void;
+  /**
+   * Prevents redundant updates when the checked prop is set
+   *    to the same value (e.g., from parent re-renders in React).
+   *
+   * @param {unknown} newValue - The new prop value.
+   * @param {unknown} oldValue - The old prop value.
+   * @param {string} name - The property name.
+   * @returns {boolean} Return false to skip the current update flow.
+   */
+  componentShouldUpdate(newValue: unknown, oldValue: unknown, name: string): boolean;
   componentDidRender(): void;
   /**
    * Invoke this method to set the value of the checkbox.
@@ -174,5 +215,24 @@ export declare class VegaCheckbox {
    * This function unregister a group disabled observer if it exists.
    */
   private unRegisterGroupDisabledObserver;
+  private onInputKeyDown;
+  /**
+   * Suppresses the duplicate `click` event that bubbles to the host when the
+   *    browser performs the label's default activation behavior. Clicking the
+   *    label area dispatches one click on the label (which bubbles to the
+   *    host), and the browser then synthesizes a second click on the wrapped
+   *    `<input>`, which also bubbles through the label to the host — causing
+   *    the consumer's `onClick` to fire twice.
+   *
+   * We tag the original label-area click with `labelClickPending = true` and,
+   *    when the synthetic input click bubbles back through the label, call
+   *    `stopPropagation()` to prevent the duplicate from leaving the host.
+   *    The input still toggles natively (no `preventDefault`), so `change`
+   *    fires once and `vegaChange` is emitted exactly once via the normal
+   *    `@Watch('checked')` path. This avoids the spurious same-value emission
+   *    that an optimistic local toggle would cause in React controlled
+   *    components, where the parent re-renders the same `checked` value.
+   */
+  private onLabelClick;
   private onSelectedIconClick;
 }

package/dist/types/components/vega-color-picker/vega-color-picker.d.ts

@@ -43,6 +43,16 @@ export declare class VegaColorPicker {
    * @vegaVersion 1.13.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * Specifies the label or title for the color picker.
    *

package/dist/types/components/vega-combo-box/slimmers/renderers/vega-combo-box-dropdown-renderer.d.ts

@@ -8,6 +8,7 @@ export declare class VegaComboBoxDropdownRenderer extends VegaSlimmer {
   private source;
   private disabled;
   private size;
+  private containerMaxHeight;
   private vegaDropdownProps;
   private label;
   private placeholder;

package/dist/types/components/vega-combo-box/vega-combo-box.d.ts

@@ -2,6 +2,8 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { DropdownSourceItem } from '../vega-dropdown/types';
 import { VegaComboBoxSize, VegaDropdownPropsForComboBox } from './types';
+import { MaxHeightType, ResponsiveType } from '../../types/ui.type';
+import { BreakpointsTokenType } from '../../types/design-token.type';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
@@ -13,6 +15,7 @@ import { VegaComboBoxRenderer } from './slimmers/renderers/vega-combo-box-render
 import { VegaComboBoxKeyboardController } from './slimmers/controllers/vega-combo-box-keyboard-controller';
 import { VegaComboBoxItemsSlotController } from './slimmers/controllers/vega-combo-box-items-slot-controller';
 import { VegaComboBoxSourceController } from './slimmers/controllers/vega-combo-box-source-controller';
+import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 /**
  * @vegaVersion 1.11.0
  */
@@ -24,6 +27,7 @@ export declare class VegaComboBox {
   protected sourceController: VegaComboBoxSourceController;
   protected renderer: VegaComboBoxRenderer;
   protected dropdownRenderer: VegaComboBoxDropdownRenderer;
+  protected readonly pageResizeSlimmer: PageResizeObserverSlimmer;
   protected readonly formFieldController: FormFieldControllerSlimmer<string[]>;
   protected changeEventEmit: EventEmitSlimmerBase;
   protected createEventEmit: EventEmitSlimmerBase;
@@ -31,6 +35,7 @@ export declare class VegaComboBox {
   protected dropdownEventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaComboBoxElement>;
   host: HTMLVegaComboBoxElement;
+  currentBreakpoint: BreakpointsTokenType;
   /**
    * Specifies the label or title for the combo box.
    *
@@ -122,6 +127,22 @@ export declare class VegaComboBox {
    * @vegaVersion 1.11.0
    */
   size: VegaComboBoxSize;
+  /**
+   * Specifies the maximum height of the combo box container,
+   *    including selected chips and input area.
+   *
+   * When set, vertical scrolling will be enabled once the
+   *    container content exceeds the configured height.
+   *
+   * Note: values smaller than the input minimum height (26px)
+   *    are floored to keep the input usable. Use
+   *    `vegaDropdownProps.maxHeight` to control the dropdown
+   *    menu height independently.
+   *
+   * @vegaVersion 2.89.0
+   */
+  containerMaxHeight: ResponsiveType<MaxHeightType>;
+  watchContainerMaxHeight(): void;
   /**
    * Specifies partial properties of the `vega-dropdown` component
    *    that are used to configure the dropdown menu

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-renderer.d.ts

@@ -6,6 +6,7 @@ export declare class VegaDatePickerRenderer extends VegaSlimmer {
   mode: VegaDatePicker['mode'];
   label: VegaDatePicker['label'];
   required: VegaDatePicker['required'];
+  optional: VegaDatePicker['optional'];
   readOnly: VegaDatePicker['readOnly'];
   autoValidation: VegaDatePicker['autoValidation'];
   host: VegaDatePicker['host'];

package/dist/types/components/vega-date-picker/vega-date-picker.d.ts

@@ -77,6 +77,16 @@ export declare class VegaDatePicker {
    * @vegaVersion 1.3.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * Specifies the validation status of the date picker component.
    *

package/dist/types/components/vega-field-label/slimmers/renderers/vega-field-label-label-announcement-renderer.d.ts

@@ -0,0 +1,21 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../../../types/general';
+export declare class VegaFieldLabelLabelAnnouncementRenderer extends VegaSlimmer {
+  private label;
+  private isFieldRequired;
+  private optional;
+  private disabled;
+  private translationSlimmer;
+  /**
+   * Render a label announcement.
+   *
+   * @returns {Nullable<HTMLElement>}
+   */
+  render(): Nullable<HTMLElement>;
+  /**
+   * Generate a screen-reader-friendly announcement string that concatenates the label text with the field's required/optional and disabled states.
+   *
+   * @returns {string} The generated announcement string.
+   */
+  private generateAnnouncement;
+}

package/dist/types/components/vega-field-label/vega-field-label.d.ts

@@ -6,6 +6,7 @@ import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from './types';
 import { VegaFieldLabelSuffixElementRenderer } from './slimmers/renderers/vega-field-label-suffix-element-renderer';
 import { Nullable } from '../../types/general';
 import { TranslationSlimmer } from '../../helpers/slimmers/translation/translation-slimmer';
+import { VegaFieldLabelLabelAnnouncementRenderer } from './slimmers/renderers/vega-field-label-label-announcement-renderer';
 /**
  * @vegaVersion 1.10.0
  */
@@ -15,6 +16,7 @@ export declare class VegaFieldLabel {
   protected suffixButtonClickEventEmitter: EventEmitSlimmerBase;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaFieldLabelElement>;
   protected suffixElementRenderer: VegaFieldLabelSuffixElementRenderer;
+  protected labelAnnouncementRenderer: VegaFieldLabelLabelAnnouncementRenderer;
   protected translationSlimmer: TranslationSlimmer<HTMLVegaFieldLabelElement>;
   host: HTMLVegaFieldLabelElement;
   /**

package/dist/types/components/vega-image-uploader/slimmers/renderers/vega-image-uploader-renderer.d.ts

@@ -12,6 +12,7 @@ export declare class VegaImageUploaderRenderer extends VegaSlimmer {
   status: VegaImageUploader['status'];
   label: VegaImageUploader['label'];
   required: VegaImageUploader['required'];
+  optional: VegaImageUploader['optional'];
   width: VegaImageUploader['width'];
   height: VegaImageUploader['height'];
   hint: VegaImageUploader['hint'];

package/dist/types/components/vega-image-uploader/vega-image-uploader.d.ts

@@ -102,6 +102,16 @@ export declare class VegaImageUploader {
    * @vegaVersion 1.14.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * Specifies the validation status.
    *

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

@@ -7,6 +7,7 @@ export declare class VegaInputNumericRenderer extends VegaSlimmer {
   private disabled;
   private placeholder;
   private label;
+  private optional;
   private hint;
   private required;
   private thousandComma;

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

@@ -165,6 +165,16 @@ export declare class VegaInputNumeric {
    * @vegaVersion 2.29.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * An array of custom validation rules applied to the numeric input in
    * addition to the built-in rules (`RequiredFieldRule`, `MinNumberRule`,

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

@@ -3,6 +3,7 @@ import { VegaInputRange } from '../../vega-input-range';
 /** The class VegaInputRangeRenderer is a TypeScript React component that renders an input range field with custom label, hint, and styling options. */
 export declare class VegaInputRangeRenderer extends VegaSlimmer {
   protected required: VegaInputRange['required'];
+  protected optional: VegaInputRange['optional'];
   protected disabled: VegaInputRange['disabled'];
   protected label: VegaInputRange['label'];
   protected hint: VegaInputRange['hint'];

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

@@ -95,6 +95,16 @@ export declare class VegaInputRange {
    * @vegaVersion 2.2.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * Indicates whether the current value in the field is considered valid
    *    based on the defined validation rules.

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

@@ -7,6 +7,7 @@ export declare class VegaInputSelectRenderer extends VegaSlimmer {
   private hint;
   private label;
   private required;
+  private optional;
   private labelSuffixButtonConfig;
   private labelButtonClickEventEmitter;
   private dropdownRenderer;

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

@@ -76,6 +76,16 @@ export declare class VegaInputSelect {
    * @vegaVersion 1.0.7
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.89.0
+   */
+  optional: boolean;
   /**
    * Allows customization of the text displayed within the
    *    select field when single or multiple items are selected.

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/action-handler-strategies/horizontal-line-block-insert-strategy.d.ts

@@ -0,0 +1,29 @@
+import type { RTEBlock } from '../../../dto/blocks/block.abstract';
+import { ActionHandleStrategy } from '../../../dto/action-handle-strategies/action-handle-strategy.abstract';
+import { InsertHorizontalLineBlockAction } from '../actions/insert-horizontal-line-block-action';
+/**
+ * Strategy to handle the insertion of a horizontal line block into the rich text editor.
+ * Follows the same pattern as BlockInsertImageIntoTextStrategy (before/after/split).
+ */
+export declare class InsertHorizontalLineBlockStrategy extends ActionHandleStrategy<InsertHorizontalLineBlockAction, RTEBlock> {
+  /**
+   * @inheritDoc
+   */
+  protected handleAction(action: InsertHorizontalLineBlockAction, target: RTEBlock): void;
+  /**
+   * Insert HR after target. If next sibling is focusable (has a text node), move cursor there;
+   * otherwise create an empty paragraph after HR.
+   *
+   * @param {InsertHorizontalLineBlockAction} action - The insert action whose `nextFocusNode` is updated.
+   * @param {RTEBlock} target - The block after which the HR is inserted.
+   * @param {RTEHorizontalLineBlock} hrBlock - The HR block to insert.
+   */
+  private insertAfterWithFocus;
+  /**
+   * Get the next sibling block of the given block.
+   *
+   * @param {RTEBlock} block - The current block.
+   * @returns {RTEBlock | undefined} The next sibling block, or undefined if none.
+   */
+  private getNextSiblingBlock;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/action-handler-strategies/hr-to-horizontal-line-block-strategy.d.ts

@@ -0,0 +1,35 @@
+import { RTEContentBlock, VegaRTETransformOptions } from '../../../interface';
+import { Nullable } from '../../../../../types/general';
+import { ElementToDTOStrategy } from '../../../slimmers/controllers/helper/element-to-dto-strategy/element-to-dto-strategy.abstract';
+/**
+ * Strategy to convert `<hr>` HTML elements into RTEHorizontalLineBlock instances.
+ */
+export declare class HrToHorizontalLineBlockStrategy extends ElementToDTOStrategy {
+  /**
+   * Determines if this strategy can handle the current element.
+   *
+   * @param {HTMLElement[]} elementsArray - Array of elements to process.
+   * @param {number} currentIndex - The current index in the array.
+   * @returns {number} The number of elements this strategy can handle (1 for `<hr>`, 0 otherwise).
+   */
+  canHandle(elementsArray: HTMLElement[], currentIndex: number): number;
+  /**
+   * Converts the `<hr>` element to an RTEHorizontalLineBlock.
+   * Uses `htmlElementToAnnotationGenerator` to extract annotations (handles refill + filter).
+   *
+   * @param {HTMLElement[]} elementsArray - Array of elements.
+   * @param {VegaRTETransformOptions} [options] - Transformation options.
+   * @returns {Nullable<RTEContentBlock>} The created horizontal line block.
+   */
+  handle(elementsArray: HTMLElement[], options?: VegaRTETransformOptions): Nullable<RTEContentBlock>;
+  /**
+   * @inheritDoc
+   */
+  appendChildBlocks(): void;
+  /**
+   * `<hr>` is a void element — no children to process.
+   *
+   * @returns {boolean} Always false.
+   */
+  shouldProceedToElementChildren(): boolean;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/actions/insert-horizontal-line-block-action.d.ts

@@ -0,0 +1,15 @@
+import { ModifyContentAction } from '../../../dto/actions/modify-content-action.abstract';
+import { RTENode } from '../../../dto/nodes/node.abstract';
+import { Nullable } from '../../../../../types/general';
+export declare const INSERT_HORIZONTAL_LINE_BLOCK: string;
+/**
+ * Action to insert a horizontal line block into the rich text editor.
+ * Carries cursor position info to support split-paragraph insertion (same pattern as InsertImageToBlockAction).
+ */
+export declare class InsertHorizontalLineBlockAction extends ModifyContentAction {
+  type: string;
+  nextFocusNode: Nullable<RTENode>;
+  splitPointNode: Nullable<RTENode>;
+  startOffsetOfNode: number;
+  constructor(splitPointNode?: Nullable<RTENode>, startOffsetOfNode?: number);
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/assets/horizontal-line.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../../../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/dto/horizontal-line-annotation.d.ts

@@ -0,0 +1,43 @@
+import { BlockAnnotation } from '../../../dto/annotations/block-annotation.abstract';
+import { AnnotationStyle, RTERenderContext } from '../../../interface';
+import { Nullable } from '../../../../../types/general';
+export declare enum RTEHorizontalLineExtensionAnnotationTypeEnum {
+  HORIZONTAL_LINE = "HORIZONTAL_LINE"
+}
+/**
+ * Horizontal line annotation.
+ * Mirrors {@link TextStyleAnnotation}: emits the HR default visual styles in
+ * standalone mode (source edit) and the corresponding class in normal mode.
+ * Only added to the block when `autoMatchFormat` is enabled.
+ */
+export declare class HorizontalLineAnnotation extends BlockAnnotation<RTEHorizontalLineExtensionAnnotationTypeEnum> {
+  readonly type: RTEHorizontalLineExtensionAnnotationTypeEnum;
+  /**
+   * Generate the map item for the annotation.
+   *
+   * @returns {[RTEHorizontalLineExtensionAnnotationTypeEnum.HORIZONTAL_LINE, HorizontalLineAnnotation]} Map item.
+   */
+  static from(): [RTEHorizontalLineExtensionAnnotationTypeEnum.HORIZONTAL_LINE, HorizontalLineAnnotation];
+  /**
+   * Get the default styles for the horizontal line element.
+   *
+   * @returns {AnnotationStyle} The default styles.
+   */
+  static getDefaultStyles(): AnnotationStyle;
+  /**
+   * @inheritDoc
+   */
+  toJSON(): Nullable<Record<string, unknown>>;
+  /**
+   * @inheritDoc
+   */
+  clone(): HorizontalLineAnnotation;
+  /**
+   * @inheritDoc
+   */
+  renderClass(options?: RTERenderContext): Nullable<string>;
+  /**
+   * @inheritDoc
+   */
+  renderStyle(options?: RTERenderContext): Nullable<AnnotationStyle>;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/dto/horizontal-line-block.d.ts

@@ -0,0 +1,53 @@
+import { VegaRTEBlockAnnotations, VegaRTECustomBlock, VegaRTETransformOptions } from '../../../interface';
+import { RTEBlock } from '../../../dto/blocks/block.abstract';
+import { VegaRTEContent } from '../../../dto/content-state';
+import { RTEHtmlBlock } from '../../../dto/blocks/html-block';
+import { RTEHorizontalLineNode } from './horizontal-line-node';
+import { RTENode } from '../../../dto/nodes/node.abstract';
+/**
+ * Horizontal line block — a block containing a single `<hr>` decorator node.
+ */
+export declare class RTEHorizontalLineBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEHorizontalLineNode> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
+  readonly type: string;
+  children: RTEHorizontalLineNode[];
+  parent: VegaRTEContent | RTEHtmlBlock;
+  constructor(id: string, options?: VegaRTETransformOptions);
+  /**
+   * Creates an RTEHorizontalLineBlock from a JSON representation.
+   *
+   * @param {VegaRTECustomBlock} block - The block JSON to convert.
+   * @param {VegaRTETransformOptions} [options] - Transformation options.
+   * @returns {RTEHorizontalLineBlock} The created block instance.
+   */
+  static from(block: VegaRTECustomBlock, options?: VegaRTETransformOptions): RTEHorizontalLineBlock;
+  /**
+   * Creates a new RTEHorizontalLineBlock with a child node.
+   *
+   * @param {VegaRTEBlockAnnotations} [annotations] - Optional annotations (e.g. customStyle overrides).
+   * @param {VegaRTETransformOptions} [options] - Transformation options.
+   * @returns {RTEHorizontalLineBlock} A new block instance.
+   */
+  static create(annotations?: VegaRTEBlockAnnotations, options?: VegaRTETransformOptions): RTEHorizontalLineBlock;
+  /**
+   * @inheritDoc
+   */
+  toJSON(): VegaRTECustomBlock;
+  /**
+   * @inheritDoc
+   */
+  toHtml(options?: VegaRTETransformOptions): string;
+  /**
+   * @inheritDoc
+   */
+  isNotEmpty(): boolean;
+  /**
+   * @inheritDoc
+   */
+  getLastNode(): RTENode;
+  /**
+   * @inheritDoc
+   */
+  clone(parent: VegaRTEContent | RTEHtmlBlock): RTEHorizontalLineBlock;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/dto/horizontal-line-node.d.ts

@@ -0,0 +1,26 @@
+import { RTEDecoratorNode } from '../../../dto/nodes/decorator-node';
+import { RTENodeAnnotationMapKey, RTENodeAnnotationMapValue } from '../../../interface';
+import type { RTEBlock } from '../../../dto/blocks/block.abstract';
+/**
+ * Horizontal line node — a decorator node representing `<hr>` in the editor.
+ */
+export declare class RTEHorizontalLineNode extends RTEDecoratorNode<RTEBlock> {
+  readonly type: string;
+  parent: RTEBlock;
+  constructor(id: string, parentBlock: RTEBlock, annotationMap?: Map<RTENodeAnnotationMapKey, RTENodeAnnotationMapValue>);
+  /**
+   * @inheritDoc
+   */
+  toJSON(): {
+    id: string;
+    type: string;
+  };
+  /**
+   * @inheritDoc
+   */
+  clone(parent: RTEBlock): RTEHorizontalLineNode;
+  /**
+   * @inheritDoc
+   */
+  toHtml(): string;
+}