@globalpayments/vega 2.96.0 → 2.98.0

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/helper/input-event-handler/keyboard-link-handler.d.ts

@@ -0,0 +1,111 @@
+import { BaseHandler } from './base-handler';
+/**
+ * Handles keyboard-based rich text link interactions (Escape close, Tab into the link popover, and
+ * the Command/Control+K open shortcut). Follows the input-event handler workflow so the keyboard
+ * link logic stays consistent with the other RTE handlers.
+ */
+export declare class KeyboardLinkHandler extends BaseHandler<KeyboardEvent> {
+  private activeLinkEditor;
+  private activeLinkWrapper;
+  private linkPopoverHideHandler;
+  private linkPopoverHideOwner;
+  /**
+   * Handles keyboard shortcuts for link popover open, close, and focus behavior.
+   *
+   * @param {KeyboardEvent} [event] - The keydown event fired from the editor.
+   */
+  handleEvent(event?: KeyboardEvent): void;
+  /**
+   * Releases any registered popover-hide listener when the owning controller is torn down.
+   */
+  dispose(): void;
+  /**
+   * Registers a one-time hide listener on the currently open link editor popover.
+   *
+   * @param {Nullable<HTMLElement>} linkEditor - Link editor that owns the popover.
+   * @param {EventListener} handler - Callback invoked when the popover hides.
+   */
+  private registerLinkPopoverHideHandler;
+  /**
+   * Executes the registered popover-hide callback and clears hide-listener state.
+   *
+   * @param {EventListener} handler - Registered callback for popover hide.
+   * @param {Event} event - Hide event payload.
+   */
+  private onLinkPopoverHide;
+  /**
+   * Removes the currently registered popover hide listener if present.
+   */
+  private unregisterLinkPopoverHideHandler;
+  /**
+   * Resolves the closest focused link wrapper from event target or current selection.
+   *
+   * @param {EventTarget | null} target - Event target from the keydown event.
+   * @returns {Nullable<HTMLElement>} Link wrapper element if found.
+   */
+  private getFocusedLinkWrapper;
+  /**
+   * Finds the link editor element inside a link wrapper.
+   *
+   * @typedef HTMLVegaRichTextLinkEditorElement - The type of the link editor element.
+   * @param {Nullable<HTMLElement>} linkWrapper - Wrapper that may contain the link editor component.
+   * @returns {Nullable<HTMLVegaRichTextLinkEditorElement>} Link editor if present.
+   */
+  private getLinkEditorFromWrapper;
+  /**
+   * Gets the popover element rendered by a link editor.
+   *
+   * @param {Nullable<HTMLElement>} linkEditor - Link editor owning the popover.
+   * @returns {Nullable<LinkEditorPopoverElement>} Popover element when available.
+   */
+  private getLinkEditorPopover;
+  /**
+   * Returns the popover content box associated with a link editor.
+   *
+   * @param {Nullable<HTMLElement>} linkEditor - Link editor owning the popover.
+   * @returns {Nullable<HTMLElement>} Popover content box element.
+   */
+  private getLinkEditorPopoverContentBox;
+  /**
+   * Clears active link editor state and restores focus to the provided wrapper.
+   *
+   * @param {Nullable<HTMLElement>} linkEditor - Link editor that has just hidden.
+   * @param {Nullable<HTMLElement>} [focusTarget] - Optional element to receive focus.
+   */
+  private handleLinkPopoverHide;
+  /**
+   * Focuses the first visible link action in the current link popover.
+   *
+   * @param {Nullable<HTMLElement>} [linkWrapper] - Optional focused link wrapper context.
+   * @returns {boolean} True when focus moved to an action button.
+   */
+  private focusVisibleLinkPopoverAction;
+  /**
+   * Prefers a scoped link-action popover and falls back to globally visible ones.
+   *
+   * @param {Document} ownerDocument - Document owning editor popovers.
+   * @param {Nullable<HTMLElement>} [linkEditor] - Optional scoped link editor.
+   * @returns {Nullable<HTMLElement>} Best popover content box to target.
+   */
+  private getPreferredLinkActionPopover;
+  /**
+   * Checks whether a popover represents the link action menu.
+   *
+   * @param {HTMLElement} popoverContentBox - Popover content box to inspect.
+   * @returns {boolean} True when both edit and unlink actions exist.
+   */
+  private isLinkActionPopover;
+  /**
+   * Gets the preferred focusable element from the first link action item.
+   *
+   * @param {HTMLElement} popoverContentBox - Link action popover content box.
+   * @returns {Nullable<HTMLElement>} Focusable anchor or button element.
+   */
+  private getFirstFocusableLinkActionButton;
+  /**
+   * Places the editor caret at the end of the link when the popover closes.
+   *
+   * @param {Nullable<HTMLElement>} linkWrapper - The link wrapper element containing link text nodes.
+   */
+  private placeLinkCaretAtEnd;
+}

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/user-input-controller.d.ts

@@ -15,6 +15,7 @@ export declare class UserInputController extends VegaSlimmer {
   private forwardDeleteContentHandler;
   private backwardDeleteContentHandler;
   private insertPasteHandler;
+  private keyboardLinkHandler;
   /**
    * Adds event listener to an editable HTML element to handle user input actions.
    */
@@ -23,6 +24,12 @@ export declare class UserInputController extends VegaSlimmer {
    * Removes event listener for user input actions from an editable HTML div element.
    */
   protected removeActionListener(): void;
+  /**
+   * Dispatches editor keydown events to the keyboard link handler using the shared handler workflow.
+   *
+   * @param {KeyboardEvent} event - The keydown event fired from the editor.
+   */
+  private handleKeyboardAction;
   /**
    * When a user performs an input action within the editable element, this function is triggered.
    *

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

@@ -16,7 +16,7 @@ import { LinkToolbarButtonSlimmer } from './slimmers/renderers/tools/link-toolba
 import { MoreIndentToolbarButtonSlimmer } from './slimmers/renderers/tools/more-indent-toolbar-button-slimmer';
 import { LessIndentToolbarButtonSlimmer } from './slimmers/renderers/tools/less-indent-toolbar-button-slimmer';
 import { ImageToolbarButtonSlimmer } from './slimmers/renderers/tools/image-toolbar-button-slimmer';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { TextColorToolbarButtonSlimmer } from './slimmers/renderers/tools/text-color-toolbar-button-slimmer';
@@ -47,6 +47,8 @@ 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';
 /**
+ * The rich text editor enables users to format text for a variety of publishers.
+ *
  * @vegaVersion 2.34.0
  */
 export declare class VegaRichTextEditor {
@@ -137,6 +139,14 @@ export declare class VegaRichTextEditor {
    * @vegaVersion 2.88.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Specifies a placeholder string that displays as a
    *    temporary hint or example within the rich text editor.

package/dist/types/components/vega-rich-text-editor/vega-rich-text-link-editor/slimmers/controllers/link-editor-controller.d.ts

@@ -0,0 +1,149 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { NotifyObserverPayload } from '../../../../../helpers/event-manager/slimmers/child-nodes-notify-observer-slimmer';
+import { VegaRichTextLinkEditor } from '../../vega-rich-text-link-editor';
+/**
+ * Coordinates link editor state, popover behavior, and submit actions.
+ */
+export declare class LinkEditorController extends VegaSlimmer {
+  protected host: VegaRichTextLinkEditor['host'];
+  protected status: VegaRichTextLinkEditor['status'];
+  protected record: VegaRichTextLinkEditor['record'];
+  protected changeEventEmitter: VegaRichTextLinkEditor['changeEventEmitter'];
+  protected resetStatusAfterHide: VegaRichTextLinkEditor['resetStatusAfterHide'];
+  protected target: VegaRichTextLinkEditor['target'];
+  protected renderer: VegaRichTextLinkEditor['renderer'];
+  protected linkTypeConfigController: VegaRichTextLinkEditor['linkTypeConfigController'];
+  protected linkEditorStateManager: VegaRichTextLinkEditor['linkEditorStateManager'];
+  private readonly linkUrlNormalizer;
+  private readonly linkTypeHandlers;
+  /** Initializes the popover target after the component loads. */
+  componentDidLoad(): void;
+  /** Notifies observers after each render cycle. */
+  componentDidRender(): void;
+  /** Focuses the URL input when the status changes to linkEdit. */
+  watchStatusChange(): void;
+  /** Invalidates link type cache and updates the popover target when the target changes. */
+  watchTargetChange(): void;
+  /**
+   * Prepares the editor state before the popover is shown.
+   *
+   * @returns {Promise<void>} Resolves when the popover show work completes.
+   * Resolves when the popover show work completes.
+   */
+  handlePopoverShow(): Promise<void>;
+  /**
+   * Clears form state after the popover hides.
+   *
+   * @returns {void} No return value.
+   */
+  handlePopoverHide(): void;
+  /**
+   * Switches the editor into link edit mode.
+   *
+   * @returns {void} No return value.
+   */
+  handleEditAction(): void;
+  /**
+   * Removes the current selection link and closes the popover.
+   *
+   * @returns {Promise<void>} Resolves when unlinking finishes.
+   */
+  handleUnlinkAction(): Promise<void>;
+  /**
+   * Updates submit state from URL input changes.
+   *
+   * @param {CustomEvent<string>} e - URL input change event.
+   * @returns {void} No return value.
+   */
+  handleUrlVegaChange(e: CustomEvent<string>): void;
+  /**
+   * Submits the current link when Enter is pressed or hides the popover when Escape is pressed.
+   *
+   * @param {KeyboardEvent} e - Key down event.
+   * @returns {void} No return value.
+   */
+  handleKeyDown(e: KeyboardEvent): void;
+  /**
+   * Switches the active form when the link type changes.
+   *
+   * @param {NotifyObserverPayload<string>} payload - Selected link type change payload.
+   * @returns {Promise<void>} Resolves when the link type switch completes.
+   */
+  handleLinkTypeChange(payload: NotifyObserverPayload<string>): Promise<void>;
+  /**
+   * Builds and emits the final link payload.
+   *
+   * @returns {Promise<void>} Resolves when the link submit flow completes.
+   */
+  submitLink(): Promise<void>;
+  /**
+   * Populates the edit form from the active record.
+   *
+   * @returns {Promise<void>} Resolves when the edit form is populated.
+   */
+  populateEditForm(): Promise<void>;
+  /**
+   * Updates the popover target via the remote invocation registry.
+   *
+   * @returns {void} No return value.
+   */
+  private updatePopoverTarget;
+  /**
+   * Preserves an unchanged mailto URL when the form edits are equivalent.
+   *
+   * @param {Record<string, string>} formValues - Current form values.
+   * @param {string} normalizedUrl - Normalized URL candidate.
+   * @returns {string} The preserved or normalized URL.
+   */
+  private preserveExistingMailtoUrlIfUnchanged;
+  /**
+   * Normalizes a URL using the currently selected link type protocol.
+   *
+   * @param {string} url - URL to normalize.
+   * @returns {string} The normalized URL.
+   */
+  private normalizeUrlByDefaultProtocol;
+  /**
+   * Parses a mailto URL into structured parts.
+   *
+   * @param {string} url - Mailto URL to parse.
+   * @returns {MailtoUrlParts} The parsed mailto parts.
+   */
+  private parseMailtoUrl;
+  /**
+   * Builds a mailto URL from the email form fields.
+   *
+   * @param {string} emailAddress - Email address value.
+   * @param {string} subject - Subject value.
+   * @param {string} body - Body value.
+   * @returns {string} The generated mailto URL.
+   */
+  private buildEmailLinkUrl;
+  /**
+   * Enables or disables submit based on the normalized URL value.
+   *
+   * @param {string} url - URL value to evaluate.
+   * @returns {void} No return value.
+   */
+  private updateSubmitDisabledState;
+  /**
+   * Restores cached form values after the next render.
+   *
+   * @param {Record<string, string>} savedValues - Link type-specific values to restore.
+   * @returns {Promise<void>} Resolves after restoring cached values.
+   */
+  private performFormRestore;
+  /**
+   * Keeps text input UI in sync as a fallback when form setValue timing misses visual update.
+   *
+   * @param {string} textValue - Text value to display.
+   * @returns {void} No return value.
+   */
+  private syncTextInputValue;
+  /**
+   * Waits for the host to finish rendering.
+   *
+   * @returns {Promise<unknown>} A promise that resolves after the host renders.
+   */
+  private waitForRender;
+}

package/dist/types/components/vega-rich-text-editor/vega-rich-text-link-editor/slimmers/controllers/link-editor-state-manager.d.ts

@@ -0,0 +1,84 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+/**
+ * Stores link editor state across popover interactions.
+ */
+export declare class LinkEditorStateManager extends VegaSlimmer {
+  private isSubmitDisabled;
+  private selectedLinkTypeKey;
+  private shouldResetStatusOnNextShow;
+  private formValuesByType;
+  private sharedTextValue;
+  /**
+   * Returns whether submit is currently disabled.
+   *
+   * @returns {boolean} True when submit is disabled.
+   */
+  getIsSubmitDisabled(): boolean;
+  /**
+   * Updates the submit disabled state.
+   *
+   * @param {boolean} isSubmitDisabled - Next disabled state.
+   * @returns {void} No return value.
+   */
+  setSubmitDisabled(isSubmitDisabled: boolean): void;
+  /**
+   * Returns the selected link type key.
+   *
+   * @returns {string} The selected link type key.
+   */
+  getSelectedLinkTypeKey(): string;
+  /**
+   * Updates the selected link type key.
+   *
+   * @param {string} selectedLinkTypeKey - Next link type key.
+   * @returns {void} No return value.
+   */
+  setSelectedLinkTypeKey(selectedLinkTypeKey: string): void;
+  /**
+   * Returns whether the status should reset on the next show.
+   *
+   * @returns {boolean} True when the next show should reset the status.
+   */
+  getShouldResetStatusOnNextShow(): boolean;
+  /**
+   * Updates whether the status should reset on the next show.
+   *
+   * @param {boolean} shouldResetStatusOnNextShow - Next reset flag.
+   * @returns {void} No return value.
+   */
+  setShouldResetStatusOnNextShow(shouldResetStatusOnNextShow: boolean): void;
+  /**
+   * Clears all cached form values.
+   *
+   * @returns {void} No return value.
+   */
+  clearFormValues(): void;
+  /**
+   * Returns the text value shared across link types.
+   *
+   * @returns {string} Shared text value.
+   */
+  getSharedTextValue(): string;
+  /**
+   * Updates the text value shared across link types.
+   *
+   * @param {string} textValue - Next shared text value.
+   * @returns {void} No return value.
+   */
+  setSharedTextValue(textValue: string): void;
+  /**
+   * Stores form values for a given link type key.
+   *
+   * @param {string} linkTypeKey - Link type cache key.
+   * @param {Record<string, string>} formValues - Form values to cache.
+   * @returns {void} No return value.
+   */
+  cacheFormValues(linkTypeKey: string, formValues: Record<string, string>): void;
+  /**
+   * Returns cached form values for a given link type key.
+   *
+   * @param {string} linkTypeKey - Link type cache key.
+   * @returns {Record<string, string> | undefined} The cached form values, if any.
+   */
+  getCachedFormValues(linkTypeKey: string): Record<string, string> | undefined;
+}

package/dist/types/components/vega-rich-text-editor/vega-rich-text-link-editor/slimmers/controllers/link-type-config-controller.d.ts

@@ -0,0 +1,82 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { TranslationSlimmer } from '../../../../../helpers/slimmers/translation';
+import { VegaRichTextLinkEditor } from '../../vega-rich-text-link-editor';
+import { VegaRTELinkExtensionConfig, VegaRTELinkType } from '../../../extensions/link/type';
+/**
+ * Resolves configured link types and their defaults.
+ */
+export declare class LinkTypeConfigController extends VegaSlimmer {
+  private static readonly SUPPORTED_LINK_TYPE_KEYS;
+  protected host: VegaRichTextLinkEditor['host'];
+  protected translationSlimmer: TranslationSlimmer<HTMLVegaRichTextLinkEditorElement>;
+  private configuredLinkTypesCache;
+  private readonly linkTypeHandlers;
+  /**
+   * Returns the configured link types, using a cache when available.
+   *
+   * @returns {VegaRTELinkType[]} The configured link types.
+   */
+  getConfiguredLinkTypes(): VegaRTELinkType[];
+  /**
+   * Clears the cached configured link types.
+   *
+   * @returns {void} No return value.
+   */
+  invalidateConfiguredLinkTypesCache(): void;
+  /**
+   * Resolves the initial link type key for the current record.
+   *
+   * @param {string} recordLinkType - Link type from the active record.
+   * @param {string} recordUrl - URL from the active record.
+   * @returns {string} The resolved initial link type key.
+   */
+  resolveInitialLinkTypeKey(recordLinkType?: string, recordUrl?: string): string;
+  /**
+   * Returns whether any configured link types are available.
+   *
+   * @returns {boolean} True when configured link types exist.
+   */
+  hasConfiguredLinkTypes(): boolean;
+  /**
+   * Returns the default protocol for a given link type key.
+   *
+   * @param {string} selectedLinkTypeKey - Selected link type key.
+   * @returns {string | undefined} The default protocol, if configured.
+   */
+  getDefaultProtocolForLinkType(selectedLinkTypeKey: string): string | undefined;
+  /**
+   * Returns the active link configuration for the current editor host.
+   *
+   * @returns {VegaRTELinkExtensionConfig} The active link configuration.
+   */
+  getLinkConfig(): VegaRTELinkExtensionConfig;
+  /**
+   * Normalizes configured link types and filters unsupported entries.
+   *
+   * @returns {VegaRTELinkType[]} The normalized configured link types.
+   */
+  resolveConfiguredLinkTypes(): VegaRTELinkType[];
+  /**
+   * Creates the default URL link type descriptor.
+   *
+   * @param {string} configDefaultProtocol - Default protocol from config.
+   * @returns {VegaRTELinkType} The default URL link type descriptor.
+   */
+  private createDefaultUrlLinkType;
+  /**
+   * Normalizes a supported link type while preserving its key.
+   *
+   * @param {VegaRTELinkType} item - Raw configured link type.
+   * @param {string} key - Normalized link type key.
+   * @param {string} configDefaultProtocol - Default protocol from config.
+   * @returns {VegaRTELinkType} The normalized link type descriptor.
+   */
+  private normalizeSupportedLinkType;
+  /**
+   * Returns the translated default label for a link type key.
+   *
+   * @param {string} key - Link type key.
+   * @returns {string} The translated label for the link type.
+   */
+  private getDefaultLinkTypeLabel;
+}

package/dist/types/components/vega-rich-text-editor/vega-rich-text-link-editor/slimmers/renderers/link-type-handler.d.ts

@@ -0,0 +1,33 @@
+import { MailtoUrlParts } from '../../../extensions/link/type';
+/**
+ * Dependencies injected into handler methods so that handlers stay pure
+ * and the renderer owns URL-building / parsing logic.
+ */
+export declare type LinkTypeHandlerDeps = {
+  normalizeUrl: (url: string) => string;
+  buildEmailUrl: (emailAddress: string, subject: string, body: string) => string;
+  parseMailtoUrl: (url: string) => MailtoUrlParts;
+};
+/**
+ * Describes all per-link-type behavior.
+ * To add a new link type (e.g. "tel"), implement this interface and add it to
+ * LINK_TYPE_HANDLERS — no changes to the renderer dispatch logic are needed.
+ */
+export interface LinkTypeHandler {
+  readonly key: string;
+  readonly defaultFallbackProtocol: string | undefined;
+  getRequiredValue(record: {
+    url?: string;
+  } | undefined, deps: Pick<LinkTypeHandlerDeps, 'parseMailtoUrl'>): string;
+  getTextValue(formValues: Record<string, string>): string;
+  getFallbackText(formValues: Record<string, string>): string;
+  buildFinalUrl(formValues: Record<string, string>, deps: Pick<LinkTypeHandlerDeps, 'normalizeUrl' | 'buildEmailUrl'>): string;
+  getInitialFormValues(record: {
+    text?: string;
+    url?: string;
+  } | undefined, deps: Pick<LinkTypeHandlerDeps, 'parseMailtoUrl' | 'normalizeUrl'>): Record<string, string>;
+}
+export declare const urlLinkTypeHandler: LinkTypeHandler;
+export declare const emailLinkTypeHandler: LinkTypeHandler;
+export declare const LINK_TYPE_HANDLERS: readonly LinkTypeHandler[];
+export declare const LINK_TYPE_HANDLER_MAP: ReadonlyMap<string, LinkTypeHandler>;

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

@@ -1,31 +1,38 @@
 import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../../../../types/general';
 import { VegaRichTextLinkEditor } from '../../vega-rich-text-link-editor';
 export declare class VegaRichTextLinkEditorRenderer extends VegaSlimmer {
   protected host: VegaRichTextLinkEditor['host'];
   protected status: VegaRichTextLinkEditor['status'];
-  protected record: VegaRichTextLinkEditor['record'];
-  protected changeEventEmitter: VegaRichTextLinkEditor['changeEventEmitter'];
-  protected resetStatusAfterHide: VegaRichTextLinkEditor['resetStatusAfterHide'];
   protected translationSlimmer: VegaRichTextLinkEditor['translationSlimmer'];
-  protected target: VegaRichTextLinkEditor['target'];
+  protected linkEditorController: VegaRichTextLinkEditor['linkEditorController'];
+  protected linkTypeConfigController: VegaRichTextLinkEditor['linkTypeConfigController'];
+  protected linkEditorStateManager: VegaRichTextLinkEditor['linkEditorStateManager'];
   private formRef;
   private popoverRef;
   private urlInputRef;
-  /**
-   * Component lifecycle - [componentDidLoad]{@link VegaRichTextLinkEditor.componentDidLoad}
-   */
-  componentDidLoad(): void;
-  /**
-   * Component lifecycle - [componentDidRender]{@link VegaRichTextLinkEditor.componentDidRender}
-   */
-  componentDidRender(): void;
-  watchStatusChange(): void;
-  watchTargetChange(): void;
+  private textInputRef;
   getPopoverRef(): HTMLVegaPopoverElement;
+  getFormRef(): Nullable<HTMLVegaFormElement>;
+  getUrlInputRef(): Nullable<HTMLVegaInputElement>;
+  getTextInputRef(): Nullable<HTMLVegaInputElement>;
   render(): HTMLElement;
   private renderLinkUnlinkContent;
   private renderLinkEditContent;
-  private handleKeyDown;
-  private updatePopoverTarget;
-  private normalizeUrlByDefaultProtocol;
+  private renderCurrentLinkTypeEditFields;
+  private renderTextInput;
+  private renderEmailLinkEditFields;
+  private renderUrlLinkEditFields;
+  private renderLinkTypeSelector;
+  private renderActionButtons;
+  private readonly handlePopoverRef;
+  private readonly handleButtonGroupRef;
+  private readonly handleFormRef;
+  private readonly handleUrlInputRef;
+  private readonly handleTextInputRef;
+  private readonly handleLinkFieldKeyDown;
+  private readonly handleUrlVegaChange;
+  private readonly handleLinkTypeSelectRef;
+  private readonly handleCancelButtonRef;
+  private readonly handleSubmitButtonRef;
 }

package/dist/types/components/vega-rich-text-editor/vega-rich-text-link-editor/slimmers/utils/link-url-normalizer.d.ts

@@ -0,0 +1,37 @@
+import { MailtoUrlParts } from '../../../extensions/link/type';
+/**
+ * Normalizes link URLs and mailto values for the link editor.
+ */
+export declare class LinkUrlNormalizer {
+  /**
+   * Normalizes a URL with the provided default protocol.
+   *
+   * @param {string} url - URL to normalize.
+   * @param {string} defaultProtocol - Default protocol to apply.
+   * @returns {string} The normalized URL.
+   */
+  normalizeUrlByDefaultProtocol(url: string, defaultProtocol?: string): string;
+  /**
+   * Parses a mailto URL into its structured parts.
+   *
+   * @param {string} url - Mailto URL to parse.
+   * @returns {MailtoUrlParts} The parsed mailto parts.
+   */
+  parseMailtoUrl(url: string): MailtoUrlParts;
+  /**
+   * Builds a mailto URL from the provided fields.
+   *
+   * @param {string} emailAddress - Email address value.
+   * @param {string} subject - Subject value.
+   * @param {string} body - Body value.
+   * @returns {string} The generated mailto URL.
+   */
+  buildEmailLinkUrl(emailAddress: string, subject: string, body: string): string;
+  /**
+   * Decodes a URI component without throwing on malformed input.
+   *
+   * @param {string} value - Encoded value.
+   * @returns {string} The decoded value.
+   */
+  private decodeURIComponentSafely;
+}

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

@@ -7,6 +7,10 @@ export type VegaRichTextLinkEditorStatus = 'editOrUnlinkSelection' | 'linkEdit';
  * Link record used by the link editor.
  */
 export type VegaRTELinkEditorRecord = {
+	/**
+	 * Optional selected link type key.
+	 */
+	linkType?: string;
 	/**
 	 * Link display text.
 	 */

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

@@ -2,6 +2,9 @@ import { EventEmitter } from '../../../stencil-public-runtime';
 import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaRichTextLinkEditorRenderer } from './slimmers/renderers/vega-rich-text-link-editor-renderer';
+import { LinkEditorController } from './slimmers/controllers/link-editor-controller';
+import { LinkTypeConfigController } from './slimmers/controllers/link-type-config-controller';
+import { LinkEditorStateManager } from './slimmers/controllers/link-editor-state-manager';
 import { EventEmitSlimmerBase } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaRichTextLinkEditorChangeDetail, VegaRichTextLinkEditorStatus, VegaRTELinkEditorRecord } from './types';
 import { TranslationSlimmer } from '../../../helpers/slimmers/translation';
@@ -16,6 +19,9 @@ export declare class VegaRichTextLinkEditor {
   protected translationSlimmer: TranslationSlimmer<HTMLVegaRichTextLinkEditorElement>;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaRichTextLinkEditorElement>;
   protected readonly renderer: VegaRichTextLinkEditorRenderer;
+  protected readonly linkEditorController: LinkEditorController;
+  protected readonly linkTypeConfigController: LinkTypeConfigController;
+  protected readonly linkEditorStateManager: LinkEditorStateManager;
   protected changeEventEmitter: EventEmitSlimmerBase;
   host: HTMLVegaRichTextLinkEditorElement;
   /**
@@ -62,5 +68,11 @@ export declare class VegaRichTextLinkEditor {
    * @vegaVersion 2.34.0
    */
   show(): Promise<void>;
+  /**
+   * Provide a method to hide the link editor popover
+   *
+   * @vegaVersion 2.97.0
+   */
+  hide(): Promise<void>;
   render(): VegaRichTextLinkEditor;
 }

package/dist/types/components/vega-section-title/vega-section-title.d.ts

@@ -6,6 +6,8 @@ import { VegaSectionTitleSizeType } from './types';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { A11yTreeSlimmer } from '../../helpers/slimmers/a11y-tree-slimmer';
 /**
+ * The Section Title component provides uniform styling when creating titles for sections on a page, with an optional icon and subtitle.
+ *
  * @vegaVersion 2.1.0
  */
 export declare class VegaSectionTitle {

package/dist/types/components/vega-segment-control/vega-segment-control.d.ts

@@ -9,6 +9,8 @@ import { VegaSegmentOverflowController } from './slimmers/controllers/vega-segme
 import { VegaSegmentRenderer } from './slimmers/renderers/vega-segment-renderer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Segment Control displays a set of mutually exclusive options, where only one option can be selected at a time.
+ *
  * @vegaVersion 2.3.0
  */
 export declare class VegaSegmentControl {