sprof 0.8.20 → 0.9.0

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

@@ -14,5 +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, isThemeLockedLight, lockLightTheme, useTheme } from './useTheme';
+export type { PlatformName, ThemeName, UseThemeOptions, UseThemeReturn } from './useTheme';
+export { DEFAULT_PLATFORM, getStoredTheme, isThemeLockedLight, lockLightTheme, MOBILE_MAX_WIDTH, resolvePlatform, useTheme } from './useTheme';

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

@@ -1,6 +1,32 @@
 import { Ref } from 'vue';
 /** Доступные темы дизайн-системы (атрибут `data-theme`). */
 export type ThemeName = 'light' | 'dark';
+/**
+ * Платформы дизайн-системы (атрибут `data-platform`, UI.md §4a).
+ * Наборы лежат в `assets/styles/platform/*.css`.
+ */
+export type PlatformName = 'web-desktop' | 'web-tablet' | 'web-mobile' | 'ios' | 'android';
+/** Стандартный брендбук/платформа (для клиентов без явного выбора). */
+export declare const DEFAULT_PLATFORM: PlatformName;
+/**
+ * Порог «узкого экрана» для мобильной раскладки, px (UI.md §4a).
+ * 768 — общий порог планшета: ниже — телефонная оболочка. Один порог (не два)
+ * специально: два порога дали бы «мёртвую зону», где платформа не переключается.
+ */
+export declare const MOBILE_MAX_WIDTH = 768;
+/**
+ * Определить платформу по размеру вьюпорта и типу указателя.
+ *
+ * ⚠️ Зачем ФУНКЦИЯ, а не CSS-медиазапрос. Платформа — это смена НАБОРА ТОКЕНОВ
+ * (плотность, высоты полей, кегль), а не пары правил. Токены живут в CSS под
+ * `:root[data-platform=…]`, поэтому переключение — смена атрибута, что нельзя
+ * сделать медиазапросом без дублирования всего набора.
+ *
+ * ⚠️ `coarse pointer` НЕ главный признак: планшет с мышью — всё равно `tablet`,
+ * а телефон в «режиме рабочего стола» — всё равно `mobile` по ширине.
+ * Порог — ПЕРВИЧЕН (ширина), указатель — только для различения планшета/ПК.
+ */
+export declare function resolvePlatform(width: number, coarsePointer?: boolean): PlatformName;
 /**
  * Дополнительные атрибуты дизайн-системы на `<html>` (UI.md §0).
  * Клиент обязан их выставить, иначе токенов нет вовсе.
@@ -8,12 +34,18 @@ export type ThemeName = 'light' | 'dark';
 export interface UseThemeOptions {
     /** Набор палитры, `data-brandbook` */
     brandbook?: string;
-    /** Платформа, `data-platform` */
-    platform?: string;
+    /** Платформа, `data-platform` (можно менять на лету через `setPlatform`) */
+    platform?: PlatformName;
     /** Ключ в localStorage; меняйте, если на одном домене несколько приложений */
     storageKey?: string;
     /** Тема, если выбор ещё не сделан (по умолчанию — светлая) */
     defaultTheme?: ThemeName;
+    /**
+     * Следить за размером вьюпорта и менять `platform` автоматически
+     * (`resolvePlatform`). По умолчанию — выкл.: публичные сайты и админки
+     * с одним сценарием не должны случайно «уезжать» в mobile.
+     */
+    autoPlatform?: boolean;
 }
 export interface UseThemeReturn {
     /** Текущая тема */
@@ -24,6 +56,10 @@ export interface UseThemeReturn {
     set(theme: ThemeName): void;
     /** Переключить */
     toggle(): void;
+    /** Текущая платформа (`data-platform`) */
+    platform: Ref<PlatformName>;
+    /** Установить платформу вручную (отключает авто-слежение) */
+    setPlatform(platform: PlatformName): void;
 }
 /** Заморозить тему в светлой (см. `themeLockedLight`). */
 export declare function lockLightTheme(): void;

package/dist/index.d.ts

@@ -47,8 +47,8 @@ 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, isThemeLockedLight, lockLightTheme, useTheme } from './core/composables/useTheme';
+export type { PlatformName, ThemeName, UseThemeOptions, UseThemeReturn } from './core/composables/useTheme';
+export { DEFAULT_PLATFORM, getStoredTheme, isThemeLockedLight, lockLightTheme, MOBILE_MAX_WIDTH, resolvePlatform, useTheme } from './core/composables/useTheme';
 export type { QuasarBrand } from './core/brand/quasar';
 export { quasarBrandExample, quasarBrandRdkb } from './core/brand/quasar';
 export type { AuthLogOperation, AuthLogProvider, AuthLogReason, AuthLogUser } from './core/auth/AuthLog';