@icomponents/shell 0.0.0-stage → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +337 -0
- package/hooks/session-rules.test.ts +68 -0
- package/hooks/session-rules.ts +95 -0
- package/package.json +49 -4
- package/src/cabinet-scroll.test.ts +17 -0
- package/src/dashboard-shell.test.tsx +89 -0
- package/src/dashboard-shell.tsx +384 -0
- package/src/nav.test.ts +202 -0
- package/src/nav.ts +297 -0
- package/src/organization.test.tsx +61 -0
- package/src/organization.ts +25 -0
- package/src/package-contract.test.ts +19 -0
- package/src/palette-switch.test.tsx +53 -0
- package/src/platform-header.tsx +84 -0
- package/src/platform-modules.test.tsx +110 -0
- package/src/platform-modules.ts +99 -0
- package/src/session-control.tsx +83 -0
- package/src/use-platform-modules.ts +40 -0
- package/README.md +0 -3
package/AGENTS.md
ADDED
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
# @icomponents/shell — как модулю платформы работать с общим меню, шапкой и стилем
|
|
2
|
+
|
|
3
|
+
Этот файл едет в npm вместе с пакетом, поэтому описывает ровно ту версию, что установлена у
|
|
4
|
+
продукта. Его раздел «Коротко» печатает хук начала сессии в каждом репозитории, где пакет стоит.
|
|
5
|
+
Источник — `icomponents/packages/shell/AGENTS.md`; правило меняется там, а не в продукте.
|
|
6
|
+
|
|
7
|
+
## Коротко
|
|
8
|
+
|
|
9
|
+
- Это общий кабинет ОДНОЙ CRM: модули (`/italent`, `/ipayment`, `/iprofile`, …) — части одного
|
|
10
|
+
продукта, и выглядеть обязаны одинаково. Своей шапки, сайдбара, кнопки входа или переключателя
|
|
11
|
+
темы у модуля нет — только `DashboardShell` из `@icomponents/shell/dashboard-shell`.
|
|
12
|
+
- Пакеты разделены по назначению: `@icomponents/shell` — оболочка и меню, `@icomponents/auth` —
|
|
13
|
+
роли и вход, `@icomponents/theme` — вид кабинета, `@icomponents/registry` — экран-реестр.
|
|
14
|
+
`@iconicompany/ui` (ilanding) заменён ими и больше не развивается.
|
|
15
|
+
- Меню — реестр `PLATFORM_MODULES` (`@icomponents/shell/nav`); оболочка берёт его документом
|
|
16
|
+
ilanding `/platform/modules.json` — пункт меняется выкаткой ilanding. Свои разделы модуль отдаёт ДАННЫМИ
|
|
17
|
+
(`sections` / `sectionGroups`), сессию — данными (`session`), а не вёрсткой. `headerSlot` устарел.
|
|
18
|
+
- **Роли меню — от СВОЕГО модуля, не от iprofile.** Модуль монтирует `GET /<модуль>/api/platform/me`
|
|
19
|
+
обработчиком `createPlatformIdentityHandler` из `@icomponents/auth/server`: он берёт access token
|
|
20
|
+
сессии модуля и читает гранты пользователя в ZITADEL (`/auth/v1/usergrants/me/_search`) — роли всех
|
|
21
|
+
проектов. Токену нужен скоуп `urn:zitadel:iam:org:project:id:zitadel:aud` при входе; без него —
|
|
22
|
+
502 `zitadel-rejected`. Кука iprofile больше ни при чём: меню живёт, пока жива сессия модуля.
|
|
23
|
+
- Оболочка запрашивает этот ответ сама: не передавай `roles` (и `organization`). На 401 —
|
|
24
|
+
`session.onSignIn` модуля (без `session` — перезагрузка, гейт отдаёт 302 на вход), не чаще раза за
|
|
25
|
+
5 мин, потом «Войти»; 502/503 — без ухода. Отключённые гранты в меню не попадают;
|
|
26
|
+
`iprofile:impersonator` добавляется по роли инстанса, как раньше в whoami iprofile. Адрес — `identityUrl`, по умолчанию
|
|
27
|
+
`/<первый сегмент пути>/api/platform/me`. Свой fetch whoami в модуле — удалить. Имя для шапки —
|
|
28
|
+
`usePlatformIdentity({ url })` из `@icomponents/auth/client/use-platform-identity` (тот же запрос).
|
|
29
|
+
- Угол сайдбара — ОРГАНИЗАЦИЯ человека, одна во всех модулях: из того же ответа (организация — из
|
|
30
|
+
клеймов токена модуля). Свой угол через `brandSlot` не рисовать — он устарел.
|
|
31
|
+
- Вид кабинета — ОДИН, из пакета: `@import "@icomponents/theme/cabinet.css"` (палитра светлая и
|
|
32
|
+
тёмная, шрифты по ролям, высота оболочки, палитры выбора) плюс `CABINET_HEAD` из
|
|
33
|
+
`@icomponents/theme/cabinet-head` в `<head>` (шрифты и скрипт против мигания) и строки
|
|
34
|
+
`@source` на `node_modules` кита и пакетов `@icomponents/*`. Своих значений `--background`,
|
|
35
|
+
`--primary` и прочих токенов кита у модуля нет. `brand.css` — только витрина (лендинг).
|
|
36
|
+
- В компонентах — только токены (`bg-primary`, `bg-accent`, `border-border`), никаких hex.
|
|
37
|
+
- `font-mono` — РОЛЬ «механический текст» (Geologica: ставки, шапки колонок), а не моноширинный. Код,
|
|
38
|
+
токены, ключи, где l/1/I обязаны различаться, — `font-code` (системный моноширинный).
|
|
39
|
+
- `--accent` — ПОДЛОЖКА СОСТОЯНИЯ кита (наведение, подсветка пункта), а не цвет бренда: кит красит
|
|
40
|
+
им каждый hover. Насыщенный цвет туда ставить нельзя — вынеси его в свой токен.
|
|
41
|
+
- Темы (`carmine`, `indigo`, …) добавляются в `@icomponents/theme`, не в продукте. Выбор палитры в
|
|
42
|
+
шапке рисует оболочка; выключить у модуля без выпуска пакета — `controls={{ palette: false }}`.
|
|
43
|
+
- Чего-то не хватает в оболочке — добавь шов в пакет (icomponents), а не патч в продукте и не правку
|
|
44
|
+
`node_modules`. Выпуск — только `bun run release` в icomponents.
|
|
45
|
+
- Шапка экрана-реестра и шапка его таблицы — `@icomponents/registry/registry` (`ScreenHeader`,
|
|
46
|
+
`RegistryTableHeader`, `RegistryHead`, для сеток — `RegistryGridHead`), по образцу italent. Свою не рисовать.
|
|
47
|
+
- Панель фильтров (только СЛЕВА), чипы активных фильтров и меню действий строки —
|
|
48
|
+
`@icomponents/registry/registry-filters`. Верхней полосы фильтров нет.
|
|
49
|
+
- Модуль ещё на `@iconicompany/ui` или своём виде — переводить по разделам «Переезд с
|
|
50
|
+
@iconicompany/ui» и «Перевод модуля на общий вид кабинета».
|
|
51
|
+
- Подробно — разделы ниже.
|
|
52
|
+
|
|
53
|
+
## Оболочка кабинета
|
|
54
|
+
|
|
55
|
+
`DashboardShell` (`@icomponents/shell/dashboard-shell`) — одна на все модули. Модуль рендерит её у
|
|
56
|
+
себя и отдаёт пропсами только то, что знает он сам:
|
|
57
|
+
|
|
58
|
+
| проп | что |
|
|
59
|
+
|---|---|
|
|
60
|
+
| `pathname`, `roles`, `user`, `t`, `locale` | путь (подсветка), роли из токена (`null` — ещё едут, меню пустое), перевод, язык |
|
|
61
|
+
| `organization` | `{ name, href? } \| null` — угол сайдбара: плашка с инициалами и название; testid `brand-home` (ссылка), `brand-organization` (название) |
|
|
62
|
+
| `brandTitle` | подпись угла, когда организации нет |
|
|
63
|
+
| `brandSlot` | УСТАРЕЛ: угол вёрсткой модуля развёл кабинеты — переезжай на `organization` |
|
|
64
|
+
| `sections` / `sectionGroups` | разделы САМОГО модуля — плоско или группами (группы побеждают) |
|
|
65
|
+
| `renderSectionLink` | ссылка раздела через роутер модуля — иначе полная перезагрузка на каждом переходе |
|
|
66
|
+
| `session` | `{ user, onSignIn, onSignOut, labels }` — кнопку входа рисует платформа |
|
|
67
|
+
| `center` | середина шапки: поиск модуля |
|
|
68
|
+
| `actions` | узкий слот под действия самого модуля (диагностика и т. п.) |
|
|
69
|
+
| `languageSlot`, `themeSlot` | переключатели языка и светлой/тёмной темы; тема по умолчанию ставится оболочкой |
|
|
70
|
+
| `controls` | видимость того, что оболочка рисует сама: `{ palette?: boolean }`, по умолчанию видно |
|
|
71
|
+
| `headerSlot` | УСТАРЕЛ: широкий слот развёл модули — переезжай на `session` + `actions` |
|
|
72
|
+
|
|
73
|
+
Своих роутера и клиента авторизации у оболочки нет: переход между модулями — обычная навигация
|
|
74
|
+
браузера, соседний модуль живёт в другом бандле.
|
|
75
|
+
|
|
76
|
+
## Меню: реестр модулей и разделы
|
|
77
|
+
|
|
78
|
+
Реестр `PLATFORM_MODULES` в `@icomponents/shell/nav` — единственный ответ на «из чего состоит
|
|
79
|
+
кабинет». Видимость — по РОЛЯМ ПРОЕКТА (`<проект>:<роль>`), а не по правам: право — дело самого
|
|
80
|
+
модуля. Новый модуль добавляется строкой в реестр В ПАКЕТЕ; в продукте список модулей не заводят.
|
|
81
|
+
|
|
82
|
+
**Меню доезжает без пересборки модулей.** ilanding отдаёт реестр документом
|
|
83
|
+
`/platform/modules.json` на общем домене; `DashboardShell` забирает его при загрузке, первый кадр —
|
|
84
|
+
вшитый список пакета, он же запас при сбое. Смена пункта — строка в `nav.ts` и выкатка ilanding;
|
|
85
|
+
выпуск пакета и пересборка модулей для этого не нужны.
|
|
86
|
+
Свой `modules` у оболочки (тесты, превью) побеждает, документ тогда не запрашивается.
|
|
87
|
+
|
|
88
|
+
Подпись пункта в сайдбаре — `title[locale]` из реестра, словарь модуля её не даёт. `titleKey` нужен
|
|
89
|
+
только модулю, который сам рисует плитки хаба своим `t`. Тест «перевод каждого модуля в словаре» с
|
|
90
|
+
меню по сети краснеет на каждом новом пункте, хотя человек ничего не теряет: проверяйте «перевод есть в
|
|
91
|
+
словаре ИЛИ `title.ru`/`title.en` в реестре» — `title` в документе обязателен, без него документ
|
|
92
|
+
отвергается целиком.
|
|
93
|
+
|
|
94
|
+
## Стили: вид кабинета
|
|
95
|
+
|
|
96
|
+
Кит (`@icomponents/react`) не знает ни одного цвета — его компоненты читают CSS-переменные.
|
|
97
|
+
Значения даёт пакет, и у всех кабинетов они ОДНИ (решение владельца 23.09.2026: за основу — вид
|
|
98
|
+
подбора). Входной CSS модуля:
|
|
99
|
+
|
|
100
|
+
```css
|
|
101
|
+
@import "tailwindcss";
|
|
102
|
+
@import "tw-animate-css";
|
|
103
|
+
@import "@icomponents/theme/cabinet.css";
|
|
104
|
+
@source "<путь до node_modules>/@icomponents/react/src";
|
|
105
|
+
@source "<путь до node_modules>/@icomponents/shell/src";
|
|
106
|
+
@source "<путь до node_modules>/@icomponents/theme/src";
|
|
107
|
+
@source "<путь до node_modules>/@icomponents/registry/src";
|
|
108
|
+
|
|
109
|
+
/* ниже — только ПРЕДМЕТНЫЕ токены модуля, которых нет у кита (у подбора `--explain`, `--score-*`),
|
|
110
|
+
с парой для `.dark` и строкой в `@theme inline` */
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Путь в `@source` — от ВХОДНОГО css до `node_modules`, где пакет реально лежит (при изолированной
|
|
114
|
+
раскладке это `apps/web/node_modules`). Автодетект Tailwind в `node_modules` не заходит: без этих
|
|
115
|
+
строк в dev почти незаметно, а в production оболочка приедет голой.
|
|
116
|
+
|
|
117
|
+
`cabinet.css` даёт: базовую палитру `:root` и `.dark`, `--success` / `--warning`, шрифты по ролям
|
|
118
|
+
(`--font-sans` Golos Text, `--font-display` и `--font-mono` Geologica), радиусы от `--radius`,
|
|
119
|
+
`@custom-variant dark` по классу, базовый слой (`border-border`, `body`, заголовки, `.tabular`),
|
|
120
|
+
высоту оболочки `100svh` и палитры выбора (`themes.css`). Своих значений токенов кита у модуля
|
|
121
|
+
нет — ни в `:root`, ни в `.dark`.
|
|
122
|
+
|
|
123
|
+
`<head>` — строка `CABINET_HEAD` из `@icomponents/theme/cabinet-head`: шрифты и скрипт, который до
|
|
124
|
+
первого кадра ставит палитру (`data-brand` из localStorage) и светлоту (класс из cookie `ui-theme`).
|
|
125
|
+
В css её не положить: `@import url(...)` после склейки с tailwindcss оказывается посреди файла, и
|
|
126
|
+
браузер его выбрасывает. Модуль с SSR вставляет строку сам; модуль со статическим `index.html`
|
|
127
|
+
вставляет её один раз и держит тест `expect(missingCabinetHead(indexHtml)).toEqual([])` — после
|
|
128
|
+
обновления пакета он скажет, если строка разошлась.
|
|
129
|
+
|
|
130
|
+
Прокрутку экрана даёт оболочка (`cabinet-scroll` с `overflow-y-auto` вокруг `children`) — свой
|
|
131
|
+
`<main overflow-y-auto>` модулю больше не нужен.
|
|
132
|
+
|
|
133
|
+
`brand.css` — вид ВИТРИНЫ (лендинга): светлый, без тёмной пары. Кабинет его не подключает; оба
|
|
134
|
+
файла сразу нельзя — их `@theme` спорят о шрифтах.
|
|
135
|
+
|
|
136
|
+
## Контракт кита: --accent и занятые имена
|
|
137
|
+
|
|
138
|
+
Имена `--primary`, `--accent`, `--muted`, `--border`, `--ring`, `--sidebar-*` и прочие ЗАНЯТЫ
|
|
139
|
+
китом и означают у него конкретную роль. Самая частая ошибка — `--accent`:
|
|
140
|
+
|
|
141
|
+
- у кита это подложка состояния: `hover:bg-accent`, `data-highlighted:bg-accent` стоят в девяти
|
|
142
|
+
компонентах (`select`, `dropdown-menu`, `command`, `button`, `dialog`, `calendar`, `badge`, …);
|
|
143
|
+
- значит, `--accent` обязан быть БЛИЗОК К ФОНУ своей темы (оттенок в 10–12 %), а
|
|
144
|
+
`--accent-foreground` — читаемыми чернилами на нём;
|
|
145
|
+
- насыщенный цвет со смыслом («слой объяснения», предупреждение) — в СВОЙ токен (`--explain`),
|
|
146
|
+
иначе им зальётся каждое наведение на фильтр.
|
|
147
|
+
|
|
148
|
+
Палитра кабинета живёт в пакете, и страж тоже: `src/cabinet.test.ts` — разница светлоты
|
|
149
|
+
подложки и фона не больше 0.25, контраст текста не меньше 4.5, в обеих темах.
|
|
150
|
+
|
|
151
|
+
## Темы: как добавить
|
|
152
|
+
|
|
153
|
+
Тема — блок `:root[data-brand="<id>"], [data-brand="<id>"]` в `src/themes/<id>.css`, строка
|
|
154
|
+
`@import` в `src/themes.css` и запись в реестре `src/themes.ts`. Оба селектора обязательны:
|
|
155
|
+
`:root[data-brand]` тяжелее собственного `:root` модуля, второй — для модуля, который вешает бренд
|
|
156
|
+
на обёртку внутри страницы.
|
|
157
|
+
|
|
158
|
+
Набор переменных темы обязан совпадать с блоком бренда платформы — незаданное имя молча берётся
|
|
159
|
+
от кита, и посреди перекрашенного экрана оказывается чужая кнопка. Сторожит
|
|
160
|
+
`src/themes/theme-parity.test.ts`.
|
|
161
|
+
|
|
162
|
+
Имена — нейтральные, по палитре, а не по заказчику: палитра `iconic` называлась «брендом
|
|
163
|
+
платформы», бренд сменил цвет, и имя стало враньём.
|
|
164
|
+
|
|
165
|
+
## Шапка реестра и шапка таблицы
|
|
166
|
+
|
|
167
|
+
`@icomponents/registry/registry` — вид italent (`jobs-list`), один на все кабинеты.
|
|
168
|
+
|
|
169
|
+
```tsx
|
|
170
|
+
<ScreenHeader
|
|
171
|
+
title="Вакансии"
|
|
172
|
+
meta={`${total} всего`}
|
|
173
|
+
actions={<Button className={SCREEN_HEADER_ACTION}><Plus />Создать</Button>}
|
|
174
|
+
/>
|
|
175
|
+
<Table>
|
|
176
|
+
<RegistryTableHeader>
|
|
177
|
+
<RegistryHead title="Вакансия" sort={{ direction, onSort, testId: "sort-title" }} />
|
|
178
|
+
<RegistryHead title="Ставка" align="end" />
|
|
179
|
+
</RegistryTableHeader>
|
|
180
|
+
<TableBody>…</TableBody>
|
|
181
|
+
</Table>
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
- `ScreenHeader` — полоса `bg-card` с нижней границей, h1 18/22px, действия справа. testid заголовка —
|
|
185
|
+
`screen-title` кита; `titleTestId` — только для модуля, чьи тесты держатся за старый.
|
|
186
|
+
- `RegistryTableHeader` — строка шапки на фоне холста без подсветки наведения (`data-testid="registry-head"`);
|
|
187
|
+
адаптивную раскладку модуля (`hidden lg:table-header-group`) передают `className`.
|
|
188
|
+
- `RegistryHead` — ячейка: прописные 11px, обычный вес, разрядка. С `sort` — кнопка с `data-dir`
|
|
189
|
+
(`""` / `asc` / `desc`) и `aria-sort` на ячейке. Своя ячейка без компонента — класс `REGISTRY_HEAD_CELL`.
|
|
190
|
+
- `ScreenHeader toolbar={…}` — полоса между заголовком и действиями (переключатель триажа, сегменты):
|
|
191
|
+
на широком экране в одном ряду, на телефоне — своей строкой под ними (`order-last w-full`).
|
|
192
|
+
- Реестр-сетка (строки на `div` + grid, а не `table`) — `RegistryGridHead` вместо `RegistryHead`: тот же
|
|
193
|
+
вид и та же кнопка сортировки, ячейка `div role="columnheader"`; место в сетке и видимость — `className`.
|
|
194
|
+
|
|
195
|
+
## Фильтры реестра и действия строки
|
|
196
|
+
|
|
197
|
+
`@icomponents/registry/registry-filters` — вид и testid italent (`jobs-list`): его сценарии не поедут.
|
|
198
|
+
|
|
199
|
+
```tsx
|
|
200
|
+
const railStatic = useFilterRailStatic(); // рельс от 1360px, ниже — нижний лист
|
|
201
|
+
const [open, setOpen] = useState(false);
|
|
202
|
+
const { draft, set, dirty } = useFilterDraft(applied); // правки копятся до «Применить» / Enter
|
|
203
|
+
|
|
204
|
+
<div className="flex min-h-full min-w-0 flex-col min-[1360px]:h-full">
|
|
205
|
+
<ScreenHeader title="Вакансии" />
|
|
206
|
+
<div className={REGISTRY_BODY}>
|
|
207
|
+
<FilterRail railStatic={railStatic} open={open} onOpenChange={setOpen} label="Фильтры реестра вакансий">
|
|
208
|
+
<FilterPanel activeCount={chips.length} railStatic={railStatic} dirty={dirty}
|
|
209
|
+
onApply={() => dirty && apply(draft)} onReset={reset} onClose={() => setOpen(false)}>
|
|
210
|
+
<FilterField label="Поиск" htmlFor="fQuery"><Input id="fQuery" data-testid="filter-query" /></FilterField>
|
|
211
|
+
<FacetSelect id="filter-grade" title="Уровень" placeholder="Любой" options={…} selected={draft.grades} onToggle={…} />
|
|
212
|
+
</FilterPanel>
|
|
213
|
+
</FilterRail>
|
|
214
|
+
<section className="flex min-h-0 min-w-0 flex-col">
|
|
215
|
+
<ActiveFilterChips chips={chips} railStatic={railStatic} onOpenFilters={() => setOpen(true)} />
|
|
216
|
+
<Table>…<RowActions testId={`job-more-${id}`} label="Действия по вакансии">
|
|
217
|
+
<RowAction data-testid={`job-open-${id}`} render={<Link to="…" />}>Открыть</RowAction>
|
|
218
|
+
<RowAction destructive data-testid={`job-delete-${id}`} onClick={…}>Удалить</RowAction>
|
|
219
|
+
</RowActions>…</Table>
|
|
220
|
+
</section>
|
|
221
|
+
</div>
|
|
222
|
+
<MobileActionBar><MobileFiltersButton activeCount={chips.length} onClick={() => setOpen(true)} /></MobileActionBar>
|
|
223
|
+
</div>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
- testid пакета: `active-filter-count`, `filters-close` (только в листе), `filters-reset`, `filters-apply`
|
|
227
|
+
(на рельсе гаснет без правок), `chip-clear-${chip.id}`, `btn-open-filters-desktop` (когда рельса нет, от lg),
|
|
228
|
+
`btn-open-filters` + `mobile-filter-count`, `${id}-trigger` у фасета. Поля, значения фасетов, кнопку и пункты
|
|
229
|
+
меню строки модуль метит своими testid.
|
|
230
|
+
- Чипы показывают ПРИМЕНЁННОЕ, не черновик. Чип без `clear` — без крестика; состояние вроде «Архивные:
|
|
231
|
+
показаны» — `StateChip` в `leading`.
|
|
232
|
+
- Корпус одним компонентом — `RegistryFilterLayout({ component, label, railStatic, open, onOpenChange, panel,
|
|
233
|
+
children })`: сетка `REGISTRY_BODY`, `FilterRail` слева, реестр в `<section>`. Имена italent
|
|
234
|
+
`useRegistryRailStatic` / `REGISTRY_RAIL_QUERY` — те же хуки пакета. В листе крестик кита спрятан: закрывает `filters-close`.
|
|
235
|
+
- Подписи по умолчанию русские; другой язык — `labels` / `title` / `label`.
|
|
236
|
+
- Таблица и её строки — свои у модуля (или `DataTable` кита); пакет даёт рамку вокруг них.
|
|
237
|
+
|
|
238
|
+
## Контракт вёрстки: data-testid
|
|
239
|
+
|
|
240
|
+
Общие элементы несут `data-testid` из `@icomponents/react/testids`; оболочка ставит свои сама
|
|
241
|
+
(`platform-header`, `brand-home`, `brand-organization`, `color-theme-switch`, `color-theme-<id>`,
|
|
242
|
+
пункты меню). Тест модуля цепляется
|
|
243
|
+
за testid, а не за класс или подпись: после смены темы или редизайна классы меняются все разом.
|
|
244
|
+
|
|
245
|
+
## Переезд с @iconicompany/ui
|
|
246
|
+
|
|
247
|
+
1. Зависимости: убрать `@iconicompany/ui`, добавить `@icomponents/shell`, `@icomponents/auth`,
|
|
248
|
+
`@icomponents/theme` (и `@icomponents/registry`, если есть экраны-реестры) рядом с
|
|
249
|
+
`@icomponents/react`/`tokens` — кит и пакеты платформы — пиры друг друга, одна копия у модуля.
|
|
250
|
+
2. Импорты: `@iconicompany/ui/{dashboard-shell,nav,platform-header,session-control,organization,
|
|
251
|
+
platform-modules}` → `@icomponents/shell/…`; `{cabinet.css,brand.css,themes.css,cabinet-head,
|
|
252
|
+
themes,palette-switch}` → `@icomponents/theme/…`; `{registry,registry-filters}` →
|
|
253
|
+
`@icomponents/registry/…`; `use-platform-identity` → `@icomponents/auth/client/use-platform-identity`
|
|
254
|
+
(теперь `usePlatformIdentity({ url: platformIdentityUrl(pathname) })`, поле ответа — `identity`).
|
|
255
|
+
3. `@source` на `@iconicompany/ui/src` → три строки на `@icomponents/{shell,theme,registry}/src`.
|
|
256
|
+
4. Сервер: смонтировать `GET /api/platform/me` (`createPlatformIdentityHandler({ issuer, resolve })`):
|
|
257
|
+
`resolve` берёт сессию модуля и её access token (better-auth: `auth.api.getAccessToken`), имя и
|
|
258
|
+
организацию из клеймов. Маршрут — закрытый (без сессии 401) в тесте анонимной поверхности.
|
|
259
|
+
5. Вход: добавить скоуп `urn:zitadel:iam:org:project:id:zitadel:aud`. Проверка — после входа ответ
|
|
260
|
+
`/api/platform/me` 200 с ролями соседних проектов, а не 502.
|
|
261
|
+
|
|
262
|
+
## Обновление пакета в продукте
|
|
263
|
+
|
|
264
|
+
1. Поднять версии `@icomponents/*` в `package.json` (во всех, где они объявлены) и `bun install`.
|
|
265
|
+
2. Прогнать проверки продукта: словарь `nav` и контракт `--accent` ловят то, что глазами не видно.
|
|
266
|
+
Пакеты платформы и кит — пиры: держите их в зависимостях модуля одной версии; второй копии в
|
|
267
|
+
`node_modules/@icomponents/shell/node_modules/` быть не должно (два React-контекста).
|
|
268
|
+
3. Раздел «Коротко» этого файла в новой версии — что изменилось в правилах.
|
|
269
|
+
|
|
270
|
+
Свежая версия появляется в npm через несколько минут после выпуска: `npm view @icomponents/shell
|
|
271
|
+
version` ещё какое-то время отдаёт прежнюю — это задержка реестра, а не провал публикации.
|
|
272
|
+
Бывает и наоборот: версия уже есть в метаданных, а tarball ещё отвечает 404, и `bun install` падает —
|
|
273
|
+
повторить через пару минут (если bun держит старый ответ — `bun install --no-cache`).
|
|
274
|
+
|
|
275
|
+
Проверять класс в собранном CSS — `grep -c '\.end-0[{:]'`, а не `.end-0{`: минификатор `Bun.build`
|
|
276
|
+
раскладывает логические свойства на `.end-0:not(:-webkit-any(:lang(ar),…)){right:…}` и зеркало для RTL.
|
|
277
|
+
|
|
278
|
+
## Перевод модуля на общий вид кабинета
|
|
279
|
+
|
|
280
|
+
Проверено переводом iprofile на 0.12 (прод v0.19.24–25). Порядок важен.
|
|
281
|
+
|
|
282
|
+
1. Пакеты `@icomponents/*` по разделу «Переезд», `bun install`. `@icomponents/react` — в зависимостях ТОГО пакета,
|
|
283
|
+
где лежат экраны (у iprofile — `packages/identity`, а не `apps/web`), иначе импорт не резолвится.
|
|
284
|
+
2. Входной css: `tailwindcss` → `tw-animate-css` → `@icomponents/theme/cabinet.css` → свой `theme.css`.
|
|
285
|
+
`@source` на `@icomponents/react/src` и `@icomponents/{shell,theme,registry}/src` — по пути `node_modules`, где пакет
|
|
286
|
+
лежит на самом деле (при изолированной раскладке — `apps/web/node_modules`).
|
|
287
|
+
3. Удалить у модуля: свои `:root`/`.dark` с токенами кита и `@theme inline` для них, `@custom-variant
|
|
288
|
+
dark`, импорт `themes.css` и `brand.css`, дубли базового слоя (`* { border-border }`, фон `body`),
|
|
289
|
+
своё `--font-display` в `@theme`. Остаются только предметные токены модуля (с парой `.dark` и
|
|
290
|
+
строкой в `@theme inline`).
|
|
291
|
+
4. `CABINET_HEAD` — во ВСЕ html-входы, которые отдаёт сервер (у iprofile их два: `index.html` и
|
|
292
|
+
`spa-fallback.html` — второй отдаётся на маршрутах приложения, про него легко забыть), и тест
|
|
293
|
+
`missingCabinetHead` на каждый. Старый скрипт палитры (`color-theme` / `data-theme`) и ссылки на
|
|
294
|
+
прежние шрифты — убрать.
|
|
295
|
+
5. Свой `<main overflow-y-auto>` вокруг экрана — убрать: прокрутку даёт `cabinet-scroll` оболочки.
|
|
296
|
+
6. Шапка и угол — ответ модуля `/api/platform/me` запрашивает оболочка: `roles` не передавать, свой
|
|
297
|
+
fetch удалить (имя — `usePlatformIdentity({ url })`); вкладка — `${title модуля из PLATFORM_MODULES} — кабинет`.
|
|
298
|
+
Переключателя языка у модуля нет: язык `ru`, иначе выбранный когда-то `en` застрянет.
|
|
299
|
+
|
|
300
|
+
Ловушки:
|
|
301
|
+
|
|
302
|
+
- **Имена с другим смыслом.** Старые экраны писали `text-muted` (подпись) и `text-accent` (ссылка), а
|
|
303
|
+
в пакете `--muted` и `--accent` — ФОНЫ: подписи и ссылки становятся почти невидимыми. Грепать
|
|
304
|
+
`text-muted\b`, `text-accent\b`, `bg-surface`, `text-text`, `text-error` → `text-muted-foreground`,
|
|
305
|
+
`text-primary`, `bg-card`, `text-foreground`, `text-destructive`. Временная область с
|
|
306
|
+
переназначенными `--muted`/`--accent` допустима, но не там, где рендерится кит: таблица кита красит
|
|
307
|
+
наведение строки через `bg-muted`.
|
|
308
|
+
- **Текст на кнопке** — только `text-primary-foreground`: `text-surface` на `bg-primary` в тёмной
|
|
309
|
+
теме даёт тёмное по тёмному.
|
|
310
|
+
- **Радиусы** в пакете все равны `var(--radius)`, прежняя шкала shadcn (`sm` = radius − 4px) не
|
|
311
|
+
действует — задай `--radius` там, где нужен старый размер.
|
|
312
|
+
- **Тест прежней палитры** (у iprofile — `theme.test.ts` на «oklch + Inter/Manrope») после перевода
|
|
313
|
+
падает. Его переписывают в страж обратного: `cabinet.css` подключён, своих `:root`/`.dark`/`@theme
|
|
314
|
+
inline` нет. CSS сверять без комментариев: пояснения называют запрещённое по имени.
|
|
315
|
+
- **Экран-реестр — как у italent** (`jobs-list`): шапка `border-b border-border bg-card px-3 pt-3
|
|
316
|
+
pb-2.5 lg:px-4`, h1 `text-[18px] lg:text-[22px] font-bold`, действие — `Button h-10 gap-2 px-3.5
|
|
317
|
+
text-[13.5px]`, таблица кита `Table`/`TableHeader` (`bg-background`)/`TableRow`, формы — в `Sheet`
|
|
318
|
+
справа, а не под списком.
|
|
319
|
+
- **Первая сборка образа** сразу после выпуска пакета может упасть на `bun install --frozen-lockfile`
|
|
320
|
+
(задержка реестра) — повтор проходит.
|
|
321
|
+
|
|
322
|
+
Проверка: снимок одного экрана до и после, в светлой и тёмной теме, рядом с italent; оба стража (css
|
|
323
|
+
и head) зелёные.
|
|
324
|
+
|
|
325
|
+
## Выпуск пакета
|
|
326
|
+
|
|
327
|
+
Только из icomponents и только через GitHub Actions (npm trusted publisher, токена нет):
|
|
328
|
+
`bun run release` (patch), `-- minor`, `-- --dry-run`. Тег `v*` выпускает все пакеты `@icomponents/*`
|
|
329
|
+
одной версией. Подробно — README репозитория.
|
|
330
|
+
|
|
331
|
+
## Единый вид CRM: что осталось
|
|
332
|
+
|
|
333
|
+
Базовая палитра, шрифты и высота оболочки — в пакете (`cabinet.css`, 0.12.0). Модуль переезжает по
|
|
334
|
+
разделу «Перевод модуля на общий вид кабинета»: iprofile переведён; ipayment переведён вместе с шапками
|
|
335
|
+
реестра (0.13.0, 23.09.2026 — локально, выкладку решает владелец); italent — все три реестра на
|
|
336
|
+
`registry` (0.14.0: jobs, offers с `toolbar`, specialists на `RegistryGridHead`; PR #1256, #1258). Палитры
|
|
337
|
+
выбора (`carmine`, `indigo`) пока без тёмной пары: в тёмной теме выбранная палитра остаётся светлой.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { afterAll, describe, expect, test } from "bun:test";
|
|
2
|
+
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { tmpdir } from "node:os";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Хук начала сессии ломается молча в обе стороны. Не нашёл пакет там, где он есть (изолированная
|
|
8
|
+
* раскладка `apps/web/node_modules` у ipayment) — сессия продукта пишет свою шапку, не зная, что
|
|
9
|
+
* она общая. Заговорил там, где пакета нет, — каждая чужая сессия получает лишний контекст, и
|
|
10
|
+
* подсказку перестают читать. Поэтому проверяются оба края, на настоящих каталогах.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
const HOOK = new URL("./session-rules.ts", import.meta.url).pathname;
|
|
14
|
+
const ROOT = mkdtempSync(join(tmpdir(), "ui-hook-"));
|
|
15
|
+
|
|
16
|
+
afterAll(() => rmSync(ROOT, { recursive: true, force: true }));
|
|
17
|
+
|
|
18
|
+
async function run(project: string): Promise<string> {
|
|
19
|
+
const proc = Bun.spawn(["bun", HOOK], {
|
|
20
|
+
env: { ...process.env, CLAUDE_PROJECT_DIR: project },
|
|
21
|
+
stdout: "pipe",
|
|
22
|
+
stderr: "pipe",
|
|
23
|
+
});
|
|
24
|
+
const out = await new Response(proc.stdout).text();
|
|
25
|
+
expect(await proc.exited).toBe(0);
|
|
26
|
+
return out;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function install(project: string, where: string, version: string, rules?: string) {
|
|
30
|
+
const dir = join(project, where, "node_modules", "@icomponents", "shell");
|
|
31
|
+
mkdirSync(dir, { recursive: true });
|
|
32
|
+
writeFileSync(join(dir, "package.json"), JSON.stringify({ name: "@icomponents/shell", version }));
|
|
33
|
+
if (rules) writeFileSync(join(dir, "AGENTS.md"), rules);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const RULES = "# заголовок\n\n## Коротко\n\n- правило-маркер\n\n## Второй раздел\n\nтекст\n";
|
|
37
|
+
|
|
38
|
+
describe("хук правил общей оболочки", () => {
|
|
39
|
+
test("молчит в репозитории без пакета", async () => {
|
|
40
|
+
const project = join(ROOT, "plain");
|
|
41
|
+
mkdirSync(project, { recursive: true });
|
|
42
|
+
expect(await run(project)).toBe("");
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
test("находит пакет в изолированной раскладке и печатает раздел «Коротко»", async () => {
|
|
46
|
+
const project = join(ROOT, "isolated");
|
|
47
|
+
install(project, "apps/web", "0.10.1", RULES);
|
|
48
|
+
const out = await run(project);
|
|
49
|
+
expect(out).toContain("0.10.1");
|
|
50
|
+
expect(out).toContain("правило-маркер");
|
|
51
|
+
expect(out).toContain("Второй раздел");
|
|
52
|
+
expect(out).toContain(join(project, "apps/web/node_modules/@icomponents/shell/AGENTS.md"));
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
test("старая версия без правил — называет версию и просит поднять", async () => {
|
|
56
|
+
const project = join(ROOT, "old");
|
|
57
|
+
install(project, ".", "0.5.0");
|
|
58
|
+
const out = await run(project);
|
|
59
|
+
expect(out).toContain("0.5.0");
|
|
60
|
+
expect(out).toContain("подними");
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
test("в icomponents берёт исходник пакета", async () => {
|
|
64
|
+
const out = await run(new URL("../../..", import.meta.url).pathname);
|
|
65
|
+
expect(out).toContain("исходник");
|
|
66
|
+
expect(out).toContain("packages/shell/AGENTS.md");
|
|
67
|
+
});
|
|
68
|
+
});
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
/**
|
|
3
|
+
* SessionStart: правила ОБЩЕЙ ОБОЛОЧКИ — только в репозитории, где стоит `@icomponents/shell`.
|
|
4
|
+
*
|
|
5
|
+
* Образец — хук idevops (`/opt/idevops/hooks/session-rules.ts`): признак проекта, короткая памятка,
|
|
6
|
+
* путь к полному тексту и его оглавление. Разница одна, и она главная: текст правил берётся из
|
|
7
|
+
* `AGENTS.md` УСТАНОВЛЕННОГО пакета, а не из этого скрипта. Продукт, застрявший на старой версии,
|
|
8
|
+
* получает правила своей версии, а не советы про пропсы, которых у него ещё нет.
|
|
9
|
+
*
|
|
10
|
+
* Пакет ищется и в корневом `node_modules`, и в `apps/*` / `packages/*`: у ipayment раскладка
|
|
11
|
+
* изолированная, в корне его нет вовсе. В самом icomponents берётся исходник `packages/shell`.
|
|
12
|
+
*
|
|
13
|
+
* Печать — раздел «Коротко» целиком плюс оглавление: весь файл держать в контексте каждой сессии
|
|
14
|
+
* незачем. Правило меняется — правится `AGENTS.md` пакета, этот скрипт не трогается.
|
|
15
|
+
*/
|
|
16
|
+
import { existsSync, readdirSync, readFileSync } from "node:fs";
|
|
17
|
+
import { dirname, join } from "node:path";
|
|
18
|
+
|
|
19
|
+
const PACKAGE = "@icomponents/shell";
|
|
20
|
+
const repo = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
|
|
21
|
+
const own = dirname(import.meta.dir);
|
|
22
|
+
|
|
23
|
+
interface Found {
|
|
24
|
+
dir: string;
|
|
25
|
+
version: string;
|
|
26
|
+
source: boolean;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function readPackage(dir: string): { name?: string; version?: string } | null {
|
|
30
|
+
try {
|
|
31
|
+
return JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
|
|
32
|
+
} catch {
|
|
33
|
+
return null;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function locate(): Found | null {
|
|
38
|
+
// icomponents: пакет лежит исходником в рабочей области, `node_modules` на него — ссылка.
|
|
39
|
+
const source = join(repo, "packages", "shell");
|
|
40
|
+
if (readPackage(source)?.name === PACKAGE)
|
|
41
|
+
return { dir: source, version: "исходник", source: true };
|
|
42
|
+
|
|
43
|
+
const roots = ["."];
|
|
44
|
+
for (const group of ["apps", "packages"]) {
|
|
45
|
+
const base = join(repo, group);
|
|
46
|
+
if (!existsSync(base)) continue;
|
|
47
|
+
for (const entry of readdirSync(base, { withFileTypes: true })) {
|
|
48
|
+
if (entry.isDirectory()) roots.push(join(group, entry.name));
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
for (const root of roots) {
|
|
52
|
+
const dir = join(repo, root, "node_modules", "@icomponents", "shell");
|
|
53
|
+
const pkg = readPackage(dir);
|
|
54
|
+
if (pkg?.name === PACKAGE) return { dir, version: pkg.version ?? "?", source: false };
|
|
55
|
+
}
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function section(text: string, title: string): string {
|
|
60
|
+
const start = text.indexOf(`## ${title}\n`);
|
|
61
|
+
if (start === -1) return "";
|
|
62
|
+
const body = text.slice(start + title.length + 4);
|
|
63
|
+
const end = body.indexOf("\n## ");
|
|
64
|
+
return (end === -1 ? body : body.slice(0, end)).trim();
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const found = locate();
|
|
68
|
+
if (!found) process.exit(0);
|
|
69
|
+
|
|
70
|
+
const rulesPath = join(found.dir, "AGENTS.md");
|
|
71
|
+
const where = found.source ? `исходник ${PACKAGE}` : `${PACKAGE} ${found.version}`;
|
|
72
|
+
|
|
73
|
+
if (!existsSync(rulesPath)) {
|
|
74
|
+
// Версия до появления правил в пакете: берём текущие из исходника и честно говорим, что они новее.
|
|
75
|
+
const current = join(own, "AGENTS.md");
|
|
76
|
+
console.log(`[icomponents-shell] В проекте стоит ${where} — общая оболочка платформы (меню, шапка, стиль),
|
|
77
|
+
но правил в этой версии пакета нет. Текущие правила — ${current};
|
|
78
|
+
часть из них описывает пропсы, которых у тебя ещё нет, поэтому сперва подними версию пакета.`);
|
|
79
|
+
process.exit(0);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
const text = readFileSync(rulesPath, "utf8");
|
|
83
|
+
const brief = section(text, "Коротко");
|
|
84
|
+
const sections = text
|
|
85
|
+
.split("\n")
|
|
86
|
+
.filter((line) => line.startsWith("## ") && line !== "## Коротко")
|
|
87
|
+
.map((line) => line.slice(3).trim())
|
|
88
|
+
.join("; ");
|
|
89
|
+
|
|
90
|
+
console.log(`[icomponents-shell] В проекте стоит ${where} — общая оболочка платформы Iconicompany:
|
|
91
|
+
меню, шапка, стиль и темы у всех модулей одни. Свои не заводить.
|
|
92
|
+
|
|
93
|
+
${brief}
|
|
94
|
+
|
|
95
|
+
Полностью — ${rulesPath} (разделы: ${sections}).`);
|
package/package.json
CHANGED
|
@@ -1,6 +1,51 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@icomponents/shell",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "Оболочка кабинета платформы: сайдбар с меню модулей, шапка, вход и выход, реестр модулей",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "UNLICENSED",
|
|
7
|
+
"publishConfig": {
|
|
8
|
+
"access": "public"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"src",
|
|
12
|
+
"hooks",
|
|
13
|
+
"AGENTS.md"
|
|
14
|
+
],
|
|
15
|
+
"exports": {
|
|
16
|
+
"./nav": "./src/nav.ts",
|
|
17
|
+
"./platform-modules": "./src/platform-modules.ts",
|
|
18
|
+
"./use-platform-modules": "./src/use-platform-modules.ts",
|
|
19
|
+
"./dashboard-shell": "./src/dashboard-shell.tsx",
|
|
20
|
+
"./platform-header": "./src/platform-header.tsx",
|
|
21
|
+
"./session-control": "./src/session-control.tsx",
|
|
22
|
+
"./organization": "./src/organization.ts"
|
|
23
|
+
},
|
|
24
|
+
"scripts": {
|
|
25
|
+
"type-check": "bunx tsc --noEmit",
|
|
26
|
+
"test": "bun test"
|
|
27
|
+
},
|
|
28
|
+
"dependencies": {
|
|
29
|
+
"lucide-react": "^1.28.0"
|
|
30
|
+
},
|
|
31
|
+
"peerDependencies": {
|
|
32
|
+
"@icomponents/auth": "^0.1.3",
|
|
33
|
+
"@icomponents/react": "^0.1.3",
|
|
34
|
+
"@icomponents/theme": "^0.1.3",
|
|
35
|
+
"react": ">=19",
|
|
36
|
+
"react-dom": ">=19"
|
|
37
|
+
},
|
|
38
|
+
"devDependencies": {
|
|
39
|
+
"@icomponents/auth": "0.1.0",
|
|
40
|
+
"@icomponents/react": "0.1.1",
|
|
41
|
+
"@icomponents/theme": "0.1.0",
|
|
42
|
+
"@icomponents/typescript-config": "0.0.0",
|
|
43
|
+
"@types/bun": "latest",
|
|
44
|
+
"@types/node": "latest",
|
|
45
|
+
"@types/react": "^19.2.0",
|
|
46
|
+
"@types/react-dom": "^19.2.0",
|
|
47
|
+
"react": "^19.2.7",
|
|
48
|
+
"react-dom": "^19.2.7",
|
|
49
|
+
"typescript": "latest"
|
|
50
|
+
}
|
|
51
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { describe, expect, test } from "bun:test";
|
|
2
|
+
|
|
3
|
+
describe("прокрутка экрана внутри оболочки", () => {
|
|
4
|
+
test("экран лежит в контейнере с собственной прокруткой — пара к высоте 100svh", async () => {
|
|
5
|
+
const { createElement } = await import("react");
|
|
6
|
+
const { renderToStaticMarkup } = await import("react-dom/server");
|
|
7
|
+
const { DashboardShell } = await import("./dashboard-shell");
|
|
8
|
+
const html = renderToStaticMarkup(
|
|
9
|
+
createElement(
|
|
10
|
+
DashboardShell,
|
|
11
|
+
{ pathname: "/iprofile", roles: [], t: (key: string) => key, brandTitle: "Платформа" },
|
|
12
|
+
"экран"
|
|
13
|
+
)
|
|
14
|
+
);
|
|
15
|
+
expect(html).toMatch(/data-testid="cabinet-scroll"[^>]*overflow-y-auto[^>]*>экран</);
|
|
16
|
+
});
|
|
17
|
+
});
|