@evergis/uilib-gl 1.0.111 → 1.0.113

package/README.md

@@ -59,6 +59,48 @@ without rebuilding after every update use linking:
 
 ### How to manage icons
 
+**Источник истины набора иконок — объект `iconTypes` в `src/atoms/Icon/Icon.ts`.**
+Инвариант: множество codepoint-ов в `iconTypes` == глифы в `src/fonts/EverCloud.svg` ==
+иконки в `src/fonts/selection.json`. Проверяется командой `yarn check-icons`.
+
+#### Добавить иконку (рекомендуемый способ)
+
+```
+yarn add-icon <путь-к.svg> [--name <имя>] [--padding <0..0.4>]
+```
+
+Скрипт сам: нормализует SVG (SVGO), переносит контур в координаты шрифта (грид 1024,
+флип Y, baseline), назначает следующий свободный codepoint, дописывает глиф в
+`EverCloud.svg` + запись в `selection.json`, вставляет строку в `iconTypes` и
+пересобирает `EverCloud.ttf/woff/eot`. После этого иконка доступна как
+`<Icon kind="<имя>" />`. Если имя уже занято — команда падает с ошибкой.
+
+Требования к исходному SVG: монохромный, контуры залиты (`fill`, не `stroke`),
+есть `viewBox` (желательно квадратный и без лишних полей). Результат стоит
+проверить визуально в Storybook (`yarn storybook`, story `Atoms/Icon`) — особенно
+иконки с отверстиями: при неверном направлении контуров дыра может залиться,
+тогда поправьте исходный SVG и перезапустите.
+
+Дубликаты по содержимому: скрипт сравнивает форму новой иконки с уже имеющимися
+(растровая «подпись» 32×32) и падает с ошибкой, если такая иконка уже есть. Обойти
+намеренно — флаг `--force`.
+
+#### Удалить иконку
+
+```
+yarn remove-icon <имя> [<имя2> ...] [--dry-run]
+```
+
+Снимает строку из `iconTypes` и пересобирает шрифт: глиф уходит из `EverCloud.svg`,
+`selection.json` и всех бинарников. Если codepoint иконки используется ещё одним
+именем-алиасом (напр. `geom_polygon`/`geom_multipolygon`), глиф сохраняется —
+снимается только имя.
+
+Вспомогательные команды: `yarn build-font` — пересобрать шрифт из текущих
+исходников (с приведением к `iconTypes`); `yarn check-icons` — проверить инвариант.
+
+#### Ручной способ через icomoon (fallback)
+
 1. https://icomoon.io/app/#/projects
 2. Import Project из `src/fonts/selection.json`
 3. Load
@@ -66,6 +108,12 @@ without rebuilding after every update use linking:
 5. Generate Font в правом нижнем углу
 6. Замена файлов `src/fonts` на загруженные из архива (папка fonts и selection.json)
 
+Совместимость двух систем: `yarn add-icon` хранит путь в `selection.json` в тех же
+координатах, что и icomoon (связь с глифом шрифта — `font_y = 832 − stored_y`).
+Поэтому оба workflow взаимозаменяемы: `selection.json` можно ре-импортировать в
+icomoon и перегенерировать шрифт (иконки, добавленные скриптом, отобразятся
+корректно), а результат генерации icomoon обрабатывается `yarn build-font` штатно.
+
 ## Used libraries, languages and tools
 
 1. Typescript [Docs](https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html)

package/dist/atoms/Icon/Icon.d.ts

@@ -347,6 +347,7 @@ export declare const iconTypes: {
     bool: string;
     json: string;
     rollup: string;
+    no_geom: string;
 };
 export declare const Icon: import("styled-components").StyledComponent<"span", import("styled-components").DefaultTheme, IIconProps, never>;
 export declare const injectIcon: (icon: IconTypesKeys) => import("styled-components").FlattenInterpolation<import("styled-components").ThemeProps<import("styled-components").DefaultTheme>>;