@heartlandone/vega 2.76.0 → 2.77.1

package/dist/types/components/vega-rich-text-editor/test/extensions/extension-test-utils.d.ts

@@ -0,0 +1,21 @@
+import { RTEExtensionContext, VegaRTEToolbarRenderContext } from '../../interface';
+/**
+ * Gets a mock rich text editor element for testing purposes.
+ *
+ * @returns {HTMLElement} A mock rich text editor element.
+ */
+export declare function getMockRichTextEditor(): HTMLElement;
+/**
+ * Mocks the extension context for testing purposes.
+ *
+ * @param {Partial<RTEExtensionContext>} context - Partial context to override default mock values.
+ * @returns {RTEExtensionContext} The mocked extension context.
+ */
+export declare function mockExtensionContext(context?: Partial<RTEExtensionContext>): RTEExtensionContext;
+/**
+ * Mocks the toolbar render context for testing purposes.
+ *
+ * @param {Partial<VegaRTEToolbarRenderContext>} context - Partial context to override default mock values.
+ * @returns {VegaRTEToolbarRenderContext} The mocked toolbar render context.
+ */
+export declare function mockToolbarRenderContext(context?: Partial<VegaRTEToolbarRenderContext>): VegaRTEToolbarRenderContext;

package/dist/types/components.d.ts

@@ -7,7 +7,7 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { BorderStyleType, BoxDisplayType, CornersType, CssStatesType, ElementAppenderAlignmentType, ElementAppenderPlacementType, FlexAlignItemType, FlexDirectionType, FlexJustifyContentType, FlexWrapType, GapType, GridColumnsType, GridRowsType, HeightType, IconAlignType, MarginType, MaxHeightType, MinHeightType, PaddingType, PlacementType, PositionAlignmentType, ResponsiveType, SizeType, StateVariantType, TextAlignType, TranslocationType, VegaComponentInterface, VegaEATriggerType, VegaFlexProps, WidthType } from "./types/ui.type";
 import { LinkTargetType, VegaAppFooterLink } from "./components/vega-app-footer/types";
-import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize } from "./components/vega-app-header-button/types";
+import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize, VegaAppHeaderLabelConfig } from "./components/vega-app-header-button/types";
 import { VegaBannerActionButtonType, VegaBannerPropType } from "./components/vega-banner/types";
 import { VegaBarChartOptionsType } from "./components/vega-chart/vega-bar-chart/types";
 import { BackgroundColorsTokenType, BorderColorsTokenType, BordersTokenType, BreakpointsTokenType, ShadowsTokenType, SpacingTokenType, TextColorsTokenType, TypographyTokenType } from "./types/design-token.type";
@@ -25,7 +25,7 @@ import { FormFieldValidationRule } from "./helpers/validator/rules/form-field-va
 import { VegaChipIconAlign, VegaChipSize, VegaChipType, VegaChipVariant } from "./components/vega-chip/types";
 import { VegaCodeBlockValue } from "./components/vega-code-block/types";
 import { VegaComboBoxSize, VegaDropdownPropsForComboBox } from "./components/vega-combo-box/types";
-import { DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, DropdownConfigForDatePicker, VegaDropdownPropsForDatePickerCalendar } from "./components/vega-date-picker/types";
+import { DatePickerCalendarIndicator, DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, DropdownConfigForDatePicker, VegaDropdownPropsForDatePickerCalendar } from "./components/vega-date-picker/types";
 import { VegaDialogAction, VegaDialogActionButtonProps } from "./components/vega-dialog/types";
 import { VegaDividerDirectionType, VegaDividerVariantType } from "./components/vega-divider/interface";
 import { VegaDropdownItemClickEvent } from "./components/vega-dropdown/vega-dropdown-item/types";
@@ -199,6 +199,11 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "label": string;
+        /**
+          * Specifies the display configuration of the app header button label.
+          * @vegaVersion 2.77.1
+         */
+        "labelConfig": VegaAppHeaderLabelConfig;
         /**
           * Specifies whether the app header button is displayed in a selected state.
           * @vegaVersion 1.15.0
@@ -1266,6 +1271,11 @@ export namespace Components {
           * @vegaVersion 2.72.0
          */
         "clearButton": boolean;
+        /**
+          * Specifies a function that returns the properties for the date indicator tooltip for a given date in the date picker.  The function is called for each date cell before rendering.
+          * @vegaVersion 2.77.0
+         */
+        "dateIndicator": DatePickerCalendarIndicator;
         /**
           * Specifies the desired date format.
           * @vegaVersion 2.72.0
@@ -5741,6 +5751,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.11.0
          */
         "label"?: string;
+        /**
+          * Specifies the display configuration of the app header button label.
+          * @vegaVersion 2.77.1
+         */
+        "labelConfig"?: VegaAppHeaderLabelConfig;
         /**
           * An event emitter notifying the click event of an app header button.
           * @eventSemantics namespace:native
@@ -7067,6 +7082,11 @@ declare namespace LocalJSX {
           * @vegaVersion 2.72.0
          */
         "clearButton"?: boolean;
+        /**
+          * Specifies a function that returns the properties for the date indicator tooltip for a given date in the date picker.  The function is called for each date cell before rendering.
+          * @vegaVersion 2.77.0
+         */
+        "dateIndicator"?: DatePickerCalendarIndicator;
         /**
           * Specifies the desired date format.
           * @vegaVersion 2.72.0

package/dist/types/helpers/calendar/utils.d.ts

@@ -1,3 +1,5 @@
+import type { CalendarDate } from './calendar-date';
+import type { Nullable } from '../../types/general';
 /**
  * Get a week days array
  *
@@ -20,3 +22,18 @@ export declare enum WeekdayLongNames {
  * @returns {string} - The system timezone identifier (e.g., "America/New_York")
  */
 export declare const getSystemTimezone: () => string;
+/**
+ * Build an aria announcement string for date picker selection.
+ * TODO: consider to implement i18n for aria announcement .
+ *
+ * @param {object} options - The options for building the announcement.
+ * @param {'single' | 'range'} options.mode - The date picker selection mode.
+ * @param {Nullable<CalendarDate>} options.startDate - The start date.
+ * @param {Nullable<CalendarDate>} [options.endDate] - The end date (used in range mode).
+ * @returns {string} - The aria announcement string.
+ */
+export declare const buildDatePickerAnnouncement: (options: {
+  mode: 'single' | 'range';
+  startDate: Nullable<CalendarDate>;
+  endDate?: Nullable<CalendarDate>;
+}) => string;

package/dist/types/helpers/chart/test/input-processors/y-axis-input-processor.coverage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/common/test/wait-for-component-did-render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/slimmers/element-appender/element-appender-slimmer.d.ts

@@ -69,5 +69,17 @@ export declare class ElementAppenderSlimmer extends VegaSlimmer {
   private removeShadowRootElementScrolling;
   private executeTriggerStrategy;
   private getTriggerStrategy;
+  /**
+   * Sets `ariaOwnsElements` on the target element to reference the appendable element directly.
+   * Uses the Element Reflection API which works across shadow DOM boundaries by using
+   * direct element references instead of IDREF strings.
+   * This ensures screen readers (e.g. VoiceOver) can navigate to the portal-appended
+   * content immediately after the trigger, rather than at the end of the document.
+   */
+  private setAriaOwns;
+  /**
+   * Removes `ariaOwnsElements` from the target element when the popup is hidden or destroyed.
+   */
+  private removeAriaOwns;
 }
 export {};

package/dist/types/helpers/slimmers/mutation-observer/aria-attributes-value-mapper.d.ts

@@ -1,7 +1,8 @@
 import { MutationObserverSlimmer } from './mutation-observer-slimmer';
+import { Nullable } from '../../../types/general';
 export declare type AriaAttrDependency = {
   dependency: string[];
-  defaultValue?: string;
+  defaultValue?: Nullable<string>;
 };
 export declare type AriaAttributesMap = Record<string, AriaAttrDependency>;
 /**

package/dist/types/helpers/slimmers/mutation-observer/data-tab-index-value-mapper.d.ts

@@ -0,0 +1,35 @@
+import { MutationObserverSlimmer } from './mutation-observer-slimmer';
+/**
+ * Maps host data-tabindex to inner native input tabindex.
+ */
+export declare class DataTabIndexValueMapper extends MutationObserverSlimmer {
+  private static readonly OBSERVED_ATTRIBUTE;
+  private readonly targetGetter;
+  /**
+   * Component lifecycle - [componentDidLoad]
+   */
+  componentDidLoad(): void;
+  /**
+   * Component lifecycle - [componentDidRender]
+   */
+  componentDidRender(): void;
+  /**
+   * Constructor for DataTabIndexValueMapper
+   *
+   * @param {() => HTMLElement} targetGetter - Function to get the target HTMLElement
+   */
+  constructor(targetGetter: () => HTMLElement);
+  /**
+   * Performs the mapping of host data-tabindex to target element's tabindex.
+   * If the host attribute value is null, undefined, or empty string, it removes the tabindex attribute from the target.
+   * Otherwise, it sets the target's tabindex to the host attribute value.
+   */
+  private performMapping;
+  /**
+   * Determines whether the tabindex attribute should be removed from the target element.
+   *
+   * @param {string | null} hostValue - The value of the host element's data-tabindex attribute
+   * @returns {boolean} True if the tabindex should be removed, false otherwise
+   */
+  private shouldRemoveTabIndex;
+}

package/dist/types/helpers/slimmers/mutation-observer/test/data-tab-index-value-mapper.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/slimmers/position-calculation/base-position-calculation-strategy.d.ts

@@ -1,4 +1,5 @@
 import { VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../../types/general';
 import { ElementBoundBox, ElementPositionBox, ElementScrollDimension, PlacementType, PositionAlignmentType } from '../../../types/ui.type';
 import { ElementAppenderShowConfig } from '../../ui/element-appender';
 /**
@@ -69,9 +70,9 @@ export declare abstract class BasePositionCalculationStrategy extends VegaSlimme
    * @param {ElementBoundBox} elementBox - The box of the element to be placed.
    * @param {ElementBoundBox} targetBox - The box of the target element.
    * @param {PlacementType[]} placements - The placements that we want to try.
-   * @returns {PlacementType} A function that takes in a containerBox, elementBox, targetBox, placements, and element.
+   * @returns {Nullable<PlacementType>} A function that takes in a containerBox, elementBox, targetBox, placements, and element.
    */
-  protected getSuitablePlacement(containerBox: ElementScrollDimension, elementBox: ElementBoundBox, targetBox: ElementBoundBox, placements: PlacementType[]): PlacementType;
+  protected getSuitablePlacement(containerBox: ElementScrollDimension, elementBox: ElementBoundBox, targetBox: ElementBoundBox, placements: PlacementType[]): Nullable<PlacementType>;
   /**
    * "Get the width, height, and top position of an element."
    *
@@ -104,6 +105,62 @@ export declare abstract class BasePositionCalculationStrategy extends VegaSlimme
    * @returns {ElementPositionBox} An object with top and left properties.
    */
   private calculatePosition;
+  /**
+   * Keeps the vertical position within the visible viewport
+   *
+   * @param {number} top - The calculated top position.
+   * @param {number} elementHeight - The height of the element.
+   * @returns {number} The top position constrained to the viewport.
+   */
+  private keepVerticallyInView;
+  /**
+   * Keeps the horizontal position within the visible viewport
+   *
+   * @param {number} left - The calculated left position.
+   * @param {number} elementWidth - The width of the element.
+   * @returns {number} The left position constrained to the viewport.
+   */
+  private keepHorizontallyInView;
+  /**
+   * Checks if the target element is visible in the viewport
+   *
+   * @param {ElementBoundBox} targetBox - The bounding box of the target element.
+   * @returns {boolean} True if target is visible in viewport.
+   */
+  private isTargetInView;
+  /**
+   * Corrects `positionBox` so the element stays within the viewport after translocation.
+   * Only runs when the target is visible; skips correction entirely if the target has
+   * scrolled out of view so the element simply follows it.
+   *
+   * @param {ElementPositionBox} positionBox - The final position box to adjust (mutated in place).
+   * @param {ElementBoundBox} elementBox - Dimensions of the positioned element.
+   * @param {ElementBoundBox} targetBox - Bounding box of the target element.
+   * @param {PlacementType} placement - Active placement used to select the correction axis.
+   */
+  private adjustPositionForViewport;
+  /**
+   * Nudges `top` so the element stays within the viewport vertically.
+   * Only corrects when the overflow is less than `targetHeight` to keep the element
+   * visually anchored to its target; larger overflows are handled by `keepVerticallyInView`.
+   *
+   * @param {number} top - The calculated top position.
+   * @param {number} elementHeight - Height of the positioned element.
+   * @param {number} targetHeight - Height of the target, used as the max correctable overflow.
+   * @returns {number} The adjusted top position.
+   */
+  private adjustForVerticalOverflow;
+  /**
+   * Nudges `left` so the element stays within the viewport horizontally.
+   * Only corrects when the overflow is less than `targetWidth` to keep the element
+   * visually anchored to its target; larger overflows are handled by `keepHorizontallyInView`.
+   *
+   * @param {number} left - The calculated left position.
+   * @param {number} elementWidth - Width of the positioned element.
+   * @param {number} targetWidth - Width of the target, used as the max correctable overflow.
+   * @returns {number} The adjusted left position.
+   */
+  private adjustForHorizontalOverflow;
   /**
    * It returns the translocation of the element relative to the target element
    *
@@ -119,7 +176,7 @@ export declare abstract class BasePositionCalculationStrategy extends VegaSlimme
    * @param {ElementBoundBox} targetBox - The box of the element that the element to be positioned is aligned to.
    * @param {PlacementType} placement - The placement of the element relative to the target.
    * @param {PositionAlignmentType[]} alignments - An array of alignments to try.
-   * @returns {PositionAlignmentType} the alignment that is suitable for the element.
+   * @returns {Nullable<PositionAlignmentType>} the alignment that is suitable for the element.
    */
   private getSuitableAlignment;
   /**

package/dist/types/helpers/slimmers/position-calculation/screen-position-calculation-strategy.d.ts

@@ -1,6 +1,7 @@
 import { ElementAppenderShowConfig } from '../../ui/element-appender';
 import { ElementBoundBox, ElementPositionBox, ElementScrollDimension, PlacementType, PositionAlignmentType } from '../../../types/ui.type';
 import { BasePositionCalculationStrategy } from './base-position-calculation-strategy';
+import { Nullable } from '../../../types/general';
 /**
  * calculate position by screen container
  */
@@ -68,7 +69,7 @@ export declare class ScreenPositionCalculationStrategy extends BasePositionCalcu
    * @param {ElementBoundBox} elementBox - The box of the element to place.
    * @param {ElementBoundBox} targetBox - The box of the target element.
    * @param {PlacementType[]} placements - Ordered list of placements to try.
-   * @returns {PlacementType} The chosen placement.
+   * @returns {Nullable<PlacementType>} The chosen placement.
    */
-  protected getSuitablePlacement(containerBox: ElementScrollDimension, elementBox: ElementBoundBox, targetBox: ElementBoundBox, placements: PlacementType[]): PlacementType;
+  protected getSuitablePlacement(containerBox: ElementScrollDimension, elementBox: ElementBoundBox, targetBox: ElementBoundBox, placements: PlacementType[]): Nullable<PlacementType>;
 }

package/dist/types/helpers/slimmers/position-calculation/test/body-position-calculation-strategy.test.d.ts

@@ -10,6 +10,6 @@ export declare class PositionCalculationMockedComponent {
   private isScreenPosition;
   constructor();
   setIsScreenPosition(isScreenPosition: boolean): void;
-  getPositionBox(container: HTMLElement, element: HTMLElement, target: HTMLElement, placement?: PlacementType | PlacementType[], alignment?: PositionAlignmentType | PositionAlignmentType[], translocation?: TranslocationType): ElementPositionBox;
+  getPositionBox(container: HTMLElement, element: HTMLElement, target: HTMLElement, placement?: PlacementType | PlacementType[], alignment?: PositionAlignmentType | PositionAlignmentType[], translocation?: TranslocationType, positionRelativeTo?: string): ElementPositionBox;
   private setHtml;
 }

package/dist/types/helpers/translation/interface.d.ts

@@ -80,11 +80,20 @@ export type StaticTranslationKey =
 	| 'Thu-short'
 	| 'Fri-short'
 	| 'Sat-short'
+	| 'Sun-full'
+	| 'Mon-full'
+	| 'Tue-full'
+	| 'Wed-full'
+	| 'Thu-full'
+	| 'Fri-full'
+	| 'Sat-full'
 	| 'Day'
 	| 'Week'
 	| 'Month'
 	| 'Today'
 	| 'Clear'
+	| 'Previous month'
+	| 'Next month'
 	// Common end
 	| 'Viewing'
 	| 'Show'
@@ -127,6 +136,10 @@ export type StaticTranslationKey =
 	| 'Less Indent'
 	| 'Link'
 	| 'Image'
+	| 'Upload from computer'
+	| 'Insert via URL'
+	| 'Image via URL'
+	| 'Insert'
 	| 'Clear Style'
 	| 'URL'
 	| 'Text'
@@ -150,6 +163,8 @@ export type StaticTranslationKey =
 	| 'Copy Code'
 	| 'Code Block'
 	| 'Copied'
+	| 'date picker'
+	| 'Selected result'
 	| 'Repeat every {0} days'
 	| 'Repeat daily'
 	| 'Repeat every {0} weeks on {1}'

package/dist/types/polyfill/d3/d3-array-polyfill.d.ts

@@ -0,0 +1,48 @@
+/**
+ * D3 Array Polyfill - Lightweight array utility functions.
+ *
+ * This is a drop-in replacement for d3-array, implementing only the methods
+ * used in the Vega chart rendering system: min, max, extent, and map.
+ *
+ * @see VD-5022 - [Zero Dependencies] remove d3 dependency
+ */
+/**
+ * Returns the minimum value in the array.
+ * Mimics d3.min().
+ *
+ * @template T
+ * @param {T[]} array - Array of values.
+ * @param {Function} [accessor] - Optional accessor function.
+ * @returns {number | undefined} The minimum value, or undefined for empty arrays.
+ */
+export declare function min<T>(array: T[], accessor?: (d: T, i: number) => number): number | undefined;
+/**
+ * Returns the maximum value in the array.
+ * Mimics d3.max().
+ *
+ * @template T
+ * @param {T[]} array - Array of values.
+ * @param {Function} [accessor] - Optional accessor function.
+ * @returns {number | undefined} The maximum value, or undefined for empty arrays.
+ */
+export declare function max<T>(array: T[], accessor?: (d: T, i: number) => number): number | undefined;
+/**
+ * Returns the [min, max] of the array.
+ * Mimics d3.extent().
+ *
+ * @template T
+ * @param {T[]} array - Array of values.
+ * @returns {[T, T] | [undefined, undefined]} Tuple of [min, max], or [undefined, undefined] for empty arrays.
+ */
+export declare function extent<T>(array: T[]): [T, T] | [undefined, undefined];
+/**
+ * Maps each element of the array through a transform function.
+ * Mimics d3.map() (the array mapping function from d3-array, not the Map collection).
+ *
+ * @template T
+ * @template U
+ * @param {T[]} array - Input array.
+ * @param {Function} mapper - Transform function called with (element, index).
+ * @returns {U[]} New array of transformed values.
+ */
+export declare function map<T, U>(array: T[], mapper: (d: T, i: number) => U): U[];

package/dist/types/polyfill/d3/d3-axis-polyfill.d.ts

@@ -0,0 +1,53 @@
+/**
+ * D3 Axis Polyfill - Lightweight SVG axis generators.
+ *
+ * This is a drop-in replacement for d3-axis, implementing only the methods
+ * used in the Vega chart rendering system: axisBottom and axisLeft.
+ *
+ * @see VD-5022 - [Zero Dependencies] remove d3 dependency
+ */
+/**
+ * The domain type for axis scales.
+ */
+export declare type AxisDomain = string | number | Date | {
+  valueOf(): number;
+};
+/**
+ * The scale interface required by axis generators.
+ */
+export interface AxisScale<Domain> {
+  (value: Domain): number | undefined;
+  domain(): Domain[];
+  domain(domain: Domain[]): this;
+  range(): number[];
+  range(range: number[]): this;
+  ticks?(count?: number): Domain[];
+  tickFormat?(...args: unknown[]): (d: Domain) => string;
+  bandwidth?(): number;
+  copy?(): AxisScale<Domain>;
+}
+/**
+ * An axis generator that renders tick marks, labels, and a domain line into an SVG <g> element.
+ * Mimics d3's Axis interface with .ticks(), .tickFormat(), and callable behavior.
+ */
+export interface Axis<Domain extends AxisDomain> {
+  (selection: any): void;
+  ticks(count: number): Axis<Domain>;
+  tickFormat(formatter: (d: Domain) => string): Axis<Domain>;
+}
+/**
+ * Creates a bottom-oriented axis generator. Mimics d3.axisBottom().
+ *
+ * @template Domain
+ * @param {AxisScale} scale - The scale to use.
+ * @returns {Axis<Domain>} An Axis callable that renders into a <g> element.
+ */
+export declare function axisBottom<Domain extends AxisDomain = AxisDomain>(scale: AxisScale<Domain>): Axis<Domain>;
+/**
+ * Creates a left-oriented axis generator. Mimics d3.axisLeft().
+ *
+ * @template Domain
+ * @param {AxisScale} scale - The scale to use.
+ * @returns {Axis<Domain>} An Axis callable that renders into a <g> element.
+ */
+export declare function axisLeft<Domain extends AxisDomain = AxisDomain>(scale: AxisScale<Domain>): Axis<Domain>;

package/dist/types/polyfill/d3/d3-scale-polyfill.d.ts

@@ -0,0 +1,42 @@
+/**
+ * D3 Scale Polyfill - Lightweight scale generators for chart axes.
+ *
+ * This is a drop-in replacement for d3-scale, implementing only the methods
+ * used in the Vega chart rendering system: scaleLinear, scaleTime, and scaleBand.
+ *
+ * @see VD-5022 - [Zero Dependencies] remove d3 dependency
+ */
+import { AxisDomain, AxisScale } from './d3-axis-polyfill';
+/**
+ * Common scale interface extending AxisScale<AxisDomain> for direct
+ * compatibility with chart type declarations.
+ */
+export interface ScaleInterface extends AxisScale<AxisDomain> {
+  ticks(count?: number): AxisDomain[];
+  tickFormat(...args: unknown[]): (d: AxisDomain) => string;
+  copy(): ScaleInterface;
+  bandwidth(): number;
+}
+/**
+ * Creates a linear scale. Mimics d3.scaleLinear().
+ *
+ * @returns A callable linear scale function with chaining methods.
+ */
+export declare function scaleLinear(): ScaleInterface;
+/**
+ * Creates a time scale. Mimics d3.scaleTime().
+ *
+ * @returns A callable time scale function with chaining methods.
+ */
+export declare function scaleTime(): ScaleInterface;
+/**
+ * Creates a band scale. Mimics d3.scaleBand().
+ *
+ * @param domain - Optional initial domain values.
+ * @param range - Optional initial range [min, max].
+ * @returns A callable band scale function with chaining methods.
+ */
+export declare function scaleBand(domain?: AxisDomain[], range?: number[]): ScaleInterface & {
+  padding(p: number): ScaleInterface;
+  bandwidth(): number;
+};

package/dist/types/polyfill/d3/d3-selection-polyfill.d.ts

@@ -0,0 +1,173 @@
+/**
+ * D3 Selection Polyfill - A lightweight DOM selection and manipulation utility.
+ *
+ * This is a drop-in replacement for d3-selection, implementing only the methods
+ * used in the Vega chart rendering system.
+ *
+ * Supported methods: select, selectAll, append, attr, property, text, datum,
+ * call, node, nodes, each, remove, clone, transition, duration.
+ *
+ * @see VD-5022 - [Zero Dependencies] remove d3 dependency
+ */
+declare type SelectionCallback<GElement, Datum> = (this: GElement, d?: Datum, i?: number, nodes?: GElement[]) => any;
+/**
+ * A lightweight selection class mimicking d3-selection's chainable API.
+ * Wraps an array of DOM elements and provides attribute/property/child manipulation.
+ */
+export declare class D3SelectionPolyfill<GElement extends Element = Element, Datum = unknown, PElement extends Element = Element, PDatum = unknown> {
+  private _groups;
+  private _datum;
+  /**
+   * @param {Element[]} elements - Array of DOM elements to wrap.
+   * @param {*} [datum] - Optional bound datum for the selection.
+   */
+  constructor(elements: GElement[], datum?: Datum);
+  /**
+   * Selects the first descendant element matching the selector.
+   *
+   * @template DescElement
+   * @template Datum
+   * @template GElement
+   * @param {string} selector - CSS selector string.
+   * @returns {D3SelectionPolyfill<DescElement, Datum, GElement, Datum>} A new selection wrapping the matched element.
+   */
+  select<DescElement extends Element = Element>(selector: string): D3SelectionPolyfill<DescElement, Datum, GElement, Datum>;
+  /**
+   * Selects all descendant elements matching the selector.
+   *
+   * @template DescElement
+   * @template NewDatum
+   * @template GElement
+   * @template Datum
+   * @param {string} selector - CSS selector string.
+   * @returns {D3SelectionPolyfill<DescElement, NewDatum, GElement, Datum>} A new selection wrapping all matched elements.
+   */
+  selectAll<DescElement extends Element = Element, NewDatum = unknown>(selector: string): D3SelectionPolyfill<DescElement, NewDatum, GElement, Datum>;
+  /**
+   * Appends a new child element to each element in the selection.
+   * Accepts either a tag name string or a factory function that returns a DOM element.
+   *
+   * @template ChildElement
+   * @template Datum
+   * @template GElement
+   * @param {string | Function} tagOrFactory - Tag name (e.g. 'g', 'path') or a factory function.
+   * @returns {D3SelectionPolyfill<ChildElement, Datum, GElement, Datum>} A new selection wrapping the appended elements.
+   */
+  append<ChildElement extends Element = Element>(tagOrFactory: string | (() => ChildElement)): D3SelectionPolyfill<ChildElement, Datum, GElement, Datum>;
+  /**
+   * Sets or gets an attribute on each element.
+   * If value is a function, it is called with the bound datum.
+   *
+   * @param {...*} args - Attribute name, and optionally a value or function returning a value.
+   * @returns {any} This selection for chaining, or the attribute value if getting.
+   */
+  attr(...args: any[]): any;
+  /**
+   * Sets a JavaScript property on each element.
+   *
+   * @param {string} name - Property name.
+   * @param {unknown} value - Property value.
+   * @returns {this} This selection for chaining.
+   */
+  property(name: string, value: unknown): this;
+  /**
+   * Sets the text content of each element.
+   *
+   * @param {string} value - Text content string.
+   * @returns {this} This selection for chaining.
+   */
+  text(value: string): this;
+  /**
+   * Binds a datum to the selection.
+   *
+   * @template NewDatum
+   * @template GElement
+   * @template PElement
+   * @template PDatum
+   * @param {*} data - The datum to bind.
+   * @returns {D3SelectionPolyfill<GElement, NewDatum, PElement, PDatum>} A new selection with the bound datum.
+   */
+  datum<NewDatum>(data: NewDatum): D3SelectionPolyfill<GElement, NewDatum, PElement, PDatum>;
+  /**
+   * Calls a function with this selection as argument. Used for grouping operations.
+   *
+   * @param {Function} fn - Function to call.
+   * @param {...*} args - Additional arguments.
+   * @returns {this} This selection for chaining.
+   */
+  call(fn: (selection: this, ...args: any[]) => void, ...args: any[]): this;
+  /**
+   * Returns the first DOM node in the selection, or null.
+   *
+   * @template GElement
+   * @returns {GElement | null} The first element or null.
+   */
+  node(): GElement | null;
+  /**
+   * Returns all DOM nodes in the selection as an array.
+   *
+   * @template GElement
+   * @returns {GElement[]} Array of elements.
+   */
+  nodes(): GElement[];
+  /**
+   * Iterates over each element, calling the provided function.
+   * The function is called with `this` set to the current DOM element.
+   *
+   * @param {Function} fn - Callback function.
+   * @returns {this} This selection for chaining.
+   */
+  each(fn: SelectionCallback<GElement, Datum>): this;
+  /**
+   * Removes all elements in the selection from the DOM.
+   *
+   * @returns {this} This selection for chaining.
+   */
+  remove(): this;
+  /**
+   * Clones each element in the selection (shallow clone) and inserts after the original.
+   *
+   * @template GElement
+   * @template Datum
+   * @template PElement
+   * @template PDatum
+   * @returns {D3SelectionPolyfill<GElement, Datum, PElement, PDatum>} A new selection wrapping the cloned elements.
+   */
+  clone(): D3SelectionPolyfill<GElement, Datum, PElement, PDatum>;
+  /**
+   * Creates a transition-like object. This is a simplified polyfill that
+   * applies attribute changes immediately (no actual animation), which is
+   * sufficient for Vega's usage of hover path swapping.
+   *
+   * @param {*} [_name] - Transition name (ignored in polyfill).
+   * @returns {this} This selection for chaining (acts as a no-op).
+   */
+  transition(_name?: unknown): this;
+  /**
+   * Sets the transition duration. No-op in this polyfill since
+   * transitions are applied immediately.
+   *
+   * @param {number} _ms - Duration in milliseconds (ignored).
+   * @returns {this} This selection for chaining.
+   */
+  duration(_ms: number): this;
+}
+/**
+ * Selects a DOM element by wrapping it in a D3SelectionPolyfill.
+ * Mimics d3.select().
+ *
+ * @template GElement
+ * @param {Element | EventTarget} element - A DOM element or EventTarget to wrap.
+ * @returns {D3SelectionPolyfill<GElement>} A new D3SelectionPolyfill wrapping the element.
+ */
+export declare function select<GElement extends Element = Element>(element: GElement | EventTarget): D3SelectionPolyfill<GElement>;
+/**
+ * Creates a detached SVG element (e.g., 'svg:text', 'svg:circle', 'svg:path').
+ * Mimics d3.create().
+ *
+ * @template GElement
+ * @param {string} qualifiedName - A qualified name like 'svg:text' or 'svg:circle'.
+ * @returns {D3SelectionPolyfill<GElement>} A new D3SelectionPolyfill wrapping the created element.
+ */
+export declare function create<GElement extends Element = Element>(qualifiedName: string): D3SelectionPolyfill<GElement>;
+export {};