@feugene/granularity-charts

Changed

• Подсказка, курсор, кисть, опора и нейтральные цвета графиков — решение темы. --gr-chart-frame-tooltip-bg, -tooltip-fg, -tooltip-brd, -crosshair, -brush-fill, -brush-stroke, -reference, --gr-chart-bullet-target и --gr-sparkline-color были хуками с запасным значением в коде, теперь это токены вида theme. Темы каталога несут их с @feugene/granularity-tokens 2.5.0 — «Сланец», «Тактильная» и «Чертёж» с прежним видом, «Глина» — графитовым пузырём подсказки, как у ядра, и графитом вокруг данных. Своей теме-копии нужны значения (granum doctor, theme-incomplete).
• Тень подсказки — токен --gr-chart-frame-tooltip-shadow, а не утилита шкалы uno: «Глина» подсказку тенью не поднимает. У «Сланца» — прежняя тень.
• Peer @feugene/granularity-tokens — >=2.5.0 <3.0.0: темы со значениями графиков.

Added

• --gr-chart-frame-tooltip-swatch-ring — кольцо метки серии в подсказке: на тёмном пузыре светлой страницы (и наоборот) метка не сливается с ним, в том числе со своими цветами серий.
• --gr-chart-bullet-value, --gr-chart-waterfall-total — цвет полосы значения и итога моста. У «Сланца» — первая серия, как было; «Глина» кладёт их графитом и отдаёт глину цели bullet.

Мажор: значения у темы. Дизайн-решения графиков — токены вида theme, их значения дают темы каталога пакета токенов; вид не меняется.

Changed

• 20 хуков — вид theme, компонент читает их без запасного значения: толщины линий (--gr-chart-line-width, -area-line-width, -radar-width, -frame-grid-width, -bar-gap, -pie-gap, -waterfall-connector-width, -waterfall-zero-step, --gr-sparkline-width) и прозрачности (--gr-chart-area-fill-opacity, -area-stack-opacity, -area-fill-fade, -bar-dim, -funnel-dim, -pie-dim, -line-gap-opacity, -radar-fill, -frame-brush-fill-opacity, -frame-reference-band-opacity, --gr-sparkline-fill-opacity). Значения — в темах @feugene/granularity-tokens 2.2.0; приложение по-прежнему переопределяет их своим CSS.
• Требования: @feugene/granularity >=3.1.0, @feugene/granularity-tokens >=2.2.0 — темы со значениями графиков, @feugene/granum >=3.11.0 — значения рамки лежат в разделе группы GrChartFrame: токены общей рамки требует каждый график, владельца среди них нет.
• Своей теме без extends нужны значения этих токенов — granum doctor называет их поимённо (theme-incomplete); начать с копии — gr-theme-copy slate <id>.
• Хуки-геометрия (--gr-sparkline-height, -inset, --gr-chart-bullet-value-width, -frame-empty-height, -frame-legend-gap) и нейтральная заливка пустой ячейки тепловой карты остаются хуками — с причиной literal в реестре.

Changed

• Peer @feugene/granularity — >=2.0.0 <4.0.0: пакет работает и с ядром 3. Значения токенов компонентов ядра переехали в темы пакета токенов, роли и подпути ядра те же; doctor-конфиг пакета называет тему сборки явно — у каталога нет темы по умолчанию.

Fixed

• Манифест объявляет хуки компонентов (tokens.hooks): на granum 3.7 doctor приложения не выдаёт token-fallback-only на точках кастомизации. Хуки берутся из tokens.json на сборке (withRegistryHookTokens тест-кита); хуки рамы GrChartFrame — у каждого графика её группы.

Changed

• Peer @feugene/granum — >=3.0.0 <4.0.0, @feugene/granularity — >=2.0.0 <3.0.0. Ядро 2 — провайдер granum 3 (манифест формата 3, контракт версии 2) с темой из @feugene/granularity-tokens, и спутник объявляет те же мажоры: с ядром 1 на granum 2 он не соберётся.

Fixed

• Холст графика перечитывает цвета и при смене режима острова. Кеш резолва цветов сбрасывался только по теме поддерева GrConfigProvider; режим (mode) теперь сбрасывает его так же.

Changed

• Peer @feugene/granum — >=2.0.0 <3.0.0. Пакет собран granum 2.0: dist не импортирует granum — контракт встроен в dist/granum/contract.js, и SSR-сервер с внешними пакетами, задеплоенный с --omit=dev, больше не падает с ERR_MODULE_NOT_FOUND. Приложению — @feugene/granum и @feugene/granum-engine-wind ^2.0.0.
• Компонент из корня пакета — ComponentRootImportError у приложения на granum 2.0. Компоненты берут из <пакет>/components/<Имя>.
• Авто-импорт — один GranularityResolver() из @feugene/unplugin-granularity 1.1: он находит пакет в package.json приложения сам, порядок резолверов больше не важен. Собственный ./resolver остаётся для уже написанных конфигов.
• Необязательный peer @feugene/fint-i18n — >=0.9.0 <1.0.0. Пакет тестируется на 0.9 вместе с ядром; на 0.7 и 0.8 он не проверялся.

Fixed

• Ось значений горизонтальных GrChartWaterfall и GrChartBar прореживается по ширине. Правило «влезает — или шаг крупнее», которое уже действовало на оси X вертикальных графиков, на оси значений горизонтальных не применялось: на узком холсте 0 500 1,000 1,500 2,000 сливалось в «0 5001,0001,5002,000». Теперь подписи, которые не помещаются, пропускаются через одну, а первая и последняя остаются.
• Шаги узкого вертикального GrChartWaterfall не сжимаются в огрызки. На 210px пять коротких подписей усекались до «Pr…», «V…», «C…» — двухбуквенный обрубок не называет ничего. Теперь сначала перенос на две строки; если и так какая-то подпись теряет больше, чем оставляет четыре знака, подписи встают в шахматку — соседние в разные ряды, каждой ширина двух шагов, крайним — до края холста. Усечённая подпись держит не меньше четырёх знаков, полный текст — в <title>.

Fixed

• Пустой график держит заданную height. Заглушка «нет данных» сжимала область построения до min(height, 8rem): GrChartArea с :height="260" занимал с данными 260px, а на периоде без данных — 128px, и карточка вокруг прыгала (скелет загрузки высоту держал). Теперь данные, загрузка и пустота — series: [] или empty — занимают одну height у всех графиков на общей раме: GrChartArea, GrChartBar, GrChartLine, GrChartPie, GrChartRadar, GrChartFunnel, GrChartHeatmap, GrChartWaterfall, GrChartBullet. Хук --gr-chart-frame-empty-height остался — по умолчанию он равен height и сжимает заглушку, если его задать; выше height она по-прежнему не растёт.
• Подпись оси значений не срезается краем холста. Отступ под ось считался по отформатированной подписи, но оценка ширины была уже настоящей: цифры шли по 0.55 кегля, «1» — по 0.32, «%» — по 0.68, тогда как в Inter, первом шрифте --gr-font-ui, это 0.6–0.65, 0.41 и 0.98. В итоге yTickFormat с «100%» получал на ~6px меньше, и подпись читалась как «l00%». Оценка (estimateTextWidth) теперь ошибается вверх: классы символов — потолок по шрифтам стека (Inter, системный, Arial/Helvetica), отдельно цифры и знаки валют, отдельно самые широкие (%, m, M, W, Ж, Ш…), заглавные — по регистру, в том числе кириллица. Поверх оценки — запас в 2px. Касается левой и правой (dualAxis) оси значений, подписей оси X и всех графиков на общей раме.
• Имена категорий горизонтального GrChartBar читаются целиком. Колонка подписей была ограничена 96px на любом холсте, и «Delivered after the promised date» на графике в 550px превращалась в «Delivered af…», хотя полосам места хватало с избытком. Теперь потолок — 40% ширины области построения (но не меньше 96px), многоточие появляется только за ним, полное имя остаётся в <title>, тултипе и скрытой таблице. Так же считаются подписи шагов горизонтального GrChartWaterfall и строк GrChartHeatmap; строка теплокарты шире потолка теперь кончается многоточием с полным текстом в <title>, а не уезжает за край холста.
• Подписи колонок GrChartHeatmap не налезают друг на друга. Подписи стояли по центру ячеек целиком при любой ширине: в матрице шириной 213px с колонками «Starter», «Team», «Business» ячейки по 31px, и подписи сливались в «StarterTeamBusiness». Теперь подпись, которая не помещается в ячейку, усекается многоточием (полный текст — в <title>), пока от неё остаются хотя бы три знака; дальше ряд прореживается с первой и последней колонкой, и каждая подпись занимает место только до середины пути к соседям. Имя строки «Recurring invoices» больше не срезается краем холста — это часть правки оценки ширины выше.
• Подписи оси X не налезают друг на друга. Число делений выбирала шкала, а ширина подписей в выбор не входила: GrChartLine на карточке в 250px с двадцатью пятью получасами категориями рисовал «00:0030:0001:00…», месяцы — «NoDecJanFebMar…», даты помесячно — «Jan 2026Apr 2026Jul 2026Oct 2026». Теперь рама после выбора делений проверяет подписи по оценке ширины и, если соседние сталкиваются, показывает каждую k-ю с первой и последней — на любой шкале: категориальной, временной и числовой. Сетка остаётся на всех делениях. Касается GrChartLine, GrChartArea, GrChartBar и вертикального GrChartWaterfall.
• xTickCount работает у категориальной оси — как потолок числа подписей (не задан — двенадцать, как прежде). Умолчание пропа у GrChartLine, GrChartArea и GrChartBar теперь undefined; для числовой и временной оси это по-прежнему шесть делений.
• Ось времени не схлопывается в одно деление. Лестница шагов прыгала с квартала сразу на год, и xTickCount: 4 на одиннадцати месяцах давал одно деление «Dec». В лестнице появились шаги в 2 и 6 месяцев, а ступень выбирается по настоящему числу делений после выравнивания: не больше xTickCount и не меньше двух, если диапазон их вмещает.
• Слот #center у GrChartPie можно поставить в центр. Слот рисуется внутри холста, а получал только total и formattedTotal: своё SVG («92%» и «on time» вместо суммы) ложилось в начало координат холста, а не в дырку. Теперь слот получает и геометрию: cx, cy, innerRadius, valueFont, labelFont — по ним стоит и содержимое по умолчанию. Пример — на странице компонента. formattedTotal форматируется по valueFormat, как и раньше.
• Ось значений GrChartWaterfall — по накоплениям, а не по шагам. Ряд рамы нёс собственные значения шагов, и дельты попадали в домен: у отчёта о прибылях 1240 → −410 → 830 → … ось уходила до −500, у складского моста — до −1000, хотя накопление нигде не опускалось ниже нуля. Теперь стороны домена — основания и вершины столбцов вместе с нулём; yDomain потребителя сильнее.
• С yDomain, чей низ выше нуля, столбцы моста не вылезают за область. Итоговый столбец от нуля уходил под ось поверх подписей «Start of Sep», «End of Sep». Теперь концы столбцов прижимаются к краю домена — обрыв виден, — а соединители и нулевые шаги вне домена не рисуются.
• Каждый шаг моста назван, и подписи не налезают. Подписи шагов стояли целиком: восемь шагов на 510px и пять на 210px сливались. Прореживать их, как у категорий, нельзя — мост без имени шага не прочитать, — поэтому рама в режиме xLabelFit: 'wrap' переносит подпись по словам на две строки, дальше усекает её многоточием с <title>; нижнее поле растёт на строку. Все шаги подписаны и сверх двенадцати.
• Горизонтальный мост оставляет место под последнюю подпись оси значений — «2,000» больше не срезается до «2,00» краем холста, как уже было у горизонтальных столбцов.
• Паутина GrChartRadar не отдаёт радиус подписям. Отступ под самую длинную подпись резервировался с каждой стороны: в карточке 213×260 с осями «System design», «Go», «SQL», «On-call», «Mentoring» паутина сжималась до 25px под наползающим текстом, а при axis-scale="per-axis" («Orders a day · 200») пропадала совсем. Теперь радиус — наибольший, при котором каждая подпись помещается со своей стороны, но не меньше половины от возможного; имя шире четверти холста переносится на две строки, дальше — многоточие с полным текстом в <title>. Потолок оси при per-axis стоит второй строкой («max 200») и не усекается. Подписи колец переехали с первой спицы на биссектрису между первой и второй: внешнее кольцо налезало на имя верхней оси.
• Гидрация радара и круга без расхождений. Координаты из тригонометрии писались полным числом, и сервер с браузером расходились в последнем знаке (229.37383539249433 против …436). Теперь спицы, кольца, вершины, дуги, выноски и центр круга идут через svgCoord с двумя знаками.
• Подсказка графика прячется, когда точка уехала из вида. Курсор, поставленный программно (v-model:active-index у пары графиков), оставлял подсказку прижатой к краю вьюпорта поверх чужого содержимого, а до первого расчёта позиции — в левом верхнем углу. Рама включает hideWhenDetached у useFloating ядра; работает с ядром 1.0.10 и новее.
• Воронка подписывает ступени именами. GrChartFunnel не рисовал имён ступеней вовсе — какая полоса что значит, знали только тултип и скрытая таблица. Теперь у вертикали имена стоят колонкой слева (до 40% ширины, не уже 96px), у горизонтали — строкой под ступенями; длинное имя кончается многоточием с полным текстом в <title>.
• Подпись значения воронки не пропадает на узкой ступени. Подпись, которая не помещалась внутри, не рисовалась: у воронки 12400 → 3180 → 1420 → 612 с labels="share-first" последняя ступень оставалась без «5%», у 940 → 1360 → 410 → 0 пропадали «410» и обещанный документацией «0». Теперь такая подпись стоит рядом со ступенью — справа от её середины у вертикали, над ней у горизонтали — цветом подписи рамы.
• tooltip: false прячет только панель. Флаг выключал всё слежение за указателем: график с :tooltip="false" в паре на одном v-model:active-index не двигал курсор под мышью, не излучал update:activeIndex и pointHover — синхронизация шла только в одну сторону. Теперь курсор, активные марки, вертикаль и события работают, пока график интерактивен; картинкой его делает только interactive: false. Поведение описано в JSDoc пропа tooltip у всех графиков.
• Появились описания у пропов, событий и слотов всех графиков, которые в API, подсказках IDE и на портале были пустыми: у общих пропов (height, yDomain, includeZero, yDomainRight, yTickFormatRight, valueFormatRight, xTickCount, yTickCount, xTickFormat, yTickFormat, valueFormat, curve, showPoints, showGrid, showLegend, legendPosition, tooltip, loading, empty, emptyText, dataTable, size, locale, ariaLabel, ariaDescription) и у своих — min и orientation буллета, stages воронки, xLabels, yLabels и цветов шкалы теплокарты, variant круга и спарклайна, fill радара, steps, showConnectors и barRadius моста; у событий update:*, *Click, *Hover, legendToggle и слотов tooltip, legend, empty, header.