@mednet/ui 0.0.0-stage → 1.1.0

package/llms.md

@@ -0,0 +1,522 @@
+# @mednet/ui 1.1.0 — справка для AI-агентов
+
+Справка по установленной версии `@mednet/ui` — React-компонентам дизайн-системы ЦНИИОИЗ. Читайте её перед тем, как писать интерфейс.
+
+## Правила
+
+1. **Стили — одна строка** в `app/globals.css`: `@import '@mednet/ui/styles.css';` (внутри Tailwind v4, тема бренда и классы компонентов). Montserrat (`@fontsource/montserrat`) подключается этой же строкой — отдельно ставить и импортировать шрифт не нужно.
+2. **Импорт — по подпутям:** `import { Button } from '@mednet/ui/button';`. Корневой `@mednet/ui` тоже работает, но тянет все модули.
+3. **Основа — Base UI, а не Radix.** Чтобы отрисовать часть компонента другим элементом, используйте проп `render`, **не** `asChild`:
+   ```tsx
+   <DialogTrigger render={<Button variant="outline" />}>Открыть</DialogTrigger>
+   <SidebarMenuButton render={<Link href="/settings" />}>Настройки</SidebarMenuButton>
+   ```
+   **Ссылка, которая выглядит как кнопка**, — это ссылка с классами кнопки, а не `Button` с `render={<a />}` (Base UI навязывает кнопке семантику кнопки):
+   ```tsx
+   import { buttonVariants } from '@mednet/ui/button';
+   <Link href="/reports" className={buttonVariants({ variant: 'outline' })}>Отчёты</Link>
+   ```
+   Примеры из интернета с `asChild` переписывайте на `render`. Не ставьте `@radix-ui/*`, `radix-ui`, `@base-ui/react` напрямую.
+4. **Цвета — только семантические классы:** `bg-primary`, `text-primary-foreground`, `bg-secondary`, `bg-muted`, `text-muted-foreground`, `border-border`, `border-input`, `bg-field` (заливка полей), `ring-ring`, `bg-destructive`, `text-destructive`, `bg-card`, `bg-popover`, `chart-1…chart-8`. Стандартная палитра Tailwind (`slate-100`, `zinc-500`…) удалена, а `red-500`, `blue-700` и другие шкалы — брендовые (из `@mednet/tokens`); hex, `rgb()`, `oklch()` и `bg-[#…]` запрещены линтером (`@mednet/lint-config`).
+5. **Типографика:** заголовки — `text-h1`…`text-h4` (класс задаёт размер, межстрочный и вес: h1 — bold, h2–h4 — semibold; на телефоне размеры меньше), вводный абзац — `text-lead`, остальное — `text-base`/`text-sm`/`text-xs`. Размеры экран/телефон, px: h1 48/32, h2 36/28, h3 28/24, h4 22/20, lead 18/17, base 16, sm 14, xs 13. Шрифт — Montserrat. Своих `text-[…px]` и `font-*` на заголовках не добавляйте.
+6. **Иконки — только `lucide-react`.**
+7. **Корневой layout** (обвязка Base UI):
+   ```tsx
+   <html lang="ru">
+     <body className="relative">
+       <div className="isolate">
+         <TooltipProvider>{children}</TooltipProvider>
+       </div>
+       <Toaster />
+     </body>
+   </html>
+   ```
+   `isolate` — порталы (диалоги, меню, подсказки, уведомления) всегда поверх страницы; `relative` — бэкдропы в Safari iOS 26+; `Toaster` (из `@mednet/ui/toast`) — один на приложение, вызов `toast.add({ title, description, type: 'success' })` из любого клиентского компонента. `TooltipProvider` (из `@mednet/ui/tooltip`) необязателен, он объединяет задержку подсказок.
+8. **Календарь — по-русски:** `<Calendar locale={ru} />`, `import { ru } from 'react-day-picker/locale';`.
+9. **Старые браузеры:** Chrome/Edge 109 (Windows 7/8.1) поддерживаются, если в `postcss.config.mjs` после `@tailwindcss/postcss` стоит `'@mednet/ui/postcss': {}`. Не работают там AI-компоненты `bubble` и эффект `shimmer` (относительные цвета, Chrome 119+) — не используйте их на публичных страницах.
+10. **Свои компоненты склеивают классы через `cn` из `@mednet/ui/utils`**, а не через clsx/tailwind-merge: обычный tailwind-merge не знает размеров шрифта бренда и роняет `text-h3` рядом с `text-foreground`.
+11. Компоненты кита не копируйте в проект и не правьте их стили `className`-ами с цветами: нужен другой вид — спросите у владельцев кита.
+12. **Графики:** `recharts` — peer-зависимость, установите его в проект (`npm i recharts`); компоненты графика импортируйте из `recharts`, обёртки — из `@mednet/ui/chart`.
+13. **Peer-зависимости ставятся сами** (npm 7+, pnpm 8+): `recharts`, `lucide-react` (иконки), `react-day-picker` (календарь, `locale`). Если менеджер их не поставил (yarn, отключён `auto-install-peers`), установите вручную: `npm i recharts lucide-react react-day-picker`. Импортируйте их напрямую только из своего `package.json`.
+
+## Фирменные блоки и каркасы
+
+Серверные компоненты: их можно рендерить в `page.tsx`/`layout.tsx` без `"use client"`.
+
+#### `Logo`
+
+`import { Logo } from '@mednet/ui/logo';`
+
+| Проп              | Тип                                                                     | По умолчанию   |
+| ----------------- | ----------------------------------------------------------------------- | -------------- |
+| `variant`         | `'horizontal' \| 'vertical' \| 'mark'`                                  | `'horizontal'` |
+| `title`           | `string` — доступное имя; без него логотип декоративный (`aria-hidden`) | —              |
+| `className` и др. | атрибуты `<svg>`; размер — классом высоты                               | —              |
+
+```tsx
+<a href="/" aria-label="ЦНИИОИЗ — на главную">
+  <Logo className="h-10 w-auto" />
+</a>
+<Logo variant="mark" title="ЦНИИОИЗ" className="size-12" />
+```
+
+#### `SiteHeader`
+
+`import { SiteHeader } from '@mednet/ui/site-header';` — логотип со ссылкой на главную, навигация, действия.
+
+| Проп       | Тип                         | По умолчанию |
+| ---------- | --------------------------- | ------------ |
+| `homeHref` | `string`                    | `'/'`        |
+| `nav`      | `ReactNode` — ссылки        | —            |
+| `actions`  | `ReactNode` — кнопки справа | —            |
+
+```tsx
+<SiteHeader
+  nav={
+    <>
+      <Link href="/about">О проекте</Link>
+      <Link href="/reports">Отчёты</Link>
+    </>
+  }
+  actions={
+    <Link href="/login" className={buttonVariants({ size: 'sm' })}>
+      Войти
+    </Link>
+  }
+/>
+```
+
+#### `SiteFooter`
+
+`import { SiteFooter, CNIIOIZ } from '@mednet/ui/site-footer';` — реквизиты ЦНИИОИЗ по умолчанию (`CNIIOIZ`: `fullName`, `shortName`, `phone`, `email`).
+
+| Проп             | Тип                                | По умолчанию                      |
+| ---------------- | ---------------------------------- | --------------------------------- |
+| `orgName`        | `string`                           | полное наименование ЦНИИОИЗ       |
+| `copyright`      | `string`                           | `ФГБУ «ЦНИИОИЗ» Минздрава России` |
+| `phone`, `email` | `string \| null` (`null` — скрыть) | телефон и почта ЦНИИОИЗ           |
+| `year`           | `number`                           | текущий                           |
+| `links`          | `ReactNode`                        | —                                 |
+
+```tsx
+<SiteFooter links={<Link href="/privacy">Политика конфиденциальности</Link>} />
+```
+
+#### `PublicLayout`
+
+`import { PublicLayout } from '@mednet/ui/public-layout';` — лендинги и отчёты: ссылка «Перейти к содержанию», `SiteHeader`, `<main id="main">`, `SiteFooter`. Пропсы: `nav`, `actions`, `homeHref` (как у `SiteHeader`), `footer` (замена подвала), `children`.
+
+```tsx
+// app/layout.tsx
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="ru">
+      <body className="relative">
+        <div className="isolate">
+          <PublicLayout nav={<Link href="/about">О проекте</Link>}>{children}</PublicLayout>
+        </div>
+        <Toaster />
+      </body>
+    </html>
+  );
+}
+```
+
+#### `AppShell`
+
+`import { AppShell } from '@mednet/ui/app-shell';` — инструменты, кабинеты, дашборды: боковая панель (shadcn Sidebar, сворачивается до иконок, Ctrl/⌘+B), верхняя панель, содержимое.
+
+| Проп          | Тип                                                                         | По умолчанию |
+| ------------- | --------------------------------------------------------------------------- | ------------ |
+| `nav`         | `ReactNode` — `SidebarGroup`/`SidebarMenu` из `@mednet/ui/sidebar`          | обязателен   |
+| `title`       | `ReactNode` — заголовок в верхней панели                                    | —            |
+| `actions`     | `ReactNode` — правая часть верхней панели                                   | —            |
+| `homeHref`    | `string`                                                                    | `'/'`        |
+| `defaultOpen` | `boolean` — из cookie `sidebar_state`; при `output: 'export'` не передавать | `true`       |
+
+```tsx
+// app/(app)/layout.tsx
+import { LayoutDashboard } from 'lucide-react';
+import { cookies } from 'next/headers';
+import Link from 'next/link';
+import type { ReactNode } from 'react';
+import { AppShell } from '@mednet/ui/app-shell';
+import { SidebarGroup, SidebarMenu, SidebarMenuButton, SidebarMenuItem } from '@mednet/ui/sidebar';
+
+export default async function AppLayout({ children }: { children: ReactNode }) {
+  const defaultOpen = (await cookies()).get('sidebar_state')?.value !== 'false';
+  return (
+    <AppShell
+      defaultOpen={defaultOpen}
+      title="Мониторинг"
+      nav={
+        <SidebarGroup>
+          <SidebarMenu>
+            <SidebarMenuItem>
+              <SidebarMenuButton render={<Link href="/dashboard" />} tooltip="Дашборд">
+                <LayoutDashboard />
+                <span>Дашборд</span>
+              </SidebarMenuButton>
+            </SidebarMenuItem>
+          </SidebarMenu>
+        </SidebarGroup>
+      }
+    >
+      {children}
+    </AppShell>
+  );
+}
+```
+
+## Модули фирменных блоков
+
+### `@mednet/ui/logo`
+
+- компоненты: `Logo`, `LogoHorizontal`, `LogoMark`, `LogoVertical`
+- типы: `LogoProps`
+
+### `@mednet/ui/site-header`
+
+- компоненты: `SiteHeader`
+- типы: `SiteHeaderProps`
+
+### `@mednet/ui/site-footer`
+
+- компоненты: `SiteFooter`
+- типы: `SiteFooterProps`
+- прочее: `CNIIOIZ`
+
+### `@mednet/ui/public-layout`
+
+- компоненты: `PublicLayout`
+- типы: `PublicLayoutProps`
+
+### `@mednet/ui/app-shell`
+
+- компоненты: `AppShell`
+- типы: `AppShellProps`
+
+## Компоненты shadcn/ui (Base UI, стиль Maia)
+
+API и примеры — как в документации shadcn/ui для Base UI (ссылка у каждого модуля). Отличия кита: цвета из токенов бренда, подписи для экранного диктора по-русски.
+
+### `@mednet/ui/accordion`
+
+- компоненты: `Accordion`, `AccordionContent`, `AccordionItem`, `AccordionTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/accordion
+
+### `@mednet/ui/alert`
+
+- компоненты: `Alert`, `AlertAction`, `AlertDescription`, `AlertTitle`
+- документация: https://ui.shadcn.com/docs/components/base/alert
+
+### `@mednet/ui/alert-dialog`
+
+- компоненты: `AlertDialog`, `AlertDialogAction`, `AlertDialogCancel`, `AlertDialogContent`, `AlertDialogDescription`, `AlertDialogFooter`, `AlertDialogHeader`, `AlertDialogMedia`, `AlertDialogOverlay`, `AlertDialogPortal`, `AlertDialogTitle`, `AlertDialogTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/alert-dialog
+
+### `@mednet/ui/aspect-ratio`
+
+- компоненты: `AspectRatio`
+- документация: https://ui.shadcn.com/docs/components/base/aspect-ratio
+
+### `@mednet/ui/attachment`
+
+- компоненты: `Attachment`, `AttachmentAction`, `AttachmentActions`, `AttachmentContent`, `AttachmentDescription`, `AttachmentGroup`, `AttachmentMedia`, `AttachmentTitle`, `AttachmentTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/attachment
+
+### `@mednet/ui/avatar`
+
+- компоненты: `Avatar`, `AvatarBadge`, `AvatarFallback`, `AvatarGroup`, `AvatarGroupCount`, `AvatarImage`
+- документация: https://ui.shadcn.com/docs/components/base/avatar
+
+### `@mednet/ui/badge`
+
+- компоненты: `Badge`
+- прочее: `badgeVariants`
+- документация: https://ui.shadcn.com/docs/components/base/badge
+
+### `@mednet/ui/breadcrumb`
+
+- компоненты: `Breadcrumb`, `BreadcrumbEllipsis`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbList`, `BreadcrumbPage`, `BreadcrumbSeparator`
+- документация: https://ui.shadcn.com/docs/components/base/breadcrumb
+
+### `@mednet/ui/bubble`
+
+- компоненты: `Bubble`, `BubbleContent`, `BubbleGroup`, `BubbleReactions`
+- документация: https://ui.shadcn.com/docs/components/base/bubble
+
+### `@mednet/ui/button`
+
+- компоненты: `Button`
+- прочее: `buttonVariants`
+- документация: https://ui.shadcn.com/docs/components/base/button
+
+### `@mednet/ui/button-group`
+
+- компоненты: `ButtonGroup`, `ButtonGroupSeparator`, `ButtonGroupText`
+- прочее: `buttonGroupVariants`
+- документация: https://ui.shadcn.com/docs/components/base/button-group
+
+### `@mednet/ui/calendar`
+
+- компоненты: `Calendar`, `CalendarDayButton`
+- документация: https://ui.shadcn.com/docs/components/base/calendar
+
+### `@mednet/ui/card`
+
+- компоненты: `Card`, `CardAction`, `CardContent`, `CardDescription`, `CardFooter`, `CardHeader`, `CardTitle`
+- документация: https://ui.shadcn.com/docs/components/base/card
+
+### `@mednet/ui/carousel`
+
+- компоненты: `Carousel`, `CarouselContent`, `CarouselItem`, `CarouselNext`, `CarouselPrevious`
+- хуки: `useCarousel`
+- типы: `CarouselApi`
+- документация: https://ui.shadcn.com/docs/components/base/carousel
+
+### `@mednet/ui/chart`
+
+- компоненты: `ChartContainer`, `ChartLegend`, `ChartLegendContent`, `ChartStyle`, `ChartTooltip`, `ChartTooltipContent`
+- типы: `ChartConfig`
+- документация: https://ui.shadcn.com/docs/components/base/chart
+
+### `@mednet/ui/checkbox`
+
+- компоненты: `Checkbox`
+- документация: https://ui.shadcn.com/docs/components/base/checkbox
+
+### `@mednet/ui/collapsible`
+
+- компоненты: `Collapsible`, `CollapsibleContent`, `CollapsibleTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/collapsible
+
+### `@mednet/ui/combobox`
+
+- компоненты: `Combobox`, `ComboboxChip`, `ComboboxChips`, `ComboboxChipsInput`, `ComboboxCollection`, `ComboboxContent`, `ComboboxEmpty`, `ComboboxGroup`, `ComboboxInput`, `ComboboxItem`, `ComboboxLabel`, `ComboboxList`, `ComboboxSeparator`, `ComboboxTrigger`, `ComboboxValue`
+- хуки: `useComboboxAnchor`
+- документация: https://ui.shadcn.com/docs/components/base/combobox
+
+### `@mednet/ui/command`
+
+- компоненты: `Command`, `CommandDialog`, `CommandEmpty`, `CommandGroup`, `CommandInput`, `CommandItem`, `CommandList`, `CommandSeparator`, `CommandShortcut`
+- документация: https://ui.shadcn.com/docs/components/base/command
+
+### `@mednet/ui/context-menu`
+
+- компоненты: `ContextMenu`, `ContextMenuCheckboxItem`, `ContextMenuContent`, `ContextMenuGroup`, `ContextMenuItem`, `ContextMenuLabel`, `ContextMenuPortal`, `ContextMenuRadioGroup`, `ContextMenuRadioItem`, `ContextMenuSeparator`, `ContextMenuShortcut`, `ContextMenuSub`, `ContextMenuSubContent`, `ContextMenuSubTrigger`, `ContextMenuTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/context-menu
+
+### `@mednet/ui/dialog`
+
+- компоненты: `Dialog`, `DialogClose`, `DialogContent`, `DialogDescription`, `DialogFooter`, `DialogHeader`, `DialogOverlay`, `DialogPortal`, `DialogTitle`, `DialogTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/dialog
+
+### `@mednet/ui/direction`
+
+- компоненты: `DirectionProvider`
+- хуки: `useDirection`
+- документация: https://ui.shadcn.com/docs/components/base/direction
+
+### `@mednet/ui/drawer`
+
+- компоненты: `Drawer`, `DrawerClose`, `DrawerContent`, `DrawerDescription`, `DrawerFooter`, `DrawerHeader`, `DrawerOverlay`, `DrawerPortal`, `DrawerSwipeHandle`, `DrawerTitle`, `DrawerTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/drawer
+
+### `@mednet/ui/dropdown-menu`
+
+- компоненты: `DropdownMenu`, `DropdownMenuCheckboxItem`, `DropdownMenuContent`, `DropdownMenuGroup`, `DropdownMenuItem`, `DropdownMenuLabel`, `DropdownMenuPortal`, `DropdownMenuRadioGroup`, `DropdownMenuRadioItem`, `DropdownMenuSeparator`, `DropdownMenuShortcut`, `DropdownMenuSub`, `DropdownMenuSubContent`, `DropdownMenuSubTrigger`, `DropdownMenuTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/dropdown-menu
+
+### `@mednet/ui/empty`
+
+- компоненты: `Empty`, `EmptyContent`, `EmptyDescription`, `EmptyHeader`, `EmptyMedia`, `EmptyTitle`
+- документация: https://ui.shadcn.com/docs/components/base/empty
+
+### `@mednet/ui/field`
+
+- компоненты: `Field`, `FieldContent`, `FieldDescription`, `FieldError`, `FieldGroup`, `FieldLabel`, `FieldLegend`, `FieldSeparator`, `FieldSet`, `FieldTitle`
+- документация: https://ui.shadcn.com/docs/components/base/field
+
+### `@mednet/ui/hover-card`
+
+- компоненты: `HoverCard`, `HoverCardContent`, `HoverCardTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/hover-card
+
+### `@mednet/ui/input`
+
+- компоненты: `Input`
+- документация: https://ui.shadcn.com/docs/components/base/input
+
+### `@mednet/ui/input-group`
+
+- компоненты: `InputGroup`, `InputGroupAddon`, `InputGroupButton`, `InputGroupInput`, `InputGroupText`, `InputGroupTextarea`
+- документация: https://ui.shadcn.com/docs/components/base/input-group
+
+### `@mednet/ui/input-otp`
+
+- компоненты: `InputOTP`, `InputOTPGroup`, `InputOTPSeparator`, `InputOTPSlot`
+- документация: https://ui.shadcn.com/docs/components/base/input-otp
+
+### `@mednet/ui/item`
+
+- компоненты: `Item`, `ItemActions`, `ItemContent`, `ItemDescription`, `ItemFooter`, `ItemGroup`, `ItemHeader`, `ItemMedia`, `ItemSeparator`, `ItemTitle`
+- документация: https://ui.shadcn.com/docs/components/base/item
+
+### `@mednet/ui/kbd`
+
+- компоненты: `Kbd`, `KbdGroup`
+- документация: https://ui.shadcn.com/docs/components/base/kbd
+
+### `@mednet/ui/label`
+
+- компоненты: `Label`
+- документация: https://ui.shadcn.com/docs/components/base/label
+
+### `@mednet/ui/marker`
+
+- компоненты: `Marker`, `MarkerContent`, `MarkerIcon`
+- прочее: `markerVariants`
+- документация: https://ui.shadcn.com/docs/components/base/marker
+
+### `@mednet/ui/menubar`
+
+- компоненты: `Menubar`, `MenubarCheckboxItem`, `MenubarContent`, `MenubarGroup`, `MenubarItem`, `MenubarLabel`, `MenubarMenu`, `MenubarPortal`, `MenubarRadioGroup`, `MenubarRadioItem`, `MenubarSeparator`, `MenubarShortcut`, `MenubarSub`, `MenubarSubContent`, `MenubarSubTrigger`, `MenubarTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/menubar
+
+### `@mednet/ui/message`
+
+- компоненты: `Message`, `MessageAvatar`, `MessageContent`, `MessageFooter`, `MessageGroup`, `MessageHeader`
+- документация: https://ui.shadcn.com/docs/components/base/message
+
+### `@mednet/ui/message-scroller`
+
+- компоненты: `MessageScroller`, `MessageScrollerButton`, `MessageScrollerContent`, `MessageScrollerItem`, `MessageScrollerProvider`, `MessageScrollerViewport`
+- хуки: `useMessageScroller`, `useMessageScrollerScrollable`, `useMessageScrollerVisibility`
+- документация: https://ui.shadcn.com/docs/components/base/message-scroller
+
+### `@mednet/ui/native-select`
+
+- компоненты: `NativeSelect`, `NativeSelectOptGroup`, `NativeSelectOption`
+- документация: https://ui.shadcn.com/docs/components/base/native-select
+
+### `@mednet/ui/navigation-menu`
+
+- компоненты: `NavigationMenu`, `NavigationMenuContent`, `NavigationMenuIndicator`, `NavigationMenuItem`, `NavigationMenuLink`, `NavigationMenuList`, `NavigationMenuPositioner`, `NavigationMenuTrigger`
+- прочее: `navigationMenuTriggerStyle`
+- документация: https://ui.shadcn.com/docs/components/base/navigation-menu
+
+### `@mednet/ui/pagination`
+
+- компоненты: `Pagination`, `PaginationContent`, `PaginationEllipsis`, `PaginationItem`, `PaginationLink`, `PaginationNext`, `PaginationPrevious`
+- документация: https://ui.shadcn.com/docs/components/base/pagination
+
+### `@mednet/ui/popover`
+
+- компоненты: `Popover`, `PopoverContent`, `PopoverDescription`, `PopoverHeader`, `PopoverTitle`, `PopoverTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/popover
+
+### `@mednet/ui/progress`
+
+- компоненты: `Progress`, `ProgressIndicator`, `ProgressLabel`, `ProgressTrack`, `ProgressValue`
+- документация: https://ui.shadcn.com/docs/components/base/progress
+
+### `@mednet/ui/questionnaire`
+
+- компоненты: `Questionnaire`, `QuestionnaireActions`, `QuestionnaireChoice`, `QuestionnaireChoiceDescription`, `QuestionnaireChoices`, `QuestionnaireDescription`, `QuestionnaireError`, `QuestionnaireInput`, `QuestionnaireItem`, `QuestionnaireNext`, `QuestionnairePrevious`, `QuestionnaireProgress`, `QuestionnaireSkip`, `QuestionnaireSubmit`, `QuestionnaireTitle`
+- документация: https://ui.shadcn.com/docs/components/base/questionnaire
+
+### `@mednet/ui/radio-group`
+
+- компоненты: `RadioGroup`, `RadioGroupItem`
+- документация: https://ui.shadcn.com/docs/components/base/radio-group
+
+### `@mednet/ui/resizable`
+
+- компоненты: `ResizableHandle`, `ResizablePanel`, `ResizablePanelGroup`
+- документация: https://ui.shadcn.com/docs/components/base/resizable
+
+### `@mednet/ui/scroll-area`
+
+- компоненты: `ScrollArea`, `ScrollBar`
+- документация: https://ui.shadcn.com/docs/components/base/scroll-area
+
+### `@mednet/ui/select`
+
+- компоненты: `Select`, `SelectContent`, `SelectGroup`, `SelectItem`, `SelectLabel`, `SelectScrollDownButton`, `SelectScrollUpButton`, `SelectSeparator`, `SelectTrigger`, `SelectValue`
+- документация: https://ui.shadcn.com/docs/components/base/select
+
+### `@mednet/ui/separator`
+
+- компоненты: `Separator`
+- документация: https://ui.shadcn.com/docs/components/base/separator
+
+### `@mednet/ui/sheet`
+
+- компоненты: `Sheet`, `SheetClose`, `SheetContent`, `SheetDescription`, `SheetFooter`, `SheetHeader`, `SheetTitle`, `SheetTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/sheet
+
+### `@mednet/ui/sidebar`
+
+- компоненты: `Sidebar`, `SidebarContent`, `SidebarFooter`, `SidebarGroup`, `SidebarGroupAction`, `SidebarGroupContent`, `SidebarGroupLabel`, `SidebarHeader`, `SidebarInput`, `SidebarInset`, `SidebarMenu`, `SidebarMenuAction`, `SidebarMenuBadge`, `SidebarMenuButton`, `SidebarMenuItem`, `SidebarMenuSkeleton`, `SidebarMenuSub`, `SidebarMenuSubButton`, `SidebarMenuSubItem`, `SidebarProvider`, `SidebarRail`, `SidebarSeparator`, `SidebarTrigger`
+- хуки: `useSidebar`
+- документация: https://ui.shadcn.com/docs/components/base/sidebar
+
+### `@mednet/ui/skeleton`
+
+- компоненты: `Skeleton`
+- документация: https://ui.shadcn.com/docs/components/base/skeleton
+
+### `@mednet/ui/slider`
+
+- компоненты: `Slider`
+- документация: https://ui.shadcn.com/docs/components/base/slider
+
+### `@mednet/ui/spinner`
+
+- компоненты: `Spinner`
+- документация: https://ui.shadcn.com/docs/components/base/spinner
+
+### `@mednet/ui/switch`
+
+- компоненты: `Switch`
+- документация: https://ui.shadcn.com/docs/components/base/switch
+
+### `@mednet/ui/table`
+
+- компоненты: `Table`, `TableBody`, `TableCaption`, `TableCell`, `TableFooter`, `TableHead`, `TableHeader`, `TableRow`
+- документация: https://ui.shadcn.com/docs/components/base/table
+
+### `@mednet/ui/tabs`
+
+- компоненты: `Tabs`, `TabsContent`, `TabsList`, `TabsTrigger`
+- прочее: `tabsListVariants`
+- документация: https://ui.shadcn.com/docs/components/base/tabs
+
+### `@mednet/ui/textarea`
+
+- компоненты: `Textarea`
+- документация: https://ui.shadcn.com/docs/components/base/textarea
+
+### `@mednet/ui/toast`
+
+- компоненты: `Toast`, `ToastAction`, `ToastClose`, `ToastContent`, `ToastDescription`, `ToastPortal`, `ToastProvider`, `ToastTitle`, `ToastViewport`, `Toaster`
+- хуки: `useToastManager`
+- прочее: `createToastManager`, `toast`
+- документация: https://ui.shadcn.com/docs/components/base/toast
+
+### `@mednet/ui/toggle`
+
+- компоненты: `Toggle`
+- прочее: `toggleVariants`
+- документация: https://ui.shadcn.com/docs/components/base/toggle
+
+### `@mednet/ui/toggle-group`
+
+- компоненты: `ToggleGroup`, `ToggleGroupItem`
+- документация: https://ui.shadcn.com/docs/components/base/toggle-group
+
+### `@mednet/ui/tooltip`
+
+- компоненты: `Tooltip`, `TooltipContent`, `TooltipProvider`, `TooltipTrigger`
+- документация: https://ui.shadcn.com/docs/components/base/tooltip

package/package.json

@@ -1,6 +1,133 @@
 {
   "name": "@mednet/ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.1.0",
+  "description": "React-компоненты ЦНИИОИЗ: shadcn/ui (Base UI, стиль Maia) в теме бренда, логотип, шапка, подвал, каркасы страниц",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hpnssflw/mednet-kit.git",
+    "directory": "packages/ui"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "llms.md",
+    "postcss.cjs",
+    "src/styles.css",
+    "src/brand.css",
+    "src/shadcn-tailwind.css",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "imports": {
+    "#components/*": {
+      "mednet-source": "./src/components/*.tsx",
+      "default": "./dist/components/*.js"
+    },
+    "#hooks/*": {
+      "mednet-source": "./src/hooks/*.ts",
+      "default": "./dist/hooks/*.js"
+    },
+    "#lib/*": {
+      "mednet-source": "./src/lib/*.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./styles.css": "./src/styles.css",
+    "./llms.md": "./llms.md",
+    "./postcss": "./postcss.cjs",
+    "./utils": {
+      "types": "./dist/lib/utils.d.ts",
+      "default": "./dist/lib/utils.js"
+    },
+    "./logo": {
+      "types": "./dist/brand/logo.d.ts",
+      "default": "./dist/brand/logo.js"
+    },
+    "./site-header": {
+      "types": "./dist/brand/site-header.d.ts",
+      "default": "./dist/brand/site-header.js"
+    },
+    "./site-footer": {
+      "types": "./dist/brand/site-footer.d.ts",
+      "default": "./dist/brand/site-footer.js"
+    },
+    "./public-layout": {
+      "types": "./dist/layouts/public-layout.d.ts",
+      "default": "./dist/layouts/public-layout.js"
+    },
+    "./app-shell": {
+      "types": "./dist/layouts/app-shell.d.ts",
+      "default": "./dist/layouts/app-shell.js"
+    },
+    "./*": {
+      "types": "./dist/components/*.d.ts",
+      "default": "./dist/components/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "lucide-react": "^1.57.0",
+    "react": "^19.2.0",
+    "react-day-picker": "^10.0.2",
+    "react-dom": "^19.2.0",
+    "recharts": "^3.8.0",
+    "tailwindcss": "^4.3.0"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.9.0",
+    "@fontsource/montserrat": "^5.3.0",
+    "@shadcn/react": "^0.3.1",
+    "class-variance-authority": "^0.7.1",
+    "cmdk": "^1.1.1",
+    "cn": "^0.4.0",
+    "date-fns": "^4.4.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.5.0",
+    "lightningcss": "^1.33.0",
+    "react-resizable-panels": "^4.14.5",
+    "tw-animate-css": "^1.4.0",
+    "@mednet/tokens": "1.1.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/node": "^4.3.3",
+    "@testing-library/jest-dom": "7.0.1",
+    "@testing-library/react": "16.3.3",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^24",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "30.1.2",
+    "lucide-react": "^1.57.0",
+    "postcss": "^8.5.30",
+    "react": "^19.3.0",
+    "react-day-picker": "^10.0.2",
+    "react-dom": "^19.3.0",
+    "recharts": "3.8.0",
+    "shadcn": "4.21.4",
+    "svgo": "4.1.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "~6.0.3",
+    "vitest": "^5.0.4"
+  },
+  "scripts": {
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json && node scripts/build-llms.mjs",
+    "logos": "node scripts/gen-logos.mjs",
+    "gen:index": "node scripts/gen-index.mjs",
+    "generate": "shadcn add --all -y --overwrite && node scripts/postgen.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "vendor-css": "node scripts/vendor-shadcn-css.mjs"
+  }
 }