@feugene/granularity-media

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

• Пустая рамка GrImageCrop держит соотношение кадра. Без картинки рамка стояла на своей минимальной высоте (min-h-48, 192px), а aspect-ratio получала только вместе с ней: фото, пришедшее после монтирования, растягивало рамку до высоты кадра и сдвигало всё под ней. Теперь соотношение у рамки с самого начала, слот #empty стоит по её центру, а слишком высокое его содержимое обрезается, а не растягивает рамку. Это заметно меняет раскладку пустого кропа: при умолчательном aspectRatio = 1 в широкой колонке пустая рамка теперь квадрат во всю ширину, а не полоса в 192px, и size на её высоту больше не влияет — высоту задаёт только соотношение.
• Кадр GrImageCrop — ровно в соотношении рамки. Область считалась от окна, измеренного в дробных CSS-пикселях внутри бордера, и расходилась с aspectRatio на долю пикселя: картинка 1600×1200 в рамке 4:3 без увеличения давала sh = 1199.4 со сдвигом sy = 0.6, а output: { width: 1200 } при 3 / 4 — JPEG 1200×1602. Теперь кадр считается от рамки, доведённой до точного соотношения, и привязан к пикселям исходника: такая картинка уходит в кадр целиком, а вторая сторона результата равна round(width / aspectRatio).

Fixed

• GrVideoPlayer после гидрации знает длительность и сбой. Серверный HTML уже несёт <video> с src: браузер читает метаданные — или ломается — раньше, чем плеер вешает слушатели в onMounted, и loadedmetadata/error терялись. Плеер оставался без длительности, а битый источник — без слоя ошибки. Теперь после монтирования плеер сверяется с элементом: readyState и error помнят то, что события уже сказали.

Fixed

• Гидрация GrCodeScanner без расхождений. Решение «нативного BarcodeDetector нет» принималось в рендере: сервер писал «This browser cannot read codes» без кнопки, Chrome — «The camera is off.» с кнопкой «Start scanning», и гидрация расходилась на каждой странице со сканером, а до неё мелькало ложное сообщение. Теперь поддержка проверяется после монтирования: первый рендер везде — нейтральное состояние покоя.
• Со слотом #controls в рамке нет второй кнопки «Start scanning». Слот владеет действиями; в рамке остаётся только текст состояния.
• GrCameraStatus экспортируется из входа GrCodeScanner. Слот #controls отдаёт status: GrCameraStatus, а тип был только у входа GrCameraCapture.

Documentation

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

Fixed

• Появились описания у пропов, которые в API, подсказках IDE и на портале были пустыми: у GrCameraCapture — output (и полей GrCameraCaptureOutput), size, disabled, ariaLabel; у GrCodeScanner — deviceId, size, disabled, ariaLabel; у GrImageCrop — shape, maxZoom, output, size, disabled, ariaLabel; у GrVideoPlayer — src, autoplay, loop, size, disabled, ariaLabel. Описаны и события всех четырёх.

Changed

• Safelist компонентов пуст. Все записи лежали в коде целыми литералами — в шаблонах и .ts-хелперах. granum извлекает такие классы сам, обходя от входа компонента все его чанки, общие включительно, и вычищал записи из манифеста как уже извлечённые. Списки пережили UnoCSS-пресет, который общий чанк не сканировал. Набор классов не изменился — проверено сверкой манифестов по селекции каждого компонента; расходятся только случайные токены, которые экстрактор выхватывает из минифицированного кода.
• Удалён 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.
• cameraState.ts moved from components/GrCameraCapture/ to components/shared/. The scanner reads it too, through the shared useCameraStream, and an import from another component’s directory counts as a declared edge — declaring it would have made a consumer of the scanner pay for the camera’s CSS and safelist in full. The public surface is unchanged: GrCameraCapture/index.ts re-exports from there.