@feugene/granularity-chrono

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

• Живой GrRelativeTime не называет только что случившееся будущим. «Сейчас» бралось из последнего тика общего таймера, а он на секундах отстаёт до пяти секунд: значение, выставленное между тактами, показывалось «in 1 sec.», а через такт — «3 sec. ago». Теперь при смене значения (и при монтировании) часы перечитываются, будущее ближе секундного такта — «сейчас» у любой метки без base, а нулевой разрыв formatRelativeTime печатает «now» или «0 sec. ago» при numeric="always", но не «in 0 sec.».

• GrRelativeTime не качается между тикерами. Метка, дозревшая до минут, переезжала на минутный тикер, а его «сейчас» могло отставать на полминуты и снова давать секунды: метка возвращалась на секундный тикер, тот давал минуты, и так по кругу — Maximum recursive updates в разработке и зависшая вкладка в проде. Теперь при переезде часы перечитываются.

• Дата без времени у GrRelativeTime меряется календарём. value="2026-10-07" с valueAdapter="isoDate" утром 6 октября читалось «in 15 hours», вчерашняя дата — «9 hours ago»: разрыв до суток считался прошедшим временем до условной полуночи. Теперь такое значение сравнивается по календарным дням — «tomorrow», «today», «yesterday», дальше недели и месяцы, — а datetime у <time> получает саму дату, а не момент в UTC.

• Колонки GrTimePicker в inline стоят на выбранном значении. Начальная прокрутка шла в setup, когда опций ещё нет в DOM, а open у инлайн-пикера больше не меняется: часы с выбранными 14 стояли на 00–05. Теперь колонки прокручиваются после монтирования — и у GrDateTimePicker, GrDateRangePicker с временем тоже, — а без значения встают на первое доступное.

• Прокрутка колонок времени не трогает страницу. Колонки двигались scrollIntoView, а он прокручивает всех предков вплоть до окна: инлайн-пикер ниже первого экрана утаскивал бы к себе страницу на загрузке. Теперь двигается только scrollTop колонки — и при показе выбранного, и при шаге стрелкой.

Added

• Флаг dateOnly у GrChronoAdapter. Адаптер объявляет, что его значение — день без времени; у isoDateAdapter он включён. Свой адаптер дат включает его так же.
• Опции selectRelativeAmount: dateOnly и nowWithin. Первая меряет разрыв календарём, вторая задаёт допуск, в пределах которого будущее считается «сейчас». Тип — SelectRelativeAmountOptions.

Added

• Хук --gr-calendar-cell-size у GrCalendar и пикеров дат. Ячейки дня были фиксированными (h-9 w-9 на md, h-8 w-8 на sm), и месяц — 290px на md, 309px с номерами недель — не помещался в карточку телефона без прокрутки. Теперь сторона ячейки — хук с прежним умолчанием по размеру; для узкой карточки, например, min(2.25rem, 12cqi).

Changed

• Поля пикеров занимают ширину колонки — как GrInput и GrSelect. Обёртка поля у GrDatePicker, GrDateRangePicker, GrDateTimePicker и GrTimePicker была inline-block и обжимала поле по его собственной ширине — около 209px у md. Диапазон со временем «Oct 11, 2026, 02:00 — Oct 11, 2026, 04:30» обрезался до «Oct 11, 2026, 02:00 —…», то есть терял конец окна, а style="width:100%" растягивал корень компонента, но не поле внутри: сделать поле шире было нельзя вовсе. Теперь обёртка блочная, и поле заполняет колонку GrFormField или ячейку сетки. Нужно узкое поле — задайте ширину самому компоненту.

Documentation

• Появились описания у методов GrCalendar, которые в API и на портале были пустыми.

Fixed

• Появились описания у пропов, которые в API, подсказках IDE и на портале были пустыми: у GrCalendar — min, max, showWeekNumbers, size, disabled, readonly; у GrDatePicker, GrDateRangePicker, GrDateTimePicker и GrTimePicker — границы дат, номера недель, первый день недели, шаги колонок времени, placeholder, clearable, placement, teleportTo, size, disabled, invalid, required, loading, ariaLabel, modelValue пикеров даты со временем и времени, а также их события.
• Описание minRange у GrDateRangePicker стояло над соседним пропом enableTime и до minRange не доходило.

Changed

• Safelist компонентов пуст. Все записи лежали в коде целыми литералами — в шаблонах и .ts-хелперах, включая общее поле пикеров в internal/. granum извлекает такие классы сам, обходя от входа компонента все его чанки, общие включительно, и вычищал записи из манифеста как уже извлечённые. Списки пережили UnoCSS-пресет, который общий чанк не сканировал. Набор классов не изменился — проверено сверкой манифестов по селекции каждого компонента; расходятся только случайные токены, которые экстрактор выхватывает из минифицированного кода.
• Удалены pickerFieldClassTokens, presetRowClassTokens и internal/classTokens.ts: они служили только спискам.
• Подключён гейт defineSafelistGate из test-kit: запись safelist, которая лежит целым литералом в коде компонента, он называет лишней. Нужен safelist только классу, собранному в рантайме из частей.

Гигиена сборки. Артефакт пакета не изменился — проверено побайтно.

Changed

• libInjectCss убран из конфига сборки. Плагин вписывал в JS-чанк компонента import '../styles.css'; до granum это был единственный канал доставки стилей, а с granum тот же файл приезжает приложению через манифест — и потребитель получал два экземпляра, причём второй вне слоёв granum.* и потому сильнее всей библиотеки.

  У этого пакета компонентного CSS нет, и плагин стоял вхолостую: сборка с ним и без него совпадает побайтно, числа в docs/entry-sizes.md не сдвинулись. Убран до того, как появится первый компонент со стилями — тогда ловушка захлопнулась бы молча.

  Ядро сняло плагин при переезде на granum, granularity-editor и granularity-code — в 1.0.1, где он уже стрелял. Диагностика css-double-delivery, которая обязана была это назвать, не работала вовсе; починена в @feugene/granum 1.0.2.

• vite-plugin-lib-inject-css убран из devDependencies: больше не импортируется.

Переезд на @feugene/granum 1.0 и первый мажор пакета.

Публичная поверхность не менялась — ломающий тут сам конвейер: peer-зависимость уезжает с @feugene/unocss-preset-granular на @feugene/granum (>=1.0.0 <2.0.0), а приложение переходит с uno.config.ts на granum.config.ts. Версия выровнена с ядром: @feugene/granularity 1.0.0.

Перед обновлением стоит прочитать руководство по переезду в granum — в частности про каскадные слои и сброс браузерных стилей, который теперь нужно импортировать в слой.

Changed

• yarn doctor is granum doctor --strict, without a wrapper script. scripts/granum-doctor.mjs existed for two reasons and both are gone. It muted token-undefined through the monorepo’s token registry — granum 0.4.0 derives the same verdict from the code itself (a use with a fallback, a token the component assigns itself and dynamicTokens are not findings), so the registry is unnecessary. And it kept recorded debt from failing the gate — that is now --allow=<codes>. Findings across the eight packages went from 861 to 1, and that one is the deliberate !important on the drag cursor in GrTransfer, recorded through --allow.
• Safelists in the manifests shrank from 3479 entries to 430 (zero in every companion): granum drops entries that static extraction already covers. Nothing in the sources changed and the CSS is byte-for-byte identical — the safelist there is derived from the component’s own class constants, and whether extraction sees a given class is decided by chunking, not by the author.
• The utility engine changed: @feugene/granum-engine-wind ^0.4.0 instead of @feugene/granum-engine-mini. It vendors preset-wind3 rather than preset-mini, so the vocabulary gained border-collapse, list-none, touch-none, table-fixed and scroll-p* — utilities that existed neither in preset-mini nor in the former extra rules, which is why a class in the markup silently produced no CSS. The package dialect is now unocss/preset-wind3+granum@66, and the peer on the core moved to >=0.3.0 <1.0.0. A consumer swaps the pair in dev dependencies and replaces miniEngine() with windEngine() in granum.config.*.
• The package is built by @feugene/granum, not by the @feugene/unocss-preset-granular preset. The dist layout and the component entries are driven by the granumProvider({ provider, engine: miniEngine(), entries }) plugin: it builds them from the provider registry, extracts the classes and the consumed tokens by walking the bundle graph, and writes a machine-generated granum.manifest.json next to dist. The package’s own build.lib, granularChunkFileNames and hand-written component entries are gone from vite.config.ts.
• The manifest is exported as ./granum.manifest.json. An application resolves it through exactly that subpath — without the export the package’s provider cannot be wired up. granum never scans node_modules: the component classes are computed when the package is built.
• The peer changed: @feugene/granum >=0.2.0 <1.0.0 instead of the preset. The utility engine comes from the application (@feugene/granum-engine-mini sits in the package’s dev dependencies), while the package declares a vocabulary dialect in the manifest — unocss/preset-mini+granum@66, the vocabulary its component classes are written against. An application running an engine of a different vocabulary gets provider-dialect-mismatch and every lost class listed by name instead of silently half-drawn components.
• The descriptor contract was renamed without a change of meaning. defineGranularComponent → defineGranumComponent, defineGranularProvider → defineGranumProvider, imported from @feugene/granum/contract. Donors are declared as strings (dependencies: ['@feugene/granularity']) rather than instances: an instance would pull the donor into the graph in object form and make the application scan its dist instead of reading the manifest. packageBaseUrl is gone — the manifest’s directory is the base — so granular-provider/node is now a plain alias of the browser entry.
• granular.options.mjs was replaced by granum.config.mjs, and yarn doctor runs granum doctor against the package’s manifests.