gradiente 2.4.0 → 3.0.0

package/dist/index.d.ts

@@ -84,30 +84,42 @@ declare function matchExpression(classified: GradientAbiInput[], patternTokens:
 declare function isValid(input: GradientAbiInput[], pattern: string): boolean;
 declare function validate(classified: GradientAbiInput[], pattern: string): boolean;
 //#endregion
-//#region src/gradients/helpers.d.ts
+//#region src/gradient/kind/hue/types.d.ts
 declare const GRADIENT_COLOR_SPACE: readonly ["oklab", "lch", "oklch", "hsl", "hwb", "lab", "srgb", "srgb-linear", "xyz", "display-p3", "a98-rgb", "prophoto-rgb", "rec2020"];
 declare const GRADIENT_HUE_INTERPOLATIONS: readonly ['shorter', 'longer', 'increasing', 'decreasing'];
 declare const GRADIENT_POLAR_COLOR_SPACES: readonly ["hsl", "hwb", "lch", "oklch"];
 type GradientHueInterpolation = (typeof GRADIENT_HUE_INTERPOLATIONS)[number];
 type GradientColorSpace = (typeof GRADIENT_COLOR_SPACE)[number];
 type GradientPolarColorSpace = (typeof GRADIENT_POLAR_COLOR_SPACES)[number];
+//#endregion
+//#region src/gradient/kind/hue/index.d.ts
 declare function isGradientHueInterpolation(value: string): value is GradientHueInterpolation;
 declare function isGradientColorSpace(value: string): value is GradientColorSpace;
 declare function isGradientPolarColorSpace(value: string): value is GradientPolarColorSpace;
 //#endregion
-//#region src/gradients/types.d.ts
+//#region src/gradient/kind/base/types.d.ts
+type GradientType = string;
+type GradientStopKind = "color-stop" | "color-hint";
+type GradientColorStop<TPosition = number, TMeta extends object = {}> = {
+  type: "color-stop";
+  value: string;
+  position: TPosition;
+} & TMeta;
+type GradientColorHint<TPosition = number> = {
+  type: "color-hint";
+  position: TPosition;
+};
+type GradientStop<TPosition = number, TMeta extends object = {}> = GradientColorStop<TPosition, TMeta> | GradientColorHint<TPosition>;
 type GradientInterpolation = {
   colorSpace: GradientColorSpace;
   hue?: GradientHueInterpolation;
 };
-/**
- * Shared scalar units
- */
-type GradientAngleUnit = "deg" | "rad" | "turn" | "grad";
 type GradientLengthUnit = "px" | "em" | "rem" | "vw" | "vh" | "vmin" | "vmax" | "cm" | "mm" | "in" | "pt" | "pc";
-type GradientNumberValue = {
-  kind: "number";
+type GradientAngleUnit = "deg" | "rad" | "turn" | "grad";
+type GradientAngleValue = {
+  kind: "angle";
   value: number;
+  unit: GradientAngleUnit;
 };
 type GradientPercentValue = {
   kind: "percent";
@@ -118,18 +130,9 @@ type GradientLengthValue = {
   value: number;
   unit: GradientLengthUnit;
 };
-type GradientAngleValue = {
-  kind: "angle";
-  value: number;
-  unit: GradientAngleUnit;
-};
 type GradientLengthPercentage = GradientLengthValue | GradientPercentValue;
 type GradientPositionKeywordX = "left" | "center" | "right";
 type GradientPositionKeywordY = "top" | "center" | "bottom";
-/**
- * Position model
- * Не строка, а нормальная структура.
- */
 type GradientPosition = {
   kind: "keywords";
   x: GradientPositionKeywordX;
@@ -139,295 +142,664 @@ type GradientPosition = {
   x: GradientLengthPercentage;
   y: GradientLengthPercentage;
 };
-/**
- * Color interpolation
- * Вынесено отдельно от geometry.
- * Это критично для future-proof модели.
- */
-type GradientHueInterpolationMethod = "shorter" | "longer" | "increasing" | "decreasing";
-type GradientRectangularColorSpace = "srgb" | "srgb-linear" | "display-p3" | "display-p3-linear" | "a98-rgb" | "prophoto-rgb" | "rec2020" | "lab" | "oklab" | "xyz" | "xyz-d50" | "xyz-d65";
-type GradientColorInterpolation = {
-  kind: "rectangular";
-  space: GradientRectangularColorSpace;
-} | {
-  kind: "polar";
-  space: GradientPolarColorSpace;
-  hueMethod?: GradientHueInterpolationMethod;
-};
-/**
- * Shared stop model
- * Твой текущий stop layer сюда ложится нормально.
- */
-type GradientColorStop = {
-  type: "color-stop";
-  color: string;
-  position: number | null;
-};
-type GradientColorHint = {
-  type: "color-hint";
-  position: number;
-};
-type GradientStop = {
-  type: "color-stop" | "color-hint";
-  value: string;
-  position: number;
-};
-/**
- * Base config fields common to all gradient classes
- */
-type GradientCommonConfig = {
-  interpolation?: GradientColorInterpolation | null;
+type GradientJSON<TConfig extends object = Record<string, never>, TExtra extends object = {}> = {
+  type: GradientType;
+  config: TConfig;
+} & TExtra;
+type GradientWithStopsJSONExtra = {
+  isRepeating?: boolean;
 };
-//#endregion
-//#region src/gradients/GradientBase.d.ts
-type GradientType = string;
-interface GradientLike<TJSON = unknown> {
+type GradientWithStopsJSON<TStop = GradientStop, TConfig extends object = Record<string, never>> = GradientJSON<TConfig, {
+  stops: TStop[];
+}>;
+interface IGradient<TConfig extends object = Record<string, never>> {
   readonly type: GradientType;
+  getConfig(): TConfig;
   clone(): this;
+  equals(other: unknown): boolean;
   toString(): string;
-  toJSON(): TJSON & {
-    type: GradientType;
-  };
+  toJSON(): GradientJSON<TConfig>;
 }
-interface GradientData<TConfig = unknown> {
-  isRepeating: boolean;
-  config: TConfig;
-  stops: GradientStop[];
-}
-interface IGradientBase<TConfig = unknown> extends GradientLike<GradientData<TConfig>> {
-  readonly type: GradientType;
-  readonly isRepeating: boolean;
-  readonly config: TConfig;
-  readonly stops: GradientStop[];
-  toJSON(): GradientData<TConfig> & {
-    type: GradientType;
-  };
-  addStop(stop: GradientStop): void;
+interface IGradientWithStops<TStop = GradientStop, TConfig extends object = Record<string, never>> extends IGradient<TConfig> {
+  isRepeating(): boolean;
+  getStops(): TStop[];
+  addStop(stop: TStop): void;
   removeStop(index: number): void;
-  equals(other: IGradientBase<TConfig>): boolean;
+  minColorStopsCount(): number;
+  toJSON(): GradientWithStopsJSON<TStop, TConfig>;
 }
-declare abstract class GradientBase<TConfig = unknown> implements IGradientBase<TConfig> {
-  abstract readonly type: GradientType;
-  private _isRepeating;
+//#endregion
+//#region src/gradient/kind/base/GradientBase.d.ts
+type SerializedStopToken = {
+  type: "color-hint";
+  position: number;
+} | {
+  type: "color-stop";
+  value: string;
+  positions: [number] | [number, number];
+};
+declare abstract class GradientBase<TConfig extends object = Record<string, never>> implements IGradient<TConfig> {
+  readonly type: GradientType;
   private _config;
-  private _stops;
-  constructor(options: GradientData<TConfig>);
-  get isRepeating(): boolean;
-  get config(): TConfig;
-  get stops(): GradientStop[];
+  constructor(type: GradientType, config: TConfig);
+  getConfig(): TConfig;
   abstract clone(): this;
+  abstract equals(other: unknown): boolean;
   abstract toString(): string;
-  toJSON(): GradientData<TConfig> & {
-    type: GradientType;
-  };
-  addStop(stop: GradientStop): void;
-  static fromString(_: string): void;
-  static fromAbi(_: GradientAbi): void;
-  removeStop(index: number): void;
-  equals(other: IGradientBase<TConfig>): boolean;
-  protected _minColorStopsCount(): number;
-  protected _getSortedStops(stops: GradientStop[]): GradientStop[];
+  toJSON(): GradientJSON<TConfig>;
   protected abstract _validateConfig(value: TConfig): void;
-  private _validateStops;
-  protected _validateStopsShape(value: GradientStop[]): void;
-  protected _validateStopsSequence(value: GradientStop[]): void;
-  private _cloneStops;
   private _cloneConfig;
-  protected _buildSerializedStopTokens(): Array<{
-    type: 'color-hint';
-    position: number;
-  } | {
-    type: 'color-stop';
-    value: string;
-    positions: [number] | [number, number];
+}
+declare abstract class GradientWithStopsBase<TStop extends GradientStop<number, object>, TConfig extends GradientWithStopsJSONExtra & {
+  interpolation: GradientInterpolation;
+}> extends GradientBase<TConfig> implements IGradientWithStops<TStop, TConfig> {
+  private _stops;
+  constructor(type: GradientType, stops: TStop[], config: TConfig);
+  static fromAbi(abi: GradientAbi): GradientWithStopsBase<GradientStop, GradientWithStopsJSONExtra & {
+    interpolation: GradientInterpolation;
+  }>;
+  static fromString(input: string): GradientWithStopsBase<GradientStop, GradientWithStopsJSONExtra & {
+    interpolation: GradientInterpolation;
   }>;
-  protected _canOmitAllStopPositions(tokens: Array<{
-    type: 'color-hint';
-    position: number;
-  } | {
-    type: 'color-stop';
-    value: string;
-    positions: [number] | [number, number];
-  }>): boolean;
+  private static _normalizeConfigInterpolation;
+  isRepeating(): boolean;
+  minColorStopsCount(): number;
+  getStops(): TStop[];
+  toJSON(): GradientWithStopsJSON<TStop, TConfig>;
+  addStop(stop: TStop): void;
+  removeStop(index: number): void;
   protected _serializeStopsCompact(): string[];
+  protected _buildSerializedStopTokens(): SerializedStopToken[];
+  protected _canOmitAllStopPositions(tokens: SerializedStopToken[]): boolean;
   protected _formatPercent(value: number): number;
   protected static _normalizeAbiInputsToStops(inputs: GradientAbiInput[]): GradientStop[];
   private static _parsePosition;
   private static _parseColorStopInput;
   private static _resolvePendingStops;
+  private _cloneStops;
+  private _getSortedStops;
+  private _validateStops;
+  private _validateStopsShape;
+  private _validateStopsSequence;
 }
 //#endregion
-//#region src/gradients/LinearGradient.d.ts
-type LinearGradientConfig = {
+//#region src/gradient/kind/base/geometry.d.ts
+declare function parseGradientAngle(input: string): GradientAngleValue;
+declare function formatGradientAngle(value: GradientAngleValue): string;
+declare function parseGradientLengthPercentage(input: string): GradientLengthPercentage;
+declare function formatGradientLengthPercentage(value: GradientLengthPercentage): string;
+declare function isGradientLengthPercentageToken(value: string | undefined): value is string;
+declare function parseGradientPosition(tokens: string[]): GradientPosition;
+declare function formatGradientPosition(position: GradientPosition): string;
+declare function validateGradientAngle(value: GradientAngleValue): void;
+declare function validateGradientLengthPercentage(value: GradientLengthPercentage): void;
+declare function validateGradientPosition(position: GradientPosition): void;
+declare function isDefaultGradientPosition(position: GradientPosition): boolean;
+//#endregion
+//#region src/gradient/kind/linear/types.d.ts
+/**
+ * Discriminator for linear gradient instances and serialized linear gradient data.
+ *
+ * Дискриминатор для экземпляров линейного градиента и его сериализованных данных.
+ */
+type GradientLinearType = "linear-gradient";
+/**
+ * Stop model used by linear gradients.
+ *
+ * Модель stop-точки, которую использует линейный градиент.
+ *
+ * @remarks
+ * This currently maps to the shared Gradiente stop model: color stops and color hints.
+ *
+ * Сейчас это общий stop-слой Gradiente: цветовые stop-точки и color hints.
+ */
+type GradientLinearStop = GradientStop;
+/**
+ * Configuration for the internal linear gradient model.
+ *
+ * Конфигурация внутренней модели линейного градиента.
+ *
+ * @remarks
+ * Renderer-specific concepts such as CSS direction keywords belong to parsers or serializers.
+ * The core model stores geometry as a normalized numeric angle.
+ *
+ * Renderer-специфичные понятия, например CSS-направления через keywords, относятся к
+ * парсерам или сериализаторам. В core-модели геометрия хранится как нормализованный числовой угол.
+ */
+type GradientLinearConfig = GradientWithStopsJSONExtra & {
+  /**
+   * Direction angle in radians, normalized to the internal Gradiente angle model.
+   *
+   * Угол направления в радианах, нормализованный под внутреннюю модель углов Gradiente.
+   */
   angle: number;
-  interpolation?: GradientInterpolation;
-};
-declare class LinearGradient extends GradientBase<LinearGradientConfig> {
-  readonly type = "linear-gradient";
-  constructor(config: GradientData<LinearGradientConfig>);
-  static normalizeConfig(value: string): LinearGradientConfig;
-  static fromString(input: string): LinearGradient;
-  static fromAbi(abi: GradientAbi): LinearGradient;
+  /**
+   * Color interpolation settings used between color stops.
+   *
+   * Настройки цветовой интерполяции между цветовыми stop-точками.
+   */
+  interpolation: GradientInterpolation;
+};
+/**
+ * JSON representation of a linear gradient in Gradiente's internal model.
+ *
+ * JSON-представление линейного градиента во внутренней модели Gradiente.
+ *
+ * @remarks
+ * This is not a CSS string or renderer adapter payload. It preserves the typed config and stops.
+ *
+ * Это не CSS-строка и не payload renderer-адаптера. Здесь сохраняются типизированные
+ * config и stops.
+ */
+type GradientLinearJSON = GradientWithStopsJSON<GradientLinearStop, GradientLinearConfig> & {
+  /**
+   * Serialized gradient type discriminator.
+   *
+   * Дискриминатор типа сериализованного градиента.
+   */
+  type: GradientLinearType;
+};
+/**
+ * Optional constructor config for a linear gradient.
+ *
+ * Опциональная конфигурация конструктора линейного градиента.
+ *
+ * @remarks
+ * Every config field is optional. Missing values are resolved from the class defaults.
+ *
+ * Все поля config опциональны. Отсутствующие значения заполняются дефолтами класса.
+ */
+type GradientLinearConfigInput = Omit<Partial<GradientLinearConfig>, "interpolation"> & {
+  /**
+   * Optional color interpolation overrides.
+   *
+   * Опциональные переопределения цветовой интерполяции.
+   */
+  interpolation?: Partial<GradientInterpolation>;
+};
+/**
+ * Public instance contract for a linear gradient.
+ *
+ * Публичный контракт экземпляра линейного градиента.
+ *
+ * @remarks
+ * The interface exposes the renderer-agnostic model: typed config, typed stops,
+ * cloning, equality, string serialization, and JSON serialization inherited from the base contract.
+ *
+ * Интерфейс раскрывает renderer-agnostic модель: типизированный config, типизированные stops,
+ * клонирование, сравнение, строковую сериализацию и JSON-сериализацию из базового контракта.
+ */
+interface IGradientLinear extends IGradientWithStops<GradientLinearStop, GradientLinearConfig> {
+  /**
+   * Linear gradient type discriminator.
+   *
+   * Дискриминатор типа линейного градиента.
+   */
+  readonly type: GradientLinearType;
+}
+//#endregion
+//#region src/gradient/kind/linear/GradientLinear.d.ts
+declare class GradientLinear extends GradientWithStopsBase<GradientLinearStop, GradientLinearConfig> implements IGradientLinear {
+  private static readonly DEFAULT_CONFIG;
+  readonly type: GradientLinearType;
+  constructor(stops: GradientLinearStop[], config?: GradientLinearConfigInput);
+  static normalizeConfig(input: string): GradientLinearConfig;
+  static fromString(input: string): GradientLinear;
+  static fromAbi(abi: GradientAbi): GradientLinear;
   clone(): this;
+  equals(other: unknown): boolean;
+  toJSON(): GradientLinearJSON;
   toString(): string;
-  protected _validateConfig(_: LinearGradientConfig): void;
-  private static _normalizeConfigInterpolation;
-  private _parseConfigToString;
-  private _parseAngleToString;
-  private _parseInterpolationToString;
+  protected _validateConfig(config: GradientLinearConfig): void;
+  private static _resolveConfig;
+  private static _parseAngleToken;
   private static _tokenizeConfigInput;
+  private _serializeConfig;
+  private _serializeAngle;
+  private _serializeInterpolation;
+  private _isDefaultInterpolation;
 }
 //#endregion
-//#region src/gradients/RadialGradient.d.ts
-type RadialGradientShape = "circle" | "ellipse";
-type RadialGradientExtent = "closest-side" | "closest-corner" | "farthest-side" | "farthest-corner";
-type RadialGradientSize = {
+//#region src/gradient/kind/radial/types.d.ts
+/**
+ * Discriminator for radial gradient instances and serialized radial gradient data.
+ *
+ * Дискриминатор для экземпляров радиального градиента и его сериализованных данных.
+ */
+type GradientRadialType = "radial-gradient";
+/**
+ * Stop model used by radial gradients.
+ *
+ * Модель stop-точки, которую использует радиальный градиент.
+ */
+type GradientRadialStop = GradientStop;
+/**
+ * Shape of a radial gradient.
+ *
+ * Форма радиального градиента.
+ */
+type GradientRadialShape = "circle" | "ellipse";
+/**
+ * Keyword extent used to resolve radial gradient size.
+ *
+ * Keyword-область, через которую определяется размер радиального градиента.
+ */
+type GradientRadialExtent = "closest-side" | "closest-corner" | "farthest-side" | "farthest-corner";
+/**
+ * Internal size model for radial gradients.
+ *
+ * Внутренняя модель размера радиального градиента.
+ */
+type GradientRadialSize = {
   kind: "extent";
-  value: RadialGradientExtent;
+  value: GradientRadialExtent;
 } | {
   kind: "explicit";
   x: GradientLengthPercentage;
   y?: GradientLengthPercentage;
 };
-type RadialGradientConfig = {
-  shape: RadialGradientShape;
-  size: RadialGradientSize;
+/**
+ * Configuration for the internal radial gradient model.
+ *
+ * Конфигурация внутренней модели радиального градиента.
+ */
+type GradientRadialConfig = GradientWithStopsJSONExtra & {
+  shape: GradientRadialShape;
+  size: GradientRadialSize;
   position: GradientPosition;
-  interpolation?: GradientInterpolation;
+  interpolation: GradientInterpolation;
+};
+/**
+ * Optional constructor config for a radial gradient.
+ *
+ * Опциональная конфигурация конструктора радиального градиента.
+ */
+type GradientRadialConfigInput = Omit<Partial<GradientRadialConfig>, "interpolation"> & {
+  interpolation?: Partial<GradientInterpolation>;
 };
-declare class RadialGradient extends GradientBase<RadialGradientConfig> {
+/**
+ * JSON representation of a radial gradient in Gradiente's internal model.
+ *
+ * JSON-представление радиального градиента во внутренней модели Gradiente.
+ */
+type GradientRadialJSON<TType extends string = GradientRadialType> = GradientWithStopsJSON<GradientRadialStop, GradientRadialConfig> & {
+  type: TType;
+};
+/**
+ * Public instance contract for a radial gradient.
+ *
+ * Публичный контракт экземпляра радиального градиента.
+ */
+interface IGradientRadial extends IGradientWithStops<GradientRadialStop, GradientRadialConfig> {
+  readonly type: GradientRadialType;
+}
+//#endregion
+//#region src/gradient/kind/radial/GradientRadial.d.ts
+declare class GradientRadial<TType extends string = GradientRadialType> extends GradientWithStopsBase<GradientRadialStop, GradientRadialConfig> {
+  protected static readonly gradientType: string;
   private static readonly DEFAULT_CONFIG;
-  readonly type: GradientType;
-  constructor(input: Partial<GradientData<RadialGradientConfig>>);
-  static fromString(input: string): RadialGradient;
-  static fromAbi(abi: GradientAbi): RadialGradient;
+  readonly type: TType;
+  constructor(stops: GradientRadialStop[], config?: GradientRadialConfigInput);
+  static normalizeConfig(input: string): GradientRadialConfig;
+  static fromString(input: string): GradientRadial<string>;
+  static fromAbi(abi: GradientAbi): GradientRadial<string>;
   clone(): this;
+  equals(other: unknown): boolean;
+  minColorStopsCount(): number;
+  toJSON(): GradientRadialJSON<TType>;
   toString(): string;
-  protected _validateConfig(config: RadialGradientConfig): void;
-  private _parseConfigToString;
-  private _parseRadialConfigToString;
-  private _parseRadialSizeToString;
-  private _parseInterpolationToString;
-  private _isDefaultRadialShape;
-  private _isDefaultRadialSize;
-  private _isDefaultRadialPosition;
+  protected _validateConfig(config: GradientRadialConfig): void;
+  private static _resolveConfig;
+  protected static _parseConfig(inputs: GradientAbiInput[]): GradientRadialConfig;
+  private static _parseConfigInput;
+  private static _parseRadialPosition;
+  private static _parseKeywordPosition;
+  private static _parseLengthPercentage;
+  private static _isShape;
+  private static _isExtent;
+  private static _isLengthPercentageToken;
+  private static _isLengthUnit;
+  private static _isPositionKeywordX;
+  private static _isPositionKeywordY;
+  private _serializeConfig;
+  private _serializeRadialConfig;
+  private _serializeSize;
   private _serializePosition;
+  private _serializeInterpolation;
   private _formatLengthPercentage;
-  protected static _parseConfig(inputs: GradientAbiInput[]): RadialGradientConfig;
-  private static _parseLengthPercentage;
-  private static _normalizeConfigInterpolation;
-}
-//#endregion
-//#region src/gradients/DiamondGradient.d.ts
-type DiamondGradientConfig = RadialGradientConfig;
-declare class DiamondGradient extends RadialGradient {
-  readonly type: GradientType;
-  constructor(input: Partial<GradientData<DiamondGradientConfig>>);
-  static fromString(input: string): DiamondGradient;
-  static fromAbi(abi: GradientAbi): DiamondGradient;
-  clone(): this;
+  private _isDefaultShape;
+  private _isDefaultSize;
+  private _isDefaultPosition;
+  private _isDefaultInterpolation;
+  private _validateSize;
+  private _validatePosition;
+  private _validateLengthPercentage;
 }
 //#endregion
-//#region src/gradients/ConicGradient.d.ts
-type ConicGradientConfig = {
+//#region src/gradient/kind/conic/types.d.ts
+/**
+ * Discriminator for conic gradient instances and serialized conic gradient data.
+ *
+ * Дискриминатор для экземпляров конического градиента и его сериализованных данных.
+ */
+type GradientConicType = "conic-gradient";
+/**
+ * Stop model used by conic gradients.
+ *
+ * Модель stop-точки, которую использует конический градиент.
+ */
+type GradientConicStop = GradientStop;
+/**
+ * Configuration for the internal conic gradient model.
+ *
+ * Конфигурация внутренней модели конического градиента.
+ */
+type GradientConicConfig = GradientWithStopsJSONExtra & {
   from: GradientAngleValue;
   position: GradientPosition;
-  interpolation?: GradientInterpolation;
+  interpolation: GradientInterpolation;
 };
-declare class ConicGradient extends GradientBase<ConicGradientConfig> {
-  readonly type = "conic-gradient";
-  constructor(config: GradientData<ConicGradientConfig>);
+/**
+ * Optional constructor config for a conic gradient.
+ *
+ * Опциональная конфигурация конструктора конического градиента.
+ */
+type GradientConicConfigInput = Omit<Partial<GradientConicConfig>, "interpolation"> & {
+  interpolation?: Partial<GradientInterpolation>;
+};
+/**
+ * JSON representation of a conic gradient in Gradiente's internal model.
+ *
+ * JSON-представление конического градиента во внутренней модели Gradiente.
+ */
+type GradientConicJSON = GradientWithStopsJSON<GradientConicStop, GradientConicConfig> & {
+  type: GradientConicType;
+};
+/**
+ * Public instance contract for a conic gradient.
+ *
+ * Публичный контракт экземпляра конического градиента.
+ */
+interface IGradientConic extends IGradientWithStops<GradientConicStop, GradientConicConfig> {
+  readonly type: GradientConicType;
+}
+//#endregion
+//#region src/gradient/kind/conic/GradientConic.d.ts
+declare class GradientConic extends GradientWithStopsBase<GradientConicStop, GradientConicConfig> implements IGradientConic {
+  private static readonly DEFAULT_CONFIG;
+  readonly type: GradientConicType;
+  constructor(stops: GradientConicStop[], config?: GradientConicConfigInput);
+  static normalizeConfig(input: string): GradientConicConfig;
+  static fromString(input: string): GradientConic;
+  static fromAbi(abi: GradientAbi): GradientConic;
   clone(): this;
+  equals(other: unknown): boolean;
+  minColorStopsCount(): number;
+  toJSON(): GradientConicJSON;
   toString(): string;
-  static fromString(input: string): ConicGradient;
-  static fromAbi(abi: GradientAbi): ConicGradient;
-  protected _validateConfig(config: ConicGradientConfig): void;
+  protected _validateConfig(config: GradientConicConfig): void;
+  private static _resolveConfig;
+  private static _parseConfigInput;
   private _serializeConfig;
-  private _serializePosition;
-  private _formatLengthPercentage;
   private _serializeInterpolation;
   private _isDefaultFrom;
-  private _isDefaultPosition;
-  private static _parseConfig;
-  private static _parseLengthPercentage;
-  private static _parseAngle;
+  private _isDefaultInterpolation;
+}
+//#endregion
+//#region src/gradient/kind/diamond/types.d.ts
+/**
+ * Discriminator for diamond gradient instances and serialized diamond gradient data.
+ *
+ * Дискриминатор для экземпляров diamond-градиента и его сериализованных данных.
+ */
+type GradientDiamondType = "diamond-gradient";
+/**
+ * Stop model used by diamond gradients.
+ *
+ * Модель stop-точки, которую использует diamond-градиент.
+ */
+type GradientDiamondStop = GradientRadialStop;
+/**
+ * Configuration for the internal diamond gradient model.
+ *
+ * Конфигурация внутренней модели diamond-градиента.
+ */
+type GradientDiamondConfig = GradientRadialConfig;
+/**
+ * Optional constructor config for a diamond gradient.
+ *
+ * Опциональная конфигурация конструктора diamond-градиента.
+ */
+type GradientDiamondConfigInput = GradientRadialConfigInput;
+/**
+ * JSON representation of a diamond gradient in Gradiente's internal model.
+ *
+ * JSON-представление diamond-градиента во внутренней модели Gradiente.
+ */
+type GradientDiamondJSON = GradientWithStopsJSON<GradientDiamondStop, GradientDiamondConfig> & {
+  type: GradientDiamondType;
+};
+/**
+ * Public instance contract for a diamond gradient.
+ *
+ * Публичный контракт экземпляра diamond-градиента.
+ */
+interface IGradientDiamond extends IGradientWithStops<GradientDiamondStop, GradientDiamondConfig> {
+  readonly type: GradientDiamondType;
 }
 //#endregion
-//#region src/gradients/MeshGradient.d.ts
-type MeshGradientInterpolationMethod = "bilinear" | "bicubic";
-type MeshGradientPatchSide = "top" | "right" | "bottom" | "left";
-type MeshGradientConfig = {
+//#region src/gradient/kind/diamond/GradientDiamond.d.ts
+declare class GradientDiamond extends GradientRadial<GradientDiamondType> implements IGradientDiamond {
+  protected static readonly gradientType: string;
+  constructor(stops: GradientDiamondStop[], config?: GradientDiamondConfigInput);
+  static fromString(input: string): GradientDiamond;
+  static fromAbi(abi: GradientAbi): GradientDiamond;
+  clone(): this;
+  equals(other: unknown): boolean;
+  toJSON(): GradientDiamondJSON;
+}
+//#endregion
+//#region src/gradient/kind/mesh/types.d.ts
+/**
+ * Discriminator for mesh gradient instances and serialized mesh gradient data.
+ *
+ * Дискриминатор для экземпляров mesh-градиента и его сериализованных данных.
+ */
+type GradientMeshType = "mesh-gradient";
+/**
+ * Surface interpolation method used to sample colors inside mesh patches.
+ *
+ * Метод интерполяции поверхности, который используется для сэмплинга цветов внутри mesh-патчей.
+ */
+type GradientMeshInterpolationMethod = "bilinear" | "bicubic";
+/**
+ * Patch edge that can carry optional cubic control handles.
+ *
+ * Сторона патча, на которой могут быть опциональные cubic-контрольные ручки.
+ */
+type GradientMeshPatchSide = "top" | "right" | "bottom" | "left";
+/**
+ * Configuration for the internal mesh gradient model.
+ *
+ * Конфигурация внутренней модели mesh-градиента.
+ *
+ * @remarks
+ * The grid describes the regular topology expected by renderers and samplers.
+ * Vertices may still be spatially distorted: `rows` and `columns` describe topology, not visual alignment.
+ *
+ * Grid описывает регулярную топологию для рендереров и сэмплеров.
+ * Вершины могут быть визуально искажены: `rows` и `columns` описывают топологию, а не выравнивание на плоскости.
+ */
+type GradientMeshConfig = {
+  /**
+   * Number of vertex rows in the mesh topology.
+   *
+   * Количество рядов вершин в mesh-топологии.
+   */
   rows: number;
+  /**
+   * Number of vertex columns in the mesh topology.
+   *
+   * Количество колонок вершин в mesh-топологии.
+   */
   columns: number;
-  method: MeshGradientInterpolationMethod;
-  interpolation?: GradientInterpolation;
+  /**
+   * Color sampling method inside each patch.
+   *
+   * Метод сэмплинга цвета внутри каждого патча.
+   */
+  method: GradientMeshInterpolationMethod;
+  /**
+   * Color interpolation settings used when sampling mesh colors.
+   *
+   * Настройки цветовой интерполяции, используемые при сэмплинге цветов mesh-градиента.
+   */
+  interpolation: GradientInterpolation;
+};
+/**
+ * Optional constructor config for a mesh gradient.
+ *
+ * Опциональная конфигурация конструктора mesh-градиента.
+ *
+ * @remarks
+ * Every config field is optional. Missing `rows` and `columns` are inferred from vertex ids or counts when possible,
+ * then fall back to the class defaults.
+ *
+ * Все поля config опциональны. Отсутствующие `rows` и `columns` по возможности выводятся из id вершин или количества
+ * элементов, а затем заменяются дефолтами класса.
+ */
+type GradientMeshConfigInput = Omit<Partial<GradientMeshConfig>, "interpolation"> & {
+  /**
+   * Optional color interpolation overrides.
+   *
+   * Опциональные переопределения цветовой интерполяции.
+   */
+  interpolation?: Partial<GradientInterpolation>;
 };
-type MeshGradientVertex = {
+/**
+ * Mesh vertex in Gradiente's internal model.
+ *
+ * Mesh-вершина во внутренней модели Gradiente.
+ */
+type GradientMeshVertex = {
+  /**
+   * Stable vertex id referenced by patches.
+   *
+   * Стабильный id вершины, на который ссылаются патчи.
+   */
   id: string;
+  /**
+   * Horizontal vertex position.
+   *
+   * Горизонтальная позиция вершины.
+   */
   x: GradientLengthPercentage;
+  /**
+   * Vertical vertex position.
+   *
+   * Вертикальная позиция вершины.
+   */
   y: GradientLengthPercentage;
+  /**
+   * Vertex color in any Culori-readable color format.
+   *
+   * Цвет вершины в любом формате, который может прочитать Culori.
+   */
   color: string;
 };
-type MeshGradientHandle = {
+/**
+ * Cubic handle coordinate used by mesh patch edges.
+ *
+ * Координата cubic-ручки, используемая сторонами mesh-патча.
+ */
+type GradientMeshHandle = {
   x: GradientLengthPercentage;
   y: GradientLengthPercentage;
 };
-type MeshGradientPatch = {
+/**
+ * Optional pair of edge handles for a mesh patch side.
+ *
+ * Опциональная пара edge-ручек для стороны mesh-патча.
+ */
+type GradientMeshPatchHandle = {
+  from: GradientMeshHandle;
+  to: GradientMeshHandle;
+};
+/**
+ * Optional handle map keyed by patch side.
+ *
+ * Опциональная карта ручек по сторонам патча.
+ */
+type GradientMeshPatchHandles = Partial<Record<GradientMeshPatchSide, GradientMeshPatchHandle>>;
+/**
+ * Mesh patch made from four unique vertex references.
+ *
+ * Mesh-патч, состоящий из четырех уникальных ссылок на вершины.
+ */
+type GradientMeshPatch = {
+  /**
+   * Stable patch id.
+   *
+   * Стабильный id патча.
+   */
   id: string;
   topLeft: string;
   topRight: string;
   bottomRight: string;
   bottomLeft: string;
-  handles?: {
-    top?: {
-      from: MeshGradientHandle;
-      to: MeshGradientHandle;
-    };
-    right?: {
-      from: MeshGradientHandle;
-      to: MeshGradientHandle;
-    };
-    bottom?: {
-      from: MeshGradientHandle;
-      to: MeshGradientHandle;
-    };
-    left?: {
-      from: MeshGradientHandle;
-      to: MeshGradientHandle;
-    };
-  };
-};
-type MeshGradientData = {
-  config: MeshGradientConfig;
-  vertices: MeshGradientVertex[];
-  patches: MeshGradientPatch[];
-};
-declare class MeshGradient implements GradientLike<MeshGradientData> {
-  readonly type = "mesh-gradient";
-  private readonly _config;
+  handles?: GradientMeshPatchHandles;
+};
+/**
+ * JSON representation of a mesh gradient in Gradiente's internal model.
+ *
+ * JSON-представление mesh-градиента во внутренней модели Gradiente.
+ */
+type GradientMeshJSON = GradientJSON<GradientMeshConfig, {
+  vertices: GradientMeshVertex[];
+  patches: GradientMeshPatch[];
+}> & {
+  type: GradientMeshType;
+};
+/**
+ * Public instance contract for a mesh gradient.
+ *
+ * Публичный контракт экземпляра mesh-градиента.
+ */
+interface IGradientMesh extends IGradient<GradientMeshConfig> {
+  readonly type: GradientMeshType;
+  getVertices(): GradientMeshVertex[];
+  getPatches(): GradientMeshPatch[];
+  getVertex(id: string): GradientMeshVertex | null;
+  getPatch(id: string): GradientMeshPatch | null;
+  samplePatchColor(patchId: string, u: number, v: number): string;
+}
+//#endregion
+//#region src/gradient/kind/mesh/GradientMesh.d.ts
+declare class GradientMesh extends GradientBase<GradientMeshConfig> implements IGradientMesh {
+  private static readonly DEFAULT_CONFIG;
+  readonly type: GradientMeshType;
   private readonly _vertices;
   private readonly _patches;
-  constructor(input: MeshGradientData);
-  get config(): MeshGradientConfig;
-  get vertices(): MeshGradientVertex[];
-  get patches(): MeshGradientPatch[];
-  static fromString(input: string): MeshGradient;
-  static fromAbi(abi: GradientAbi): MeshGradient;
+  private _colorSampler?;
+  constructor(vertices: GradientMeshVertex[], patches: GradientMeshPatch[], config?: GradientMeshConfigInput);
+  static normalizeConfig(input: string): GradientMeshConfig;
+  static fromString(input: string): GradientMesh;
+  static fromAbi(abi: GradientAbi): GradientMesh;
   clone(): this;
-  toJSON(): MeshGradientData & {
-    type: "mesh-gradient";
-  };
+  equals(other: unknown): boolean;
+  toJSON(): GradientMeshJSON;
   toString(): string;
-  getVertex(id: string): MeshGradientVertex | null;
-  private _serializeConfig;
-  private _serializeVertex;
-  private _serializePatch;
-  private _serializeHandles;
-  private _formatLengthPercentage;
-  private _validate;
-  private _validateId;
-  private _validateHandles;
-  private _validateLengthPercentage;
+  getVertices(): GradientMeshVertex[];
+  getPatches(): GradientMeshPatch[];
+  getVertex(id: string): GradientMeshVertex | null;
+  getPatch(id: string): GradientMeshPatch | null;
+  samplePatchColor(patchId: string, u: number, v: number): string;
+  protected _validateConfig(config: GradientMeshConfig): void;
+  private static _resolveConfig;
+  private static _inferMissingColumns;
+  private static _inferGridSize;
+  private static _inferGridSizeFromVertexIds;
+  private static _inferGridSizeFromCounts;
   private static _parseConfig;
   private static _parseVertex;
   private static _parsePatch;
@@ -435,187 +807,285 @@ declare class MeshGradient implements GradientLike<MeshGradientData> {
   private static _attachHandles;
   private static _parseLengthPercentage;
   private static _normalizeInterpolation;
+  private static _isInterpolationMethod;
+  private static _isPatchSide;
   private static _parseFunction;
   private static _findOuterClosingParenIndex;
   private static _splitTopLevelInputs;
   private static _pushTrimmed;
+  private _validateMesh;
+  private _validateId;
+  private _validatePatchVertices;
+  private _validateHandles;
+  private _validateRegularPatchTopology;
+  private _serializeConfig;
+  private _serializeInterpolation;
+  private _serializeVertex;
+  private _serializePatch;
+  private _serializeHandles;
+  private _isDefaultInterpolation;
+  private _validateSampleCoordinate;
+  private _getColorSampler;
 }
 //#endregion
-//#region src/gradients/GradientFactory.d.ts
-interface IGradientStatic<TGradient extends GradientLike = GradientLike> {
-  fromAbi(abi: GradientAbi): TGradient;
-  fromString(input: string): TGradient;
-}
-declare class GradientFactory {
-  private static readonly _registry;
-  private static _initialized;
-  static add(type: string, value: IGradientStatic): void;
-  static get(functionName: string): IGradientStatic | null;
-  static remove(functionName: string): boolean;
-  static create(input: string | GradientAbi): AnyGradient;
-  static isValid(input: string): boolean;
-  private static _ensureInitialized;
-  private static _getFunctionName;
-}
-type AnyGradient = LinearGradient | RadialGradient | DiamondGradient | ConicGradient | MeshGradient;
-declare function parse(input: string): AnyGradient;
-declare function isGradient(input: string): boolean;
-declare function format(input: string | AnyGradient): string;
-declare function transformTo(target: string, input: string | AnyGradient): unknown;
-declare function transformFrom<TInput = unknown>(target: string, gradientType: string, input: TInput): AnyGradient;
-//#endregion
-//#region src/gradient-transformer/modules/types.d.ts
+//#region src/gradient/transformer/modules/types.d.ts
+type AnyGradient = GradientLinear | GradientRadial<string> | GradientDiamond | GradientConic | GradientMesh;
+type GradientTransformerTarget = "css" | "canvas-2d" | "canvas-webgl" | "svg" | string;
 interface IGradientTransformerModule<TOutput = unknown> {
   readonly target: string;
   readonly gradientType: string;
-  to(input: GradientLike): TOutput;
-  from?(input: TOutput): GradientLike;
+  to(input: AnyGradient): TOutput;
+  from?(input: TOutput): AnyGradient;
 }
 interface ICanvasPaintResult {
   draw(ctx: CanvasRenderingContext2D, width: number, height: number): void;
 }
+interface ISvgGradientResult {
+  id: string;
+  href: string;
+  url: string;
+  type: "linearGradient" | "radialGradient" | "pattern";
+  gradient: string;
+  defs: string;
+  svg: string;
+}
+//#endregion
+//#region src/gradient/transformer/modules/GradientTransformerModule.d.ts
+type GradientRuntimeClass<TGradient extends AnyGradient> = Function & {
+  prototype: TGradient;
+};
+type GradientTransformerModuleOptions<TGradient extends AnyGradient> = {
+  target: string;
+  gradientType: TGradient["type"];
+  gradientClass: GradientRuntimeClass<TGradient>;
+  expectedName: string;
+};
+declare abstract class GradientTransformerModule<TGradient extends AnyGradient, TOutput> implements IGradientTransformerModule<TOutput> {
+  readonly target: string;
+  readonly gradientType: TGradient["type"];
+  private readonly _gradientClass;
+  private readonly _expectedName;
+  protected constructor(options: GradientTransformerModuleOptions<TGradient>);
+  to(input: AnyGradient): TOutput;
+  protected abstract transform(gradient: TGradient): TOutput;
+  protected _expectGradient(input: AnyGradient): TGradient;
+}
+declare abstract class GradientCssStringTransformerModule<TGradient extends AnyGradient> extends GradientTransformerModule<TGradient, string> {
+  protected transform(gradient: TGradient): string;
+}
+//#endregion
+//#region src/gradient/transformer/modules/css/ModuleTransformerLinearGradientToCss.d.ts
+declare class ModuleTransformerLinearGradientToCss extends GradientCssStringTransformerModule<GradientLinear> {
+  constructor();
+}
+//#endregion
+//#region src/gradient/transformer/modules/css/ModuleTransformerRadialGradientToCss.d.ts
+declare class ModuleTransformerRadialGradientToCss extends GradientCssStringTransformerModule<GradientRadial> {
+  constructor();
+}
 //#endregion
-//#region src/gradient-transformer/modules/css/ModuleTransformerLinearGradientToCss.d.ts
-declare class ModuleTransformerLinearGradientToCss implements IGradientTransformerModule<string> {
-  readonly target = "css";
-  readonly gradientType = "linear-gradient";
-  to(input: GradientBase<any>): string;
-}
-//#endregion
-//#region src/gradient-transformer/modules/css/ModuleTransformerRadialGradientToCss.d.ts
-declare class ModuleTransformerRadialGradientToCss implements IGradientTransformerModule<string> {
-  readonly target = "css";
-  readonly gradientType = "radial-gradient";
-  to(input: GradientBase<any>): string;
-}
-//#endregion
-//#region src/gradient-transformer/modules/css/ModuleTransformerDiamondGradientToCss.d.ts
-declare class ModuleTransformerDiamondGradientToCss implements IGradientTransformerModule<string> {
-  readonly target = "css";
-  readonly gradientType = "diamond-gradient";
-  to(input: GradientBase<any>): string;
-}
-//#endregion
-//#region src/gradient-transformer/modules/css/ModuleTransformerConicGradientToCss.d.ts
-declare class ModuleTransformerConicGradientToCss implements IGradientTransformerModule<string> {
-  readonly target = "css";
-  readonly gradientType = "conic-gradient";
-  to(input: GradientBase<any>): string;
-}
-//#endregion
-//#region src/gradient-transformer/modules/css/ModuleTransformerMeshGradientToCss.d.ts
-declare class ModuleTransformerMeshGradientToCss implements IGradientTransformerModule<string> {
-  readonly target = "css";
-  readonly gradientType = "mesh-gradient";
-  to(input: GradientLike): string;
-}
-//#endregion
-//#region src/gradient-transformer/modules/canvas/ModuleTransformerLinearGradientToCanvas.d.ts
-declare class ModuleTransformerLinearGradientToCanvas implements IGradientTransformerModule<ICanvasPaintResult> {
-  readonly target = "canvas-2d";
-  readonly gradientType = "linear-gradient";
-  to(input: GradientBase<any>): ICanvasPaintResult;
-}
-//#endregion
-//#region src/gradient-transformer/modules/canvas/ModuleTransformerRadialGradientToCanvas.d.ts
-declare class ModuleTransformerRadialGradientToCanvas implements IGradientTransformerModule<ICanvasPaintResult> {
-  readonly target = "canvas-2d";
-  readonly gradientType = "radial-gradient";
-  to(input: GradientBase<any>): ICanvasPaintResult;
-  private _resolveCenter;
-  private _resolveKeywordX;
-  private _resolveKeywordY;
-  private _resolveRadialRadii;
-  private _resolve;
-}
-//#endregion
-//#region src/gradient-transformer/modules/canvas/ModuleTransformerDiamondGradientToCanvas.d.ts
-declare class ModuleTransformerDiamondGradientToCanvas implements IGradientTransformerModule<ICanvasPaintResult> {
-  readonly target = "canvas-2d";
-  readonly gradientType = "diamond-gradient";
-  to(input: GradientBase<any>): ICanvasPaintResult;
-  private _resolveCenter;
-  private _resolveKeywordX;
-  private _resolveKeywordY;
-  private _resolveDiamondRadii;
-  private _resolve;
-}
-//#endregion
-//#region src/gradient-transformer/modules/canvas/ModuleTransformerConicGradientToCanvas.d.ts
-declare class ModuleTransformerConicGradientToCanvas implements IGradientTransformerModule<ICanvasPaintResult> {
-  readonly target = "canvas-2d";
-  readonly gradientType = "conic-gradient";
-  to(input: GradientBase<any>): ICanvasPaintResult;
-  private _resolvePosition;
-  private _resolve;
-  private _resolveKeywordX;
-  private _resolveKeywordY;
-  private _toRad;
+//#region src/gradient/transformer/modules/css/ModuleTransformerDiamondGradientToCss.d.ts
+declare class ModuleTransformerDiamondGradientToCss extends GradientTransformerModule<GradientDiamond, string> {
+  constructor();
+  protected transform(gradient: GradientDiamond): string;
+}
+//#endregion
+//#region src/gradient/transformer/modules/css/ModuleTransformerConicGradientToCss.d.ts
+declare class ModuleTransformerConicGradientToCss extends GradientCssStringTransformerModule<GradientConic> {
+  constructor();
+}
+//#endregion
+//#region src/gradient/transformer/modules/css/ModuleTransformerMeshGradientToCss.d.ts
+declare class ModuleTransformerMeshGradientToCss extends GradientTransformerModule<GradientMesh, string> {
+  constructor();
+  protected transform(gradient: GradientMesh): string;
+}
+//#endregion
+//#region src/gradient/transformer/modules/canvas/ModuleTransformerLinearGradientToCanvas.d.ts
+declare class ModuleTransformerLinearGradientToCanvas extends GradientTransformerModule<GradientLinear, ICanvasPaintResult> {
+  constructor();
+  protected transform(gradient: GradientLinear): ICanvasPaintResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/canvas/ModuleTransformerRadialGradientToCanvas.d.ts
+declare class ModuleTransformerRadialGradientToCanvas extends GradientTransformerModule<GradientRadial, ICanvasPaintResult> {
+  constructor();
+  protected transform(gradient: GradientRadial): ICanvasPaintResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/canvas/ModuleTransformerDiamondGradientToCanvas.d.ts
+declare class ModuleTransformerDiamondGradientToCanvas extends GradientTransformerModule<GradientDiamond, ICanvasPaintResult> {
+  constructor();
+  protected transform(gradient: GradientDiamond): ICanvasPaintResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/canvas/ModuleTransformerConicGradientToCanvas.d.ts
+declare class ModuleTransformerConicGradientToCanvas extends GradientTransformerModule<GradientConic, ICanvasPaintResult> {
+  constructor();
+  protected transform(gradient: GradientConic): ICanvasPaintResult;
   private _normalizeStops;
   private _sampleColor;
-  private _mixColor;
-  private _parseColor;
-  private _clamp01;
 }
 //#endregion
-//#region src/gradient-transformer/modules/canvas/ModuleTransformerMeshGradientToCanvas.d.ts
-declare class ModuleTransformerMeshGradientToCanvas implements IGradientTransformerModule<ICanvasPaintResult> {
-  readonly target = "canvas-2d";
-  readonly gradientType = "mesh-gradient";
-  to(input: GradientLike): ICanvasPaintResult;
+//#region src/gradient/transformer/modules/canvas/ModuleTransformerMeshGradientToCanvas.d.ts
+declare class ModuleTransformerMeshGradientToCanvas extends GradientTransformerModule<GradientMesh, ICanvasPaintResult> {
+  constructor();
+  protected transform(gradient: GradientMesh): ICanvasPaintResult;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/types.d.ts
+//#region src/gradient/transformer/modules/helpers/color-stops.d.ts
+type GradientRenderableColorStop = Extract<GradientStop, {
+  type: "color-stop";
+}>;
+//#endregion
+//#region src/gradient/transformer/modules/webgl/helpers.d.ts
+/**
+ * RU: Создает и компилирует WebGL shader с подробной ошибкой компиляции.
+ * EN: Creates and compiles a WebGL shader with a detailed compile error.
+ */
+declare function createWebGLShader(gl: WebGLRenderingContext, type: number, source: string): WebGLShader;
+/**
+ * RU: Создает WebGL program из vertex/fragment shader source.
+ * EN: Creates a WebGL program from vertex/fragment shader source.
+ */
+declare function createWebGLProgram(gl: WebGLRenderingContext, vertexSource: string, fragmentSource: string): WebGLProgram;
+/**
+ * RU: Преобразует CSS-цвет в WebGL vec4 с каналами 0..1.
+ * EN: Converts a CSS color into a WebGL vec4 with 0..1 channels.
+ */
+declare function toWebGLColor(input: string): [number, number, number, number];
+/**
+ * RU: Подбирает количество samples на segment так, чтобы уложиться в лимит uniforms.
+ * EN: Picks per-segment sample count so the result fits the uniform limit.
+ */
+declare function getWebGLSampleCount(stops: GradientStop[], maxStops: number): number;
+/**
+ * RU: Уменьшает stops до WebGL-лимита, пересэмплируя цвета при необходимости.
+ * EN: Fits stops to the WebGL limit by resampling colors when necessary.
+ */
+declare function fitStopsToWebGLLimit(stops: GradientStop[], maxStops: number): GradientRenderableColorStop[];
+//#endregion
+//#region src/gradient/transformer/modules/webgl/types.d.ts
 interface IWebGLPaintResult {
   draw(canvas: HTMLCanvasElement, width: number, height: number): void;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/ModuleTransformerLinearGradientToWebgl.d.ts
-declare class ModuleTransformerLinearGradientToCanvasWebGL implements IGradientTransformerModule<IWebGLPaintResult> {
-  readonly target = "canvas-webgl";
-  readonly gradientType = "linear-gradient";
-  to(input: GradientBase<any>): IWebGLPaintResult;
+//#region src/gradient/transformer/modules/webgl/ModuleTransformerLinearGradientToWebgl.d.ts
+declare class ModuleTransformerLinearGradientToCanvasWebGL extends GradientTransformerModule<GradientLinear, IWebGLPaintResult> {
+  constructor();
+  protected transform(gradient: GradientLinear): IWebGLPaintResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/webgl/ModuleTransformerConicGradientToWebgl.d.ts
+declare class ModuleTransformerConicGradientToCanvasWebGL extends GradientTransformerModule<GradientConic, IWebGLPaintResult> {
+  constructor();
+  protected transform(gradient: GradientConic): IWebGLPaintResult;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/ModuleTransformerConicGradientToWebgl.d.ts
-declare class ModuleTransformerConicGradientToCanvasWebGL implements IGradientTransformerModule<IWebGLPaintResult> {
-  readonly target = "canvas-webgl";
-  readonly gradientType = "conic-gradient";
-  to(input: GradientBase<any>): IWebGLPaintResult;
+//#region src/gradient/transformer/modules/webgl/ModuleTransformerRadialGradientToWebgl.d.ts
+declare class ModuleTransformerRadialGradientToCanvasWebGL extends GradientTransformerModule<GradientRadial, IWebGLPaintResult> {
+  constructor();
+  protected transform(gradient: GradientRadial): IWebGLPaintResult;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/ModuleTransformerRadialGradientToWebgl.d.ts
-declare class ModuleTransformerRadialGradientToCanvasWebGL implements IGradientTransformerModule<IWebGLPaintResult> {
-  readonly target = "canvas-webgl";
-  readonly gradientType = "radial-gradient";
-  to(input: GradientBase<any>): IWebGLPaintResult;
+//#region src/gradient/transformer/modules/webgl/ModuleTransformerDiamondGradientToWebgl.d.ts
+declare class ModuleTransformerDiamondGradientToCanvasWebGL extends GradientTransformerModule<GradientDiamond, IWebGLPaintResult> {
+  constructor();
+  protected transform(gradient: GradientDiamond): IWebGLPaintResult;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/ModuleTransformerDiamondGradientToWebgl.d.ts
-declare class ModuleTransformerDiamondGradientToCanvasWebGL implements IGradientTransformerModule<IWebGLPaintResult> {
-  readonly target = "canvas-webgl";
-  readonly gradientType = "diamond-gradient";
-  to(input: GradientBase<any>): IWebGLPaintResult;
+//#region src/gradient/transformer/modules/webgl/ModuleTransformerMeshGradientToWebgl.d.ts
+declare class ModuleTransformerMeshGradientToCanvasWebGL extends GradientTransformerModule<GradientMesh, IWebGLPaintResult> {
+  constructor();
+  protected transform(gradient: GradientMesh): IWebGLPaintResult;
 }
 //#endregion
-//#region src/gradient-transformer/modules/webgl/ModuleTransformerMeshGradientToWebgl.d.ts
-declare class ModuleTransformerMeshGradientToCanvasWebGL implements IGradientTransformerModule<IWebGLPaintResult> {
-  readonly target = "canvas-webgl";
-  readonly gradientType = "mesh-gradient";
-  to(input: GradientLike): IWebGLPaintResult;
+//#region src/gradient/transformer/modules/svg/ModuleTransformerLinearGradientToSvg.d.ts
+declare class ModuleTransformerLinearGradientToSvg extends GradientTransformerModule<GradientLinear, ISvgGradientResult> {
+  constructor();
+  protected transform(gradientValue: GradientLinear): ISvgGradientResult;
 }
 //#endregion
-//#region src/gradient-transformer/GradientTransformer.d.ts
+//#region src/gradient/transformer/modules/svg/ModuleTransformerRadialGradientToSvg.d.ts
+declare class ModuleTransformerRadialGradientToSvg extends GradientTransformerModule<GradientRadial, ISvgGradientResult> {
+  constructor();
+  protected transform(gradientValue: GradientRadial): ISvgGradientResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/svg/ModuleTransformerConicGradientToSvg.d.ts
+declare class ModuleTransformerConicGradientToSvg extends GradientTransformerModule<GradientConic, ISvgGradientResult> {
+  constructor();
+  protected transform(gradientValue: GradientConic): ISvgGradientResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/svg/ModuleTransformerDiamondGradientToSvg.d.ts
+declare class ModuleTransformerDiamondGradientToSvg extends GradientTransformerModule<GradientDiamond, ISvgGradientResult> {
+  constructor();
+  protected transform(gradientValue: GradientDiamond): ISvgGradientResult;
+}
+//#endregion
+//#region src/gradient/transformer/modules/svg/ModuleTransformerMeshGradientToSvg.d.ts
+declare class ModuleTransformerMeshGradientToSvg extends GradientTransformerModule<GradientMesh, ISvgGradientResult> {
+  constructor();
+  protected transform(gradientValue: GradientMesh): ISvgGradientResult;
+}
+//#endregion
+//#region src/gradient/kind/GradientFactory.d.ts
+type BuiltInGradientFunctionName = "linear-gradient" | "radial-gradient" | "diamond-gradient" | "conic-gradient" | "mesh-gradient";
+type GradientByFunctionName = {
+  "linear-gradient": GradientLinear;
+  "radial-gradient": GradientRadial<string>;
+  "diamond-gradient": GradientDiamond;
+  "conic-gradient": GradientConic;
+  "mesh-gradient": GradientMesh;
+};
+type GradientTransformOutputByTarget = {
+  css: string;
+  "canvas-2d": ICanvasPaintResult;
+  "canvas-webgl": IWebGLPaintResult;
+  svg: ISvgGradientResult;
+};
+type GradientTransformTarget = keyof GradientTransformOutputByTarget;
+type GradientInstance = IGradient<object>;
+interface IGradientStatic<TGradient extends GradientInstance = GradientInstance> {
+  fromAbi(abi: GradientAbi): TGradient;
+  fromString(input: string): TGradient;
+}
+declare class GradientFactory {
+  private static readonly _registry;
+  private static _initialized;
+  static add<TGradient extends GradientInstance>(type: string, value: IGradientStatic<TGradient>): void;
+  static get<TFunctionName extends BuiltInGradientFunctionName>(functionName: TFunctionName): IGradientStatic<GradientByFunctionName[TFunctionName]> | null;
+  static get<TGradient extends GradientInstance = GradientInstance>(functionName: string): IGradientStatic<TGradient> | null;
+  static remove(functionName: string): boolean;
+  static create<TFunctionName extends BuiltInGradientFunctionName>(input: GradientAbi & {
+    functionName: TFunctionName;
+  }): GradientByFunctionName[TFunctionName];
+  static create(input: string | GradientAbi): AnyGradient;
+  static isValid(input: string): boolean;
+  private static _ensureInitialized;
+  private static _readFunctionName;
+  private static _normalizeFunctionName;
+}
+declare function parse(input: string): AnyGradient;
+declare function isGradient(input: string): boolean;
+declare function format(input: string | AnyGradient): string;
+//#endregion
+//#region src/gradient/transformer/GradientTransformer.d.ts
 declare class GradientTransformer {
   private static readonly _modules;
   private static _initialized;
   static add(module: IGradientTransformerModule): void;
   static get(target: string, gradientType: string): IGradientTransformerModule | null;
   static remove(target: string, gradientType: string): boolean;
-  static to<TOutput = unknown>(target: string, input: string | GradientLike): TOutput;
+  static to<TOutput = unknown>(target: string, input: string | AnyGradient): TOutput;
   static from<TOutput = unknown>(target: string, gradientType: string, input: TOutput): AnyGradient;
   private static _ensureInitialized;
   private static _getKey;
 }
+declare function transformTo<TTarget extends GradientTransformTarget>(target: TTarget, input: string | AnyGradient): GradientTransformOutputByTarget[TTarget];
+declare function transformTo<TOutput = unknown>(target: string, input: string | AnyGradient): TOutput;
+declare function transformFrom<TFunctionName extends BuiltInGradientFunctionName>(target: string, gradientType: TFunctionName, input: unknown): GradientByFunctionName[TFunctionName];
+declare function transformFrom<TInput = unknown>(target: string, gradientType: string, input: TInput): AnyGradient;
 //#endregion
-export { AbiInputType, AngleUnit, AnyGradient, ConicGradient, ConicGradientConfig, DiamondGradient, DiamondGradientConfig, GRADIENT_COLOR_SPACE, GRADIENT_HUE_INTERPOLATIONS, GRADIENT_POLAR_COLOR_SPACES, GradientAbi, GradientAbiInput, GradientAngleUnit, GradientAngleValue, GradientBase, GradientColorHint, GradientColorInterpolation, GradientColorSpace, GradientColorStop, GradientCommonConfig, GradientData, GradientFactory, GradientHueInterpolation, GradientHueInterpolationMethod, GradientInterpolation, GradientLengthPercentage, GradientLengthUnit, GradientLengthValue, GradientLike, GradientNumberValue, GradientPercentValue, GradientPolarColorSpace, GradientPosition, GradientPositionKeywordX, GradientPositionKeywordY, GradientRectangularColorSpace, GradientStop, GradientTransformer, GradientType, ICanvasPaintResult, IGradientBase, IGradientStatic, IGradientTransformerModule, LinearGradient, LinearGradientConfig, MeshGradient, MeshGradientConfig, MeshGradientData, MeshGradientHandle, MeshGradientInterpolationMethod, MeshGradientPatch, MeshGradientPatchSide, MeshGradientVertex, ModuleTransformerConicGradientToCanvas, ModuleTransformerConicGradientToCanvasWebGL, ModuleTransformerConicGradientToCss, ModuleTransformerDiamondGradientToCanvas, ModuleTransformerDiamondGradientToCanvasWebGL, ModuleTransformerDiamondGradientToCss, ModuleTransformerLinearGradientToCanvas, ModuleTransformerLinearGradientToCanvasWebGL, ModuleTransformerLinearGradientToCss, ModuleTransformerMeshGradientToCanvas, ModuleTransformerMeshGradientToCanvasWebGL, ModuleTransformerMeshGradientToCss, ModuleTransformerRadialGradientToCanvas, ModuleTransformerRadialGradientToCanvasWebGL, ModuleTransformerRadialGradientToCss, PatternTokenKind, RadialGradient, RadialGradientConfig, RadialGradientExtent, RadialGradientShape, RadialGradientSize, angleValueFromString, ceilTo, clamp, degToRad, floorTo, format, fromPercent, gradToRad, isAngle, isAngleUnit, isColorHint, isColorStop, isConfig, isGradient, isGradientColorSpace, isGradientHueInterpolation, isGradientPolarColorSpace, isPatternSyntaxValid, isPatternValid, isValid, matchExpression, normalizeAngleDeg, normalizeAngleRad, parse, parseStringToAbi, radToDeg, roundTo, splitTopLevelByWhitespace, toPercent, tokenizePattern, transformFrom, transformTo, truncTo, turnToRad, validate, validatePattern, validatePatternSemantic, validatePatternStructure, validatePatternSyntax };
+export { AbiInputType, AngleUnit, AnyGradient, BuiltInGradientFunctionName, GRADIENT_COLOR_SPACE, GRADIENT_HUE_INTERPOLATIONS, GRADIENT_POLAR_COLOR_SPACES, GradientAbi, GradientAbiInput, GradientAngleUnit, GradientAngleValue, GradientBase, GradientByFunctionName, GradientColorHint, GradientColorSpace, GradientColorStop, GradientConic, GradientConicConfig, GradientConicConfigInput, GradientConicJSON, GradientConicStop, GradientConicType, GradientCssStringTransformerModule, GradientDiamond, GradientDiamondConfig, GradientDiamondConfigInput, GradientDiamondJSON, GradientDiamondStop, GradientDiamondType, GradientFactory, GradientHueInterpolation, GradientInterpolation, GradientJSON, GradientLengthPercentage, GradientLengthUnit, GradientLengthValue, GradientLinear, GradientLinearConfig, GradientLinearConfigInput, GradientLinearJSON, GradientLinearStop, GradientLinearType, GradientMesh, GradientMeshConfig, GradientMeshConfigInput, GradientMeshHandle, GradientMeshInterpolationMethod, GradientMeshJSON, GradientMeshPatch, GradientMeshPatchHandle, GradientMeshPatchHandles, GradientMeshPatchSide, GradientMeshType, GradientMeshVertex, GradientPercentValue, GradientPolarColorSpace, GradientPosition, GradientPositionKeywordX, GradientPositionKeywordY, GradientRadial, GradientRadialConfig, GradientRadialConfigInput, GradientRadialExtent, GradientRadialJSON, GradientRadialShape, GradientRadialSize, GradientRadialStop, GradientRadialType, GradientStop, GradientStopKind, GradientTransformOutputByTarget, GradientTransformTarget, GradientTransformer, GradientTransformerModule, GradientTransformerTarget, GradientType, GradientWithStopsBase, GradientWithStopsJSON, GradientWithStopsJSONExtra, ICanvasPaintResult, IGradient, IGradientConic, IGradientDiamond, IGradientLinear, IGradientMesh, IGradientRadial, IGradientStatic, IGradientTransformerModule, IGradientWithStops, ISvgGradientResult, ModuleTransformerConicGradientToCanvas, ModuleTransformerConicGradientToCanvasWebGL, ModuleTransformerConicGradientToCss, ModuleTransformerConicGradientToSvg, ModuleTransformerDiamondGradientToCanvas, ModuleTransformerDiamondGradientToCanvasWebGL, ModuleTransformerDiamondGradientToCss, ModuleTransformerDiamondGradientToSvg, ModuleTransformerLinearGradientToCanvas, ModuleTransformerLinearGradientToCanvasWebGL, ModuleTransformerLinearGradientToCss, ModuleTransformerLinearGradientToSvg, ModuleTransformerMeshGradientToCanvas, ModuleTransformerMeshGradientToCanvasWebGL, ModuleTransformerMeshGradientToCss, ModuleTransformerMeshGradientToSvg, ModuleTransformerRadialGradientToCanvas, ModuleTransformerRadialGradientToCanvasWebGL, ModuleTransformerRadialGradientToCss, ModuleTransformerRadialGradientToSvg, PatternTokenKind, angleValueFromString, ceilTo, clamp, createWebGLProgram, createWebGLShader, degToRad, fitStopsToWebGLLimit, floorTo, format, formatGradientAngle, formatGradientLengthPercentage, formatGradientPosition, fromPercent, getWebGLSampleCount, gradToRad, isAngle, isAngleUnit, isColorHint, isColorStop, isConfig, isDefaultGradientPosition, isGradient, isGradientColorSpace, isGradientHueInterpolation, isGradientLengthPercentageToken, isGradientPolarColorSpace, isPatternSyntaxValid, isPatternValid, isValid, matchExpression, normalizeAngleDeg, normalizeAngleRad, parse, parseGradientAngle, parseGradientLengthPercentage, parseGradientPosition, parseStringToAbi, radToDeg, roundTo, splitTopLevelByWhitespace, toPercent, toWebGLColor, tokenizePattern, transformFrom, transformTo, truncTo, turnToRad, validate, validateGradientAngle, validateGradientLengthPercentage, validateGradientPosition, validatePattern, validatePatternSemantic, validatePatternStructure, validatePatternSyntax };