plmt-widgets-helper

Общая TypeScript-библиотека с утилитами, которые переиспользуются в виджетах.

Установка

npm install plmt-widgets-helper

Использование

Библиотека экспортирует несколько пространств имён из одной точки входа:

• Methods — функции и утилиты
• Enums — перечисления
• Types — типы
• Interfaces — интерфейсы

import { Methods } from "plmt-widgets-helper";

const bounds = Methods.getAxisMinMax({
  min: "0",
  max: "100",
  dataMin: 12,
});

const formatted = Methods.format({ toFixed: 2, useGrouping: true }, 1234567.89);

Типы и интерфейсы импортируются отдельно:

import type { Types, Interfaces } from "plmt-widgets-helper";

const value: Types.Nullable<string> = null;
const bounds: Interfaces.AxisMinMaxBounds = { min: 0, max: 100 };

Основные группы методов

Конвертация значений

• convertToCurrentType — приведение значения к типу колонки
• convertStringToCurrentType — парсинг строковых примитивов ('null', 'true', числа)
• checkValueIsNull — преобразование строки 'null' в null

Форматирование

• format — форматирование чисел по настройкам
• formatNullableValue — форматирование с обработкой null/undefined
• getOneAxisFormatter — выбор форматтера для общей оси
• truncate — обрезка строки

Оси графиков

• toAxisBoundNumber — парсинг границ оси из пользовательского ввода
• getAxisMinMax — сборка min/max для опций ECharts
• getFiniteNumericMin — минимум среди конечных чисел
• getLogAxisMinFromExtent — нижняя граница логарифмической оси

Прочее

• measureTextWidth, textLengthAtAngle — расчёт размеров текста
• setTextProperties, setElementsColorProperty — стили из темы
• Methods.Lodash — реэкспорт часто используемых функций lodash

Разработка

npm install
npm run typecheck
npm run build

Новый код добавляйте в соответствующую папку внутри src, экспортируйте из её index.ts — после этого он станет доступен из корневого импорта библиотеки.

Сборка попадает в dist и именно она публикуется в npm.