@dskripchenko/ui 0.5.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Denis Skripchenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.de.md

@@ -0,0 +1,145 @@
+# @dskripchenko/ui
+
+Eine Bibliothek aus Vue-3-Komponenten, Tokens und Themes auf Basis von CSS Custom Properties.
+
+[English](./README.md) · [Русский](./README.ru.md) · [**Deutsch**](./README.de.md) · [中文](./README.zh.md)
+
+[![npm](https://img.shields.io/npm/v/@dskripchenko/ui.svg)](https://www.npmjs.com/package/@dskripchenko/ui)
+[![bundle](https://img.shields.io/bundlephobia/minzip/@dskripchenko/ui)](https://bundlephobia.com/package/@dskripchenko/ui)
+[![license](https://img.shields.io/npm/l/@dskripchenko/ui.svg)](./LICENSE)
+
+> **Status:** stabil. SemVer-Garantien gelten — Breaking Changes nur in Major-Versionen.
+
+📖 **Storybook:** [dskripchenko.github.io/ui](https://dskripchenko.github.io/ui/)
+
+## Highlights
+
+- **70+ Komponenten** — Formulare, Navigation, Overlays, Datenanzeige, Charts, Patterns, Layouts
+- **Vue 3 + TypeScript** — Composition API, `<script setup>`, vollständig typisiert
+- **CSS Custom Properties** — kein CSS-in-JS, kein Tailwind, keine Präprozessoren; alles über Variablen
+- **Light / Dark Themes** — Umschalten über `data-theme` auf `:root`, einfach zu überschreiben
+- **Tree-shakable** — Import pro Komponente, ESM + CJS Builds
+- **A11y** — `:focus-visible`, ARIA-Attribute, Tastatur-Navigation in allen interaktiven Komponenten
+- **i18n** — eingebaute `ru` + `en` Locales, `UidLocaleProvider` für partielle Überschreibungen und eigene Locales
+- **~1500 Icons** — `lucide-vue-next` unter der Haube + Sub-Export `@dskripchenko/ui/icons`
+- **Keine Runtime-Chart-Deps** — eingebaute SVG-Primitive (Sparkline, ProgressRing, Gauge, Heatmap)
+
+## Installation
+
+```bash
+pnpm add @dskripchenko/ui
+# oder
+npm install @dskripchenko/ui
+```
+
+## Schnellstart
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import App from './App.vue'
+
+import '@dskripchenko/ui/styles/tokens.css'
+import '@dskripchenko/ui/styles/themes.css'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { UidButton, UidIcon, UidLocaleProvider, en } from '@dskripchenko/ui'
+import { Check } from '@dskripchenko/ui/icons'
+</script>
+
+<template>
+  <UidLocaleProvider :locale="en">
+    <UidButton variant="primary">
+      <UidIcon :icon="Check" /> Speichern
+    </UidButton>
+  </UidLocaleProvider>
+</template>
+```
+
+Theme über Attribut auf `<html>` umschalten:
+
+```html
+<html data-theme="dark">
+```
+
+## Inhalt
+
+Kurze Auswahl — vollständiger Katalog im [Storybook](https://dskripchenko.github.io/ui/).
+
+**Formulare & Eingabe:** Button, Input, Textarea, NumberInput, Checkbox, Radio, Switch, Label, FormField, Select, Combobox, TagsInput, DatePicker, DateRangePicker, TimePicker, ColorPicker, Slider, Rating, FileUpload, Mention, TreeSelect, Cascader
+
+**Feedback:** Spinner, Skeleton, Badge, Alert, Progress, Toast, Tour
+
+**Overlays:** Modal, Drawer, Tooltip, Popover, Menu, Command
+
+**Navigation:** Tabs, Breadcrumb, Link, Pagination (+ Cursor / LoadMore / InfiniteScroll / PageSize), BackTop, Affix, Anchor
+
+**Datenanzeige:** Card, Avatar, AvatarGroup, Tag, Divider, Accordion, Table, VirtualList, Stat, DescriptionList, Timeline, TreeView, Code, Watermark, Carousel, Calendar, NotificationBadge
+
+**Layout-Helfer:** Stack, Grid, Container, Splitter
+
+**Charts:** Sparkline, ProgressRing, Gauge, Heatmap
+
+**Wizards:** Stepper, Wizard, WizardStep
+
+**Patterns:** Header, Footer, Sidebar, PageHeader, EmptyState, ErrorState, Result
+
+**Layouts:** SimpleLayout, SidebarLayout, AuthLayout, WizardLayout
+
+**Composables:** useTheme, useLocale, useField, useToast, useWizard, useSidebar, useCommandPalette, useFocusTrap, useScrollLock, usePopover
+
+## Dokumentation
+
+Anwender-Dokumentation in vier Sprachen — wähle deine:
+
+- 🇬🇧 **English** (default): [docs/en/](./docs/en/)
+- 🇷🇺 **Русский**: [docs/ru/](./docs/ru/)
+- 🇩🇪 **Deutsch**: [Erste Schritte](./docs/de/getting-started.md), [Theming](./docs/de/theming.md), [Tokens](./docs/de/tokens.md), [Icons](./docs/de/icons.md), [Patterns](./docs/de/patterns.md), [Validation](./docs/de/validation.md), [Charts](./docs/de/charts.md), [i18n](./docs/de/i18n.md)
+- 🇨🇳 **中文**: [docs/zh/](./docs/zh/)
+
+Mitwirkenden-Dokumentation (nur Englisch): [Architecture](./docs/ARCHITECTURE.md), [Component guidelines](./docs/COMPONENT_GUIDELINES.md), [Contributing](./docs/CONTRIBUTING.md), [Roadmap](./docs/ROADMAP.md).
+
+## Theming
+
+Alle Farben, Abstände und Schriften sind CSS-Variablen. Theme überschreiben — Tokens auf `:root` oder einem Container setzen:
+
+```css
+:root[data-theme='dark'] {
+  --uid-color-primary: #8b5cf6;
+  --uid-color-bg: #0a0a0a;
+}
+```
+
+Mehr in [Theming](./docs/de/theming.md) und [Tokens](./docs/de/tokens.md).
+
+## Icons
+
+Sub-Export `@dskripchenko/ui/icons` re-exportiert alle ~1500 Lucide-Icons:
+
+```ts
+import { UidIcon } from '@dskripchenko/ui'
+import { Heart, Star } from '@dskripchenko/ui/icons'
+```
+
+Mehr in [Icons](./docs/de/icons.md).
+
+## Entwicklung
+
+```bash
+pnpm install
+pnpm dev               # Storybook auf :6006
+pnpm test              # Vitest
+pnpm build             # Library-Build
+pnpm build-storybook   # Storybook → storybook-static
+pnpm build:analyze     # Bundle-Visualizer
+pnpm changeset         # Änderung fürs nächste Release beschreiben
+```
+
+## Lizenz
+
+MIT

package/README.md

@@ -1,34 +1,38 @@
 # @dskripchenko/ui
 
-Набор Vue 3 компонентов, токенов и тем на CSS custom properties.
+A Vue 3 component, token, and theme library on CSS custom properties.
+
+[**English**](./README.md) · [Русский](./README.ru.md) · [Deutsch](./README.de.md) · [中文](./README.zh.md)
 
 [![npm](https://img.shields.io/npm/v/@dskripchenko/ui.svg)](https://www.npmjs.com/package/@dskripchenko/ui)
 [![bundle](https://img.shields.io/bundlephobia/minzip/@dskripchenko/ui)](https://bundlephobia.com/package/@dskripchenko/ui)
 [![license](https://img.shields.io/npm/l/@dskripchenko/ui.svg)](./LICENSE)
 
-> **Статус:** ранняя разработка. API нестабилен до `1.0`.
+> **Status:** stable. SemVer guarantees apply — breaking changes only on a major bump.
 
 📖 **Storybook:** [dskripchenko.github.io/ui](https://dskripchenko.github.io/ui/)
 
-## Особенности
+## Highlights
 
-- **59 компонентов** — формы, навигация, оверлеи, отображение данных, паттерны и лейауты
-- **Vue 3 + TypeScript** — Composition API, `<script setup>`, полная типизация
-- **CSS custom properties** — никакого CSS-in-JS, Tailwind или препроцессоров; всё через переменные
-- **Light / Dark темы** — через `data-theme` на `:root`, легко переопределяются
-- **Tree-shakeable** — импорт по компонентам, ESM + CJS сборки
-- **A11y** — `:focus-visible`, ARIA-атрибуты, keyboard-навигация во всех интерактивных компонентах
-- **~1500 иконок** — `lucide-vue-next` под капотом + sub-export `@dskripchenko/ui/icons`
+- **70+ components** — forms, navigation, overlays, data display, charts, patterns, layouts
+- **Vue 3 + TypeScript** — Composition API, `<script setup>`, fully typed
+- **CSS custom properties** — no CSS-in-JS, no Tailwind, no preprocessors; everything is variables
+- **Light / Dark themes** — toggled via `data-theme` on `:root`, easy to override
+- **Tree-shakable** — per-component imports, ESM + CJS builds
+- **A11y** — `:focus-visible`, ARIA attributes, keyboard navigation across every interactive component
+- **i18n** — built-in `ru` + `en` locales, `UidLocaleProvider` for partial overrides or custom locales
+- **~1500 icons** — `lucide-vue-next` under the hood + `@dskripchenko/ui/icons` sub-export
+- **Zero runtime chart deps** — built-in SVG primitives (Sparkline, ProgressRing, Gauge, Heatmap)
 
-## Установка
+## Install
 
 ```bash
 pnpm add @dskripchenko/ui
-# или
+# or
 npm install @dskripchenko/ui
 ```
 
-## Быстрый старт
+## Quick start
 
 ```ts
 // main.ts
@@ -44,70 +48,65 @@ createApp(App).mount('#app')
 ```vue
 <!-- App.vue -->
 <script setup lang="ts">
-import { UidButton, UidIcon } from '@dskripchenko/ui'
+import { UidButton, UidIcon, UidLocaleProvider, en } from '@dskripchenko/ui'
 import { Check } from '@dskripchenko/ui/icons'
 </script>
 
 <template>
-  <UidButton variant="primary">
-    <UidIcon :icon="Check" /> Привет
-  </UidButton>
+  <UidLocaleProvider :locale="en">
+    <UidButton variant="primary">
+      <UidIcon :icon="Check" /> Save
+    </UidButton>
+  </UidLocaleProvider>
 </template>
 ```
 
-Переключение темы — атрибут на `<html>`:
+Switch theme by attribute on `<html>`:
 
 ```html
 <html data-theme="dark">
 ```
 
-## Состав библиотеки
-
-### Базовые формы и ввод
-
-`UidButton`, `UidInput`, `UidTextarea`, `UidNumberInput`, `UidCheckbox`, `UidRadio`, `UidRadioGroup`, `UidSwitch`, `UidLabel`, `UidFormField`, `UidSelect`, `UidCombobox`, `UidTagsInput`, `UidDatePicker`, `UidDateRangePicker`, `UidTimePicker`, `UidColorPicker`, `UidSlider`, `UidRating`, `UidFileUpload`, `UidMention`, `UidTreeSelect`
-
-### Обратная связь
+## What's inside
 
-`UidSpinner`, `UidSkeleton`, `UidBadge`, `UidAlert`, `UidProgress`, `UidToast`, `UidToastProvider`, `UidTour`
+A short selection — the full catalog is in [Storybook](https://dskripchenko.github.io/ui/).
 
-### Оверлеи
+**Forms & input:** Button, Input, Textarea, NumberInput, Checkbox, Radio, Switch, Label, FormField, Select, Combobox, TagsInput, DatePicker, DateRangePicker, TimePicker, ColorPicker, Slider, Rating, FileUpload, Mention, TreeSelect, Cascader
 
-`UidModal`, `UidDrawer`, `UidTooltip`, `UidPopover`, `UidMenu`, `UidMenuItem`, `UidCommand`
+**Feedback:** Spinner, Skeleton, Badge, Alert, Progress, Toast, Tour
 
-### Навигация
+**Overlays:** Modal, Drawer, Tooltip, Popover, Menu, Command
 
-`UidTabs`, `UidTab`, `UidTabPanel`, `UidBreadcrumb`, `UidLink`, `UidPagination`, `UidPaginationCursor`, `UidLoadMore`, `UidInfiniteScroll`, `UidPageSize`, `UidBackTop`, `UidAffix`, `UidAnchor`
+**Navigation:** Tabs, Breadcrumb, Link, Pagination (+ Cursor / LoadMore / InfiniteScroll / PageSize), BackTop, Affix, Anchor
 
-### Отображение данных
+**Data display:** Card, Avatar, AvatarGroup, Tag, Divider, Accordion, Table, VirtualList, Stat, DescriptionList, Timeline, TreeView, Code, Watermark, Carousel, Calendar, NotificationBadge
 
-`UidCard`, `UidAvatar`, `UidAvatarGroup`, `UidTag`, `UidDivider`, `UidAccordion`, `UidTable`, `UidVirtualList`, `UidStat`, `UidDescriptionList`, `UidDescriptionItem`, `UidTimeline`, `UidTimelineItem`, `UidTreeView`, `UidCode`, `UidWatermark`
+**Layout helpers:** Stack, Grid, Container, Splitter
 
-### Layout-помощники
+**Charts:** Sparkline, ProgressRing, Gauge, Heatmap
 
-`UidStack`, `UidGrid`, `UidContainer`, `UidSplitter`
+**Wizards:** Stepper, Wizard, WizardStep
 
-### Wizards
+**Patterns:** Header, Footer, Sidebar, PageHeader, EmptyState, ErrorState, Result
 
-`UidStepper`, `UidWizard`, `UidWizardStep`
+**Layouts:** SimpleLayout, SidebarLayout, AuthLayout, WizardLayout
 
-### Patterns
+**Composables:** useTheme, useLocale, useField, useToast, useWizard, useSidebar, useCommandPalette, useFocusTrap, useScrollLock, usePopover
 
-`UidHeader`, `UidFooter`, `UidSidebar`, `UidPageHeader`, `UidEmptyState`, `UidErrorState`, `UidResult`
+## Documentation
 
-### Layouts
+User docs are translated into four languages — pick yours:
 
-`UidSimpleLayout`, `UidSidebarLayout`, `UidAuthLayout`, `UidWizardLayout`
+- 🇬🇧 **English** (default): [getting-started](./docs/en/getting-started.md), [theming](./docs/en/theming.md), [tokens](./docs/en/tokens.md), [icons](./docs/en/icons.md), [patterns](./docs/en/patterns.md), [validation](./docs/en/validation.md), [charts](./docs/en/charts.md), [i18n](./docs/en/i18n.md)
+- 🇷🇺 **Русский**: [docs/ru/](./docs/ru/)
+- 🇩🇪 **Deutsch**: [docs/de/](./docs/de/)
+- 🇨🇳 **中文**: [docs/zh/](./docs/zh/)
 
-### Composables
+Contributor docs (English only): [Architecture](./docs/ARCHITECTURE.md), [Component guidelines](./docs/COMPONENT_GUIDELINES.md), [Contributing](./docs/CONTRIBUTING.md), [Roadmap](./docs/ROADMAP.md).
 
-`useTheme`, `useField`, `useToast`, `useWizard`, `useSidebar`, `useCommandPalette`, `useFocusTrap`, `useScrollLock`, `usePopover`
+## Theming
 
-Полный каталог с интерактивными примерами — в **[Storybook](https://dskripchenko.github.io/ui/)**.
-
-## Темизация
-
-Все цвета, отступы, шрифты — CSS-переменные. Переопределить тему — задать токены на `:root` или контейнере:
+Every colour, spacing, and font is a CSS variable. Override the theme by setting tokens on `:root` or on a container:
 
 ```css
 :root[data-theme='dark'] {
@@ -116,42 +115,31 @@ import { Check } from '@dskripchenko/ui/icons'
 }
 ```
 
-Подробнее — [`docs/THEMING.md`](./docs/THEMING.md) и [`docs/TOKENS.md`](./docs/TOKENS.md).
+See [theming](./docs/en/theming.md) and [tokens](./docs/en/tokens.md) for details.
 
-## Иконки
+## Icons
 
-Sub-export `@dskripchenko/ui/icons` реэкспортирует все ~1500 иконок Lucide:
+The `@dskripchenko/ui/icons` sub-export re-exports all ~1500 Lucide icons:
 
 ```ts
 import { UidIcon } from '@dskripchenko/ui'
 import { Heart, Star } from '@dskripchenko/ui/icons'
 ```
 
-Подробнее — [`docs/ICONS.md`](./docs/ICONS.md).
-
-## Документация
-
-- [Архитектура](./docs/ARCHITECTURE.md) — структура пакета, сборка, экспорт
-- [Дизайн-токены](./docs/TOKENS.md) — система CSS-переменных
-- [Темизация](./docs/THEMING.md) — light/dark и кастомизация
-- [Иконки](./docs/ICONS.md) — `UidIcon` и реестр Lucide
-- [Валидация форм](./docs/VALIDATION.md) — `useField`, правила
-- [Patterns и Layouts](./docs/PATTERNS.md) — составные блоки и шаблоны страниц
-- [Гайдлайны компонентов](./docs/COMPONENT_GUIDELINES.md) — конвенции
-- [Roadmap](./docs/ROADMAP.md) — план развития
-- [Контрибьютинг](./docs/CONTRIBUTING.md) — workflow
+See [icons](./docs/en/icons.md).
 
-## Разработка
+## Development
 
 ```bash
 pnpm install
-pnpm dev              # Storybook на :6006
-pnpm test             # Vitest
-pnpm build            # Сборка библиотеки
-pnpm build-storybook  # Сборка Storybook → storybook-static
-pnpm changeset        # Описать изменения для следующего релиза
+pnpm dev               # Storybook on :6006
+pnpm test              # Vitest
+pnpm build             # Library build
+pnpm build-storybook   # Storybook → storybook-static
+pnpm build:analyze     # Bundle visualizer
+pnpm changeset         # Describe a change for the next release
 ```
 
-## Лицензия
+## License
 
 MIT

package/README.ru.md

@@ -0,0 +1,143 @@
+# @dskripchenko/ui
+
+Набор Vue 3 компонентов, токенов и тем на CSS custom properties.
+
+[English](./README.md) · [**Русский**](./README.ru.md) · [Deutsch](./README.de.md) · [中文](./README.zh.md)
+
+[![npm](https://img.shields.io/npm/v/@dskripchenko/ui.svg)](https://www.npmjs.com/package/@dskripchenko/ui)
+[![bundle](https://img.shields.io/bundlephobia/minzip/@dskripchenko/ui)](https://bundlephobia.com/package/@dskripchenko/ui)
+[![license](https://img.shields.io/npm/l/@dskripchenko/ui.svg)](./LICENSE)
+
+> **Статус:** стабильно. Действуют гарантии SemVer — ломающие изменения только в major-версиях.
+
+📖 **Storybook:** [dskripchenko.github.io/ui](https://dskripchenko.github.io/ui/)
+
+## Особенности
+
+- **70+ компонентов** — формы, навигация, оверлеи, отображение данных, графики, паттерны, лейауты
+- **Vue 3 + TypeScript** — Composition API, `<script setup>`, полная типизация
+- **CSS custom properties** — никакого CSS-in-JS, Tailwind или препроцессоров; всё через переменные
+- **Light / Dark темы** — через `data-theme` на `:root`, легко переопределяются
+- **Tree-shakeable** — импорт по компонентам, ESM + CJS сборки
+- **A11y** — `:focus-visible`, ARIA-атрибуты, keyboard-навигация во всех интерактивных компонентах
+- **i18n** — встроенные `ru` + `en` локали, `UidLocaleProvider` для частичных переопределений и кастомных локалей
+- **~1500 иконок** — `lucide-vue-next` под капотом + sub-export `@dskripchenko/ui/icons`
+- **Zero runtime chart deps** — встроенные SVG-примитивы (Sparkline, ProgressRing, Gauge, Heatmap)
+
+## Установка
+
+```bash
+pnpm add @dskripchenko/ui
+# или
+npm install @dskripchenko/ui
+```
+
+## Быстрый старт
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import App from './App.vue'
+
+import '@dskripchenko/ui/styles/tokens.css'
+import '@dskripchenko/ui/styles/themes.css'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { UidButton, UidIcon } from '@dskripchenko/ui'
+import { Check } from '@dskripchenko/ui/icons'
+</script>
+
+<template>
+  <UidButton variant="primary">
+    <UidIcon :icon="Check" /> Сохранить
+  </UidButton>
+</template>
+```
+
+Переключение темы — атрибут на `<html>`:
+
+```html
+<html data-theme="dark">
+```
+
+## Что внутри
+
+Краткий список — полный каталог в [Storybook](https://dskripchenko.github.io/ui/).
+
+**Формы и ввод:** Button, Input, Textarea, NumberInput, Checkbox, Radio, Switch, Label, FormField, Select, Combobox, TagsInput, DatePicker, DateRangePicker, TimePicker, ColorPicker, Slider, Rating, FileUpload, Mention, TreeSelect, Cascader
+
+**Обратная связь:** Spinner, Skeleton, Badge, Alert, Progress, Toast, Tour
+
+**Оверлеи:** Modal, Drawer, Tooltip, Popover, Menu, Command
+
+**Навигация:** Tabs, Breadcrumb, Link, Pagination (+ Cursor / LoadMore / InfiniteScroll / PageSize), BackTop, Affix, Anchor
+
+**Отображение данных:** Card, Avatar, AvatarGroup, Tag, Divider, Accordion, Table, VirtualList, Stat, DescriptionList, Timeline, TreeView, Code, Watermark, Carousel, Calendar, NotificationBadge
+
+**Layout-помощники:** Stack, Grid, Container, Splitter
+
+**Графики:** Sparkline, ProgressRing, Gauge, Heatmap
+
+**Wizards:** Stepper, Wizard, WizardStep
+
+**Patterns:** Header, Footer, Sidebar, PageHeader, EmptyState, ErrorState, Result
+
+**Layouts:** SimpleLayout, SidebarLayout, AuthLayout, WizardLayout
+
+**Composables:** useTheme, useLocale, useField, useToast, useWizard, useSidebar, useCommandPalette, useFocusTrap, useScrollLock, usePopover
+
+## Документация
+
+Пользовательская документация переведена на 4 языка — выбери свой:
+
+- 🇬🇧 **English** (default): [docs/en/](./docs/en/)
+- 🇷🇺 **Русский**: [getting-started](./docs/ru/getting-started.md), [тема](./docs/ru/theming.md), [токены](./docs/ru/tokens.md), [иконки](./docs/ru/icons.md), [патерны](./docs/ru/patterns.md), [валидация](./docs/ru/validation.md), [графики](./docs/ru/charts.md), [i18n](./docs/ru/i18n.md)
+- 🇩🇪 **Deutsch**: [docs/de/](./docs/de/)
+- 🇨🇳 **中文**: [docs/zh/](./docs/zh/)
+
+Документация для контрибьюторов (только английская): [Architecture](./docs/ARCHITECTURE.md), [Component guidelines](./docs/COMPONENT_GUIDELINES.md), [Contributing](./docs/CONTRIBUTING.md), [Roadmap](./docs/ROADMAP.md).
+
+## Темизация
+
+Все цвета, отступы, шрифты — CSS-переменные. Переопределить тему — задать токены на `:root` или контейнере:
+
+```css
+:root[data-theme='dark'] {
+  --uid-color-primary: #8b5cf6;
+  --uid-color-bg: #0a0a0a;
+}
+```
+
+Подробнее — [темизация](./docs/ru/theming.md) и [токены](./docs/ru/tokens.md).
+
+## Иконки
+
+Sub-export `@dskripchenko/ui/icons` реэкспортирует все ~1500 иконок Lucide:
+
+```ts
+import { UidIcon } from '@dskripchenko/ui'
+import { Heart, Star } from '@dskripchenko/ui/icons'
+```
+
+Подробнее — [иконки](./docs/ru/icons.md).
+
+## Разработка
+
+```bash
+pnpm install
+pnpm dev               # Storybook на :6006
+pnpm test              # Vitest
+pnpm build             # Сборка библиотеки
+pnpm build-storybook   # Сборка Storybook → storybook-static
+pnpm build:analyze     # Bundle visualizer
+pnpm changeset         # Описать изменения для следующего релиза
+```
+
+## Лицензия
+
+MIT

package/README.zh.md

@@ -0,0 +1,145 @@
+# @dskripchenko/ui
+
+基于 CSS Custom Properties 的 Vue 3 组件、token 与主题库。
+
+[English](./README.md) · [Русский](./README.ru.md) · [Deutsch](./README.de.md) · [**中文**](./README.zh.md)
+
+[![npm](https://img.shields.io/npm/v/@dskripchenko/ui.svg)](https://www.npmjs.com/package/@dskripchenko/ui)
+[![bundle](https://img.shields.io/bundlephobia/minzip/@dskripchenko/ui)](https://bundlephobia.com/package/@dskripchenko/ui)
+[![license](https://img.shields.io/npm/l/@dskripchenko/ui.svg)](./LICENSE)
+
+> **状态：** 稳定。遵循 SemVer 保障——破坏性变更仅在主版本中发布。
+
+📖 **Storybook：**[dskripchenko.github.io/ui](https://dskripchenko.github.io/ui/)
+
+## 亮点
+
+- **70+ 组件** — 表单、导航、浮层、数据展示、图表、Patterns、Layouts
+- **Vue 3 + TypeScript** — Composition API、`<script setup>`、完整类型
+- **CSS 自定义属性** — 不用 CSS-in-JS、Tailwind 或预处理器；一切都是变量
+- **Light / Dark 主题** — 通过 `:root` 上的 `data-theme` 切换，便于覆盖
+- **可 tree-shake** — 按组件导入，ESM + CJS 构建
+- **无障碍** — `:focus-visible`、ARIA 属性、所有交互组件支持键盘
+- **i18n** — 内置 `ru` + `en` locale，`UidLocaleProvider` 支持部分覆盖与自定义 locale
+- **~1500 图标** — 底层使用 `lucide-vue-next` + 子导出 `@dskripchenko/ui/icons`
+- **零图表运行时依赖** — 内置 SVG 原语(Sparkline、ProgressRing、Gauge、Heatmap)
+
+## 安装
+
+```bash
+pnpm add @dskripchenko/ui
+# 或
+npm install @dskripchenko/ui
+```
+
+## 快速开始
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import App from './App.vue'
+
+import '@dskripchenko/ui/styles/tokens.css'
+import '@dskripchenko/ui/styles/themes.css'
+
+createApp(App).mount('#app')
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { UidButton, UidIcon, UidLocaleProvider, en } from '@dskripchenko/ui'
+import { Check } from '@dskripchenko/ui/icons'
+</script>
+
+<template>
+  <UidLocaleProvider :locale="en">
+    <UidButton variant="primary">
+      <UidIcon :icon="Check" /> 保存
+    </UidButton>
+  </UidLocaleProvider>
+</template>
+```
+
+通过 `<html>` 上的属性切换主题：
+
+```html
+<html data-theme="dark">
+```
+
+## 内容速览
+
+精简列表 — 完整目录在 [Storybook](https://dskripchenko.github.io/ui/)。
+
+**表单与输入：** Button、Input、Textarea、NumberInput、Checkbox、Radio、Switch、Label、FormField、Select、Combobox、TagsInput、DatePicker、DateRangePicker、TimePicker、ColorPicker、Slider、Rating、FileUpload、Mention、TreeSelect、Cascader
+
+**反馈：** Spinner、Skeleton、Badge、Alert、Progress、Toast、Tour
+
+**浮层：** Modal、Drawer、Tooltip、Popover、Menu、Command
+
+**导航：** Tabs、Breadcrumb、Link、Pagination(+ Cursor / LoadMore / InfiniteScroll / PageSize)、BackTop、Affix、Anchor
+
+**数据展示：** Card、Avatar、AvatarGroup、Tag、Divider、Accordion、Table、VirtualList、Stat、DescriptionList、Timeline、TreeView、Code、Watermark、Carousel、Calendar、NotificationBadge
+
+**布局辅助：** Stack、Grid、Container、Splitter
+
+**图表：** Sparkline、ProgressRing、Gauge、Heatmap
+
+**Wizards：** Stepper、Wizard、WizardStep
+
+**Patterns：** Header、Footer、Sidebar、PageHeader、EmptyState、ErrorState、Result
+
+**Layouts：** SimpleLayout、SidebarLayout、AuthLayout、WizardLayout
+
+**Composables：** useTheme、useLocale、useField、useToast、useWizard、useSidebar、useCommandPalette、useFocusTrap、useScrollLock、usePopover
+
+## 文档
+
+用户文档已译为四种语言 — 选择你的：
+
+- 🇬🇧 **English**(default)：[docs/en/](./docs/en/)
+- 🇷🇺 **Русский**：[docs/ru/](./docs/ru/)
+- 🇩🇪 **Deutsch**：[docs/de/](./docs/de/)
+- 🇨🇳 **中文**：[快速开始](./docs/zh/getting-started.md)、[主题](./docs/zh/theming.md)、[Tokens](./docs/zh/tokens.md)、[图标](./docs/zh/icons.md)、[Patterns](./docs/zh/patterns.md)、[表单校验](./docs/zh/validation.md)、[图表](./docs/zh/charts.md)、[i18n](./docs/zh/i18n.md)
+
+贡献者文档(仅英文)：[Architecture](./docs/ARCHITECTURE.md)、[Component guidelines](./docs/COMPONENT_GUIDELINES.md)、[Contributing](./docs/CONTRIBUTING.md)、[Roadmap](./docs/ROADMAP.md)。
+
+## 主题
+
+所有颜色、间距、字体都是 CSS 变量。覆盖主题——在 `:root` 或容器上设置 token：
+
+```css
+:root[data-theme='dark'] {
+  --uid-color-primary: #8b5cf6;
+  --uid-color-bg: #0a0a0a;
+}
+```
+
+详见 [主题](./docs/zh/theming.md) 与 [Tokens](./docs/zh/tokens.md)。
+
+## 图标
+
+子导出 `@dskripchenko/ui/icons` re-export 了全部 ~1500 个 Lucide 图标：
+
+```ts
+import { UidIcon } from '@dskripchenko/ui'
+import { Heart, Star } from '@dskripchenko/ui/icons'
+```
+
+详见 [图标](./docs/zh/icons.md)。
+
+## 开发
+
+```bash
+pnpm install
+pnpm dev               # Storybook，端口 6006
+pnpm test              # Vitest
+pnpm build             # 库构建
+pnpm build-storybook   # Storybook → storybook-static
+pnpm build:analyze     # Bundle visualizer
+pnpm changeset         # 描述下一次发布的变更
+```
+
+## 许可证
+
+MIT