@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.
Files changed (192) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +201 -0
  3. package/README.md +195 -0
  4. package/dist/cjs/components/AdaptiveProvider/AdaptiveProvider.d.ts +15 -0
  5. package/dist/cjs/components/AdaptiveProvider/AdaptiveProvider.js +17 -0
  6. package/dist/cjs/components/AdaptiveProvider/index.d.ts +1 -0
  7. package/dist/cjs/components/AdaptiveProvider/index.js +17 -0
  8. package/dist/cjs/components/index.d.ts +2 -0
  9. package/dist/cjs/components/index.js +18 -0
  10. package/dist/cjs/components/withLayoutType/index.d.ts +1 -0
  11. package/dist/cjs/components/withLayoutType/index.js +17 -0
  12. package/dist/cjs/components/withLayoutType/withLayoutType.d.ts +14 -0
  13. package/dist/cjs/components/withLayoutType/withLayoutType.js +20 -0
  14. package/dist/cjs/constants/adaptive.d.ts +57 -0
  15. package/dist/cjs/constants/adaptive.js +61 -0
  16. package/dist/cjs/constants/index.d.ts +1 -0
  17. package/dist/cjs/constants/index.js +17 -0
  18. package/dist/cjs/context/adaptiveContext.d.ts +15 -0
  19. package/dist/cjs/context/adaptiveContext.js +15 -0
  20. package/dist/cjs/context/index.d.ts +2 -0
  21. package/dist/cjs/context/index.js +5 -0
  22. package/dist/cjs/hooks/index.d.ts +4 -0
  23. package/dist/cjs/hooks/index.js +20 -0
  24. package/dist/cjs/hooks/useAdaptiveBootstrap.d.ts +18 -0
  25. package/dist/cjs/hooks/useAdaptiveBootstrap.js +22 -0
  26. package/dist/cjs/hooks/useClientLayoutType.d.ts +10 -0
  27. package/dist/cjs/hooks/useClientLayoutType.js +35 -0
  28. package/dist/cjs/hooks/useLayoutDefaults.d.ts +14 -0
  29. package/dist/cjs/hooks/useLayoutDefaults.js +21 -0
  30. package/dist/cjs/hooks/useMatchMedia.d.ts +18 -0
  31. package/dist/cjs/hooks/useMatchMedia.js +42 -0
  32. package/dist/cjs/index.d.ts +7 -0
  33. package/dist/cjs/index.js +23 -0
  34. package/dist/cjs/keys.d.ts +4 -0
  35. package/dist/cjs/keys.js +19 -0
  36. package/dist/cjs/package.json +3 -0
  37. package/dist/cjs/ssr.d.ts +10 -0
  38. package/dist/cjs/ssr.js +32 -0
  39. package/dist/cjs/store/createAdaptiveStore.d.ts +22 -0
  40. package/dist/cjs/store/createAdaptiveStore.js +29 -0
  41. package/dist/cjs/store/globalStore.d.ts +20 -0
  42. package/dist/cjs/store/globalStore.js +43 -0
  43. package/dist/cjs/store/index.d.ts +2 -0
  44. package/dist/cjs/store/index.js +18 -0
  45. package/dist/cjs/types/adaptive.d.ts +6 -0
  46. package/dist/cjs/types/adaptive.js +2 -0
  47. package/dist/cjs/types/index.d.ts +3 -0
  48. package/dist/cjs/types/index.js +19 -0
  49. package/dist/cjs/types/layoutTypes.d.ts +13 -0
  50. package/dist/cjs/types/layoutTypes.js +10 -0
  51. package/dist/cjs/types/presets.d.ts +6 -0
  52. package/dist/cjs/types/presets.js +2 -0
  53. package/dist/cjs/types/valueOf.d.ts +2 -0
  54. package/dist/cjs/types/valueOf.js +2 -0
  55. package/dist/cjs/utils/getAdaptive.d.ts +15 -0
  56. package/dist/cjs/utils/getAdaptive.js +39 -0
  57. package/dist/cjs/utils/getLayoutBootstrapScript.d.ts +2 -0
  58. package/dist/cjs/utils/getLayoutBootstrapScript.js +9 -0
  59. package/dist/cjs/utils/getMatchMedia.d.ts +12 -0
  60. package/dist/cjs/utils/getMatchMedia.js +24 -0
  61. package/dist/cjs/utils/getSSRInitialLayoutType.d.ts +21 -0
  62. package/dist/cjs/utils/getSSRInitialLayoutType.js +32 -0
  63. package/dist/cjs/utils/getUserAgentInfo.d.ts +43 -0
  64. package/dist/cjs/utils/getUserAgentInfo.js +114 -0
  65. package/dist/cjs/utils/index.d.ts +6 -0
  66. package/dist/cjs/utils/index.js +22 -0
  67. package/dist/cjs/utils/isBrowser.d.ts +3 -0
  68. package/dist/cjs/utils/isBrowser.js +9 -0
  69. package/dist/cjs/utils/layoutTypeFromMatchMedia.d.ts +4 -0
  70. package/dist/cjs/utils/layoutTypeFromMatchMedia.js +18 -0
  71. package/dist/cjs/utils/layoutTypeFromUserAgent.d.ts +6 -0
  72. package/dist/cjs/utils/layoutTypeFromUserAgent.js +20 -0
  73. package/dist/cjs/utils/layoutTypeFromWidth.d.ts +3 -0
  74. package/dist/cjs/utils/layoutTypeFromWidth.js +18 -0
  75. package/dist/cjs/utils/resolveByLayout.d.ts +28 -0
  76. package/dist/cjs/utils/resolveByLayout.js +49 -0
  77. package/dist/cjs/utils/resolveLayoutType.d.ts +11 -0
  78. package/dist/cjs/utils/resolveLayoutType.js +19 -0
  79. package/dist/esm/components/AdaptiveProvider/AdaptiveProvider.d.ts +15 -0
  80. package/dist/esm/components/AdaptiveProvider/AdaptiveProvider.js +14 -0
  81. package/dist/esm/components/AdaptiveProvider/index.d.ts +1 -0
  82. package/dist/esm/components/AdaptiveProvider/index.js +1 -0
  83. package/dist/esm/components/index.d.ts +2 -0
  84. package/dist/esm/components/index.js +2 -0
  85. package/dist/esm/components/withLayoutType/index.d.ts +1 -0
  86. package/dist/esm/components/withLayoutType/index.js +1 -0
  87. package/dist/esm/components/withLayoutType/withLayoutType.d.ts +14 -0
  88. package/dist/esm/components/withLayoutType/withLayoutType.js +17 -0
  89. package/dist/esm/constants/adaptive.d.ts +57 -0
  90. package/dist/esm/constants/adaptive.js +57 -0
  91. package/dist/esm/constants/index.d.ts +1 -0
  92. package/dist/esm/constants/index.js +1 -0
  93. package/dist/esm/context/adaptiveContext.d.ts +15 -0
  94. package/dist/esm/context/adaptiveContext.js +11 -0
  95. package/dist/esm/context/index.d.ts +2 -0
  96. package/dist/esm/context/index.js +1 -0
  97. package/dist/esm/hooks/index.d.ts +4 -0
  98. package/dist/esm/hooks/index.js +4 -0
  99. package/dist/esm/hooks/useAdaptiveBootstrap.d.ts +18 -0
  100. package/dist/esm/hooks/useAdaptiveBootstrap.js +19 -0
  101. package/dist/esm/hooks/useClientLayoutType.d.ts +10 -0
  102. package/dist/esm/hooks/useClientLayoutType.js +32 -0
  103. package/dist/esm/hooks/useLayoutDefaults.d.ts +14 -0
  104. package/dist/esm/hooks/useLayoutDefaults.js +18 -0
  105. package/dist/esm/hooks/useMatchMedia.d.ts +18 -0
  106. package/dist/esm/hooks/useMatchMedia.js +37 -0
  107. package/dist/esm/index.d.ts +7 -0
  108. package/dist/esm/index.js +7 -0
  109. package/dist/esm/keys.d.ts +4 -0
  110. package/dist/esm/keys.js +16 -0
  111. package/dist/esm/ssr.d.ts +10 -0
  112. package/dist/esm/ssr.js +16 -0
  113. package/dist/esm/store/createAdaptiveStore.d.ts +22 -0
  114. package/dist/esm/store/createAdaptiveStore.js +26 -0
  115. package/dist/esm/store/globalStore.d.ts +20 -0
  116. package/dist/esm/store/globalStore.js +40 -0
  117. package/dist/esm/store/index.d.ts +2 -0
  118. package/dist/esm/store/index.js +2 -0
  119. package/dist/esm/types/adaptive.d.ts +6 -0
  120. package/dist/esm/types/adaptive.js +1 -0
  121. package/dist/esm/types/index.d.ts +3 -0
  122. package/dist/esm/types/index.js +3 -0
  123. package/dist/esm/types/layoutTypes.d.ts +13 -0
  124. package/dist/esm/types/layoutTypes.js +7 -0
  125. package/dist/esm/types/presets.d.ts +6 -0
  126. package/dist/esm/types/presets.js +1 -0
  127. package/dist/esm/types/valueOf.d.ts +2 -0
  128. package/dist/esm/types/valueOf.js +1 -0
  129. package/dist/esm/utils/getAdaptive.d.ts +15 -0
  130. package/dist/esm/utils/getAdaptive.js +36 -0
  131. package/dist/esm/utils/getLayoutBootstrapScript.d.ts +2 -0
  132. package/dist/esm/utils/getLayoutBootstrapScript.js +6 -0
  133. package/dist/esm/utils/getMatchMedia.d.ts +12 -0
  134. package/dist/esm/utils/getMatchMedia.js +18 -0
  135. package/dist/esm/utils/getSSRInitialLayoutType.d.ts +21 -0
  136. package/dist/esm/utils/getSSRInitialLayoutType.js +28 -0
  137. package/dist/esm/utils/getUserAgentInfo.d.ts +43 -0
  138. package/dist/esm/utils/getUserAgentInfo.js +110 -0
  139. package/dist/esm/utils/index.d.ts +6 -0
  140. package/dist/esm/utils/index.js +6 -0
  141. package/dist/esm/utils/isBrowser.d.ts +3 -0
  142. package/dist/esm/utils/isBrowser.js +6 -0
  143. package/dist/esm/utils/layoutTypeFromMatchMedia.d.ts +4 -0
  144. package/dist/esm/utils/layoutTypeFromMatchMedia.js +15 -0
  145. package/dist/esm/utils/layoutTypeFromUserAgent.d.ts +6 -0
  146. package/dist/esm/utils/layoutTypeFromUserAgent.js +17 -0
  147. package/dist/esm/utils/layoutTypeFromWidth.d.ts +3 -0
  148. package/dist/esm/utils/layoutTypeFromWidth.js +15 -0
  149. package/dist/esm/utils/resolveByLayout.d.ts +28 -0
  150. package/dist/esm/utils/resolveByLayout.js +45 -0
  151. package/dist/esm/utils/resolveLayoutType.d.ts +11 -0
  152. package/dist/esm/utils/resolveLayoutType.js +15 -0
  153. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  154. package/dist/tsconfig.esm.tsbuildinfo +1 -0
  155. package/package.json +45 -0
  156. package/src/components/AdaptiveProvider/AdaptiveProvider.tsx +28 -0
  157. package/src/components/AdaptiveProvider/index.ts +1 -0
  158. package/src/components/index.ts +2 -0
  159. package/src/components/withLayoutType/index.ts +1 -0
  160. package/src/components/withLayoutType/withLayoutType.tsx +26 -0
  161. package/src/constants/adaptive.ts +73 -0
  162. package/src/constants/index.ts +1 -0
  163. package/src/context/adaptiveContext.ts +27 -0
  164. package/src/context/index.ts +2 -0
  165. package/src/hooks/index.ts +4 -0
  166. package/src/hooks/useAdaptiveBootstrap.ts +38 -0
  167. package/src/hooks/useClientLayoutType.ts +51 -0
  168. package/src/hooks/useLayoutDefaults.ts +21 -0
  169. package/src/hooks/useMatchMedia.ts +52 -0
  170. package/src/index.ts +7 -0
  171. package/src/keys.ts +18 -0
  172. package/src/ssr.ts +16 -0
  173. package/src/store/createAdaptiveStore.ts +42 -0
  174. package/src/store/globalStore.ts +57 -0
  175. package/src/store/index.ts +2 -0
  176. package/src/types/adaptive.ts +8 -0
  177. package/src/types/index.ts +3 -0
  178. package/src/types/layoutTypes.ts +15 -0
  179. package/src/types/presets.ts +7 -0
  180. package/src/types/valueOf.ts +2 -0
  181. package/src/utils/getAdaptive.ts +46 -0
  182. package/src/utils/getLayoutBootstrapScript.ts +8 -0
  183. package/src/utils/getMatchMedia.ts +36 -0
  184. package/src/utils/getSSRInitialLayoutType.ts +50 -0
  185. package/src/utils/getUserAgentInfo.ts +145 -0
  186. package/src/utils/index.ts +6 -0
  187. package/src/utils/isBrowser.ts +6 -0
  188. package/src/utils/layoutTypeFromMatchMedia.ts +20 -0
  189. package/src/utils/layoutTypeFromUserAgent.ts +19 -0
  190. package/src/utils/layoutTypeFromWidth.ts +20 -0
  191. package/src/utils/resolveByLayout.ts +72 -0
  192. package/src/utils/resolveLayoutType.ts +18 -0
@@ -0,0 +1,145 @@
1
+ import { ValueOf } from '../types/valueOf';
2
+ import { isBrowser } from './isBrowser';
3
+
4
+ /** Тип устройства из user-agent. */
5
+ export const DEVICE_TYPE = {
6
+ Console: 'console',
7
+ Mobile: 'mobile',
8
+ Tablet: 'tablet',
9
+ Smarttv: 'smarttv',
10
+ Wearable: 'wearable',
11
+ Embedded: 'embedded',
12
+ Desktop: 'desktop',
13
+ } as const;
14
+
15
+ export type DeviceType = ValueOf<typeof DEVICE_TYPE>;
16
+
17
+ /** Операционная система из user-agent. Поля пустые, если UA не распознан. */
18
+ export type UserAgentOs = {
19
+ name?: string;
20
+ version?: string;
21
+ };
22
+
23
+ /** Браузер из user-agent. Поля пустые, если UA не распознан. */
24
+ export type UserAgentBrowser = {
25
+ name?: string;
26
+ version?: string;
27
+ /** Мажорная часть `version` — удобна для проверок вида «Safari младше 16». */
28
+ major?: string;
29
+ };
30
+
31
+ export type UserAgentInfo = {
32
+ device: {
33
+ model?: string;
34
+ type: DeviceType;
35
+ };
36
+ os: UserAgentOs;
37
+ browser: UserAgentBrowser;
38
+ };
39
+
40
+ const TV_PATTERN = /\b(?:SmartTV|SMART-TV|GoogleTV|AppleTV|HbbTV|NetCast|Web0S|webOS TV|BRAVIA|Roku|CrKey)\b/i;
41
+ const CONSOLE_PATTERN = /\b(?:Nintendo|PlayStation|Xbox)\b/i;
42
+ const WEARABLE_PATTERN = /\b(?:Watch|Wear OS|Glass)\b/i;
43
+ const TABLET_PATTERN = /\b(?:iPad|Tablet|PlayBook|Kindle|Silk)\b/i;
44
+ const MOBILE_PATTERN = /\b(?:iPhone|iPod|Windows Phone|IEMobile|BlackBerry|BB10|Opera Mini|Mobi)\b/i;
45
+
46
+ function detectDeviceType(userAgent: string): DeviceType {
47
+ if (TV_PATTERN.test(userAgent)) return DEVICE_TYPE.Smarttv;
48
+ if (CONSOLE_PATTERN.test(userAgent)) return DEVICE_TYPE.Console;
49
+ if (WEARABLE_PATTERN.test(userAgent)) return DEVICE_TYPE.Wearable;
50
+ if (TABLET_PATTERN.test(userAgent)) return DEVICE_TYPE.Tablet;
51
+ // Android без токена `Mobi` — планшет: так это размечает сам Android (WebView ставит `Mobile`
52
+ // только на телефонах).
53
+ if (/Android/i.test(userAgent)) return /Mobi/i.test(userAgent) ? DEVICE_TYPE.Mobile : DEVICE_TYPE.Tablet;
54
+ if (MOBILE_PATTERN.test(userAgent)) return DEVICE_TYPE.Mobile;
55
+
56
+ return DEVICE_TYPE.Desktop;
57
+ }
58
+
59
+ function detectModel(userAgent: string): string | undefined {
60
+ const apple = /\b(iPhone|iPad|iPod)\b/.exec(userAgent);
61
+ if (apple) return apple[1];
62
+
63
+ // Android держит модель в комментарии: `(Linux; Android 14; SM-S911B) ...` или `... Build/...`.
64
+ const android = /Android[^;)]*;\s*([^;)]+?)(?:\s+Build\/[^;)]*)?\s*[;)]/.exec(userAgent);
65
+
66
+ return android?.[1]?.trim() || undefined;
67
+ }
68
+
69
+ const WINDOWS_NT_NAMES: Record<string, string> = {
70
+ '10.0': '10',
71
+ '6.3': '8.1',
72
+ '6.2': '8',
73
+ '6.1': '7',
74
+ };
75
+
76
+ function detectOs(userAgent: string): UserAgentOs {
77
+ const ios = /\b(?:iPhone|iPad|iPod)\b.*?\bOS (\d+(?:[._]\d+)*)/.exec(userAgent);
78
+ if (ios) return { name: 'iOS', version: ios[1].replace(/_/g, '.') };
79
+
80
+ const android = /Android (\d+(?:\.\d+)*)/.exec(userAgent);
81
+ if (android) return { name: 'Android', version: android[1] };
82
+
83
+ const windows = /Windows NT (\d+\.\d+)/.exec(userAgent);
84
+ if (windows) return { name: 'Windows', version: WINDOWS_NT_NAMES[windows[1]] ?? windows[1] };
85
+
86
+ const macos = /Mac OS X (\d+(?:[._]\d+)*)/.exec(userAgent);
87
+ if (macos) return { name: 'macOS', version: macos[1].replace(/_/g, '.') };
88
+
89
+ if (/Macintosh/i.test(userAgent)) return { name: 'macOS' };
90
+ if (/Linux/i.test(userAgent)) return { name: 'Linux' };
91
+
92
+ return {};
93
+ }
94
+
95
+ // Порядок важен: Edge и Opera представляются Chrome'ом, Chrome — Safari.
96
+ const BROWSER_PATTERNS: { name: string; pattern: RegExp }[] = [
97
+ { name: 'Edge', pattern: /\bEdgi?[A-Za-z]*\/([\d.]+)/ },
98
+ { name: 'Opera', pattern: /\b(?:OPR|Opera)\/([\d.]+)/ },
99
+ { name: 'Yandex Browser', pattern: /\bYaBrowser\/([\d.]+)/ },
100
+ { name: 'Samsung Internet', pattern: /\bSamsungBrowser\/([\d.]+)/ },
101
+ { name: 'Firefox', pattern: /\b(?:Firefox|FxiOS)\/([\d.]+)/ },
102
+ { name: 'Chrome', pattern: /\b(?:Chrome|CriOS|Chromium)\/([\d.]+)/ },
103
+ { name: 'Safari', pattern: /\bVersion\/([\d.]+).*\bSafari\b/ },
104
+ ];
105
+
106
+ function detectBrowser(userAgent: string): UserAgentBrowser {
107
+ for (const { name, pattern } of BROWSER_PATTERNS) {
108
+ const match = pattern.exec(userAgent);
109
+
110
+ if (match) {
111
+ const version = match[1];
112
+
113
+ return { name, version, major: version.split('.')[0] };
114
+ }
115
+ }
116
+
117
+ return {};
118
+ }
119
+
120
+ /**
121
+ * Разбирает user-agent и возвращает тип устройства, ОС и браузер.
122
+ * Источник UA: аргумент `userAgent` (для SSR — заголовок запроса), иначе `navigator.userAgent`.
123
+ * На сервере без аргумента `device.type` нормализуется к `desktop`.
124
+ *
125
+ * Детектор целенаправленно узкий: он покрывает раскладку (`device.type` — единственное, что читает
126
+ * адаптив) и популярные браузеры/ОС. Для экзотических устройств `device.type` деградирует к
127
+ * `desktop`, а `os`/`browser` остаются пустыми — это осознанный размен на отсутствие внешней
128
+ * зависимости с базой UA.
129
+ */
130
+ export function getUserAgentInfo(userAgent?: string): UserAgentInfo {
131
+ const resolvedUserAgent = userAgent ?? (isBrowser() ? globalThis.navigator.userAgent : undefined);
132
+
133
+ if (!resolvedUserAgent) {
134
+ return { device: { type: DEVICE_TYPE.Desktop }, os: {}, browser: {} };
135
+ }
136
+
137
+ return {
138
+ device: {
139
+ model: detectModel(resolvedUserAgent),
140
+ type: detectDeviceType(resolvedUserAgent),
141
+ },
142
+ os: detectOs(resolvedUserAgent),
143
+ browser: detectBrowser(resolvedUserAgent),
144
+ };
145
+ }
@@ -0,0 +1,6 @@
1
+ export * from './getAdaptive';
2
+ export * from './getMatchMedia';
3
+ export * from './getUserAgentInfo';
4
+ export * from './layoutTypeFromMatchMedia';
5
+ export * from './resolveLayoutType';
6
+ export * from './resolveByLayout';
@@ -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,20 @@
1
+ import { ADAPTIVE_QUERY } from '../constants/adaptive';
2
+ import { AdaptiveQuery, MatchMediaGeneric } from '../types/adaptive';
3
+ import { LAYOUT_TYPE, LayoutType } from '../types/layoutTypes';
4
+
5
+ /** Каскад `layoutType` по adaptive media-query (без учёта user-agent). */
6
+ export function layoutTypeFromMatchMedia(matchMedia: MatchMediaGeneric<AdaptiveQuery>): LayoutType {
7
+ if (matchMedia[ADAPTIVE_QUERY.IsMobile]) {
8
+ return LAYOUT_TYPE.Mobile;
9
+ }
10
+
11
+ if (matchMedia[ADAPTIVE_QUERY.IsTablet]) {
12
+ return LAYOUT_TYPE.Tablet;
13
+ }
14
+
15
+ if (matchMedia[ADAPTIVE_QUERY.IsSmallDesktop]) {
16
+ return LAYOUT_TYPE.DesktopSmall;
17
+ }
18
+
19
+ return LAYOUT_TYPE.Desktop;
20
+ }
@@ -0,0 +1,19 @@
1
+ import { LAYOUT_TYPE, LayoutType } from '../types/layoutTypes';
2
+ import { DEVICE_TYPE, getUserAgentInfo } from './getUserAgentInfo';
3
+
4
+ /**
5
+ * Грубый `layoutType` по user-agent (три тира: mobile / tablet / desktop).
6
+ * Без ширины окна `desktopSmall` не выводится — для SSR-фолбэка, когда нет Client Hints.
7
+ */
8
+ export function layoutTypeFromUserAgent(userAgent: string): LayoutType {
9
+ const { device } = getUserAgentInfo(userAgent);
10
+
11
+ switch (device.type) {
12
+ case DEVICE_TYPE.Mobile:
13
+ return LAYOUT_TYPE.Mobile;
14
+ case DEVICE_TYPE.Tablet:
15
+ return LAYOUT_TYPE.Tablet;
16
+ default:
17
+ return LAYOUT_TYPE.Desktop;
18
+ }
19
+ }
@@ -0,0 +1,20 @@
1
+ import { ADAPTIVE_BREAKPOINT, AdaptiveBreakpoints } from '../constants/adaptive';
2
+ import { LAYOUT_TYPE, LayoutType } from '../types';
3
+
4
+ export function layoutTypeFromWidth(width: number, breakpoints?: AdaptiveBreakpoints): LayoutType {
5
+ const mergedBreakpoints = { ...ADAPTIVE_BREAKPOINT, ...breakpoints };
6
+
7
+ if (width <= mergedBreakpoints.mobile) {
8
+ return LAYOUT_TYPE.Mobile;
9
+ }
10
+
11
+ if (width <= mergedBreakpoints.tablet) {
12
+ return LAYOUT_TYPE.Tablet;
13
+ }
14
+
15
+ if (width <= mergedBreakpoints.desktopSmall) {
16
+ return LAYOUT_TYPE.DesktopSmall;
17
+ }
18
+
19
+ return LAYOUT_TYPE.Desktop;
20
+ }
@@ -0,0 +1,72 @@
1
+ import { LayoutType } from '../types/layoutTypes';
2
+ import { LayoutPresets } from '../types/presets';
3
+ import { resolveLayoutType } from './resolveLayoutType';
4
+
5
+ /**
6
+ * Сливает несколько `LayoutPresets` в один пер-tier: для каждого тира ключи пропов объединяются
7
+ * поверхностным spread'ом, поздний аргумент побеждает (`undefined`-пресет пропускается). Вложенные
8
+ * объекты-значения пропов не мёржатся рекурсивно — поздний целиком перетирает ранний.
9
+ * Накладывает per-instance override (`layoutPresets`) поверх DS-пресетов компонента (`X_LAYOUT_PRESETS`).
10
+ */
11
+ export function mergePresets<P>(...presets: (LayoutPresets<P> | undefined)[]): LayoutPresets<P> {
12
+ const result: LayoutPresets<P> = {};
13
+
14
+ for (const preset of presets) {
15
+ if (!preset) {
16
+ continue;
17
+ }
18
+
19
+ for (const tier of Object.keys(preset) as LayoutType[]) {
20
+ result[tier] = { ...result[tier], ...preset[tier] };
21
+ }
22
+ }
23
+
24
+ return result;
25
+ }
26
+
27
+ /** Аргументы {@link resolveByLayout}. */
28
+ export type ResolveByLayoutOptions<P extends object> = {
29
+ /** Текущая раскладка (`undefined` → desktop-baseline). */
30
+ layoutType: LayoutType | undefined;
31
+ /** Базовые desktop-дефолты. */
32
+ base: P;
33
+ /** Пресеты пер-tier (instance ⊕ DS, обычно через {@link mergePresets}). */
34
+ presets: LayoutPresets<P>;
35
+ /** Явно переданные пропы (= desktop-значения). */
36
+ explicit: Partial<P>;
37
+ };
38
+
39
+ /**
40
+ * Резолвит итоговые значения пропов по раскладке — desktop-first. Чистая функция.
41
+ *
42
+ * Приоритет ключа: `presets[layoutType]` (пресет раскладки, instance > DS) > `explicit` (явный проп) >
43
+ * `base` (desktop-дефолт). Перетирают только определённые (`!== undefined`) ключи. Пресет выше пропа,
44
+ * потому что перенесённый из desktop-макета проп = desktop-значение и не должен ломать mobile.
45
+ */
46
+ export function resolveByLayout<P extends object>({
47
+ layoutType,
48
+ base,
49
+ presets,
50
+ explicit,
51
+ }: ResolveByLayoutOptions<P>): P {
52
+ const preset: Partial<P> = presets[resolveLayoutType(layoutType)] ?? {};
53
+ const result = { ...base };
54
+
55
+ // explicit поверх base…
56
+ for (const key of Object.keys(explicit) as (keyof P)[]) {
57
+ const value = explicit[key];
58
+ if (value !== undefined) {
59
+ result[key] = value as P[keyof P];
60
+ }
61
+ }
62
+
63
+ // …а пресет раскладки поверх explicit (mobile-дефолт защищён от перенесённого desktop-пропа).
64
+ for (const key of Object.keys(preset) as (keyof P)[]) {
65
+ const value = preset[key];
66
+ if (value !== undefined) {
67
+ result[key] = value as P[keyof P];
68
+ }
69
+ }
70
+
71
+ return result;
72
+ }
@@ -0,0 +1,18 @@
1
+ import { DEFAULT_LAYOUT_TYPE, LAYOUT_SPLIT_MOBILE_TIERS } from '../constants/adaptive';
2
+ import { LayoutType } from '../types/layoutTypes';
3
+
4
+ /**
5
+ * Нормализует опциональный `layoutType` к desktop-дефолту. Единая точка SSR-решения:
6
+ * на сервере и до mount, когда раскладка не передана, считаем desktop.
7
+ */
8
+ export function resolveLayoutType(layoutType?: LayoutType): LayoutType {
9
+ return layoutType ?? DEFAULT_LAYOUT_TYPE;
10
+ }
11
+
12
+ /**
13
+ * Канон ветвления `Adaptive*`-обёрток: mobile-путь строго на `mobile`,
14
+ * tablet/desktopSmall/desktop → desktop-ветка.
15
+ */
16
+ export function isMobileLayout(layoutType?: LayoutType): boolean {
17
+ return (LAYOUT_SPLIT_MOBILE_TIERS.mobileOnly as readonly LayoutType[]).includes(resolveLayoutType(layoutType));
18
+ }