@cntrl-site/sdk-nextjs 1.9.27-1 → 1.9.28

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 (137) hide show
  1. package/.idea/codeStyles/codeStyleConfig.xml +5 -0
  2. package/.idea/modules.xml +8 -0
  3. package/.idea/sdk-nextjs.iml +12 -0
  4. package/.idea/vcs.xml +6 -0
  5. package/LICENSE +21 -21
  6. package/README.md +4 -4
  7. package/TODO.md +1 -1
  8. package/eslint.config.mjs +35 -35
  9. package/jest.config.js +6 -6
  10. package/lib/common/useItemFXData.js +7 -7
  11. package/lib/components/Article.js +5 -5
  12. package/lib/components/LayoutStyle.js +4 -4
  13. package/lib/components/Section/Section.js +27 -27
  14. package/lib/components/items/CodeEmbedItem/CodeEmbedItem.js +36 -36
  15. package/lib/components/items/ComponentItem/ComponentItem.js +13 -13
  16. package/lib/components/items/CompoundItem/CompoundChild.js +20 -20
  17. package/lib/components/items/CompoundItem/CompoundItem.js +14 -14
  18. package/lib/components/items/CustomItem/CustomItem.js +9 -9
  19. package/lib/components/items/EmbedVideoItem/VimeoEmbed.js +24 -24
  20. package/lib/components/items/EmbedVideoItem/YoutubeEmbed.js +27 -27
  21. package/lib/components/items/FileItem/ImageItem.js +40 -40
  22. package/lib/components/items/FileItem/VideoItem.js +64 -64
  23. package/lib/components/items/GroupItem/GroupItem.js +14 -14
  24. package/lib/components/items/Item.js +32 -31
  25. package/lib/components/items/RectangleItem/RectangleItem.js +27 -27
  26. package/lib/components/items/RichTextItem/RichTextItem.js +22 -22
  27. package/lib/utils/RichTextConverter/RichTextConverter.js +21 -21
  28. package/package.json +60 -60
  29. package/src/ItemGeometry/CSSPropertyNameMap.ts +37 -37
  30. package/src/ItemGeometry/GenericGeometryController.ts +59 -59
  31. package/src/ItemGeometry/ItemGeometryContext.ts +4 -4
  32. package/src/ItemGeometry/ItemGeometryController.ts +22 -22
  33. package/src/ItemGeometry/ItemGeometryService.ts +34 -34
  34. package/src/ItemGeometry/RichTextGeometryController.ts +166 -166
  35. package/src/ItemGeometry/useItemGeometry.ts +25 -25
  36. package/src/common/useCurrentLayout.ts +52 -52
  37. package/src/common/useExemplary.ts +9 -9
  38. package/src/common/useItemFXData.ts +47 -47
  39. package/src/common/useKeyframeValue.ts +85 -85
  40. package/src/common/useRegisterResize.ts +16 -16
  41. package/src/components/Article.tsx +73 -73
  42. package/src/components/ArticleWrapper.tsx +21 -21
  43. package/src/components/Head.tsx +56 -56
  44. package/src/components/LayoutStyle.tsx +21 -21
  45. package/src/components/Page.tsx +38 -38
  46. package/src/components/ScrollPlaybackVideo.tsx +56 -56
  47. package/src/components/Section/Section.tsx +127 -127
  48. package/src/components/Section/SectionImage.tsx +48 -48
  49. package/src/components/Section/SectionVideo.tsx +144 -144
  50. package/src/components/Section/useSectionColor.ts +19 -19
  51. package/src/components/Section/useSectionHeightMap.ts +19 -19
  52. package/src/components/items/CodeEmbedItem/CodeEmbedItem.tsx +147 -147
  53. package/src/components/items/CodeEmbedItem/useCodeEmbedItem.ts +36 -36
  54. package/src/components/items/ComponentItem/ComponentItem.tsx +70 -70
  55. package/src/components/items/ComponentItem/useComponentItem.ts +35 -35
  56. package/src/components/items/CompoundItem/CompoundChild.tsx +150 -150
  57. package/src/components/items/CompoundItem/CompoundItem.tsx +87 -87
  58. package/src/components/items/CompoundItem/useCompoundItem.ts +21 -21
  59. package/src/components/items/CustomItem/CustomItem.tsx +50 -50
  60. package/src/components/items/EmbedVideoItem/VimeoEmbed.tsx +216 -216
  61. package/src/components/items/EmbedVideoItem/YoutubeEmbed.tsx +200 -200
  62. package/src/components/items/EmbedVideoItem/useEmbedVideoItem.ts +46 -46
  63. package/src/components/items/FileItem/ImageItem.tsx +165 -165
  64. package/src/components/items/FileItem/VideoItem.tsx +282 -282
  65. package/src/components/items/FileItem/useFileItem.ts +81 -81
  66. package/src/components/items/GroupItem/GroupItem.tsx +98 -98
  67. package/src/components/items/GroupItem/useGroupItem.ts +34 -34
  68. package/src/components/items/Item.tsx +262 -260
  69. package/src/components/items/LinkWrapper.tsx +39 -39
  70. package/src/components/items/RectangleItem/RectangleItem.tsx +184 -184
  71. package/src/components/items/RectangleItem/useRectangleItem.ts +89 -89
  72. package/src/components/items/RichTextItem/RichTextItem.tsx +112 -112
  73. package/src/components/items/RichTextItem/useRichTextItem.ts +12 -12
  74. package/src/components/items/RichTextWrapper.tsx +15 -15
  75. package/src/components/items/itemsMap.ts +28 -28
  76. package/src/components/items/useDraggable.ts +252 -252
  77. package/src/components/items/useItemAngle.ts +13 -13
  78. package/src/components/items/useItemArea.ts +35 -35
  79. package/src/components/items/useItemPointerEvents.ts +23 -23
  80. package/src/components/items/useItemScale.ts +17 -17
  81. package/src/components/items/useItemTriggers.ts +15 -15
  82. package/src/components/items/useRichTextItemValues.ts +66 -66
  83. package/src/components/items/useSizing.ts +25 -25
  84. package/src/components/items/useStickyItemTop.ts +21 -21
  85. package/src/components/useLayoutContext.ts +7 -7
  86. package/src/index.ts +24 -24
  87. package/src/interactions/InteractionsRegistry.ts +507 -507
  88. package/src/interactions/ItemInteractionCtrl.ts +78 -78
  89. package/src/interactions/getTransition.ts +27 -27
  90. package/src/interactions/types.ts +36 -36
  91. package/src/interactions/useItemInteractionCtrl.ts +18 -18
  92. package/src/provider/ArticleRectContext.ts +4 -4
  93. package/src/provider/CntrlContext.ts +5 -5
  94. package/src/provider/CntrlProvider.tsx +11 -11
  95. package/src/provider/CntrlSdkContext.ts +84 -84
  96. package/src/provider/CustomItemRegistry.ts +14 -14
  97. package/src/provider/CustomItemTypes.ts +3 -3
  98. package/src/provider/CustomSectionRegistry.ts +25 -25
  99. package/src/provider/InteractionsContext.tsx +61 -61
  100. package/src/provider/Keyframes.ts +11 -11
  101. package/src/provider/KeyframesContext.ts +5 -5
  102. package/src/provider/LayoutContext.ts +3 -3
  103. package/src/provider/WebGLContextManagerContext.tsx +4 -4
  104. package/src/provider/defaultContext.ts +8 -8
  105. package/src/provider/useCntrlContext.ts +8 -8
  106. package/src/styled-jsx.d.ts +1 -1
  107. package/src/utils/Animator/Animator.ts +570 -570
  108. package/src/utils/ArticleRectManager/ArticleRectObserver.ts +93 -93
  109. package/src/utils/ArticleRectManager/useArticleRectObserver.ts +17 -17
  110. package/src/utils/ArticleRectManager/useSectionRegistry.ts +11 -11
  111. package/src/utils/CSSNumeric.ts +19 -19
  112. package/src/utils/EventEmitter.ts +41 -41
  113. package/src/utils/RichTextConverter/RichTextConverter.tsx +342 -342
  114. package/src/utils/ScaleAnchorMap.ts +13 -13
  115. package/src/utils/StickyManager/StickyManager.ts +23 -23
  116. package/src/utils/Youtube/YouTubeIframeApiLoader.ts +58 -58
  117. package/src/utils/Youtube/YoutubeIframeApi.ts +101 -101
  118. package/src/utils/Youtube/useYouTubeIframeApi.ts +12 -12
  119. package/src/utils/areFillsVisible/areFillsVisible.test.ts +63 -63
  120. package/src/utils/areFillsVisible/areFillsVisible.ts +37 -37
  121. package/src/utils/binSearchInsertAt.ts +33 -33
  122. package/src/utils/castObject.ts +10 -10
  123. package/src/utils/checkOverflowClipSupport.ts +13 -13
  124. package/src/utils/domDfs.ts +11 -11
  125. package/src/utils/effects/useImageFx.ts +156 -156
  126. package/src/utils/effects/useVideoFx.ts +158 -158
  127. package/src/utils/getAnchoredItemTop.ts +12 -12
  128. package/src/utils/getCompoundBoundaryStyles.ts +60 -60
  129. package/src/utils/getFill.ts +46 -46
  130. package/src/utils/getFontFamilyValue.ts +3 -3
  131. package/src/utils/getInvertedRanges.ts +43 -43
  132. package/src/utils/getItemTopStyle.ts +14 -14
  133. package/src/utils/getStyleFromItemStateAndParams.ts +8 -8
  134. package/src/utils/getValidYoutubeUrl.ts +29 -29
  135. package/src/utils/isItemType.ts +5 -5
  136. package/src/utils/rangeMap.ts +13 -13
  137. package/src/utils/useElementRect.ts +23 -23
@@ -1,87 +1,87 @@
1
- import React, { FC, useContext, useEffect, useId, useState } from 'react';
2
- import { useItemAngle } from '../useItemAngle';
3
- import { useCntrlContext } from '../../../provider/useCntrlContext';
4
- import { useRegisterResize } from '../../../common/useRegisterResize';
5
- import { getStyleFromItemStateAndParams } from '../../../utils/getStyleFromItemStateAndParams';
6
- import { LinkWrapper } from '../LinkWrapper';
7
- import { ItemProps } from '../Item';
8
- import JSXStyle from 'styled-jsx/style';
9
- import { getLayoutStyles, CompoundItem as TCompoundItem } from '@cntrl-site/sdk';
10
- import { CompoundChild } from './CompoundChild';
11
- import { useCompoundItem } from './useCompoundItem';
12
- import { useItemGeometry } from '../../../ItemGeometry/useItemGeometry';
13
- import { ItemGeometryContext } from '../../../ItemGeometry/ItemGeometryContext';
14
-
15
- export const CompoundItem: FC<ItemProps<TCompoundItem>> = ({ item, sectionId, onResize, interactionCtrl, onVisibilityChange }) => {
16
- const id = useId();
17
- const { items } = item;
18
- const itemIds = items ? items.map(item => item.id) : [];
19
- const itemAngle = useItemAngle(item, sectionId);
20
- const { layouts } = useCntrlContext();
21
- const { opacity: itemOpacity } = useCompoundItem(item, sectionId);
22
- const layoutValues: Record<string, any>[] = [item.area, item.layoutParams];
23
- const [ref, setRef] = useState<HTMLDivElement | null>(null);
24
- useRegisterResize(ref, onResize);
25
- useItemGeometry(item.id, ref);
26
- const itemGeometryService = useContext(ItemGeometryContext);
27
- const stateParams = interactionCtrl?.getState<number>(['opacity', 'angle']);
28
- const angle = getStyleFromItemStateAndParams(stateParams?.styles?.angle, itemAngle);
29
- const opacity = getStyleFromItemStateAndParams(stateParams?.styles?.opacity, itemOpacity);
30
- const isInteractive = opacity !== 0 && opacity !== undefined;
31
- useEffect(() => {
32
- onVisibilityChange?.(isInteractive);
33
- }, [isInteractive, onVisibilityChange]);
34
- useEffect(() => {
35
- // because on first render controllers not yet initialized
36
- setTimeout(() => {
37
- for (const id of itemIds) {
38
- const hasItem = itemGeometryService.hasItem(id);
39
- if (hasItem) {
40
- const cntrl = itemGeometryService.getControllerById(id);
41
- cntrl.setParentId(item.id);
42
- }
43
- }
44
- }, 0);
45
- }, [itemIds, item.id]);
46
- return (
47
- <LinkWrapper url={item.link?.url} target={item.link?.target}>
48
- <>
49
- <div
50
- className={`compound-${item.id}`}
51
- ref={setRef}
52
- style={{
53
- ...(opacity !== undefined ? { opacity } : {}),
54
- ...(angle !== undefined ? { transform: `rotate(${angle}deg)` } : {}),
55
- transition: stateParams?.transition ?? 'none'
56
- }}
57
- >
58
- {items && items.map(item => (
59
- <CompoundChild
60
- item={item}
61
- key={item.id}
62
- sectionId={sectionId}
63
- isParentVisible={isInteractive}
64
- />
65
- ))}
66
- </div>
67
- <JSXStyle id={id}>{`
68
- .compound-${item.id} {
69
- overflow: ${item.commonParams.overflow};
70
- position: absolute;
71
- width: 100%;
72
- height: 100%;
73
- box-sizing: border-box;
74
- }
75
- ${getLayoutStyles(layouts, layoutValues, ([area, layoutParams]) => {
76
- return (`
77
- .compound-${item.id} {
78
- opacity: ${layoutParams.opacity};
79
- transform: rotate(${area.angle}deg);
80
- }
81
- `);
82
- })}
83
- `}</JSXStyle>
84
- </>
85
- </LinkWrapper>
86
- );
87
- };
1
+ import React, { FC, useContext, useEffect, useId, useState } from 'react';
2
+ import { useItemAngle } from '../useItemAngle';
3
+ import { useCntrlContext } from '../../../provider/useCntrlContext';
4
+ import { useRegisterResize } from '../../../common/useRegisterResize';
5
+ import { getStyleFromItemStateAndParams } from '../../../utils/getStyleFromItemStateAndParams';
6
+ import { LinkWrapper } from '../LinkWrapper';
7
+ import { ItemProps } from '../Item';
8
+ import JSXStyle from 'styled-jsx/style';
9
+ import { getLayoutStyles, CompoundItem as TCompoundItem } from '@cntrl-site/sdk';
10
+ import { CompoundChild } from './CompoundChild';
11
+ import { useCompoundItem } from './useCompoundItem';
12
+ import { useItemGeometry } from '../../../ItemGeometry/useItemGeometry';
13
+ import { ItemGeometryContext } from '../../../ItemGeometry/ItemGeometryContext';
14
+
15
+ export const CompoundItem: FC<ItemProps<TCompoundItem>> = ({ item, sectionId, onResize, interactionCtrl, onVisibilityChange }) => {
16
+ const id = useId();
17
+ const { items } = item;
18
+ const itemIds = items ? items.map(item => item.id) : [];
19
+ const itemAngle = useItemAngle(item, sectionId);
20
+ const { layouts } = useCntrlContext();
21
+ const { opacity: itemOpacity } = useCompoundItem(item, sectionId);
22
+ const layoutValues: Record<string, any>[] = [item.area, item.layoutParams];
23
+ const [ref, setRef] = useState<HTMLDivElement | null>(null);
24
+ useRegisterResize(ref, onResize);
25
+ useItemGeometry(item.id, ref);
26
+ const itemGeometryService = useContext(ItemGeometryContext);
27
+ const stateParams = interactionCtrl?.getState<number>(['opacity', 'angle']);
28
+ const angle = getStyleFromItemStateAndParams(stateParams?.styles?.angle, itemAngle);
29
+ const opacity = getStyleFromItemStateAndParams(stateParams?.styles?.opacity, itemOpacity);
30
+ const isInteractive = opacity !== 0 && opacity !== undefined;
31
+ useEffect(() => {
32
+ onVisibilityChange?.(isInteractive);
33
+ }, [isInteractive, onVisibilityChange]);
34
+ useEffect(() => {
35
+ // because on first render controllers not yet initialized
36
+ setTimeout(() => {
37
+ for (const id of itemIds) {
38
+ const hasItem = itemGeometryService.hasItem(id);
39
+ if (hasItem) {
40
+ const cntrl = itemGeometryService.getControllerById(id);
41
+ cntrl.setParentId(item.id);
42
+ }
43
+ }
44
+ }, 0);
45
+ }, [itemIds, item.id]);
46
+ return (
47
+ <LinkWrapper url={item.link?.url} target={item.link?.target}>
48
+ <>
49
+ <div
50
+ className={`compound-${item.id}`}
51
+ ref={setRef}
52
+ style={{
53
+ ...(opacity !== undefined ? { opacity } : {}),
54
+ ...(angle !== undefined ? { transform: `rotate(${angle}deg)` } : {}),
55
+ transition: stateParams?.transition ?? 'none'
56
+ }}
57
+ >
58
+ {items && items.map(item => (
59
+ <CompoundChild
60
+ item={item}
61
+ key={item.id}
62
+ sectionId={sectionId}
63
+ isParentVisible={isInteractive}
64
+ />
65
+ ))}
66
+ </div>
67
+ <JSXStyle id={id}>{`
68
+ .compound-${item.id} {
69
+ overflow: ${item.commonParams.overflow};
70
+ position: absolute;
71
+ width: 100%;
72
+ height: 100%;
73
+ box-sizing: border-box;
74
+ }
75
+ ${getLayoutStyles(layouts, layoutValues, ([area, layoutParams]) => {
76
+ return (`
77
+ .compound-${item.id} {
78
+ opacity: ${layoutParams.opacity};
79
+ transform: rotate(${area.angle}deg);
80
+ }
81
+ `);
82
+ })}
83
+ `}</JSXStyle>
84
+ </>
85
+ </LinkWrapper>
86
+ );
87
+ };
@@ -1,21 +1,21 @@
1
- import { CompoundItem, KeyframeType } from '@cntrl-site/sdk';
2
- import { useLayoutContext } from '../../useLayoutContext';
3
- import { useKeyframeValue } from '../../../common/useKeyframeValue';
4
-
5
- export function useCompoundItem(item: CompoundItem, sectionId: string) {
6
- const layoutId = useLayoutContext();
7
- const opacity = useKeyframeValue(
8
- item,
9
- KeyframeType.Opacity,
10
- (item, layoutId) => {
11
- if (!layoutId) return;
12
- const layoutParams = item.layoutParams[layoutId];
13
- return 'opacity' in layoutParams ? layoutParams.opacity : 1;
14
- },
15
- (animator, scroll, value) => value !== undefined ? animator.getOpacity({ opacity: value }, scroll).opacity : undefined,
16
- sectionId,
17
- [layoutId]
18
- );
19
-
20
- return { opacity };
21
- }
1
+ import { CompoundItem, KeyframeType } from '@cntrl-site/sdk';
2
+ import { useLayoutContext } from '../../useLayoutContext';
3
+ import { useKeyframeValue } from '../../../common/useKeyframeValue';
4
+
5
+ export function useCompoundItem(item: CompoundItem, sectionId: string) {
6
+ const layoutId = useLayoutContext();
7
+ const opacity = useKeyframeValue(
8
+ item,
9
+ KeyframeType.Opacity,
10
+ (item, layoutId) => {
11
+ if (!layoutId) return;
12
+ const layoutParams = item.layoutParams[layoutId];
13
+ return 'opacity' in layoutParams ? layoutParams.opacity : 1;
14
+ },
15
+ (animator, scroll, value) => value !== undefined ? animator.getOpacity({ opacity: value }, scroll).opacity : undefined,
16
+ sectionId,
17
+ [layoutId]
18
+ );
19
+
20
+ return { opacity };
21
+ }
@@ -1,50 +1,50 @@
1
- import { getLayoutStyles, CustomItem as TCustomItem } from '@cntrl-site/sdk';
2
- import { FC, useState } from 'react';
3
- import { useCntrlContext } from '../../../provider/useCntrlContext';
4
- import { ItemProps } from '../Item';
5
- import JSXStyle from 'styled-jsx/style';
6
- import { useRegisterResize } from '../../../common/useRegisterResize';
7
- import { useItemAngle } from '../useItemAngle';
8
- import { useItemGeometry } from '../../../ItemGeometry/useItemGeometry';
9
-
10
- export const CustomItem: FC<ItemProps<TCustomItem>> = ({ item, onResize, sectionId, interactionCtrl }) => {
11
- const sdk = useCntrlContext();
12
- const { layouts } = useCntrlContext();
13
- const itemAngle = useItemAngle(item, sectionId);
14
- const component = sdk.customItems.get(item.commonParams.name);
15
- const layoutValues: Record<string, any>[] = [item.area];
16
- const [ref, setRef] = useState<HTMLDivElement | null>(null);
17
- useRegisterResize(ref, onResize);
18
- useItemGeometry(item.id, ref);
19
- const stateParams = interactionCtrl?.getState<number>(['angle']);
20
- const angle = stateParams?.styles?.angle ?? itemAngle;
21
- if (!component) return null;
22
- return (
23
- <>
24
- <div
25
- className={`custom-component-${item.id}`}
26
- ref={setRef}
27
- style={{
28
- ...(angle !== undefined ? { transform: `rotate(${angle}deg)` } : {}),
29
- transition: stateParams?.transition ?? 'none'
30
- }}
31
- >
32
- {component({})}
33
- </div>
34
- <JSXStyle id={item.id}>
35
- {`${getLayoutStyles(layouts, layoutValues, ([area]) => {
36
- return (`
37
- .custom-component-${item.id} {
38
- transform: rotate(${area.angle}deg);
39
- height: 100%;
40
- width: 100%;
41
- position: absolute;
42
- left: 0;
43
- top: 0;
44
- }
45
- `);
46
- })}`}
47
- </JSXStyle>
48
- </>
49
- );
50
- };
1
+ import { getLayoutStyles, CustomItem as TCustomItem } from '@cntrl-site/sdk';
2
+ import { FC, useState } from 'react';
3
+ import { useCntrlContext } from '../../../provider/useCntrlContext';
4
+ import { ItemProps } from '../Item';
5
+ import JSXStyle from 'styled-jsx/style';
6
+ import { useRegisterResize } from '../../../common/useRegisterResize';
7
+ import { useItemAngle } from '../useItemAngle';
8
+ import { useItemGeometry } from '../../../ItemGeometry/useItemGeometry';
9
+
10
+ export const CustomItem: FC<ItemProps<TCustomItem>> = ({ item, onResize, sectionId, interactionCtrl }) => {
11
+ const sdk = useCntrlContext();
12
+ const { layouts } = useCntrlContext();
13
+ const itemAngle = useItemAngle(item, sectionId);
14
+ const component = sdk.customItems.get(item.commonParams.name);
15
+ const layoutValues: Record<string, any>[] = [item.area];
16
+ const [ref, setRef] = useState<HTMLDivElement | null>(null);
17
+ useRegisterResize(ref, onResize);
18
+ useItemGeometry(item.id, ref);
19
+ const stateParams = interactionCtrl?.getState<number>(['angle']);
20
+ const angle = stateParams?.styles?.angle ?? itemAngle;
21
+ if (!component) return null;
22
+ return (
23
+ <>
24
+ <div
25
+ className={`custom-component-${item.id}`}
26
+ ref={setRef}
27
+ style={{
28
+ ...(angle !== undefined ? { transform: `rotate(${angle}deg)` } : {}),
29
+ transition: stateParams?.transition ?? 'none'
30
+ }}
31
+ >
32
+ {component({})}
33
+ </div>
34
+ <JSXStyle id={item.id}>
35
+ {`${getLayoutStyles(layouts, layoutValues, ([area]) => {
36
+ return (`
37
+ .custom-component-${item.id} {
38
+ transform: rotate(${area.angle}deg);
39
+ height: 100%;
40
+ width: 100%;
41
+ position: absolute;
42
+ left: 0;
43
+ top: 0;
44
+ }
45
+ `);
46
+ })}`}
47
+ </JSXStyle>
48
+ </>
49
+ );
50
+ };