sprof 0.8.1 → 0.8.3

package/dist/core/composables/index.d.ts

@@ -14,3 +14,5 @@ export type { UseFiltersReturn } from './useFilters';
 export { useFilters } from './useFilters';
 export type { UsePaginationReturn } from './usePagination';
 export { usePagination } from './usePagination';
+export type { ThemeName, UseThemeOptions, UseThemeReturn } from './useTheme';
+export { getStoredTheme, useTheme } from './useTheme';

package/dist/core/composables/useTheme.d.ts

@@ -0,0 +1,46 @@
+import { Ref } from 'vue';
+/** Доступные темы дизайн-системы (атрибут `data-theme`). */
+export type ThemeName = 'light' | 'dark';
+/**
+ * Дополнительные атрибуты дизайн-системы на `<html>` (UI.md §0).
+ * Клиент обязан их выставить, иначе токенов нет вовсе.
+ */
+export interface UseThemeOptions {
+    /** Набор палитры, `data-brandbook` */
+    brandbook?: string;
+    /** Платформа, `data-platform` */
+    platform?: string;
+    /** Ключ в localStorage; меняйте, если на одном домене несколько приложений */
+    storageKey?: string;
+    /** Тема, если выбор ещё не сделан и системная не определилась */
+    defaultTheme?: ThemeName;
+}
+export interface UseThemeReturn {
+    /** Текущая тема */
+    theme: Ref<ThemeName>;
+    /** Тема тёмная */
+    isDark: Ref<boolean>;
+    /** Установить тему (и запомнить выбор) */
+    set(theme: ThemeName): void;
+    /** Переключить */
+    toggle(): void;
+}
+/**
+ * Переключатель темы дизайн-системы (UI-6.1).
+ *
+ * ⚠️ Токены объявлены под `:root[data-theme='light'|'dark']`, поэтому смена
+ * темы — это смена атрибута на `<html>`, а не подмена CSS. Здесь же ставим
+ * `data-brandbook`/`data-platform`: без них переменных не существует вовсе
+ * (история проекта — цвета руками именно из-за этого).
+ *
+ * ⚠️ Экземпляр СОЗДАЁТСЯ в setup клиента (один на приложение): несколько
+ * вызовов дадут несколько независимых `ref` и рассинхрон при переключении.
+ * Держите его в сторе/провайдере корневого компонента.
+ *
+ * ```ts
+ * const { theme, toggle } = useTheme({ brandbook: 'rdkb', platform: 'web-desktop' });
+ * ```
+ */
+export declare function useTheme(options?: UseThemeOptions): UseThemeReturn;
+/** Тема из localStorage (для ранней установки атрибута до создания приложения). */
+export declare function getStoredTheme(storageKey?: string): ThemeName | undefined;

package/dist/core/composables/useTheme.test.d.ts

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

package/dist/index.d.ts

@@ -47,5 +47,7 @@ export { useCrud, useFilters, usePagination } from './core/composables/index';
 export type { UseCrudOptions, UseCrudReturn } from './core/composables/useCrud';
 export type { UseFiltersReturn } from './core/composables/useFilters';
 export type { UsePaginationReturn } from './core/composables/usePagination';
+export type { ThemeName, UseThemeOptions, UseThemeReturn } from './core/composables/useTheme';
+export { getStoredTheme, useTheme } from './core/composables/useTheme';
 export type { AuthLogOperation, AuthLogProvider, AuthLogReason, AuthLogUser } from './core/auth/AuthLog';
 export { initAuthLog } from './core/auth/AuthLog';