@cloud-ru/ds-adaptive 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/LICENSE +201 -0
- package/README.md +195 -0
- package/dist/cjs/components/AdaptiveProvider/AdaptiveProvider.d.ts +15 -0
- package/dist/cjs/components/AdaptiveProvider/AdaptiveProvider.js +17 -0
- package/dist/cjs/components/AdaptiveProvider/index.d.ts +1 -0
- package/dist/cjs/components/AdaptiveProvider/index.js +17 -0
- package/dist/cjs/components/index.d.ts +2 -0
- package/dist/cjs/components/index.js +18 -0
- package/dist/cjs/components/withLayoutType/index.d.ts +1 -0
- package/dist/cjs/components/withLayoutType/index.js +17 -0
- package/dist/cjs/components/withLayoutType/withLayoutType.d.ts +14 -0
- package/dist/cjs/components/withLayoutType/withLayoutType.js +20 -0
- package/dist/cjs/constants/adaptive.d.ts +57 -0
- package/dist/cjs/constants/adaptive.js +61 -0
- package/dist/cjs/constants/index.d.ts +1 -0
- package/dist/cjs/constants/index.js +17 -0
- package/dist/cjs/context/adaptiveContext.d.ts +15 -0
- package/dist/cjs/context/adaptiveContext.js +15 -0
- package/dist/cjs/context/index.d.ts +2 -0
- package/dist/cjs/context/index.js +5 -0
- package/dist/cjs/hooks/index.d.ts +4 -0
- package/dist/cjs/hooks/index.js +20 -0
- package/dist/cjs/hooks/useAdaptiveBootstrap.d.ts +18 -0
- package/dist/cjs/hooks/useAdaptiveBootstrap.js +22 -0
- package/dist/cjs/hooks/useClientLayoutType.d.ts +10 -0
- package/dist/cjs/hooks/useClientLayoutType.js +35 -0
- package/dist/cjs/hooks/useLayoutDefaults.d.ts +14 -0
- package/dist/cjs/hooks/useLayoutDefaults.js +21 -0
- package/dist/cjs/hooks/useMatchMedia.d.ts +18 -0
- package/dist/cjs/hooks/useMatchMedia.js +42 -0
- package/dist/cjs/index.d.ts +7 -0
- package/dist/cjs/index.js +23 -0
- package/dist/cjs/keys.d.ts +4 -0
- package/dist/cjs/keys.js +19 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/ssr.d.ts +10 -0
- package/dist/cjs/ssr.js +32 -0
- package/dist/cjs/store/createAdaptiveStore.d.ts +22 -0
- package/dist/cjs/store/createAdaptiveStore.js +29 -0
- package/dist/cjs/store/globalStore.d.ts +20 -0
- package/dist/cjs/store/globalStore.js +43 -0
- package/dist/cjs/store/index.d.ts +2 -0
- package/dist/cjs/store/index.js +18 -0
- package/dist/cjs/types/adaptive.d.ts +6 -0
- package/dist/cjs/types/adaptive.js +2 -0
- package/dist/cjs/types/index.d.ts +3 -0
- package/dist/cjs/types/index.js +19 -0
- package/dist/cjs/types/layoutTypes.d.ts +13 -0
- package/dist/cjs/types/layoutTypes.js +10 -0
- package/dist/cjs/types/presets.d.ts +6 -0
- package/dist/cjs/types/presets.js +2 -0
- package/dist/cjs/types/valueOf.d.ts +2 -0
- package/dist/cjs/types/valueOf.js +2 -0
- package/dist/cjs/utils/getAdaptive.d.ts +15 -0
- package/dist/cjs/utils/getAdaptive.js +39 -0
- package/dist/cjs/utils/getLayoutBootstrapScript.d.ts +2 -0
- package/dist/cjs/utils/getLayoutBootstrapScript.js +9 -0
- package/dist/cjs/utils/getMatchMedia.d.ts +12 -0
- package/dist/cjs/utils/getMatchMedia.js +24 -0
- package/dist/cjs/utils/getSSRInitialLayoutType.d.ts +21 -0
- package/dist/cjs/utils/getSSRInitialLayoutType.js +32 -0
- package/dist/cjs/utils/getUserAgentInfo.d.ts +43 -0
- package/dist/cjs/utils/getUserAgentInfo.js +114 -0
- package/dist/cjs/utils/index.d.ts +6 -0
- package/dist/cjs/utils/index.js +22 -0
- package/dist/cjs/utils/isBrowser.d.ts +3 -0
- package/dist/cjs/utils/isBrowser.js +9 -0
- package/dist/cjs/utils/layoutTypeFromMatchMedia.d.ts +4 -0
- package/dist/cjs/utils/layoutTypeFromMatchMedia.js +18 -0
- package/dist/cjs/utils/layoutTypeFromUserAgent.d.ts +6 -0
- package/dist/cjs/utils/layoutTypeFromUserAgent.js +20 -0
- package/dist/cjs/utils/layoutTypeFromWidth.d.ts +3 -0
- package/dist/cjs/utils/layoutTypeFromWidth.js +18 -0
- package/dist/cjs/utils/resolveByLayout.d.ts +28 -0
- package/dist/cjs/utils/resolveByLayout.js +49 -0
- package/dist/cjs/utils/resolveLayoutType.d.ts +11 -0
- package/dist/cjs/utils/resolveLayoutType.js +19 -0
- package/dist/esm/components/AdaptiveProvider/AdaptiveProvider.d.ts +15 -0
- package/dist/esm/components/AdaptiveProvider/AdaptiveProvider.js +14 -0
- package/dist/esm/components/AdaptiveProvider/index.d.ts +1 -0
- package/dist/esm/components/AdaptiveProvider/index.js +1 -0
- package/dist/esm/components/index.d.ts +2 -0
- package/dist/esm/components/index.js +2 -0
- package/dist/esm/components/withLayoutType/index.d.ts +1 -0
- package/dist/esm/components/withLayoutType/index.js +1 -0
- package/dist/esm/components/withLayoutType/withLayoutType.d.ts +14 -0
- package/dist/esm/components/withLayoutType/withLayoutType.js +17 -0
- package/dist/esm/constants/adaptive.d.ts +57 -0
- package/dist/esm/constants/adaptive.js +57 -0
- package/dist/esm/constants/index.d.ts +1 -0
- package/dist/esm/constants/index.js +1 -0
- package/dist/esm/context/adaptiveContext.d.ts +15 -0
- package/dist/esm/context/adaptiveContext.js +11 -0
- package/dist/esm/context/index.d.ts +2 -0
- package/dist/esm/context/index.js +1 -0
- package/dist/esm/hooks/index.d.ts +4 -0
- package/dist/esm/hooks/index.js +4 -0
- package/dist/esm/hooks/useAdaptiveBootstrap.d.ts +18 -0
- package/dist/esm/hooks/useAdaptiveBootstrap.js +19 -0
- package/dist/esm/hooks/useClientLayoutType.d.ts +10 -0
- package/dist/esm/hooks/useClientLayoutType.js +32 -0
- package/dist/esm/hooks/useLayoutDefaults.d.ts +14 -0
- package/dist/esm/hooks/useLayoutDefaults.js +18 -0
- package/dist/esm/hooks/useMatchMedia.d.ts +18 -0
- package/dist/esm/hooks/useMatchMedia.js +37 -0
- package/dist/esm/index.d.ts +7 -0
- package/dist/esm/index.js +7 -0
- package/dist/esm/keys.d.ts +4 -0
- package/dist/esm/keys.js +16 -0
- package/dist/esm/ssr.d.ts +10 -0
- package/dist/esm/ssr.js +16 -0
- package/dist/esm/store/createAdaptiveStore.d.ts +22 -0
- package/dist/esm/store/createAdaptiveStore.js +26 -0
- package/dist/esm/store/globalStore.d.ts +20 -0
- package/dist/esm/store/globalStore.js +40 -0
- package/dist/esm/store/index.d.ts +2 -0
- package/dist/esm/store/index.js +2 -0
- package/dist/esm/types/adaptive.d.ts +6 -0
- package/dist/esm/types/adaptive.js +1 -0
- package/dist/esm/types/index.d.ts +3 -0
- package/dist/esm/types/index.js +3 -0
- package/dist/esm/types/layoutTypes.d.ts +13 -0
- package/dist/esm/types/layoutTypes.js +7 -0
- package/dist/esm/types/presets.d.ts +6 -0
- package/dist/esm/types/presets.js +1 -0
- package/dist/esm/types/valueOf.d.ts +2 -0
- package/dist/esm/types/valueOf.js +1 -0
- package/dist/esm/utils/getAdaptive.d.ts +15 -0
- package/dist/esm/utils/getAdaptive.js +36 -0
- package/dist/esm/utils/getLayoutBootstrapScript.d.ts +2 -0
- package/dist/esm/utils/getLayoutBootstrapScript.js +6 -0
- package/dist/esm/utils/getMatchMedia.d.ts +12 -0
- package/dist/esm/utils/getMatchMedia.js +18 -0
- package/dist/esm/utils/getSSRInitialLayoutType.d.ts +21 -0
- package/dist/esm/utils/getSSRInitialLayoutType.js +28 -0
- package/dist/esm/utils/getUserAgentInfo.d.ts +43 -0
- package/dist/esm/utils/getUserAgentInfo.js +110 -0
- package/dist/esm/utils/index.d.ts +6 -0
- package/dist/esm/utils/index.js +6 -0
- package/dist/esm/utils/isBrowser.d.ts +3 -0
- package/dist/esm/utils/isBrowser.js +6 -0
- package/dist/esm/utils/layoutTypeFromMatchMedia.d.ts +4 -0
- package/dist/esm/utils/layoutTypeFromMatchMedia.js +15 -0
- package/dist/esm/utils/layoutTypeFromUserAgent.d.ts +6 -0
- package/dist/esm/utils/layoutTypeFromUserAgent.js +17 -0
- package/dist/esm/utils/layoutTypeFromWidth.d.ts +3 -0
- package/dist/esm/utils/layoutTypeFromWidth.js +15 -0
- package/dist/esm/utils/resolveByLayout.d.ts +28 -0
- package/dist/esm/utils/resolveByLayout.js +45 -0
- package/dist/esm/utils/resolveLayoutType.d.ts +11 -0
- package/dist/esm/utils/resolveLayoutType.js +15 -0
- package/dist/tsconfig.cjs.tsbuildinfo +1 -0
- package/dist/tsconfig.esm.tsbuildinfo +1 -0
- package/package.json +45 -0
- package/src/components/AdaptiveProvider/AdaptiveProvider.tsx +28 -0
- package/src/components/AdaptiveProvider/index.ts +1 -0
- package/src/components/index.ts +2 -0
- package/src/components/withLayoutType/index.ts +1 -0
- package/src/components/withLayoutType/withLayoutType.tsx +26 -0
- package/src/constants/adaptive.ts +73 -0
- package/src/constants/index.ts +1 -0
- package/src/context/adaptiveContext.ts +27 -0
- package/src/context/index.ts +2 -0
- package/src/hooks/index.ts +4 -0
- package/src/hooks/useAdaptiveBootstrap.ts +38 -0
- package/src/hooks/useClientLayoutType.ts +51 -0
- package/src/hooks/useLayoutDefaults.ts +21 -0
- package/src/hooks/useMatchMedia.ts +52 -0
- package/src/index.ts +7 -0
- package/src/keys.ts +18 -0
- package/src/ssr.ts +16 -0
- package/src/store/createAdaptiveStore.ts +42 -0
- package/src/store/globalStore.ts +57 -0
- package/src/store/index.ts +2 -0
- package/src/types/adaptive.ts +8 -0
- package/src/types/index.ts +3 -0
- package/src/types/layoutTypes.ts +15 -0
- package/src/types/presets.ts +7 -0
- package/src/types/valueOf.ts +2 -0
- package/src/utils/getAdaptive.ts +46 -0
- package/src/utils/getLayoutBootstrapScript.ts +8 -0
- package/src/utils/getMatchMedia.ts +36 -0
- package/src/utils/getSSRInitialLayoutType.ts +50 -0
- package/src/utils/getUserAgentInfo.ts +145 -0
- package/src/utils/index.ts +6 -0
- package/src/utils/isBrowser.ts +6 -0
- package/src/utils/layoutTypeFromMatchMedia.ts +20 -0
- package/src/utils/layoutTypeFromUserAgent.ts +19 -0
- package/src/utils/layoutTypeFromWidth.ts +20 -0
- package/src/utils/resolveByLayout.ts +72 -0
- package/src/utils/resolveLayoutType.ts +18 -0
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { ADAPTIVE_QUERY } from '../constants/adaptive.js';
|
|
2
|
+
import { ValueOf } from './valueOf.js';
|
|
3
|
+
/** Ключ одного из adaptive media-query (`isMobile` / `isTablet` / …). */
|
|
4
|
+
export type AdaptiveQuery = ValueOf<typeof ADAPTIVE_QUERY>;
|
|
5
|
+
/** Карта `query-key → matched?` для произвольного набора media-query. */
|
|
6
|
+
export type MatchMediaGeneric<T extends string> = Record<T, boolean>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { ValueOf } from './valueOf.js';
|
|
2
|
+
/** Константы типов раскладки adaptive-компонентов (mobile / tablet / desktopSmall / desktop). */
|
|
3
|
+
export declare const LAYOUT_TYPE: {
|
|
4
|
+
readonly Desktop: "desktop";
|
|
5
|
+
readonly DesktopSmall: "desktopSmall";
|
|
6
|
+
readonly Tablet: "tablet";
|
|
7
|
+
readonly Mobile: "mobile";
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* Union типов раскладки adaptive-компонентов
|
|
11
|
+
* @function type
|
|
12
|
+
*/
|
|
13
|
+
export type LayoutType = ValueOf<typeof LAYOUT_TYPE>;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { LayoutType } from './layoutTypes.js';
|
|
2
|
+
/**
|
|
3
|
+
* Карта пресетов дефолтов по раскладке: для каждого `layoutType` — частичный набор пропов поверх
|
|
4
|
+
* базовых дефолтов. Обычно непуст только `mobile`. Резолв — `resolveByLayout` / `useLayoutDefaults`.
|
|
5
|
+
*/
|
|
6
|
+
export type LayoutPresets<P> = Partial<Record<LayoutType, Partial<P>>>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { AdaptiveQuery, MatchMediaGeneric } from '../types/adaptive.js';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
3
|
+
/**
|
|
4
|
+
* Вычисляет `layoutType` по типу устройства из user-agent + media-query (гибрид «UA + ширина»):
|
|
5
|
+
* - `mobile` → всегда `mobile`;
|
|
6
|
+
* - `tablet` → `mobile` при узком окне (`isTablet`), иначе `tablet`;
|
|
7
|
+
* - desktop / неизвестное → каскад по ширине: `isMobile` → `mobile`, `isTablet` → `tablet`,
|
|
8
|
+
* `isSmallDesktop` → `desktopSmall`, иначе `desktop`.
|
|
9
|
+
*
|
|
10
|
+
* SSR: передайте `userAgent` из заголовка запроса для корректной ветки в HTML без скачка после
|
|
11
|
+
* гидрации; media-query на сервере нет → `INITIAL_ADAPTIVE_QUERIES_VALUE`.
|
|
12
|
+
*/
|
|
13
|
+
export declare function getAdaptive(matchMedia: MatchMediaGeneric<AdaptiveQuery>, userAgent?: string): {
|
|
14
|
+
layoutType: LayoutType;
|
|
15
|
+
};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { ADAPTIVE_QUERY } from '../constants/adaptive.js';
|
|
2
|
+
import { LAYOUT_TYPE } from '../types/layoutTypes.js';
|
|
3
|
+
import { getUserAgentInfo } from './getUserAgentInfo.js';
|
|
4
|
+
/**
|
|
5
|
+
* Вычисляет `layoutType` по типу устройства из user-agent + media-query (гибрид «UA + ширина»):
|
|
6
|
+
* - `mobile` → всегда `mobile`;
|
|
7
|
+
* - `tablet` → `mobile` при узком окне (`isTablet`), иначе `tablet`;
|
|
8
|
+
* - desktop / неизвестное → каскад по ширине: `isMobile` → `mobile`, `isTablet` → `tablet`,
|
|
9
|
+
* `isSmallDesktop` → `desktopSmall`, иначе `desktop`.
|
|
10
|
+
*
|
|
11
|
+
* SSR: передайте `userAgent` из заголовка запроса для корректной ветки в HTML без скачка после
|
|
12
|
+
* гидрации; media-query на сервере нет → `INITIAL_ADAPTIVE_QUERIES_VALUE`.
|
|
13
|
+
*/
|
|
14
|
+
export function getAdaptive(matchMedia, userAgent) {
|
|
15
|
+
const { device } = getUserAgentInfo(userAgent);
|
|
16
|
+
const isMobile = matchMedia[ADAPTIVE_QUERY.IsMobile];
|
|
17
|
+
const isTablet = matchMedia[ADAPTIVE_QUERY.IsTablet];
|
|
18
|
+
const isSmallDesktop = matchMedia[ADAPTIVE_QUERY.IsSmallDesktop];
|
|
19
|
+
if (device.type === 'mobile') {
|
|
20
|
+
return { layoutType: LAYOUT_TYPE.Mobile };
|
|
21
|
+
}
|
|
22
|
+
if (device.type === 'tablet') {
|
|
23
|
+
return { layoutType: isTablet ? LAYOUT_TYPE.Mobile : LAYOUT_TYPE.Tablet };
|
|
24
|
+
}
|
|
25
|
+
// desktop / неизвестное устройство — каскад по ширине через все пороги.
|
|
26
|
+
if (isMobile) {
|
|
27
|
+
return { layoutType: LAYOUT_TYPE.Mobile };
|
|
28
|
+
}
|
|
29
|
+
if (isTablet) {
|
|
30
|
+
return { layoutType: LAYOUT_TYPE.Tablet };
|
|
31
|
+
}
|
|
32
|
+
if (isSmallDesktop) {
|
|
33
|
+
return { layoutType: LAYOUT_TYPE.DesktopSmall };
|
|
34
|
+
}
|
|
35
|
+
return { layoutType: LAYOUT_TYPE.Desktop };
|
|
36
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { ADAPTIVE_BREAKPOINT, buildAdaptiveQueries } from '../constants/adaptive.js';
|
|
2
|
+
import { LAYOUT_TYPE } from '../types/layoutTypes.js';
|
|
3
|
+
export function getLayoutBootstrapScript(breakpoints) {
|
|
4
|
+
const queries = buildAdaptiveQueries({ ...ADAPTIVE_BREAKPOINT, ...breakpoints });
|
|
5
|
+
return `(function(){try{var d=document.documentElement;if(matchMedia('${queries.isMobile}').matches){d.dataset.layoutType='${LAYOUT_TYPE.Mobile}';}else if(matchMedia('${queries.isTablet}').matches){d.dataset.layoutType='${LAYOUT_TYPE.Tablet}';}else if(matchMedia('${queries.isSmallDesktop}').matches){d.dataset.layoutType='${LAYOUT_TYPE.DesktopSmall}';}else{d.dataset.layoutType='${LAYOUT_TYPE.Desktop}';}}catch(e){}})();`;
|
|
6
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { MatchMediaGeneric } from '../types/adaptive.js';
|
|
2
|
+
/** Возвращает пары `[query-key, MediaQueryList]` для подписки на `change`. */
|
|
3
|
+
export declare function getMediaQueryListGeneric<T extends string>({ queryValues }: {
|
|
4
|
+
queryValues: Record<T, string>;
|
|
5
|
+
}): Array<[T, MediaQueryList]>;
|
|
6
|
+
/** Снимок текущего состояния media-query (`query-key → matched?`); SSR → `initialValues`. */
|
|
7
|
+
export declare function getMatchMediaGeneric<T extends string>({ queryValues, initialValues, }: {
|
|
8
|
+
queryValues: Record<T, string>;
|
|
9
|
+
initialValues: MatchMediaGeneric<T>;
|
|
10
|
+
}): MatchMediaGeneric<T>;
|
|
11
|
+
/** Снимок adaptive media-query (`isMobile` / `isTablet` / …). */
|
|
12
|
+
export declare const getAdaptiveMatchMedia: () => MatchMediaGeneric<"isMobile" | "isTablet" | "isSmallDesktop" | "isDesktop" | "isLarge">;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { ADAPTIVE_QUERIES, INITIAL_ADAPTIVE_QUERIES_VALUE } from '../constants/adaptive.js';
|
|
2
|
+
import { isBrowser } from './isBrowser.js';
|
|
3
|
+
function getMediaQueries({ queryValues }) {
|
|
4
|
+
return Object.keys(queryValues).reduce((acc, key) => ({
|
|
5
|
+
...acc,
|
|
6
|
+
[key]: isBrowser() ? globalThis.matchMedia(queryValues[key]) : undefined,
|
|
7
|
+
}), {});
|
|
8
|
+
}
|
|
9
|
+
/** Возвращает пары `[query-key, MediaQueryList]` для подписки на `change`. */
|
|
10
|
+
export function getMediaQueryListGeneric({ queryValues }) {
|
|
11
|
+
return Object.entries(getMediaQueries({ queryValues }));
|
|
12
|
+
}
|
|
13
|
+
/** Снимок текущего состояния media-query (`query-key → matched?`); SSR → `initialValues`. */
|
|
14
|
+
export function getMatchMediaGeneric({ queryValues, initialValues, }) {
|
|
15
|
+
return getMediaQueryListGeneric({ queryValues }).reduce((acc, [key, q]) => ({ ...acc, [key]: q?.matches || false }), initialValues);
|
|
16
|
+
}
|
|
17
|
+
/** Снимок adaptive media-query (`isMobile` / `isTablet` / …). */
|
|
18
|
+
export const getAdaptiveMatchMedia = () => getMatchMediaGeneric({ queryValues: ADAPTIVE_QUERIES, initialValues: INITIAL_ADAPTIVE_QUERIES_VALUE });
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { AdaptiveBreakpoints } from '../constants/adaptive.js';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
3
|
+
/** Заголовок Client Hints с шириной viewport (Chromium). См. `Critical-CH` в `next.config`. */
|
|
4
|
+
export declare const SEC_CH_VIEWPORT_WIDTH_HEADER = "sec-ch-viewport-width";
|
|
5
|
+
export type GetSSRInitialLayoutTypeOptions = {
|
|
6
|
+
/** `Sec-CH-Viewport-Width` или другое значение ширины (строка из заголовка или число в px). */
|
|
7
|
+
viewportWidth?: string | number | null;
|
|
8
|
+
/** `User-Agent` запроса для SSR-фолбэка без Client Hints. */
|
|
9
|
+
userAgent?: string | null;
|
|
10
|
+
/** Переопределение брейкпоинтов — только для ветки с `viewportWidth`. */
|
|
11
|
+
breakpoints?: AdaptiveBreakpoints;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Стартовый `layoutType` для SSR в Next.js App Router.
|
|
15
|
+
*
|
|
16
|
+
* 1. Есть валидная ширина (Client Hints на Chromium) → каскад по брейкпоинтам (4 тира).
|
|
17
|
+
* 2. Иначе → `layoutTypeFromUserAgent` (mobile / tablet / desktop).
|
|
18
|
+
*
|
|
19
|
+
* Пара с `getLayoutBootstrapScript()` (pre-paint) и `useLayoutTypeState(initialLayoutType)` на клиенте.
|
|
20
|
+
*/
|
|
21
|
+
export declare function getSSRInitialLayoutType({ viewportWidth, userAgent, breakpoints, }: GetSSRInitialLayoutTypeOptions): LayoutType;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { layoutTypeFromUserAgent } from './layoutTypeFromUserAgent.js';
|
|
2
|
+
import { layoutTypeFromWidth } from './layoutTypeFromWidth.js';
|
|
3
|
+
/** Заголовок Client Hints с шириной viewport (Chromium). См. `Critical-CH` в `next.config`. */
|
|
4
|
+
export const SEC_CH_VIEWPORT_WIDTH_HEADER = 'sec-ch-viewport-width';
|
|
5
|
+
function parseViewportWidth(viewportWidth) {
|
|
6
|
+
const width = typeof viewportWidth === 'number' ? viewportWidth : Number(viewportWidth);
|
|
7
|
+
if (!Number.isFinite(width) || width <= 0) {
|
|
8
|
+
return null;
|
|
9
|
+
}
|
|
10
|
+
return width;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Стартовый `layoutType` для SSR в Next.js App Router.
|
|
14
|
+
*
|
|
15
|
+
* 1. Есть валидная ширина (Client Hints на Chromium) → каскад по брейкпоинтам (4 тира).
|
|
16
|
+
* 2. Иначе → `layoutTypeFromUserAgent` (mobile / tablet / desktop).
|
|
17
|
+
*
|
|
18
|
+
* Пара с `getLayoutBootstrapScript()` (pre-paint) и `useLayoutTypeState(initialLayoutType)` на клиенте.
|
|
19
|
+
*/
|
|
20
|
+
export function getSSRInitialLayoutType({ viewportWidth, userAgent, breakpoints, }) {
|
|
21
|
+
if (viewportWidth != null && viewportWidth !== '') {
|
|
22
|
+
const width = parseViewportWidth(viewportWidth);
|
|
23
|
+
if (width != null) {
|
|
24
|
+
return layoutTypeFromWidth(width, breakpoints);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return layoutTypeFromUserAgent(userAgent ?? '');
|
|
28
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { ValueOf } from '../types/valueOf.js';
|
|
2
|
+
/** Тип устройства из user-agent. */
|
|
3
|
+
export declare const DEVICE_TYPE: {
|
|
4
|
+
readonly Console: "console";
|
|
5
|
+
readonly Mobile: "mobile";
|
|
6
|
+
readonly Tablet: "tablet";
|
|
7
|
+
readonly Smarttv: "smarttv";
|
|
8
|
+
readonly Wearable: "wearable";
|
|
9
|
+
readonly Embedded: "embedded";
|
|
10
|
+
readonly Desktop: "desktop";
|
|
11
|
+
};
|
|
12
|
+
export type DeviceType = ValueOf<typeof DEVICE_TYPE>;
|
|
13
|
+
/** Операционная система из user-agent. Поля пустые, если UA не распознан. */
|
|
14
|
+
export type UserAgentOs = {
|
|
15
|
+
name?: string;
|
|
16
|
+
version?: string;
|
|
17
|
+
};
|
|
18
|
+
/** Браузер из user-agent. Поля пустые, если UA не распознан. */
|
|
19
|
+
export type UserAgentBrowser = {
|
|
20
|
+
name?: string;
|
|
21
|
+
version?: string;
|
|
22
|
+
/** Мажорная часть `version` — удобна для проверок вида «Safari младше 16». */
|
|
23
|
+
major?: string;
|
|
24
|
+
};
|
|
25
|
+
export type UserAgentInfo = {
|
|
26
|
+
device: {
|
|
27
|
+
model?: string;
|
|
28
|
+
type: DeviceType;
|
|
29
|
+
};
|
|
30
|
+
os: UserAgentOs;
|
|
31
|
+
browser: UserAgentBrowser;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Разбирает user-agent и возвращает тип устройства, ОС и браузер.
|
|
35
|
+
* Источник UA: аргумент `userAgent` (для SSR — заголовок запроса), иначе `navigator.userAgent`.
|
|
36
|
+
* На сервере без аргумента `device.type` нормализуется к `desktop`.
|
|
37
|
+
*
|
|
38
|
+
* Детектор целенаправленно узкий: он покрывает раскладку (`device.type` — единственное, что читает
|
|
39
|
+
* адаптив) и популярные браузеры/ОС. Для экзотических устройств `device.type` деградирует к
|
|
40
|
+
* `desktop`, а `os`/`browser` остаются пустыми — это осознанный размен на отсутствие внешней
|
|
41
|
+
* зависимости с базой UA.
|
|
42
|
+
*/
|
|
43
|
+
export declare function getUserAgentInfo(userAgent?: string): UserAgentInfo;
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { isBrowser } from './isBrowser.js';
|
|
2
|
+
/** Тип устройства из user-agent. */
|
|
3
|
+
export const DEVICE_TYPE = {
|
|
4
|
+
Console: 'console',
|
|
5
|
+
Mobile: 'mobile',
|
|
6
|
+
Tablet: 'tablet',
|
|
7
|
+
Smarttv: 'smarttv',
|
|
8
|
+
Wearable: 'wearable',
|
|
9
|
+
Embedded: 'embedded',
|
|
10
|
+
Desktop: 'desktop',
|
|
11
|
+
};
|
|
12
|
+
const TV_PATTERN = /\b(?:SmartTV|SMART-TV|GoogleTV|AppleTV|HbbTV|NetCast|Web0S|webOS TV|BRAVIA|Roku|CrKey)\b/i;
|
|
13
|
+
const CONSOLE_PATTERN = /\b(?:Nintendo|PlayStation|Xbox)\b/i;
|
|
14
|
+
const WEARABLE_PATTERN = /\b(?:Watch|Wear OS|Glass)\b/i;
|
|
15
|
+
const TABLET_PATTERN = /\b(?:iPad|Tablet|PlayBook|Kindle|Silk)\b/i;
|
|
16
|
+
const MOBILE_PATTERN = /\b(?:iPhone|iPod|Windows Phone|IEMobile|BlackBerry|BB10|Opera Mini|Mobi)\b/i;
|
|
17
|
+
function detectDeviceType(userAgent) {
|
|
18
|
+
if (TV_PATTERN.test(userAgent))
|
|
19
|
+
return DEVICE_TYPE.Smarttv;
|
|
20
|
+
if (CONSOLE_PATTERN.test(userAgent))
|
|
21
|
+
return DEVICE_TYPE.Console;
|
|
22
|
+
if (WEARABLE_PATTERN.test(userAgent))
|
|
23
|
+
return DEVICE_TYPE.Wearable;
|
|
24
|
+
if (TABLET_PATTERN.test(userAgent))
|
|
25
|
+
return DEVICE_TYPE.Tablet;
|
|
26
|
+
// Android без токена `Mobi` — планшет: так это размечает сам Android (WebView ставит `Mobile`
|
|
27
|
+
// только на телефонах).
|
|
28
|
+
if (/Android/i.test(userAgent))
|
|
29
|
+
return /Mobi/i.test(userAgent) ? DEVICE_TYPE.Mobile : DEVICE_TYPE.Tablet;
|
|
30
|
+
if (MOBILE_PATTERN.test(userAgent))
|
|
31
|
+
return DEVICE_TYPE.Mobile;
|
|
32
|
+
return DEVICE_TYPE.Desktop;
|
|
33
|
+
}
|
|
34
|
+
function detectModel(userAgent) {
|
|
35
|
+
const apple = /\b(iPhone|iPad|iPod)\b/.exec(userAgent);
|
|
36
|
+
if (apple)
|
|
37
|
+
return apple[1];
|
|
38
|
+
// Android держит модель в комментарии: `(Linux; Android 14; SM-S911B) ...` или `... Build/...`.
|
|
39
|
+
const android = /Android[^;)]*;\s*([^;)]+?)(?:\s+Build\/[^;)]*)?\s*[;)]/.exec(userAgent);
|
|
40
|
+
return android?.[1]?.trim() || undefined;
|
|
41
|
+
}
|
|
42
|
+
const WINDOWS_NT_NAMES = {
|
|
43
|
+
'10.0': '10',
|
|
44
|
+
'6.3': '8.1',
|
|
45
|
+
'6.2': '8',
|
|
46
|
+
'6.1': '7',
|
|
47
|
+
};
|
|
48
|
+
function detectOs(userAgent) {
|
|
49
|
+
const ios = /\b(?:iPhone|iPad|iPod)\b.*?\bOS (\d+(?:[._]\d+)*)/.exec(userAgent);
|
|
50
|
+
if (ios)
|
|
51
|
+
return { name: 'iOS', version: ios[1].replace(/_/g, '.') };
|
|
52
|
+
const android = /Android (\d+(?:\.\d+)*)/.exec(userAgent);
|
|
53
|
+
if (android)
|
|
54
|
+
return { name: 'Android', version: android[1] };
|
|
55
|
+
const windows = /Windows NT (\d+\.\d+)/.exec(userAgent);
|
|
56
|
+
if (windows)
|
|
57
|
+
return { name: 'Windows', version: WINDOWS_NT_NAMES[windows[1]] ?? windows[1] };
|
|
58
|
+
const macos = /Mac OS X (\d+(?:[._]\d+)*)/.exec(userAgent);
|
|
59
|
+
if (macos)
|
|
60
|
+
return { name: 'macOS', version: macos[1].replace(/_/g, '.') };
|
|
61
|
+
if (/Macintosh/i.test(userAgent))
|
|
62
|
+
return { name: 'macOS' };
|
|
63
|
+
if (/Linux/i.test(userAgent))
|
|
64
|
+
return { name: 'Linux' };
|
|
65
|
+
return {};
|
|
66
|
+
}
|
|
67
|
+
// Порядок важен: Edge и Opera представляются Chrome'ом, Chrome — Safari.
|
|
68
|
+
const BROWSER_PATTERNS = [
|
|
69
|
+
{ name: 'Edge', pattern: /\bEdgi?[A-Za-z]*\/([\d.]+)/ },
|
|
70
|
+
{ name: 'Opera', pattern: /\b(?:OPR|Opera)\/([\d.]+)/ },
|
|
71
|
+
{ name: 'Yandex Browser', pattern: /\bYaBrowser\/([\d.]+)/ },
|
|
72
|
+
{ name: 'Samsung Internet', pattern: /\bSamsungBrowser\/([\d.]+)/ },
|
|
73
|
+
{ name: 'Firefox', pattern: /\b(?:Firefox|FxiOS)\/([\d.]+)/ },
|
|
74
|
+
{ name: 'Chrome', pattern: /\b(?:Chrome|CriOS|Chromium)\/([\d.]+)/ },
|
|
75
|
+
{ name: 'Safari', pattern: /\bVersion\/([\d.]+).*\bSafari\b/ },
|
|
76
|
+
];
|
|
77
|
+
function detectBrowser(userAgent) {
|
|
78
|
+
for (const { name, pattern } of BROWSER_PATTERNS) {
|
|
79
|
+
const match = pattern.exec(userAgent);
|
|
80
|
+
if (match) {
|
|
81
|
+
const version = match[1];
|
|
82
|
+
return { name, version, major: version.split('.')[0] };
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return {};
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Разбирает user-agent и возвращает тип устройства, ОС и браузер.
|
|
89
|
+
* Источник UA: аргумент `userAgent` (для SSR — заголовок запроса), иначе `navigator.userAgent`.
|
|
90
|
+
* На сервере без аргумента `device.type` нормализуется к `desktop`.
|
|
91
|
+
*
|
|
92
|
+
* Детектор целенаправленно узкий: он покрывает раскладку (`device.type` — единственное, что читает
|
|
93
|
+
* адаптив) и популярные браузеры/ОС. Для экзотических устройств `device.type` деградирует к
|
|
94
|
+
* `desktop`, а `os`/`browser` остаются пустыми — это осознанный размен на отсутствие внешней
|
|
95
|
+
* зависимости с базой UA.
|
|
96
|
+
*/
|
|
97
|
+
export function getUserAgentInfo(userAgent) {
|
|
98
|
+
const resolvedUserAgent = userAgent ?? (isBrowser() ? globalThis.navigator.userAgent : undefined);
|
|
99
|
+
if (!resolvedUserAgent) {
|
|
100
|
+
return { device: { type: DEVICE_TYPE.Desktop }, os: {}, browser: {} };
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
device: {
|
|
104
|
+
model: detectModel(resolvedUserAgent),
|
|
105
|
+
type: detectDeviceType(resolvedUserAgent),
|
|
106
|
+
},
|
|
107
|
+
os: detectOs(resolvedUserAgent),
|
|
108
|
+
browser: detectBrowser(resolvedUserAgent),
|
|
109
|
+
};
|
|
110
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/** Проверка браузерной среды (SSR-safe). Локальная копия — чтобы SSR-путь `@cloud-ru/ds-adaptive/ssr`
|
|
2
|
+
* не тянул баррель `@cloud-ru/ds-utils` (createContext/хуки) в React Server Components. */
|
|
3
|
+
export function isBrowser() {
|
|
4
|
+
// eslint-disable-next-line @cloud-ru/ssr-safe-react/domApi
|
|
5
|
+
return Boolean(typeof window !== 'undefined' && window.document && window.document.createElement);
|
|
6
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { AdaptiveQuery, MatchMediaGeneric } from '../types/adaptive.js';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
3
|
+
/** Каскад `layoutType` по adaptive media-query (без учёта user-agent). */
|
|
4
|
+
export declare function layoutTypeFromMatchMedia(matchMedia: MatchMediaGeneric<AdaptiveQuery>): LayoutType;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { ADAPTIVE_QUERY } from '../constants/adaptive.js';
|
|
2
|
+
import { LAYOUT_TYPE } from '../types/layoutTypes.js';
|
|
3
|
+
/** Каскад `layoutType` по adaptive media-query (без учёта user-agent). */
|
|
4
|
+
export function layoutTypeFromMatchMedia(matchMedia) {
|
|
5
|
+
if (matchMedia[ADAPTIVE_QUERY.IsMobile]) {
|
|
6
|
+
return LAYOUT_TYPE.Mobile;
|
|
7
|
+
}
|
|
8
|
+
if (matchMedia[ADAPTIVE_QUERY.IsTablet]) {
|
|
9
|
+
return LAYOUT_TYPE.Tablet;
|
|
10
|
+
}
|
|
11
|
+
if (matchMedia[ADAPTIVE_QUERY.IsSmallDesktop]) {
|
|
12
|
+
return LAYOUT_TYPE.DesktopSmall;
|
|
13
|
+
}
|
|
14
|
+
return LAYOUT_TYPE.Desktop;
|
|
15
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
2
|
+
/**
|
|
3
|
+
* Грубый `layoutType` по user-agent (три тира: mobile / tablet / desktop).
|
|
4
|
+
* Без ширины окна `desktopSmall` не выводится — для SSR-фолбэка, когда нет Client Hints.
|
|
5
|
+
*/
|
|
6
|
+
export declare function layoutTypeFromUserAgent(userAgent: string): LayoutType;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { LAYOUT_TYPE } from '../types/layoutTypes.js';
|
|
2
|
+
import { DEVICE_TYPE, getUserAgentInfo } from './getUserAgentInfo.js';
|
|
3
|
+
/**
|
|
4
|
+
* Грубый `layoutType` по user-agent (три тира: mobile / tablet / desktop).
|
|
5
|
+
* Без ширины окна `desktopSmall` не выводится — для SSR-фолбэка, когда нет Client Hints.
|
|
6
|
+
*/
|
|
7
|
+
export function layoutTypeFromUserAgent(userAgent) {
|
|
8
|
+
const { device } = getUserAgentInfo(userAgent);
|
|
9
|
+
switch (device.type) {
|
|
10
|
+
case DEVICE_TYPE.Mobile:
|
|
11
|
+
return LAYOUT_TYPE.Mobile;
|
|
12
|
+
case DEVICE_TYPE.Tablet:
|
|
13
|
+
return LAYOUT_TYPE.Tablet;
|
|
14
|
+
default:
|
|
15
|
+
return LAYOUT_TYPE.Desktop;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { ADAPTIVE_BREAKPOINT } from '../constants/adaptive.js';
|
|
2
|
+
import { LAYOUT_TYPE } from '../types/index.js';
|
|
3
|
+
export function layoutTypeFromWidth(width, breakpoints) {
|
|
4
|
+
const mergedBreakpoints = { ...ADAPTIVE_BREAKPOINT, ...breakpoints };
|
|
5
|
+
if (width <= mergedBreakpoints.mobile) {
|
|
6
|
+
return LAYOUT_TYPE.Mobile;
|
|
7
|
+
}
|
|
8
|
+
if (width <= mergedBreakpoints.tablet) {
|
|
9
|
+
return LAYOUT_TYPE.Tablet;
|
|
10
|
+
}
|
|
11
|
+
if (width <= mergedBreakpoints.desktopSmall) {
|
|
12
|
+
return LAYOUT_TYPE.DesktopSmall;
|
|
13
|
+
}
|
|
14
|
+
return LAYOUT_TYPE.Desktop;
|
|
15
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
2
|
+
import { LayoutPresets } from '../types/presets.js';
|
|
3
|
+
/**
|
|
4
|
+
* Сливает несколько `LayoutPresets` в один пер-tier: для каждого тира ключи пропов объединяются
|
|
5
|
+
* поверхностным spread'ом, поздний аргумент побеждает (`undefined`-пресет пропускается). Вложенные
|
|
6
|
+
* объекты-значения пропов не мёржатся рекурсивно — поздний целиком перетирает ранний.
|
|
7
|
+
* Накладывает per-instance override (`layoutPresets`) поверх DS-пресетов компонента (`X_LAYOUT_PRESETS`).
|
|
8
|
+
*/
|
|
9
|
+
export declare function mergePresets<P>(...presets: (LayoutPresets<P> | undefined)[]): LayoutPresets<P>;
|
|
10
|
+
/** Аргументы {@link resolveByLayout}. */
|
|
11
|
+
export type ResolveByLayoutOptions<P extends object> = {
|
|
12
|
+
/** Текущая раскладка (`undefined` → desktop-baseline). */
|
|
13
|
+
layoutType: LayoutType | undefined;
|
|
14
|
+
/** Базовые desktop-дефолты. */
|
|
15
|
+
base: P;
|
|
16
|
+
/** Пресеты пер-tier (instance ⊕ DS, обычно через {@link mergePresets}). */
|
|
17
|
+
presets: LayoutPresets<P>;
|
|
18
|
+
/** Явно переданные пропы (= desktop-значения). */
|
|
19
|
+
explicit: Partial<P>;
|
|
20
|
+
};
|
|
21
|
+
/**
|
|
22
|
+
* Резолвит итоговые значения пропов по раскладке — desktop-first. Чистая функция.
|
|
23
|
+
*
|
|
24
|
+
* Приоритет ключа: `presets[layoutType]` (пресет раскладки, instance > DS) > `explicit` (явный проп) >
|
|
25
|
+
* `base` (desktop-дефолт). Перетирают только определённые (`!== undefined`) ключи. Пресет выше пропа,
|
|
26
|
+
* потому что перенесённый из desktop-макета проп = desktop-значение и не должен ломать mobile.
|
|
27
|
+
*/
|
|
28
|
+
export declare function resolveByLayout<P extends object>({ layoutType, base, presets, explicit, }: ResolveByLayoutOptions<P>): P;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { resolveLayoutType } from './resolveLayoutType.js';
|
|
2
|
+
/**
|
|
3
|
+
* Сливает несколько `LayoutPresets` в один пер-tier: для каждого тира ключи пропов объединяются
|
|
4
|
+
* поверхностным spread'ом, поздний аргумент побеждает (`undefined`-пресет пропускается). Вложенные
|
|
5
|
+
* объекты-значения пропов не мёржатся рекурсивно — поздний целиком перетирает ранний.
|
|
6
|
+
* Накладывает per-instance override (`layoutPresets`) поверх DS-пресетов компонента (`X_LAYOUT_PRESETS`).
|
|
7
|
+
*/
|
|
8
|
+
export function mergePresets(...presets) {
|
|
9
|
+
const result = {};
|
|
10
|
+
for (const preset of presets) {
|
|
11
|
+
if (!preset) {
|
|
12
|
+
continue;
|
|
13
|
+
}
|
|
14
|
+
for (const tier of Object.keys(preset)) {
|
|
15
|
+
result[tier] = { ...result[tier], ...preset[tier] };
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
return result;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Резолвит итоговые значения пропов по раскладке — desktop-first. Чистая функция.
|
|
22
|
+
*
|
|
23
|
+
* Приоритет ключа: `presets[layoutType]` (пресет раскладки, instance > DS) > `explicit` (явный проп) >
|
|
24
|
+
* `base` (desktop-дефолт). Перетирают только определённые (`!== undefined`) ключи. Пресет выше пропа,
|
|
25
|
+
* потому что перенесённый из desktop-макета проп = desktop-значение и не должен ломать mobile.
|
|
26
|
+
*/
|
|
27
|
+
export function resolveByLayout({ layoutType, base, presets, explicit, }) {
|
|
28
|
+
const preset = presets[resolveLayoutType(layoutType)] ?? {};
|
|
29
|
+
const result = { ...base };
|
|
30
|
+
// explicit поверх base…
|
|
31
|
+
for (const key of Object.keys(explicit)) {
|
|
32
|
+
const value = explicit[key];
|
|
33
|
+
if (value !== undefined) {
|
|
34
|
+
result[key] = value;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
// …а пресет раскладки поверх explicit (mobile-дефолт защищён от перенесённого desktop-пропа).
|
|
38
|
+
for (const key of Object.keys(preset)) {
|
|
39
|
+
const value = preset[key];
|
|
40
|
+
if (value !== undefined) {
|
|
41
|
+
result[key] = value;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return result;
|
|
45
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { LayoutType } from '../types/layoutTypes.js';
|
|
2
|
+
/**
|
|
3
|
+
* Нормализует опциональный `layoutType` к desktop-дефолту. Единая точка SSR-решения:
|
|
4
|
+
* на сервере и до mount, когда раскладка не передана, считаем desktop.
|
|
5
|
+
*/
|
|
6
|
+
export declare function resolveLayoutType(layoutType?: LayoutType): LayoutType;
|
|
7
|
+
/**
|
|
8
|
+
* Канон ветвления `Adaptive*`-обёрток: mobile-путь строго на `mobile`,
|
|
9
|
+
* tablet/desktopSmall/desktop → desktop-ветка.
|
|
10
|
+
*/
|
|
11
|
+
export declare function isMobileLayout(layoutType?: LayoutType): boolean;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { DEFAULT_LAYOUT_TYPE, LAYOUT_SPLIT_MOBILE_TIERS } from '../constants/adaptive.js';
|
|
2
|
+
/**
|
|
3
|
+
* Нормализует опциональный `layoutType` к desktop-дефолту. Единая точка SSR-решения:
|
|
4
|
+
* на сервере и до mount, когда раскладка не передана, считаем desktop.
|
|
5
|
+
*/
|
|
6
|
+
export function resolveLayoutType(layoutType) {
|
|
7
|
+
return layoutType ?? DEFAULT_LAYOUT_TYPE;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Канон ветвления `Adaptive*`-обёрток: mobile-путь строго на `mobile`,
|
|
11
|
+
* tablet/desktopSmall/desktop → desktop-ветка.
|
|
12
|
+
*/
|
|
13
|
+
export function isMobileLayout(layoutType) {
|
|
14
|
+
return LAYOUT_SPLIT_MOBILE_TIERS.mobileOnly.includes(resolveLayoutType(layoutType));
|
|
15
|
+
}
|