@pgcorp/ui-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PGCorp
+
+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.md

@@ -0,0 +1,157 @@
+# @pgcorp/ui-kit
+
+[![npm version](https://img.shields.io/npm/v/%40pgcorp%2Fui-kit)](https://www.npmjs.com/package/@pgcorp/ui-kit)
+[![npm downloads](https://img.shields.io/npm/dm/%40pgcorp%2Fui-kit)](https://www.npmjs.com/package/@pgcorp/ui-kit)
+[![Vue 3](https://img.shields.io/badge/Vue-3.5%2B-42b883)](https://vuejs.org/)
+[![License](https://img.shields.io/npm/l/%40pgcorp%2Fui-kit)](./LICENSE)
+
+Production design system PGCorp для Vue 3: типизированные компоненты, layout-примитивы,
+design tokens, темы, accessibility-контракты и готовые сложные интерфейсные паттерны.
+
+PGCorp production design system for Vue 3: typed components, layout primitives,
+design tokens, themes, accessibility contracts, and reusable complex UI patterns.
+
+## Возможности / Features
+
+- 118 точных package exports без wildcard и private imports.
+- Vue Single-File Components с TypeScript-контрактами.
+- Светлые и тёмные темы на semantic CSS tokens.
+- Controls, navigation, data display, overlays, workbench layouts, editors and graphs.
+- Keyboard, focus, ARIA, disabled, loading and error states.
+- Проверяемые unit, Storybook, browser, accessibility и visual contracts.
+
+---
+
+- 118 exact package exports without wildcards or private imports.
+- Vue Single-File Components with TypeScript contracts.
+- Light and dark themes built on semantic CSS tokens.
+- Controls, navigation, data display, overlays, workbench layouts, editors, and graphs.
+- Keyboard, focus, ARIA, disabled, loading, and error states.
+- Executable unit, Storybook, browser, accessibility, and visual contracts.
+
+## Установка / Installation
+
+```bash
+npm install @pgcorp/ui-kit vue pinia vue-router
+```
+
+Требования:
+
+- Node.js `>=20.19`;
+- npm `>=11.10 <12`;
+- Vue `^3.5`;
+- Pinia `^3.0`;
+- Vue Router `^5.0`;
+- Vite-based Vue application.
+
+Requirements:
+
+- Node.js `>=20.19`;
+- npm `>=11.10 <12`;
+- Vue `^3.5`;
+- Pinia `^3.0`;
+- Vue Router `^5.0`;
+- a Vite-based Vue application.
+
+## Быстрый старт / Quick start
+
+Подключите базовые стили один раз в entrypoint приложения:
+
+Import the base stylesheet once in the application entrypoint:
+
+```ts
+import { createApp } from 'vue'
+import '@pgcorp/ui-kit/style.css'
+
+import App from './App.vue'
+
+createApp(App).mount('#app')
+```
+
+Импортируйте компоненты только через документированные subpaths:
+
+Import components only through documented subpaths:
+
+```vue
+<script setup lang="ts">
+import SButton from '@pgcorp/ui-kit/shared/controls/SButton.vue'
+import SPanel from '@pgcorp/ui-kit/shared/containers/SPanel.vue'
+</script>
+
+<template>
+  <SPanel>
+    <template #header>Профиль</template>
+    <SButton variant="primary">Сохранить</SButton>
+  </SPanel>
+</template>
+```
+
+## Стили и темы / Styling and themes
+
+`style.css` подключает semantic tokens и базовый визуальный контракт. Для token-only
+интеграции доступен отдельный export:
+
+`style.css` provides semantic tokens and the base visual contract. A token-only
+integration is available as a separate export:
+
+```ts
+import '@pgcorp/ui-kit/tokens.css'
+```
+
+Компоненты используют semantic tokens. Consumer не переоформляет внутренний DOM
+компонентов через deep selectors; варианты задаются публичными props, slots и tokens.
+
+Components consume semantic tokens. Consumers do not restyle component internals
+through deep selectors; variants are expressed through public props, slots, and tokens.
+
+Подробнее: [темы и tokens](./docs/theming.md).
+
+Learn more: [themes and tokens](./docs/theming.md).
+
+## Публичный API / Public API
+
+Корневой export содержит theme, variants и icon registry:
+
+The root export contains theme, variants, and the icon registry:
+
+```ts
+import { applyThemeIdToDocument, uiVariantClasses } from '@pgcorp/ui-kit'
+```
+
+Компоненты и модули импортируются через exact subpaths из `package.json#exports`.
+Wildcard imports и доступ к внутренним путям пакета не поддерживаются.
+
+Components and modules are imported through exact subpaths declared in
+`package.json#exports`. Wildcard imports and package-internal paths are unsupported.
+
+Полный маршрут по API: [Public API](./docs/public-api.md).
+
+Complete API guide: [Public API](./docs/public-api.md).
+
+## Документация / Documentation
+
+- [Начало работы / Getting started](./docs/getting-started.md)
+- [Public API](./docs/public-api.md)
+- [Темы и design tokens / Themes and design tokens](./docs/theming.md)
+- [Accessibility](./docs/accessibility.md)
+- [Версии и релизы / Versioning and releases](./docs/versioning.md)
+- [Лицензирование и Enterprise / Licensing and Enterprise](./docs/licensing.md)
+- [Безопасность / Security](./docs/security.md)
+
+## Поддержка / Support
+
+Ошибки и запросы на изменение принимаются по адресу
+[remand-gambol4g@icloud.com](mailto:remand-gambol4g@icloud.com).
+Security reports отправляются по процессу из [Security](./docs/security.md).
+
+Bugs and change requests are accepted at
+[remand-gambol4g@icloud.com](mailto:remand-gambol4g@icloud.com).
+Security reports follow the process documented in [Security](./docs/security.md).
+
+## Лицензия / License
+
+`@pgcorp/ui-kit` распространяется по лицензии MIT. Copyright и текст лицензии
+должны сохраняться в копиях и существенных частях пакета. См. [LICENSE](./LICENSE).
+
+`@pgcorp/ui-kit` is distributed under the MIT License. The copyright and license
+notice must be retained in copies and substantial portions. See [LICENSE](./LICENSE).

package/docs/accessibility.md

@@ -0,0 +1,27 @@
+# Accessibility
+
+## Русский
+
+Интерактивная семантика принадлежит leaf-компонентам UI-kit. Они отвечают за:
+
+- keyboard navigation и ожидаемые клавиши;
+- видимый focus и focus restoration;
+- accessible name, roles и ARIA state;
+- disabled, loading, invalid и error states;
+- hitbox и поведение на узком viewport.
+
+Consumer обязан передавать человекочитаемые labels и не заменять семантику
+компонента локальными DOM listeners или CSS.
+
+## English
+
+Interactive semantics belong to UI-kit leaf components. They own:
+
+- keyboard navigation and expected keys;
+- visible focus and focus restoration;
+- accessible names, roles, and ARIA state;
+- disabled, loading, invalid, and error states;
+- hitboxes and narrow-viewport behavior.
+
+Consumers must provide human-readable labels and must not replace component
+semantics with local DOM listeners or CSS.

package/docs/getting-started.md

@@ -0,0 +1,80 @@
+# Начало работы / Getting started
+
+## Русский
+
+### Установка
+
+```bash
+npm install @pgcorp/ui-kit vue pinia vue-router
+```
+
+UI-kit поставляется как Vue 3 SFC/TypeScript package для Vite-based приложений.
+Consumer отвечает за единственные экземпляры `vue`, `pinia` и `vue-router`.
+
+### Подключение
+
+```ts
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import router from './router'
+import '@pgcorp/ui-kit/style.css'
+
+import App from './App.vue'
+
+createApp(App).use(createPinia()).use(router).mount('#app')
+```
+
+Каждый компонент импортируется через точный публичный subpath:
+
+```ts
+import SButton from '@pgcorp/ui-kit/shared/controls/SButton.vue'
+import SModal from '@pgcorp/ui-kit/shared/containers/SModal.vue'
+```
+
+Не используйте пути `@pgcorp/ui-kit/src/*`: они не являются public API.
+
+### Проверка интеграции
+
+Production build consumer-приложения должен выполняться без alias на исходный
+monorepo и без копирования файлов UI-kit. TypeScript и Vue language tools должны
+разрешать типы непосредственно из package exports.
+
+## English
+
+### Installation
+
+```bash
+npm install @pgcorp/ui-kit vue pinia vue-router
+```
+
+The UI kit is distributed as a Vue 3 SFC/TypeScript package for Vite-based
+applications. The consumer owns the single `vue`, `pinia`, and `vue-router`
+instances.
+
+### Setup
+
+```ts
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import router from './router'
+import '@pgcorp/ui-kit/style.css'
+
+import App from './App.vue'
+
+createApp(App).use(createPinia()).use(router).mount('#app')
+```
+
+Import every component through an exact public subpath:
+
+```ts
+import SButton from '@pgcorp/ui-kit/shared/controls/SButton.vue'
+import SModal from '@pgcorp/ui-kit/shared/containers/SModal.vue'
+```
+
+Do not use `@pgcorp/ui-kit/src/*`; internal paths are not public API.
+
+### Integration verification
+
+The consumer production build must succeed without a monorepo source alias or
+copied UI-kit files. TypeScript and Vue language tools must resolve types directly
+from package exports.

package/docs/licensing.md

@@ -0,0 +1,30 @@
+# Лицензирование и Enterprise / Licensing and Enterprise
+
+## Русский
+
+`@pgcorp/ui-kit` распространяется по лицензии MIT. Каждая опубликованная версия
+сохраняет условия MIT бессрочно: полученные пользователями права не отзываются
+последующим релизом или изменением коммерческой модели.
+
+Enterprise-возможности могут распространяться отдельным закрытым пакетом,
+приложением или сервисом по коммерческой лицензии. Такой продукт может зависеть
+от `@pgcorp/ui-kit`, но не изменяет лицензию уже опубликованной открытой базы.
+Copyright notice и текст MIT сохраняются во всех копиях и существенных частях
+MIT-компонентов.
+
+Название PGCorp и связанные товарные знаки не лицензируются условиями MIT.
+
+## English
+
+`@pgcorp/ui-kit` is distributed under the MIT License. Every published version
+remains available under its original MIT terms indefinitely: rights already
+granted to recipients are not revoked by a later release or business-model
+change.
+
+Enterprise capabilities may be distributed as a separate private package,
+application, or service under a commercial license. Such a product may depend
+on `@pgcorp/ui-kit`, but it does not change the license of the published
+open-source base. The copyright notice and MIT text must remain in all copies
+or substantial portions of MIT components.
+
+The PGCorp name and related trademarks are not licensed by the MIT License.

package/docs/public-api.md

@@ -0,0 +1,39 @@
+# Публичный API / Public API
+
+## Русский
+
+`package.json#exports` является машинно-читаемым источником истины. Каждый export
+явный; wildcard отсутствуют.
+
+Основные группы:
+
+- `layout/*` — каркас приложения, dock regions, stack и workbench layouts;
+- `shared/controls/*` — buttons, fields, inputs, selects, menus и selection controls;
+- `shared/containers/*` — panels, modal, drawer, popover и sidebars;
+- `shared/data-display/*` — badges, tables, code, JSON, progress, status и tooltips;
+- `shared/navigation/*` — tabs, breadcrumbs, catalog navigation и wizard steps;
+- `shared/database/*`, `shared/graph/*`, `shared/persona/*` — доменные сложные поверхности;
+- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules;
+- `style.css`, `tokens.css`, `reference.css` — документированные style entrypoints.
+
+Компонентный contract выражается через typed props, slots, events и exposed
+methods. Внутренний DOM, CSS-классы и private modules не являются API.
+
+## English
+
+`package.json#exports` is the machine-readable source of truth. Every export is
+explicit and no wildcard exports are provided.
+
+Primary groups:
+
+- `layout/*` — application shells, dock regions, stacks, and workbench layouts;
+- `shared/controls/*` — buttons, fields, inputs, selects, menus, and selection controls;
+- `shared/containers/*` — panels, modal, drawer, popover, and sidebars;
+- `shared/data-display/*` — badges, tables, code, JSON, progress, status, and tooltips;
+- `shared/navigation/*` — tabs, breadcrumbs, catalog navigation, and wizard steps;
+- `shared/database/*`, `shared/graph/*`, `shared/persona/*` — complex domain surfaces;
+- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules;
+- `style.css`, `tokens.css`, `reference.css` — documented style entrypoints.
+
+Component contracts are expressed through typed props, slots, events, and exposed
+methods. Internal DOM, CSS classes, and private modules are not API.

package/docs/security.md

@@ -0,0 +1,21 @@
+# Безопасность / Security
+
+## Русский
+
+Не публикуйте сведения об уязвимости в public issue до согласования исправления.
+Отправьте private security report на
+[remand-gambol4g@icloud.com](mailto:remand-gambol4g@icloud.com) с темой
+`[SECURITY] @pgcorp/ui-kit`.
+
+Укажите версию пакета, затронутый component/subpath, воспроизводимый сценарий,
+impact и известные ограничения.
+
+## English
+
+Do not disclose a vulnerability in a public issue before a fix is coordinated.
+Send a private security report to
+[remand-gambol4g@icloud.com](mailto:remand-gambol4g@icloud.com) with the subject
+`[SECURITY] @pgcorp/ui-kit`.
+
+Include the package version, affected component/subpath, reproducible scenario,
+impact, and known constraints.

package/docs/theming.md

@@ -0,0 +1,35 @@
+# Темы и design tokens / Themes and design tokens
+
+## Русский
+
+`tokens.css` содержит primitive и semantic tokens. `style.css` подключает tokens,
+color-scheme, typography, field surfaces, focus contracts и общие utilities.
+
+Поддерживаемые theme identifiers и runtime API экспортируются из `theme`:
+
+```ts
+import { applyThemeIdToDocument } from '@pgcorp/ui-kit/theme'
+
+applyThemeIdToDocument(document, 'classic-light')
+```
+
+Переопределяйте только документированные CSS custom properties на корневом
+theme-контейнере. Не стилизуйте внутренний DOM компонентов через `:deep`,
+private selectors или зависимость от структуры template.
+
+## English
+
+`tokens.css` contains primitive and semantic tokens. `style.css` includes tokens,
+color scheme, typography, field surfaces, focus contracts, and shared utilities.
+
+Supported theme identifiers and runtime APIs are exported from `theme`:
+
+```ts
+import { applyThemeIdToDocument } from '@pgcorp/ui-kit/theme'
+
+applyThemeIdToDocument(document, 'classic-light')
+```
+
+Override documented CSS custom properties on the root theme container only. Do
+not style component internals through `:deep`, private selectors, or template
+structure dependencies.

package/docs/versioning.md

@@ -0,0 +1,23 @@
+# Версии и релизы / Versioning and releases
+
+## Русский
+
+Пакет использует Semantic Versioning:
+
+- patch — исправление без изменения документированного контракта;
+- minor — обратно совместимое расширение public API;
+- major — несовместимое изменение exports, props, events, tokens или поведения.
+
+Официальный release публикуется из защищённого git tag после package contract,
+consumer builds и browser proof. Один и тот же номер версии не публикуется повторно.
+
+## English
+
+The package follows Semantic Versioning:
+
+- patch — a fix that preserves the documented contract;
+- minor — a backward-compatible public API extension;
+- major — an incompatible change to exports, props, events, tokens, or behavior.
+
+An official release is published from a protected git tag after package-contract,
+consumer-build, and browser-proof checks. A version number is never republished.

package/index.ts

@@ -0,0 +1,3 @@
+export * from './src/theme';
+export * from './src/variants';
+export * from './src/components/icons/sputnigUiIcons';