@heartlandone/vega 2.76.0 → 2.77.0

package/dist/types/components/vega-button-circle/vega-button-circle.d.ts

@@ -6,6 +6,7 @@ import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
+import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 /**
  * @vegaVersion 1.0.2
  */
@@ -13,6 +14,7 @@ export declare class VegaButtonCircle {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected clickEventEmitter: EventEmitSlimmerBase;
   protected eventPrevent: ChildNodesEventPreventSlimmer;
+  protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaButtonCircleElement>;
   host: HTMLVegaButtonCircleElement;
   /**

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

@@ -1,3 +1,5 @@
+import { Nullable } from '../../types/general';
+
 /**
  * Modes supported by the date picker component.
  */
@@ -63,3 +65,15 @@ export type VegaDropdownPropsForDatePickerCalendar = Partial<
  * Size variants for the date picker calendar.
  */
 export type DatePickerCalendarSizeType = 'small' | 'regular' | 'large';
+
+/**
+ * Indicator function type for calendar dates, returning tooltip properties or null.
+ */
+export type DatePickerCalendarIndicatorTooltipProps = Partial<
+	Pick<HTMLVegaTooltipElement, 'text' | 'size' | 'maxWidth' | 'minWidth' | 'trigger'>
+>;
+
+/**
+ * Function type for providing date indicators in the calendar, returning tooltip properties or null for a given date.
+ */
+export type DatePickerCalendarIndicator = (date: Date) => Nullable<DatePickerCalendarIndicatorTooltipProps>;

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

@@ -14,12 +14,15 @@ export declare class VegaDatePickerMonthItemRenderer extends VegaSlimmer {
   mode: VegaDatePickerCalendar['mode'];
   size: VegaDatePickerCalendar['size'];
   isDateDisabled: VegaDatePickerCalendar['isDateDisabled'];
+  dateIndicator: VegaDatePickerCalendar['dateIndicator'];
   private isMobileDevice;
   private monthViewGenerator;
   render(type: DatePickerCalendarMonthRenderType): HTMLElement;
   private renderCurrentYearMonth;
   private renderWeek;
   private renderDays;
+  private renderItem;
+  private renderDayWithIndicator;
   private renderDay;
   private getCurrentRangeDates;
   private isBeforeMinDate;

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

@@ -3,7 +3,7 @@ import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaDatePickerCalendarRenderer } from './slimmers/renderers/vega-date-picker-calendar-renderer';
 import { VegaDatePickerCalendarYearMonthSwitcherRenderer } from './slimmers/renderers/vega-date-picker-calendar-year-month-switcher-renderer';
-import { DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, VegaDropdownPropsForDatePickerCalendar } from '../types';
+import { DatePickerCalendarIndicator, DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, VegaDropdownPropsForDatePickerCalendar } from '../types';
 import { TranslationSlimmer } from '../../../helpers/slimmers/translation/translation-slimmer';
 import { CalendarDate, MonthPeriod } from '../../../helpers/calendar';
 import { VegaDatePickerCalendarCurrentPeriodController } from './slimmers/controllers/vega-date-picker-calendar-current-period-controller';
@@ -138,6 +138,14 @@ export declare class VegaDatePickerCalendar {
    * @vegaVersion 2.72.0
    */
   isDateDisabled: DisabledDate;
+  /**
+   * 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;
   /**
    * An event emitter notifying the change of the value in the date picker,
    *    whether triggered programmatically or through user interaction.

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

@@ -21,4 +21,10 @@ export declare class VegaRichTextContentRenderer extends VegaSlimmer {
   private renderRichTextContent;
   private renderContent;
   private shouldShowPlaceholder;
+  /**
+   * Inject the reference of rich text editor into render context for the usage of extensions.
+   *
+   * @param {RTERenderContext} renderContext - The render context which may contain the host reference.
+   */
+  private injectRTERefIntoContext;
 }

package/dist/types/components/vega-rich-text-editor/extensions/base-extension-renderer.d.ts

@@ -3,7 +3,7 @@ import { Nullable } from '../../../types/general';
 import { RTEBlock } from '../dto/blocks/block.abstract';
 import { RTENode } from '../dto/nodes/node.abstract';
 import { VegaRTEBaseRenderer } from '../dto/renderers/base-renderer';
-import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../interface';
+import { RTEExtensionContext, RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../interface';
 declare type VegaRTEUseRef = (element: HTMLElement) => void;
 /**
  * Base renderer for Vega Rich Text Editor.
@@ -40,6 +40,14 @@ export declare abstract class VegaRTEExtensionRenderer extends VegaRTEBaseRender
    * @returns {Nullable<BaseRenderer>} - The registered renderer or null if not found.
    */
   protected getDTORenderer(key: string): Nullable<BaseRenderer>;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {HTMLVegaRichTextEditorElement} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  protected getExtensionContext(el?: HTMLVegaRichTextEditorElement): Nullable<RTEExtensionContext>;
   /**
    * Auto render the block children if the block element is not exist
    *

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

@@ -1,5 +1,5 @@
 import { Nullable } from '../../../types/general';
-import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps, RTEDropdownListGroup } from '../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps, RTEDropdownListGroup, RTEExtensionContext } from '../interface';
 /**
  * Base class for rendering extension toolbar button in the rich text editor.
  * The renderer provides common functionalities for rendering toolbar buttons, including:
@@ -26,6 +26,14 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @returns {VegaRTERenderResult} Toolbar button.
    */
   abstract render(createElement: VegaRTECreateElementFunction, editorContext?: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {HTMLVegaRichTextEditorElement} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  protected getExtensionContext(el: HTMLVegaRichTextEditorElement): Nullable<RTEExtensionContext>;
   /**
    * Renders a dropdown component with the specified properties and children.
    *

package/dist/types/components/vega-rich-text-editor/extensions/functions/function-extension.d.ts

@@ -1,17 +1,10 @@
 import { VegaRTEExtension } from '../extension.abstract';
-import { RTEExtensionContext } from '../../interface';
 /**
  * Function extension class for Vega Rich Text Editor.
  */
 export declare class VegaRTEFunctionExtension extends VegaRTEExtension {
   private toolbarButtonRenderer;
   constructor();
-  /**
-   * Initializes the extension with the given context
-   *
-   * @param {RTEExtensionContext} context - extension context
-   */
-  initialExtension(context: RTEExtensionContext): void;
   /**
    * Remove the appen children strategies to prevent default insert new paragraph logic in function block
    */

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

@@ -1,4 +1,4 @@
-import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEExtensionContext } from '../../../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem } from '../../../interface';
 import { VegaRTEToolbarButtonRenderer } from '../../base-toolbar-button-renderer';
 import { RTEExtensionFunctionType } from '../actions/insert-function-block-action';
 /**
@@ -6,13 +6,6 @@ import { RTEExtensionFunctionType } from '../actions/insert-function-block-actio
  */
 export declare class FunctionToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
   static FUNCTION_LIST: RTEDropdownListItem[];
-  private extensionContext?;
-  /**
-   * Injects the extension context
-   *
-   * @param {RTEExtensionContext} context - extension context
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * @inheritDoc
    */
@@ -20,14 +13,16 @@ export declare class FunctionToolbarButtonRenderer extends VegaRTEToolbarButtonR
   /**
    * Overrides the isDisabled method to determine if the button should be disabled.
    *
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    * @returns {boolean} - true if the button should be disabled, false otherwise.
    */
-  protected isDisabled(): boolean;
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
   protected handleButtonClick(): void;
   /**
    * Handles dropdown click event
    *
    * @param {RTEExtensionFunctionType} itemKey - key of the clicked item
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    */
-  protected handleDropdownClick(itemKey: RTEExtensionFunctionType): void;
+  protected handleDropdownClick(itemKey: RTEExtensionFunctionType, editorContext?: VegaRTEToolbarRenderContext): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-extension.d.ts

@@ -1,4 +1,4 @@
-import { RTEExtensionContext, RTEDropdownListGroup, RTEDropdownListItem } from '../../interface';
+import { RTEDropdownListGroup, RTEDropdownListItem } from '../../interface';
 import { VegaRTEExtension } from '../extension.abstract';
 /**
  * Vega Rich Text Editor Token Extension
@@ -7,8 +7,4 @@ export declare class VegaRTETokenExtension extends VegaRTEExtension {
   private tokenRenderer;
   private tokenToolbarButtonRenderer;
   constructor(tokenList?: (RTEDropdownListItem | RTEDropdownListGroup)[]);
-  /**
-   * @inheritDoc
-   */
-  initialExtension(context: RTEExtensionContext): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-node-renderer.d.ts

@@ -1,11 +1,10 @@
-import { RTEExtensionContext, RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../interface';
+import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../interface';
 import { VegaRTEExtensionRenderer } from '../base-extension-renderer';
 import { RTETokenNode } from './token-node';
 /**
  * Token node renderer for the rich text editor.
  */
 export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
-  private extensionContext;
   /**
    * Renders the token node as a DOM element.
    *
@@ -15,12 +14,6 @@ export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
    * @returns {VegaRTERenderResult} - The rendered DOM element.
    */
   doRender(createElement: VegaRTECreateElementFunction, node: RTETokenNode, editorContent?: RTERenderContext): VegaRTERenderResult;
-  /**
-   * Sets the RTE extension context.
-   *
-   * @param {RTEExtensionContext} context - The context of the RTE extension.
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * Override to inject RTE scope styles for the token node.
    *
@@ -30,8 +23,10 @@ export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
   /**
    * Handle the click event on the token element.
    *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
    * @param {MouseEvent} event - The click event.
    * @param {RTETokenNode} node - The token node that was clicked.
+   * @param {HTMLVegaRichTextEditorElement} [richTextEditor] - The rich text editor host element.
    */
   private handleTokenElementClick;
   /**

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

@@ -1,18 +1,11 @@
-import { RTEExtensionContext, VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEDropdownListGroup } from '../../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEDropdownListGroup } from '../../interface';
 import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
 /**
  * Renderer for the token toolbar button in the Vega Rich Text Editor.
  */
 export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
   private tokenList;
-  private extensionContext;
   constructor(tokenList: (RTEDropdownListItem | RTEDropdownListGroup)[]);
-  /**
-   * Sets the RTE extension context.
-   *
-   * @param {RTEExtensionContext} context - The context of the RTE extension.
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * Renders the token toolbar button.
    *
@@ -24,9 +17,10 @@ export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonR
   /**
    * Checks if the token toolbar button is disabled.
    *
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    * @returns {boolean} True if the button is disabled, false otherwise.
    */
-  protected isDisabled(): boolean;
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
   /**
    * Handles the button click event. No need this method for token button.
    *
@@ -42,6 +36,8 @@ export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonR
   protected handleDropdownClick(itemKey: string, editorContext: VegaRTEToolbarRenderContext): void;
   /**
    * Refreshes the editor UI.
+   *
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
    */
   private flushEditorUI;
 }

package/dist/types/components/vega-rich-text-editor/helpers/extension-context-manager.d.ts

@@ -0,0 +1,26 @@
+import { Nullable } from '../../../types/general';
+import { RTEExtensionContext } from '../interface';
+/**
+ * Manager for storing and retrieving the extension context associated with each rich text editor host element.
+ *
+ * @todo Currently, there are three types of contexts in RTE: toolbar render context, extension context, and DTO render context. The second and third types are bound to the extension context via host props. We are considering optimizing these three types of contexts to make the program more flexible and easier to maintain.
+ */
+declare class RTEExtensionContextManager {
+  private extensionContextMap;
+  /**
+   * Store the extension context for the given rich text editor host element.
+   *
+   * @param {RTEExtensionContext} context - The extension context to store.
+   */
+  setExtensionContext(context: RTEExtensionContext): void;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {Nullable<HTMLVegaRichTextEditorElement>} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  getExtensionContext(el: Nullable<HTMLVegaRichTextEditorElement>): Nullable<RTEExtensionContext>;
+}
+declare const _default: RTEExtensionContextManager;
+export default _default;

package/dist/types/components/vega-rich-text-editor/helpers/extension-context-manager.test.d.ts

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

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

@@ -549,6 +549,10 @@ export type RTERenderContext = {
 	 * If `false`, use CSS classes for integration within the RTE content view.
 	 */
 	standalone?: boolean;
+	/**
+	 * Host rich text editor element reference.
+	 */
+	host?: HTMLVegaRichTextEditorElement;
 } & Partial<Pick<VegaRTETransformOptions, 'autoMatchFormat'>>;
 
 /**

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

@@ -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";
@@ -1266,6 +1266,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
@@ -7067,6 +7072,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/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/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;
+};