@heartlandone/vega 2.75.1 → 2.77.0

package/dist/types/polyfill/libphonenumber/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared types and constants for the libphonenumber polyfill.
+ */
+import type { VegaCountryCode } from '../../types/flag.type';
+/** Shape of a single format rule inside a country metadata entry. */
+export declare type FormatRule = [
+  /** pattern - regex source matching the national number */
+  string,
+  /** replacement - e.g. '($1) $2-$3' */
+  string,
+  /** leadingDigitsPatterns - array of regex sources for matching leading digits */
+  string[],
+  /** nationalPrefixFormattingRule (optional) - e.g. '0$1' */
+  string?,
+  /** domesticCarrierCodeFormattingRule (optional) */
+  (string | number)?,
+  /** internationalFormat (optional) */
+  string?
+];
+/**
+ * Country metadata tuple.
+ *
+ * Index mapping (metadata version 4):
+ *  [0]  callingCode
+ *  [1]  international direct dialing pattern
+ *  [2]  validation regex source (generalDesc)
+ *  [3]  possible lengths
+ *  [4]  format rules (or 0/undefined)
+ *  [5]  trunk prefix (or 0/undefined)
+ *  [6..9] various national prefix fields
+ *  [10] leadingDigits for country-in-calling-code disambiguation (or 0)
+ *  [11] types array (or 0)
+ */
+export declare type CountryMetadata = [
+  string,
+  // [0] callingCode
+  string | 0,
+  string,
+  number[],
+  // [3] possibleLengths
+  FormatRule[] | 0,
+  ...unknown[]
+];
+export interface MetadataJson {
+  version: number;
+  countryCallingCode: Record<string, string[]>;
+  countries: Record<string, CountryMetadata>;
+}
+/** Result of populating a formatting template with digits. */
+export interface PopulatedTemplateResult {
+  /** The template string with digits filled in. */
+  filled: string;
+  /** The index of the last populated placeholder. */
+  lastPosition: number;
+}
+export interface ParsePhoneNumberOptions {
+  defaultCountry?: VegaCountryCode;
+  /** When false, the entire input must be a phone number (no extraction). */
+  extract?: boolean;
+}
+/** Placeholder character used in formatting templates. */
+export declare const DIGIT_PLACEHOLDER: string;
+/** Dummy digit used to generate formatting templates. */
+export declare const DUMMY_DIGIT: string;
+/** Maximum possible national number length. */
+export declare const LONGEST_NATIONAL_NUMBER_LENGTH: number;
+/** Minimum digits before progressive leading-digits matching kicks in. */
+export declare const MIN_LEADING_DIGITS_LENGTH: number;
+/**
+ * Pattern that matches national prefix formatting rules that are just "$1"
+ * or "($1)" — i.e. rules that don't actually prepend a national prefix digit.
+ */
+export declare const FIRST_GROUP_ONLY_PREFIX_PATTERN: RegExp;
+/** Error code thrown when the input does not contain a valid phone number. */
+export declare const PARSE_ERROR_NOT_A_NUMBER: string;
+/** Error code thrown when the country cannot be determined from the input. */
+export declare const PARSE_ERROR_INVALID_COUNTRY: string;

package/dist/types/polyfill/prism/index.d.ts

@@ -0,0 +1,3 @@
+export { tokenize } from './tokenizer';
+export { getLanguageGrammar } from './languages/language-registry';
+export type { SyntaxToken, Grammar, GrammarPattern, GrammarEntry } from './types';

package/dist/types/polyfill/prism/languages/css.d.ts

@@ -0,0 +1,6 @@
+import { Grammar } from '../types';
+/**
+ * Grammar definition for CSS syntax highlighting.
+ * Handles selectors, properties, values, at-rules, comments, strings, and other CSS constructs.
+ */
+export declare const cssGrammar: Grammar;

package/dist/types/polyfill/prism/languages/javascript.d.ts

@@ -0,0 +1,7 @@
+import { Grammar } from '../types';
+/**
+ * Grammar definition for JavaScript syntax highlighting.
+ * Handles keywords, operators, strings, template literals, numbers,
+ * regex literals, comments, functions, classes, and other JS constructs.
+ */
+export declare const javascriptGrammar: Grammar;

package/dist/types/polyfill/prism/languages/jsx.d.ts

@@ -0,0 +1,7 @@
+import { Grammar } from '../types';
+/**
+ * Grammar definition for JSX syntax highlighting.
+ * Extends JavaScript grammar with JSX tag syntax for React components,
+ * including self-closing tags, expressions in braces, and embedded markup attributes.
+ */
+export declare const jsxGrammar: Grammar;

package/dist/types/polyfill/prism/languages/language-registry.d.ts

@@ -0,0 +1,8 @@
+import { Grammar } from '../types';
+/**
+ * Retrieve the grammar for a given language identifier.
+ *
+ * @param {string} language - The language identifier (e.g., 'js', 'css', 'html', 'ts', 'jsx', 'tsx').
+ * @returns {Grammar | undefined} The grammar definition, or undefined if the language is not registered.
+ */
+export declare function getLanguageGrammar(language: string): Grammar | undefined;

package/dist/types/polyfill/prism/languages/markup.d.ts

@@ -0,0 +1,6 @@
+import { Grammar } from '../types';
+/**
+ * Grammar definition for HTML/Markup syntax highlighting.
+ * Handles tags, attributes, comments, doctypes, CDATA, entities, and embedded content.
+ */
+export declare const markupGrammar: Grammar;

package/dist/types/polyfill/prism/languages/tsx.d.ts

@@ -0,0 +1,7 @@
+import { Grammar } from '../types';
+/**
+ * Grammar definition for TSX (TypeScript + JSX) syntax highlighting.
+ * Merges TypeScript and JSX grammars, supporting both type annotations
+ * and JSX tag syntax in the same file.
+ */
+export declare const tsxGrammar: Grammar;

package/dist/types/polyfill/prism/languages/typescript.d.ts

@@ -0,0 +1,2 @@
+import { Grammar } from '../types';
+export declare const typescriptGrammar: Grammar;

package/dist/types/polyfill/prism/test/css.test.d.ts

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

package/dist/types/polyfill/prism/test/javascript.test.d.ts

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

package/dist/types/polyfill/prism/test/jsx.test.d.ts

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

package/dist/types/polyfill/prism/test/language-registry.test.d.ts

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

package/dist/types/polyfill/prism/test/markup.test.d.ts

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

package/dist/types/polyfill/prism/test/test-utils.d.ts

@@ -0,0 +1,10 @@
+import { SyntaxToken } from '../types';
+/**
+ * Recursively find all tokens of a given type within a token array.
+ * Traverses nested token content arrays to find deeply nested tokens.
+ *
+ * @param {(string | SyntaxToken)[]} tokens - The token array to search.
+ * @param {string} type - The token type to filter by.
+ * @returns {SyntaxToken[]} All tokens matching the specified type.
+ */
+export declare const findTokensByType: (tokens: (string | SyntaxToken)[], type: string) => SyntaxToken[];

package/dist/types/polyfill/prism/test/tokenizer.test.d.ts

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

package/dist/types/polyfill/prism/test/tsx.test.d.ts

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

package/dist/types/polyfill/prism/test/typescript.test.d.ts

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

package/dist/types/polyfill/prism/tokenizer.d.ts

@@ -0,0 +1,17 @@
+import { Grammar, SyntaxToken } from './types';
+/**
+ * Core tokenizer that converts source code into syntax tokens based on a grammar definition.
+ * This is a local replacement for Prism tokenize.
+ *
+ * The tokenizer works by:
+ * 1. Pre-processing greedy patterns to claim their matched regions first
+ * 2. Iterating through all grammar rules in order
+ * 3. Finding regex matches in the source text
+ * 4. Splitting the text into matched (typed) and unmatched (plain) segments
+ * 5. Recursively tokenizing nested content when an `inside` grammar is specified
+ *
+ * @param {string} code - The source code string to tokenize.
+ * @param {Grammar} grammar - The grammar rules to apply for tokenization.
+ * @returns {(string | SyntaxToken)[]} An array of plain strings and syntax tokens.
+ */
+export declare function tokenize(code: string, grammar: Grammar): (string | SyntaxToken)[];

package/dist/types/polyfill/prism/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Represents a token produced by the syntax highlighting tokenizer.
+ * A token has a type (e.g. 'keyword', 'string', 'comment') and content
+ * which can be a string, a single nested token, or an array of mixed strings and tokens.
+ */
+export interface SyntaxToken {
+  type: string;
+  content: string | SyntaxToken | (string | SyntaxToken)[];
+}
+/**
+ * A grammar rule pattern used for tokenizing source code.
+ * Each pattern has a regex to match and an optional `inside` grammar for nested tokenization.
+ */
+export interface GrammarPattern {
+  pattern: RegExp;
+  lookbehind?: boolean;
+  greedy?: boolean;
+  inside?: Grammar;
+}
+/**
+ * A grammar is a map of token type names to their pattern definitions.
+ * Each entry can be a single pattern, an array of patterns, or a nested grammar reference.
+ */
+export declare type GrammarEntry = GrammarPattern | GrammarPattern[];
+export declare type Grammar = Record<string, GrammarEntry>;

package/dist/types/polyfill/tinycolor/tinycolor-polyfill.d.ts

@@ -0,0 +1,149 @@
+/**
+ * TinyColor Polyfill - A lightweight color manipulation utility.
+ *
+ * This is a drop-in replacement for tinycolor2, implementing only the methods
+ * used in the Vega theme overriding system.
+ *
+ * @see VD-5026 - [Zero Dependencies] remove tinycolor2 dependency
+ */
+declare type RgbaValue = {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+};
+/**
+ * TinyColor polyfill class for color manipulation.
+ * Implements the same interface as tinycolor2.Instance for the methods used in Vega.
+ */
+export declare class TinyColorPolyfill {
+  private _r;
+  private _g;
+  private _b;
+  private _a;
+  /**
+   * Create a new TinyColorPolyfill instance.
+   *
+   * @param {string | RgbaValue} color - The color to parse.
+   */
+  constructor(color: string | RgbaValue);
+  /**
+   * Clamp a value between a minimum and maximum.
+   *
+   * @param {number} value - The value to clamp.
+   * @param {number} min - The minimum allowed value.
+   * @param {number} max - The maximum allowed value.
+   * @returns {number} The clamped value.
+   */
+  private static clamp;
+  /**
+   * Parse a color string or RGBA object into an RgbaValue.
+   *
+   * Supported formats:
+   * - Hex: #RGB, #RRGGBB, #RRGGBBAA
+   * - RGB: rgb(r, g, b)
+   * - RGBA: rgba(r, g, b, a)
+   * - Object: { r, g, b, a? }
+   *
+   * @param {string | RgbaValue} color - The color to parse.
+   * @returns {RgbaValue} The parsed RGBA value.
+   */
+  private static parseColor;
+  /**
+   * Parse a hex color string into RGBA values.
+   *
+   * @param {string} hex - The hex color string (e.g., "#fff", "#ffffff", "#ffffffff").
+   * @returns {RgbaValue} The parsed RGBA value.
+   */
+  private static parseHex;
+  /**
+   * Parse an RGB or RGBA string into RGBA values.
+   *
+   * @param {string} rgbString - The RGB/RGBA string (e.g., "rgb(255, 128, 0)" or "rgba(255, 128, 0, 0.5)").
+   * @returns {RgbaValue} The parsed RGBA value.
+   */
+  private static parseRgbString;
+  /**
+   * Convert RGB to HSL.
+   *
+   * @param {number} r - Red (0-255).
+   * @param {number} g - Green (0-255).
+   * @param {number} b - Blue (0-255).
+   * @returns {HslValue} The HSL values (h: 0-360, s: 0-1, l: 0-1).
+   */
+  private static rgbToHsl;
+  /**
+   * Convert HSL to RGB.
+   *
+   * @param {number} h - Hue (0-360).
+   * @param {number} s - Saturation (0-1).
+   * @param {number} l - Lightness (0-1).
+   * @returns {RgbValue} The RGB values (0-255).
+   */
+  private static hslToRgb;
+  /**
+   * Calculate the perceived brightness of a color using the YIQ formula.
+   * This matches tinycolor2's brightness calculation.
+   *
+   * @param {number} r - Red (0-255).
+   * @param {number} g - Green (0-255).
+   * @param {number} b - Blue (0-255).
+   * @returns {number} Brightness value (0-255).
+   */
+  private static getBrightness;
+  /**
+   * Check if the color is dark (brightness < 128).
+   *
+   * @returns {boolean} True if the color is considered dark.
+   */
+  isDark(): boolean;
+  /**
+   * Check if the color is light (brightness >= 128).
+   *
+   * @returns {boolean} True if the color is considered light.
+   */
+  isLight(): boolean;
+  /**
+   * Create a copy of this color.
+   *
+   * @returns {TinyColorPolyfill} A new TinyColorPolyfill instance with the same values.
+   */
+  clone(): TinyColorPolyfill;
+  /**
+   * Lighten the color by a given amount.
+   * Note: tinycolor2 accepts negative values to darken.
+   *
+   * @param {number} amount - The amount to lighten (0-100). Negative values darken.
+   * @returns {TinyColorPolyfill} This instance for chaining.
+   */
+  lighten(amount?: number): TinyColorPolyfill;
+  /**
+   * Darken the color by a given amount.
+   *
+   * @param {number} amount - The amount to darken (0-100).
+   * @returns {TinyColorPolyfill} This instance for chaining.
+   */
+  darken(amount?: number): TinyColorPolyfill;
+  /**
+   * Set the alpha (opacity) of the color.
+   *
+   * @param {number} alpha - The alpha value (0-1).
+   * @returns {TinyColorPolyfill} This instance for chaining.
+   */
+  setAlpha(alpha: number): TinyColorPolyfill;
+  /**
+   * Get the RGBA representation of the color.
+   *
+   * @returns {RgbaValue} The RGBA values.
+   */
+  toRgb(): RgbaValue;
+}
+/**
+ * Factory function to create a TinyColorPolyfill instance.
+ * This provides API compatibility with tinycolor2's default export.
+ *
+ * @param {string | RgbaValue} color - The color to parse.
+ * @returns {TinyColorPolyfill} A new TinyColorPolyfill instance.
+ */
+export declare function tinycolor(color: string | RgbaValue): TinyColorPolyfill;
+export {};

package/dist/types/polyfill/tinycolor/tinycolor-polyfill.test.d.ts

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

package/dist/types/types/components.type.d.ts

@@ -116,6 +116,7 @@ export {
 export { VegaCodeBlockValue } from '../components/vega-code-block/types';
 export { VegaComboBoxSize, VegaDropdownPropsForComboBox } from '../components/vega-combo-box/types';
 export {
+	DatePickerCalendarIndicator,
 	DatePickerCalendarRepickType,
 	DatePickerCalendarSizeType,
 	DatePickerModeType,
@@ -183,7 +184,10 @@ export {
 	VegaPaginationLayoutType,
 } from '../components/vega-pagination/types';
 export { PieChartOptions } from '../helpers/chart/pie-chart';
-export { VegaProgressTrackerDirectionType } from '../components/vega-progress-tracker/type';
+export {
+	VegaProgressTrackerDirectionType,
+	VegaProgressTrackerStepItem,
+} from '../components/vega-progress-tracker/type';
 export { VegaRTEContent } from '../components/vega-rich-text-editor/dto/content-state';
 export { VegaRTEExtension } from '../components/vega-rich-text-editor/extensions/extension.abstract';
 export {

package/dist/types/types/design-token.type.d.ts

@@ -7,15 +7,51 @@ import { Shadows } from '../constants/tokens/shadows';
 import { Spacing } from '../constants/tokens/spacing';
 import { TypographyKeys } from '../constants/tokens/typography';
 import { Borders } from '../constants/tokens/borders';
+/**
+ * Token key for border radius values.
+ */
 export declare type BorderRadiusTokenType = keyof typeof BorderRadius;
+/**
+ * Token key for breakpoints; includes a default fallback.
+ */
 export declare type BreakpointsTokenType = keyof typeof Breakpoints | 'default';
+/**
+ * Allowed values for color tokens.
+ */
 export declare type ColorsTokenType = typeof Colors[number];
+/**
+ * Allowed values for text color tokens.
+ */
 export declare type TextColorsTokenType = typeof TextColors[number];
+/**
+ * Allowed values for background color tokens.
+ */
 export declare type BackgroundColorsTokenType = typeof BackgroundColors[number];
+/**
+ * Allowed values for border color tokens.
+ */
 export declare type BorderColorsTokenType = typeof BorderColors[number];
+/**
+ * Allowed values for border style tokens.
+ */
 export declare type BordersTokenType = typeof Borders[number];
+/**
+ * Icon token string; can be from predefined list or a Font Awesome class.
+ */
 export declare type IconsTokenType = typeof Icons[number] | `fas ${string}`;
+/**
+ * Token values for ring styles.
+ */
 export declare type RingsTokenType = typeof Rings[number];
+/**
+ * Token values for shadow styles.
+ */
 export declare type ShadowsTokenType = typeof Shadows[number];
+/**
+ * Token key for spacing values.
+ */
 export declare type SpacingTokenType = keyof typeof Spacing;
+/**
+ * Token values for typography styles.
+ */
 export declare type TypographyTokenType = typeof TypographyKeys[number];