@globalpayments/vega 2.87.0 → 2.89.0

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

@@ -0,0 +1,16 @@
+import { VegaRTEExtensionRenderer } from '../../base-extension-renderer';
+import { RTEHorizontalLineBlock } from '../dto/horizontal-line-block';
+import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../../interface';
+/**
+ * Renderer for horizontal line blocks in the rich text editor.
+ */
+export declare class RTEHorizontalLineBlockRenderer extends VegaRTEExtensionRenderer {
+  /**
+   * @inheritDoc
+   */
+  doRender(createElement: VegaRTECreateElementFunction, block: RTEHorizontalLineBlock, rteContext: RTERenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  injectRTEScopeStyles(): string;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/renderers/horizontal-line-toolbar-button-renderer.d.ts

@@ -0,0 +1,27 @@
+import { VegaRTEToolbarButtonRenderer } from '../../base-toolbar-button-renderer';
+import { VegaRTECreateElementFunction, VegaRTERenderResult, VegaRTEToolbarRenderContext } from '../../../interface';
+/**
+ * Toolbar button renderer for horizontal line insertion.
+ */
+export declare class RTEHorizontalLineToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
+  /**
+   * Renders the horizontal line toolbar button.
+   *
+   * @param {VegaRTECreateElementFunction} createElement - The function to create elements.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context.
+   * @returns {VegaRTERenderResult} The rendered toolbar button.
+   */
+  render(createElement: VegaRTECreateElementFunction, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
+  /**
+   * @inheritDoc
+   */
+  protected handleButtonClick(editorContext: VegaRTEToolbarRenderContext): void;
+  /**
+   * @inheritDoc
+   */
+  protected handleDropdownClick(): void;
+}

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

@@ -0,0 +1,18 @@
+import { ActionHandleStrategy } from '../../../dto/action-handle-strategies/action-handle-strategy.abstract';
+import type { RTEBlock } from '../../../dto/blocks/block.abstract';
+import { LineHeightAnnotationAction } from '../actions/line-height-annotation-action';
+/**
+ * Update the block line height strategy.
+ *
+ * Registered for RTETextBlock and RTEListItemBlock, so the
+ * target type is widened to the common RTEBlock base.
+ */
+export declare class BlockUpdateLineHeightStrategy extends ActionHandleStrategy<LineHeightAnnotationAction, RTEBlock> {
+  /**
+   * Updating the line height of a block requires cascading updates to the custom style.
+   *
+   * @param {LineHeightAnnotationAction} _action - The line height annotation action.
+   * @param {RTEBlock} target - The current block.
+   */
+  protected handleAction(_action: LineHeightAnnotationAction, target: RTEBlock): void;
+}

package/dist/types/components/vega-rich-text-editor/extensions/line-height/actions/line-height-annotation-action.d.ts

@@ -0,0 +1,16 @@
+import { AnnotationAction } from '../../../dto/actions/annotation-action.abstract';
+import { LineHeightAnnotation } from '../annotations/line-height-annotation';
+/**
+ * Action to update block line height annotation.
+ */
+export declare class LineHeightAnnotationAction extends AnnotationAction {
+  isFlushable: boolean;
+  lineHeight: string;
+  constructor(lineHeight: string);
+  /**
+   * Converts the action to an annotation.
+   *
+   * @returns {LineHeightAnnotation} The annotation.
+   */
+  toAnnotation(): LineHeightAnnotation;
+}

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

@@ -0,0 +1,46 @@
+import { BlockAnnotation } from '../../../dto/annotations/block-annotation.abstract';
+import { AnnotationStyle } from '../../../interface';
+import { Nullable } from '../../../../../types/general';
+export declare enum RTELineHeightExtensionAnnotationTypeEnum {
+  LINE_HEIGHT = "LINE_HEIGHT"
+}
+/**
+ * Annotation to set block line height.
+ */
+export declare class LineHeightAnnotation extends BlockAnnotation<RTELineHeightExtensionAnnotationTypeEnum.LINE_HEIGHT> {
+  readonly type: RTELineHeightExtensionAnnotationTypeEnum.LINE_HEIGHT;
+  lineHeight: string;
+  constructor(lineHeight: string);
+  /**
+   * Generate the map item for the annotation.
+   *
+   * @param {string} lineHeight - Line height value.
+   * @returns {[RTELineHeightExtensionAnnotationTypeEnum.LINE_HEIGHT, LineHeightAnnotation]} Map item for the annotation.
+   */
+  static from(lineHeight: string): [RTELineHeightExtensionAnnotationTypeEnum.LINE_HEIGHT, LineHeightAnnotation];
+  /**
+   * Get the default standalone styles for a given line height value.
+   *
+   * @param {string} lineHeight - The line height value.
+   * @returns {AnnotationStyle} The default standalone styles.
+   */
+  static getDefaultStyles(lineHeight: string): AnnotationStyle;
+  /**
+   * Generate the JSON item of the annotation.
+   *
+   * @returns {Record<string, unknown>} JSON representation of the annotation.
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * @inheritDoc
+   */
+  renderClass(): Nullable<string>;
+  /**
+   * @inheritDoc
+   */
+  clone(): LineHeightAnnotation;
+  /**
+   * @inheritDoc
+   */
+  renderStyle(): Nullable<AnnotationStyle>;
+}

package/dist/types/components/vega-rich-text-editor/extensions/line-height/assets/line-height.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/line-height/constants.d.ts

@@ -0,0 +1,6 @@
+import { VegaRTELineHeightOption } from '../type';
+/**
+ * Default line height options used by the line-height extension when no
+ * custom options are provided.
+ */
+export declare const VegaRTEDefaultLineHeightOptions: VegaRTELineHeightOption[];

package/dist/types/components/vega-rich-text-editor/extensions/line-height/element-to-dto-strategies/line-height-annotation-handler.d.ts

@@ -0,0 +1,23 @@
+import { VegaRTEBlockAnnotations } from '../../../interface';
+import { AnnotationGeneratorStrategyAbstract } from '../../../slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/annotation-generator-strategy.abstract';
+import { RTEDtoClassPrototype } from '../../../slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/html-element-to-annotation-generator';
+import { VegaRTELineHeightOption } from '../../type';
+/** Handle line height annotation. */
+export declare class LineHeightAnnotationHandler extends AnnotationGeneratorStrategyAbstract {
+  private readonly allowedLineHeights;
+  constructor(options?: VegaRTELineHeightOption[]);
+  /**
+   * Can be handled.
+   *
+   * @param {RTEDtoClassPrototype} targetDto - Target DTO.
+   * @returns {boolean} Whether the target DTO supports line-height annotations.
+   */
+  canHandle<T extends RTEDtoClassPrototype>(targetDto: T): boolean;
+  /**
+   * Extract inline `line-height` as a semantic `lineHeight` annotation.
+   *
+   * @param {HTMLElement} [element] - Current element.
+   * @returns {VegaRTEBlockAnnotations} `{ lineHeight }` when present, otherwise `{}`.
+   */
+  handle(element?: HTMLElement): VegaRTEBlockAnnotations;
+}

package/dist/types/components/vega-rich-text-editor/extensions/line-height/element-to-dto-strategies/line-height-filter-styles-strategy.d.ts

@@ -0,0 +1,26 @@
+import { VegaRTEAnnotations } from '../../../interface';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../../../dto/filter-styles-strategies/filter-styles-strategy.abstract';
+/**
+ * Removes a redundant inline `customStyle.lineHeight` when it duplicates the
+ * semantic `lineHeight` annotation during HTML-to-DTO conversion.
+ *
+ * Note: moving out-of-list line-height values from the semantic annotation to
+ * `customStyle.lineHeight` is handled by the per-host interceptor in
+ * `line-height-host-interceptor.ts`, not here.
+ */
+export declare class LineHeightFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * Always run this strategy, even when autoMatchFormat is disabled.
+   *
+   * @returns {boolean} Always true.
+   */
+  get alwaysFilter(): boolean;
+  /**
+   * Drop `customStyle.lineHeight` when it duplicates the semantic `lineHeight`.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations to filter.
+   * @returns {VegaRTEAnnotations} The same annotations reference.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
+}

package/dist/types/components/vega-rich-text-editor/extensions/line-height/element-to-dto-strategies/line-height-from-json-handler.d.ts

@@ -0,0 +1,17 @@
+import { VegaRTELineHeightOption } from '../../type';
+import { RTETextBlock } from '../../../dto/blocks/text-block';
+import { RTEListItemBlock } from '../../../dto/blocks/list-item-block';
+export declare type LineHeightBlockClass = typeof RTETextBlock | typeof RTEListItemBlock;
+/**
+ * Install the JSON `lineHeight` annotation handler for a block class.
+ *
+ * @param {LineHeightBlockClass} BlockClass - Target block class.
+ */
+export declare function attachLineHeightFromJson(BlockClass: LineHeightBlockClass): void;
+/**
+ * Update the set of allowed line-height values for a block class.
+ *
+ * @param {LineHeightBlockClass} BlockClass - Target block class.
+ * @param {VegaRTELineHeightOption[]} options - Allowed line-height options.
+ */
+export declare function setAllowedLineHeights(BlockClass: LineHeightBlockClass, options: VegaRTELineHeightOption[]): void;

package/dist/types/components/vega-rich-text-editor/extensions/line-height/line-height-extension.d.ts

@@ -0,0 +1,19 @@
+import { VegaRTELineHeightOption } from '../type';
+import { VegaRTEExtension } from '../extension.abstract';
+/**
+ * Rich Text Editor extension that adds configurable line-height support
+ * (toolbar control, annotations, content transforms, and JSON parsing).
+ */
+export declare class VegaRTELineHeightExtension extends VegaRTEExtension {
+  private readonly options;
+  private toolbarButtonRenderer;
+  constructor(options?: VegaRTELineHeightOption[]);
+  /**
+   * Register the per-host toolbar renderer so each editor on the page gets
+   * its own isolated line-height renderer instance.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type of the host rich text editor element.
+   * @param {HTMLVegaRichTextEditorElement} host - The host element.
+   */
+  prepareBeforeLoad(host: HTMLVegaRichTextEditorElement): void;
+}

package/dist/types/components/vega-rich-text-editor/extensions/line-height/line-height-toolbar-button-renderer.d.ts

@@ -0,0 +1,44 @@
+import { VegaRTELineHeightOption } from '../type';
+import { VegaRTECreateElementFunction, VegaRTERenderResult, VegaRTEToolbarRenderContext } from '../../interface';
+import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
+/**
+ * Renderer for the line-height toolbar button in the Vega Rich Text Editor.
+ */
+export declare class RTELineHeightToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
+  private readonly options;
+  constructor(options: VegaRTELineHeightOption[]);
+  /**
+   * @inheritDoc
+   */
+  render(createElement: VegaRTECreateElementFunction, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  protected isSelected(): boolean;
+  /**
+   * @inheritDoc
+   */
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
+  /**
+   * @inheritDoc
+   */
+  protected handleDropdownClick(itemValue: string, editorContext: VegaRTEToolbarRenderContext): void;
+  /**
+   * Handle direct toolbar button click.
+   */
+  protected handleButtonClick(): void;
+  /**
+   * Get the selected line-height key for dropdown selection state.
+   *
+   * @param {VegaRTEToolbarRenderContext} editorContext - Current toolbar context.
+   * @returns {string} Selected line-height key or empty string for mixed/none.
+   */
+  private getSelectedSourceValue;
+  /**
+   * Resolve selected blocks from selected nodes with range fallback.
+   *
+   * @param {VegaRTEToolbarRenderContext} editorContext - Current toolbar context.
+   * @returns {RTEBlock[]} Selected blocks.
+   */
+  private getSelectedBlocks;
+}

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/arrow-characters.d.ts

@@ -0,0 +1,2 @@
+import { VegaRTESpecialCharacterItem } from '../types';
+export declare const ARROW_CHARACTERS: VegaRTESpecialCharacterItem[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/currency-characters.d.ts

@@ -0,0 +1,2 @@
+import { VegaRTESpecialCharacterItem } from '../types';
+export declare const CURRENCY_CHARACTERS: VegaRTESpecialCharacterItem[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/default-categories.d.ts

@@ -0,0 +1,7 @@
+import { VegaRTESpecialCharacterCategory } from '../types';
+export declare const VegaRTESpecialCharactersLatin: VegaRTESpecialCharacterCategory;
+export declare const VegaRTESpecialCharactersMathematical: VegaRTESpecialCharacterCategory;
+export declare const VegaRTESpecialCharactersArrows: VegaRTESpecialCharacterCategory;
+export declare const VegaRTESpecialCharactersCurrency: VegaRTESpecialCharacterCategory;
+export declare const VegaRTESpecialCharactersText: VegaRTESpecialCharacterCategory;
+export declare const VegaRTESpecialCharactersEssentials: VegaRTESpecialCharacterCategory[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/latin-characters.d.ts

@@ -0,0 +1,2 @@
+import { VegaRTESpecialCharacterItem } from '../types';
+export declare const LATIN_CHARACTERS: VegaRTESpecialCharacterItem[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/mathematical-characters.d.ts

@@ -0,0 +1,2 @@
+import { VegaRTESpecialCharacterItem } from '../types';
+export declare const MATHEMATICAL_CHARACTERS: VegaRTESpecialCharacterItem[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/constants/text-characters.d.ts

@@ -0,0 +1,2 @@
+import { VegaRTESpecialCharacterItem } from '../types';
+export declare const TEXT_CHARACTERS: VegaRTESpecialCharacterItem[];

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/special-characters-extension.d.ts

@@ -0,0 +1,20 @@
+import { VegaRTEExtension } from '../extension.abstract';
+import { VegaRTESpecialCharactersConfig } from './types';
+/**
+ * Vega Rich Text Editor Special Characters Extension.
+ * Adds a toolbar button that opens a popover with categorized Unicode characters
+ * for insertion into the editor content as plain text.
+ */
+export declare class VegaRTESpecialCharactersExtension extends VegaRTEExtension {
+  private categories;
+  constructor(config?: VegaRTESpecialCharactersConfig);
+  /** @inheritDoc */
+  prepareBeforeLoad(host: HTMLVegaRichTextEditorElement): void;
+  /**
+   * Builds the final list of special character categories from the provided config.
+   *
+   * @param {VegaRTESpecialCharactersConfig} config - Optional configuration with custom categories.
+   * @returns {VegaRTESpecialCharacterCategory[]} - The merged categories array.
+   */
+  private buildCategories;
+}

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/special-characters-icon.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/special-characters/special-characters-toolbar-button-renderer.d.ts

@@ -0,0 +1,83 @@
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult } from '../../interface';
+import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
+import { VegaRTESpecialCharacterCategory } from './types';
+/**
+ * Toolbar button renderer for the Special Characters extension.
+ * Renders a toolbar button with an Ω icon that opens a popover panel
+ * with categorized character grids.
+ */
+export declare class RTESpecialCharactersToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
+  private categories;
+  private panelRef;
+  constructor(categories: VegaRTESpecialCharacterCategory[]);
+  /**
+   * Renders the special characters toolbar button wrapped in a popover.
+   *
+   * @param {VegaRTECreateElementFunction} h - Create element function.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
+   * @returns {VegaRTERenderResult} - The toolbar button render result.
+   */
+  render(h: VegaRTECreateElementFunction, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  protected handleButtonClick(): void;
+  /**
+   * @inheritDoc
+   */
+  protected handleDropdownClick(): void;
+  /**
+   * Resets the panel and moves focus to the category select when the
+   * popover opens.
+   */
+  private handlePopoverShow;
+  /**
+   * Inserts a special character at the current cursor position using ReplaceSelectedTextAction,
+   * then restores the cursor position after flushing.
+   *
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
+   * @param {string} char - The Unicode character to insert.
+   */
+  private insertCharacter;
+  /**
+   * Checks whether the caret is collapsed on a Shift+Enter line-break text node.
+   *
+   * @param {RTENode} cursorNode - The current cursor node.
+   * @param {RTERange} range - The current selection range.
+   * @returns {boolean} True if the caret is collapsed on a '\n' text node.
+   */
+  private isCaretOnLineBreak;
+  /**
+   * Default insert path: replace the selected range on a regular text node.
+   *
+   * @param {RTENode} cursorNode - The current cursor node.
+   * @param {string} char - The Unicode character to insert.
+   * @param {RTERange} range - The current selection range.
+   * @returns {CaretTarget} The node and offset for the resulting caret position.
+   */
+  private insertAtTextNode;
+  /**
+   * Line-break insert path: delegate to insertTextToLineBreakNode and place
+   * the caret at the end of the inserted text.
+   *
+   * @param {RTETextNode} lineBreakNode - The '\n' text node at the caret.
+   * @param {string} char - The Unicode character to insert.
+   * @param {RTERange} range - The current selection range.
+   * @returns {CaretTarget} Caret target.
+   */
+  private insertAtLineBreak;
+  /**
+   * Mirror of InsertTextHandler.insertTextToLineBreakNode for the toolbar
+   * insert path: caret on a Shift+Enter line-break text node needs either a
+   * new sibling text node inserted before the break, or the break's text
+   * replaced. The default ReplaceSelectedTextAction + getRangeEndOffset()
+   * path returns 0 for '\n' text nodes and drops the caret in front of the
+   * inserted character.
+   *
+   * @param {RTETextNode} lineBreakNode - The '\n' text node at the caret.
+   * @param {string} text - The text to insert.
+   * @param {RTERange} currentRange - The current selection range.
+   * @returns {RTETextNode} The node the caret should land in.
+   */
+  private insertTextToLineBreakNode;
+}

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

@@ -0,0 +1,20 @@
+export declare type VegaRTESpecialCharacterItem = {
+  /** The Unicode character to display and insert (e.g. "Ω", "→"). */
+  character: string;
+  /** Human-readable name shown as tooltip and in the footer on hover (e.g. "Greek capital letter omega"). */
+  title: string;
+};
+export declare type VegaRTESpecialCharacterCategory = {
+  /** Unique identifier for the category, used as the select option value (e.g. "latin", "arrows"). */
+  key: string;
+  /** Display name shown in the category dropdown (e.g. "Latin", "Arrows"). */
+  label: string;
+  /** The list of special characters belonging to this category. */
+  characters: VegaRTESpecialCharacterItem[];
+};
+export declare type VegaRTESpecialCharactersConfig = {
+  /** Custom categories to append after the defaults (or use alone when includeDefaults is false). */
+  categories?: VegaRTESpecialCharacterCategory[];
+  /** Whether to include the built-in default categories. Defaults to true. */
+  includeDefaults?: boolean;
+};

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/vega-rich-text-special-characters-panel/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Synthetic key used by the panel's category dropdown to represent the
+ * "All" entry that aggregates characters from every configured category.
+ */
+export declare const ALL_CATEGORY_KEY: string;
+/**
+ * Number of columns in the character grid.
+ * Used by keyboard navigation and exposed as a CSS custom property
+ * (`--vega-special-characters-grid-columns`) so the grid layout stays in sync without duplication.
+ */
+export declare const GRID_COLUMNS: number;

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/vega-rich-text-special-characters-panel/slimmers/controllers/special-characters-panel-keyboard-controller.d.ts

@@ -0,0 +1,18 @@
+import { KeyboardManagerSlimmer } from '../../../../../../../helpers/slimmers/keyboard-manager-slimmer';
+import { VegaRichTextSpecialCharactersPanel } from '../../vega-rich-text-special-characters-panel';
+/**
+ * Handles arrow-key navigation within the Special Characters panel grid.
+ * Escape, Tab, Enter, and Space are not handled here — the popover and
+ * native button elements manage those interactions.
+ */
+export declare class SpecialCharactersPanelKeyboardController extends KeyboardManagerSlimmer {
+  protected renderer: VegaRichTextSpecialCharactersPanel['renderer'];
+  constructor();
+  /**
+   * Translates an arrow key press into a new active cell index
+   * and asks the renderer to move focus.
+   *
+   * @param {KeyboardEvent} event - The grid-scoped keydown event.
+   */
+  private handleNavigation;
+}

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

@@ -0,0 +1,66 @@
+import { VegaSlimmer } from '../../../../../../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../../../../../../types/general';
+import { VegaRichTextSpecialCharactersPanel } from '../../vega-rich-text-special-characters-panel';
+/**
+ * Renderer slimmer for the Special Characters panel.
+ */
+export declare class SpecialCharactersPanelRenderer extends VegaSlimmer {
+  categories: VegaRichTextSpecialCharactersPanel['categories'];
+  clickEventEmitter: VegaRichTextSpecialCharactersPanel['clickEventEmitter'];
+  translationSlimmer: VegaRichTextSpecialCharactersPanel['translationSlimmer'];
+  activeCategoryKey: VegaRichTextSpecialCharactersPanel['activeCategoryKey'];
+  hoveredItem: VegaRichTextSpecialCharactersPanel['hoveredItem'];
+  focusedCellIndex: VegaRichTextSpecialCharactersPanel['focusedCellIndex'];
+  private gridRef;
+  private selectRef;
+  /**
+   * Resets the panel to its initial state and moves focus to the category select.
+   * Called via {@link VegaRichTextSpecialCharactersPanel.resetPanel} whenever the popover opens.
+   */
+  resetPanel(): void;
+  /**
+   * Returns the rendered grid container element (or null if not yet
+   * mounted). Used by the keyboard controller to scope its listeners
+   * to the grid only.
+   */
+  getGridRef(): Nullable<HTMLElement>;
+  /**
+   * Returns the number of cells currently rendered in the grid (i.e.
+   * the character count of the active category view).
+   */
+  getCellCount(): number;
+  getActiveCellIndex(): number;
+  /**
+   * Updates the roving-tabindex pointer and focuses the targeted cell.
+   * No-ops when the index is out of range.
+   */
+  focusCellByIndex(index: number): void;
+  render(): HTMLElement;
+  /**
+   * Moves focus to the category select trigger so the user can immediately
+   * change the category or Tab into the grid. The select is a custom element
+   * whose trigger button lives in its shadow root.
+   */
+  private focusSelect;
+  /**
+   * Suppresses the default mousedown behavior inside the panel so that the
+   * RTE keeps focus and its current selection range stays intact — without
+   * it, clicking a character would blur the editor and the insertion point
+   * would be lost before `insertCharacter` runs.
+   */
+  private preventLostFocus;
+  private renderHeader;
+  private renderCategorySelect;
+  private renderCharacterGrid;
+  private handleCellMouseEnter;
+  private handleCellMouseLeave;
+  private handleCellFocus;
+  private handleCellClick;
+  private renderFooter;
+  /**
+   * Formats a character's Unicode code point as `U+XXXX`,
+   * padded to at least 4 hex digits (e.g. `U+00E0`, `U+1F600`).
+   */
+  private getCodePoint;
+  private getActiveCharacters;
+}

package/dist/types/components/vega-rich-text-editor/extensions/special-characters/vega-rich-text-special-characters-panel/vega-rich-text-special-characters-panel.d.ts

@@ -0,0 +1,58 @@
+import { EventEmitter } from '../../../../../stencil-public-runtime';
+import { GlobalSlimmers } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../../../helpers/slimmers/component-usage-runtime-metrics';
+import { EventEmitSlimmerBase } from '../../../../../helpers/event-manager/slimmers/event-emit-slimmer';
+import { SpecialCharactersPanelRenderer } from './slimmers/renderers/special-characters-panel-renderer';
+import { SpecialCharactersPanelKeyboardController } from './slimmers/controllers/special-characters-panel-keyboard-controller';
+import { VegaRTESpecialCharacterCategory, VegaRTESpecialCharacterItem } from '../types';
+import { Nullable } from '../../../../../types/general';
+import { TranslationSlimmer } from '../../../../../helpers/slimmers/translation';
+/**
+ * Internal panel component for the Special Characters extension.
+ * Renders a category select, character grid, and info footer.
+ *
+ * @vegaVersion 2.88.0
+ */
+export declare class VegaRichTextSpecialCharactersPanel {
+  protected readonly globalSlimmers: GlobalSlimmers;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaRichTextSpecialCharactersPanelElement>;
+  protected translationSlimmer: TranslationSlimmer<HTMLVegaRichTextSpecialCharactersPanelElement>;
+  protected clickEventEmitter: EventEmitSlimmerBase;
+  protected readonly renderer: SpecialCharactersPanelRenderer;
+  protected readonly keyboardController: SpecialCharactersPanelKeyboardController;
+  host: HTMLVegaRichTextSpecialCharactersPanelElement;
+  activeCategoryKey: string;
+  hoveredItem: Nullable<VegaRTESpecialCharacterItem>;
+  /**
+   * Index of the grid cell that currently has DOM focus (or null when no cell
+   * has been focused yet). Drives both the roving-tabindex anchor and the
+   * footer character preview during keyboard navigation.
+   */
+  focusedCellIndex: Nullable<number>;
+  /**
+   * The special character categories to display.
+   *
+   * @vegaVersion 2.88.0
+   */
+  categories: VegaRTESpecialCharacterCategory[];
+  /**
+   * Emitted when a character cell is clicked. The payload is the Unicode character string.
+   *
+   * @vegaVersion 2.88.0
+   */
+  vegaClick: EventEmitter<string>;
+  /**
+   * Emitted when a character cell is clicked. The payload is the Unicode character string.
+   *
+   * @vegaVersion 2.88.0
+   */
+  click: EventEmitter<string>;
+  /**
+   * Resets the panel to its initial state (all categories, no hovered item)
+   * and moves focus to the category select. Called whenever the popover opens.
+   *
+   * @vegaVersion 2.88.0
+   */
+  resetPanel(): Promise<void>;
+  render(): VegaRichTextSpecialCharactersPanel;
+}

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

@@ -24,6 +24,8 @@ export declare type VegaRTETableChildType = RTETableHeadBlock | RTETableBodyBloc
  * Class representing a table block in the rich text editor.
  */
 export declare class RTETableBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, VegaRTETableChildType> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: VegaRTEContent | RTEHtmlBlock;
   children: VegaRTETableChildType[];

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

@@ -11,6 +11,8 @@ export declare type VegaRTETableBodyBlock = VegaRTEBlockBase & {
  * Class representing a table body block in the rich text editor.
  */
 export declare class RTETableBodyBlock extends RTEBlock<RTETableBlock, RTETableRowBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTETableBlock;
   children: RTETableRowBlock[];

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

@@ -13,6 +13,8 @@ export declare type VegaRTETableCaptionBlock = VegaRTEBlockBase & {
  * Represents the optional caption block for a table.
  */
 export declare class RTETableCaptionBlock extends RTEBlock<RTETableBlock, RTEBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTETableBlock;
   children: RTEBlock[];

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

@@ -14,6 +14,8 @@ export declare type VegaRTETableCellBlock = VegaRTEBlockBase & {
  * Class representing a table cell block in the rich text editor.
  */
 export declare class RTETableCellBlock extends RTEBlock<RTETableRowBlock, RTEBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTETableRowBlock;
   children: RTEBlock[];

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

@@ -11,6 +11,8 @@ export declare type VegaRTETableHeadBlock = VegaRTEBlockBase & {
  * Class representing a table head block in the rich text editor.
  */
 export declare class RTETableHeadBlock extends RTEBlock<RTETableBlock, RTETableRowBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTETableBlock;
   children: RTETableRowBlock[];