@dskripchenko/laravel-admin 1.1.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.md

@@ -0,0 +1,226 @@
+# dskripchenko/laravel-admin
+
+Конструктор админок для Laravel: Resource-first CRUD, Vue 3 SPA, JSON-API транспорт. Подключается в любой существующий Laravel-проект без вмешательства в его routes/auth.
+
+> **Статус:** in development. Архитектура зафиксирована, идёт реализация. См. `docs/ARCHITECTURE.md`.
+
+## Tldr
+
+```php
+class UserResource extends Resource
+{
+    public static string $model = \App\Models\User::class;
+    public static string $icon  = 'user';
+
+    public function fields(): array
+    {
+        return [
+            Field\Input::make('name')->required(),
+            Field\Input::make('email')->type('email')->required()->unique(),
+            Field\Switch::make('is_active'),
+        ];
+    }
+
+    public function columns(): array
+    {
+        return [
+            TC::make('id')->sort(),
+            TC::make('name')->sort()->search(),
+            TC::make('email')->copyable(),
+            TC::make('is_active')->as('badge'),
+        ];
+    }
+}
+```
+
+```php
+// AppServiceProvider
+Admin::resources([UserResource::class]);
+```
+
+Готово: SPA с list/create/edit/view/audit/permissions.
+
+## Требования
+
+- PHP `^8.5`
+- Laravel `^12`
+- Redis или Memcached (для tag-aware кэша переводов; иначе soft-fallback)
+- Vue 3.4+, TypeScript, Vite (для frontend-сборки)
+
+## Установка
+
+```bash
+composer require dskripchenko/laravel-admin
+php artisan admin:install
+php artisan migrate
+php artisan admin:user "Admin" admin@example.com secret
+npm install
+npm run admin:build
+```
+
+После этого админка доступна на `/admin`.
+
+## Frontend SPA (`@dskripchenko/laravel-admin` npm-пакет)
+
+Для host-проектов которые хотят встроить SPA в свой Vite-bundle вместо Blade-shell'а либо построить кастомный admin-фронт поверх готовых блоков.
+
+### Установка
+
+```bash
+npm install @dskripchenko/laravel-admin @dskripchenko/ui vue@^3.4 vue-router@^4.3 pinia axios
+```
+
+### Минимальный entry
+
+```ts
+// resources/admin-spa/main.ts
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+
+// (1) UI-кит: токены + темы + reset + global + Uid*-стили
+import '@dskripchenko/ui/styles/all.css'
+// (2) admin-каркас (impersonation banner, polling-dot, page utilities)
+import '@dskripchenko/laravel-admin/style.css'
+
+import {
+  createAdminClient,
+  setAdminClient,
+  loadBootstrap,
+  createAdminRouter,
+  registerBuiltinComponents,
+  registerBuiltinInfolistEntries,
+  registerBuiltinWidgets,
+  AdminShell,
+  ResourceIndexPage,
+  ResourceFormPage,
+  ResourceViewPage,
+  DashboardPage,
+} from '@dskripchenko/laravel-admin'
+
+// 1. HTTP-клиент с envelope/CSRF/error handling
+const client = createAdminClient({
+  baseURL: '/api/admin',
+  onUnauthenticated: () => router.push({ name: 'admin.login' }),
+})
+setAdminClient(client)
+
+// 2. Bootstrap (inline через <script> либо xhr через /system/bootstrap)
+const bootstrap = await loadBootstrap({ client })
+
+// 3. Pinia + hydrate stores
+const pinia = createPinia()
+const app = createApp(AdminShell)
+app.use(pinia)
+
+// 4. Регистрация builtin-компонентов в JSON-renderer'ы
+registerBuiltinComponents()        // Field/Layout (text/textarea/number/select/...)
+registerBuiltinInfolistEntries()   // Read-only display (text/badge/icon/keyvalue)
+registerBuiltinWidgets()           // Dashboard widgets (stat/charts/heatmap/gauge)
+
+// 5. Router с динамическими роутами из manifest'а
+const router = createAdminRouter({
+  base: '/admin',
+  components: {
+    login: () => import('./pages/Login.vue'),
+    home: () => import('./pages/Home.vue'),
+    forbidden: () => import('./pages/403.vue'),
+    notFound: () => import('./pages/404.vue'),
+    resourceIndex: ResourceIndexPage,
+    resourceCreate: ResourceFormPage,
+    resourceEdit: ResourceFormPage,
+    screen: () => import('./pages/Screen.vue'),
+    settings: () => import('./pages/Settings.vue'),
+    dashboard: DashboardPage,
+  },
+})
+app.use(router)
+app.mount('#admin')
+```
+
+### Готовые компоненты-страницы
+
+- `LoginPage` + `LoginForm` + `TwoFactorForm` — auth + TOTP/recovery
+- `ResourceIndexPage` — список с filter-bar / bulk toolbar / pagination
+- `ResourceFormPage` — create/edit unified с sticky save-bar
+- `ResourceViewPage` — read-only display через Infolist
+- `DashboardPage` — 12-col widget grid
+- `ProfilePage` — sidebar nav + cards
+- `ImportWizardPage` — 4-step wizard
+- `NotificationsDrawer` — UidDrawer right с tabs
+- `FieldGalleryPage` — каталог field-типов (docs/playground)
+
+### Расширение через registry
+
+```ts
+import { registerField, registerWidget, registerInfolistEntry } from '@dskripchenko/laravel-admin'
+import MyCustomField from './fields/MyCustomField.vue'
+
+registerField('my-custom', MyCustomField)
+// теперь manifest узел { type: 'my-custom', name: 'x', ... } рендерится через MyCustomField
+```
+
+### Шрифты (опционально)
+
+UID design system предполагает Inter Variable + Inter Display. Library не bundle'ит шрифты в style.css (Vite lib-mode инлайнит base64 → 1.4 MB). Варианты:
+
+- `npm i @fontsource-variable/inter @fontsource/inter-display` + `import` (рекомендуется)
+- Google Fonts CDN
+- Self-hosted — копировать `node_modules/@dskripchenko/laravel-admin/resources/fonts/*.woff2` в `public/fonts/` + подключить `fonts.css`
+
+### Скрипты разработки
+
+```bash
+npm run lint        # eslint flat config + vue-eslint-parser
+npm run typecheck   # vue-tsc --noEmit
+npm test            # vitest (jsdom)
+npm run build       # vite build + vue-tsc --emitDeclarationOnly
+npm run build:analyze  # с rollup-plugin-visualizer → dist/stats.html
+npm run size        # size-limit budgets (ESM/CJS gzipped + CSS)
+npm run preflight   # lint + typecheck + test + build (CI gate)
+```
+
+## Документация
+
+- [ARCHITECTURE.md](docs/ARCHITECTURE.md) — архитектура и решения.
+- [docs/sister-packs/](docs/sister-packs/) — спецификации опциональных расширений.
+- [docs/design_handoff_laravel_admin/](docs/design_handoff_laravel_admin/) — UID design handoff (эталон вёрстки SPA).
+
+## Sister-packs
+
+| Пакет | Назначение |
+|---|---|
+| `dskripchenko/laravel-admin-starter` | Готовые системные Resource'ы |
+| `dskripchenko/laravel-admin-tinymce` / `*-quill` | Альтернативные WYSIWYG |
+| `dskripchenko/laravel-admin-search` | Глобальный поиск |
+| `dskripchenko/laravel-admin-media` | Медиа-библиотека |
+| `dskripchenko/laravel-admin-health` | Health-checks |
+| `dskripchenko/laravel-admin-pulse` | Лёгкая телеметрия |
+| `dskripchenko/laravel-admin-jobs` | Failed jobs viewer |
+
+## Структура репозитория (dev)
+
+На время разработки до первого релиза проект ведётся как **монорепо**:
+
+```
+laravel-admin/
+├── src/                      # основной пакет dskripchenko/laravel-admin
+├── resources/ts/             # SPA-бандл @dskripchenko/laravel-admin
+├── packages/                 # sister-packs, локально
+│   ├── starter/
+│   ├── tinymce/
+│   ├── quill/
+│   ├── search/
+│   ├── media/
+│   ├── health/
+│   ├── pulse/
+│   └── jobs/
+└── docs/
+```
+
+- Composer: корневой `composer.json` содержит `repositories: [{ type: path, url: packages/* }]` — sister-packs резолвятся локально через симлинки. Это позволяет менять core и sister-packs одновременно без публикации dev-версий.
+- NPM: workspaces для `packages/tinymce` и `packages/quill` (только им нужны npm-зависимости). `npm install` из корня устанавливает зависимости всем сразу.
+- **Перед первым стабильным релизом** sister-packs выносятся в отдельные репозитории на github.com/dskripchenko и публикуются на packagist/npm независимо. На этот момент `repositories` в корневом `composer.json` удаляются, sister-packs ставятся обычным `composer require`.
+
+## License
+
+MIT. См. [LICENSE](LICENSE).

package/dist/api/bootstrap.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Загрузка bootstrap-payload'а в SPA.
+ *
+ * Поддерживает обе стратегии:
+ *   - 'inline' — читает window.__ADMIN_BOOTSTRAP__ (инжект через
+ *     shell.blade при strategy=inline).
+ *   - 'xhr' — fetch'ит /api/admin/system/bootstrap.
+ *
+ * Если оба способа не дали результата — throw'ит. SPA должна это поймать
+ * и показать full-screen error.
+ */
+import type { AdminBootstrap } from '../types/bootstrap';
+import type { AdminClient } from './client';
+export interface LoadBootstrapOptions {
+    /** Если задан client — fallback на xhr через него. */
+    client?: AdminClient;
+    /** Override URL для xhr. Default: '/system/bootstrap'. */
+    xhrUrl?: string;
+}
+/**
+ * Возвращает bootstrap или null если не загрузился.
+ *
+ * Порядок:
+ *   1. window.__ADMIN_BOOTSTRAP__ (inline-strategy).
+ *   2. xhr fetch если передан client.
+ *   3. null — caller решает что делать (показать error-screen).
+ */
+export declare function loadBootstrap(opts?: LoadBootstrapOptions): Promise<AdminBootstrap | null>;
+/**
+ * Прочитать bootstrap из window — только в браузерном контексте.
+ */
+export declare function readInlineBootstrap(): AdminBootstrap | null;
+/**
+ * Прочитать CSRF-token из meta-tag (Blade-injection через `csrf_token()`).
+ *
+ * Используется как fallback если bootstrap.csrf отсутствует.
+ */
+export declare function readCsrfFromMeta(): string | null;

package/dist/api/bootstrap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api/client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Axios-клиент для admin API.
+ *
+ * Особенности:
+ *   - baseURL берётся из bootstrap.apiUrl (либо передаётся явно).
+ *   - X-XSRF-TOKEN добавляется автоматически из cookie (Laravel Sanctum/web).
+ *   - X-CSRF-TOKEN — fallback из meta[name=csrf-token] (Blade-injection).
+ *   - X-Admin-Locale выставляется при наличии текущей локали.
+ *   - Response interceptor разворачивает envelope и бросает ApiError.
+ *   - 401 → onUnauthenticated callback (редирект на login на стороне consumer'а).
+ */
+import { type AxiosInstance, type AxiosRequestConfig } from 'axios';
+export interface ClientOptions {
+    baseURL: string;
+    csrfToken?: string;
+    locale?: string;
+    /** Вызывается при 401. Обычно — push на /admin/login. */
+    onUnauthenticated?: () => void;
+}
+export interface AdminClient {
+    /** Низкоуровневый axios — для специфичных случаев. */
+    raw: AxiosInstance;
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    setLocale(locale: string): void;
+}
+export declare function createAdminClient(opts: ClientOptions): AdminClient;

package/dist/api/client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api/envelope.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Контракт ответов laravel-api: каждое тело — `{success, payload}`.
+ *
+ * Success: `{success: true, payload: {...}}`
+ * Error:   `{success: false, payload: {errorKey, message, ...}}`
+ *
+ * Helper'ы здесь — для type-narrowing'а в потребителях.
+ */
+export interface SuccessEnvelope<T = unknown> {
+    success: true;
+    payload: T;
+}
+export interface ErrorEnvelope {
+    success: false;
+    payload: {
+        errorKey: string;
+        message: string;
+        messages?: Record<string, string[]>;
+        [key: string]: unknown;
+    };
+}
+export type ApiEnvelope<T = unknown> = SuccessEnvelope<T> | ErrorEnvelope;
+export declare function isSuccess<T>(env: ApiEnvelope<T>): env is SuccessEnvelope<T>;
+export declare function isError(env: ApiEnvelope): env is ErrorEnvelope;

package/dist/api/envelope.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Кастомные Error-классы для admin API.
+ *
+ * Все API-ошибки бросаются как ApiError или его подклассы. Потребители
+ * могут делать `instanceof ValidationError` для специфичной обработки.
+ */
+import type { ErrorEnvelope } from './envelope';
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly errorKey: string;
+    readonly payload: ErrorEnvelope['payload'];
+    constructor(status: number, payload: ErrorEnvelope['payload']);
+}
+export declare class UnauthenticatedError extends ApiError {
+    constructor(payload: ErrorEnvelope['payload']);
+}
+export declare class ForbiddenError extends ApiError {
+    constructor(payload: ErrorEnvelope['payload']);
+}
+export declare class NotFoundError extends ApiError {
+    constructor(payload: ErrorEnvelope['payload']);
+}
+export declare class ValidationError extends ApiError {
+    /** Field-keyed map of error messages. */
+    readonly fields: Record<string, string[]>;
+    constructor(payload: ErrorEnvelope['payload']);
+    /** Первое сообщение из field'а — удобно для toast. */
+    firstFieldMessage(): string | null;
+}
+/**
+ * Network-failure (не дошли до сервера). Отдельный класс чтобы UI мог
+ * показать «Нет соединения» вместо «500 Server Error».
+ */
+export declare class NetworkError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Превращает HTTP-status + envelope в правильный подкласс ApiError.
+ */
+export declare function toApiError(status: number, payload: ErrorEnvelope['payload']): ApiError;

package/dist/api/errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/AdminApp.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/ForbiddenPage.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/HomePage.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/NotFoundPage.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/SettingsPage.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/UnknownScreenPage.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/auth/LoginForm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/auth/LoginForm.vue.d.ts

@@ -0,0 +1,17 @@
+interface Props {
+    /** URL «Забыли пароль?» — если задан, показывается link справа от remember. */
+    forgotUrl?: string | null;
+    /** Текст SSO-ссылки или null чтобы скрыть. */
+    ssoLinkLabel?: string | null;
+    ssoUrl?: string | null;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    success: (result: "authenticated" | "two_factor_required") => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    onSuccess?: ((result: "authenticated" | "two_factor_required") => any) | undefined;
+}>, {
+    forgotUrl: string | null;
+    ssoLinkLabel: string | null;
+    ssoUrl: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/auth/LoginPage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/auth/LoginPage.vue.d.ts

@@ -0,0 +1,26 @@
+interface Props {
+    brandName?: string;
+    brandMark?: string;
+    brandLogo?: string | null;
+    homeRouteName?: string;
+    redirectQueryKey?: string;
+    /** URL «Забыли пароль?» — пробрасывается в LoginForm. */
+    forgotUrl?: string | null;
+    /** SSO-link (label + url) — пробрасывается в LoginForm. */
+    ssoLinkLabel?: string | null;
+    ssoUrl?: string | null;
+    /** Показывать ли theme/locale toggle'ы в углу. */
+    showCornerActions?: boolean;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    brandName: string;
+    brandMark: string;
+    forgotUrl: string | null;
+    ssoLinkLabel: string | null;
+    ssoUrl: string | null;
+    brandLogo: string | null;
+    homeRouteName: string;
+    redirectQueryKey: string;
+    showCornerActions: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/auth/TwoFactorForm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/auth/TwoFactorForm.vue.d.ts

@@ -0,0 +1,8 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    success: () => any;
+    cancel: () => any;
+}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/auth/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public exports auth-страниц.
+ */
+export { default as LoginPage } from './LoginPage.vue';
+export { default as LoginForm } from './LoginForm.vue';
+export { default as TwoFactorForm } from './TwoFactorForm.vue';

package/dist/components/createComponentRegistry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generic factory для component-registry'ов (fields, layouts, widgets,
+ * infolist entries и т.п.).
+ *
+ * Все component-registry в admin'е по сути одинаковы: keyed Map<string, Component>
+ * + register/get/has/list/clear/registerBundle. Этот factory вытаскивает паттерн
+ * один раз; конкретные модули просто переименовывают экспорты.
+ *
+ *     const reg = createComponentRegistry<Component>()
+ *     export const registerWidget = reg.register
+ *     export const getWidget = reg.get
+ *     // ...
+ */
+export interface ComponentRegistry<T> {
+    register(type: string, value: T): void;
+    get(type: string): T | null;
+    has(type: string): boolean;
+    list(): string[];
+    clear(): void;
+    registerBundle(bundle: Record<string, T>): void;
+}
+export declare function createComponentRegistry<T>(): ComponentRegistry<T>;

package/dist/components/dashboard/BarChartWidget.vue.d.ts

@@ -0,0 +1,18 @@
+interface Datum {
+    label: string;
+    value: number;
+}
+interface Props {
+    title?: string;
+    description?: string;
+    data: Datum[];
+    accent?: string;
+    height?: number;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    title: string;
+    description: string;
+    height: number;
+    accent: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/dashboard/DashboardPage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/dashboard/DashboardPage.vue.d.ts

@@ -0,0 +1,28 @@
+import { type WidgetNode } from './WidgetRenderer.vue';
+interface Props {
+    /** Slug dashboard'а в manifest.dashboards. */
+    slug?: string;
+    /** Прямой override widget'ов (если slug не задан или не нашёлся). */
+    widgets?: WidgetNode[];
+    /** Заголовок страницы. */
+    title?: string;
+    /** Подзаголовок (description). */
+    subtitle?: string;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    actions?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    title: string;
+    slug: string;
+    subtitle: string;
+    widgets: WidgetNode[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/dashboard/DonutChartWidget.vue.d.ts

@@ -0,0 +1,13 @@
+interface Slice {
+    label: string;
+    value: number;
+    color?: string;
+}
+interface Props {
+    title?: string;
+    data: Slice[];
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    title: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/dashboard/GaugeWidget.vue.d.ts

@@ -0,0 +1,29 @@
+import type { GaugeRange } from '@dskripchenko/ui';
+type SemanticTone = 'neutral' | 'positive' | 'warning' | 'negative';
+interface Props {
+    title?: string;
+    value?: number;
+    min?: number;
+    max?: number;
+    size?: number;
+    ranges?: GaugeRange[];
+    tone?: SemanticTone;
+    color?: string;
+    label?: string;
+    suffix?: string;
+    precision?: number;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    value: number;
+    label: string;
+    title: string;
+    color: string;
+    size: number;
+    suffix: string;
+    precision: number;
+    tone: SemanticTone;
+    min: number;
+    max: number;
+    ranges: GaugeRange[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/dashboard/HeatmapWidget.vue.d.ts

@@ -0,0 +1,18 @@
+interface HeatmapPoint {
+    date: string;
+    value: number;
+}
+interface Props {
+    title?: string;
+    data: HeatmapPoint[];
+    levels?: number;
+    color?: string;
+    gap?: number;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    title: string;
+    color: string;
+    levels: number;
+    gap: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/dashboard/MarkdownWidget.vue.d.ts

@@ -0,0 +1,8 @@
+interface Props {
+    title?: string;
+    content: string;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+    title: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;