@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,61 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.LAYOUT_SPLIT_MOBILE_TIERS = exports.DEFAULT_LAYOUT_TYPE = exports.INITIAL_ADAPTIVE_QUERIES_VALUE = exports.ADAPTIVE_QUERIES = exports.ADAPTIVE_QUERY = exports.CSS_BREAKPOINTS = exports.ADAPTIVE_BREAKPOINT = void 0;
|
|
4
|
+
exports.buildAdaptiveQueries = buildAdaptiveQueries;
|
|
5
|
+
const layoutTypes_1 = require("../types/layoutTypes");
|
|
6
|
+
/** Брейкпоинты adaptive-раскладки (max-width в px), по которым `useAdaptiveBootstrap` выбирает `layoutType`. */
|
|
7
|
+
exports.ADAPTIVE_BREAKPOINT = {
|
|
8
|
+
mobile: 767,
|
|
9
|
+
tablet: 1023,
|
|
10
|
+
desktopSmall: 1279,
|
|
11
|
+
desktop: 1439,
|
|
12
|
+
};
|
|
13
|
+
/** CSS media-query строки, собранные из `ADAPTIVE_BREAKPOINT`. */
|
|
14
|
+
exports.CSS_BREAKPOINTS = {
|
|
15
|
+
mobile: `(max-width: ${exports.ADAPTIVE_BREAKPOINT.mobile}px)`,
|
|
16
|
+
tablet: `(max-width: ${exports.ADAPTIVE_BREAKPOINT.tablet}px)`,
|
|
17
|
+
desktopSmall: `(max-width: ${exports.ADAPTIVE_BREAKPOINT.desktopSmall}px)`,
|
|
18
|
+
desktop: `(max-width: ${exports.ADAPTIVE_BREAKPOINT.desktop}px)`,
|
|
19
|
+
large: `(min-width: ${exports.ADAPTIVE_BREAKPOINT.desktop + 1}px)`,
|
|
20
|
+
};
|
|
21
|
+
/** Ключи media-query, отслеживаемых `useAdaptiveMatchMedia`. */
|
|
22
|
+
exports.ADAPTIVE_QUERY = {
|
|
23
|
+
IsMobile: 'isMobile',
|
|
24
|
+
IsTablet: 'isTablet',
|
|
25
|
+
IsSmallDesktop: 'isSmallDesktop',
|
|
26
|
+
IsDesktop: 'isDesktop',
|
|
27
|
+
IsLarge: 'isLarge',
|
|
28
|
+
};
|
|
29
|
+
/** Карта `query-key → media-query строка` для подписки. */
|
|
30
|
+
exports.ADAPTIVE_QUERIES = {
|
|
31
|
+
[exports.ADAPTIVE_QUERY.IsMobile]: exports.CSS_BREAKPOINTS.mobile,
|
|
32
|
+
[exports.ADAPTIVE_QUERY.IsTablet]: exports.CSS_BREAKPOINTS.tablet,
|
|
33
|
+
[exports.ADAPTIVE_QUERY.IsSmallDesktop]: exports.CSS_BREAKPOINTS.desktopSmall,
|
|
34
|
+
[exports.ADAPTIVE_QUERY.IsDesktop]: exports.CSS_BREAKPOINTS.desktop,
|
|
35
|
+
[exports.ADAPTIVE_QUERY.IsLarge]: exports.CSS_BREAKPOINTS.large,
|
|
36
|
+
};
|
|
37
|
+
/** Собирает карту adaptive media-query из произвольных брейкпоинтов — для per-app override. */
|
|
38
|
+
function buildAdaptiveQueries(breakpoints) {
|
|
39
|
+
return {
|
|
40
|
+
[exports.ADAPTIVE_QUERY.IsMobile]: `(max-width: ${breakpoints.mobile}px)`,
|
|
41
|
+
[exports.ADAPTIVE_QUERY.IsTablet]: `(max-width: ${breakpoints.tablet}px)`,
|
|
42
|
+
[exports.ADAPTIVE_QUERY.IsSmallDesktop]: `(max-width: ${breakpoints.desktopSmall}px)`,
|
|
43
|
+
[exports.ADAPTIVE_QUERY.IsDesktop]: `(max-width: ${breakpoints.desktop}px)`,
|
|
44
|
+
[exports.ADAPTIVE_QUERY.IsLarge]: `(min-width: ${breakpoints.desktop + 1}px)`,
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
/** SSR-safe начальные значения (на сервере ни один media-query не матчится). */
|
|
48
|
+
exports.INITIAL_ADAPTIVE_QUERIES_VALUE = {
|
|
49
|
+
[exports.ADAPTIVE_QUERY.IsMobile]: false,
|
|
50
|
+
[exports.ADAPTIVE_QUERY.IsTablet]: false,
|
|
51
|
+
[exports.ADAPTIVE_QUERY.IsSmallDesktop]: false,
|
|
52
|
+
[exports.ADAPTIVE_QUERY.IsDesktop]: false,
|
|
53
|
+
[exports.ADAPTIVE_QUERY.IsLarge]: false,
|
|
54
|
+
};
|
|
55
|
+
/** SSR-baseline раскладки адаптивных компонентов: на сервере и до mount — desktop. */
|
|
56
|
+
exports.DEFAULT_LAYOUT_TYPE = layoutTypes_1.LAYOUT_TYPE.Desktop;
|
|
57
|
+
/** Наборы `layoutType`, уходящие по mobile-ветке surface-swap. Один источник для runtime, stories и docs. */
|
|
58
|
+
exports.LAYOUT_SPLIT_MOBILE_TIERS = {
|
|
59
|
+
/** Только phone уходит в mobile-ветку. */
|
|
60
|
+
mobileOnly: [layoutTypes_1.LAYOUT_TYPE.Mobile],
|
|
61
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from './adaptive';
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
__exportStar(require("./adaptive"), exports);
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { ExternalStore } from '@cloud-ru/ds-context-kit';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes';
|
|
3
|
+
/** Значение adaptive-контекста: текущая раскладка. */
|
|
4
|
+
export type AdaptiveContextValue = {
|
|
5
|
+
layoutType: LayoutType;
|
|
6
|
+
};
|
|
7
|
+
/** Внешний стор раскладки (формат `useSyncExternalStore`). Адаптер над любым реактивным источником — см. `createAdaptiveStore`. */
|
|
8
|
+
export type AdaptiveStore = ExternalStore<AdaptiveContextValue>;
|
|
9
|
+
declare const StoreProvider: ({ store, children }: {
|
|
10
|
+
store: ExternalStore<AdaptiveContextValue>;
|
|
11
|
+
children: import("react").ReactNode;
|
|
12
|
+
}) => import("react/jsx-runtime").JSX.Element;
|
|
13
|
+
export { StoreProvider as AdaptiveStoreProvider };
|
|
14
|
+
/** Возвращает текущую раскладку из `AdaptiveProvider`. Реактивно к внешнему стору, если он задан. */
|
|
15
|
+
export declare function useAdaptiveLayout(): AdaptiveContextValue;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.AdaptiveStoreProvider = void 0;
|
|
4
|
+
exports.useAdaptiveLayout = useAdaptiveLayout;
|
|
5
|
+
const context_kit_1 = require("@cloud-ru/ds-context-kit");
|
|
6
|
+
const keys_1 = require("../keys");
|
|
7
|
+
const globalStore_1 = require("../store/globalStore");
|
|
8
|
+
// Дефолт контекста = глобальный singleton-стор: потребитель без `AdaptiveProvider` в своём дереве
|
|
9
|
+
// читает раскладку, выставленную шеллом в `getGlobalAdaptiveStore`. Явный `<AdaptiveProvider>` затеняет дефолт.
|
|
10
|
+
const { StoreProvider, useStoreValue } = (0, context_kit_1.createSharedStoreContext)(keys_1.ADAPTIVE_KEYS.context, (0, globalStore_1.getGlobalAdaptiveStore)().store);
|
|
11
|
+
exports.AdaptiveStoreProvider = StoreProvider;
|
|
12
|
+
/** Возвращает текущую раскладку из `AdaptiveProvider`. Реактивно к внешнему стору, если он задан. */
|
|
13
|
+
function useAdaptiveLayout() {
|
|
14
|
+
return useStoreValue();
|
|
15
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.useAdaptiveLayout = void 0;
|
|
4
|
+
var adaptiveContext_1 = require("./adaptiveContext");
|
|
5
|
+
Object.defineProperty(exports, "useAdaptiveLayout", { enumerable: true, get: function () { return adaptiveContext_1.useAdaptiveLayout; } });
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
__exportStar(require("./useAdaptiveBootstrap"), exports);
|
|
18
|
+
__exportStar(require("./useLayoutDefaults"), exports);
|
|
19
|
+
__exportStar(require("./useClientLayoutType"), exports);
|
|
20
|
+
__exportStar(require("./useMatchMedia"), exports);
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { AdaptiveBreakpoints } from '../constants/adaptive';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes';
|
|
3
|
+
export type UseAdaptiveBootstrapOptions = {
|
|
4
|
+
/** Переопределение брейкпоинтов (max-width в px), напр. `{ mobile: 480 }`. Меняет только пороги, набор тиров прежний. */
|
|
5
|
+
breakpoints?: Partial<AdaptiveBreakpoints>;
|
|
6
|
+
/** User-agent для SSR (на клиенте берётся из `navigator`). См. `getAdaptive`. */
|
|
7
|
+
userAgent?: string;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* Возвращает текущий `layoutType` по типу устройства из user-agent + media-query. SSR-safe: до mount `desktop`.
|
|
11
|
+
* Вызывается один раз в корне приложения, результат передаётся в `<AdaptiveProvider layoutType={...}>`.
|
|
12
|
+
* Не путать с `useAdaptiveLayout` — тем читают уже посчитанную раскладку из контекста внутри компонентов.
|
|
13
|
+
* Для per-app порогов передайте `breakpoints` (мемоизировать объект не нужно).
|
|
14
|
+
* @function React hook
|
|
15
|
+
*/
|
|
16
|
+
export declare function useAdaptiveBootstrap(options?: UseAdaptiveBootstrapOptions): {
|
|
17
|
+
layoutType: LayoutType;
|
|
18
|
+
};
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.useAdaptiveBootstrap = useAdaptiveBootstrap;
|
|
4
|
+
const react_1 = require("react");
|
|
5
|
+
const adaptive_1 = require("../constants/adaptive");
|
|
6
|
+
const getAdaptive_1 = require("../utils/getAdaptive");
|
|
7
|
+
const useMatchMedia_1 = require("./useMatchMedia");
|
|
8
|
+
/**
|
|
9
|
+
* Возвращает текущий `layoutType` по типу устройства из user-agent + media-query. SSR-safe: до mount `desktop`.
|
|
10
|
+
* Вызывается один раз в корне приложения, результат передаётся в `<AdaptiveProvider layoutType={...}>`.
|
|
11
|
+
* Не путать с `useAdaptiveLayout` — тем читают уже посчитанную раскладку из контекста внутри компонентов.
|
|
12
|
+
* Для per-app порогов передайте `breakpoints` (мемоизировать объект не нужно).
|
|
13
|
+
* @function React hook
|
|
14
|
+
*/
|
|
15
|
+
function useAdaptiveBootstrap(options) {
|
|
16
|
+
const { breakpoints, userAgent } = options ?? {};
|
|
17
|
+
const queryValues = (0, react_1.useMemo)(() => (breakpoints ? (0, adaptive_1.buildAdaptiveQueries)({ ...adaptive_1.ADAPTIVE_BREAKPOINT, ...breakpoints }) : adaptive_1.ADAPTIVE_QUERIES),
|
|
18
|
+
// Зависим от значений брейкпоинтов, а не от ссылки объекта — иначе инлайн-`{ mobile: 480 }` переподписывает matchMedia.
|
|
19
|
+
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
20
|
+
[breakpoints?.mobile, breakpoints?.tablet, breakpoints?.desktopSmall, breakpoints?.desktop]);
|
|
21
|
+
return (0, getAdaptive_1.getAdaptive)((0, useMatchMedia_1.useAdaptiveMatchMedia)(queryValues), userAgent);
|
|
22
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { AdaptiveBreakpoints } from '../constants/adaptive';
|
|
2
|
+
import { LayoutType } from '../types';
|
|
3
|
+
/**
|
|
4
|
+
* Раскладка с коррекцией ДО первой отрисовки. Старт — `initialLayoutType` с сервера (Client Hints
|
|
5
|
+
* → точная ширина на Chromium; иначе desktop), поэтому первый клиентский рендер совпадает с SSR
|
|
6
|
+
* (чистая гидратация). Уточнение по media-query — в `useLayoutEffect` (синхронно перед paint), а не
|
|
7
|
+
* в `useEffect`: на узком окне в FF/Safari переключение происходит до отрисовки, без видимого прыжка.
|
|
8
|
+
* `<html data-layout-type>` держим синхронизированным для адаптивного CSS (его же ставит pre-paint скрипт).
|
|
9
|
+
*/
|
|
10
|
+
export declare function useClientLayoutType(initialLayoutType: LayoutType, breakpoints?: AdaptiveBreakpoints): LayoutType;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.useClientLayoutType = useClientLayoutType;
|
|
4
|
+
const utils_1 = require("@cloud-ru/ds-utils");
|
|
5
|
+
const react_1 = require("react");
|
|
6
|
+
const adaptive_1 = require("../constants/adaptive");
|
|
7
|
+
const getMatchMedia_1 = require("../utils/getMatchMedia");
|
|
8
|
+
const layoutTypeFromMatchMedia_1 = require("../utils/layoutTypeFromMatchMedia");
|
|
9
|
+
/**
|
|
10
|
+
* Раскладка с коррекцией ДО первой отрисовки. Старт — `initialLayoutType` с сервера (Client Hints
|
|
11
|
+
* → точная ширина на Chromium; иначе desktop), поэтому первый клиентский рендер совпадает с SSR
|
|
12
|
+
* (чистая гидратация). Уточнение по media-query — в `useLayoutEffect` (синхронно перед paint), а не
|
|
13
|
+
* в `useEffect`: на узком окне в FF/Safari переключение происходит до отрисовки, без видимого прыжка.
|
|
14
|
+
* `<html data-layout-type>` держим синхронизированным для адаптивного CSS (его же ставит pre-paint скрипт).
|
|
15
|
+
*/
|
|
16
|
+
function useClientLayoutType(initialLayoutType, breakpoints) {
|
|
17
|
+
const [layoutType, setLayoutType] = (0, react_1.useState)(initialLayoutType);
|
|
18
|
+
const queryValues = (0, react_1.useMemo)(() => (breakpoints ? (0, adaptive_1.buildAdaptiveQueries)({ ...adaptive_1.ADAPTIVE_BREAKPOINT, ...breakpoints }) : adaptive_1.ADAPTIVE_QUERIES),
|
|
19
|
+
// Зависим от значений брейкпоинтов, а не от ссылки объекта — иначе инлайн-override переподписывает matchMedia.
|
|
20
|
+
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
21
|
+
[breakpoints?.mobile, breakpoints?.tablet, breakpoints?.desktopSmall, breakpoints?.desktop]);
|
|
22
|
+
(0, utils_1.useLayoutEffect)(() => {
|
|
23
|
+
const apply = () => {
|
|
24
|
+
const next = (0, layoutTypeFromMatchMedia_1.layoutTypeFromMatchMedia)((0, getMatchMedia_1.getMatchMediaGeneric)({ queryValues, initialValues: adaptive_1.INITIAL_ADAPTIVE_QUERIES_VALUE }));
|
|
25
|
+
document.documentElement.dataset.layoutType = next;
|
|
26
|
+
setLayoutType(next);
|
|
27
|
+
};
|
|
28
|
+
apply();
|
|
29
|
+
const handler = () => apply();
|
|
30
|
+
const mediaQueryList = (0, getMatchMedia_1.getMediaQueryListGeneric)({ queryValues });
|
|
31
|
+
mediaQueryList.forEach(([, mql]) => mql.addEventListener('change', handler));
|
|
32
|
+
return () => mediaQueryList.forEach(([, mql]) => mql.removeEventListener('change', handler));
|
|
33
|
+
}, [queryValues]);
|
|
34
|
+
return layoutType;
|
|
35
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { LayoutPresets } from '../types/presets';
|
|
2
|
+
/**
|
|
3
|
+
* React-хук preset-класса адаптивности: резолвит дефолты пропов по раскладке из `AdaptiveProvider`.
|
|
4
|
+
* desktop-first приоритет: пресет раскладки (instance > DS) > явный проп инстанса > базовый дефолт.
|
|
5
|
+
* Preset-участвующие пропы передавай в `explicit` без destructure-дефолта.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* const { collapsible } = useLayoutDefaults(
|
|
9
|
+
* { collapsible: false }, // база (desktop)
|
|
10
|
+
* mergePresets(ALERT_TOP_LAYOUT_PRESETS, layoutPresets), // DS-пресет ⊕ instance-override
|
|
11
|
+
* { collapsible }, // явный проп инстанса = desktop-значение (может быть undefined)
|
|
12
|
+
* );
|
|
13
|
+
*/
|
|
14
|
+
export declare function useLayoutDefaults<P extends object>(base: P, presets: LayoutPresets<P>, explicit: Partial<P>): P;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.useLayoutDefaults = useLayoutDefaults;
|
|
4
|
+
const adaptiveContext_1 = require("../context/adaptiveContext");
|
|
5
|
+
const resolveByLayout_1 = require("../utils/resolveByLayout");
|
|
6
|
+
/**
|
|
7
|
+
* React-хук preset-класса адаптивности: резолвит дефолты пропов по раскладке из `AdaptiveProvider`.
|
|
8
|
+
* desktop-first приоритет: пресет раскладки (instance > DS) > явный проп инстанса > базовый дефолт.
|
|
9
|
+
* Preset-участвующие пропы передавай в `explicit` без destructure-дефолта.
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* const { collapsible } = useLayoutDefaults(
|
|
13
|
+
* { collapsible: false }, // база (desktop)
|
|
14
|
+
* mergePresets(ALERT_TOP_LAYOUT_PRESETS, layoutPresets), // DS-пресет ⊕ instance-override
|
|
15
|
+
* { collapsible }, // явный проп инстанса = desktop-значение (может быть undefined)
|
|
16
|
+
* );
|
|
17
|
+
*/
|
|
18
|
+
function useLayoutDefaults(base, presets, explicit) {
|
|
19
|
+
const { layoutType } = (0, adaptiveContext_1.useAdaptiveLayout)();
|
|
20
|
+
return (0, resolveByLayout_1.resolveByLayout)({ layoutType, base, presets, explicit });
|
|
21
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { AdaptiveQuery, MatchMediaGeneric } from '../types/adaptive';
|
|
2
|
+
/**
|
|
3
|
+
* Подписывается на набор media-query и возвращает их состояние (`query-key → matched?`).
|
|
4
|
+
* SSR-safe: первый рендер — и на сервере, и при гидрации на клиенте — берёт `initialValues`, что
|
|
5
|
+
* совпадает с серверным HTML и не даёт hydration mismatch. Реальное состояние media-query читается
|
|
6
|
+
* уже после mount в `useLayoutEffect` (синхронно, до paint — без видимого скачка), там же — подписка
|
|
7
|
+
* на `change`.
|
|
8
|
+
* @function React hook
|
|
9
|
+
*/
|
|
10
|
+
export declare const useMatchMediaGeneric: <T extends string>({ queryValues, initialValues, }: {
|
|
11
|
+
queryValues: Record<T, string>;
|
|
12
|
+
initialValues: MatchMediaGeneric<T>;
|
|
13
|
+
}) => MatchMediaGeneric<T>;
|
|
14
|
+
/**
|
|
15
|
+
* Состояние adaptive media-query (`isMobile` / `isTablet` / …). По умолчанию — дефолтные брейкпоинты DS.
|
|
16
|
+
* Для per-app override передайте свою карту запросов; она должна быть стабильной по ссылке.
|
|
17
|
+
*/
|
|
18
|
+
export declare function useAdaptiveMatchMedia(queryValues?: Record<AdaptiveQuery, string>): MatchMediaGeneric<AdaptiveQuery>;
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.useMatchMediaGeneric = void 0;
|
|
4
|
+
exports.useAdaptiveMatchMedia = useAdaptiveMatchMedia;
|
|
5
|
+
const utils_1 = require("@cloud-ru/ds-utils");
|
|
6
|
+
const react_1 = require("react");
|
|
7
|
+
const adaptive_1 = require("../constants/adaptive");
|
|
8
|
+
const getMatchMedia_1 = require("../utils/getMatchMedia");
|
|
9
|
+
/**
|
|
10
|
+
* Подписывается на набор media-query и возвращает их состояние (`query-key → matched?`).
|
|
11
|
+
* SSR-safe: первый рендер — и на сервере, и при гидрации на клиенте — берёт `initialValues`, что
|
|
12
|
+
* совпадает с серверным HTML и не даёт hydration mismatch. Реальное состояние media-query читается
|
|
13
|
+
* уже после mount в `useLayoutEffect` (синхронно, до paint — без видимого скачка), там же — подписка
|
|
14
|
+
* на `change`.
|
|
15
|
+
* @function React hook
|
|
16
|
+
*/
|
|
17
|
+
const useMatchMediaGeneric = ({ queryValues, initialValues, }) => {
|
|
18
|
+
const [value, setValue] = (0, react_1.useState)(initialValues);
|
|
19
|
+
(0, utils_1.useLayoutEffect)(() => {
|
|
20
|
+
const read = () => (0, getMatchMedia_1.getMatchMediaGeneric)({ queryValues, initialValues });
|
|
21
|
+
// Синхронизируемся с реальным matchMedia на клиенте — устраняем рассинхрон с SSR-initialValues.
|
|
22
|
+
setValue(read());
|
|
23
|
+
const handler = () => setValue(read());
|
|
24
|
+
const mediaQueryList = (0, getMatchMedia_1.getMediaQueryListGeneric)({ queryValues });
|
|
25
|
+
mediaQueryList.forEach(([, mql]) => mql.addEventListener('change', handler));
|
|
26
|
+
return () => mediaQueryList.forEach(([, mql]) => mql.removeEventListener('change', handler));
|
|
27
|
+
// queryValues/initialValues стабильны по ссылке (useAdaptiveBootstrap мемоизирует queryValues); смена
|
|
28
|
+
// breakpoints на лету пере-подписывает на новые media-query.
|
|
29
|
+
}, [queryValues, initialValues]);
|
|
30
|
+
return value;
|
|
31
|
+
};
|
|
32
|
+
exports.useMatchMediaGeneric = useMatchMediaGeneric;
|
|
33
|
+
/**
|
|
34
|
+
* Состояние adaptive media-query (`isMobile` / `isTablet` / …). По умолчанию — дефолтные брейкпоинты DS.
|
|
35
|
+
* Для per-app override передайте свою карту запросов; она должна быть стабильной по ссылке.
|
|
36
|
+
*/
|
|
37
|
+
function useAdaptiveMatchMedia(queryValues = adaptive_1.ADAPTIVE_QUERIES) {
|
|
38
|
+
return (0, exports.useMatchMediaGeneric)({
|
|
39
|
+
queryValues,
|
|
40
|
+
initialValues: adaptive_1.INITIAL_ADAPTIVE_QUERIES_VALUE,
|
|
41
|
+
});
|
|
42
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
__exportStar(require("./components"), exports);
|
|
18
|
+
__exportStar(require("./context"), exports);
|
|
19
|
+
__exportStar(require("./store"), exports);
|
|
20
|
+
__exportStar(require("./hooks"), exports);
|
|
21
|
+
__exportStar(require("./utils"), exports);
|
|
22
|
+
__exportStar(require("./types"), exports);
|
|
23
|
+
__exportStar(require("./constants"), exports);
|
package/dist/cjs/keys.js
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ADAPTIVE_KEYS = void 0;
|
|
4
|
+
const context_kit_1 = require("@cloud-ru/ds-context-kit");
|
|
5
|
+
/**
|
|
6
|
+
* `Symbol.for`-ключи домена adaptive — обе системы синглтонов в одном месте:
|
|
7
|
+
* - `context` — объект React-контекста (через `providerKey` → есть dev-warn о смешанных версиях);
|
|
8
|
+
* - `store` — глобальный мутабельный стор раскладки (кросс-root мост хост→MFE).
|
|
9
|
+
*
|
|
10
|
+
* Одна контракт-версия на домен повышается ТОЛЬКО при несовместимом сломе формы значения и двигает
|
|
11
|
+
* ОБА ключа вместе — забыть половину нельзя. Ортогонально мажору ПАКЕТА (разные мажоры делят ключ,
|
|
12
|
+
* пока shape аддитивен). Строки менять НЕЛЬЗЯ — это форк синглтона (случайный `:v2`). См.
|
|
13
|
+
* providers-standard.md.
|
|
14
|
+
*/
|
|
15
|
+
const CONTRACT_VERSION = 1;
|
|
16
|
+
exports.ADAPTIVE_KEYS = {
|
|
17
|
+
context: (0, context_kit_1.providerKey)('adaptive-context', CONTRACT_VERSION),
|
|
18
|
+
store: `@cloud-ru/ds:global-adaptive-store:v${CONTRACT_VERSION}`,
|
|
19
|
+
};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export * from './constants/adaptive';
|
|
2
|
+
export * from './types/layoutTypes';
|
|
3
|
+
export * from './types/presets';
|
|
4
|
+
export * from './utils/getAdaptive';
|
|
5
|
+
export * from './utils/getLayoutBootstrapScript';
|
|
6
|
+
export * from './utils/getSSRInitialLayoutType';
|
|
7
|
+
export * from './utils/getUserAgentInfo';
|
|
8
|
+
export * from './utils/layoutTypeFromUserAgent';
|
|
9
|
+
export * from './utils/resolveByLayout';
|
|
10
|
+
export * from './utils/resolveLayoutType';
|
package/dist/cjs/ssr.js
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
// Server-safe подмножество публичного API @cloud-ru/ds-adaptive: чистые функции и константы адаптива БЕЗ
|
|
18
|
+
// React-импортов. Барель `@cloud-ru/ds-adaptive` (src/index.ts) реэкспортит хуки и контексты
|
|
19
|
+
// (`createContext`/`useEffect`), поэтому его нельзя импортировать в React Server Component (Next App
|
|
20
|
+
// Router завершается с ошибкой «needs use client»). Этот вход безопасно импортировать на сервере —
|
|
21
|
+
// например, чтобы вычислить `layoutType` из request User-Agent в `layout.tsx`
|
|
22
|
+
// (`getSSRInitialLayoutType({ viewportWidth, userAgent })` + `getLayoutBootstrapScript()`).
|
|
23
|
+
__exportStar(require("./constants/adaptive"), exports);
|
|
24
|
+
__exportStar(require("./types/layoutTypes"), exports);
|
|
25
|
+
__exportStar(require("./types/presets"), exports);
|
|
26
|
+
__exportStar(require("./utils/getAdaptive"), exports);
|
|
27
|
+
__exportStar(require("./utils/getLayoutBootstrapScript"), exports);
|
|
28
|
+
__exportStar(require("./utils/getSSRInitialLayoutType"), exports);
|
|
29
|
+
__exportStar(require("./utils/getUserAgentInfo"), exports);
|
|
30
|
+
__exportStar(require("./utils/layoutTypeFromUserAgent"), exports);
|
|
31
|
+
__exportStar(require("./utils/resolveByLayout"), exports);
|
|
32
|
+
__exportStar(require("./utils/resolveLayoutType"), exports);
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { AdaptiveStore } from '../context/adaptiveContext';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes';
|
|
3
|
+
export type CreateAdaptiveStoreOptions = {
|
|
4
|
+
/** Текущая раскладка из внешнего источника. */
|
|
5
|
+
getLayoutType(): LayoutType;
|
|
6
|
+
/** Подписка на изменения внешнего источника; возвращает функцию отписки. */
|
|
7
|
+
subscribe(onChange: () => void): () => void;
|
|
8
|
+
/** Раскладка для SSR (request-scoped). Нужен только при server-render; в чистом CSR — нет. */
|
|
9
|
+
getServerLayoutType?(): LayoutType;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Адаптер внешнего реактивного источника раскладки (redux / zustand / signals / observable) в
|
|
13
|
+
* `AdaptiveStore` (формат `useSyncExternalStore`) для `<AdaptiveProvider store={...} />`.
|
|
14
|
+
* Кэширует snapshot по `layoutType` ради стабильной ссылки.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* const adaptiveStore = createAdaptiveStore({
|
|
18
|
+
* getLayoutType: () => layoutSource.current,
|
|
19
|
+
* subscribe: (onChange) => layoutSource.on('change', onChange),
|
|
20
|
+
* });
|
|
21
|
+
*/
|
|
22
|
+
export declare function createAdaptiveStore(options: CreateAdaptiveStoreOptions): AdaptiveStore;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createAdaptiveStore = createAdaptiveStore;
|
|
4
|
+
/**
|
|
5
|
+
* Адаптер внешнего реактивного источника раскладки (redux / zustand / signals / observable) в
|
|
6
|
+
* `AdaptiveStore` (формат `useSyncExternalStore`) для `<AdaptiveProvider store={...} />`.
|
|
7
|
+
* Кэширует snapshot по `layoutType` ради стабильной ссылки.
|
|
8
|
+
*
|
|
9
|
+
* @example
|
|
10
|
+
* const adaptiveStore = createAdaptiveStore({
|
|
11
|
+
* getLayoutType: () => layoutSource.current,
|
|
12
|
+
* subscribe: (onChange) => layoutSource.on('change', onChange),
|
|
13
|
+
* });
|
|
14
|
+
*/
|
|
15
|
+
function createAdaptiveStore(options) {
|
|
16
|
+
let cache;
|
|
17
|
+
const read = (layoutType) => {
|
|
18
|
+
if (!cache || cache.layoutType !== layoutType) {
|
|
19
|
+
cache = { layoutType };
|
|
20
|
+
}
|
|
21
|
+
return cache;
|
|
22
|
+
};
|
|
23
|
+
const { getServerLayoutType } = options;
|
|
24
|
+
return {
|
|
25
|
+
subscribe: options.subscribe,
|
|
26
|
+
getSnapshot: () => read(options.getLayoutType()),
|
|
27
|
+
getServerSnapshot: getServerLayoutType ? () => read(getServerLayoutType()) : undefined,
|
|
28
|
+
};
|
|
29
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { AdaptiveStore } from '../context/adaptiveContext';
|
|
2
|
+
import { LayoutType } from '../types/layoutTypes';
|
|
3
|
+
export type GlobalAdaptiveStore = {
|
|
4
|
+
/** Стор для `<AdaptiveProvider store={...} />`. */
|
|
5
|
+
store: AdaptiveStore;
|
|
6
|
+
/** Текущая раскладка. */
|
|
7
|
+
getLayoutType(): LayoutType;
|
|
8
|
+
/** Установить раскладку и уведомить все подписанные `AdaptiveProvider`. */
|
|
9
|
+
setLayoutType(layoutType: LayoutType): void;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Глобальный singleton-стор раскладки, общий для всех React-корней процесса (микрофронты single-spa,
|
|
13
|
+
* острова Astro). Хранится в `globalThis` через `Symbol.for`, переживает несколько копий пакета.
|
|
14
|
+
* Нужен только для multi-root; при одном корне — обычный `AdaptiveProvider` или `createAdaptiveStore`.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* getGlobalAdaptiveStore().setLayoutType(useAdaptiveBootstrap().layoutType);
|
|
18
|
+
* <AdaptiveProvider store={getGlobalAdaptiveStore().store}>{root}</AdaptiveProvider>;
|
|
19
|
+
*/
|
|
20
|
+
export declare function getGlobalAdaptiveStore(): GlobalAdaptiveStore;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getGlobalAdaptiveStore = getGlobalAdaptiveStore;
|
|
4
|
+
const adaptive_1 = require("../constants/adaptive");
|
|
5
|
+
const keys_1 = require("../keys");
|
|
6
|
+
const createAdaptiveStore_1 = require("./createAdaptiveStore");
|
|
7
|
+
const REGISTRY_KEY = Symbol.for(keys_1.ADAPTIVE_KEYS.store);
|
|
8
|
+
/**
|
|
9
|
+
* Глобальный singleton-стор раскладки, общий для всех React-корней процесса (микрофронты single-spa,
|
|
10
|
+
* острова Astro). Хранится в `globalThis` через `Symbol.for`, переживает несколько копий пакета.
|
|
11
|
+
* Нужен только для multi-root; при одном корне — обычный `AdaptiveProvider` или `createAdaptiveStore`.
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* getGlobalAdaptiveStore().setLayoutType(useAdaptiveBootstrap().layoutType);
|
|
15
|
+
* <AdaptiveProvider store={getGlobalAdaptiveStore().store}>{root}</AdaptiveProvider>;
|
|
16
|
+
*/
|
|
17
|
+
function getGlobalAdaptiveStore() {
|
|
18
|
+
const registry = globalThis;
|
|
19
|
+
if (!registry[REGISTRY_KEY]) {
|
|
20
|
+
let currentLayout = adaptive_1.DEFAULT_LAYOUT_TYPE;
|
|
21
|
+
const listeners = new Set();
|
|
22
|
+
registry[REGISTRY_KEY] = {
|
|
23
|
+
store: (0, createAdaptiveStore_1.createAdaptiveStore)({
|
|
24
|
+
getLayoutType: () => currentLayout,
|
|
25
|
+
subscribe: onChange => {
|
|
26
|
+
listeners.add(onChange);
|
|
27
|
+
return () => {
|
|
28
|
+
listeners.delete(onChange);
|
|
29
|
+
};
|
|
30
|
+
},
|
|
31
|
+
getServerLayoutType: () => adaptive_1.DEFAULT_LAYOUT_TYPE,
|
|
32
|
+
}),
|
|
33
|
+
getLayoutType: () => currentLayout,
|
|
34
|
+
setLayoutType: layoutType => {
|
|
35
|
+
if (layoutType === currentLayout)
|
|
36
|
+
return;
|
|
37
|
+
currentLayout = layoutType;
|
|
38
|
+
listeners.forEach(listener => listener());
|
|
39
|
+
},
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
return registry[REGISTRY_KEY];
|
|
43
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
__exportStar(require("./globalStore"), exports);
|
|
18
|
+
__exportStar(require("./createAdaptiveStore"), exports);
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { ADAPTIVE_QUERY } from '../constants/adaptive';
|
|
2
|
+
import { ValueOf } from './valueOf';
|
|
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>;
|