@rt-tools/ui-kit-v2 0.6.0 → 0.7.0

package/README.md

@@ -50,8 +50,8 @@ export const appConfig: ApplicationConfig = {
 
 Иконки лежат отдельными файлами в `node_modules/@rt-tools/ui-kit-v2/src/assets/icons`: сборка
 копирует каталог в свою статику, а `provideRtIcons('/icons')` называет адрес, по которому он
-опубликован. Реестр забирает их одним проходом на подъёме и склеивает в inline-sprite, поэтому
-дальше `<rt-icon>` рисуется без запросов.
+опубликован. Файл забирается тогда, когда значок с этим именем попросила разметка, и дальше
+живёт в inline-sprite: страница платит за те значки, которые нарисовала, а не за весь набор.
 
 ```json
 {
@@ -63,16 +63,25 @@ export const appConfig: ApplicationConfig = {
 
 ## Что внутри
 
-**Компоненты** — 72 семейства: поля формы (`rt-input`, `rt-select`, `rt-multiselect`,
+**Компоненты** — 73 семейства: поля формы (`rt-input`, `rt-select`, `rt-multiselect`,
 `rt-date-picker`, `rt-file-input`, `rt-rich-editor`, `rt-field`), таблица с настройкой колонок и
 пагинацией, панель правки записи с маршрутом и защитой несохранённого, диалоги, чат с композером,
-календарь, шапка страницы с навигацией, тосты, просмотрщик фотографий и остальное.
+календарь, шапка страницы с навигацией, тосты, просмотрщик фотографий, показ размеченного текста
+(`rt-markdown-text`) и остальное.
 
 **Дизайн-система** — `src/styles`:
 
+- `tokens.source.mjs` — вход источника: ступени шкал, назначения и ответ тёмной темы рядом со
+  своим назначением. Сами узлы лежат частями рядом — `tokens.scale-*.mjs` для шкал,
+  `tokens.light-*.mjs` для назначений, `tokens.dark-layout.mjs` и `tokens.coarse-pointer.mjs`
+  для порядка тёмного файла и грубого указателя, — а вход складывает их в два ряда. Три файла
+  ниже и имена в `src/lib/tokens/rt-design-tokens.ts` собираются отсюда командой
+  `pnpm run build:tokens-source` и руками не правятся;
 - `_primitives.scss` — шкалы: нейтральные и цветные ряды, отступы, радиусы, тени, типографика;
 - `_semantic.scss` — назначения поверх шкал (`--rt-color-bg-surface`, `--rt-color-text-muted`);
 - `_theme-dark.scss` — переопределения назначений для `[data-theme='dark']`;
+- `_theme-dark-rules.scss` — правила тёмной темы, которые свойств не объявляют: подложка экранов
+  входа и инверсия логотипа;
 - `_scrollbar.scss` — оформление полос прокрутки;
 - `_breakpoints.scss` — SCSS-переменные порогов: свойства оформления в `@media` не работают,
   поэтому пороги остаются переменными препроцессора;
@@ -98,16 +107,16 @@ export const appConfig: ApplicationConfig = {
 отдаёт функцией-переводчиком:
 
 ```typescript
-import { provideRtKitLabels, RtKitLabelKey, RtKitLabelParams } from '@rt-tools/ui-kit-v2';
+import { provideRtKitLabels, TRtKitLabelKey, TRtKitLabelParams } from '@rt-tools/ui-kit-v2';
 
 provideRtKitLabels({
-    translator: computed(() => (key: RtKitLabelKey, params?: RtKitLabelParams) => myDictionary(key, params)),
+    translator: computed(() => (key: TRtKitLabelKey, params?: TRtKitLabelParams) => myDictionary(key, params)),
     locale: myLocale, // Signal<string>; ею кит форматирует даты
 });
 ```
 
 Способ доставки — дело приложения: Transloco, `$localize`, собственный словарь. Кит знает
-только ключи (`RtKitLabelKey` — перечень выводится из английского набора, поэтому опечатка не
+только ключи (`TRtKitLabelKey` — перечень выводится из английского набора, поэтому опечатка не
 доживает до рантайма) и то, что на них отвечают готовой строкой: подстановки вида `{{name}}`
 переводчик делает сам. Подпись, которой он не дал, берётся английской — поштучно, не набором.